From fa510792f128bee0526884e131508b37c58c4e12 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Thu, 24 Aug 2023 14:18:46 -0700 Subject: [PATCH 001/290] Revert "Remove importlib-metadata and importlib-resources" This reverts commit 47b2f55c973c701f89fd2ada79d8afd53759396e. --- package/requirements-package.txt | 2 ++ 1 file changed, 2 insertions(+) diff --git a/package/requirements-package.txt b/package/requirements-package.txt index db171e7a..1027cf23 100644 --- a/package/requirements-package.txt +++ b/package/requirements-package.txt @@ -1,4 +1,6 @@ apscheduler==3.10.4 +importlib-metadata==6.8.0 +importlib-resources==6.0.1 pyinstaller==5.13.0 pyopenssl==23.2.0 pycryptodomex==3.18.0 From 1b26775ec6eddd8769c492bb8f96c8aca3d86a8d Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Thu, 24 Aug 2023 13:49:16 -0700 Subject: [PATCH 002/290] Revert "Remove importlib-metadata and importlib-resources" This reverts commit 38435ae81c5b029e54f87aa460d6f9394e6c3180. --- lib/importlib_metadata/__init__.py | 904 ++++++++++++++++++ lib/importlib_metadata/_adapters.py | 90 ++ lib/importlib_metadata/_collections.py | 30 + lib/importlib_metadata/_compat.py | 72 ++ lib/importlib_metadata/_functools.py | 104 ++ lib/importlib_metadata/_itertools.py | 73 ++ lib/importlib_metadata/_meta.py | 49 + lib/importlib_metadata/_py39compat.py | 35 + lib/importlib_metadata/_text.py | 99 ++ lib/importlib_metadata/py.typed | 0 lib/importlib_resources/__init__.py | 17 + lib/importlib_resources/_adapters.py | 168 ++++ lib/importlib_resources/_common.py | 207 ++++ lib/importlib_resources/_compat.py | 109 +++ lib/importlib_resources/_itertools.py | 38 + lib/importlib_resources/abc.py | 170 ++++ lib/importlib_resources/py.typed | 0 lib/importlib_resources/readers.py | 144 +++ lib/importlib_resources/simple.py | 106 ++ lib/importlib_resources/tests/__init__.py | 0 lib/importlib_resources/tests/_compat.py | 32 + lib/importlib_resources/tests/_path.py | 56 ++ .../tests/data01/__init__.py | 0 .../tests/data01/binary.file | Bin 0 -> 4 bytes .../tests/data01/subdirectory/__init__.py | 0 .../tests/data01/subdirectory/binary.file | Bin 0 -> 4 bytes .../tests/data01/utf-16.file | Bin 0 -> 44 bytes .../tests/data01/utf-8.file | 1 + .../tests/data02/__init__.py | 0 .../tests/data02/one/__init__.py | 0 .../tests/data02/one/resource1.txt | 1 + .../subdirectory/subsubdir/resource.txt | 1 + .../tests/data02/two/__init__.py | 0 .../tests/data02/two/resource2.txt | 1 + .../tests/namespacedata01/binary.file | Bin 0 -> 4 bytes .../tests/namespacedata01/utf-16.file | Bin 0 -> 44 bytes .../tests/namespacedata01/utf-8.file | 1 + .../tests/test_compatibilty_files.py | 104 ++ .../tests/test_contents.py | 43 + lib/importlib_resources/tests/test_custom.py | 45 + lib/importlib_resources/tests/test_files.py | 112 +++ lib/importlib_resources/tests/test_open.py | 85 ++ lib/importlib_resources/tests/test_path.py | 69 ++ lib/importlib_resources/tests/test_read.py | 82 ++ lib/importlib_resources/tests/test_reader.py | 144 +++ .../tests/test_resource.py | 252 +++++ lib/importlib_resources/tests/update-zips.py | 53 + lib/importlib_resources/tests/util.py | 179 ++++ .../tests/zipdata01/__init__.py | 0 .../tests/zipdata01/ziptestdata.zip | Bin 0 -> 876 bytes .../tests/zipdata02/__init__.py | 0 .../tests/zipdata02/ziptestdata.zip | Bin 0 -> 698 bytes requirements.txt | 2 + 53 files changed, 3678 insertions(+) create mode 100644 lib/importlib_metadata/__init__.py create mode 100644 lib/importlib_metadata/_adapters.py create mode 100644 lib/importlib_metadata/_collections.py create mode 100644 lib/importlib_metadata/_compat.py create mode 100644 lib/importlib_metadata/_functools.py create mode 100644 lib/importlib_metadata/_itertools.py create mode 100644 lib/importlib_metadata/_meta.py create mode 100644 lib/importlib_metadata/_py39compat.py create mode 100644 lib/importlib_metadata/_text.py create mode 100644 lib/importlib_metadata/py.typed create mode 100644 lib/importlib_resources/__init__.py create mode 100644 lib/importlib_resources/_adapters.py create mode 100644 lib/importlib_resources/_common.py create mode 100644 lib/importlib_resources/_compat.py create mode 100644 lib/importlib_resources/_itertools.py create mode 100644 lib/importlib_resources/abc.py create mode 100644 lib/importlib_resources/py.typed create mode 100644 lib/importlib_resources/readers.py create mode 100644 lib/importlib_resources/simple.py create mode 100644 lib/importlib_resources/tests/__init__.py create mode 100644 lib/importlib_resources/tests/_compat.py create mode 100644 lib/importlib_resources/tests/_path.py create mode 100644 lib/importlib_resources/tests/data01/__init__.py create mode 100644 lib/importlib_resources/tests/data01/binary.file create mode 100644 lib/importlib_resources/tests/data01/subdirectory/__init__.py create mode 100644 lib/importlib_resources/tests/data01/subdirectory/binary.file create mode 100644 lib/importlib_resources/tests/data01/utf-16.file create mode 100644 lib/importlib_resources/tests/data01/utf-8.file create mode 100644 lib/importlib_resources/tests/data02/__init__.py create mode 100644 lib/importlib_resources/tests/data02/one/__init__.py create mode 100644 lib/importlib_resources/tests/data02/one/resource1.txt create mode 100644 lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt create mode 100644 lib/importlib_resources/tests/data02/two/__init__.py create mode 100644 lib/importlib_resources/tests/data02/two/resource2.txt create mode 100644 lib/importlib_resources/tests/namespacedata01/binary.file create mode 100644 lib/importlib_resources/tests/namespacedata01/utf-16.file create mode 100644 lib/importlib_resources/tests/namespacedata01/utf-8.file create mode 100644 lib/importlib_resources/tests/test_compatibilty_files.py create mode 100644 lib/importlib_resources/tests/test_contents.py create mode 100644 lib/importlib_resources/tests/test_custom.py create mode 100644 lib/importlib_resources/tests/test_files.py create mode 100644 lib/importlib_resources/tests/test_open.py create mode 100644 lib/importlib_resources/tests/test_path.py create mode 100644 lib/importlib_resources/tests/test_read.py create mode 100644 lib/importlib_resources/tests/test_reader.py create mode 100644 lib/importlib_resources/tests/test_resource.py create mode 100644 lib/importlib_resources/tests/update-zips.py create mode 100644 lib/importlib_resources/tests/util.py create mode 100644 lib/importlib_resources/tests/zipdata01/__init__.py create mode 100644 lib/importlib_resources/tests/zipdata01/ziptestdata.zip create mode 100644 lib/importlib_resources/tests/zipdata02/__init__.py create mode 100644 lib/importlib_resources/tests/zipdata02/ziptestdata.zip diff --git a/lib/importlib_metadata/__init__.py b/lib/importlib_metadata/__init__.py new file mode 100644 index 00000000..9a36a8e6 --- /dev/null +++ b/lib/importlib_metadata/__init__.py @@ -0,0 +1,904 @@ +import os +import re +import abc +import csv +import sys +import zipp +import email +import pathlib +import operator +import textwrap +import warnings +import functools +import itertools +import posixpath +import collections + +from . import _adapters, _meta, _py39compat +from ._collections import FreezableDefaultDict, Pair +from ._compat import ( + NullFinder, + install, + pypy_partial, +) +from ._functools import method_cache, pass_none +from ._itertools import always_iterable, unique_everseen +from ._meta import PackageMetadata, SimplePath + +from contextlib import suppress +from importlib import import_module +from importlib.abc import MetaPathFinder +from itertools import starmap +from typing import List, Mapping, Optional + + +__all__ = [ + 'Distribution', + 'DistributionFinder', + 'PackageMetadata', + 'PackageNotFoundError', + 'distribution', + 'distributions', + 'entry_points', + 'files', + 'metadata', + 'packages_distributions', + 'requires', + 'version', +] + + +class PackageNotFoundError(ModuleNotFoundError): + """The package was not found.""" + + def __str__(self): + return f"No package metadata was found for {self.name}" + + @property + def name(self): + (name,) = self.args + return name + + +class Sectioned: + """ + A simple entry point config parser for performance + + >>> for item in Sectioned.read(Sectioned._sample): + ... print(item) + Pair(name='sec1', value='# comments ignored') + Pair(name='sec1', value='a = 1') + Pair(name='sec1', value='b = 2') + Pair(name='sec2', value='a = 2') + + >>> res = Sectioned.section_pairs(Sectioned._sample) + >>> item = next(res) + >>> item.name + 'sec1' + >>> item.value + Pair(name='a', value='1') + >>> item = next(res) + >>> item.value + Pair(name='b', value='2') + >>> item = next(res) + >>> item.name + 'sec2' + >>> item.value + Pair(name='a', value='2') + >>> list(res) + [] + """ + + _sample = textwrap.dedent( + """ + [sec1] + # comments ignored + a = 1 + b = 2 + + [sec2] + a = 2 + """ + ).lstrip() + + @classmethod + def section_pairs(cls, text): + return ( + section._replace(value=Pair.parse(section.value)) + for section in cls.read(text, filter_=cls.valid) + if section.name is not None + ) + + @staticmethod + def read(text, filter_=None): + lines = filter(filter_, map(str.strip, text.splitlines())) + name = None + for value in lines: + section_match = value.startswith('[') and value.endswith(']') + if section_match: + name = value.strip('[]') + continue + yield Pair(name, value) + + @staticmethod + def valid(line): + return line and not line.startswith('#') + + +class DeprecatedTuple: + """ + Provide subscript item access for backward compatibility. + + >>> recwarn = getfixture('recwarn') + >>> ep = EntryPoint(name='name', value='value', group='group') + >>> ep[:] + ('name', 'value', 'group') + >>> ep[0] + 'name' + >>> len(recwarn) + 1 + """ + + # Do not remove prior to 2023-05-01 or Python 3.13 + _warn = functools.partial( + warnings.warn, + "EntryPoint tuple interface is deprecated. Access members by name.", + DeprecationWarning, + stacklevel=pypy_partial(2), + ) + + def __getitem__(self, item): + self._warn() + return self._key()[item] + + +class EntryPoint(DeprecatedTuple): + """An entry point as defined by Python packaging conventions. + + See `the packaging docs on entry points + `_ + for more information. + + >>> ep = EntryPoint( + ... name=None, group=None, value='package.module:attr [extra1, extra2]') + >>> ep.module + 'package.module' + >>> ep.attr + 'attr' + >>> ep.extras + ['extra1', 'extra2'] + """ + + pattern = re.compile( + r'(?P[\w.]+)\s*' + r'(:\s*(?P[\w.]+)\s*)?' + r'((?P\[.*\])\s*)?$' + ) + """ + A regular expression describing the syntax for an entry point, + which might look like: + + - module + - package.module + - package.module:attribute + - package.module:object.attribute + - package.module:attr [extra1, extra2] + + Other combinations are possible as well. + + The expression is lenient about whitespace around the ':', + following the attr, and following any extras. + """ + + name: str + value: str + group: str + + dist: Optional['Distribution'] = None + + def __init__(self, name, value, group): + vars(self).update(name=name, value=value, group=group) + + def load(self): + """Load the entry point from its definition. If only a module + is indicated by the value, return that module. Otherwise, + return the named object. + """ + match = self.pattern.match(self.value) + module = import_module(match.group('module')) + attrs = filter(None, (match.group('attr') or '').split('.')) + return functools.reduce(getattr, attrs, module) + + @property + def module(self): + match = self.pattern.match(self.value) + return match.group('module') + + @property + def attr(self): + match = self.pattern.match(self.value) + return match.group('attr') + + @property + def extras(self): + match = self.pattern.match(self.value) + return re.findall(r'\w+', match.group('extras') or '') + + def _for(self, dist): + vars(self).update(dist=dist) + return self + + def matches(self, **params): + """ + EntryPoint matches the given parameters. + + >>> ep = EntryPoint(group='foo', name='bar', value='bing:bong [extra1, extra2]') + >>> ep.matches(group='foo') + True + >>> ep.matches(name='bar', value='bing:bong [extra1, extra2]') + True + >>> ep.matches(group='foo', name='other') + False + >>> ep.matches() + True + >>> ep.matches(extras=['extra1', 'extra2']) + True + >>> ep.matches(module='bing') + True + >>> ep.matches(attr='bong') + True + """ + attrs = (getattr(self, param) for param in params) + return all(map(operator.eq, params.values(), attrs)) + + def _key(self): + return self.name, self.value, self.group + + def __lt__(self, other): + return self._key() < other._key() + + def __eq__(self, other): + return self._key() == other._key() + + def __setattr__(self, name, value): + raise AttributeError("EntryPoint objects are immutable.") + + def __repr__(self): + return ( + f'EntryPoint(name={self.name!r}, value={self.value!r}, ' + f'group={self.group!r})' + ) + + def __hash__(self): + return hash(self._key()) + + +class EntryPoints(tuple): + """ + An immutable collection of selectable EntryPoint objects. + """ + + __slots__ = () + + def __getitem__(self, name): # -> EntryPoint: + """ + Get the EntryPoint in self matching name. + """ + try: + return next(iter(self.select(name=name))) + except StopIteration: + raise KeyError(name) + + def select(self, **params): + """ + Select entry points from self that match the + given parameters (typically group and/or name). + """ + return EntryPoints(ep for ep in self if _py39compat.ep_matches(ep, **params)) + + @property + def names(self): + """ + Return the set of all names of all entry points. + """ + return {ep.name for ep in self} + + @property + def groups(self): + """ + Return the set of all groups of all entry points. + """ + return {ep.group for ep in self} + + @classmethod + def _from_text_for(cls, text, dist): + return cls(ep._for(dist) for ep in cls._from_text(text)) + + @staticmethod + def _from_text(text): + return ( + EntryPoint(name=item.value.name, value=item.value.value, group=item.name) + for item in Sectioned.section_pairs(text or '') + ) + + +class PackagePath(pathlib.PurePosixPath): + """A reference to a path in a package""" + + def read_text(self, encoding='utf-8'): + with self.locate().open(encoding=encoding) as stream: + return stream.read() + + def read_binary(self): + with self.locate().open('rb') as stream: + return stream.read() + + def locate(self): + """Return a path-like object for this path""" + return self.dist.locate_file(self) + + +class FileHash: + def __init__(self, spec): + self.mode, _, self.value = spec.partition('=') + + def __repr__(self): + return f'' + + +class Distribution(metaclass=abc.ABCMeta): + """A Python distribution package.""" + + @abc.abstractmethod + def read_text(self, filename): + """Attempt to load metadata file given by the name. + + :param filename: The name of the file in the distribution info. + :return: The text if found, otherwise None. + """ + + @abc.abstractmethod + def locate_file(self, path): + """ + Given a path to a file in this distribution, return a path + to it. + """ + + @classmethod + def from_name(cls, name: str): + """Return the Distribution for the given package name. + + :param name: The name of the distribution package to search for. + :return: The Distribution instance (or subclass thereof) for the named + package, if found. + :raises PackageNotFoundError: When the named package's distribution + metadata cannot be found. + :raises ValueError: When an invalid value is supplied for name. + """ + if not name: + raise ValueError("A distribution name is required.") + try: + return next(cls.discover(name=name)) + except StopIteration: + raise PackageNotFoundError(name) + + @classmethod + def discover(cls, **kwargs): + """Return an iterable of Distribution objects for all packages. + + Pass a ``context`` or pass keyword arguments for constructing + a context. + + :context: A ``DistributionFinder.Context`` object. + :return: Iterable of Distribution objects for all packages. + """ + context = kwargs.pop('context', None) + if context and kwargs: + raise ValueError("cannot accept context and kwargs") + context = context or DistributionFinder.Context(**kwargs) + return itertools.chain.from_iterable( + resolver(context) for resolver in cls._discover_resolvers() + ) + + @staticmethod + def at(path): + """Return a Distribution for the indicated metadata path + + :param path: a string or path-like object + :return: a concrete Distribution instance for the path + """ + return PathDistribution(pathlib.Path(path)) + + @staticmethod + def _discover_resolvers(): + """Search the meta_path for resolvers.""" + declared = ( + getattr(finder, 'find_distributions', None) for finder in sys.meta_path + ) + return filter(None, declared) + + @property + def metadata(self) -> _meta.PackageMetadata: + """Return the parsed metadata for this Distribution. + + The returned object will have keys that name the various bits of + metadata. See PEP 566 for details. + """ + text = ( + self.read_text('METADATA') + or self.read_text('PKG-INFO') + # This last clause is here to support old egg-info files. Its + # effect is to just end up using the PathDistribution's self._path + # (which points to the egg-info file) attribute unchanged. + or self.read_text('') + ) + return _adapters.Message(email.message_from_string(text)) + + @property + def name(self): + """Return the 'Name' metadata for the distribution package.""" + return self.metadata['Name'] + + @property + def _normalized_name(self): + """Return a normalized version of the name.""" + return Prepared.normalize(self.name) + + @property + def version(self): + """Return the 'Version' metadata for the distribution package.""" + return self.metadata['Version'] + + @property + def entry_points(self): + return EntryPoints._from_text_for(self.read_text('entry_points.txt'), self) + + @property + def files(self): + """Files in this distribution. + + :return: List of PackagePath for this distribution or None + + Result is `None` if the metadata file that enumerates files + (i.e. RECORD for dist-info or SOURCES.txt for egg-info) is + missing. + Result may be empty if the metadata exists but is empty. + """ + + def make_file(name, hash=None, size_str=None): + result = PackagePath(name) + result.hash = FileHash(hash) if hash else None + result.size = int(size_str) if size_str else None + result.dist = self + return result + + @pass_none + def make_files(lines): + return list(starmap(make_file, csv.reader(lines))) + + return make_files(self._read_files_distinfo() or self._read_files_egginfo()) + + def _read_files_distinfo(self): + """ + Read the lines of RECORD + """ + text = self.read_text('RECORD') + return text and text.splitlines() + + def _read_files_egginfo(self): + """ + SOURCES.txt might contain literal commas, so wrap each line + in quotes. + """ + text = self.read_text('SOURCES.txt') + return text and map('"{}"'.format, text.splitlines()) + + @property + def requires(self): + """Generated requirements specified for this Distribution""" + reqs = self._read_dist_info_reqs() or self._read_egg_info_reqs() + return reqs and list(reqs) + + def _read_dist_info_reqs(self): + return self.metadata.get_all('Requires-Dist') + + def _read_egg_info_reqs(self): + source = self.read_text('requires.txt') + return pass_none(self._deps_from_requires_text)(source) + + @classmethod + def _deps_from_requires_text(cls, source): + return cls._convert_egg_info_reqs_to_simple_reqs(Sectioned.read(source)) + + @staticmethod + def _convert_egg_info_reqs_to_simple_reqs(sections): + """ + Historically, setuptools would solicit and store 'extra' + requirements, including those with environment markers, + in separate sections. More modern tools expect each + dependency to be defined separately, with any relevant + extras and environment markers attached directly to that + requirement. This method converts the former to the + latter. See _test_deps_from_requires_text for an example. + """ + + def make_condition(name): + return name and f'extra == "{name}"' + + def quoted_marker(section): + section = section or '' + extra, sep, markers = section.partition(':') + if extra and markers: + markers = f'({markers})' + conditions = list(filter(None, [markers, make_condition(extra)])) + return '; ' + ' and '.join(conditions) if conditions else '' + + def url_req_space(req): + """ + PEP 508 requires a space between the url_spec and the quoted_marker. + Ref python/importlib_metadata#357. + """ + # '@' is uniquely indicative of a url_req. + return ' ' * ('@' in req) + + for section in sections: + space = url_req_space(section.value) + yield section.value + space + quoted_marker(section.name) + + +class DistributionFinder(MetaPathFinder): + """ + A MetaPathFinder capable of discovering installed distributions. + """ + + class Context: + """ + Keyword arguments presented by the caller to + ``distributions()`` or ``Distribution.discover()`` + to narrow the scope of a search for distributions + in all DistributionFinders. + + Each DistributionFinder may expect any parameters + and should attempt to honor the canonical + parameters defined below when appropriate. + """ + + name = None + """ + Specific name for which a distribution finder should match. + A name of ``None`` matches all distributions. + """ + + def __init__(self, **kwargs): + vars(self).update(kwargs) + + @property + def path(self): + """ + The sequence of directory path that a distribution finder + should search. + + Typically refers to Python installed package paths such as + "site-packages" directories and defaults to ``sys.path``. + """ + return vars(self).get('path', sys.path) + + @abc.abstractmethod + def find_distributions(self, context=Context()): + """ + Find distributions. + + Return an iterable of all Distribution instances capable of + loading the metadata for packages matching the ``context``, + a DistributionFinder.Context instance. + """ + + +class FastPath: + """ + Micro-optimized class for searching a path for + children. + + >>> FastPath('').children() + ['...'] + """ + + @functools.lru_cache() # type: ignore + def __new__(cls, root): + return super().__new__(cls) + + def __init__(self, root): + self.root = root + + def joinpath(self, child): + return pathlib.Path(self.root, child) + + def children(self): + with suppress(Exception): + return os.listdir(self.root or '.') + with suppress(Exception): + return self.zip_children() + return [] + + def zip_children(self): + zip_path = zipp.Path(self.root) + names = zip_path.root.namelist() + self.joinpath = zip_path.joinpath + + return dict.fromkeys(child.split(posixpath.sep, 1)[0] for child in names) + + def search(self, name): + return self.lookup(self.mtime).search(name) + + @property + def mtime(self): + with suppress(OSError): + return os.stat(self.root).st_mtime + self.lookup.cache_clear() + + @method_cache + def lookup(self, mtime): + return Lookup(self) + + +class Lookup: + def __init__(self, path: FastPath): + base = os.path.basename(path.root).lower() + base_is_egg = base.endswith(".egg") + self.infos = FreezableDefaultDict(list) + self.eggs = FreezableDefaultDict(list) + + for child in path.children(): + low = child.lower() + if low.endswith((".dist-info", ".egg-info")): + # rpartition is faster than splitext and suitable for this purpose. + name = low.rpartition(".")[0].partition("-")[0] + normalized = Prepared.normalize(name) + self.infos[normalized].append(path.joinpath(child)) + elif base_is_egg and low == "egg-info": + name = base.rpartition(".")[0].partition("-")[0] + legacy_normalized = Prepared.legacy_normalize(name) + self.eggs[legacy_normalized].append(path.joinpath(child)) + + self.infos.freeze() + self.eggs.freeze() + + def search(self, prepared): + infos = ( + self.infos[prepared.normalized] + if prepared + else itertools.chain.from_iterable(self.infos.values()) + ) + eggs = ( + self.eggs[prepared.legacy_normalized] + if prepared + else itertools.chain.from_iterable(self.eggs.values()) + ) + return itertools.chain(infos, eggs) + + +class Prepared: + """ + A prepared search for metadata on a possibly-named package. + """ + + normalized = None + legacy_normalized = None + + def __init__(self, name): + self.name = name + if name is None: + return + self.normalized = self.normalize(name) + self.legacy_normalized = self.legacy_normalize(name) + + @staticmethod + def normalize(name): + """ + PEP 503 normalization plus dashes as underscores. + """ + return re.sub(r"[-_.]+", "-", name).lower().replace('-', '_') + + @staticmethod + def legacy_normalize(name): + """ + Normalize the package name as found in the convention in + older packaging tools versions and specs. + """ + return name.lower().replace('-', '_') + + def __bool__(self): + return bool(self.name) + + +@install +class MetadataPathFinder(NullFinder, DistributionFinder): + """A degenerate finder for distribution packages on the file system. + + This finder supplies only a find_distributions() method for versions + of Python that do not have a PathFinder find_distributions(). + """ + + def find_distributions(self, context=DistributionFinder.Context()): + """ + Find distributions. + + Return an iterable of all Distribution instances capable of + loading the metadata for packages matching ``context.name`` + (or all names if ``None`` indicated) along the paths in the list + of directories ``context.path``. + """ + found = self._search_paths(context.name, context.path) + return map(PathDistribution, found) + + @classmethod + def _search_paths(cls, name, paths): + """Find metadata directories in paths heuristically.""" + prepared = Prepared(name) + return itertools.chain.from_iterable( + path.search(prepared) for path in map(FastPath, paths) + ) + + def invalidate_caches(cls): + FastPath.__new__.cache_clear() + + +class PathDistribution(Distribution): + def __init__(self, path: SimplePath): + """Construct a distribution. + + :param path: SimplePath indicating the metadata directory. + """ + self._path = path + + def read_text(self, filename): + with suppress( + FileNotFoundError, + IsADirectoryError, + KeyError, + NotADirectoryError, + PermissionError, + ): + return self._path.joinpath(filename).read_text(encoding='utf-8') + + read_text.__doc__ = Distribution.read_text.__doc__ + + def locate_file(self, path): + return self._path.parent / path + + @property + def _normalized_name(self): + """ + Performance optimization: where possible, resolve the + normalized name from the file system path. + """ + stem = os.path.basename(str(self._path)) + return ( + pass_none(Prepared.normalize)(self._name_from_stem(stem)) + or super()._normalized_name + ) + + @staticmethod + def _name_from_stem(stem): + """ + >>> PathDistribution._name_from_stem('foo-3.0.egg-info') + 'foo' + >>> PathDistribution._name_from_stem('CherryPy-3.0.dist-info') + 'CherryPy' + >>> PathDistribution._name_from_stem('face.egg-info') + 'face' + >>> PathDistribution._name_from_stem('foo.bar') + """ + filename, ext = os.path.splitext(stem) + if ext not in ('.dist-info', '.egg-info'): + return + name, sep, rest = filename.partition('-') + return name + + +def distribution(distribution_name): + """Get the ``Distribution`` instance for the named package. + + :param distribution_name: The name of the distribution package as a string. + :return: A ``Distribution`` instance (or subclass thereof). + """ + return Distribution.from_name(distribution_name) + + +def distributions(**kwargs): + """Get all ``Distribution`` instances in the current environment. + + :return: An iterable of ``Distribution`` instances. + """ + return Distribution.discover(**kwargs) + + +def metadata(distribution_name) -> _meta.PackageMetadata: + """Get the metadata for the named package. + + :param distribution_name: The name of the distribution package to query. + :return: A PackageMetadata containing the parsed metadata. + """ + return Distribution.from_name(distribution_name).metadata + + +def version(distribution_name): + """Get the version string for the named package. + + :param distribution_name: The name of the distribution package to query. + :return: The version string for the package as defined in the package's + "Version" metadata key. + """ + return distribution(distribution_name).version + + +_unique = functools.partial( + unique_everseen, + key=_py39compat.normalized_name, +) +""" +Wrapper for ``distributions`` to return unique distributions by name. +""" + + +def entry_points(**params) -> EntryPoints: + """Return EntryPoint objects for all installed packages. + + Pass selection parameters (group or name) to filter the + result to entry points matching those properties (see + EntryPoints.select()). + + :return: EntryPoints for all installed packages. + """ + eps = itertools.chain.from_iterable( + dist.entry_points for dist in _unique(distributions()) + ) + return EntryPoints(eps).select(**params) + + +def files(distribution_name): + """Return a list of files for the named package. + + :param distribution_name: The name of the distribution package to query. + :return: List of files composing the distribution. + """ + return distribution(distribution_name).files + + +def requires(distribution_name): + """ + Return a list of requirements for the named package. + + :return: An iterator of requirements, suitable for + packaging.requirement.Requirement. + """ + return distribution(distribution_name).requires + + +def packages_distributions() -> Mapping[str, List[str]]: + """ + Return a mapping of top-level packages to their + distributions. + + >>> import collections.abc + >>> pkgs = packages_distributions() + >>> all(isinstance(dist, collections.abc.Sequence) for dist in pkgs.values()) + True + """ + pkg_to_dist = collections.defaultdict(list) + for dist in distributions(): + for pkg in _top_level_declared(dist) or _top_level_inferred(dist): + pkg_to_dist[pkg].append(dist.metadata['Name']) + return dict(pkg_to_dist) + + +def _top_level_declared(dist): + return (dist.read_text('top_level.txt') or '').split() + + +def _top_level_inferred(dist): + return { + f.parts[0] if len(f.parts) > 1 else f.with_suffix('').name + for f in always_iterable(dist.files) + if f.suffix == ".py" + } diff --git a/lib/importlib_metadata/_adapters.py b/lib/importlib_metadata/_adapters.py new file mode 100644 index 00000000..e33cba5e --- /dev/null +++ b/lib/importlib_metadata/_adapters.py @@ -0,0 +1,90 @@ +import functools +import warnings +import re +import textwrap +import email.message + +from ._text import FoldedCase +from ._compat import pypy_partial + + +# Do not remove prior to 2024-01-01 or Python 3.14 +_warn = functools.partial( + warnings.warn, + "Implicit None on return values is deprecated and will raise KeyErrors.", + DeprecationWarning, + stacklevel=pypy_partial(2), +) + + +class Message(email.message.Message): + multiple_use_keys = set( + map( + FoldedCase, + [ + 'Classifier', + 'Obsoletes-Dist', + 'Platform', + 'Project-URL', + 'Provides-Dist', + 'Provides-Extra', + 'Requires-Dist', + 'Requires-External', + 'Supported-Platform', + 'Dynamic', + ], + ) + ) + """ + Keys that may be indicated multiple times per PEP 566. + """ + + def __new__(cls, orig: email.message.Message): + res = super().__new__(cls) + vars(res).update(vars(orig)) + return res + + def __init__(self, *args, **kwargs): + self._headers = self._repair_headers() + + # suppress spurious error from mypy + def __iter__(self): + return super().__iter__() + + def __getitem__(self, item): + """ + Warn users that a ``KeyError`` can be expected when a + mising key is supplied. Ref python/importlib_metadata#371. + """ + res = super().__getitem__(item) + if res is None: + _warn() + return res + + def _repair_headers(self): + def redent(value): + "Correct for RFC822 indentation" + if not value or '\n' not in value: + return value + return textwrap.dedent(' ' * 8 + value) + + headers = [(key, redent(value)) for key, value in vars(self)['_headers']] + if self._payload: + headers.append(('Description', self.get_payload())) + return headers + + @property + def json(self): + """ + Convert PackageMetadata to a JSON-compatible format + per PEP 0566. + """ + + def transform(key): + value = self.get_all(key) if key in self.multiple_use_keys else self[key] + if key == 'Keywords': + value = re.split(r'\s+', value) + tk = key.lower().replace('-', '_') + return tk, value + + return dict(map(transform, map(FoldedCase, self))) diff --git a/lib/importlib_metadata/_collections.py b/lib/importlib_metadata/_collections.py new file mode 100644 index 00000000..cf0954e1 --- /dev/null +++ b/lib/importlib_metadata/_collections.py @@ -0,0 +1,30 @@ +import collections + + +# from jaraco.collections 3.3 +class FreezableDefaultDict(collections.defaultdict): + """ + Often it is desirable to prevent the mutation of + a default dict after its initial construction, such + as to prevent mutation during iteration. + + >>> dd = FreezableDefaultDict(list) + >>> dd[0].append('1') + >>> dd.freeze() + >>> dd[1] + [] + >>> len(dd) + 1 + """ + + def __missing__(self, key): + return getattr(self, '_frozen', super().__missing__)(key) + + def freeze(self): + self._frozen = lambda key: self.default_factory() + + +class Pair(collections.namedtuple('Pair', 'name value')): + @classmethod + def parse(cls, text): + return cls(*map(str.strip, text.split("=", 1))) diff --git a/lib/importlib_metadata/_compat.py b/lib/importlib_metadata/_compat.py new file mode 100644 index 00000000..3d78566e --- /dev/null +++ b/lib/importlib_metadata/_compat.py @@ -0,0 +1,72 @@ +import sys +import platform + + +__all__ = ['install', 'NullFinder', 'Protocol'] + + +try: + from typing import Protocol +except ImportError: # pragma: no cover + # Python 3.7 compatibility + from typing_extensions import Protocol # type: ignore + + +def install(cls): + """ + Class decorator for installation on sys.meta_path. + + Adds the backport DistributionFinder to sys.meta_path and + attempts to disable the finder functionality of the stdlib + DistributionFinder. + """ + sys.meta_path.append(cls()) + disable_stdlib_finder() + return cls + + +def disable_stdlib_finder(): + """ + Give the backport primacy for discovering path-based distributions + by monkey-patching the stdlib O_O. + + See #91 for more background for rationale on this sketchy + behavior. + """ + + def matches(finder): + return getattr( + finder, '__module__', None + ) == '_frozen_importlib_external' and hasattr(finder, 'find_distributions') + + for finder in filter(matches, sys.meta_path): # pragma: nocover + del finder.find_distributions + + +class NullFinder: + """ + A "Finder" (aka "MetaClassFinder") that never finds any modules, + but may find distributions. + """ + + @staticmethod + def find_spec(*args, **kwargs): + return None + + # In Python 2, the import system requires finders + # to have a find_module() method, but this usage + # is deprecated in Python 3 in favor of find_spec(). + # For the purposes of this finder (i.e. being present + # on sys.meta_path but having no other import + # system functionality), the two methods are identical. + find_module = find_spec + + +def pypy_partial(val): + """ + Adjust for variable stacklevel on partial under PyPy. + + Workaround for #327. + """ + is_pypy = platform.python_implementation() == 'PyPy' + return val + is_pypy diff --git a/lib/importlib_metadata/_functools.py b/lib/importlib_metadata/_functools.py new file mode 100644 index 00000000..71f66bd0 --- /dev/null +++ b/lib/importlib_metadata/_functools.py @@ -0,0 +1,104 @@ +import types +import functools + + +# from jaraco.functools 3.3 +def method_cache(method, cache_wrapper=None): + """ + Wrap lru_cache to support storing the cache data in the object instances. + + Abstracts the common paradigm where the method explicitly saves an + underscore-prefixed protected property on first call and returns that + subsequently. + + >>> class MyClass: + ... calls = 0 + ... + ... @method_cache + ... def method(self, value): + ... self.calls += 1 + ... return value + + >>> a = MyClass() + >>> a.method(3) + 3 + >>> for x in range(75): + ... res = a.method(x) + >>> a.calls + 75 + + Note that the apparent behavior will be exactly like that of lru_cache + except that the cache is stored on each instance, so values in one + instance will not flush values from another, and when an instance is + deleted, so are the cached values for that instance. + + >>> b = MyClass() + >>> for x in range(35): + ... res = b.method(x) + >>> b.calls + 35 + >>> a.method(0) + 0 + >>> a.calls + 75 + + Note that if method had been decorated with ``functools.lru_cache()``, + a.calls would have been 76 (due to the cached value of 0 having been + flushed by the 'b' instance). + + Clear the cache with ``.cache_clear()`` + + >>> a.method.cache_clear() + + Same for a method that hasn't yet been called. + + >>> c = MyClass() + >>> c.method.cache_clear() + + Another cache wrapper may be supplied: + + >>> cache = functools.lru_cache(maxsize=2) + >>> MyClass.method2 = method_cache(lambda self: 3, cache_wrapper=cache) + >>> a = MyClass() + >>> a.method2() + 3 + + Caution - do not subsequently wrap the method with another decorator, such + as ``@property``, which changes the semantics of the function. + + See also + http://code.activestate.com/recipes/577452-a-memoize-decorator-for-instance-methods/ + for another implementation and additional justification. + """ + cache_wrapper = cache_wrapper or functools.lru_cache() + + def wrapper(self, *args, **kwargs): + # it's the first call, replace the method with a cached, bound method + bound_method = types.MethodType(method, self) + cached_method = cache_wrapper(bound_method) + setattr(self, method.__name__, cached_method) + return cached_method(*args, **kwargs) + + # Support cache clear even before cache has been created. + wrapper.cache_clear = lambda: None + + return wrapper + + +# From jaraco.functools 3.3 +def pass_none(func): + """ + Wrap func so it's not called if its first param is None + + >>> print_text = pass_none(print) + >>> print_text('text') + text + >>> print_text(None) + """ + + @functools.wraps(func) + def wrapper(param, *args, **kwargs): + if param is not None: + return func(param, *args, **kwargs) + + return wrapper diff --git a/lib/importlib_metadata/_itertools.py b/lib/importlib_metadata/_itertools.py new file mode 100644 index 00000000..d4ca9b91 --- /dev/null +++ b/lib/importlib_metadata/_itertools.py @@ -0,0 +1,73 @@ +from itertools import filterfalse + + +def unique_everseen(iterable, key=None): + "List unique elements, preserving order. Remember all elements ever seen." + # unique_everseen('AAAABBBCCDAABBB') --> A B C D + # unique_everseen('ABBCcAD', str.lower) --> A B C D + seen = set() + seen_add = seen.add + if key is None: + for element in filterfalse(seen.__contains__, iterable): + seen_add(element) + yield element + else: + for element in iterable: + k = key(element) + if k not in seen: + seen_add(k) + yield element + + +# copied from more_itertools 8.8 +def always_iterable(obj, base_type=(str, bytes)): + """If *obj* is iterable, return an iterator over its items:: + + >>> obj = (1, 2, 3) + >>> list(always_iterable(obj)) + [1, 2, 3] + + If *obj* is not iterable, return a one-item iterable containing *obj*:: + + >>> obj = 1 + >>> list(always_iterable(obj)) + [1] + + If *obj* is ``None``, return an empty iterable: + + >>> obj = None + >>> list(always_iterable(None)) + [] + + By default, binary and text strings are not considered iterable:: + + >>> obj = 'foo' + >>> list(always_iterable(obj)) + ['foo'] + + If *base_type* is set, objects for which ``isinstance(obj, base_type)`` + returns ``True`` won't be considered iterable. + + >>> obj = {'a': 1} + >>> list(always_iterable(obj)) # Iterate over the dict's keys + ['a'] + >>> list(always_iterable(obj, base_type=dict)) # Treat dicts as a unit + [{'a': 1}] + + Set *base_type* to ``None`` to avoid any special handling and treat objects + Python considers iterable as iterable: + + >>> obj = 'foo' + >>> list(always_iterable(obj, base_type=None)) + ['f', 'o', 'o'] + """ + if obj is None: + return iter(()) + + if (base_type is not None) and isinstance(obj, base_type): + return iter((obj,)) + + try: + return iter(obj) + except TypeError: + return iter((obj,)) diff --git a/lib/importlib_metadata/_meta.py b/lib/importlib_metadata/_meta.py new file mode 100644 index 00000000..259b15ba --- /dev/null +++ b/lib/importlib_metadata/_meta.py @@ -0,0 +1,49 @@ +from ._compat import Protocol +from typing import Any, Dict, Iterator, List, TypeVar, Union + + +_T = TypeVar("_T") + + +class PackageMetadata(Protocol): + def __len__(self) -> int: + ... # pragma: no cover + + def __contains__(self, item: str) -> bool: + ... # pragma: no cover + + def __getitem__(self, key: str) -> str: + ... # pragma: no cover + + def __iter__(self) -> Iterator[str]: + ... # pragma: no cover + + def get_all(self, name: str, failobj: _T = ...) -> Union[List[Any], _T]: + """ + Return all values associated with a possibly multi-valued key. + """ + + @property + def json(self) -> Dict[str, Union[str, List[str]]]: + """ + A JSON-compatible form of the metadata. + """ + + +class SimplePath(Protocol[_T]): + """ + A minimal subset of pathlib.Path required by PathDistribution. + """ + + def joinpath(self) -> _T: + ... # pragma: no cover + + def __truediv__(self, other: Union[str, _T]) -> _T: + ... # pragma: no cover + + @property + def parent(self) -> _T: + ... # pragma: no cover + + def read_text(self) -> str: + ... # pragma: no cover diff --git a/lib/importlib_metadata/_py39compat.py b/lib/importlib_metadata/_py39compat.py new file mode 100644 index 00000000..cde4558f --- /dev/null +++ b/lib/importlib_metadata/_py39compat.py @@ -0,0 +1,35 @@ +""" +Compatibility layer with Python 3.8/3.9 +""" +from typing import TYPE_CHECKING, Any, Optional + +if TYPE_CHECKING: # pragma: no cover + # Prevent circular imports on runtime. + from . import Distribution, EntryPoint +else: + Distribution = EntryPoint = Any + + +def normalized_name(dist: Distribution) -> Optional[str]: + """ + Honor name normalization for distributions that don't provide ``_normalized_name``. + """ + try: + return dist._normalized_name + except AttributeError: + from . import Prepared # -> delay to prevent circular imports. + + return Prepared.normalize(getattr(dist, "name", None) or dist.metadata['Name']) + + +def ep_matches(ep: EntryPoint, **params) -> bool: + """ + Workaround for ``EntryPoint`` objects without the ``matches`` method. + """ + try: + return ep.matches(**params) + except AttributeError: + from . import EntryPoint # -> delay to prevent circular imports. + + # Reconstruct the EntryPoint object to make sure it is compatible. + return EntryPoint(ep.name, ep.value, ep.group).matches(**params) diff --git a/lib/importlib_metadata/_text.py b/lib/importlib_metadata/_text.py new file mode 100644 index 00000000..c88cfbb2 --- /dev/null +++ b/lib/importlib_metadata/_text.py @@ -0,0 +1,99 @@ +import re + +from ._functools import method_cache + + +# from jaraco.text 3.5 +class FoldedCase(str): + """ + A case insensitive string class; behaves just like str + except compares equal when the only variation is case. + + >>> s = FoldedCase('hello world') + + >>> s == 'Hello World' + True + + >>> 'Hello World' == s + True + + >>> s != 'Hello World' + False + + >>> s.index('O') + 4 + + >>> s.split('O') + ['hell', ' w', 'rld'] + + >>> sorted(map(FoldedCase, ['GAMMA', 'alpha', 'Beta'])) + ['alpha', 'Beta', 'GAMMA'] + + Sequence membership is straightforward. + + >>> "Hello World" in [s] + True + >>> s in ["Hello World"] + True + + You may test for set inclusion, but candidate and elements + must both be folded. + + >>> FoldedCase("Hello World") in {s} + True + >>> s in {FoldedCase("Hello World")} + True + + String inclusion works as long as the FoldedCase object + is on the right. + + >>> "hello" in FoldedCase("Hello World") + True + + But not if the FoldedCase object is on the left: + + >>> FoldedCase('hello') in 'Hello World' + False + + In that case, use in_: + + >>> FoldedCase('hello').in_('Hello World') + True + + >>> FoldedCase('hello') > FoldedCase('Hello') + False + """ + + def __lt__(self, other): + return self.lower() < other.lower() + + def __gt__(self, other): + return self.lower() > other.lower() + + def __eq__(self, other): + return self.lower() == other.lower() + + def __ne__(self, other): + return self.lower() != other.lower() + + def __hash__(self): + return hash(self.lower()) + + def __contains__(self, other): + return super().lower().__contains__(other.lower()) + + def in_(self, other): + "Does self appear in other?" + return self in FoldedCase(other) + + # cache lower since it's likely to be called frequently. + @method_cache + def lower(self): + return super().lower() + + def index(self, sub): + return self.lower().index(sub.lower()) + + def split(self, splitter=' ', maxsplit=0): + pattern = re.compile(re.escape(splitter), re.I) + return pattern.split(self, maxsplit) diff --git a/lib/importlib_metadata/py.typed b/lib/importlib_metadata/py.typed new file mode 100644 index 00000000..e69de29b diff --git a/lib/importlib_resources/__init__.py b/lib/importlib_resources/__init__.py new file mode 100644 index 00000000..e6b60c18 --- /dev/null +++ b/lib/importlib_resources/__init__.py @@ -0,0 +1,17 @@ +"""Read resources contained within a package.""" + +from ._common import ( + as_file, + files, + Package, +) + +from .abc import ResourceReader + + +__all__ = [ + 'Package', + 'ResourceReader', + 'as_file', + 'files', +] diff --git a/lib/importlib_resources/_adapters.py b/lib/importlib_resources/_adapters.py new file mode 100644 index 00000000..50688fbb --- /dev/null +++ b/lib/importlib_resources/_adapters.py @@ -0,0 +1,168 @@ +from contextlib import suppress +from io import TextIOWrapper + +from . import abc + + +class SpecLoaderAdapter: + """ + Adapt a package spec to adapt the underlying loader. + """ + + def __init__(self, spec, adapter=lambda spec: spec.loader): + self.spec = spec + self.loader = adapter(spec) + + def __getattr__(self, name): + return getattr(self.spec, name) + + +class TraversableResourcesLoader: + """ + Adapt a loader to provide TraversableResources. + """ + + def __init__(self, spec): + self.spec = spec + + def get_resource_reader(self, name): + return CompatibilityFiles(self.spec)._native() + + +def _io_wrapper(file, mode='r', *args, **kwargs): + if mode == 'r': + return TextIOWrapper(file, *args, **kwargs) + elif mode == 'rb': + return file + raise ValueError(f"Invalid mode value '{mode}', only 'r' and 'rb' are supported") + + +class CompatibilityFiles: + """ + Adapter for an existing or non-existent resource reader + to provide a compatibility .files(). + """ + + class SpecPath(abc.Traversable): + """ + Path tied to a module spec. + Can be read and exposes the resource reader children. + """ + + def __init__(self, spec, reader): + self._spec = spec + self._reader = reader + + def iterdir(self): + if not self._reader: + return iter(()) + return iter( + CompatibilityFiles.ChildPath(self._reader, path) + for path in self._reader.contents() + ) + + def is_file(self): + return False + + is_dir = is_file + + def joinpath(self, other): + if not self._reader: + return CompatibilityFiles.OrphanPath(other) + return CompatibilityFiles.ChildPath(self._reader, other) + + @property + def name(self): + return self._spec.name + + def open(self, mode='r', *args, **kwargs): + return _io_wrapper(self._reader.open_resource(None), mode, *args, **kwargs) + + class ChildPath(abc.Traversable): + """ + Path tied to a resource reader child. + Can be read but doesn't expose any meaningful children. + """ + + def __init__(self, reader, name): + self._reader = reader + self._name = name + + def iterdir(self): + return iter(()) + + def is_file(self): + return self._reader.is_resource(self.name) + + def is_dir(self): + return not self.is_file() + + def joinpath(self, other): + return CompatibilityFiles.OrphanPath(self.name, other) + + @property + def name(self): + return self._name + + def open(self, mode='r', *args, **kwargs): + return _io_wrapper( + self._reader.open_resource(self.name), mode, *args, **kwargs + ) + + class OrphanPath(abc.Traversable): + """ + Orphan path, not tied to a module spec or resource reader. + Can't be read and doesn't expose any meaningful children. + """ + + def __init__(self, *path_parts): + if len(path_parts) < 1: + raise ValueError('Need at least one path part to construct a path') + self._path = path_parts + + def iterdir(self): + return iter(()) + + def is_file(self): + return False + + is_dir = is_file + + def joinpath(self, other): + return CompatibilityFiles.OrphanPath(*self._path, other) + + @property + def name(self): + return self._path[-1] + + def open(self, mode='r', *args, **kwargs): + raise FileNotFoundError("Can't open orphan path") + + def __init__(self, spec): + self.spec = spec + + @property + def _reader(self): + with suppress(AttributeError): + return self.spec.loader.get_resource_reader(self.spec.name) + + def _native(self): + """ + Return the native reader if it supports files(). + """ + reader = self._reader + return reader if hasattr(reader, 'files') else self + + def __getattr__(self, attr): + return getattr(self._reader, attr) + + def files(self): + return CompatibilityFiles.SpecPath(self.spec, self._reader) + + +def wrap_spec(package): + """ + Construct a package spec with traversable compatibility + on the spec/loader/reader. + """ + return SpecLoaderAdapter(package.__spec__, TraversableResourcesLoader) diff --git a/lib/importlib_resources/_common.py b/lib/importlib_resources/_common.py new file mode 100644 index 00000000..3c6de1cf --- /dev/null +++ b/lib/importlib_resources/_common.py @@ -0,0 +1,207 @@ +import os +import pathlib +import tempfile +import functools +import contextlib +import types +import importlib +import inspect +import warnings +import itertools + +from typing import Union, Optional, cast +from .abc import ResourceReader, Traversable + +from ._compat import wrap_spec + +Package = Union[types.ModuleType, str] +Anchor = Package + + +def package_to_anchor(func): + """ + Replace 'package' parameter as 'anchor' and warn about the change. + + Other errors should fall through. + + >>> files('a', 'b') + Traceback (most recent call last): + TypeError: files() takes from 0 to 1 positional arguments but 2 were given + """ + undefined = object() + + @functools.wraps(func) + def wrapper(anchor=undefined, package=undefined): + if package is not undefined: + if anchor is not undefined: + return func(anchor, package) + warnings.warn( + "First parameter to files is renamed to 'anchor'", + DeprecationWarning, + stacklevel=2, + ) + return func(package) + elif anchor is undefined: + return func() + return func(anchor) + + return wrapper + + +@package_to_anchor +def files(anchor: Optional[Anchor] = None) -> Traversable: + """ + Get a Traversable resource for an anchor. + """ + return from_package(resolve(anchor)) + + +def get_resource_reader(package: types.ModuleType) -> Optional[ResourceReader]: + """ + Return the package's loader if it's a ResourceReader. + """ + # We can't use + # a issubclass() check here because apparently abc.'s __subclasscheck__() + # hook wants to create a weak reference to the object, but + # zipimport.zipimporter does not support weak references, resulting in a + # TypeError. That seems terrible. + spec = package.__spec__ + reader = getattr(spec.loader, 'get_resource_reader', None) # type: ignore + if reader is None: + return None + return reader(spec.name) # type: ignore + + +@functools.singledispatch +def resolve(cand: Optional[Anchor]) -> types.ModuleType: + return cast(types.ModuleType, cand) + + +@resolve.register +def _(cand: str) -> types.ModuleType: + return importlib.import_module(cand) + + +@resolve.register +def _(cand: None) -> types.ModuleType: + return resolve(_infer_caller().f_globals['__name__']) + + +def _infer_caller(): + """ + Walk the stack and find the frame of the first caller not in this module. + """ + + def is_this_file(frame_info): + return frame_info.filename == __file__ + + def is_wrapper(frame_info): + return frame_info.function == 'wrapper' + + not_this_file = itertools.filterfalse(is_this_file, inspect.stack()) + # also exclude 'wrapper' due to singledispatch in the call stack + callers = itertools.filterfalse(is_wrapper, not_this_file) + return next(callers).frame + + +def from_package(package: types.ModuleType): + """ + Return a Traversable object for the given package. + + """ + spec = wrap_spec(package) + reader = spec.loader.get_resource_reader(spec.name) + return reader.files() + + +@contextlib.contextmanager +def _tempfile( + reader, + suffix='', + # gh-93353: Keep a reference to call os.remove() in late Python + # finalization. + *, + _os_remove=os.remove, +): + # Not using tempfile.NamedTemporaryFile as it leads to deeper 'try' + # blocks due to the need to close the temporary file to work on Windows + # properly. + fd, raw_path = tempfile.mkstemp(suffix=suffix) + try: + try: + os.write(fd, reader()) + finally: + os.close(fd) + del reader + yield pathlib.Path(raw_path) + finally: + try: + _os_remove(raw_path) + except FileNotFoundError: + pass + + +def _temp_file(path): + return _tempfile(path.read_bytes, suffix=path.name) + + +def _is_present_dir(path: Traversable) -> bool: + """ + Some Traversables implement ``is_dir()`` to raise an + exception (i.e. ``FileNotFoundError``) when the + directory doesn't exist. This function wraps that call + to always return a boolean and only return True + if there's a dir and it exists. + """ + with contextlib.suppress(FileNotFoundError): + return path.is_dir() + return False + + +@functools.singledispatch +def as_file(path): + """ + Given a Traversable object, return that object as a + path on the local file system in a context manager. + """ + return _temp_dir(path) if _is_present_dir(path) else _temp_file(path) + + +@as_file.register(pathlib.Path) +@contextlib.contextmanager +def _(path): + """ + Degenerate behavior for pathlib.Path objects. + """ + yield path + + +@contextlib.contextmanager +def _temp_path(dir: tempfile.TemporaryDirectory): + """ + Wrap tempfile.TemporyDirectory to return a pathlib object. + """ + with dir as result: + yield pathlib.Path(result) + + +@contextlib.contextmanager +def _temp_dir(path): + """ + Given a traversable dir, recursively replicate the whole tree + to the file system in a context manager. + """ + assert path.is_dir() + with _temp_path(tempfile.TemporaryDirectory()) as temp_dir: + yield _write_contents(temp_dir, path) + + +def _write_contents(target, source): + child = target.joinpath(source.name) + if source.is_dir(): + child.mkdir() + for item in source.iterdir(): + _write_contents(child, item) + else: + child.write_bytes(source.read_bytes()) + return child diff --git a/lib/importlib_resources/_compat.py b/lib/importlib_resources/_compat.py new file mode 100644 index 00000000..a93a8826 --- /dev/null +++ b/lib/importlib_resources/_compat.py @@ -0,0 +1,109 @@ +# flake8: noqa + +import abc +import os +import sys +import pathlib +from contextlib import suppress +from typing import Union + + +if sys.version_info >= (3, 10): + from zipfile import Path as ZipPath # type: ignore +else: + from zipp import Path as ZipPath # type: ignore + + +try: + from typing import runtime_checkable # type: ignore +except ImportError: + + def runtime_checkable(cls): # type: ignore + return cls + + +try: + from typing import Protocol # type: ignore +except ImportError: + Protocol = abc.ABC # type: ignore + + +class TraversableResourcesLoader: + """ + Adapt loaders to provide TraversableResources and other + compatibility. + + Used primarily for Python 3.9 and earlier where the native + loaders do not yet implement TraversableResources. + """ + + def __init__(self, spec): + self.spec = spec + + @property + def path(self): + return self.spec.origin + + def get_resource_reader(self, name): + from . import readers, _adapters + + def _zip_reader(spec): + with suppress(AttributeError): + return readers.ZipReader(spec.loader, spec.name) + + def _namespace_reader(spec): + with suppress(AttributeError, ValueError): + return readers.NamespaceReader(spec.submodule_search_locations) + + def _available_reader(spec): + with suppress(AttributeError): + return spec.loader.get_resource_reader(spec.name) + + def _native_reader(spec): + reader = _available_reader(spec) + return reader if hasattr(reader, 'files') else None + + def _file_reader(spec): + try: + path = pathlib.Path(self.path) + except TypeError: + return None + if path.exists(): + return readers.FileReader(self) + + return ( + # local ZipReader if a zip module + _zip_reader(self.spec) + or + # local NamespaceReader if a namespace module + _namespace_reader(self.spec) + or + # local FileReader + _file_reader(self.spec) + or + # native reader if it supplies 'files' + _native_reader(self.spec) + or + # fallback - adapt the spec ResourceReader to TraversableReader + _adapters.CompatibilityFiles(self.spec) + ) + + +def wrap_spec(package): + """ + Construct a package spec with traversable compatibility + on the spec/loader/reader. + + Supersedes _adapters.wrap_spec to use TraversableResourcesLoader + from above for older Python compatibility (<3.10). + """ + from . import _adapters + + return _adapters.SpecLoaderAdapter(package.__spec__, TraversableResourcesLoader) + + +if sys.version_info >= (3, 9): + StrPath = Union[str, os.PathLike[str]] +else: + # PathLike is only subscriptable at runtime in 3.9+ + StrPath = Union[str, "os.PathLike[str]"] diff --git a/lib/importlib_resources/_itertools.py b/lib/importlib_resources/_itertools.py new file mode 100644 index 00000000..7b775ef5 --- /dev/null +++ b/lib/importlib_resources/_itertools.py @@ -0,0 +1,38 @@ +# from more_itertools 9.0 +def only(iterable, default=None, too_long=None): + """If *iterable* has only one item, return it. + If it has zero items, return *default*. + If it has more than one item, raise the exception given by *too_long*, + which is ``ValueError`` by default. + >>> only([], default='missing') + 'missing' + >>> only([1]) + 1 + >>> only([1, 2]) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + ValueError: Expected exactly one item in iterable, but got 1, 2, + and perhaps more.' + >>> only([1, 2], too_long=TypeError) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + TypeError + Note that :func:`only` attempts to advance *iterable* twice to ensure there + is only one item. See :func:`spy` or :func:`peekable` to check + iterable contents less destructively. + """ + it = iter(iterable) + first_value = next(it, default) + + try: + second_value = next(it) + except StopIteration: + pass + else: + msg = ( + 'Expected exactly one item in iterable, but got {!r}, {!r}, ' + 'and perhaps more.'.format(first_value, second_value) + ) + raise too_long or ValueError(msg) + + return first_value diff --git a/lib/importlib_resources/abc.py b/lib/importlib_resources/abc.py new file mode 100644 index 00000000..23b6aeaf --- /dev/null +++ b/lib/importlib_resources/abc.py @@ -0,0 +1,170 @@ +import abc +import io +import itertools +import pathlib +from typing import Any, BinaryIO, Iterable, Iterator, NoReturn, Text, Optional + +from ._compat import runtime_checkable, Protocol, StrPath + + +__all__ = ["ResourceReader", "Traversable", "TraversableResources"] + + +class ResourceReader(metaclass=abc.ABCMeta): + """Abstract base class for loaders to provide resource reading support.""" + + @abc.abstractmethod + def open_resource(self, resource: Text) -> BinaryIO: + """Return an opened, file-like object for binary reading. + + The 'resource' argument is expected to represent only a file name. + If the resource cannot be found, FileNotFoundError is raised. + """ + # This deliberately raises FileNotFoundError instead of + # NotImplementedError so that if this method is accidentally called, + # it'll still do the right thing. + raise FileNotFoundError + + @abc.abstractmethod + def resource_path(self, resource: Text) -> Text: + """Return the file system path to the specified resource. + + The 'resource' argument is expected to represent only a file name. + If the resource does not exist on the file system, raise + FileNotFoundError. + """ + # This deliberately raises FileNotFoundError instead of + # NotImplementedError so that if this method is accidentally called, + # it'll still do the right thing. + raise FileNotFoundError + + @abc.abstractmethod + def is_resource(self, path: Text) -> bool: + """Return True if the named 'path' is a resource. + + Files are resources, directories are not. + """ + raise FileNotFoundError + + @abc.abstractmethod + def contents(self) -> Iterable[str]: + """Return an iterable of entries in `package`.""" + raise FileNotFoundError + + +class TraversalError(Exception): + pass + + +@runtime_checkable +class Traversable(Protocol): + """ + An object with a subset of pathlib.Path methods suitable for + traversing directories and opening files. + + Any exceptions that occur when accessing the backing resource + may propagate unaltered. + """ + + @abc.abstractmethod + def iterdir(self) -> Iterator["Traversable"]: + """ + Yield Traversable objects in self + """ + + def read_bytes(self) -> bytes: + """ + Read contents of self as bytes + """ + with self.open('rb') as strm: + return strm.read() + + def read_text(self, encoding: Optional[str] = None) -> str: + """ + Read contents of self as text + """ + with self.open(encoding=encoding) as strm: + return strm.read() + + @abc.abstractmethod + def is_dir(self) -> bool: + """ + Return True if self is a directory + """ + + @abc.abstractmethod + def is_file(self) -> bool: + """ + Return True if self is a file + """ + + def joinpath(self, *descendants: StrPath) -> "Traversable": + """ + Return Traversable resolved with any descendants applied. + + Each descendant should be a path segment relative to self + and each may contain multiple levels separated by + ``posixpath.sep`` (``/``). + """ + if not descendants: + return self + names = itertools.chain.from_iterable( + path.parts for path in map(pathlib.PurePosixPath, descendants) + ) + target = next(names) + matches = ( + traversable for traversable in self.iterdir() if traversable.name == target + ) + try: + match = next(matches) + except StopIteration: + raise TraversalError( + "Target not found during traversal.", target, list(names) + ) + return match.joinpath(*names) + + def __truediv__(self, child: StrPath) -> "Traversable": + """ + Return Traversable child in self + """ + return self.joinpath(child) + + @abc.abstractmethod + def open(self, mode='r', *args, **kwargs): + """ + mode may be 'r' or 'rb' to open as text or binary. Return a handle + suitable for reading (same as pathlib.Path.open). + + When opening as text, accepts encoding parameters such as those + accepted by io.TextIOWrapper. + """ + + @property + @abc.abstractmethod + def name(self) -> str: + """ + The base name of this object without any parent references. + """ + + +class TraversableResources(ResourceReader): + """ + The required interface for providing traversable + resources. + """ + + @abc.abstractmethod + def files(self) -> "Traversable": + """Return a Traversable object for the loaded package.""" + + def open_resource(self, resource: StrPath) -> io.BufferedReader: + return self.files().joinpath(resource).open('rb') + + def resource_path(self, resource: Any) -> NoReturn: + raise FileNotFoundError(resource) + + def is_resource(self, path: StrPath) -> bool: + return self.files().joinpath(path).is_file() + + def contents(self) -> Iterator[str]: + return (item.name for item in self.files().iterdir()) diff --git a/lib/importlib_resources/py.typed b/lib/importlib_resources/py.typed new file mode 100644 index 00000000..e69de29b diff --git a/lib/importlib_resources/readers.py b/lib/importlib_resources/readers.py new file mode 100644 index 00000000..51d030a6 --- /dev/null +++ b/lib/importlib_resources/readers.py @@ -0,0 +1,144 @@ +import collections +import itertools +import pathlib +import operator + +from . import abc + +from ._itertools import only +from ._compat import ZipPath + + +def remove_duplicates(items): + return iter(collections.OrderedDict.fromkeys(items)) + + +class FileReader(abc.TraversableResources): + def __init__(self, loader): + self.path = pathlib.Path(loader.path).parent + + def resource_path(self, resource): + """ + Return the file system path to prevent + `resources.path()` from creating a temporary + copy. + """ + return str(self.path.joinpath(resource)) + + def files(self): + return self.path + + +class ZipReader(abc.TraversableResources): + def __init__(self, loader, module): + _, _, name = module.rpartition('.') + self.prefix = loader.prefix.replace('\\', '/') + name + '/' + self.archive = loader.archive + + def open_resource(self, resource): + try: + return super().open_resource(resource) + except KeyError as exc: + raise FileNotFoundError(exc.args[0]) + + def is_resource(self, path): + """ + Workaround for `zipfile.Path.is_file` returning true + for non-existent paths. + """ + target = self.files().joinpath(path) + return target.is_file() and target.exists() + + def files(self): + return ZipPath(self.archive, self.prefix) + + +class MultiplexedPath(abc.Traversable): + """ + Given a series of Traversable objects, implement a merged + version of the interface across all objects. Useful for + namespace packages which may be multihomed at a single + name. + """ + + def __init__(self, *paths): + self._paths = list(map(pathlib.Path, remove_duplicates(paths))) + if not self._paths: + message = 'MultiplexedPath must contain at least one path' + raise FileNotFoundError(message) + if not all(path.is_dir() for path in self._paths): + raise NotADirectoryError('MultiplexedPath only supports directories') + + def iterdir(self): + children = (child for path in self._paths for child in path.iterdir()) + by_name = operator.attrgetter('name') + groups = itertools.groupby(sorted(children, key=by_name), key=by_name) + return map(self._follow, (locs for name, locs in groups)) + + def read_bytes(self): + raise FileNotFoundError(f'{self} is not a file') + + def read_text(self, *args, **kwargs): + raise FileNotFoundError(f'{self} is not a file') + + def is_dir(self): + return True + + def is_file(self): + return False + + def joinpath(self, *descendants): + try: + return super().joinpath(*descendants) + except abc.TraversalError: + # One of the paths did not resolve (a directory does not exist). + # Just return something that will not exist. + return self._paths[0].joinpath(*descendants) + + @classmethod + def _follow(cls, children): + """ + Construct a MultiplexedPath if needed. + + If children contains a sole element, return it. + Otherwise, return a MultiplexedPath of the items. + Unless one of the items is not a Directory, then return the first. + """ + subdirs, one_dir, one_file = itertools.tee(children, 3) + + try: + return only(one_dir) + except ValueError: + try: + return cls(*subdirs) + except NotADirectoryError: + return next(one_file) + + def open(self, *args, **kwargs): + raise FileNotFoundError(f'{self} is not a file') + + @property + def name(self): + return self._paths[0].name + + def __repr__(self): + paths = ', '.join(f"'{path}'" for path in self._paths) + return f'MultiplexedPath({paths})' + + +class NamespaceReader(abc.TraversableResources): + def __init__(self, namespace_path): + if 'NamespacePath' not in str(namespace_path): + raise ValueError('Invalid path') + self.path = MultiplexedPath(*list(namespace_path)) + + def resource_path(self, resource): + """ + Return the file system path to prevent + `resources.path()` from creating a temporary + copy. + """ + return str(self.path.joinpath(resource)) + + def files(self): + return self.path diff --git a/lib/importlib_resources/simple.py b/lib/importlib_resources/simple.py new file mode 100644 index 00000000..7770c922 --- /dev/null +++ b/lib/importlib_resources/simple.py @@ -0,0 +1,106 @@ +""" +Interface adapters for low-level readers. +""" + +import abc +import io +import itertools +from typing import BinaryIO, List + +from .abc import Traversable, TraversableResources + + +class SimpleReader(abc.ABC): + """ + The minimum, low-level interface required from a resource + provider. + """ + + @property + @abc.abstractmethod + def package(self) -> str: + """ + The name of the package for which this reader loads resources. + """ + + @abc.abstractmethod + def children(self) -> List['SimpleReader']: + """ + Obtain an iterable of SimpleReader for available + child containers (e.g. directories). + """ + + @abc.abstractmethod + def resources(self) -> List[str]: + """ + Obtain available named resources for this virtual package. + """ + + @abc.abstractmethod + def open_binary(self, resource: str) -> BinaryIO: + """ + Obtain a File-like for a named resource. + """ + + @property + def name(self): + return self.package.split('.')[-1] + + +class ResourceContainer(Traversable): + """ + Traversable container for a package's resources via its reader. + """ + + def __init__(self, reader: SimpleReader): + self.reader = reader + + def is_dir(self): + return True + + def is_file(self): + return False + + def iterdir(self): + files = (ResourceHandle(self, name) for name in self.reader.resources) + dirs = map(ResourceContainer, self.reader.children()) + return itertools.chain(files, dirs) + + def open(self, *args, **kwargs): + raise IsADirectoryError() + + +class ResourceHandle(Traversable): + """ + Handle to a named resource in a ResourceReader. + """ + + def __init__(self, parent: ResourceContainer, name: str): + self.parent = parent + self.name = name # type: ignore + + def is_file(self): + return True + + def is_dir(self): + return False + + def open(self, mode='r', *args, **kwargs): + stream = self.parent.reader.open_binary(self.name) + if 'b' not in mode: + stream = io.TextIOWrapper(*args, **kwargs) + return stream + + def joinpath(self, name): + raise RuntimeError("Cannot traverse into a resource") + + +class TraversableReader(TraversableResources, SimpleReader): + """ + A TraversableResources based on SimpleReader. Resource providers + may derive from this class to provide the TraversableResources + interface by supplying the SimpleReader interface. + """ + + def files(self): + return ResourceContainer(self) diff --git a/lib/importlib_resources/tests/__init__.py b/lib/importlib_resources/tests/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/importlib_resources/tests/_compat.py b/lib/importlib_resources/tests/_compat.py new file mode 100644 index 00000000..e7bf06dd --- /dev/null +++ b/lib/importlib_resources/tests/_compat.py @@ -0,0 +1,32 @@ +import os + + +try: + from test.support import import_helper # type: ignore +except ImportError: + # Python 3.9 and earlier + class import_helper: # type: ignore + from test.support import ( + modules_setup, + modules_cleanup, + DirsOnSysPath, + CleanImport, + ) + + +try: + from test.support import os_helper # type: ignore +except ImportError: + # Python 3.9 compat + class os_helper: # type:ignore + from test.support import temp_dir + + +try: + # Python 3.10 + from test.support.os_helper import unlink +except ImportError: + from test.support import unlink as _unlink + + def unlink(target): + return _unlink(os.fspath(target)) diff --git a/lib/importlib_resources/tests/_path.py b/lib/importlib_resources/tests/_path.py new file mode 100644 index 00000000..1f97c961 --- /dev/null +++ b/lib/importlib_resources/tests/_path.py @@ -0,0 +1,56 @@ +import pathlib +import functools + +from typing import Dict, Union + + +#### +# from jaraco.path 3.4.1 + +FilesSpec = Dict[str, Union[str, bytes, 'FilesSpec']] # type: ignore + + +def build(spec: FilesSpec, prefix=pathlib.Path()): + """ + Build a set of files/directories, as described by the spec. + + Each key represents a pathname, and the value represents + the content. Content may be a nested directory. + + >>> spec = { + ... 'README.txt': "A README file", + ... "foo": { + ... "__init__.py": "", + ... "bar": { + ... "__init__.py": "", + ... }, + ... "baz.py": "# Some code", + ... } + ... } + >>> target = getfixture('tmp_path') + >>> build(spec, target) + >>> target.joinpath('foo/baz.py').read_text(encoding='utf-8') + '# Some code' + """ + for name, contents in spec.items(): + create(contents, pathlib.Path(prefix) / name) + + +@functools.singledispatch +def create(content: Union[str, bytes, FilesSpec], path): + path.mkdir(exist_ok=True) + build(content, prefix=path) # type: ignore + + +@create.register +def _(content: bytes, path): + path.write_bytes(content) + + +@create.register +def _(content: str, path): + path.write_text(content, encoding='utf-8') + + +# end from jaraco.path +#### diff --git a/lib/importlib_resources/tests/data01/__init__.py b/lib/importlib_resources/tests/data01/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/importlib_resources/tests/data01/binary.file b/lib/importlib_resources/tests/data01/binary.file new file mode 100644 index 0000000000000000000000000000000000000000..eaf36c1daccfdf325514461cd1a2ffbc139b5464 GIT binary patch literal 4 LcmZQzWMT#Y01f~L literal 0 HcmV?d00001 diff --git a/lib/importlib_resources/tests/data01/subdirectory/__init__.py b/lib/importlib_resources/tests/data01/subdirectory/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/importlib_resources/tests/data01/subdirectory/binary.file b/lib/importlib_resources/tests/data01/subdirectory/binary.file new file mode 100644 index 0000000000000000000000000000000000000000..eaf36c1daccfdf325514461cd1a2ffbc139b5464 GIT binary patch literal 4 LcmZQzWMT#Y01f~L literal 0 HcmV?d00001 diff --git a/lib/importlib_resources/tests/data01/utf-16.file b/lib/importlib_resources/tests/data01/utf-16.file new file mode 100644 index 0000000000000000000000000000000000000000..2cb772295ef4b480a8d83725bd5006a0236d8f68 GIT binary patch literal 44 ucmezW&x0YAAqNQa8FUyF7(y9B7~B|i84MZBfV^^`Xc15@g+Y;liva-T)Ce>H literal 0 HcmV?d00001 diff --git a/lib/importlib_resources/tests/data01/utf-8.file b/lib/importlib_resources/tests/data01/utf-8.file new file mode 100644 index 00000000..1c0132ad --- /dev/null +++ b/lib/importlib_resources/tests/data01/utf-8.file @@ -0,0 +1 @@ +Hello, UTF-8 world! diff --git a/lib/importlib_resources/tests/data02/__init__.py b/lib/importlib_resources/tests/data02/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/importlib_resources/tests/data02/one/__init__.py b/lib/importlib_resources/tests/data02/one/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/importlib_resources/tests/data02/one/resource1.txt b/lib/importlib_resources/tests/data02/one/resource1.txt new file mode 100644 index 00000000..61a813e4 --- /dev/null +++ b/lib/importlib_resources/tests/data02/one/resource1.txt @@ -0,0 +1 @@ +one resource diff --git a/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt b/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt new file mode 100644 index 00000000..48f587a2 --- /dev/null +++ b/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt @@ -0,0 +1 @@ +a resource \ No newline at end of file diff --git a/lib/importlib_resources/tests/data02/two/__init__.py b/lib/importlib_resources/tests/data02/two/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/importlib_resources/tests/data02/two/resource2.txt b/lib/importlib_resources/tests/data02/two/resource2.txt new file mode 100644 index 00000000..a80ce46e --- /dev/null +++ b/lib/importlib_resources/tests/data02/two/resource2.txt @@ -0,0 +1 @@ +two resource diff --git a/lib/importlib_resources/tests/namespacedata01/binary.file b/lib/importlib_resources/tests/namespacedata01/binary.file new file mode 100644 index 0000000000000000000000000000000000000000..eaf36c1daccfdf325514461cd1a2ffbc139b5464 GIT binary patch literal 4 LcmZQzWMT#Y01f~L literal 0 HcmV?d00001 diff --git a/lib/importlib_resources/tests/namespacedata01/utf-16.file b/lib/importlib_resources/tests/namespacedata01/utf-16.file new file mode 100644 index 0000000000000000000000000000000000000000..2cb772295ef4b480a8d83725bd5006a0236d8f68 GIT binary patch literal 44 ucmezW&x0YAAqNQa8FUyF7(y9B7~B|i84MZBfV^^`Xc15@g+Y;liva-T)Ce>H literal 0 HcmV?d00001 diff --git a/lib/importlib_resources/tests/namespacedata01/utf-8.file b/lib/importlib_resources/tests/namespacedata01/utf-8.file new file mode 100644 index 00000000..1c0132ad --- /dev/null +++ b/lib/importlib_resources/tests/namespacedata01/utf-8.file @@ -0,0 +1 @@ +Hello, UTF-8 world! diff --git a/lib/importlib_resources/tests/test_compatibilty_files.py b/lib/importlib_resources/tests/test_compatibilty_files.py new file mode 100644 index 00000000..13ad0dfb --- /dev/null +++ b/lib/importlib_resources/tests/test_compatibilty_files.py @@ -0,0 +1,104 @@ +import io +import unittest + +import importlib_resources as resources + +from importlib_resources._adapters import ( + CompatibilityFiles, + wrap_spec, +) + +from . import util + + +class CompatibilityFilesTests(unittest.TestCase): + @property + def package(self): + bytes_data = io.BytesIO(b'Hello, world!') + return util.create_package( + file=bytes_data, + path='some_path', + contents=('a', 'b', 'c'), + ) + + @property + def files(self): + return resources.files(self.package) + + def test_spec_path_iter(self): + self.assertEqual( + sorted(path.name for path in self.files.iterdir()), + ['a', 'b', 'c'], + ) + + def test_child_path_iter(self): + self.assertEqual(list((self.files / 'a').iterdir()), []) + + def test_orphan_path_iter(self): + self.assertEqual(list((self.files / 'a' / 'a').iterdir()), []) + self.assertEqual(list((self.files / 'a' / 'a' / 'a').iterdir()), []) + + def test_spec_path_is(self): + self.assertFalse(self.files.is_file()) + self.assertFalse(self.files.is_dir()) + + def test_child_path_is(self): + self.assertTrue((self.files / 'a').is_file()) + self.assertFalse((self.files / 'a').is_dir()) + + def test_orphan_path_is(self): + self.assertFalse((self.files / 'a' / 'a').is_file()) + self.assertFalse((self.files / 'a' / 'a').is_dir()) + self.assertFalse((self.files / 'a' / 'a' / 'a').is_file()) + self.assertFalse((self.files / 'a' / 'a' / 'a').is_dir()) + + def test_spec_path_name(self): + self.assertEqual(self.files.name, 'testingpackage') + + def test_child_path_name(self): + self.assertEqual((self.files / 'a').name, 'a') + + def test_orphan_path_name(self): + self.assertEqual((self.files / 'a' / 'b').name, 'b') + self.assertEqual((self.files / 'a' / 'b' / 'c').name, 'c') + + def test_spec_path_open(self): + self.assertEqual(self.files.read_bytes(), b'Hello, world!') + self.assertEqual(self.files.read_text(encoding='utf-8'), 'Hello, world!') + + def test_child_path_open(self): + self.assertEqual((self.files / 'a').read_bytes(), b'Hello, world!') + self.assertEqual( + (self.files / 'a').read_text(encoding='utf-8'), 'Hello, world!' + ) + + def test_orphan_path_open(self): + with self.assertRaises(FileNotFoundError): + (self.files / 'a' / 'b').read_bytes() + with self.assertRaises(FileNotFoundError): + (self.files / 'a' / 'b' / 'c').read_bytes() + + def test_open_invalid_mode(self): + with self.assertRaises(ValueError): + self.files.open('0') + + def test_orphan_path_invalid(self): + with self.assertRaises(ValueError): + CompatibilityFiles.OrphanPath() + + def test_wrap_spec(self): + spec = wrap_spec(self.package) + self.assertIsInstance(spec.loader.get_resource_reader(None), CompatibilityFiles) + + +class CompatibilityFilesNoReaderTests(unittest.TestCase): + @property + def package(self): + return util.create_package_from_loader(None) + + @property + def files(self): + return resources.files(self.package) + + def test_spec_path_joinpath(self): + self.assertIsInstance(self.files / 'a', CompatibilityFiles.OrphanPath) diff --git a/lib/importlib_resources/tests/test_contents.py b/lib/importlib_resources/tests/test_contents.py new file mode 100644 index 00000000..525568e8 --- /dev/null +++ b/lib/importlib_resources/tests/test_contents.py @@ -0,0 +1,43 @@ +import unittest +import importlib_resources as resources + +from . import data01 +from . import util + + +class ContentsTests: + expected = { + '__init__.py', + 'binary.file', + 'subdirectory', + 'utf-16.file', + 'utf-8.file', + } + + def test_contents(self): + contents = {path.name for path in resources.files(self.data).iterdir()} + assert self.expected <= contents + + +class ContentsDiskTests(ContentsTests, unittest.TestCase): + def setUp(self): + self.data = data01 + + +class ContentsZipTests(ContentsTests, util.ZipSetup, unittest.TestCase): + pass + + +class ContentsNamespaceTests(ContentsTests, unittest.TestCase): + expected = { + # no __init__ because of namespace design + # no subdirectory as incidental difference in fixture + 'binary.file', + 'utf-16.file', + 'utf-8.file', + } + + def setUp(self): + from . import namespacedata01 + + self.data = namespacedata01 diff --git a/lib/importlib_resources/tests/test_custom.py b/lib/importlib_resources/tests/test_custom.py new file mode 100644 index 00000000..e85ddd65 --- /dev/null +++ b/lib/importlib_resources/tests/test_custom.py @@ -0,0 +1,45 @@ +import unittest +import contextlib +import pathlib + +import importlib_resources as resources +from ..abc import TraversableResources, ResourceReader +from . import util +from ._compat import os_helper + + +class SimpleLoader: + """ + A simple loader that only implements a resource reader. + """ + + def __init__(self, reader: ResourceReader): + self.reader = reader + + def get_resource_reader(self, package): + return self.reader + + +class MagicResources(TraversableResources): + """ + Magically returns the resources at path. + """ + + def __init__(self, path: pathlib.Path): + self.path = path + + def files(self): + return self.path + + +class CustomTraversableResourcesTests(unittest.TestCase): + def setUp(self): + self.fixtures = contextlib.ExitStack() + self.addCleanup(self.fixtures.close) + + def test_custom_loader(self): + temp_dir = self.fixtures.enter_context(os_helper.temp_dir()) + loader = SimpleLoader(MagicResources(temp_dir)) + pkg = util.create_package_from_loader(loader) + files = resources.files(pkg) + assert files is temp_dir diff --git a/lib/importlib_resources/tests/test_files.py b/lib/importlib_resources/tests/test_files.py new file mode 100644 index 00000000..197a063b --- /dev/null +++ b/lib/importlib_resources/tests/test_files.py @@ -0,0 +1,112 @@ +import typing +import textwrap +import unittest +import warnings +import importlib +import contextlib + +import importlib_resources as resources +from ..abc import Traversable +from . import data01 +from . import util +from . import _path +from ._compat import os_helper, import_helper + + +@contextlib.contextmanager +def suppress_known_deprecation(): + with warnings.catch_warnings(record=True) as ctx: + warnings.simplefilter('default', category=DeprecationWarning) + yield ctx + + +class FilesTests: + def test_read_bytes(self): + files = resources.files(self.data) + actual = files.joinpath('utf-8.file').read_bytes() + assert actual == b'Hello, UTF-8 world!\n' + + def test_read_text(self): + files = resources.files(self.data) + actual = files.joinpath('utf-8.file').read_text(encoding='utf-8') + assert actual == 'Hello, UTF-8 world!\n' + + @unittest.skipUnless( + hasattr(typing, 'runtime_checkable'), + "Only suitable when typing supports runtime_checkable", + ) + def test_traversable(self): + assert isinstance(resources.files(self.data), Traversable) + + def test_old_parameter(self): + """ + Files used to take a 'package' parameter. Make sure anyone + passing by name is still supported. + """ + with suppress_known_deprecation(): + resources.files(package=self.data) + + +class OpenDiskTests(FilesTests, unittest.TestCase): + def setUp(self): + self.data = data01 + + +class OpenZipTests(FilesTests, util.ZipSetup, unittest.TestCase): + pass + + +class OpenNamespaceTests(FilesTests, unittest.TestCase): + def setUp(self): + from . import namespacedata01 + + self.data = namespacedata01 + + +class SiteDir: + def setUp(self): + self.fixtures = contextlib.ExitStack() + self.addCleanup(self.fixtures.close) + self.site_dir = self.fixtures.enter_context(os_helper.temp_dir()) + self.fixtures.enter_context(import_helper.DirsOnSysPath(self.site_dir)) + self.fixtures.enter_context(import_helper.CleanImport()) + + +class ModulesFilesTests(SiteDir, unittest.TestCase): + def test_module_resources(self): + """ + A module can have resources found adjacent to the module. + """ + spec = { + 'mod.py': '', + 'res.txt': 'resources are the best', + } + _path.build(spec, self.site_dir) + import mod + + actual = resources.files(mod).joinpath('res.txt').read_text(encoding='utf-8') + assert actual == spec['res.txt'] + + +class ImplicitContextFilesTests(SiteDir, unittest.TestCase): + def test_implicit_files(self): + """ + Without any parameter, files() will infer the location as the caller. + """ + spec = { + 'somepkg': { + '__init__.py': textwrap.dedent( + """ + import importlib_resources as res + val = res.files().joinpath('res.txt').read_text(encoding='utf-8') + """ + ), + 'res.txt': 'resources are the best', + }, + } + _path.build(spec, self.site_dir) + assert importlib.import_module('somepkg').val == 'resources are the best' + + +if __name__ == '__main__': + unittest.main() diff --git a/lib/importlib_resources/tests/test_open.py b/lib/importlib_resources/tests/test_open.py new file mode 100644 index 00000000..83b737dc --- /dev/null +++ b/lib/importlib_resources/tests/test_open.py @@ -0,0 +1,85 @@ +import unittest + +import importlib_resources as resources +from . import data01 +from . import util + + +class CommonBinaryTests(util.CommonTests, unittest.TestCase): + def execute(self, package, path): + target = resources.files(package).joinpath(path) + with target.open('rb'): + pass + + +class CommonTextTests(util.CommonTests, unittest.TestCase): + def execute(self, package, path): + target = resources.files(package).joinpath(path) + with target.open(encoding='utf-8'): + pass + + +class OpenTests: + def test_open_binary(self): + target = resources.files(self.data) / 'binary.file' + with target.open('rb') as fp: + result = fp.read() + self.assertEqual(result, b'\x00\x01\x02\x03') + + def test_open_text_default_encoding(self): + target = resources.files(self.data) / 'utf-8.file' + with target.open(encoding='utf-8') as fp: + result = fp.read() + self.assertEqual(result, 'Hello, UTF-8 world!\n') + + def test_open_text_given_encoding(self): + target = resources.files(self.data) / 'utf-16.file' + with target.open(encoding='utf-16', errors='strict') as fp: + result = fp.read() + self.assertEqual(result, 'Hello, UTF-16 world!\n') + + def test_open_text_with_errors(self): + """ + Raises UnicodeError without the 'errors' argument. + """ + target = resources.files(self.data) / 'utf-16.file' + with target.open(encoding='utf-8', errors='strict') as fp: + self.assertRaises(UnicodeError, fp.read) + with target.open(encoding='utf-8', errors='ignore') as fp: + result = fp.read() + self.assertEqual( + result, + 'H\x00e\x00l\x00l\x00o\x00,\x00 ' + '\x00U\x00T\x00F\x00-\x001\x006\x00 ' + '\x00w\x00o\x00r\x00l\x00d\x00!\x00\n\x00', + ) + + def test_open_binary_FileNotFoundError(self): + target = resources.files(self.data) / 'does-not-exist' + with self.assertRaises(FileNotFoundError): + target.open('rb') + + def test_open_text_FileNotFoundError(self): + target = resources.files(self.data) / 'does-not-exist' + with self.assertRaises(FileNotFoundError): + target.open(encoding='utf-8') + + +class OpenDiskTests(OpenTests, unittest.TestCase): + def setUp(self): + self.data = data01 + + +class OpenDiskNamespaceTests(OpenTests, unittest.TestCase): + def setUp(self): + from . import namespacedata01 + + self.data = namespacedata01 + + +class OpenZipTests(OpenTests, util.ZipSetup, unittest.TestCase): + pass + + +if __name__ == '__main__': + unittest.main() diff --git a/lib/importlib_resources/tests/test_path.py b/lib/importlib_resources/tests/test_path.py new file mode 100644 index 00000000..7cb20003 --- /dev/null +++ b/lib/importlib_resources/tests/test_path.py @@ -0,0 +1,69 @@ +import io +import unittest + +import importlib_resources as resources +from . import data01 +from . import util + + +class CommonTests(util.CommonTests, unittest.TestCase): + def execute(self, package, path): + with resources.as_file(resources.files(package).joinpath(path)): + pass + + +class PathTests: + def test_reading(self): + """ + Path should be readable. + + Test also implicitly verifies the returned object is a pathlib.Path + instance. + """ + target = resources.files(self.data) / 'utf-8.file' + with resources.as_file(target) as path: + self.assertTrue(path.name.endswith("utf-8.file"), repr(path)) + # pathlib.Path.read_text() was introduced in Python 3.5. + with path.open('r', encoding='utf-8') as file: + text = file.read() + self.assertEqual('Hello, UTF-8 world!\n', text) + + +class PathDiskTests(PathTests, unittest.TestCase): + data = data01 + + def test_natural_path(self): + """ + Guarantee the internal implementation detail that + file-system-backed resources do not get the tempdir + treatment. + """ + target = resources.files(self.data) / 'utf-8.file' + with resources.as_file(target) as path: + assert 'data' in str(path) + + +class PathMemoryTests(PathTests, unittest.TestCase): + def setUp(self): + file = io.BytesIO(b'Hello, UTF-8 world!\n') + self.addCleanup(file.close) + self.data = util.create_package( + file=file, path=FileNotFoundError("package exists only in memory") + ) + self.data.__spec__.origin = None + self.data.__spec__.has_location = False + + +class PathZipTests(PathTests, util.ZipSetup, unittest.TestCase): + def test_remove_in_context_manager(self): + """ + It is not an error if the file that was temporarily stashed on the + file system is removed inside the `with` stanza. + """ + target = resources.files(self.data) / 'utf-8.file' + with resources.as_file(target) as path: + path.unlink() + + +if __name__ == '__main__': + unittest.main() diff --git a/lib/importlib_resources/tests/test_read.py b/lib/importlib_resources/tests/test_read.py new file mode 100644 index 00000000..b5aaec45 --- /dev/null +++ b/lib/importlib_resources/tests/test_read.py @@ -0,0 +1,82 @@ +import unittest +import importlib_resources as resources + +from . import data01 +from . import util +from importlib import import_module + + +class CommonBinaryTests(util.CommonTests, unittest.TestCase): + def execute(self, package, path): + resources.files(package).joinpath(path).read_bytes() + + +class CommonTextTests(util.CommonTests, unittest.TestCase): + def execute(self, package, path): + resources.files(package).joinpath(path).read_text(encoding='utf-8') + + +class ReadTests: + def test_read_bytes(self): + result = resources.files(self.data).joinpath('binary.file').read_bytes() + self.assertEqual(result, b'\0\1\2\3') + + def test_read_text_default_encoding(self): + result = ( + resources.files(self.data) + .joinpath('utf-8.file') + .read_text(encoding='utf-8') + ) + self.assertEqual(result, 'Hello, UTF-8 world!\n') + + def test_read_text_given_encoding(self): + result = ( + resources.files(self.data) + .joinpath('utf-16.file') + .read_text(encoding='utf-16') + ) + self.assertEqual(result, 'Hello, UTF-16 world!\n') + + def test_read_text_with_errors(self): + """ + Raises UnicodeError without the 'errors' argument. + """ + target = resources.files(self.data) / 'utf-16.file' + self.assertRaises(UnicodeError, target.read_text, encoding='utf-8') + result = target.read_text(encoding='utf-8', errors='ignore') + self.assertEqual( + result, + 'H\x00e\x00l\x00l\x00o\x00,\x00 ' + '\x00U\x00T\x00F\x00-\x001\x006\x00 ' + '\x00w\x00o\x00r\x00l\x00d\x00!\x00\n\x00', + ) + + +class ReadDiskTests(ReadTests, unittest.TestCase): + data = data01 + + +class ReadZipTests(ReadTests, util.ZipSetup, unittest.TestCase): + def test_read_submodule_resource(self): + submodule = import_module('ziptestdata.subdirectory') + result = resources.files(submodule).joinpath('binary.file').read_bytes() + self.assertEqual(result, b'\0\1\2\3') + + def test_read_submodule_resource_by_name(self): + result = ( + resources.files('ziptestdata.subdirectory') + .joinpath('binary.file') + .read_bytes() + ) + self.assertEqual(result, b'\0\1\2\3') + + +class ReadNamespaceTests(ReadTests, unittest.TestCase): + def setUp(self): + from . import namespacedata01 + + self.data = namespacedata01 + + +if __name__ == '__main__': + unittest.main() diff --git a/lib/importlib_resources/tests/test_reader.py b/lib/importlib_resources/tests/test_reader.py new file mode 100644 index 00000000..e2bdf19c --- /dev/null +++ b/lib/importlib_resources/tests/test_reader.py @@ -0,0 +1,144 @@ +import os.path +import sys +import pathlib +import unittest + +from importlib import import_module +from importlib_resources.readers import MultiplexedPath, NamespaceReader + + +class MultiplexedPathTest(unittest.TestCase): + @classmethod + def setUpClass(cls): + path = pathlib.Path(__file__).parent / 'namespacedata01' + cls.folder = str(path) + + def test_init_no_paths(self): + with self.assertRaises(FileNotFoundError): + MultiplexedPath() + + def test_init_file(self): + with self.assertRaises(NotADirectoryError): + MultiplexedPath(os.path.join(self.folder, 'binary.file')) + + def test_iterdir(self): + contents = {path.name for path in MultiplexedPath(self.folder).iterdir()} + try: + contents.remove('__pycache__') + except (KeyError, ValueError): + pass + self.assertEqual(contents, {'binary.file', 'utf-16.file', 'utf-8.file'}) + + def test_iterdir_duplicate(self): + data01 = os.path.abspath(os.path.join(__file__, '..', 'data01')) + contents = { + path.name for path in MultiplexedPath(self.folder, data01).iterdir() + } + for remove in ('__pycache__', '__init__.pyc'): + try: + contents.remove(remove) + except (KeyError, ValueError): + pass + self.assertEqual( + contents, + {'__init__.py', 'binary.file', 'subdirectory', 'utf-16.file', 'utf-8.file'}, + ) + + def test_is_dir(self): + self.assertEqual(MultiplexedPath(self.folder).is_dir(), True) + + def test_is_file(self): + self.assertEqual(MultiplexedPath(self.folder).is_file(), False) + + def test_open_file(self): + path = MultiplexedPath(self.folder) + with self.assertRaises(FileNotFoundError): + path.read_bytes() + with self.assertRaises(FileNotFoundError): + path.read_text() + with self.assertRaises(FileNotFoundError): + path.open() + + def test_join_path(self): + prefix = os.path.abspath(os.path.join(__file__, '..')) + data01 = os.path.join(prefix, 'data01') + path = MultiplexedPath(self.folder, data01) + self.assertEqual( + str(path.joinpath('binary.file'))[len(prefix) + 1 :], + os.path.join('namespacedata01', 'binary.file'), + ) + self.assertEqual( + str(path.joinpath('subdirectory'))[len(prefix) + 1 :], + os.path.join('data01', 'subdirectory'), + ) + self.assertEqual( + str(path.joinpath('imaginary'))[len(prefix) + 1 :], + os.path.join('namespacedata01', 'imaginary'), + ) + self.assertEqual(path.joinpath(), path) + + def test_join_path_compound(self): + path = MultiplexedPath(self.folder) + assert not path.joinpath('imaginary/foo.py').exists() + + def test_join_path_common_subdir(self): + prefix = os.path.abspath(os.path.join(__file__, '..')) + data01 = os.path.join(prefix, 'data01') + data02 = os.path.join(prefix, 'data02') + path = MultiplexedPath(data01, data02) + self.assertIsInstance(path.joinpath('subdirectory'), MultiplexedPath) + self.assertEqual( + str(path.joinpath('subdirectory', 'subsubdir'))[len(prefix) + 1 :], + os.path.join('data02', 'subdirectory', 'subsubdir'), + ) + + def test_repr(self): + self.assertEqual( + repr(MultiplexedPath(self.folder)), + f"MultiplexedPath('{self.folder}')", + ) + + def test_name(self): + self.assertEqual( + MultiplexedPath(self.folder).name, + os.path.basename(self.folder), + ) + + +class NamespaceReaderTest(unittest.TestCase): + site_dir = str(pathlib.Path(__file__).parent) + + @classmethod + def setUpClass(cls): + sys.path.append(cls.site_dir) + + @classmethod + def tearDownClass(cls): + sys.path.remove(cls.site_dir) + + def test_init_error(self): + with self.assertRaises(ValueError): + NamespaceReader(['path1', 'path2']) + + def test_resource_path(self): + namespacedata01 = import_module('namespacedata01') + reader = NamespaceReader(namespacedata01.__spec__.submodule_search_locations) + + root = os.path.abspath(os.path.join(__file__, '..', 'namespacedata01')) + self.assertEqual( + reader.resource_path('binary.file'), os.path.join(root, 'binary.file') + ) + self.assertEqual( + reader.resource_path('imaginary'), os.path.join(root, 'imaginary') + ) + + def test_files(self): + namespacedata01 = import_module('namespacedata01') + reader = NamespaceReader(namespacedata01.__spec__.submodule_search_locations) + root = os.path.abspath(os.path.join(__file__, '..', 'namespacedata01')) + self.assertIsInstance(reader.files(), MultiplexedPath) + self.assertEqual(repr(reader.files()), f"MultiplexedPath('{root}')") + + +if __name__ == '__main__': + unittest.main() diff --git a/lib/importlib_resources/tests/test_resource.py b/lib/importlib_resources/tests/test_resource.py new file mode 100644 index 00000000..677110cd --- /dev/null +++ b/lib/importlib_resources/tests/test_resource.py @@ -0,0 +1,252 @@ +import contextlib +import sys +import unittest +import importlib_resources as resources +import uuid +import pathlib + +from . import data01 +from . import zipdata01, zipdata02 +from . import util +from importlib import import_module +from ._compat import import_helper, os_helper, unlink + + +class ResourceTests: + # Subclasses are expected to set the `data` attribute. + + def test_is_file_exists(self): + target = resources.files(self.data) / 'binary.file' + self.assertTrue(target.is_file()) + + def test_is_file_missing(self): + target = resources.files(self.data) / 'not-a-file' + self.assertFalse(target.is_file()) + + def test_is_dir(self): + target = resources.files(self.data) / 'subdirectory' + self.assertFalse(target.is_file()) + self.assertTrue(target.is_dir()) + + +class ResourceDiskTests(ResourceTests, unittest.TestCase): + def setUp(self): + self.data = data01 + + +class ResourceZipTests(ResourceTests, util.ZipSetup, unittest.TestCase): + pass + + +def names(traversable): + return {item.name for item in traversable.iterdir()} + + +class ResourceLoaderTests(unittest.TestCase): + def test_resource_contents(self): + package = util.create_package( + file=data01, path=data01.__file__, contents=['A', 'B', 'C'] + ) + self.assertEqual(names(resources.files(package)), {'A', 'B', 'C'}) + + def test_is_file(self): + package = util.create_package( + file=data01, path=data01.__file__, contents=['A', 'B', 'C', 'D/E', 'D/F'] + ) + self.assertTrue(resources.files(package).joinpath('B').is_file()) + + def test_is_dir(self): + package = util.create_package( + file=data01, path=data01.__file__, contents=['A', 'B', 'C', 'D/E', 'D/F'] + ) + self.assertTrue(resources.files(package).joinpath('D').is_dir()) + + def test_resource_missing(self): + package = util.create_package( + file=data01, path=data01.__file__, contents=['A', 'B', 'C', 'D/E', 'D/F'] + ) + self.assertFalse(resources.files(package).joinpath('Z').is_file()) + + +class ResourceCornerCaseTests(unittest.TestCase): + def test_package_has_no_reader_fallback(self): + """ + Test odd ball packages which: + # 1. Do not have a ResourceReader as a loader + # 2. Are not on the file system + # 3. Are not in a zip file + """ + module = util.create_package( + file=data01, path=data01.__file__, contents=['A', 'B', 'C'] + ) + # Give the module a dummy loader. + module.__loader__ = object() + # Give the module a dummy origin. + module.__file__ = '/path/which/shall/not/be/named' + module.__spec__.loader = module.__loader__ + module.__spec__.origin = module.__file__ + self.assertFalse(resources.files(module).joinpath('A').is_file()) + + +class ResourceFromZipsTest01(util.ZipSetupBase, unittest.TestCase): + ZIP_MODULE = zipdata01 # type: ignore + + def test_is_submodule_resource(self): + submodule = import_module('ziptestdata.subdirectory') + self.assertTrue(resources.files(submodule).joinpath('binary.file').is_file()) + + def test_read_submodule_resource_by_name(self): + self.assertTrue( + resources.files('ziptestdata.subdirectory') + .joinpath('binary.file') + .is_file() + ) + + def test_submodule_contents(self): + submodule = import_module('ziptestdata.subdirectory') + self.assertEqual( + names(resources.files(submodule)), {'__init__.py', 'binary.file'} + ) + + def test_submodule_contents_by_name(self): + self.assertEqual( + names(resources.files('ziptestdata.subdirectory')), + {'__init__.py', 'binary.file'}, + ) + + def test_as_file_directory(self): + with resources.as_file(resources.files('ziptestdata')) as data: + assert data.name == 'ziptestdata' + assert data.is_dir() + assert data.joinpath('subdirectory').is_dir() + assert len(list(data.iterdir())) + assert not data.parent.exists() + + +class ResourceFromZipsTest02(util.ZipSetupBase, unittest.TestCase): + ZIP_MODULE = zipdata02 # type: ignore + + def test_unrelated_contents(self): + """ + Test thata zip with two unrelated subpackages return + distinct resources. Ref python/importlib_resources#44. + """ + self.assertEqual( + names(resources.files('ziptestdata.one')), + {'__init__.py', 'resource1.txt'}, + ) + self.assertEqual( + names(resources.files('ziptestdata.two')), + {'__init__.py', 'resource2.txt'}, + ) + + +@contextlib.contextmanager +def zip_on_path(dir): + data_path = pathlib.Path(zipdata01.__file__) + source_zip_path = data_path.parent.joinpath('ziptestdata.zip') + zip_path = pathlib.Path(dir) / f'{uuid.uuid4()}.zip' + zip_path.write_bytes(source_zip_path.read_bytes()) + sys.path.append(str(zip_path)) + import_module('ziptestdata') + + try: + yield + finally: + with contextlib.suppress(ValueError): + sys.path.remove(str(zip_path)) + + with contextlib.suppress(KeyError): + del sys.path_importer_cache[str(zip_path)] + del sys.modules['ziptestdata'] + + with contextlib.suppress(OSError): + unlink(zip_path) + + +class DeletingZipsTest(unittest.TestCase): + """Having accessed resources in a zip file should not keep an open + reference to the zip. + """ + + def setUp(self): + self.fixtures = contextlib.ExitStack() + self.addCleanup(self.fixtures.close) + + modules = import_helper.modules_setup() + self.addCleanup(import_helper.modules_cleanup, *modules) + + temp_dir = self.fixtures.enter_context(os_helper.temp_dir()) + self.fixtures.enter_context(zip_on_path(temp_dir)) + + def test_iterdir_does_not_keep_open(self): + [item.name for item in resources.files('ziptestdata').iterdir()] + + def test_is_file_does_not_keep_open(self): + resources.files('ziptestdata').joinpath('binary.file').is_file() + + def test_is_file_failure_does_not_keep_open(self): + resources.files('ziptestdata').joinpath('not-present').is_file() + + @unittest.skip("Desired but not supported.") + def test_as_file_does_not_keep_open(self): # pragma: no cover + resources.as_file(resources.files('ziptestdata') / 'binary.file') + + def test_entered_path_does_not_keep_open(self): + """ + Mimic what certifi does on import to make its bundle + available for the process duration. + """ + resources.as_file(resources.files('ziptestdata') / 'binary.file').__enter__() + + def test_read_binary_does_not_keep_open(self): + resources.files('ziptestdata').joinpath('binary.file').read_bytes() + + def test_read_text_does_not_keep_open(self): + resources.files('ziptestdata').joinpath('utf-8.file').read_text( + encoding='utf-8' + ) + + +class ResourceFromNamespaceTest01(unittest.TestCase): + site_dir = str(pathlib.Path(__file__).parent) + + @classmethod + def setUpClass(cls): + sys.path.append(cls.site_dir) + + @classmethod + def tearDownClass(cls): + sys.path.remove(cls.site_dir) + + def test_is_submodule_resource(self): + self.assertTrue( + resources.files(import_module('namespacedata01')) + .joinpath('binary.file') + .is_file() + ) + + def test_read_submodule_resource_by_name(self): + self.assertTrue( + resources.files('namespacedata01').joinpath('binary.file').is_file() + ) + + def test_submodule_contents(self): + contents = names(resources.files(import_module('namespacedata01'))) + try: + contents.remove('__pycache__') + except KeyError: + pass + self.assertEqual(contents, {'binary.file', 'utf-8.file', 'utf-16.file'}) + + def test_submodule_contents_by_name(self): + contents = names(resources.files('namespacedata01')) + try: + contents.remove('__pycache__') + except KeyError: + pass + self.assertEqual(contents, {'binary.file', 'utf-8.file', 'utf-16.file'}) + + +if __name__ == '__main__': + unittest.main() diff --git a/lib/importlib_resources/tests/update-zips.py b/lib/importlib_resources/tests/update-zips.py new file mode 100644 index 00000000..231334aa --- /dev/null +++ b/lib/importlib_resources/tests/update-zips.py @@ -0,0 +1,53 @@ +""" +Generate the zip test data files. + +Run to build the tests/zipdataNN/ziptestdata.zip files from +files in tests/dataNN. + +Replaces the file with the working copy, but does commit anything +to the source repo. +""" + +import contextlib +import os +import pathlib +import zipfile + + +def main(): + """ + >>> from unittest import mock + >>> monkeypatch = getfixture('monkeypatch') + >>> monkeypatch.setattr(zipfile, 'ZipFile', mock.MagicMock()) + >>> print(); main() # print workaround for bpo-32509 + + ...data01... -> ziptestdata/... + ... + ...data02... -> ziptestdata/... + ... + """ + suffixes = '01', '02' + tuple(map(generate, suffixes)) + + +def generate(suffix): + root = pathlib.Path(__file__).parent.relative_to(os.getcwd()) + zfpath = root / f'zipdata{suffix}/ziptestdata.zip' + with zipfile.ZipFile(zfpath, 'w') as zf: + for src, rel in walk(root / f'data{suffix}'): + dst = 'ziptestdata' / pathlib.PurePosixPath(rel.as_posix()) + print(src, '->', dst) + zf.write(src, dst) + + +def walk(datapath): + for dirpath, dirnames, filenames in os.walk(datapath): + with contextlib.suppress(ValueError): + dirnames.remove('__pycache__') + for filename in filenames: + res = pathlib.Path(dirpath) / filename + rel = res.relative_to(datapath) + yield res, rel + + +__name__ == '__main__' and main() diff --git a/lib/importlib_resources/tests/util.py b/lib/importlib_resources/tests/util.py new file mode 100644 index 00000000..ce0e6fad --- /dev/null +++ b/lib/importlib_resources/tests/util.py @@ -0,0 +1,179 @@ +import abc +import importlib +import io +import sys +import types +import pathlib + +from . import data01 +from . import zipdata01 +from ..abc import ResourceReader +from ._compat import import_helper + + +from importlib.machinery import ModuleSpec + + +class Reader(ResourceReader): + def __init__(self, **kwargs): + vars(self).update(kwargs) + + def get_resource_reader(self, package): + return self + + def open_resource(self, path): + self._path = path + if isinstance(self.file, Exception): + raise self.file + return self.file + + def resource_path(self, path_): + self._path = path_ + if isinstance(self.path, Exception): + raise self.path + return self.path + + def is_resource(self, path_): + self._path = path_ + if isinstance(self.path, Exception): + raise self.path + + def part(entry): + return entry.split('/') + + return any( + len(parts) == 1 and parts[0] == path_ for parts in map(part, self._contents) + ) + + def contents(self): + if isinstance(self.path, Exception): + raise self.path + yield from self._contents + + +def create_package_from_loader(loader, is_package=True): + name = 'testingpackage' + module = types.ModuleType(name) + spec = ModuleSpec(name, loader, origin='does-not-exist', is_package=is_package) + module.__spec__ = spec + module.__loader__ = loader + return module + + +def create_package(file=None, path=None, is_package=True, contents=()): + return create_package_from_loader( + Reader(file=file, path=path, _contents=contents), + is_package, + ) + + +class CommonTests(metaclass=abc.ABCMeta): + """ + Tests shared by test_open, test_path, and test_read. + """ + + @abc.abstractmethod + def execute(self, package, path): + """ + Call the pertinent legacy API function (e.g. open_text, path) + on package and path. + """ + + def test_package_name(self): + """ + Passing in the package name should succeed. + """ + self.execute(data01.__name__, 'utf-8.file') + + def test_package_object(self): + """ + Passing in the package itself should succeed. + """ + self.execute(data01, 'utf-8.file') + + def test_string_path(self): + """ + Passing in a string for the path should succeed. + """ + path = 'utf-8.file' + self.execute(data01, path) + + def test_pathlib_path(self): + """ + Passing in a pathlib.PurePath object for the path should succeed. + """ + path = pathlib.PurePath('utf-8.file') + self.execute(data01, path) + + def test_importing_module_as_side_effect(self): + """ + The anchor package can already be imported. + """ + del sys.modules[data01.__name__] + self.execute(data01.__name__, 'utf-8.file') + + def test_missing_path(self): + """ + Attempting to open or read or request the path for a + non-existent path should succeed if open_resource + can return a viable data stream. + """ + bytes_data = io.BytesIO(b'Hello, world!') + package = create_package(file=bytes_data, path=FileNotFoundError()) + self.execute(package, 'utf-8.file') + self.assertEqual(package.__loader__._path, 'utf-8.file') + + def test_extant_path(self): + # Attempting to open or read or request the path when the + # path does exist should still succeed. Does not assert + # anything about the result. + bytes_data = io.BytesIO(b'Hello, world!') + # any path that exists + path = __file__ + package = create_package(file=bytes_data, path=path) + self.execute(package, 'utf-8.file') + self.assertEqual(package.__loader__._path, 'utf-8.file') + + def test_useless_loader(self): + package = create_package(file=FileNotFoundError(), path=FileNotFoundError()) + with self.assertRaises(FileNotFoundError): + self.execute(package, 'utf-8.file') + + +class ZipSetupBase: + ZIP_MODULE = None + + @classmethod + def setUpClass(cls): + data_path = pathlib.Path(cls.ZIP_MODULE.__file__) + data_dir = data_path.parent + cls._zip_path = str(data_dir / 'ziptestdata.zip') + sys.path.append(cls._zip_path) + cls.data = importlib.import_module('ziptestdata') + + @classmethod + def tearDownClass(cls): + try: + sys.path.remove(cls._zip_path) + except ValueError: + pass + + try: + del sys.path_importer_cache[cls._zip_path] + del sys.modules[cls.data.__name__] + except KeyError: + pass + + try: + del cls.data + del cls._zip_path + except AttributeError: + pass + + def setUp(self): + modules = import_helper.modules_setup() + self.addCleanup(import_helper.modules_cleanup, *modules) + + +class ZipSetup(ZipSetupBase): + ZIP_MODULE = zipdata01 # type: ignore diff --git a/lib/importlib_resources/tests/zipdata01/__init__.py b/lib/importlib_resources/tests/zipdata01/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/importlib_resources/tests/zipdata01/ziptestdata.zip b/lib/importlib_resources/tests/zipdata01/ziptestdata.zip new file mode 100644 index 0000000000000000000000000000000000000000..9a3bb0739f87e97c1084b94d7d153680f6727738 GIT binary patch literal 876 zcmWIWW@Zs#00HOCX@Q%&m27l?Y!DU);;PJolGNgol*E!m{nC;&T|+ayw9K5;|NlG~ zQWMD z9;rDw`8o=rA#S=B3g!7lIVp-}COK17UPc zNtt;*xhM-3R!jMEPhCreO-3*u>5Df}T7+BJ{639e$2uhfsIs`pJ5Qf}C xGXyDE@VNvOv@o!wQJfLgCAgysx3f@9jKpUmiW^zkK<;1z!tFpk^MROw0RS~O%0&PG literal 0 HcmV?d00001 diff --git a/lib/importlib_resources/tests/zipdata02/__init__.py b/lib/importlib_resources/tests/zipdata02/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/importlib_resources/tests/zipdata02/ziptestdata.zip b/lib/importlib_resources/tests/zipdata02/ziptestdata.zip new file mode 100644 index 0000000000000000000000000000000000000000..d63ff512d2807ef2fd259455283b81b02e0e45fb GIT binary patch literal 698 zcmWIWW@Zs#00HOCX@Ot{ln@8fRhb1Psl_EJi6x2p@$s2?nI-Y@dIgmMI5kP5Y0A$_ z#jWw|&p#`9ff_(q7K_HB)Z+ZoqU2OVy^@L&ph*fa0WRVlP*R?c+X1opI-R&20MZDv z&j{oIpa8N17@0(vaR(gGH(;=&5k%n(M%;#g0ulz6G@1gL$cA79E2=^00gEsw4~s!C zUxI@ZWaIMqz|BszK;s4KsL2<9jRy!Q2E6`2cTLHjr{wAk1ZCU@!+_ G1_l6Bc%f?m literal 0 HcmV?d00001 diff --git a/requirements.txt b/requirements.txt index e71070e6..3fc87314 100644 --- a/requirements.txt +++ b/requirements.txt @@ -19,6 +19,8 @@ gntp==1.0.3 html5lib==1.1 httpagentparser==1.9.5 idna==3.4 +importlib-metadata==6.8.0 +importlib-resources==6.0.1 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois IPy==1.01 Mako==1.2.4 From 80e6131a0daf7b2feaa996630aaeb5940169420e Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 24 Aug 2023 12:10:08 -0700 Subject: [PATCH 003/290] Revert "Bump apscheduler from 3.10.1 to 3.10.4 (#2133)" This reverts commit 2c421507997f23ac904259f019e9fc3c7eefea65. --- lib/apscheduler/__init__.py | 13 +- lib/apscheduler/schedulers/base.py | 19 +- lib/apscheduler/schedulers/qt.py | 28 +- lib/apscheduler/util.py | 39 +- lib/tzlocal/__init__.py | 9 +- lib/tzlocal/unix.py | 63 +- lib/tzlocal/utils.py | 68 +- lib/tzlocal/win32.py | 32 +- lib/tzlocal/windows_tz.py | 1405 ++++++++++++++-------------- package/requirements-package.txt | 2 +- requirements.txt | 2 +- 11 files changed, 825 insertions(+), 855 deletions(-) diff --git a/lib/apscheduler/__init__.py b/lib/apscheduler/__init__.py index 651aba49..968169a9 100644 --- a/lib/apscheduler/__init__.py +++ b/lib/apscheduler/__init__.py @@ -1,15 +1,10 @@ -import sys -if sys.version_info >= (3, 8): - import importlib.metadata as importlib_metadata -else: - import importlib_metadata - +from pkg_resources import get_distribution, DistributionNotFound try: - release = importlib_metadata.version('APScheduler').split('-')[0] -except importlib_metadata.PackageNotFoundError: + release = get_distribution('APScheduler').version.split('-')[0] +except DistributionNotFound: release = '3.5.0' version_info = tuple(int(x) if x.isdigit() else x for x in release.split('.')) version = __version__ = '.'.join(str(x) for x in version_info[:3]) -del sys, importlib_metadata +del get_distribution, DistributionNotFound diff --git a/lib/apscheduler/schedulers/base.py b/lib/apscheduler/schedulers/base.py index f751c955..444de8ef 100644 --- a/lib/apscheduler/schedulers/base.py +++ b/lib/apscheduler/schedulers/base.py @@ -7,6 +7,7 @@ from logging import getLogger import warnings import sys +from pkg_resources import iter_entry_points from tzlocal import get_localzone import six @@ -30,11 +31,6 @@ try: except ImportError: from collections import MutableMapping -try: - from importlib.metadata import entry_points -except ModuleNotFoundError: - from importlib_metadata import entry_points - #: constant indicating a scheduler's stopped state STATE_STOPPED = 0 #: constant indicating a scheduler's running state (started and processing jobs) @@ -66,18 +62,12 @@ class BaseScheduler(six.with_metaclass(ABCMeta)): .. seealso:: :ref:`scheduler-config` """ - # The `group=...` API is only available in the backport, used in <=3.7, and in std>=3.10. - if (3, 8) <= sys.version_info < (3, 10): - _trigger_plugins = {ep.name: ep for ep in entry_points()['apscheduler.triggers']} - _executor_plugins = {ep.name: ep for ep in entry_points()['apscheduler.executors']} - _jobstore_plugins = {ep.name: ep for ep in entry_points()['apscheduler.jobstores']} - else: - _trigger_plugins = {ep.name: ep for ep in entry_points(group='apscheduler.triggers')} - _executor_plugins = {ep.name: ep for ep in entry_points(group='apscheduler.executors')} - _jobstore_plugins = {ep.name: ep for ep in entry_points(group='apscheduler.jobstores')} + _trigger_plugins = dict((ep.name, ep) for ep in iter_entry_points('apscheduler.triggers')) _trigger_classes = {} + _executor_plugins = dict((ep.name, ep) for ep in iter_entry_points('apscheduler.executors')) _executor_classes = {} + _jobstore_plugins = dict((ep.name, ep) for ep in iter_entry_points('apscheduler.jobstores')) _jobstore_classes = {} # @@ -1029,7 +1019,6 @@ class BaseScheduler(six.with_metaclass(ABCMeta)): wait_seconds = None self._logger.debug('No jobs; waiting until a job is added') else: - now = datetime.now(self.timezone) wait_seconds = min(max(timedelta_seconds(next_wakeup_time - now), 0), TIMEOUT_MAX) self._logger.debug('Next wakeup is due at %s (in %f seconds)', next_wakeup_time, wait_seconds) diff --git a/lib/apscheduler/schedulers/qt.py b/lib/apscheduler/schedulers/qt.py index 6762c5c3..890a44a8 100644 --- a/lib/apscheduler/schedulers/qt.py +++ b/lib/apscheduler/schedulers/qt.py @@ -1,22 +1,24 @@ from __future__ import absolute_import -from importlib import import_module -from itertools import product - from apscheduler.schedulers.base import BaseScheduler -for version, pkgname in product(range(6, 1, -1), ("PySide", "PyQt")): +try: + from PyQt5.QtCore import QObject, QTimer +except (ImportError, RuntimeError): # pragma: nocover try: - qtcore = import_module(pkgname + str(version) + ".QtCore") + from PyQt4.QtCore import QObject, QTimer except ImportError: - pass - else: - QTimer = qtcore.QTimer - break -else: - raise ImportError( - "QtScheduler requires either PySide/PyQt (v6 to v2) installed" - ) + try: + from PySide6.QtCore import QObject, QTimer # noqa + except ImportError: + try: + from PySide2.QtCore import QObject, QTimer # noqa + except ImportError: + try: + from PySide.QtCore import QObject, QTimer # noqa + except ImportError: + raise ImportError('QtScheduler requires either PyQt5, PyQt4, PySide6, PySide2 ' + 'or PySide installed') class QtScheduler(BaseScheduler): diff --git a/lib/apscheduler/util.py b/lib/apscheduler/util.py index 003b30f5..64b27d7b 100644 --- a/lib/apscheduler/util.py +++ b/lib/apscheduler/util.py @@ -6,7 +6,7 @@ from asyncio import iscoroutinefunction from datetime import date, datetime, time, timedelta, tzinfo from calendar import timegm from functools import partial -from inspect import isbuiltin, isclass, isfunction, ismethod +from inspect import isclass, ismethod import re import sys @@ -214,15 +214,28 @@ def get_callable_name(func): :rtype: str """ - if ismethod(func): - self = func.__self__ - cls = self if isclass(self) else type(self) - return f"{cls.__qualname__}.{func.__name__}" - elif isclass(func) or isfunction(func) or isbuiltin(func): + # the easy case (on Python 3.3+) + if hasattr(func, '__qualname__'): return func.__qualname__ - elif hasattr(func, '__call__') and callable(func.__call__): + + # class methods, bound and unbound methods + f_self = getattr(func, '__self__', None) or getattr(func, 'im_self', None) + if f_self and hasattr(func, '__name__'): + f_class = f_self if isclass(f_self) else f_self.__class__ + else: + f_class = getattr(func, 'im_class', None) + + if f_class and hasattr(func, '__name__'): + return '%s.%s' % (f_class.__name__, func.__name__) + + # class or class instance + if hasattr(func, '__call__'): + # class + if hasattr(func, '__name__'): + return func.__name__ + # instance of a class with a __call__ method - return type(func).__qualname__ + return func.__class__.__name__ raise TypeError('Unable to determine a name for %r -- maybe it is not a callable?' % func) @@ -247,10 +260,16 @@ def obj_to_ref(obj): raise ValueError('Cannot create a reference to a nested function') if ismethod(obj): - module = obj.__self__.__module__ + if hasattr(obj, 'im_self') and obj.im_self: + # bound method + module = obj.im_self.__module__ + elif hasattr(obj, 'im_class') and obj.im_class: + # unbound method + module = obj.im_class.__module__ + else: + module = obj.__module__ else: module = obj.__module__ - return '%s:%s' % (module, name) diff --git a/lib/tzlocal/__init__.py b/lib/tzlocal/__init__.py index 50abb093..98ed04fd 100644 --- a/lib/tzlocal/__init__.py +++ b/lib/tzlocal/__init__.py @@ -9,12 +9,5 @@ if sys.platform == "win32": else: from tzlocal.unix import get_localzone, get_localzone_name, reload_localzone -from tzlocal.utils import assert_tz_offset - -__all__ = [ - "get_localzone", - "get_localzone_name", - "reload_localzone", - "assert_tz_offset", -] +__all__ = ["get_localzone", "get_localzone_name", "reload_localzone"] diff --git a/lib/tzlocal/unix.py b/lib/tzlocal/unix.py index f510c12c..eaf96d92 100644 --- a/lib/tzlocal/unix.py +++ b/lib/tzlocal/unix.py @@ -1,21 +1,20 @@ -import logging import os import re import sys import warnings from datetime import timezone +import pytz_deprecation_shim as pds from tzlocal import utils if sys.version_info >= (3, 9): - import zoneinfo # pragma: no cover + from zoneinfo import ZoneInfo # pragma: no cover else: - from backports import zoneinfo # pragma: no cover + from backports.zoneinfo import ZoneInfo # pragma: no cover _cache_tz = None _cache_tz_name = None -log = logging.getLogger("tzlocal") def _get_localzone_name(_root="/"): """Tries to find the local timezone configuration. @@ -33,21 +32,14 @@ def _get_localzone_name(_root="/"): # Are we under Termux on Android? if os.path.exists(os.path.join(_root, "system/bin/getprop")): - log.debug("This looks like Termux") - import subprocess - try: - androidtz = ( - subprocess.check_output(["getprop", "persist.sys.timezone"]) - .strip() - .decode() - ) - return androidtz - except (OSError, subprocess.CalledProcessError): - # proot environment or failed to getprop - log.debug("It's not termux?") - pass + androidtz = ( + subprocess.check_output(["getprop", "persist.sys.timezone"]) + .strip() + .decode() + ) + return androidtz # Now look for distribution specific configuration files # that contain the timezone name. @@ -58,11 +50,10 @@ def _get_localzone_name(_root="/"): for configfile in ("etc/timezone", "var/db/zoneinfo"): tzpath = os.path.join(_root, configfile) try: - with open(tzpath) as tzfile: + with open(tzpath, "rt") as tzfile: data = tzfile.read() - log.debug(f"{tzpath} found, contents:\n {data}") - etctz = data.strip("/ \t\r\n") + etctz = data.strip('/ \t\r\n') if not etctz: # Empty file, skip continue @@ -77,7 +68,7 @@ def _get_localzone_name(_root="/"): found_configs[tzpath] = etctz.replace(" ", "_") - except (OSError, UnicodeDecodeError): + except (IOError, UnicodeDecodeError): # File doesn't exist or is a directory, or it's a binary file. continue @@ -95,7 +86,6 @@ def _get_localzone_name(_root="/"): try: with open(tzpath, "rt") as tzfile: data = tzfile.readlines() - log.debug(f"{tzpath} found, contents:\n {data}") for line in data: # Look for the ZONE= setting. @@ -105,13 +95,13 @@ def _get_localzone_name(_root="/"): match = timezone_re.match(line) if match is not None: # Some setting existed - line = line[match.end() :] + line = line[match.end():] etctz = line[: end_re.search(line).start()] # We found a timezone found_configs[tzpath] = etctz.replace(" ", "_") - except (OSError, UnicodeDecodeError): + except (IOError, UnicodeDecodeError): # UnicodeDecode handles when clock is symlink to /etc/localtime continue @@ -119,34 +109,30 @@ def _get_localzone_name(_root="/"): # see manpage of localtime(5) and timedatectl(1) tzpath = os.path.join(_root, "etc/localtime") if os.path.exists(tzpath) and os.path.islink(tzpath): - log.debug(f"{tzpath} found") - etctz = os.path.realpath(tzpath) + etctz = realtzpath = os.path.realpath(tzpath) start = etctz.find("/") + 1 while start != 0: etctz = etctz[start:] try: - zoneinfo.ZoneInfo(etctz) + pds.timezone(etctz) tzinfo = f"{tzpath} is a symlink to" found_configs[tzinfo] = etctz.replace(" ", "_") - # Only need first valid relative path in simlink. - break - except zoneinfo.ZoneInfoNotFoundError: + except pds.UnknownTimeZoneError: pass start = etctz.find("/") + 1 if len(found_configs) > 0: - log.debug(f"{len(found_configs)} found:\n {found_configs}") # We found some explicit config of some sort! if len(found_configs) > 1: # Uh-oh, multiple configs. See if they match: unique_tzs = set() - zoneinfopath = os.path.join(_root, "usr", "share", "zoneinfo") - directory_depth = len(zoneinfopath.split(os.path.sep)) + zoneinfo = os.path.join(_root, "usr", "share", "zoneinfo") + directory_depth = len(zoneinfo.split(os.path.sep)) for tzname in found_configs.values(): # Look them up in /usr/share/zoneinfo, and find what they # really point to: - path = os.path.realpath(os.path.join(zoneinfopath, *tzname.split("/"))) + path = os.path.realpath(os.path.join(zoneinfo, *tzname.split("/"))) real_zone_name = "/".join(path.split(os.path.sep)[directory_depth:]) unique_tzs.add(real_zone_name) @@ -155,7 +141,7 @@ def _get_localzone_name(_root="/"): for key, value in found_configs.items(): message += f"{key}: {value}\n" message += "Fix the configuration, or set the time zone in a TZ environment variable.\n" - raise zoneinfo.ZoneInfoNotFoundError(message) + raise utils.ZoneInfoNotFoundError(message) # We found exactly one config! Use it. return list(found_configs.values())[0] @@ -179,25 +165,24 @@ def _get_localzone(_root="/"): tzname = _get_localzone_name(_root) if tzname is None: # No explicit setting existed. Use localtime - log.debug("No explicit setting existed. Use localtime") for filename in ("etc/localtime", "usr/local/etc/localtime"): tzpath = os.path.join(_root, filename) if not os.path.exists(tzpath): continue with open(tzpath, "rb") as tzfile: - tz = zoneinfo.ZoneInfo.from_file(tzfile, key="local") + tz = pds.wrap_zone(ZoneInfo.from_file(tzfile, key="local")) break else: warnings.warn("Can not find any timezone configuration, defaulting to UTC.") tz = timezone.utc else: - tz = zoneinfo.ZoneInfo(tzname) + tz = pds.timezone(tzname) if _root == "/": # We are using a file in etc to name the timezone. # Verify that the timezone specified there is actually used: - utils.assert_tz_offset(tz, error=False) + utils.assert_tz_offset(tz) return tz diff --git a/lib/tzlocal/utils.py b/lib/tzlocal/utils.py index 4ba82d3d..d1026b32 100644 --- a/lib/tzlocal/utils.py +++ b/lib/tzlocal/utils.py @@ -1,9 +1,9 @@ -import logging +# -*- coding: utf-8 -*- import os import time import datetime import calendar -import warnings +import pytz_deprecation_shim as pds try: import zoneinfo # pragma: no cover @@ -12,7 +12,35 @@ except ImportError: from tzlocal import windows_tz -log = logging.getLogger("tzlocal") + +class ZoneInfoNotFoundError(pds.UnknownTimeZoneError, zoneinfo.ZoneInfoNotFoundError): + """An exception derived from both pytz and zoneinfo + + This exception will be trappable both by pytz expecting clients and + zoneinfo expecting clients. + """ + + +def get_system_offset(): + """Get system's timezone offset using built-in library time. + + For the Timezone constants (altzone, daylight, timezone, and tzname), the + value is determined by the timezone rules in effect at module load time or + the last time tzset() is called and may be incorrect for times in the past. + + To keep compatibility with Windows, we're always importing time module here. + """ + + localtime = calendar.timegm(time.localtime()) + gmtime = calendar.timegm(time.gmtime()) + offset = gmtime - localtime + # We could get the localtime and gmtime on either side of a second switch + # so we check that the difference is less than one minute, because nobody + # has that small DST differences. + if abs(offset - time.altzone) < 60: + return -time.altzone # pragma: no cover + else: + return -time.timezone # pragma: no cover def get_tz_offset(tz): @@ -20,27 +48,19 @@ def get_tz_offset(tz): return int(datetime.datetime.now(tz).utcoffset().total_seconds()) -def assert_tz_offset(tz, error=True): +def assert_tz_offset(tz): """Assert that system's timezone offset equals to the timezone offset found. If they don't match, we probably have a misconfiguration, for example, an - incorrect timezone set in /etc/timezone file in systemd distributions. - - If error is True, this method will raise a ValueError, otherwise it will - emit a warning. - """ - + incorrect timezone set in /etc/timezone file in systemd distributions.""" tz_offset = get_tz_offset(tz) - system_offset = calendar.timegm(time.localtime()) - calendar.timegm(time.gmtime()) - # No one has timezone offsets less than a minute, so this should be close enough: - if abs(tz_offset - system_offset) > 60: + system_offset = get_system_offset() + if tz_offset != system_offset: msg = ( "Timezone offset does not match system offset: {} != {}. " "Please, check your config files." ).format(tz_offset, system_offset) - if error: - raise ValueError(msg) - warnings.warn(msg) + raise ValueError(msg) def _tz_name_from_env(tzenv=None): @@ -50,8 +70,6 @@ def _tz_name_from_env(tzenv=None): if not tzenv: return None - log.debug(f"Found a TZ environment: {tzenv}") - if tzenv[0] == ":": tzenv = tzenv[1:] @@ -74,9 +92,6 @@ def _tz_name_from_env(tzenv=None): # Indeed return parts[-1] - log.debug("TZ does not contain a time zone name") - return None - def _tz_from_env(tzenv=None): if tzenv is None: @@ -97,16 +112,17 @@ def _tz_from_env(tzenv=None): # Nope, not a standard timezone name, just take the filename tzname = tzenv.split(os.sep)[-1] with open(tzenv, "rb") as tzfile: - return zoneinfo.ZoneInfo.from_file(tzfile, key=tzname) + zone = zoneinfo.ZoneInfo.from_file(tzfile, key=tzname) + return pds.wrap_zone(zone) # TZ must specify a zoneinfo zone. try: - tz = zoneinfo.ZoneInfo(tzenv) + tz = pds.timezone(tzenv) # That worked, so we return this: return tz - except zoneinfo.ZoneInfoNotFoundError: + except pds.UnknownTimeZoneError: # Nope, it's something like "PST4DST" etc, we can't handle that. - raise zoneinfo.ZoneInfoNotFoundError( + raise ZoneInfoNotFoundError( "tzlocal() does not support non-zoneinfo timezones like %s. \n" - "Please use a timezone in the form of Continent/City" % tzenv + "Please use a timezone in the form of Continent/City" ) from None diff --git a/lib/tzlocal/win32.py b/lib/tzlocal/win32.py index 9e8dc735..720ab2b7 100644 --- a/lib/tzlocal/win32.py +++ b/lib/tzlocal/win32.py @@ -1,24 +1,17 @@ -import logging from datetime import datetime +import pytz_deprecation_shim as pds try: import _winreg as winreg except ImportError: import winreg -try: - import zoneinfo # pragma: no cover -except ImportError: - from backports import zoneinfo # pragma: no cover - from tzlocal.windows_tz import win_tz from tzlocal import utils _cache_tz = None _cache_tz_name = None -log = logging.getLogger("tzlocal") - def valuestodict(key): """Convert a registry key's values to a dictionary.""" @@ -55,7 +48,6 @@ def _get_localzone_name(): if tzenv: return tzenv - log.debug("Looking up time zone info from registry") handle = winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE) TZLOCALKEYNAME = r"SYSTEM\CurrentControlSet\Control\TimeZoneInformation" @@ -82,13 +74,13 @@ def _get_localzone_name(): # Return what we have. if timezone is None: - raise zoneinfo.ZoneInfoNotFoundError(tzkeyname) + raise utils.ZoneInfoNotFoundError(tzkeyname) if keyvalues.get("DynamicDaylightTimeDisabled", 0) == 1: # DST is disabled, so don't return the timezone name, # instead return Etc/GMT+offset - tz = zoneinfo.ZoneInfo(timezone) + tz = pds.timezone(timezone) has_dst, std_offset, dst_offset = _get_dst_info(tz) if not has_dst: # The DST is turned off in the windows configuration, @@ -96,15 +88,13 @@ def _get_localzone_name(): return timezone if std_offset is None: - raise zoneinfo.ZoneInfoNotFoundError( - f"{tzkeyname} claims to not have a non-DST time!?" - ) + raise utils.ZoneInfoNotFoundError( + f"{tzkeyname} claims to not have a non-DST time!?") if std_offset % 3600: # I can't convert this to an hourly offset - raise zoneinfo.ZoneInfoNotFoundError( - f"tzlocal can't support disabling DST in the {timezone} zone." - ) + raise utils.ZoneInfoNotFoundError( + f"tzlocal can't support disabling DST in the {timezone} zone.") # This has whole hours as offset, return it as Etc/GMT return f"Etc/GMT{-std_offset//3600:+.0f}" @@ -126,13 +116,13 @@ def get_localzone(): global _cache_tz if _cache_tz is None: - _cache_tz = zoneinfo.ZoneInfo(get_localzone_name()) + _cache_tz = pds.timezone(get_localzone_name()) if not utils._tz_name_from_env(): # If the timezone does NOT come from a TZ environment variable, # verify that it's correct. If it's from the environment, # we accept it, this is so you can run tests with different timezones. - utils.assert_tz_offset(_cache_tz, error=False) + utils.assert_tz_offset(_cache_tz) return _cache_tz @@ -142,6 +132,6 @@ def reload_localzone(): global _cache_tz global _cache_tz_name _cache_tz_name = _get_localzone_name() - _cache_tz = zoneinfo.ZoneInfo(_cache_tz_name) - utils.assert_tz_offset(_cache_tz, error=False) + _cache_tz = pds.timezone(_cache_tz_name) + utils.assert_tz_offset(_cache_tz) return _cache_tz diff --git a/lib/tzlocal/windows_tz.py b/lib/tzlocal/windows_tz.py index ed49c4ac..0d285037 100644 --- a/lib/tzlocal/windows_tz.py +++ b/lib/tzlocal/windows_tz.py @@ -1,718 +1,699 @@ # This file is autogenerated by the update_windows_mapping.py script # Do not edit. -win_tz = { - "AUS Central Standard Time": "Australia/Darwin", - "AUS Eastern Standard Time": "Australia/Sydney", - "Afghanistan Standard Time": "Asia/Kabul", - "Alaskan Standard Time": "America/Anchorage", - "Aleutian Standard Time": "America/Adak", - "Altai Standard Time": "Asia/Barnaul", - "Arab Standard Time": "Asia/Riyadh", - "Arabian Standard Time": "Asia/Dubai", - "Arabic Standard Time": "Asia/Baghdad", - "Argentina Standard Time": "America/Buenos_Aires", - "Astrakhan Standard Time": "Europe/Astrakhan", - "Atlantic Standard Time": "America/Halifax", - "Aus Central W. Standard Time": "Australia/Eucla", - "Azerbaijan Standard Time": "Asia/Baku", - "Azores Standard Time": "Atlantic/Azores", - "Bahia Standard Time": "America/Bahia", - "Bangladesh Standard Time": "Asia/Dhaka", - "Belarus Standard Time": "Europe/Minsk", - "Bougainville Standard Time": "Pacific/Bougainville", - "Canada Central Standard Time": "America/Regina", - "Cape Verde Standard Time": "Atlantic/Cape_Verde", - "Caucasus Standard Time": "Asia/Yerevan", - "Cen. Australia Standard Time": "Australia/Adelaide", - "Central America Standard Time": "America/Guatemala", - "Central Asia Standard Time": "Asia/Almaty", - "Central Brazilian Standard Time": "America/Cuiaba", - "Central Europe Standard Time": "Europe/Budapest", - "Central European Standard Time": "Europe/Warsaw", - "Central Pacific Standard Time": "Pacific/Guadalcanal", - "Central Standard Time": "America/Chicago", - "Central Standard Time (Mexico)": "America/Mexico_City", - "Chatham Islands Standard Time": "Pacific/Chatham", - "China Standard Time": "Asia/Shanghai", - "Cuba Standard Time": "America/Havana", - "Dateline Standard Time": "Etc/GMT+12", - "E. Africa Standard Time": "Africa/Nairobi", - "E. Australia Standard Time": "Australia/Brisbane", - "E. Europe Standard Time": "Europe/Chisinau", - "E. South America Standard Time": "America/Sao_Paulo", - "Easter Island Standard Time": "Pacific/Easter", - "Eastern Standard Time": "America/New_York", - "Eastern Standard Time (Mexico)": "America/Cancun", - "Egypt Standard Time": "Africa/Cairo", - "Ekaterinburg Standard Time": "Asia/Yekaterinburg", - "FLE Standard Time": "Europe/Kiev", - "Fiji Standard Time": "Pacific/Fiji", - "GMT Standard Time": "Europe/London", - "GTB Standard Time": "Europe/Bucharest", - "Georgian Standard Time": "Asia/Tbilisi", - "Greenland Standard Time": "America/Godthab", - "Greenwich Standard Time": "Atlantic/Reykjavik", - "Haiti Standard Time": "America/Port-au-Prince", - "Hawaiian Standard Time": "Pacific/Honolulu", - "India Standard Time": "Asia/Calcutta", - "Iran Standard Time": "Asia/Tehran", - "Israel Standard Time": "Asia/Jerusalem", - "Jordan Standard Time": "Asia/Amman", - "Kaliningrad Standard Time": "Europe/Kaliningrad", - "Korea Standard Time": "Asia/Seoul", - "Libya Standard Time": "Africa/Tripoli", - "Line Islands Standard Time": "Pacific/Kiritimati", - "Lord Howe Standard Time": "Australia/Lord_Howe", - "Magadan Standard Time": "Asia/Magadan", - "Magallanes Standard Time": "America/Punta_Arenas", - "Marquesas Standard Time": "Pacific/Marquesas", - "Mauritius Standard Time": "Indian/Mauritius", - "Middle East Standard Time": "Asia/Beirut", - "Montevideo Standard Time": "America/Montevideo", - "Morocco Standard Time": "Africa/Casablanca", - "Mountain Standard Time": "America/Denver", - "Mountain Standard Time (Mexico)": "America/Mazatlan", - "Myanmar Standard Time": "Asia/Rangoon", - "N. Central Asia Standard Time": "Asia/Novosibirsk", - "Namibia Standard Time": "Africa/Windhoek", - "Nepal Standard Time": "Asia/Katmandu", - "New Zealand Standard Time": "Pacific/Auckland", - "Newfoundland Standard Time": "America/St_Johns", - "Norfolk Standard Time": "Pacific/Norfolk", - "North Asia East Standard Time": "Asia/Irkutsk", - "North Asia Standard Time": "Asia/Krasnoyarsk", - "North Korea Standard Time": "Asia/Pyongyang", - "Omsk Standard Time": "Asia/Omsk", - "Pacific SA Standard Time": "America/Santiago", - "Pacific Standard Time": "America/Los_Angeles", - "Pacific Standard Time (Mexico)": "America/Tijuana", - "Pakistan Standard Time": "Asia/Karachi", - "Paraguay Standard Time": "America/Asuncion", - "Qyzylorda Standard Time": "Asia/Qyzylorda", - "Romance Standard Time": "Europe/Paris", - "Russia Time Zone 10": "Asia/Srednekolymsk", - "Russia Time Zone 11": "Asia/Kamchatka", - "Russia Time Zone 3": "Europe/Samara", - "Russian Standard Time": "Europe/Moscow", - "SA Eastern Standard Time": "America/Cayenne", - "SA Pacific Standard Time": "America/Bogota", - "SA Western Standard Time": "America/La_Paz", - "SE Asia Standard Time": "Asia/Bangkok", - "Saint Pierre Standard Time": "America/Miquelon", - "Sakhalin Standard Time": "Asia/Sakhalin", - "Samoa Standard Time": "Pacific/Apia", - "Sao Tome Standard Time": "Africa/Sao_Tome", - "Saratov Standard Time": "Europe/Saratov", - "Singapore Standard Time": "Asia/Singapore", - "South Africa Standard Time": "Africa/Johannesburg", - "South Sudan Standard Time": "Africa/Juba", - "Sri Lanka Standard Time": "Asia/Colombo", - "Sudan Standard Time": "Africa/Khartoum", - "Syria Standard Time": "Asia/Damascus", - "Taipei Standard Time": "Asia/Taipei", - "Tasmania Standard Time": "Australia/Hobart", - "Tocantins Standard Time": "America/Araguaina", - "Tokyo Standard Time": "Asia/Tokyo", - "Tomsk Standard Time": "Asia/Tomsk", - "Tonga Standard Time": "Pacific/Tongatapu", - "Transbaikal Standard Time": "Asia/Chita", - "Turkey Standard Time": "Europe/Istanbul", - "Turks And Caicos Standard Time": "America/Grand_Turk", - "US Eastern Standard Time": "America/Indianapolis", - "US Mountain Standard Time": "America/Phoenix", - "UTC": "Etc/UTC", - "UTC+12": "Etc/GMT-12", - "UTC+13": "Etc/GMT-13", - "UTC-02": "Etc/GMT+2", - "UTC-08": "Etc/GMT+8", - "UTC-09": "Etc/GMT+9", - "UTC-11": "Etc/GMT+11", - "Ulaanbaatar Standard Time": "Asia/Ulaanbaatar", - "Venezuela Standard Time": "America/Caracas", - "Vladivostok Standard Time": "Asia/Vladivostok", - "Volgograd Standard Time": "Europe/Volgograd", - "W. Australia Standard Time": "Australia/Perth", - "W. Central Africa Standard Time": "Africa/Lagos", - "W. Europe Standard Time": "Europe/Berlin", - "W. Mongolia Standard Time": "Asia/Hovd", - "West Asia Standard Time": "Asia/Tashkent", - "West Bank Standard Time": "Asia/Hebron", - "West Pacific Standard Time": "Pacific/Port_Moresby", - "Yakutsk Standard Time": "Asia/Yakutsk", - "Yukon Standard Time": "America/Whitehorse", -} +win_tz = {'AUS Central Standard Time': 'Australia/Darwin', + 'AUS Eastern Standard Time': 'Australia/Sydney', + 'Afghanistan Standard Time': 'Asia/Kabul', + 'Alaskan Standard Time': 'America/Anchorage', + 'Aleutian Standard Time': 'America/Adak', + 'Altai Standard Time': 'Asia/Barnaul', + 'Arab Standard Time': 'Asia/Riyadh', + 'Arabian Standard Time': 'Asia/Dubai', + 'Arabic Standard Time': 'Asia/Baghdad', + 'Argentina Standard Time': 'America/Buenos_Aires', + 'Astrakhan Standard Time': 'Europe/Astrakhan', + 'Atlantic Standard Time': 'America/Halifax', + 'Aus Central W. Standard Time': 'Australia/Eucla', + 'Azerbaijan Standard Time': 'Asia/Baku', + 'Azores Standard Time': 'Atlantic/Azores', + 'Bahia Standard Time': 'America/Bahia', + 'Bangladesh Standard Time': 'Asia/Dhaka', + 'Belarus Standard Time': 'Europe/Minsk', + 'Bougainville Standard Time': 'Pacific/Bougainville', + 'Canada Central Standard Time': 'America/Regina', + 'Cape Verde Standard Time': 'Atlantic/Cape_Verde', + 'Caucasus Standard Time': 'Asia/Yerevan', + 'Cen. Australia Standard Time': 'Australia/Adelaide', + 'Central America Standard Time': 'America/Guatemala', + 'Central Asia Standard Time': 'Asia/Almaty', + 'Central Brazilian Standard Time': 'America/Cuiaba', + 'Central Europe Standard Time': 'Europe/Budapest', + 'Central European Standard Time': 'Europe/Warsaw', + 'Central Pacific Standard Time': 'Pacific/Guadalcanal', + 'Central Standard Time': 'America/Chicago', + 'Central Standard Time (Mexico)': 'America/Mexico_City', + 'Chatham Islands Standard Time': 'Pacific/Chatham', + 'China Standard Time': 'Asia/Shanghai', + 'Cuba Standard Time': 'America/Havana', + 'Dateline Standard Time': 'Etc/GMT+12', + 'E. Africa Standard Time': 'Africa/Nairobi', + 'E. Australia Standard Time': 'Australia/Brisbane', + 'E. Europe Standard Time': 'Europe/Chisinau', + 'E. South America Standard Time': 'America/Sao_Paulo', + 'Easter Island Standard Time': 'Pacific/Easter', + 'Eastern Standard Time': 'America/New_York', + 'Eastern Standard Time (Mexico)': 'America/Cancun', + 'Egypt Standard Time': 'Africa/Cairo', + 'Ekaterinburg Standard Time': 'Asia/Yekaterinburg', + 'FLE Standard Time': 'Europe/Kiev', + 'Fiji Standard Time': 'Pacific/Fiji', + 'GMT Standard Time': 'Europe/London', + 'GTB Standard Time': 'Europe/Bucharest', + 'Georgian Standard Time': 'Asia/Tbilisi', + 'Greenland Standard Time': 'America/Godthab', + 'Greenwich Standard Time': 'Atlantic/Reykjavik', + 'Haiti Standard Time': 'America/Port-au-Prince', + 'Hawaiian Standard Time': 'Pacific/Honolulu', + 'India Standard Time': 'Asia/Calcutta', + 'Iran Standard Time': 'Asia/Tehran', + 'Israel Standard Time': 'Asia/Jerusalem', + 'Jordan Standard Time': 'Asia/Amman', + 'Kaliningrad Standard Time': 'Europe/Kaliningrad', + 'Korea Standard Time': 'Asia/Seoul', + 'Libya Standard Time': 'Africa/Tripoli', + 'Line Islands Standard Time': 'Pacific/Kiritimati', + 'Lord Howe Standard Time': 'Australia/Lord_Howe', + 'Magadan Standard Time': 'Asia/Magadan', + 'Magallanes Standard Time': 'America/Punta_Arenas', + 'Marquesas Standard Time': 'Pacific/Marquesas', + 'Mauritius Standard Time': 'Indian/Mauritius', + 'Middle East Standard Time': 'Asia/Beirut', + 'Montevideo Standard Time': 'America/Montevideo', + 'Morocco Standard Time': 'Africa/Casablanca', + 'Mountain Standard Time': 'America/Denver', + 'Mountain Standard Time (Mexico)': 'America/Chihuahua', + 'Myanmar Standard Time': 'Asia/Rangoon', + 'N. Central Asia Standard Time': 'Asia/Novosibirsk', + 'Namibia Standard Time': 'Africa/Windhoek', + 'Nepal Standard Time': 'Asia/Katmandu', + 'New Zealand Standard Time': 'Pacific/Auckland', + 'Newfoundland Standard Time': 'America/St_Johns', + 'Norfolk Standard Time': 'Pacific/Norfolk', + 'North Asia East Standard Time': 'Asia/Irkutsk', + 'North Asia Standard Time': 'Asia/Krasnoyarsk', + 'North Korea Standard Time': 'Asia/Pyongyang', + 'Omsk Standard Time': 'Asia/Omsk', + 'Pacific SA Standard Time': 'America/Santiago', + 'Pacific Standard Time': 'America/Los_Angeles', + 'Pacific Standard Time (Mexico)': 'America/Tijuana', + 'Pakistan Standard Time': 'Asia/Karachi', + 'Paraguay Standard Time': 'America/Asuncion', + 'Qyzylorda Standard Time': 'Asia/Qyzylorda', + 'Romance Standard Time': 'Europe/Paris', + 'Russia Time Zone 10': 'Asia/Srednekolymsk', + 'Russia Time Zone 11': 'Asia/Kamchatka', + 'Russia Time Zone 3': 'Europe/Samara', + 'Russian Standard Time': 'Europe/Moscow', + 'SA Eastern Standard Time': 'America/Cayenne', + 'SA Pacific Standard Time': 'America/Bogota', + 'SA Western Standard Time': 'America/La_Paz', + 'SE Asia Standard Time': 'Asia/Bangkok', + 'Saint Pierre Standard Time': 'America/Miquelon', + 'Sakhalin Standard Time': 'Asia/Sakhalin', + 'Samoa Standard Time': 'Pacific/Apia', + 'Sao Tome Standard Time': 'Africa/Sao_Tome', + 'Saratov Standard Time': 'Europe/Saratov', + 'Singapore Standard Time': 'Asia/Singapore', + 'South Africa Standard Time': 'Africa/Johannesburg', + 'South Sudan Standard Time': 'Africa/Juba', + 'Sri Lanka Standard Time': 'Asia/Colombo', + 'Sudan Standard Time': 'Africa/Khartoum', + 'Syria Standard Time': 'Asia/Damascus', + 'Taipei Standard Time': 'Asia/Taipei', + 'Tasmania Standard Time': 'Australia/Hobart', + 'Tocantins Standard Time': 'America/Araguaina', + 'Tokyo Standard Time': 'Asia/Tokyo', + 'Tomsk Standard Time': 'Asia/Tomsk', + 'Tonga Standard Time': 'Pacific/Tongatapu', + 'Transbaikal Standard Time': 'Asia/Chita', + 'Turkey Standard Time': 'Europe/Istanbul', + 'Turks And Caicos Standard Time': 'America/Grand_Turk', + 'US Eastern Standard Time': 'America/Indianapolis', + 'US Mountain Standard Time': 'America/Phoenix', + 'UTC': 'Etc/UTC', + 'UTC+12': 'Etc/GMT-12', + 'UTC+13': 'Etc/GMT-13', + 'UTC-02': 'Etc/GMT+2', + 'UTC-08': 'Etc/GMT+8', + 'UTC-09': 'Etc/GMT+9', + 'UTC-11': 'Etc/GMT+11', + 'Ulaanbaatar Standard Time': 'Asia/Ulaanbaatar', + 'Venezuela Standard Time': 'America/Caracas', + 'Vladivostok Standard Time': 'Asia/Vladivostok', + 'Volgograd Standard Time': 'Europe/Volgograd', + 'W. Australia Standard Time': 'Australia/Perth', + 'W. Central Africa Standard Time': 'Africa/Lagos', + 'W. Europe Standard Time': 'Europe/Berlin', + 'W. Mongolia Standard Time': 'Asia/Hovd', + 'West Asia Standard Time': 'Asia/Tashkent', + 'West Bank Standard Time': 'Asia/Hebron', + 'West Pacific Standard Time': 'Pacific/Port_Moresby', + 'Yakutsk Standard Time': 'Asia/Yakutsk', + 'Yukon Standard Time': 'America/Whitehorse'} # Old name for the win_tz variable: tz_names = win_tz -tz_win = { - "": "Central Standard Time (Mexico)", - "Africa/Abidjan": "Greenwich Standard Time", - "Africa/Accra": "Greenwich Standard Time", - "Africa/Addis_Ababa": "E. Africa Standard Time", - "Africa/Algiers": "W. Central Africa Standard Time", - "Africa/Asmara": "E. Africa Standard Time", - "Africa/Asmera": "E. Africa Standard Time", - "Africa/Bamako": "Greenwich Standard Time", - "Africa/Bangui": "W. Central Africa Standard Time", - "Africa/Banjul": "Greenwich Standard Time", - "Africa/Bissau": "Greenwich Standard Time", - "Africa/Blantyre": "South Africa Standard Time", - "Africa/Brazzaville": "W. Central Africa Standard Time", - "Africa/Bujumbura": "South Africa Standard Time", - "Africa/Cairo": "Egypt Standard Time", - "Africa/Casablanca": "Morocco Standard Time", - "Africa/Ceuta": "Romance Standard Time", - "Africa/Conakry": "Greenwich Standard Time", - "Africa/Dakar": "Greenwich Standard Time", - "Africa/Dar_es_Salaam": "E. Africa Standard Time", - "Africa/Djibouti": "E. Africa Standard Time", - "Africa/Douala": "W. Central Africa Standard Time", - "Africa/El_Aaiun": "Morocco Standard Time", - "Africa/Freetown": "Greenwich Standard Time", - "Africa/Gaborone": "South Africa Standard Time", - "Africa/Harare": "South Africa Standard Time", - "Africa/Johannesburg": "South Africa Standard Time", - "Africa/Juba": "South Sudan Standard Time", - "Africa/Kampala": "E. Africa Standard Time", - "Africa/Khartoum": "Sudan Standard Time", - "Africa/Kigali": "South Africa Standard Time", - "Africa/Kinshasa": "W. Central Africa Standard Time", - "Africa/Lagos": "W. Central Africa Standard Time", - "Africa/Libreville": "W. Central Africa Standard Time", - "Africa/Lome": "Greenwich Standard Time", - "Africa/Luanda": "W. Central Africa Standard Time", - "Africa/Lubumbashi": "South Africa Standard Time", - "Africa/Lusaka": "South Africa Standard Time", - "Africa/Malabo": "W. Central Africa Standard Time", - "Africa/Maputo": "South Africa Standard Time", - "Africa/Maseru": "South Africa Standard Time", - "Africa/Mbabane": "South Africa Standard Time", - "Africa/Mogadishu": "E. Africa Standard Time", - "Africa/Monrovia": "Greenwich Standard Time", - "Africa/Nairobi": "E. Africa Standard Time", - "Africa/Ndjamena": "W. Central Africa Standard Time", - "Africa/Niamey": "W. Central Africa Standard Time", - "Africa/Nouakchott": "Greenwich Standard Time", - "Africa/Ouagadougou": "Greenwich Standard Time", - "Africa/Porto-Novo": "W. Central Africa Standard Time", - "Africa/Sao_Tome": "Sao Tome Standard Time", - "Africa/Timbuktu": "Greenwich Standard Time", - "Africa/Tripoli": "Libya Standard Time", - "Africa/Tunis": "W. Central Africa Standard Time", - "Africa/Windhoek": "Namibia Standard Time", - "America/Adak": "Aleutian Standard Time", - "America/Anchorage": "Alaskan Standard Time", - "America/Anguilla": "SA Western Standard Time", - "America/Antigua": "SA Western Standard Time", - "America/Araguaina": "Tocantins Standard Time", - "America/Argentina/La_Rioja": "Argentina Standard Time", - "America/Argentina/Rio_Gallegos": "Argentina Standard Time", - "America/Argentina/Salta": "Argentina Standard Time", - "America/Argentina/San_Juan": "Argentina Standard Time", - "America/Argentina/San_Luis": "Argentina Standard Time", - "America/Argentina/Tucuman": "Argentina Standard Time", - "America/Argentina/Ushuaia": "Argentina Standard Time", - "America/Aruba": "SA Western Standard Time", - "America/Asuncion": "Paraguay Standard Time", - "America/Atikokan": "SA Pacific Standard Time", - "America/Atka": "Aleutian Standard Time", - "America/Bahia": "Bahia Standard Time", - "America/Bahia_Banderas": "Central Standard Time (Mexico)", - "America/Barbados": "SA Western Standard Time", - "America/Belem": "SA Eastern Standard Time", - "America/Belize": "Central America Standard Time", - "America/Blanc-Sablon": "SA Western Standard Time", - "America/Boa_Vista": "SA Western Standard Time", - "America/Bogota": "SA Pacific Standard Time", - "America/Boise": "Mountain Standard Time", - "America/Buenos_Aires": "Argentina Standard Time", - "America/Cambridge_Bay": "Mountain Standard Time", - "America/Campo_Grande": "Central Brazilian Standard Time", - "America/Cancun": "Eastern Standard Time (Mexico)", - "America/Caracas": "Venezuela Standard Time", - "America/Catamarca": "Argentina Standard Time", - "America/Cayenne": "SA Eastern Standard Time", - "America/Cayman": "SA Pacific Standard Time", - "America/Chicago": "Central Standard Time", - "America/Chihuahua": "Central Standard Time (Mexico)", - "America/Ciudad_Juarez": "Mountain Standard Time", - "America/Coral_Harbour": "SA Pacific Standard Time", - "America/Cordoba": "Argentina Standard Time", - "America/Costa_Rica": "Central America Standard Time", - "America/Creston": "US Mountain Standard Time", - "America/Cuiaba": "Central Brazilian Standard Time", - "America/Curacao": "SA Western Standard Time", - "America/Danmarkshavn": "Greenwich Standard Time", - "America/Dawson": "Yukon Standard Time", - "America/Dawson_Creek": "US Mountain Standard Time", - "America/Denver": "Mountain Standard Time", - "America/Detroit": "Eastern Standard Time", - "America/Dominica": "SA Western Standard Time", - "America/Edmonton": "Mountain Standard Time", - "America/Eirunepe": "SA Pacific Standard Time", - "America/El_Salvador": "Central America Standard Time", - "America/Ensenada": "Pacific Standard Time (Mexico)", - "America/Fort_Nelson": "US Mountain Standard Time", - "America/Fortaleza": "SA Eastern Standard Time", - "America/Glace_Bay": "Atlantic Standard Time", - "America/Godthab": "Greenland Standard Time", - "America/Goose_Bay": "Atlantic Standard Time", - "America/Grand_Turk": "Turks And Caicos Standard Time", - "America/Grenada": "SA Western Standard Time", - "America/Guadeloupe": "SA Western Standard Time", - "America/Guatemala": "Central America Standard Time", - "America/Guayaquil": "SA Pacific Standard Time", - "America/Guyana": "SA Western Standard Time", - "America/Halifax": "Atlantic Standard Time", - "America/Havana": "Cuba Standard Time", - "America/Hermosillo": "US Mountain Standard Time", - "America/Indiana/Knox": "Central Standard Time", - "America/Indiana/Marengo": "US Eastern Standard Time", - "America/Indiana/Petersburg": "Eastern Standard Time", - "America/Indiana/Tell_City": "Central Standard Time", - "America/Indiana/Vevay": "US Eastern Standard Time", - "America/Indiana/Vincennes": "Eastern Standard Time", - "America/Indiana/Winamac": "Eastern Standard Time", - "America/Indianapolis": "US Eastern Standard Time", - "America/Inuvik": "Mountain Standard Time", - "America/Iqaluit": "Eastern Standard Time", - "America/Jamaica": "SA Pacific Standard Time", - "America/Jujuy": "Argentina Standard Time", - "America/Juneau": "Alaskan Standard Time", - "America/Kentucky/Monticello": "Eastern Standard Time", - "America/Knox_IN": "Central Standard Time", - "America/Kralendijk": "SA Western Standard Time", - "America/La_Paz": "SA Western Standard Time", - "America/Lima": "SA Pacific Standard Time", - "America/Los_Angeles": "Pacific Standard Time", - "America/Louisville": "Eastern Standard Time", - "America/Lower_Princes": "SA Western Standard Time", - "America/Maceio": "SA Eastern Standard Time", - "America/Managua": "Central America Standard Time", - "America/Manaus": "SA Western Standard Time", - "America/Marigot": "SA Western Standard Time", - "America/Martinique": "SA Western Standard Time", - "America/Matamoros": "Central Standard Time", - "America/Mazatlan": "Mountain Standard Time (Mexico)", - "America/Mendoza": "Argentina Standard Time", - "America/Menominee": "Central Standard Time", - "America/Merida": "Central Standard Time (Mexico)", - "America/Metlakatla": "Alaskan Standard Time", - "America/Mexico_City": "Central Standard Time (Mexico)", - "America/Miquelon": "Saint Pierre Standard Time", - "America/Moncton": "Atlantic Standard Time", - "America/Monterrey": "Central Standard Time (Mexico)", - "America/Montevideo": "Montevideo Standard Time", - "America/Montreal": "Eastern Standard Time", - "America/Montserrat": "SA Western Standard Time", - "America/Nassau": "Eastern Standard Time", - "America/New_York": "Eastern Standard Time", - "America/Nipigon": "Eastern Standard Time", - "America/Nome": "Alaskan Standard Time", - "America/Noronha": "UTC-02", - "America/North_Dakota/Beulah": "Central Standard Time", - "America/North_Dakota/Center": "Central Standard Time", - "America/North_Dakota/New_Salem": "Central Standard Time", - "America/Ojinaga": "Central Standard Time", - "America/Panama": "SA Pacific Standard Time", - "America/Pangnirtung": "Eastern Standard Time", - "America/Paramaribo": "SA Eastern Standard Time", - "America/Phoenix": "US Mountain Standard Time", - "America/Port-au-Prince": "Haiti Standard Time", - "America/Port_of_Spain": "SA Western Standard Time", - "America/Porto_Acre": "SA Pacific Standard Time", - "America/Porto_Velho": "SA Western Standard Time", - "America/Puerto_Rico": "SA Western Standard Time", - "America/Punta_Arenas": "Magallanes Standard Time", - "America/Rainy_River": "Central Standard Time", - "America/Rankin_Inlet": "Central Standard Time", - "America/Recife": "SA Eastern Standard Time", - "America/Regina": "Canada Central Standard Time", - "America/Resolute": "Central Standard Time", - "America/Rio_Branco": "SA Pacific Standard Time", - "America/Santa_Isabel": "Pacific Standard Time (Mexico)", - "America/Santarem": "SA Eastern Standard Time", - "America/Santiago": "Pacific SA Standard Time", - "America/Santo_Domingo": "SA Western Standard Time", - "America/Sao_Paulo": "E. South America Standard Time", - "America/Scoresbysund": "Azores Standard Time", - "America/Shiprock": "Mountain Standard Time", - "America/Sitka": "Alaskan Standard Time", - "America/St_Barthelemy": "SA Western Standard Time", - "America/St_Johns": "Newfoundland Standard Time", - "America/St_Kitts": "SA Western Standard Time", - "America/St_Lucia": "SA Western Standard Time", - "America/St_Thomas": "SA Western Standard Time", - "America/St_Vincent": "SA Western Standard Time", - "America/Swift_Current": "Canada Central Standard Time", - "America/Tegucigalpa": "Central America Standard Time", - "America/Thule": "Atlantic Standard Time", - "America/Thunder_Bay": "Eastern Standard Time", - "America/Tijuana": "Pacific Standard Time (Mexico)", - "America/Toronto": "Eastern Standard Time", - "America/Tortola": "SA Western Standard Time", - "America/Vancouver": "Pacific Standard Time", - "America/Virgin": "SA Western Standard Time", - "America/Whitehorse": "Yukon Standard Time", - "America/Winnipeg": "Central Standard Time", - "America/Yakutat": "Alaskan Standard Time", - "America/Yellowknife": "Mountain Standard Time", - "Antarctica/Casey": "Central Pacific Standard Time", - "Antarctica/Davis": "SE Asia Standard Time", - "Antarctica/DumontDUrville": "West Pacific Standard Time", - "Antarctica/Macquarie": "Tasmania Standard Time", - "Antarctica/Mawson": "West Asia Standard Time", - "Antarctica/McMurdo": "New Zealand Standard Time", - "Antarctica/Palmer": "SA Eastern Standard Time", - "Antarctica/Rothera": "SA Eastern Standard Time", - "Antarctica/South_Pole": "New Zealand Standard Time", - "Antarctica/Syowa": "Arab Standard Time", - "Antarctica/Vostok": "Central Asia Standard Time", - "Arctic/Longyearbyen": "W. Europe Standard Time", - "Asia/Aden": "Arab Standard Time", - "Asia/Almaty": "Central Asia Standard Time", - "Asia/Amman": "Jordan Standard Time", - "Asia/Anadyr": "Russia Time Zone 11", - "Asia/Aqtau": "West Asia Standard Time", - "Asia/Aqtobe": "West Asia Standard Time", - "Asia/Ashgabat": "West Asia Standard Time", - "Asia/Ashkhabad": "West Asia Standard Time", - "Asia/Atyrau": "West Asia Standard Time", - "Asia/Baghdad": "Arabic Standard Time", - "Asia/Bahrain": "Arab Standard Time", - "Asia/Baku": "Azerbaijan Standard Time", - "Asia/Bangkok": "SE Asia Standard Time", - "Asia/Barnaul": "Altai Standard Time", - "Asia/Beirut": "Middle East Standard Time", - "Asia/Bishkek": "Central Asia Standard Time", - "Asia/Brunei": "Singapore Standard Time", - "Asia/Calcutta": "India Standard Time", - "Asia/Chita": "Transbaikal Standard Time", - "Asia/Choibalsan": "Ulaanbaatar Standard Time", - "Asia/Chongqing": "China Standard Time", - "Asia/Chungking": "China Standard Time", - "Asia/Colombo": "Sri Lanka Standard Time", - "Asia/Dacca": "Bangladesh Standard Time", - "Asia/Damascus": "Syria Standard Time", - "Asia/Dhaka": "Bangladesh Standard Time", - "Asia/Dili": "Tokyo Standard Time", - "Asia/Dubai": "Arabian Standard Time", - "Asia/Dushanbe": "West Asia Standard Time", - "Asia/Famagusta": "GTB Standard Time", - "Asia/Gaza": "West Bank Standard Time", - "Asia/Harbin": "China Standard Time", - "Asia/Hebron": "West Bank Standard Time", - "Asia/Hong_Kong": "China Standard Time", - "Asia/Hovd": "W. Mongolia Standard Time", - "Asia/Irkutsk": "North Asia East Standard Time", - "Asia/Istanbul": "Turkey Standard Time", - "Asia/Jakarta": "SE Asia Standard Time", - "Asia/Jayapura": "Tokyo Standard Time", - "Asia/Jerusalem": "Israel Standard Time", - "Asia/Kabul": "Afghanistan Standard Time", - "Asia/Kamchatka": "Russia Time Zone 11", - "Asia/Karachi": "Pakistan Standard Time", - "Asia/Kashgar": "Central Asia Standard Time", - "Asia/Katmandu": "Nepal Standard Time", - "Asia/Khandyga": "Yakutsk Standard Time", - "Asia/Krasnoyarsk": "North Asia Standard Time", - "Asia/Kuala_Lumpur": "Singapore Standard Time", - "Asia/Kuching": "Singapore Standard Time", - "Asia/Kuwait": "Arab Standard Time", - "Asia/Macao": "China Standard Time", - "Asia/Macau": "China Standard Time", - "Asia/Magadan": "Magadan Standard Time", - "Asia/Makassar": "Singapore Standard Time", - "Asia/Manila": "Singapore Standard Time", - "Asia/Muscat": "Arabian Standard Time", - "Asia/Nicosia": "GTB Standard Time", - "Asia/Novokuznetsk": "North Asia Standard Time", - "Asia/Novosibirsk": "N. Central Asia Standard Time", - "Asia/Omsk": "Omsk Standard Time", - "Asia/Oral": "West Asia Standard Time", - "Asia/Phnom_Penh": "SE Asia Standard Time", - "Asia/Pontianak": "SE Asia Standard Time", - "Asia/Pyongyang": "North Korea Standard Time", - "Asia/Qatar": "Arab Standard Time", - "Asia/Qostanay": "Central Asia Standard Time", - "Asia/Qyzylorda": "Qyzylorda Standard Time", - "Asia/Rangoon": "Myanmar Standard Time", - "Asia/Riyadh": "Arab Standard Time", - "Asia/Saigon": "SE Asia Standard Time", - "Asia/Sakhalin": "Sakhalin Standard Time", - "Asia/Samarkand": "West Asia Standard Time", - "Asia/Seoul": "Korea Standard Time", - "Asia/Shanghai": "China Standard Time", - "Asia/Singapore": "Singapore Standard Time", - "Asia/Srednekolymsk": "Russia Time Zone 10", - "Asia/Taipei": "Taipei Standard Time", - "Asia/Tashkent": "West Asia Standard Time", - "Asia/Tbilisi": "Georgian Standard Time", - "Asia/Tehran": "Iran Standard Time", - "Asia/Tel_Aviv": "Israel Standard Time", - "Asia/Thimbu": "Bangladesh Standard Time", - "Asia/Thimphu": "Bangladesh Standard Time", - "Asia/Tokyo": "Tokyo Standard Time", - "Asia/Tomsk": "Tomsk Standard Time", - "Asia/Ujung_Pandang": "Singapore Standard Time", - "Asia/Ulaanbaatar": "Ulaanbaatar Standard Time", - "Asia/Ulan_Bator": "Ulaanbaatar Standard Time", - "Asia/Urumqi": "Central Asia Standard Time", - "Asia/Ust-Nera": "Vladivostok Standard Time", - "Asia/Vientiane": "SE Asia Standard Time", - "Asia/Vladivostok": "Vladivostok Standard Time", - "Asia/Yakutsk": "Yakutsk Standard Time", - "Asia/Yekaterinburg": "Ekaterinburg Standard Time", - "Asia/Yerevan": "Caucasus Standard Time", - "Atlantic/Azores": "Azores Standard Time", - "Atlantic/Bermuda": "Atlantic Standard Time", - "Atlantic/Canary": "GMT Standard Time", - "Atlantic/Cape_Verde": "Cape Verde Standard Time", - "Atlantic/Faeroe": "GMT Standard Time", - "Atlantic/Jan_Mayen": "W. Europe Standard Time", - "Atlantic/Madeira": "GMT Standard Time", - "Atlantic/Reykjavik": "Greenwich Standard Time", - "Atlantic/South_Georgia": "UTC-02", - "Atlantic/St_Helena": "Greenwich Standard Time", - "Atlantic/Stanley": "SA Eastern Standard Time", - "Australia/ACT": "AUS Eastern Standard Time", - "Australia/Adelaide": "Cen. Australia Standard Time", - "Australia/Brisbane": "E. Australia Standard Time", - "Australia/Broken_Hill": "Cen. Australia Standard Time", - "Australia/Canberra": "AUS Eastern Standard Time", - "Australia/Currie": "Tasmania Standard Time", - "Australia/Darwin": "AUS Central Standard Time", - "Australia/Eucla": "Aus Central W. Standard Time", - "Australia/Hobart": "Tasmania Standard Time", - "Australia/LHI": "Lord Howe Standard Time", - "Australia/Lindeman": "E. Australia Standard Time", - "Australia/Lord_Howe": "Lord Howe Standard Time", - "Australia/Melbourne": "AUS Eastern Standard Time", - "Australia/NSW": "AUS Eastern Standard Time", - "Australia/North": "AUS Central Standard Time", - "Australia/Perth": "W. Australia Standard Time", - "Australia/Queensland": "E. Australia Standard Time", - "Australia/South": "Cen. Australia Standard Time", - "Australia/Sydney": "AUS Eastern Standard Time", - "Australia/Tasmania": "Tasmania Standard Time", - "Australia/Victoria": "AUS Eastern Standard Time", - "Australia/West": "W. Australia Standard Time", - "Australia/Yancowinna": "Cen. Australia Standard Time", - "Brazil/Acre": "SA Pacific Standard Time", - "Brazil/DeNoronha": "UTC-02", - "Brazil/East": "E. South America Standard Time", - "Brazil/West": "SA Western Standard Time", - "CST6CDT": "Central Standard Time", - "Canada/Atlantic": "Atlantic Standard Time", - "Canada/Central": "Central Standard Time", - "Canada/Eastern": "Eastern Standard Time", - "Canada/Mountain": "Mountain Standard Time", - "Canada/Newfoundland": "Newfoundland Standard Time", - "Canada/Pacific": "Pacific Standard Time", - "Canada/Saskatchewan": "Canada Central Standard Time", - "Canada/Yukon": "Yukon Standard Time", - "Chile/Continental": "Pacific SA Standard Time", - "Chile/EasterIsland": "Easter Island Standard Time", - "Cuba": "Cuba Standard Time", - "EST5EDT": "Eastern Standard Time", - "Egypt": "Egypt Standard Time", - "Eire": "GMT Standard Time", - "Etc/GMT": "UTC", - "Etc/GMT+0": "UTC", - "Etc/GMT+1": "Cape Verde Standard Time", - "Etc/GMT+10": "Hawaiian Standard Time", - "Etc/GMT+11": "UTC-11", - "Etc/GMT+12": "Dateline Standard Time", - "Etc/GMT+2": "UTC-02", - "Etc/GMT+3": "SA Eastern Standard Time", - "Etc/GMT+4": "SA Western Standard Time", - "Etc/GMT+5": "SA Pacific Standard Time", - "Etc/GMT+6": "Central America Standard Time", - "Etc/GMT+7": "US Mountain Standard Time", - "Etc/GMT+8": "UTC-08", - "Etc/GMT+9": "UTC-09", - "Etc/GMT-0": "UTC", - "Etc/GMT-1": "W. Central Africa Standard Time", - "Etc/GMT-10": "West Pacific Standard Time", - "Etc/GMT-11": "Central Pacific Standard Time", - "Etc/GMT-12": "UTC+12", - "Etc/GMT-13": "UTC+13", - "Etc/GMT-14": "Line Islands Standard Time", - "Etc/GMT-2": "South Africa Standard Time", - "Etc/GMT-3": "E. Africa Standard Time", - "Etc/GMT-4": "Arabian Standard Time", - "Etc/GMT-5": "West Asia Standard Time", - "Etc/GMT-6": "Central Asia Standard Time", - "Etc/GMT-7": "SE Asia Standard Time", - "Etc/GMT-8": "Singapore Standard Time", - "Etc/GMT-9": "Tokyo Standard Time", - "Etc/GMT0": "UTC", - "Etc/Greenwich": "UTC", - "Etc/UCT": "UTC", - "Etc/UTC": "UTC", - "Etc/Universal": "UTC", - "Etc/Zulu": "UTC", - "Europe/Amsterdam": "Romance Standard Time", - "Europe/Andorra": "W. Europe Standard Time", - "Europe/Astrakhan": "Astrakhan Standard Time", - "Europe/Athens": "GTB Standard Time", - "Europe/Belfast": "GMT Standard Time", - "Europe/Belgrade": "Central Europe Standard Time", - "Europe/Berlin": "W. Europe Standard Time", - "Europe/Bratislava": "Central Europe Standard Time", - "Europe/Brussels": "Romance Standard Time", - "Europe/Bucharest": "GTB Standard Time", - "Europe/Budapest": "Central Europe Standard Time", - "Europe/Busingen": "W. Europe Standard Time", - "Europe/Chisinau": "E. Europe Standard Time", - "Europe/Copenhagen": "W. Europe Standard Time", - "Europe/Dublin": "GMT Standard Time", - "Europe/Gibraltar": "W. Europe Standard Time", - "Europe/Guernsey": "GMT Standard Time", - "Europe/Helsinki": "FLE Standard Time", - "Europe/Isle_of_Man": "GMT Standard Time", - "Europe/Istanbul": "Turkey Standard Time", - "Europe/Jersey": "GMT Standard Time", - "Europe/Kaliningrad": "Kaliningrad Standard Time", - "Europe/Kiev": "FLE Standard Time", - "Europe/Kirov": "Russian Standard Time", - "Europe/Lisbon": "GMT Standard Time", - "Europe/Ljubljana": "Central Europe Standard Time", - "Europe/London": "GMT Standard Time", - "Europe/Luxembourg": "Romance Standard Time", - "Europe/Madrid": "Romance Standard Time", - "Europe/Malta": "W. Europe Standard Time", - "Europe/Mariehamn": "FLE Standard Time", - "Europe/Minsk": "Belarus Standard Time", - "Europe/Monaco": "Romance Standard Time", - "Europe/Moscow": "Russian Standard Time", - "Europe/Nicosia": "GTB Standard Time", - "Europe/Oslo": "W. Europe Standard Time", - "Europe/Paris": "Romance Standard Time", - "Europe/Podgorica": "Central Europe Standard Time", - "Europe/Prague": "Central Europe Standard Time", - "Europe/Riga": "FLE Standard Time", - "Europe/Rome": "W. Europe Standard Time", - "Europe/Samara": "Russia Time Zone 3", - "Europe/San_Marino": "W. Europe Standard Time", - "Europe/Sarajevo": "Central Europe Standard Time", - "Europe/Saratov": "Saratov Standard Time", - "Europe/Simferopol": "Russian Standard Time", - "Europe/Skopje": "Central Europe Standard Time", - "Europe/Sofia": "FLE Standard Time", - "Europe/Stockholm": "W. Europe Standard Time", - "Europe/Tallinn": "FLE Standard Time", - "Europe/Tirane": "Central Europe Standard Time", - "Europe/Tiraspol": "E. Europe Standard Time", - "Europe/Ulyanovsk": "Astrakhan Standard Time", - "Europe/Uzhgorod": "FLE Standard Time", - "Europe/Vaduz": "W. Europe Standard Time", - "Europe/Vatican": "W. Europe Standard Time", - "Europe/Vienna": "W. Europe Standard Time", - "Europe/Vilnius": "FLE Standard Time", - "Europe/Volgograd": "Volgograd Standard Time", - "Europe/Warsaw": "Central European Standard Time", - "Europe/Zagreb": "Central Europe Standard Time", - "Europe/Zaporozhye": "FLE Standard Time", - "Europe/Zurich": "W. Europe Standard Time", - "GB": "GMT Standard Time", - "GB-Eire": "GMT Standard Time", - "GMT+0": "UTC", - "GMT-0": "UTC", - "GMT0": "UTC", - "Greenwich": "UTC", - "Hongkong": "China Standard Time", - "Iceland": "Greenwich Standard Time", - "Indian/Antananarivo": "E. Africa Standard Time", - "Indian/Chagos": "Central Asia Standard Time", - "Indian/Christmas": "SE Asia Standard Time", - "Indian/Cocos": "Myanmar Standard Time", - "Indian/Comoro": "E. Africa Standard Time", - "Indian/Kerguelen": "West Asia Standard Time", - "Indian/Mahe": "Arabian Standard Time", - "Indian/Maldives": "West Asia Standard Time", - "Indian/Mauritius": "Mauritius Standard Time", - "Indian/Mayotte": "E. Africa Standard Time", - "Indian/Reunion": "Arabian Standard Time", - "Iran": "Iran Standard Time", - "Israel": "Israel Standard Time", - "Jamaica": "SA Pacific Standard Time", - "Japan": "Tokyo Standard Time", - "Kwajalein": "UTC+12", - "Libya": "Libya Standard Time", - "MST7MDT": "Mountain Standard Time", - "Mexico/BajaNorte": "Pacific Standard Time (Mexico)", - "Mexico/BajaSur": "Mountain Standard Time (Mexico)", - "Mexico/General": "Central Standard Time (Mexico)", - "NZ": "New Zealand Standard Time", - "NZ-CHAT": "Chatham Islands Standard Time", - "Navajo": "Mountain Standard Time", - "PRC": "China Standard Time", - "PST8PDT": "Pacific Standard Time", - "Pacific/Apia": "Samoa Standard Time", - "Pacific/Auckland": "New Zealand Standard Time", - "Pacific/Bougainville": "Bougainville Standard Time", - "Pacific/Chatham": "Chatham Islands Standard Time", - "Pacific/Chuuk": "West Pacific Standard Time", - "Pacific/Easter": "Easter Island Standard Time", - "Pacific/Efate": "Central Pacific Standard Time", - "Pacific/Enderbury": "UTC+13", - "Pacific/Fakaofo": "UTC+13", - "Pacific/Fiji": "Fiji Standard Time", - "Pacific/Funafuti": "UTC+12", - "Pacific/Galapagos": "Central America Standard Time", - "Pacific/Gambier": "UTC-09", - "Pacific/Guadalcanal": "Central Pacific Standard Time", - "Pacific/Guam": "West Pacific Standard Time", - "Pacific/Honolulu": "Hawaiian Standard Time", - "Pacific/Johnston": "Hawaiian Standard Time", - "Pacific/Kiritimati": "Line Islands Standard Time", - "Pacific/Kosrae": "Central Pacific Standard Time", - "Pacific/Kwajalein": "UTC+12", - "Pacific/Majuro": "UTC+12", - "Pacific/Marquesas": "Marquesas Standard Time", - "Pacific/Midway": "UTC-11", - "Pacific/Nauru": "UTC+12", - "Pacific/Niue": "UTC-11", - "Pacific/Norfolk": "Norfolk Standard Time", - "Pacific/Noumea": "Central Pacific Standard Time", - "Pacific/Pago_Pago": "UTC-11", - "Pacific/Palau": "Tokyo Standard Time", - "Pacific/Pitcairn": "UTC-08", - "Pacific/Pohnpei": "Central Pacific Standard Time", - "Pacific/Ponape": "Central Pacific Standard Time", - "Pacific/Port_Moresby": "West Pacific Standard Time", - "Pacific/Rarotonga": "Hawaiian Standard Time", - "Pacific/Saipan": "West Pacific Standard Time", - "Pacific/Samoa": "UTC-11", - "Pacific/Tahiti": "Hawaiian Standard Time", - "Pacific/Tarawa": "UTC+12", - "Pacific/Tongatapu": "Tonga Standard Time", - "Pacific/Truk": "West Pacific Standard Time", - "Pacific/Wake": "UTC+12", - "Pacific/Wallis": "UTC+12", - "Pacific/Yap": "West Pacific Standard Time", - "Poland": "Central European Standard Time", - "Portugal": "GMT Standard Time", - "ROC": "Taipei Standard Time", - "ROK": "Korea Standard Time", - "Singapore": "Singapore Standard Time", - "Turkey": "Turkey Standard Time", - "UCT": "UTC", - "US/Alaska": "Alaskan Standard Time", - "US/Aleutian": "Aleutian Standard Time", - "US/Arizona": "US Mountain Standard Time", - "US/Central": "Central Standard Time", - "US/Eastern": "Eastern Standard Time", - "US/Hawaii": "Hawaiian Standard Time", - "US/Indiana-Starke": "Central Standard Time", - "US/Michigan": "Eastern Standard Time", - "US/Mountain": "Mountain Standard Time", - "US/Pacific": "Pacific Standard Time", - "US/Samoa": "UTC-11", - "UTC": "UTC", - "Universal": "UTC", - "W-SU": "Russian Standard Time", - "Zulu": "UTC", -} +tz_win = {'Africa/Abidjan': 'Greenwich Standard Time', + 'Africa/Accra': 'Greenwich Standard Time', + 'Africa/Addis_Ababa': 'E. Africa Standard Time', + 'Africa/Algiers': 'W. Central Africa Standard Time', + 'Africa/Asmera': 'E. Africa Standard Time', + 'Africa/Bamako': 'Greenwich Standard Time', + 'Africa/Bangui': 'W. Central Africa Standard Time', + 'Africa/Banjul': 'Greenwich Standard Time', + 'Africa/Bissau': 'Greenwich Standard Time', + 'Africa/Blantyre': 'South Africa Standard Time', + 'Africa/Brazzaville': 'W. Central Africa Standard Time', + 'Africa/Bujumbura': 'South Africa Standard Time', + 'Africa/Cairo': 'Egypt Standard Time', + 'Africa/Casablanca': 'Morocco Standard Time', + 'Africa/Ceuta': 'Romance Standard Time', + 'Africa/Conakry': 'Greenwich Standard Time', + 'Africa/Dakar': 'Greenwich Standard Time', + 'Africa/Dar_es_Salaam': 'E. Africa Standard Time', + 'Africa/Djibouti': 'E. Africa Standard Time', + 'Africa/Douala': 'W. Central Africa Standard Time', + 'Africa/El_Aaiun': 'Morocco Standard Time', + 'Africa/Freetown': 'Greenwich Standard Time', + 'Africa/Gaborone': 'South Africa Standard Time', + 'Africa/Harare': 'South Africa Standard Time', + 'Africa/Johannesburg': 'South Africa Standard Time', + 'Africa/Juba': 'South Sudan Standard Time', + 'Africa/Kampala': 'E. Africa Standard Time', + 'Africa/Khartoum': 'Sudan Standard Time', + 'Africa/Kigali': 'South Africa Standard Time', + 'Africa/Kinshasa': 'W. Central Africa Standard Time', + 'Africa/Lagos': 'W. Central Africa Standard Time', + 'Africa/Libreville': 'W. Central Africa Standard Time', + 'Africa/Lome': 'Greenwich Standard Time', + 'Africa/Luanda': 'W. Central Africa Standard Time', + 'Africa/Lubumbashi': 'South Africa Standard Time', + 'Africa/Lusaka': 'South Africa Standard Time', + 'Africa/Malabo': 'W. Central Africa Standard Time', + 'Africa/Maputo': 'South Africa Standard Time', + 'Africa/Maseru': 'South Africa Standard Time', + 'Africa/Mbabane': 'South Africa Standard Time', + 'Africa/Mogadishu': 'E. Africa Standard Time', + 'Africa/Monrovia': 'Greenwich Standard Time', + 'Africa/Nairobi': 'E. Africa Standard Time', + 'Africa/Ndjamena': 'W. Central Africa Standard Time', + 'Africa/Niamey': 'W. Central Africa Standard Time', + 'Africa/Nouakchott': 'Greenwich Standard Time', + 'Africa/Ouagadougou': 'Greenwich Standard Time', + 'Africa/Porto-Novo': 'W. Central Africa Standard Time', + 'Africa/Sao_Tome': 'Sao Tome Standard Time', + 'Africa/Timbuktu': 'Greenwich Standard Time', + 'Africa/Tripoli': 'Libya Standard Time', + 'Africa/Tunis': 'W. Central Africa Standard Time', + 'Africa/Windhoek': 'Namibia Standard Time', + 'America/Adak': 'Aleutian Standard Time', + 'America/Anchorage': 'Alaskan Standard Time', + 'America/Anguilla': 'SA Western Standard Time', + 'America/Antigua': 'SA Western Standard Time', + 'America/Araguaina': 'Tocantins Standard Time', + 'America/Argentina/La_Rioja': 'Argentina Standard Time', + 'America/Argentina/Rio_Gallegos': 'Argentina Standard Time', + 'America/Argentina/Salta': 'Argentina Standard Time', + 'America/Argentina/San_Juan': 'Argentina Standard Time', + 'America/Argentina/San_Luis': 'Argentina Standard Time', + 'America/Argentina/Tucuman': 'Argentina Standard Time', + 'America/Argentina/Ushuaia': 'Argentina Standard Time', + 'America/Aruba': 'SA Western Standard Time', + 'America/Asuncion': 'Paraguay Standard Time', + 'America/Atka': 'Aleutian Standard Time', + 'America/Bahia': 'Bahia Standard Time', + 'America/Bahia_Banderas': 'Central Standard Time (Mexico)', + 'America/Barbados': 'SA Western Standard Time', + 'America/Belem': 'SA Eastern Standard Time', + 'America/Belize': 'Central America Standard Time', + 'America/Blanc-Sablon': 'SA Western Standard Time', + 'America/Boa_Vista': 'SA Western Standard Time', + 'America/Bogota': 'SA Pacific Standard Time', + 'America/Boise': 'Mountain Standard Time', + 'America/Buenos_Aires': 'Argentina Standard Time', + 'America/Cambridge_Bay': 'Mountain Standard Time', + 'America/Campo_Grande': 'Central Brazilian Standard Time', + 'America/Cancun': 'Eastern Standard Time (Mexico)', + 'America/Caracas': 'Venezuela Standard Time', + 'America/Catamarca': 'Argentina Standard Time', + 'America/Cayenne': 'SA Eastern Standard Time', + 'America/Cayman': 'SA Pacific Standard Time', + 'America/Chicago': 'Central Standard Time', + 'America/Chihuahua': 'Mountain Standard Time (Mexico)', + 'America/Coral_Harbour': 'SA Pacific Standard Time', + 'America/Cordoba': 'Argentina Standard Time', + 'America/Costa_Rica': 'Central America Standard Time', + 'America/Creston': 'US Mountain Standard Time', + 'America/Cuiaba': 'Central Brazilian Standard Time', + 'America/Curacao': 'SA Western Standard Time', + 'America/Danmarkshavn': 'Greenwich Standard Time', + 'America/Dawson': 'Yukon Standard Time', + 'America/Dawson_Creek': 'US Mountain Standard Time', + 'America/Denver': 'Mountain Standard Time', + 'America/Detroit': 'Eastern Standard Time', + 'America/Dominica': 'SA Western Standard Time', + 'America/Edmonton': 'Mountain Standard Time', + 'America/Eirunepe': 'SA Pacific Standard Time', + 'America/El_Salvador': 'Central America Standard Time', + 'America/Ensenada': 'Pacific Standard Time (Mexico)', + 'America/Fort_Nelson': 'US Mountain Standard Time', + 'America/Fortaleza': 'SA Eastern Standard Time', + 'America/Glace_Bay': 'Atlantic Standard Time', + 'America/Godthab': 'Greenland Standard Time', + 'America/Goose_Bay': 'Atlantic Standard Time', + 'America/Grand_Turk': 'Turks And Caicos Standard Time', + 'America/Grenada': 'SA Western Standard Time', + 'America/Guadeloupe': 'SA Western Standard Time', + 'America/Guatemala': 'Central America Standard Time', + 'America/Guayaquil': 'SA Pacific Standard Time', + 'America/Guyana': 'SA Western Standard Time', + 'America/Halifax': 'Atlantic Standard Time', + 'America/Havana': 'Cuba Standard Time', + 'America/Hermosillo': 'US Mountain Standard Time', + 'America/Indiana/Knox': 'Central Standard Time', + 'America/Indiana/Marengo': 'US Eastern Standard Time', + 'America/Indiana/Petersburg': 'Eastern Standard Time', + 'America/Indiana/Tell_City': 'Central Standard Time', + 'America/Indiana/Vevay': 'US Eastern Standard Time', + 'America/Indiana/Vincennes': 'Eastern Standard Time', + 'America/Indiana/Winamac': 'Eastern Standard Time', + 'America/Indianapolis': 'US Eastern Standard Time', + 'America/Inuvik': 'Mountain Standard Time', + 'America/Iqaluit': 'Eastern Standard Time', + 'America/Jamaica': 'SA Pacific Standard Time', + 'America/Jujuy': 'Argentina Standard Time', + 'America/Juneau': 'Alaskan Standard Time', + 'America/Kentucky/Monticello': 'Eastern Standard Time', + 'America/Knox_IN': 'Central Standard Time', + 'America/Kralendijk': 'SA Western Standard Time', + 'America/La_Paz': 'SA Western Standard Time', + 'America/Lima': 'SA Pacific Standard Time', + 'America/Los_Angeles': 'Pacific Standard Time', + 'America/Louisville': 'Eastern Standard Time', + 'America/Lower_Princes': 'SA Western Standard Time', + 'America/Maceio': 'SA Eastern Standard Time', + 'America/Managua': 'Central America Standard Time', + 'America/Manaus': 'SA Western Standard Time', + 'America/Marigot': 'SA Western Standard Time', + 'America/Martinique': 'SA Western Standard Time', + 'America/Matamoros': 'Central Standard Time', + 'America/Mazatlan': 'Mountain Standard Time (Mexico)', + 'America/Mendoza': 'Argentina Standard Time', + 'America/Menominee': 'Central Standard Time', + 'America/Merida': 'Central Standard Time (Mexico)', + 'America/Metlakatla': 'Alaskan Standard Time', + 'America/Mexico_City': 'Central Standard Time (Mexico)', + 'America/Miquelon': 'Saint Pierre Standard Time', + 'America/Moncton': 'Atlantic Standard Time', + 'America/Monterrey': 'Central Standard Time (Mexico)', + 'America/Montevideo': 'Montevideo Standard Time', + 'America/Montreal': 'Eastern Standard Time', + 'America/Montserrat': 'SA Western Standard Time', + 'America/Nassau': 'Eastern Standard Time', + 'America/New_York': 'Eastern Standard Time', + 'America/Nipigon': 'Eastern Standard Time', + 'America/Nome': 'Alaskan Standard Time', + 'America/Noronha': 'UTC-02', + 'America/North_Dakota/Beulah': 'Central Standard Time', + 'America/North_Dakota/Center': 'Central Standard Time', + 'America/North_Dakota/New_Salem': 'Central Standard Time', + 'America/Ojinaga': 'Mountain Standard Time', + 'America/Panama': 'SA Pacific Standard Time', + 'America/Pangnirtung': 'Eastern Standard Time', + 'America/Paramaribo': 'SA Eastern Standard Time', + 'America/Phoenix': 'US Mountain Standard Time', + 'America/Port-au-Prince': 'Haiti Standard Time', + 'America/Port_of_Spain': 'SA Western Standard Time', + 'America/Porto_Acre': 'SA Pacific Standard Time', + 'America/Porto_Velho': 'SA Western Standard Time', + 'America/Puerto_Rico': 'SA Western Standard Time', + 'America/Punta_Arenas': 'Magallanes Standard Time', + 'America/Rainy_River': 'Central Standard Time', + 'America/Rankin_Inlet': 'Central Standard Time', + 'America/Recife': 'SA Eastern Standard Time', + 'America/Regina': 'Canada Central Standard Time', + 'America/Resolute': 'Central Standard Time', + 'America/Rio_Branco': 'SA Pacific Standard Time', + 'America/Santa_Isabel': 'Pacific Standard Time (Mexico)', + 'America/Santarem': 'SA Eastern Standard Time', + 'America/Santiago': 'Pacific SA Standard Time', + 'America/Santo_Domingo': 'SA Western Standard Time', + 'America/Sao_Paulo': 'E. South America Standard Time', + 'America/Scoresbysund': 'Azores Standard Time', + 'America/Shiprock': 'Mountain Standard Time', + 'America/Sitka': 'Alaskan Standard Time', + 'America/St_Barthelemy': 'SA Western Standard Time', + 'America/St_Johns': 'Newfoundland Standard Time', + 'America/St_Kitts': 'SA Western Standard Time', + 'America/St_Lucia': 'SA Western Standard Time', + 'America/St_Thomas': 'SA Western Standard Time', + 'America/St_Vincent': 'SA Western Standard Time', + 'America/Swift_Current': 'Canada Central Standard Time', + 'America/Tegucigalpa': 'Central America Standard Time', + 'America/Thule': 'Atlantic Standard Time', + 'America/Thunder_Bay': 'Eastern Standard Time', + 'America/Tijuana': 'Pacific Standard Time (Mexico)', + 'America/Toronto': 'Eastern Standard Time', + 'America/Tortola': 'SA Western Standard Time', + 'America/Vancouver': 'Pacific Standard Time', + 'America/Virgin': 'SA Western Standard Time', + 'America/Whitehorse': 'Yukon Standard Time', + 'America/Winnipeg': 'Central Standard Time', + 'America/Yakutat': 'Alaskan Standard Time', + 'America/Yellowknife': 'Mountain Standard Time', + 'Antarctica/Casey': 'Central Pacific Standard Time', + 'Antarctica/Davis': 'SE Asia Standard Time', + 'Antarctica/DumontDUrville': 'West Pacific Standard Time', + 'Antarctica/Macquarie': 'Tasmania Standard Time', + 'Antarctica/Mawson': 'West Asia Standard Time', + 'Antarctica/McMurdo': 'New Zealand Standard Time', + 'Antarctica/Palmer': 'SA Eastern Standard Time', + 'Antarctica/Rothera': 'SA Eastern Standard Time', + 'Antarctica/South_Pole': 'New Zealand Standard Time', + 'Antarctica/Syowa': 'E. Africa Standard Time', + 'Antarctica/Vostok': 'Central Asia Standard Time', + 'Arctic/Longyearbyen': 'W. Europe Standard Time', + 'Asia/Aden': 'Arab Standard Time', + 'Asia/Almaty': 'Central Asia Standard Time', + 'Asia/Amman': 'Jordan Standard Time', + 'Asia/Anadyr': 'Russia Time Zone 11', + 'Asia/Aqtau': 'West Asia Standard Time', + 'Asia/Aqtobe': 'West Asia Standard Time', + 'Asia/Ashgabat': 'West Asia Standard Time', + 'Asia/Ashkhabad': 'West Asia Standard Time', + 'Asia/Atyrau': 'West Asia Standard Time', + 'Asia/Baghdad': 'Arabic Standard Time', + 'Asia/Bahrain': 'Arab Standard Time', + 'Asia/Baku': 'Azerbaijan Standard Time', + 'Asia/Bangkok': 'SE Asia Standard Time', + 'Asia/Barnaul': 'Altai Standard Time', + 'Asia/Beirut': 'Middle East Standard Time', + 'Asia/Bishkek': 'Central Asia Standard Time', + 'Asia/Brunei': 'Singapore Standard Time', + 'Asia/Calcutta': 'India Standard Time', + 'Asia/Chita': 'Transbaikal Standard Time', + 'Asia/Choibalsan': 'Ulaanbaatar Standard Time', + 'Asia/Chongqing': 'China Standard Time', + 'Asia/Chungking': 'China Standard Time', + 'Asia/Colombo': 'Sri Lanka Standard Time', + 'Asia/Dacca': 'Bangladesh Standard Time', + 'Asia/Damascus': 'Syria Standard Time', + 'Asia/Dhaka': 'Bangladesh Standard Time', + 'Asia/Dili': 'Tokyo Standard Time', + 'Asia/Dubai': 'Arabian Standard Time', + 'Asia/Dushanbe': 'West Asia Standard Time', + 'Asia/Famagusta': 'GTB Standard Time', + 'Asia/Gaza': 'West Bank Standard Time', + 'Asia/Harbin': 'China Standard Time', + 'Asia/Hebron': 'West Bank Standard Time', + 'Asia/Hong_Kong': 'China Standard Time', + 'Asia/Hovd': 'W. Mongolia Standard Time', + 'Asia/Irkutsk': 'North Asia East Standard Time', + 'Asia/Jakarta': 'SE Asia Standard Time', + 'Asia/Jayapura': 'Tokyo Standard Time', + 'Asia/Jerusalem': 'Israel Standard Time', + 'Asia/Kabul': 'Afghanistan Standard Time', + 'Asia/Kamchatka': 'Russia Time Zone 11', + 'Asia/Karachi': 'Pakistan Standard Time', + 'Asia/Kashgar': 'Central Asia Standard Time', + 'Asia/Katmandu': 'Nepal Standard Time', + 'Asia/Khandyga': 'Yakutsk Standard Time', + 'Asia/Krasnoyarsk': 'North Asia Standard Time', + 'Asia/Kuala_Lumpur': 'Singapore Standard Time', + 'Asia/Kuching': 'Singapore Standard Time', + 'Asia/Kuwait': 'Arab Standard Time', + 'Asia/Macao': 'China Standard Time', + 'Asia/Macau': 'China Standard Time', + 'Asia/Magadan': 'Magadan Standard Time', + 'Asia/Makassar': 'Singapore Standard Time', + 'Asia/Manila': 'Singapore Standard Time', + 'Asia/Muscat': 'Arabian Standard Time', + 'Asia/Nicosia': 'GTB Standard Time', + 'Asia/Novokuznetsk': 'North Asia Standard Time', + 'Asia/Novosibirsk': 'N. Central Asia Standard Time', + 'Asia/Omsk': 'Omsk Standard Time', + 'Asia/Oral': 'West Asia Standard Time', + 'Asia/Phnom_Penh': 'SE Asia Standard Time', + 'Asia/Pontianak': 'SE Asia Standard Time', + 'Asia/Pyongyang': 'North Korea Standard Time', + 'Asia/Qatar': 'Arab Standard Time', + 'Asia/Qostanay': 'Central Asia Standard Time', + 'Asia/Qyzylorda': 'Qyzylorda Standard Time', + 'Asia/Rangoon': 'Myanmar Standard Time', + 'Asia/Riyadh': 'Arab Standard Time', + 'Asia/Saigon': 'SE Asia Standard Time', + 'Asia/Sakhalin': 'Sakhalin Standard Time', + 'Asia/Samarkand': 'West Asia Standard Time', + 'Asia/Seoul': 'Korea Standard Time', + 'Asia/Shanghai': 'China Standard Time', + 'Asia/Singapore': 'Singapore Standard Time', + 'Asia/Srednekolymsk': 'Russia Time Zone 10', + 'Asia/Taipei': 'Taipei Standard Time', + 'Asia/Tashkent': 'West Asia Standard Time', + 'Asia/Tbilisi': 'Georgian Standard Time', + 'Asia/Tehran': 'Iran Standard Time', + 'Asia/Tel_Aviv': 'Israel Standard Time', + 'Asia/Thimbu': 'Bangladesh Standard Time', + 'Asia/Thimphu': 'Bangladesh Standard Time', + 'Asia/Tokyo': 'Tokyo Standard Time', + 'Asia/Tomsk': 'Tomsk Standard Time', + 'Asia/Ujung_Pandang': 'Singapore Standard Time', + 'Asia/Ulaanbaatar': 'Ulaanbaatar Standard Time', + 'Asia/Ulan_Bator': 'Ulaanbaatar Standard Time', + 'Asia/Urumqi': 'Central Asia Standard Time', + 'Asia/Ust-Nera': 'Vladivostok Standard Time', + 'Asia/Vientiane': 'SE Asia Standard Time', + 'Asia/Vladivostok': 'Vladivostok Standard Time', + 'Asia/Yakutsk': 'Yakutsk Standard Time', + 'Asia/Yekaterinburg': 'Ekaterinburg Standard Time', + 'Asia/Yerevan': 'Caucasus Standard Time', + 'Atlantic/Azores': 'Azores Standard Time', + 'Atlantic/Bermuda': 'Atlantic Standard Time', + 'Atlantic/Canary': 'GMT Standard Time', + 'Atlantic/Cape_Verde': 'Cape Verde Standard Time', + 'Atlantic/Faeroe': 'GMT Standard Time', + 'Atlantic/Jan_Mayen': 'W. Europe Standard Time', + 'Atlantic/Madeira': 'GMT Standard Time', + 'Atlantic/Reykjavik': 'Greenwich Standard Time', + 'Atlantic/South_Georgia': 'UTC-02', + 'Atlantic/St_Helena': 'Greenwich Standard Time', + 'Atlantic/Stanley': 'SA Eastern Standard Time', + 'Australia/ACT': 'AUS Eastern Standard Time', + 'Australia/Adelaide': 'Cen. Australia Standard Time', + 'Australia/Brisbane': 'E. Australia Standard Time', + 'Australia/Broken_Hill': 'Cen. Australia Standard Time', + 'Australia/Canberra': 'AUS Eastern Standard Time', + 'Australia/Currie': 'Tasmania Standard Time', + 'Australia/Darwin': 'AUS Central Standard Time', + 'Australia/Eucla': 'Aus Central W. Standard Time', + 'Australia/Hobart': 'Tasmania Standard Time', + 'Australia/LHI': 'Lord Howe Standard Time', + 'Australia/Lindeman': 'E. Australia Standard Time', + 'Australia/Lord_Howe': 'Lord Howe Standard Time', + 'Australia/Melbourne': 'AUS Eastern Standard Time', + 'Australia/NSW': 'AUS Eastern Standard Time', + 'Australia/North': 'AUS Central Standard Time', + 'Australia/Perth': 'W. Australia Standard Time', + 'Australia/Queensland': 'E. Australia Standard Time', + 'Australia/South': 'Cen. Australia Standard Time', + 'Australia/Sydney': 'AUS Eastern Standard Time', + 'Australia/Tasmania': 'Tasmania Standard Time', + 'Australia/Victoria': 'AUS Eastern Standard Time', + 'Australia/West': 'W. Australia Standard Time', + 'Australia/Yancowinna': 'Cen. Australia Standard Time', + 'Brazil/Acre': 'SA Pacific Standard Time', + 'Brazil/DeNoronha': 'UTC-02', + 'Brazil/East': 'E. South America Standard Time', + 'Brazil/West': 'SA Western Standard Time', + 'CST6CDT': 'Central Standard Time', + 'Canada/Atlantic': 'Atlantic Standard Time', + 'Canada/Central': 'Central Standard Time', + 'Canada/Eastern': 'Eastern Standard Time', + 'Canada/Mountain': 'Mountain Standard Time', + 'Canada/Newfoundland': 'Newfoundland Standard Time', + 'Canada/Pacific': 'Pacific Standard Time', + 'Canada/Saskatchewan': 'Canada Central Standard Time', + 'Canada/Yukon': 'Yukon Standard Time', + 'Chile/Continental': 'Pacific SA Standard Time', + 'Chile/EasterIsland': 'Easter Island Standard Time', + 'Cuba': 'Cuba Standard Time', + 'EST5EDT': 'Eastern Standard Time', + 'Egypt': 'Egypt Standard Time', + 'Eire': 'GMT Standard Time', + 'Etc/GMT': 'UTC', + 'Etc/GMT+1': 'Cape Verde Standard Time', + 'Etc/GMT+10': 'Hawaiian Standard Time', + 'Etc/GMT+11': 'UTC-11', + 'Etc/GMT+12': 'Dateline Standard Time', + 'Etc/GMT+2': 'UTC-02', + 'Etc/GMT+3': 'SA Eastern Standard Time', + 'Etc/GMT+4': 'SA Western Standard Time', + 'Etc/GMT+5': 'SA Pacific Standard Time', + 'Etc/GMT+6': 'Central America Standard Time', + 'Etc/GMT+7': 'US Mountain Standard Time', + 'Etc/GMT+8': 'UTC-08', + 'Etc/GMT+9': 'UTC-09', + 'Etc/GMT-1': 'W. Central Africa Standard Time', + 'Etc/GMT-10': 'West Pacific Standard Time', + 'Etc/GMT-11': 'Central Pacific Standard Time', + 'Etc/GMT-12': 'UTC+12', + 'Etc/GMT-13': 'UTC+13', + 'Etc/GMT-14': 'Line Islands Standard Time', + 'Etc/GMT-2': 'South Africa Standard Time', + 'Etc/GMT-3': 'E. Africa Standard Time', + 'Etc/GMT-4': 'Arabian Standard Time', + 'Etc/GMT-5': 'West Asia Standard Time', + 'Etc/GMT-6': 'Central Asia Standard Time', + 'Etc/GMT-7': 'SE Asia Standard Time', + 'Etc/GMT-8': 'Singapore Standard Time', + 'Etc/GMT-9': 'Tokyo Standard Time', + 'Etc/UCT': 'UTC', + 'Etc/UTC': 'UTC', + 'Europe/Amsterdam': 'W. Europe Standard Time', + 'Europe/Andorra': 'W. Europe Standard Time', + 'Europe/Astrakhan': 'Astrakhan Standard Time', + 'Europe/Athens': 'GTB Standard Time', + 'Europe/Belfast': 'GMT Standard Time', + 'Europe/Belgrade': 'Central Europe Standard Time', + 'Europe/Berlin': 'W. Europe Standard Time', + 'Europe/Bratislava': 'Central Europe Standard Time', + 'Europe/Brussels': 'Romance Standard Time', + 'Europe/Bucharest': 'GTB Standard Time', + 'Europe/Budapest': 'Central Europe Standard Time', + 'Europe/Busingen': 'W. Europe Standard Time', + 'Europe/Chisinau': 'E. Europe Standard Time', + 'Europe/Copenhagen': 'Romance Standard Time', + 'Europe/Dublin': 'GMT Standard Time', + 'Europe/Gibraltar': 'W. Europe Standard Time', + 'Europe/Guernsey': 'GMT Standard Time', + 'Europe/Helsinki': 'FLE Standard Time', + 'Europe/Isle_of_Man': 'GMT Standard Time', + 'Europe/Istanbul': 'Turkey Standard Time', + 'Europe/Jersey': 'GMT Standard Time', + 'Europe/Kaliningrad': 'Kaliningrad Standard Time', + 'Europe/Kiev': 'FLE Standard Time', + 'Europe/Kirov': 'Russian Standard Time', + 'Europe/Lisbon': 'GMT Standard Time', + 'Europe/Ljubljana': 'Central Europe Standard Time', + 'Europe/London': 'GMT Standard Time', + 'Europe/Luxembourg': 'W. Europe Standard Time', + 'Europe/Madrid': 'Romance Standard Time', + 'Europe/Malta': 'W. Europe Standard Time', + 'Europe/Mariehamn': 'FLE Standard Time', + 'Europe/Minsk': 'Belarus Standard Time', + 'Europe/Monaco': 'W. Europe Standard Time', + 'Europe/Moscow': 'Russian Standard Time', + 'Europe/Oslo': 'W. Europe Standard Time', + 'Europe/Paris': 'Romance Standard Time', + 'Europe/Podgorica': 'Central Europe Standard Time', + 'Europe/Prague': 'Central Europe Standard Time', + 'Europe/Riga': 'FLE Standard Time', + 'Europe/Rome': 'W. Europe Standard Time', + 'Europe/Samara': 'Russia Time Zone 3', + 'Europe/San_Marino': 'W. Europe Standard Time', + 'Europe/Sarajevo': 'Central European Standard Time', + 'Europe/Saratov': 'Saratov Standard Time', + 'Europe/Simferopol': 'Russian Standard Time', + 'Europe/Skopje': 'Central European Standard Time', + 'Europe/Sofia': 'FLE Standard Time', + 'Europe/Stockholm': 'W. Europe Standard Time', + 'Europe/Tallinn': 'FLE Standard Time', + 'Europe/Tirane': 'Central Europe Standard Time', + 'Europe/Tiraspol': 'E. Europe Standard Time', + 'Europe/Ulyanovsk': 'Astrakhan Standard Time', + 'Europe/Uzhgorod': 'FLE Standard Time', + 'Europe/Vaduz': 'W. Europe Standard Time', + 'Europe/Vatican': 'W. Europe Standard Time', + 'Europe/Vienna': 'W. Europe Standard Time', + 'Europe/Vilnius': 'FLE Standard Time', + 'Europe/Volgograd': 'Volgograd Standard Time', + 'Europe/Warsaw': 'Central European Standard Time', + 'Europe/Zagreb': 'Central European Standard Time', + 'Europe/Zaporozhye': 'FLE Standard Time', + 'Europe/Zurich': 'W. Europe Standard Time', + 'GB': 'GMT Standard Time', + 'GB-Eire': 'GMT Standard Time', + 'GMT+0': 'UTC', + 'GMT-0': 'UTC', + 'GMT0': 'UTC', + 'Greenwich': 'UTC', + 'Hongkong': 'China Standard Time', + 'Iceland': 'Greenwich Standard Time', + 'Indian/Antananarivo': 'E. Africa Standard Time', + 'Indian/Chagos': 'Central Asia Standard Time', + 'Indian/Christmas': 'SE Asia Standard Time', + 'Indian/Cocos': 'Myanmar Standard Time', + 'Indian/Comoro': 'E. Africa Standard Time', + 'Indian/Kerguelen': 'West Asia Standard Time', + 'Indian/Mahe': 'Mauritius Standard Time', + 'Indian/Maldives': 'West Asia Standard Time', + 'Indian/Mauritius': 'Mauritius Standard Time', + 'Indian/Mayotte': 'E. Africa Standard Time', + 'Indian/Reunion': 'Mauritius Standard Time', + 'Iran': 'Iran Standard Time', + 'Israel': 'Israel Standard Time', + 'Jamaica': 'SA Pacific Standard Time', + 'Japan': 'Tokyo Standard Time', + 'Kwajalein': 'UTC+12', + 'Libya': 'Libya Standard Time', + 'MST7MDT': 'Mountain Standard Time', + 'Mexico/BajaNorte': 'Pacific Standard Time (Mexico)', + 'Mexico/BajaSur': 'Mountain Standard Time (Mexico)', + 'Mexico/General': 'Central Standard Time (Mexico)', + 'NZ': 'New Zealand Standard Time', + 'NZ-CHAT': 'Chatham Islands Standard Time', + 'Navajo': 'Mountain Standard Time', + 'PRC': 'China Standard Time', + 'PST8PDT': 'Pacific Standard Time', + 'Pacific/Apia': 'Samoa Standard Time', + 'Pacific/Auckland': 'New Zealand Standard Time', + 'Pacific/Bougainville': 'Bougainville Standard Time', + 'Pacific/Chatham': 'Chatham Islands Standard Time', + 'Pacific/Easter': 'Easter Island Standard Time', + 'Pacific/Efate': 'Central Pacific Standard Time', + 'Pacific/Enderbury': 'UTC+13', + 'Pacific/Fakaofo': 'UTC+13', + 'Pacific/Fiji': 'Fiji Standard Time', + 'Pacific/Funafuti': 'UTC+12', + 'Pacific/Galapagos': 'Central America Standard Time', + 'Pacific/Gambier': 'UTC-09', + 'Pacific/Guadalcanal': 'Central Pacific Standard Time', + 'Pacific/Guam': 'West Pacific Standard Time', + 'Pacific/Honolulu': 'Hawaiian Standard Time', + 'Pacific/Johnston': 'Hawaiian Standard Time', + 'Pacific/Kiritimati': 'Line Islands Standard Time', + 'Pacific/Kosrae': 'Central Pacific Standard Time', + 'Pacific/Kwajalein': 'UTC+12', + 'Pacific/Majuro': 'UTC+12', + 'Pacific/Marquesas': 'Marquesas Standard Time', + 'Pacific/Midway': 'UTC-11', + 'Pacific/Nauru': 'UTC+12', + 'Pacific/Niue': 'UTC-11', + 'Pacific/Norfolk': 'Norfolk Standard Time', + 'Pacific/Noumea': 'Central Pacific Standard Time', + 'Pacific/Pago_Pago': 'UTC-11', + 'Pacific/Palau': 'Tokyo Standard Time', + 'Pacific/Pitcairn': 'UTC-08', + 'Pacific/Ponape': 'Central Pacific Standard Time', + 'Pacific/Port_Moresby': 'West Pacific Standard Time', + 'Pacific/Rarotonga': 'Hawaiian Standard Time', + 'Pacific/Saipan': 'West Pacific Standard Time', + 'Pacific/Samoa': 'UTC-11', + 'Pacific/Tahiti': 'Hawaiian Standard Time', + 'Pacific/Tarawa': 'UTC+12', + 'Pacific/Tongatapu': 'Tonga Standard Time', + 'Pacific/Truk': 'West Pacific Standard Time', + 'Pacific/Wake': 'UTC+12', + 'Pacific/Wallis': 'UTC+12', + 'Poland': 'Central European Standard Time', + 'Portugal': 'GMT Standard Time', + 'ROC': 'Taipei Standard Time', + 'ROK': 'Korea Standard Time', + 'Singapore': 'Singapore Standard Time', + 'Turkey': 'Turkey Standard Time', + 'UCT': 'UTC', + 'US/Alaska': 'Alaskan Standard Time', + 'US/Aleutian': 'Aleutian Standard Time', + 'US/Arizona': 'US Mountain Standard Time', + 'US/Central': 'Central Standard Time', + 'US/Eastern': 'Eastern Standard Time', + 'US/Hawaii': 'Hawaiian Standard Time', + 'US/Indiana-Starke': 'Central Standard Time', + 'US/Michigan': 'Eastern Standard Time', + 'US/Mountain': 'Mountain Standard Time', + 'US/Pacific': 'Pacific Standard Time', + 'US/Samoa': 'UTC-11', + 'UTC': 'UTC', + 'Universal': 'UTC', + 'W-SU': 'Russian Standard Time', + 'Zulu': 'UTC'} diff --git a/package/requirements-package.txt b/package/requirements-package.txt index 1027cf23..e0bd159b 100644 --- a/package/requirements-package.txt +++ b/package/requirements-package.txt @@ -1,4 +1,4 @@ -apscheduler==3.10.4 +apscheduler==3.10.1 importlib-metadata==6.8.0 importlib-resources==6.0.1 pyinstaller==5.13.0 diff --git a/requirements.txt b/requirements.txt index 3fc87314..56927154 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,5 +1,5 @@ appdirs==1.4.4 -apscheduler==3.10.4 +apscheduler==3.10.1 arrow==1.2.3 backports.csv==1.0.7 backports.functools-lru-cache==1.6.6 From 85bc9c39ae82a38bd94bef21f5e7011e94b47c6c Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Fri, 25 Aug 2023 11:33:56 -0700 Subject: [PATCH 004/290] Update tzlocal==5.0.1 --- lib/tzlocal/__init__.py | 9 +- lib/tzlocal/unix.py | 63 +- lib/tzlocal/utils.py | 68 +- lib/tzlocal/win32.py | 32 +- lib/tzlocal/windows_tz.py | 1405 +++++++++++++++++++------------------ requirements.txt | 2 +- 6 files changed, 807 insertions(+), 772 deletions(-) diff --git a/lib/tzlocal/__init__.py b/lib/tzlocal/__init__.py index 98ed04fd..50abb093 100644 --- a/lib/tzlocal/__init__.py +++ b/lib/tzlocal/__init__.py @@ -9,5 +9,12 @@ if sys.platform == "win32": else: from tzlocal.unix import get_localzone, get_localzone_name, reload_localzone +from tzlocal.utils import assert_tz_offset -__all__ = ["get_localzone", "get_localzone_name", "reload_localzone"] + +__all__ = [ + "get_localzone", + "get_localzone_name", + "reload_localzone", + "assert_tz_offset", +] diff --git a/lib/tzlocal/unix.py b/lib/tzlocal/unix.py index eaf96d92..f510c12c 100644 --- a/lib/tzlocal/unix.py +++ b/lib/tzlocal/unix.py @@ -1,20 +1,21 @@ +import logging import os import re import sys import warnings from datetime import timezone -import pytz_deprecation_shim as pds from tzlocal import utils if sys.version_info >= (3, 9): - from zoneinfo import ZoneInfo # pragma: no cover + import zoneinfo # pragma: no cover else: - from backports.zoneinfo import ZoneInfo # pragma: no cover + from backports import zoneinfo # pragma: no cover _cache_tz = None _cache_tz_name = None +log = logging.getLogger("tzlocal") def _get_localzone_name(_root="/"): """Tries to find the local timezone configuration. @@ -32,14 +33,21 @@ def _get_localzone_name(_root="/"): # Are we under Termux on Android? if os.path.exists(os.path.join(_root, "system/bin/getprop")): + log.debug("This looks like Termux") + import subprocess - androidtz = ( - subprocess.check_output(["getprop", "persist.sys.timezone"]) - .strip() - .decode() - ) - return androidtz + try: + androidtz = ( + subprocess.check_output(["getprop", "persist.sys.timezone"]) + .strip() + .decode() + ) + return androidtz + except (OSError, subprocess.CalledProcessError): + # proot environment or failed to getprop + log.debug("It's not termux?") + pass # Now look for distribution specific configuration files # that contain the timezone name. @@ -50,10 +58,11 @@ def _get_localzone_name(_root="/"): for configfile in ("etc/timezone", "var/db/zoneinfo"): tzpath = os.path.join(_root, configfile) try: - with open(tzpath, "rt") as tzfile: + with open(tzpath) as tzfile: data = tzfile.read() + log.debug(f"{tzpath} found, contents:\n {data}") - etctz = data.strip('/ \t\r\n') + etctz = data.strip("/ \t\r\n") if not etctz: # Empty file, skip continue @@ -68,7 +77,7 @@ def _get_localzone_name(_root="/"): found_configs[tzpath] = etctz.replace(" ", "_") - except (IOError, UnicodeDecodeError): + except (OSError, UnicodeDecodeError): # File doesn't exist or is a directory, or it's a binary file. continue @@ -86,6 +95,7 @@ def _get_localzone_name(_root="/"): try: with open(tzpath, "rt") as tzfile: data = tzfile.readlines() + log.debug(f"{tzpath} found, contents:\n {data}") for line in data: # Look for the ZONE= setting. @@ -95,13 +105,13 @@ def _get_localzone_name(_root="/"): match = timezone_re.match(line) if match is not None: # Some setting existed - line = line[match.end():] + line = line[match.end() :] etctz = line[: end_re.search(line).start()] # We found a timezone found_configs[tzpath] = etctz.replace(" ", "_") - except (IOError, UnicodeDecodeError): + except (OSError, UnicodeDecodeError): # UnicodeDecode handles when clock is symlink to /etc/localtime continue @@ -109,30 +119,34 @@ def _get_localzone_name(_root="/"): # see manpage of localtime(5) and timedatectl(1) tzpath = os.path.join(_root, "etc/localtime") if os.path.exists(tzpath) and os.path.islink(tzpath): - etctz = realtzpath = os.path.realpath(tzpath) + log.debug(f"{tzpath} found") + etctz = os.path.realpath(tzpath) start = etctz.find("/") + 1 while start != 0: etctz = etctz[start:] try: - pds.timezone(etctz) + zoneinfo.ZoneInfo(etctz) tzinfo = f"{tzpath} is a symlink to" found_configs[tzinfo] = etctz.replace(" ", "_") - except pds.UnknownTimeZoneError: + # Only need first valid relative path in simlink. + break + except zoneinfo.ZoneInfoNotFoundError: pass start = etctz.find("/") + 1 if len(found_configs) > 0: + log.debug(f"{len(found_configs)} found:\n {found_configs}") # We found some explicit config of some sort! if len(found_configs) > 1: # Uh-oh, multiple configs. See if they match: unique_tzs = set() - zoneinfo = os.path.join(_root, "usr", "share", "zoneinfo") - directory_depth = len(zoneinfo.split(os.path.sep)) + zoneinfopath = os.path.join(_root, "usr", "share", "zoneinfo") + directory_depth = len(zoneinfopath.split(os.path.sep)) for tzname in found_configs.values(): # Look them up in /usr/share/zoneinfo, and find what they # really point to: - path = os.path.realpath(os.path.join(zoneinfo, *tzname.split("/"))) + path = os.path.realpath(os.path.join(zoneinfopath, *tzname.split("/"))) real_zone_name = "/".join(path.split(os.path.sep)[directory_depth:]) unique_tzs.add(real_zone_name) @@ -141,7 +155,7 @@ def _get_localzone_name(_root="/"): for key, value in found_configs.items(): message += f"{key}: {value}\n" message += "Fix the configuration, or set the time zone in a TZ environment variable.\n" - raise utils.ZoneInfoNotFoundError(message) + raise zoneinfo.ZoneInfoNotFoundError(message) # We found exactly one config! Use it. return list(found_configs.values())[0] @@ -165,24 +179,25 @@ def _get_localzone(_root="/"): tzname = _get_localzone_name(_root) if tzname is None: # No explicit setting existed. Use localtime + log.debug("No explicit setting existed. Use localtime") for filename in ("etc/localtime", "usr/local/etc/localtime"): tzpath = os.path.join(_root, filename) if not os.path.exists(tzpath): continue with open(tzpath, "rb") as tzfile: - tz = pds.wrap_zone(ZoneInfo.from_file(tzfile, key="local")) + tz = zoneinfo.ZoneInfo.from_file(tzfile, key="local") break else: warnings.warn("Can not find any timezone configuration, defaulting to UTC.") tz = timezone.utc else: - tz = pds.timezone(tzname) + tz = zoneinfo.ZoneInfo(tzname) if _root == "/": # We are using a file in etc to name the timezone. # Verify that the timezone specified there is actually used: - utils.assert_tz_offset(tz) + utils.assert_tz_offset(tz, error=False) return tz diff --git a/lib/tzlocal/utils.py b/lib/tzlocal/utils.py index d1026b32..4ba82d3d 100644 --- a/lib/tzlocal/utils.py +++ b/lib/tzlocal/utils.py @@ -1,9 +1,9 @@ -# -*- coding: utf-8 -*- +import logging import os import time import datetime import calendar -import pytz_deprecation_shim as pds +import warnings try: import zoneinfo # pragma: no cover @@ -12,35 +12,7 @@ except ImportError: from tzlocal import windows_tz - -class ZoneInfoNotFoundError(pds.UnknownTimeZoneError, zoneinfo.ZoneInfoNotFoundError): - """An exception derived from both pytz and zoneinfo - - This exception will be trappable both by pytz expecting clients and - zoneinfo expecting clients. - """ - - -def get_system_offset(): - """Get system's timezone offset using built-in library time. - - For the Timezone constants (altzone, daylight, timezone, and tzname), the - value is determined by the timezone rules in effect at module load time or - the last time tzset() is called and may be incorrect for times in the past. - - To keep compatibility with Windows, we're always importing time module here. - """ - - localtime = calendar.timegm(time.localtime()) - gmtime = calendar.timegm(time.gmtime()) - offset = gmtime - localtime - # We could get the localtime and gmtime on either side of a second switch - # so we check that the difference is less than one minute, because nobody - # has that small DST differences. - if abs(offset - time.altzone) < 60: - return -time.altzone # pragma: no cover - else: - return -time.timezone # pragma: no cover +log = logging.getLogger("tzlocal") def get_tz_offset(tz): @@ -48,19 +20,27 @@ def get_tz_offset(tz): return int(datetime.datetime.now(tz).utcoffset().total_seconds()) -def assert_tz_offset(tz): +def assert_tz_offset(tz, error=True): """Assert that system's timezone offset equals to the timezone offset found. If they don't match, we probably have a misconfiguration, for example, an - incorrect timezone set in /etc/timezone file in systemd distributions.""" + incorrect timezone set in /etc/timezone file in systemd distributions. + + If error is True, this method will raise a ValueError, otherwise it will + emit a warning. + """ + tz_offset = get_tz_offset(tz) - system_offset = get_system_offset() - if tz_offset != system_offset: + system_offset = calendar.timegm(time.localtime()) - calendar.timegm(time.gmtime()) + # No one has timezone offsets less than a minute, so this should be close enough: + if abs(tz_offset - system_offset) > 60: msg = ( "Timezone offset does not match system offset: {} != {}. " "Please, check your config files." ).format(tz_offset, system_offset) - raise ValueError(msg) + if error: + raise ValueError(msg) + warnings.warn(msg) def _tz_name_from_env(tzenv=None): @@ -70,6 +50,8 @@ def _tz_name_from_env(tzenv=None): if not tzenv: return None + log.debug(f"Found a TZ environment: {tzenv}") + if tzenv[0] == ":": tzenv = tzenv[1:] @@ -92,6 +74,9 @@ def _tz_name_from_env(tzenv=None): # Indeed return parts[-1] + log.debug("TZ does not contain a time zone name") + return None + def _tz_from_env(tzenv=None): if tzenv is None: @@ -112,17 +97,16 @@ def _tz_from_env(tzenv=None): # Nope, not a standard timezone name, just take the filename tzname = tzenv.split(os.sep)[-1] with open(tzenv, "rb") as tzfile: - zone = zoneinfo.ZoneInfo.from_file(tzfile, key=tzname) - return pds.wrap_zone(zone) + return zoneinfo.ZoneInfo.from_file(tzfile, key=tzname) # TZ must specify a zoneinfo zone. try: - tz = pds.timezone(tzenv) + tz = zoneinfo.ZoneInfo(tzenv) # That worked, so we return this: return tz - except pds.UnknownTimeZoneError: + except zoneinfo.ZoneInfoNotFoundError: # Nope, it's something like "PST4DST" etc, we can't handle that. - raise ZoneInfoNotFoundError( + raise zoneinfo.ZoneInfoNotFoundError( "tzlocal() does not support non-zoneinfo timezones like %s. \n" - "Please use a timezone in the form of Continent/City" + "Please use a timezone in the form of Continent/City" % tzenv ) from None diff --git a/lib/tzlocal/win32.py b/lib/tzlocal/win32.py index 720ab2b7..9e8dc735 100644 --- a/lib/tzlocal/win32.py +++ b/lib/tzlocal/win32.py @@ -1,17 +1,24 @@ +import logging from datetime import datetime -import pytz_deprecation_shim as pds try: import _winreg as winreg except ImportError: import winreg +try: + import zoneinfo # pragma: no cover +except ImportError: + from backports import zoneinfo # pragma: no cover + from tzlocal.windows_tz import win_tz from tzlocal import utils _cache_tz = None _cache_tz_name = None +log = logging.getLogger("tzlocal") + def valuestodict(key): """Convert a registry key's values to a dictionary.""" @@ -48,6 +55,7 @@ def _get_localzone_name(): if tzenv: return tzenv + log.debug("Looking up time zone info from registry") handle = winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE) TZLOCALKEYNAME = r"SYSTEM\CurrentControlSet\Control\TimeZoneInformation" @@ -74,13 +82,13 @@ def _get_localzone_name(): # Return what we have. if timezone is None: - raise utils.ZoneInfoNotFoundError(tzkeyname) + raise zoneinfo.ZoneInfoNotFoundError(tzkeyname) if keyvalues.get("DynamicDaylightTimeDisabled", 0) == 1: # DST is disabled, so don't return the timezone name, # instead return Etc/GMT+offset - tz = pds.timezone(timezone) + tz = zoneinfo.ZoneInfo(timezone) has_dst, std_offset, dst_offset = _get_dst_info(tz) if not has_dst: # The DST is turned off in the windows configuration, @@ -88,13 +96,15 @@ def _get_localzone_name(): return timezone if std_offset is None: - raise utils.ZoneInfoNotFoundError( - f"{tzkeyname} claims to not have a non-DST time!?") + raise zoneinfo.ZoneInfoNotFoundError( + f"{tzkeyname} claims to not have a non-DST time!?" + ) if std_offset % 3600: # I can't convert this to an hourly offset - raise utils.ZoneInfoNotFoundError( - f"tzlocal can't support disabling DST in the {timezone} zone.") + raise zoneinfo.ZoneInfoNotFoundError( + f"tzlocal can't support disabling DST in the {timezone} zone." + ) # This has whole hours as offset, return it as Etc/GMT return f"Etc/GMT{-std_offset//3600:+.0f}" @@ -116,13 +126,13 @@ def get_localzone(): global _cache_tz if _cache_tz is None: - _cache_tz = pds.timezone(get_localzone_name()) + _cache_tz = zoneinfo.ZoneInfo(get_localzone_name()) if not utils._tz_name_from_env(): # If the timezone does NOT come from a TZ environment variable, # verify that it's correct. If it's from the environment, # we accept it, this is so you can run tests with different timezones. - utils.assert_tz_offset(_cache_tz) + utils.assert_tz_offset(_cache_tz, error=False) return _cache_tz @@ -132,6 +142,6 @@ def reload_localzone(): global _cache_tz global _cache_tz_name _cache_tz_name = _get_localzone_name() - _cache_tz = pds.timezone(_cache_tz_name) - utils.assert_tz_offset(_cache_tz) + _cache_tz = zoneinfo.ZoneInfo(_cache_tz_name) + utils.assert_tz_offset(_cache_tz, error=False) return _cache_tz diff --git a/lib/tzlocal/windows_tz.py b/lib/tzlocal/windows_tz.py index 0d285037..ed49c4ac 100644 --- a/lib/tzlocal/windows_tz.py +++ b/lib/tzlocal/windows_tz.py @@ -1,699 +1,718 @@ # This file is autogenerated by the update_windows_mapping.py script # Do not edit. -win_tz = {'AUS Central Standard Time': 'Australia/Darwin', - 'AUS Eastern Standard Time': 'Australia/Sydney', - 'Afghanistan Standard Time': 'Asia/Kabul', - 'Alaskan Standard Time': 'America/Anchorage', - 'Aleutian Standard Time': 'America/Adak', - 'Altai Standard Time': 'Asia/Barnaul', - 'Arab Standard Time': 'Asia/Riyadh', - 'Arabian Standard Time': 'Asia/Dubai', - 'Arabic Standard Time': 'Asia/Baghdad', - 'Argentina Standard Time': 'America/Buenos_Aires', - 'Astrakhan Standard Time': 'Europe/Astrakhan', - 'Atlantic Standard Time': 'America/Halifax', - 'Aus Central W. Standard Time': 'Australia/Eucla', - 'Azerbaijan Standard Time': 'Asia/Baku', - 'Azores Standard Time': 'Atlantic/Azores', - 'Bahia Standard Time': 'America/Bahia', - 'Bangladesh Standard Time': 'Asia/Dhaka', - 'Belarus Standard Time': 'Europe/Minsk', - 'Bougainville Standard Time': 'Pacific/Bougainville', - 'Canada Central Standard Time': 'America/Regina', - 'Cape Verde Standard Time': 'Atlantic/Cape_Verde', - 'Caucasus Standard Time': 'Asia/Yerevan', - 'Cen. Australia Standard Time': 'Australia/Adelaide', - 'Central America Standard Time': 'America/Guatemala', - 'Central Asia Standard Time': 'Asia/Almaty', - 'Central Brazilian Standard Time': 'America/Cuiaba', - 'Central Europe Standard Time': 'Europe/Budapest', - 'Central European Standard Time': 'Europe/Warsaw', - 'Central Pacific Standard Time': 'Pacific/Guadalcanal', - 'Central Standard Time': 'America/Chicago', - 'Central Standard Time (Mexico)': 'America/Mexico_City', - 'Chatham Islands Standard Time': 'Pacific/Chatham', - 'China Standard Time': 'Asia/Shanghai', - 'Cuba Standard Time': 'America/Havana', - 'Dateline Standard Time': 'Etc/GMT+12', - 'E. Africa Standard Time': 'Africa/Nairobi', - 'E. Australia Standard Time': 'Australia/Brisbane', - 'E. Europe Standard Time': 'Europe/Chisinau', - 'E. South America Standard Time': 'America/Sao_Paulo', - 'Easter Island Standard Time': 'Pacific/Easter', - 'Eastern Standard Time': 'America/New_York', - 'Eastern Standard Time (Mexico)': 'America/Cancun', - 'Egypt Standard Time': 'Africa/Cairo', - 'Ekaterinburg Standard Time': 'Asia/Yekaterinburg', - 'FLE Standard Time': 'Europe/Kiev', - 'Fiji Standard Time': 'Pacific/Fiji', - 'GMT Standard Time': 'Europe/London', - 'GTB Standard Time': 'Europe/Bucharest', - 'Georgian Standard Time': 'Asia/Tbilisi', - 'Greenland Standard Time': 'America/Godthab', - 'Greenwich Standard Time': 'Atlantic/Reykjavik', - 'Haiti Standard Time': 'America/Port-au-Prince', - 'Hawaiian Standard Time': 'Pacific/Honolulu', - 'India Standard Time': 'Asia/Calcutta', - 'Iran Standard Time': 'Asia/Tehran', - 'Israel Standard Time': 'Asia/Jerusalem', - 'Jordan Standard Time': 'Asia/Amman', - 'Kaliningrad Standard Time': 'Europe/Kaliningrad', - 'Korea Standard Time': 'Asia/Seoul', - 'Libya Standard Time': 'Africa/Tripoli', - 'Line Islands Standard Time': 'Pacific/Kiritimati', - 'Lord Howe Standard Time': 'Australia/Lord_Howe', - 'Magadan Standard Time': 'Asia/Magadan', - 'Magallanes Standard Time': 'America/Punta_Arenas', - 'Marquesas Standard Time': 'Pacific/Marquesas', - 'Mauritius Standard Time': 'Indian/Mauritius', - 'Middle East Standard Time': 'Asia/Beirut', - 'Montevideo Standard Time': 'America/Montevideo', - 'Morocco Standard Time': 'Africa/Casablanca', - 'Mountain Standard Time': 'America/Denver', - 'Mountain Standard Time (Mexico)': 'America/Chihuahua', - 'Myanmar Standard Time': 'Asia/Rangoon', - 'N. Central Asia Standard Time': 'Asia/Novosibirsk', - 'Namibia Standard Time': 'Africa/Windhoek', - 'Nepal Standard Time': 'Asia/Katmandu', - 'New Zealand Standard Time': 'Pacific/Auckland', - 'Newfoundland Standard Time': 'America/St_Johns', - 'Norfolk Standard Time': 'Pacific/Norfolk', - 'North Asia East Standard Time': 'Asia/Irkutsk', - 'North Asia Standard Time': 'Asia/Krasnoyarsk', - 'North Korea Standard Time': 'Asia/Pyongyang', - 'Omsk Standard Time': 'Asia/Omsk', - 'Pacific SA Standard Time': 'America/Santiago', - 'Pacific Standard Time': 'America/Los_Angeles', - 'Pacific Standard Time (Mexico)': 'America/Tijuana', - 'Pakistan Standard Time': 'Asia/Karachi', - 'Paraguay Standard Time': 'America/Asuncion', - 'Qyzylorda Standard Time': 'Asia/Qyzylorda', - 'Romance Standard Time': 'Europe/Paris', - 'Russia Time Zone 10': 'Asia/Srednekolymsk', - 'Russia Time Zone 11': 'Asia/Kamchatka', - 'Russia Time Zone 3': 'Europe/Samara', - 'Russian Standard Time': 'Europe/Moscow', - 'SA Eastern Standard Time': 'America/Cayenne', - 'SA Pacific Standard Time': 'America/Bogota', - 'SA Western Standard Time': 'America/La_Paz', - 'SE Asia Standard Time': 'Asia/Bangkok', - 'Saint Pierre Standard Time': 'America/Miquelon', - 'Sakhalin Standard Time': 'Asia/Sakhalin', - 'Samoa Standard Time': 'Pacific/Apia', - 'Sao Tome Standard Time': 'Africa/Sao_Tome', - 'Saratov Standard Time': 'Europe/Saratov', - 'Singapore Standard Time': 'Asia/Singapore', - 'South Africa Standard Time': 'Africa/Johannesburg', - 'South Sudan Standard Time': 'Africa/Juba', - 'Sri Lanka Standard Time': 'Asia/Colombo', - 'Sudan Standard Time': 'Africa/Khartoum', - 'Syria Standard Time': 'Asia/Damascus', - 'Taipei Standard Time': 'Asia/Taipei', - 'Tasmania Standard Time': 'Australia/Hobart', - 'Tocantins Standard Time': 'America/Araguaina', - 'Tokyo Standard Time': 'Asia/Tokyo', - 'Tomsk Standard Time': 'Asia/Tomsk', - 'Tonga Standard Time': 'Pacific/Tongatapu', - 'Transbaikal Standard Time': 'Asia/Chita', - 'Turkey Standard Time': 'Europe/Istanbul', - 'Turks And Caicos Standard Time': 'America/Grand_Turk', - 'US Eastern Standard Time': 'America/Indianapolis', - 'US Mountain Standard Time': 'America/Phoenix', - 'UTC': 'Etc/UTC', - 'UTC+12': 'Etc/GMT-12', - 'UTC+13': 'Etc/GMT-13', - 'UTC-02': 'Etc/GMT+2', - 'UTC-08': 'Etc/GMT+8', - 'UTC-09': 'Etc/GMT+9', - 'UTC-11': 'Etc/GMT+11', - 'Ulaanbaatar Standard Time': 'Asia/Ulaanbaatar', - 'Venezuela Standard Time': 'America/Caracas', - 'Vladivostok Standard Time': 'Asia/Vladivostok', - 'Volgograd Standard Time': 'Europe/Volgograd', - 'W. Australia Standard Time': 'Australia/Perth', - 'W. Central Africa Standard Time': 'Africa/Lagos', - 'W. Europe Standard Time': 'Europe/Berlin', - 'W. Mongolia Standard Time': 'Asia/Hovd', - 'West Asia Standard Time': 'Asia/Tashkent', - 'West Bank Standard Time': 'Asia/Hebron', - 'West Pacific Standard Time': 'Pacific/Port_Moresby', - 'Yakutsk Standard Time': 'Asia/Yakutsk', - 'Yukon Standard Time': 'America/Whitehorse'} +win_tz = { + "AUS Central Standard Time": "Australia/Darwin", + "AUS Eastern Standard Time": "Australia/Sydney", + "Afghanistan Standard Time": "Asia/Kabul", + "Alaskan Standard Time": "America/Anchorage", + "Aleutian Standard Time": "America/Adak", + "Altai Standard Time": "Asia/Barnaul", + "Arab Standard Time": "Asia/Riyadh", + "Arabian Standard Time": "Asia/Dubai", + "Arabic Standard Time": "Asia/Baghdad", + "Argentina Standard Time": "America/Buenos_Aires", + "Astrakhan Standard Time": "Europe/Astrakhan", + "Atlantic Standard Time": "America/Halifax", + "Aus Central W. Standard Time": "Australia/Eucla", + "Azerbaijan Standard Time": "Asia/Baku", + "Azores Standard Time": "Atlantic/Azores", + "Bahia Standard Time": "America/Bahia", + "Bangladesh Standard Time": "Asia/Dhaka", + "Belarus Standard Time": "Europe/Minsk", + "Bougainville Standard Time": "Pacific/Bougainville", + "Canada Central Standard Time": "America/Regina", + "Cape Verde Standard Time": "Atlantic/Cape_Verde", + "Caucasus Standard Time": "Asia/Yerevan", + "Cen. Australia Standard Time": "Australia/Adelaide", + "Central America Standard Time": "America/Guatemala", + "Central Asia Standard Time": "Asia/Almaty", + "Central Brazilian Standard Time": "America/Cuiaba", + "Central Europe Standard Time": "Europe/Budapest", + "Central European Standard Time": "Europe/Warsaw", + "Central Pacific Standard Time": "Pacific/Guadalcanal", + "Central Standard Time": "America/Chicago", + "Central Standard Time (Mexico)": "America/Mexico_City", + "Chatham Islands Standard Time": "Pacific/Chatham", + "China Standard Time": "Asia/Shanghai", + "Cuba Standard Time": "America/Havana", + "Dateline Standard Time": "Etc/GMT+12", + "E. Africa Standard Time": "Africa/Nairobi", + "E. Australia Standard Time": "Australia/Brisbane", + "E. Europe Standard Time": "Europe/Chisinau", + "E. South America Standard Time": "America/Sao_Paulo", + "Easter Island Standard Time": "Pacific/Easter", + "Eastern Standard Time": "America/New_York", + "Eastern Standard Time (Mexico)": "America/Cancun", + "Egypt Standard Time": "Africa/Cairo", + "Ekaterinburg Standard Time": "Asia/Yekaterinburg", + "FLE Standard Time": "Europe/Kiev", + "Fiji Standard Time": "Pacific/Fiji", + "GMT Standard Time": "Europe/London", + "GTB Standard Time": "Europe/Bucharest", + "Georgian Standard Time": "Asia/Tbilisi", + "Greenland Standard Time": "America/Godthab", + "Greenwich Standard Time": "Atlantic/Reykjavik", + "Haiti Standard Time": "America/Port-au-Prince", + "Hawaiian Standard Time": "Pacific/Honolulu", + "India Standard Time": "Asia/Calcutta", + "Iran Standard Time": "Asia/Tehran", + "Israel Standard Time": "Asia/Jerusalem", + "Jordan Standard Time": "Asia/Amman", + "Kaliningrad Standard Time": "Europe/Kaliningrad", + "Korea Standard Time": "Asia/Seoul", + "Libya Standard Time": "Africa/Tripoli", + "Line Islands Standard Time": "Pacific/Kiritimati", + "Lord Howe Standard Time": "Australia/Lord_Howe", + "Magadan Standard Time": "Asia/Magadan", + "Magallanes Standard Time": "America/Punta_Arenas", + "Marquesas Standard Time": "Pacific/Marquesas", + "Mauritius Standard Time": "Indian/Mauritius", + "Middle East Standard Time": "Asia/Beirut", + "Montevideo Standard Time": "America/Montevideo", + "Morocco Standard Time": "Africa/Casablanca", + "Mountain Standard Time": "America/Denver", + "Mountain Standard Time (Mexico)": "America/Mazatlan", + "Myanmar Standard Time": "Asia/Rangoon", + "N. Central Asia Standard Time": "Asia/Novosibirsk", + "Namibia Standard Time": "Africa/Windhoek", + "Nepal Standard Time": "Asia/Katmandu", + "New Zealand Standard Time": "Pacific/Auckland", + "Newfoundland Standard Time": "America/St_Johns", + "Norfolk Standard Time": "Pacific/Norfolk", + "North Asia East Standard Time": "Asia/Irkutsk", + "North Asia Standard Time": "Asia/Krasnoyarsk", + "North Korea Standard Time": "Asia/Pyongyang", + "Omsk Standard Time": "Asia/Omsk", + "Pacific SA Standard Time": "America/Santiago", + "Pacific Standard Time": "America/Los_Angeles", + "Pacific Standard Time (Mexico)": "America/Tijuana", + "Pakistan Standard Time": "Asia/Karachi", + "Paraguay Standard Time": "America/Asuncion", + "Qyzylorda Standard Time": "Asia/Qyzylorda", + "Romance Standard Time": "Europe/Paris", + "Russia Time Zone 10": "Asia/Srednekolymsk", + "Russia Time Zone 11": "Asia/Kamchatka", + "Russia Time Zone 3": "Europe/Samara", + "Russian Standard Time": "Europe/Moscow", + "SA Eastern Standard Time": "America/Cayenne", + "SA Pacific Standard Time": "America/Bogota", + "SA Western Standard Time": "America/La_Paz", + "SE Asia Standard Time": "Asia/Bangkok", + "Saint Pierre Standard Time": "America/Miquelon", + "Sakhalin Standard Time": "Asia/Sakhalin", + "Samoa Standard Time": "Pacific/Apia", + "Sao Tome Standard Time": "Africa/Sao_Tome", + "Saratov Standard Time": "Europe/Saratov", + "Singapore Standard Time": "Asia/Singapore", + "South Africa Standard Time": "Africa/Johannesburg", + "South Sudan Standard Time": "Africa/Juba", + "Sri Lanka Standard Time": "Asia/Colombo", + "Sudan Standard Time": "Africa/Khartoum", + "Syria Standard Time": "Asia/Damascus", + "Taipei Standard Time": "Asia/Taipei", + "Tasmania Standard Time": "Australia/Hobart", + "Tocantins Standard Time": "America/Araguaina", + "Tokyo Standard Time": "Asia/Tokyo", + "Tomsk Standard Time": "Asia/Tomsk", + "Tonga Standard Time": "Pacific/Tongatapu", + "Transbaikal Standard Time": "Asia/Chita", + "Turkey Standard Time": "Europe/Istanbul", + "Turks And Caicos Standard Time": "America/Grand_Turk", + "US Eastern Standard Time": "America/Indianapolis", + "US Mountain Standard Time": "America/Phoenix", + "UTC": "Etc/UTC", + "UTC+12": "Etc/GMT-12", + "UTC+13": "Etc/GMT-13", + "UTC-02": "Etc/GMT+2", + "UTC-08": "Etc/GMT+8", + "UTC-09": "Etc/GMT+9", + "UTC-11": "Etc/GMT+11", + "Ulaanbaatar Standard Time": "Asia/Ulaanbaatar", + "Venezuela Standard Time": "America/Caracas", + "Vladivostok Standard Time": "Asia/Vladivostok", + "Volgograd Standard Time": "Europe/Volgograd", + "W. Australia Standard Time": "Australia/Perth", + "W. Central Africa Standard Time": "Africa/Lagos", + "W. Europe Standard Time": "Europe/Berlin", + "W. Mongolia Standard Time": "Asia/Hovd", + "West Asia Standard Time": "Asia/Tashkent", + "West Bank Standard Time": "Asia/Hebron", + "West Pacific Standard Time": "Pacific/Port_Moresby", + "Yakutsk Standard Time": "Asia/Yakutsk", + "Yukon Standard Time": "America/Whitehorse", +} # Old name for the win_tz variable: tz_names = win_tz -tz_win = {'Africa/Abidjan': 'Greenwich Standard Time', - 'Africa/Accra': 'Greenwich Standard Time', - 'Africa/Addis_Ababa': 'E. Africa Standard Time', - 'Africa/Algiers': 'W. Central Africa Standard Time', - 'Africa/Asmera': 'E. Africa Standard Time', - 'Africa/Bamako': 'Greenwich Standard Time', - 'Africa/Bangui': 'W. Central Africa Standard Time', - 'Africa/Banjul': 'Greenwich Standard Time', - 'Africa/Bissau': 'Greenwich Standard Time', - 'Africa/Blantyre': 'South Africa Standard Time', - 'Africa/Brazzaville': 'W. Central Africa Standard Time', - 'Africa/Bujumbura': 'South Africa Standard Time', - 'Africa/Cairo': 'Egypt Standard Time', - 'Africa/Casablanca': 'Morocco Standard Time', - 'Africa/Ceuta': 'Romance Standard Time', - 'Africa/Conakry': 'Greenwich Standard Time', - 'Africa/Dakar': 'Greenwich Standard Time', - 'Africa/Dar_es_Salaam': 'E. Africa Standard Time', - 'Africa/Djibouti': 'E. Africa Standard Time', - 'Africa/Douala': 'W. Central Africa Standard Time', - 'Africa/El_Aaiun': 'Morocco Standard Time', - 'Africa/Freetown': 'Greenwich Standard Time', - 'Africa/Gaborone': 'South Africa Standard Time', - 'Africa/Harare': 'South Africa Standard Time', - 'Africa/Johannesburg': 'South Africa Standard Time', - 'Africa/Juba': 'South Sudan Standard Time', - 'Africa/Kampala': 'E. Africa Standard Time', - 'Africa/Khartoum': 'Sudan Standard Time', - 'Africa/Kigali': 'South Africa Standard Time', - 'Africa/Kinshasa': 'W. Central Africa Standard Time', - 'Africa/Lagos': 'W. Central Africa Standard Time', - 'Africa/Libreville': 'W. Central Africa Standard Time', - 'Africa/Lome': 'Greenwich Standard Time', - 'Africa/Luanda': 'W. Central Africa Standard Time', - 'Africa/Lubumbashi': 'South Africa Standard Time', - 'Africa/Lusaka': 'South Africa Standard Time', - 'Africa/Malabo': 'W. Central Africa Standard Time', - 'Africa/Maputo': 'South Africa Standard Time', - 'Africa/Maseru': 'South Africa Standard Time', - 'Africa/Mbabane': 'South Africa Standard Time', - 'Africa/Mogadishu': 'E. Africa Standard Time', - 'Africa/Monrovia': 'Greenwich Standard Time', - 'Africa/Nairobi': 'E. Africa Standard Time', - 'Africa/Ndjamena': 'W. Central Africa Standard Time', - 'Africa/Niamey': 'W. Central Africa Standard Time', - 'Africa/Nouakchott': 'Greenwich Standard Time', - 'Africa/Ouagadougou': 'Greenwich Standard Time', - 'Africa/Porto-Novo': 'W. Central Africa Standard Time', - 'Africa/Sao_Tome': 'Sao Tome Standard Time', - 'Africa/Timbuktu': 'Greenwich Standard Time', - 'Africa/Tripoli': 'Libya Standard Time', - 'Africa/Tunis': 'W. Central Africa Standard Time', - 'Africa/Windhoek': 'Namibia Standard Time', - 'America/Adak': 'Aleutian Standard Time', - 'America/Anchorage': 'Alaskan Standard Time', - 'America/Anguilla': 'SA Western Standard Time', - 'America/Antigua': 'SA Western Standard Time', - 'America/Araguaina': 'Tocantins Standard Time', - 'America/Argentina/La_Rioja': 'Argentina Standard Time', - 'America/Argentina/Rio_Gallegos': 'Argentina Standard Time', - 'America/Argentina/Salta': 'Argentina Standard Time', - 'America/Argentina/San_Juan': 'Argentina Standard Time', - 'America/Argentina/San_Luis': 'Argentina Standard Time', - 'America/Argentina/Tucuman': 'Argentina Standard Time', - 'America/Argentina/Ushuaia': 'Argentina Standard Time', - 'America/Aruba': 'SA Western Standard Time', - 'America/Asuncion': 'Paraguay Standard Time', - 'America/Atka': 'Aleutian Standard Time', - 'America/Bahia': 'Bahia Standard Time', - 'America/Bahia_Banderas': 'Central Standard Time (Mexico)', - 'America/Barbados': 'SA Western Standard Time', - 'America/Belem': 'SA Eastern Standard Time', - 'America/Belize': 'Central America Standard Time', - 'America/Blanc-Sablon': 'SA Western Standard Time', - 'America/Boa_Vista': 'SA Western Standard Time', - 'America/Bogota': 'SA Pacific Standard Time', - 'America/Boise': 'Mountain Standard Time', - 'America/Buenos_Aires': 'Argentina Standard Time', - 'America/Cambridge_Bay': 'Mountain Standard Time', - 'America/Campo_Grande': 'Central Brazilian Standard Time', - 'America/Cancun': 'Eastern Standard Time (Mexico)', - 'America/Caracas': 'Venezuela Standard Time', - 'America/Catamarca': 'Argentina Standard Time', - 'America/Cayenne': 'SA Eastern Standard Time', - 'America/Cayman': 'SA Pacific Standard Time', - 'America/Chicago': 'Central Standard Time', - 'America/Chihuahua': 'Mountain Standard Time (Mexico)', - 'America/Coral_Harbour': 'SA Pacific Standard Time', - 'America/Cordoba': 'Argentina Standard Time', - 'America/Costa_Rica': 'Central America Standard Time', - 'America/Creston': 'US Mountain Standard Time', - 'America/Cuiaba': 'Central Brazilian Standard Time', - 'America/Curacao': 'SA Western Standard Time', - 'America/Danmarkshavn': 'Greenwich Standard Time', - 'America/Dawson': 'Yukon Standard Time', - 'America/Dawson_Creek': 'US Mountain Standard Time', - 'America/Denver': 'Mountain Standard Time', - 'America/Detroit': 'Eastern Standard Time', - 'America/Dominica': 'SA Western Standard Time', - 'America/Edmonton': 'Mountain Standard Time', - 'America/Eirunepe': 'SA Pacific Standard Time', - 'America/El_Salvador': 'Central America Standard Time', - 'America/Ensenada': 'Pacific Standard Time (Mexico)', - 'America/Fort_Nelson': 'US Mountain Standard Time', - 'America/Fortaleza': 'SA Eastern Standard Time', - 'America/Glace_Bay': 'Atlantic Standard Time', - 'America/Godthab': 'Greenland Standard Time', - 'America/Goose_Bay': 'Atlantic Standard Time', - 'America/Grand_Turk': 'Turks And Caicos Standard Time', - 'America/Grenada': 'SA Western Standard Time', - 'America/Guadeloupe': 'SA Western Standard Time', - 'America/Guatemala': 'Central America Standard Time', - 'America/Guayaquil': 'SA Pacific Standard Time', - 'America/Guyana': 'SA Western Standard Time', - 'America/Halifax': 'Atlantic Standard Time', - 'America/Havana': 'Cuba Standard Time', - 'America/Hermosillo': 'US Mountain Standard Time', - 'America/Indiana/Knox': 'Central Standard Time', - 'America/Indiana/Marengo': 'US Eastern Standard Time', - 'America/Indiana/Petersburg': 'Eastern Standard Time', - 'America/Indiana/Tell_City': 'Central Standard Time', - 'America/Indiana/Vevay': 'US Eastern Standard Time', - 'America/Indiana/Vincennes': 'Eastern Standard Time', - 'America/Indiana/Winamac': 'Eastern Standard Time', - 'America/Indianapolis': 'US Eastern Standard Time', - 'America/Inuvik': 'Mountain Standard Time', - 'America/Iqaluit': 'Eastern Standard Time', - 'America/Jamaica': 'SA Pacific Standard Time', - 'America/Jujuy': 'Argentina Standard Time', - 'America/Juneau': 'Alaskan Standard Time', - 'America/Kentucky/Monticello': 'Eastern Standard Time', - 'America/Knox_IN': 'Central Standard Time', - 'America/Kralendijk': 'SA Western Standard Time', - 'America/La_Paz': 'SA Western Standard Time', - 'America/Lima': 'SA Pacific Standard Time', - 'America/Los_Angeles': 'Pacific Standard Time', - 'America/Louisville': 'Eastern Standard Time', - 'America/Lower_Princes': 'SA Western Standard Time', - 'America/Maceio': 'SA Eastern Standard Time', - 'America/Managua': 'Central America Standard Time', - 'America/Manaus': 'SA Western Standard Time', - 'America/Marigot': 'SA Western Standard Time', - 'America/Martinique': 'SA Western Standard Time', - 'America/Matamoros': 'Central Standard Time', - 'America/Mazatlan': 'Mountain Standard Time (Mexico)', - 'America/Mendoza': 'Argentina Standard Time', - 'America/Menominee': 'Central Standard Time', - 'America/Merida': 'Central Standard Time (Mexico)', - 'America/Metlakatla': 'Alaskan Standard Time', - 'America/Mexico_City': 'Central Standard Time (Mexico)', - 'America/Miquelon': 'Saint Pierre Standard Time', - 'America/Moncton': 'Atlantic Standard Time', - 'America/Monterrey': 'Central Standard Time (Mexico)', - 'America/Montevideo': 'Montevideo Standard Time', - 'America/Montreal': 'Eastern Standard Time', - 'America/Montserrat': 'SA Western Standard Time', - 'America/Nassau': 'Eastern Standard Time', - 'America/New_York': 'Eastern Standard Time', - 'America/Nipigon': 'Eastern Standard Time', - 'America/Nome': 'Alaskan Standard Time', - 'America/Noronha': 'UTC-02', - 'America/North_Dakota/Beulah': 'Central Standard Time', - 'America/North_Dakota/Center': 'Central Standard Time', - 'America/North_Dakota/New_Salem': 'Central Standard Time', - 'America/Ojinaga': 'Mountain Standard Time', - 'America/Panama': 'SA Pacific Standard Time', - 'America/Pangnirtung': 'Eastern Standard Time', - 'America/Paramaribo': 'SA Eastern Standard Time', - 'America/Phoenix': 'US Mountain Standard Time', - 'America/Port-au-Prince': 'Haiti Standard Time', - 'America/Port_of_Spain': 'SA Western Standard Time', - 'America/Porto_Acre': 'SA Pacific Standard Time', - 'America/Porto_Velho': 'SA Western Standard Time', - 'America/Puerto_Rico': 'SA Western Standard Time', - 'America/Punta_Arenas': 'Magallanes Standard Time', - 'America/Rainy_River': 'Central Standard Time', - 'America/Rankin_Inlet': 'Central Standard Time', - 'America/Recife': 'SA Eastern Standard Time', - 'America/Regina': 'Canada Central Standard Time', - 'America/Resolute': 'Central Standard Time', - 'America/Rio_Branco': 'SA Pacific Standard Time', - 'America/Santa_Isabel': 'Pacific Standard Time (Mexico)', - 'America/Santarem': 'SA Eastern Standard Time', - 'America/Santiago': 'Pacific SA Standard Time', - 'America/Santo_Domingo': 'SA Western Standard Time', - 'America/Sao_Paulo': 'E. South America Standard Time', - 'America/Scoresbysund': 'Azores Standard Time', - 'America/Shiprock': 'Mountain Standard Time', - 'America/Sitka': 'Alaskan Standard Time', - 'America/St_Barthelemy': 'SA Western Standard Time', - 'America/St_Johns': 'Newfoundland Standard Time', - 'America/St_Kitts': 'SA Western Standard Time', - 'America/St_Lucia': 'SA Western Standard Time', - 'America/St_Thomas': 'SA Western Standard Time', - 'America/St_Vincent': 'SA Western Standard Time', - 'America/Swift_Current': 'Canada Central Standard Time', - 'America/Tegucigalpa': 'Central America Standard Time', - 'America/Thule': 'Atlantic Standard Time', - 'America/Thunder_Bay': 'Eastern Standard Time', - 'America/Tijuana': 'Pacific Standard Time (Mexico)', - 'America/Toronto': 'Eastern Standard Time', - 'America/Tortola': 'SA Western Standard Time', - 'America/Vancouver': 'Pacific Standard Time', - 'America/Virgin': 'SA Western Standard Time', - 'America/Whitehorse': 'Yukon Standard Time', - 'America/Winnipeg': 'Central Standard Time', - 'America/Yakutat': 'Alaskan Standard Time', - 'America/Yellowknife': 'Mountain Standard Time', - 'Antarctica/Casey': 'Central Pacific Standard Time', - 'Antarctica/Davis': 'SE Asia Standard Time', - 'Antarctica/DumontDUrville': 'West Pacific Standard Time', - 'Antarctica/Macquarie': 'Tasmania Standard Time', - 'Antarctica/Mawson': 'West Asia Standard Time', - 'Antarctica/McMurdo': 'New Zealand Standard Time', - 'Antarctica/Palmer': 'SA Eastern Standard Time', - 'Antarctica/Rothera': 'SA Eastern Standard Time', - 'Antarctica/South_Pole': 'New Zealand Standard Time', - 'Antarctica/Syowa': 'E. Africa Standard Time', - 'Antarctica/Vostok': 'Central Asia Standard Time', - 'Arctic/Longyearbyen': 'W. Europe Standard Time', - 'Asia/Aden': 'Arab Standard Time', - 'Asia/Almaty': 'Central Asia Standard Time', - 'Asia/Amman': 'Jordan Standard Time', - 'Asia/Anadyr': 'Russia Time Zone 11', - 'Asia/Aqtau': 'West Asia Standard Time', - 'Asia/Aqtobe': 'West Asia Standard Time', - 'Asia/Ashgabat': 'West Asia Standard Time', - 'Asia/Ashkhabad': 'West Asia Standard Time', - 'Asia/Atyrau': 'West Asia Standard Time', - 'Asia/Baghdad': 'Arabic Standard Time', - 'Asia/Bahrain': 'Arab Standard Time', - 'Asia/Baku': 'Azerbaijan Standard Time', - 'Asia/Bangkok': 'SE Asia Standard Time', - 'Asia/Barnaul': 'Altai Standard Time', - 'Asia/Beirut': 'Middle East Standard Time', - 'Asia/Bishkek': 'Central Asia Standard Time', - 'Asia/Brunei': 'Singapore Standard Time', - 'Asia/Calcutta': 'India Standard Time', - 'Asia/Chita': 'Transbaikal Standard Time', - 'Asia/Choibalsan': 'Ulaanbaatar Standard Time', - 'Asia/Chongqing': 'China Standard Time', - 'Asia/Chungking': 'China Standard Time', - 'Asia/Colombo': 'Sri Lanka Standard Time', - 'Asia/Dacca': 'Bangladesh Standard Time', - 'Asia/Damascus': 'Syria Standard Time', - 'Asia/Dhaka': 'Bangladesh Standard Time', - 'Asia/Dili': 'Tokyo Standard Time', - 'Asia/Dubai': 'Arabian Standard Time', - 'Asia/Dushanbe': 'West Asia Standard Time', - 'Asia/Famagusta': 'GTB Standard Time', - 'Asia/Gaza': 'West Bank Standard Time', - 'Asia/Harbin': 'China Standard Time', - 'Asia/Hebron': 'West Bank Standard Time', - 'Asia/Hong_Kong': 'China Standard Time', - 'Asia/Hovd': 'W. Mongolia Standard Time', - 'Asia/Irkutsk': 'North Asia East Standard Time', - 'Asia/Jakarta': 'SE Asia Standard Time', - 'Asia/Jayapura': 'Tokyo Standard Time', - 'Asia/Jerusalem': 'Israel Standard Time', - 'Asia/Kabul': 'Afghanistan Standard Time', - 'Asia/Kamchatka': 'Russia Time Zone 11', - 'Asia/Karachi': 'Pakistan Standard Time', - 'Asia/Kashgar': 'Central Asia Standard Time', - 'Asia/Katmandu': 'Nepal Standard Time', - 'Asia/Khandyga': 'Yakutsk Standard Time', - 'Asia/Krasnoyarsk': 'North Asia Standard Time', - 'Asia/Kuala_Lumpur': 'Singapore Standard Time', - 'Asia/Kuching': 'Singapore Standard Time', - 'Asia/Kuwait': 'Arab Standard Time', - 'Asia/Macao': 'China Standard Time', - 'Asia/Macau': 'China Standard Time', - 'Asia/Magadan': 'Magadan Standard Time', - 'Asia/Makassar': 'Singapore Standard Time', - 'Asia/Manila': 'Singapore Standard Time', - 'Asia/Muscat': 'Arabian Standard Time', - 'Asia/Nicosia': 'GTB Standard Time', - 'Asia/Novokuznetsk': 'North Asia Standard Time', - 'Asia/Novosibirsk': 'N. Central Asia Standard Time', - 'Asia/Omsk': 'Omsk Standard Time', - 'Asia/Oral': 'West Asia Standard Time', - 'Asia/Phnom_Penh': 'SE Asia Standard Time', - 'Asia/Pontianak': 'SE Asia Standard Time', - 'Asia/Pyongyang': 'North Korea Standard Time', - 'Asia/Qatar': 'Arab Standard Time', - 'Asia/Qostanay': 'Central Asia Standard Time', - 'Asia/Qyzylorda': 'Qyzylorda Standard Time', - 'Asia/Rangoon': 'Myanmar Standard Time', - 'Asia/Riyadh': 'Arab Standard Time', - 'Asia/Saigon': 'SE Asia Standard Time', - 'Asia/Sakhalin': 'Sakhalin Standard Time', - 'Asia/Samarkand': 'West Asia Standard Time', - 'Asia/Seoul': 'Korea Standard Time', - 'Asia/Shanghai': 'China Standard Time', - 'Asia/Singapore': 'Singapore Standard Time', - 'Asia/Srednekolymsk': 'Russia Time Zone 10', - 'Asia/Taipei': 'Taipei Standard Time', - 'Asia/Tashkent': 'West Asia Standard Time', - 'Asia/Tbilisi': 'Georgian Standard Time', - 'Asia/Tehran': 'Iran Standard Time', - 'Asia/Tel_Aviv': 'Israel Standard Time', - 'Asia/Thimbu': 'Bangladesh Standard Time', - 'Asia/Thimphu': 'Bangladesh Standard Time', - 'Asia/Tokyo': 'Tokyo Standard Time', - 'Asia/Tomsk': 'Tomsk Standard Time', - 'Asia/Ujung_Pandang': 'Singapore Standard Time', - 'Asia/Ulaanbaatar': 'Ulaanbaatar Standard Time', - 'Asia/Ulan_Bator': 'Ulaanbaatar Standard Time', - 'Asia/Urumqi': 'Central Asia Standard Time', - 'Asia/Ust-Nera': 'Vladivostok Standard Time', - 'Asia/Vientiane': 'SE Asia Standard Time', - 'Asia/Vladivostok': 'Vladivostok Standard Time', - 'Asia/Yakutsk': 'Yakutsk Standard Time', - 'Asia/Yekaterinburg': 'Ekaterinburg Standard Time', - 'Asia/Yerevan': 'Caucasus Standard Time', - 'Atlantic/Azores': 'Azores Standard Time', - 'Atlantic/Bermuda': 'Atlantic Standard Time', - 'Atlantic/Canary': 'GMT Standard Time', - 'Atlantic/Cape_Verde': 'Cape Verde Standard Time', - 'Atlantic/Faeroe': 'GMT Standard Time', - 'Atlantic/Jan_Mayen': 'W. Europe Standard Time', - 'Atlantic/Madeira': 'GMT Standard Time', - 'Atlantic/Reykjavik': 'Greenwich Standard Time', - 'Atlantic/South_Georgia': 'UTC-02', - 'Atlantic/St_Helena': 'Greenwich Standard Time', - 'Atlantic/Stanley': 'SA Eastern Standard Time', - 'Australia/ACT': 'AUS Eastern Standard Time', - 'Australia/Adelaide': 'Cen. Australia Standard Time', - 'Australia/Brisbane': 'E. Australia Standard Time', - 'Australia/Broken_Hill': 'Cen. Australia Standard Time', - 'Australia/Canberra': 'AUS Eastern Standard Time', - 'Australia/Currie': 'Tasmania Standard Time', - 'Australia/Darwin': 'AUS Central Standard Time', - 'Australia/Eucla': 'Aus Central W. Standard Time', - 'Australia/Hobart': 'Tasmania Standard Time', - 'Australia/LHI': 'Lord Howe Standard Time', - 'Australia/Lindeman': 'E. Australia Standard Time', - 'Australia/Lord_Howe': 'Lord Howe Standard Time', - 'Australia/Melbourne': 'AUS Eastern Standard Time', - 'Australia/NSW': 'AUS Eastern Standard Time', - 'Australia/North': 'AUS Central Standard Time', - 'Australia/Perth': 'W. Australia Standard Time', - 'Australia/Queensland': 'E. Australia Standard Time', - 'Australia/South': 'Cen. Australia Standard Time', - 'Australia/Sydney': 'AUS Eastern Standard Time', - 'Australia/Tasmania': 'Tasmania Standard Time', - 'Australia/Victoria': 'AUS Eastern Standard Time', - 'Australia/West': 'W. Australia Standard Time', - 'Australia/Yancowinna': 'Cen. Australia Standard Time', - 'Brazil/Acre': 'SA Pacific Standard Time', - 'Brazil/DeNoronha': 'UTC-02', - 'Brazil/East': 'E. South America Standard Time', - 'Brazil/West': 'SA Western Standard Time', - 'CST6CDT': 'Central Standard Time', - 'Canada/Atlantic': 'Atlantic Standard Time', - 'Canada/Central': 'Central Standard Time', - 'Canada/Eastern': 'Eastern Standard Time', - 'Canada/Mountain': 'Mountain Standard Time', - 'Canada/Newfoundland': 'Newfoundland Standard Time', - 'Canada/Pacific': 'Pacific Standard Time', - 'Canada/Saskatchewan': 'Canada Central Standard Time', - 'Canada/Yukon': 'Yukon Standard Time', - 'Chile/Continental': 'Pacific SA Standard Time', - 'Chile/EasterIsland': 'Easter Island Standard Time', - 'Cuba': 'Cuba Standard Time', - 'EST5EDT': 'Eastern Standard Time', - 'Egypt': 'Egypt Standard Time', - 'Eire': 'GMT Standard Time', - 'Etc/GMT': 'UTC', - 'Etc/GMT+1': 'Cape Verde Standard Time', - 'Etc/GMT+10': 'Hawaiian Standard Time', - 'Etc/GMT+11': 'UTC-11', - 'Etc/GMT+12': 'Dateline Standard Time', - 'Etc/GMT+2': 'UTC-02', - 'Etc/GMT+3': 'SA Eastern Standard Time', - 'Etc/GMT+4': 'SA Western Standard Time', - 'Etc/GMT+5': 'SA Pacific Standard Time', - 'Etc/GMT+6': 'Central America Standard Time', - 'Etc/GMT+7': 'US Mountain Standard Time', - 'Etc/GMT+8': 'UTC-08', - 'Etc/GMT+9': 'UTC-09', - 'Etc/GMT-1': 'W. Central Africa Standard Time', - 'Etc/GMT-10': 'West Pacific Standard Time', - 'Etc/GMT-11': 'Central Pacific Standard Time', - 'Etc/GMT-12': 'UTC+12', - 'Etc/GMT-13': 'UTC+13', - 'Etc/GMT-14': 'Line Islands Standard Time', - 'Etc/GMT-2': 'South Africa Standard Time', - 'Etc/GMT-3': 'E. Africa Standard Time', - 'Etc/GMT-4': 'Arabian Standard Time', - 'Etc/GMT-5': 'West Asia Standard Time', - 'Etc/GMT-6': 'Central Asia Standard Time', - 'Etc/GMT-7': 'SE Asia Standard Time', - 'Etc/GMT-8': 'Singapore Standard Time', - 'Etc/GMT-9': 'Tokyo Standard Time', - 'Etc/UCT': 'UTC', - 'Etc/UTC': 'UTC', - 'Europe/Amsterdam': 'W. Europe Standard Time', - 'Europe/Andorra': 'W. Europe Standard Time', - 'Europe/Astrakhan': 'Astrakhan Standard Time', - 'Europe/Athens': 'GTB Standard Time', - 'Europe/Belfast': 'GMT Standard Time', - 'Europe/Belgrade': 'Central Europe Standard Time', - 'Europe/Berlin': 'W. Europe Standard Time', - 'Europe/Bratislava': 'Central Europe Standard Time', - 'Europe/Brussels': 'Romance Standard Time', - 'Europe/Bucharest': 'GTB Standard Time', - 'Europe/Budapest': 'Central Europe Standard Time', - 'Europe/Busingen': 'W. Europe Standard Time', - 'Europe/Chisinau': 'E. Europe Standard Time', - 'Europe/Copenhagen': 'Romance Standard Time', - 'Europe/Dublin': 'GMT Standard Time', - 'Europe/Gibraltar': 'W. Europe Standard Time', - 'Europe/Guernsey': 'GMT Standard Time', - 'Europe/Helsinki': 'FLE Standard Time', - 'Europe/Isle_of_Man': 'GMT Standard Time', - 'Europe/Istanbul': 'Turkey Standard Time', - 'Europe/Jersey': 'GMT Standard Time', - 'Europe/Kaliningrad': 'Kaliningrad Standard Time', - 'Europe/Kiev': 'FLE Standard Time', - 'Europe/Kirov': 'Russian Standard Time', - 'Europe/Lisbon': 'GMT Standard Time', - 'Europe/Ljubljana': 'Central Europe Standard Time', - 'Europe/London': 'GMT Standard Time', - 'Europe/Luxembourg': 'W. Europe Standard Time', - 'Europe/Madrid': 'Romance Standard Time', - 'Europe/Malta': 'W. Europe Standard Time', - 'Europe/Mariehamn': 'FLE Standard Time', - 'Europe/Minsk': 'Belarus Standard Time', - 'Europe/Monaco': 'W. Europe Standard Time', - 'Europe/Moscow': 'Russian Standard Time', - 'Europe/Oslo': 'W. Europe Standard Time', - 'Europe/Paris': 'Romance Standard Time', - 'Europe/Podgorica': 'Central Europe Standard Time', - 'Europe/Prague': 'Central Europe Standard Time', - 'Europe/Riga': 'FLE Standard Time', - 'Europe/Rome': 'W. Europe Standard Time', - 'Europe/Samara': 'Russia Time Zone 3', - 'Europe/San_Marino': 'W. Europe Standard Time', - 'Europe/Sarajevo': 'Central European Standard Time', - 'Europe/Saratov': 'Saratov Standard Time', - 'Europe/Simferopol': 'Russian Standard Time', - 'Europe/Skopje': 'Central European Standard Time', - 'Europe/Sofia': 'FLE Standard Time', - 'Europe/Stockholm': 'W. Europe Standard Time', - 'Europe/Tallinn': 'FLE Standard Time', - 'Europe/Tirane': 'Central Europe Standard Time', - 'Europe/Tiraspol': 'E. Europe Standard Time', - 'Europe/Ulyanovsk': 'Astrakhan Standard Time', - 'Europe/Uzhgorod': 'FLE Standard Time', - 'Europe/Vaduz': 'W. Europe Standard Time', - 'Europe/Vatican': 'W. Europe Standard Time', - 'Europe/Vienna': 'W. Europe Standard Time', - 'Europe/Vilnius': 'FLE Standard Time', - 'Europe/Volgograd': 'Volgograd Standard Time', - 'Europe/Warsaw': 'Central European Standard Time', - 'Europe/Zagreb': 'Central European Standard Time', - 'Europe/Zaporozhye': 'FLE Standard Time', - 'Europe/Zurich': 'W. Europe Standard Time', - 'GB': 'GMT Standard Time', - 'GB-Eire': 'GMT Standard Time', - 'GMT+0': 'UTC', - 'GMT-0': 'UTC', - 'GMT0': 'UTC', - 'Greenwich': 'UTC', - 'Hongkong': 'China Standard Time', - 'Iceland': 'Greenwich Standard Time', - 'Indian/Antananarivo': 'E. Africa Standard Time', - 'Indian/Chagos': 'Central Asia Standard Time', - 'Indian/Christmas': 'SE Asia Standard Time', - 'Indian/Cocos': 'Myanmar Standard Time', - 'Indian/Comoro': 'E. Africa Standard Time', - 'Indian/Kerguelen': 'West Asia Standard Time', - 'Indian/Mahe': 'Mauritius Standard Time', - 'Indian/Maldives': 'West Asia Standard Time', - 'Indian/Mauritius': 'Mauritius Standard Time', - 'Indian/Mayotte': 'E. Africa Standard Time', - 'Indian/Reunion': 'Mauritius Standard Time', - 'Iran': 'Iran Standard Time', - 'Israel': 'Israel Standard Time', - 'Jamaica': 'SA Pacific Standard Time', - 'Japan': 'Tokyo Standard Time', - 'Kwajalein': 'UTC+12', - 'Libya': 'Libya Standard Time', - 'MST7MDT': 'Mountain Standard Time', - 'Mexico/BajaNorte': 'Pacific Standard Time (Mexico)', - 'Mexico/BajaSur': 'Mountain Standard Time (Mexico)', - 'Mexico/General': 'Central Standard Time (Mexico)', - 'NZ': 'New Zealand Standard Time', - 'NZ-CHAT': 'Chatham Islands Standard Time', - 'Navajo': 'Mountain Standard Time', - 'PRC': 'China Standard Time', - 'PST8PDT': 'Pacific Standard Time', - 'Pacific/Apia': 'Samoa Standard Time', - 'Pacific/Auckland': 'New Zealand Standard Time', - 'Pacific/Bougainville': 'Bougainville Standard Time', - 'Pacific/Chatham': 'Chatham Islands Standard Time', - 'Pacific/Easter': 'Easter Island Standard Time', - 'Pacific/Efate': 'Central Pacific Standard Time', - 'Pacific/Enderbury': 'UTC+13', - 'Pacific/Fakaofo': 'UTC+13', - 'Pacific/Fiji': 'Fiji Standard Time', - 'Pacific/Funafuti': 'UTC+12', - 'Pacific/Galapagos': 'Central America Standard Time', - 'Pacific/Gambier': 'UTC-09', - 'Pacific/Guadalcanal': 'Central Pacific Standard Time', - 'Pacific/Guam': 'West Pacific Standard Time', - 'Pacific/Honolulu': 'Hawaiian Standard Time', - 'Pacific/Johnston': 'Hawaiian Standard Time', - 'Pacific/Kiritimati': 'Line Islands Standard Time', - 'Pacific/Kosrae': 'Central Pacific Standard Time', - 'Pacific/Kwajalein': 'UTC+12', - 'Pacific/Majuro': 'UTC+12', - 'Pacific/Marquesas': 'Marquesas Standard Time', - 'Pacific/Midway': 'UTC-11', - 'Pacific/Nauru': 'UTC+12', - 'Pacific/Niue': 'UTC-11', - 'Pacific/Norfolk': 'Norfolk Standard Time', - 'Pacific/Noumea': 'Central Pacific Standard Time', - 'Pacific/Pago_Pago': 'UTC-11', - 'Pacific/Palau': 'Tokyo Standard Time', - 'Pacific/Pitcairn': 'UTC-08', - 'Pacific/Ponape': 'Central Pacific Standard Time', - 'Pacific/Port_Moresby': 'West Pacific Standard Time', - 'Pacific/Rarotonga': 'Hawaiian Standard Time', - 'Pacific/Saipan': 'West Pacific Standard Time', - 'Pacific/Samoa': 'UTC-11', - 'Pacific/Tahiti': 'Hawaiian Standard Time', - 'Pacific/Tarawa': 'UTC+12', - 'Pacific/Tongatapu': 'Tonga Standard Time', - 'Pacific/Truk': 'West Pacific Standard Time', - 'Pacific/Wake': 'UTC+12', - 'Pacific/Wallis': 'UTC+12', - 'Poland': 'Central European Standard Time', - 'Portugal': 'GMT Standard Time', - 'ROC': 'Taipei Standard Time', - 'ROK': 'Korea Standard Time', - 'Singapore': 'Singapore Standard Time', - 'Turkey': 'Turkey Standard Time', - 'UCT': 'UTC', - 'US/Alaska': 'Alaskan Standard Time', - 'US/Aleutian': 'Aleutian Standard Time', - 'US/Arizona': 'US Mountain Standard Time', - 'US/Central': 'Central Standard Time', - 'US/Eastern': 'Eastern Standard Time', - 'US/Hawaii': 'Hawaiian Standard Time', - 'US/Indiana-Starke': 'Central Standard Time', - 'US/Michigan': 'Eastern Standard Time', - 'US/Mountain': 'Mountain Standard Time', - 'US/Pacific': 'Pacific Standard Time', - 'US/Samoa': 'UTC-11', - 'UTC': 'UTC', - 'Universal': 'UTC', - 'W-SU': 'Russian Standard Time', - 'Zulu': 'UTC'} +tz_win = { + "": "Central Standard Time (Mexico)", + "Africa/Abidjan": "Greenwich Standard Time", + "Africa/Accra": "Greenwich Standard Time", + "Africa/Addis_Ababa": "E. Africa Standard Time", + "Africa/Algiers": "W. Central Africa Standard Time", + "Africa/Asmara": "E. Africa Standard Time", + "Africa/Asmera": "E. Africa Standard Time", + "Africa/Bamako": "Greenwich Standard Time", + "Africa/Bangui": "W. Central Africa Standard Time", + "Africa/Banjul": "Greenwich Standard Time", + "Africa/Bissau": "Greenwich Standard Time", + "Africa/Blantyre": "South Africa Standard Time", + "Africa/Brazzaville": "W. Central Africa Standard Time", + "Africa/Bujumbura": "South Africa Standard Time", + "Africa/Cairo": "Egypt Standard Time", + "Africa/Casablanca": "Morocco Standard Time", + "Africa/Ceuta": "Romance Standard Time", + "Africa/Conakry": "Greenwich Standard Time", + "Africa/Dakar": "Greenwich Standard Time", + "Africa/Dar_es_Salaam": "E. Africa Standard Time", + "Africa/Djibouti": "E. Africa Standard Time", + "Africa/Douala": "W. Central Africa Standard Time", + "Africa/El_Aaiun": "Morocco Standard Time", + "Africa/Freetown": "Greenwich Standard Time", + "Africa/Gaborone": "South Africa Standard Time", + "Africa/Harare": "South Africa Standard Time", + "Africa/Johannesburg": "South Africa Standard Time", + "Africa/Juba": "South Sudan Standard Time", + "Africa/Kampala": "E. Africa Standard Time", + "Africa/Khartoum": "Sudan Standard Time", + "Africa/Kigali": "South Africa Standard Time", + "Africa/Kinshasa": "W. Central Africa Standard Time", + "Africa/Lagos": "W. Central Africa Standard Time", + "Africa/Libreville": "W. Central Africa Standard Time", + "Africa/Lome": "Greenwich Standard Time", + "Africa/Luanda": "W. Central Africa Standard Time", + "Africa/Lubumbashi": "South Africa Standard Time", + "Africa/Lusaka": "South Africa Standard Time", + "Africa/Malabo": "W. Central Africa Standard Time", + "Africa/Maputo": "South Africa Standard Time", + "Africa/Maseru": "South Africa Standard Time", + "Africa/Mbabane": "South Africa Standard Time", + "Africa/Mogadishu": "E. Africa Standard Time", + "Africa/Monrovia": "Greenwich Standard Time", + "Africa/Nairobi": "E. Africa Standard Time", + "Africa/Ndjamena": "W. Central Africa Standard Time", + "Africa/Niamey": "W. Central Africa Standard Time", + "Africa/Nouakchott": "Greenwich Standard Time", + "Africa/Ouagadougou": "Greenwich Standard Time", + "Africa/Porto-Novo": "W. Central Africa Standard Time", + "Africa/Sao_Tome": "Sao Tome Standard Time", + "Africa/Timbuktu": "Greenwich Standard Time", + "Africa/Tripoli": "Libya Standard Time", + "Africa/Tunis": "W. Central Africa Standard Time", + "Africa/Windhoek": "Namibia Standard Time", + "America/Adak": "Aleutian Standard Time", + "America/Anchorage": "Alaskan Standard Time", + "America/Anguilla": "SA Western Standard Time", + "America/Antigua": "SA Western Standard Time", + "America/Araguaina": "Tocantins Standard Time", + "America/Argentina/La_Rioja": "Argentina Standard Time", + "America/Argentina/Rio_Gallegos": "Argentina Standard Time", + "America/Argentina/Salta": "Argentina Standard Time", + "America/Argentina/San_Juan": "Argentina Standard Time", + "America/Argentina/San_Luis": "Argentina Standard Time", + "America/Argentina/Tucuman": "Argentina Standard Time", + "America/Argentina/Ushuaia": "Argentina Standard Time", + "America/Aruba": "SA Western Standard Time", + "America/Asuncion": "Paraguay Standard Time", + "America/Atikokan": "SA Pacific Standard Time", + "America/Atka": "Aleutian Standard Time", + "America/Bahia": "Bahia Standard Time", + "America/Bahia_Banderas": "Central Standard Time (Mexico)", + "America/Barbados": "SA Western Standard Time", + "America/Belem": "SA Eastern Standard Time", + "America/Belize": "Central America Standard Time", + "America/Blanc-Sablon": "SA Western Standard Time", + "America/Boa_Vista": "SA Western Standard Time", + "America/Bogota": "SA Pacific Standard Time", + "America/Boise": "Mountain Standard Time", + "America/Buenos_Aires": "Argentina Standard Time", + "America/Cambridge_Bay": "Mountain Standard Time", + "America/Campo_Grande": "Central Brazilian Standard Time", + "America/Cancun": "Eastern Standard Time (Mexico)", + "America/Caracas": "Venezuela Standard Time", + "America/Catamarca": "Argentina Standard Time", + "America/Cayenne": "SA Eastern Standard Time", + "America/Cayman": "SA Pacific Standard Time", + "America/Chicago": "Central Standard Time", + "America/Chihuahua": "Central Standard Time (Mexico)", + "America/Ciudad_Juarez": "Mountain Standard Time", + "America/Coral_Harbour": "SA Pacific Standard Time", + "America/Cordoba": "Argentina Standard Time", + "America/Costa_Rica": "Central America Standard Time", + "America/Creston": "US Mountain Standard Time", + "America/Cuiaba": "Central Brazilian Standard Time", + "America/Curacao": "SA Western Standard Time", + "America/Danmarkshavn": "Greenwich Standard Time", + "America/Dawson": "Yukon Standard Time", + "America/Dawson_Creek": "US Mountain Standard Time", + "America/Denver": "Mountain Standard Time", + "America/Detroit": "Eastern Standard Time", + "America/Dominica": "SA Western Standard Time", + "America/Edmonton": "Mountain Standard Time", + "America/Eirunepe": "SA Pacific Standard Time", + "America/El_Salvador": "Central America Standard Time", + "America/Ensenada": "Pacific Standard Time (Mexico)", + "America/Fort_Nelson": "US Mountain Standard Time", + "America/Fortaleza": "SA Eastern Standard Time", + "America/Glace_Bay": "Atlantic Standard Time", + "America/Godthab": "Greenland Standard Time", + "America/Goose_Bay": "Atlantic Standard Time", + "America/Grand_Turk": "Turks And Caicos Standard Time", + "America/Grenada": "SA Western Standard Time", + "America/Guadeloupe": "SA Western Standard Time", + "America/Guatemala": "Central America Standard Time", + "America/Guayaquil": "SA Pacific Standard Time", + "America/Guyana": "SA Western Standard Time", + "America/Halifax": "Atlantic Standard Time", + "America/Havana": "Cuba Standard Time", + "America/Hermosillo": "US Mountain Standard Time", + "America/Indiana/Knox": "Central Standard Time", + "America/Indiana/Marengo": "US Eastern Standard Time", + "America/Indiana/Petersburg": "Eastern Standard Time", + "America/Indiana/Tell_City": "Central Standard Time", + "America/Indiana/Vevay": "US Eastern Standard Time", + "America/Indiana/Vincennes": "Eastern Standard Time", + "America/Indiana/Winamac": "Eastern Standard Time", + "America/Indianapolis": "US Eastern Standard Time", + "America/Inuvik": "Mountain Standard Time", + "America/Iqaluit": "Eastern Standard Time", + "America/Jamaica": "SA Pacific Standard Time", + "America/Jujuy": "Argentina Standard Time", + "America/Juneau": "Alaskan Standard Time", + "America/Kentucky/Monticello": "Eastern Standard Time", + "America/Knox_IN": "Central Standard Time", + "America/Kralendijk": "SA Western Standard Time", + "America/La_Paz": "SA Western Standard Time", + "America/Lima": "SA Pacific Standard Time", + "America/Los_Angeles": "Pacific Standard Time", + "America/Louisville": "Eastern Standard Time", + "America/Lower_Princes": "SA Western Standard Time", + "America/Maceio": "SA Eastern Standard Time", + "America/Managua": "Central America Standard Time", + "America/Manaus": "SA Western Standard Time", + "America/Marigot": "SA Western Standard Time", + "America/Martinique": "SA Western Standard Time", + "America/Matamoros": "Central Standard Time", + "America/Mazatlan": "Mountain Standard Time (Mexico)", + "America/Mendoza": "Argentina Standard Time", + "America/Menominee": "Central Standard Time", + "America/Merida": "Central Standard Time (Mexico)", + "America/Metlakatla": "Alaskan Standard Time", + "America/Mexico_City": "Central Standard Time (Mexico)", + "America/Miquelon": "Saint Pierre Standard Time", + "America/Moncton": "Atlantic Standard Time", + "America/Monterrey": "Central Standard Time (Mexico)", + "America/Montevideo": "Montevideo Standard Time", + "America/Montreal": "Eastern Standard Time", + "America/Montserrat": "SA Western Standard Time", + "America/Nassau": "Eastern Standard Time", + "America/New_York": "Eastern Standard Time", + "America/Nipigon": "Eastern Standard Time", + "America/Nome": "Alaskan Standard Time", + "America/Noronha": "UTC-02", + "America/North_Dakota/Beulah": "Central Standard Time", + "America/North_Dakota/Center": "Central Standard Time", + "America/North_Dakota/New_Salem": "Central Standard Time", + "America/Ojinaga": "Central Standard Time", + "America/Panama": "SA Pacific Standard Time", + "America/Pangnirtung": "Eastern Standard Time", + "America/Paramaribo": "SA Eastern Standard Time", + "America/Phoenix": "US Mountain Standard Time", + "America/Port-au-Prince": "Haiti Standard Time", + "America/Port_of_Spain": "SA Western Standard Time", + "America/Porto_Acre": "SA Pacific Standard Time", + "America/Porto_Velho": "SA Western Standard Time", + "America/Puerto_Rico": "SA Western Standard Time", + "America/Punta_Arenas": "Magallanes Standard Time", + "America/Rainy_River": "Central Standard Time", + "America/Rankin_Inlet": "Central Standard Time", + "America/Recife": "SA Eastern Standard Time", + "America/Regina": "Canada Central Standard Time", + "America/Resolute": "Central Standard Time", + "America/Rio_Branco": "SA Pacific Standard Time", + "America/Santa_Isabel": "Pacific Standard Time (Mexico)", + "America/Santarem": "SA Eastern Standard Time", + "America/Santiago": "Pacific SA Standard Time", + "America/Santo_Domingo": "SA Western Standard Time", + "America/Sao_Paulo": "E. South America Standard Time", + "America/Scoresbysund": "Azores Standard Time", + "America/Shiprock": "Mountain Standard Time", + "America/Sitka": "Alaskan Standard Time", + "America/St_Barthelemy": "SA Western Standard Time", + "America/St_Johns": "Newfoundland Standard Time", + "America/St_Kitts": "SA Western Standard Time", + "America/St_Lucia": "SA Western Standard Time", + "America/St_Thomas": "SA Western Standard Time", + "America/St_Vincent": "SA Western Standard Time", + "America/Swift_Current": "Canada Central Standard Time", + "America/Tegucigalpa": "Central America Standard Time", + "America/Thule": "Atlantic Standard Time", + "America/Thunder_Bay": "Eastern Standard Time", + "America/Tijuana": "Pacific Standard Time (Mexico)", + "America/Toronto": "Eastern Standard Time", + "America/Tortola": "SA Western Standard Time", + "America/Vancouver": "Pacific Standard Time", + "America/Virgin": "SA Western Standard Time", + "America/Whitehorse": "Yukon Standard Time", + "America/Winnipeg": "Central Standard Time", + "America/Yakutat": "Alaskan Standard Time", + "America/Yellowknife": "Mountain Standard Time", + "Antarctica/Casey": "Central Pacific Standard Time", + "Antarctica/Davis": "SE Asia Standard Time", + "Antarctica/DumontDUrville": "West Pacific Standard Time", + "Antarctica/Macquarie": "Tasmania Standard Time", + "Antarctica/Mawson": "West Asia Standard Time", + "Antarctica/McMurdo": "New Zealand Standard Time", + "Antarctica/Palmer": "SA Eastern Standard Time", + "Antarctica/Rothera": "SA Eastern Standard Time", + "Antarctica/South_Pole": "New Zealand Standard Time", + "Antarctica/Syowa": "Arab Standard Time", + "Antarctica/Vostok": "Central Asia Standard Time", + "Arctic/Longyearbyen": "W. Europe Standard Time", + "Asia/Aden": "Arab Standard Time", + "Asia/Almaty": "Central Asia Standard Time", + "Asia/Amman": "Jordan Standard Time", + "Asia/Anadyr": "Russia Time Zone 11", + "Asia/Aqtau": "West Asia Standard Time", + "Asia/Aqtobe": "West Asia Standard Time", + "Asia/Ashgabat": "West Asia Standard Time", + "Asia/Ashkhabad": "West Asia Standard Time", + "Asia/Atyrau": "West Asia Standard Time", + "Asia/Baghdad": "Arabic Standard Time", + "Asia/Bahrain": "Arab Standard Time", + "Asia/Baku": "Azerbaijan Standard Time", + "Asia/Bangkok": "SE Asia Standard Time", + "Asia/Barnaul": "Altai Standard Time", + "Asia/Beirut": "Middle East Standard Time", + "Asia/Bishkek": "Central Asia Standard Time", + "Asia/Brunei": "Singapore Standard Time", + "Asia/Calcutta": "India Standard Time", + "Asia/Chita": "Transbaikal Standard Time", + "Asia/Choibalsan": "Ulaanbaatar Standard Time", + "Asia/Chongqing": "China Standard Time", + "Asia/Chungking": "China Standard Time", + "Asia/Colombo": "Sri Lanka Standard Time", + "Asia/Dacca": "Bangladesh Standard Time", + "Asia/Damascus": "Syria Standard Time", + "Asia/Dhaka": "Bangladesh Standard Time", + "Asia/Dili": "Tokyo Standard Time", + "Asia/Dubai": "Arabian Standard Time", + "Asia/Dushanbe": "West Asia Standard Time", + "Asia/Famagusta": "GTB Standard Time", + "Asia/Gaza": "West Bank Standard Time", + "Asia/Harbin": "China Standard Time", + "Asia/Hebron": "West Bank Standard Time", + "Asia/Hong_Kong": "China Standard Time", + "Asia/Hovd": "W. Mongolia Standard Time", + "Asia/Irkutsk": "North Asia East Standard Time", + "Asia/Istanbul": "Turkey Standard Time", + "Asia/Jakarta": "SE Asia Standard Time", + "Asia/Jayapura": "Tokyo Standard Time", + "Asia/Jerusalem": "Israel Standard Time", + "Asia/Kabul": "Afghanistan Standard Time", + "Asia/Kamchatka": "Russia Time Zone 11", + "Asia/Karachi": "Pakistan Standard Time", + "Asia/Kashgar": "Central Asia Standard Time", + "Asia/Katmandu": "Nepal Standard Time", + "Asia/Khandyga": "Yakutsk Standard Time", + "Asia/Krasnoyarsk": "North Asia Standard Time", + "Asia/Kuala_Lumpur": "Singapore Standard Time", + "Asia/Kuching": "Singapore Standard Time", + "Asia/Kuwait": "Arab Standard Time", + "Asia/Macao": "China Standard Time", + "Asia/Macau": "China Standard Time", + "Asia/Magadan": "Magadan Standard Time", + "Asia/Makassar": "Singapore Standard Time", + "Asia/Manila": "Singapore Standard Time", + "Asia/Muscat": "Arabian Standard Time", + "Asia/Nicosia": "GTB Standard Time", + "Asia/Novokuznetsk": "North Asia Standard Time", + "Asia/Novosibirsk": "N. Central Asia Standard Time", + "Asia/Omsk": "Omsk Standard Time", + "Asia/Oral": "West Asia Standard Time", + "Asia/Phnom_Penh": "SE Asia Standard Time", + "Asia/Pontianak": "SE Asia Standard Time", + "Asia/Pyongyang": "North Korea Standard Time", + "Asia/Qatar": "Arab Standard Time", + "Asia/Qostanay": "Central Asia Standard Time", + "Asia/Qyzylorda": "Qyzylorda Standard Time", + "Asia/Rangoon": "Myanmar Standard Time", + "Asia/Riyadh": "Arab Standard Time", + "Asia/Saigon": "SE Asia Standard Time", + "Asia/Sakhalin": "Sakhalin Standard Time", + "Asia/Samarkand": "West Asia Standard Time", + "Asia/Seoul": "Korea Standard Time", + "Asia/Shanghai": "China Standard Time", + "Asia/Singapore": "Singapore Standard Time", + "Asia/Srednekolymsk": "Russia Time Zone 10", + "Asia/Taipei": "Taipei Standard Time", + "Asia/Tashkent": "West Asia Standard Time", + "Asia/Tbilisi": "Georgian Standard Time", + "Asia/Tehran": "Iran Standard Time", + "Asia/Tel_Aviv": "Israel Standard Time", + "Asia/Thimbu": "Bangladesh Standard Time", + "Asia/Thimphu": "Bangladesh Standard Time", + "Asia/Tokyo": "Tokyo Standard Time", + "Asia/Tomsk": "Tomsk Standard Time", + "Asia/Ujung_Pandang": "Singapore Standard Time", + "Asia/Ulaanbaatar": "Ulaanbaatar Standard Time", + "Asia/Ulan_Bator": "Ulaanbaatar Standard Time", + "Asia/Urumqi": "Central Asia Standard Time", + "Asia/Ust-Nera": "Vladivostok Standard Time", + "Asia/Vientiane": "SE Asia Standard Time", + "Asia/Vladivostok": "Vladivostok Standard Time", + "Asia/Yakutsk": "Yakutsk Standard Time", + "Asia/Yekaterinburg": "Ekaterinburg Standard Time", + "Asia/Yerevan": "Caucasus Standard Time", + "Atlantic/Azores": "Azores Standard Time", + "Atlantic/Bermuda": "Atlantic Standard Time", + "Atlantic/Canary": "GMT Standard Time", + "Atlantic/Cape_Verde": "Cape Verde Standard Time", + "Atlantic/Faeroe": "GMT Standard Time", + "Atlantic/Jan_Mayen": "W. Europe Standard Time", + "Atlantic/Madeira": "GMT Standard Time", + "Atlantic/Reykjavik": "Greenwich Standard Time", + "Atlantic/South_Georgia": "UTC-02", + "Atlantic/St_Helena": "Greenwich Standard Time", + "Atlantic/Stanley": "SA Eastern Standard Time", + "Australia/ACT": "AUS Eastern Standard Time", + "Australia/Adelaide": "Cen. Australia Standard Time", + "Australia/Brisbane": "E. Australia Standard Time", + "Australia/Broken_Hill": "Cen. Australia Standard Time", + "Australia/Canberra": "AUS Eastern Standard Time", + "Australia/Currie": "Tasmania Standard Time", + "Australia/Darwin": "AUS Central Standard Time", + "Australia/Eucla": "Aus Central W. Standard Time", + "Australia/Hobart": "Tasmania Standard Time", + "Australia/LHI": "Lord Howe Standard Time", + "Australia/Lindeman": "E. Australia Standard Time", + "Australia/Lord_Howe": "Lord Howe Standard Time", + "Australia/Melbourne": "AUS Eastern Standard Time", + "Australia/NSW": "AUS Eastern Standard Time", + "Australia/North": "AUS Central Standard Time", + "Australia/Perth": "W. Australia Standard Time", + "Australia/Queensland": "E. Australia Standard Time", + "Australia/South": "Cen. Australia Standard Time", + "Australia/Sydney": "AUS Eastern Standard Time", + "Australia/Tasmania": "Tasmania Standard Time", + "Australia/Victoria": "AUS Eastern Standard Time", + "Australia/West": "W. Australia Standard Time", + "Australia/Yancowinna": "Cen. Australia Standard Time", + "Brazil/Acre": "SA Pacific Standard Time", + "Brazil/DeNoronha": "UTC-02", + "Brazil/East": "E. South America Standard Time", + "Brazil/West": "SA Western Standard Time", + "CST6CDT": "Central Standard Time", + "Canada/Atlantic": "Atlantic Standard Time", + "Canada/Central": "Central Standard Time", + "Canada/Eastern": "Eastern Standard Time", + "Canada/Mountain": "Mountain Standard Time", + "Canada/Newfoundland": "Newfoundland Standard Time", + "Canada/Pacific": "Pacific Standard Time", + "Canada/Saskatchewan": "Canada Central Standard Time", + "Canada/Yukon": "Yukon Standard Time", + "Chile/Continental": "Pacific SA Standard Time", + "Chile/EasterIsland": "Easter Island Standard Time", + "Cuba": "Cuba Standard Time", + "EST5EDT": "Eastern Standard Time", + "Egypt": "Egypt Standard Time", + "Eire": "GMT Standard Time", + "Etc/GMT": "UTC", + "Etc/GMT+0": "UTC", + "Etc/GMT+1": "Cape Verde Standard Time", + "Etc/GMT+10": "Hawaiian Standard Time", + "Etc/GMT+11": "UTC-11", + "Etc/GMT+12": "Dateline Standard Time", + "Etc/GMT+2": "UTC-02", + "Etc/GMT+3": "SA Eastern Standard Time", + "Etc/GMT+4": "SA Western Standard Time", + "Etc/GMT+5": "SA Pacific Standard Time", + "Etc/GMT+6": "Central America Standard Time", + "Etc/GMT+7": "US Mountain Standard Time", + "Etc/GMT+8": "UTC-08", + "Etc/GMT+9": "UTC-09", + "Etc/GMT-0": "UTC", + "Etc/GMT-1": "W. Central Africa Standard Time", + "Etc/GMT-10": "West Pacific Standard Time", + "Etc/GMT-11": "Central Pacific Standard Time", + "Etc/GMT-12": "UTC+12", + "Etc/GMT-13": "UTC+13", + "Etc/GMT-14": "Line Islands Standard Time", + "Etc/GMT-2": "South Africa Standard Time", + "Etc/GMT-3": "E. Africa Standard Time", + "Etc/GMT-4": "Arabian Standard Time", + "Etc/GMT-5": "West Asia Standard Time", + "Etc/GMT-6": "Central Asia Standard Time", + "Etc/GMT-7": "SE Asia Standard Time", + "Etc/GMT-8": "Singapore Standard Time", + "Etc/GMT-9": "Tokyo Standard Time", + "Etc/GMT0": "UTC", + "Etc/Greenwich": "UTC", + "Etc/UCT": "UTC", + "Etc/UTC": "UTC", + "Etc/Universal": "UTC", + "Etc/Zulu": "UTC", + "Europe/Amsterdam": "Romance Standard Time", + "Europe/Andorra": "W. Europe Standard Time", + "Europe/Astrakhan": "Astrakhan Standard Time", + "Europe/Athens": "GTB Standard Time", + "Europe/Belfast": "GMT Standard Time", + "Europe/Belgrade": "Central Europe Standard Time", + "Europe/Berlin": "W. Europe Standard Time", + "Europe/Bratislava": "Central Europe Standard Time", + "Europe/Brussels": "Romance Standard Time", + "Europe/Bucharest": "GTB Standard Time", + "Europe/Budapest": "Central Europe Standard Time", + "Europe/Busingen": "W. Europe Standard Time", + "Europe/Chisinau": "E. Europe Standard Time", + "Europe/Copenhagen": "W. Europe Standard Time", + "Europe/Dublin": "GMT Standard Time", + "Europe/Gibraltar": "W. Europe Standard Time", + "Europe/Guernsey": "GMT Standard Time", + "Europe/Helsinki": "FLE Standard Time", + "Europe/Isle_of_Man": "GMT Standard Time", + "Europe/Istanbul": "Turkey Standard Time", + "Europe/Jersey": "GMT Standard Time", + "Europe/Kaliningrad": "Kaliningrad Standard Time", + "Europe/Kiev": "FLE Standard Time", + "Europe/Kirov": "Russian Standard Time", + "Europe/Lisbon": "GMT Standard Time", + "Europe/Ljubljana": "Central Europe Standard Time", + "Europe/London": "GMT Standard Time", + "Europe/Luxembourg": "Romance Standard Time", + "Europe/Madrid": "Romance Standard Time", + "Europe/Malta": "W. Europe Standard Time", + "Europe/Mariehamn": "FLE Standard Time", + "Europe/Minsk": "Belarus Standard Time", + "Europe/Monaco": "Romance Standard Time", + "Europe/Moscow": "Russian Standard Time", + "Europe/Nicosia": "GTB Standard Time", + "Europe/Oslo": "W. Europe Standard Time", + "Europe/Paris": "Romance Standard Time", + "Europe/Podgorica": "Central Europe Standard Time", + "Europe/Prague": "Central Europe Standard Time", + "Europe/Riga": "FLE Standard Time", + "Europe/Rome": "W. Europe Standard Time", + "Europe/Samara": "Russia Time Zone 3", + "Europe/San_Marino": "W. Europe Standard Time", + "Europe/Sarajevo": "Central Europe Standard Time", + "Europe/Saratov": "Saratov Standard Time", + "Europe/Simferopol": "Russian Standard Time", + "Europe/Skopje": "Central Europe Standard Time", + "Europe/Sofia": "FLE Standard Time", + "Europe/Stockholm": "W. Europe Standard Time", + "Europe/Tallinn": "FLE Standard Time", + "Europe/Tirane": "Central Europe Standard Time", + "Europe/Tiraspol": "E. Europe Standard Time", + "Europe/Ulyanovsk": "Astrakhan Standard Time", + "Europe/Uzhgorod": "FLE Standard Time", + "Europe/Vaduz": "W. Europe Standard Time", + "Europe/Vatican": "W. Europe Standard Time", + "Europe/Vienna": "W. Europe Standard Time", + "Europe/Vilnius": "FLE Standard Time", + "Europe/Volgograd": "Volgograd Standard Time", + "Europe/Warsaw": "Central European Standard Time", + "Europe/Zagreb": "Central Europe Standard Time", + "Europe/Zaporozhye": "FLE Standard Time", + "Europe/Zurich": "W. Europe Standard Time", + "GB": "GMT Standard Time", + "GB-Eire": "GMT Standard Time", + "GMT+0": "UTC", + "GMT-0": "UTC", + "GMT0": "UTC", + "Greenwich": "UTC", + "Hongkong": "China Standard Time", + "Iceland": "Greenwich Standard Time", + "Indian/Antananarivo": "E. Africa Standard Time", + "Indian/Chagos": "Central Asia Standard Time", + "Indian/Christmas": "SE Asia Standard Time", + "Indian/Cocos": "Myanmar Standard Time", + "Indian/Comoro": "E. Africa Standard Time", + "Indian/Kerguelen": "West Asia Standard Time", + "Indian/Mahe": "Arabian Standard Time", + "Indian/Maldives": "West Asia Standard Time", + "Indian/Mauritius": "Mauritius Standard Time", + "Indian/Mayotte": "E. Africa Standard Time", + "Indian/Reunion": "Arabian Standard Time", + "Iran": "Iran Standard Time", + "Israel": "Israel Standard Time", + "Jamaica": "SA Pacific Standard Time", + "Japan": "Tokyo Standard Time", + "Kwajalein": "UTC+12", + "Libya": "Libya Standard Time", + "MST7MDT": "Mountain Standard Time", + "Mexico/BajaNorte": "Pacific Standard Time (Mexico)", + "Mexico/BajaSur": "Mountain Standard Time (Mexico)", + "Mexico/General": "Central Standard Time (Mexico)", + "NZ": "New Zealand Standard Time", + "NZ-CHAT": "Chatham Islands Standard Time", + "Navajo": "Mountain Standard Time", + "PRC": "China Standard Time", + "PST8PDT": "Pacific Standard Time", + "Pacific/Apia": "Samoa Standard Time", + "Pacific/Auckland": "New Zealand Standard Time", + "Pacific/Bougainville": "Bougainville Standard Time", + "Pacific/Chatham": "Chatham Islands Standard Time", + "Pacific/Chuuk": "West Pacific Standard Time", + "Pacific/Easter": "Easter Island Standard Time", + "Pacific/Efate": "Central Pacific Standard Time", + "Pacific/Enderbury": "UTC+13", + "Pacific/Fakaofo": "UTC+13", + "Pacific/Fiji": "Fiji Standard Time", + "Pacific/Funafuti": "UTC+12", + "Pacific/Galapagos": "Central America Standard Time", + "Pacific/Gambier": "UTC-09", + "Pacific/Guadalcanal": "Central Pacific Standard Time", + "Pacific/Guam": "West Pacific Standard Time", + "Pacific/Honolulu": "Hawaiian Standard Time", + "Pacific/Johnston": "Hawaiian Standard Time", + "Pacific/Kiritimati": "Line Islands Standard Time", + "Pacific/Kosrae": "Central Pacific Standard Time", + "Pacific/Kwajalein": "UTC+12", + "Pacific/Majuro": "UTC+12", + "Pacific/Marquesas": "Marquesas Standard Time", + "Pacific/Midway": "UTC-11", + "Pacific/Nauru": "UTC+12", + "Pacific/Niue": "UTC-11", + "Pacific/Norfolk": "Norfolk Standard Time", + "Pacific/Noumea": "Central Pacific Standard Time", + "Pacific/Pago_Pago": "UTC-11", + "Pacific/Palau": "Tokyo Standard Time", + "Pacific/Pitcairn": "UTC-08", + "Pacific/Pohnpei": "Central Pacific Standard Time", + "Pacific/Ponape": "Central Pacific Standard Time", + "Pacific/Port_Moresby": "West Pacific Standard Time", + "Pacific/Rarotonga": "Hawaiian Standard Time", + "Pacific/Saipan": "West Pacific Standard Time", + "Pacific/Samoa": "UTC-11", + "Pacific/Tahiti": "Hawaiian Standard Time", + "Pacific/Tarawa": "UTC+12", + "Pacific/Tongatapu": "Tonga Standard Time", + "Pacific/Truk": "West Pacific Standard Time", + "Pacific/Wake": "UTC+12", + "Pacific/Wallis": "UTC+12", + "Pacific/Yap": "West Pacific Standard Time", + "Poland": "Central European Standard Time", + "Portugal": "GMT Standard Time", + "ROC": "Taipei Standard Time", + "ROK": "Korea Standard Time", + "Singapore": "Singapore Standard Time", + "Turkey": "Turkey Standard Time", + "UCT": "UTC", + "US/Alaska": "Alaskan Standard Time", + "US/Aleutian": "Aleutian Standard Time", + "US/Arizona": "US Mountain Standard Time", + "US/Central": "Central Standard Time", + "US/Eastern": "Eastern Standard Time", + "US/Hawaii": "Hawaiian Standard Time", + "US/Indiana-Starke": "Central Standard Time", + "US/Michigan": "Eastern Standard Time", + "US/Mountain": "Mountain Standard Time", + "US/Pacific": "Pacific Standard Time", + "US/Samoa": "UTC-11", + "UTC": "UTC", + "Universal": "UTC", + "W-SU": "Russian Standard Time", + "Zulu": "UTC", +} diff --git a/requirements.txt b/requirements.txt index 56927154..8ca67fe6 100644 --- a/requirements.txt +++ b/requirements.txt @@ -44,7 +44,7 @@ six==1.16.0 tempora==5.5.0 tokenize-rt==5.2.0 tzdata==2023.3 -tzlocal==4.2 +tzlocal==5.0.1 urllib3<2 webencodings==0.5.1 websocket-client==1.6.2 From 6d858367a4367e204f1cc02467c99546a5d8bc23 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Fri, 25 Aug 2023 11:49:55 -0700 Subject: [PATCH 005/290] v2.13.1 --- CHANGELOG.md | 7 +++++++ plexpy/version.py | 2 +- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index a7655ed1..1266e43f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,12 @@ # Changelog +## v2.13.1 (2023-08-25) +* Notes: + * Support for Python 3.7 has been dropped. The minimum Python version is now 3.8. +* Other: + * Fix: Tautulli failing to start on some systems. + + ## v2.13.0 (2023-08-25) * Notes: diff --git a/plexpy/version.py b/plexpy/version.py index 398d8ecb..c5ee1521 100644 --- a/plexpy/version.py +++ b/plexpy/version.py @@ -18,4 +18,4 @@ from __future__ import unicode_literals PLEXPY_BRANCH = "master" -PLEXPY_RELEASE_VERSION = "v2.13.0" \ No newline at end of file +PLEXPY_RELEASE_VERSION = "v2.13.1" \ No newline at end of file From aaea924aaaf9501e70b2277dd0b073cc2cc75e41 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 18 Sep 2023 12:57:18 -0700 Subject: [PATCH 006/290] Bump actions/checkout from 3 to 4 (#2145) Bumps [actions/checkout](https://github.com/actions/checkout) from 3 to 4. - [Release notes](https://github.com/actions/checkout/releases) - [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md) - [Commits](https://github.com/actions/checkout/compare/v3...v4) --- updated-dependencies: - dependency-name: actions/checkout dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- .github/workflows/codeql.yml | 2 +- .github/workflows/publish-docker.yml | 2 +- .github/workflows/publish-installers.yml | 4 ++-- .github/workflows/publish-snap.yml | 2 +- .github/workflows/pull-requests.yml | 2 +- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml index e914485d..f9593d5a 100644 --- a/.github/workflows/codeql.yml +++ b/.github/workflows/codeql.yml @@ -24,7 +24,7 @@ jobs: steps: - name: Checkout Code - uses: actions/checkout@v3 + uses: actions/checkout@v4 - name: Initialize CodeQL uses: github/codeql-action/init@v2 diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml index 6d91bbf6..80dad13c 100644 --- a/.github/workflows/publish-docker.yml +++ b/.github/workflows/publish-docker.yml @@ -13,7 +13,7 @@ jobs: if: ${{ !contains(github.event.head_commit.message, '[skip ci]') }} steps: - name: Checkout Code - uses: actions/checkout@v3 + uses: actions/checkout@v4 - name: Prepare id: prepare diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml index 0b6eec36..0e0b1082 100644 --- a/.github/workflows/publish-installers.yml +++ b/.github/workflows/publish-installers.yml @@ -24,7 +24,7 @@ jobs: steps: - name: Checkout Code - uses: actions/checkout@v3 + uses: actions/checkout@v4 - name: Set Release Version id: get_version @@ -103,7 +103,7 @@ jobs: uses: technote-space/workflow-conclusion-action@v3 - name: Checkout Code - uses: actions/checkout@v3 + uses: actions/checkout@v4 - name: Set Release Version id: get_version diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml index dd74c3a3..30ee799b 100644 --- a/.github/workflows/publish-snap.yml +++ b/.github/workflows/publish-snap.yml @@ -20,7 +20,7 @@ jobs: - armhf steps: - name: Checkout Code - uses: actions/checkout@v3 + uses: actions/checkout@v4 - name: Prepare id: prepare diff --git a/.github/workflows/pull-requests.yml b/.github/workflows/pull-requests.yml index 1a24cf24..ac550fe2 100644 --- a/.github/workflows/pull-requests.yml +++ b/.github/workflows/pull-requests.yml @@ -10,7 +10,7 @@ jobs: runs-on: ubuntu-latest steps: - name: Checkout Code - uses: actions/checkout@v3 + uses: actions/checkout@v4 - name: Comment on Pull Request uses: mshick/add-pr-comment@v2 From 26419f4610e0633498efe0a8229eab061e5eadf5 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 18 Sep 2023 12:57:32 -0700 Subject: [PATCH 007/290] Bump docker/login-action from 2 to 3 (#2149) Bumps [docker/login-action](https://github.com/docker/login-action) from 2 to 3. - [Release notes](https://github.com/docker/login-action/releases) - [Commits](https://github.com/docker/login-action/compare/v2...v3) --- updated-dependencies: - dependency-name: docker/login-action dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- .github/workflows/publish-docker.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml index 80dad13c..789c65f6 100644 --- a/.github/workflows/publish-docker.yml +++ b/.github/workflows/publish-docker.yml @@ -55,14 +55,14 @@ jobs: ${{ runner.os }}-buildx- - name: Login to DockerHub - uses: docker/login-action@v2 + uses: docker/login-action@v3 if: success() with: username: ${{ secrets.DOCKER_USERNAME }} password: ${{ secrets.DOCKER_PASSWORD }} - name: Login to GitHub Container Registry - uses: docker/login-action@v2 + uses: docker/login-action@v3 if: success() with: registry: ghcr.io From 5e75d0ce73b64076a0f65d5cfb5411c759a5bdad Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 18 Sep 2023 12:57:43 -0700 Subject: [PATCH 008/290] Bump docker/setup-qemu-action from 2 to 3 (#2150) Bumps [docker/setup-qemu-action](https://github.com/docker/setup-qemu-action) from 2 to 3. - [Release notes](https://github.com/docker/setup-qemu-action/releases) - [Commits](https://github.com/docker/setup-qemu-action/compare/v2...v3) --- updated-dependencies: - dependency-name: docker/setup-qemu-action dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- .github/workflows/publish-docker.yml | 2 +- .github/workflows/publish-snap.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml index 789c65f6..f396bbac 100644 --- a/.github/workflows/publish-docker.yml +++ b/.github/workflows/publish-docker.yml @@ -38,7 +38,7 @@ jobs: echo "docker_image=${{ secrets.DOCKER_REPO }}/tautulli" >> $GITHUB_OUTPUT - name: Set Up QEMU - uses: docker/setup-qemu-action@v2 + uses: docker/setup-qemu-action@v3 - name: Set up Docker Buildx uses: docker/setup-buildx-action@v2 diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml index 30ee799b..e8a6be7d 100644 --- a/.github/workflows/publish-snap.yml +++ b/.github/workflows/publish-snap.yml @@ -35,7 +35,7 @@ jobs: fi - name: Set Up QEMU - uses: docker/setup-qemu-action@v2 + uses: docker/setup-qemu-action@v3 - name: Build Snap Package uses: diddlesnaps/snapcraft-multiarch-action@v1 From 76f1335a559d5dbc6e5edd505032b899dc9bb04b Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 18 Sep 2023 12:57:59 -0700 Subject: [PATCH 009/290] Bump docker/build-push-action from 4 to 5 (#2151) Bumps [docker/build-push-action](https://github.com/docker/build-push-action) from 4 to 5. - [Release notes](https://github.com/docker/build-push-action/releases) - [Commits](https://github.com/docker/build-push-action/compare/v4...v5) --- updated-dependencies: - dependency-name: docker/build-push-action dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- .github/workflows/publish-docker.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml index f396bbac..feb56b68 100644 --- a/.github/workflows/publish-docker.yml +++ b/.github/workflows/publish-docker.yml @@ -70,7 +70,7 @@ jobs: password: ${{ secrets.GHCR_TOKEN }} - name: Docker Build and Push - uses: docker/build-push-action@v4 + uses: docker/build-push-action@v5 if: success() with: context: . From 4938954c6117a00091d8f78db32d61e27a7e74a0 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 18 Sep 2023 12:59:23 -0700 Subject: [PATCH 010/290] Bump docker/setup-buildx-action from 2 to 3 (#2152) Bumps [docker/setup-buildx-action](https://github.com/docker/setup-buildx-action) from 2 to 3. - [Release notes](https://github.com/docker/setup-buildx-action/releases) - [Commits](https://github.com/docker/setup-buildx-action/compare/v2...v3) --- updated-dependencies: - dependency-name: docker/setup-buildx-action dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- .github/workflows/publish-docker.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml index feb56b68..2eccdf5d 100644 --- a/.github/workflows/publish-docker.yml +++ b/.github/workflows/publish-docker.yml @@ -41,7 +41,7 @@ jobs: uses: docker/setup-qemu-action@v3 - name: Set up Docker Buildx - uses: docker/setup-buildx-action@v2 + uses: docker/setup-buildx-action@v3 id: buildx with: version: latest From 59fe34982efc0bcb6fc160fc027231ad6dc81e21 Mon Sep 17 00:00:00 2001 From: herby2212 <12448284+herby2212@users.noreply.github.com> Date: Sat, 7 Oct 2023 22:45:11 +0200 Subject: [PATCH 011/290] Concurrent Streams per Day Graph (#2046) * initial commit * fix grouping in webserve * remove event handler and adapt cursor * optimize most concurrent calculation * update branch from nightly and user filter * max concurrent streams in graph * made several changes mentioned in review --- data/interfaces/default/graphs.html | 46 +++++++- .../concurrent_streams_by_stream_type.js | 76 +++++++++++++ plexpy/graphs.py | 104 +++++++++++++++++- plexpy/helpers.py | 6 + plexpy/webserve.py | 38 +++++++ 5 files changed, 265 insertions(+), 5 deletions(-) create mode 100644 data/interfaces/default/js/graphs/concurrent_streams_by_stream_type.js diff --git a/data/interfaces/default/graphs.html b/data/interfaces/default/graphs.html index 8435df20..8f16f59a 100644 --- a/data/interfaces/default/graphs.html +++ b/data/interfaces/default/graphs.html @@ -137,6 +137,20 @@ +
+
+

Daily concurrent stream count by stream type Last 30 days

+

+ The total count of concurrent streams of tv, movies, and music by the transcode decision. +

+
+
+
Loading chart...
+
+
+
+
+

Play count by source resolution Last 30 days

@@ -312,7 +326,8 @@ 'Live TV': '#19A0D7', 'Direct Play': '#E5A00D', 'Direct Stream': '#FFFFFF', - 'Transcode': '#F06464' + 'Transcode': '#F06464', + 'Max. Concurrent Streams': '#1014FC' }; var series_colors = []; $.each(data_series, function(index, series) { @@ -327,6 +342,7 @@ + @@ -540,6 +556,33 @@ } }); + $.ajax({ + url: "get_concurrent_streams_by_stream_type", + type: 'get', + data: { time_range: time_range, user_id: selected_user_id }, + dataType: "json", + success: function(data) { + var dateArray = []; + $.each(data.categories, function (i, day) { + dateArray.push(moment(day, 'YYYY-MM-DD').valueOf()); + // Highlight the weekend + if ((moment(day, 'YYYY-MM-DD').format('ddd') == 'Sat') || + (moment(day, 'YYYY-MM-DD').format('ddd') == 'Sun')) { + hc_plays_by_day_options.xAxis.plotBands.push({ + from: i-0.5, + to: i+0.5, + color: 'rgba(80,80,80,0.3)' + }); + } + }); + hc_concurrent_streams_by_stream_type_options.yAxis.min = 0; + hc_concurrent_streams_by_stream_type_options.xAxis.categories = dateArray; + hc_concurrent_streams_by_stream_type_options.series = getGraphVisibility(hc_concurrent_streams_by_stream_type_options.chart.renderTo, data.series); + hc_concurrent_streams_by_stream_type_options.colors = getGraphColors(data.series); + var hc_plays_by_stream_type = new Highcharts.Chart(hc_concurrent_streams_by_stream_type_options); + } + }); + $.ajax({ url: "get_plays_by_source_resolution", type: 'get', @@ -754,6 +797,7 @@ hc_plays_by_day_options.xAxis.plotBands = []; hc_plays_by_stream_type_options.xAxis.plotBands = []; + hc_concurrent_streams_by_stream_type_options.xAxis.plotBands = []; hc_plays_by_day_options.yAxis.labels.formatter = yaxis_format; hc_plays_by_dayofweek_options.yAxis.labels.formatter = yaxis_format; diff --git a/data/interfaces/default/js/graphs/concurrent_streams_by_stream_type.js b/data/interfaces/default/js/graphs/concurrent_streams_by_stream_type.js new file mode 100644 index 00000000..623e4735 --- /dev/null +++ b/data/interfaces/default/js/graphs/concurrent_streams_by_stream_type.js @@ -0,0 +1,76 @@ +var formatter_function = function() { + if (moment(this.x, 'X').isValid() && (this.x > 946684800)) { + var s = ''+ moment(this.x).format('ddd MMM D') +''; + } else { + var s = ''+ this.x +''; + } + $.each(this.points, function(i, point) { + s += '
'+point.series.name+': '+point.y; + }); + return s; +}; + +var hc_concurrent_streams_by_stream_type_options = { + chart: { + type: 'line', + backgroundColor: 'rgba(0,0,0,0)', + renderTo: 'graph_concurrent_streams_by_stream_type' + }, + title: { + text: '' + }, + legend: { + enabled: true, + itemStyle: { + font: '9pt "Open Sans", sans-serif', + color: '#A0A0A0' + }, + itemHoverStyle: { + color: '#FFF' + }, + itemHiddenStyle: { + color: '#444' + } + }, + credits: { + enabled: false + }, + plotOptions: { + series: { + events: { + legendItemClick: function() { + setGraphVisibility(this.chart.renderTo.id, this.chart.series, this.name); + } + } + } + }, + xAxis: { + type: 'datetime', + labels: { + formatter: function() { + return moment(this.value).format("MMM D"); + }, + style: { + color: '#aaa' + } + }, + categories: [{}], + plotBands: [] + }, + yAxis: { + title: { + text: null + }, + labels: { + style: { + color: '#aaa' + } + } + }, + tooltip: { + shared: true, + crosshairs: true, + formatter: formatter_function + }, + series: [{}] +}; \ No newline at end of file diff --git a/plexpy/graphs.py b/plexpy/graphs.py index 58a199c0..82db9d82 100644 --- a/plexpy/graphs.py +++ b/plexpy/graphs.py @@ -22,7 +22,6 @@ from future.builtins import object import arrow import datetime - import plexpy if plexpy.PYTHON2: import common @@ -826,6 +825,102 @@ class Graphs(object): 'series': [series_1_output, series_2_output, series_3_output]} return output + def get_total_concurrent_streams_per_stream_type(self, time_range='30', user_id=None): + monitor_db = database.MonitorDatabase() + + time_range = helpers.cast_to_int(time_range) or 30 + timestamp = helpers.timestamp() - time_range * 24 * 60 * 60 + + user_cond = self._make_user_cond(user_id, 'WHERE') + + def calc_most_concurrent(result): + times = [] + for item in result: + times.append({'time': str(item['started']) + 'B', 'count': 1}) + times.append({'time': str(item['stopped']) + 'A', 'count': -1}) + times = sorted(times, key=lambda k: k['time']) + + count = 0 + final_count = 0 + last_count = 0 + + for d in times: + if d['count'] == 1: + count += d['count'] + else: + if count >= last_count: + last_count = count + final_count = count + count += d['count'] + + return final_count + + try: + query = 'SELECT sh.date_played, sh.started, sh.stopped, shmi.transcode_decision ' \ + 'FROM (SELECT *, ' \ + 'date(started, "unixepoch", "localtime") AS date_played ' \ + 'FROM session_history %s) AS sh ' \ + 'JOIN session_history_media_info AS shmi ON sh.id = shmi.id ' \ + 'WHERE sh.stopped >= %s ' \ + 'ORDER BY sh.date_played' % (user_cond, timestamp) + + result = monitor_db.select(query) + except Exception as e: + logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_stream_type: %s." % e) + return None + + # create our date range as some days may not have any data + # but we still want to display them + base = datetime.date.today() + date_list = [base - datetime.timedelta(days=x) for x in range(0, int(time_range))] + + categories = [] + series_1 = [] + series_2 = [] + series_3 = [] + series_4 = [] + + grouped_result_by_stream_type = helpers.group_by_keys(result, ('date_played','transcode_decision')) + grouped_result_by_day = helpers.group_by_keys(result, ['date_played']) + + for date_item in sorted(date_list): + date_string = date_item.strftime('%Y-%m-%d') + categories.append(date_string) + series_1_value = 0 + series_2_value = 0 + series_3_value = 0 + series_4_value = 0 + + for item in grouped_result_by_stream_type: + if item['key'] == (date_string,'direct play'): + series_1_value = calc_most_concurrent(item['value']) + elif item['key'] == (date_string,'copy'): + series_2_value = calc_most_concurrent(item['value']) + elif item['key'] == (date_string,'transcode'): + series_3_value = calc_most_concurrent(item['value']) + + for item in grouped_result_by_day: + if item['key'] == date_string: + series_4_value = calc_most_concurrent(item['value']) + + series_1.append(series_1_value) + series_2.append(series_2_value) + series_3.append(series_3_value) + series_4.append(series_4_value) + + series_1_output = {'name': 'Direct Play', + 'data': series_1} + series_2_output = {'name': 'Direct Stream', + 'data': series_2} + series_3_output = {'name': 'Transcode', + 'data': series_3} + series_4_output = {'name': 'Max. Concurrent Streams', + 'data': series_4} + + output = {'categories': categories, + 'series': [series_1_output, series_2_output, series_3_output, series_4_output]} + return output + def get_total_plays_by_source_resolution(self, time_range='30', y_axis='plays', user_id=None, grouping=None): monitor_db = database.MonitorDatabase() @@ -1169,15 +1264,16 @@ class Graphs(object): return output - def _make_user_cond(self, user_id): + def _make_user_cond(self, user_id, cond_prefix='AND'): """ Expects user_id to be a comma-separated list of ints. """ user_cond = '' + if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()): - user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id() + user_cond = cond_prefix + ' session_history.user_id = %s ' % session.get_session_user_id() elif user_id: user_ids = helpers.split_strip(user_id) if all(id.isdigit() for id in user_ids): - user_cond = 'AND session_history.user_id IN (%s) ' % ','.join(user_ids) + user_cond =cond_prefix + ' session_history.user_id IN (%s) ' % ','.join(user_ids) return user_cond diff --git a/plexpy/helpers.py b/plexpy/helpers.py index 085dfc12..4512f0b6 100644 --- a/plexpy/helpers.py +++ b/plexpy/helpers.py @@ -32,6 +32,7 @@ import datetime from functools import reduce, wraps import hashlib import imghdr +from itertools import groupby from future.moves.itertools import islice, zip_longest from ipaddress import ip_address, ip_network, IPv4Address import ipwhois @@ -1241,6 +1242,11 @@ def grouper(iterable, n, fillvalue=None): args = [iter(iterable)] * n return zip_longest(fillvalue=fillvalue, *args) +def group_by_keys(iterable, keys): + key_function = operator.itemgetter(*keys) + + sorted_iterable = sorted(iterable, key=key_function) + return[{'key': key, 'value': list(group)} for key, group in groupby(sorted_iterable, key_function)] def chunk(it, size): it = iter(it) diff --git a/plexpy/webserve.py b/plexpy/webserve.py index b643f84b..196bbe5b 100644 --- a/plexpy/webserve.py +++ b/plexpy/webserve.py @@ -2549,6 +2549,44 @@ class WebInterface(object): logger.warn("Unable to retrieve data for get_plays_by_stream_type.") return result + @cherrypy.expose + @cherrypy.tools.json_out() + @requireAuth() + @addtoapi() + def get_concurrent_streams_by_stream_type(self, time_range='30', user_id=None, **kwargs): + """ Get graph data for concurrent streams by stream type by date. + + ``` + Required parameters: + None + + Optional parameters: + time_range (str): The number of days of data to return + user_id (str): Comma separated list of user id to filter the data + + Returns: + json: + {"categories": + ["YYYY-MM-DD", "YYYY-MM-DD", ...] + "series": + [{"name": "Direct Play", "data": [...]} + {"name": "Direct Stream", "data": [...]}, + {"name": "Transcode", "data": [...]}, + {"name": "Max. Concurrent Streams", "data": [...]} + ] + } + ``` + """ + + graph = graphs.Graphs() + result = graph.get_total_concurrent_streams_per_stream_type(time_range=time_range, user_id=user_id) + + if result: + return result + else: + logger.warn("Unable to retrieve data for get_concurrent_streams_by_stream_type.") + return result + @cherrypy.expose @cherrypy.tools.json_out() @requireAuth() From a668932ea87b73967c716cf0b88a7a39c37f48b0 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Fri, 8 Sep 2023 15:27:50 -0700 Subject: [PATCH 012/290] Remove banners from exports --- plexpy/exporter.py | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/plexpy/exporter.py b/plexpy/exporter.py index f1c730a4..e1dc989d 100644 --- a/plexpy/exporter.py +++ b/plexpy/exporter.py @@ -420,8 +420,6 @@ class Export(object): 'audioLanguage': None, 'autoDeletionItemPolicyUnwatchedLibrary': None, 'autoDeletionItemPolicyWatchedLibrary': None, - 'banner': None, - 'bannerFile': lambda o: self.get_image(o, 'banner'), 'childCount': None, 'collections': { 'id': None, @@ -1382,7 +1380,7 @@ class Export(object): 'fields.name', 'fields.locked', 'guids.id' ], 3: [ - 'art', 'thumb', 'banner', 'theme', 'key', + 'art', 'thumb', 'theme', 'key', 'updatedAt', 'lastViewedAt', 'viewCount', 'lastRatedAt' ], 9: self._get_all_metadata_attrs(_media_type) @@ -2258,8 +2256,6 @@ class Export(object): image_url = item.thumbUrl elif image == 'art': image_url = item.artUrl - elif image == 'banner': - image_url = item.bannerUrl if not image_url: return From b18c31f431571bb3246fdca1380edde26cd7dcba Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Fri, 15 Sep 2023 17:15:54 -0700 Subject: [PATCH 013/290] Update table right flow overflow --- data/interfaces/default/css/tautulli.css | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css index e256d2d7..8cad039f 100644 --- a/data/interfaces/default/css/tautulli.css +++ b/data/interfaces/default/css/tautulli.css @@ -2984,7 +2984,8 @@ a .home-platforms-list-cover-face:hover max-width: 900px; } .stacked-configs > li > span { - display: block; + display: inline-block; + width: inherit; padding: 8px 20px 8px 15px; color: #eee; border-left: 2px solid #444; From 0fa7553d97cbadabe4fd5f9cc7c21fd87659fb6c Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Fri, 15 Sep 2023 17:16:16 -0700 Subject: [PATCH 014/290] Fix right float cog icon on mobile devices table --- data/interfaces/default/mobile_devices_table.html | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/data/interfaces/default/mobile_devices_table.html b/data/interfaces/default/mobile_devices_table.html index e5363885..852fb2dd 100644 --- a/data/interfaces/default/mobile_devices_table.html +++ b/data/interfaces/default/mobile_devices_table.html @@ -28,15 +28,17 @@ DOCUMENTATION :: END % endif ${device['friendly_name'] or device['device_name']}  (${device['id']}) - - + % if device['last_seen']: - + + + % else: never % endif + From 982c893c4989e2733d7e38562c36c128556f908f Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Thu, 21 Sep 2023 12:16:01 -0700 Subject: [PATCH 015/290] Use helper function to cast play duration to int --- plexpy/datafactory.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py index 3db32a51..bd5a7c31 100644 --- a/plexpy/datafactory.py +++ b/plexpy/datafactory.py @@ -270,7 +270,7 @@ class DataFactory(object): item['user_thumb'] = users_lookup.get(item['user_id']) - filter_duration += int(item['play_duration']) + filter_duration += helpers.cast_to_int(item['play_duration']) if item['media_type'] == 'episode' and item['parent_thumb']: thumb = item['parent_thumb'] From 62be48df9c79d6b3de47d16578471290d2ef9206 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Mon, 9 Oct 2023 11:33:40 -0700 Subject: [PATCH 016/290] Change colour of max. concurrent stream series --- data/interfaces/default/graphs.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/interfaces/default/graphs.html b/data/interfaces/default/graphs.html index 8f16f59a..7cd0c98b 100644 --- a/data/interfaces/default/graphs.html +++ b/data/interfaces/default/graphs.html @@ -327,7 +327,7 @@ 'Direct Play': '#E5A00D', 'Direct Stream': '#FFFFFF', 'Transcode': '#F06464', - 'Max. Concurrent Streams': '#1014FC' + 'Max. Concurrent Streams': '#96C83C' }; var series_colors = []; $.each(data_series, function(index, series) { From fdc1dd3525ce752b05bb74147130a9f2cba2765a Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Mon, 9 Oct 2023 11:37:56 -0700 Subject: [PATCH 017/290] Add trigger time to notification and newsletter tables --- .../interfaces/default/newsletters_table.html | 25 +++++++++++++++---- data/interfaces/default/notifiers_table.html | 15 ++++++++++- data/interfaces/default/settings.html | 6 ++--- plexpy/newsletters.py | 15 ++++++++--- plexpy/notifiers.py | 14 ++++++++--- 5 files changed, 60 insertions(+), 15 deletions(-) diff --git a/data/interfaces/default/newsletters_table.html b/data/interfaces/default/newsletters_table.html index 5ceaf0a0..b2c4cb04 100644 --- a/data/interfaces/default/newsletters_table.html +++ b/data/interfaces/default/newsletters_table.html @@ -20,13 +20,28 @@ DOCUMENTATION :: END % else: ${newsletter['agent_label']}  (${newsletter['id']}) % endif - - + % if newsletter_handler.NEWSLETTER_SCHED.get_job('newsletter-{}'.format(newsletter['id'])): <% job = newsletter_handler.NEWSLETTER_SCHED.get_job('newsletter-{}'.format(newsletter['id'])) %> - + + + + % endif + % if newsletter['last_triggered']: + <% icon, icon_tooltip = ('fa-check', 'Success') if newsletter['last_success'] else ('fa-times', 'Failed') %> + + + + % else: + Last: never + % endif diff --git a/data/interfaces/default/notifiers_table.html b/data/interfaces/default/notifiers_table.html index d2bfa55e..1017f7f4 100644 --- a/data/interfaces/default/notifiers_table.html +++ b/data/interfaces/default/notifiers_table.html @@ -19,7 +19,20 @@ DOCUMENTATION :: END % else: ${notifier['agent_label']}  (${notifier['id']}) % endif - + + % if notifier['last_triggered']: + <% icon, icon_tooltip = ('fa-check', 'Success') if notifier['last_success'] else ('fa-times', 'Failed') %> + + + + % else: + never + + % endif % endfor diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html index c5d8fe37..6710ff79 100644 --- a/data/interfaces/default/settings.html +++ b/data/interfaces/default/settings.html @@ -1278,7 +1278,7 @@

- Add a new notification agent, or configure an existing notification agent by clicking the settings icon on the right. + Add a new notification agent, or configure an existing notification agent by clicking on the item below.

Please see the Notification Agents Guide for instructions on setting up each notification agent. @@ -1298,7 +1298,7 @@

- Add a new newsletter agent, or configure an existing newsletter agent by clicking the settings icon on the right. + Add a new newsletter agent, or configure an existing newsletter agent by clicking on the item below.

Warning: The Image Hosting setting must be enabled for images to display on the newsletter. @@ -1630,7 +1630,7 @@

-

Register a new device using a QR code, or configure an existing device by clicking the settings icon on the right.

+

Register a new device using a QR code, or configure an existing device by clicking on the item below.

Warning: The API must be enabled under Web Interface to use the app.


diff --git a/plexpy/newsletters.py b/plexpy/newsletters.py index 661a2b42..5fe8448c 100644 --- a/plexpy/newsletters.py +++ b/plexpy/newsletters.py @@ -119,13 +119,22 @@ def get_newsletters(newsletter_id=None): if newsletter_id: where = "WHERE " if newsletter_id: - where_id += "id = ?" + where_id += "newsletters.id = ?" args.append(newsletter_id) where += " AND ".join([w for w in [where_id] if w]) db = database.MonitorDatabase() - result = db.select("SELECT id, agent_id, agent_name, agent_label, " - "friendly_name, cron, active FROM newsletters %s" % where, args=args) + result = db.select( + ( + "SELECT newsletters.id, newsletters.agent_id, newsletters.agent_name, newsletters.agent_label, " + "newsletters.friendly_name, newsletters.cron, newsletters.active, " + "MAX(newsletter_log.timestamp) AS last_triggered, newsletter_log.success AS last_success " + "FROM newsletters " + "LEFT OUTER JOIN newsletter_log ON newsletters.id = newsletter_log.newsletter_id " + "%s " + "GROUP BY newsletters.id" + ) % where, args=args + ) return result diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py index ec8ad5b9..1e18644e 100644 --- a/plexpy/notifiers.py +++ b/plexpy/notifiers.py @@ -499,7 +499,7 @@ def get_notifiers(notifier_id=None, notify_action=None): if notifier_id or notify_action: where = 'WHERE ' if notifier_id: - where_id += 'id = ?' + where_id += 'notifiers.id = ?' args.append(notifier_id) if notify_action and notify_action in notify_actions: where_action = '%s = ?' % notify_action @@ -507,8 +507,16 @@ def get_notifiers(notifier_id=None, notify_action=None): where += ' AND '.join([w for w in [where_id, where_action] if w]) db = database.MonitorDatabase() - result = db.select("SELECT id, agent_id, agent_name, agent_label, friendly_name, %s FROM notifiers %s" - % (', '.join(notify_actions), where), args=args) + result = db.select( + ( + "SELECT notifiers.id, notifiers.agent_id, notifiers.agent_name, notifiers.agent_label, notifiers.friendly_name, %s, " + "MAX(notify_log.timestamp) AS last_triggered, notify_log.success AS last_success " + "FROM notifiers " + "LEFT OUTER JOIN notify_log ON notifiers.id = notify_log.notifier_id " + "%s " + "GROUP BY notifiers.id" + ) % (', '.join(notify_actions), where), args=args + ) for item in result: item['active'] = int(any([item.pop(k) for k in list(item.keys()) if k in notify_actions])) From aa4d98ee3406a330d8f30972c24635e4f539b8aa Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 10 Oct 2023 14:22:10 -0700 Subject: [PATCH 018/290] Bump plexapi from 4.15.0 to 4.15.4 (#2175) * Bump plexapi from 4.15.0 to 4.15.4 Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.15.0 to 4.15.4. - [Release notes](https://github.com/pkkid/python-plexapi/releases) - [Commits](https://github.com/pkkid/python-plexapi/compare/4.15.0...4.15.4) --- updated-dependencies: - dependency-name: plexapi dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] * Update plexapi==4.15.4 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/plexapi/__init__.py | 1 + lib/plexapi/alert.py | 19 +++---- lib/plexapi/audio.py | 19 +++++++ lib/plexapi/base.py | 11 +++-- lib/plexapi/client.py | 5 +- lib/plexapi/collection.py | 9 +++- lib/plexapi/config.py | 1 + lib/plexapi/const.py | 2 +- lib/plexapi/library.py | 33 +++++++------ lib/plexapi/media.py | 90 +++++++++++++++++++++++++-------- lib/plexapi/mixins.py | 22 ++++----- lib/plexapi/myplex.py | 80 ++++++++++++++++++++++++++---- lib/plexapi/photo.py | 15 +++++- lib/plexapi/playlist.py | 13 +++-- lib/plexapi/server.py | 54 +++++++++++++++----- lib/plexapi/sync.py | 1 - lib/plexapi/utils.py | 49 ++++++++++++------ lib/plexapi/video.py | 101 ++++++++++++++++++++++++++++++-------- requirements.txt | 2 +- 19 files changed, 399 insertions(+), 128 deletions(-) diff --git a/lib/plexapi/__init__.py b/lib/plexapi/__init__.py index eefc181d..1d4fb471 100644 --- a/lib/plexapi/__init__.py +++ b/lib/plexapi/__init__.py @@ -30,6 +30,7 @@ X_PLEX_VERSION = CONFIG.get('header.version', VERSION) X_PLEX_DEVICE = CONFIG.get('header.device', X_PLEX_PLATFORM) X_PLEX_DEVICE_NAME = CONFIG.get('header.device_name', uname()[1]) X_PLEX_IDENTIFIER = CONFIG.get('header.identifier', str(hex(getnode()))) +X_PLEX_LANGUAGE = CONFIG.get('header.language', 'en') BASE_HEADERS = reset_base_headers() # Logging Configuration diff --git a/lib/plexapi/alert.py b/lib/plexapi/alert.py index 79ecc445..2d6a18e8 100644 --- a/lib/plexapi/alert.py +++ b/lib/plexapi/alert.py @@ -1,5 +1,7 @@ # -*- coding: utf-8 -*- import json +import socket +from typing import Callable import threading from plexapi import log @@ -32,15 +34,17 @@ class AlertListener(threading.Thread): callbackError (func): Callback function to call on errors. The callback function will be sent a single argument 'error' which will contain the Error object. :samp:`def my_callback(error): ...` + ws_socket (socket): Socket to use for the connection. If not specified, a new socket will be created. """ key = '/:/websockets/notifications' - def __init__(self, server, callback=None, callbackError=None): + def __init__(self, server, callback: Callable = None, callbackError: Callable = None, ws_socket: socket = None): super(AlertListener, self).__init__() self.daemon = True self._server = server self._callback = callback self._callbackError = callbackError + self._socket = ws_socket self._ws = None def run(self): @@ -52,8 +56,9 @@ class AlertListener(threading.Thread): # create the websocket connection url = self._server.url(self.key, includeToken=True).replace('http', 'ws') log.info('Starting AlertListener: %s', url) - self._ws = websocket.WebSocketApp(url, on_message=self._onMessage, - on_error=self._onError) + + self._ws = websocket.WebSocketApp(url, on_message=self._onMessage, on_error=self._onError, socket=self._socket) + self._ws.run_forever() def stop(self): @@ -66,10 +71,8 @@ class AlertListener(threading.Thread): def _onMessage(self, *args): """ Called when websocket message is received. - In earlier releases, websocket-client returned a tuple of two parameters: a websocket.app.WebSocketApp - object and the message as a STR. Current releases appear to only return the message. + We are assuming the last argument in the tuple is the message. - This is to support compatibility with current and previous releases of websocket-client. """ message = args[-1] try: @@ -82,10 +85,8 @@ class AlertListener(threading.Thread): def _onError(self, *args): # pragma: no cover """ Called when websocket error is received. - In earlier releases, websocket-client returned a tuple of two parameters: a websocket.app.WebSocketApp - object and the error. Current releases appear to only return the error. + We are assuming the last argument in the tuple is the message. - This is to support compatibility with current and previous releases of websocket-client. """ err = args[-1] try: diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py index e1382760..2a169877 100644 --- a/lib/plexapi/audio.py +++ b/lib/plexapi/audio.py @@ -1,5 +1,6 @@ # -*- coding: utf-8 -*- import os +from pathlib import Path from urllib.parse import quote_plus from plexapi import media, utils @@ -240,6 +241,12 @@ class Artist( key = f'{self.key}?includeStations=1' return next(iter(self.fetchItems(key, cls=Playlist, rtag="Stations")), None) + @property + def metadataDirectory(self): + """ Returns the Plex Media Server data directory where the metadata is stored. """ + guid_hash = utils.sha1hash(self.guid) + return str(Path('Metadata') / 'Artists' / guid_hash[0] / f'{guid_hash[1:]}.bundle') + @utils.registerPlexObject class Album( @@ -359,6 +366,12 @@ class Album( """ Returns str, default title for a new syncItem. """ return f'{self.parentTitle} - {self.title}' + @property + def metadataDirectory(self): + """ Returns the Plex Media Server data directory where the metadata is stored. """ + guid_hash = utils.sha1hash(self.guid) + return str(Path('Metadata') / 'Albums' / guid_hash[0] / f'{guid_hash[1:]}.bundle') + @utils.registerPlexObject class Track( @@ -470,6 +483,12 @@ class Track( """ Get the Plex Web URL with the correct parameters. """ return self._server._buildWebURL(base=base, endpoint='details', key=self.parentKey) + @property + def metadataDirectory(self): + """ Returns the Plex Media Server data directory where the metadata is stored. """ + guid_hash = utils.sha1hash(self.parentGuid) + return str(Path('Metadata') / 'Albums' / guid_hash[0] / f'{guid_hash[1:]}.bundle') + @utils.registerPlexObject class TrackSession(PlexSession, Track): diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py index 88a31bbe..822e40ea 100644 --- a/lib/plexapi/base.py +++ b/lib/plexapi/base.py @@ -227,7 +227,7 @@ class PlexObject: fetchItem(ekey, viewCount__gte=0) fetchItem(ekey, Media__container__in=["mp4", "mkv"]) - fetchItem(ekey, guid__iregex=r"(imdb:\/\/|themoviedb:\/\/)") + fetchItem(ekey, guid__iregex=r"(imdb://|themoviedb://)") fetchItem(ekey, Media__Part__file__startswith="D:\\Movies") """ @@ -502,7 +502,7 @@ class PlexPartialObject(PlexObject): def __eq__(self, other): if isinstance(other, PlexPartialObject): - return other not in [None, []] and self.key == other.key + return self.key == other.key return NotImplemented def __hash__(self): @@ -626,7 +626,8 @@ class PlexPartialObject(PlexObject): return self def saveEdits(self): - """ Save all the batch edits and automatically reload the object. + """ Save all the batch edits. The object needs to be reloaded manually, + if required. See :func:`~plexapi.base.PlexPartialObject.batchEdits` for details. """ if not isinstance(self._edits, dict): @@ -635,7 +636,7 @@ class PlexPartialObject(PlexObject): edits = self._edits self._edits = None self._edit(**edits) - return self.reload() + return self def refresh(self): """ Refreshing a Library or individual item causes the metadata for the item to be @@ -919,7 +920,7 @@ class PlexSession(object): def stop(self, reason=''): """ Stop playback for the session. - + Parameters: reason (str): Message displayed to the user for stopping playback. """ diff --git a/lib/plexapi/client.py b/lib/plexapi/client.py index 2b4283c7..279b4974 100644 --- a/lib/plexapi/client.py +++ b/lib/plexapi/client.py @@ -70,6 +70,7 @@ class PlexClient(PlexObject): self._showSecrets = CONFIG.get('log.show_secrets', '').lower() == 'true' server_session = server._session if server else None self._session = session or server_session or requests.Session() + self._timeout = timeout or TIMEOUT self._proxyThroughServer = False self._commandId = 0 self._last_call = 0 @@ -94,7 +95,7 @@ class PlexClient(PlexObject): raise Unsupported('Cannot reload an object not built from a URL.') self._initpath = self.key data = self.query(self.key, timeout=timeout) - if not data: + if data is None: raise NotFound(f"Client not found at {self._baseurl}") if self._clientIdentifier: client = next( @@ -179,7 +180,7 @@ class PlexClient(PlexObject): """ url = self.url(path) method = method or self._session.get - timeout = timeout or TIMEOUT + timeout = timeout or self._timeout log.debug('%s %s', method.__name__.upper(), url) headers = self._headers(**headers or {}) response = method(url, headers=headers, timeout=timeout, **kwargs) diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py index d4820fe2..8bc5f286 100644 --- a/lib/plexapi/collection.py +++ b/lib/plexapi/collection.py @@ -1,4 +1,5 @@ # -*- coding: utf-8 -*- +from pathlib import Path from urllib.parse import quote_plus from plexapi import media, utils @@ -399,7 +400,7 @@ class Collection( @deprecated('use editTitle, editSortTitle, editContentRating, and editSummary instead') def edit(self, title=None, titleSort=None, contentRating=None, summary=None, **kwargs): """ Edit the collection. - + Parameters: title (str, optional): The title of the collection. titleSort (str, optional): The sort title of the collection. @@ -560,3 +561,9 @@ class Collection( raise Unsupported('Unsupported collection content') return myplex.sync(sync_item, client=client, clientId=clientId) + + @property + def metadataDirectory(self): + """ Returns the Plex Media Server data directory where the metadata is stored. """ + guid_hash = utils.sha1hash(self.guid) + return str(Path('Metadata') / 'Collections' / guid_hash[0] / f'{guid_hash[1:]}.bundle') diff --git a/lib/plexapi/config.py b/lib/plexapi/config.py index 8bbf1f31..5cfa74c8 100644 --- a/lib/plexapi/config.py +++ b/lib/plexapi/config.py @@ -63,6 +63,7 @@ def reset_base_headers(): 'X-Plex-Device': plexapi.X_PLEX_DEVICE, 'X-Plex-Device-Name': plexapi.X_PLEX_DEVICE_NAME, 'X-Plex-Client-Identifier': plexapi.X_PLEX_IDENTIFIER, + 'X-Plex-Language': plexapi.X_PLEX_LANGUAGE, 'X-Plex-Sync-Version': '2', 'X-Plex-Features': 'external-media', } diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py index df86ff5d..8a172e98 100644 --- a/lib/plexapi/const.py +++ b/lib/plexapi/const.py @@ -4,6 +4,6 @@ # Library version MAJOR_VERSION = 4 MINOR_VERSION = 15 -PATCH_VERSION = 0 +PATCH_VERSION = 4 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}" __version__ = f"{__short_version__}.{PATCH_VERSION}" diff --git a/lib/plexapi/library.py b/lib/plexapi/library.py index cbca4246..87d59eac 100644 --- a/lib/plexapi/library.py +++ b/lib/plexapi/library.py @@ -542,7 +542,7 @@ class LibrarySection(PlexObject): def addLocations(self, location): """ Add a location to a library. - + Parameters: location (str or list): A single folder path, list of paths. @@ -565,7 +565,7 @@ class LibrarySection(PlexObject): def removeLocations(self, location): """ Remove a location from a library. - + Parameters: location (str or list): A single folder path, list of paths. @@ -744,7 +744,7 @@ class LibrarySection(PlexObject): def lockAllField(self, field, libtype=None): """ Lock a field for all items in the library. - + Parameters: field (str): The field to lock (e.g. thumb, rating, collection). libtype (str, optional): The library type to lock (movie, show, season, episode, @@ -754,7 +754,7 @@ class LibrarySection(PlexObject): def unlockAllField(self, field, libtype=None): """ Unlock a field for all items in the library. - + Parameters: field (str): The field to unlock (e.g. thumb, rating, collection). libtype (str, optional): The library type to lock (movie, show, season, episode, @@ -847,7 +847,7 @@ class LibrarySection(PlexObject): """ _key = ('/library/sections/{key}/{filter}?includeMeta=1&includeAdvanced=1' '&X-Plex-Container-Start=0&X-Plex-Container-Size=0') - + key = _key.format(key=self.key, filter='all') data = self._server.query(key) self._filterTypes = self.findItems(data, FilteringType, rtag='Meta') @@ -894,7 +894,7 @@ class LibrarySection(PlexObject): def getFieldType(self, fieldType): """ Returns a :class:`~plexapi.library.FilteringFieldType` for a specified fieldType. - + Parameters: fieldType (str): The data type for the field (tag, integer, string, boolean, date, subtitleLanguage, audioLanguage, resolution). @@ -927,7 +927,7 @@ class LibrarySection(PlexObject): """ return self.getFilterType(libtype).filters - + def listSorts(self, libtype=None): """ Returns a list of available :class:`~plexapi.library.FilteringSort` for a specified libtype. This is the list of options in the sorting dropdown menu @@ -970,7 +970,7 @@ class LibrarySection(PlexObject): """ Returns a list of available :class:`~plexapi.library.FilteringOperator` for a specified fieldType. This is the list of options in the custom filter operator dropdown menu (`screenshot <../_static/images/LibrarySection.search.png>`__). - + Parameters: fieldType (str): The data type for the field (tag, integer, string, boolean, date, subtitleLanguage, audioLanguage, resolution). @@ -992,7 +992,7 @@ class LibrarySection(PlexObject): :class:`~plexapi.library.FilteringFilter` or filter field. This is the list of available values for a custom filter (`screenshot <../_static/images/LibrarySection.search.png>`__). - + Parameters: field (str): :class:`~plexapi.library.FilteringFilter` object, or the name of the field (genre, year, contentRating, etc.). @@ -1024,7 +1024,7 @@ class LibrarySection(PlexObject): availableFilters = [f.filter for f in self.listFilters(libtype)] raise NotFound(f'Unknown filter field "{field}" for libtype "{libtype}". ' f'Available filters: {availableFilters}') from None - + data = self._server.query(field.key) return self.findItems(data, FilterChoice) @@ -1111,7 +1111,7 @@ class LibrarySection(PlexObject): except (ValueError, AttributeError): raise BadRequest(f'Invalid value "{value}" for filter field "{filterField.key}", ' f'value should be type {fieldType.type}') from None - + return results def _validateFieldValueDate(self, value): @@ -1345,7 +1345,7 @@ class LibrarySection(PlexObject): Tag type filter values can be a :class:`~plexapi.library.FilterChoice` object, :class:`~plexapi.media.MediaTag` object, the exact name :attr:`MediaTag.tag` (*str*), or the exact id :attr:`MediaTag.id` (*int*). - + Date type filter values can be a ``datetime`` object, a relative date using a one of the available date suffixes (e.g. ``30d``) (*str*), or a date in ``YYYY-MM-DD`` (*str*) format. @@ -1358,7 +1358,7 @@ class LibrarySection(PlexObject): * ``w``: ``weeks`` * ``mon``: ``months`` * ``y``: ``years`` - + Multiple values can be ``OR`` together by providing a list of values. Examples: @@ -1684,12 +1684,12 @@ class LibrarySection(PlexObject): def _validateItems(self, items): """ Validates the specified items are from this library and of the same type. """ - if not items: + if items is None or items == []: raise BadRequest('No items specified.') - + if not isinstance(items, list): items = [items] - + itemType = items[0].type for item in items: if item.librarySectionID != self.key: @@ -3102,6 +3102,7 @@ class FirstCharacter(PlexObject): size (str): Total amount of library items starting with this character. title (str): Character (#, !, A, B, C, ...). """ + def _loadData(self, data): """ Load attribute values from Plex XML response. """ self._data = data diff --git a/lib/plexapi/media.py b/lib/plexapi/media.py index 8793463f..369bb759 100644 --- a/lib/plexapi/media.py +++ b/lib/plexapi/media.py @@ -1,6 +1,6 @@ # -*- coding: utf-8 -*- - import xml +from pathlib import Path from urllib.parse import quote_plus from plexapi import log, settings, utils @@ -121,6 +121,7 @@ class MediaPart(PlexObject): optimizedForStreaming (bool): True if the file is optimized for streaming. packetLength (int): The packet length of the file. requiredBandwidths (str): The required bandwidths to stream the file. + selected (bool): True if this media part is selected. size (int): The size of the file in bytes (ex: 733884416). streams (List<:class:`~plexapi.media.MediaPartStream`>): List of stream objects. syncItemId (int): The unique ID for this media part if it is synced. @@ -184,38 +185,60 @@ class MediaPart(PlexObject): """ Returns a list of :class:`~plexapi.media.LyricStream` objects in this MediaPart. """ return [stream for stream in self.streams if isinstance(stream, LyricStream)] - def setDefaultAudioStream(self, stream): - """ Set the default :class:`~plexapi.media.AudioStream` for this MediaPart. + def setSelectedAudioStream(self, stream): + """ Set the selected :class:`~plexapi.media.AudioStream` for this MediaPart. Parameters: - stream (:class:`~plexapi.media.AudioStream`): AudioStream to set as default + stream (:class:`~plexapi.media.AudioStream`): Audio stream to set as selected """ + key = f'/library/parts/{self.id}' + params = {'allParts': 1} + if isinstance(stream, AudioStream): - key = f"/library/parts/{self.id}?audioStreamID={stream.id}&allParts=1" + params['audioStreamID'] = stream.id else: - key = f"/library/parts/{self.id}?audioStreamID={stream}&allParts=1" - self._server.query(key, method=self._server._session.put) + params['audioStreamID'] = stream + + self._server.query(key, method=self._server._session.put, params=params) return self - def setDefaultSubtitleStream(self, stream): - """ Set the default :class:`~plexapi.media.SubtitleStream` for this MediaPart. + def setSelectedSubtitleStream(self, stream): + """ Set the selected :class:`~plexapi.media.SubtitleStream` for this MediaPart. Parameters: - stream (:class:`~plexapi.media.SubtitleStream`): SubtitleStream to set as default. + stream (:class:`~plexapi.media.SubtitleStream`): Subtitle stream to set as selected. """ + key = f'/library/parts/{self.id}' + params = {'allParts': 1} + if isinstance(stream, SubtitleStream): - key = f"/library/parts/{self.id}?subtitleStreamID={stream.id}&allParts=1" + params['subtitleStreamID'] = stream.id else: - key = f"/library/parts/{self.id}?subtitleStreamID={stream}&allParts=1" + params['subtitleStreamID'] = stream + self._server.query(key, method=self._server._session.put) return self - def resetDefaultSubtitleStream(self): - """ Set default subtitle of this MediaPart to 'none'. """ - key = f"/library/parts/{self.id}?subtitleStreamID=0&allParts=1" - self._server.query(key, method=self._server._session.put) + def resetSelectedSubtitleStream(self): + """ Set the selected subtitle of this MediaPart to 'None'. """ + key = f'/library/parts/{self.id}' + params = {'subtitleStreamID': 0, 'allParts': 1} + + self._server.query(key, method=self._server._session.put, params=params) return self + @deprecated('Use "setSelectedAudioStream" instead.') + def setDefaultAudioStream(self, stream): + return self.setSelectedAudioStream(stream) + + @deprecated('Use "setSelectedSubtitleStream" instead.') + def setDefaultSubtitleStream(self, stream): + return self.setSelectedSubtitleStream(stream) + + @deprecated('Use "resetSelectedSubtitleStream" instead.') + def resetDefaultSubtitleStream(self): + return self.resetSelectedSubtitleStream() + class MediaPartStream(PlexObject): """ Base class for media streams. These consist of video, audio, subtitles, and lyrics. @@ -399,9 +422,15 @@ class AudioStream(MediaPartStream): self.peak = utils.cast(float, data.attrib.get('peak')) self.startRamp = data.attrib.get('startRamp') + def setSelected(self): + """ Sets this audio stream as the selected audio stream. + Alias for :func:`~plexapi.media.MediaPart.setSelectedAudioStream`. + """ + return self._parent().setSelectedAudioStream(self) + + @deprecated('Use "setSelected" instead.') def setDefault(self): - """ Sets this audio stream as the default audio stream. """ - return self._parent().setDefaultAudioStream(self) + return self.setSelected() @utils.registerPlexObject @@ -437,9 +466,15 @@ class SubtitleStream(MediaPartStream): self.transient = data.attrib.get('transient') self.userID = utils.cast(int, data.attrib.get('userID')) + def setSelected(self): + """ Sets this subtitle stream as the selected subtitle stream. + Alias for :func:`~plexapi.media.MediaPart.setSelectedSubtitleStream`. + """ + return self._parent().setSelectedSubtitleStream(self) + + @deprecated('Use "setSelected" instead.') def setDefault(self): - """ Sets this subtitle stream as the default subtitle stream. """ - return self._parent().setDefaultSubtitleStream(self) + return self.setSelected() class LyricStream(MediaPartStream): @@ -973,6 +1008,7 @@ class BaseResource(PlexObject): selected (bool): True if the resource is currently selected. thumb (str): The URL to retrieve the resource thumbnail. """ + def _loadData(self, data): self._data = data self.key = data.attrib.get('key') @@ -989,6 +1025,20 @@ class BaseResource(PlexObject): except xml.etree.ElementTree.ParseError: pass + @property + def resourceFilepath(self): + """ Returns the file path to the resource in the Plex Media Server data directory. + Note: Returns the URL if the resource is not stored locally. + """ + if self.ratingKey.startswith('media://'): + return str(Path('Media') / 'localhost' / self.ratingKey.split('://')[-1]) + elif self.ratingKey.startswith('metadata://'): + return str(Path(self._parent().metadataDirectory) / 'Contents' / '_combined' / self.ratingKey.split('://')[-1]) + elif self.ratingKey.startswith('upload://'): + return str(Path(self._parent().metadataDirectory) / 'Uploads' / self.ratingKey.split('://')[-1]) + else: + return self.ratingKey + class Art(BaseResource): """ Represents a single Art object. """ diff --git a/lib/plexapi/mixins.py b/lib/plexapi/mixins.py index f0c21cfe..e1cce54b 100644 --- a/lib/plexapi/mixins.py +++ b/lib/plexapi/mixins.py @@ -39,7 +39,7 @@ class AdvancedSettingsMixin: pref = preferences[settingID] except KeyError: raise NotFound(f'{value} not found in {list(preferences.keys())}') - + enumValues = pref.enumValues if enumValues.get(value, enumValues.get(str(value))): data[settingID] = value @@ -69,7 +69,7 @@ class SmartFilterMixin: filters = {} filterOp = 'and' filterGroups = [[]] - + for key, value in parse_qsl(content.query): # Move = sign to key when operator is == if value.startswith('='): @@ -96,11 +96,11 @@ class SmartFilterMixin: filterGroups.pop() else: filterGroups[-1].append({key: value}) - + if filterGroups: filters['filters'] = self._formatFilterGroups(filterGroups.pop()) return filters - + def _formatFilterGroups(self, groups): """ Formats the filter groups into the advanced search rules. """ if len(groups) == 1 and isinstance(groups[0], list): @@ -131,7 +131,7 @@ class SplitMergeMixin: def merge(self, ratingKeys): """ Merge other Plex objects into the current object. - + Parameters: ratingKeys (list): A list of rating keys to merge. """ @@ -320,7 +320,7 @@ class RatingMixin: class ArtUrlMixin: """ Mixin for Plex objects that can have a background artwork url. """ - + @property def artUrl(self): """ Return the art url for the Plex object. """ @@ -349,7 +349,7 @@ class ArtMixin(ArtUrlMixin, ArtLockMixin): def uploadArt(self, url=None, filepath=None): """ Upload a background artwork from a url or filepath. - + Parameters: url (str): The full URL to the image to upload. filepath (str): The full file path the the image to upload or file-like object. @@ -365,7 +365,7 @@ class ArtMixin(ArtUrlMixin, ArtLockMixin): def setArt(self, art): """ Set the background artwork for a Plex object. - + Parameters: art (:class:`~plexapi.media.Art`): The art object to select. """ @@ -425,7 +425,7 @@ class PosterMixin(PosterUrlMixin, PosterLockMixin): def setPoster(self, poster): """ Set the poster for a Plex object. - + Parameters: poster (:class:`~plexapi.media.Poster`): The poster object to select. """ @@ -491,11 +491,11 @@ class ThemeMixin(ThemeUrlMixin, ThemeLockMixin): class EditFieldMixin: """ Mixin for editing Plex object fields. """ - + def editField(self, field, value, locked=True, **kwargs): """ Edit the field of a Plex object. All field editing methods can be chained together. Also see :func:`~plexapi.base.PlexPartialObject.batchEdits` for batch editing fields. - + Parameters: field (str): The name of the field to edit. value (str): The value to edit the field to. diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py index c90b5d33..ede2276d 100644 --- a/lib/plexapi/myplex.py +++ b/lib/plexapi/myplex.py @@ -111,12 +111,14 @@ class MyPlexAccount(PlexObject): # Hub sections VOD = 'https://vod.provider.plex.tv' # get MUSIC = 'https://music.provider.plex.tv' # get + DISCOVER = 'https://discover.provider.plex.tv' METADATA = 'https://metadata.provider.plex.tv' key = 'https://plex.tv/api/v2/user' def __init__(self, username=None, password=None, token=None, session=None, timeout=None, code=None, remember=True): self._token = logfilter.add_secret(token or CONFIG.get('auth.server_token')) self._session = session or requests.Session() + self._timeout = timeout or TIMEOUT self._sonos_cache = [] self._sonos_cache_timestamp = 0 data, initpath = self._signin(username, password, code, remember, timeout) @@ -186,7 +188,9 @@ class MyPlexAccount(PlexObject): self.subscriptionPaymentService = subscription.attrib.get('paymentService') self.subscriptionPlan = subscription.attrib.get('plan') self.subscriptionStatus = subscription.attrib.get('status') - self.subscriptionSubscribedAt = utils.toDatetime(subscription.attrib.get('subscribedAt'), '%Y-%m-%d %H:%M:%S %Z') + self.subscriptionSubscribedAt = utils.toDatetime( + subscription.attrib.get('subscribedAt') or None, '%Y-%m-%d %H:%M:%S %Z' + ) profile = data.find('profile') self.profileAutoSelectAudio = utils.cast(bool, profile.attrib.get('autoSelectAudio')) @@ -223,7 +227,7 @@ class MyPlexAccount(PlexObject): def query(self, url, method=None, headers=None, timeout=None, **kwargs): method = method or self._session.get - timeout = timeout or TIMEOUT + timeout = timeout or self._timeout log.debug('%s %s %s', method.__name__.upper(), url, kwargs.get('json', '')) headers = self._headers(**headers or {}) response = method(url, headers=headers, timeout=timeout, **kwargs) @@ -239,8 +243,10 @@ class MyPlexAccount(PlexObject): raise Unauthorized(message) else: raise BadRequest(message) - if headers.get('Accept') == 'application/json': + if 'application/json' in response.headers.get('Content-Type', ''): return response.json() + elif 'text/plain' in response.headers.get('Content-Type', ''): + return response.text.strip() data = response.text.encode('utf8') return ElementTree.fromstring(data) if data.strip() else None @@ -672,7 +678,7 @@ class MyPlexAccount(PlexObject): if (invite.username and invite.email and invite.id and username.lower() in (invite.username.lower(), invite.email.lower(), str(invite.id))): return invite - + raise NotFound(f'Unable to find invite {username}') def pendingInvites(self, includeSent=True, includeReceived=True): @@ -950,7 +956,7 @@ class MyPlexAccount(PlexObject): """ if not isinstance(items, list): items = [items] - + for item in items: if self.onWatchlist(item): raise BadRequest(f'"{item.title}" is already on the watchlist') @@ -971,7 +977,7 @@ class MyPlexAccount(PlexObject): """ if not isinstance(items, list): items = [items] - + for item in items: if not self.onWatchlist(item): raise BadRequest(f'"{item.title}" is not on the watchlist') @@ -1053,7 +1059,7 @@ class MyPlexAccount(PlexObject): 'includeMetadata': 1 } - data = self.query(f'{self.METADATA}/library/search', headers=headers, params=params) + data = self.query(f'{self.DISCOVER}/library/search', headers=headers, params=params) searchResults = data['MediaContainer'].get('SearchResults', []) searchResult = next((s.get('SearchResult', []) for s in searchResults if s.get('id') == 'external'), []) @@ -1135,6 +1141,21 @@ class MyPlexAccount(PlexObject): return objs + def publicIP(self): + """ Returns your public IP address. """ + return self.query('https://plex.tv/:/ip') + + def geoip(self, ip_address): + """ Returns a :class:`~plexapi.myplex.GeoLocation` object with geolocation information + for an IP address using Plex's GeoIP database. + + Parameters: + ip_address (str): IP address to lookup. + """ + params = {'ip_address': ip_address} + data = self.query('https://plex.tv/api/v2/geoip', params=params) + return GeoLocation(self, data) + class MyPlexUser(PlexObject): """ This object represents non-signed in users such as friends and linked @@ -1773,7 +1794,7 @@ class MyPlexPinLogin: params = None response = self._query(url, self._session.post, params=params) - if not response: + if response is None: return None self._id = response.attrib.get('id') @@ -1790,7 +1811,7 @@ class MyPlexPinLogin: url = self.CHECKPINS.format(pinid=self._id) response = self._query(url) - if not response: + if response is None: return False token = response.attrib.get('authToken') @@ -1927,7 +1948,7 @@ class AccountOptOut(PlexObject): def optOutManaged(self): """ Sets the Online Media Source to "Disabled for Managed Users". - + Raises: :exc:`~plexapi.exceptions.BadRequest`: When trying to opt out music. """ @@ -1964,3 +1985,42 @@ class UserState(PlexObject): self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0)) self.viewState = data.attrib.get('viewState') == 'complete' self.watchlistedAt = utils.toDatetime(data.attrib.get('watchlistedAt')) + + +class GeoLocation(PlexObject): + """ Represents a signle IP address geolocation + + Attributes: + TAG (str): location + city (str): City name + code (str): Country code + continentCode (str): Continent code + coordinates (Tuple): Latitude and longitude + country (str): Country name + europeanUnionMember (bool): True if the country is a member of the European Union + inPrivacyRestrictedCountry (bool): True if the country is privacy restricted + postalCode (str): Postal code + subdivisions (str): Subdivision name + timezone (str): Timezone + """ + TAG = 'location' + + def _loadData(self, data): + self._data = data + self.city = data.attrib.get('city') + self.code = data.attrib.get('code') + self.continentCode = data.attrib.get('continent_code') + self.coordinates = tuple( + utils.cast(float, coord) for coord in (data.attrib.get('coordinates') or ',').split(',')) + self.country = data.attrib.get('country') + self.postalCode = data.attrib.get('postal_code') + self.subdivisions = data.attrib.get('subdivisions') + self.timezone = data.attrib.get('time_zone') + + europeanUnionMember = data.attrib.get('european_union_member') + self.europeanUnionMember = ( + False if europeanUnionMember == 'Unknown' else utils.cast(bool, europeanUnionMember)) + + inPrivacyRestrictedCountry = data.attrib.get('in_privacy_restricted_country') + self.inPrivacyRestrictedCountry = ( + False if inPrivacyRestrictedCountry == 'Unknown' else utils.cast(bool, inPrivacyRestrictedCountry)) diff --git a/lib/plexapi/photo.py b/lib/plexapi/photo.py index 039ac80c..8737d814 100644 --- a/lib/plexapi/photo.py +++ b/lib/plexapi/photo.py @@ -1,5 +1,6 @@ # -*- coding: utf-8 -*- import os +from pathlib import Path from urllib.parse import quote_plus from plexapi import media, utils, video @@ -139,6 +140,12 @@ class Photoalbum( """ Get the Plex Web URL with the correct parameters. """ return self._server._buildWebURL(base=base, endpoint='details', key=self.key, legacy=1) + @property + def metadataDirectory(self): + """ Returns the Plex Media Server data directory where the metadata is stored. """ + guid_hash = utils.sha1hash(self.guid) + return str(Path('Metadata') / 'Photos' / guid_hash[0] / f'{guid_hash[1:]}.bundle') + @utils.registerPlexObject class Photo( @@ -249,7 +256,7 @@ class Photo( List of file paths where the photo is found on disk. """ return [part.file for item in self.media for part in item.parts if part] - + def sync(self, resolution, client=None, clientId=None, limit=None, title=None): """ Add current photo as sync item for specified device. See :func:`~plexapi.myplex.MyPlexAccount.sync` for possible exceptions. @@ -290,6 +297,12 @@ class Photo( """ Get the Plex Web URL with the correct parameters. """ return self._server._buildWebURL(base=base, endpoint='details', key=self.parentKey, legacy=1) + @property + def metadataDirectory(self): + """ Returns the Plex Media Server data directory where the metadata is stored. """ + guid_hash = utils.sha1hash(self.parentGuid) + return str(Path('Metadata') / 'Photos' / guid_hash[0] / f'{guid_hash[1:]}.bundle') + @utils.registerPlexObject class PhotoSession(PlexSession, Photo): diff --git a/lib/plexapi/playlist.py b/lib/plexapi/playlist.py index c435613a..44073ee7 100644 --- a/lib/plexapi/playlist.py +++ b/lib/plexapi/playlist.py @@ -1,5 +1,6 @@ # -*- coding: utf-8 -*- import re +from pathlib import Path from urllib.parse import quote_plus, unquote from plexapi import media, utils @@ -154,7 +155,7 @@ class Playlist( sectionKey = int(match.group(1)) self._section = self._server.library.sectionByID(sectionKey) return self._section - + # Try to get the library section from the first item in the playlist if self.items(): self._section = self.items()[0].section() @@ -313,7 +314,7 @@ class Playlist( def edit(self, title=None, summary=None): """ Edit the playlist. - + Parameters: title (str, optional): The title of the playlist. summary (str, optional): The summary of the playlist. @@ -431,7 +432,7 @@ class Playlist( def copyToUser(self, user): """ Copy playlist to another user account. - + Parameters: user (:class:`~plexapi.myplex.MyPlexUser` or str): `MyPlexUser` object, username, email, or user id of the user to copy the playlist to. @@ -496,3 +497,9 @@ class Playlist( def _getWebURL(self, base=None): """ Get the Plex Web URL with the correct parameters. """ return self._server._buildWebURL(base=base, endpoint='playlist', key=self.key) + + @property + def metadataDirectory(self): + """ Returns the Plex Media Server data directory where the metadata is stored. """ + guid_hash = utils.sha1hash(self.guid) + return str(Path('Metadata') / 'Playlists' / guid_hash[0] / f'{guid_hash[1:]}.bundle') diff --git a/lib/plexapi/server.py b/lib/plexapi/server.py index 69d5f89a..52a203a8 100644 --- a/lib/plexapi/server.py +++ b/lib/plexapi/server.py @@ -109,7 +109,7 @@ class PlexServer(PlexObject): self._token = logfilter.add_secret(token or CONFIG.get('auth.server_token')) self._showSecrets = CONFIG.get('log.show_secrets', '').lower() == 'true' self._session = session or requests.Session() - self._timeout = timeout + self._timeout = timeout or TIMEOUT self._myPlexAccount = None # cached myPlexAccount self._systemAccounts = None # cached list of SystemAccount self._systemDevices = None # cached list of SystemDevice @@ -189,6 +189,11 @@ class PlexServer(PlexObject): data = self.query(Settings.key) return Settings(self, data) + def identity(self): + """ Returns the Plex server identity. """ + data = self.query('/identity') + return Identity(self, data) + def account(self): """ Returns the :class:`~plexapi.server.Account` object this server belongs to. """ data = self.query(Account.key) @@ -197,7 +202,7 @@ class PlexServer(PlexObject): def claim(self, account): """ Claim the Plex server using a :class:`~plexapi.myplex.MyPlexAccount`. This will only work with an unclaimed server on localhost or the same subnet. - + Parameters: account (:class:`~plexapi.myplex.MyPlexAccount`): The account used to claim the server. @@ -240,7 +245,7 @@ class PlexServer(PlexObject): def switchUser(self, user, session=None, timeout=None): """ Returns a new :class:`~plexapi.server.PlexServer` object logged in as the given username. Note: Only the admin account can switch to other users. - + Parameters: user (:class:`~plexapi.myplex.MyPlexUser` or str): `MyPlexUser` object, username, email, or user id of the user to log in to the server. @@ -585,7 +590,7 @@ class PlexServer(PlexObject): def runButlerTask(self, task): """ Manually run a butler task immediately instead of waiting for the scheduled task to run. Note: The butler task is run asynchronously. Check Plex Web to monitor activity. - + Parameters: task (str): The name of the task to run. (e.g. 'BackupDatabase') @@ -597,7 +602,7 @@ class PlexServer(PlexObject): print("Available butler tasks:", availableTasks) """ - validTasks = [task.name for task in self.butlerTasks()] + validTasks = [_task.name for _task in self.butlerTasks()] if task not in validTasks: raise BadRequest( f'Invalid butler task: {task}. Available tasks are: {validTasks}' @@ -610,7 +615,8 @@ class PlexServer(PlexObject): return self.checkForUpdate(force=force, download=download) def checkForUpdate(self, force=True, download=False): - """ Returns a :class:`~plexapi.base.Release` object containing release info. + """ Returns a :class:`~plexapi.server.Release` object containing release info + if an update is available or None if no update is available. Parameters: force (bool): Force server to check for new releases @@ -624,12 +630,19 @@ class PlexServer(PlexObject): return releases[0] def isLatest(self): - """ Check if the installed version of PMS is the latest. """ + """ Returns True if the installed version of Plex Media Server is the latest. """ release = self.checkForUpdate(force=True) return release is None + def canInstallUpdate(self): + """ Returns True if the newest version of Plex Media Server can be installed automatically. + (e.g. Windows and Mac can install updates automatically, but Docker and NAS devices cannot.) + """ + release = self.query('/updater/status') + return utils.cast(bool, release.get('canInstall')) + def installUpdate(self): - """ Install the newest version of Plex Media Server. """ + """ Automatically install the newest version of Plex Media Server. """ # We can add this but dunno how useful this is since it sometimes # requires user action using a gui. part = '/updater/apply' @@ -661,7 +674,7 @@ class PlexServer(PlexObject): args['librarySectionID'] = librarySectionID if mindate: args['viewedAt>'] = int(mindate.timestamp()) - + key = f'/status/sessions/history/all{utils.joinArgs(args)}' return self.fetchItems(key, maxresults=maxresults) @@ -741,7 +754,7 @@ class PlexServer(PlexObject): """ url = self.url(key) method = method or self._session.get - timeout = timeout or TIMEOUT + timeout = timeout or self._timeout log.debug('%s %s', method.__name__.upper(), url) headers = self._headers(**headers or {}) response = method(url, headers=headers, timeout=timeout, **kwargs) @@ -1253,7 +1266,7 @@ class StatisticsResources(PlexObject): @utils.registerPlexObject class ButlerTask(PlexObject): """ Represents a single scheduled butler task. - + Attributes: TAG (str): 'ButlerTask' description (str): The description of the task. @@ -1273,3 +1286,22 @@ class ButlerTask(PlexObject): self.name = data.attrib.get('name') self.scheduleRandomized = utils.cast(bool, data.attrib.get('scheduleRandomized')) self.title = data.attrib.get('title') + + +class Identity(PlexObject): + """ Represents a server identity. + + Attributes: + claimed (bool): True or False if the server is claimed. + machineIdentifier (str): The Plex server machine identifier. + version (str): The Plex server version. + """ + + def __repr__(self): + return f"<{self.__class__.__name__}:{self.machineIdentifier}>" + + def _loadData(self, data): + self._data = data + self.claimed = utils.cast(bool, data.attrib.get('claimed')) + self.machineIdentifier = data.attrib.get('machineIdentifier') + self.version = data.attrib.get('version') diff --git a/lib/plexapi/sync.py b/lib/plexapi/sync.py index 66468c30..f57e89d9 100644 --- a/lib/plexapi/sync.py +++ b/lib/plexapi/sync.py @@ -23,7 +23,6 @@ you can set items to be synced to your app) you need to init some variables. You have to fake platform/device/model because transcoding profiles are hardcoded in Plex, and you obviously have to explicitly specify that your app supports `sync-target`. """ - import requests import plexapi diff --git a/lib/plexapi/utils.py b/lib/plexapi/utils.py index d1882fbb..8478f2d4 100644 --- a/lib/plexapi/utils.py +++ b/lib/plexapi/utils.py @@ -11,13 +11,14 @@ import unicodedata import warnings import zipfile from collections import deque -from datetime import datetime +from datetime import datetime, timedelta from getpass import getpass +from hashlib import sha1 from threading import Event, Thread from urllib.parse import quote -from requests.status_codes import _codes as codes import requests +from requests.status_codes import _codes as codes from plexapi.exceptions import BadRequest, NotFound, Unauthorized @@ -313,33 +314,44 @@ def toDatetime(value, format=None): value (str): value to return as a datetime format (str): Format to pass strftime (optional; if value is a str). """ - if value and value is not None: + if value is not None: if format: try: - value = datetime.strptime(value, format) + return datetime.strptime(value, format) except ValueError: - log.info('Failed to parse %s to datetime, defaulting to None', value) + log.info('Failed to parse "%s" to datetime as format "%s", defaulting to None', value, format) return None else: - # https://bugs.python.org/issue30684 - # And platform support for before epoch seems to be flaky. - # Also limit to max 32-bit integer - value = min(max(int(value), 86400), 2**31 - 1) - value = datetime.fromtimestamp(int(value)) + try: + value = int(value) + except ValueError: + log.info('Failed to parse "%s" to datetime as timestamp, defaulting to None', value) + return None + try: + return datetime.fromtimestamp(value) + except (OSError, OverflowError): + try: + return datetime.fromtimestamp(0) + timedelta(seconds=value) + except OverflowError: + log.info('Failed to parse "%s" to datetime as timestamp (out-of-bounds), defaulting to None', value) + return None return value def millisecondToHumanstr(milliseconds): - """ Returns human readable time duration from milliseconds. - HH:MM:SS:MMMM + """ Returns human readable time duration [D day[s], ]HH:MM:SS.UUU from milliseconds. Parameters: - milliseconds (str,int): time duration in milliseconds. + milliseconds (str, int): time duration in milliseconds. """ milliseconds = int(milliseconds) - r = datetime.utcfromtimestamp(milliseconds / 1000) - f = r.strftime("%H:%M:%S.%f") - return f[:-2] + if milliseconds < 0: + return '-' + millisecondToHumanstr(abs(milliseconds)) + secs, ms = divmod(milliseconds, 1000) + mins, secs = divmod(secs, 60) + hours, mins = divmod(mins, 60) + days, hours = divmod(hours, 24) + return ('' if days == 0 else f'{days} day{"s" if days > 1 else ""}, ') + f'{hours:02d}:{mins:02d}:{secs:02d}.{ms:03d}' def toList(value, itemcast=None, delim=','): @@ -644,3 +656,8 @@ def openOrRead(file): return file.read() with open(file, 'rb') as f: return f.read() + + +def sha1hash(guid): + """ Return the SHA1 hash of a guid. """ + return sha1(guid.encode('utf-8')).hexdigest() diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py index 486bb5ca..e95b12ff 100644 --- a/lib/plexapi/video.py +++ b/lib/plexapi/video.py @@ -1,5 +1,7 @@ # -*- coding: utf-8 -*- import os +from functools import cached_property +from pathlib import Path from urllib.parse import quote_plus from plexapi import media, utils @@ -445,6 +447,12 @@ class Movie( self._server.query(key, params=params, method=self._server._session.put) return self + @property + def metadataDirectory(self): + """ Returns the Plex Media Server data directory where the metadata is stored. """ + guid_hash = utils.sha1hash(self.guid) + return str(Path('Metadata') / 'Movies' / guid_hash[0] / f'{guid_hash[1:]}.bundle') + @utils.registerPlexObject class Show( @@ -655,6 +663,12 @@ class Show( filepaths += episode.download(_savepath, keep_original_name, **kwargs) return filepaths + @property + def metadataDirectory(self): + """ Returns the Plex Media Server data directory where the metadata is stored. """ + guid_hash = utils.sha1hash(self.guid) + return str(Path('Metadata') / 'TV Shows' / guid_hash[0] / f'{guid_hash[1:]}.bundle') + @utils.registerPlexObject class Season( @@ -663,7 +677,7 @@ class Season( ArtMixin, PosterMixin, ThemeUrlMixin, SeasonEditMixins ): - """ Represents a single Show Season (including all episodes). + """ Represents a single Season. Attributes: TAG (str): 'Directory' @@ -808,6 +822,12 @@ class Season( """ Returns str, default title for a new syncItem. """ return f'{self.parentTitle} - {self.title}' + @property + def metadataDirectory(self): + """ Returns the Plex Media Server data directory where the metadata is stored. """ + guid_hash = utils.sha1hash(self.parentGuid) + return str(Path('Metadata') / 'TV Shows' / guid_hash[0] / f'{guid_hash[1:]}.bundle') + @utils.registerPlexObject class Episode( @@ -816,7 +836,7 @@ class Episode( ArtMixin, PosterMixin, ThemeUrlMixin, EpisodeEditMixins ): - """ Represents a single Shows Episode. + """ Represents a single Episode. Attributes: TAG (str): 'Video' @@ -845,7 +865,7 @@ class Episode( parentGuid (str): Plex GUID for the season (plex://season/5d9c09e42df347001e3c2a72). parentIndex (int): Season number of episode. parentKey (str): API URL of the season (/library/metadata/). - parentRatingKey (int): Unique key identifying the season. + parentRatingKey (int): Unique key identifying the season. parentThumb (str): URL to season thumbnail image (/library/metadata//thumb/). parentTitle (str): Name of the season for the episode. parentYear (int): Year the season was released. @@ -866,7 +886,6 @@ class Episode( """ Load attribute values from Plex XML response. """ Video._loadData(self, data) Playable._loadData(self, data) - self._seasonNumber = None # cached season number self.audienceRating = utils.cast(float, data.attrib.get('audienceRating')) self.audienceRatingImage = data.attrib.get('audienceRatingImage') self.chapters = self.findItems(data, media.Chapter) @@ -890,9 +909,6 @@ class Episode( self.originallyAvailableAt = utils.toDatetime(data.attrib.get('originallyAvailableAt'), '%Y-%m-%d') self.parentGuid = data.attrib.get('parentGuid') self.parentIndex = utils.cast(int, data.attrib.get('parentIndex')) - self.parentKey = data.attrib.get('parentKey') - self.parentRatingKey = utils.cast(int, data.attrib.get('parentRatingKey')) - self.parentThumb = data.attrib.get('parentThumb') self.parentTitle = data.attrib.get('parentTitle') self.parentYear = utils.cast(int, data.attrib.get('parentYear')) self.producers = self.findItems(data, media.Producer) @@ -906,15 +922,50 @@ class Episode( # If seasons are hidden, parentKey and parentRatingKey are missing from the XML response. # https://forums.plex.tv/t/parentratingkey-not-in-episode-xml-when-seasons-are-hidden/300553 - if self.skipParent and data.attrib.get('parentRatingKey') is None: - # Parse the parentRatingKey from the parentThumb - if self.parentThumb and self.parentThumb.startswith('/library/metadata/'): - self.parentRatingKey = utils.cast(int, self.parentThumb.split('/')[3]) - # Get the parentRatingKey from the season's ratingKey - if not self.parentRatingKey and self.grandparentRatingKey: - self.parentRatingKey = self.show().season(season=self.parentIndex).ratingKey - if self.parentRatingKey: - self.parentKey = f'/library/metadata/{self.parentRatingKey}' + # Use cached properties below to return the correct values if they are missing to avoid auto-reloading. + self._parentKey = data.attrib.get('parentKey') + self._parentRatingKey = utils.cast(int, data.attrib.get('parentRatingKey')) + self._parentThumb = data.attrib.get('parentThumb') + + @cached_property + def parentKey(self): + """ Returns the parentKey. Refer to the Episode attributes. """ + if self._parentKey: + return self._parentKey + if self.parentRatingKey: + return f'/library/metadata/{self.parentRatingKey}' + return None + + @cached_property + def parentRatingKey(self): + """ Returns the parentRatingKey. Refer to the Episode attributes. """ + if self._parentRatingKey is not None: + return self._parentRatingKey + # Parse the parentRatingKey from the parentThumb + if self._parentThumb and self._parentThumb.startswith('/library/metadata/'): + return utils.cast(int, self._parentThumb.split('/')[3]) + # Get the parentRatingKey from the season's ratingKey if available + if self._season: + return self._season.ratingKey + return None + + @cached_property + def parentThumb(self): + """ Returns the parentThumb. Refer to the Episode attributes. """ + if self._parentThumb: + return self._parentThumb + if self._season: + return self._season.thumb + return None + + @cached_property + def _season(self): + """ Returns the :class:`~plexapi.video.Season` object by querying for the show's children. """ + if not self.grandparentKey: + return None + return self.fetchItem( + f'{self.grandparentKey}/children?excludeAllLeaves=1&index={self.parentIndex}' + ) def __repr__(self): return '<{}>'.format( @@ -949,12 +1000,10 @@ class Episode( """ Returns the episode number. """ return self.index - @property + @cached_property def seasonNumber(self): """ Returns the episode's season number. """ - if self._seasonNumber is None: - self._seasonNumber = self.parentIndex if isinstance(self.parentIndex, int) else self.season().seasonNumber - return utils.cast(int, self._seasonNumber) + return self.parentIndex if isinstance(self.parentIndex, int) else self._season.seasonNumber @property def seasonEpisode(self): @@ -1000,6 +1049,12 @@ class Episode( self._server.query(key, params=params, method=self._server._session.put) return self + @property + def metadataDirectory(self): + """ Returns the Plex Media Server data directory where the metadata is stored. """ + guid_hash = utils.sha1hash(self.grandparentGuid) + return str(Path('Metadata') / 'TV Shows' / guid_hash[0] / f'{guid_hash[1:]}.bundle') + @utils.registerPlexObject class Clip( @@ -1058,6 +1113,12 @@ class Clip( """ Returns a filename for use in download. """ return self.title + @property + def metadataDirectory(self): + """ Returns the Plex Media Server data directory where the metadata is stored. """ + guid_hash = utils.sha1hash(self.guid) + return str(Path('Metadata') / 'Movies' / guid_hash[0] / f'{guid_hash[1:]}.bundle') + class Extra(Clip): """ Represents a single Extra (trailer, behindTheScenes, etc). """ diff --git a/requirements.txt b/requirements.txt index 8ca67fe6..04578ef9 100644 --- a/requirements.txt +++ b/requirements.txt @@ -28,7 +28,7 @@ MarkupSafe==2.1.3 musicbrainzngs==0.7.1 packaging==23.1 paho-mqtt==1.6.1 -plexapi==4.15.0 +plexapi==4.15.4 portend==3.2.0 profilehooks==1.12.0 PyJWT==2.8.0 From a59e07c07d00fc12caf466b5bb71c1412d8eafa7 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Tue, 10 Oct 2023 14:23:26 -0700 Subject: [PATCH 019/290] Add metadataDirectory to exporter fields --- plexpy/exporter.py | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/plexpy/exporter.py b/plexpy/exporter.py index e1dc989d..1232481c 100644 --- a/plexpy/exporter.py +++ b/plexpy/exporter.py @@ -371,6 +371,7 @@ class Export(object): } } }, + 'metadataDirectory': None, 'originallyAvailableAt': partial(helpers.datetime_to_iso, to_date=True), 'originalTitle': None, 'producers': { @@ -457,6 +458,7 @@ class Export(object): 'librarySectionKey': None, 'librarySectionTitle': None, 'locations': None, + 'metadataDirectory': None, 'network': None, 'originallyAvailableAt': partial(helpers.datetime_to_iso, to_date=True), 'originalTitle': None, @@ -523,6 +525,7 @@ class Export(object): 'librarySectionID': None, 'librarySectionKey': None, 'librarySectionTitle': None, + 'metadataDirectory': None, 'parentGuid': None, 'parentIndex': None, 'parentKey': None, @@ -769,6 +772,7 @@ class Export(object): } } }, + 'metadataDirectory': None, 'originallyAvailableAt': partial(helpers.datetime_to_iso, to_date=True), 'parentGuid': None, 'parentIndex': None, @@ -849,6 +853,7 @@ class Export(object): 'librarySectionKey': None, 'librarySectionTitle': None, 'locations': None, + 'metadataDirectory': None, 'moods': { 'id': None, 'tag': None @@ -918,6 +923,7 @@ class Export(object): 'librarySectionKey': None, 'librarySectionTitle': None, 'loudnessAnalysisVersion': None, + 'metadataDirectory': None, 'moods': { 'id': None, 'tag': None @@ -1087,6 +1093,7 @@ class Export(object): } } }, + 'metadataDirectory': None, 'moods': { 'id': None, 'tag': None @@ -1133,6 +1140,7 @@ class Export(object): 'librarySectionID': None, 'librarySectionKey': None, 'librarySectionTitle': None, + 'metadataDirectory': None, 'ratingKey': None, 'summary': None, 'thumb': None, @@ -1164,6 +1172,7 @@ class Export(object): 'librarySectionKey': None, 'librarySectionTitle': None, 'locations': None, + 'metadataDirectory': None, 'originallyAvailableAt': partial(helpers.datetime_to_iso, to_date=True), 'parentGuid': None, 'parentIndex': None, @@ -1238,6 +1247,7 @@ class Export(object): 'librarySectionKey': None, 'librarySectionTitle': None, 'maxYear': None, + 'metadataDirectory': None, 'minYear': None, 'ratingKey': None, 'subtype': None, @@ -1266,6 +1276,7 @@ class Export(object): 'icon': None, 'key': None, 'leafCount': None, + 'metadataDirectory': None, 'playlistType': None, 'ratingKey': None, 'smart': None, From b32183b7b6284508a60acd1a17f76a81c1b05738 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Tue, 10 Oct 2023 19:18:18 -0700 Subject: [PATCH 020/290] Speed up graphs data lookup --- plexpy/graphs.py | 162 +++++++++++++++++++--------------------------- plexpy/helpers.py | 4 +- 2 files changed, 69 insertions(+), 97 deletions(-) diff --git a/plexpy/graphs.py b/plexpy/graphs.py index 82db9d82..7596e124 100644 --- a/plexpy/graphs.py +++ b/plexpy/graphs.py @@ -101,6 +101,8 @@ class Graphs(object): logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_day: %s." % e) return None + result_by_date_played = {item['date_played']: item for item in result} + # create our date range as some days may not have any data # but we still want to display them base = datetime.date.today() @@ -115,22 +117,13 @@ class Graphs(object): for date_item in sorted(date_list): date_string = date_item.strftime('%Y-%m-%d') categories.append(date_string) - series_1_value = 0 - series_2_value = 0 - series_3_value = 0 - series_4_value = 0 - for item in result: - if date_string == item['date_played']: - series_1_value = item['tv_count'] - series_2_value = item['movie_count'] - series_3_value = item['music_count'] - series_4_value = item['live_count'] - break - else: - series_1_value = 0 - series_2_value = 0 - series_3_value = 0 - series_4_value = 0 + + result_date = result_by_date_played.get(date_string, {}) + + series_1_value = result_date.get('tv_count', 0) + series_2_value = result_date.get('movie_count', 0) + series_3_value = result_date.get('music_count', 0) + series_4_value = result_date.get('live_count', 0) series_1.append(series_1_value) series_2.append(series_2_value) @@ -233,6 +226,8 @@ class Graphs(object): logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_dayofweek: %s." % e) return None + result_by_dayofweek = {item['dayofweek']: item for item in result} + if plexpy.CONFIG.WEEK_START_MONDAY: days_list = ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday'] @@ -248,22 +243,13 @@ class Graphs(object): for day_item in days_list: categories.append(day_item) - series_1_value = 0 - series_2_value = 0 - series_3_value = 0 - series_4_value = 0 - for item in result: - if day_item == item['dayofweek']: - series_1_value = item['tv_count'] - series_2_value = item['movie_count'] - series_3_value = item['music_count'] - series_4_value = item['live_count'] - break - else: - series_1_value = 0 - series_2_value = 0 - series_3_value = 0 - series_4_value = 0 + + result_day = result_by_dayofweek.get(day_item, {}) + + series_1_value = result_day.get('tv_count', 0) + series_2_value = result_day.get('movie_count', 0) + series_3_value = result_day.get('music_count', 0) + series_4_value = result_day.get('live_count', 0) series_1.append(series_1_value) series_2.append(series_2_value) @@ -350,6 +336,8 @@ class Graphs(object): logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_hourofday: %s." % e) return None + result_by_hourofday = {item['hourofday']: item for item in result} + hours_list = ['00', '01', '02', '03', '04', '05', '06', '07', '08', '09', '10', '11', '12', '13', '14', '15', '16', '17', @@ -363,22 +351,13 @@ class Graphs(object): for hour_item in hours_list: categories.append(hour_item) - series_1_value = 0 - series_2_value = 0 - series_3_value = 0 - series_4_value = 0 - for item in result: - if hour_item == item['hourofday']: - series_1_value = item['tv_count'] - series_2_value = item['movie_count'] - series_3_value = item['music_count'] - series_4_value = item['live_count'] - break - else: - series_1_value = 0 - series_2_value = 0 - series_3_value = 0 - series_4_value = 0 + + result_hour = result_by_hourofday.get(hour_item, {}) + + series_1_value = result_hour.get('tv_count', 0) + series_2_value = result_hour.get('movie_count', 0) + series_3_value = result_hour.get('music_count', 0) + series_4_value = result_hour.get('live_count', 0) series_1.append(series_1_value) series_2.append(series_2_value) @@ -465,6 +444,8 @@ class Graphs(object): logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_month: %s." % e) return None + result_by_datestring = {item['datestring']: item for item in result} + # create our date range as some months may not have any data # but we still want to display them dt_today = datetime.date.today() @@ -486,22 +467,13 @@ class Graphs(object): for dt in sorted(month_range): date_string = dt.strftime('%Y-%m') categories.append(dt.strftime('%b %Y')) - series_1_value = 0 - series_2_value = 0 - series_3_value = 0 - series_4_value = 0 - for item in result: - if date_string == item['datestring']: - series_1_value = item['tv_count'] - series_2_value = item['movie_count'] - series_3_value = item['music_count'] - series_4_value = item['live_count'] - break - else: - series_1_value = 0 - series_2_value = 0 - series_3_value = 0 - series_4_value = 0 + + result_date = result_by_datestring.get(date_string, {}) + + series_1_value = result_date.get('tv_count', 0) + series_2_value = result_date.get('movie_count', 0) + series_3_value = result_date.get('music_count', 0) + series_4_value = result_date.get('live_count', 0) series_1.append(series_1_value) series_2.append(series_2_value) @@ -598,6 +570,7 @@ class Graphs(object): for item in result: categories.append(common.PLATFORM_NAME_OVERRIDES.get(item['platform'], item['platform'])) + series_1.append(item['tv_count']) series_2.append(item['movie_count']) series_3.append(item['music_count']) @@ -704,6 +677,7 @@ class Graphs(object): categories.append(item['username'] if str(item['user_id']) == session_user_id else 'Plex User') else: categories.append(item['friendly_name']) + series_1.append(item['tv_count']) series_2.append(item['movie_count']) series_3.append(item['music_count']) @@ -783,6 +757,8 @@ class Graphs(object): logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_stream_type: %s." % e) return None + result_by_date_played = {item['date_played']: item for item in result} + # create our date range as some days may not have any data # but we still want to display them base = datetime.date.today() @@ -796,19 +772,12 @@ class Graphs(object): for date_item in sorted(date_list): date_string = date_item.strftime('%Y-%m-%d') categories.append(date_string) - series_1_value = 0 - series_2_value = 0 - series_3_value = 0 - for item in result: - if date_string == item['date_played']: - series_1_value = item['dp_count'] - series_2_value = item['ds_count'] - series_3_value = item['tc_count'] - break - else: - series_1_value = 0 - series_2_value = 0 - series_3_value = 0 + + result_date = result_by_date_played.get(date_string, {}) + + series_1_value = result_date.get('dp_count', 0) + series_2_value = result_date.get('ds_count', 0) + series_3_value = result_date.get('tc_count', 0) series_1.append(series_1_value) series_2.append(series_2_value) @@ -869,6 +838,9 @@ class Graphs(object): logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_stream_type: %s." % e) return None + result_by_date_and_decision = helpers.group_by_keys(result, ('date_played', 'transcode_decision')) + result_by_date = helpers.group_by_keys(result, 'date_played') + # create our date range as some days may not have any data # but we still want to display them base = datetime.date.today() @@ -880,29 +852,23 @@ class Graphs(object): series_3 = [] series_4 = [] - grouped_result_by_stream_type = helpers.group_by_keys(result, ('date_played','transcode_decision')) - grouped_result_by_day = helpers.group_by_keys(result, ['date_played']) - for date_item in sorted(date_list): date_string = date_item.strftime('%Y-%m-%d') categories.append(date_string) - series_1_value = 0 - series_2_value = 0 - series_3_value = 0 - series_4_value = 0 - for item in grouped_result_by_stream_type: - if item['key'] == (date_string,'direct play'): - series_1_value = calc_most_concurrent(item['value']) - elif item['key'] == (date_string,'copy'): - series_2_value = calc_most_concurrent(item['value']) - elif item['key'] == (date_string,'transcode'): - series_3_value = calc_most_concurrent(item['value']) + series_1_value = calc_most_concurrent( + result_by_date_and_decision.get((date_string, 'direct play'), []) + ) + series_2_value = calc_most_concurrent( + result_by_date_and_decision.get((date_string, 'copy'), []) + ) + series_3_value = calc_most_concurrent( + result_by_date_and_decision.get((date_string, 'transcode'), []) + ) + series_4_value = calc_most_concurrent( + result_by_date.get(date_string, []) + ) - for item in grouped_result_by_day: - if item['key'] == date_string: - series_4_value = calc_most_concurrent(item['value']) - series_1.append(series_1_value) series_2.append(series_2_value) series_3.append(series_3_value) @@ -983,6 +949,7 @@ class Graphs(object): for item in result: categories.append(item['resolution']) + series_1.append(item['dp_count']) series_2.append(item['ds_count']) series_3.append(item['tc_count']) @@ -1086,6 +1053,7 @@ class Graphs(object): for item in result: categories.append(item['resolution']) + series_1.append(item['dp_count']) series_2.append(item['ds_count']) series_3.append(item['tc_count']) @@ -1161,6 +1129,7 @@ class Graphs(object): for item in result: categories.append(common.PLATFORM_NAME_OVERRIDES.get(item['platform'], item['platform'])) + series_1.append(item['dp_count']) series_2.append(item['ds_count']) series_3.append(item['tc_count']) @@ -1248,6 +1217,7 @@ class Graphs(object): categories.append(item['username'] if str(item['user_id']) == session_user_id else 'Plex User') else: categories.append(item['friendly_name']) + series_1.append(item['dp_count']) series_2.append(item['ds_count']) series_3.append(item['tc_count']) @@ -1275,5 +1245,5 @@ class Graphs(object): elif user_id: user_ids = helpers.split_strip(user_id) if all(id.isdigit() for id in user_ids): - user_cond =cond_prefix + ' session_history.user_id IN (%s) ' % ','.join(user_ids) + user_cond = cond_prefix + ' session_history.user_id IN (%s) ' % ','.join(user_ids) return user_cond diff --git a/plexpy/helpers.py b/plexpy/helpers.py index 4512f0b6..e8056eb4 100644 --- a/plexpy/helpers.py +++ b/plexpy/helpers.py @@ -1242,11 +1242,13 @@ def grouper(iterable, n, fillvalue=None): args = [iter(iterable)] * n return zip_longest(fillvalue=fillvalue, *args) + def group_by_keys(iterable, keys): key_function = operator.itemgetter(*keys) sorted_iterable = sorted(iterable, key=key_function) - return[{'key': key, 'value': list(group)} for key, group in groupby(sorted_iterable, key_function)] + return {key: list(group) for key, group in groupby(sorted_iterable, key_function)} + def chunk(it, size): it = iter(it) From d8d1f75605fdc1679890837395af4a80d16beee1 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Tue, 10 Oct 2023 19:32:30 -0700 Subject: [PATCH 021/290] Use group_by_keys helper for library stats --- plexpy/datafactory.py | 3 +-- plexpy/helpers.py | 4 +++- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py index bd5a7c31..0937480d 100644 --- a/plexpy/datafactory.py +++ b/plexpy/datafactory.py @@ -22,7 +22,6 @@ from future.builtins import str from future.builtins import object import json -from itertools import groupby import plexpy if plexpy.PYTHON2: @@ -1187,7 +1186,7 @@ class DataFactory(object): library_stats.append(library) library_stats = session.mask_session_info(library_stats) - library_stats = {k: list(v) for k, v in groupby(library_stats, key=lambda x: x['section_type'])} + library_stats = helpers.group_by_keys(library_stats, 'section_type') return library_stats diff --git a/plexpy/helpers.py b/plexpy/helpers.py index e8056eb4..25850a16 100644 --- a/plexpy/helpers.py +++ b/plexpy/helpers.py @@ -1244,8 +1244,10 @@ def grouper(iterable, n, fillvalue=None): def group_by_keys(iterable, keys): - key_function = operator.itemgetter(*keys) + if not isinstance(keys, (list, tuple)): + keys = [keys] + key_function = operator.itemgetter(*keys) sorted_iterable = sorted(iterable, key=key_function) return {key: list(group) for key, group in groupby(sorted_iterable, key_function)} From 7245e97726ea6b8ff0427a7b794d32e595c305d8 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Tue, 10 Oct 2023 21:27:13 -0700 Subject: [PATCH 022/290] Fix concurrent streams graph query --- plexpy/graphs.py | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/plexpy/graphs.py b/plexpy/graphs.py index 7596e124..8758f71f 100644 --- a/plexpy/graphs.py +++ b/plexpy/graphs.py @@ -825,13 +825,14 @@ class Graphs(object): return final_count try: - query = 'SELECT sh.date_played, sh.started, sh.stopped, shmi.transcode_decision ' \ - 'FROM (SELECT *, ' \ - 'date(started, "unixepoch", "localtime") AS date_played ' \ - 'FROM session_history %s) AS sh ' \ - 'JOIN session_history_media_info AS shmi ON sh.id = shmi.id ' \ - 'WHERE sh.stopped >= %s ' \ - 'ORDER BY sh.date_played' % (user_cond, timestamp) + query = "SELECT sh.date_played, sh.started, sh.stopped, shmi.transcode_decision " \ + "FROM (SELECT *, " \ + "date(started, 'unixepoch', 'localtime') AS date_played " \ + "FROM session_history %s " \ + "GROUP BY id) AS sh " \ + "JOIN session_history_media_info AS shmi ON sh.id = shmi.id " \ + "WHERE sh.stopped >= %s " \ + "ORDER BY sh.started" % (user_cond, timestamp) result = monitor_db.select(query) except Exception as e: From efdd4156d89b14a7418ae40c104631b0e7de8d09 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Mon, 16 Oct 2023 15:04:19 -0700 Subject: [PATCH 023/290] Update IP helper function --- plexpy/helpers.py | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/plexpy/helpers.py b/plexpy/helpers.py index 25850a16..486be759 100644 --- a/plexpy/helpers.py +++ b/plexpy/helpers.py @@ -1194,18 +1194,20 @@ def get_plexpy_url(hostname=None): scheme = 'http' if hostname is None and plexpy.CONFIG.HTTP_HOST in ('0.0.0.0', '::'): - import socket + # Only returns IPv4 address + s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) + s.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1) + s.settimeout(0) try: - # Only returns IPv4 address - s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) - s.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1) - s.connect(('', 0)) + s.connect(('', 1)) hostname = s.getsockname()[0] except socket.error: try: hostname = socket.gethostbyname(socket.gethostname()) except socket.gaierror: pass + finally: + s.close() if not hostname: hostname = 'localhost' From 1e4fc05ecfddb6e710afe05e5e55cca6b78799c4 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Tue, 17 Oct 2023 11:23:04 -0700 Subject: [PATCH 024/290] Add ping method to refresh token --- plexpy/plextv.py | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/plexpy/plextv.py b/plexpy/plextv.py index 8bab1d51..d3afb26a 100644 --- a/plexpy/plextv.py +++ b/plexpy/plextv.py @@ -80,6 +80,7 @@ def get_server_resources(return_presence=False, return_server=False, return_info port=server['pms_port']) plex_tv = PlexTV() + plex_tv.ping() result = plex_tv.get_server_connections(pms_identifier=server['pms_identifier'], pms_ip=server['pms_ip'], pms_port=server['pms_port'], @@ -347,6 +348,13 @@ class PlexTV(object): return request + def ping_plextv(self, output_format=''): + uri = '/api/v2/ping' + request = self.request_handler.make_request(uri=uri, + request_type='GET', + output_format=output_format) + return request + def get_full_users_list(self): own_account = self.get_plextv_user_details(output_format='xml') friends_list = self.get_plextv_friends(output_format='xml') @@ -950,3 +958,18 @@ class PlexTV(object): } return geo_info + + def ping(self): + logger.info(u"Tautulli PlexTV :: Pinging Plex.tv to refresh token.") + + pong = self.ping_plextv(output_format='xml') + + try: + xml_head = pong.getElementsByTagName('pong') + except Exception as e: + logger.warn(u"Tautulli PlexTV :: Unable to parse XML for ping: %s." % e) + return None + + if xml_head: + return helpers.bool_true(xml_head[0].firstChild.nodeValue) + return False From a31dcb5508cde585a096c0df4a27611bc39f5856 Mon Sep 17 00:00:00 2001 From: herby2212 <12448284+herby2212@users.noreply.github.com> Date: Tue, 24 Oct 2023 00:51:35 +0200 Subject: [PATCH 025/290] Quater values for History Watch Status (#2179) * initial release * change fillup orientation to clockwise * fix indentation for css * fix 50 percent circle orientation * optimize colors and padding --- data/interfaces/default/css/tautulli.css | 128 +++++++++++------- .../default/js/tables/history_table.js | 12 +- plexpy/datafactory.py | 10 +- 3 files changed, 92 insertions(+), 58 deletions(-) diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css index 8cad039f..0c81f0e5 100644 --- a/data/interfaces/default/css/tautulli.css +++ b/data/interfaces/default/css/tautulli.css @@ -338,20 +338,20 @@ object { } .btn-dark:focus, .btn-dark.focus { - color: #d7d7d7; - background-color: #3B3B3B; + color: #d7d7d7; + background-color: #3B3B3B; } .btn-dark:hover { - color: #eee; - background-color: #333; - border-color: #444; + color: #eee; + background-color: #333; + border-color: #444; } .btn-dark:active, .btn-dark.active, .open > .dropdown-toggle.btn-dark { - color: #eee; - background-color: #333; - border-color: #444; + color: #eee; + background-color: #333; + border-color: #444; } .btn-dark:active:hover, .btn-dark.active:hover, @@ -362,13 +362,13 @@ object { .btn-dark:active.focus, .btn-dark.active.focus, .open > .dropdown-toggle.btn-dark.focus { - color: #eee; - background-color: #333; + color: #eee; + background-color: #333; } .btn-dark:active, .btn-dark.active, .open > .dropdown-toggle.btn-dark { - background-image: none; + background-image: none; } .btn-dark.disabled, .btn-dark[disabled], @@ -388,8 +388,8 @@ fieldset[disabled] .btn-dark:active, .btn-dark.disabled.active, .btn-dark[disabled].active, fieldset[disabled] .btn-dark.active { - background-color: #333; - color: #aaa; + background-color: #333; + color: #aaa; } .btn-dark.inactive:hover { color: #d7d7d7; @@ -398,30 +398,30 @@ fieldset[disabled] .btn-dark.active { cursor: default; } .btn-dark .badge { - color: #e5e5e5; - background-color: #3B3B3B; + color: #e5e5e5; + background-color: #3B3B3B; } .btn-bright { - color: #eee; - background-color: #cc7b19; - box-shadow: inset 0 1px 0 #e7993b; + color: #eee; + background-color: #cc7b19; + box-shadow: inset 0 1px 0 #e7993b; } .btn-bright:focus, .btn-bright.focus { - color: #eee; - background-color: #eb8600; + color: #eee; + background-color: #eb8600; } .btn-bright:hover { - color: #eee; - background-color: #e59029; - box-shadow: inset 0 1px 0 #ebac60; + color: #eee; + background-color: #e59029; + box-shadow: inset 0 1px 0 #ebac60; } .btn-bright:active, .btn-bright.active, .open > .dropdown-toggle.btn-bright { - color: #eee; - background-color: #cc7b19; - box-shadow: inset 0 1px 0 #e7993b; + color: #eee; + background-color: #cc7b19; + box-shadow: inset 0 1px 0 #e7993b; } .btn-bright:active:hover, .btn-bright.active:hover, @@ -432,14 +432,14 @@ fieldset[disabled] .btn-dark.active { .btn-bright:active.focus, .btn-bright.active.focus, .open > .dropdown-toggle.btn-bright.focus { - color: #eee; - background-color: #cc7b19; - box-shadow: inset 0 1px 0 #e7993b; + color: #eee; + background-color: #cc7b19; + box-shadow: inset 0 1px 0 #e7993b; } .btn-bright:active, .btn-bright.active, .open > .dropdown-toggle.btn-bright { - background-image: none; + background-image: none; } .btn-bright.disabled, .btn-bright[disabled], @@ -459,13 +459,13 @@ fieldset[disabled] .btn-bright:active, .btn-bright.disabled.active, .btn-bright[disabled].active, fieldset[disabled] .btn-bright.active { - background-color: #cc7b19; - border-color: #b56d16; + background-color: #cc7b19; + border-color: #b56d16; } .btn-bright .badge { - color: #eee; - background-color: #cc7b19; - box-shadow: inset 0 1px 0 #e7993b; + color: #eee; + background-color: #cc7b19; + box-shadow: inset 0 1px 0 #e7993b; } .btn-danger.btn-edit { color: #d7d7d7; @@ -479,14 +479,14 @@ fieldset[disabled] .btn-bright.active { border-color: #ac2925; } .btn-danger.btn-edit.active { - color: #eee; - background-color: #c9302c; - border-color: #ac2925; + color: #eee; + background-color: #c9302c; + border-color: #ac2925; } .btn-danger.btn-edit.active:hover { - color: #eee; - background-color: #ac2925; - border-color: #761c19; + color: #eee; + background-color: #ac2925; + border-color: #761c19; } .btn-group select { margin-top: 0; @@ -667,12 +667,12 @@ textarea.form-control:focus { white-space: nowrap; vertical-align: middle; -ms-touch-action: manipulation; - touch-action: manipulation; + touch-action: manipulation; cursor: pointer; -webkit-user-select: none; - -moz-user-select: none; - -ms-user-select: none; - user-select: none; + -moz-user-select: none; + -ms-user-select: none; + user-select: none; background-image: none; background-color: #3B3B3B; color: #e5e5e5; @@ -690,10 +690,10 @@ textarea.form-control:focus { } .btn-filter.active, .btn-filter.active.focus { - background-color: #b7800a !important; + background-color: #b7800a !important; } .btn-filter.active:hover { - background-color: #896007 !important; + background-color: #896007 !important; } .form-control-feedback { color: #E5A00D; @@ -1281,7 +1281,7 @@ a .dashboard-activity-metadata-user-thumb:hover { -webkit-backface-visibility: hidden; backface-visibility: hidden; z-index: 1; - -webkit-border-radius: 50%; + -webkit-border-radius: 50%; -moz-border-radius: 50%; border-radius: 350%; overflow: hidden; @@ -2203,8 +2203,8 @@ span.settings-warning { padding-left: 10px; } #menu_link_show_advanced_settings.active { - color: #eee; - background-color: #cc7b19; + color: #eee; + background-color: #cc7b19; } #configUpdate .form-group, #configUpdate .checkbox{ @@ -2854,6 +2854,30 @@ a .home-platforms-list-cover-face:hover overflow: hidden; max-width: 350px; } +.circle { + width: 1.55rem; + height: 1.55rem; + border-radius: 50%; + border: 0.2rem solid #eeeeee; +} +.circle-quarter { + background-image: + linear-gradient(00deg, #2b2b2b 50%, transparent 50%), + linear-gradient(270deg, #eeeeee 50%, transparent 50%); +} +.circle-half { + background-image: + linear-gradient(90deg, #2b2b2b 50%, transparent 50%), + linear-gradient(-90deg, #eeeeee 50%, transparent 50%); + } +.circle-three-quarter { + background-image: + linear-gradient(180deg, transparent 50%, #eeeeee 50%), + linear-gradient(-90deg, #eeeeee 50%, transparent 50%); +} +.circle-full { + background: #eeeeee; +} #graph-tabs { padding-bottom: 10px; float: none; @@ -2991,8 +3015,8 @@ a .home-platforms-list-cover-face:hover border-left: 2px solid #444; border-top: 1px solid #2d2d2d; -webkit-transition: all 0.3s ease; - -o-transition: all 0.3s ease; - transition: all 0.3s ease; + -o-transition: all 0.3s ease; + transition: all 0.3s ease; } .stacked-configs > li > span:hover, .stacked-configs > li > span:focus { diff --git a/data/interfaces/default/js/tables/history_table.js b/data/interfaces/default/js/tables/history_table.js index d209f90e..7f9d578f 100644 --- a/data/interfaces/default/js/tables/history_table.js +++ b/data/interfaces/default/js/tables/history_table.js @@ -263,13 +263,17 @@ history_table_options = { "targets": [12], "data": "watched_status", "createdCell": function (td, cellData, rowData, row, col) { + var circleValue = ""; if (cellData == 1) { - $(td).html(''); + circleValue = " circle-full"; + } else if (cellData == 0.75) { + circleValue = " circle-three-quarter"; } else if (cellData == 0.5) { - $(td).html(''); - } else { - $(td).html(''); + circleValue = " circle-half"; + } else if (cellData == 0.25) { + circleValue = " circle-quarter"; } + $(td).html('
'); }, "searchable": false, "orderable": false, diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py index 0937480d..de3ed030 100644 --- a/plexpy/datafactory.py +++ b/plexpy/datafactory.py @@ -281,13 +281,19 @@ class DataFactory(object): if item['live']: item['percent_complete'] = 100 + base_watched_value = watched_percent[item['media_type']] / 4.0 + if helpers.check_watched( item['media_type'], item['view_offset'], item['duration'], item['marker_credits_first'], item['marker_credits_final'] ): watched_status = 1 - elif item['percent_complete'] >= watched_percent[item['media_type']] / 2.0: - watched_status = 0.5 + elif item['percent_complete'] >= base_watched_value * 3.0: + watched_status = 0.75 + elif item['percent_complete'] >= base_watched_value * 2.0: + watched_status = 0.50 + elif item['percent_complete'] >= base_watched_value: + watched_status = 0.25 else: watched_status = 0 From ab16adcffc77a2629663674cf83ec056f9832d42 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Mon, 23 Oct 2023 16:04:29 -0700 Subject: [PATCH 026/290] Add link from concurrent stream stats card to graphs page --- data/interfaces/default/graphs.html | 8 ++++++-- data/interfaces/default/home_stats.html | 4 +++- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/data/interfaces/default/graphs.html b/data/interfaces/default/graphs.html index 7cd0c98b..15a96a69 100644 --- a/data/interfaces/default/graphs.html +++ b/data/interfaces/default/graphs.html @@ -137,7 +137,7 @@
-
+

Daily concurrent stream count by stream type Last 30 days

@@ -372,6 +372,10 @@ break } + if (window.location.hash === '#concurrent-graph') { + current_tab = '#tabs-stream'; + } + $('#yaxis-' + yaxis).prop('checked', true); $('#yaxis-' + yaxis).closest('label').addClass('active'); $('#graph-days').val(current_day_range); @@ -639,7 +643,7 @@ } }); - $('#nav-tabs-2').tab('show'); + $('#nav-tabs-stream').tab('show'); } function loadGraphsTab3(time_range, yaxis) { diff --git a/data/interfaces/default/home_stats.html b/data/interfaces/default/home_stats.html index d66dd1d4..3e1e118c 100644 --- a/data/interfaces/default/home_stats.html +++ b/data/interfaces/default/home_stats.html @@ -177,7 +177,9 @@ DOCUMENTATION :: END % elif stat_id == 'top_platforms': ${row['platform']} % elif stat_id == 'most_concurrent': - ${row['title']} + + ${row['title']} + % endif

From 98583d139ac4207604fd728f3d591c2a79cb4636 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Thu, 26 Oct 2023 09:05:47 -0700 Subject: [PATCH 027/290] Add config override for PMS_LANGUAGE --- plexpy/config.py | 1 + plexpy/http_handler.py | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/plexpy/config.py b/plexpy/config.py index 6f2926d9..dbcd294d 100644 --- a/plexpy/config.py +++ b/plexpy/config.py @@ -55,6 +55,7 @@ _CONFIG_DEFINITIONS = { 'PMS_IP': (str, 'PMS', '127.0.0.1'), 'PMS_IS_CLOUD': (int, 'PMS', 0), 'PMS_IS_REMOTE': (int, 'PMS', 0), + 'PMS_LANGUAGE': (str, 'PMS', ''), 'PMS_LOGS_FOLDER': (str, 'PMS', ''), 'PMS_LOGS_LINE_CAP': (int, 'PMS', 1000), 'PMS_NAME': (str, 'PMS', ''), diff --git a/plexpy/http_handler.py b/plexpy/http_handler.py index 87c4cff5..79bb3562 100644 --- a/plexpy/http_handler.py +++ b/plexpy/http_handler.py @@ -62,7 +62,7 @@ class HTTPHandler(object): plexpy.common.PLATFORM_RELEASE), 'X-Plex-Device-Name': '{} ({})'.format(plexpy.common.PLATFORM_DEVICE_NAME, plexpy.common.PRODUCT), - 'Accept-Language': plexpy.SYS_LANGUAGE + 'X-Plex-Language': plexpy.CONFIG.PMS_LANGUAGE or plexpy.SYS_LANGUAGE } self.token = token From d63c0cb469375537ddb713368a1e89dde41072ad Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Thu, 26 Oct 2023 09:24:48 -0700 Subject: [PATCH 028/290] Guard against None transcode_key --- plexpy/activity_handler.py | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py index 7bfbe8fb..32f835c3 100644 --- a/plexpy/activity_handler.py +++ b/plexpy/activity_handler.py @@ -310,7 +310,9 @@ class ActivityHandler(object): last_state = self.db_session['state'] last_rating_key = str(self.db_session['rating_key']) last_live_uuid = self.db_session['live_uuid'] - last_transcode_key = self.db_session['transcode_key'].split('/')[-1] + last_transcode_key = self.db_session['transcode_key'] + if isinstance(last_transcode_key, str): + last_transcode_key = last_transcode_key.split('/')[-1] last_paused = self.db_session['last_paused'] last_rating_key_websocket = self.db_session['rating_key_websocket'] last_guid = self.db_session['guid'] From c215afbf84baafb1a2020c2dc6e36944a6de1504 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Thu, 26 Oct 2023 09:27:31 -0700 Subject: [PATCH 029/290] v2.13.2 --- CHANGELOG.md | 14 ++++++++++++++ plexpy/version.py | 2 +- 2 files changed, 15 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1266e43f..d5eb4c5a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,19 @@ # Changelog +## v2.13.2 (2023-10-26) +* History: + * New: Added quarter values icons for history watch status. (#2179, #2156) (Thanks @herby2212) +* Graphs: + * New: Added concurrent streams per day graph. (#2046) (Thanks @herby2212) +* Exporter: + * New: Added metadata directory to exporter fields. + * Removed: Banner exporter fields for tv shows. +* UI: + * New: Added last triggered time to notification agents and newsletter agent lists. +* Other: + * New: Added X-Plex-Language header override to config file. + + ## v2.13.1 (2023-08-25) * Notes: * Support for Python 3.7 has been dropped. The minimum Python version is now 3.8. diff --git a/plexpy/version.py b/plexpy/version.py index c5ee1521..5ca70297 100644 --- a/plexpy/version.py +++ b/plexpy/version.py @@ -18,4 +18,4 @@ from __future__ import unicode_literals PLEXPY_BRANCH = "master" -PLEXPY_RELEASE_VERSION = "v2.13.1" \ No newline at end of file +PLEXPY_RELEASE_VERSION = "v2.13.2" \ No newline at end of file From dd380b583f67ad112f99057da4518a3df9c7ff74 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Thu, 26 Oct 2023 11:05:34 -0700 Subject: [PATCH 030/290] Add system language to startup logs --- plexpy/__init__.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/plexpy/__init__.py b/plexpy/__init__.py index eb1f73c2..2590c867 100644 --- a/plexpy/__init__.py +++ b/plexpy/__init__.py @@ -239,6 +239,9 @@ def initialize(config_file): logger.info("{} (UTC{})".format( str(SYS_TIMEZONE), SYS_UTC_OFFSET )) + logger.info("Language {}{} / Encoding {}".format( + SYS_LANGUAGE, f' (override {CONFIG.PMS_LANGUAGE})' if CONFIG.PMS_LANGUAGE else '', SYS_ENCODING + )) logger.info("Python {}".format( sys.version.replace('\n', '') )) From 32cf26884b4dcc7fa1aa26260d99689b922deedd Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Thu, 26 Oct 2023 11:05:51 -0700 Subject: [PATCH 031/290] Add system language and sqlite version to configuration table --- data/interfaces/default/configuration_table.html | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/data/interfaces/default/configuration_table.html b/data/interfaces/default/configuration_table.html index 676876d6..66d8ef40 100644 --- a/data/interfaces/default/configuration_table.html +++ b/data/interfaces/default/configuration_table.html @@ -11,6 +11,7 @@ DOCUMENTATION :: END <%! import os + import sqlite3 import sys import plexpy from plexpy import common, logger @@ -71,10 +72,18 @@ DOCUMENTATION :: END System Timezone: ${str(plexpy.SYS_TIMEZONE)} (${'UTC{}'.format(plexpy.SYS_UTC_OFFSET)}) + + System Language: + ${plexpy.SYS_LANGUAGE + (' (override {})'.format(plexpy.CONFIG.PMS_LANGUAGE) if plexpy.CONFIG.PMS_LANGUAGE else '')} + Python Version: ${sys.version} + + SQLite Version: + ${sqlite3.sqlite_version} + Resources: From f1c12c0bbe0a8364bd1c3a3822291dc52f806bfb Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sat, 4 Nov 2023 13:29:40 -0700 Subject: [PATCH 032/290] Switch appdirs to platformdirs --- Tautulli.py | 4 +- lib/appdirs.py | 608 --------------------------------- lib/platformdirs/__init__.py | 628 +++++++++++++++++++++++++++++++++++ lib/platformdirs/__main__.py | 54 +++ lib/platformdirs/android.py | 220 ++++++++++++ lib/platformdirs/api.py | 243 ++++++++++++++ lib/platformdirs/macos.py | 126 +++++++ lib/platformdirs/py.typed | 0 lib/platformdirs/unix.py | 251 ++++++++++++++ lib/platformdirs/version.py | 16 + lib/platformdirs/windows.py | 266 +++++++++++++++ requirements.txt | 2 +- 12 files changed, 1807 insertions(+), 611 deletions(-) delete mode 100644 lib/appdirs.py create mode 100644 lib/platformdirs/__init__.py create mode 100644 lib/platformdirs/__main__.py create mode 100644 lib/platformdirs/android.py create mode 100644 lib/platformdirs/api.py create mode 100644 lib/platformdirs/macos.py create mode 100644 lib/platformdirs/py.typed create mode 100644 lib/platformdirs/unix.py create mode 100644 lib/platformdirs/version.py create mode 100644 lib/platformdirs/windows.py diff --git a/Tautulli.py b/Tautulli.py index eebfa55a..04a6778e 100755 --- a/Tautulli.py +++ b/Tautulli.py @@ -25,10 +25,10 @@ sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), 'lib from future.builtins import str -import appdirs import argparse import datetime import locale +import platformdirs import pytz import signal import shutil @@ -186,7 +186,7 @@ def main(): if args.datadir: plexpy.DATA_DIR = args.datadir elif plexpy.FROZEN: - plexpy.DATA_DIR = appdirs.user_data_dir("Tautulli", False) + plexpy.DATA_DIR = platformdirs.user_data_dir("Tautulli", False) else: plexpy.DATA_DIR = plexpy.PROG_DIR diff --git a/lib/appdirs.py b/lib/appdirs.py deleted file mode 100644 index 2acd1deb..00000000 --- a/lib/appdirs.py +++ /dev/null @@ -1,608 +0,0 @@ -#!/usr/bin/env python -# -*- coding: utf-8 -*- -# Copyright (c) 2005-2010 ActiveState Software Inc. -# Copyright (c) 2013 Eddy Petrișor - -"""Utilities for determining application-specific dirs. - -See for details and usage. -""" -# Dev Notes: -# - MSDN on where to store app data files: -# http://support.microsoft.com/default.aspx?scid=kb;en-us;310294#XSLTH3194121123120121120120 -# - Mac OS X: http://developer.apple.com/documentation/MacOSX/Conceptual/BPFileSystem/index.html -# - XDG spec for Un*x: http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html - -__version__ = "1.4.4" -__version_info__ = tuple(int(segment) for segment in __version__.split(".")) - - -import sys -import os - -PY3 = sys.version_info[0] == 3 - -if PY3: - unicode = str - -if sys.platform.startswith('java'): - import platform - os_name = platform.java_ver()[3][0] - if os_name.startswith('Windows'): # "Windows XP", "Windows 7", etc. - system = 'win32' - elif os_name.startswith('Mac'): # "Mac OS X", etc. - system = 'darwin' - else: # "Linux", "SunOS", "FreeBSD", etc. - # Setting this to "linux2" is not ideal, but only Windows or Mac - # are actually checked for and the rest of the module expects - # *sys.platform* style strings. - system = 'linux2' -else: - system = sys.platform - - - -def user_data_dir(appname=None, appauthor=None, version=None, roaming=False): - r"""Return full path to the user-specific data dir for this application. - - "appname" is the name of application. - If None, just the system directory is returned. - "appauthor" (only used on Windows) is the name of the - appauthor or distributing body for this application. Typically - it is the owning company name. This falls back to appname. You may - pass False to disable it. - "version" is an optional version path element to append to the - path. You might want to use this if you want multiple versions - of your app to be able to run independently. If used, this - would typically be ".". - Only applied when appname is present. - "roaming" (boolean, default False) can be set True to use the Windows - roaming appdata directory. That means that for users on a Windows - network setup for roaming profiles, this user data will be - sync'd on login. See - - for a discussion of issues. - - Typical user data directories are: - Mac OS X: ~/Library/Application Support/ - Unix: ~/.local/share/ # or in $XDG_DATA_HOME, if defined - Win XP (not roaming): C:\Documents and Settings\\Application Data\\ - Win XP (roaming): C:\Documents and Settings\\Local Settings\Application Data\\ - Win 7 (not roaming): C:\Users\\AppData\Local\\ - Win 7 (roaming): C:\Users\\AppData\Roaming\\ - - For Unix, we follow the XDG spec and support $XDG_DATA_HOME. - That means, by default "~/.local/share/". - """ - if system == "win32": - if appauthor is None: - appauthor = appname - const = roaming and "CSIDL_APPDATA" or "CSIDL_LOCAL_APPDATA" - path = os.path.normpath(_get_win_folder(const)) - if appname: - if appauthor is not False: - path = os.path.join(path, appauthor, appname) - else: - path = os.path.join(path, appname) - elif system == 'darwin': - path = os.path.expanduser('~/Library/Application Support/') - if appname: - path = os.path.join(path, appname) - else: - path = os.getenv('XDG_DATA_HOME', os.path.expanduser("~/.local/share")) - if appname: - path = os.path.join(path, appname) - if appname and version: - path = os.path.join(path, version) - return path - - -def site_data_dir(appname=None, appauthor=None, version=None, multipath=False): - r"""Return full path to the user-shared data dir for this application. - - "appname" is the name of application. - If None, just the system directory is returned. - "appauthor" (only used on Windows) is the name of the - appauthor or distributing body for this application. Typically - it is the owning company name. This falls back to appname. You may - pass False to disable it. - "version" is an optional version path element to append to the - path. You might want to use this if you want multiple versions - of your app to be able to run independently. If used, this - would typically be ".". - Only applied when appname is present. - "multipath" is an optional parameter only applicable to *nix - which indicates that the entire list of data dirs should be - returned. By default, the first item from XDG_DATA_DIRS is - returned, or '/usr/local/share/', - if XDG_DATA_DIRS is not set - - Typical site data directories are: - Mac OS X: /Library/Application Support/ - Unix: /usr/local/share/ or /usr/share/ - Win XP: C:\Documents and Settings\All Users\Application Data\\ - Vista: (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.) - Win 7: C:\ProgramData\\ # Hidden, but writeable on Win 7. - - For Unix, this is using the $XDG_DATA_DIRS[0] default. - - WARNING: Do not use this on Windows. See the Vista-Fail note above for why. - """ - if system == "win32": - if appauthor is None: - appauthor = appname - path = os.path.normpath(_get_win_folder("CSIDL_COMMON_APPDATA")) - if appname: - if appauthor is not False: - path = os.path.join(path, appauthor, appname) - else: - path = os.path.join(path, appname) - elif system == 'darwin': - path = os.path.expanduser('/Library/Application Support') - if appname: - path = os.path.join(path, appname) - else: - # XDG default for $XDG_DATA_DIRS - # only first, if multipath is False - path = os.getenv('XDG_DATA_DIRS', - os.pathsep.join(['/usr/local/share', '/usr/share'])) - pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)] - if appname: - if version: - appname = os.path.join(appname, version) - pathlist = [os.sep.join([x, appname]) for x in pathlist] - - if multipath: - path = os.pathsep.join(pathlist) - else: - path = pathlist[0] - return path - - if appname and version: - path = os.path.join(path, version) - return path - - -def user_config_dir(appname=None, appauthor=None, version=None, roaming=False): - r"""Return full path to the user-specific config dir for this application. - - "appname" is the name of application. - If None, just the system directory is returned. - "appauthor" (only used on Windows) is the name of the - appauthor or distributing body for this application. Typically - it is the owning company name. This falls back to appname. You may - pass False to disable it. - "version" is an optional version path element to append to the - path. You might want to use this if you want multiple versions - of your app to be able to run independently. If used, this - would typically be ".". - Only applied when appname is present. - "roaming" (boolean, default False) can be set True to use the Windows - roaming appdata directory. That means that for users on a Windows - network setup for roaming profiles, this user data will be - sync'd on login. See - - for a discussion of issues. - - Typical user config directories are: - Mac OS X: same as user_data_dir - Unix: ~/.config/ # or in $XDG_CONFIG_HOME, if defined - Win *: same as user_data_dir - - For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME. - That means, by default "~/.config/". - """ - if system in ["win32", "darwin"]: - path = user_data_dir(appname, appauthor, None, roaming) - else: - path = os.getenv('XDG_CONFIG_HOME', os.path.expanduser("~/.config")) - if appname: - path = os.path.join(path, appname) - if appname and version: - path = os.path.join(path, version) - return path - - -def site_config_dir(appname=None, appauthor=None, version=None, multipath=False): - r"""Return full path to the user-shared data dir for this application. - - "appname" is the name of application. - If None, just the system directory is returned. - "appauthor" (only used on Windows) is the name of the - appauthor or distributing body for this application. Typically - it is the owning company name. This falls back to appname. You may - pass False to disable it. - "version" is an optional version path element to append to the - path. You might want to use this if you want multiple versions - of your app to be able to run independently. If used, this - would typically be ".". - Only applied when appname is present. - "multipath" is an optional parameter only applicable to *nix - which indicates that the entire list of config dirs should be - returned. By default, the first item from XDG_CONFIG_DIRS is - returned, or '/etc/xdg/', if XDG_CONFIG_DIRS is not set - - Typical site config directories are: - Mac OS X: same as site_data_dir - Unix: /etc/xdg/ or $XDG_CONFIG_DIRS[i]/ for each value in - $XDG_CONFIG_DIRS - Win *: same as site_data_dir - Vista: (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.) - - For Unix, this is using the $XDG_CONFIG_DIRS[0] default, if multipath=False - - WARNING: Do not use this on Windows. See the Vista-Fail note above for why. - """ - if system in ["win32", "darwin"]: - path = site_data_dir(appname, appauthor) - if appname and version: - path = os.path.join(path, version) - else: - # XDG default for $XDG_CONFIG_DIRS - # only first, if multipath is False - path = os.getenv('XDG_CONFIG_DIRS', '/etc/xdg') - pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)] - if appname: - if version: - appname = os.path.join(appname, version) - pathlist = [os.sep.join([x, appname]) for x in pathlist] - - if multipath: - path = os.pathsep.join(pathlist) - else: - path = pathlist[0] - return path - - -def user_cache_dir(appname=None, appauthor=None, version=None, opinion=True): - r"""Return full path to the user-specific cache dir for this application. - - "appname" is the name of application. - If None, just the system directory is returned. - "appauthor" (only used on Windows) is the name of the - appauthor or distributing body for this application. Typically - it is the owning company name. This falls back to appname. You may - pass False to disable it. - "version" is an optional version path element to append to the - path. You might want to use this if you want multiple versions - of your app to be able to run independently. If used, this - would typically be ".". - Only applied when appname is present. - "opinion" (boolean) can be False to disable the appending of - "Cache" to the base app data dir for Windows. See - discussion below. - - Typical user cache directories are: - Mac OS X: ~/Library/Caches/ - Unix: ~/.cache/ (XDG default) - Win XP: C:\Documents and Settings\\Local Settings\Application Data\\\Cache - Vista: C:\Users\\AppData\Local\\\Cache - - On Windows the only suggestion in the MSDN docs is that local settings go in - the `CSIDL_LOCAL_APPDATA` directory. This is identical to the non-roaming - app data dir (the default returned by `user_data_dir` above). Apps typically - put cache data somewhere *under* the given dir here. Some examples: - ...\Mozilla\Firefox\Profiles\\Cache - ...\Acme\SuperApp\Cache\1.0 - OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value. - This can be disabled with the `opinion=False` option. - """ - if system == "win32": - if appauthor is None: - appauthor = appname - path = os.path.normpath(_get_win_folder("CSIDL_LOCAL_APPDATA")) - if appname: - if appauthor is not False: - path = os.path.join(path, appauthor, appname) - else: - path = os.path.join(path, appname) - if opinion: - path = os.path.join(path, "Cache") - elif system == 'darwin': - path = os.path.expanduser('~/Library/Caches') - if appname: - path = os.path.join(path, appname) - else: - path = os.getenv('XDG_CACHE_HOME', os.path.expanduser('~/.cache')) - if appname: - path = os.path.join(path, appname) - if appname and version: - path = os.path.join(path, version) - return path - - -def user_state_dir(appname=None, appauthor=None, version=None, roaming=False): - r"""Return full path to the user-specific state dir for this application. - - "appname" is the name of application. - If None, just the system directory is returned. - "appauthor" (only used on Windows) is the name of the - appauthor or distributing body for this application. Typically - it is the owning company name. This falls back to appname. You may - pass False to disable it. - "version" is an optional version path element to append to the - path. You might want to use this if you want multiple versions - of your app to be able to run independently. If used, this - would typically be ".". - Only applied when appname is present. - "roaming" (boolean, default False) can be set True to use the Windows - roaming appdata directory. That means that for users on a Windows - network setup for roaming profiles, this user data will be - sync'd on login. See - - for a discussion of issues. - - Typical user state directories are: - Mac OS X: same as user_data_dir - Unix: ~/.local/state/ # or in $XDG_STATE_HOME, if defined - Win *: same as user_data_dir - - For Unix, we follow this Debian proposal - to extend the XDG spec and support $XDG_STATE_HOME. - - That means, by default "~/.local/state/". - """ - if system in ["win32", "darwin"]: - path = user_data_dir(appname, appauthor, None, roaming) - else: - path = os.getenv('XDG_STATE_HOME', os.path.expanduser("~/.local/state")) - if appname: - path = os.path.join(path, appname) - if appname and version: - path = os.path.join(path, version) - return path - - -def user_log_dir(appname=None, appauthor=None, version=None, opinion=True): - r"""Return full path to the user-specific log dir for this application. - - "appname" is the name of application. - If None, just the system directory is returned. - "appauthor" (only used on Windows) is the name of the - appauthor or distributing body for this application. Typically - it is the owning company name. This falls back to appname. You may - pass False to disable it. - "version" is an optional version path element to append to the - path. You might want to use this if you want multiple versions - of your app to be able to run independently. If used, this - would typically be ".". - Only applied when appname is present. - "opinion" (boolean) can be False to disable the appending of - "Logs" to the base app data dir for Windows, and "log" to the - base cache dir for Unix. See discussion below. - - Typical user log directories are: - Mac OS X: ~/Library/Logs/ - Unix: ~/.cache//log # or under $XDG_CACHE_HOME if defined - Win XP: C:\Documents and Settings\\Local Settings\Application Data\\\Logs - Vista: C:\Users\\AppData\Local\\\Logs - - On Windows the only suggestion in the MSDN docs is that local settings - go in the `CSIDL_LOCAL_APPDATA` directory. (Note: I'm interested in - examples of what some windows apps use for a logs dir.) - - OPINION: This function appends "Logs" to the `CSIDL_LOCAL_APPDATA` - value for Windows and appends "log" to the user cache dir for Unix. - This can be disabled with the `opinion=False` option. - """ - if system == "darwin": - path = os.path.join( - os.path.expanduser('~/Library/Logs'), - appname) - elif system == "win32": - path = user_data_dir(appname, appauthor, version) - version = False - if opinion: - path = os.path.join(path, "Logs") - else: - path = user_cache_dir(appname, appauthor, version) - version = False - if opinion: - path = os.path.join(path, "log") - if appname and version: - path = os.path.join(path, version) - return path - - -class AppDirs(object): - """Convenience wrapper for getting application dirs.""" - def __init__(self, appname=None, appauthor=None, version=None, - roaming=False, multipath=False): - self.appname = appname - self.appauthor = appauthor - self.version = version - self.roaming = roaming - self.multipath = multipath - - @property - def user_data_dir(self): - return user_data_dir(self.appname, self.appauthor, - version=self.version, roaming=self.roaming) - - @property - def site_data_dir(self): - return site_data_dir(self.appname, self.appauthor, - version=self.version, multipath=self.multipath) - - @property - def user_config_dir(self): - return user_config_dir(self.appname, self.appauthor, - version=self.version, roaming=self.roaming) - - @property - def site_config_dir(self): - return site_config_dir(self.appname, self.appauthor, - version=self.version, multipath=self.multipath) - - @property - def user_cache_dir(self): - return user_cache_dir(self.appname, self.appauthor, - version=self.version) - - @property - def user_state_dir(self): - return user_state_dir(self.appname, self.appauthor, - version=self.version) - - @property - def user_log_dir(self): - return user_log_dir(self.appname, self.appauthor, - version=self.version) - - -#---- internal support stuff - -def _get_win_folder_from_registry(csidl_name): - """This is a fallback technique at best. I'm not sure if using the - registry for this guarantees us the correct answer for all CSIDL_* - names. - """ - if PY3: - import winreg as _winreg - else: - import _winreg - - shell_folder_name = { - "CSIDL_APPDATA": "AppData", - "CSIDL_COMMON_APPDATA": "Common AppData", - "CSIDL_LOCAL_APPDATA": "Local AppData", - }[csidl_name] - - key = _winreg.OpenKey( - _winreg.HKEY_CURRENT_USER, - r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" - ) - dir, type = _winreg.QueryValueEx(key, shell_folder_name) - return dir - - -def _get_win_folder_with_pywin32(csidl_name): - from win32com.shell import shellcon, shell - dir = shell.SHGetFolderPath(0, getattr(shellcon, csidl_name), 0, 0) - # Try to make this a unicode path because SHGetFolderPath does - # not return unicode strings when there is unicode data in the - # path. - try: - dir = unicode(dir) - - # Downgrade to short path name if have highbit chars. See - # . - has_high_char = False - for c in dir: - if ord(c) > 255: - has_high_char = True - break - if has_high_char: - try: - import win32api - dir = win32api.GetShortPathName(dir) - except ImportError: - pass - except UnicodeError: - pass - return dir - - -def _get_win_folder_with_ctypes(csidl_name): - import ctypes - - csidl_const = { - "CSIDL_APPDATA": 26, - "CSIDL_COMMON_APPDATA": 35, - "CSIDL_LOCAL_APPDATA": 28, - }[csidl_name] - - buf = ctypes.create_unicode_buffer(1024) - ctypes.windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf) - - # Downgrade to short path name if have highbit chars. See - # . - has_high_char = False - for c in buf: - if ord(c) > 255: - has_high_char = True - break - if has_high_char: - buf2 = ctypes.create_unicode_buffer(1024) - if ctypes.windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024): - buf = buf2 - - return buf.value - -def _get_win_folder_with_jna(csidl_name): - import array - from com.sun import jna - from com.sun.jna.platform import win32 - - buf_size = win32.WinDef.MAX_PATH * 2 - buf = array.zeros('c', buf_size) - shell = win32.Shell32.INSTANCE - shell.SHGetFolderPath(None, getattr(win32.ShlObj, csidl_name), None, win32.ShlObj.SHGFP_TYPE_CURRENT, buf) - dir = jna.Native.toString(buf.tostring()).rstrip("\0") - - # Downgrade to short path name if have highbit chars. See - # . - has_high_char = False - for c in dir: - if ord(c) > 255: - has_high_char = True - break - if has_high_char: - buf = array.zeros('c', buf_size) - kernel = win32.Kernel32.INSTANCE - if kernel.GetShortPathName(dir, buf, buf_size): - dir = jna.Native.toString(buf.tostring()).rstrip("\0") - - return dir - -if system == "win32": - try: - import win32com.shell - _get_win_folder = _get_win_folder_with_pywin32 - except ImportError: - try: - from ctypes import windll - _get_win_folder = _get_win_folder_with_ctypes - except ImportError: - try: - import com.sun.jna - _get_win_folder = _get_win_folder_with_jna - except ImportError: - _get_win_folder = _get_win_folder_from_registry - - -#---- self test code - -if __name__ == "__main__": - appname = "MyApp" - appauthor = "MyCompany" - - props = ("user_data_dir", - "user_config_dir", - "user_cache_dir", - "user_state_dir", - "user_log_dir", - "site_data_dir", - "site_config_dir") - - print("-- app dirs %s --" % __version__) - - print("-- app dirs (with optional 'version')") - dirs = AppDirs(appname, appauthor, version="1.0") - for prop in props: - print("%s: %s" % (prop, getattr(dirs, prop))) - - print("\n-- app dirs (without optional 'version')") - dirs = AppDirs(appname, appauthor) - for prop in props: - print("%s: %s" % (prop, getattr(dirs, prop))) - - print("\n-- app dirs (without optional 'appauthor')") - dirs = AppDirs(appname) - for prop in props: - print("%s: %s" % (prop, getattr(dirs, prop))) - - print("\n-- app dirs (with disabled 'appauthor')") - dirs = AppDirs(appname, appauthor=False) - for prop in props: - print("%s: %s" % (prop, getattr(dirs, prop))) diff --git a/lib/platformdirs/__init__.py b/lib/platformdirs/__init__.py new file mode 100644 index 00000000..3d5a5bda --- /dev/null +++ b/lib/platformdirs/__init__.py @@ -0,0 +1,628 @@ +""" +Utilities for determining application-specific dirs. See for details and +usage. +""" +from __future__ import annotations + +import os +import sys +from typing import TYPE_CHECKING + +from .api import PlatformDirsABC +from .version import __version__ +from .version import __version_tuple__ as __version_info__ + +if TYPE_CHECKING: + from pathlib import Path + + if sys.version_info >= (3, 8): # pragma: no cover (py38+) + from typing import Literal + else: # pragma: no cover (py38+) + from typing_extensions import Literal + + +def _set_platform_dir_class() -> type[PlatformDirsABC]: + if sys.platform == "win32": + from platformdirs.windows import Windows as Result + elif sys.platform == "darwin": + from platformdirs.macos import MacOS as Result + else: + from platformdirs.unix import Unix as Result + + if os.getenv("ANDROID_DATA") == "/data" and os.getenv("ANDROID_ROOT") == "/system": + if os.getenv("SHELL") or os.getenv("PREFIX"): + return Result + + from platformdirs.android import _android_folder + + if _android_folder() is not None: + from platformdirs.android import Android + + return Android # return to avoid redefinition of result + + return Result + + +PlatformDirs = _set_platform_dir_class() #: Currently active platform +AppDirs = PlatformDirs #: Backwards compatibility with appdirs + + +def user_data_dir( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + roaming: bool = False, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> str: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param roaming: See `roaming `. + :param ensure_exists: See `ensure_exists `. + :returns: data directory tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + roaming=roaming, + ensure_exists=ensure_exists, + ).user_data_dir + + +def site_data_dir( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + multipath: bool = False, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> str: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param multipath: See `roaming `. + :param ensure_exists: See `ensure_exists `. + :returns: data directory shared by users + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + multipath=multipath, + ensure_exists=ensure_exists, + ).site_data_dir + + +def user_config_dir( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + roaming: bool = False, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> str: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param roaming: See `roaming `. + :param ensure_exists: See `ensure_exists `. + :returns: config directory tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + roaming=roaming, + ensure_exists=ensure_exists, + ).user_config_dir + + +def site_config_dir( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + multipath: bool = False, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> str: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param multipath: See `roaming `. + :param ensure_exists: See `ensure_exists `. + :returns: config directory shared by the users + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + multipath=multipath, + ensure_exists=ensure_exists, + ).site_config_dir + + +def user_cache_dir( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + opinion: bool = True, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> str: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param opinion: See `roaming `. + :param ensure_exists: See `ensure_exists `. + :returns: cache directory tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + opinion=opinion, + ensure_exists=ensure_exists, + ).user_cache_dir + + +def site_cache_dir( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + opinion: bool = True, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> str: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param opinion: See `opinion `. + :param ensure_exists: See `ensure_exists `. + :returns: cache directory tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + opinion=opinion, + ensure_exists=ensure_exists, + ).site_cache_dir + + +def user_state_dir( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + roaming: bool = False, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> str: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param roaming: See `roaming `. + :param ensure_exists: See `ensure_exists `. + :returns: state directory tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + roaming=roaming, + ensure_exists=ensure_exists, + ).user_state_dir + + +def user_log_dir( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + opinion: bool = True, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> str: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param opinion: See `roaming `. + :param ensure_exists: See `ensure_exists `. + :returns: log directory tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + opinion=opinion, + ensure_exists=ensure_exists, + ).user_log_dir + + +def user_documents_dir() -> str: + """:returns: documents directory tied to the user""" + return PlatformDirs().user_documents_dir + + +def user_downloads_dir() -> str: + """:returns: downloads directory tied to the user""" + return PlatformDirs().user_downloads_dir + + +def user_pictures_dir() -> str: + """:returns: pictures directory tied to the user""" + return PlatformDirs().user_pictures_dir + + +def user_videos_dir() -> str: + """:returns: videos directory tied to the user""" + return PlatformDirs().user_videos_dir + + +def user_music_dir() -> str: + """:returns: music directory tied to the user""" + return PlatformDirs().user_music_dir + + +def user_desktop_dir() -> str: + """:returns: desktop directory tied to the user""" + return PlatformDirs().user_desktop_dir + + +def user_runtime_dir( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + opinion: bool = True, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> str: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param opinion: See `opinion `. + :param ensure_exists: See `ensure_exists `. + :returns: runtime directory tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + opinion=opinion, + ensure_exists=ensure_exists, + ).user_runtime_dir + + +def site_runtime_dir( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + opinion: bool = True, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> str: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param opinion: See `opinion `. + :param ensure_exists: See `ensure_exists `. + :returns: runtime directory shared by users + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + opinion=opinion, + ensure_exists=ensure_exists, + ).site_runtime_dir + + +def user_data_path( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + roaming: bool = False, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> Path: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param roaming: See `roaming `. + :param ensure_exists: See `ensure_exists `. + :returns: data path tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + roaming=roaming, + ensure_exists=ensure_exists, + ).user_data_path + + +def site_data_path( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + multipath: bool = False, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> Path: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param multipath: See `multipath `. + :param ensure_exists: See `ensure_exists `. + :returns: data path shared by users + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + multipath=multipath, + ensure_exists=ensure_exists, + ).site_data_path + + +def user_config_path( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + roaming: bool = False, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> Path: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param roaming: See `roaming `. + :param ensure_exists: See `ensure_exists `. + :returns: config path tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + roaming=roaming, + ensure_exists=ensure_exists, + ).user_config_path + + +def site_config_path( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + multipath: bool = False, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> Path: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param multipath: See `roaming `. + :param ensure_exists: See `ensure_exists `. + :returns: config path shared by the users + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + multipath=multipath, + ensure_exists=ensure_exists, + ).site_config_path + + +def site_cache_path( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + opinion: bool = True, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> Path: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param opinion: See `opinion `. + :param ensure_exists: See `ensure_exists `. + :returns: cache directory tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + opinion=opinion, + ensure_exists=ensure_exists, + ).site_cache_path + + +def user_cache_path( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + opinion: bool = True, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> Path: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param opinion: See `roaming `. + :param ensure_exists: See `ensure_exists `. + :returns: cache path tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + opinion=opinion, + ensure_exists=ensure_exists, + ).user_cache_path + + +def user_state_path( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + roaming: bool = False, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> Path: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param roaming: See `roaming `. + :param ensure_exists: See `ensure_exists `. + :returns: state path tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + roaming=roaming, + ensure_exists=ensure_exists, + ).user_state_path + + +def user_log_path( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + opinion: bool = True, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> Path: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param opinion: See `roaming `. + :param ensure_exists: See `ensure_exists `. + :returns: log path tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + opinion=opinion, + ensure_exists=ensure_exists, + ).user_log_path + + +def user_documents_path() -> Path: + """:returns: documents path tied to the user""" + return PlatformDirs().user_documents_path + + +def user_downloads_path() -> Path: + """:returns: downloads path tied to the user""" + return PlatformDirs().user_downloads_path + + +def user_pictures_path() -> Path: + """:returns: pictures path tied to the user""" + return PlatformDirs().user_pictures_path + + +def user_videos_path() -> Path: + """:returns: videos path tied to the user""" + return PlatformDirs().user_videos_path + + +def user_music_path() -> Path: + """:returns: music path tied to the user""" + return PlatformDirs().user_music_path + + +def user_desktop_path() -> Path: + """:returns: desktop path tied to the user""" + return PlatformDirs().user_desktop_path + + +def user_runtime_path( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + opinion: bool = True, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> Path: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param opinion: See `opinion `. + :param ensure_exists: See `ensure_exists `. + :returns: runtime path tied to the user + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + opinion=opinion, + ensure_exists=ensure_exists, + ).user_runtime_path + + +def site_runtime_path( + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + opinion: bool = True, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 +) -> Path: + """ + :param appname: See `appname `. + :param appauthor: See `appauthor `. + :param version: See `version `. + :param opinion: See `opinion `. + :param ensure_exists: See `ensure_exists `. + :returns: runtime path shared by users + """ + return PlatformDirs( + appname=appname, + appauthor=appauthor, + version=version, + opinion=opinion, + ensure_exists=ensure_exists, + ).site_runtime_path + + +__all__ = [ + "__version__", + "__version_info__", + "PlatformDirs", + "AppDirs", + "PlatformDirsABC", + "user_data_dir", + "user_config_dir", + "user_cache_dir", + "user_state_dir", + "user_log_dir", + "user_documents_dir", + "user_downloads_dir", + "user_pictures_dir", + "user_videos_dir", + "user_music_dir", + "user_desktop_dir", + "user_runtime_dir", + "site_data_dir", + "site_config_dir", + "site_cache_dir", + "site_runtime_dir", + "user_data_path", + "user_config_path", + "user_cache_path", + "user_state_path", + "user_log_path", + "user_documents_path", + "user_downloads_path", + "user_pictures_path", + "user_videos_path", + "user_music_path", + "user_desktop_path", + "user_runtime_path", + "site_data_path", + "site_config_path", + "site_cache_path", + "site_runtime_path", +] diff --git a/lib/platformdirs/__main__.py b/lib/platformdirs/__main__.py new file mode 100644 index 00000000..3cefedbd --- /dev/null +++ b/lib/platformdirs/__main__.py @@ -0,0 +1,54 @@ +"""Main entry point.""" +from __future__ import annotations + +from platformdirs import PlatformDirs, __version__ + +PROPS = ( + "user_data_dir", + "user_config_dir", + "user_cache_dir", + "user_state_dir", + "user_log_dir", + "user_documents_dir", + "user_downloads_dir", + "user_pictures_dir", + "user_videos_dir", + "user_music_dir", + "user_runtime_dir", + "site_data_dir", + "site_config_dir", + "site_cache_dir", + "site_runtime_dir", +) + + +def main() -> None: + """Run main entry point.""" + app_name = "MyApp" + app_author = "MyCompany" + + print(f"-- platformdirs {__version__} --") # noqa: T201 + + print("-- app dirs (with optional 'version')") # noqa: T201 + dirs = PlatformDirs(app_name, app_author, version="1.0") + for prop in PROPS: + print(f"{prop}: {getattr(dirs, prop)}") # noqa: T201 + + print("\n-- app dirs (without optional 'version')") # noqa: T201 + dirs = PlatformDirs(app_name, app_author) + for prop in PROPS: + print(f"{prop}: {getattr(dirs, prop)}") # noqa: T201 + + print("\n-- app dirs (without optional 'appauthor')") # noqa: T201 + dirs = PlatformDirs(app_name) + for prop in PROPS: + print(f"{prop}: {getattr(dirs, prop)}") # noqa: T201 + + print("\n-- app dirs (with disabled 'appauthor')") # noqa: T201 + dirs = PlatformDirs(app_name, appauthor=False) + for prop in PROPS: + print(f"{prop}: {getattr(dirs, prop)}") # noqa: T201 + + +if __name__ == "__main__": + main() diff --git a/lib/platformdirs/android.py b/lib/platformdirs/android.py new file mode 100644 index 00000000..572559f8 --- /dev/null +++ b/lib/platformdirs/android.py @@ -0,0 +1,220 @@ +"""Android.""" +from __future__ import annotations + +import os +import re +import sys +from functools import lru_cache +from typing import cast + +from .api import PlatformDirsABC + + +class Android(PlatformDirsABC): + """ + Follows the guidance `from here `_. Makes use of the + `appname `, + `version `, + `ensure_exists `. + """ + + @property + def user_data_dir(self) -> str: + """:return: data directory tied to the user, e.g. ``/data/user///files/``""" + return self._append_app_name_and_version(cast(str, _android_folder()), "files") + + @property + def site_data_dir(self) -> str: + """:return: data directory shared by users, same as `user_data_dir`""" + return self.user_data_dir + + @property + def user_config_dir(self) -> str: + """ + :return: config directory tied to the user, e.g. \ + ``/data/user///shared_prefs/`` + """ + return self._append_app_name_and_version(cast(str, _android_folder()), "shared_prefs") + + @property + def site_config_dir(self) -> str: + """:return: config directory shared by the users, same as `user_config_dir`""" + return self.user_config_dir + + @property + def user_cache_dir(self) -> str: + """:return: cache directory tied to the user, e.g. e.g. ``/data/user///cache/``""" + return self._append_app_name_and_version(cast(str, _android_folder()), "cache") + + @property + def site_cache_dir(self) -> str: + """:return: cache directory shared by users, same as `user_cache_dir`""" + return self.user_cache_dir + + @property + def user_state_dir(self) -> str: + """:return: state directory tied to the user, same as `user_data_dir`""" + return self.user_data_dir + + @property + def user_log_dir(self) -> str: + """ + :return: log directory tied to the user, same as `user_cache_dir` if not opinionated else ``log`` in it, + e.g. ``/data/user///cache//log`` + """ + path = self.user_cache_dir + if self.opinion: + path = os.path.join(path, "log") # noqa: PTH118 + return path + + @property + def user_documents_dir(self) -> str: + """:return: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``""" + return _android_documents_folder() + + @property + def user_downloads_dir(self) -> str: + """:return: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``""" + return _android_downloads_folder() + + @property + def user_pictures_dir(self) -> str: + """:return: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``""" + return _android_pictures_folder() + + @property + def user_videos_dir(self) -> str: + """:return: videos directory tied to the user e.g. ``/storage/emulated/0/DCIM/Camera``""" + return _android_videos_folder() + + @property + def user_music_dir(self) -> str: + """:return: music directory tied to the user e.g. ``/storage/emulated/0/Music``""" + return _android_music_folder() + + @property + def user_desktop_dir(self) -> str: + """:return: desktop directory tied to the user e.g. ``/storage/emulated/0/Desktop``""" + return "/storage/emulated/0/Desktop" + + @property + def user_runtime_dir(self) -> str: + """ + :return: runtime directory tied to the user, same as `user_cache_dir` if not opinionated else ``tmp`` in it, + e.g. ``/data/user///cache//tmp`` + """ + path = self.user_cache_dir + if self.opinion: + path = os.path.join(path, "tmp") # noqa: PTH118 + return path + + @property + def site_runtime_dir(self) -> str: + """:return: runtime directory shared by users, same as `user_runtime_dir`""" + return self.user_runtime_dir + + +@lru_cache(maxsize=1) +def _android_folder() -> str | None: + """:return: base folder for the Android OS or None if it cannot be found""" + try: + # First try to get path to android app via pyjnius + from jnius import autoclass + + context = autoclass("android.content.Context") + result: str | None = context.getFilesDir().getParentFile().getAbsolutePath() + except Exception: # noqa: BLE001 + # if fails find an android folder looking path on the sys.path + pattern = re.compile(r"/data/(data|user/\d+)/(.+)/files") + for path in sys.path: + if pattern.match(path): + result = path.split("/files")[0] + break + else: + result = None + return result + + +@lru_cache(maxsize=1) +def _android_documents_folder() -> str: + """:return: documents folder for the Android OS""" + # Get directories with pyjnius + try: + from jnius import autoclass + + context = autoclass("android.content.Context") + environment = autoclass("android.os.Environment") + documents_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DOCUMENTS).getAbsolutePath() + except Exception: # noqa: BLE001 + documents_dir = "/storage/emulated/0/Documents" + + return documents_dir + + +@lru_cache(maxsize=1) +def _android_downloads_folder() -> str: + """:return: downloads folder for the Android OS""" + # Get directories with pyjnius + try: + from jnius import autoclass + + context = autoclass("android.content.Context") + environment = autoclass("android.os.Environment") + downloads_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DOWNLOADS).getAbsolutePath() + except Exception: # noqa: BLE001 + downloads_dir = "/storage/emulated/0/Downloads" + + return downloads_dir + + +@lru_cache(maxsize=1) +def _android_pictures_folder() -> str: + """:return: pictures folder for the Android OS""" + # Get directories with pyjnius + try: + from jnius import autoclass + + context = autoclass("android.content.Context") + environment = autoclass("android.os.Environment") + pictures_dir: str = context.getExternalFilesDir(environment.DIRECTORY_PICTURES).getAbsolutePath() + except Exception: # noqa: BLE001 + pictures_dir = "/storage/emulated/0/Pictures" + + return pictures_dir + + +@lru_cache(maxsize=1) +def _android_videos_folder() -> str: + """:return: videos folder for the Android OS""" + # Get directories with pyjnius + try: + from jnius import autoclass + + context = autoclass("android.content.Context") + environment = autoclass("android.os.Environment") + videos_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DCIM).getAbsolutePath() + except Exception: # noqa: BLE001 + videos_dir = "/storage/emulated/0/DCIM/Camera" + + return videos_dir + + +@lru_cache(maxsize=1) +def _android_music_folder() -> str: + """:return: music folder for the Android OS""" + # Get directories with pyjnius + try: + from jnius import autoclass + + context = autoclass("android.content.Context") + environment = autoclass("android.os.Environment") + music_dir: str = context.getExternalFilesDir(environment.DIRECTORY_MUSIC).getAbsolutePath() + except Exception: # noqa: BLE001 + music_dir = "/storage/emulated/0/Music" + + return music_dir + + +__all__ = [ + "Android", +] diff --git a/lib/platformdirs/api.py b/lib/platformdirs/api.py new file mode 100644 index 00000000..aa9ce7b9 --- /dev/null +++ b/lib/platformdirs/api.py @@ -0,0 +1,243 @@ +"""Base API.""" +from __future__ import annotations + +import os +from abc import ABC, abstractmethod +from pathlib import Path +from typing import TYPE_CHECKING + +if TYPE_CHECKING: + import sys + + if sys.version_info >= (3, 8): # pragma: no cover (py38+) + from typing import Literal + else: # pragma: no cover (py38+) + from typing_extensions import Literal + + +class PlatformDirsABC(ABC): + """Abstract base class for platform directories.""" + + def __init__( # noqa: PLR0913 + self, + appname: str | None = None, + appauthor: str | None | Literal[False] = None, + version: str | None = None, + roaming: bool = False, # noqa: FBT001, FBT002 + multipath: bool = False, # noqa: FBT001, FBT002 + opinion: bool = True, # noqa: FBT001, FBT002 + ensure_exists: bool = False, # noqa: FBT001, FBT002 + ) -> None: + """ + Create a new platform directory. + + :param appname: See `appname`. + :param appauthor: See `appauthor`. + :param version: See `version`. + :param roaming: See `roaming`. + :param multipath: See `multipath`. + :param opinion: See `opinion`. + :param ensure_exists: See `ensure_exists`. + """ + self.appname = appname #: The name of application. + self.appauthor = appauthor + """ + The name of the app author or distributing body for this application. Typically, it is the owning company name. + Defaults to `appname`. You may pass ``False`` to disable it. + """ + self.version = version + """ + An optional version path element to append to the path. You might want to use this if you want multiple versions + of your app to be able to run independently. If used, this would typically be ``.``. + """ + self.roaming = roaming + """ + Whether to use the roaming appdata directory on Windows. That means that for users on a Windows network setup + for roaming profiles, this user data will be synced on login (see + `here `_). + """ + self.multipath = multipath + """ + An optional parameter which indicates that the entire list of data dirs should be returned. + By default, the first item would only be returned. + """ + self.opinion = opinion #: A flag to indicating to use opinionated values. + self.ensure_exists = ensure_exists + """ + Optionally create the directory (and any missing parents) upon access if it does not exist. + By default, no directories are created. + """ + + def _append_app_name_and_version(self, *base: str) -> str: + params = list(base[1:]) + if self.appname: + params.append(self.appname) + if self.version: + params.append(self.version) + path = os.path.join(base[0], *params) # noqa: PTH118 + self._optionally_create_directory(path) + return path + + def _optionally_create_directory(self, path: str) -> None: + if self.ensure_exists: + Path(path).mkdir(parents=True, exist_ok=True) + + @property + @abstractmethod + def user_data_dir(self) -> str: + """:return: data directory tied to the user""" + + @property + @abstractmethod + def site_data_dir(self) -> str: + """:return: data directory shared by users""" + + @property + @abstractmethod + def user_config_dir(self) -> str: + """:return: config directory tied to the user""" + + @property + @abstractmethod + def site_config_dir(self) -> str: + """:return: config directory shared by the users""" + + @property + @abstractmethod + def user_cache_dir(self) -> str: + """:return: cache directory tied to the user""" + + @property + @abstractmethod + def site_cache_dir(self) -> str: + """:return: cache directory shared by users""" + + @property + @abstractmethod + def user_state_dir(self) -> str: + """:return: state directory tied to the user""" + + @property + @abstractmethod + def user_log_dir(self) -> str: + """:return: log directory tied to the user""" + + @property + @abstractmethod + def user_documents_dir(self) -> str: + """:return: documents directory tied to the user""" + + @property + @abstractmethod + def user_downloads_dir(self) -> str: + """:return: downloads directory tied to the user""" + + @property + @abstractmethod + def user_pictures_dir(self) -> str: + """:return: pictures directory tied to the user""" + + @property + @abstractmethod + def user_videos_dir(self) -> str: + """:return: videos directory tied to the user""" + + @property + @abstractmethod + def user_music_dir(self) -> str: + """:return: music directory tied to the user""" + + @property + @abstractmethod + def user_desktop_dir(self) -> str: + """:return: desktop directory tied to the user""" + + @property + @abstractmethod + def user_runtime_dir(self) -> str: + """:return: runtime directory tied to the user""" + + @property + @abstractmethod + def site_runtime_dir(self) -> str: + """:return: runtime directory shared by users""" + + @property + def user_data_path(self) -> Path: + """:return: data path tied to the user""" + return Path(self.user_data_dir) + + @property + def site_data_path(self) -> Path: + """:return: data path shared by users""" + return Path(self.site_data_dir) + + @property + def user_config_path(self) -> Path: + """:return: config path tied to the user""" + return Path(self.user_config_dir) + + @property + def site_config_path(self) -> Path: + """:return: config path shared by the users""" + return Path(self.site_config_dir) + + @property + def user_cache_path(self) -> Path: + """:return: cache path tied to the user""" + return Path(self.user_cache_dir) + + @property + def site_cache_path(self) -> Path: + """:return: cache path shared by users""" + return Path(self.site_cache_dir) + + @property + def user_state_path(self) -> Path: + """:return: state path tied to the user""" + return Path(self.user_state_dir) + + @property + def user_log_path(self) -> Path: + """:return: log path tied to the user""" + return Path(self.user_log_dir) + + @property + def user_documents_path(self) -> Path: + """:return: documents path tied to the user""" + return Path(self.user_documents_dir) + + @property + def user_downloads_path(self) -> Path: + """:return: downloads path tied to the user""" + return Path(self.user_downloads_dir) + + @property + def user_pictures_path(self) -> Path: + """:return: pictures path tied to the user""" + return Path(self.user_pictures_dir) + + @property + def user_videos_path(self) -> Path: + """:return: videos path tied to the user""" + return Path(self.user_videos_dir) + + @property + def user_music_path(self) -> Path: + """:return: music path tied to the user""" + return Path(self.user_music_dir) + + @property + def user_desktop_path(self) -> Path: + """:return: desktop path tied to the user""" + return Path(self.user_desktop_dir) + + @property + def user_runtime_path(self) -> Path: + """:return: runtime path tied to the user""" + return Path(self.user_runtime_dir) + + @property + def site_runtime_path(self) -> Path: + """:return: runtime path shared by users""" + return Path(self.site_runtime_dir) diff --git a/lib/platformdirs/macos.py b/lib/platformdirs/macos.py new file mode 100644 index 00000000..c01ce163 --- /dev/null +++ b/lib/platformdirs/macos.py @@ -0,0 +1,126 @@ +"""macOS.""" +from __future__ import annotations + +import os.path +import sys + +from .api import PlatformDirsABC + + +class MacOS(PlatformDirsABC): + """ + Platform directories for the macOS operating system. Follows the guidance from `Apple documentation + `_. + Makes use of the `appname `, + `version `, + `ensure_exists `. + """ + + @property + def user_data_dir(self) -> str: + """:return: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``""" + return self._append_app_name_and_version(os.path.expanduser("~/Library/Application Support")) # noqa: PTH111 + + @property + def site_data_dir(self) -> str: + """ + :return: data directory shared by users, e.g. ``/Library/Application Support/$appname/$version``. + If we're using a Python binary managed by `Homebrew `_, the directory + will be under the Homebrew prefix, e.g. ``/opt/homebrew/share/$appname/$version``. + If `multipath ` is enabled and we're in Homebrew, + the response is a multi-path string separated by ":", e.g. + ``/opt/homebrew/share/$appname/$version:/Library/Application Support/$appname/$version`` + """ + is_homebrew = sys.prefix.startswith("/opt/homebrew") + path_list = [self._append_app_name_and_version("/opt/homebrew/share")] if is_homebrew else [] + path_list.append(self._append_app_name_and_version("/Library/Application Support")) + if self.multipath: + return os.pathsep.join(path_list) + return path_list[0] + + @property + def user_config_dir(self) -> str: + """:return: config directory tied to the user, same as `user_data_dir`""" + return self.user_data_dir + + @property + def site_config_dir(self) -> str: + """:return: config directory shared by the users, same as `site_data_dir`""" + return self.site_data_dir + + @property + def user_cache_dir(self) -> str: + """:return: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``""" + return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches")) # noqa: PTH111 + + @property + def site_cache_dir(self) -> str: + """ + :return: cache directory shared by users, e.g. ``/Library/Caches/$appname/$version``. + If we're using a Python binary managed by `Homebrew `_, the directory + will be under the Homebrew prefix, e.g. ``/opt/homebrew/var/cache/$appname/$version``. + If `multipath ` is enabled and we're in Homebrew, + the response is a multi-path string separated by ":", e.g. + ``/opt/homebrew/var/cache/$appname/$version:/Library/Caches/$appname/$version`` + """ + is_homebrew = sys.prefix.startswith("/opt/homebrew") + path_list = [self._append_app_name_and_version("/opt/homebrew/var/cache")] if is_homebrew else [] + path_list.append(self._append_app_name_and_version("/Library/Caches")) + if self.multipath: + return os.pathsep.join(path_list) + return path_list[0] + + @property + def user_state_dir(self) -> str: + """:return: state directory tied to the user, same as `user_data_dir`""" + return self.user_data_dir + + @property + def user_log_dir(self) -> str: + """:return: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``""" + return self._append_app_name_and_version(os.path.expanduser("~/Library/Logs")) # noqa: PTH111 + + @property + def user_documents_dir(self) -> str: + """:return: documents directory tied to the user, e.g. ``~/Documents``""" + return os.path.expanduser("~/Documents") # noqa: PTH111 + + @property + def user_downloads_dir(self) -> str: + """:return: downloads directory tied to the user, e.g. ``~/Downloads``""" + return os.path.expanduser("~/Downloads") # noqa: PTH111 + + @property + def user_pictures_dir(self) -> str: + """:return: pictures directory tied to the user, e.g. ``~/Pictures``""" + return os.path.expanduser("~/Pictures") # noqa: PTH111 + + @property + def user_videos_dir(self) -> str: + """:return: videos directory tied to the user, e.g. ``~/Movies``""" + return os.path.expanduser("~/Movies") # noqa: PTH111 + + @property + def user_music_dir(self) -> str: + """:return: music directory tied to the user, e.g. ``~/Music``""" + return os.path.expanduser("~/Music") # noqa: PTH111 + + @property + def user_desktop_dir(self) -> str: + """:return: desktop directory tied to the user, e.g. ``~/Desktop``""" + return os.path.expanduser("~/Desktop") # noqa: PTH111 + + @property + def user_runtime_dir(self) -> str: + """:return: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``""" + return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches/TemporaryItems")) # noqa: PTH111 + + @property + def site_runtime_dir(self) -> str: + """:return: runtime directory shared by users, same as `user_runtime_dir`""" + return self.user_runtime_dir + + +__all__ = [ + "MacOS", +] diff --git a/lib/platformdirs/py.typed b/lib/platformdirs/py.typed new file mode 100644 index 00000000..e69de29b diff --git a/lib/platformdirs/unix.py b/lib/platformdirs/unix.py new file mode 100644 index 00000000..1d0174f2 --- /dev/null +++ b/lib/platformdirs/unix.py @@ -0,0 +1,251 @@ +"""Unix.""" +from __future__ import annotations + +import os +import sys +from configparser import ConfigParser +from pathlib import Path + +from .api import PlatformDirsABC + +if sys.platform == "win32": + + def getuid() -> int: + msg = "should only be used on Unix" + raise RuntimeError(msg) + +else: + from os import getuid + + +class Unix(PlatformDirsABC): + """ + On Unix/Linux, we follow the + `XDG Basedir Spec `_. The spec allows + overriding directories with environment variables. The examples show are the default values, alongside the name of + the environment variable that overrides them. Makes use of the + `appname `, + `version `, + `multipath `, + `opinion `, + `ensure_exists `. + """ + + @property + def user_data_dir(self) -> str: + """ + :return: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or + ``$XDG_DATA_HOME/$appname/$version`` + """ + path = os.environ.get("XDG_DATA_HOME", "") + if not path.strip(): + path = os.path.expanduser("~/.local/share") # noqa: PTH111 + return self._append_app_name_and_version(path) + + @property + def site_data_dir(self) -> str: + """ + :return: data directories shared by users (if `multipath ` is + enabled and ``XDG_DATA_DIR`` is set and a multi path the response is also a multi path separated by the OS + path separator), e.g. ``/usr/local/share/$appname/$version`` or ``/usr/share/$appname/$version`` + """ + # XDG default for $XDG_DATA_DIRS; only first, if multipath is False + path = os.environ.get("XDG_DATA_DIRS", "") + if not path.strip(): + path = f"/usr/local/share{os.pathsep}/usr/share" + return self._with_multi_path(path) + + def _with_multi_path(self, path: str) -> str: + path_list = path.split(os.pathsep) + if not self.multipath: + path_list = path_list[0:1] + path_list = [self._append_app_name_and_version(os.path.expanduser(p)) for p in path_list] # noqa: PTH111 + return os.pathsep.join(path_list) + + @property + def user_config_dir(self) -> str: + """ + :return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or + ``$XDG_CONFIG_HOME/$appname/$version`` + """ + path = os.environ.get("XDG_CONFIG_HOME", "") + if not path.strip(): + path = os.path.expanduser("~/.config") # noqa: PTH111 + return self._append_app_name_and_version(path) + + @property + def site_config_dir(self) -> str: + """ + :return: config directories shared by users (if `multipath ` + is enabled and ``XDG_DATA_DIR`` is set and a multi path the response is also a multi path separated by the OS + path separator), e.g. ``/etc/xdg/$appname/$version`` + """ + # XDG default for $XDG_CONFIG_DIRS only first, if multipath is False + path = os.environ.get("XDG_CONFIG_DIRS", "") + if not path.strip(): + path = "/etc/xdg" + return self._with_multi_path(path) + + @property + def user_cache_dir(self) -> str: + """ + :return: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or + ``~/$XDG_CACHE_HOME/$appname/$version`` + """ + path = os.environ.get("XDG_CACHE_HOME", "") + if not path.strip(): + path = os.path.expanduser("~/.cache") # noqa: PTH111 + return self._append_app_name_and_version(path) + + @property + def site_cache_dir(self) -> str: + """:return: cache directory shared by users, e.g. ``/var/tmp/$appname/$version``""" + return self._append_app_name_and_version("/var/tmp") # noqa: S108 + + @property + def user_state_dir(self) -> str: + """ + :return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or + ``$XDG_STATE_HOME/$appname/$version`` + """ + path = os.environ.get("XDG_STATE_HOME", "") + if not path.strip(): + path = os.path.expanduser("~/.local/state") # noqa: PTH111 + return self._append_app_name_and_version(path) + + @property + def user_log_dir(self) -> str: + """:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in it""" + path = self.user_state_dir + if self.opinion: + path = os.path.join(path, "log") # noqa: PTH118 + self._optionally_create_directory(path) + return path + + @property + def user_documents_dir(self) -> str: + """:return: documents directory tied to the user, e.g. ``~/Documents``""" + return _get_user_media_dir("XDG_DOCUMENTS_DIR", "~/Documents") + + @property + def user_downloads_dir(self) -> str: + """:return: downloads directory tied to the user, e.g. ``~/Downloads``""" + return _get_user_media_dir("XDG_DOWNLOAD_DIR", "~/Downloads") + + @property + def user_pictures_dir(self) -> str: + """:return: pictures directory tied to the user, e.g. ``~/Pictures``""" + return _get_user_media_dir("XDG_PICTURES_DIR", "~/Pictures") + + @property + def user_videos_dir(self) -> str: + """:return: videos directory tied to the user, e.g. ``~/Videos``""" + return _get_user_media_dir("XDG_VIDEOS_DIR", "~/Videos") + + @property + def user_music_dir(self) -> str: + """:return: music directory tied to the user, e.g. ``~/Music``""" + return _get_user_media_dir("XDG_MUSIC_DIR", "~/Music") + + @property + def user_desktop_dir(self) -> str: + """:return: desktop directory tied to the user, e.g. ``~/Desktop``""" + return _get_user_media_dir("XDG_DESKTOP_DIR", "~/Desktop") + + @property + def user_runtime_dir(self) -> str: + """ + :return: runtime directory tied to the user, e.g. ``/run/user/$(id -u)/$appname/$version`` or + ``$XDG_RUNTIME_DIR/$appname/$version``. + + For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/user/$(id -u)/$appname/$version`` if + exists, otherwise ``/tmp/runtime-$(id -u)/$appname/$version``, if``$XDG_RUNTIME_DIR`` + is not set. + """ + path = os.environ.get("XDG_RUNTIME_DIR", "") + if not path.strip(): + if sys.platform.startswith(("freebsd", "openbsd", "netbsd")): + path = f"/var/run/user/{getuid()}" + if not Path(path).exists(): + path = f"/tmp/runtime-{getuid()}" # noqa: S108 + else: + path = f"/run/user/{getuid()}" + return self._append_app_name_and_version(path) + + @property + def site_runtime_dir(self) -> str: + """ + :return: runtime directory shared by users, e.g. ``/run/$appname/$version`` or \ + ``$XDG_RUNTIME_DIR/$appname/$version``. + + Note that this behaves almost exactly like `user_runtime_dir` if ``$XDG_RUNTIME_DIR`` is set, but will + fall back to paths associated to the root user instead of a regular logged-in user if it's not set. + + If you wish to ensure that a logged-in root user path is returned e.g. ``/run/user/0``, use `user_runtime_dir` + instead. + + For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/$appname/$version`` if ``$XDG_RUNTIME_DIR`` is not set. + """ + path = os.environ.get("XDG_RUNTIME_DIR", "") + if not path.strip(): + if sys.platform.startswith(("freebsd", "openbsd", "netbsd")): + path = "/var/run" + else: + path = "/run" + return self._append_app_name_and_version(path) + + @property + def site_data_path(self) -> Path: + """:return: data path shared by users. Only return first item, even if ``multipath`` is set to ``True``""" + return self._first_item_as_path_if_multipath(self.site_data_dir) + + @property + def site_config_path(self) -> Path: + """:return: config path shared by the users. Only return first item, even if ``multipath`` is set to ``True``""" + return self._first_item_as_path_if_multipath(self.site_config_dir) + + @property + def site_cache_path(self) -> Path: + """:return: cache path shared by users. Only return first item, even if ``multipath`` is set to ``True``""" + return self._first_item_as_path_if_multipath(self.site_cache_dir) + + def _first_item_as_path_if_multipath(self, directory: str) -> Path: + if self.multipath: + # If multipath is True, the first path is returned. + directory = directory.split(os.pathsep)[0] + return Path(directory) + + +def _get_user_media_dir(env_var: str, fallback_tilde_path: str) -> str: + media_dir = _get_user_dirs_folder(env_var) + if media_dir is None: + media_dir = os.environ.get(env_var, "").strip() + if not media_dir: + media_dir = os.path.expanduser(fallback_tilde_path) # noqa: PTH111 + + return media_dir + + +def _get_user_dirs_folder(key: str) -> str | None: + """Return directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/.""" + user_dirs_config_path = Path(Unix().user_config_dir) / "user-dirs.dirs" + if user_dirs_config_path.exists(): + parser = ConfigParser() + + with user_dirs_config_path.open() as stream: + # Add fake section header, so ConfigParser doesn't complain + parser.read_string(f"[top]\n{stream.read()}") + + if key not in parser["top"]: + return None + + path = parser["top"][key].strip('"') + # Handle relative home paths + return path.replace("$HOME", os.path.expanduser("~")) # noqa: PTH111 + + return None + + +__all__ = [ + "Unix", +] diff --git a/lib/platformdirs/version.py b/lib/platformdirs/version.py new file mode 100644 index 00000000..c2ef2084 --- /dev/null +++ b/lib/platformdirs/version.py @@ -0,0 +1,16 @@ +# file generated by setuptools_scm +# don't change, don't track in version control +TYPE_CHECKING = False +if TYPE_CHECKING: + from typing import Tuple, Union + VERSION_TUPLE = Tuple[Union[int, str], ...] +else: + VERSION_TUPLE = object + +version: str +__version__: str +__version_tuple__: VERSION_TUPLE +version_tuple: VERSION_TUPLE + +__version__ = version = '3.11.0' +__version_tuple__ = version_tuple = (3, 11, 0) diff --git a/lib/platformdirs/windows.py b/lib/platformdirs/windows.py new file mode 100644 index 00000000..751143ad --- /dev/null +++ b/lib/platformdirs/windows.py @@ -0,0 +1,266 @@ +"""Windows.""" +from __future__ import annotations + +import ctypes +import os +import sys +from functools import lru_cache +from typing import TYPE_CHECKING + +from .api import PlatformDirsABC + +if TYPE_CHECKING: + from collections.abc import Callable + + +class Windows(PlatformDirsABC): + """ + `MSDN on where to store app data files + `_. + Makes use of the + `appname `, + `appauthor `, + `version `, + `roaming `, + `opinion `, + `ensure_exists `. + """ + + @property + def user_data_dir(self) -> str: + """ + :return: data directory tied to the user, e.g. + ``%USERPROFILE%\\AppData\\Local\\$appauthor\\$appname`` (not roaming) or + ``%USERPROFILE%\\AppData\\Roaming\\$appauthor\\$appname`` (roaming) + """ + const = "CSIDL_APPDATA" if self.roaming else "CSIDL_LOCAL_APPDATA" + path = os.path.normpath(get_win_folder(const)) + return self._append_parts(path) + + def _append_parts(self, path: str, *, opinion_value: str | None = None) -> str: + params = [] + if self.appname: + if self.appauthor is not False: + author = self.appauthor or self.appname + params.append(author) + params.append(self.appname) + if opinion_value is not None and self.opinion: + params.append(opinion_value) + if self.version: + params.append(self.version) + path = os.path.join(path, *params) # noqa: PTH118 + self._optionally_create_directory(path) + return path + + @property + def site_data_dir(self) -> str: + """:return: data directory shared by users, e.g. ``C:\\ProgramData\\$appauthor\\$appname``""" + path = os.path.normpath(get_win_folder("CSIDL_COMMON_APPDATA")) + return self._append_parts(path) + + @property + def user_config_dir(self) -> str: + """:return: config directory tied to the user, same as `user_data_dir`""" + return self.user_data_dir + + @property + def site_config_dir(self) -> str: + """:return: config directory shared by the users, same as `site_data_dir`""" + return self.site_data_dir + + @property + def user_cache_dir(self) -> str: + """ + :return: cache directory tied to the user (if opinionated with ``Cache`` folder within ``$appname``) e.g. + ``%USERPROFILE%\\AppData\\Local\\$appauthor\\$appname\\Cache\\$version`` + """ + path = os.path.normpath(get_win_folder("CSIDL_LOCAL_APPDATA")) + return self._append_parts(path, opinion_value="Cache") + + @property + def site_cache_dir(self) -> str: + """:return: cache directory shared by users, e.g. ``C:\\ProgramData\\$appauthor\\$appname\\Cache\\$version``""" + path = os.path.normpath(get_win_folder("CSIDL_COMMON_APPDATA")) + return self._append_parts(path, opinion_value="Cache") + + @property + def user_state_dir(self) -> str: + """:return: state directory tied to the user, same as `user_data_dir`""" + return self.user_data_dir + + @property + def user_log_dir(self) -> str: + """:return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in it""" + path = self.user_data_dir + if self.opinion: + path = os.path.join(path, "Logs") # noqa: PTH118 + self._optionally_create_directory(path) + return path + + @property + def user_documents_dir(self) -> str: + """:return: documents directory tied to the user e.g. ``%USERPROFILE%\\Documents``""" + return os.path.normpath(get_win_folder("CSIDL_PERSONAL")) + + @property + def user_downloads_dir(self) -> str: + """:return: downloads directory tied to the user e.g. ``%USERPROFILE%\\Downloads``""" + return os.path.normpath(get_win_folder("CSIDL_DOWNLOADS")) + + @property + def user_pictures_dir(self) -> str: + """:return: pictures directory tied to the user e.g. ``%USERPROFILE%\\Pictures``""" + return os.path.normpath(get_win_folder("CSIDL_MYPICTURES")) + + @property + def user_videos_dir(self) -> str: + """:return: videos directory tied to the user e.g. ``%USERPROFILE%\\Videos``""" + return os.path.normpath(get_win_folder("CSIDL_MYVIDEO")) + + @property + def user_music_dir(self) -> str: + """:return: music directory tied to the user e.g. ``%USERPROFILE%\\Music``""" + return os.path.normpath(get_win_folder("CSIDL_MYMUSIC")) + + @property + def user_desktop_dir(self) -> str: + """:return: desktop directory tied to the user, e.g. ``%USERPROFILE%\\Desktop``""" + return os.path.normpath(get_win_folder("CSIDL_DESKTOPDIRECTORY")) + + @property + def user_runtime_dir(self) -> str: + """ + :return: runtime directory tied to the user, e.g. + ``%USERPROFILE%\\AppData\\Local\\Temp\\$appauthor\\$appname`` + """ + path = os.path.normpath(os.path.join(get_win_folder("CSIDL_LOCAL_APPDATA"), "Temp")) # noqa: PTH118 + return self._append_parts(path) + + @property + def site_runtime_dir(self) -> str: + """:return: runtime directory shared by users, same as `user_runtime_dir`""" + return self.user_runtime_dir + + +def get_win_folder_from_env_vars(csidl_name: str) -> str: + """Get folder from environment variables.""" + result = get_win_folder_if_csidl_name_not_env_var(csidl_name) + if result is not None: + return result + + env_var_name = { + "CSIDL_APPDATA": "APPDATA", + "CSIDL_COMMON_APPDATA": "ALLUSERSPROFILE", + "CSIDL_LOCAL_APPDATA": "LOCALAPPDATA", + }.get(csidl_name) + if env_var_name is None: + msg = f"Unknown CSIDL name: {csidl_name}" + raise ValueError(msg) + result = os.environ.get(env_var_name) + if result is None: + msg = f"Unset environment variable: {env_var_name}" + raise ValueError(msg) + return result + + +def get_win_folder_if_csidl_name_not_env_var(csidl_name: str) -> str | None: + """Get folder for a CSIDL name that does not exist as an environment variable.""" + if csidl_name == "CSIDL_PERSONAL": + return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Documents") # noqa: PTH118 + + if csidl_name == "CSIDL_DOWNLOADS": + return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Downloads") # noqa: PTH118 + + if csidl_name == "CSIDL_MYPICTURES": + return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Pictures") # noqa: PTH118 + + if csidl_name == "CSIDL_MYVIDEO": + return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Videos") # noqa: PTH118 + + if csidl_name == "CSIDL_MYMUSIC": + return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Music") # noqa: PTH118 + return None + + +def get_win_folder_from_registry(csidl_name: str) -> str: + """ + Get folder from the registry. + + This is a fallback technique at best. I'm not sure if using the registry for these guarantees us the correct answer + for all CSIDL_* names. + """ + shell_folder_name = { + "CSIDL_APPDATA": "AppData", + "CSIDL_COMMON_APPDATA": "Common AppData", + "CSIDL_LOCAL_APPDATA": "Local AppData", + "CSIDL_PERSONAL": "Personal", + "CSIDL_DOWNLOADS": "{374DE290-123F-4565-9164-39C4925E467B}", + "CSIDL_MYPICTURES": "My Pictures", + "CSIDL_MYVIDEO": "My Video", + "CSIDL_MYMUSIC": "My Music", + }.get(csidl_name) + if shell_folder_name is None: + msg = f"Unknown CSIDL name: {csidl_name}" + raise ValueError(msg) + if sys.platform != "win32": # only needed for mypy type checker to know that this code runs only on Windows + raise NotImplementedError + import winreg + + key = winreg.OpenKey(winreg.HKEY_CURRENT_USER, r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders") + directory, _ = winreg.QueryValueEx(key, shell_folder_name) + return str(directory) + + +def get_win_folder_via_ctypes(csidl_name: str) -> str: + """Get folder with ctypes.""" + # There is no 'CSIDL_DOWNLOADS'. + # Use 'CSIDL_PROFILE' (40) and append the default folder 'Downloads' instead. + # https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid + + csidl_const = { + "CSIDL_APPDATA": 26, + "CSIDL_COMMON_APPDATA": 35, + "CSIDL_LOCAL_APPDATA": 28, + "CSIDL_PERSONAL": 5, + "CSIDL_MYPICTURES": 39, + "CSIDL_MYVIDEO": 14, + "CSIDL_MYMUSIC": 13, + "CSIDL_DOWNLOADS": 40, + "CSIDL_DESKTOPDIRECTORY": 16, + }.get(csidl_name) + if csidl_const is None: + msg = f"Unknown CSIDL name: {csidl_name}" + raise ValueError(msg) + + buf = ctypes.create_unicode_buffer(1024) + windll = getattr(ctypes, "windll") # noqa: B009 # using getattr to avoid false positive with mypy type checker + windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf) + + # Downgrade to short path name if it has high-bit chars. + if any(ord(c) > 255 for c in buf): # noqa: PLR2004 + buf2 = ctypes.create_unicode_buffer(1024) + if windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024): + buf = buf2 + + if csidl_name == "CSIDL_DOWNLOADS": + return os.path.join(buf.value, "Downloads") # noqa: PTH118 + + return buf.value + + +def _pick_get_win_folder() -> Callable[[str], str]: + if hasattr(ctypes, "windll"): + return get_win_folder_via_ctypes + try: + import winreg # noqa: F401 + except ImportError: + return get_win_folder_from_env_vars + else: + return get_win_folder_from_registry + + +get_win_folder = lru_cache(maxsize=None)(_pick_get_win_folder()) + +__all__ = [ + "Windows", +] diff --git a/requirements.txt b/requirements.txt index 04578ef9..bc0a4bd6 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,4 +1,3 @@ -appdirs==1.4.4 apscheduler==3.10.1 arrow==1.2.3 backports.csv==1.0.7 @@ -28,6 +27,7 @@ MarkupSafe==2.1.3 musicbrainzngs==0.7.1 packaging==23.1 paho-mqtt==1.6.1 +platformdirs==3.11.0 plexapi==4.15.4 portend==3.2.0 profilehooks==1.12.0 From ae17d2dde036e216cf8c626596ad8cb6952ccb94 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sat, 4 Nov 2023 13:44:49 -0700 Subject: [PATCH 033/290] Switch actions/create-release to softprops/action-gh-release * actions/create-release deprecated --- .github/workflows/publish-installers.yml | 30 ++++-------------------- 1 file changed, 5 insertions(+), 25 deletions(-) diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml index 0e0b1082..a9f6cda3 100644 --- a/.github/workflows/publish-installers.yml +++ b/.github/workflows/publish-installers.yml @@ -125,41 +125,21 @@ jobs: echo "$EOF" >> $GITHUB_OUTPUT - name: Create Release - uses: actions/create-release@v1 + uses: softprops/action-gh-release@v1 id: create_release env: GITHUB_TOKEN: ${{ secrets.GHACTIONS_TOKEN }} with: tag_name: ${{ steps.get_version.outputs.RELEASE_VERSION }} - release_name: Tautulli ${{ steps.get_version.outputs.RELEASE_VERSION }} + name: Tautulli ${{ steps.get_version.outputs.RELEASE_VERSION }} body: | ## Changelog ##${{ steps.get_changelog.outputs.CHANGELOG }} - draft: false prerelease: ${{ endsWith(steps.get_version.outputs.RELEASE_VERSION, '-beta') }} - - - name: Upload Windows Installer - uses: actions/upload-release-asset@v1 - if: env.WORKFLOW_CONCLUSION == 'success' - env: - GITHUB_TOKEN: ${{ secrets.GHACTIONS_TOKEN }} - with: - upload_url: ${{ steps.create_release.outputs.upload_url }} - asset_path: Tautulli-windows-installer/Tautulli-windows-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.exe - asset_name: Tautulli-windows-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.exe - asset_content_type: application/vnd.microsoft.portable-executable - - - name: Upload MacOS Installer - uses: actions/upload-release-asset@v1 - if: env.WORKFLOW_CONCLUSION == 'success' - env: - GITHUB_TOKEN: ${{ secrets.GHACTIONS_TOKEN }} - with: - upload_url: ${{ steps.create_release.outputs.upload_url }} - asset_path: Tautulli-macos-installer/Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.pkg - asset_name: Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.pkg - asset_content_type: application/vnd.apple.installer+xml + files: | + Tautulli-windows-installer/Tautulli-windows-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.exe + Tautulli-macos-installer/Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.pkg discord: name: Discord Notification From ab5836a65b7846be835e148d89bd6de6ec781a4f Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Tue, 7 Nov 2023 17:12:19 -0800 Subject: [PATCH 034/290] Add duration_time notification parameter --- plexpy/common.py | 1 + plexpy/notification_handler.py | 1 + 2 files changed, 2 insertions(+) diff --git a/plexpy/common.py b/plexpy/common.py index 889d3f73..c692840b 100644 --- a/plexpy/common.py +++ b/plexpy/common.py @@ -547,6 +547,7 @@ NOTIFICATION_PARAMETERS = [ {'name': 'Duration', 'type': 'int', 'value': 'duration', 'description': 'The duration (in minutes) for the item.'}, {'name': 'Duration (sec)', 'type': 'int', 'value': 'duration_sec', 'description': 'The duration (in seconds) for the item.'}, {'name': 'Duration (ms)', 'type': 'int', 'value': 'duration_ms', 'description': 'The duration (in milliseconds) for the item.'}, + {'name': 'Duration Time', 'type': 'str', 'value': 'duration_time', 'description': 'The duration (in time format) for the item.'}, {'name': 'Poster URL', 'type': 'str', 'value': 'poster_url', 'description': 'A URL for the movie, TV show, or album poster.'}, {'name': 'Plex ID', 'type': 'str', 'value': 'plex_id', 'description': 'The Plex ID for the item.', 'example': 'e.g. 5d7769a9594b2b001e6a6b7e'}, {'name': 'Plex URL', 'type': 'str', 'value': 'plex_url', 'description': 'The Plex URL to your server for the item.'}, diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py index 8b4b8583..b6972268 100644 --- a/plexpy/notification_handler.py +++ b/plexpy/notification_handler.py @@ -1155,6 +1155,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m 'duration': duration, 'duration_sec': duration_sec, 'duration_ms': notify_params['duration'], + 'druation_time': arrow.get(duration_sec).format(duration_format), 'poster_title': notify_params['poster_title'], 'poster_url': notify_params['poster_url'], 'plex_id': notify_params['plex_id'], From 2da3714dd11c915706aa111993c7e946aff278ca Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Tue, 7 Nov 2023 17:18:48 -0800 Subject: [PATCH 035/290] Add CustomArrow date/time formatter --- plexpy/notification_handler.py | 47 ++++++++++++++++++++++++---------- 1 file changed, 33 insertions(+), 14 deletions(-) diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py index b6972268..a7336a30 100644 --- a/plexpy/notification_handler.py +++ b/plexpy/notification_handler.py @@ -18,6 +18,7 @@ from __future__ import division from __future__ import unicode_literals +from typing import Optional from future.builtins import next from future.builtins import map from future.builtins import str @@ -1006,21 +1007,21 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m 'product': notify_params['product'], 'player': notify_params['player'], 'ip_address': notify_params.get('ip_address', 'N/A'), - 'started_datestamp': arrow.get(notify_params['started']).format(date_format) if notify_params['started'] else '', - 'started_timestamp': arrow.get(notify_params['started']).format(time_format) if notify_params['started'] else '', + 'started_datestamp': CustomArrow(arrow.get(notify_params['started']), date_format) if notify_params['started'] else '', + 'started_timestamp': CustomArrow(arrow.get(notify_params['started']), time_format) if notify_params['started'] else '', 'started_unixtime': notify_params['started'], - 'stopped_datestamp': arrow.get(notify_params['stopped']).format(date_format) if notify_params['stopped'] else '', - 'stopped_timestamp': arrow.get(notify_params['stopped']).format(time_format) if notify_params['stopped'] else '', + 'stopped_datestamp': CustomArrow(arrow.get(notify_params['stopped']), date_format) if notify_params['stopped'] else '', + 'stopped_timestamp': CustomArrow(arrow.get(notify_params['stopped']), time_format) if notify_params['stopped'] else '', 'stopped_unixtime': notify_params['stopped'], 'stream_duration': stream_duration, 'stream_duration_sec': stream_duration_sec, - 'stream_time': arrow.get(stream_duration_sec).format(duration_format), + 'stream_time': CustomArrow(arrow.get(stream_duration_sec), duration_format), 'remaining_duration': remaining_duration, 'remaining_duration_sec': remaining_duration_sec, - 'remaining_time': arrow.get(remaining_duration_sec).format(duration_format), + 'remaining_time': CustomArrow(arrow.get(remaining_duration_sec), duration_format), 'progress_duration': progress_duration, 'progress_duration_sec': progress_duration_sec, - 'progress_time': arrow.get(progress_duration_sec).format(duration_format), + 'progress_time': CustomArrow(arrow.get(progress_duration_sec), duration_format), 'progress_percent': helpers.get_percent(progress_duration_sec, duration_sec), 'view_offset': session.get('view_offset', 0), 'initial_stream': notify_params['initial_stream'], @@ -1128,15 +1129,15 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m 'track_count': grandchild_count, 'year': notify_params['year'], 'show_year': show_year, - 'release_date': arrow.get(notify_params['originally_available_at']).format(date_format) + 'release_date': CustomArrow(arrow.get(notify_params['originally_available_at']), date_format) if notify_params['originally_available_at'] else '', - 'air_date': arrow.get(notify_params['originally_available_at']).format(date_format) + 'air_date': CustomArrow(arrow.get(notify_params['originally_available_at']), date_format) if notify_params['originally_available_at'] else '', - 'added_date': arrow.get(int(notify_params['added_at'])).format(date_format) + 'added_date': CustomArrow(arrow.get(int(notify_params['added_at'])), date_format) if notify_params['added_at'] else '', - 'updated_date': arrow.get(int(notify_params['updated_at'])).format(date_format) + 'updated_date': CustomArrow(arrow.get(int(notify_params['updated_at'])), date_format) if notify_params['updated_at'] else '', - 'last_viewed_date': arrow.get(int(notify_params['last_viewed_at'])).format(date_format) + 'last_viewed_date': CustomArrow(arrow.get(int(notify_params['last_viewed_at'])), date_format) if notify_params['last_viewed_at'] else '', 'studio': notify_params['studio'], 'content_rating': notify_params['content_rating'], @@ -1155,7 +1156,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m 'duration': duration, 'duration_sec': duration_sec, 'duration_ms': notify_params['duration'], - 'druation_time': arrow.get(duration_sec).format(duration_format), + 'druation_time': CustomArrow(arrow.get(duration_sec), duration_format), 'poster_title': notify_params['poster_title'], 'poster_url': notify_params['poster_url'], 'plex_id': notify_params['plex_id'], @@ -1292,7 +1293,7 @@ def build_server_notify_params(notify_action=None, **kwargs): # Plex Media Server update parameters 'update_version': pms_download_info['version'], 'update_url': pms_download_info['download_url'], - 'update_release_date': arrow.get(pms_download_info['release_date']).format(date_format) + 'update_release_date': CustomArrow(arrow.get(pms_download_info['release_date']), date_format) if pms_download_info['release_date'] else '', 'update_channel': 'Beta' if update_channel == 'beta' else 'Public', 'update_platform': pms_download_info['platform'], @@ -2095,3 +2096,21 @@ class CustomFormatter(Formatter): return ''.join(result) else: return ''.join(result), auto_arg_index + + +class CustomArrow: + def __init__(self, arrow_value: arrow.arrow.Arrow, default_format: Optional[str] = None): + self.arrow_value = arrow_value + self.default_format = default_format + + def __format__(self, formatstr: str) -> str: + if len(formatstr) > 0: + return self.arrow_value.format(formatstr) + + if self.default_format is not None: + return self.__format__(self.default_format) + + return str(self.arrow_value) + + def __str__(self) -> str: + return self.__format__('') From 89aad6952b965c71a2c7bae2e698a8d727f91d53 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Thu, 9 Nov 2023 16:43:41 -0800 Subject: [PATCH 036/290] Fix activity card overflow due to screen scaling * Fixes #2033 --- data/interfaces/default/css/tautulli.css | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css index 0c81f0e5..f8b15890 100644 --- a/data/interfaces/default/css/tautulli.css +++ b/data/interfaces/default/css/tautulli.css @@ -965,7 +965,7 @@ a .users-poster-face:hover { font-size: 10px; text-align: right; text-transform: uppercase; - line-height: 14px; + line-height: 10px; -webkit-flex-shrink: 0; flex-shrink: 0; } From 8fd62e30b3afb88950274ee9a9cfaadc7b0572ec Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Thu, 9 Nov 2023 17:17:24 -0800 Subject: [PATCH 037/290] Fix duration_time typo --- plexpy/notification_handler.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py index a7336a30..8f1d6263 100644 --- a/plexpy/notification_handler.py +++ b/plexpy/notification_handler.py @@ -1156,7 +1156,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m 'duration': duration, 'duration_sec': duration_sec, 'duration_ms': notify_params['duration'], - 'druation_time': CustomArrow(arrow.get(duration_sec), duration_format), + 'duration_time': CustomArrow(arrow.get(duration_sec), duration_format), 'poster_title': notify_params['poster_title'], 'poster_url': notify_params['poster_url'], 'plex_id': notify_params['plex_id'], From 5abdfd7377a6da718a67b4956b8268485e192de8 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Mon, 13 Nov 2023 11:25:39 -0800 Subject: [PATCH 038/290] Make datestamp and timestamp formattable --- plexpy/notification_handler.py | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py index 8f1d6263..4ed08bf6 100644 --- a/plexpy/notification_handler.py +++ b/plexpy/notification_handler.py @@ -982,8 +982,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m 'current_weekday': now_iso[2], 'current_week': now_iso[1], 'week_number': now_iso[1], # Keep for backwards compatibility - 'datestamp': now.format(date_format), - 'timestamp': now.format(time_format), + 'datestamp': CustomArrow(now, date_format), + 'timestamp': CustomArrow(now, time_format), 'unixtime': helpers.timestamp(), 'utctime': helpers.utc_now_iso(), # Stream parameters @@ -1278,8 +1278,8 @@ def build_server_notify_params(notify_action=None, **kwargs): 'current_weekday': now_iso[2], 'current_week': now_iso[1], 'week_number': now_iso[1], # Keep for backwards compatibility - 'datestamp': now.format(date_format), - 'timestamp': now.format(time_format), + 'datestamp': CustomArrow(now, date_format), + 'timestamp': CustomArrow(now, time_format), 'unixtime': helpers.timestamp(), 'utctime': helpers.utc_now_iso(), # Plex remote access parameters From 98c363f559365e927b41bde3549bce6b37021df1 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Mon, 13 Nov 2023 11:28:53 -0800 Subject: [PATCH 039/290] Update Notification Text Modifiers modal with Time Formats --- data/interfaces/default/settings.html | 15 +++++++++++++++ plexpy/common.py | 2 +- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html index 6710ff79..e5b0b321 100644 --- a/data/interfaces/default/settings.html +++ b/data/interfaces/default/settings.html @@ -1923,6 +1923,21 @@

Example:

{media_type}   --> movie
 {media_type!c} --> Movie
+
+
+

Time Formats

+
+
+

+ Notification parameters which are "in date format" or "in time format" can be formatted using the + Date & Time Format Options + by adding a :format specifier. + If no format is specified, the default Date Format and Time Format under Settings > General will be used. +

+

Example:

+ 
{started_datestamp:ddd, MMMM DD, YYYY}   --> Mon, December 25, 2023
+{stopped_timestamp:h:mm a}               --> 9:56 pm
+{duration_time:HH:mm:ss}                 --> 01:42:20

List Slicing

diff --git a/plexpy/common.py b/plexpy/common.py index c692840b..79b76b5c 100644 --- a/plexpy/common.py +++ b/plexpy/common.py @@ -636,7 +636,7 @@ NOTIFICATION_PARAMETERS = [ 'parameters': [ {'name': 'Update Version', 'type': 'str', 'value': 'update_version', 'description': 'The available update version for your Plex Server.'}, {'name': 'Update Url', 'type': 'str', 'value': 'update_url', 'description': 'The download URL for the available update.'}, - {'name': 'Update Release Date', 'type': 'str', 'value': 'update_release_date', 'description': 'The release date of the available update.'}, + {'name': 'Update Release Date', 'type': 'str', 'value': 'update_release_date', 'description': 'The release date (in date format) of the available update.'}, {'name': 'Update Channel', 'type': 'str', 'value': 'update_channel', 'description': 'The update channel.', 'example': 'Public or Plex Pass'}, {'name': 'Update Platform', 'type': 'str', 'value': 'update_platform', 'description': 'The platform of your Plex Server.'}, {'name': 'Update Distro', 'type': 'str', 'value': 'update_distro', 'description': 'The distro of your Plex Server.'}, From 380cbd232c90290971f2d43e9c8fbbff1777ffa6 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sun, 19 Nov 2023 13:05:16 -0800 Subject: [PATCH 040/290] Add file_size_bytes notification parameter * Change type of file_size parameter and update description to indicate it is in human readable format. --- plexpy/common.py | 3 ++- plexpy/notification_handler.py | 1 + 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/plexpy/common.py b/plexpy/common.py index 79b76b5c..b0e22147 100644 --- a/plexpy/common.py +++ b/plexpy/common.py @@ -604,7 +604,8 @@ NOTIFICATION_PARAMETERS = [ {'name': 'Subtitle Language Code', 'type': 'str', 'value': 'subtitle_language_code', 'description': 'The subtitle language code of the original media.'}, {'name': 'File', 'type': 'str', 'value': 'file', 'description': 'The file path to the item.'}, {'name': 'Filename', 'type': 'str', 'value': 'filename', 'description': 'The file name of the item.'}, - {'name': 'File Size', 'type': 'int', 'value': 'file_size', 'description': 'The file size of the item.'}, + {'name': 'File Size', 'type': 'str', 'value': 'file_size', 'description': 'The file size of the item in human readable format.', 'example': '1.2 GB'}, + {'name': 'File Size Bytes', 'type': 'int', 'value': 'file_size_bytes', 'description': 'The file size of the item in bytes.'}, {'name': 'Guid', 'type': 'str', 'value': 'guid', 'description': 'The full guid for the item.'}, {'name': 'Section ID', 'type': 'int', 'value': 'section_id', 'description': 'The unique identifier for the library.'}, {'name': 'Rating Key', 'type': 'int', 'value': 'rating_key', 'description': 'The unique identifier for the movie, episode, or track.'}, diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py index 4ed08bf6..14e20750 100644 --- a/plexpy/notification_handler.py +++ b/plexpy/notification_handler.py @@ -1215,6 +1215,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m 'file': notify_params['file'], 'filename': os.path.basename(notify_params['file'].replace('\\', os.sep)), 'file_size': helpers.human_file_size(notify_params['file_size']), + 'file_size_bytes': notify_params['file_size'], 'indexes': notify_params['indexes'], 'guid': notify_params['guid'], 'section_id': notify_params['section_id'], From d0c1e467bd42bf3c38733b3bf324a7e6e81bcc39 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sun, 19 Nov 2023 13:46:57 -0800 Subject: [PATCH 041/290] Add support for thetvdb_url for movies --- plexpy/common.py | 8 ++++---- plexpy/notification_handler.py | 7 ++++--- plexpy/notifiers.py | 1 + 3 files changed, 9 insertions(+), 7 deletions(-) diff --git a/plexpy/common.py b/plexpy/common.py index b0e22147..9496913f 100644 --- a/plexpy/common.py +++ b/plexpy/common.py @@ -551,10 +551,10 @@ NOTIFICATION_PARAMETERS = [ {'name': 'Poster URL', 'type': 'str', 'value': 'poster_url', 'description': 'A URL for the movie, TV show, or album poster.'}, {'name': 'Plex ID', 'type': 'str', 'value': 'plex_id', 'description': 'The Plex ID for the item.', 'example': 'e.g. 5d7769a9594b2b001e6a6b7e'}, {'name': 'Plex URL', 'type': 'str', 'value': 'plex_url', 'description': 'The Plex URL to your server for the item.'}, - {'name': 'IMDB ID', 'type': 'str', 'value': 'imdb_id', 'description': 'The IMDB ID for the movie.', 'example': 'e.g. tt2488496'}, - {'name': 'IMDB URL', 'type': 'str', 'value': 'imdb_url', 'description': 'The IMDB URL for the movie.'}, - {'name': 'TVDB ID', 'type': 'int', 'value': 'thetvdb_id', 'description': 'The TVDB ID for the TV show.', 'example': 'e.g. 121361'}, - {'name': 'TVDB URL', 'type': 'str', 'value': 'thetvdb_url', 'description': 'The TVDB URL for the TV show.'}, + {'name': 'IMDB ID', 'type': 'str', 'value': 'imdb_id', 'description': 'The IMDB ID for the movie or TV show.', 'example': 'e.g. tt2488496'}, + {'name': 'IMDB URL', 'type': 'str', 'value': 'imdb_url', 'description': 'The IMDB URL for the movie or TV show.'}, + {'name': 'TVDB ID', 'type': 'int', 'value': 'thetvdb_id', 'description': 'The TVDB ID for the movie or TV show.', 'example': 'e.g. 121361'}, + {'name': 'TVDB URL', 'type': 'str', 'value': 'thetvdb_url', 'description': 'The TVDB URL for the movie or TV show.'}, {'name': 'TMDB ID', 'type': 'int', 'value': 'themoviedb_id', 'description': 'The TMDb ID for the movie or TV show.', 'example': 'e.g. 15260'}, {'name': 'TMDB URL', 'type': 'str', 'value': 'themoviedb_url', 'description': 'The TMDb URL for the movie or TV show.'}, {'name': 'TVmaze ID', 'type': 'int', 'value': 'tvmaze_id', 'description': 'The TVmaze ID for the TV show.', 'example': 'e.g. 290'}, diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py index 14e20750..34a60cd6 100644 --- a/plexpy/notification_handler.py +++ b/plexpy/notification_handler.py @@ -699,13 +699,14 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m notify_params['trakt_url'] = 'https://trakt.tv/search/imdb/' + notify_params['imdb_id'] if 'thetvdb://' in notify_params['guid'] or notify_params['thetvdb_id']: + thetvdb_media_type = 'movie' if notify_params['media_type'] == 'movie' else 'series' notify_params['thetvdb_id'] = notify_params['thetvdb_id'] or notify_params['guid'].split('thetvdb://')[1].split('/')[0].split('?')[0] - notify_params['thetvdb_url'] = 'https://thetvdb.com/?tab=series&id=' + notify_params['thetvdb_id'] + notify_params['thetvdb_url'] = f'https://thetvdb.com/dereferrer/{thetvdb_media_type}/{notify_params["thetvdb_id"]}' notify_params['trakt_url'] = 'https://trakt.tv/search/tvdb/' + notify_params['thetvdb_id'] + '?type=show' elif 'thetvdbdvdorder://' in notify_params['guid']: notify_params['thetvdb_id'] = notify_params['guid'].split('thetvdbdvdorder://')[1].split('/')[0].split('?')[0] - notify_params['thetvdb_url'] = 'https://thetvdb.com/?tab=series&id=' + notify_params['thetvdb_id'] + notify_params['thetvdb_url'] = f'https://thetvdb.com/dereferrer/series/{notify_params["thetvdb_id"]}' notify_params['trakt_url'] = 'https://trakt.tv/search/tvdb/' + notify_params['thetvdb_id'] + '?type=show' if 'themoviedb://' in notify_params['guid'] or notify_params['themoviedb_id']: @@ -806,7 +807,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m notify_params.update(tvmaze_info) if tvmaze_info.get('thetvdb_id'): - notify_params['thetvdb_url'] = 'https://thetvdb.com/?tab=series&id=' + str(tvmaze_info['thetvdb_id']) + notify_params['thetvdb_url'] = f'https://thetvdb.com/dereferrer/series/{tvmaze_info["thetvdb_id"]}' notify_params['trakt_url'] = 'https://trakt.tv/search/tvdb/{}' + str(notify_params['thetvdb_id']) + '?type=show' if tvmaze_info.get('imdb_id'): notify_params['imdb_url'] = 'https://www.imdb.com/title/' + tvmaze_info['imdb_id'] diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py index 1e18644e..1e890806 100644 --- a/plexpy/notifiers.py +++ b/plexpy/notifiers.py @@ -807,6 +807,7 @@ class PrettyMetadata(object): 'plexweb': 'Plex Web', 'imdb': 'IMDB', 'themoviedb': 'The Movie Database', + 'thetvdb': 'TheTVDB', 'trakt': 'Trakt.tv' } From ddc8a08fc7cea4c31a36a42e283a60e78495c4f6 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Tue, 21 Nov 2023 11:35:54 -0800 Subject: [PATCH 042/290] Replace usage of utcnow() `datetime.utcnow()` deprecated in Python 3.12 --- plexpy/helpers.py | 12 ++++++------ plexpy/webauth.py | 2 +- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/plexpy/helpers.py b/plexpy/helpers.py index 486be759..a3257403 100644 --- a/plexpy/helpers.py +++ b/plexpy/helpers.py @@ -28,7 +28,7 @@ from cloudinary.api import delete_resources_by_tag from cloudinary.uploader import upload from cloudinary.utils import cloudinary_url from collections import OrderedDict -import datetime +from datetime import date, datetime, timezone from functools import reduce, wraps import hashlib import imghdr @@ -222,14 +222,14 @@ def timestamp(): def today(): - today = datetime.date.today() - yyyymmdd = datetime.date.isoformat(today) + today = date.today() + yyyymmdd = date.isoformat(today) return yyyymmdd def utc_now_iso(): - utcnow = datetime.datetime.utcnow() + utcnow = datetime.now(tz=timezone.utc).replace(tzinfo=None) return utcnow.isoformat() @@ -246,7 +246,7 @@ def timestamp_to_YMDHMS(ts, sep=False): def timestamp_to_datetime(ts): - return datetime.datetime.fromtimestamp(ts) + return datetime.fromtimestamp(ts) def iso_to_YMD(iso): @@ -258,7 +258,7 @@ def iso_to_datetime(iso): def datetime_to_iso(dt, to_date=False): - if isinstance(dt, datetime.datetime): + if isinstance(dt, datetime): if to_date: dt = dt.date() return dt.isoformat() diff --git a/plexpy/webauth.py b/plexpy/webauth.py index 5487f2ea..c3c3f7e2 100644 --- a/plexpy/webauth.py +++ b/plexpy/webauth.py @@ -378,7 +378,7 @@ class AuthController(object): if valid_login: time_delta = timedelta(days=30) if remember_me == '1' else timedelta(minutes=60) - expiry = datetime.utcnow() + time_delta + expiry = datetime.now() + time_delta payload = { 'user_id': user_details['user_id'], From 325271a88eb884f58a646416b6a1a2841371ef8a Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sun, 3 Dec 2023 13:33:37 -0800 Subject: [PATCH 043/290] Update the stream duration on activity cards * Fixes #2206 Some clients like Plexamp use the same sessionKey when the track changes. --- data/interfaces/default/index.html | 1 + 1 file changed, 1 insertion(+) diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html index 57236e69..4a74b2e4 100644 --- a/data/interfaces/default/index.html +++ b/data/interfaces/default/index.html @@ -584,6 +584,7 @@ // Update the stream progress times $('#stream-eta-' + key).html(moment().add(parseInt(s.duration) - parseInt(s.view_offset), 'milliseconds').format(time_format)); + $('#stream-duration-' + key).html(millisecondsToMinutes(parseInt(s.stream_duration), false)); var stream_view_offset = $('#stream-view-offset-' + key); stream_view_offset.data('state', s.state); if (stream_view_offset.data('last_view_offset') !== s.view_offset) { From 98ceb0a81d45f177dbc8cb8cfca86f1d2e585624 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sun, 3 Dec 2023 13:45:13 -0800 Subject: [PATCH 044/290] Add time formats to order of notification text modifiers --- data/interfaces/default/settings.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html index e5b0b321..883d4d3d 100644 --- a/data/interfaces/default/settings.html +++ b/data/interfaces/default/settings.html @@ -2009,7 +2009,7 @@ Rating: {rating}/10 --> Rating: /10
  • Evaluation
  • Parameter
  • Case Modifier
    • -
  • List Slicing
    • +
  • Time Formats / List Slicing
  • Suffix

    • Example:

    From 8cb74f74806863abbc47419d85b002abb600ea00 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sun, 3 Dec 2023 13:49:55 -0800 Subject: [PATCH 045/290] v2.13.3 --- CHANGELOG.md | 14 ++++++++++++++ plexpy/version.py | 2 +- 2 files changed, 15 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index d5eb4c5a..ff82a7a0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,19 @@ # Changelog +## v2.13.3 (2023-12-03) + +* Notifications: + * New: Added duration_time notification parameter. + * New: Added file_size_bytes notification parameter. + * New: Added time formats notification text modifiers. + * New: Added support for thetvdb_url for movies. +* UI: + * Fix: Activity card overflowing due to screen scaling. (#2033) + * Fix: Stream duration on activity card not being updated on track changes in some cases. (@2206) + + ## v2.13.2 (2023-10-26) + * History: * New: Added quarter values icons for history watch status. (#2179, #2156) (Thanks @herby2212) * Graphs: @@ -15,6 +28,7 @@ ## v2.13.1 (2023-08-25) + * Notes: * Support for Python 3.7 has been dropped. The minimum Python version is now 3.8. * Other: diff --git a/plexpy/version.py b/plexpy/version.py index 5ca70297..c52bd955 100644 --- a/plexpy/version.py +++ b/plexpy/version.py @@ -18,4 +18,4 @@ from __future__ import unicode_literals PLEXPY_BRANCH = "master" -PLEXPY_RELEASE_VERSION = "v2.13.2" \ No newline at end of file +PLEXPY_RELEASE_VERSION = "v2.13.3" \ No newline at end of file From 5525b9851cd15508da3a4ecce87916445b1bc66e Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sun, 3 Dec 2023 14:02:51 -0800 Subject: [PATCH 046/290] Fix issue number in changelog --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ff82a7a0..2ee3bb33 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,7 +9,7 @@ * New: Added support for thetvdb_url for movies. * UI: * Fix: Activity card overflowing due to screen scaling. (#2033) - * Fix: Stream duration on activity card not being updated on track changes in some cases. (@2206) + * Fix: Stream duration on activity card not being updated on track changes in some cases. (#2206) ## v2.13.2 (2023-10-26) From e3113ebd309739a755c95ec1b8b6d94709d2d016 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Wed, 6 Dec 2023 13:20:33 -0800 Subject: [PATCH 047/290] Fix configuration table None system language --- data/interfaces/default/configuration_table.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/interfaces/default/configuration_table.html b/data/interfaces/default/configuration_table.html index 66d8ef40..e0f3155d 100644 --- a/data/interfaces/default/configuration_table.html +++ b/data/interfaces/default/configuration_table.html @@ -74,7 +74,7 @@ DOCUMENTATION :: END System Language: - ${plexpy.SYS_LANGUAGE + (' (override {})'.format(plexpy.CONFIG.PMS_LANGUAGE) if plexpy.CONFIG.PMS_LANGUAGE else '')} + ${plexpy.SYS_LANGUAGE}${' (override {})'.format(plexpy.CONFIG.PMS_LANGUAGE) if plexpy.CONFIG.PMS_LANGUAGE else ''} Python Version: From fe7a59c7f94804df2051018c63ed5fa2d3c2d23f Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Wed, 6 Dec 2023 23:09:32 -0800 Subject: [PATCH 048/290] Fix use UTC for JWT expiry and max-age for cookie --- plexpy/webauth.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/plexpy/webauth.py b/plexpy/webauth.py index c3c3f7e2..cc6c6579 100644 --- a/plexpy/webauth.py +++ b/plexpy/webauth.py @@ -22,7 +22,7 @@ from future.builtins import object -from datetime import datetime, timedelta +from datetime import datetime, timedelta, timezone from future.moves.urllib.parse import quote, unquote import cherrypy @@ -378,7 +378,7 @@ class AuthController(object): if valid_login: time_delta = timedelta(days=30) if remember_me == '1' else timedelta(minutes=60) - expiry = datetime.now() + time_delta + expiry = datetime.now(tz=timezone.utc) + time_delta payload = { 'user_id': user_details['user_id'], @@ -399,7 +399,7 @@ class AuthController(object): jwt_cookie = str(JWT_COOKIE_NAME + plexpy.CONFIG.PMS_UUID) cherrypy.response.cookie[jwt_cookie] = jwt_token - cherrypy.response.cookie[jwt_cookie]['expires'] = int(time_delta.total_seconds()) + cherrypy.response.cookie[jwt_cookie]['max-age'] = int(time_delta.total_seconds()) cherrypy.response.cookie[jwt_cookie]['path'] = plexpy.HTTP_ROOT.rstrip('/') or '/' cherrypy.response.cookie[jwt_cookie]['httponly'] = True cherrypy.response.cookie[jwt_cookie]['samesite'] = 'lax' From d019efcf911b4806618761c2da48bab7d04031ec Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Wed, 6 Dec 2023 23:18:16 -0800 Subject: [PATCH 049/290] v2.13.4 --- CHANGELOG.md | 7 +++++++ plexpy/version.py | 2 +- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2ee3bb33..26dc180c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,12 @@ # Changelog +## v2.13.4 (2023-12-07) + +* UI: + * Fix: Tautulli configuration settings page not loading when system language is None. + * Fix: Login cookie expiring too quickly. + + ## v2.13.3 (2023-12-03) * Notifications: diff --git a/plexpy/version.py b/plexpy/version.py index c52bd955..433710bc 100644 --- a/plexpy/version.py +++ b/plexpy/version.py @@ -18,4 +18,4 @@ from __future__ import unicode_literals PLEXPY_BRANCH = "master" -PLEXPY_RELEASE_VERSION = "v2.13.3" \ No newline at end of file +PLEXPY_RELEASE_VERSION = "v2.13.4" \ No newline at end of file From d0c07326ab617731f74ae5d2dde4c014132796b3 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Thu, 7 Dec 2023 23:05:34 -0800 Subject: [PATCH 050/290] Change cookie expires to max-age --- plexpy/webauth.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plexpy/webauth.py b/plexpy/webauth.py index cc6c6579..768b2d64 100644 --- a/plexpy/webauth.py +++ b/plexpy/webauth.py @@ -337,12 +337,12 @@ class AuthController(object): jwt_cookie = str(JWT_COOKIE_NAME + plexpy.CONFIG.PMS_UUID) cherrypy.response.cookie[jwt_cookie] = '' - cherrypy.response.cookie[jwt_cookie]['expires'] = 0 + cherrypy.response.cookie[jwt_cookie]['max-age'] = 0 cherrypy.response.cookie[jwt_cookie]['path'] = plexpy.HTTP_ROOT.rstrip('/') or '/' if plexpy.HTTP_ROOT != '/': # Also expire the JWT on the root path - cherrypy.response.headers['Set-Cookie'] = jwt_cookie + '=""; expires=Thu, 01 Jan 1970 12:00:00 GMT; path=/' + cherrypy.response.headers['Set-Cookie'] = jwt_cookie + '=""; max-age=0; path=/' cherrypy.request.login = None From c172965ec8098bbb45abff9072b8f691d96aac19 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sat, 17 Feb 2024 23:18:13 +0000 Subject: [PATCH 051/290] Don't need to refresh Pushover config after entering token --- plexpy/notifiers.py | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py index 1e890806..bf033a9f 100644 --- a/plexpy/notifiers.py +++ b/plexpy/notifiers.py @@ -3284,8 +3284,7 @@ class PUSHOVER(Notifier): 'value': self.config['api_token'], 'name': 'pushover_api_token', 'description': 'Your Pushover API token.', - 'input_type': 'token', - 'refresh': True + 'input_type': 'token' }, {'label': 'Pushover User or Group Key', 'value': self.config['key'], From 040972bcbab905d17f011a515b00bd86f145f63d Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Mon, 19 Feb 2024 17:31:28 -0800 Subject: [PATCH 052/290] Increase PBKDF2 iterations to 600,000 OWASP Cheat Sheet recommends 600,000 iterations. https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html#pbkdf2 --- lib/hashing_passwords.py | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/lib/hashing_passwords.py b/lib/hashing_passwords.py index 4540db75..beea1e85 100644 --- a/lib/hashing_passwords.py +++ b/lib/hashing_passwords.py @@ -16,7 +16,6 @@ """ -import hashlib from os import urandom from base64 import b64encode, b64decode from hashlib import pbkdf2_hmac @@ -30,7 +29,7 @@ HASH_FUNCTION = 'sha256' # Must be in hashlib. # Linear to the hashing time. Adjust to be high but take a reasonable # amount of time on your server. Measure with: # python -m timeit -s 'import passwords as p' 'p.make_hash("something")' -COST_FACTOR = 10000 +COST_FACTOR = 600000 def make_hash(password): From b1c0972077f935d268bb94944d3cbeeae1c9d22e Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 2 Mar 2024 13:52:45 -0800 Subject: [PATCH 053/290] Bump plexapi from 4.15.4 to 4.15.10 (#2251) * Bump plexapi from 4.15.4 to 4.15.10 Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.15.4 to 4.15.10. - [Release notes](https://github.com/pkkid/python-plexapi/releases) - [Commits](https://github.com/pkkid/python-plexapi/compare/4.15.4...4.15.10) --- updated-dependencies: - dependency-name: plexapi dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] * Update plexapi==4.15.10 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/plexapi/audio.py | 47 +++++++++++- lib/plexapi/base.py | 53 ++++++++++--- lib/plexapi/client.py | 5 +- lib/plexapi/collection.py | 2 +- lib/plexapi/const.py | 2 +- lib/plexapi/exceptions.py | 5 ++ lib/plexapi/library.py | 51 ++++++++++--- lib/plexapi/media.py | 56 +++++++------- lib/plexapi/mixins.py | 152 ++++++++++++++++++++++++-------------- lib/plexapi/myplex.py | 20 ++++- lib/plexapi/photo.py | 3 + lib/plexapi/playlist.py | 16 +++- lib/plexapi/server.py | 3 +- lib/plexapi/utils.py | 33 ++++----- lib/plexapi/video.py | 152 ++++++++++++++++++++++++-------------- requirements.txt | 2 +- 16 files changed, 413 insertions(+), 189 deletions(-) diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py index 2a169877..370fe0dc 100644 --- a/lib/plexapi/audio.py +++ b/lib/plexapi/audio.py @@ -3,6 +3,8 @@ import os from pathlib import Path from urllib.parse import quote_plus +from typing import Any, Dict, List, Optional, TypeVar + from plexapi import media, utils from plexapi.base import Playable, PlexPartialObject, PlexHistory, PlexSession from plexapi.exceptions import BadRequest @@ -14,6 +16,9 @@ from plexapi.mixins import ( from plexapi.playlist import Playlist +TAudio = TypeVar("TAudio", bound="Audio") + + class Audio(PlexPartialObject, PlayedUnplayedMixin): """ Base class for all audio objects including :class:`~plexapi.audio.Artist`, :class:`~plexapi.audio.Album`, and :class:`~plexapi.audio.Track`. @@ -22,6 +27,7 @@ class Audio(PlexPartialObject, PlayedUnplayedMixin): addedAt (datetime): Datetime the item was added to the library. art (str): URL to artwork image (/library/metadata//art/). artBlurHash (str): BlurHash string for artwork image. + distance (float): Sonic Distance of the item from the seed item. fields (List<:class:`~plexapi.media.Field`>): List of field objects. guid (str): Plex GUID for the artist, album, or track (plex://artist/5d07bcb0403c64029053ac4c). index (int): Plex index number (often the track number). @@ -53,6 +59,7 @@ class Audio(PlexPartialObject, PlayedUnplayedMixin): self.addedAt = utils.toDatetime(data.attrib.get('addedAt')) self.art = data.attrib.get('art') self.artBlurHash = data.attrib.get('artBlurHash') + self.distance = utils.cast(float, data.attrib.get('distance')) self.fields = self.findItems(data, media.Field) self.guid = data.attrib.get('guid') self.index = utils.cast(int, data.attrib.get('index')) @@ -125,6 +132,37 @@ class Audio(PlexPartialObject, PlayedUnplayedMixin): return myplex.sync(sync_item, client=client, clientId=clientId) + def sonicallySimilar( + self: TAudio, + limit: Optional[int] = None, + maxDistance: Optional[float] = None, + **kwargs, + ) -> List[TAudio]: + """Returns a list of sonically similar audio items. + + Parameters: + limit (int): Maximum count of items to return. Default 50 (server default) + maxDistance (float): Maximum distance between tracks, 0.0 - 1.0. Default 0.25 (server default). + **kwargs: Additional options passed into :func:`~plexapi.base.PlexObject.fetchItems`. + + Returns: + List[:class:`~plexapi.audio.Audio`]: list of sonically similar audio items. + """ + + key = f"{self.key}/nearest" + params: Dict[str, Any] = {} + if limit is not None: + params['limit'] = limit + if maxDistance is not None: + params['maxDistance'] = maxDistance + key += utils.joinArgs(params) + + return self.fetchItems( + key, + cls=type(self), + **kwargs, + ) + @utils.registerPlexObject class Artist( @@ -189,7 +227,7 @@ class Artist( """ Returns a list of :class:`~plexapi.audio.Album` objects by the artist. """ return self.section().search( libtype='album', - filters={'artist.id': self.ratingKey}, + filters={**kwargs.pop('filters', {}), 'artist.id': self.ratingKey}, **kwargs ) @@ -251,7 +289,7 @@ class Artist( @utils.registerPlexObject class Album( Audio, - UnmatchMatchMixin, RatingMixin, + SplitMergeMixin, UnmatchMatchMixin, RatingMixin, ArtMixin, PosterMixin, ThemeUrlMixin, AlbumEditMixins ): @@ -389,6 +427,7 @@ class Track( chapterSource (str): Unknown collections (List<:class:`~plexapi.media.Collection`>): List of collection objects. duration (int): Length of the track in milliseconds. + genres (List<:class:`~plexapi.media.Genre`>): List of genre objects. grandparentArt (str): URL to album artist artwork (/library/metadata//art/). grandparentGuid (str): Plex GUID for the album artist (plex://artist/5d07bcb0403c64029053ac4c). grandparentKey (str): API URL of the album artist (/library/metadata/). @@ -411,6 +450,8 @@ class Track( primaryExtraKey (str) API URL for the primary extra for the track. ratingCount (int): Number of listeners who have scrobbled this track, as reported by Last.fm. skipCount (int): Number of times the track has been skipped. + sourceURI (str): Remote server URI (server:///com.plexapp.plugins.library) + (remote playlist item only). viewOffset (int): View offset in milliseconds. year (int): Year the track was released. """ @@ -425,6 +466,7 @@ class Track( self.chapterSource = data.attrib.get('chapterSource') self.collections = self.findItems(data, media.Collection) self.duration = utils.cast(int, data.attrib.get('duration')) + self.genres = self.findItems(data, media.Genre) self.grandparentArt = data.attrib.get('grandparentArt') self.grandparentGuid = data.attrib.get('grandparentGuid') self.grandparentKey = data.attrib.get('grandparentKey') @@ -445,6 +487,7 @@ class Track( self.primaryExtraKey = data.attrib.get('primaryExtraKey') self.ratingCount = utils.cast(int, data.attrib.get('ratingCount')) self.skipCount = utils.cast(int, data.attrib.get('skipCount')) + self.sourceURI = data.attrib.get('source') # remote playlist item self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0)) self.year = utils.cast(int, data.attrib.get('year')) diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py index 822e40ea..52063c00 100644 --- a/lib/plexapi/base.py +++ b/lib/plexapi/base.py @@ -22,12 +22,12 @@ OPERATORS = { 'lt': lambda v, q: v < q, 'lte': lambda v, q: v <= q, 'startswith': lambda v, q: v.startswith(q), - 'istartswith': lambda v, q: v.lower().startswith(q), + 'istartswith': lambda v, q: v.lower().startswith(q.lower()), 'endswith': lambda v, q: v.endswith(q), - 'iendswith': lambda v, q: v.lower().endswith(q), + 'iendswith': lambda v, q: v.lower().endswith(q.lower()), 'exists': lambda v, q: v is not None if q else v is None, - 'regex': lambda v, q: re.match(q, v), - 'iregex': lambda v, q: re.match(q, v, flags=re.IGNORECASE), + 'regex': lambda v, q: bool(re.search(q, v)), + 'iregex': lambda v, q: bool(re.search(q, v, flags=re.IGNORECASE)), } @@ -98,7 +98,7 @@ class PlexObject: ecls = utils.PLEXOBJECTS.get(ehash, utils.PLEXOBJECTS.get(elem.tag)) # log.debug('Building %s as %s', elem.tag, ecls.__name__) if ecls is not None: - return ecls(self._server, elem, initpath) + return ecls(self._server, elem, initpath, parent=self) raise UnknownType(f"Unknown library type <{elem.tag} type='{etype}'../>") def _buildItemOrNone(self, elem, cls=None, initpath=None): @@ -227,7 +227,8 @@ class PlexObject: fetchItem(ekey, viewCount__gte=0) fetchItem(ekey, Media__container__in=["mp4", "mkv"]) - fetchItem(ekey, guid__iregex=r"(imdb://|themoviedb://)") + fetchItem(ekey, guid__regex=r"com\.plexapp\.agents\.(imdb|themoviedb)://|tt\d+") + fetchItem(ekey, guid__id__regex=r"(imdb|tmdb|tvdb)://") fetchItem(ekey, Media__Part__file__startswith="D:\\Movies") """ @@ -439,7 +440,7 @@ class PlexObject: attrstr = parts[1] if len(parts) == 2 else None if attrstr: results = [] if results is None else results - for child in [c for c in elem if c.tag.lower() == attr.lower()]: + for child in (c for c in elem if c.tag.lower() == attr.lower()): results += self._getAttrValue(child, attrstr, results) return [r for r in results if r is not None] # check were looking for the tag @@ -565,6 +566,14 @@ class PlexPartialObject(PlexObject): """ Returns True if this is not a full object. """ return not self.isFullObject() + def isLocked(self, field: str): + """ Returns True if the specified field is locked, otherwise False. + + Parameters: + field (str): The name of the field. + """ + return next((f.locked for f in self.fields if f.name == field), False) + def _edit(self, **kwargs): """ Actually edit an object. """ if isinstance(self._edits, dict): @@ -763,6 +772,30 @@ class Playable: for part in item.parts: yield part + def videoStreams(self): + """ Returns a list of :class:`~plexapi.media.videoStream` objects for all MediaParts. """ + if self.isPartialObject(): + self.reload() + return sum((part.videoStreams() for part in self.iterParts()), []) + + def audioStreams(self): + """ Returns a list of :class:`~plexapi.media.AudioStream` objects for all MediaParts. """ + if self.isPartialObject(): + self.reload() + return sum((part.audioStreams() for part in self.iterParts()), []) + + def subtitleStreams(self): + """ Returns a list of :class:`~plexapi.media.SubtitleStream` objects for all MediaParts. """ + if self.isPartialObject(): + self.reload() + return sum((part.subtitleStreams() for part in self.iterParts()), []) + + def lyricStreams(self): + """ Returns a list of :class:`~plexapi.media.LyricStream` objects for all MediaParts. """ + if self.isPartialObject(): + self.reload() + return sum((part.lyricStreams() for part in self.iterParts()), []) + def play(self, client): """ Start playback on the specified client. @@ -953,8 +986,10 @@ class PlexHistory(object): raise NotImplementedError('History objects cannot be reloaded. Use source() to get the source media item.') def source(self): - """ Return the source media object for the history entry. """ - return self.fetchItem(self._details_key) + """ Return the source media object for the history entry + or None if the media no longer exists on the server. + """ + return self.fetchItem(self._details_key) if self._details_key else None def delete(self): """ Delete the history entry. """ diff --git a/lib/plexapi/client.py b/lib/plexapi/client.py index 279b4974..76513e79 100644 --- a/lib/plexapi/client.py +++ b/lib/plexapi/client.py @@ -1,5 +1,6 @@ # -*- coding: utf-8 -*- import time +import weakref from xml.etree import ElementTree import requests @@ -62,7 +63,8 @@ class PlexClient(PlexObject): key = '/resources' def __init__(self, server=None, data=None, initpath=None, baseurl=None, - identifier=None, token=None, connect=True, session=None, timeout=None): + identifier=None, token=None, connect=True, session=None, timeout=None, + parent=None): super(PlexClient, self).__init__(server, data, initpath) self._baseurl = baseurl.strip('/') if baseurl else None self._clientIdentifier = identifier @@ -76,6 +78,7 @@ class PlexClient(PlexObject): self._last_call = 0 self._timeline_cache = [] self._timeline_cache_timestamp = 0 + self._parent = weakref.ref(parent) if parent is not None else None if not any([data is not None, initpath, baseurl, token]): self._baseurl = CONFIG.get('auth.client_baseurl', 'http://localhost:32433') self._token = logfilter.add_secret(CONFIG.get('auth.client_token')) diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py index 8bc5f286..809455ea 100644 --- a/lib/plexapi/collection.py +++ b/lib/plexapi/collection.py @@ -276,7 +276,7 @@ class Collection( .. code-block:: python - collection.updateSort(mode="alpha") + collection.sortUpdate(sort="alpha") """ if self.smart: diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py index 8a172e98..c427177f 100644 --- a/lib/plexapi/const.py +++ b/lib/plexapi/const.py @@ -4,6 +4,6 @@ # Library version MAJOR_VERSION = 4 MINOR_VERSION = 15 -PATCH_VERSION = 4 +PATCH_VERSION = 10 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}" __version__ = f"{__short_version__}.{PATCH_VERSION}" diff --git a/lib/plexapi/exceptions.py b/lib/plexapi/exceptions.py index c269c38e..182feb13 100644 --- a/lib/plexapi/exceptions.py +++ b/lib/plexapi/exceptions.py @@ -29,3 +29,8 @@ class Unsupported(PlexApiException): class Unauthorized(BadRequest): """ Invalid username/password or token. """ pass + + +class TwoFactorRequired(Unauthorized): + """ Two factor authentication required. """ + pass diff --git a/lib/plexapi/library.py b/lib/plexapi/library.py index 87d59eac..5b06f009 100644 --- a/lib/plexapi/library.py +++ b/lib/plexapi/library.py @@ -1,5 +1,7 @@ # -*- coding: utf-8 -*- import re +import warnings +from collections import defaultdict from datetime import datetime from functools import cached_property from urllib.parse import parse_qs, quote_plus, urlencode, urlparse @@ -41,14 +43,22 @@ class Library(PlexObject): def _loadSections(self): """ Loads and caches all the library sections. """ key = '/library/sections' - self._sectionsByID = {} - self._sectionsByTitle = {} + sectionsByID = {} + sectionsByTitle = defaultdict(list) + libcls = { + 'movie': MovieSection, + 'show': ShowSection, + 'artist': MusicSection, + 'photo': PhotoSection, + } + for elem in self._server.query(key): - for cls in (MovieSection, ShowSection, MusicSection, PhotoSection): - if elem.attrib.get('type') == cls.TYPE: - section = cls(self._server, elem, key) - self._sectionsByID[section.key] = section - self._sectionsByTitle[section.title.lower().strip()] = section + section = libcls.get(elem.attrib.get('type'), LibrarySection)(self._server, elem, initpath=key) + sectionsByID[section.key] = section + sectionsByTitle[section.title.lower().strip()].append(section) + + self._sectionsByID = sectionsByID + self._sectionsByTitle = dict(sectionsByTitle) def sections(self): """ Returns a list of all media sections in this library. Library sections may be any of @@ -60,18 +70,30 @@ class Library(PlexObject): def section(self, title): """ Returns the :class:`~plexapi.library.LibrarySection` that matches the specified title. + Note: Multiple library sections with the same title is ambiguous. + Use :func:`~plexapi.library.Library.sectionByID` instead for an exact match. Parameters: title (str): Title of the section to return. + + Raises: + :exc:`~plexapi.exceptions.NotFound`: The library section title is not found on the server. """ normalized_title = title.lower().strip() if not self._sectionsByTitle or normalized_title not in self._sectionsByTitle: self._loadSections() try: - return self._sectionsByTitle[normalized_title] + sections = self._sectionsByTitle[normalized_title] except KeyError: raise NotFound(f'Invalid library section: {title}') from None + if len(sections) > 1: + warnings.warn( + 'Multiple library sections with the same title found, use "sectionByID" instead. ' + 'Returning the last section.' + ) + return sections[-1] + def sectionByID(self, sectionID): """ Returns the :class:`~plexapi.library.LibrarySection` that matches the specified sectionID. @@ -2727,7 +2749,9 @@ class FilteringType(PlexObject): ('id', 'integer', 'Rating Key'), ('index', 'integer', f'{self.type.capitalize()} Number'), ('lastRatedAt', 'date', f'{self.type.capitalize()} Last Rated'), - ('updatedAt', 'date', 'Date Updated') + ('updatedAt', 'date', 'Date Updated'), + ('group', 'string', 'SQL Group By Statement'), + ('having', 'string', 'SQL Having Clause') ] if self.type == 'movie': @@ -2778,11 +2802,14 @@ class FilteringType(PlexObject): manualFields = [] for field, fieldType, fieldTitle in additionalFields: + if field not in {'group', 'having'}: + field = f"{prefix}{field}" fieldXML = ( - f'' ) + manualFields.append(self._manuallyLoadXML(fieldXML, FilteringField)) return manualFields @@ -2922,6 +2949,10 @@ class FilterChoice(PlexObject): self.title = data.attrib.get('title') self.type = data.attrib.get('type') + def items(self): + """ Returns a list of items for this filter choice. """ + return self.fetchItems(self.fastKey) + class ManagedHub(PlexObject): """ Represents a Managed Hub (recommendation) inside a library. diff --git a/lib/plexapi/media.py b/lib/plexapi/media.py index 369bb759..43c5636d 100644 --- a/lib/plexapi/media.py +++ b/lib/plexapi/media.py @@ -37,7 +37,7 @@ class Media(PlexObject): videoResolution (str): The video resolution of the media (ex: sd). width (int): The width of the video in pixels (ex: 608). - : The following attributes are only available for photos. + Photo_only_attributes: The following attributes are only available for photos. * aperture (str): The aperture used to take the photo. * exposure (str): The exposure used to take the photo. @@ -74,13 +74,13 @@ class Media(PlexObject): self.width = utils.cast(int, data.attrib.get('width')) self.uuid = data.attrib.get('uuid') - if self._isChildOf(etag='Photo'): - self.aperture = data.attrib.get('aperture') - self.exposure = data.attrib.get('exposure') - self.iso = utils.cast(int, data.attrib.get('iso')) - self.lens = data.attrib.get('lens') - self.make = data.attrib.get('make') - self.model = data.attrib.get('model') + # Photo only attributes + self.aperture = data.attrib.get('aperture') + self.exposure = data.attrib.get('exposure') + self.iso = utils.cast(int, data.attrib.get('iso')) + self.lens = data.attrib.get('lens') + self.make = data.attrib.get('make') + self.model = data.attrib.get('model') parent = self._parent() self._parentKey = parent.key @@ -158,11 +158,8 @@ class MediaPart(PlexObject): self.videoProfile = data.attrib.get('videoProfile') def _buildStreams(self, data): - streams = [] - for cls in (VideoStream, AudioStream, SubtitleStream, LyricStream): - items = self.findItems(data, cls, streamType=cls.STREAMTYPE) - streams.extend(items) - return streams + """ Returns a list of :class:`~plexapi.media.MediaPartStream` objects in this MediaPart. """ + return self.findItems(data) @property def hasPreviewThumbnails(self): @@ -216,7 +213,7 @@ class MediaPart(PlexObject): else: params['subtitleStreamID'] = stream - self._server.query(key, method=self._server._session.put) + self._server.query(key, method=self._server._session.put, params=params) return self def resetSelectedSubtitleStream(self): @@ -384,7 +381,7 @@ class AudioStream(MediaPartStream): samplingRate (int): The sampling rate of the audio stream (ex: xxx) streamIdentifier (int): The stream identifier of the audio stream. - : The following attributes are only available for tracks. + Track_only_attributes: The following attributes are only available for tracks. * albumGain (float): The gain for the album. * albumPeak (float): The peak for the album. @@ -411,16 +408,16 @@ class AudioStream(MediaPartStream): self.samplingRate = utils.cast(int, data.attrib.get('samplingRate')) self.streamIdentifier = utils.cast(int, data.attrib.get('streamIdentifier')) - if self._isChildOf(etag='Track'): - self.albumGain = utils.cast(float, data.attrib.get('albumGain')) - self.albumPeak = utils.cast(float, data.attrib.get('albumPeak')) - self.albumRange = utils.cast(float, data.attrib.get('albumRange')) - self.endRamp = data.attrib.get('endRamp') - self.gain = utils.cast(float, data.attrib.get('gain')) - self.loudness = utils.cast(float, data.attrib.get('loudness')) - self.lra = utils.cast(float, data.attrib.get('lra')) - self.peak = utils.cast(float, data.attrib.get('peak')) - self.startRamp = data.attrib.get('startRamp') + # Track only attributes + self.albumGain = utils.cast(float, data.attrib.get('albumGain')) + self.albumPeak = utils.cast(float, data.attrib.get('albumPeak')) + self.albumRange = utils.cast(float, data.attrib.get('albumRange')) + self.endRamp = data.attrib.get('endRamp') + self.gain = utils.cast(float, data.attrib.get('gain')) + self.loudness = utils.cast(float, data.attrib.get('loudness')) + self.lra = utils.cast(float, data.attrib.get('lra')) + self.peak = utils.cast(float, data.attrib.get('peak')) + self.startRamp = data.attrib.get('startRamp') def setSelected(self): """ Sets this audio stream as the selected audio stream. @@ -444,8 +441,10 @@ class SubtitleStream(MediaPartStream): forced (bool): True if this is a forced subtitle. format (str): The format of the subtitle stream (ex: srt). headerCompression (str): The header compression of the subtitle stream. + hearingImpaired (bool): True if this is a hearing impaired (SDH) subtitle. + perfectMatch (bool): True if the on-demand subtitle is a perfect match. providerTitle (str): The provider title where the on-demand subtitle is downloaded from. - score (int): The match score of the on-demand subtitle. + score (int): The match score (download count) of the on-demand subtitle. sourceKey (str): The source key of the on-demand subtitle. transient (str): Unknown. userID (int): The user id of the user that downloaded the on-demand subtitle. @@ -460,6 +459,8 @@ class SubtitleStream(MediaPartStream): self.forced = utils.cast(bool, data.attrib.get('forced', '0')) self.format = data.attrib.get('format') self.headerCompression = data.attrib.get('headerCompression') + self.hearingImpaired = utils.cast(bool, data.attrib.get('hearingImpaired', '0')) + self.perfectMatch = utils.cast(bool, data.attrib.get('perfectMatch')) self.providerTitle = data.attrib.get('providerTitle') self.score = utils.cast(int, data.attrib.get('score')) self.sourceKey = data.attrib.get('sourceKey') @@ -1003,7 +1004,8 @@ class BaseResource(PlexObject): Attributes: TAG (str): 'Photo' or 'Track' key (str): API URL (/library/metadata/). - provider (str): The source of the art or poster, None for Theme objects. + provider (str): The source of the resource. 'local' for local files (e.g. theme.mp3), + None if uploaded or agent-/plugin-supplied. ratingKey (str): Unique key identifying the resource. selected (bool): True if the resource is currently selected. thumb (str): The URL to retrieve the resource thumbnail. diff --git a/lib/plexapi/mixins.py b/lib/plexapi/mixins.py index e1cce54b..60c24e26 100644 --- a/lib/plexapi/mixins.py +++ b/lib/plexapi/mixins.py @@ -1,5 +1,7 @@ # -*- coding: utf-8 -*- +from collections import deque from datetime import datetime +from typing import Deque, Set, Tuple, Union from urllib.parse import parse_qsl, quote, quote_plus, unquote, urlencode, urlsplit from plexapi import media, settings, utils @@ -61,63 +63,96 @@ class AdvancedSettingsMixin: class SmartFilterMixin: - """ Mixing for Plex objects that can have smart filters. """ + """ Mixin for Plex objects that can have smart filters. """ + + def _parseFilterGroups(self, feed: Deque[Tuple[str, str]], returnOn: Union[Set[str], None] = None) -> dict: + """ Parse filter groups from input lines between push and pop. """ + currentFiltersStack: list[dict] = [] + operatorForStack = None + if returnOn is None: + returnOn = set("pop") + else: + returnOn.add("pop") + allowedLogicalOperators = ["and", "or"] # first is the default + + while feed: + key, value = feed.popleft() # consume the first item + if key == "push": + # recurse and add the result to the current stack + currentFiltersStack.append( + self._parseFilterGroups(feed, returnOn) + ) + elif key in returnOn: + # stop iterating and return the current stack + if not key == "pop": + feed.appendleft((key, value)) # put the item back + break + + elif key in allowedLogicalOperators: + # set the operator + if operatorForStack and not operatorForStack == key: + raise ValueError( + "cannot have different logical operators for the same" + " filter group" + ) + operatorForStack = key + + else: + # add the key value pair to the current filter + currentFiltersStack.append({key: value}) + + if not operatorForStack and len(currentFiltersStack) > 1: + # consider 'and' as the default operator + operatorForStack = allowedLogicalOperators[0] + + if operatorForStack: + return {operatorForStack: currentFiltersStack} + return currentFiltersStack.pop() + + def _parseQueryFeed(self, feed: "deque[Tuple[str, str]]") -> dict: + """ Parse the query string into a dict. """ + filtersDict = {} + special_keys = {"type", "sort"} + integer_keys = {"includeGuids", "limit"} + as_is_keys = {"group", "having"} + reserved_keys = special_keys | integer_keys | as_is_keys + while feed: + key, value = feed.popleft() + if key in integer_keys: + filtersDict[key] = int(value) + elif key in as_is_keys: + filtersDict[key] = value + elif key == "type": + filtersDict["libtype"] = utils.reverseSearchType(value) + elif key == "sort": + filtersDict["sort"] = value.split(",") + else: + feed.appendleft((key, value)) # put the item back + filter_group = self._parseFilterGroups( + feed, returnOn=reserved_keys + ) + if "filters" in filtersDict: + filtersDict["filters"] = { + "and": [filtersDict["filters"], filter_group] + } + else: + filtersDict["filters"] = filter_group + + return filtersDict def _parseFilters(self, content): """ Parse the content string and returns the filter dict. """ content = urlsplit(unquote(content)) - filters = {} - filterOp = 'and' - filterGroups = [[]] + feed = deque() for key, value in parse_qsl(content.query): # Move = sign to key when operator is == - if value.startswith('='): - key += '=' - value = value[1:] + if value.startswith("="): + key, value = f"{key}=", value[1:] - if key == 'includeGuids': - filters['includeGuids'] = int(value) - elif key == 'type': - filters['libtype'] = utils.reverseSearchType(value) - elif key == 'sort': - filters['sort'] = value.split(',') - elif key == 'limit': - filters['limit'] = int(value) - elif key == 'push': - filterGroups[-1].append([]) - filterGroups.append(filterGroups[-1][-1]) - elif key == 'and': - filterOp = 'and' - elif key == 'or': - filterOp = 'or' - elif key == 'pop': - filterGroups[-1].insert(0, filterOp) - filterGroups.pop() - else: - filterGroups[-1].append({key: value}) + feed.append((key, value)) - if filterGroups: - filters['filters'] = self._formatFilterGroups(filterGroups.pop()) - return filters - - def _formatFilterGroups(self, groups): - """ Formats the filter groups into the advanced search rules. """ - if len(groups) == 1 and isinstance(groups[0], list): - groups = groups.pop() - - filterOp = 'and' - rules = [] - - for g in groups: - if isinstance(g, list): - rules.append(self._formatFilterGroups(g)) - elif isinstance(g, dict): - rules.append(g) - elif g in {'and', 'or'}: - filterOp = g - - return {filterOp: rules} + return self._parseQueryFeed(feed) class SplitMergeMixin: @@ -281,19 +316,16 @@ class PlayedUnplayedMixin: return self @property - @deprecated('use "isPlayed" instead', stacklevel=3) def isWatched(self): - """ Returns True if the show is watched. """ + """ Alias to self.isPlayed. """ return self.isPlayed - @deprecated('use "markPlayed" instead') def markWatched(self): - """ Mark the video as played. """ + """ Alias to :func:`~plexapi.mixins.PlayedUnplayedMixin.markPlayed`. """ self.markPlayed() - @deprecated('use "markUnplayed" instead') def markUnwatched(self): - """ Mark the video as unplayed. """ + """ Alias to :func:`~plexapi.mixins.PlayedUnplayedMixin.markUnplayed`. """ self.markUnplayed() @@ -755,7 +787,8 @@ class EditTagsMixin: if not remove: tags = getattr(self, self._tagPlural(tag), []) - items = tags + items + if isinstance(tags, list): + items = tags + items edits = self._tagHelper(self._tagSingular(tag), items, locked, remove) edits.update(kwargs) @@ -1163,7 +1196,7 @@ class AlbumEditMixins( class TrackEditMixins( ArtLockMixin, PosterLockMixin, ThemeLockMixin, AddedAtMixin, TitleMixin, TrackArtistMixin, TrackNumberMixin, TrackDiscNumberMixin, UserRatingMixin, - CollectionMixin, LabelMixin, MoodMixin + CollectionMixin, GenreMixin, LabelMixin, MoodMixin ): pass @@ -1189,3 +1222,10 @@ class CollectionEditMixins( LabelMixin ): pass + + +class PlaylistEditMixins( + ArtLockMixin, PosterLockMixin, + SortTitleMixin, SummaryMixin, TitleMixin +): + pass diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py index ede2276d..8d697924 100644 --- a/lib/plexapi/myplex.py +++ b/lib/plexapi/myplex.py @@ -12,7 +12,7 @@ from plexapi import (BASE_HEADERS, CONFIG, TIMEOUT, X_PLEX_ENABLE_FAST_CONNECT, log, logfilter, utils) from plexapi.base import PlexObject from plexapi.client import PlexClient -from plexapi.exceptions import BadRequest, NotFound, Unauthorized +from plexapi.exceptions import BadRequest, NotFound, Unauthorized, TwoFactorRequired from plexapi.library import LibrarySection from plexapi.server import PlexServer from plexapi.sonos import PlexSonosClient @@ -108,6 +108,7 @@ class MyPlexAccount(PlexObject): OPTOUTS = 'https://plex.tv/api/v2/user/{userUUID}/settings/opt_outs' # get LINK = 'https://plex.tv/api/v2/pins/link' # put VIEWSTATESYNC = 'https://plex.tv/api/v2/user/view_state_sync' # put + PING = 'https://plex.tv/api/v2/ping' # Hub sections VOD = 'https://vod.provider.plex.tv' # get MUSIC = 'https://music.provider.plex.tv' # get @@ -236,6 +237,8 @@ class MyPlexAccount(PlexObject): errtext = response.text.replace('\n', ' ') message = f'({response.status_code}) {codename}; {response.url} {errtext}' if response.status_code == 401: + if "verification code" in response.text: + raise TwoFactorRequired(message) raise Unauthorized(message) elif response.status_code == 404: raise NotFound(message) @@ -250,6 +253,15 @@ class MyPlexAccount(PlexObject): data = response.text.encode('utf8') return ElementTree.fromstring(data) if data.strip() else None + def ping(self): + """ Ping the Plex.tv API. + This will refresh the authentication token to prevent it from expiring. + """ + pong = self.query(self.PING) + if pong is not None: + return utils.cast(bool, pong.text) + return False + def device(self, name=None, clientId=None): """ Returns the :class:`~plexapi.myplex.MyPlexDevice` that matches the name specified. @@ -1694,7 +1706,9 @@ class MyPlexPinLogin: @property def pin(self): - """ Return the 4 character PIN used for linking a device at https://plex.tv/link. """ + """ Return the 4 character PIN used for linking a device at + https://plex.tv/link. + """ if self._oauth: raise BadRequest('Cannot use PIN for Plex OAuth login') return self._code @@ -1726,6 +1740,7 @@ class MyPlexPinLogin: def run(self, callback=None, timeout=None): """ Starts the thread which monitors the PIN login state. + Parameters: callback (Callable[str]): Callback called with the received authentication token (optional). timeout (int): Timeout in seconds waiting for the PIN login to succeed (optional). @@ -1748,6 +1763,7 @@ class MyPlexPinLogin: def waitForLogin(self): """ Waits for the PIN login to succeed or expire. + Parameters: callback (Callable[str]): Callback called with the received authentication token (optional). timeout (int): Timeout in seconds waiting for the PIN login to succeed (optional). diff --git a/lib/plexapi/photo.py b/lib/plexapi/photo.py index 8737d814..c68b3613 100644 --- a/lib/plexapi/photo.py +++ b/lib/plexapi/photo.py @@ -180,6 +180,8 @@ class Photo( parentThumb (str): URL to photo album thumbnail image (/library/metadata//thumb/). parentTitle (str): Name of the photo album for the photo. ratingKey (int): Unique key identifying the photo. + sourceURI (str): Remote server URI (server:///com.plexapp.plugins.library) + (remote playlist item only). summary (str): Summary of the photo. tags (List<:class:`~plexapi.media.Tag`>): List of tag objects. thumb (str): URL to thumbnail image (/library/metadata//thumb/). @@ -218,6 +220,7 @@ class Photo( self.parentThumb = data.attrib.get('parentThumb') self.parentTitle = data.attrib.get('parentTitle') self.ratingKey = utils.cast(int, data.attrib.get('ratingKey')) + self.sourceURI = data.attrib.get('source') # remote playlist item self.summary = data.attrib.get('summary') self.tags = self.findItems(data, media.Tag) self.thumb = data.attrib.get('thumb') diff --git a/lib/plexapi/playlist.py b/lib/plexapi/playlist.py index 44073ee7..14ef88ed 100644 --- a/lib/plexapi/playlist.py +++ b/lib/plexapi/playlist.py @@ -7,7 +7,7 @@ from plexapi import media, utils from plexapi.base import Playable, PlexPartialObject from plexapi.exceptions import BadRequest, NotFound, Unsupported from plexapi.library import LibrarySection, MusicSection -from plexapi.mixins import SmartFilterMixin, ArtMixin, PosterMixin +from plexapi.mixins import SmartFilterMixin, ArtMixin, PosterMixin, PlaylistEditMixins from plexapi.utils import deprecated @@ -15,7 +15,8 @@ from plexapi.utils import deprecated class Playlist( PlexPartialObject, Playable, SmartFilterMixin, - ArtMixin, PosterMixin + ArtMixin, PosterMixin, + PlaylistEditMixins ): """ Represents a single Playlist. @@ -42,6 +43,7 @@ class Playlist( smart (bool): True if the playlist is a smart playlist. summary (str): Summary of the playlist. title (str): Name of the playlist. + titleSort (str): Title to use when sorting (defaults to title). type (str): 'playlist' updatedAt (datetime): Datetime the playlist was updated. """ @@ -71,6 +73,7 @@ class Playlist( self.smart = utils.cast(bool, data.attrib.get('smart')) self.summary = data.attrib.get('summary') self.title = data.attrib.get('title') + self.titleSort = data.attrib.get('titleSort', self.title) self.type = data.attrib.get('type') self.updatedAt = utils.toDatetime(data.attrib.get('updatedAt')) self._items = None # cache for self.items @@ -224,7 +227,7 @@ class Playlist( self._server.query(key, method=self._server._session.put) return self - @deprecated('use "removeItems" instead', stacklevel=3) + @deprecated('use "removeItems" instead') def removeItem(self, item): self.removeItems(item) @@ -308,10 +311,15 @@ class Playlist( def _edit(self, **kwargs): """ Actually edit the playlist. """ + if isinstance(self._edits, dict): + self._edits.update(kwargs) + return self + key = f'{self.key}{utils.joinArgs(kwargs)}' self._server.query(key, method=self._server._session.put) return self + @deprecated('use "editTitle" and "editSummary" instead') def edit(self, title=None, summary=None): """ Edit the playlist. @@ -384,7 +392,7 @@ class Playlist( key = f"/playlists/upload{utils.joinArgs(args)}" server.query(key, method=server._session.post) try: - return server.playlists(sectionId=section.key, guid__endswith=m3ufilepath)[0].edit(title=title).reload() + return server.playlists(sectionId=section.key, guid__endswith=m3ufilepath)[0].editTitle(title).reload() except IndexError: raise BadRequest('Failed to create playlist from m3u file.') from None diff --git a/lib/plexapi/server.py b/lib/plexapi/server.py index 52a203a8..bdd330f7 100644 --- a/lib/plexapi/server.py +++ b/lib/plexapi/server.py @@ -355,8 +355,7 @@ class PlexServer(PlexObject): key = f'/services/browse/{base64path}' else: key = '/services/browse' - if includeFiles: - key += '?includeFiles=1' + key += f'?includeFiles={int(includeFiles)}' # starting with PMS v1.32.7.7621 this must set explicitly return self.fetchItems(key) def walk(self, path=None): diff --git a/lib/plexapi/utils.py b/lib/plexapi/utils.py index 8478f2d4..467ccf05 100644 --- a/lib/plexapi/utils.py +++ b/lib/plexapi/utils.py @@ -144,22 +144,21 @@ def cast(func, value): func (func): Callback function to used cast to type (int, bool, float). value (any): value to be cast and returned. """ - if value is not None: - if func == bool: - if value in (1, True, "1", "true"): - return True - elif value in (0, False, "0", "false"): - return False - else: - raise ValueError(value) + if value is None: + return value + if func == bool: + if value in (1, True, "1", "true"): + return True + if value in (0, False, "0", "false"): + return False + raise ValueError(value) - elif func in (int, float): - try: - return func(value) - except ValueError: - return float('nan') - return func(value) - return value + if func in (int, float): + try: + return func(value) + except ValueError: + return float('nan') + return func(value) def joinArgs(args): @@ -329,7 +328,7 @@ def toDatetime(value, format=None): return None try: return datetime.fromtimestamp(value) - except (OSError, OverflowError): + except (OSError, OverflowError, ValueError): try: return datetime.fromtimestamp(0) + timedelta(seconds=value) except OverflowError: @@ -407,7 +406,7 @@ def downloadSessionImages(server, filename=None, height=150, width=150, return info -def download(url, token, filename=None, savepath=None, session=None, chunksize=4024, # noqa: C901 +def download(url, token, filename=None, savepath=None, session=None, chunksize=4096, # noqa: C901 unpack=False, mocked=False, showstatus=False): """ Helper to download a thumb, videofile or other media item. Returns the local path to the downloaded file. diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py index e95b12ff..727ba0f8 100644 --- a/lib/plexapi/video.py +++ b/lib/plexapi/video.py @@ -97,64 +97,88 @@ class Video(PlexPartialObject, PlayedUnplayedMixin): """ Returns str, default title for a new syncItem. """ return self.title - def videoStreams(self): - """ Returns a list of :class:`~plexapi.media.videoStream` objects for all MediaParts. """ - streams = [] - - if self.isPartialObject(): - self.reload() - - parts = self.iterParts() - for part in parts: - streams += part.videoStreams() - return streams - - def audioStreams(self): - """ Returns a list of :class:`~plexapi.media.AudioStream` objects for all MediaParts. """ - streams = [] - - if self.isPartialObject(): - self.reload() - - parts = self.iterParts() - for part in parts: - streams += part.audioStreams() - return streams - - def subtitleStreams(self): - """ Returns a list of :class:`~plexapi.media.SubtitleStream` objects for all MediaParts. """ - streams = [] - - if self.isPartialObject(): - self.reload() - - parts = self.iterParts() - for part in parts: - streams += part.subtitleStreams() - return streams - def uploadSubtitles(self, filepath): - """ Upload Subtitle file for video. """ + """ Upload a subtitle file for the video. + + Parameters: + filepath (str): Path to subtitle file. + """ url = f'{self.key}/subtitles' filename = os.path.basename(filepath) subFormat = os.path.splitext(filepath)[1][1:] + params = { + 'title': filename, + 'format': subFormat, + } + headers = {'Accept': 'text/plain, */*'} with open(filepath, 'rb') as subfile: - params = {'title': filename, - 'format': subFormat - } - headers = {'Accept': 'text/plain, */*'} self._server.query(url, self._server._session.post, data=subfile, params=params, headers=headers) return self - def removeSubtitles(self, streamID=None, streamTitle=None): - """ Remove Subtitle from movie's subtitles listing. + def searchSubtitles(self, language='en', hearingImpaired=0, forced=0): + """ Search for on-demand subtitles for the video. + See https://support.plex.tv/articles/subtitle-search/. - Note: If subtitle file is located inside video directory it will bbe deleted. - Files outside of video directory are not effected. + Parameters: + language (str, optional): Language code (ISO 639-1) of the subtitles to search for. + Default 'en'. + hearingImpaired (int, optional): Search option for SDH subtitles. + Default 0. + (0 = Prefer non-SDH subtitles, 1 = Prefer SDH subtitles, + 2 = Only show SDH subtitles, 3 = Only show non-SDH subtitles) + forced (int, optional): Search option for forced subtitles. + Default 0. + (0 = Prefer non-forced subtitles, 1 = Prefer forced subtitles, + 2 = Only show forced subtitles, 3 = Only show non-forced subtitles) + + Returns: + List<:class:`~plexapi.media.SubtitleStream`>: List of SubtitleStream objects. """ - for stream in self.subtitleStreams(): - if streamID == stream.id or streamTitle == stream.title: - self._server.query(stream.key, self._server._session.delete) + params = { + 'language': language, + 'hearingImpaired': hearingImpaired, + 'forced': forced, + } + key = f'{self.key}/subtitles{utils.joinArgs(params)}' + return self.fetchItems(key) + + def downloadSubtitles(self, subtitleStream): + """ Download on-demand subtitles for the video. + See https://support.plex.tv/articles/subtitle-search/. + + Note: This method is asynchronous and returns immediately before subtitles are fully downloaded. + + Parameters: + subtitleStream (:class:`~plexapi.media.SubtitleStream`): + Subtitle object returned from :func:`~plexapi.video.Video.searchSubtitles`. + """ + key = f'{self.key}/subtitles' + params = {'key': subtitleStream.key} + self._server.query(key, self._server._session.put, params=params) + return self + + def removeSubtitles(self, subtitleStream=None, streamID=None, streamTitle=None): + """ Remove an upload or downloaded subtitle from the video. + + Note: If the subtitle file is located inside video directory it will be deleted. + Files outside of video directory are not affected. + Embedded subtitles cannot be removed. + + Parameters: + subtitleStream (:class:`~plexapi.media.SubtitleStream`, optional): Subtitle object to remove. + streamID (int, optional): ID of the subtitle stream to remove. + streamTitle (str, optional): Title of the subtitle stream to remove. + """ + if subtitleStream is None: + try: + subtitleStream = next( + stream for stream in self.subtitleStreams() + if streamID == stream.id or streamTitle == stream.title + ) + except StopIteration: + raise BadRequest(f"Subtitle stream with ID '{streamID}' or title '{streamTitle}' not found.") from None + + self._server.query(subtitleStream.key, self._server._session.delete) return self def optimize(self, title='', target='', deviceProfile='', videoQuality=None, @@ -344,7 +368,10 @@ class Movie( ratingImage (str): Key to critic rating image (rottentomatoes://image.rating.rotten). ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects. roles (List<:class:`~plexapi.media.Role`>): List of role objects. + slug (str): The clean watch.plex.tv URL identifier for the movie. similar (List<:class:`~plexapi.media.Similar`>): List of Similar objects. + sourceURI (str): Remote server URI (server:///com.plexapp.plugins.library) + (remote playlist item only). studio (str): Studio that created movie (Di Bonaventura Pictures; 21 Laps Entertainment). tagline (str): Movie tag line (Back 2 Work; Who says men can't change?). theme (str): URL to theme resource (/library/metadata//theme/). @@ -387,7 +414,9 @@ class Movie( self.ratingImage = data.attrib.get('ratingImage') self.ratings = self.findItems(data, media.Rating) self.roles = self.findItems(data, media.Role) + self.slug = data.attrib.get('slug') self.similar = self.findItems(data, media.Similar) + self.sourceURI = data.attrib.get('source') # remote playlist item self.studio = data.attrib.get('studio') self.tagline = data.attrib.get('tagline') self.theme = data.attrib.get('theme') @@ -507,6 +536,7 @@ class Show( (None = Library default, tmdbAiring = The Movie Database (Aired), aired = TheTVDB (Aired), dvd = TheTVDB (DVD), absolute = TheTVDB (Absolute)). similar (List<:class:`~plexapi.media.Similar`>): List of Similar objects. + slug (str): The clean watch.plex.tv URL identifier for the show. studio (str): Studio that created show (Di Bonaventura Pictures; 21 Laps Entertainment). subtitleLanguage (str): Setting that indicates the preferred subtitle language. subtitleMode (int): Setting that indicates the auto-select subtitle mode. @@ -556,8 +586,9 @@ class Show( self.seasonCount = utils.cast(int, data.attrib.get('seasonCount', self.childCount)) self.showOrdering = data.attrib.get('showOrdering') self.similar = self.findItems(data, media.Similar) + self.slug = data.attrib.get('slug') self.studio = data.attrib.get('studio') - self.subtitleLanguage = data.attrib.get('audioLanguage', '') + self.subtitleLanguage = data.attrib.get('subtitleLanguage', '') self.subtitleMode = utils.cast(int, data.attrib.get('subtitleMode', '-1')) self.tagline = data.attrib.get('tagline') self.theme = data.attrib.get('theme') @@ -693,6 +724,7 @@ class Season( parentIndex (int): Plex index number for the show. parentKey (str): API URL of the show (/library/metadata/). parentRatingKey (int): Unique key identifying the show. + parentSlug (str): The clean watch.plex.tv URL identifier for the show. parentStudio (str): Studio that created show. parentTheme (str): URL to show theme resource (/library/metadata//theme/). parentThumb (str): URL to show thumbnail image (/library/metadata//thumb/). @@ -722,12 +754,13 @@ class Season( self.parentIndex = utils.cast(int, data.attrib.get('parentIndex')) self.parentKey = data.attrib.get('parentKey') self.parentRatingKey = utils.cast(int, data.attrib.get('parentRatingKey')) + self.parentSlug = data.attrib.get('parentSlug') self.parentStudio = data.attrib.get('parentStudio') self.parentTheme = data.attrib.get('parentTheme') self.parentThumb = data.attrib.get('parentThumb') self.parentTitle = data.attrib.get('parentTitle') self.ratings = self.findItems(data, media.Rating) - self.subtitleLanguage = data.attrib.get('audioLanguage', '') + self.subtitleLanguage = data.attrib.get('subtitleLanguage', '') self.subtitleMode = utils.cast(int, data.attrib.get('subtitleMode', '-1')) self.viewedLeafCount = utils.cast(int, data.attrib.get('viewedLeafCount')) self.year = utils.cast(int, data.attrib.get('year')) @@ -853,6 +886,7 @@ class Episode( grandparentGuid (str): Plex GUID for the show (plex://show/5d9c086fe9d5a1001f4d9fe6). grandparentKey (str): API URL of the show (/library/metadata/). grandparentRatingKey (int): Unique key identifying the show. + grandparentSlug (str): The clean watch.plex.tv URL identifier for the show. grandparentTheme (str): URL to show theme resource (/library/metadata//theme/). grandparentThumb (str): URL to show thumbnail image (/library/metadata//thumb/). grandparentTitle (str): Name of the show for the episode. @@ -874,6 +908,8 @@ class Episode( ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects. roles (List<:class:`~plexapi.media.Role`>): List of role objects. skipParent (bool): True if the show's seasons are set to hidden. + sourceURI (str): Remote server URI (server:///com.plexapp.plugins.library) + (remote playlist item only). viewOffset (int): View offset in milliseconds. writers (List<:class:`~plexapi.media.Writer`>): List of writers objects. year (int): Year the episode was released. @@ -898,6 +934,7 @@ class Episode( self.grandparentGuid = data.attrib.get('grandparentGuid') self.grandparentKey = data.attrib.get('grandparentKey') self.grandparentRatingKey = utils.cast(int, data.attrib.get('grandparentRatingKey')) + self.grandparentSlug = data.attrib.get('grandparentSlug') self.grandparentTheme = data.attrib.get('grandparentTheme') self.grandparentThumb = data.attrib.get('grandparentThumb') self.grandparentTitle = data.attrib.get('grandparentTitle') @@ -916,6 +953,7 @@ class Episode( self.ratings = self.findItems(data, media.Rating) self.roles = self.findItems(data, media.Role) self.skipParent = utils.cast(bool, data.attrib.get('skipParent', '0')) + self.sourceURI = data.attrib.get('source') # remote playlist item self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0)) self.writers = self.findItems(data, media.Writer) self.year = utils.cast(int, data.attrib.get('year')) @@ -961,11 +999,9 @@ class Episode( @cached_property def _season(self): """ Returns the :class:`~plexapi.video.Season` object by querying for the show's children. """ - if not self.grandparentKey: - return None - return self.fetchItem( - f'{self.grandparentKey}/children?excludeAllLeaves=1&index={self.parentIndex}' - ) + if self.grandparentKey and self.parentIndex is not None: + return self.fetchItem(f'{self.grandparentKey}/children?excludeAllLeaves=1&index={self.parentIndex}') + return None def __repr__(self): return '<{}>'.format( @@ -1003,7 +1039,11 @@ class Episode( @cached_property def seasonNumber(self): """ Returns the episode's season number. """ - return self.parentIndex if isinstance(self.parentIndex, int) else self._season.seasonNumber + if isinstance(self.parentIndex, int): + return self.parentIndex + elif self._season: + return self._season.index + return None @property def seasonEpisode(self): diff --git a/requirements.txt b/requirements.txt index bc0a4bd6..73b6e088 100644 --- a/requirements.txt +++ b/requirements.txt @@ -28,7 +28,7 @@ musicbrainzngs==0.7.1 packaging==23.1 paho-mqtt==1.6.1 platformdirs==3.11.0 -plexapi==4.15.4 +plexapi==4.15.10 portend==3.2.0 profilehooks==1.12.0 PyJWT==2.8.0 From 60f29b0fa48d750f431c5727aa6226304bb23319 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 2 Mar 2024 14:02:24 -0800 Subject: [PATCH 054/290] Bump pycryptodomex from 3.18.0 to 3.20.0 (#2237) Bumps [pycryptodomex](https://github.com/Legrandin/pycryptodome) from 3.18.0 to 3.20.0. - [Release notes](https://github.com/Legrandin/pycryptodome/releases) - [Changelog](https://github.com/Legrandin/pycryptodome/blob/master/Changelog.rst) - [Commits](https://github.com/Legrandin/pycryptodome/compare/v3.18.0...v3.20.0) --- updated-dependencies: - dependency-name: pycryptodomex dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- package/requirements-package.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package/requirements-package.txt b/package/requirements-package.txt index e0bd159b..ee2ccf44 100644 --- a/package/requirements-package.txt +++ b/package/requirements-package.txt @@ -3,7 +3,7 @@ importlib-metadata==6.8.0 importlib-resources==6.0.1 pyinstaller==5.13.0 pyopenssl==23.2.0 -pycryptodomex==3.18.0 +pycryptodomex==3.20.0 pyobjc-core==9.2; platform_system == "Darwin" pyobjc-framework-Cocoa==9.2; platform_system == "Darwin" From 23591a0435c1627f995b37e25e10c411a87060ac Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 2 Mar 2024 14:07:39 -0800 Subject: [PATCH 055/290] Bump pyopenssl from 23.2.0 to 24.0.0 (#2252) Bumps [pyopenssl](https://github.com/pyca/pyopenssl) from 23.2.0 to 24.0.0. - [Changelog](https://github.com/pyca/pyopenssl/blob/main/CHANGELOG.rst) - [Commits](https://github.com/pyca/pyopenssl/compare/23.2.0...24.0.0) --- updated-dependencies: - dependency-name: pyopenssl dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- package/requirements-package.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package/requirements-package.txt b/package/requirements-package.txt index ee2ccf44..4062609c 100644 --- a/package/requirements-package.txt +++ b/package/requirements-package.txt @@ -2,7 +2,7 @@ apscheduler==3.10.1 importlib-metadata==6.8.0 importlib-resources==6.0.1 pyinstaller==5.13.0 -pyopenssl==23.2.0 +pyopenssl==24.0.0 pycryptodomex==3.20.0 pyobjc-core==9.2; platform_system == "Darwin" From 50dba6bf19164e141dbabd25a4d68b95991cb7ee Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 2 Mar 2024 14:08:25 -0800 Subject: [PATCH 056/290] Bump pyobjc-core from 9.2 to 10.1 (#2219) Bumps [pyobjc-core](https://github.com/ronaldoussoren/pyobjc) from 9.2 to 10.1. - [Release notes](https://github.com/ronaldoussoren/pyobjc/releases) - [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst) - [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v9.2...v10.1) --- updated-dependencies: - dependency-name: pyobjc-core dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- package/requirements-package.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package/requirements-package.txt b/package/requirements-package.txt index 4062609c..75c9e4d2 100644 --- a/package/requirements-package.txt +++ b/package/requirements-package.txt @@ -5,7 +5,7 @@ pyinstaller==5.13.0 pyopenssl==24.0.0 pycryptodomex==3.20.0 -pyobjc-core==9.2; platform_system == "Darwin" +pyobjc-core==10.1; platform_system == "Darwin" pyobjc-framework-Cocoa==9.2; platform_system == "Darwin" pywin32==306; platform_system == "Windows" From f403fdcc5b41a25392b979b6a98625dce2885396 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 2 Mar 2024 14:10:07 -0800 Subject: [PATCH 057/290] Bump pyobjc-framework-cocoa from 9.2 to 10.1 (#2218) Bumps [pyobjc-framework-cocoa](https://github.com/ronaldoussoren/pyobjc) from 9.2 to 10.1. - [Release notes](https://github.com/ronaldoussoren/pyobjc/releases) - [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst) - [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v9.2...v10.1) --- updated-dependencies: - dependency-name: pyobjc-framework-cocoa dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- package/requirements-package.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package/requirements-package.txt b/package/requirements-package.txt index 75c9e4d2..7238285d 100644 --- a/package/requirements-package.txt +++ b/package/requirements-package.txt @@ -6,6 +6,6 @@ pyopenssl==24.0.0 pycryptodomex==3.20.0 pyobjc-core==10.1; platform_system == "Darwin" -pyobjc-framework-Cocoa==9.2; platform_system == "Darwin" +pyobjc-framework-Cocoa==10.1; platform_system == "Darwin" pywin32==306; platform_system == "Windows" From 78a7a48587bda6149eac67bdbe181bb5c1c94b29 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 2 Mar 2024 14:10:17 -0800 Subject: [PATCH 058/290] Bump pyinstaller from 5.13.0 to 6.4.0 (#2253) Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 5.13.0 to 6.4.0. - [Release notes](https://github.com/pyinstaller/pyinstaller/releases) - [Changelog](https://github.com/pyinstaller/pyinstaller/blob/develop/doc/CHANGES.rst) - [Commits](https://github.com/pyinstaller/pyinstaller/compare/v5.13.0...v6.4.0) --- updated-dependencies: - dependency-name: pyinstaller dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- package/requirements-package.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package/requirements-package.txt b/package/requirements-package.txt index 7238285d..f1ad724e 100644 --- a/package/requirements-package.txt +++ b/package/requirements-package.txt @@ -1,7 +1,7 @@ apscheduler==3.10.1 importlib-metadata==6.8.0 importlib-resources==6.0.1 -pyinstaller==5.13.0 +pyinstaller==6.4.0 pyopenssl==24.0.0 pycryptodomex==3.20.0 From cc070cfc6bdaa977452d9efb6274cdc97d7d84f7 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sat, 2 Mar 2024 13:57:57 -0800 Subject: [PATCH 059/290] Add slug attribute to exporter --- plexpy/exporter.py | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/plexpy/exporter.py b/plexpy/exporter.py index 1232481c..6c136f0e 100644 --- a/plexpy/exporter.py +++ b/plexpy/exporter.py @@ -387,6 +387,7 @@ class Export(object): 'role': None, 'thumb': None }, + 'slug': None, 'studio': None, 'summary': None, 'tagline': None, @@ -472,6 +473,7 @@ class Export(object): }, 'seasonCount': None, 'showOrdering': None, + 'slug': None, 'studio': None, 'subtitleLanguage': None, 'subtitleMode': None, @@ -536,6 +538,7 @@ class Export(object): 'parentTitle': None, 'ratingKey': None, 'seasonNumber': None, + 'slug': None, 'subtitleLanguage': None, 'subtitleMode': None, 'summary': None, @@ -795,6 +798,7 @@ class Export(object): }, 'seasonEpisode': None, 'seasonNumber': None, + 'slug': None, 'summary': None, 'thumb': None, 'thumbBlurHash': None, From 82089fdb7b7f443b4effd44f8e6d980988cea304 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sat, 2 Mar 2024 13:58:12 -0800 Subject: [PATCH 060/290] Add track genres to exporter --- plexpy/exporter.py | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/plexpy/exporter.py b/plexpy/exporter.py index 6c136f0e..a0b52083 100644 --- a/plexpy/exporter.py +++ b/plexpy/exporter.py @@ -991,6 +991,10 @@ class Export(object): 'name': None, 'locked': None }, + 'genres': { + 'id': None, + 'tag': None + }, 'grandparentArt': None, 'grandparentGuid': None, 'grandparentKey': None, @@ -1555,7 +1559,7 @@ class Export(object): 'hasSonicAnalysis' ], 2: [ - 'collections.tag', 'moods.tag', + 'collections.tag', 'genres.tag', 'moods.tag', 'fields.name', 'fields.locked', 'guids.id' ], 3: [ From 7ee2c590754899815ac7538d2d8f34b7fcb7d199 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sat, 2 Mar 2024 13:58:30 -0800 Subject: [PATCH 061/290] Add playlist sourceURI to exporter --- plexpy/exporter.py | 1 + 1 file changed, 1 insertion(+) diff --git a/plexpy/exporter.py b/plexpy/exporter.py index a0b52083..efb1abf3 100644 --- a/plexpy/exporter.py +++ b/plexpy/exporter.py @@ -1288,6 +1288,7 @@ class Export(object): 'playlistType': None, 'ratingKey': None, 'smart': None, + 'sourceURI': None, 'summary': None, 'title': None, 'type': None, From 36ed4bfa3c07feb6772ea89aa74674204a089e7d Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sat, 2 Mar 2024 14:31:44 -0800 Subject: [PATCH 062/290] Set pyinstaller --contents-directory Revert back to old one-dir behaviour Ref.: pyinstaller/pyinstaller#7713 --- package/Tautulli-macos.spec | 3 ++- package/Tautulli-windows.spec | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/package/Tautulli-macos.spec b/package/Tautulli-macos.spec index caa126d7..bd61f1f2 100644 --- a/package/Tautulli-macos.spec +++ b/package/Tautulli-macos.spec @@ -34,7 +34,8 @@ exe = EXE( exclude_binaries=True, name='Tautulli', console=False, - icon='../data/interfaces/default/images/logo-circle.icns' + icon='../data/interfaces/default/images/logo-circle.icns', + contents_directory='.' ) coll = COLLECT( exe, diff --git a/package/Tautulli-windows.spec b/package/Tautulli-windows.spec index cded3cf8..18f4219f 100644 --- a/package/Tautulli-windows.spec +++ b/package/Tautulli-windows.spec @@ -31,7 +31,8 @@ exe = EXE( exclude_binaries=True, name='Tautulli', console=False, - icon='..\\data\\interfaces\\default\\images\\logo-circle.ico' + icon='..\\data\\interfaces\\default\\images\\logo-circle.ico', + contents_directory='.' ) coll = COLLECT( exe, From 7e4f7c0c5616b50c23b205662ebd1d232a3cb7fb Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 2 Mar 2024 14:33:52 -0800 Subject: [PATCH 063/290] Bump dessant/label-actions from 3 to 4 (#2195) Bumps [dessant/label-actions](https://github.com/dessant/label-actions) from 3 to 4. - [Release notes](https://github.com/dessant/label-actions/releases) - [Changelog](https://github.com/dessant/label-actions/blob/main/CHANGELOG.md) - [Commits](https://github.com/dessant/label-actions/compare/v3...v4) --- updated-dependencies: - dependency-name: dessant/label-actions dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- .github/workflows/issues.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/issues.yml b/.github/workflows/issues.yml index 34ceb357..a60987f5 100644 --- a/.github/workflows/issues.yml +++ b/.github/workflows/issues.yml @@ -10,6 +10,6 @@ jobs: runs-on: ubuntu-latest steps: - name: Label Issues - uses: dessant/label-actions@v3 + uses: dessant/label-actions@v4 with: github-token: ${{ github.token }} From 71e6ea00c9b9df0f8ee547881dbc943c7a05eea7 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 2 Mar 2024 14:34:18 -0800 Subject: [PATCH 064/290] Bump actions/setup-python from 4 to 5 (#2211) Bumps [actions/setup-python](https://github.com/actions/setup-python) from 4 to 5. - [Release notes](https://github.com/actions/setup-python/releases) - [Commits](https://github.com/actions/setup-python/compare/v4...v5) --- updated-dependencies: - dependency-name: actions/setup-python dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- .github/workflows/publish-installers.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml index a9f6cda3..ef46671d 100644 --- a/.github/workflows/publish-installers.yml +++ b/.github/workflows/publish-installers.yml @@ -52,7 +52,7 @@ jobs: echo $GITHUB_SHA > version.txt - name: Set Up Python - uses: actions/setup-python@v4 + uses: actions/setup-python@v5 with: python-version: '3.9' cache: pip From 6a19beb476ee7fb63e483b76ec4675b0e638a782 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 2 Mar 2024 14:34:58 -0800 Subject: [PATCH 065/290] Bump actions/stale from 8 to 9 (#2214) Bumps [actions/stale](https://github.com/actions/stale) from 8 to 9. - [Release notes](https://github.com/actions/stale/releases) - [Changelog](https://github.com/actions/stale/blob/main/CHANGELOG.md) - [Commits](https://github.com/actions/stale/compare/v8...v9) --- updated-dependencies: - dependency-name: actions/stale dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- .github/workflows/issues-stale.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/issues-stale.yml b/.github/workflows/issues-stale.yml index 26b8aa5f..b805e266 100644 --- a/.github/workflows/issues-stale.yml +++ b/.github/workflows/issues-stale.yml @@ -10,7 +10,7 @@ jobs: runs-on: ubuntu-latest steps: - name: Stale - uses: actions/stale@v8 + uses: actions/stale@v9 with: stale-issue-message: > This issue is stale because it has been open for 30 days with no activity. @@ -30,7 +30,7 @@ jobs: days-before-close: 5 - name: Invalid Template - uses: actions/stale@v8 + uses: actions/stale@v9 with: stale-issue-message: > Invalid issues template. From a397b90c23699bd6a493944aaca0ccbf4fa9f1e0 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 2 Mar 2024 14:35:11 -0800 Subject: [PATCH 066/290] Bump github/codeql-action from 2 to 3 (#2222) Bumps [github/codeql-action](https://github.com/github/codeql-action) from 2 to 3. - [Release notes](https://github.com/github/codeql-action/releases) - [Changelog](https://github.com/github/codeql-action/blob/main/CHANGELOG.md) - [Commits](https://github.com/github/codeql-action/compare/v2...v3) --- updated-dependencies: - dependency-name: github/codeql-action dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- .github/workflows/codeql.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml index f9593d5a..e9c8e05d 100644 --- a/.github/workflows/codeql.yml +++ b/.github/workflows/codeql.yml @@ -27,12 +27,12 @@ jobs: uses: actions/checkout@v4 - name: Initialize CodeQL - uses: github/codeql-action/init@v2 + uses: github/codeql-action/init@v3 with: config-file: ./.github/codeql-config.yml languages: ${{ matrix.language }} - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v2 + uses: github/codeql-action/analyze@v3 with: category: "/language:${{matrix.language}}" From 355be9951201c82a30e06684473e7f9cb4147866 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 2 Mar 2024 14:35:43 -0800 Subject: [PATCH 067/290] Bump actions/upload-artifact from 3 to 4 (#2224) Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 3 to 4. - [Release notes](https://github.com/actions/upload-artifact/releases) - [Commits](https://github.com/actions/upload-artifact/compare/v3...v4) --- updated-dependencies: - dependency-name: actions/upload-artifact dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- .github/workflows/publish-installers.yml | 2 +- .github/workflows/publish-snap.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml index ef46671d..f0483ec9 100644 --- a/.github/workflows/publish-installers.yml +++ b/.github/workflows/publish-installers.yml @@ -88,7 +88,7 @@ jobs: Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.pkg - name: Upload Installer - uses: actions/upload-artifact@v3 + uses: actions/upload-artifact@v4 with: name: Tautulli-${{ matrix.os }}-installer path: Tautulli-${{ matrix.os }}-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.${{ matrix.ext }} diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml index e8a6be7d..65442eca 100644 --- a/.github/workflows/publish-snap.yml +++ b/.github/workflows/publish-snap.yml @@ -44,7 +44,7 @@ jobs: architecture: ${{ matrix.architecture }} - name: Upload Snap Package - uses: actions/upload-artifact@v3 + uses: actions/upload-artifact@v4 with: name: Tautulli-snap-package-${{ matrix.architecture }} path: ${{ steps.build.outputs.snap }} From 36fbff550349b758ccba3bc76837790cd8f24f11 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 2 Mar 2024 14:35:56 -0800 Subject: [PATCH 068/290] Bump actions/download-artifact from 3 to 4 (#2223) Bumps [actions/download-artifact](https://github.com/actions/download-artifact) from 3 to 4. - [Release notes](https://github.com/actions/download-artifact/releases) - [Commits](https://github.com/actions/download-artifact/compare/v3...v4) --- updated-dependencies: - dependency-name: actions/download-artifact dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- .github/workflows/publish-installers.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml index f0483ec9..0842f6c1 100644 --- a/.github/workflows/publish-installers.yml +++ b/.github/workflows/publish-installers.yml @@ -112,7 +112,7 @@ jobs: - name: Download Installers if: env.WORKFLOW_CONCLUSION == 'success' - uses: actions/download-artifact@v3 + uses: actions/download-artifact@v4 - name: Get Changelog id: get_changelog From b48e9f40745d05ca22bf170dc69dbf63935bc500 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sat, 2 Mar 2024 16:28:12 -0800 Subject: [PATCH 069/290] Update installer workflow for universal macOS binary Bump python to 3.11 --- .github/workflows/publish-installers.yml | 19 +++++++++++++------ package/Tautulli-macos.spec | 3 ++- 2 files changed, 15 insertions(+), 7 deletions(-) diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml index 0842f6c1..87ebc15c 100644 --- a/.github/workflows/publish-installers.yml +++ b/.github/workflows/publish-installers.yml @@ -6,10 +6,13 @@ on: branches: [master, beta, nightly] tags: [v*] +env: + PYTHON_VERSION: '3.11' + jobs: build-installer: name: Build ${{ matrix.os_upper }} Installer - runs-on: ${{ matrix.os }}-latest + runs-on: ${{ matrix.os }}-${{ matrix.os_version }} if: ${{ !contains(github.event.head_commit.message, '[skip ci]') }} strategy: fail-fast: false @@ -17,9 +20,13 @@ jobs: include: - os: 'windows' os_upper: 'Windows' + os_version: 'latest' + arch: 'x64' ext: 'exe' - os: 'macos' os_upper: 'MacOS' + os_version: '14' + arch: 'universal' ext: 'pkg' steps: @@ -54,14 +61,14 @@ jobs: - name: Set Up Python uses: actions/setup-python@v5 with: - python-version: '3.9' + python-version: ${{ env.PYTHON_VERSION }} cache: pip cache-dependency-path: '**/requirements*.txt' - name: Install Dependencies run: | python -m pip install --upgrade pip - pip install -r package/requirements-package.txt + pip install -r package/requirements-package.txt --no-binary cffi - name: Build Package run: | @@ -74,7 +81,7 @@ jobs: script-file: ./package/Tautulli.nsi arguments: > /DVERSION=${{ steps.get_version.outputs.VERSION_NSIS }} - /DINSTALLER_NAME=..\Tautulli-windows-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.exe + /DINSTALLER_NAME=..\Tautulli-${{ matrix.os }}-${{ steps.get_version.outputs.RELEASE_VERSION }}-${{ matrix.arch }}.${{ matrix.ext }} additional-plugin-paths: package/nsis-plugins - name: Create MacOS Installer @@ -85,13 +92,13 @@ jobs: --version ${{ steps.get_version.outputs.VERSION }} \ --component ./dist/Tautulli.app \ --scripts ./package/macos-scripts \ - Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.pkg + Tautulli-${{ matrix.os }}-${{ steps.get_version.outputs.RELEASE_VERSION }}-${{ matrix.arch }}.${{ matrix.ext }} - name: Upload Installer uses: actions/upload-artifact@v4 with: name: Tautulli-${{ matrix.os }}-installer - path: Tautulli-${{ matrix.os }}-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.${{ matrix.ext }} + path: Tautulli-${{ matrix.os }}-${{ steps.get_version.outputs.RELEASE_VERSION }}-${{ matrix.arch }}.${{ matrix.ext }} release: name: Release Installers diff --git a/package/Tautulli-macos.spec b/package/Tautulli-macos.spec index bd61f1f2..8ffe6ba5 100644 --- a/package/Tautulli-macos.spec +++ b/package/Tautulli-macos.spec @@ -35,7 +35,8 @@ exe = EXE( name='Tautulli', console=False, icon='../data/interfaces/default/images/logo-circle.icns', - contents_directory='.' + contents_directory='.', + target_arch='universal2' ) coll = COLLECT( exe, From b73a2e9accf6b9b7f1393f9527aeb7b84151955e Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sat, 2 Mar 2024 16:28:27 -0800 Subject: [PATCH 070/290] Update workflow statuses --- .github/workflows/publish-docker.yml | 15 +-------------- .github/workflows/publish-installers.yml | 20 ++------------------ .github/workflows/publish-snap.yml | 15 +-------------- 3 files changed, 4 insertions(+), 46 deletions(-) diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml index 2eccdf5d..f0947104 100644 --- a/.github/workflows/publish-docker.yml +++ b/.github/workflows/publish-docker.yml @@ -94,23 +94,10 @@ jobs: if: always() && !contains(github.event.head_commit.message, '[skip ci]') runs-on: ubuntu-latest steps: - - name: Get Build Job Status - uses: technote-space/workflow-conclusion-action@v3 - - - name: Combine Job Status - id: status - run: | - failures=(neutral, skipped, timed_out, action_required) - if [[ ${array[@]} =~ $WORKFLOW_CONCLUSION ]]; then - echo "status=failure" >> $GITHUB_OUTPUT - else - echo "status=$WORKFLOW_CONCLUSION" >> $GITHUB_OUTPUT - fi - - name: Post Status to Discord uses: sarisia/actions-status-discord@v1 with: webhook: ${{ secrets.DISCORD_WEBHOOK }} - status: ${{ steps.status.outputs.status }} + status: ${{ needs.build-docker.result == 'success' && 'success' || contains(needs.*.result, 'failure') && 'failure' || 'cancelled' }} title: ${{ github.workflow }} nofail: true diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml index 87ebc15c..45610edf 100644 --- a/.github/workflows/publish-installers.yml +++ b/.github/workflows/publish-installers.yml @@ -106,9 +106,6 @@ jobs: if: always() && startsWith(github.ref, 'refs/tags/') && !contains(github.event.head_commit.message, '[skip ci]') runs-on: ubuntu-latest steps: - - name: Get Build Job Status - uses: technote-space/workflow-conclusion-action@v3 - - name: Checkout Code uses: actions/checkout@v4 @@ -118,7 +115,7 @@ jobs: echo "RELEASE_VERSION=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT - name: Download Installers - if: env.WORKFLOW_CONCLUSION == 'success' + if: needs.build-installer.result == 'success' uses: actions/download-artifact@v4 - name: Get Changelog @@ -154,23 +151,10 @@ jobs: if: always() && !contains(github.event.head_commit.message, '[skip ci]') runs-on: ubuntu-latest steps: - - name: Get Build Job Status - uses: technote-space/workflow-conclusion-action@v3 - - - name: Combine Job Status - id: status - run: | - failures=(neutral, skipped, timed_out, action_required) - if [[ ${array[@]} =~ $WORKFLOW_CONCLUSION ]]; then - echo "status=failure" >> $GITHUB_OUTPUT - else - echo "status=$WORKFLOW_CONCLUSION" >> $GITHUB_OUTPUT - fi - - name: Post Status to Discord uses: sarisia/actions-status-discord@v1 with: webhook: ${{ secrets.DISCORD_WEBHOOK }} - status: ${{ steps.status.outputs.status }} + status: ${{ needs.build-installer.result == 'success' && 'success' || contains(needs.*.result, 'failure') && 'failure' || 'cancelled' }} title: ${{ github.workflow }} nofail: true diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml index 65442eca..539282e1 100644 --- a/.github/workflows/publish-snap.yml +++ b/.github/workflows/publish-snap.yml @@ -69,23 +69,10 @@ jobs: if: always() && !contains(github.event.head_commit.message, '[skip ci]') runs-on: ubuntu-latest steps: - - name: Get Build Job Status - uses: technote-space/workflow-conclusion-action@v3 - - - name: Combine Job Status - id: status - run: | - failures=(neutral, skipped, timed_out, action_required) - if [[ ${array[@]} =~ $WORKFLOW_CONCLUSION ]]; then - echo "status=failure" >> $GITHUB_OUTPUT - else - echo "status=$WORKFLOW_CONCLUSION" >> $GITHUB_OUTPUT - fi - - name: Post Status to Discord uses: sarisia/actions-status-discord@v1 with: webhook: ${{ secrets.DISCORD_WEBHOOK }} - status: ${{ steps.status.outputs.status }} + status: ${{ needs.build-snap.result == 'success' && 'success' || contains(needs.*.result, 'failure') && 'failure' || 'cancelled' }} title: ${{ github.workflow }} nofail: true From 149c7fa7a0e9fa76060e95e5d69fc09d0ccb8267 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Sat, 2 Mar 2024 16:45:02 -0800 Subject: [PATCH 071/290] Bump snap to core22 --- snap/snapcraft.yaml | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/snap/snapcraft.yaml b/snap/snapcraft.yaml index 030e72a9..612b189d 100644 --- a/snap/snapcraft.yaml +++ b/snap/snapcraft.yaml @@ -7,7 +7,7 @@ description: > The only thing missing is "why they watched it", but who am I to question your 42 plays of Frozen. All statistics are presented in a nice and clean interface with many tables and graphs, which makes it easy to brag about your server to everyone else. -base: core20 +base: core22 confinement: strict architectures: @@ -37,8 +37,8 @@ parts: - python3-setuptools - python3-pkg-resources override-pull: | - snapcraftctl pull - git config --global --add safe.directory /data/parts/tautulli/src + craftctl default + git config --global --add safe.directory /root/parts/tautulli/src TAG_FULL=$(git describe --tag) TAG=$(echo $TAG_FULL | grep -oP '(v\d+\.\d+\.\d+(?>-beta)?)') BRANCH=$(git rev-parse --abbrev-ref HEAD) @@ -60,10 +60,10 @@ parts: fi echo $BRANCH > branch.txt echo $COMMIT > version.txt - snapcraftctl set-version "$VERSION" - snapcraftctl set-grade "$GRADE" + craftctl set version="$VERSION" + craftctl set grade="$GRADE" override-prime: | - snapcraftctl prime + craftctl default mkdir -p usr/bin ln -s /usr/bin/python3 usr/bin/python3 From 901c484f89cc4e6e91a389063b065c9f4c04ca89 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Thu, 14 Mar 2024 12:15:02 -0700 Subject: [PATCH 072/290] Include deleted usernames in log filter --- plexpy/logger.py | 2 +- plexpy/users.py | 6 ++++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/plexpy/logger.py b/plexpy/logger.py index 9f44df95..7227ab10 100644 --- a/plexpy/logger.py +++ b/plexpy/logger.py @@ -76,7 +76,7 @@ def filter_usernames(new_users=None): global _FILTER_USERNAMES if new_users is None: - new_users = [user['username'] for user in users.Users().get_users()] + new_users = [user['username'] for user in users.Users().get_users(include_deleted=True)] for username in new_users: if username.lower() not in ('local', 'guest') and len(username) > 3 and username not in _FILTER_USERNAMES: diff --git a/plexpy/users.py b/plexpy/users.py index 0e201791..974d30cd 100644 --- a/plexpy/users.py +++ b/plexpy/users.py @@ -679,15 +679,17 @@ class Users(object): return recently_watched - def get_users(self): + def get_users(self, include_deleted=False): monitor_db = database.MonitorDatabase() + where = '' if include_deleted else 'WHERE deleted_user = 0' + try: query = "SELECT id AS row_id, user_id, username, friendly_name, thumb, custom_avatar_url, email, " \ "is_active, is_admin, is_home_user, is_allow_sync, is_restricted, " \ "do_notify, keep_history, allow_guest, shared_libraries, " \ "filter_all, filter_movies, filter_tv, filter_music, filter_photos " \ - "FROM users WHERE deleted_user = 0" + "FROM users %s" % where result = monitor_db.select(query=query) except Exception as e: logger.warn("Tautulli Users :: Unable to execute database query for get_users: %s." % e) From 344f19c9d6581cddf92ff89dafadf358b1b0e784 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 14:53:10 -0700 Subject: [PATCH 073/290] Bump actions/cache from 3 to 4 (#2261) Bumps [actions/cache](https://github.com/actions/cache) from 3 to 4. - [Release notes](https://github.com/actions/cache/releases) - [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md) - [Commits](https://github.com/actions/cache/compare/v3...v4) --- updated-dependencies: - dependency-name: actions/cache dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- .github/workflows/publish-docker.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml index f0947104..1185e5eb 100644 --- a/.github/workflows/publish-docker.yml +++ b/.github/workflows/publish-docker.yml @@ -47,7 +47,7 @@ jobs: version: latest - name: Cache Docker Layers - uses: actions/cache@v3 + uses: actions/cache@v4 with: path: /tmp/.buildx-cache key: ${{ runner.os }}-buildx-${{ github.sha }} From d3504e8a3c192f28c12397494857c7b2dcc6e31a Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 14:53:44 -0700 Subject: [PATCH 074/290] Bump softprops/action-gh-release from 1 to 2 (#2273) Bumps [softprops/action-gh-release](https://github.com/softprops/action-gh-release) from 1 to 2. - [Release notes](https://github.com/softprops/action-gh-release/releases) - [Changelog](https://github.com/softprops/action-gh-release/blob/master/CHANGELOG.md) - [Commits](https://github.com/softprops/action-gh-release/compare/v1...v2) --- updated-dependencies: - dependency-name: softprops/action-gh-release dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> [skip ci] --- .github/workflows/publish-installers.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml index 45610edf..7b79eea6 100644 --- a/.github/workflows/publish-installers.yml +++ b/.github/workflows/publish-installers.yml @@ -129,7 +129,7 @@ jobs: echo "$EOF" >> $GITHUB_OUTPUT - name: Create Release - uses: softprops/action-gh-release@v1 + uses: softprops/action-gh-release@v2 id: create_release env: GITHUB_TOKEN: ${{ secrets.GHACTIONS_TOKEN }} From c1b8be0227d2aa47e4092e86a5e4e1e617ff0b13 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 15:20:52 -0700 Subject: [PATCH 075/290] Bump arrow from 1.2.3 to 1.3.0 (#2172) * Bump arrow from 1.2.3 to 1.3.0 Bumps [arrow](https://github.com/arrow-py/arrow) from 1.2.3 to 1.3.0. - [Release notes](https://github.com/arrow-py/arrow/releases) - [Changelog](https://github.com/arrow-py/arrow/blob/master/CHANGELOG.rst) - [Commits](https://github.com/arrow-py/arrow/compare/1.2.3...1.3.0) --- updated-dependencies: - dependency-name: arrow dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] * Update arrow==1.3.0 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/arrow/_version.py | 2 +- lib/arrow/arrow.py | 31 ++--- lib/arrow/factory.py | 3 - lib/arrow/formatter.py | 4 - lib/arrow/locales.py | 34 ++++-- lib/arrow/parser.py | 20 +-- lib/dateutil-stubs/METADATA.toml | 6 + lib/dateutil-stubs/__init__.pyi | 0 lib/dateutil-stubs/_common.pyi | 9 ++ lib/dateutil-stubs/easter.pyi | 8 ++ lib/dateutil-stubs/parser/__init__.pyi | 67 ++++++++++ lib/dateutil-stubs/parser/isoparser.pyi | 15 +++ lib/dateutil-stubs/py.typed | 1 + lib/dateutil-stubs/relativedelta.pyi | 97 +++++++++++++++ lib/dateutil-stubs/rrule.pyi | 111 +++++++++++++++++ lib/dateutil-stubs/tz/__init__.pyi | 15 +++ lib/dateutil-stubs/tz/_common.pyi | 28 +++++ lib/dateutil-stubs/tz/tz.pyi | 115 ++++++++++++++++++ lib/dateutil-stubs/utils.pyi | 5 + lib/dateutil-stubs/zoneinfo/__init__.pyi | 17 +++ lib/dateutil-stubs/zoneinfo/rebuild.pyi | 11 ++ lib/dateutil/__init__.py | 16 +++ lib/dateutil/_version.py | 5 +- lib/dateutil/parser/isoparser.py | 2 +- lib/dateutil/relativedelta.py | 2 +- lib/dateutil/rrule.py | 2 +- lib/dateutil/tz/tz.py | 2 +- .../zoneinfo/dateutil-zoneinfo.tar.gz | Bin 174394 -> 156400 bytes requirements.txt | 2 +- 29 files changed, 564 insertions(+), 66 deletions(-) create mode 100644 lib/dateutil-stubs/METADATA.toml create mode 100644 lib/dateutil-stubs/__init__.pyi create mode 100644 lib/dateutil-stubs/_common.pyi create mode 100644 lib/dateutil-stubs/easter.pyi create mode 100644 lib/dateutil-stubs/parser/__init__.pyi create mode 100644 lib/dateutil-stubs/parser/isoparser.pyi create mode 100644 lib/dateutil-stubs/py.typed create mode 100644 lib/dateutil-stubs/relativedelta.pyi create mode 100644 lib/dateutil-stubs/rrule.pyi create mode 100644 lib/dateutil-stubs/tz/__init__.pyi create mode 100644 lib/dateutil-stubs/tz/_common.pyi create mode 100644 lib/dateutil-stubs/tz/tz.pyi create mode 100644 lib/dateutil-stubs/utils.pyi create mode 100644 lib/dateutil-stubs/zoneinfo/__init__.pyi create mode 100644 lib/dateutil-stubs/zoneinfo/rebuild.pyi diff --git a/lib/arrow/_version.py b/lib/arrow/_version.py index 10aa336c..67bc602a 100644 --- a/lib/arrow/_version.py +++ b/lib/arrow/_version.py @@ -1 +1 @@ -__version__ = "1.2.3" +__version__ = "1.3.0" diff --git a/lib/arrow/arrow.py b/lib/arrow/arrow.py index 1ede107f..8d329efd 100644 --- a/lib/arrow/arrow.py +++ b/lib/arrow/arrow.py @@ -168,9 +168,9 @@ class Arrow: isinstance(tzinfo, dt_tzinfo) and hasattr(tzinfo, "localize") and hasattr(tzinfo, "zone") - and tzinfo.zone # type: ignore[attr-defined] + and tzinfo.zone ): - tzinfo = parser.TzinfoParser.parse(tzinfo.zone) # type: ignore[attr-defined] + tzinfo = parser.TzinfoParser.parse(tzinfo.zone) elif isinstance(tzinfo, str): tzinfo = parser.TzinfoParser.parse(tzinfo) @@ -495,7 +495,7 @@ class Arrow: yield current values = [getattr(current, f) for f in cls._ATTRS] - current = cls(*values, tzinfo=tzinfo).shift( # type: ignore + current = cls(*values, tzinfo=tzinfo).shift( # type: ignore[misc] **{frame_relative: relative_steps} ) @@ -578,7 +578,7 @@ class Arrow: for _ in range(3 - len(values)): values.append(1) - floor = self.__class__(*values, tzinfo=self.tzinfo) # type: ignore + floor = self.__class__(*values, tzinfo=self.tzinfo) # type: ignore[misc] if frame_absolute == "week": # if week_start is greater than self.isoweekday() go back one week by setting delta = 7 @@ -792,7 +792,6 @@ class Arrow: return self._datetime.isoformat() def __format__(self, formatstr: str) -> str: - if len(formatstr) > 0: return self.format(formatstr) @@ -804,7 +803,6 @@ class Arrow: # attributes and properties def __getattr__(self, name: str) -> int: - if name == "week": return self.isocalendar()[1] @@ -965,7 +963,6 @@ class Arrow: absolute_kwargs = {} for key, value in kwargs.items(): - if key in self._ATTRS: absolute_kwargs[key] = value elif key in ["week", "quarter"]: @@ -1022,7 +1019,6 @@ class Arrow: additional_attrs = ["weeks", "quarters", "weekday"] for key, value in kwargs.items(): - if key in self._ATTRS_PLURAL or key in additional_attrs: relative_kwargs[key] = value else: @@ -1259,11 +1255,10 @@ class Arrow: ) if trunc(abs(delta)) != 1: - granularity += "s" # type: ignore + granularity += "s" # type: ignore[assignment] return locale.describe(granularity, delta, only_distance=only_distance) else: - if not granularity: raise ValueError( "Empty granularity list provided. " @@ -1314,7 +1309,7 @@ class Arrow: def dehumanize(self, input_string: str, locale: str = "en_us") -> "Arrow": """Returns a new :class:`Arrow ` object, that represents - the time difference relative to the attrbiutes of the + the time difference relative to the attributes of the :class:`Arrow ` object. :param timestring: a ``str`` representing a humanized relative time. @@ -1367,7 +1362,6 @@ class Arrow: # Search input string for each time unit within locale for unit, unit_object in locale_obj.timeframes.items(): - # Need to check the type of unit_object to create the correct dictionary if isinstance(unit_object, Mapping): strings_to_search = unit_object @@ -1378,7 +1372,6 @@ class Arrow: # Needs to cycle all through strings as some locales have strings that # could overlap in a regex match, since input validation isn't being performed. for time_delta, time_string in strings_to_search.items(): - # Replace {0} with regex \d representing digits search_string = str(time_string) search_string = search_string.format(r"\d+") @@ -1419,7 +1412,7 @@ class Arrow: # Assert error if string does not modify any units if not any([True for k, v in unit_visited.items() if v]): raise ValueError( - "Input string not valid. Note: Some locales do not support the week granulairty in Arrow. " + "Input string not valid. Note: Some locales do not support the week granularity in Arrow. " "If you are attempting to use the week granularity on an unsupported locale, this could be the cause of this error." ) @@ -1718,7 +1711,6 @@ class Arrow: # math def __add__(self, other: Any) -> "Arrow": - if isinstance(other, (timedelta, relativedelta)): return self.fromdatetime(self._datetime + other, self._datetime.tzinfo) @@ -1736,7 +1728,6 @@ class Arrow: pass # pragma: no cover def __sub__(self, other: Any) -> Union[timedelta, "Arrow"]: - if isinstance(other, (timedelta, relativedelta)): return self.fromdatetime(self._datetime - other, self._datetime.tzinfo) @@ -1749,7 +1740,6 @@ class Arrow: return NotImplemented def __rsub__(self, other: Any) -> timedelta: - if isinstance(other, dt_datetime): return other - self._datetime @@ -1758,42 +1748,36 @@ class Arrow: # comparisons def __eq__(self, other: Any) -> bool: - if not isinstance(other, (Arrow, dt_datetime)): return False return self._datetime == self._get_datetime(other) def __ne__(self, other: Any) -> bool: - if not isinstance(other, (Arrow, dt_datetime)): return True return not self.__eq__(other) def __gt__(self, other: Any) -> bool: - if not isinstance(other, (Arrow, dt_datetime)): return NotImplemented return self._datetime > self._get_datetime(other) def __ge__(self, other: Any) -> bool: - if not isinstance(other, (Arrow, dt_datetime)): return NotImplemented return self._datetime >= self._get_datetime(other) def __lt__(self, other: Any) -> bool: - if not isinstance(other, (Arrow, dt_datetime)): return NotImplemented return self._datetime < self._get_datetime(other) def __le__(self, other: Any) -> bool: - if not isinstance(other, (Arrow, dt_datetime)): return NotImplemented @@ -1865,7 +1849,6 @@ class Arrow: def _get_iteration_params(cls, end: Any, limit: Optional[int]) -> Tuple[Any, int]: """Sets default end and limit values for range method.""" if end is None: - if limit is None: raise ValueError("One of 'end' or 'limit' is required.") diff --git a/lib/arrow/factory.py b/lib/arrow/factory.py index aad4af8b..f35085f1 100644 --- a/lib/arrow/factory.py +++ b/lib/arrow/factory.py @@ -267,11 +267,9 @@ class ArrowFactory: raise TypeError(f"Cannot parse single argument of type {type(arg)!r}.") elif arg_count == 2: - arg_1, arg_2 = args[0], args[1] if isinstance(arg_1, datetime): - # (datetime, tzinfo/str) -> fromdatetime @ tzinfo if isinstance(arg_2, (dt_tzinfo, str)): return self.type.fromdatetime(arg_1, tzinfo=arg_2) @@ -281,7 +279,6 @@ class ArrowFactory: ) elif isinstance(arg_1, date): - # (date, tzinfo/str) -> fromdate @ tzinfo if isinstance(arg_2, (dt_tzinfo, str)): return self.type.fromdate(arg_1, tzinfo=arg_2) diff --git a/lib/arrow/formatter.py b/lib/arrow/formatter.py index 728bea1a..d45f7153 100644 --- a/lib/arrow/formatter.py +++ b/lib/arrow/formatter.py @@ -29,7 +29,6 @@ FORMAT_W3C: Final[str] = "YYYY-MM-DD HH:mm:ssZZ" class DateTimeFormatter: - # This pattern matches characters enclosed in square brackets are matched as # an atomic group. For more info on atomic groups and how to they are # emulated in Python's re library, see https://stackoverflow.com/a/13577411/2701578 @@ -41,18 +40,15 @@ class DateTimeFormatter: locale: locales.Locale def __init__(self, locale: str = DEFAULT_LOCALE) -> None: - self.locale = locales.get_locale(locale) def format(cls, dt: datetime, fmt: str) -> str: - # FIXME: _format_token() is nullable return cls._FORMAT_RE.sub( lambda m: cast(str, cls._format_token(dt, m.group(0))), fmt ) def _format_token(self, dt: datetime, token: Optional[str]) -> Optional[str]: - if token and token.startswith("[") and token.endswith("]"): return token[1:-1] diff --git a/lib/arrow/locales.py b/lib/arrow/locales.py index 3627497f..34b2a098 100644 --- a/lib/arrow/locales.py +++ b/lib/arrow/locales.py @@ -129,7 +129,6 @@ class Locale: _locale_map[locale_name.lower().replace("_", "-")] = cls def __init__(self) -> None: - self._month_name_to_ordinal = None def describe( @@ -174,7 +173,7 @@ class Locale: # Needed to determine the correct relative string to use timeframe_value = 0 - for _unit_name, unit_value in timeframes: + for _, unit_value in timeframes: if trunc(unit_value) != 0: timeframe_value = trunc(unit_value) break @@ -285,7 +284,6 @@ class Locale: timeframe: TimeFrameLiteral, delta: Union[float, int], ) -> str: - if timeframe == "now": return humanized @@ -425,7 +423,7 @@ class ItalianLocale(Locale): "hours": "{0} ore", "day": "un giorno", "days": "{0} giorni", - "week": "una settimana,", + "week": "una settimana", "weeks": "{0} settimane", "month": "un mese", "months": "{0} mesi", @@ -867,14 +865,16 @@ class FinnishLocale(Locale): timeframes: ClassVar[Mapping[TimeFrameLiteral, Union[str, Mapping[str, str]]]] = { "now": "juuri nyt", - "second": "sekunti", - "seconds": {"past": "{0} muutama sekunti", "future": "{0} muutaman sekunnin"}, + "second": {"past": "sekunti", "future": "sekunnin"}, + "seconds": {"past": "{0} sekuntia", "future": "{0} sekunnin"}, "minute": {"past": "minuutti", "future": "minuutin"}, "minutes": {"past": "{0} minuuttia", "future": "{0} minuutin"}, "hour": {"past": "tunti", "future": "tunnin"}, "hours": {"past": "{0} tuntia", "future": "{0} tunnin"}, - "day": "päivä", + "day": {"past": "päivä", "future": "päivän"}, "days": {"past": "{0} päivää", "future": "{0} päivän"}, + "week": {"past": "viikko", "future": "viikon"}, + "weeks": {"past": "{0} viikkoa", "future": "{0} viikon"}, "month": {"past": "kuukausi", "future": "kuukauden"}, "months": {"past": "{0} kuukautta", "future": "{0} kuukauden"}, "year": {"past": "vuosi", "future": "vuoden"}, @@ -1887,7 +1887,7 @@ class GermanBaseLocale(Locale): future = "in {0}" and_word = "und" - timeframes = { + timeframes: ClassVar[Dict[TimeFrameLiteral, str]] = { "now": "gerade eben", "second": "einer Sekunde", "seconds": "{0} Sekunden", @@ -1982,7 +1982,9 @@ class GermanBaseLocale(Locale): return super().describe(timeframe, delta, only_distance) # German uses a different case without 'in' or 'ago' - humanized = self.timeframes_only_distance[timeframe].format(trunc(abs(delta))) + humanized: str = self.timeframes_only_distance[timeframe].format( + trunc(abs(delta)) + ) return humanized @@ -2547,6 +2549,8 @@ class ArabicLocale(Locale): "hours": {"2": "ساعتين", "ten": "{0} ساعات", "higher": "{0} ساعة"}, "day": "يوم", "days": {"2": "يومين", "ten": "{0} أيام", "higher": "{0} يوم"}, + "week": "اسبوع", + "weeks": {"2": "اسبوعين", "ten": "{0} أسابيع", "higher": "{0} اسبوع"}, "month": "شهر", "months": {"2": "شهرين", "ten": "{0} أشهر", "higher": "{0} شهر"}, "year": "سنة", @@ -3709,6 +3713,8 @@ class HungarianLocale(Locale): "hours": {"past": "{0} órával", "future": "{0} óra"}, "day": {"past": "egy nappal", "future": "egy nap"}, "days": {"past": "{0} nappal", "future": "{0} nap"}, + "week": {"past": "egy héttel", "future": "egy hét"}, + "weeks": {"past": "{0} héttel", "future": "{0} hét"}, "month": {"past": "egy hónappal", "future": "egy hónap"}, "months": {"past": "{0} hónappal", "future": "{0} hónap"}, "year": {"past": "egy évvel", "future": "egy év"}, @@ -3934,7 +3940,6 @@ class ThaiLocale(Locale): class LaotianLocale(Locale): - names = ["lo", "lo-la"] past = "{0} àºà»ˆàº­àº™àº«àº™à»‰àº²àº™àºµà»‰" @@ -4119,6 +4124,7 @@ class BengaliLocale(Locale): return f"{n}রà§à¦¥" if n == 6: return f"{n}ষà§à¦ " + return "" class RomanshLocale(Locale): @@ -4137,6 +4143,8 @@ class RomanshLocale(Locale): "hours": "{0} ura", "day": "in di", "days": "{0} dis", + "week": "in'emna", + "weeks": "{0} emnas", "month": "in mais", "months": "{0} mais", "year": "in onn", @@ -5399,7 +5407,7 @@ class LuxembourgishLocale(Locale): future = "an {0}" and_word = "an" - timeframes = { + timeframes: ClassVar[Dict[TimeFrameLiteral, str]] = { "now": "just elo", "second": "enger Sekonn", "seconds": "{0} Sekonnen", @@ -5487,7 +5495,9 @@ class LuxembourgishLocale(Locale): return super().describe(timeframe, delta, only_distance) # Luxembourgish uses a different case without 'in' or 'ago' - humanized = self.timeframes_only_distance[timeframe].format(trunc(abs(delta))) + humanized: str = self.timeframes_only_distance[timeframe].format( + trunc(abs(delta)) + ) return humanized diff --git a/lib/arrow/parser.py b/lib/arrow/parser.py index e95d78b0..645e3da7 100644 --- a/lib/arrow/parser.py +++ b/lib/arrow/parser.py @@ -159,7 +159,6 @@ class DateTimeParser: _input_re_map: Dict[_FORMAT_TYPE, Pattern[str]] def __init__(self, locale: str = DEFAULT_LOCALE, cache_size: int = 0) -> None: - self.locale = locales.get_locale(locale) self._input_re_map = self._BASE_INPUT_RE_MAP.copy() self._input_re_map.update( @@ -196,7 +195,6 @@ class DateTimeParser: def parse_iso( self, datetime_string: str, normalize_whitespace: bool = False ) -> datetime: - if normalize_whitespace: datetime_string = re.sub(r"\s+", " ", datetime_string.strip()) @@ -236,13 +234,14 @@ class DateTimeParser: ] if has_time: - if has_space_divider: date_string, time_string = datetime_string.split(" ", 1) else: date_string, time_string = datetime_string.split("T", 1) - time_parts = re.split(r"[\+\-Z]", time_string, 1, re.IGNORECASE) + time_parts = re.split( + r"[\+\-Z]", time_string, maxsplit=1, flags=re.IGNORECASE + ) time_components: Optional[Match[str]] = self._TIME_RE.match(time_parts[0]) @@ -303,7 +302,6 @@ class DateTimeParser: fmt: Union[List[str], str], normalize_whitespace: bool = False, ) -> datetime: - if normalize_whitespace: datetime_string = re.sub(r"\s+", " ", datetime_string) @@ -341,12 +339,11 @@ class DateTimeParser: f"Unable to find a match group for the specified token {token!r}." ) - self._parse_token(token, value, parts) # type: ignore + self._parse_token(token, value, parts) # type: ignore[arg-type] return self._build_datetime(parts) def _generate_pattern_re(self, fmt: str) -> Tuple[List[_FORMAT_TYPE], Pattern[str]]: - # fmt is a string of tokens like 'YYYY-MM-DD' # we construct a new string by replacing each # token by its pattern: @@ -498,7 +495,6 @@ class DateTimeParser: value: Any, parts: _Parts, ) -> None: - if token == "YYYY": parts["year"] = int(value) @@ -508,7 +504,7 @@ class DateTimeParser: elif token in ["MMMM", "MMM"]: # FIXME: month_number() is nullable - parts["month"] = self.locale.month_number(value.lower()) # type: ignore + parts["month"] = self.locale.month_number(value.lower()) # type: ignore[typeddict-item] elif token in ["MM", "M"]: parts["month"] = int(value) @@ -588,7 +584,6 @@ class DateTimeParser: weekdate = parts.get("weekdate") if weekdate is not None: - year, week = int(weekdate[0]), int(weekdate[1]) if weekdate[2] is not None: @@ -712,7 +707,6 @@ class DateTimeParser: ) def _parse_multiformat(self, string: str, formats: Iterable[str]) -> datetime: - _datetime: Optional[datetime] = None for fmt in formats: @@ -740,12 +734,11 @@ class DateTimeParser: class TzinfoParser: _TZINFO_RE: ClassVar[Pattern[str]] = re.compile( - r"^([\+\-])?(\d{2})(?:\:?(\d{2}))?$" + r"^(?:\(UTC)*([\+\-])?(\d{2})(?:\:?(\d{2}))?" ) @classmethod def parse(cls, tzinfo_string: str) -> dt_tzinfo: - tzinfo: Optional[dt_tzinfo] = None if tzinfo_string == "local": @@ -755,7 +748,6 @@ class TzinfoParser: tzinfo = tz.tzutc() else: - iso_match = cls._TZINFO_RE.match(tzinfo_string) if iso_match: diff --git a/lib/dateutil-stubs/METADATA.toml b/lib/dateutil-stubs/METADATA.toml new file mode 100644 index 00000000..5f2be1e4 --- /dev/null +++ b/lib/dateutil-stubs/METADATA.toml @@ -0,0 +1,6 @@ +version = "2.9.*" +upstream_repository = "https://github.com/dateutil/dateutil" +partial_stub = true + +[tool.stubtest] +ignore_missing_stub = true diff --git a/lib/dateutil-stubs/__init__.pyi b/lib/dateutil-stubs/__init__.pyi new file mode 100644 index 00000000..e69de29b diff --git a/lib/dateutil-stubs/_common.pyi b/lib/dateutil-stubs/_common.pyi new file mode 100644 index 00000000..75bf74c5 --- /dev/null +++ b/lib/dateutil-stubs/_common.pyi @@ -0,0 +1,9 @@ +from typing_extensions import Self + +class weekday: + def __init__(self, weekday: int, n: int | None = None) -> None: ... + def __call__(self, n: int) -> Self: ... + def __eq__(self, other: object) -> bool: ... + def __hash__(self) -> int: ... + weekday: int + n: int diff --git a/lib/dateutil-stubs/easter.pyi b/lib/dateutil-stubs/easter.pyi new file mode 100644 index 00000000..952d1191 --- /dev/null +++ b/lib/dateutil-stubs/easter.pyi @@ -0,0 +1,8 @@ +from datetime import date +from typing import Literal + +EASTER_JULIAN: Literal[1] +EASTER_ORTHODOX: Literal[2] +EASTER_WESTERN: Literal[3] + +def easter(year: int, method: Literal[1, 2, 3] = 3) -> date: ... diff --git a/lib/dateutil-stubs/parser/__init__.pyi b/lib/dateutil-stubs/parser/__init__.pyi new file mode 100644 index 00000000..c375ff15 --- /dev/null +++ b/lib/dateutil-stubs/parser/__init__.pyi @@ -0,0 +1,67 @@ +from collections.abc import Callable, Mapping +from datetime import datetime, tzinfo +from typing import IO, Any +from typing_extensions import TypeAlias + +from .isoparser import isoparse as isoparse, isoparser as isoparser + +_FileOrStr: TypeAlias = bytes | str | IO[str] | IO[Any] +_TzData: TypeAlias = tzinfo | int | str | None +_TzInfo: TypeAlias = Mapping[str, _TzData] | Callable[[str, int], _TzData] + +class parserinfo: + JUMP: list[str] + WEEKDAYS: list[tuple[str, ...]] + MONTHS: list[tuple[str, ...]] + HMS: list[tuple[str, str, str]] + AMPM: list[tuple[str, str]] + UTCZONE: list[str] + PERTAIN: list[str] + TZOFFSET: dict[str, int] + def __init__(self, dayfirst: bool = False, yearfirst: bool = False) -> None: ... + def jump(self, name: str) -> bool: ... + def weekday(self, name: str) -> int | None: ... + def month(self, name: str) -> int | None: ... + def hms(self, name: str) -> int | None: ... + def ampm(self, name: str) -> int | None: ... + def pertain(self, name: str) -> bool: ... + def utczone(self, name: str) -> bool: ... + def tzoffset(self, name: str) -> int | None: ... + def convertyear(self, year: int) -> int: ... + def validate(self, res: datetime) -> bool: ... + +class parser: + def __init__(self, info: parserinfo | None = None) -> None: ... + def parse( + self, + timestr: _FileOrStr, + default: datetime | None = None, + ignoretz: bool = False, + tzinfos: _TzInfo | None = None, + *, + dayfirst: bool | None = ..., + yearfirst: bool | None = ..., + fuzzy: bool = ..., + fuzzy_with_tokens: bool = ..., + ) -> datetime: ... + +DEFAULTPARSER: parser + +def parse( + timestr: _FileOrStr, + parserinfo: parserinfo | None = None, + *, + dayfirst: bool | None = ..., + yearfirst: bool | None = ..., + ignoretz: bool = ..., + fuzzy: bool = ..., + fuzzy_with_tokens: bool = ..., + default: datetime | None = ..., + tzinfos: _TzInfo | None = ..., +) -> datetime: ... + +class _tzparser: ... + +DEFAULTTZPARSER: _tzparser + +class ParserError(ValueError): ... diff --git a/lib/dateutil-stubs/parser/isoparser.pyi b/lib/dateutil-stubs/parser/isoparser.pyi new file mode 100644 index 00000000..fc5e46d9 --- /dev/null +++ b/lib/dateutil-stubs/parser/isoparser.pyi @@ -0,0 +1,15 @@ +from _typeshed import SupportsRead +from datetime import date, datetime, time, tzinfo +from typing_extensions import TypeAlias + +_Readable: TypeAlias = SupportsRead[str | bytes] +_TakesAscii: TypeAlias = str | bytes | _Readable + +class isoparser: + def __init__(self, sep: str | bytes | None = None): ... + def isoparse(self, dt_str: _TakesAscii) -> datetime: ... + def parse_isodate(self, datestr: _TakesAscii) -> date: ... + def parse_isotime(self, timestr: _TakesAscii) -> time: ... + def parse_tzstr(self, tzstr: _TakesAscii, zero_as_utc: bool = True) -> tzinfo: ... + +def isoparse(dt_str: _TakesAscii) -> datetime: ... diff --git a/lib/dateutil-stubs/py.typed b/lib/dateutil-stubs/py.typed new file mode 100644 index 00000000..b648ac92 --- /dev/null +++ b/lib/dateutil-stubs/py.typed @@ -0,0 +1 @@ +partial diff --git a/lib/dateutil-stubs/relativedelta.pyi b/lib/dateutil-stubs/relativedelta.pyi new file mode 100644 index 00000000..394713db --- /dev/null +++ b/lib/dateutil-stubs/relativedelta.pyi @@ -0,0 +1,97 @@ +from datetime import date, timedelta +from typing import SupportsFloat, TypeVar, overload +from typing_extensions import Self, TypeAlias + +# See #9817 for why we reexport this here +from ._common import weekday as weekday + +_DateT = TypeVar("_DateT", bound=date) +# Work around attribute and type having the same name. +_Weekday: TypeAlias = weekday + +MO: weekday +TU: weekday +WE: weekday +TH: weekday +FR: weekday +SA: weekday +SU: weekday + +class relativedelta: + years: int + months: int + days: int + leapdays: int + hours: int + minutes: int + seconds: int + microseconds: int + year: int | None + month: int | None + weekday: _Weekday | None + day: int | None + hour: int | None + minute: int | None + second: int | None + microsecond: int | None + def __init__( + self, + dt1: date | None = None, + dt2: date | None = None, + years: int | None = 0, + months: int | None = 0, + days: int | None = 0, + leapdays: int | None = 0, + weeks: int | None = 0, + hours: int | None = 0, + minutes: int | None = 0, + seconds: int | None = 0, + microseconds: int | None = 0, + year: int | None = None, + month: int | None = None, + day: int | None = None, + weekday: int | _Weekday | None = None, + yearday: int | None = None, + nlyearday: int | None = None, + hour: int | None = None, + minute: int | None = None, + second: int | None = None, + microsecond: int | None = None, + ) -> None: ... + @property + def weeks(self) -> int: ... + @weeks.setter + def weeks(self, value: int) -> None: ... + def normalized(self) -> Self: ... + # TODO: use Union when mypy will handle it properly in overloaded operator + # methods (#2129, #1442, #1264 in mypy) + @overload + def __add__(self, other: relativedelta) -> Self: ... + @overload + def __add__(self, other: timedelta) -> Self: ... + @overload + def __add__(self, other: _DateT) -> _DateT: ... + @overload + def __radd__(self, other: relativedelta) -> Self: ... + @overload + def __radd__(self, other: timedelta) -> Self: ... + @overload + def __radd__(self, other: _DateT) -> _DateT: ... + @overload + def __rsub__(self, other: relativedelta) -> Self: ... + @overload + def __rsub__(self, other: timedelta) -> Self: ... + @overload + def __rsub__(self, other: _DateT) -> _DateT: ... + def __sub__(self, other: relativedelta) -> Self: ... + def __neg__(self) -> Self: ... + def __bool__(self) -> bool: ... + def __nonzero__(self) -> bool: ... + def __mul__(self, other: SupportsFloat) -> Self: ... + def __rmul__(self, other: SupportsFloat) -> Self: ... + def __eq__(self, other: object) -> bool: ... + def __ne__(self, other: object) -> bool: ... + def __div__(self, other: SupportsFloat) -> Self: ... + def __truediv__(self, other: SupportsFloat) -> Self: ... + def __abs__(self) -> Self: ... + def __hash__(self) -> int: ... diff --git a/lib/dateutil-stubs/rrule.pyi b/lib/dateutil-stubs/rrule.pyi new file mode 100644 index 00000000..f091cfbd --- /dev/null +++ b/lib/dateutil-stubs/rrule.pyi @@ -0,0 +1,111 @@ +import datetime +from _typeshed import Incomplete +from collections.abc import Iterable, Iterator, Sequence +from typing_extensions import TypeAlias + +from ._common import weekday as weekdaybase + +YEARLY: int +MONTHLY: int +WEEKLY: int +DAILY: int +HOURLY: int +MINUTELY: int +SECONDLY: int + +class weekday(weekdaybase): ... + +weekdays: tuple[weekday, weekday, weekday, weekday, weekday, weekday, weekday] +MO: weekday +TU: weekday +WE: weekday +TH: weekday +FR: weekday +SA: weekday +SU: weekday + +class rrulebase: + def __init__(self, cache: bool = False) -> None: ... + def __iter__(self) -> Iterator[datetime.datetime]: ... + def __getitem__(self, item): ... + def __contains__(self, item): ... + def count(self): ... + def before(self, dt, inc: bool = False): ... + def after(self, dt, inc: bool = False): ... + def xafter(self, dt, count: Incomplete | None = None, inc: bool = False): ... + def between(self, after, before, inc: bool = False, count: int = 1): ... + +class rrule(rrulebase): + def __init__( + self, + freq, + dtstart: datetime.date | None = None, + interval: int = 1, + wkst: weekday | int | None = None, + count: int | None = None, + until: datetime.date | int | None = None, + bysetpos: int | Iterable[int] | None = None, + bymonth: int | Iterable[int] | None = None, + bymonthday: int | Iterable[int] | None = None, + byyearday: int | Iterable[int] | None = None, + byeaster: int | Iterable[int] | None = None, + byweekno: int | Iterable[int] | None = None, + byweekday: int | weekday | Iterable[int] | Iterable[weekday] | None = None, + byhour: int | Iterable[int] | None = None, + byminute: int | Iterable[int] | None = None, + bysecond: int | Iterable[int] | None = None, + cache: bool = False, + ) -> None: ... + def replace(self, **kwargs): ... + +_RRule: TypeAlias = rrule + +class _iterinfo: + rrule: _RRule + def __init__(self, rrule: _RRule) -> None: ... + yearlen: int | None + nextyearlen: int | None + yearordinal: int | None + yearweekday: int | None + mmask: Sequence[int] | None + mdaymask: Sequence[int] | None + nmdaymask: Sequence[int] | None + wdaymask: Sequence[int] | None + mrange: Sequence[int] | None + wnomask: Sequence[int] | None + nwdaymask: Sequence[int] | None + eastermask: Sequence[int] | None + lastyear: int | None + lastmonth: int | None + def rebuild(self, year, month): ... + def ydayset(self, year, month, day): ... + def mdayset(self, year, month, day): ... + def wdayset(self, year, month, day): ... + def ddayset(self, year, month, day): ... + def htimeset(self, hour, minute, second): ... + def mtimeset(self, hour, minute, second): ... + def stimeset(self, hour, minute, second): ... + +class rruleset(rrulebase): + class _genitem: + dt: Incomplete + genlist: list[Incomplete] + gen: Incomplete + def __init__(self, genlist, gen) -> None: ... + def __next__(self) -> None: ... + next = __next__ + def __lt__(self, other) -> bool: ... + def __gt__(self, other) -> bool: ... + def __eq__(self, other) -> bool: ... + def __ne__(self, other) -> bool: ... + + def __init__(self, cache: bool = False) -> None: ... + def rrule(self, rrule: _RRule): ... + def rdate(self, rdate): ... + def exrule(self, exrule): ... + def exdate(self, exdate): ... + +class _rrulestr: + def __call__(self, s, **kwargs) -> rrule | rruleset: ... + +rrulestr: _rrulestr diff --git a/lib/dateutil-stubs/tz/__init__.pyi b/lib/dateutil-stubs/tz/__init__.pyi new file mode 100644 index 00000000..334ca482 --- /dev/null +++ b/lib/dateutil-stubs/tz/__init__.pyi @@ -0,0 +1,15 @@ +from .tz import ( + datetime_ambiguous as datetime_ambiguous, + datetime_exists as datetime_exists, + gettz as gettz, + resolve_imaginary as resolve_imaginary, + tzfile as tzfile, + tzical as tzical, + tzlocal as tzlocal, + tzoffset as tzoffset, + tzrange as tzrange, + tzstr as tzstr, + tzutc as tzutc, +) + +UTC: tzutc diff --git a/lib/dateutil-stubs/tz/_common.pyi b/lib/dateutil-stubs/tz/_common.pyi new file mode 100644 index 00000000..4e64822f --- /dev/null +++ b/lib/dateutil-stubs/tz/_common.pyi @@ -0,0 +1,28 @@ +import abc +from datetime import datetime, timedelta, tzinfo +from typing import ClassVar + +def tzname_in_python2(namefunc): ... +def enfold(dt: datetime, fold: int = 1): ... + +class _DatetimeWithFold(datetime): + @property + def fold(self): ... + +# Doesn't actually have ABCMeta as the metaclass at runtime, +# but mypy complains if we don't have it in the stub. +# See discussion in #8908 +class _tzinfo(tzinfo, metaclass=abc.ABCMeta): + def is_ambiguous(self, dt: datetime) -> bool: ... + def fromutc(self, dt: datetime) -> datetime: ... + +class tzrangebase(_tzinfo): + def __init__(self) -> None: ... + def utcoffset(self, dt: datetime | None) -> timedelta | None: ... + def dst(self, dt: datetime | None) -> timedelta | None: ... + def tzname(self, dt: datetime | None) -> str: ... + def fromutc(self, dt: datetime) -> datetime: ... + def is_ambiguous(self, dt: datetime) -> bool: ... + __hash__: ClassVar[None] # type: ignore[assignment] + def __ne__(self, other): ... + __reduce__ = object.__reduce__ diff --git a/lib/dateutil-stubs/tz/tz.pyi b/lib/dateutil-stubs/tz/tz.pyi new file mode 100644 index 00000000..6addba65 --- /dev/null +++ b/lib/dateutil-stubs/tz/tz.pyi @@ -0,0 +1,115 @@ +import datetime +from _typeshed import Incomplete +from typing import ClassVar, Literal, Protocol, TypeVar + +from ..relativedelta import relativedelta +from ._common import _tzinfo as _tzinfo, enfold as enfold, tzname_in_python2 as tzname_in_python2, tzrangebase as tzrangebase + +_DT = TypeVar("_DT", bound=datetime.datetime) + +ZERO: datetime.timedelta +EPOCH: datetime.datetime +EPOCHORDINAL: int + +class tzutc(datetime.tzinfo): + def utcoffset(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ... + def dst(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ... + def tzname(self, dt: datetime.datetime | None) -> str: ... + def is_ambiguous(self, dt: datetime.datetime | None) -> bool: ... + def fromutc(self, dt: _DT) -> _DT: ... + def __eq__(self, other): ... + __hash__: ClassVar[None] # type: ignore[assignment] + def __ne__(self, other): ... + __reduce__ = object.__reduce__ + +class tzoffset(datetime.tzinfo): + def __init__(self, name, offset) -> None: ... + def utcoffset(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ... + def dst(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ... + def is_ambiguous(self, dt: datetime.datetime | None) -> bool: ... + def tzname(self, dt: datetime.datetime | None) -> str: ... + def fromutc(self, dt: _DT) -> _DT: ... + def __eq__(self, other): ... + __hash__: ClassVar[None] # type: ignore[assignment] + def __ne__(self, other): ... + __reduce__ = object.__reduce__ + @classmethod + def instance(cls, name, offset) -> tzoffset: ... + +class tzlocal(_tzinfo): + def __init__(self) -> None: ... + def utcoffset(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ... + def dst(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ... + def tzname(self, dt: datetime.datetime | None) -> str: ... + def is_ambiguous(self, dt: datetime.datetime | None) -> bool: ... + def __eq__(self, other): ... + __hash__: ClassVar[None] # type: ignore[assignment] + def __ne__(self, other): ... + __reduce__ = object.__reduce__ + +class _ttinfo: + def __init__(self) -> None: ... + def __eq__(self, other): ... + __hash__: ClassVar[None] # type: ignore[assignment] + def __ne__(self, other): ... + +class _TZFileReader(Protocol): + # optional attribute: + # name: str + def read(self, size: int, /) -> bytes: ... + def seek(self, target: int, whence: Literal[1], /) -> object: ... + +class tzfile(_tzinfo): + def __init__(self, fileobj: str | _TZFileReader, filename: str | None = None) -> None: ... + def is_ambiguous(self, dt: datetime.datetime | None, idx: int | None = None) -> bool: ... + def utcoffset(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ... + def dst(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ... + def tzname(self, dt: datetime.datetime | None) -> str: ... + def __eq__(self, other): ... + __hash__: ClassVar[None] # type: ignore[assignment] + def __ne__(self, other): ... + def __reduce__(self): ... + def __reduce_ex__(self, protocol): ... + +class tzrange(tzrangebase): + hasdst: bool + def __init__( + self, + stdabbr: str, + stdoffset: int | datetime.timedelta | None = None, + dstabbr: str | None = None, + dstoffset: int | datetime.timedelta | None = None, + start: relativedelta | None = None, + end: relativedelta | None = None, + ) -> None: ... + def transitions(self, year: int) -> tuple[datetime.datetime, datetime.datetime]: ... + def __eq__(self, other): ... + +class tzstr(tzrange): + hasdst: bool + def __init__(self, s: str, posix_offset: bool = False) -> None: ... + @classmethod + def instance(cls, name, offset) -> tzoffset: ... + +class _ICalReader(Protocol): + # optional attribute: + # name: str + def read(self) -> str: ... + +class tzical: + def __init__(self, fileobj: str | _ICalReader) -> None: ... + def keys(self): ... + def get(self, tzid: Incomplete | None = None): ... + +TZFILES: list[str] +TZPATHS: list[str] + +def datetime_exists(dt: datetime.datetime, tz: datetime.tzinfo | None = None) -> bool: ... +def datetime_ambiguous(dt: datetime.datetime, tz: datetime.tzinfo | None = None) -> bool: ... +def resolve_imaginary(dt: datetime.datetime) -> datetime.datetime: ... + +class _GetTZ: + def __call__(self, name: str | None = ...) -> datetime.tzinfo | None: ... + def nocache(self, name: str | None) -> datetime.tzinfo | None: ... + +gettz: _GetTZ diff --git a/lib/dateutil-stubs/utils.pyi b/lib/dateutil-stubs/utils.pyi new file mode 100644 index 00000000..8c9f5e44 --- /dev/null +++ b/lib/dateutil-stubs/utils.pyi @@ -0,0 +1,5 @@ +from datetime import datetime, timedelta, tzinfo + +def default_tzinfo(dt: datetime, tzinfo: tzinfo) -> datetime: ... +def today(tzinfo: tzinfo | None = None) -> datetime: ... +def within_delta(dt1: datetime, dt2: datetime, delta: timedelta) -> bool: ... diff --git a/lib/dateutil-stubs/zoneinfo/__init__.pyi b/lib/dateutil-stubs/zoneinfo/__init__.pyi new file mode 100644 index 00000000..7bd2845a --- /dev/null +++ b/lib/dateutil-stubs/zoneinfo/__init__.pyi @@ -0,0 +1,17 @@ +from _typeshed import Incomplete +from typing import IO +from typing_extensions import TypeAlias + +__all__ = ["get_zonefile_instance", "gettz", "gettz_db_metadata"] + +_MetadataType: TypeAlias = dict[str, Incomplete] + +class ZoneInfoFile: + zones: dict[Incomplete, Incomplete] + metadata: _MetadataType | None + def __init__(self, zonefile_stream: IO[bytes] | None = None) -> None: ... + def get(self, name, default: Incomplete | None = None): ... + +def get_zonefile_instance(new_instance: bool = False) -> ZoneInfoFile: ... +def gettz(name): ... +def gettz_db_metadata() -> _MetadataType: ... diff --git a/lib/dateutil-stubs/zoneinfo/rebuild.pyi b/lib/dateutil-stubs/zoneinfo/rebuild.pyi new file mode 100644 index 00000000..e3845926 --- /dev/null +++ b/lib/dateutil-stubs/zoneinfo/rebuild.pyi @@ -0,0 +1,11 @@ +from _typeshed import Incomplete, StrOrBytesPath +from collections.abc import Sequence +from tarfile import TarInfo + +def rebuild( + filename: StrOrBytesPath, + tag: Incomplete | None = None, + format: str = "gz", + zonegroups: Sequence[str | TarInfo] = [], + metadata: Incomplete | None = None, +) -> None: ... diff --git a/lib/dateutil/__init__.py b/lib/dateutil/__init__.py index 0defb82e..a2c19c06 100644 --- a/lib/dateutil/__init__.py +++ b/lib/dateutil/__init__.py @@ -1,4 +1,6 @@ # -*- coding: utf-8 -*- +import sys + try: from ._version import version as __version__ except ImportError: @@ -6,3 +8,17 @@ except ImportError: __all__ = ['easter', 'parser', 'relativedelta', 'rrule', 'tz', 'utils', 'zoneinfo'] + +def __getattr__(name): + import importlib + + if name in __all__: + return importlib.import_module("." + name, __name__) + raise AttributeError( + "module {!r} has not attribute {!r}".format(__name__, name) + ) + + +def __dir__(): + # __dir__ should include all the lazy-importable modules as well. + return [x for x in globals() if x not in sys.modules] + __all__ diff --git a/lib/dateutil/_version.py b/lib/dateutil/_version.py index b723056a..ddda9809 100644 --- a/lib/dateutil/_version.py +++ b/lib/dateutil/_version.py @@ -1,5 +1,4 @@ -# coding: utf-8 # file generated by setuptools_scm # don't change, don't track in version control -version = '2.8.2' -version_tuple = (2, 8, 2) +__version__ = version = '2.9.0.post0' +__version_tuple__ = version_tuple = (2, 9, 0) diff --git a/lib/dateutil/parser/isoparser.py b/lib/dateutil/parser/isoparser.py index 5d7bee38..7060087d 100644 --- a/lib/dateutil/parser/isoparser.py +++ b/lib/dateutil/parser/isoparser.py @@ -72,7 +72,7 @@ class isoparser(object): Common: - ``YYYY`` - - ``YYYY-MM`` or ``YYYYMM`` + - ``YYYY-MM`` - ``YYYY-MM-DD`` or ``YYYYMMDD`` Uncommon: diff --git a/lib/dateutil/relativedelta.py b/lib/dateutil/relativedelta.py index a9e85f7e..cd323a54 100644 --- a/lib/dateutil/relativedelta.py +++ b/lib/dateutil/relativedelta.py @@ -48,7 +48,7 @@ class relativedelta(object): the corresponding arithmetic operation on the original datetime value with the information in the relativedelta. - weekday: + weekday: One of the weekday instances (MO, TU, etc) available in the relativedelta module. These instances may receive a parameter N, specifying the Nth weekday, which could be positive or negative diff --git a/lib/dateutil/rrule.py b/lib/dateutil/rrule.py index b3203393..571a0d2b 100644 --- a/lib/dateutil/rrule.py +++ b/lib/dateutil/rrule.py @@ -182,7 +182,7 @@ class rrulebase(object): # __len__() introduces a large performance penalty. def count(self): """ Returns the number of recurrences in this set. It will have go - trough the whole recurrence, if this hasn't been done before. """ + through the whole recurrence, if this hasn't been done before. """ if self._len is None: for x in self: pass diff --git a/lib/dateutil/tz/tz.py b/lib/dateutil/tz/tz.py index c67f56d4..61759144 100644 --- a/lib/dateutil/tz/tz.py +++ b/lib/dateutil/tz/tz.py @@ -34,7 +34,7 @@ except ImportError: from warnings import warn ZERO = datetime.timedelta(0) -EPOCH = datetime.datetime.utcfromtimestamp(0) +EPOCH = datetime.datetime(1970, 1, 1, 0, 0) EPOCHORDINAL = EPOCH.toordinal() diff --git a/lib/dateutil/zoneinfo/dateutil-zoneinfo.tar.gz b/lib/dateutil/zoneinfo/dateutil-zoneinfo.tar.gz index 524c48e12db7dfe159f282e4664f71ce249e1970..1461f8c862df8c3eae75e0ea376788b5b2602269 100644 GIT binary patch literal 156400 zcmX_|1yoeu7w_qk7(k@EK|rKC1qneykQNXSP`YbqhL#eLl5S8!Bu7bU=?+1<8wO_X zyZqjJ|FvfAbMEKtv(I;*GqdL2JLe8#EFRtw150alg z8Elr>XB5xyRSP#gT~xj0sjvE$X1WT^Ju6VVti2`^%waw}T7G~()V3wDC4Dv`Rc+kl za1i5V=cVDn$yTEFtghec7T_9G_yw2gyG3_!P-;!5sHq$0t4fWJC}ZfQwr zEz2bQk^qkwKP7Bu3F0Tm#Pme|Q}*dp9MBNW%?;%U#xFmyj!|cdb&aLYmVSC%3m=Y> z)i9$I1lEBKRg$`Do|(z%ff2w91(=~oh(B@zQL{;YnD5(LdOdc>xl8l}H-TU@iPftc zIsNZvz^l2#OZV~VccxY?QonKz8FG^{M42T-igirv-taa@Tw58h%_?7ocjI?)mc$ne z5dQVP;bone`d)1^VO{ywJErxOgR$=3d4IJ)0CZ2~F2{Ql5ZXz(;f&K{$a)T_qXy+A zp3E-A5Gzy`^~duAy?@D7nw2mxPLSxV8=|b3Dp)w!kv)A)YJ@I{aU>e=S#hJ-B5~O{ zaIhmH8u9V8T@p13sgg3N#GgKqc2Ryu>&N>fKC3Dg zRs>EQ6)DwI7TG6Ev-HaxPyWz9BKu6mAU#eGfn?9xhD(V*7Jl+X*i!lV>o+gAo#9K) zw`HUNg0kbOgb2GJH=k#LWd5qTTcV~$0{qx)E$1O3c6|a09ESf3t+jt&(%gqa9dt+A zmpiN#9~Bjq6eqeRYTO|cGe1h6kgRBHCTeSHYw{j1KlcvsbC@sESfTlwz!(PKxjI_f z(9-xV*AR3yPv$TK^+MX+%3WU8F5+m@NqsAW_5!N_Rz&3N#Y*E2KnRPzW&{M}{JtU? zrGSMSfMyi<87We1;N2u>iP(%=z$9z|AEi2Z)sbw(OjC^6$1baw}gd z`5vZVPM_Vb9JhUSNwZs~Nwh;XNaTLl==J{&o$LB$twuDeDxf0nHA3LE-vW=e_BQtH z%U$Nz?uj_bRZpDu($AfqT7OP*v6#AgR8FQh;qG3`pHQJ-Cp|?2Jtz-4W7dvOmXa0; zdc9SCGxt=xy1k|JvV>E{bJ=%B=juX??jkqus0_&H8(Yo2r5pKXpAf0EP9N{rD^AmN zwELs@Sy`c)8MLpO!a?#*L)GUFN^rS&=}WFXpfEq5CpuRs!yXL>=CQL~AIzek{`b6r!l}CX9HeUMjOqx_a237MD79`}WZn zuUsjM%I?DME+44s_Y);EsORGAzb3@hSr#Kza7PU$N86qac*p&5+-$sq<7CDeb*fa^!BWd;v86$-bLQX zDZvwt{-m*%&zxP7hrg@NV>#VtZ2O9wulzY^1*8s9@2a;gauRU5?(Km*cQF4hSF+IzD^XwQ8q}7L11h2|;6_lE=b= zeL*9oVhY7n4i3g6gM?tPyq3oz3=$8;QCyh8Q^4Yft!{*-VNfYU+}-l!aY%W;w9!-}MRN=6M)>|*UJ3cO!d$?rlS{E#(l#h>ypDm-RPW?LpKqVTd1 zh$v(YM{!jiMu(TbE*acS9KI^3b}o;{n9@xWjur}0kPT5(#8V_xz+=JF!2&!xw^g-` zaaOAzwTBuC5l<_hovpqS@CK3IgkA1k-tAx~Mfj{OFZ5E0!V?-GB? zCu6k&0v#y0B8pQ~2=JwkXRr-C3BNQ=blr7tHfh|-lPm5xMq%!@mD}&$85)`(j;TC< z6>?5dN*x$lsH?rA6s>u~w|iD_;jnWwX$TGIG)AC!r)g`2zkk{Z)VEf#cf9GcuA*>Y z^|YB++RYj(o@~PKuP{n$DmU_VoD^AUujr^h;M-fO>X~l2>6*H5XZ+SSYCIh|^liFV z$J;n-&CevuS)kepKfU^DUiQO>cz?5{7N88#q3w8qoY1-mTW75zF}$dkz1w7WZ=LR1 z4BCF?*ar=*rqA-@Vk~Zd7t~A1D0wpkN2F=Q6|sI1l6t!gRpS*AaR>Suq3 z0Qn`Ucl8&plRSGVqOCc%pPf8{j2(-GS{D`VE^7hTL%^Zs>?f)<8+V0qL%PBCv**?U5vi!+rfr&n7F)x0*)zy@RfP$7(sAzTeszo5)`26PSQ**Y3%wNS6Z- zJ>V$!b$o}yq*eW-!f zmV?^6+dGQ#IPK`@6-UyT%OAvFB2%;QSpY+f5qQ=^)#Fn^EoTOYQrTi3Mkw@V-J6=B)a~4w(d3ZqR$Cn)aTzK5r%%x0h z6ya5&9}OU<1d3J)zaQh3V>35tCYwU)9w_=L{1(8&$6@YbDxwOf3;XyMQb(xxS>d-3 zUNjE#gl4h>#BG?ZABTB?sVGbBbeNw;P5kWREaOKvj(&+&2euu}WKXY|=ku9tNBeb2 z-9l=cb01jC?UEPk_f(Qc176YzJeR|}!A-)DFG7cuqbW|iJlpe2dQ7ZF2tFqH|=lT_r3$RImd%IcQ7#^_1L@I*gd1Pk*h<%74Xxn3+lix?>#uE$i(&cIE<%p> z*o&I#W)bc}D^nlDCcK0`h}CZ|X|@t_*FEh{?0Cg+opmuUxf*(7tZy540L-ECWPq#Q zB^Na(LGbH713+F_DAfHU{6Rxmy0VJOs|LQK7S80H7pt#U3jk`U2q2_Se3OG3w9Hqy zyvehY2EvBL@UgzEq^o-ZB(@9`L(wHX~=JS$o8j!iv18_A@o z6U(3|r4!_}X@6_Luqi_C&M54>dtG3}F4W)Fj1sPQFikZQ@h&owX=^q@4&tVMCTist zY2x5%4E)U9Xc4WyOIP`2GG|P`d<$t%o~Lha|K&(G+dEsA#(_6g#Z98#^;C6}FAXl5 z)o`lg#5Xo~UVELn2EBW9_Fc~;wS;ysW7w;$Kp0y6ZQN?7OMOsPgSVQ2v9N&wSwN)h2bdGT4wrp-QWx{qLZGFgVkC*$v z?n+QKF^?Kvbw;dIHGBzAXHN|m3j-?X4;+1hZ z^^0^{5>-WuA`6qzMazvnMm ze8d)d^Nn)U@aVKWd@DmTMs*gg9rvmaQ*MuiV^MG2B4akJe14}oH+Jq{Db?GQytR)n zf?}SD-f%O3AOnjuoyjWY1vExm^p;yC^I_?GgkDuB%n%|t$cfJ7bi;<$!=H!s<$5Cp z?O|5{S@2qhHpa`xXKH9McCz^Lg2SLw&ApT8y_4-(o>g|~Z{2Jm?&-OJQXjjmaI0K3 zR}z*>g>Jd5fg<$xJSoIqb(D;MmOR}-2LV0^_`jBG&ffz}5Rht) zeWE5dtI2WjCOHUnqUi*k@IWVauvab!KHmcZ5b%MZmP~n)g6cChX-3%S zaq~C8=G^<{5wKYjY(4-%$9;fN5J+bYhy_pI{yq4F9^zB`tX9;@{DVtn@LH~ch@J?GV7k;Lif6nWEhj8Z9)X z4G&c4ACV|LTp1geKHg!S{#BedtYksgL@ehuFTGq^ez79xyb%!OKCELA$CY`r@j^yB z`(3qd?)7P(4kz!`pmek6N?9%Z!N}caT9r}k@Sb!U8!u^g}9Rb zG*=0y*Qq~zMrKOS*%|MM(->@;(R}gnePUD#3=?-`DXt~j&sI&P`=p)^$#4mHmyR-+ zSrJ^=6^i`I~wyyphuHDEq4Eh9-9Ej%5D77Z2wI*&|{NaB)?(`3A;PnL?wC;UV zL0_j0UzrBSX7>E0K|cHgD<`#gV(uEc9@vpQ zXmJk?{JH_2NOa2r&U^4`pr-)1ya8x!XySh2CzR8nvENIA{mj%o8Ao zw+#>#WxqzI>Xe|oPn1S0?%F#_)U!J_TN5vu;K|vJ_1aP^65@YuoTkmUS~i*yh~~=d z<*i+Dv9}|xPT2v=&D>7O?(QoQh)>7NBUkfIE>7_arOq-hwSX^(>Rggd!qb2stsQo^ zW(U$zpEPn4Q^otVMqNj1QY{%C_q5!;|6;A}R^#p*pod)Nnz&IzMj|+KM*U?a93(F< zf|i;Enu>ClcJa+0Y|FDx`L6CcXXDD%<})IWS-1WU!*^AerOO!u3tJ`v99myLc&FKt zGJ_Fw0&5JGeC&B@EdR>d1MGR{^X<`}zbGrdFKKr7#~o}-pP{v94N~er(5}lC$&#uh zly15IMz1RdG1?^Ng<=UT-4fO5M|5AT zXBQVzN)4tu?wzMGx*~#J%@~acP8&Iy)J%--9z2E@d^fjD->+@x~-Q|*ss zT$@?}sVM;c< zN1s5Hd5;_ve)Hk=V>7pECYzhf!TzPIkr66JDm?%8+VEYXUKQ`;0{1k<=b~88h_^vR zzK`|@E+%_g6nQqyr)HpHrr|`Kk!cWU)~IL!NZ?L!aw&2 zb$C`UBDm;}TNG2td}Nr_AG9Svig7@7<6Xs-o~$p91DMn)+MFQ85575l?5|A{%}ABZ zNR{=WXI5v{RA-fThUxYf@8K~QKjE%EzGGJBlZL{^AB-{obj13G9N@6G#r^Wok&-5ck7b6kvK9(TR3x!oIgbik#*A{6zv z%l$p@=aQt>9{9r#MY-OrN7*Pz0uT0I_}3#X7685~U_pf#ybb-$`UYpVze=B4N>37Z z88)hXIXFio{R?t@`CF?!gG^+E#42mjuGDk6hx;1?Z0UqF7Hy2#r%a1e-OTyuKk(R? zs=l)DEnK_x;cLvc&ewI?(fgDqV#e((TV^l|6c~+V6&V-{4Og}OLmxaDdVW?CMPAL5 z(vm60scQTRS461tnMh+rQ~8_ecgD*Vb7keamHXV4UeTxO2S>XZ`s;jjsYvvK_Km1a z-SZD#Plw)jI7QA|ImeB=nb*xb*p!X?sgu0QHPgd?u3m>RF~X&gq+{R$S5k*T-Fbyw za>zDK#t3TNe-Z*~QkBDV-b3Gy4!+ORXWMAhi_HBJS48yREB4E?0RvOy)zFXO(rSg~ z*x_Ffu8fruq^*c^z7MpxFTHku-AU(o-L_mZzV~8E#yak4!N!C`fUW?0zE#O*sySmd zX_412PT^{5^JC^O_|L+U+Zs9~5wY5-g4#`uy@%2t5(dj0iytpImJt7LoXo5oI$QLPO8xBOz9(qi^KiP0U5pIN&os? zUcJa?<$7D{1X`8pT--ONdW^olj)dj<=F0{Gxf9k#K~+r4QKoC*(3y~PYQ9Hj4@n~M zIlOMUzRVsJez9sw#E4yzCE)ie=K48nR={Mf`{mmM#a|qzAHD8q6#Dq_uo-^;>Jw$c zW)dY(L=kaA6tD_iG~6h>G`P4TOsq~Fu}WPuM8TrmMdJ}zRJv%CoH=6gwX)y#gwo=f zABs)Gu*D$VoqVJZoR~5qOvd9aSj*=4@_*Vkg@krB9np?=S?+p|4dl>b_rr@U&K0anEI~#E)pKr2-5?i>*(+~@# z$6yg`p(H%Z$NcwAQ+RjS5*Zo9OXIonk68|8OAv&Uv*Htg-FQ0rB)V#u`N5*QmicKX zpHW{evnY7@@I5D*UFmSnxn&+$<+tx;eM zI;p{6hIrr#v3&<4uRe8u)~4u_$=0!-Jo)fJxqSE>Uq2~W#)0J{uuKI@GO)~^<7-~V zniqgCMmUrH_Wu6hCmEfXOR4q!DZcX+Aa?j@OpZf%jbi8Q&@f7bAgE!WI3Nt#bMsv`3aTp zP~h9(uT4up8St%37T*lC>aX-68{HBp9GZ&-bfivFjhC~lU(Gtdrf4T`RClyBN=qLq z_|Cl4vh&x&fzqlvE5*9}1zuCdvj{!^mkSkR4Wf($Us42uCi9OMyD#IM=wDLuZFQPOqp9k)|t4$Oyb$#VlS{mnhc=nF!@7%o|Um(}2 zOH>UUhPAvJKiA$SPFo$}HEy)EHW=`>mQ|M$j{lo$sz6tx)?E#+b9nidE^Ui*3IcrB z|Kx1g6|ko(5!6Wlu%r(hlT>}zkNz%o-7*z4CsExs&smiql=!YmuGF|jzjoSwe%)b9 zR=|N2zuX~xdZMAm3{hbQ^@$zWaW(k2Y*!X{X#K3ZEo)#4t+MaTy&?D3ud@9xv*^N{ zuQD)_c&s3=rr`3!io%}QiE1Ns3CDOSIM888f{{;@O(P!JCY$z)(Zto{C938-j)1h5 z&5^0&cEhm#q1N|E_BKtM!2nqS6h(-d&%XVA@>Agk9WP5*4eAy}_7fB283543Rpi|OZ3S)wbc~Zl{23sCP{u0X z2A<`?-cTUn+vKDT1%TM&F+h7#8IT(!LjsS%Ks%qdfeH38pwGAfNK8`(7@fe8Ou>;p zXq*F$U_(?nsDm>aWpPc0=QjrAy?O>fRX~lFug-xe;W41r@EKrX1V+OEK`Gb)?ih`N z*0Ldh8!+_EIroEzZNS?RjNYUSz;(%yP(v^>Fa~N+q(A~@pSOY5vI2myC>jMAfFY<0 zs8}sYk zfukv90QkX!04PPqfYOQrAg?4E1+P6ue_jO+sdbIU24;H18h}P7Fb3d)9rFso_9n1{ z8YsmERGhc|wp6c6S07Oemb>BkvkTCoclX0R@*n0QI~+ z2MWPqVtpc*Vo?^|yx~UY04A8eg&oF0y2ar<621g1AOTiEjb5(HC-|0ww@! zcL(6_dI?-27{OPMTS%Z8=lr_u)7)6qwuv3{p;-N;6kn@(D$^Ek`J@hybkU8 zp9t#H>ag1Kmia?qA2r$mbj7z`Xfg=)o3$Y=Bsr&Lb@ZFQMs9BX^3366_V{ z9~;N>8wsrO={$W;uf!7qGv5U*BfKuo*cXOt{o!`6@}`W+buK9zdowp}hf{{DjB%rQ z8=C~`ciV0)iVw3=s{PI!GcN4X4QUsF>NWk=N}?sbAr+)oMSN?juroftrHDOQ$>Ofx zAi;j1G5#)D1x{3)XrYCV$}Vla#a{Yd$tNh%w12RstkC;7kL?xJK+pGyC;>aA9qpZF z7Jj=}`Iv-lo^cOL)H_*5Rj9ay=L@JbXrzK`>q>Hd7SaDQd^IuhW}NtMWwCv!%Z$8K zWGnW(#E{Th@7r0mMUg)VYc(NWkGzQ*x~@rl^|JGRCai;i!JFtRmNvzb(+%vA+=?@w z3Az$*fGs@UL@&DIJHNUco!jHOztWb%;C<+v54}nPpqf(%-`~2gl!MZ>z@K zmY+ITrd?50mrC!X*^vlgBrm&QYq?M>BrzDe04gdl=x1KxvQ*Md+I523g_p#@)5)n# zQ?=%U>CZJ@xN_+Ww7-^#9h(N|Wv1GjFcO*)PlE549gt}$Z} zZ9yI9@YZb%y8T;Tsws;h>DS>kY-!1(;k)t)Ds9^8*iotV|K#sq%V2X(ExAC8^zbfp zzKvcEqUMW3dE)w6Tk%p0Zq55xD?MhtJbP_u8W!WW_{nAF%i__$U$G9Yk#uu>BspFq zo?9(xr(eTaYyO_0Sb5t=e3pbh(Xtvdoc3}Ki<0rwoN=gV36p8>EVBV2D&q;a?fo4e z;{FxmFOOMF3-(F}<~i=yxcHi?wDIY@D}o zEXN%ysr2etINJ_;s%*B@wxzgvSf93$w0qmFI4=s>lwU1ZVObA+&0H>bKY9|No_ctJ`%M8)xnCP$bG^xY*l_ni zZ#5Lp9D+{B0#m?x3VVY?`iCi$M)^$`o)ZL}nC15zXQ8|uG%hp;DM;XR*~hg#$5{B& zPWM7g80Lt{^&mqFYxsQ6?ui8Uhi6VDxpcM$_FUuzBoDCC`RHq!Sp)WH|5{@lLFh?>7!`;4|Y1 zVll&*lu5&%ghEsy82E~83V7^z->{f7n3Pi-(a5wQYyE8K*vti*WV#Tm0X79}<_e~8 zitrzykk=5F2a4|$V0?JLu$fz!!YRYApQ;5bz@DUpQ-xCrseM#{J;k%cVIE<^q6vQ< z261>|QKgZ_Wwtpg8!(vG9>YjE>30k(7~5Y_mI5*v0|n&|y#hxcHQhp6f&a`=Dw!OQ z$Z$^TYvmKb4he=nmws@5QWog% zCg+xaOl^Plimxv$t#Z9}AC)jG=Zx2ySRR+UnsZWSlP>hOM@Eh{4leo4FedaT@oh=6 zUO6Qf@@RRfRGYGS%ZW_Rt=|x-j0R@<)%u%1^{Zv5x}rvWAw_!lw>#gm6VFv=ye(OQDYoCWo4D!QIN?muw+x=*oiK+rB*}f_>Cucu+B9#=e7w?Qz31h1rAM+ z|NGYZS)$K|@S|QF!N}z76Qi7)YWIM5d=h+~>F$b+^=^K76eH(tG%70Bs(!sm7V$%$ zBXgS%zX)>MeUkNEZtY!~+d;_aZPH%Z_U!6KF4<}3(AHS^BY{o2$z*-zPiqd}9?Kc5 zdehyt(J&Ox`}zur6jK1e*_WJJbriSS9F#(kWN8FgWqvNYCCZt z2cl~RvuL=W@2nFZt$YJH%-RwY=7n+c_&~ajpov5$qxh@2>t6!PlqfK$Y559=}iq0?* zLG<+}7&eCgeK0PeC8qLTC(a)mOH8a?FcphOqVli6i1>Fj^Q`aDTm$kIz^wWxjoIF# z$$>MGCkdvWAkd&Ti?(*HSQ!4_f%<<3_2ERvk?#Pt)^H*h%?6;z5}X4zP{&hC%*V+Q zL{BC`0YspHr=FIWZEx{t-+a9nKxB#8FcU%a5d>d4K)^MIO1Z?R{n89Z!i*sL^8$<% z0jA0UrkbHQi$(#a`rZx9$plmr3+6h@{($yPB-pY-1bOb04*G2nZYjVFx#Wm?@AaEaV&bySE79=zja+WA2Y z#+m&VcXmWqvghs(_#=>TWPqHX(5!*z{r1t75#Z8G4W+HE^?94W?i#4SgWlX7{rU0- z(ogLo5<~8fYP#QC0%!pTdvIrQq_%s?9cSr}SS}Q>k2o5f0SXfSbf8+rZ{ZqEZxD~w z@+fkHM9fAi=xl6rymuV6a0i_k)w~(-ph~jG7t}W|tF3$UMZ&V9Mh#LDrM^m_i@iI zs6ynBfLQOStlxuv3m&o*6MBMDVg z)KpU`LKApktb<0;3H&hDA*uL;rzr`-u)^UYR^qj?F!58S1X&mt4Q~<`5FYYK05l2h`t%1n@ z-UpN#fHU~BcMZxrHzOli($c5&Uqd&(VKG3GDzFDAVJd;|lG-#BoHg)M{%8e_Oq;l4 zNgLuYsHVvQ?)-KtZ)X7UI&G!Kwf5@Zl>oJ)`={1rUxePx5)!zm89W!7uC3lVCC;^f z@ADUXrq?U$-wQo2U$GhF+-yOr+lT%S9L@(1H|rOa%Ar?%#5Nm@TfjcD{QULJmVDISmcS;hgqW(2`}e~%DDs4VCbK=ickTuA zvis3_`Y3#PH0?G3mVNd5>)=)Kp~{?z?nSS5^;0KT>Ee3m8=Gwu5$_h}PaYT(Qist>eI=YBHFOT9AR#zZwaREC#*SBE(`S`ST?1L=)l_W;Ll zs8M%{5>y}F+i|YD!k{nLDnOQTtIh!Ooj*bQy*e^tJK}9_dxSEp}05^IFB*_ zv+&{QK-A1M)CBl|Y`OpnP^Iie2`(0YuLX(#aw@X7w{qVB_X}hmuRE$qIi&tWmX{el zU{`K=D+dGtrSC=n^Jr50dnfA|@Cw}7dBz>N61cV%izPl;CP*22l78K!+!RCJS#Aknjre zp=o&+0o0(kD!R*SP-eI_<(F}UESrC&f3mOkWoBFrjmBY-_>T)YCnkZn;A_$sIPGLg z6NeA?5i2#o0b*sjrWOG=v{F~x{kN72C|P_5C%X^@@7M$;3A}EOX5TJ)ar7@tZrchA zB{maGqI!o_N@o+6p*{>~TKhc+2c(Rl9cna2*J}q#l!|KX2BLI&i{;{lbxys>y`u|B zuS(hF;^hr&X(9}dhkjB}C3*EY|2K;>;Ma}J41i45i&AarOL(EF&ewafqPTytvX6jM zO+#CsE<+Wdo`Fl1`T*zb1ptR4n+m?&)po-g_Mok(rvFUSUNh?Gh#~8+W9`J^#|`ky z@_u%zCxMxnI{@yBJd$f0AUmtIfUBPYa^EXadq)*3Ycx==`2Vi~T(k9QfV-KXj&1 zefBDS^S_jkQ-BO7hxU)U6QJ}0D!+ZS2doA|T2b)GUFgbQ0ZI3sHS0jT&*c61lU|MRMe|IJ*M7v;-1Gc+RM z8Wa@DjYia>`07TODpQzAflwWSN#4DBXVDtWD=B|q{`0?u1V1<J$QwGz*_(711Rd z`xSuX4^+AeQ$1HLF#OFiz`y=~OGkMDbdx%jZ?C~$UO`Fl(lERD+W~*|@$P@$te2iq z1DD8^`wy#}1<>^Y2_HL$c6O&;|C>xLhymorfG=OauH4EgFz1JWpWOIsxvQ;KLgH&V zBaxufRHvYy8~!6t@4QO<2S;yymVLc5bnY24Z64qMR5K8UNvPVg*3Qk`S@v|5duG`C zy--EujN7X-IZngcsR@%pQ^&$y>fu*sZ`(}wR@I#k4mkfw?sc|;c|rX9E=p_v!_K%PZvj|^Qa^{`jR-iMBo z?8UXl8B@L~0+q_X1Rs;Do9T~w6+bW(Rr^CQO?<<6YM+F5(JilL=eWJQIBL)D>k#b> zLe0{4SVoQ6t~fX^U=PN5?OnCZ3z+bEQyranWlI=#1Rm?A^Lo}T+TS(Rj40I7k_LJ= zw=CX;kBPjAsN5r|AT_#W6&R(EvG(z;*$y#UW}uz#m$B$SyEJ~OeJHb@(Uka!Q?;_W zrlY-Y09o+D5HM)ppzv0Wx@I!aq#&_Cu7e$CD~eK(zzA*QOuqqCgm;gKx8 zJIif&ieNt7CXzCPqjov2fS+uJ(t#vxK^ZEOB`b)&2m3`ZLXQl z>h|2|@CY0QJ|M=CF<*OQnvu`791=FRLxx-Ugq8kM`!p^~dOv*()<-G0J4aHGL}GOw z21A4Bps|q2D`Uc7XrvTOESSn3!7vC!2ZKddUikqGW~n~jA65M&d%(zaHOz|&yE(n!z6Xxx6_#v1mP&u3$r#0oD6en|ltz)&=k=OV;Q zL(dmxn#2iT3w}wj6<#FGG#RBvfTb9bQKZZ?i5Jci@{%1gfTfrt&-D;54I^KlX_6q^ zD&!>}WB^;ST|6WuG~}gV3Hus}1CHXDd>IX%4Q9R*(?jC$fsmJymquy_{1+xbU<@u? z^oRA6*6)0N*uSeWjQguM9)ZuPV6R8#Edg`LJaCIUlJN?<({HWY_an9tNWoN60#7JI z_xFIBG*m5C;3wsfSk%!N;}U0p`oE28-K2PfDP>V(YuIAgS%leb-^1ONhiRA9rmjE^ zbRm&J@x4tQ(n1QLv_z$I0}DD{)*FD}Gf%`3R2)#fu=`oO1&}RT@8A8mklf zeMWhEC93n6+%Sfu??KwpQueJ&w3>>FeG_2K9f!SX+<{qP#S`Y z3|QS0I?Xrki&JvMks!&d=3w+agq>~wwX+f8_XKKbB@%^Lw zcPH1}lLhN+qwK;wWJz4W;h6u0-;o^i%;=rI^Oq>9kuN!ZUAM^_DjQ8Z@#}Od>+2OM zTh7q7ss6L36{P0SO3<#3U405g{H8U=#iQj{Zi7i#Io0P9ZhKPZUIX)N5?{;(WL&;X z;PD8}Q`0f9;%>cniIk-MoiC-jBfTQEr(l;=nAiWo?)#sG4}(JUr3T|t?}Ky?XBWo( z4tiQhUzA!OUbicTYn42m0HiO@&Tzt&yuLE(#F0)8()ZEs)r9NA`pTx` z8CU5{4^3Y$5qiU1vlo4jpjZh4Fl)j!@i6gerUWsVHSyXHp`F<vKxQCwu~R|HhK_8JrXPIBp*i)S&ve)#_JZh8h?!; zFtS!6h;3yWa(}8t2@}Mz%0Bs3{0+ydEriPbjZR|g1NY_w#Aprh9{i0F_<^Ebp370> zS~*EAr|omDG_a{nVI-GGU~uZsgtDlDk0EZnV@55}<%i%lJXx_#IF^Jz|7&63(jd`l z;c%-*q1`&wT6`Iq2R?;JS(G3IKUqXA>i4H1lE9}Bw;DzQ3AL3w+l|ww>!rTtyU4u8z;iZqo^-d^NY$!2a8Z}-VIB3h7* zLDn;`ky2?BR(`T}L@q(qJ>P%K&~P36S*wt#?9Ci(P>@?HB)*g_C%So?A?eXiJDyW% zy8AUsX8afs)=m2-+%HpHD8j;{62rLJ0N&{5>DORSy-P`a%8r63wzW}OeT=g>UM=c% zl+;>*m#lZU``DF4s;N2>=2fg!KA&nw^gSm%pR3e}dl7A8W&4Rc;)~L-4H>-?f8zGXF!6m;hOzvu zQy8&ax~ec%hA`m|&4T=&He^J&{3-9AyJRYNg$}aO(3o4boOv)3AL6nHQ zzpk$4Lqt&tWS0J+J=-PSAH z=1*)v*K<*=-{m~v&DIu$W{gV{gNrwdgRNfd2?jiBD_Lo|e(w!8B$9WYYtMP=^}5!p zYo6C+MQw4v+DI5<|ErePncQ`kl-^WL922AMbz_=6!owgpzsbtc_-SpYN?+V#mt=v5 z3lHiUo1C;$nAqw-ikplRMQze2ROJ}k#K##CJvs>0otcf`JXl@i;s^NwxF>> zfJMtxI)5(kLK{B61qDu}Uq`pK$s{5R&nhVaS=S&D8KjCh9HD(x+5RZ?0GPeVGXv%p zJoNx}ZLP{x8YHE6G%x1=YtnBswpw@1oaU1q zf7L_!rm}TG_pzoB*V^kXp4tF?5vSIZ4X)N;1)lK~GK zqy3Ke*1cRdzV8e!2|PbH*CFcXoK+HqSMF|d_ov*%+%LxL*6QenhpH~T`>Mb3WH^t) zg`5shB?D4=&WZlsFMMs5jw4<7wsLjbn$qJIJ~r#k`Iv<5zi=H)8@36oYYHDV_#SX$ zbU7V4I8<%Y^cH?}R&;~nt$ho1c^`U{Z|A<~WytETz0No#a}=MrJaZmb=M25t-*<~j z-524jyMi`qNgQhy?}zylXGA@%-tXdF7EJ6u=$Dmr%(eGI@E^YZY|G&ML+Y?Th;;}+ zRK?v&e~rDl`37_c8ue8NH2c0W}*fCFsk{)adXsvq-P^FU~$OEmF;k5RCidY zzRlIHNvedZL;&q+9&$_-iadhD>1&g*Xj}HF@_nmY|A4oSv+XmNiAU54NDKLYxW2 znzH-aW}Ir1d`~zbQ}|PJ;+K=5BEexKR=ndO=ezf3yRE_um`Bcz5%_^j^u@ z4vqC3!`PV1rx_4b!1v2QXUfIK9uifNLeFMCJcosLB8R!Fer4h!G2(oW-+aiE60Vx^dR2| zSj?N93o~qV7u{A=z6};#Zv@3#WvIChRTAqxc3)9B849HB5x)BHaE9s*_JN~E3`S*# z8eChH&2s+#&oEpH900xlhpw*-sH%z9Mi2#&R=OmmrMtVOr3I1h?n85=8)@n8?rs6; z?rzCL@4J2P{eFIbW}dayGizqffwL#p%x+fQ)VXnu!t>mj^JRFv?lAO=w>iFs{F`TW ze7Ra{e})B50cxUxKtO|vem7#Wk`Uo=f^F z_`QUA*qx=yVpCr^xEc-)B#uu~ihx*^sTB!a05S`_)@y$@{pxEq2bq(8(o7MQlevRI zeiCvCTWdIoI$d6c^tHjsCVte4l_f)0d0rx^;;vKD(r=8jC7-|B^q>9^bZ_|4I9P!6 zHzKaj$95>`+szPzkJ4|hQGVSc9hg;Ene9RN06^=xVGd|Lzkpl>lBYahYu*WQQ&Rq| zz5_%IU7nfyA0Y?uSdQRtsKj$7%z?}MdC`Kz+k?%!tER&ZXKiBYZlmWtKYzino+@t~ z+l2j%c$yQF=dZ2D`g#=`4MM5a&1N<3Y5UvXg9)UpoefE%9 z=)k=4Ysl{J!aXy$HP*5TUw)~riKRRp(MX;YCx{pr&PW{sVT;<%^qiiWW>&E9Fb*hK z7{V*MYfj>4yeZZmaYy&iE;}x$%ZS~MF?|g@IV-L{%ubxHFLtzz$;^?~bCc_=Qb?S7 z_hG8r|9n?>VJHPtWhxrD4C5Doq0V@$u=PxNI!l#}|1nm&no=yYeIUv3!KbQycGmGQ zdiAIo#-q7_O?Z)k^WcsmrTa9V+sK$e6yVSx9e}GH`9VrQCRlN4tI=_#XR@wk|MK$sLQr)9gn9E5FP$V_hz>eTMPcu=d4dea3`A+H60+ zz#kSDO)7I;NkXY%Ryo;-vaQdir!oB@X|B0>?X(JoF4Hlqd*-wPuu>Wdub@Qx?Mj-O zT~+Pf=Iaa@9{j~^cNBhC(*bjsynCmkt%i>EaHaV8bdxhjyIQq;(d2ipiXw18w~)}c zi7RMS6jqH((uak2wZ9(p$?Y5^Gvy<9&LwW!K1Z}*PM;B8Tdxy-X4vI-uQ#|Jx~NIT zqb{VP(FKFbco*+@-biGSOKl*LQ@YdP27ULV)qR&?g{uOs){{0IcKHxQw+5HqonY%5 z8NCB3EWc&^=yaEq|Fl;&y52)m&$?q1)x>IF7pppL;3FL*^4FpHO z#=M!wxF_o-C8UH4eET)voo_UPRrE`YYG2ezI8hQ|>6b{!Ut`sLqfszoyKW9%RhgjV z2AoVG8ja#eLo1c~QW&GLFdY0*W8p-$D3!vUIX-Y(mO+f#F60@&3`O zR?%u0)o(<#MF#0Lu_&v^j1y&4P(*E#DVxZQlVm1QM14f0KOy1wzoLEhVPKwYh|CzD zFc&|N|671~K(x6@IaG6yBaV_V(27l_S!9q43HkMhEwWsqz_fs9r_(W8c`aBDbKnH7 zU1nLQhC`VCix-XOvmA>G3;%@#UV^cE9hbem@zcmXd{hNgiXTI7nWrB+Iy>QbwkPi( z<}yEM4~A$Z&Mg-&0W0unu{H}3>H-wYTavj{G?Y|mXU7>%2~TUkM#=%y{Lvdo*aUDr z0-lVsdv@IOKXWxp@@VUT*^Tg`*MuC=l)-dyNltN_R8nh5zgWw8zqfv9ge(m(Y8^rz zKB_J@$QQ+G9*TwQ*{t17O3EYu3Vt?ngxGg&rtqu(I;B#81SP7WJ+_YyAVxL9VR3zU zvS!>`%Xm*6Jztjh^&Ze&?AR(MpJ#Gb$8@SM@jz`VHb811g6}S;`vE;EUpzg0@1kid zU-jhbUix2TH&Fh(mH~Jp+yEAbe+Su@;ST8@I{a=I&+dU=a1YN)eGA|a7BzuMAK>D- zwJ-qYxXarc&d+Hb;_QZ&wzrgwf#7T1=d%pX6j}H3d?f)2Ee5j=#A!mKmuOZysC03(uS25j5ciJb#nKt|viR8E=xWZpnCRrJJiKo^ zQ9U9c<{Wo*K2En>7A)}}nHgs19sRg=znPTdFsE;0t9e<9={}`eKG>ii z+mg=Gs_aM--$MFx=Ol~qlLxpTc9O^c^~#5Hc8NwdDTnmu`r%PH`+Xm}-E~q50Sl&K z`Ok{e=x>B`4t?#AR3gpIQhJ*onf&{=hI8v7?J*%lGUsT-*D;S#XTWWe=7IIvb5wbB zD>q&5``EYu+dz6s7J_7U@+SN|<)Pe|A%%|-iqsLGZA8uES!gO*`M!d z$+Ck$J)Vsytwkep-rxpxe0B(^AOjVlph9{RRQv!HA3;U&KZX%U&c2aKp#7zca(}M$ z)^1#Ogbd~YSRpZ3p?fy6!bWBY(l&L;mz=*Ay7ZR+E%g7lcZK9C``8)20kq=n z$M@*>f-T@<_I`~Ehzm;ur*pVvg1^)* zOl1Y;dM#J#XNCMKVXais5x?DqL+R8NB8C;?!F!0p7Afde?)hNu5exQTx~a0Rl$)mw zyyJh5cz&z;%ZQ@S<*|{@5p2iYmymlb?Sfgpo#$G6MSGR;uE9v)*I(rKi#eNtVpx2? z=WD<`o=TCMNTnA!WcQK4Q#;LVzC08g-6%y6j1tap`$f@NM?#EPex3LOTb7$(GcbTV zD=>##ksAt%y#FUsDsszX(-7>N`EeWRZcQkE+x=(t_-$qQas8u1SrYhTqgSL;g0qGR z%V_{kG-Ve5n*#ouH%l~5EuWtvOW*(yPJoMhz5061AO2qi@_PW+^75NZB%O3i%~69H zaJg*TEPd|8auOlAHrZKQsm9tpd98li9pb?Z1yH5`U|4*0-`rA~=eaUTc=<|eL_<=#Ki*~bVlTv!K6Z0D0p>Kh z8g5lmPO$hz=fptMyTsd^u|&SSIe#o^F@;&)+4?|bauLQ^eD(-KIav8FRqCADAai8u z!FaarJ^3o9t=WF@+ho4rROu)(?PTICMH$RPAltfZd315sp|qZnM)~QNk?l#qvGjFM zhyzEJj|7k9SubgBl%9c3=G$BG#l2-iZ-R@&ct*yW8%WmblY^z}f$6ivzE!LGF5h&Tw5^~jD3OM5rrrq%WcZ#yF6YR#{t}lF3`=v&@7pE)sp-W|~FBKxi)ijjE5^ zQ7-Q{4+9R^h zjl}pmYmbbbIIx^eW=Uk9FOEGUN&Q1Qb7QG2&ol7rj?9TP@Fw671cL`ooCGcgduGu z>PQDn17)c@Byq(}`ooXRKl*y(D64+D#Z%#6N5%FUZH_X6lA{a*wZ3v`rU*}1K-dKi zbh%Ie(+)ER&s%X4gqRWGZMNMlBhF731aS_8oZDO&JZRz>2r);(+k6;2=!6#}(B%-+ zJ9Kfh-e7(ta$F-Z!Iv@ERUerB2P5XANt4$clPNza`41+LT~I;OkjZWR2h-=Hg+#VL zTMg!rInZ)$t77oHC%mAGbD)Pl4(Ae~kdONh){$K>LeoaPg?98XnvyJ?hC9d{KEZ9nYtIydtVt2c+P2L`Kn>mITSLBS5}3D!qaH;pM`u2 zKU8K#!YRx77Sae$zau+*VN~f1RNy}@rCY#{~&qp5dH6Y^15;G0;@9#z;#-j>&f-{X|2iz#VRvf^n$R^xHC3XH2jkD(^%l%blo)v6&IT}XRJsByrqJC|)o0n2BAaT~i z7}f4-c|!V-gX{N%r#Wqrk_n^K)i(oa@0AZ3KHnN-p7>_|_Fj3Z6RbbZU@vX5nE!J6 zgRN;@g=5-&gnu@6`ZQ8+gi`}ToUyF6qd5pyLL(kR1r{u4JhfX zcD7NqaS>MDLCzl(a+Rl>$8VcxY?D;igr|%YtC-hIK`o=ud(;wAN!@Dr&AuHp?>CUr z-uL}9jUfXp-pycOXm$k)&u^_p^^?MU*k3ila_k2|4-)@8IDnK` zkdn0gpcn8h?%_>~QRV-|ZFoMwW`H4V>}BNtB4(%*+ncW;(OwJpLS0>kH%~&LHP0PR zGbtY?`>rA7G53JQvRHsc>Fq&5!e(<+zfjTH^Cn^8qvbhlxI>8k(d&(X*Ky)Dx_0c* z&MC?}Ciyq`_S%R2O(;DblxioQ)bpwTZ3%o@xXL4I4L&ON{Cf{v9+Ak5X8RM|3 z(iU7gh(Ecw-aNKDwx6Y4K2SwP&^FvMe|x5JlwPmcgEXJmPOU=%0Muu$TOeZ(g7f;@ zE1GyI_|COafY3qgiR(t}+w-0xQA2b-GQTe(>-D>vzl%e`G1vYSxgKX!3x`}*%rgcS zHSWwaxh^tC>4H;&FyeqV-^%EOJX#Kn? z?rwN)T>i?nQbitHzc`=eu5NhUtMhWx8va~^=eerk0j70gbOlHPw%fp`dqAJoUR5P7 zZkX}eb{5cK;MxX|SP8E)>8gPWZLb04n%gGmv(Ptn)9VD(^3W$4CFi>^pumf>BeA(= z0&_earQLmsr{Kq4UYKg%2u)59-F$Db;(MKi#I(CS?#GT9mAId^jkT`!2e1vV9_@3N zy6RSr_Um?8#@E(uXTRBGHmxUTJ(UvbR{>I?0i9Qy){e%u#LxyMos@#m+Pu4ZueX9{ z9&-*w69C~;M+~sA4|pmlKxt_nV6dZ(wV%Mqn$b4UtOK6U?4G$lW5Zpezg`0po!1ud zc58Zt)UTf`bbb|sdP4Ozz(;*8g6_@O$t1wU-haZY!1J$zxHkP7uJCN9uW@*}=&L3Hv}6<%`*^BL(0UX0K+64c)z>vRus}m6G0KgC-GIM0 zq1SY0J0|GSHb{#5!GwD?#&#g$sdK);EF1_w&&&cMwp=2BdkCp5FcFuguH<~n&R0k!Pd#guX2LerH#bJTY4mj|y%J__;Fbl8dhd%e*+ zi>JVMssWfi;xK4desH>IucTlXbyT9*bUz2byaJupH1(eUu|gDwihwIuE!Wa*&0*bc zcH7-WKrwAuTTx$H)O4b9okAHk5r&RVJ6GMoL)QGPchb-jm)I2(zctKWRXnpb-DOSn zTi?xsdD*MrycGXnHC4t{<@|NuI18v{ zA?@e@q(GsRS91NxUW z17dE6l$H8zALq|=m^WSK*}T0qVcz?dj)#BzO>RDpBw0*zr7KM6oA&K9X5?cAHEoK~ zzfnNnYom`$D@m68&ir0#z{f}w%}p?*b4pIlv2BHmbKRp<=#>%5J9&lQF;%%g1S-=LSZtFtYecH3I66|<`K=|NS=7#!?v?QUHI;pyzJ-mq2 z^J2mE7Q7i~(~L)xUSA85F^YN5!`b!Rq1+{MGC|N^Uag5-A#eD7#RUtqHWg`3P2$kN zKE+2uO6`xNIj-4O(Pl+nR%6=qq^UJHBLlk$|13vk|w0s$-sU1#{64G$e$7Z3_VBO`wa{rG}h#TSZ0M*a#~xG_ln8oK|2+}{^UPDYLl zHG?P5_Jz`sk%z(f8Jc~epUAS`LZuPN7rCpU2;_&{)q@D+_uSP;FUjBdLB+wyFevmT zIh`L=o-7+1iiAim>jza^)z_+ZFvdg?pLQ^gK@qx7G&gv zx3JLD7SDtnd%XMcKak*Ow#d|@4wg2R%}wf6!zbLYXsulU`r9k6t2Mn%z?I2I@!Ft9 zu)3qVOYh0b2b=Gpy?!&p&{V-wp`f>dp()?HdvDVR=Bn^e*U*O$)N=gVQSJQmD(}Mv z*Q(lOb!G!;GEiFlUA~4?A$sOpjpTfk)LV@Xl9j&a2&HHba)!mL6YqfDxYcw8nsLO? z0$l-x0+*Jswe*kdI~7f28LP#~V+_m8KABoy=V)v(#+e3dGE>`>1v1mV0fxUV52Fwa z>VWAjZ`DEXKLXuJ>F3L?`a=8^cE=o`+JI8jZz+hcbgtwJeR9m#1 zoz)BFq^eEv2Ra)%2F-cFu^RV-irPbZRMykI`r3qb?~4vMw6N6$_^DK8dUQeXsGD0H za+XqfxUod8F0lN)pg5#hS{;3E0VJli1CqIO-0 zA~etd;+(sqjU}*LIymorp)PQ>y=R6BTB9>_)IZONMP%kUf1c@qe}+xS79JXAq!*Le zs1+R=MuMO{A8du@iQ4sFKSUC$pbU}LsG*{)n#Cy<0|0w?PnY*jd$@=T9iOfgAt za^c~JJPHZ9t+iv-_{evRXi$yU;v)#F#AV}nBZOO!Z;ue>C?Mi#4YqtM#6(-hzXecl z0l(Hee-Z9M;KR=WJ=W*(k3OruQ9#8K@MNKzb-%c5(H$z7(rna4*G`(|Wb;j_{#2G70!?SuqS#{#Oe%5F6#rIVg+tjiNKl?4zb^KID zJ+z!T_Grt;zf2PtMXGF-ab%}H7pti1l+P{#RiF9x?CZuJMuM7c=OyeHwnW?R0F1L# zOqyvW=zGF&Bu=sV}K5=o=|q? z78^V470&wLPv3FgeKlgDaJZNB>u_vvU1;2$7{Zk=(LNz!Scy3LSCNk*2P3o7-2Rew z^cRF5MXtv-SFDT@b@aCZEh-!ypWcij&we&jtZbHb^k1W8r*V_bwVXN5p5fNF zX=LAsQm`L&fAMtX)Y?QW!Ip9n*P?=`15&LBJ(d4BpVmp*QRan$HZtn1&jn5pm zpEoiw5mwBkk`}CSQRtRrV&rq-ZIm=g-GYJ7Gm`{&)6)Xl_tFt1nX{>C#k3qed(>P4 z9@-bn3Cvtejj9*gmqE*3cLYQ6)ccIP46)j1eEAJ2(M5IjR(jiW99U zTtk93J?xpS3Dsvs7-il!{7qt~pNE(!MA{*GmDBbbLJO^fVi!?Sa|kL-GJb}b9)H%w zV*6U!NQj~tgBoXN#ZpQBh$?wixHdm#&AJ~kwT*PWEwkLkZ(4dKan#;P3v)9sHBr!~ zho$l9czj(qYSOd{pKke7ws;f^r)Z)xJ*CjK33bIn7kyc`5xERIqbPQJ8B+oKJuPdMl!A=-#;)*DGk}(N|{u*cZRO_42N?&M&@c z=}(qUU|t;KzASQcUs|!Jr_){veq|ZIhTBtX&4ZU;B^4udfy|nFdlJA$SbA+3P$$?n z!Y}afyKbrmiHOWUWW)wXIM0|1g)${ruWX9_*uf|A7kToE1V!?S7ESVsJVmmXICZl8 zLO7-sWt`?;$Ct!I+cZ?MLrQ~`aRxKe)B_`waeEe&ainuH)KPPwd_Wo3!x1}V$U9_g z5Mf*$rO4WpD9PHCugJO((m~>%XzZZy!?>CdBJlE4(hvhwhWadCni>LbLF-e*$m2N0 z4uw(14h?{LGQrUHDDTjA5SXijIW3qgunuh-f_Va%V?-EV@FyEzeEwnV;4jb0^MyQl zS&2IN_(P0*3lyb^ky z94)WG9y_E6`uYNDwZYu#hw+6`vav(BI4h3=b@H+td2*{ZO)|eEMe?H(SV}3v*dZJ2 zS%M_1d%HaA0$q%J#>Y5$8(OgLco}NV7-?$P?L9KO*r99V*rBC69_cXS3kcXTXXn@< zox3ByUTNxzS!wFML&`XyC`R5#6Kr8&jJ$qvoIJ@dP?n-j=2r$Q1wVTt&}jx!oc!rW zP%llLtg8g}C?PWdNru{Uh%yc)O&P~`IfuX!D}OUBL%nz57)?2}?FxPcDT=J_MUt#{ z*y+X>ZzGIZ`{W?P1PXvS8Y;>Jx$7jMcwh+YE9Zp}{-f=`*=WB#&25L$aqf1m10CFj=dW^%dFouM#N(8tX}+A2TSo%x8mUuV*oKg|Uy%_Jl$3>SY`3$19W zP}6w*tfZ@V`@`6tZ5d$__)<9LUIMsb^(seAU#4GRx(kbwVqgv? z8B~4T9wa|EIcmd5t|i^afH-zEkf317NwSphJpp)`P*fRk6=NQ zcl6Y|TRp`v9;JEh*+%ZM3f>jFbLjs{0Ruh@cN0b>IV#kOo%_mBW?C)Ga#A!k)6_04iW4mK z@0JR8XQ=3BTD5IKHA0!%WpPoQg}#7AUW#UDgoVEISXPSW24}Im^Rz5S#Ta+du6h7b zvHQ#<=rM7}Zl|Z5SyS+sz!3y&AkdDxaQ6pD=F;fjyR0;+7|xMEkH)3ekNMUqx|SXV zexb$YwN&lS;{o_vLf@VTxKD3yneBf^|Lm>(Ilmq6@B>I41zx|>6M9Cu;M#?prks=Z z3%2g=S$b+D%QKTqYKMCb&0b7cm8s7SSoQ6Wq+&JS!HD;F0n38&HceaYb5zlL2vgP^!8p{g@}n^(J5BURb7QsV+pt=Ucxp&!uj2yN_4tqrR&0paWk4#N`k_sN(#~jo+jC z6lQmO(AoZg$+aqNLqVo&lfXl0{8CMTbd$glG=51Hm$qTg26KVX(jxgr`@t1j=ZLd- z)S5{<>%C+&%8B#}57_8^j_fEObAYz_tU>bIGZ*e!B z@biOgjQh<`_wkZ%PY%ahn*~Kxbp~|SCG7I(dY~O?J!6BnKHe#7D{K|N0RZV40#4D}-6ln8}%kru!iuXQr|s2z>3B``SW* zXKS(I_^M&1y?yz;nPk5AZu_~#eQD6mKy~+wR!+gZX~%j=H+8W}kp;(%9c(!?G~-C= z2YZkumiZg?a-{;TG@(p%K9;&KvE&_;RVL?;o9Ya5mFM4y8Nj#h@RGr!L)Q_=;hK<# z{G*xAzWRN!aDR;=-ChxmNVTRp2p>0Db)za*@a_6vazdY|IIt+fkRDkV`GuFbgb5Uz zbr@s@LeYbMy&|vlL$V=*CxVi_CjaAyg;ztWG)nhZ*abg>%; z2P5!nse)iwJn)shWBE4}M18W|2VTdistmk^$}vQdM|Tte2)6S8?z?qcmMaM2Az-PR z%z$y4cTXCyJZ&LhIj_uE*?hp~iF%GQqcCsiIz@cgcBrr%nUdr>rEQ2CPX@W)<5Mf# zvAF%5m00U8nU&Zfl9eb@>j$s)f`OLl%`lulr|&PcNM7q-pVBaL+-O~ePrsf|cFUSei{#Z(k%c+k2ArC!|6|eRP%8;?g&sPj@J~t z)v6cL0!L1pB6m|8j0sAxprK3wb!kgDBa8he)o~O9?T#tf+a-!)j*~wf)vYwg*sRx2 zrz3$+i=t1$8!f|KX|(rQt$D*6TxvYbp1}^rKB1-G`Adlu@aRZWXB2oyFc}~M%}ov$ zx?)f9C1meR+z%xxaLv0XMOVJBDxc_&m+0J4b6^&)WLR8CNF=ArF;_6S8w(YIYe4NW zIWN}MH|$R~NA#`!%#LWJEmy%fcF;nr7)B$Hc87yp=-j6K#_e*DRk~7n-@I?-862M= z;;E*VNp?Yz8;92HB8y`qW+%svtx`mft!BlI`9zug)~caOZ<8lWZ~IJ>{!}i?>lv!Z z>schqs{_6sVEnVRX~AG_4XK8-DLN>-s!E%_9?7jqrO(YFJj~4r+7#u@cueE+CX%Dw z`Y7sq6&!P(V4{E47G43dfAh(qh2YW}WuLWoa=`cN>G1M@dYF6tCc1&>5!QXNALI z3w)#y4wS@yQR*^`gkhW?4p&4yjP#dNXkaEg98QWj9`kG94_5fbR9Xt*3=p)MffT<- zBF$J<_;5~TN#8GQ-(UXCrv2pdotB~#2mAZW`B6Ziob~(5LKBb~H4%^AvgtJ(qUS6K zK7IHzFOYL-3A_+MjW^1_1e<7~p{u}ao~t{?o8GH9$eYb8G{~FpUm^yYdJDeHbM=8q zLtjW`!wI3-sc+}0pCsh_e=EZq0O0^B9uP#;A09?{Df~N}4}2!w*F7qI2nGzm_xNBePfF}6uG=-1w2RXEb7=v5`0Iaq~$AIIW;vtqBLb) zNJ<5s;;LnaW?41LE%Yf;Bl-3HGf`#=y5;jJX^hb+Bmzd4%Lz0bON|q|b<|Q8?T;L( z=7&5Hdtn4Od9xPX4yKkP9%Tw^1L@W)27g+;x6)RF&SV8`3>7n5^J33vNlhP)@l`^W zUt9a&qszf6EKQHNOHz&Xw@ogiNV5=gx0m31n$1K4Ix4kVQ_Z_xpy^20ku%mF?2Y}w zma0=sT61w(ZI(H5`0VU5I-P4nsFJpV>qUO;W?ndz(kgn$<63><=cgpwW)w2-;p!!R zIJIPS}#d!r4x;3IM)OaPUfb()SwG3PI}T-wASK z!s)socDF;pC5-Xm$v=jq^TGPhlA+bDR$=%35@9#P4wANl*qhH!|U1p|I zd+1O6oA^3K|HH(#@JA&lKkiNDP9tQf8$5abEdz2GJ(&>-^mcR5=q-5QgM8K(%0*^` z25m$jzww0%kr`n?xnGjw_(7$}jIh8HALN{VP$e>>c#1IaBD?ocx1G>{J_b!92AihM zuT>-OUxyi}5cTm4ej#$q>oUTJy6wsa^s!^uql#NO8lR(zhdUbEqluRyV4ey0@?+SK z541Df_(377N-St_{;zN6q4qB@yx?Baz;&Sr+aYKQ&X_s8BI-JSsW9eC@4Jpt?u%z? zhuG_efOHDyFXX$9LFN_+8x5E9UB@Ql4x;uZ$r>W*XJkLPBv-h(RaWHs`&QxpC9gSn zZJ%VE;HhHDRWj{Fu99yAwYQ`U`@vKvs1>;7X@pXHYfG~q)Qp32f_Zg_J+{KVmsp%Y zc#hfRKoGSjp5{dExII`(-)S;;90vrG>0l+zAUy{JYz8?pq$P3G-Ws4&wqa1K^v`<_ z2(ZmSZ$t|BR|R0hoY@Z?g%oZ+je&IKY?(}J&XlWzU;kXwDBMp^m`$37fli$M)#D1* zV*`R+KJ&>v;*?`UBAGbBcNOchDOXu;h^CXd=za8!Ao-(yR~Gw$*!df#Jef?U$H%kY zBAep@5rK#W(*I^C1(T|+fAzZ0(LFP!U$Dof93l#nQF0#Z+TLSjW zh2t~xyCc2lGi&NwsYMo#LwSc3nkv(QCv4NmAtA-snnI=2Ht7tC9>u9CwHDBykJ66n zK9l5%B-85h_-oQ>n`cz{H+NcT+DaHxyv-%%_bm1v=_rRzdnWe%$xnwlk?NbjnK=s& zMg)~fJs;K%OY!Na7skglSP-`U?YTNMs+YOM>C9wjr@uiZ3ZkR>Z{M|p-{_;ehHH_; z6u)1es=zZIPxHEve>J;4k`?<`COa*PUHBvpV-S4%2h2c_vpYz@iQ8Oi@0c}0z>V8j z8sq3ULcj}xs(*kV1QY*&APCMu0Pl;Ui}O-LYvGcn~R}dr0+eilP z+g1t`4A5<~9Y_rVsSF_1cLSuNk}g+u{sZVVMmWN{>yg>5{794_^;1lzUN@$Q1iUNn z2NWi(Mz!5nB9ib)!^>pz((5Y8gfEGab?F=f)+zjshA>5>|Fhu9{AZ!Ut#2#*jp`qV zvZV2^*f7`%wMd39O`YFgj36?hXfxRf6|iz4=`-1_<$}2plU-&$n42)!VHbhrQsO93 ztjPRRQFL(DiL{~}4UZJR7hxRhu0KnI`IYYaX;!rwk`I#|{tK`_(qPvm!LGBiuEWDv z=;RPpz>feE;mi|{2TlY-_YZ6A`XCe@sd~LT5%U#peK>n#<@a9jgP}lYvcmVXGaQi) zMA4C?)SYK#-2f?XK#JNwN;e`S1ultv_}9i?-zj@yFi~-9!>zbkyFpS68c1>jN!vZ3 zA2QGnvc2I56bky0q*CpMn2UDHI|;+!ZuZxRhi4r+nsPFQup3OCubAQ+!2P+aOcua$ zzoT+{oAy0BKp6hDLlHoHjeoaB@9^AUa!x$3*EgM- z!oBq{liB)N$Y~0ySHh+Az~UrV;9SzsKRvQIdwVytRJK?1tZ8oDqNLziEhtdmxU$#n zsl{&UW#oCP+6MDpXmGgAkXk%lI=WQ2)!dkYos?8DdUe2xydQwGh`#~Xx;f~ltJP1R z!FNY&a8U>CeV39TO&0p3JAxD;n6gglW2F(dzlC|-(?Oz+@ubi~+M^Wce*AFL?y;m) z-&T9Jy>Pjtq|R4+HeD{T)WH|i#ta$tTvD>FJL9{wce#ZnlS&*_%=e5lxl!FOA438& zl`^oOdVbFTC4C(k_FOa&uz|~a^P_#<=J+P;HMJz53-dWpx%L^8!+o$wQo83sxpDqe zZdGx_@VhwYeVflLEyD~)l6%vb?39aT!uK}#y$%>o?a#RAd513=A|=REXm$0iU;gCV zdim(UuHbFgpk8O)-wyXSBlM);zC_heH9L2qMMC?MhNp7kCSs;4<+J~T5iy-fC~3|8=m=2{Eq~W_ zbUAI+T1?FchFCJ`+4?TUR>6m^4GdELf&MlvdX=7&vdVSf`M}$QOYzvzM?>UiCY2C_ zCLOeJ<)e_%3Id|{C1mUjcJcG-*^`i3G9M-n@Qp!Q)EtU*cT#lfit`k0T}n>1gLNWU zpN@oF=;;=JH#FzFjMD&F*@GvM} zy^MJwVj_$|fRX#^Wz~6laQHGet3QJOwye@c=KPo|5o`Ar9~%C_IdMq%?QNu(q>tCY z2MXc#t>_rCHS5wAwB@mxC zYPTw7*iX1i$Hzs|_-oK9l!lMDs-jpQrnexZ;=?g9v}-YgNC^}a>chuzZJ@rjA)WPM z9$f8BWPR}J1q27dycJ6!+4~t&G1+@pT-79V-fsAqjVXoofgcZ4-TzZnJ)Q+b)Ao!% zVST?nkU|{C<53MJ6`}!!U&_Im&5Da6T2eX0@uqj%4AQ9$Op?pO(OeiWeQcT9=XHd` zn6a?T&m}ZoFt-16f#QHKTLM*^m!Qf6R6z#|`fx`kLFvIu+lz%Q9mimL3{>TSsvui( z#`gUf#V}?Is>#hToJS&J3{asVyc*9IgJZzXOlE6g4N~lAL0}I8Zhg>1k%?nq1!@kP zK!@iZFWgm&?rLw19C_VUmHz>C5M+U1v&iWpKlqOQ@r#C?O zQwJ;!NWzMH$7ixX9sk1>ysaR5r~gsOum3qJ^a>~!$VZCrtbg&?A>q76TgoM**kLQ# zs3G)0-u6?sreoCK2|}0RJdTT^BG1~Z7y?b9GOi*uRSSnP1sjj6+U+KK1DksLg6+Cp zl%~52j#yfSKRUm)DC>w^A{r?*%k}E!ryesdkSE*(N2ec%7>o3*SS2^{Xp{GR)OefSXL`jeS{J z2&cfWpp0AnGp9STvddXLkE8&6?YZA<4h^WGv)+EHr{|MjMpIffPI+AGuR1&X94hAV z4qSHQo0l%7nwIO6XXqO4(ZfOos||aT)nyv<@wg?Et&C}(Rj^tOwwYzVd8}$b{V7p+ zCn{u^fxEUJo-g}`Pmv~wxICsCZA!-Q!6LWP`<5r=ljeLWeq8rWjI?3q?w;8skyZ_L zkheB@P&#v5_bP2n_p>N`HBVbLD@JQ95nd&8$s6XY#J9z>iK*DVNov#9{R z?d~DbsLa1+SD9Zs%B>Uvot}YCO+hE)gSnOOBi_}kQU?iWPz1GUfVmENP}>*kAYzJ` z?sh&$ZTzO+R0S{B$IcW_gG=bc>v3F3vDW|pRc3dJ(D-5 zZb@)*!E^s>kaO#8@sb@!B6*)9H0Yy9X7{3;8_7=VzRl@mAz>1c@jE0u^j|R%(fvNI`@!m zj?(Va>~50T3b)Q2?;d#5has9$uNIdb*#vsr_iamP#E17%FEfyS2jN07Z%qzFyn384 zT6Bi5jM(GW5-aWo!ZwrK3?q;G{J#4j%x793*c@AN{HvPl9_)TSSZ~}rRiAT+>XU7I z7J&YjYZkJq@Fa8!6PPPKZNyOEK9;M11`nKMm zNzTsww){;`5>Z`lwYc1B0TnP+@A^7$SWc>?N&3d&ap3a(5yZub6KMDvc|971o3h4R zGk$+F6}0;s{oxC7O-S-w>r=I}wa`M<>4Mg*tG4Z@j#Nsmxt2ZdRl>i%93>tU0}o{Y z^WKv!#Ko%cLTfBo4|S9jIj5BLX=yFS`;_=-;P8c`;%Ng9p;Sn+ko&II5w%XR`z7T< zb6@GthJ2?w8|;CUhSxMZR)Blr)>LqPni5Pd(()*ATX6+Ev$S%s%*G(MWU0ONIDC;^ zuk>Ym`7ERSWGhB;kILP}2ADgyl1Gaf z&A7fpMzM=7U)@pkWec`W?IXv+SPhDX%$~`3L%NcW?7iV{@uesP8fl?xXszDM{;giC5{UE|;hVP0H{!4*Dg#1zozAHiaFBL`_@=IIzu5{tQ zG#Es~)~fwE!gjP3@*otzg71>+3XJ9-kCT%bk6-_ zTY>CzPLSQ03bG$ZK{nc6kt1G|qp_|ct)q!-JS)wNB(0;Q3in|BxxP^Z`TmcR72C`6lG%^b#vbFgrvojn}&gw>hySc(*$u^yWORah-0c)d7a5- zIq$f!DP{ez%|Y-)CF>Wr&aSeC=NuB=ES7NB6my?1dWeSqEuzCvfT9OrdldTiRIvdB z4dkj%KN>_+-M#|Gg(&}rueS_n>j~ONTciYNaci-(l;TctE2YJyxVyW%OL2F%;t(kA zDei8?ix+o-h1}EM`~L6!a_{|+-Pzse%xoYzXEQtV?Bp4O-uKk;dDeZ zoUzi^*icqjxlBoMx{|{`cyEzvzgI#jH+Sq&?HvHWJI*Qk~uCvv^gJ zg{i2r7g8`#DeQK5{CIa8mnDtX#=`=A`q7|2LORZHN%51&6n(s4A$AWW9m}h;Yco{F zX;W8M>piOZh0n6W(jrc2taWI2iFHMDwSHO^-aSgjZICl2o2y?{M*Z9J*pI!$RZdtd z8%8-))^?+kdHY*>-ZMy!_mmW&E9Zll$bLnkowD_GCY<$Zd3@AjmU@2wn~k#ERxvgo zY3|?nnQcdYvzctFsvNY{tTFaBtquxuL#xhT#vcWZe>O-!jBOUJ;_Bx7tE;NCQ2CZu zpmR&}@LajmuLF+ln0ieOZ8gjLiQMbE4|DwEH;ec-uFLw+ ztfzB$*7Ke=KIERqtWWc}T+(%dTv4k*)$L|fP=*Cb--R~0i#FHg!BfwHemLYDn}2BC zbLsVbYdq7@Bxz&Vu<-J``Nb@sSjzfqFOP&O#2#^0y!@ye)~&n0(;v<;$tP7GQdm>Q zlR1^&Ap;;d}Ne&zFi=$wpeF!yVDw{^FL3#zwZQ78%^;D(an*rMJ0W4! zYRu2grL1X&aVd&({3w#1Y7LEXvs_vP zs0Z)>djVc}+w~RFlL)}C>f#U2K*DGY_6q@Q$Zq5${Qm?LH}XeG!63Tk!(YDx+pui* zuYbK+anT>`(n0H|AbTAIV19xCaN<7!9S{ob7dE~rPUsVz@Ck?=ynflE6RP_or;BsN z#T>}*iTVub5gxM99|h{eM+6#>K*gGy8x%h1k~TQeC9%yXcHzW|--1Pc$4e5S9qLQg zrM%5|>wse90H~jDfFS>_s6Q03oo0dbw2e?uMv`3#b3Skfuu+Kj zd#=dpkBUPAqY)G@B_Q4JWAsH&=mkC4e-jDngKqhNdCiYX3=NfJ9+t zp|&9i6b9*a^%bl$8cQnfU8+Da3lt<449E1&O@I-Z#%YKswU&ii*9d^X$tu!8jTq3= z{;vp80cM5Nx5e`RS_I}+^{U)@u?x83Xn5*eBk}3FAoJa?yJQUi-@#`+TZ$j3Nm*XJ>MT`n@9F#Fj~pRgM4#+|CVO`l8IhtZws&u* zLc10iDXxBem57Sbi=9BHd-YW4om)aI{gWa4mJ(jC>Ah35_1Z9U%ut#?M251Ekc zxDa0M2Q$h@st0p#z6>7$p{h~gca(f|oc1}=D$0ukMFE$$oAl+xgc%S_7D$06gmOI^ zejn@9@L!I`&!>gI2&x1_e8U7oz7(~`P<2L=K?K3zi)VpDK-vl5@%Xpu+iEs?)QfU- zH0(~|FGAS<@gst#Av!V;r(N4gvur&^rtkZb^&Uz8C*I`+VtwmzorTWB)1wzLHjhAg zK+^&Eh*()4p%Isea^iJ|cJ;>9hq-&&4rsbtG1kAk@6&X21SjsjIVjOa-I#?$-n-Gnpx=3MAC@%P z5{-L%D?bS-DP5^?4Ve*p7d*0>=6LTLw%gws2kX|bh&I=Dbm*qd>C$TIXc6m{GBuAr z=vH$cd*xqjYdR*UWk{(kzi!F6uHUqD9fnM}GkolAaExx!#b3GVbCk7-SG0nDuFmFA zDZ6}f@?7Q4!S6LG^X#}Q>-OO&xVlIGCK`mB-|8h+I$5KH-w`j5-&JT5w$khwF!@8# zsAY&3yJ&xEq;?M?EmapCYEu0%G--E4I7QaNC4|T+WrQg-n^05sR>IC^h;Zr3=ZoFp z6Xee^zc`F}rRcUfdZr9(4%{+v2McC}N_wiFu)i(15fL<8mB~M~@atF~kxqW{LK}?V z=SX^fICk+X9-E<&8a5Qv>ZpLMlB{jV?KwZ=o=*4@#kboCCVv{EfqdG0BHfZ6&pS({YKRi>nK+C}_^iDYAr$l;7b#<1IRr!UwDw@aq z-;LoT;)6jII}5mbLv8gLD813|BUZ$3ReMM*x-+BkHfQ56$vPIeL}iY-J9DCCTJ>GjipjgiDeim4TjBpoegD0(Zat zmM7A6NnPyGs_Jp>BqqH6ZHFFIUw2R-$6pb1?o{)fkaC?-;rzUiose>YfL^Fm zvN&6<-W7xK6MxAja9|l>{>*q82r%BTVDU=H%XfSc8O;diNoTBZT1_91OdlUif(lZ7 z9;k6k7Mw1n7hvG8|2ihhqS>ulX`g`=3#SqpmVkO(UdRt*l0Ofa%F3JTT6Glu6~ zGCaTJL|6&1Y6x&-LXfTd&dF%po>!uxI6d#u6=5a8VSIs-xbZCWd6zlQFG~?tQmh(M zoR^`goH-v3LahE=@3SEPnbynj%nh8<@#3i;?I%IB?T(#T!2Jiq2e zSh=ujxNt_Jk&niH#w~HEXHgkBf`0?0GgzG*WQrEJ8ldkER;K_Jqpf9HPjI}1wesI! zyuM%mpJ#wy_)~0@WVm#MeCP4GU)}vgz!UeZ9~L@@^$MX=fY<_}nt&h9EK{(etM=H? z(d$Q_Pf*C-0vT8kdiI&T@TQwlzT@xpJ6Uzj(za3la+QqY{p20dvIyrd5X+e#mh)7# z6?gbU*XjN27B_vZnNQm`RjXtscd-Q5vO0oGRux1Yca=f~_6@F03r+ksA<G!(Z1_qmu2>mbL;f>_-q!jJ$PmV#UO|)Yf=&^=vYS&aECK~Fbug6htPhk z2yf1Rj7MkRiS-uC_l`fm*K?S^gqfkf%J-~BpM%nKuU3`M{g+sCm79-{x>}!X?(Jpk zz*96^>AHjZ=N&E}G?9>^?sEyt5GxU<-Xw~Tk1+>O(yO(PPJ#XRzt`W88W{HqJ_Z~f_*De?#I4LHWXwIDf^5*hiF3(l2 z!-~~C3q3QF=~v!fgzS}`i2bkY>)fC~r07RGw~@#7Jgsa*4^r#87Sy70<_GSwjk>Xl zp(cMNAx}QnUst)(fX8}h?KfUE<*N?FfWSdp*5;yRP%Bf+oVKU*p=HoQxQE~^?t#jQgY1;y_Efe^%;r&P2SJQ za1+U{-&-dC<2jn(IjMgl&50x6pfg>`&O)HS{O5J(S)cTCi+svdSB1NYU-&=Ct;J2Z zP7b0u&IJ6){W!S3rV(&pZ|G6p1C=cp6;2P@ZkqeSR_Iz?F$4txeEie@`|omC5ksub zw+c6vB7BRUv?L_*7E2LE{{m_Wdw}rLQ?FP=NinqyBlH%k0jG5ObN!^JFOnCJD0>Ho zTE)`*?x1huo-BW*P~PjlT!H1NRB>Ht;P!E^Vor8_(JD-@)V3R|E%QX-|38rMYnFoW zTUBe;cQW>|?h4kwhs4ddXXLKT7sV~Kdt|K@hqNplAyrFP>aY5o+*}$K`%ej~KbFky zj=0el*P9wf@}^6T7<@6TK+najViND;@>wTZYPG}b@KNb%I}1D5N_ls?ZKLcX|B7(Q z3|j0um`n(bqM3bIc%{lW9-%fC8R%Ol4bmaE z1$K53M6E1?YF_P}S~Va1@^7*p5-xs;gf21Muobxt?9B>w4AB06q_>DdQ`O4huo&fc zGkayo^KNP{Vq_F-q-BQlAn@5Pi{vCA-~M3IK#$=w=0W+llq#uNZt`C9>MhZ$6u!-{ zZl>QIlyJS^$W zmQ&j5fG6FOPgw?9=}>P}jUNQ#nVY)%JAS9wW#HW$wwyVs)Q6b_3V?M>ghS~pL|<}85idLjxM{M=F~p(TL(rO*~uD( zTeFKS?(_>S&-$*%PS2v3=rD@g6wa>>+TA^wbd`0kjI!IRnw>q39bRA8a(bQ2{49>8 zEVx6)MG^^qj+6f@T9OD$Bp3z9pesJ)1+EVze6~JkN0zMS=-&^84aLh;iP&5KDWGYbg>;it`pt?DunAPmy3soVQ`f1|Tuo zO%Wa>+ypWWbtK#jG7Wbm+yWk)Vv%5aoQ>hoB1Yo?kk(pA%_QnO@4K3i5LO(6mtwTY zxZ@(hoHz!r#LS(HH(rT_ZHc5I;~wzfoQMPqUcy) zb38EdiF!NnzHB?ucWmMl!*-&r3eXEqkoU}jQkZ}DR$NMc)%rH~$^}rk`VLTtdLg-v zJ493T6UjWxd)foz?uQki8y~PuT(O;aqclh(3)r{@>ge6QJo*bsexN%CP)a_ohduj6 z$bu%`TX9(7#T%+z=O$q0gz?_fZYUR$vB1okaR+HSDih>eRRN1NQbPNNA>PxmfchCg zeJY^mD=Y%BT0!L8;K6P`ey#4_$FA}3Q?hXoaNp! z{@~QmY9|1R9O<{Z-W}M7je!;pXoB}&eZ93j!4>lCk!z^`D)iAMHbqEr>!9TNL$alm z?0CzNY-~=7fZNW<7}rTs`@HvCZoSU0>_zCFk-U*VQhH+ct3DW8RxxE>bNLWk+N`SW zuXQSMo_5RD#xApt(byFodC`kmJc-#WX;KQv0TJGZf#xrCrK;n zs|QnX-o_c9+g78Y8B4!~G+a*>qt#F1hseD5E_YjNl|FT3{d}0=@%5zf(^M;q{ji|! zn+lD@g<-+H@e~S@X7v+7Qm2VitLja~vJ1*Km8u(Y#Drc;@=L#_9sS#fPUIfFn|2~U zV0ZD=tszouLhjbOzWT~uMiH{lcVZU0U+jT;2?X$fxBxf*8oGx0un=q*o^MGEwrE6q zFd?1?dj0ppA3!UrJy`AI1)ljUwC?Ek-~pElynd@~>fZfr>R_M_2I^Z&;PrQ#dUkqH zy0k1Y^-qr;cD|&psBCyU3ip#INa=*SMuD2ephQf!o0#1L-Rk`X9!hq5@E5?yfb#_& zJD{HHaGRQOc2HXVOP`^JdSYsgathGmPEceIJpmvuatH9S?vx4h$ zHml2b1>bW$;CP;Zt`w_zKbTB-thAJ@1bu9iMJ0mk-_Ls^#Dw4kLehavi6Iyf6c`A% zQ%8{NS0W%1aJOUQ`M}LRn|y>&=6bK(9mP^ah=xIN!CYs-SzzqYPMM}*(f&u-WSSl$pMM(YFLYeMKY6y22bj{C_6#ACrd3jtl-V_pFRw1&**6uann4 z*0rkO&0s+Yx6xH4w)AC995EGUWN69qSXkP$7~0Ojl$5k!RHk<8+_GySspLYo6B*tY zSp44dL&Z0Xl>B_#LN>4w^^;~lorI39$^r7-FI;VY?W<(0)W0Z5Zm^vu<6gK%x>fS> z{Gss*I}F-Yn7A*Vv|CQ+*Lj+n^~lU@8R@E)(IK}XU*&4IJAkOVUAga5Cw{z3D%@Lv z9bvzGT$y5UP493UXd?IVoT!KK`puHz z53!AJGoKl((kaK6jo`YP#vA~E0Uu_j*rppzVLqV)>;;F7$R^gm|5VYvq|F}`Zkh8MrfEqoW&-K zWos=b>6%g8tjAS?rEMj}WVtPY3GdEHfz=tchV}>vKI9qo_w60UntE@iwXn?P2ptj* z7-@XF(J0*GF@@q-nn}$U4Og#~-_jLXxM7bfxdkfYAPI0F-mO=~0&b~s$RxcP z3ZuqbKiBJfg80ff0(_0PTQbHWFF(c;;=M~C#It_KUI5|268Xmb+8Yd{1R*^O zMDYhBfd`*~M4tr`_=8`72cLrip9Q}62V;N-kwD#l1|^U|n|}rekwHk$1I7Hoc;LZc zY{={UXP@ZXsf>G(P+HEqh^a`x5-&gn&jYRf!DL_wG|=Y8;2;_Z2`MnxAN&qH2m*;B z1t$4}KY$0r-JYWI{K0hKFbq&FQeX`a`!rHuGY|U(Qs6Hh;B?}^L4Pm@81xFHh#dIa zAIuE~VSy5m1ONJi`6;-g&Hy-a;4J`04t&PTj)xKm3IKlwgK$BLD1jsaU~w=A50ros zNE-l_27?k|@F>mzuv|=(Kmb@FCQ2*-tQZp|6985QOAvw#Q3JID!0KQLB2WQppmhLP z8!SN#+T0l&BnBbv4oZ-K-t7(!l7K{C1SSQ5O~He&L4hv>2;`3Iahsy zW35T0d5-TmZXfD_+HTWHeP_@SyLLiMHvfC)n?%4j6BJ8gGIDaq`V?OvxLJ9^ z`k;N2h!=?eyoL@dyicdO0v`>eG=VMW6`N>8<}EZuIn2%(G;K(z0K-NNc%5`R;%SUJlKk ztXI}mOkGx$J&WD_GUk1L-(JdXD&DcvUdr6Zj5biqDx#st81&j-9}P?rNM#hBS)%_G z0mVuy)K;R`)0^CDO&ZqEQKU6j-|1n%PMTt#yxmWC}Wj=wdE-w91?X*s5Qy8rW3GAq4uaz5?WiHKe1S*5Yd z-t;PuT@!lnDEfS&zQ|&f;fQEma~#m1BDgGQto8HGz+o+FB_kmk`-&(rj&w8QIzVV+ zIb0hT!V_ELIf?}=l~=ouxv&%>Bgo32dI8^~Wjxl9Hx>p;IxM1w(TYtNOdHgjqx&jx zVz&kA7lu5{StcDnDVB!GJ5osGzmsdZ{AHNTkIkq%{J3r3apWB0W!rwk6ZN*d-)KN@gB$Ytk60nUTjK0?KW_I zdqLvm*}nlYM=(ij+$F0V&7MKF==f(!!2TYgBSru4wt$S%pvPaP#7kDuw|n_jGUK1$ zL{E|I0Y;hPF72fN&2@l+J-}oRpqXYUfE90+WIRYA{!7=B&A#f;R8R5Z ziVYVTpp+VEMl5TWKdDJNShh<7s}{hY@5g%y@HlPdY$1};dU?Lq;eSYxe@snAFa<2^ zA|xVmGvd-nlyc7hOLYDBUG|H;@I$1rHKvJ=usqrIBLY%LZxFYn*OaHD4w#Gh6`+M} zztIcL3zzwHLA`NidV0q)pO8-V;F|QclyEAv|9zFev%MZ-uEtRSM ztnntZAL-naY|(0yGWptNwY7HOH!=EIJ4#d23mRjF-E>VRqH zLg2UgU12@@4C9X_vi%NbK=2_Mlq=cBm!-pc#|P#z6r~~lv}WqOecGYXI*G#P=={gm zR62dl*dbyMJHWk8q}>3##))G`7RHU;i}q(w2<3@H2qb=E;D0M3;!O({BEg}=3d0_Z z_Zh4RN)o>K#HRVv8Jft!^53EjAh?=Bz~pn-i_H|hwGCI2_*W5HfwsR9V>u)bPzHeH zOVxYe{L}g6i@yjC)sSVq#Xpdx+^Yr_zwWX{P8Qn0DRJ?nGt|D%4XtiJsp>KF3f#66@wC5TI}Qrl|Z zsoY<~rwq)^{i?P;4oq0&x>?S*>mkzKI?SwtmPOLJ%OR^d%KrA^Cm#Es_e!xev;T*{ z$qzzWrCTnf*6w`nFtd}m)fedFP|UF0Gs3I4&w9>%nVf@J%PlxBalNuSxn{jJQNEB7 zd9yo$U0z&&Q%vL}q^R|Ej;kTVUc}nwZf&;sG}KTFrt`sW{pD2KS^esOEUwRm>ynRr zG~u#Y^-s6K?4o-U#@cnLoFe~th9x(Pr^t1z-#7tlQNtUO6ibXZin0yv;^~3Na^-I! z`Nawo<%WNoWM#6M{TN)=H1!W0&-@J4LPI;2zat`6iM4BC?)$H&GQ0=ZoK8p&kdf<- zI}8y;Hz(#zuzf+vV<({nf?b$A8zW3dN$gmR&2UvwX?+H{*O#Tb4z|w!DO$#FO-SFz z&*jgch3j&{!`vqw@!x1A;RgU?&P{&Lc-d#njKxAmz4CAC&Rk!-vIz^D+%vus>_%W$ z(Q*oA!5}=25Ysow9m-_n58)Ov{V%^ojMfc|dg+oMrW#Qa3(H1V!OI1it%KjVc|ru& z+9KaTjoJmf8qzb)RGWRe!{51VCh#Z~%qV3g5t&L2GZG{gddplO$!3vh&m<*0hV%5n z>*-wnV6Zimeivlo6qg-&7#CXIQgQLT!Fq^_bea?AU_a)7MXSx2G1UvF5JJY^2=)m* zpz2*WR@t;|H5C+u*w|G*`PyU%ys=A}^=FZc3Jp?iYiUjj!M&y5p_g?uPj=+dt9t30 zr!w5>s#)aysY3%#spbXF=%8d=?2m*xT5?~k%;9xs`#8ICgI{0zeck|(EE}+-QQ@(cDRB2&1UZ=aDuLbZmv)gr4 zj^|zfwk~iOQBjnhcd3f765;$m8yDjJh9a!5s}5o~rpiywpze6T4IbM^CG}rtB6XFD z)X?LM4u2svQe$2s>2aLuS0@4$qXyap=xc-3QzQBM+ut9!o;$GuyA9nUtiWzVzX&Tk zPUTA!4kz5f-{}kt{gWa!oRp|+#V-P@?glg2xNs_8p*SITt%;#g0J`$nAy==*@vC_y)91;9PS^EucPDW;P9S%EmvKm~ig z0DGc=Jwaekbg(A|*b@`%`4a5;3hapm_QV!qHxLAg&qqF+O0+lbK*tfp5TCDjHdXg* zs_ofS&$FqKXHzrJrk0;gZ9SVhd^UCYZ0h0J6!LihnMGlgkNKV3?As;+{V4kPBCo)*EE zXdY$7$oY1e*xqhK-lgZ?2J&IzX;^x$+Q(Vlbikr{l7t4vqWb$VpS{>AO3{HJ)i6NJ+ zwq4|`R8~&nCWdS{yn<{1DW8^=|D}93bfLV2VCz+kLvY1iv;CV@MYLIjdio%*#a&l# zUlO;uk}Y0uap)YqxkzVrCBKs)ZcFhlj?|GCO6-Nu-MY{_N>?Kc`xjFuUq#yNiwv@ttZ|`SYU0@ z4W$=`((8uW3q$R7>yP)b6Y+Kv@%H<*d`E8hMMobdQpm#5@7I4jF^T9u&)kCkNV_d# z`xl0&gRpDyh5LcO2lwBeo{%66=I;*fp|OwM@~Vf)^mFP{tEzUBU#iwphZ^sn(CY6` zU)J9BGIHM89+_FKAJ!0^K~HV4#rDiQJm3HJ#FkaO=cIhwqFk2(;3P# z^SSwhUaA7U9`XIfpv3T0NW1pnf=UWZX8AeaSx2z@=`Hn|Fi!6Cu!*jCA0n_2w)joD z|E;!n&43UoPHwCd%|n!kw;WiA0VkK(onN?)lpmcL?JL)RVU>@Rg$Qwku#41PA7bp0 z()tDp0RlR)Iqwl|KM>sTO~mL)wu)PGj*E%^7Q7ByU3l;z^iJe&=sfb>Tvg~Bzg(xk zaQDlNk*Z1$mYvL4GF_Xw?>C%?GtuKL%8Cyee#4SKbxUWu92^wP4*P6ccBO4K$BVej zd71aPYlt2X^)V%SMZJ(g44nqZtCcy2;iOV<1%L!rEKLO=__Q>2rq3xN2fRH zLt}TTK`UfS!C@7WwsO^Ej!szogJbEY)ZAt)!UKdaHtE+39xnLR01hDiTVdc+apo7b zRn7S%Eg2>+SA~Pv>%XS#3OHKmzsLUHuwkB)mxz)N@2O>SG@lfGWzKz&KyO_OyYp{d5A%RXJd>e>!p?KNf{xDF!X_}s zFHd+r;XrWcrS7Eo_$p)6u&**Dd7BhTBAa6BJK=AJyJK+!_f-o0eZq_b^S+AVn1>$* zvVFzEVYbWzr++KnH@6O=+qo!w$l_s^*T#GM{)BOwrl^59fj#zM=vxD-N7o0R+8wXA z)E-4beLksieD*mxn(msCm^yDuc8-;cy#(mwCv*!(n{UG&&HLY(>~?lK-dC0l8)=Yl zYZQhu)ajK{wEUkP|?xKp}BNwDUpPKbIw-w>!1!s_p&tKW+ z-8rm?XMo0V!iqs+PACPENK=df<{2WK^56_woH2s1;^EJ+AJt+ihmfYMd25R!k;hWE zh+1#W`$afS$jrw@I4#J`=S4Ve$jsM7I32(lyg0JtVY}n$(H}j)8G?X`0P`m@4bU^( z7i1c=&v5^3|6m29;^YS)|J(lgbL)2lL18Yh_0n5WaC)sYviePFWpd<$Idh??e?$~% zL4hv8JA#ex5~V+ka!q{oc8qrue0WrgnRc1DM}N?zmezlj>`?|zB9uAK(A-5rzUsdPuH@NWV=CfxUkaY z=`$?ScM;qb3CyqFb#7?&JKW?A-=1wzk8$-v{5}wt9RP zO?wLf3FsiiyAlp?tA9!pHt*B_)rp(;V*j*DIr#9{Nw{aGTbY~>d}TEFi}?Cz*9#C? zE%zhNhaBhD@uED>!2z(oBybTdND3K>xa(|Mh7PRZ8 z+s7P%-LuSjEsm?mOk&n8OAsR(*2^OC+bd5|ioMFAR9j1m!%2pC_y8HqXttCc+@HN%zAAGXNbFG9d64%4C zDu;0O0ae5=kA|)rr^fG;M@pm}9SigB=MUw)9j&v*ONQ5q+4r6P0%ac6Upyn1DyXaH zXPm3Mj~i8!#Sg16RF^a&_>W1f8*9^t_x!coxp~AHgfpq2I4+&nM$hvO@#yUlE;%BXBkXgS%e^*nbh-hk=a{xQ-+(o zZ|1@|c@-Rqys<0N%!hLlgUpQm=)!^o#PZNS1HJk6oE}Wz{0xN}2Sf8&;2ZxuG%zg^ zC?l^%Lje`X`IB^3-phFj#O4~>Czc=a7!hxyuUJleo{`6M(bI-2OyXG-24;Xz1>?Wc z(?)PA7QzC?5iuRu2z!jqj(hs3$Mr#g321@mN$Aec(ooxa{|<3|g7nj8i0z9a7H&sm z$VqE|be>E(ww)9#_OzAgg-CiRE7Gt)@LPr5w^0G?*akRB9-zX!QK}RU9TGGXif)m? zKOynY3}}-aKt|8I^=Y?ozJ8{C844f;03>q3=w}jK02W7kiPJBZJ|M$yM$uhLdnsXD z>+kSw7kB*mA#ire`kLTm7$WL+q7*@Lt|#WLsd%Jb|7`v0cA_ar{!eu-A{9C6X??lq z$%yG`1$0PR?C#W25)%GF-ss@!QPor?v;T*MOnQH?g-mL{v4u=>znFzgV*h&!nfQJb z3z^vdZF8CE{$6vL$o?PZGU5Hf<}#uE#^y31{bJ@aLH+N|WddR_c>adne~^i>RW^=U zThXLYbpIvbEJ^60-u2Z<<_tL|ZJ%a)gI9W#YE%1Su=2Gj^=29o|CY%B?de4Q6nZTG zX1S%Nw|OAd)2%gA7sEc$*@V%$|`cqvbIT;9o8 zPUDAQ2Ki1JyI}^Gi*H;{p^QeXF>(uD72A3EzqQUFYa`%{%5Mzlk zQ(Py*+iPxCOQ!31jg<8L6&8iM;@1bJ$Wryk;@{=BPE;sAR)yM|$#4I@Y+1YBZC|%= z8a60mv;B`n6_oA`{Cn1ZqUMLVfVvHomG07#yF)hHBDp5b%@bsg0-&RN5;tF z!30fuIoE>GM)*YELTg5SNzT5eUQo-(f`6rJ+BKtp+LaUld~?Ra*0=ByfD5=INiPTe zC8Gca^G2s{(D_2$YU+>K0cE5T#lb|ORfi${(XKmHekdN>==wKJK2TADGZDGu9p%$|$={Xb^ z*z2ywMTqyBy^oQ5y~x34vnd;kfN$$fAkJXP(YFZIeuSF1S65%|;p6~i@T416j~moTc~QGmJIjDRmf7W<^>qvMv+|RJKMx7iHQkbG z3UD&B$qfOuflDm25~d0r*r~_pqDLQ=RqD0FIHXQhqm9Y?mxW}y)v=IIeUZ5F_XacV zFzRNwf|W!~D)siP5=7xNXMD2VSj~NIcl<0_Rjqm}XMBw%rtW6ZC71dg$Mlk$EUL6| zRP5aSBd#=b{9_fI#@q0<0wT)gPaZcD@`Rs7G=_UWp3C1PhSsUW@xQYCI-fCe9kF~& zs;tyM)pD5LBQ2bfRXB;Q7%vPm>XqQJt-s-?nr0vNN^o%wjHQNHMtu~jFQ$HSSF;k0 zH*El`3^)oOgpArPLC1>s9V7TBUO0Nt zPHz!69L}mOr`@iT)y%_`)vWC1uz7)(-IK=aFy!F4nXtFn+xH1bt&`FY4shD6?HLZ2 z&Pv2jRZ*4Grm%P1WM3E#A2G+IVSWvCh%#n1zie>a-2Ad<|3XT=-Qy)eRv;eH21#%? zFRcSEmS}jSJszN_P+{|3RtO&P25V9?s3gDl3lA1GbGOGoh!_BQ_l{^oBDg!fne5_a zc25~l@xcXnh*Ll36gcs`PW_yat^Gpd&nA1=+>lA!5HoYoEnf=|ra5d9CxMyz>4Qeg z%T1#Vc8RFu5%5PQ?H3#Qx%M*5L23JBSOA3G8B2VJU4rV~!(N>^NWvLwpol%pUY9wD zG0%yI4Y-`Y<>f_r`h9=5N!)8y<{;+=``5vt5#1XtFT3Ho z_TJ1v?lZg~|1;P30h@G3n-z9yg~Gt|JnHfEW*iaqRL#$fkd~y#R^{7YKi%;o_x7$H zLOhyKA=;Af^g=edVYi+h6(%`))GRovNK_C1kT$kmKT`?2<{%ee{C?c8f7W1BothzVp%E2UMw9lChm6CoSXXn^HRbL;(b=sURGI6RDYK6?sHWto(I38^Z(E6_RdJng zP;tTfR$e9Trs8K4xLgljQZd@qhppoCw^)8~bzXQg{Y!bp)S5-%jqh1N!_=}|(fMX-)h@blYo?6X%98UW@rkJsQQHZo z`j+k5p&o>&VXv)2bD*sqLye(|KD1Sna8yZ?(q_jpkwc))M)&ajX{BxYv8t-1rErmC zvA}~^g1l%dW@j1XJ#@04`0)XnNbqOJAwTFe>&Gt)Jv~r)H900<`<>{(WnHYxQteeY z+-o|wD^T-qBeV3CQ*LT%nvxamE~omQ3_R7S0I^Lu`^H-{@?`@(P6 z`SLz#nEc6es{(GIg<`1f=F#{4J>;vj%Y+^KRAS_#z^UKca`vLwiUkN2T2oWQEn^kIW{S8b9}4Eb0MifH4UroMpr4r5WC9o5!vCi z9!iaYahpTA`$wyV<}1sSZNf|)x*+E!KC80B4S({J*`##Hd4pQZ%)5csX^bX@{ZI0m zGnlIMuU-1pIUIA;KI9x5WhY&SvGYQ+KRONL>`YlFx(tUsB$r+K)_XoqfLgWhYE7O} zstXFDyB^P&(VqTB;Yo@R-dh(`H^iX?6JQ$@7{~lmltK1phzgVDQB z7;kW9HhAd$uID;Z{JAVol)1lSx8RE`qJ9FQjiHpd4Ypacp9 z!{?x|#QcHp5RS(gX z^yeB>)JtFDV}iBQ0`Baf7z>idJmWXtnap2DqCZb^zW(!4)ktJPM1c#Z z{uPRg(yI0(Hx7ZEiTJ0jV7>~LJSQ+MIY<*Na48_q4NOY`%0LS|kUYk7#zxse{`4TC zAdGW`-HZ3Em;G6zvA1E+vg=X{;(%5R#JRT@}UD$AK%f0j4) zkCnekJ^bliQ%*E-kfHunT?NzSXE~R=fl5_!q)Nj^dS!WooS{mU)`tp9l>~JatAwHQ zrSSKvbFJF?Dr3pL<(gZVmE|3Yz2zALsH$_j?|+uxTmwSAQDwPJ=dbdmBS2v4_*JgC z#HKpOWl~#Ch)8VDj~sFC_v7UP&3M*vJ3|0wgQTuZN6Ps%-HpELoa0RDgv3 z4E1q!l}jTRSw^eM@;PA2Tp9){V++IOOZFiu4VtRJOz0}h;l?H^RpH&`nnKw|cSb75 zI;so3?1SY?k(H3}oj8>SYoJ{Vv@w~1NwjIGj5q`DeRiyT2}E3B$+22luAvRQi}IRs z;6N>4QWzDMtCf}I(cgeK+zm`YPEr)qVedTW+Xi{`l=Y9+SL;*U60R!rQWyeuKXC;KN25M+wsuB$+l;*6kJgQbN*HAI? z>q`JoaKK{!G@MkLdralX_Nd9=FOc&Alb-<|W3l`S2T^zn$yJ$z;KXv8?cP(TeZ_POwA!7&UKvG5?&WU00}^s0SMCbb*4xJMCe808j~bb&IO|Xv}ln-m6>75 z$m7`9<@h@2bKu(VDJ5U0Ev3Z~wPLG7`RZ}sQ~2D{ca~j~J;scZ4ydJJqtk)daS(4$ ztuPs{%<`@I*U4gAo%*q!&=)oqE9wuWa)`W@i0qwMQZ9`9TM4SWL&RUOhFb+Dg-e z?ycNs>^)WQs;$(PniS>x>_~a_XI9L&X+ij0z85YvDeW9k;gc7ywr#&z_2jo4y_&bY zZ{Ierb;w(pW$0P4K7V^GG(#qSsf(_8X~&=0k)fR0p*ID&c&oO;=4hHCUyHDwDjUS}XyCgTwlXo%LNvw2(kwBvjS- zwy+wY(#`z}cE`~hi65m244rU{?CWeRGm-aR%{+C${&@0{mY&bEw`VkWAGZ?3d45+I zKOx^aJ1(B<-M1|6-HMAW%7{sY)E#Hejbk7qLPCJ^6*bu4xq-F_35m*0aQt%vbLB<+ z{;$b`2KIpPRU8o9|MmP6{Qvbx07BTmo_|8zzaB|KL4&j_kwR8EQG>jH9T>s+co;@S z!>O$5q6YQK&+)%Y(?+Gzt9SdOhu|uONRhCsl0V_KrF#TY*GCB`0_aAET!PBZ<|wTm&604|E``A4n(=OMC!ROUrc9V+>Zq5*0o>s+WSb3 zyxf^XYulHuxN>3f$_wv2N;~rH=o&aUXe_iBcb=SKnfSDD+}}^gH?Q+w z6?GbfjAYkYWIsJsx~+_>5gkze7fMd0cG7E?pH!t6A2Fqs zop>Fy6@kqvTm4M4Hpe3r{xA04x+{+6YZnd{1_=_}2MED~CAcTSEkT1zaCZv~4j};& z2yP*`LvWoN4<6jz-F0C4H23d$p0m#TeuA^s`D3c8cU}A1yL-)=>5{z*|C#tt>a7ppfgAP<2$kzZ|gkkoaj!9%3z+uF^AbCD!a0<+xGkW718_YvR8*|dRlwT zi^J;vI+d>{$V#7sas?H)scId4wuyk|Zkotx(Jj?>YdUDR^# zbuJjGQxm&GlKcDox9$g+bVL7ry{`F{;$hJcdd+O(&f#wPy`li8*IxrOi)R0;PHxY^ zPPLZFZ)+XHdVg!uYsr75t!5kAD_AeIQ>C<#E(@R|`i{)R3hV3Emuh>uw?a%RAg%o~T zYKj#gwGV%GNNm##!?zBr&71sz3=YpN66Wz2d-jKARr)q{q1p2ZKRm||$MV_47`6(; z)=cAo3aDxO(ODdN?qP?VQCOI`2F=UnlWC{2>+EC~RAUSb0>Jk-|GH)_NK4 zqr3jbQ+LJxm6%motl@EB$~)%Qy??wvqXf_=o&LdMuYFF6Ry`Id@=ocCSQg%w~Ieh>I5}>X8Ks+rB^;1I=m($hcBeN`}wQc zy!~xj-$LG!`W3z0w|w^&Wg(6~1Q2QTAmT!Q#t1@)OV0B*Qr~_cuw$PQzmab!hbl@- zCH+9d8O@>AAz%d!5^RLmgNnMKJBS6)s65yRa{#UVbe$^E z@p6jj3a6Iikd)+*mgIPoqZ!c^K`qZA_YeEnmUxaUhYBdcP+)ksZ7$p+jnQd}(HZoX zGEAphu7d!F%$nTvgyG3+4&xGo&M_fU-cjyO)5o1bk2`-o?reYDx%#*h6|<88vr}4@ zg;WGeDheePgOZ9vNhP49l2B5qQKe4lKNmB>!c&&oe}_AM{YmMqa*OWzUj4LE@@eGT z*jI5<;AQMfqDtdf3kFhUD5(mRR8?WN3l+PQK>?*!N3MZ3O%f(Ss!@g+zNe4BSnMQL zA2oEbOdYz{rrChUL8@DZ3H)>wyA~7f`K5SaTzTvwb{*1pVVs(}*Cwh-fWtEt>|F#U z{aA*1rXj^KppUNtW?3=~w1~2#P)#Sod1WgKY=VL|izw#LLzPZd-F$IK7{_wS$=6(0 zj`fn0H-Cjl-6p+e!JGFO_3B(zkt)|&{;($0rM}fEt;#~`TZAUCTIs8EUP#M9>R*KU zr7Lr{jp5Nxp9%=(}0O1ILya<4B2S9iOATJ>}Ge(3?1f&&khGXb} z3GD47)HejEZ=k4exKZCoqP|g+rc5DBx~u#r=l8XT@w9dj08xuaPE6pdi?hQUzIK3T2=;6UY^Dm=NkU{C;XH0y^&hbI{=Q=LpL3; zp>twc2Eb<{_5fA6-Bq$$R<15O4I|`~=b?6YbM6Z)ouX#pWg6ocRdBp&k?y$a zsR$dan#{NkVdU`R%cbDj0<3_{*hxg-0u?>QA=U8FaQ@zVF3H>tSGR1k<)J+c7T@eq z_l8rL*~I-qiBa((OwIR-#ouRWO{V@Ee>Pk3Tp_2Vlj-N$M{QB_q!m#^ZQsX9pJ#)%r$5bJSJjM1$&erMNs#cwFU#Ck_+k=gNpSR zT=qBw)OQkdsOWS{1GSHi1#6aZUN94XGNe2}T}BqqVN^W6%RN9fEoB*b0iDFnHdvnZ zKq)c$NAUnvrzb$BDPZJ)T}kmW-$CGbvJss0rL4wT=< zz#RkL0X(}B{|03!`Bas!(^F?r*OxgcKd(}`<_I6sNbQp zkGR;7X0O}i2kRTp$-Z0dp{DsJ15FRWu5efXsHoPVF89{F9NwQ5Ljd+)jYL8BTODVB!dR~n1p4P5OskTK zjA)r7jlYy!$RQJzBNl<=%ff7H4Znt&B*sky>WjWXUq4facfRobiCg6=?G^7*%?-zW^pe^yK{63s>kwRv?N zuT??_RgCUiFy;75OuxDJhhE694P&zL8;Gk<)`ulEe;Z4TEDvqU3*7bU|Jun56}e}& zPL43T6i@Ow1Txm&>*>lJf0X@Gh~`po^~u$0QAVhF_nGT;ACpV@8qek;m;cX;nfR56 zKc7DAHCYre@@_g03fEO-8*QPN!oUQ60gqQ^|6%FnIhLm4WLy5pxSPr?)cEeZkdLda zx7-TK*{>)$`{4JdT-aC&t2N55Olw9Y1?_3YG~sJ{M- zE_-(}qZ_1M&uF5TlCV9~{k>jPf$Gd&vuCJ>-uqhf8=>a`a#l<8mZK@%*{V(zvX;i ziuCcAcfPdWy@Q6!CjX}0=rcOf%=)#Z{7HT^<>UIoiPk=x$FOb4XVsSEHu|&p6dPMg zp6Pif2i4^gL1rqH=!pIIaVrDPLq)slivK+szfF9mrP9RX2&JpR`((vgOto15uKT3K zZ9+!qzZUnt{-Mcn!5L=Ha>2oWrm5vcUtEqqR)BsgL*34}laEvW>_XG)d0~0Gh`e9a zM(N&4ZceMm7Fd^-v_`vD-ug`T?(TVt-b#9L6_+;|l(Zu4OfKA8zD!IlkZKuu@A-JW zDlTt!7i&(P&|Yk$H5}UABW5oyuLL_uz&d7hIC!h-RycO3?NLel<Inxxq4(ml3^$~> z0`XGIL=yxY*_O16Zy1w!RCcr3{SMZghFO=i>(Z383vVA`j#XeI$kT(JbwZ=!K7`)) zg8FD~c#j!~IXc<)DTFbpDzOnv>A~?jp$4*B#>`qKWGNp)#fmDin=Lp zZ3N^on$u3gm}i8B%TL1o2`Fg~>n&*~9T`TW`i<=yFw_=V((drG3fouOg2dxTsqZ$yYZUUQm77_;g(wn&CQEqQ|G zw3HiO9utXH1!r*u^EP!!KU+yZ$mb0{RL^Z{4zOtnGQmc4LMN!fM5ADxegHnZV9?zZ z@Y%hkEUtJ50`kFU_|z< zc)*aOC}6%0_^H2FkEM&`d;VaFzM0`m+mGUi5#6zdzEtY11e%&m09kU=4tu}mwu}%K<3yq86lVD-?;%$vy(R8@S`}3@HBFFVe=t8?@mIJG^Iizdip$-kGR~T1* zRz{pvulrDwXVu$`Yd$NZb|?8jOr@YB5-ny*0ywZ^3B$E)JxS(6R zc0Dngea#qb){~dhRm+6|p4|+o54?rL;pNA`BgX$EQv>%$t!~|EAbaf?w08A zeG}G!fPhDg06hK%)&;I}HFRZCO+OO_W_nw#TJi@^-k>2?$y%%YgsURc5h%NITSF?` z=@L&l4gS#CH73o;vke?tvFT1q#%@jtcn`4r=o57r(YRdksdcGzKiDWGvm@cyI>>Md z96Z~3^HPuFfF{b#f!6UgXd84(eW*a@fa2* zlUo+OdZtlCgACZoh%U|X)vI|qVNGdTtXKHE(2#;luZ2!;dXKK;qisd@ua*_er8&wL zzwt${6aG}8maM|wYLeQ#;7FyxZoBwH96@87#XZi#w+B(+;f@}?#ZK@R%?*u0%{I)- zNm)zN^a*Y<$0spD#;{ zTWR_H;$Dhc#)>l>YFdBP`daqplhv1Wo_91G_mTE)?cA@*c8O}Q|Gu!fI|;YLGK`uC zv2U^aoIz`|dRkk{6Astv8G4c!E6z3AlUw&aR-5{-`mZ8|-IA!=4ipKwLRQ7|lbSk3 z>+gK$)$MDw=RdW_&x3~TDcm#E_*@oil|>QXgjx55=GN~FZ8m>k)yh`Q6{*YM)+(nP zDRah9!_PhL&PtB+4d1?v-ts=AeHjkSGNm+yGsIonG@hrsQz|Gs3g!sE{LZM;j2Urd zd{TRA*P4+SsnDg#gdan7ChRj>p-&Q(`Evh_E}rPO%$Ih?Tg*@3Rn9SzB)+}0fx=HE z8eX+^sye(?yj!0%CX#5FkY8O4jDCJdvyAfnSm(BG=%Ln!Hj_c{AGd!AJpKr6PFC}J zNnohVB1#20dfeU-c;`S7!4##1l=q+vW40rl15g5tQK*ekq0^5r$x$F$kAfcJ zaHZQGPDCb9l1iDz6oo$h3f88y1X!EK%3m?x1WC!^5OD;dDM{<H~CxqpsoO8Ug$I~L~4%8_dsJqYGWfPIXR{dIplda3jgDv@6G}7fyNfp#+K4;4-rdQ#x~ID6gBSu zU$|0Sp0Dh0A!UPun=3m!?o${eAn;IdeFv_-s;VGxdY6a6f2MnI?cUK32{f15FS1OC z>=EiU#kbiYSYO+nx^ik{hPV-WYiry~XTR8BrK2jHkm#1+sn9{XeeL1u9^SIEAx&z819|Jm__4U8L15`J_U@wqa=Zut4 z*ti1-skVSNwk_bbT^dlQCIqN%Z7Ww0Yyl%rw*XnqAwWbv4RF*H0=5v?9t@%bS0o%= zH*mexJ3v_&)65wOd>y)xSkkT_+X6lrwV9>?XMPx|Aa(kgf16DjP`=S@Q~_GR5j-N} z=(zztem;ZIrJn)b{6heuNCpY(SqEV1{Qo{iuvohWucvW+B<p-q90DNJP>2dz|!Dk}@`0m4tz&apMh=k2mHT-*X5^MneDaj2C6a3?dI|Zrd{D&`=cyU{91kEBdl{`~aa~ATKcZ7Z!DIbode(Lmihyo$91`2_tOlu0g;f zfPud-$8_Z0hr7Iw_1CVYOt#Sl?EXp~<=)&1ALd-cV-0eHWBpFB?q~fAmj1pTp0|g? z1}`PV{s;-MSyz zA7vVL^ZyL2^IQJ;x;BukXf7MIcKTPVwQZ!sdCi~G;^Z)52hy1q2TH99jgJ>1N*%5i zk#_#^)*mNzzIQe4SMpg*%Xq`h=)``txD}tP#qe%a9AtRKb9x4I-NOA5ni@YQ9(}0z zv!&eAr^C;qOs&gs-&hyb$)1Tn)2*X*j;k7W%@Vs=ay{w&&?Lk(vNfit!{F8C{ zk!>knKpL~#WW9fR&&K0dFHHP$oJ(hrn6JvHe7i9w6=oAEz;%|7gxuBC4MPV z{JX2}q0lpnGwbO}$N-j>@96GMNbd7}byufPvba@H_C3#~-jbhJ9-TJgI^F$ZLsL&KiA#;2ymVJoqA@ekpJZ zckDaC^bp}Px@$$uoDP57sy=M7?kT7(-rc(XXol%n?Gw+=HcR<<#KzWAPD2l|yl2_) zt<0k_$A+M&q}re^GxKY?!1-%>tTjxula9ht%{#PXx)nO9*!j%+aN{i}c$vQ^_ZY<< zyb?(@3?Q+P(<$=aBLwIKLK|MwW>EMQ^hE;BY|lSZU% zE+r*NR2W%)1?*kG+>g)h-H~L=TvRtpoI?N`v6;rn7A615M%Q{c*LW!qP@K_&pWwr+ zsak2+Kjf+q?CxT^4by*YmA~ zTg33ch=qqaelZ5V60tRDj<$nv-Pb`a9N&2ei`*TAa*ehwZ2+wBc$6nL1!$NXY-q!o z@3T=2wZUx$uQcd+s+O`V&e0d(`pynu!xEkN?M-~bpu41BLJk96kVr42r zMR>CP_|05QY)rOo)w!*8T?)nuTIwCrM6CAcGmQ@{ar2S9}QCv(=|E zkP!M&Q`WD9kYM!xW6NG3w+8ep2_zV!-71h<-$llxIix*chXIH2ar?JGZVM1UOMbsWBm2^u&1RAw-1OvZ(FJkkHpCD;ko5qy$44A;BmsA0-7T zciz-xS80;cp-DSTj0OK2NbzqG0m$Zw3c3VPrY7lQBVoZ8z$5t6d!t?~qNj1Orix?W zCik9ygDGwSngM{7u_;C+ii-vu``vkFK5PI;^h0}czeTzyk%(8-nS0IVY6NS~Fu0du zMVNkdU63!nSU_#sDE_HhVnox_(^z--c52a`hyyW%(7_?isM=qu>)xd$w-yqEx9%z3 z$R}i`@$U^!2n!8g;#6haZwGAXZxEHamQT23NKB6VtVrObJ(2KVm}Ob}QB|3p*}s3) zQq^1CQ>uI(!SR87Jax?R<-VC8BHhX`zem(i{EMUuS$TUvQ>$-`ukOQ!F5jf zdxb8boC+`y0T!mF3V?+dCv>$69Q`LtX0pGF@h7XeE+;0__f5R(mU(W9e_nAI(G*+F z=v`rMExKc!ww?`gVBo~`BCa^A>M=bMRfo%WMb*XSk-f<_Hx0Ua2X=6kgetm?-YvGK z^ew~UpXm}>{VppKzzC)P-LKqt-2%F1va0zrj+rtS9ZeqAaH_zFYcqA4PC5|-+Gj0B zkwSMYhxOl=Vi;R`qMdRCbhhNm%e%iD;^WBr#Pm|{wDb^WUM~oZBHDVt8wP8{qXP*JzX%F`>p6N!1GSVNBfzA zw|PAc<|L3sqq_=X-krzNGfEW82P|W;2 zhYVI`PGn@!n?;Xf)>`?ZPqf~<^1MQw>g3O69o>$pcYf2lE=8%Z_N$A!vcv00bLAQI zsaYQ*;VD{Ot6ZNES&O~N$Gr)q@=J}a^;fq2DsZWx^qneBvO3RN;vw;T68nYCAMdYh zXo*UOcoUpT_n}6XLatP$pQhv#F$#+|y{CLhhwmk2|F&On52TXQ%R)@W2V2)GUBXt)3H0! z-D_p7-SItLCw)caiUIGhxouS!)nV+7x|D@v)!kJCq-W#5UE+T5Cgjl!_YdCE{+`$N z%$ygMbKwUz{2IDqEYl5}$oe^9i|ck5E00Sr63d0>nyck(n=a+^ugu1(Je+P;)n3g#)iKE@eWqE5?x*|i@Y;aNGJh(j?+T_r zF>|w|xACIi-^qjKEMfkj_dumTK(+c1ztrvW*jIgz;Z^ynm*2t}ib;UY#qv&oc=1t)ECF`;qjtW4V?5~<`j`2# zURZ-Wf%$)dil}iKFWmdxcH4ksYG^Yi1Ru5iOTh6nX!B<^FJc4eil(F&DZwH}NI1%h zxuh2*!Q$hP9+VY#NiSN0Ma&RP)Rj<4F9w1|ITq2Ukn(558CW5ns4H2LUaSNe3O0$y zTJM`edSYjpniIxftTg0!U>z~lD0*=d7~+O7qpb{vv}Xq%+d%*KP!}pn198M`Ut^6V zHN+3u8jECZrh`2G$)Z^Ch(PHPI@O~#h-3vS!N4PQ5d!S6M?p*h#@NtlR7m%upjQFL zc+hDy$m1+c!wLw25-NJ?qc#@F3hXRnQs{K38aFNh2O9d=qc(oY|0Dl50S7ud5lWkk zB=^%&>7e)kJPyFP zHkt#r_O@)-Vc;ZWlMmUI=NAceWZmDjX5W==&(aSwU;Yj8yZ`G9w>MjNyB}l5u@}Xx zjm@}Pe?3ZuM(nrsGkx^M8UKBMK+XHsYUw2d-@xj*`;u1KJ9l3fv-1{=GdqM~RWXJT zkv+mPujsJEq!#Tn+C;E=<8&+D(N9{+k?Bk2V&UDDzeA&So`^l!W=eTk|7KYUHsmYW zy37f<#3wc3TH84PPyNq#I;)O$^4}X)re9Lz0`FTA5A?g-cIIc$KW~kMDT>C_Ms=Q9 z6)T9wTw;QfMe{Z9>K^+f;}0Wu4Nv0O*%ckli+PcrIEI|!^Jj$cCMzj(^MR`!ZDGy3&Kr3|*R0>qX*?x;4 z6Qi0M_F7>rgwJ}7x?di)ZEpCjB@gU9sV_c|Cu*D?yCW}y2?NdKG4r!rEVI41B~gRNe~D> zYS8xpV|uhK4Sv*DK61NW&$} zvHqc;DqP1k%1CrF591nEtmo~xdeP3#_sQF^J(r@@SZWkK((*d!2^QDz@rE~+w#D^n za|qaNNo1J3(oaKetQ|JK7vw`dWR&b_&W9tY!uB}cDXt?## zUuC9OUJ{SzsMKF>-6i8?&l(~uI|&7kF>F3f?aA}0#v&O-j(S{;qBM*c$qC- ztNyHiJ8BgLOizC-OLS5F(w9$CEnp(DNYv#u@t5UH<{o~h_^v6B z^#^!`Hwua`9HXYH?sJP!m9!H~K%`}@y)~EV5bK))X{A099 zgEl(QZ1#^{vui-TF4#bc^28-K1;sY~ATTi56W2=$yt><_){X^xOu+W)$3>o>--A7I zt=P|^QBns%Ej;k8Jl?w}0Gs!S{J0=^RNT3X^?*n_9c*koG&09p-`u*+V<;dx)1kzk z4**$6mqC`B;yi^yRp&z1OT~G5Y3D?i!Ka>)qa4n4EOyBL!z7-r{{N0-?E#pPigHTP zoZvnX!#lEVU*)?kc5p&rvG2M($jy9QR`O&^SXKX1nUvNgHsaSsM(xDO_ghM#ffoKw z*b)$T3=koIB#d{JGEB;5F3%g<5T(qi7lr?MKT+iq4GRrQ#7f=7tHFV$Mp3^*{n%qkMjp2a$yv91wyZqez9}D%? zAB+cOE#uX52j5!R=B<|2J}J%WRdlu<)o|!Z4dEh?$^5Az>?8hA=N|{lKNc^`JA&=Q zWxVF#))Va>g4KyTb4|Vqvdyz8(Rb7Ox5x?y;aYZ8;a2nTox01KX2UJTn_s^GT4}-4 zFtn9FumghGPRpmWe?Ojvy)FuU#KiF5llH&Q!#c9B_oDPag*eos%)f64s%7ko`q_im zHTY0G$?AF1rJSXvF;9;Dwrh}{SO5}{`i8}Um_Pt0f=Y%nWi{{Jm%Mss$$3$z1C&63 zFoFuJa}a$s>}g~wc4t&Bsj9Q9Vy)L?me$*OD~A)M@AX}0wnTMahw=4Yu2rA)L|yA^ z)X5*!c?oY*he>i~w3CDK&*^%iRd(~MLLEb#8T?drUe9M6x?F!m>52NzHFWV!cXMVe zdN`cenXHix8|tGx?e5^ruveZ3kEB^mP+92YO!t0T=eB4X%%FS~HfjIw81A8fBTv@U zW1r`AB_;q%IzWt();n);1D+L?VmEZ4e;E;khjRp-*v74{s8UL%Ujr2B%LmA z6!Ib44_g%2BLl=ZlV8w*ld2OpVCERto(23Op= zk;DJ)XxWB)3Iq9HW0aMZSiuEadgN6X`rqO!Kvfw`d!winZNJ3F1fGncVaIw6?qd2^ z0oe8R^t%)Jy4QDH2%|25zISac&TQ@L4cC8QaOWRSf&A{6CX5q!Ow3Zv zJ)M7`4A3(uh?L}MuJlTb+rBB6Hxckf+9sV=Y+U94P2^;oO)+rMVHJC>arjua%@C=1 z(^e*L;@Qrkqi?!w|kN6mLMS;6>De%%symk?WX5r5-~lcIhzdYixctp15SJn@?>A)=oQH?L$C(*cN0`Y5fMM=j&d>xt!Nzx#%4+}wveQ4hn6*{P2=OGN+l zeJLjqb&S)-NO^kMRMlRlgo_ybV50p5r-=~Y$grxv@kp_P7;W{2iI|)H&f=N*n`HMV z?nzryNRV&fvJq5}976jz=u6!>bh4_VPxrI-+Vg^WFxUP~kB9hyaP`%NBh`x0-Og34 z;D0R+n5_eU0Ckzi`Ck>4ko|81mWlz)Tm32k7La*zcXaR`D5O6jeRlC3fH%Rz{}V5m zOU3zCQMEBABhFRKV!c6hNcjnS@$TerL|?mu{;Ysa8*gP@qN}k!a9JRQv(i#c@c0WCecRoBtj<|T zpc`O@?`nv=BHNNBDfD9W$ImF6Og$yO^>bSG{3Yq)@}jh2)svAJPPaj~>iLWq&iqg_ z5yQDQXjVO+6T<}_>U=@%J0$T|Li?)%j@D~Hz81_6Wp*!c4ie>s(Ncd~^Uf2c_Zm3+;Z%EbZQ5~z&SGsxEGks}c0phozUr_2{9CmH5`JV{wW)3LbwZTN{h%Pxdj|#v_sX!dcAKEqTr5{5Q@fJ*GrrxcCQSTCJZ}JorL`0u>^M zncnf>p|Zb*0bBg_eyz4r-oj#sKH5L+DGpm=-%Qd&+NI^qNwgGLIO4}Avr9(XOy%uK zv=nWMEA%6~LoQ-x**KCWCO^C3DdtV+>hKkow*PtnD6?>+j%%4LgtWKIyWdBNC7Yb& z)FN$EEp#M62%4NdiJ_!T@iDqCXNbVJSvJw2ppPpgA?jKs9EyT!-C?~OvYzTdJn$9&cET4vHbne<*6+|J>B$btla4xZFUasn=mA>nbW zzz8e2o*=7CEkQ4I_`C=3r@2G*F9mKqk6*0X(TVt?{P|sJ08!%RBdpfHyW4v7dCe#!wuirmZ9r8J^!)!MVl?L%gI!+ z1ADFXnmWG?k*2G(^8JH6n2lrRWrjhtp2HPI>)d*3W8eCec}p)G&{vo208)gnEs})w z(`>MdBzkD8xhBU?J~g(Cg=OR+uHMXvz=cN_&Hb2trqMsq7X5r=)nhRG z=6t&+1TX}EN!rn~Ups-PbaSs$4+KIp1nsc75P__BRr>1XVWvh z$Eo~!Dyu!>D=eT;_cUN&fRz}YhQ#vslx(WMI>+|E%%ld8{r4xh2 z-x4~`HDXy=3mHxyGw!p#6kc}Df4<~FJf7`&L1m#jds<;VA7`-NTaL$_D>^=1CQfMV zQ*UIcz8id%(v5h@n;Uv(nxgiaH@B|bUUdpTg}3P5ZrI75S6Q@jPF&u1;^j@%#pM77 z-7KBo9{iG($f#1)&!Q-O56lbwgWU+5Yd8{qU!B z44f-`T4$`u(wsv>oBLu}>wD+XGXPXu?S3QFigIlK9a!N2<)DVJW44cCh5pYp6n@AB zm^|!<8HDR6^=mKG4f1v>mL39HDWR}q>^`0lOEm}jW;6(X*1WVA7D0w|L+CLWAjKo; z^#nw^g2=_!AQB29$=*fNi+*MhUr`3hVi-I~4c~%29FdR^&xf9`E;#>AO>L02&p|?a z-hs5yYF@PL3p-#YkQ~r7JxEBz3KGhJYH}c<_Ipq*PV3o9I!K703p(&HTLn6x1r<#I z*=j=CU0Lf078O}UlU#6Dx=mpJGT0t*98Et*~@zy-Gr9fa_MPl6kjpyUxc-=j7>Np5rk4it3tM{T6lP^|x% z!3tL6h7fR|qQ^aIdoIb1O;Cc0UIp&bko^D5U%kdDG^TZV(Iy`9?_`7Y|K6hk9$_b0 zK}3N2Rw&81P_bcJ;!EMTr5le65+lDxQ?k|o4;Np@%vwTmUcY8my%UO?%a@?R^^fHbgZCWCfSQ!ohbvNVKX77pDvFC5-z&$Dkj%Ayt*A^c2>X z{I6~#U~q6rChi^$_x{LY2L@!1`d*y9t%{TosQJv5IaIQ>EM(8A6grc&`OCaic@)g4 z6T@7b)c0}T`~|{E(YHZ|OZLV;{(z)W+r_J|XFo&r%1wjU&!W8g&d=4{plWHuaHZh4 zZ)#!D*$3GgcXp)-Bj0{I-Q$wNZl$K1!_RBVuZYwKYr=4OC-CU3TJz0*?ksB247jJ@ zRZNv?^yrr>1+@IX{mcKi?qB{hFV<&pq>0QE|4J_}lE9FgX&z^_Od0EOQiJXHiiAX2 z{X}p9OhQC+J5SKt>>l8SPwH6gg^B+oEaL32CHN$?r-DS{N82@3w0jM%H5YQ8nD=8H zK9>WgxNwIf%J4w(7K;#HIYw{%x|`s#mte@*2tElOB!mccB|=h=kpK@XL>+Y{3Cv2e zL-(BehngTOK{R$q73xZbq#!3jG)~AF>dHTof;-+SR_RE#v2}ocE!C0wi_6Zx366GlOm*0Xy z6SSvBgd!p~CPLltq)oluIq&bG&l9xC{t7`NLBHOI1Qp0>k$im10{QY$Q%W}^sQ!WW zElA4^I`{cIX!t9Lvv@Gf=&kvUvbQ+>21Vc-Rd4Z=Yp|wX!SMg*$wyfhNDQd&6B2a& zpf7v6`xF#ElRMpYd+3%swV{?+e*FF!_yiciyQ2ml61qHSL|*r(_!P|ns@T4E7eFN! z=R^grvZ!=(!UyA@x3#-q53ecLR&y4a!^obH$4eq(-Q zd(|?&brI%!+4|1GCsW{s!!%+u3lqVyRA+UhH%B|yXxdTTGJ9HI>IhFEIU5?ow==j2 z;k1~jPtenr5M;AZezQ?(O9zSWb?~*@Yb50~U2MsJpLsFiyKey7M2H{VJ1s3f5vjZA z?TwTJPnB=~eWhJqur_dsb!)te-!GnK#Amhk?Vz7u%;mY2YfpTCZRg}4WWnKCzYAyn zZ;2OYD*dVhB2^MXg83U-*7p3?Gkq)b&CJ1P@NG?gyRFxpr=B&p&-eQ)B5!Wu#j)oO z++V`3Jj+853RfsvEPFQRTQICg5QbD_THlCBT3{9*lSJ5AZY6)IPPegM{DR|^Q+QZi zhi*ISW?+d>>oNm#O}6W_*3K`0KfUS=vh4eV5{-VAhgadQr!g%p{8!hcvdGU@uI*sx zF1@bNIz&Xs_T71mIvtKkJTK?%`JegEVOdzlLk6;}MGP<=d_#!LGyU z2gxv`+?RQro53@#O|1dWfy)6dU7wfQDOU!qJzq;3%xQ04!b@%qbc8nK+`RYlO-ML0 z-}v_Rcd(@_eJ%T#LZbD-=Xv9Aq|>y4!>h)=!+h6bVT7!&e@>>{*ArW@0^t}Tl^Yl$S=MiP%}gpniE|L-X37(x9DC8u4@X4 zfDt+fyc#w+MO(k>_AGv(ch>f2DP7){7`ZiiAH>VSbYH?2vlh`9)lH!WoSZKlufC{Do(EpG~SLm&(U-zTFgYF9R$d1%l`zX%h*P#MF zVGhQvuYqfJWK+_wD1Kw7H!X7bDEc8yh!~q0hOM?mLDU*MxP!1jmeS= z?SE4JL)!YafEGPlWb-e5Z4Cm{)fWU9Boc(XhUhN?AQ7wXuiuUo6hNfmXKB_mZ+C53 z%LmRA@8XD4e77>r(vtZ+Ew(Rc{S7oug}-G^tgZ$dAtuP+Zy#GrQj3NC?NEs^@uEx2 zNlO)C`{KZ$C(&p-?Fl_63JDAP`_3>krkXe;<5bu$rx5B!5>gxVSDSzmN7~YR276SO zmIT^@k<|coBMZ6Ym4``LaYJYxXLUi(lcq4ADQ{k&$R~RHNsd|=(tSHm21QX1qWlMu zjUm~$^AyW~Sc@}UwNd*F6ouI*((vS*6{s6^NJ8*m*XP#45ChDt1L!$TNO$mGZvtI> z=_4sCamWH@);;u`?hUT-d+KF#Ojgn~o_T4Wz$vbr`hWJw-rFs^Z!o(A5MTOQz^0M*jzd$peDC98JDb3D;3`j&agN=+9n0w5)RYo!#0BXQZQO z^IM+i@H&>ElVj2@VcNxCUd&;2S|`4pVm!??-Co_cA9kM*_&|r%&M_)`zeeu4Sa30|B zl*GeyaBVN{q;YK*(wW0*$`D{{W8193+(aSv$l;Ewi0AJySOT@?SwK(hpsw4=wI}M^_B3hiiF!x^2y!y zqmkzX9lETbTCoSHwwng3**uRlDP?IDw_*pe-FLM1kHK5_K&z`NJoqQ)GMId_F=i>7 zhCZw&!`xTO_u&pZjz-Ernwz(#VEm*kuI&@{ryaTi2ZSBEBcRCkLnQg6f(kJx$^#h- z-td&Xdhr(5_SJ*v1mq{=DIpmEJpu8ruEl1bgU*n^=w?~Kni4Ln7aCp@h7Eh03fAqR z@LvZEVKrJ0+=X|v2jn~@?qD~LO z7qdiH?RHP;H`70%ueXW0YfAGCYHk^rd5ipJXFm0JcmiLEjp z)#tBR*U=55bo=3+gTHi|qU;yWn6CjrAKa`SZlCG6AJcpmh}-y`m(EudDw^{d4KiDE zd^(7JikN%zdZkqBEhb1azy4QlEGt zxG(IMcr(FI`LBwH)o+yJ4Mu&8R8v?`=+$X6gy@s3WN zGM20<4@r2}kDEQ1nB8pe8TE3uWoBW{f6cA5W61FGTke!C%~WlrXUc*m-x85=T@Jp0 zv}Cc^iYE%`K7?+&oTPxn7A2(p5}qJ&7T z(juUQbeD7}ApNGLOFC9M1!<6yZcw^c=|;Liy1SR%y}#@Gd7jVj`_J6D=gz$|EHh`$ zobx*8ypFz%R>^RP(y>0XM$?T`pUKYlge(+%Ry?v-Ef-K%RQzD9Dm0<0NPJme=&)C0 z{ti8s`9ooniPmFYbO%EuyXl?f%}g=DRW;SJGeo<~olZb^rE-7Sc-;(?BwoL_TqjIl z9}@auz!ugtWcVFk{+j(mj_+LeZOx7xa@O)iM#<2^_^7DOrQ<=!MTzg_Hpg7LjM(ge z6NSR4{u~d*P`-ho*pj~?PqNoPD=m>W^`8Y=7w<{^3I($P-MicVLHschWDUz$92ONu z#c1{h78Q;g^Z-9d-RbwU4s2t6*n3GggpQO!TvABp|X&6sKjG> z5NvFm@Zzgk3K$?X$lv)kK8iFbo2&1=#N!w7QRG1@TzwuAk6%LQ?-}>Pq9}tT0$*A~ zLkQa&Bp&la=q(GGq%7lp1itiOq7;F2SjL?MI^Kb*+-WBf=f4XHy|Y5<^P}&TI6oc) z4{L=1Mjgx>pN<>U@v_fKoS!H@9WUtatG;k?{)Z4t>=iXwI)0F;zas~f=w5pt2sDOR z-d%B2au$R}_b_bTUHPQsED4Q5(gEG2@Ta7ZUd&DuwKF2cs5k+4~jHS z#b@82Hnl}&CRM<@TK6~ZA$M-Yk6sknc_HLnU8jH3DbuA8l{9y_f4yYUn`|Y_rZd>TnfPWtZXy zd)jrbxhSza{VPM+2r$zm*0Qk{Y{>OT9{4{hILbsTi<~DJBQX`NyTmpa$J>IIGE9Rb z;3S~xW9L@OXoeN z)D!uT(+k+$EpYGzcJG*{-O|k>kcBVZ<42zCD!c0+*kA4*d7W9tG*s%esq&H4@YObe z9v^e-Ukj2RiM^{N0DeuBjNGer4Lm6Lij5kF5u z$EOnmcowogT^F-%AKp@KwXrB^o#x=W5a1C9IZ%1?GTx&LO!c7)u}5~6sN?#(dNd{) z`7LGT@E2~0Xr2{?``GWS^E|Pyjqx4J)A5LXTLmjj?$=X`x8ui;geFPYR8uOJffhmM z3gaiWPO*Z57rf&s`Qw`9fM31ok}q=Ri{w?qd9j!E5ZPf((2CbwcH`ms9}X{M-N|8; z_0V~gX82(^Uc`m`RbeVutMX(Y?)`!?UgnAY^*W|4NvVv7PKm6{x4gXdzn;Eb`k82L z=tSr)@h;o&JD_(}^NkEy^Lc(@JZ5mx@`b@#W}{^b$bSqDsiv5BtL3(uwuFBlsxnQX zD^a8roPW%->86~vdL@&cyI+^ISXnQmQWfSLmx&>&iUMaga{dUtvO6WKPkB8nj`(dc zrACzbT7LIwfimX9!*M3!5|g=gmH3p`jhafy3^F9+OxkDOECfdt;=9k>wBPTMH?s-n zMlO;ay8JCBx(@N*E}FRG7IL_0KRyH>KG?icgDn~Ozk9P^@x|mJNYLow85%~>mUK2h z|HAc3KBKc{=n>P8=5~jYlsc;v@U9iC+=S{W&HLz(HM8xzgC91W1V0>X54NIjnlUgA z*4wXej0C$#`P+Y)8u)Mx>@~QtWX52{A|7nf^4v}P4R`n=*~0bpqepM;eq652^KDh=DqAe*hH#4KA~iOYTg8F;z^K6 zpqd@Df2j4Ph65CTn4L+(392w${!zmP8bKsEDZwHHamC9%hP}&_S0I)=kYEvoOyXsu zU=wuGICn^J#igT$+GM<^fdwuJrmH5)pA} zC{!IsngNSMSzMYFs*WpdwxabwhJs1vF;qQ7KK7n;jj={27Ky94G%a)#PZ|fCBv@Sf z8FUmPEsaf*C@#$e9Sx@nC(Ra@W@VCj4jqkWJp|^ z2dYjeZFZMrQCylIsvfQL0!20&-Dq^pmP6~3d#o)j1|@+?lj4xvmyni%l904i<(k~_ zr8WoLZ3AFuVq5_I-y%LeHa;^}(+^|Rje-|VK0o`HrGnz=hQ>DV{XV6q)uSpG=kfj? zfb$!m6}hp0gD@t)MhpVl?=ir+udQ5Si#_8hpeH?Lj z;rje{Y^vbtroO@EPavH7`VF1CR&mzfB)`_cIkBs!gOUuhM>avmAF7OPobf$zKdnYK z{VbuL&)2TphN2a?f;}C@F2d>mxhzCq<+pCcX|AhWCaJcuMCL!0@$4uEbe=i)=?One zUWjwa_%6KkG__21J!#%!c#u6bRl1@^Tuek8zcfKWCiQKLk8=dTbVT$m#ynE}5-1wvU!uWZq!D8zvk8vDZhf(>PP2&zclLL;ad&G2>*1x^WZg#gl-geYEZGN+%Ih5tq zO{3C|aOJZ%GO|OxRaK22(QQmSY#1KjueCnh9MQbcuSQYT7sKWjR=e2`ZQ|2X^i)uD z9}TXZTuMccQgr#QJE<2ADc>H4n`YKwxqqEI1ZKt$zl~4$tud*FW)LhqRZR94tQc~3 z|LR-a;}f%JC-0sn6_hq;EVbL*5%_k9BpcC0UwXkM$6Ib0fh_qffSlnh7tCYv>kgK1u^&b0IJq>tWdEWOZ zc-)Dt=H}xQ${OM^ACBaSfWZuud5%E7=MUD6A-ByHW>MbH9z4H&(3oju`Yk^P+S(KK z@$Gk&o`YkaOyz((ZBL8bf~nNfMU*0lyUCo5j6B#&=FC z-MYsy12kLee(4dhTN52Qr+06*eBs;0?V_3q=KeF!1X+KxWlY;B_m)3Py%8fE(NBRY z*4=oBVd-z?d&cLS`*vj>jvDU&{M*GBV@E$6njT9auiVhVjc2AjzNpo`6DJP~_6B-+^;t~Jm zM|UbnT>)>VEMiSQZ(KP###$fjkQ7g8*~eP9MlW})2uv!daB7qh|ue>cY7vaH?-$qB@!I$;x0I9Jn&;pbMzYJ+%o-%onYs5 zP*&}Stg+S^PcMy!3-@UbEQmBHB>?&knu9O-ULuSQ z;%`n)fC&E0C2uPM;fR-}2s#dc8bPriNCrtjUO`^nQ^cY4+#*1~EA_e$S0KB&hk(CH zR%I&sb;sw)=VgG(el7tGp9MIlF^CpmD`F2QG`Fx&%}7XmC0eczY9eloN*VXhFP1f! zO`USePS4?~KqAN&jke)t2@?QY-V9z((ycq{0)w#Jg0r^(&4Yl}d(74Om=f#k+}#_a zs~ob5jd8Zyh>#dJyNZ)$m$PB*1a?i#+C0}l!T$ExQ2p6uYQ>dz#pyu=LhI(+GSl*5 zigJHu$y$bY8hU+h-ZZK51|WQG5dY&n-%#eB{pjsI^xXMIL6Tk1_B7*yt+l3m(wrdw z&;+t@)H==je!*)Y+g)7d6Ln%QzAGD7ME^voTcT%uV|-!A`rLllOr1~Q(~M`!|GX)@ zzxqxhog-c)wc7RLoRXmH@YLweS)N-7cIJf2zP)8+? zyf=fT`@X^E;Z*DlO_#ZRTKQm)~W{=M=&47$w2poZVpV{A& zZgWi9^H(u~^Q|Z4)##>}bQ&#tmym_#(OIX%Czgf6_2cPY$>Utsft);+u_JS?#hkXs zAB{Y?lR2NAdl_|}{Aep;8c$cJ>$%B^`RwTCmtR{s(DvAJ(DcV}1t*`oTXSt<^{q*l z6_wG@tf~E5qmgTe^dD;~*Q>gAPTf6E+6*-Rae#n3PwlnS(g_#C@rJq zN%w1{op0wXFl=k2fw1_RC3aX_q@QnHyE|Dj#nQU+^iRpSAGS^A2?!0gj(uJqwRx_} z^F%ty({IAiN`S1gne&w3T>?uQok6*qMZUz&o}n8;Hezfd=;QQGRz3G^Eel$>-wnB? zaJR+}c|}o;M)s^&y`dICK0g>*QSkA3D579r&7wo9nDCYkMR+SY{^BOMz21|+xQZKE z*IoUoZz;vhMVKmOKRVvk%sah|{?;^(FyOls)9f>dw^^KWz;{JxU3lOp-+=GxP`7>t zJzV2Tm@RqGV!(F;=;Z*VOqH?9YAlV*!x-Dtcn`CY^iKM;O$ORoUL%<*JMf9`-zVwu z?q*vs+YI^3VR_*yPpI1n!#tib0Q0#MMEB_!*M2Kj?9=i6DYH`oXxp!YJEz1@QS5eA z@oRht+&FIJ(=ip(4G{#uT9JaGAVHk|$IMVs-1bWGYjOyHy8 ztb4;yG4i6lXx&pOXd9%RPU4zjeuL~V8S5M_S%y`G<^+Attbow|OMpxRsp6{i(X7Bc z!IJ2h^9&wqSqUbCCyZZ1kj-MmTK_pz)#UO2{m0`%t-<~5*PVk_Lq24LgPqBdn%cnY z&^dKsM6LpvjE>14KzLo^kKP{+`2t*W3gT+kk{n_6q6s;Ojl+-M9ZKqKy7!-!JE+D~ zQAa$kBwU>(;b)*t&hNm!`K`8n+`uXw3c*N)QbMIh7Pl7>l62;%Z(|df}c9&Q?6{dMk)q^eU^pE zzT?HExEOn4)D5QuHO)ATqP|VsmFbAJ$|(R+pUI7(u;(4PHu`mfIG;)jRWzKI1`yks zuCk+}sY^p})ITj}m(xq^dRjJmVpe;LmxG1f%?>n|ZS{^VE56Q6?zj3wGbdS^mzDJ0 zRz`G0Kj>O^84vz&4BZ~M%lR&gi0KHNFHtXFMfz#@9hbQx3+kQG9@ALMs`MdjVq34> zXb-D?UJU#;A2v#xc0!Z?=(y5zYB}{*)7(1BYRjcYi_E$2*REBFUD}<~z|Wbc!wJO% zA{~4s)RXE?Z}Q=5B|Mf5;|O=|{3=sKwZbi#!sLu#o3($l{$ypOyB5$E@=(qEE9alq z$J3fdG*`HywU7LnCciwKt5EQO0=Pdj~Ad-zWs_w6_NhFaW~=w8*tdv_1oN~tE@ zc|R_%*?91%Tdn(aPJdWd(q8L$)y70craf+;Vp(l&tZ+s_dt$Jr;GRl;;8y4OLaQR< z)z~c8aGpNj>zUb-NvQT-%5=sr%`H~DujpNyvq_+Fj+NW@U}@*j8rXSa8CvL)_+?u3 z%vJw5r8K@d(>RlKyLRxV3vzJQIxT2XPck*UM|gyZBOy6X=c^jR(_J4qn$0b(oX&9< zwK+mvNa-fmUd@D6}_VWs~(lajsEAh8&A-PCi? z`hqDp`PFFV`@*=`YZDp=hh+-cEFr_HEA(&Gy)BQfc?Z9UQHKrn+b<{<(_ZegRw>bi zZ;S@+@glV`s)~CpeY`?zhJHOHfyMm{qkdJw}jckZA% zW4SL>F|=SZW7&!dck5^pYpJF{lngbxBkC7k-#G;$vm$S(BF3T|GCx>$mzydpHz*QT zj;3!oJ$}&30{07?_iT-#!12rn#)U6FwS1PR?P29O6@+H?ye00v759KaIB{0O)A8vY za8_brEpdgdfRR2-22@!Dc;wn_c{ECdwIweYEv% znIMN;9=D-g{=Rq-7DVPxKa=L2><27rc*AUQlAqM>Z(f!6KT;SNHBJ`1}p&|*Sd?L%S4KK(j?B=UyW1cM_fR*cvpkAgu*?^p$1&> zhXKuzABELI~xO_7O}2{LIG=j?nLH1Q}X;PeB2F$;vzJnk!(yt+iu^Z0~B`Q3i? z6w)Lr%DgIA0(sC}fSNwEgh0|WHLndu`Zx$bP|XBt{XjBSqKFG(elL3%M*1X3AyCcQ zo;p@HP|X%vLMYjonzsZar4EV+RC9(}6G@Ir6bTlt0=)gS;+&F_C+eXXW10@35cl@6 zXBJ*$Q>;Aur$>@~7{or1)r<+<2aH(FKWGGx0HPyEy7zaaU+KuMgZ>?ue~oa-?|}`Z zsDif6R1XUhe-MmAJ7EoJ30ow z0og0(Bg!kuW1xEaUsK-^(BOO_HWi!py7k!{K(bW^m=F@z_uq&Wfa6xB= zl0%L3aIiT^x!`kgagSq+0mL8FNbm3JRk%lrOg9h_1r#PLFvjdwjPWbPI)P?2Yk$4L z#m*=9DNd46inP343P$uETpxzB6OqLjr~EN7k!9^F9w|Z}|5kWk{XZADF7?pJbjIgv zh=030jp+g~(N1qqX#^;(HdX+NuYi?^B|7x`%WJR!*%LtV3O)_)osuY{7Mrg&eIY6l z-b;dZ?tgGLW^CM9;KF=*0+>t34Qc-#O_T?PjC|Yt247{WM)B>Fu4T%D68-98jjp9m z&5dam?OK%{gGtd3`z7kPkF-HdoFgvkxMZ)y{By!jk=w+t)iJEKQxwl@<=|yS#ARx` zALsKXGG1#JPx~}#h?%!&0G&hqlj`9LQh>jLTI4(J-&^GQKa4oF!ARGQUw!7fCqEjt zl+Ko7Rc!A3s<0s!DNG3&ajSJ~-D|4bGRZgZuJ3o9UiwzE+p273U={Un!R_-ypKILw zp=?zHyJfhzRsDgh_N^;-0#PZgYw&`Q#*Rmiuy$dKeT1iT$N-mh5F5{pR@WSFHyQaW ziTe&y3uI2Nbd0MFs}ZQ$z=s#3mKEDQ2q)L2%HHFN~HN*{m)|XPos#u@v(eLY8ZVW*m|6tpQcQ@!* zo?n0Rqi?Or4=vZ<%Us8rOFL5()n-R1%Svk3Ztyrmt($4n=$ zmT8EW+42j49?`Al3BuM-fsm&BeN^l9B#SS5f3fNp%3XgeF_G1^&KA1o=1w#`A1yT- zzrNLWd}p3+=8+vPGO;praj_#<#soqCo(nE$81H=;#TxkHMan^S{j% z$5w;gW%+`=Y5XdjH13Whxf+ZRwvL7S5KEG&;l8p4mLv!NLaf=RFNF3cu^+#Qi;BO2 z;G5wDCA^G@l+XA=O4^GLvBG-F31heyH26*2TD+GKp8+pu-!Y7N2kWUA%NH1w3r8|S zyq5%@A^aw-q2db@Y44*#-DUE4F4)_2P`|RbRHdISUM1d34%xweYDDe)2F!;0IPH}@ zW&HYspgjLCywI_Gl1t)msPWB+a5X})8>J}eU*}rRO8K8VHSwuO*^6TfMQ?@Mw?^fEzqr2Tzz#3j{Xxh!8a?8CpL=ZI^h zGL*7>(IV|-!)GAJ<%+~E#(i23W1tAyckV$hGq+-0Gjy7CTM93Z1<)*Zd{WVxb%_0| zl>r=(fHMl{-v?BO*po%3faib%Z&oWNo|j9h0`O>D2NbI>{j*Xf4SYpgrrfyR8l5uN zj2VA?^@;Y^-EH%mj_rv*F)n*?ZGWOxJ`wodm)+`U4(=^}{uhwIc?MLWv`^sr04jZA zUy%+N;RdD^R_&`EJbt?NpAAtL+z`dIb1?HXsqq6c*cfYI1fsYtfJUe_0;)2XKuNN& zT1Y~R7Tour#M3>0^Gx~+6M~qQ)^XJBN^xDT5WR4ZAu%V)v;%r}VtH>~<;8tI3QkD1 zrgvUUA<}jBFl3W3^IJ(SeqbH5_Y<0J!$I z1TdTAvx&CTvUJ?_)W^XGO|o=pdNQoR<$lX%_UQ50_CKuyLw0`Nx!(_LDm~^7{K~$g zBg`|2IG3~@JCA?PjE-a?cY7ie}0Em`{@t#;4eC8fNQ9aX~bB0Y3b*IUvo ztgc|EH<7fvx$Q7V;pVsdt#M%UYw#;z*7^|HNgTY$RPov!VdtG~*DI7s`)G>%vPN_* zT)Cz4WyMlPrpJIw-E~$*W{}|3+(W-2GZipN!IZaDUE|0lsowHMMB#FEh8=pj#Dex8 zM6u(axJg>?k=Ecqi=E702k=@#%G5RaChHix_v=_^-+7nG3Obi|C8jSYNWb^@4r-$- z;m?!Tha)4GIo>^|pg1~3YI1U57LExzZT6dCqO9oh?Khz*9oxqFa^WNi!*A%5x_GXW ze7K02QXvp-|GSlz}hJp_>od^CVJuA>;Rqmz21ipcX{!6A~#x zka#@fOPCT}&`qEt77^k4J(xaLkkBW``%wE|4AXa3XqB8vp!V49n*7yLhuH1r;thn5 zX{;4dm_8(k%HNR@de|u|$I&$=V~^Wjo3d^Q(=X!*JQw?80ZJ}u_GG-)jPn3^$nSxh z-Db@Jfz@YBc^mwHEnEBm{eJqb7`uf4=56c&Fh0lTsS9mlmIJ+xNmqQ?PYgnMyeJO#;EQj%h9DsCmMM3uhGaT zNfA7UR2K^N4*;ACfRH5`0jbspj;i*61M7!BDr)Md{Mh^^hxNGtL=;-g?CNA%EMuKDLZ^OP;iqs=?;5`Z z4CC&8vP{~$TV3_;HX!Xnq63plJghVxDs8bVkA8TbO^CPMM>DtEhe*9hxYs(7u;_ZR zf~ZlKYjJ#!@YDVzIA$P6Q+p`ndY+y&`Rb~z)Y{aoIGT!R*R&Z?6irpDsoJ_J!CSs( z?dx-~b#ZRdl!>``=G%TkEt318N%Ulm!FTM@^j@livO4qfl;((+ZP-_ll_!gyHVuO2 zYEfUg+p@pfSXFFx0Tr9m>JtGfgy-1Hmb*2&h@J5khoW)Ba_PviaKW(8mAUU!VC4>9 zncw>?5#M~#tziK{U3LtBHcVvR;^X1H2}hFGYb6XiL-Ip)qR4?8LdvaHEswyxt~{H2 zt4$|jIW~B!NdJZqSOtB21!LG=U!D#AYEwW%9jt;g%;v$WU|_=(tb#AhhG?}Zu;J3y z`y*On<_<*YpE&kU-|?7caUjiijHzJzcY{8E0v*Nbu-gsA!9cyuSjIxI{ZNB6TSyR% z|93{{WhX-#wy`$MmLSO2|NASb+r9QF@fj*e+FfIJm@RP-+W)%*)U7v8x(?D#n`#yh z+mDm4yWcJSA90_F-i^9_Ax-Fyj-eoSI@Lj@rLWBF!bbn7km0vJfEx=mDI6ylb`vKV0^^sCKo!M671chxjnZR6yHoI6SJ(U2+6Ir0&zR;mto^XM zx~$ytlX6=Ablv;n@Yqj#O*Rf1*=1c|Df~jgJ2H{h*j&)=T)w)=ezUQh-xsR+2_9s9 zN1Y5-5-6{UoufN5RAepwjyUW&wz{$pWl@RvJBqO9rW&>WMS{>tyc~Rqcl2Q;IO-X& z5>n~ffFfP!q<0muL7Qe&hG5yE%9l+F){K~y}8*upi`L|om$T=hX z;=#j=H)6I$KGU=)#UFtkwlsVJBJ1kdiuED34$(}y9Ge3rNj}DRf5@!=d7ZB(9dPXo z#ruh;isw|qw`X)e@+^#Apw^p#PE}bnQ_ymsLB~sNyHK|%%ewK|h04GBMDSoJ<`zKj z5Mb)u_%EuF2ZW#IPFg44ifMgBaW3ZV6vRzy(@z~1l+{2oWxrS$rvS8LTS@ff|&!xF@RN8RYYVwI^ z>I7aw$~ODcDmEyOfT{Iy@$#LPI^F8_quR|KZL8^q*006WPs@Y%1P*jv2y@N5o4Z|W z5xlyt=i|ECyH+^UD18FVzF_W9HeYRBr6%v3owvRX@KLe6qvS@n_dv5I+FfZ(P#LAb zt$J9ggS4HJjOTt}(_C2lJ*-XE<0p-7=j2n_&Jooov52YHIc`h#(nrYA?H0GHQS-O# z?3SCXo_UMwUgd zF}<3y$e7rgG}RRv3?WcDnq%-lx-uuKNib3 zWDzFosi!q4*?}l*Mjf_mw5(|fNxt&D&~S?3%=@$xjh0tueGt>Bh#zx=XMs_(d|g&9 zOw?qi+=*b|-B__i(v2Olf4+`%W~W~5z7dPiw7E5&!pW4W=AL*M{Uhw9uxZFmaKZ2N z>4nj;{S%V~eS4?4*|p@CzD%iN5Q;l1|Ig-*)y^y4fCr(#T493e2h0E6+EdnF!}LSt z5AU`Ir>x7u^zR1=`8%>g|8DH!4HOWHyDJtjeZrt-e@6kRJzo1o%DNv+9~wjz;3xw< zgtRkCG%)h<_3=tHFo)iAR)^a650N-)LJ#rV%_SPxA=Bn@w*ijEQ2Ph%i4qOmkmP$S zQ!st1An!m&C#XG9`=msJ5F{CILNQR^^$iUViK@9$17@=c0l9}RfNFk}%Pc>od_(5j=U)Z5z zxRPz+Zyw7z#l3=RbTbIteQE_WBMhqX|H21-h$p!z{)Pt9xR%K%ztl&&2~_N7$0#}! zB~#4_ybun7FPBRJA2PjyV^r)j-&C468(jkC09fP`>8qmw6iOZh62oV^;q>%QK>bEd zpOw>1e0BBdYRD#PoSxJfrTrH{-Uy77RRAZ^3oWPT0Ko=aik=;`)k?8DqpspM;N@F> z`sM5XRo~WKeb?beUh{7ACkLa2L8j~qVsC=r?%U?_0lHqwAVGG-ogEm)JZ*e zvMKqNX?=H8WbnltY0BP}*Z1!d8Oy}~{#&B643-u*tl zb%l=W@jIF7p4IqrBS#06@jOjx10Rl@f@bl1E-Q8@r)?A1Ylnz4Cpr=ddZr0^Vt|HV zc686t&?Cc>dUM;Wugn}bW3P8+w+2(I!6XK4dxkDkz07vA+`_b$g9ml2^oN)0HC`<* z>s>OLEBjIHsP4W@6elwoIrZmLCEsfJN)0iUcY)Ykv19jM>}G2H1Z(=m8~QUs9U8l8 z2SJNWZt+^QdHXuuOl08$G0n(Gy7Un5*_}pbr;~B}{n4}U(f7AjZ>;#V@_qW&daM#W z7AEbZzsWI(D8#Wavdv!KBz9ST5eCEE#A~+%9UaSRuZy*elKF%k*}%kB_ow89Q}1AK z+6%?6$so(CO1w7|5V|!^CNa~vza}mfjrb9#xUZ<__=$Dz^gJeDje++D#$4P-EFiDk z)+=v)DhD=Ebq1TnflboV)0qIAm0a*5W*%4R?5t})*mbngt#4^RhegmFIfpt;Xb36k?#4#2M>(A1%RViuSrZ;7g0^ zdFSfjt*VLwoMoR*upexxp`s9<=?o4e5gbVAGgkI}I;5An{0?CJxoe4&WbxUy4nqk$ z4ZUD+NCXeBVc&50J^<=(2Z8=m;tQZh=yWUr45CIb1iaQ8(E+AyllI^SRT#k2KCCz= zz3C}a(YouOMMO(o#oRfb-DI?VE$`e(TK$O)9rUT&Vuc)2$>@}t(8Ykmp&Jhc4c)etSpuB?2BqPoS-f!fUGN;#*# zwWA;1)$f;xV#~UHtD{c4*@~6P(kYlr?CI!zQ#{SsvE;*9Kch{iYA(R}@t33hLTJvJ z>6n1?a`15cEyu@-1^4W;jW&V|?kj`smc}E=tzlmZLHJ>_8ja&}@UH(Y$2$tJ3Gz=H z!Q}lbog%}A5lPpMJmd;^PjY2Yl-Y13>DuK>QNjtnl95=41@w6}R~>~U|LX_ww`j(m zhwH3kOwU{jjF6XEvrqg~ZaKN$MFa25Zja72nh>9mUZK7fO?`<3LYm>12}+G;6hK~s zM+%`p7LU-}V@{7m@uiMr>6VW&DOEnibEelE!y?R)`m}9lX2Ycqmf5tk|IgUyh&tLx zS?{IIG9bC3tDbZoMsiN6r2>ums|a`>Jrv9H=Lw#o2|Ryw^_B2~)USFjyyacS$X^Dw zKgDiBNscY$h+36dZvx)>V>sKSW!?X)h)x0oF_ub$ER{#s0~he2Y*4#SWs!6OaD@Xy ziXG=t7n$r)+hf1OW_;g8HgPCLdY#ahJ7f^aE>G6h`c=|QAh*t6-Yc6aA+$w>7$dA| zEyR#1uRO+ty8jScdc?=Ijm2Rca$>3LbQJxHvSP>f73s}oOYgvzgt7bWbw$# z0%lQOd+c@}bFV(Xx-GTR&8Oq#xr?!;5Olg4A~1}y6;^*QSY^C1`nf8d?(0*2IiIjI zv$4hiej}y~?yxh9vBp4tIMns$(Bl$3sOv93*^6I!f>`RDN+ncnMDiw*Ji8ESkyphP z;u93{yAPyW{fmU47kD{D5)<@cO*raVu-%#(&x_>=wh@*t9}P-Ivs=|V04$P#gG(d7 zBvT(hLs?Hy9y=AwHYNd8^)wvw@MOi?N{znUrcxgEwL%uQ_G30{vUePMJkG?f+9i_{a>?bb#s%NYN6xp7i zIM?*i(eb3-+XoIkH*H7H_@0YNQ=ic2m9a24 z;c>ED+EkFnD4eiH3bOdMo@OK#OlhF>h+VW?I5bM^77q!^{E{E?+Zcv^O*?d*RPgSc z6>zHwX{8@Q7VGO%|GL6TZ%oWHg2CJOLKq*&ueMS>T8&GXxqrU-OeNd@nOoAj0plJV zxvAxJSMrS*v=C>tMm+sV*!W$ih!%Z%l}EUR5dq^e*>7ckS-G%5}fX@B0 z{Xx_q3bgmEB)LohM9FJ^O&z64!u~o{1-(5m;-6tx9 zoF9=4u-&SM^_K;GNKFm+bxrx`I}VEo-f6Y2etK#6q3<)9d}(~ua8O~T`tYQBz41k8 z(93j7e!c*H9wr*v9#=u>rREr-c==F#Oh+h{I6~OrLn8Vwd;yib0e^dX9+n3kNO zNpb=#ptGJm^8gAJNBLuK#s0x1!WD%WkgHY7y|IT4!K#>`O$@^F`wq(#mWaH#iKtNd&j?eX>@vCIX zNl5m@!_u16j_*%Ob*vojvyJnG91N-{|&@AmWV7mA2)#LxIm!UWyKHb^d5!dxjHV3{v?zRV#QCO;OZFL4tPHH%l(W z4C+-DhQ@gwbYg+QETDM!tN(bCLh+&`@ji=%+!ZU=Q7^87=Rbe%rbUgus|O4VpokY6 zUi{a-b-nCfVwywG%}!qmdLY`~EFU|9=||Z&Jk_}VW6%UWY{d59@SaXo`aZbFazz8d zV`4(Q812l+w+jE!d+h>bm4Lw8({X1SvL6_u4<6S7w_>^*NJMg8g7K8!&(=%7@chz? z1!(Y(ddf#C6;o0aWiQ~0Wp^exN$3o>9ZsK!Yq`{K4{KGEGW>5DJBI<3#cyfG2Sxx+ zYG8y0AV}N;^i@viZs|{ufV-xE)?$pPXOg=)wM*Vd2U+R;rxbjY!1}Tj6|B^TtJSJ@A;hOGUvukvvzB%*oC&#@9B?Z`ouN$Bpjs*a}hw zBO}fSW;`+?bXM`I3*jF3oea#$K%8`?u?bNo{_;x%!{Y0*uz;%&@x(;t~QF6SCOT-+x<` z%YVW9oQZ?Cg;08EHMz)uY4T;5?mhK!m^GF3=fEOYC@*o&rG!4#YyBpCSOrd4Db{Ml z%bk)>4P3AaqA)g`)#v^V8n6oTFt&TECH@W0unJlbS-bi?pdoJG@guKPl^_IH+0rqR-jX2&d>zY(P zx(Q^TSe&*bj97cE&4^Hdw2;asS9q%2LG(bC(udx3H z{#Ui6h(@elh>feOUjf0g>D~Yc=>ncN0ouAMhjV)xDnpZdj+}nHdYn3U2B-~^RxrCJ zD-~BAZEqjyNBr!SPe1b)O-XSIT# zUIN@f5h9*%=P4$%=c3GyOJn&-7}c45S_st{d6R(kO#*Z8eUB=M60FHwiKN9j6Vmg_}n5w{>5ngbsBt;{04A2?LHqFmLH%IY86Hyl#q1RKTeSV2=Ur$+tPGg||wR72D4_x24B3@f-N!~;ejFoj*#AS}Q#asjxA zONe}&XH^iEcH{}vt0vjV>~bs5P3&NN)E0O6zU~@SvlL;DoeGd$Ez3twU! zgFQz)GG*UyPWkWM*O)`Zey>++9TwEPdVZU=nOqoR=JEdXbz`|f`Fji*9L`|5bMb;nzw9OB&2`+Ilf=j!d~5ZHw%pTp~yBiE?RJ3a8hTaYBZ6&AdkId zTZBwKe;v@e%~+zE$adBJprc61TY$ciB75Z0X5Px?!tmGdJ*H1+cnKTK)N{lrw zJ{3J<(tH$Ff~{`g^YWcJtb|Z{(!WR)stL(?BJqwfY!^p8U#Ub3syUFii#w1V@q;$B zF-@joiv53U0Hs<3gz$5vN076wH8nY06p-Z6f*F? znfcc_2_9!EDSKo4-HYT5Xm1}e0AvmUcXW6uBq)K#>k%J)W1=;&(JrC>j0x| zu#e&UC?bkFL$Gj%|Bo9dKf`SC7ij%PI&94Yi=dJc@!y${q?iLVTrrQV40199h%cB> z5HY04ARn*~Xxajm*7qx)dm6aQp&rf?yFTDOeILMQy+yb*oLD+9v{hE`dV~5VVsR{0 zmtfJ{%F3;@6wl_U-A?R!tu=e>t|joJ{gS}2tOOmhqP=%M&B$gSVj^P4CenUPheGv# z^k@;Irg;|D(aGsl1S6v8e9FD^U4mLLtOL&pUrF$De8xC@^WFE5BG5FnajJV)|NpeE ztjur?Pv4&96oAGbRSBA|{_6zWZv=!2Flo+UvbGul`mq;h|NC_}9`3*`EMyNiasZNS zCfq{u<^a5MRanW3$ysy;f^d&&b=WLfP(2CEKg0x_r2V zFx++Rwycuk#y}nY<=)2&C{L+WGoi@u^TqqxXt2;>Lf2|PePYN<@t)vwsi zB)RY?GQzXSQhgd%X0LhZ#hZQ6n;4e)Ugk)z2m3W`mRHd-KayPc9*NGUr!?67^X`Zb zkKxku1YOh?v-p1E=$G~0?TELi)6Xal^}EbI24)CR8}zrf_{e+iXixMPqJc;875Af` z=$@f-%*;EH>vSc|M7QU|MF|J)3`Fo;!-=ph{KyJ;%``Ihidu!*buX%D^yZh0>6mu; zbco2?_3cMZezpm*{1xbHmNxaD2#v&kO%xkCSq!uON`0SCy2#TK1=Jq z-vt?Ce*sPgM&OYD&8o6<`}e1fv;8A09!3RwkyOl%pC$AyQ4gn|bY9$Z8j{d=XEN}H zPSXVue)@hFT6d?NHpT1_Y#%$w?$dW-=xgkDl?GqQzc#7{m0k<+8NwdUDjMkJ-S!ai z84`$|Nt}rPcUGtyZhM{h3) z***+12>7lHy}aKpD>1`bKhmcqF~bH)!!@qoN0>Fk_9=o0x%;9eX1E~U_l(D3`%i-G z0>3*zUlX+tOUwvDyzz|BVEeQ|2Z70@Xwz{PuVwbmx!LE;alMxa(4`y|^P;f-6Uoyb z;UaO*tI+UF6!DHnr_~KGb3eM}{zeT>)Zo7cS9k$NE=?Zj04FM#zlp_BX^><2=voL# z7lNkqQc@XMS%>RtNqC0G|34T$&~+vMym#QE*@ik*bNYoCmvGAiB;AuI7Me=`KZegJ z4ha8plf|YCcn|*E6eAnO#Ds+j>jCA)#?HWzq6Wsy=etGU-7XeSn)RH*W@6zD!v*)Y zw(HKVLq=lIk$kB|$w+WZ#dr3tkml9n!ZsfXO<$Q9qjR|``)Tbu+fq?M$9Uws$MfocWLHh{O3WfhnOx_611Ib%3!9gQX7gHZH$~B{KBdSd zZWpqnKN}HOquS>OQdC9r6j9o4K}%)(4d$tBF4u*-x2^6)%{j!gq92-<>zYTs>qL0* z?Y#ZqQ*~EqWOc+>OQ!Sno)rhV$)|R7Vp|*wh}DXA)x);p-wmww$K&Y}?IYbp>?j|{ z%63jKS#m$hxq{=LwV&}3)(;(SktLA%>7D?)WgjXtp@zzkgL(Jpxwcz`gI#DQviA}# zHE%11vdkUgGyQzf6K+4Rx>iSu5jK-rS((ucM!ZiZ$ILk!uQ*)j2g{)fNoj99ZH?U>V`Lt|CK2J}!Kw4F-zZ>!u*ESpK6Sn%jcXba;LNr%axc^@K4bN&`8PQvm$Z|O0 znQNR|yuL6$WTL7|`6^odYr?kg`P(yGMdj&1-49&mO-k&tDz6OY9mckYc3@>M5GGyIp zvY6(2PnrDv&fPLWIn@UaDHQm#1AITv?Pb_-k~? zlM@Q&2p7KN5?_&f+nc5eQgNs%?j>d8+VBc19*wFiB8I*faqSco9#oX!0tJ!p*1mS$ zT{fdk#vHxdD|T5f$=iPT9`*BDSB<1b&Sk+~iG2Q1!eybj++&X$x70#cV}HF&sIrJ> z;_{-Ba2G#ndxuD3;xd$+b~i4wQE$Y{D(u~DeTB!gk=W$H)0v%N?anFs0K>`jQ|u`n zIVWybge!M@R4#$DWj5iBplZ?7okG@@w^#<^QO`SQo84urnRUO0%uAu&;Ii}XV3+Zd z&vkgr-K&m4ouaWX%hF7M<*Z1uZjbQcX(Pjr79W)G@b)tU>|d<&pOa$9y?v&_!-aU_ ze{t%s6IE{%tvP+C4lz?Ny(@x8DX)rur!ub}rTl22XwzbFYM9@N`(#9P^`XnmWK48{ zlD)|apEQuhe^i3Tf)e75mJFK1Uu z{%wmJWLNN3{m3NP(uD9QT(6jx=yx4UvLU{VMD7>#UGIH z#Du%>pjBw%{K$B!!d)+Ex(T4CPsAgT@yvv~h@q$G;)AOas&q%bAp)>9+>lpj6gYk% z60kMAkYqFp7QYY$`7p%;;TL(rUG&hZXW}g=cs0UZ%+RXv#gsL|kXPswQGOvN@?mB$ zL*kG|bc%Yv5IdOR>kwWHifO+PSC}DLNFxTtm0t)PW(W)6g-{UqhXl)qg~HY-LjFQ1 z1pPx|U~5z%pZdM+!jfQyG!1d|w*Da*3p{x@Pbq@@L-JsT^dWA4@{^xYRB+JO`-fD* z44FcBF)60~LmFU)EFq1U6jzSRzH6)@udpa^0z$fBYwRJ(SQIRr^lt+~M&!fBU~60< zpRg(P0zzi_2}B%7#1GK%+C{qTp$@ObnYQa0yPcryq~bbeD%Kcy%PB9`MY`OfRb=8V z7Oxe;-IcPqDc~@H8X`K0owa45-!)ModSok`84IlHO?#KKwb0-ZV8v zC~g76qyX-}+3>Xw`XjaJ{kJ7iXJ-KB2Kabg4u;fUk=Z8Pwm%yLGV~JZiVlG$BU{nGGyWUF0^$@0vZsm<~q+5__YA`9}7$7pY0`{^8Q9Qip} z-**GAmzw?Bi?!-yIZJl9N=FkYUK0lzM5=YaTCY8<2ykXBTR*OpKN`2?2qv$UbHbCA zT|La~S|iN!5GRF8=&fn5G^8?4-dZ~?K$_}9Ta_;rBYJ##431}&8N0a?e@`eU;REDZ~0A|IWvb& z@AUtln(6=J)J%-GYE7d{wJ+~fbsjv-YH=H`Pw^{D4jTscrEEGHFkikr zY|Rwg5jnty_a8H+@I9|8Lafg}7^kMS77tQR` z#5kG@_$8nvzJ_F@Bz+NPXA;}%s2Y^sy9rfh_QMI!-W}sX`-p13{!j~wiio(;a3C6e+E)aRt}I$P|a|q-|%`0GyI-KRe45J z@&v5H4pu4s4OYPct9aNG_`L`Ot5ASds8^X#N}hrg<$sh8kU{`bn(VK9Uj)f8bj}7K zRT(o+27zo|kUa&m>2X1}cjFVqXI&usO;mlpIB4O1t{HfIBk)ni7;kCwT8TDB;^f4$ zIKGd<`lZ}ftX3#fhh>#BOG#oM#m)oS9(6T@?}3bgrWzviKxPSURBw*Oro;&hAnn0T z4&d%Z$uRVSyZ?@+gcSTbr^)#qU>lq3;J%XoI|6**5$FS37yWkx96^2zxPxIJ#bg7d zP)Z4_NYj*1fi>w<@)OeqVBN;CmLM%Y4y0v*v?rS&jSloA1A4Oj1A6)hdMf=#NdPGo zAm!^OI(i8cNU=!Cum9)5BzDj7$~QhqW^VxGe+K!_oIrju$nOF95?i244v?P$y4)KC zDdr$W_8%ox#&QV!GS*u@tCdQ&Taw_X{V)a7OT;tkZKe)uu;~1+b*HNp{h|Zpix-l1 zql&nPA$m;(c?Ii0k2U8kkn{+52ci!E*Dx1jKF7kOG(bNaP|WcDHzqC_91+)!au28_ zsFEnT4E@AtOl2g&{=_;FX2~pDK##YzHKri{N zW_Y=x-*NF)zkYoFs7cH2+LT*&N!!uli20PUQ)yV}8a%!7qP|Q=3l5%XxM7EBmFlnT zR^BH>qiR4n<1!D^r9zVdo&Y&T6uI z8Z4#$m8o7{xPfT{OHj)3csJWQV=1U94>Q;@0flKb_Cc>ahM*LukL-i|A6|A2%7EG^ zjczulKu{Y1nqTLG+)uh#oWY>Sp9!Fw%4yKdt&77sV6X+BU^@qjsh*4$nR;oxGq$29 zt!~vJnWzS6@8OP*LbE^~B8$^T-cjp=rPj|I;OiDVSaVnph!%_i54SN;Dciq(G2_=b z;=b=KC;$G;v_ymZVMx7+kF0yh4u{g#$2Q%e=HsR+kI-r%t@u#veA=Iz?xJPmNYoVr z#&-}hnq1UX^-j1G8?~#pu3s4Kzp$j^BP$W`{?ajj)3_)B{F&(h5&~lPFNhgpB9?Xd zlOEs?HSW=MQcH#V{YC;k$M$_?|E=C$*4o-~7O#n3-A5sZJTDWj{tp9%u%xr1{>Ae- z>ePTA3MpL)GCC<;t>0rClj?dNj!mpg0L6bPZ4?t7cYy?r>*M1Cz&r}8`z|Xf+lgTY z9``R#!xG?Lun#AfnodSU?OJGVuKzc2iMmS2>S4qhyt{`D0#kJE*-T9Cx-$}r;ix2* z;jZ30+SRUgh?76tmj$f5chx_`FLH@hFUs{V)fxn5mEf)t-|vD+(jeEIV`BZ2z>Gr{nX2`sD40>y!sxMI=lbAfgNJ1;^H^p*&Z0&|Jcr04Z!bGd$ZzO zY=aQMB1Ym)`2DamvtX5+e)UH3{_2qH&%|MepNRsOg==J-({&G5loc-p+8hO9FM$Ky zr#c_i?%N=ZId8RSLU!mVU?@ojYW2!W;!3m)3#||;n!SAURJjJ7>a%?kg@M7a=aGZf z4BUcAxg6Y_8Iyl>_S7vkS>oghOcBf50xLoKvH$)|ez*?mbq;XzTS&6U0vc{Sj1|LWeZ zBIRoN!&UW+_q2BDwHxVf{q9)l8&=`+tj&VAJDV2G0=wxRhY$UCUIOql-1JHp{Jrw& z3eEj$x$c)5tv#C^Pt1^L4kwruj~(#}KJM%Iv|q${pcA4lJBF(D@Bh)}j~dO!w}Y^p zivuvd%9)y(1a1x8{IeN&`wphW;WI>!qqi+-;iUKw_Gtol(ISk!)gxxD;2kQ^jr#esyW*kZso78FEEivgcts=an0 zSm@nxH3KLVfR(VpO0Df+3C{BEp`sYj%LkPt)XKo4jm#vRyaX(bobWwV6$64Yplc`4 z;{6TuvRnaLLP6(k;-Gq_I2UoRtTqXcCY1Kko`kn6f=W)bSX{!(<@=`#v_7~uPGCD( zAfw?u_{|hQDxVJi z2XyWMx@+rT0d1c_FE(Gm-F*Y91baZ0*|U5^D0avl-Rqqq`|L`T+;)`Q5tQ8JwaGV^ zx|?#O6(cjM!5(``ilj?{d>KtRCHAC_oZAI^w?YCyQ6(^Q4$l#&rj2UkF?u+`;}HN{ zBf*7hR>$yS*_pUG(*$)BGl7X-xHAC9e}ro<0vde4veQLlOZpr7*}PsXlFZZVc_8Z+ zuG%$q4;L3tySU9t;6pgwDwl6);mZ)Q)T}wKb|BWqi5UxCs{J|7a)Sq?Y=;*JJw_M* zF_dN7^^raXE)n|Cz(t?qv5Mqbx`7w(2!x<#U}9n*e}5MsQYh<HzFx^!Kaz}_Q1SA^_+((<7%P6x#BT2?;L}&ZjxNz)md{vS8kr8 zH%5?IejRcZ#=*rOp^4bzJ~|>~@v22OU|VcDtykrCpQm54Bu^ zC}W@y3XbPQelRL%KAL~B@Hc#jKZ=M7EaVxQrXP&yy#oa^wCjm~i!d}fMj8t(hA4DU z7@8U*jg4022jhXFVfb$ls&Y4=jKvT=QyiT+*}2o70bXVUmzP3nTR$QyPOt_pFW^-D zk7XC|PcK^KXMltvKtQ&FH!*&}4(kz+H?Zo3mm$Zt+t*zfUU^vT#`pi(I@KroGl`ng zCVA(K(Akgboo09+toOr_^xN-Bq6#%&Jy`F3KDm!x2^qpP^lrUKu|(>~P4->&7W3{- zHOlVaj@$85-AC$e)N47R%80lR7ss?2=`$bSO|huI6DY{IlQSYOu@$kaJ7`LtEB)Ji z6f!sJ+U~J^I6o;_aa2Zwu^30-yc&`Pqm); zSj`p)lEoagIBVZA&9Jt5{q~ev*maxb8V`??E)dfE<%PYQn7jK z{Sn<7@jQ&dT!F+a{K8hFe>3w-j=fLd*owt_v^mwvh1(zNR@T*Y@6xua!1Bey~uOqV0=D?xgA`j_QE z(p&x6FHtw5iUQEeF8nx+pzmxRbxlXpryrWy0Kk77UBLOUb`Hj{l2Z+6WN!G;7yLI2C@vI$S zuG_J%>BYo7#$mWS?da>s3fm(fy>0Sb9V?0^B%Mzuv421)hNpjBMDc06FVDrV+3<}s zl^QHbM@KG-wCj0@b!1r4XfI)J=N^Rcu2*!W^JToSzxo`U?4*xP|KL5pl6!t!3(nvD z`g5n_yzT2aK698(VH2S`$)@_oyPbQ{hKk^@1=R(VQmN*iNplyv?4H`2WUVP4jLAC_ zRry1)0Tg~gICbH0&n)s~mJP|oXJ^|t47*dsTY4ERQ?jhwe>~ri4h~P3iq3B*mR8DK*u| z(b6`mzoeg!rpRohoZcW!^ala46KjH4xkHP8G>lpYog_%CrQ9OLaHH= zw}2mw4uM~BhY4N?3nnty`eKTQ`XNJfZLM?Hpqh!CeAMuwI*GNCAkJ0Xd) zf`x8g3}LSI*GS5dpn?ZfY=Vl~e~M^OAp|O(@PUktYKXW5OR%srntyDBxE!qbDVl&^ zHXW4f35Ocr?i%A&{hL447c_GyBD%00Oti0l+3e7d=>EeI;ubLTA?ZnU|D|*)iZE0W zr(tF26rYrX)kN#tRw`aeLgpsK%q0LQ0#bqf`2eMhYAK4;eN`u?DC3R5=gF~{n9XD$ z`e}A7yUGmE1k5}FLnFY>eY+Ynuq;?cQUCaJ>|um^2L4sb0BBG)PD^p`%e$*Gy68iFrY~~a&7{iOv*aj#m1%kkaj|oAX&U?}}zZ-1*5OE4uFp?w)?%jSVb+M!O zdUv9T_sVg-u4RPU3`iehij$y@4M$8)3)k{MZE(O4|Jc=c<>E)b z6{LIoHDsvHieSVI5*n@V$`io63mbOxTlzJ!KW#+UOV|wxnwjqkHgo~mUr5*<0wF{G zO?{QqMGND7(xT?3_CAX20|YT4o>>7nKNjt`msS9hQG><5(0*NR!NnzXT7hVKon@eC z{8In&`GK}$J7TXp>wRf-O7T?jd1-;^fO)~zSmo=w#p5YUJG;-PH;6`cvk_jY#b~bt z52prRThDG?_6W@*^Rqd#uo29<*9zO28mR)`H6x7L)KhW2m&bE^J;UtgG@=qU_g}PU z8%mY!jD@xL%0(eXS84rf&}H(&SW?!4dqq>4+tg2QO$|q_n5ou&ds_B7XQJlC&*SIJ zOl5I~mO$I{%-7lCT&zkI+SBT}I;IR`xcnvJz)dW{`Jr+7;jnAMmt)*%!(|U;aOrT3 zP;m5JEE}_;jLxVoyV;fUT=bp9{x?BMxv+uB*!hd`clEea@1{b>RZ?eWRHEE0OX|ep zC!2a%Q}Vd{RC3w2{-z*$m%e=D zcDuF>o5tMxTB!K){h0oKyPz1!56TZDH#)IzcZLe*R_J}^zL^=lG*QB4Hj0hrs2zL4 zTmw9LlA4n`aLH1!Msa21{BycMD@AHyQRe4q`pR@Q=Ezfmd&b0r?>j--?EBYi;>$3; z7IE?TV6t!d*$^QaE@XcO;nA-#bf{=HuR`Amk77WcA&XGLiqX(Ae6wH3spq}~K>&gf z#48X)Ac#Sb$W3#dBC<(AkxXvdyh@bpg>i{2moXJX^+)P=XNuDCV6hg&B!~-RK8Y75 zpxILa*y-aJaA8&F9w2T=@SXW)4P9Tr+7QRp8gwa{S@;~=I%%z;<}u?Aub#2$#F zgQL(h;ZZWk9;yf&Chz-_E(IA{_)B^VDNu$jRujp9SU4F2N`n%Zf@HuToQw&jK@FV! zasOrlxx>qs?TsV{B@JQ9bIKHaD9w{VO=JTt;bcN64SHY-vVo;=G6|FhBXAbkz@s4c zk$_8x?&c(LNu~}=?VL@c4&48mUd`3~UUIV%tGR9>kd51HU=$2rh%b!J zQcqQQm;Xx2D~F5xho(i$6?r$$my~gi9nJ0$&-(E{Mqz8m>czKN9+H^6KYkJM{yxB3 z;Fhs!eWQV?#V2j0I;wz~nN<8$KB;cBWh*s(N*I$QK0CR`jehl1l6tMeNj6`Ro0`G8 z{rTlRGIil85wq#CWWnKVt5&niSJ{KiORa@iY^{e>!rDM0xw@{exE5Onnp*c3BaEc) zmddD2N@c6{o2J<~+5>HL^9D~iYkVRNV4cxg({r#2rZ4Q)PL zJh#}e6ive)dKGH02Y^%xznU)`j=KG{?%BmZSAfA0)JV zL@RUVic;FYp8u+q#lo>OAW=vf*=?CY95Hog95W`_S*1lzXE~mWtXZx~`K-=o>CNOF zdyGgCx=F$j3#d2vszt~^jLkH8r$LZ2En%a@Rj;(4`<9tlxA>BlS+qQS@GS&3dG}1A z_)>~HXWAwL7O1pOQG;#BmPwdm0}XU&@3Rh|`#wGMkJxFMA>C=|T@I@F|Ent96%`la ztSqt2VB8c#MBap$xXh{mF4koqc|6R&Z0@!fpH$!K>jG-^2u9`?M9Pj?7t8p3-$=0^ z$s3k;HLY8I65BUP3=^9@C5b;~i%i*oM8p5$jTwET9H$+?Gm&)`&p6%)IVCd>oh4r} z_hk7!ZtHC$b)c6=ZClb#?PJ3&*D99yHYTQ;kKCgXsgYa@b2J_F= zJPTowIikVmUZoPT>}i*D#uYT`uLv&5`DBbu6rX?uXy9IT4j&C%XA;HVdLKxWz5z`= zF$f+F40tVyZ^{=)BmY9$7%$a6Tf)2p2~12Y*RrqpAMwkKhCDO+0#ite62#jAG+0L|ltD39;A)IbvoT z=}~uGAb|^G#}t3B$BE^C{}-i=i2ZNuOtg%79bfzqnCIsz%EVI!gWqcx( zM*VeAuQcd`k5+=zQA|e=m$E|Q8lWHOe$a)jVSB_}sEqW{E8Ryq?z)adSR` zYBmiHwZ!*VX(|f?;RQEOFs1@Ev&uqo-DI}#P$#cYvy$HB1KP4-z()lfAN|9>gSvYk zj|u4|!j$Ej>>TK45~C(`lE+Z1%x38M-cuXVnO7B zs0PsiV*Ez{)!GV@yS=Zl@HYsAVihUH-d8Efq9aYN^lS!m?7y=B{J&KKjy=X$l|P>O z&X534lLq$Mr8Q^Z3Eu%(+?iOb3_?YI+Gc^b4WFECriu-^4>X-Dcw8)Sq}_fZ*qyNv zd}LiDI(tHu=QJ<%$@k%pqxbMuFqkW()&`I(`wak})Q7Hxo$uj`=Taqqt?cp_-1Z|3k6oPVXaaj&}eHIy&%g#+%YP_0;?A5)>VY0K%-bS0c z!s+8jS-yI0Sr>0P*~NOvy|YCxdYf(vdhdM_%Ng22*~LVmk}u>1(uuR{lg&q&->>>w zwGW8|J{=}3sUI%(eZR6;FGtK?%82-q zbiasbb49+Irhf=e{h5tZBo`w1;Q9P3Z-6-08cS4h7ZFu1zS*}Bm2{CaJR(x1@R*%$ zl{mT{X|8pw=gN_s()-=tO_icJrN!S5!|*P_Y8U?u-#~@fmnv}yP)T|#MJwxw9%|kX z`l11SWu}WzgmFAqaPTdS5Z8E}&4e>bfKiNz=I!9yAw2pDqZkVh ztn`qJ(tc?X^$JGuhF3I+@qeE!CZgN30V!+}c8{*|cp!ZI9NwUVz%5-V@C>$TOim>k z6ti|7c&{8fnf@w1jKvjEIkHDY;_DW`cm{`G(d^uV3$|W<{JI3}KLX2tf&ELM>=Phl z`mv{RL3RM>Hv!kJ3!AdsRDJa8Zb*#8fU)}b0+{)d+=L{=8MmUB z{0~2etSW;i-S&~vuA5$a#%(?x2!=QPO&gA?<4IfSu^qgu;vxSuvP5y{zsNIfVMlZk zxj5n(+?vpf@de(nUJcMI;P9T*@!5A!ZvE0d9w_H&p~fg@`ZoV!FezYrC|;~^nKgK8 zvo9xYe5&0E_b(3VGB>Ts5yOWo&#?t|3l|64Ym2QH%TK!Ld-do(xOivty3C7p>$Z`6 zO0TD=;q~4ZcbcJnM{q6sp8ooFQ|dhO;8e3l@=~a^aq5>&mhHq((ib}9gbYKZ z9}jLWO3 zvidVa5l(11h09H@WXLFTzJPo zf%NwE!PW~H`-2DluRmr#D-bS^mHWW6QQ+bnz7q*is zyZ9G11tXPH32oT>@9umM0prJ$4pP9Bc06*kpbM7Q>bJM%o7z#oac!rA2Gfp}f|w>a z3R^6QQhBupUUQAaPFcq%k_s(3Dh~A~7zlbZclx|4*+{oDBWnBE?0AfzNyPhVAbZsF zs<%(GfiW-f?Ux9$FIrW@H;WF-x|enAv-*5Je`xDkqPn9Tf<|gj-`q2=XV_Wc@3mT` zthh<0xgAIhpkB$$<=ad!#bs$`%WKBiq`W&t-uz9g!Zfq|@sdW5Ze?e1^>=s1r^>&s zb^P@(mFZ(bhd-&-C}2{wj7X(E*S<{;R@%l+^g(Q1`$(6h$q&USM4u$z9p(GY zooMTXJfUh0P+o$8SG7mK)_Ik#e4}i?Q6(YEQhw1Z#ScE7siBSZ3-z+z|6hXSvYvv)=^+{c-~sNi4Li%;Y*C zxz@{m*YWIs3=+4WZ*cGqz4xJGOCA#9o+Pg+=J3;KJF`N}?aFC#TQxyr=uq6MzIZL| zTg9L(ys^x`{6q+JNET|~GIGZ?(kk5dL}WqZ8#zh`p+mehA|%G^In*aK#tR>ccnTqZ z5}1Y3p@F1G}5MF91|ge*S^1W-DHkym>g8EN#<1BFmKijY@lUiCL1uP*zZI0)bH z!MsSJ2pmWjM&L4P$2IaQ;CtdHd?Nz$dILp#qeiQ|xb_I9CWLM*cFo<$fdFHlxQX zwqD)|X0wlEwXOF0R5g;@)~#SxL;zm>EB+>vd|dGQ9JfZW>k{s51kl+MIk)^B(Pp&W zJhiB5pLeeTN{qIAT?q&=e8`y_mVR`-s_mDvRXqt|ciZLTGrqGo+8KPTPERn!YTnkJ zopkx+%Gfq=o(LN>NI&<(QMS>=^8al-qd{fb7%N)dS;old8W*1Vf_X0ZMH}hx5I3TKCupERF0za@d3+(pRprQ-o~X3( zyM5fNN&BDH+c-(FZz810+UOP&*56(B4m{i#1|dEMyeh=+{A>~z*cXP4*U*T1)0H8uHZZ3L{x4|9kR?kbb?MNxf`e49Et2JNLJo&iR`!OBV#8NN^I7&NI-kW6RDoV^#y1lsq8lbYxGH$ewm-fJ}P068LHD*y0sS{1YA*DU{Clm{97z zwHbao(lNs;Cb|m~wt<5}#tvi9=CCz^-yDk|MoI;z&KD=hSG=m?z!kbyM8JQqSmZpV zfb@egZsqq=a=v%D2MGAabLU4_s|a9$C6wc1W~G4oV!i37Ki^$xZ_AD|FX~%(%zxf3 zncXJhKIhsEn0il2PHd+kq@&bX-A^qs$5oYKbndEM5RKll|F?S8|IT4SW}w&UPWJt~ zXlK1Kg+z5}QCi-JnM3R>-w*cb2P!1^VoE2Dr3y`A3xuTl&W#bfFq)snD$?_g-q>_> zUN2#7I8go2m^K2aeq>A=8B{+eri})wpAgf=0@Y86X?qLRCk?5@?NUVQ8u=wH^aLs- zMYMTx{XjK}!v6F(dmT7V;lIHOLI`j^bbL%29}6pMUhEwZa?;0f-!1|6s4Ox(3cXX< z^UgW)ni!Vw%h84$2r`@zj+rcGKKs}HZrQlqKx z3LJ|(skr#db2^)Gk6|hFL-iE#2-4^AYoUH&FZ832yG}@_ny+@x?TZ)$<4AO6g+Ah9 z2)^*HO??>KJCRzisBub()<`=-m#W9Cd@iQ$0aRWCcXySgOTaexjxnr%C%50;ae31| zeh-W@Z^y|Vk?1XW(!i(Ia0`ME0_CnAg1OwKd=s-fgIe9^C&XnlnMPXc<)P}wF1z(K z1M4<|;iA?GW;`|AY1Ti8oOG>+Fw%e2N#74|ku(oXbL@zvWnEipGe#%bAZ*`bBZ}U> zLc#I+jFryT@v70PB3+xHC@>mtmoo1_DM^RK*7to7=t zt~H*(gLRCcjkR(iaeeXmr8WB!GdBBudVT$NDal;pS`L6eqs$^22h%k8kS zoc7psVq0Bv&OZK9y`BZRjJMCMX-kY6`^?YDjr{h%k%9hh<1{trF>6IX+CJ>s>{7D0 zu(YDzZH_Za>?p4KBoDq3ii$ns-L%lqLzc8*3`!K-pdITGuH}T<3`rkigL5#(j)ZFk zpoh3<7``iD?+lVZuCP4{L=WjV*foQUCgr>G6sm*l&l=H11am`0bA1*1e|OEmZn~O+ zd7q$F{*}UO@LeIi4)0=zxuK)Y_^yyZ(~YQ>kbetEu8~7uqxlC5+v7n5QGUz7+@7NG z_^r_1o2=16`8RtgDo}oFz<4py?EF?(C{GC?IGoR;{Z=^2oYpv@>FEA52N)sqyuXe) zo|b6GulL#4DL`z?Fkgbf@H_nxV7FI)8psRA9qJ=ZV=wJE07kap5)ujhz*qd8J75}I zAu)bq{V4h8`MvKv|J5u%uAMsT?&H7M_fYwNvF{q)@*x^hl?X~4tu)-f-)p7kjV~j0 z3v01Fy7#sPv@JGI8>g1bmCl7Ot2tMG8ELIlNM)4sY*>mgO7YIWaGvnrc5w;%FYv8Y z^gn@bTW%L@wT^YM?|8p26Qs!lxJ!p+3KmzX>;EQo1m(z0^zAo~xC+cFSURmCxO(*KY z)9`HSun;nJ_-EVvrTXF|$3I)(-jealQqL5MkJpUqIZbAaqAo(VFH4)1@JsJaij)?k zEktdE_Fh=N*TA>*3{)*Xv`tl-*Ub>M834CAA9CtR%tdXA&H*V#%sSGJZF8HPdTg&K zbu(@S<`K(Ot*j|7cHb$kDiG{`;1&eCf9vZi|0(BcrOVG4WxI)@QvuZ9GehZxe|(){ zV-Je?go@_GQo5ctoJm45Hub;pF!Id_cwW#VkJsc6*?ypUNWTD}proWWN-mI!1tXR> z`q%%uild)h0_&34Bsu?$!a{&bk4J!E8<5(LBI9#*mT2w0e1IE&?3y|k$~EzRJXYYd zg;8qCJ(p7wh~eA?bJdU<FoHb`# z@INtyKg#amsxnUZg1uQ&yY} zZ#cmVXDN<;5zeybpy-aF!Fj@@>+$BUci?_t$I+X{dAHMSSci5xV6ax-N&q5Ad%ad= zI1Cd!Hqm`tK1&(UcNh8JA#RuJi93LlX~fWLo_fbS;H2+lhhtxe^74|rK^6dfsixu6 z@YAj`d_51kkGlLfd{!co-Yzm70n-IraeD&_oZr9pj7(}+$~zz)j>*PDk;A{!_M#UT z85U_NUi&CK7HG0=S1K<{x9f#CW|lNay*nS$+MeaiC~!I^Z$PwNbKT{-9)<-(y;H{t>U_>Iz!c zi|dmA4xFY{ey^OXWhXAQZ8Oj#8*~BJ6j1c0b3Y`tuz8Rm?Du?pYBjOcrc%?3qZLVy zD?LPh=~y2!5a%Vue{5~xp>cV>Z*DWirg`al-EaqR2xHzXnLd4(*0yLZ$f4dDf)xy{ zz4@OG-q|?joH$zgv%VQp12L*@<52rRTCXzkz|Bt-X|_ta#Qggq74=Htf;ElFCv|kzGc=es^~SSK4=_SR8|U2fh6)6=JmFBr})I zgB|r-^`Z972)cH>2zPCSOoL`n59u@*n6vhyDgAy|{fTANA2Umrfo;H3bfz_Tkm+q8 z3$Bg3JEn4yoD079&yPIH$)FJVPe=iUjDJF^oHKs8U-nz*1-k#5@aStuDXNGoj1Cv= zkSO#{cr+_U9tpyU)bYZX4Fe{R(r5ac6S=$VeKH14G6ZUh5?F#{z#^QC1vL#oE$nPc z84Qk*2h+nFF0jxn{Z6<4mG8^O2$RQzoOdAOqjn71|C;n=<9W@-2OGq}kjI6bcOv7X zbznLCdf~?=1(SacsX^=DBI@V&V^f9=#y=G+d=~f<#h_X^nR!5mLl-uf)J(-;FpLsQ zRD(sKir$g#$7TT=BnFefceD`ocloh7!Q@FHP8b~ ziMt2#MPUEm3VX0RSusme+!QF>D7c>|IUxvyJvMI6+<4U%-{BY&7TaCdN2;ljLthmDA;Kdqb~iL z--py-y*t zYH0MbW`pK#A;j^KmYwQcezp7PAr-(Aa1$4`4?GI_&m;J7E5z^}AWw^9w*-5tE&u}q z1CwnaaQ_r;at#z{kGjhcUIS@`>VFY%ZG_EjO==uBRsZ+3iG@A_3%4QoEX7a(zy7C# zpF9eWQb#|fgmxs{)y9MvD(z$;QIpMBy1?$;F?l6$ahg?H0K7Aa7<`2;R{Y|Tkc`y* z^6uC^P6iBqmjIUWIu7#8KlS1Lj|%gX@9vt^JprBI-dU#d;rArWE|_x+mt^-n4)e}- z-E0-jc|Ke21tN+=j-DEXLV> z7X0C;KA*`>ta|ynK1yaAJ7Ynpy5PpgMw;(S-?zQH%r`FcreaCQ1SI3?Oq}_4-ZRse zp|e4@1NyZt%p^Ux<5fPI=!ti`=w!BM5=uP zIS5gvIE(J3KF`M1-exfRhcf6lZYCF2O2be#*6rXo_D!kz(XIyUlz{rV>Qn)vz9@Zz z=Atczc{cJio4>e<^Nz#ORoKh?V_%LDdi8i;QLTTH9CJpbzqBK%t1U8c{=k{$Vw%6& z*1U#gbYx-tie!57+stW%fsS`Sn_z8@P0P791ZW=S2Sez<5#}kB?ja5b@lxt zEp}MtF1nxQnSVNt%4g7_Z-#`od#$yNZAaNVEzJt#p6UMtDTTcT+Q49)& zlNq2}f23&!N(?x(CI4L)2_g9C9T9$PCa^&wNE~{{cRx0pqr1KqKQ;&0;A@B~M#lml zFGU5gA+?1A2r6NkR(LM(W@O7sv3m#}jUR3e$PgZ0blT+=vBR zK&SkP16#m=vYtiXb}q6f;Mc9bKp&i(z{-|7(f(7wKAInnu>rX^cp=Hy!+l#i=LVTLW`Sl9EF z1UTaVMll*Fb$dvPJr#a3{G(0pfsph~QVH;qpd1{gXmP6VHXCe}q~pM^=Ggv5r9183 zCh0ABhxC3?BfaQxLVFpv374LK%NZV|e=l3f94>#+)4A6^mMfpY%`2yu;;$RFn<2D;CpPVIX={mZ_9eg zd!M0GaiPyW!S{I^|5@duw^gyp$>e>)oBxZkzYdG)dH=_8B?N;K1wl#y5$SFgL_nk@ zq~nQ{v~;tS(yTO+3Ift49ZMs*bcf{9wJfl(?D-yjy?>v-f7f0!+;iXenR7UM_RQS( zJnnnc&)z1sUnfQ@N%xO*%^GaBwGWq^wrhH1%zDGho5V|$?jkD$%9X_6O=4kAww#Mi z=U-gA#+LII$c#&wtpiwNUWk66_gAm9$ZYNNF+KO+NiESWF_&A`K*clG#Wr!7(lcVK zT(QStlegU&-PLBY^3){7J1}j#nG;IcZtiL(U)WXk{pQ5oUn*|56H$p7^Q7oZYrmdc z+}6ysib*?|EO&QyFYczEhNE5vC2Sz%zebT;qRX3274q|*MJ;~%KGNl-)YtNuACeNT ziIP(hxAdpxcE%U5V9_Gzplets`N~3Wbvx7s&n!zO^*Om!|K!nc?I2!VCKW2;YD<=J z!VW*0zR)0Eb0!rUV%J+8KZ1Dem{iiIRTI2XjW+zwm5z;-?@H3MN+aFJd5*+XOiI$1 zo=mAHY@>W^_@R}KK2a=Fs&yO4l{;Qru?shu8wg@&`?!wCl*)q49bL%iToa=HJW5+2 z=p9*qA^Q25XFH!@!@bz=eGVV*sg{M9e{f->lS{a}0;&*$DsTR(bbu;}1Lhy*{v@==-*N$-fA{2*ycC!gDPqos=!ot*l8J_#do=7uM+d3_HnqnSOsDg_%@zy_By z=b~oU!AEtO`sZLDs(kUqt9oe*4|~Vft3;EZ)pdh<+@PMnGp8zdw7HFoIh}F>hdGVx z!QX}r*f3nvyWBw!tgk-m8v>QeNQpgrE8Vs)EnR#;>FyfX8za~oo>+3MAJ7jfl8PmB z8^cu`S5|QON~e`DznTlBd7B|F)COZCz@>Gd5YWqzr(H#-Jh^6da_0f_6GB z=yTz-Adbz{MwycGFy+lupGLhyvgtuS_vD!wBJMQv9gE6JG9#hhvG$zS8%DytWA5EO z(jOP;v=|>gzH0mAs&X9xDwbt{y&=I1R7R$zEr`F}-$fwF+{?O=WW5usC>zz~Khx?? zr zT@HP^&kmZBT39SR>FNTzye!#`m^WZKTAt5W`-4ROkZwo1My_^aj&(792Y+yWxE~jF zV+jIXJ#y-fd+mUe$xFIyaLFnpI~!6#1pkOj$dT^Q!d+ir3p;Zdy2kSbu$Kjg4}}(} zC&D+7)P8Pk*%0Q%P6TAUl>xXGSiU+!-CY(u#&q!P9Am1{&%o+2&k-i4!4s^4l~%Fe zej<++#+)v&n5%#lWOg>o#T9mr%MaHvNOpn2D&}Ia-J_-`6b}g|4G3^PKfh>Z63s-U zgmQ19^2*pSXr5)^5QOOxiW6e$<@YEXUS)MBn`d4s699_uh8fWy~RbA@>C3n>>g_NjU-B z!!R-=s>SZJfs-nYubru5WdE_c8^m3+Pc$;KkbvbPie1 zEZ617jKv%>;w~_gYKV*5rKg|Xpm!{Ymk%RL*uI8?{-rheU&M`o+r`f}yFhs*kWEKX zb_o0nTGWjMrl$cNJ|J7lZE))i3K*rJ&;@-@KiJ>E07o6HXC?-6m&G5405N6NwT&CA z*lgW%n-tIiD?B2%E9{>wO}6!n zl;IgnNAMwnU@Z%lUg8PsTiXI5ftQ0!{#N8~vuS=H?sa@e+`A+iA}R8kHJ(J?+Qyjv zyPw5AIM35BKQdP28c7+Gv}o3#(=&k3QmmVL-#*y z;T3vd^9Ks1!uy2aAHNvh6bRxD;N+uxzFm1TNYJ6UY5#5u?-;R_>*{uS?uUgAFED|K zq${XDPCe=HF9IcAK_rPE=UaLWzF#y3h#2|x9Oa)It(X&(f`&b zj8ug-8)wqUM8DPkZ+$|;f#&r45Tfa=!^Uyd(DJ@qA24xCt}Q4fugzGQq*O%m1z~B1 zIvK&+~@}YaL zwD3n4WCX>?hlb0d(-^`xiGuNDMs5(lxFJi#^t}D`uN%R%)UG!kD#8poM854pjDi1y zDi{3#G<%~TrHFXEV%>&ld3n)XQ`3Jx1oUPv%hhf_OIko;q%oS<9I*bsq0prqKweDoL(oYYn4-@!59F&@+)CkbkL2>nL_Tk#Mf&w^dMaesP^#t!{baDibjDF;Nyu1%aX@0BS-=G58HR7^nfYKV z8T$l@JF2_Tw6Vo zc*Zq&xGp`Ix+)N2RPIs+VOqvodBbIc$87HC z4o+M+QHu5(*)}vOYxekF_;2e(b5C^DmkNn0D^c*3j6Ln`yj z@_Tz&lxY8W*GR6v4kUy4l~z<{xkpu&Tmt^+o{XRrvk-iw^nDNc2PQW=-FI74ILyns z{EfSdv?)Apb{|_uN>x#x99v>21SuNPNWbrf@FD6(cWaRU_~etLaT1T)u86{SL(fN_ z9Iq3lh<>u1?!L(#DOZku3758faEYb>80_+)w~Uc;e;Qe- z@22y7!NJk52C?@*(UAYlh1(|?y^8~sMn@G<}Zcjw?p zz)g#wip4Lp?f;t?ac)S;1v+#4w}6jg1_(eWA9wz|Vf8mh!y%!NwJ-KG*m_q`GwXVf zzE^qn>)fgmncg<@IJz!T=le}hL zc=okj2PT4hyX$9DJH@qCI%Rm7h6b}h>^Q(D>%63F>wNaB?UusmhMzr#N%&`xR10TH zP0iZ7B#)=g&(He($7UUM`k}zdD6rb{F;9VM!rZV912O}5fYSlSv!((=YD$8dh7Amz zF8XMHxn$R${eig-nU5nrC@@?u8siZ}E-NZ0CySs^Dj6 zAj8DXo7wct&)6j9vv!>v>ROWoJe)Fw9Btx-0vxpLI#eKbtJU$7e(EH4SKF!?^x_P) z&n$5(DrZ+Sb9_p!CZ5Zc(8D@o*X7Do&wJG8^vYf)dlI!$T_@D>8IA{zWs`Ob7kO5t z{L~_v0ZTXO9<0B9f5%fbtHL-%q@hs#{p{Y@(N1rHXsjCb5@|Kk#_QQV){D z{ye>$ZGKFggD>l$@KjP!{*@0?I2i%PyN;Lt22=D6V!1!pA$^Y?^)UtV-eI~IGVKuW zeAKAQPp-g!pXnYUvH1#(y#;TxbVBs!Y3ulvqiA7%2Bv$&#LRddUjlibDeymMioQeK ziPupd$jfVz?fs_YF!cMej|#uA2~6o$7~@?9qRAdNJ2V`MFpCO0srb>zE$0%gS1^4w3aK-X$gN6B z=6hd3HLF;LzHeea_D`n{+bYCtS=Ovr@R3__(MGRgtV^HTV*6g?^!V#g2nBQycT#Jt z?SkZ{q5Q=2soge;@Sn#v1>v;Wo{>MDbF^N?6oCbwAU=d#V~qgkD|&}Q=nUy9dM}o? z&*tOA>)4Roo|^ambacduG3&2HZCMmM=q1G{DTEkmBYz%~RWc;dMTOG}fgJ+bO&M|c zcuPmz*6XSD_>Dd(0xp`-c_6d;GAfrJPzn2VAtd=k6ubG`NeVZ<1_9>)4`E=+!06wP z5_HWB1C2ee6;CI3Au1X^Slz1?WBQ)#8`C`5zfy1hWqOrzI@#~A zGfj9{G`F^v=X9wO*XoaCKsWt-G8TlCC?-0z=b`U+eX~5h{2e#4BZLlPWcc!;80Vyi zED+RMc&_XOV6ScL zcBT|GQ#`4}#!aM{^AKeld*bl#bNg}DrHiP5cU&P7qK7-^yg6o($vJ`drE?rozvr%E zkrUDmI|f%7K5zHuc}HeFbwAG?{tBxG`dQrD%5sN;5bR^1n?5t7!0pTDLEp~8d$#PB zDzjGfw5G=WbQX11LKxZp*lfF&g2r_5K{kZ=-k&EzNI%BiBQlZV^8;9AtX`GM(BjO1 zm`jhn`^4CDk$Zjts?`yuY+i*B@BJK|cp`q_8e2SVOv~ufBaYKc75u(rvK#79 zr%VYet&={Qv#}Ygr7lUxE-P2lKmOvrbCIwUqHbYeTx2S3vF1_goB`p9(V?JLvW@M3 z8h>2J(c`ys^Z~ZgugJX^c5i51)#I#z=!e7I#)k`b?`5QVKTbhfCo!X7^MW@M5iCpRG`R_}VfL`)3pdTnx>7(o!~ ziPs@_b0shENL$8>gGrK#+~h7XqC2wv>76^BAuEB@_#Fu=fg<=FxqR`u_#M?Nfu8ss zohyMU_#NXbfpz#DYd2TWfk%EaUJxcpCUO&UV)fr=@=N5zFyc^M3l;=%sHepOYkqa7 zGTsV%&{49CmkQlcnv9nk-BFf|*IT-y92qZ7x}$u~M`<4``b{1ZBkqKHTC$Mc4NW2J z7{^<22s)~l@iJzTA#rf3bstCgLE%`i4W>pO%VSfJg>~{j1FaUi4CZ;L& z!e%FHI48iJSOBLN)d1ONg3}9Nst;J}N3YOZxAI02noYjGU&R~EmkU+hF=`5VIUH@~=6>zmc zbP88bXOW!s7(PyGnXY-8#tAn*)?d#T^vC`hvmblXExLL)4-+`_Ch8aPytQ&5Fm|1gX1)=03-&1AhKanO@XXYD>R-gJVRn`DbD8WpUku^{-<9wS2gJeTTq%e4`}30N z)nxmT)#>JMtb=+*tlWOD1*{QcbLze(+at#&Tn)saav-9OJZ4Ot^2X&^o z#JIVK;kAT0{$f#Y90v8ZZLNoMG!0#;lIGH@e@<*>$me+=*YDOyS!)ztgDP}?IA0tG zR{!iG9L~AV_=?K?4zpML>xDm@J2xv!?}|RHDonU={`jf7u#0*)|Gu?o`kQ7mf4PMf z`xnPy{uIvPpn&-R2v^QfWtDaoP7>|b*Is={zVMzUpz@9bXH~%;8f&cxJ5bvCSK2$P zy-IJbH66ake$hKS@#(#<;L(@IVfDX3J~OD804kce2q)F|f!(lKYeeKmcWHqarb`o1 z4vL0Bk=FpI%WbU%u+};>J`_{ABR!Z%PG>dtFsuv!k^M+8D$!~e;G_8}*2%#ErhU4E zYs9TI;^6WpP(4~$kYKiA0nVhty|wV8qDcth)!mv7+eOo)HIu^+Fz6E|xa*al*d#M6 z1l<X8y$`&4vj7hUgcd-$H>-gv&uMK4}pCu8)en6q055UHH0mmd9+@P-}{~9Kwp8@$8 z_k%(8qWocB>91CAZycqMIkql}Cc+M<7`-RYO0bJh@&5+khtmLZ16-9(5-R%(&ao>2 zZbyNUErve;p3EQSUdLUD+p1C<9Z{67jX(f9Y3*KuttkUqA^s-^0usj3_V|x%bDzA; zM`kC2JegE-x>@d*<%Y!|Ug{qbQzHup$7=%M6@Z-uOUvLR4}q?TR-pJ_Y7GQXGKPbM zVRyUClC*)o2MiC5^Kn|CCO~D?8oZG;)yM^ir9Nl4u=)Q7tSMZ{XdkY+M`TwKas8kA zOjkffll^g{rEdUl7nhi0xM_9w7v423xz&!1&s~&6 zC7XM!npZY<6QuNvaq;}rg?#~?d9g}blWGSxnvvx>`E-x-^BX}5TLLC^4_c@A{eJ47!8;KsTD%KW-J6I!|jB3{?Ktq^)_WCyo zzRzpx^^*ewIN(t!y6ZA^CmFp%g7oBqDu zy3#G+u3ln*jj8+&e3;M7B7A`55f&6jecJK9a7~{!A-i)%G}Ao2F_R8XpwIOux|iHM zN?K;ug+0v6U@e$7pED{O>b=%VHQ#}6PJ01M5__eR(iK-t^eNZsHZE;JD_mk9EQ1#E|7)d_bjqjWzYY)+|2)&Vc37!+`oRfyx@`~R z$IRsp*VXoVrEjEOyYD$5YQD^uN?5@bcc1lgp}(w6)5TL-(Irt*J0=g!&TpKJlg>!E z`N^sEFMLox^VK{^)&2nbV${@*{RgvL>|>=Sg{HF_9ZFgTJQw$DIDF>E>teq&NmDo+ zCV7lp049*_gP!!rMPnG$pYTcPJNYjX6OnhO>s|`;uVM>i?u#*0u02jOSoe}fB1hMs_6oE;bCDGDh+EsXrWVWM z28oE8C_44WO}~#Xc!Tdh?R9PEc9B#An||h?0zIgJX#+XEmT_yN7GPtJ(?t?S%(4?s zhcK-Aef;1z*rzF#Sk_mtvA_d%6$>g{gPLC*!Q-ER$2atX$M5ey?H!*5iB`M_m#4kv zn{XmDc!8fl<=zWA!F4(^4e+8#`@jp(274Q-`n_+TBJYR{G+y^u`XcXWoeL6KiSmvG zBit?$YZh_y-h&|Fy7#m$f#b__P8W$qkQ|=}dCZ_NqBbgHSa!{HczeOfmKjQ!NnR3` z|2OmyO1J|}C3l5y3$J(U`5sz;iv>W$9iChuxAPPY2N6GZ$wtl-FB%Y6 zz)*&;`Ei=rqJ4J_*>l4s@t=N@)~|=?GZn=TGh9n78q12)ecjJ#g;?0l$#H3pi}j}E z5&Ni-U9z>vCeREd@tWvKczDApds@pr+jEHP^iAwosf%$xs{OlTfdbm-UKjNrsn1)= zH;(1K;0~Ak&0ZDpi}{z;AWZ2#YD`{J+bTEO))j8;eE zPy=@i#`cI+xnT?N(Sx&{91A$~@&9mNAdVp)fJ4l^Og^>rnmz(xcgVs3M)}&WUqvJZ zn13O=M$fIae_a1Vh=HhDH1ypmU@X8dprE_pYXsWDdS5T0E6>2>i(0V|8qP9}V0PB? z!&E-MHcG~VXx9M0_ffUz1=;~N3E*w5R9#mk^V-eb;oES1Pj{~&jQ(8l6aqDtY07fu zc0j7?ae&(|aaUhNl=ylaRv$=R*1DUHN=#kP2e<{GR~eAg#kyiOVN+so?;RUt-6DSG za!mG?B>B#Yr06>P?sp%>%w@J#&5LWNLiwdwTIMOxnMB zYi4sHaP1swu+F(hb%a`UdYGBYN|Yfe@m_61kXY2gPhc}8QR^oBQZ)usYNn15ICwMo zbv!Q1n#?0y?0oV|$8sGBw>Y47)dA5-jpCL(G<+^Kn)BPT$k(h!!%@C0q!si-`uzMY z)y?(I=a-#Ij7}Jytx6QE@SVS_OsT1G_k{E>&bBp_?)x444EndgY%L#&0+K2+NGruI zHnLG0z5*t(8=z~N^79(>rG~9ZYep(b`5I^JW_8Uc9y3^O*l7I_A1%wc{84N9<80$H zVxp%xm!(GF@VS!1P@#sc(~?;HT!v@t4-cZ8{h$xfCE0jUCXX*FRIiQxWHLvPMR(l> zSzhfDukVZ0t1%ykcz$7tJtB?oq6FFX9U$A(i%4np-XW7x^9nsnghX=)%W)W}M0yM= zF)OUzC--~LqIR>LgQ=d703P_~5xFFOu${~i3GwjFb_u5X-uX#NAn*?pxg$xiUu&ej9C+%J?@(-Vz;9Rcj^;Zjw0yVg6tYBUAk#3zM|K{eqxB zLd?#Oi39N4oteBy38sVUXqWBA*F>0gad5AHxeovROnd4hePQq~0NGu5JuWvmgc3}6 z_is&R7gAIUFeb+(@fD4oKwPxHULr1W$-{K(7F@6cZxY6yz% z7~7@Y4{n=;)yNejmx-^(1Cga2yJHhJ!*ot3N3{M#+nif%an0-xEuFRSkf}|4>AKo~ zkpWy)wf`amT1Mvj*PM&t^R@**VM^vrB9ml1Hn$W!PpKXImX({Kcm*i0z;pdCCv};ZzFtSR8)1Q_xr+j+39RXDe*8v^0YsQ^4)lMlj`?H9CF&ew1{eUrn$L~Apmi9+-3XKts-@0i6{lp-UH84V7by|_9 z{CsBLMyFShLm*dkw`fvZ=WM|Kg|E$2;#p&osujRsi#zvpx@DTw=I~!*iRz%W)eWTE znZa_+nfTS7l>KrsZsi=lt-f>?4zb*}0>a+`r-pQO7%gfiw^$X^KkDh#9b!cYH>gkA zxS06+dPwdxi*?V6&G6ty(5^%9B42{PfT0(Pu8_w=AF?O=}YuIR)sf7DFG9K?zXMy19nXw#W$d)y^ z|4`rM<5$@sTb|_pWI2HB%nf3R8)kQz_HKr%23Fi9uf5qJEi*$5MrxXIFztOxn7v2b zBpb5-k^kzZnHc}+h{B^<%>i>3#X1|v_%gAQG1q_vhz1Kn|I-C z8P!1bl*JD$JPrlOn9J%%%Dk!H{HZjO0EQF{k+IA0{N>T}1@z*X1xnDr~%dWx4zOEHi;4W~gwIs{BhXRglZ% zCq`(Swcy+s??79XZ@<6@ja#O=}A}GD36xxT9hoItXh8kH6=O07P zOe$EWp6RL_)uy|4OiA}zUmJQ@FMs-sET#96vfjO@bDvUMv2)05HMNQntDl&{l;YW? zP@gzdN+f$VIU4Ql*7}syUAcsn_vY}Ks5*Z>%%Q<=ma4wI@*#npoiR+zO|zX<)H&@s z`8iXRmO4XT&0f-9_RK*Kr)zIYnAVXlH1`UBSTvuyFf6hUNx=??|G-+M3zv5kr8o2y zAWXJ}SU9B3{k~353~dPPQvcqhocL?JJ;`}%`0(_yQd6{Lz6k?luocu=o2wG^>soAs5X_CXMa-IvM!ZQ zX-fG*wXwb%64n1M{XnOz%&5SqdX@GQYnZkm8gl|aqtvj{3_?GNH!F(Tpvl4;Z%s(e>YxQmqnH4P;<&_{Z+hy9L4;>1r@HJ8SuNDz?dk`mk zaf29gW92Rr_GYMh;L%<3*7iOuekd&Ph?2Y&uftU4;vO;l=86OpmMD}g=!luTm7pVA z=HdY{9B;*t2^*Dwc|;7sU$Mik3qbK#T$!+>p@+vt@fb#8#`Q)7mOPZ_#3%&AOq@-y zlEUOi847jbXCz!H$Qaa>z2G3uCS0jw@}mv~f{)C|1MYRCc$b*t?sXK%UI-B{-&$E_ z@}mpQcI7uES~<)ZM9N-B5ib+108D~6LP-Nh@W_2`yrh)b!XtM0V=#DnGgKjP;XgyAqRIM9O@saL@=FIW6JK0Ja zfBv#4e|?UfcFi$7q8X)>!gfvj_+uePlyL6rUL>Yk`o|DM+L#qt5*6PwC8QN~q_9ep z_z0S@A7BSSUWLS5}0pygy zs#8NZzgM5;z?TyYm4ivEya>t)wj_iwf6aaVh)wk-#h4+3n1chy!+=Pv=VE66Td8*n*3AJqTjX`-26xll$r*Z-l(ERBZ)0iJ&UUNh__+D# zTUfr=H)IZtv6NKxoR<&D)#SMEpSmpRN@?}wDJQShwCsv5dMW!A*G8%Z+kN=79ZdyF zY@lrjX84lt9Hboe@CoH-u& z4mQY6!`I;)Y=bXZ0JzVq6QC4Sl7_v;Egyxi1EGJr;ChNF&&ui=RA2#2qF&>&t3iSD zUDoRw^-BORKPGxPZSzQOqV}BVh*hA>{nZ3yM+Tx!**{m z!pqGy$e`N=DNLTDpXbve<%TrBvN9bQ|J&ddM6|~OZUoL*?0MTR}I}?q0 zJzxIwzK!pnvfw-AujlbSAF3Qj{*wBrD;ux-V?U_r&U-PtgBSm`ycj!Mla8w;I(V^V zzgE&v{3liQ$G#n*J}m0jbs$IvHQmjsi2x7uY^P2C+YdEoZN#sZ%L6>Chff{KTbly) z!~U@??(!>B*j!l($JM6$KXpK?mYaz^bzroov}uZ<)ae@cuu=lA?LDQ<6(XaeC{0lO z2j^Y=YIfG82l5!k4QNdfFm_3%`U0q?N=zJ1w{%Z@AgF*l2RE5cn=uT!hVQdt

    oF5%wc?0lVIdiCvTMwKQ}m1M4pzSU2C#ISwFq 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
    oHJaZa%&cRgbKqQScY`o5It4F}rqGD>-kDeG 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 diff --git a/requirements.txt b/requirements.txt index 73b6e088..84451150 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,5 +1,5 @@ apscheduler==3.10.1 -arrow==1.2.3 +arrow==1.3.0 backports.csv==1.0.7 backports.functools-lru-cache==1.6.6 backports.zoneinfo==0.2.1;python_version<"3.9" From e30779647593bc07ffa0ba5d74e09e29ebb8a822 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 15:21:17 -0700 Subject: [PATCH 076/290] Bump simplejson from 3.19.1 to 3.19.2 (#2176) * Bump simplejson from 3.19.1 to 3.19.2 Bumps [simplejson](https://github.com/simplejson/simplejson) from 3.19.1 to 3.19.2. - [Release notes](https://github.com/simplejson/simplejson/releases) - [Changelog](https://github.com/simplejson/simplejson/blob/master/CHANGES.txt) - [Commits](https://github.com/simplejson/simplejson/compare/v3.19.1...v3.19.2) --- updated-dependencies: - dependency-name: simplejson dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] * Update simplejson==3.19.2 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/simplejson/__init__.py | 2 +- requirements.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/lib/simplejson/__init__.py b/lib/simplejson/__init__.py index 7e533a24..2d1900d8 100644 --- a/lib/simplejson/__init__.py +++ b/lib/simplejson/__init__.py @@ -118,7 +118,7 @@ Serializing multiple objects to JSON lines (newline-delimited JSON):: """ from __future__ import absolute_import -__version__ = '3.19.1' +__version__ = '3.19.2' __all__ = [ 'dump', 'dumps', 'load', 'loads', 'JSONDecoder', 'JSONDecodeError', 'JSONEncoder', diff --git a/requirements.txt b/requirements.txt index 84451150..7b0b98a8 100644 --- a/requirements.txt +++ b/requirements.txt @@ -39,7 +39,7 @@ pytz==2023.3 requests==2.31.0 requests-oauthlib==1.3.1 rumps==0.4.0; platform_system == "Darwin" -simplejson==3.19.1 +simplejson==3.19.2 six==1.16.0 tempora==5.5.0 tokenize-rt==5.2.0 From dbffb519f53fbd5565a55566a54e29a280608669 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 15:21:33 -0700 Subject: [PATCH 077/290] Bump bleach from 6.0.0 to 6.1.0 (#2177) * Bump bleach from 6.0.0 to 6.1.0 Bumps [bleach](https://github.com/mozilla/bleach) from 6.0.0 to 6.1.0. - [Changelog](https://github.com/mozilla/bleach/blob/main/CHANGES) - [Commits](https://github.com/mozilla/bleach/compare/v6.0.0...v6.1.0) --- updated-dependencies: - dependency-name: bleach dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] * Update bleach==6.1.0 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/bleach/__init__.py | 4 ++-- lib/bleach/html5lib_shim.py | 15 +++++++++++---- lib/bleach/linkifier.py | 6 +++--- requirements.txt | 2 +- 4 files changed, 17 insertions(+), 10 deletions(-) diff --git a/lib/bleach/__init__.py b/lib/bleach/__init__.py index 4e87eb80..12e93b4d 100644 --- a/lib/bleach/__init__.py +++ b/lib/bleach/__init__.py @@ -11,9 +11,9 @@ from bleach.sanitizer import ( # yyyymmdd -__releasedate__ = "20230123" +__releasedate__ = "20231006" # x.y.z or x.y.z.dev0 -- semver -__version__ = "6.0.0" +__version__ = "6.1.0" __all__ = ["clean", "linkify"] diff --git a/lib/bleach/html5lib_shim.py b/lib/bleach/html5lib_shim.py index aa5189b1..ca1cc8c8 100644 --- a/lib/bleach/html5lib_shim.py +++ b/lib/bleach/html5lib_shim.py @@ -395,10 +395,17 @@ class BleachHTMLTokenizer(HTMLTokenizer): # followed by a series of characters. It's treated as a tag # name that abruptly ends, but we should treat that like # character data - yield { - "type": TAG_TOKEN_TYPE_CHARACTERS, - "data": "<" + self.currentToken["name"], - } + yield {"type": TAG_TOKEN_TYPE_CHARACTERS, "data": self.stream.get_tag()} + elif last_error_token["data"] in ( + "eof-in-attribute-name", + "eof-in-attribute-value-no-quotes", + ): + # Handle the case where the text being parsed ends with < + # followed by a series of characters and then space and then + # more characters. It's treated as a tag name followed by an + # attribute that abruptly ends, but we should treat that like + # character data. + yield {"type": TAG_TOKEN_TYPE_CHARACTERS, "data": self.stream.get_tag()} else: yield last_error_token diff --git a/lib/bleach/linkifier.py b/lib/bleach/linkifier.py index 679d7ead..8fcefb2c 100644 --- a/lib/bleach/linkifier.py +++ b/lib/bleach/linkifier.py @@ -45,8 +45,8 @@ def build_url_re(tlds=TLDS, protocols=html5lib_shim.allowed_protocols): r"""\(* # Match any opening parentheses. \b(?"]*)? - # /path/zz (excluding "unsafe" chars from RFC 1738, + (?:[/?][^\s\{{\}}\|\\\^`<>"]*)? + # /path/zz (excluding "unsafe" chars from RFC 3986, # except for # and ~, which happen in practice) """.format( "|".join(sorted(protocols)), "|".join(sorted(tlds)) @@ -591,7 +591,7 @@ class LinkifyFilter(html5lib_shim.Filter): in_a = False token_buffer = [] else: - token_buffer.append(token) + token_buffer.extend(list(self.extract_entities(token))) continue if token["type"] in ["StartTag", "EmptyTag"]: diff --git a/requirements.txt b/requirements.txt index 7b0b98a8..8c8e91f3 100644 --- a/requirements.txt +++ b/requirements.txt @@ -4,7 +4,7 @@ backports.csv==1.0.7 backports.functools-lru-cache==1.6.6 backports.zoneinfo==0.2.1;python_version<"3.9" beautifulsoup4==4.12.2 -bleach==6.0.0 +bleach==6.1.0 certifi==2023.7.22 cheroot==10.0.0 cherrypy==18.8.0 From 24b6d37bbe02c37416c838b4d3e529fefe444811 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 15:21:51 -0700 Subject: [PATCH 078/290] Bump websocket-client from 1.6.2 to 1.7.0 (#2207) * Bump websocket-client from 1.6.2 to 1.7.0 Bumps [websocket-client](https://github.com/websocket-client/websocket-client) from 1.6.2 to 1.7.0. - [Release notes](https://github.com/websocket-client/websocket-client/releases) - [Changelog](https://github.com/websocket-client/websocket-client/blob/master/ChangeLog) - [Commits](https://github.com/websocket-client/websocket-client/compare/v1.6.2...v1.7.0) --- updated-dependencies: - dependency-name: websocket-client dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] * Update websocket-client==1.7.0 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/websocket/__init__.py | 2 +- lib/websocket/_abnf.py | 183 +++++++----- lib/websocket/_app.py | 283 ++++++++++++------ lib/websocket/_cookiejar.py | 37 ++- lib/websocket/_core.py | 182 +++++++----- lib/websocket/_exceptions.py | 16 +- lib/websocket/_handshake.py | 109 +++---- lib/websocket/_http.py | 203 +++++++------ lib/websocket/_logging.py | 27 +- lib/websocket/_socket.py | 34 ++- lib/websocket/_ssl_compat.py | 5 +- lib/websocket/_url.py | 49 +++- lib/websocket/_utils.py | 405 ++++++++++++++++++++++++-- lib/websocket/_wsdump.py | 87 +++--- lib/websocket/py.typed | 0 lib/websocket/tests/echo-server.py | 6 +- lib/websocket/tests/test_abnf.py | 98 +++++-- lib/websocket/tests/test_app.py | 180 +++++++----- lib/websocket/tests/test_cookiejar.py | 13 +- lib/websocket/tests/test_http.py | 281 +++++++++++++++--- lib/websocket/tests/test_url.py | 278 +++++++++++++----- lib/websocket/tests/test_websocket.py | 230 +++++++++------ requirements.txt | 2 +- 23 files changed, 1909 insertions(+), 801 deletions(-) create mode 100644 lib/websocket/py.typed diff --git a/lib/websocket/__init__.py b/lib/websocket/__init__.py index bfa71981..2ff75879 100644 --- a/lib/websocket/__init__.py +++ b/lib/websocket/__init__.py @@ -23,4 +23,4 @@ from ._exceptions import * from ._logging import * from ._socket import * -__version__ = "1.6.2" +__version__ = "1.7.0" diff --git a/lib/websocket/_abnf.py b/lib/websocket/_abnf.py index 6c2466ad..416ebc8f 100644 --- a/lib/websocket/_abnf.py +++ b/lib/websocket/_abnf.py @@ -2,10 +2,11 @@ import array import os import struct import sys +from threading import Lock +from typing import Callable, Optional, Union from ._exceptions import * from ._utils import validate_utf8 -from threading import Lock """ _abnf.py @@ -33,8 +34,9 @@ try: # Note that wsaccel is unmaintained. from wsaccel.xormask import XorMaskerSimple - def _mask(_m, _d) -> bytes: - return XorMaskerSimple(_m).process(_d) + def _mask(mask_value: array.array, data_value: array.array) -> bytes: + mask_result: bytes = XorMaskerSimple(mask_value).process(data_value) + return mask_result except ImportError: # wsaccel is not available, use websocket-client _mask() @@ -42,26 +44,30 @@ except ImportError: def _mask(mask_value: array.array, data_value: array.array) -> bytes: datalen = len(data_value) - data_value = int.from_bytes(data_value, native_byteorder) - mask_value = int.from_bytes(mask_value * (datalen // 4) + mask_value[: datalen % 4], native_byteorder) - return (data_value ^ mask_value).to_bytes(datalen, native_byteorder) + int_data_value = int.from_bytes(data_value, native_byteorder) + int_mask_value = int.from_bytes( + mask_value * (datalen // 4) + mask_value[: datalen % 4], native_byteorder + ) + return (int_data_value ^ int_mask_value).to_bytes(datalen, native_byteorder) __all__ = [ - 'ABNF', 'continuous_frame', 'frame_buffer', - 'STATUS_NORMAL', - 'STATUS_GOING_AWAY', - 'STATUS_PROTOCOL_ERROR', - 'STATUS_UNSUPPORTED_DATA_TYPE', - 'STATUS_STATUS_NOT_AVAILABLE', - 'STATUS_ABNORMAL_CLOSED', - 'STATUS_INVALID_PAYLOAD', - 'STATUS_POLICY_VIOLATION', - 'STATUS_MESSAGE_TOO_BIG', - 'STATUS_INVALID_EXTENSION', - 'STATUS_UNEXPECTED_CONDITION', - 'STATUS_BAD_GATEWAY', - 'STATUS_TLS_HANDSHAKE_ERROR', + "ABNF", + "continuous_frame", + "frame_buffer", + "STATUS_NORMAL", + "STATUS_GOING_AWAY", + "STATUS_PROTOCOL_ERROR", + "STATUS_UNSUPPORTED_DATA_TYPE", + "STATUS_STATUS_NOT_AVAILABLE", + "STATUS_ABNORMAL_CLOSED", + "STATUS_INVALID_PAYLOAD", + "STATUS_POLICY_VIOLATION", + "STATUS_MESSAGE_TOO_BIG", + "STATUS_INVALID_EXTENSION", + "STATUS_UNEXPECTED_CONDITION", + "STATUS_BAD_GATEWAY", + "STATUS_TLS_HANDSHAKE_ERROR", ] # closing frame status codes. @@ -110,11 +116,17 @@ class ABNF: OPCODE_BINARY = 0x2 OPCODE_CLOSE = 0x8 OPCODE_PING = 0x9 - OPCODE_PONG = 0xa + OPCODE_PONG = 0xA # available operation code value tuple - OPCODES = (OPCODE_CONT, OPCODE_TEXT, OPCODE_BINARY, OPCODE_CLOSE, - OPCODE_PING, OPCODE_PONG) + OPCODES = ( + OPCODE_CONT, + OPCODE_TEXT, + OPCODE_BINARY, + OPCODE_CLOSE, + OPCODE_PING, + OPCODE_PONG, + ) # opcode human readable string OPCODE_MAP = { @@ -123,16 +135,24 @@ class ABNF: OPCODE_BINARY: "binary", OPCODE_CLOSE: "close", OPCODE_PING: "ping", - OPCODE_PONG: "pong" + OPCODE_PONG: "pong", } # data length threshold. - LENGTH_7 = 0x7e + LENGTH_7 = 0x7E LENGTH_16 = 1 << 16 LENGTH_63 = 1 << 63 - def __init__(self, fin: int = 0, rsv1: int = 0, rsv2: int = 0, rsv3: int = 0, - opcode: int = OPCODE_TEXT, mask: int = 1, data: str or bytes = "") -> None: + def __init__( + self, + fin: int = 0, + rsv1: int = 0, + rsv2: int = 0, + rsv3: int = 0, + opcode: int = OPCODE_TEXT, + mask_value: int = 1, + data: Union[str, bytes, None] = "", + ) -> None: """ Constructor for ABNF. Please check RFC for arguments. """ @@ -141,7 +161,7 @@ class ABNF: self.rsv2 = rsv2 self.rsv3 = rsv3 self.opcode = opcode - self.mask = mask + self.mask_value = mask_value if data is None: data = "" self.data = data @@ -173,7 +193,7 @@ class ABNF: if l > 2 and not skip_utf8_validation and not validate_utf8(self.data[2:]): raise WebSocketProtocolException("Invalid close frame.") - code = 256 * self.data[0] + self.data[1] + code = 256 * int(self.data[0]) + int(self.data[1]) if not self._is_valid_close_status(code): raise WebSocketProtocolException("Invalid close opcode %r", code) @@ -182,12 +202,10 @@ class ABNF: return code in VALID_CLOSE_STATUS or (3000 <= code < 5000) def __str__(self) -> str: - return "fin=" + str(self.fin) \ - + " opcode=" + str(self.opcode) \ - + " data=" + str(self.data) + return f"fin={self.fin} opcode={self.opcode} data={self.data}" @staticmethod - def create_frame(data: str, opcode: int, fin: int = 1) -> 'ABNF': + def create_frame(data: Union[bytes, str], opcode: int, fin: int = 1) -> "ABNF": """ Create frame to send text, binary and other data. @@ -219,34 +237,39 @@ class ABNF: if length >= ABNF.LENGTH_63: raise ValueError("data is too long") - frame_header = chr(self.fin << 7 | - self.rsv1 << 6 | self.rsv2 << 5 | self.rsv3 << 4 | - self.opcode).encode('latin-1') + frame_header = chr( + self.fin << 7 + | self.rsv1 << 6 + | self.rsv2 << 5 + | self.rsv3 << 4 + | self.opcode + ).encode("latin-1") if length < ABNF.LENGTH_7: - frame_header += chr(self.mask << 7 | length).encode('latin-1') + frame_header += chr(self.mask_value << 7 | length).encode("latin-1") elif length < ABNF.LENGTH_16: - frame_header += chr(self.mask << 7 | 0x7e).encode('latin-1') + frame_header += chr(self.mask_value << 7 | 0x7E).encode("latin-1") frame_header += struct.pack("!H", length) else: - frame_header += chr(self.mask << 7 | 0x7f).encode('latin-1') + frame_header += chr(self.mask_value << 7 | 0x7F).encode("latin-1") frame_header += struct.pack("!Q", length) - if not self.mask: + if not self.mask_value: + if isinstance(self.data, str): + self.data = self.data.encode("utf-8") return frame_header + self.data - else: - mask_key = self.get_mask_key(4) - return frame_header + self._get_masked(mask_key) + mask_key = self.get_mask_key(4) + return frame_header + self._get_masked(mask_key) - def _get_masked(self, mask_key: str or bytes) -> bytes: + def _get_masked(self, mask_key: Union[str, bytes]) -> bytes: s = ABNF.mask(mask_key, self.data) if isinstance(mask_key, str): - mask_key = mask_key.encode('utf-8') + mask_key = mask_key.encode("utf-8") return mask_key + s @staticmethod - def mask(mask_key: str or bytes, data: str or bytes) -> bytes: + def mask(mask_key: Union[str, bytes], data: Union[str, bytes]) -> bytes: """ Mask or unmask data. Just do xor for each byte @@ -261,10 +284,10 @@ class ABNF: data = "" if isinstance(mask_key, str): - mask_key = mask_key.encode('latin-1') + mask_key = mask_key.encode("latin-1") if isinstance(data, str): - data = data.encode('latin-1') + data = data.encode("latin-1") return _mask(array.array("B", mask_key), array.array("B", data)) @@ -273,19 +296,21 @@ class frame_buffer: _HEADER_MASK_INDEX = 5 _HEADER_LENGTH_INDEX = 6 - def __init__(self, recv_fn: int, skip_utf8_validation: bool) -> None: + def __init__( + self, recv_fn: Callable[[int], int], skip_utf8_validation: bool + ) -> None: self.recv = recv_fn self.skip_utf8_validation = skip_utf8_validation # Buffers over the packets from the layer beneath until desired amount # bytes of bytes are received. - self.recv_buffer = [] + self.recv_buffer: list = [] self.clear() self.lock = Lock() def clear(self) -> None: - self.header = None - self.length = None - self.mask = None + self.header: Optional[tuple] = None + self.length: Optional[int] = None + self.mask_value: Union[bytes, str, None] = None def has_received_header(self) -> bool: return self.header is None @@ -297,41 +322,41 @@ class frame_buffer: rsv1 = b1 >> 6 & 1 rsv2 = b1 >> 5 & 1 rsv3 = b1 >> 4 & 1 - opcode = b1 & 0xf + opcode = b1 & 0xF b2 = header[1] has_mask = b2 >> 7 & 1 - length_bits = b2 & 0x7f + length_bits = b2 & 0x7F self.header = (fin, rsv1, rsv2, rsv3, opcode, has_mask, length_bits) - def has_mask(self) -> bool or int: + def has_mask(self) -> Union[bool, int]: if not self.header: return False - return self.header[frame_buffer._HEADER_MASK_INDEX] + header_val: int = self.header[frame_buffer._HEADER_MASK_INDEX] + return header_val def has_received_length(self) -> bool: return self.length is None def recv_length(self) -> None: bits = self.header[frame_buffer._HEADER_LENGTH_INDEX] - length_bits = bits & 0x7f - if length_bits == 0x7e: + length_bits = bits & 0x7F + if length_bits == 0x7E: v = self.recv_strict(2) self.length = struct.unpack("!H", v)[0] - elif length_bits == 0x7f: + elif length_bits == 0x7F: v = self.recv_strict(8) self.length = struct.unpack("!Q", v)[0] else: self.length = length_bits def has_received_mask(self) -> bool: - return self.mask is None + return self.mask_value is None def recv_mask(self) -> None: - self.mask = self.recv_strict(4) if self.has_mask() else "" + self.mask_value = self.recv_strict(4) if self.has_mask() else "" def recv_frame(self) -> ABNF: - with self.lock: # Header if self.has_received_header(): @@ -346,12 +371,12 @@ class frame_buffer: # Mask if self.has_received_mask(): self.recv_mask() - mask = self.mask + mask_value = self.mask_value # Payload payload = self.recv_strict(length) if has_mask: - payload = ABNF.mask(mask, payload) + payload = ABNF.mask(mask_value, payload) # Reset for next frame self.clear() @@ -385,18 +410,19 @@ class frame_buffer: class continuous_frame: - def __init__(self, fire_cont_frame: bool, skip_utf8_validation: bool) -> None: self.fire_cont_frame = fire_cont_frame self.skip_utf8_validation = skip_utf8_validation - self.cont_data = None - self.recving_frames = None + self.cont_data: Optional[list] = None + self.recving_frames: Optional[int] = None def validate(self, frame: ABNF) -> None: if not self.recving_frames and frame.opcode == ABNF.OPCODE_CONT: raise WebSocketProtocolException("Illegal frame") - if self.recving_frames and \ - frame.opcode in (ABNF.OPCODE_TEXT, ABNF.OPCODE_BINARY): + if self.recving_frames and frame.opcode in ( + ABNF.OPCODE_TEXT, + ABNF.OPCODE_BINARY, + ): raise WebSocketProtocolException("Illegal frame") def add(self, frame: ABNF) -> None: @@ -410,15 +436,18 @@ class continuous_frame: if frame.fin: self.recving_frames = None - def is_fire(self, frame: ABNF) -> bool or int: + def is_fire(self, frame: ABNF) -> Union[bool, int]: return frame.fin or self.fire_cont_frame - def extract(self, frame: ABNF) -> list: + def extract(self, frame: ABNF) -> tuple: data = self.cont_data self.cont_data = None frame.data = data[1] - if not self.fire_cont_frame and data[0] == ABNF.OPCODE_TEXT and not self.skip_utf8_validation and not validate_utf8(frame.data): - raise WebSocketPayloadException( - "cannot decode: " + repr(frame.data)) - - return [data[0], frame] + if ( + not self.fire_cont_frame + and data[0] == ABNF.OPCODE_TEXT + and not self.skip_utf8_validation + and not validate_utf8(frame.data) + ): + raise WebSocketPayloadException(f"cannot decode: {repr(frame.data)}") + return data[0], frame diff --git a/lib/websocket/_app.py b/lib/websocket/_app.py index 2577f1ba..4d8af3b5 100644 --- a/lib/websocket/_app.py +++ b/lib/websocket/_app.py @@ -1,18 +1,19 @@ import inspect import selectors -import sys +import socket import threading import time -import traceback -import socket - -from typing import Callable, Any +from typing import Any, Callable, Optional, Union from . import _logging from ._abnf import ABNF -from ._url import parse_url from ._core import WebSocket, getdefaulttimeout -from ._exceptions import * +from ._exceptions import ( + WebSocketConnectionClosedException, + WebSocketException, + WebSocketTimeoutException, +) +from ._url import parse_url """ _app.py @@ -47,22 +48,24 @@ class DispatcherBase: """ DispatcherBase """ - def __init__(self, app: Any, ping_timeout: float) -> None: + + def __init__(self, app: Any, ping_timeout: Union[float, int, None]) -> None: self.app = app self.ping_timeout = ping_timeout - def timeout(self, seconds: int, callback: Callable) -> None: + def timeout(self, seconds: Union[float, int, None], callback: Callable) -> None: time.sleep(seconds) callback() def reconnect(self, seconds: int, reconnector: Callable) -> None: try: - _logging.info("reconnect() - retrying in {seconds_count} seconds [{frame_count} frames in stack]".format( - seconds_count=seconds, frame_count=len(inspect.stack()))) + _logging.info( + f"reconnect() - retrying in {seconds} seconds [{len(inspect.stack())} frames in stack]" + ) time.sleep(seconds) reconnector(reconnecting=True) except KeyboardInterrupt as e: - _logging.info("User exited {err}".format(err=e)) + _logging.info(f"User exited {e}") raise e @@ -70,13 +73,18 @@ class Dispatcher(DispatcherBase): """ Dispatcher """ - def read(self, sock: socket.socket, read_callback: Callable, check_callback: Callable) -> None: + + def read( + self, + sock: socket.socket, + read_callback: Callable, + check_callback: Callable, + ) -> None: sel = selectors.DefaultSelector() sel.register(self.app.sock.sock, selectors.EVENT_READ) try: while self.app.keep_running: - r = sel.select(self.ping_timeout) - if r: + if sel.select(self.ping_timeout): if not read_callback(): break check_callback() @@ -88,24 +96,31 @@ class SSLDispatcher(DispatcherBase): """ SSLDispatcher """ - def read(self, sock: socket.socket, read_callback: Callable, check_callback: Callable) -> None: + + def read( + self, + sock: socket.socket, + read_callback: Callable, + check_callback: Callable, + ) -> None: sock = self.app.sock.sock sel = selectors.DefaultSelector() sel.register(sock, selectors.EVENT_READ) try: while self.app.keep_running: - r = self.select(sock, sel) - if r: + if self.select(sock, sel): if not read_callback(): break check_callback() finally: sel.close() - def select(self, sock, sel:selectors.DefaultSelector): + def select(self, sock, sel: selectors.DefaultSelector): sock = self.app.sock.sock if sock.pending(): - return [sock,] + return [ + sock, + ] r = sel.select(self.ping_timeout) @@ -117,17 +132,23 @@ class WrappedDispatcher: """ WrappedDispatcher """ - def __init__(self, app, ping_timeout: float, dispatcher: Dispatcher) -> None: + + def __init__(self, app, ping_timeout: Union[float, int, None], dispatcher) -> None: self.app = app self.ping_timeout = ping_timeout self.dispatcher = dispatcher dispatcher.signal(2, dispatcher.abort) # keyboard interrupt - def read(self, sock: socket.socket, read_callback: Callable, check_callback: Callable) -> None: + def read( + self, + sock: socket.socket, + read_callback: Callable, + check_callback: Callable, + ) -> None: self.dispatcher.read(sock, read_callback) self.ping_timeout and self.timeout(self.ping_timeout, check_callback) - def timeout(self, seconds: int, callback: Callable) -> None: + def timeout(self, seconds: float, callback: Callable) -> None: self.dispatcher.timeout(seconds, callback) def reconnect(self, seconds: int, reconnector: Callable) -> None: @@ -139,14 +160,24 @@ class WebSocketApp: Higher level of APIs are provided. The interface is like JavaScript WebSocket object. """ - def __init__(self, url: str, header: list or dict or Callable = None, - on_open: Callable = None, on_message: Callable = None, on_error: Callable = None, - on_close: Callable = None, on_ping: Callable = None, on_pong: Callable = None, - on_cont_message: Callable = None, - keep_running: bool = True, get_mask_key: Callable = None, cookie: str = None, - subprotocols: list = None, - on_data: Callable = None, - socket: socket.socket = None) -> None: + def __init__( + self, + url: str, + header: Union[list, dict, Callable, None] = None, + on_open: Optional[Callable[[WebSocket], None]] = None, + on_message: Optional[Callable[[WebSocket, Any], None]] = None, + on_error: Optional[Callable[[WebSocket, Any], None]] = None, + on_close: Optional[Callable[[WebSocket, Any, Any], None]] = None, + on_ping: Optional[Callable] = None, + on_pong: Optional[Callable] = None, + on_cont_message: Optional[Callable] = None, + keep_running: bool = True, + get_mask_key: Optional[Callable] = None, + cookie: Optional[str] = None, + subprotocols: Optional[list] = None, + on_data: Optional[Callable] = None, + socket: Optional[socket.socket] = None, + ) -> None: """ WebSocketApp initialization @@ -222,13 +253,13 @@ class WebSocketApp: self.on_cont_message = on_cont_message self.keep_running = False self.get_mask_key = get_mask_key - self.sock = None - self.last_ping_tm = 0 - self.last_pong_tm = 0 - self.ping_thread = None - self.stop_ping = None - self.ping_interval = 0 - self.ping_timeout = None + self.sock: Optional[WebSocket] = None + self.last_ping_tm = float(0) + self.last_pong_tm = float(0) + self.ping_thread: Optional[threading.Thread] = None + self.stop_ping: Optional[threading.Event] = None + self.ping_interval = float(0) + self.ping_timeout: Union[float, int, None] = None self.ping_payload = "" self.subprotocols = subprotocols self.prepared_socket = socket @@ -236,7 +267,7 @@ class WebSocketApp: self.has_done_teardown = False self.has_done_teardown_lock = threading.Lock() - def send(self, data: str, opcode: int = ABNF.OPCODE_TEXT) -> None: + def send(self, data: Union[bytes, str], opcode: int = ABNF.OPCODE_TEXT) -> None: """ send message @@ -250,8 +281,21 @@ class WebSocketApp: """ if not self.sock or self.sock.send(data, opcode) == 0: - raise WebSocketConnectionClosedException( - "Connection is already closed.") + raise WebSocketConnectionClosedException("Connection is already closed.") + + def send_text(self, text_data: str) -> None: + """ + Sends UTF-8 encoded text. + """ + if not self.sock or self.sock.send(text_data, ABNF.OPCODE_TEXT) == 0: + raise WebSocketConnectionClosedException("Connection is already closed.") + + def send_bytes(self, data: Union[bytes, bytearray]) -> None: + """ + Sends a sequence of bytes. + """ + if not self.sock or self.sock.send(data, ABNF.OPCODE_BINARY) == 0: + raise WebSocketConnectionClosedException("Connection is already closed.") def close(self, **kwargs) -> None: """ @@ -263,7 +307,7 @@ class WebSocketApp: self.sock = None def _start_ping_thread(self) -> None: - self.last_ping_tm = self.last_pong_tm = 0 + self.last_ping_tm = self.last_pong_tm = float(0) self.stop_ping = threading.Event() self.ping_thread = threading.Thread(target=self._send_ping) self.ping_thread.daemon = True @@ -274,7 +318,7 @@ class WebSocketApp: self.stop_ping.set() if self.ping_thread and self.ping_thread.is_alive(): self.ping_thread.join(3) - self.last_ping_tm = self.last_pong_tm = 0 + self.last_ping_tm = self.last_pong_tm = float(0) def _send_ping(self) -> None: if self.stop_ping.wait(self.ping_interval) or self.keep_running is False: @@ -286,17 +330,28 @@ class WebSocketApp: _logging.debug("Sending ping") self.sock.ping(self.ping_payload) except Exception as e: - _logging.debug("Failed to send ping: {err}".format(err=e)) + _logging.debug(f"Failed to send ping: {e}") - def run_forever(self, sockopt: tuple = None, sslopt: dict = None, - ping_interval: float = 0, ping_timeout: float or None = None, - ping_payload: str = "", - http_proxy_host: str = None, http_proxy_port: int or str = None, - http_no_proxy: list = None, http_proxy_auth: tuple = None, - http_proxy_timeout: float = None, - skip_utf8_validation: bool = False, - host: str = None, origin: str = None, dispatcher: Dispatcher = None, - suppress_origin: bool = False, proxy_type: str = None, reconnect: int = None) -> bool: + def run_forever( + self, + sockopt: tuple = None, + sslopt: dict = None, + ping_interval: Union[float, int] = 0, + ping_timeout: Union[float, int, None] = None, + ping_payload: str = "", + http_proxy_host: str = None, + http_proxy_port: Union[int, str] = None, + http_no_proxy: list = None, + http_proxy_auth: tuple = None, + http_proxy_timeout: Optional[float] = None, + skip_utf8_validation: bool = False, + host: str = None, + origin: str = None, + dispatcher=None, + suppress_origin: bool = False, + proxy_type: str = None, + reconnect: int = None, + ) -> bool: """ Run event loop for WebSocket framework. @@ -360,7 +415,7 @@ class WebSocketApp: if ping_timeout and ping_interval and ping_interval <= ping_timeout: raise WebSocketException("Ensure ping_interval > ping_timeout") if not sockopt: - sockopt = [] + sockopt = () if not sslopt: sslopt = {} if self.sock: @@ -394,7 +449,8 @@ class WebSocketApp: if self.sock: self.sock.close() close_status_code, close_reason = self._get_close_args( - close_frame if close_frame else None) + close_frame if close_frame else None + ) self.sock = None # Finally call the callback AFTER all teardown is complete @@ -405,24 +461,34 @@ class WebSocketApp: self.sock.shutdown() self.sock = WebSocket( - self.get_mask_key, sockopt=sockopt, sslopt=sslopt, + self.get_mask_key, + sockopt=sockopt, + sslopt=sslopt, fire_cont_frame=self.on_cont_message is not None, skip_utf8_validation=skip_utf8_validation, - enable_multithread=True) + enable_multithread=True, + ) self.sock.settimeout(getdefaulttimeout()) try: - header = self.header() if callable(self.header) else self.header self.sock.connect( - self.url, header=header, cookie=self.cookie, + self.url, + header=header, + cookie=self.cookie, http_proxy_host=http_proxy_host, - http_proxy_port=http_proxy_port, http_no_proxy=http_no_proxy, - http_proxy_auth=http_proxy_auth, http_proxy_timeout=http_proxy_timeout, + http_proxy_port=http_proxy_port, + http_no_proxy=http_no_proxy, + http_proxy_auth=http_proxy_auth, + http_proxy_timeout=http_proxy_timeout, subprotocols=self.subprotocols, - host=host, origin=origin, suppress_origin=suppress_origin, - proxy_type=proxy_type, socket=self.prepared_socket) + host=host, + origin=origin, + suppress_origin=suppress_origin, + proxy_type=proxy_type, + socket=self.prepared_socket, + ) _logging.info("Websocket connected") @@ -432,7 +498,13 @@ class WebSocketApp: self._callback(self.on_open) dispatcher.read(self.sock.sock, read, check) - except (WebSocketConnectionClosedException, ConnectionRefusedError, KeyboardInterrupt, SystemExit, Exception) as e: + except ( + WebSocketConnectionClosedException, + ConnectionRefusedError, + KeyboardInterrupt, + SystemExit, + Exception, + ) as e: handleDisconnect(e, reconnecting) def read() -> bool: @@ -441,7 +513,10 @@ class WebSocketApp: try: op_code, frame = self.sock.recv_data_frame(True) - except (WebSocketConnectionClosedException, KeyboardInterrupt) as e: + except ( + WebSocketConnectionClosedException, + KeyboardInterrupt, + ) as e: if custom_dispatcher: return handleDisconnect(e) else: @@ -455,10 +530,8 @@ class WebSocketApp: self.last_pong_tm = time.time() self._callback(self.on_pong, frame.data) elif op_code == ABNF.OPCODE_CONT and self.on_cont_message: - self._callback(self.on_data, frame.data, - frame.opcode, frame.fin) - self._callback(self.on_cont_message, - frame.data, frame.fin) + self._callback(self.on_data, frame.data, frame.opcode, frame.fin) + self._callback(self.on_cont_message, frame.data, frame.fin) else: data = frame.data if op_code == ABNF.OPCODE_TEXT and not skip_utf8_validation: @@ -469,18 +542,38 @@ class WebSocketApp: return True def check() -> bool: - if (self.ping_timeout): - has_timeout_expired = time.time() - self.last_ping_tm > self.ping_timeout - has_pong_not_arrived_after_last_ping = self.last_pong_tm - self.last_ping_tm < 0 - has_pong_arrived_too_late = self.last_pong_tm - self.last_ping_tm > self.ping_timeout + if self.ping_timeout: + has_timeout_expired = ( + time.time() - self.last_ping_tm > self.ping_timeout + ) + has_pong_not_arrived_after_last_ping = ( + self.last_pong_tm - self.last_ping_tm < 0 + ) + has_pong_arrived_too_late = ( + self.last_pong_tm - self.last_ping_tm > self.ping_timeout + ) - if (self.last_ping_tm and - has_timeout_expired and - (has_pong_not_arrived_after_last_ping or has_pong_arrived_too_late)): + if ( + self.last_ping_tm + and has_timeout_expired + and ( + has_pong_not_arrived_after_last_ping + or has_pong_arrived_too_late + ) + ): raise WebSocketTimeoutException("ping/pong timed out") return True - def handleDisconnect(e: Exception, reconnecting: bool = False) -> bool: + def handleDisconnect( + e: Union[ + WebSocketConnectionClosedException, + ConnectionRefusedError, + KeyboardInterrupt, + SystemExit, + Exception, + ], + reconnecting: bool = False, + ) -> bool: self.has_errored = True self._stop_ping_thread() if not reconnecting: @@ -492,25 +585,31 @@ class WebSocketApp: raise if reconnect: - _logging.info("{err} - reconnect".format(err=e)) + _logging.info(f"{e} - reconnect") if custom_dispatcher: - _logging.debug("Calling custom dispatcher reconnect [{frame_count} frames in stack]".format(frame_count=len(inspect.stack()))) + _logging.debug( + f"Calling custom dispatcher reconnect [{len(inspect.stack())} frames in stack]" + ) dispatcher.reconnect(reconnect, setSock) else: - _logging.error("{err} - goodbye".format(err=e)) + _logging.error(f"{e} - goodbye") teardown() custom_dispatcher = bool(dispatcher) - dispatcher = self.create_dispatcher(ping_timeout, dispatcher, parse_url(self.url)[3]) + dispatcher = self.create_dispatcher( + ping_timeout, dispatcher, parse_url(self.url)[3] + ) try: setSock() if not custom_dispatcher and reconnect: while self.keep_running: - _logging.debug("Calling dispatcher reconnect [{frame_count} frames in stack]".format(frame_count=len(inspect.stack()))) + _logging.debug( + f"Calling dispatcher reconnect [{len(inspect.stack())} frames in stack]" + ) dispatcher.reconnect(reconnect, setSock) except (KeyboardInterrupt, Exception) as e: - _logging.info("tearing down on exception {err}".format(err=e)) + _logging.info(f"tearing down on exception {e}") teardown() finally: if not custom_dispatcher: @@ -519,13 +618,17 @@ class WebSocketApp: return self.has_errored - def create_dispatcher(self, ping_timeout: int, dispatcher: Dispatcher = None, is_ssl: bool = False) -> DispatcherBase: + def create_dispatcher( + self, + ping_timeout: Union[float, int, None], + dispatcher: Optional[DispatcherBase] = None, + is_ssl: bool = False, + ) -> Union[Dispatcher, SSLDispatcher, WrappedDispatcher]: if dispatcher: # If custom dispatcher is set, use WrappedDispatcher return WrappedDispatcher(self, ping_timeout, dispatcher) timeout = ping_timeout or 10 if is_ssl: return SSLDispatcher(self, timeout) - return Dispatcher(self, timeout) def _get_close_args(self, close_frame: ABNF) -> list: @@ -540,8 +643,12 @@ class WebSocketApp: # Extract close frame status code if close_frame.data and len(close_frame.data) >= 2: - close_status_code = 256 * close_frame.data[0] + close_frame.data[1] - reason = close_frame.data[2:].decode('utf-8') + close_status_code = 256 * int(close_frame.data[0]) + int( + close_frame.data[1] + ) + reason = close_frame.data[2:] + if isinstance(reason, bytes): + reason = reason.decode("utf-8") return [close_status_code, reason] else: # Most likely reached this because len(close_frame_data.data) < 2 @@ -553,6 +660,6 @@ class WebSocketApp: callback(self, *args) except Exception as e: - _logging.error("error from callback {callback}: {err}".format(callback=callback, err=e)) + _logging.error(f"error from callback {callback}: {e}") if self.on_error: self.on_error(self, e) diff --git a/lib/websocket/_cookiejar.py b/lib/websocket/_cookiejar.py index 2047eddd..61079402 100644 --- a/lib/websocket/_cookiejar.py +++ b/lib/websocket/_cookiejar.py @@ -1,4 +1,5 @@ import http.cookies +from typing import Optional """ _cookiejar.py @@ -22,18 +23,21 @@ limitations under the License. class SimpleCookieJar: def __init__(self) -> None: - self.jar = dict() + self.jar: dict = dict() - def add(self, set_cookie: str) -> None: + def add(self, set_cookie: Optional[str]) -> None: if set_cookie: simpleCookie = http.cookies.SimpleCookie(set_cookie) for k, v in simpleCookie.items(): - domain = v.get("domain") - if domain: + if domain := v.get("domain"): if not domain.startswith("."): - domain = "." + domain - cookie = self.jar.get(domain) if self.jar.get(domain) else http.cookies.SimpleCookie() + domain = f".{domain}" + cookie = ( + self.jar.get(domain) + if self.jar.get(domain) + else http.cookies.SimpleCookie() + ) cookie.update(simpleCookie) self.jar[domain.lower()] = cookie @@ -42,10 +46,9 @@ class SimpleCookieJar: simpleCookie = http.cookies.SimpleCookie(set_cookie) for k, v in simpleCookie.items(): - domain = v.get("domain") - if domain: + if domain := v.get("domain"): if not domain.startswith("."): - domain = "." + domain + domain = f".{domain}" self.jar[domain.lower()] = simpleCookie def get(self, host: str) -> str: @@ -58,7 +61,15 @@ class SimpleCookieJar: if host.endswith(domain) or host == domain[1:]: cookies.append(self.jar.get(domain)) - return "; ".join(filter( - None, sorted( - ["%s=%s" % (k, v.value) for cookie in filter(None, cookies) for k, v in cookie.items()] - ))) + return "; ".join( + filter( + None, + sorted( + [ + "%s=%s" % (k, v.value) + for cookie in filter(None, cookies) + for k, v in cookie.items() + ] + ), + ) + ) diff --git a/lib/websocket/_core.py b/lib/websocket/_core.py index e81066ad..f28ca4b9 100644 --- a/lib/websocket/_core.py +++ b/lib/websocket/_core.py @@ -2,6 +2,7 @@ import socket import struct import threading import time +from typing import Optional, Union # websocket modules from ._abnf import * @@ -32,7 +33,7 @@ See the License for the specific language governing permissions and limitations under the License. """ -__all__ = ['WebSocket', 'create_connection'] +__all__ = ["WebSocket", "create_connection"] class WebSocket: @@ -73,9 +74,16 @@ class WebSocket: Skip utf8 validation. """ - def __init__(self, get_mask_key=None, sockopt=None, sslopt=None, - fire_cont_frame: bool = False, enable_multithread: bool = True, - skip_utf8_validation: bool = False, **_): + def __init__( + self, + get_mask_key=None, + sockopt=None, + sslopt=None, + fire_cont_frame: bool = False, + enable_multithread: bool = True, + skip_utf8_validation: bool = False, + **_, + ): """ Initialize WebSocket object. @@ -86,14 +94,13 @@ class WebSocket: """ self.sock_opt = sock_opt(sockopt, sslopt) self.handshake_response = None - self.sock = None + self.sock: Optional[socket.socket] = None self.connected = False self.get_mask_key = get_mask_key # These buffer over the build-up of a single frame. self.frame_buffer = frame_buffer(self._recv, skip_utf8_validation) - self.cont_frame = continuous_frame( - fire_cont_frame, skip_utf8_validation) + self.cont_frame = continuous_frame(fire_cont_frame, skip_utf8_validation) if enable_multithread: self.lock = threading.Lock() @@ -133,7 +140,7 @@ class WebSocket: """ self.get_mask_key = func - def gettimeout(self) -> float: + def gettimeout(self) -> Union[float, int, None]: """ Get the websocket timeout (in seconds) as an int or float @@ -144,7 +151,7 @@ class WebSocket: """ return self.sock_opt.timeout - def settimeout(self, timeout: float): + def settimeout(self, timeout: Union[float, int, None]): """ Set the timeout to the websocket. @@ -245,19 +252,26 @@ class WebSocket: socket: socket Pre-initialized stream socket. """ - self.sock_opt.timeout = options.get('timeout', self.sock_opt.timeout) - self.sock, addrs = connect(url, self.sock_opt, proxy_info(**options), - options.pop('socket', None)) + self.sock_opt.timeout = options.get("timeout", self.sock_opt.timeout) + self.sock, addrs = connect( + url, self.sock_opt, proxy_info(**options), options.pop("socket", None) + ) try: self.handshake_response = handshake(self.sock, url, *addrs, **options) - for attempt in range(options.pop('redirect_limit', 3)): + for attempt in range(options.pop("redirect_limit", 3)): if self.handshake_response.status in SUPPORTED_REDIRECT_STATUSES: - url = self.handshake_response.headers['location'] + url = self.handshake_response.headers["location"] self.sock.close() - self.sock, addrs = connect(url, self.sock_opt, proxy_info(**options), - options.pop('socket', None)) - self.handshake_response = handshake(self.sock, url, *addrs, **options) + self.sock, addrs = connect( + url, + self.sock_opt, + proxy_info(**options), + options.pop("socket", None), + ) + self.handshake_response = handshake( + self.sock, url, *addrs, **options + ) self.connected = True except: if self.sock: @@ -265,7 +279,7 @@ class WebSocket: self.sock = None raise - def send(self, payload: bytes or str, opcode: int = ABNF.OPCODE_TEXT) -> int: + def send(self, payload: Union[bytes, str], opcode: int = ABNF.OPCODE_TEXT) -> int: """ Send the data as string. @@ -282,6 +296,18 @@ class WebSocket: frame = ABNF.create_frame(payload, opcode) return self.send_frame(frame) + def send_text(self, text_data: str) -> int: + """ + Sends UTF-8 encoded text. + """ + return self.send(text_data, ABNF.OPCODE_TEXT) + + def send_bytes(self, data: Union[bytes, bytearray]) -> int: + """ + Sends a sequence of bytes. + """ + return self.send(data, ABNF.OPCODE_BINARY) + def send_frame(self, frame) -> int: """ Send the data frame. @@ -303,9 +329,9 @@ class WebSocket: frame.get_mask_key = self.get_mask_key data = frame.format() length = len(data) - if (isEnabledForTrace()): - trace("++Sent raw: " + repr(data)) - trace("++Sent decoded: " + frame.__str__()) + if isEnabledForTrace(): + trace(f"++Sent raw: {repr(data)}") + trace(f"++Sent decoded: {frame.__str__()}") with self.lock: while data: l = self._send(data) @@ -324,7 +350,7 @@ class WebSocket: """ return self.send(payload, ABNF.OPCODE_BINARY) - def ping(self, payload: str or bytes = ""): + def ping(self, payload: Union[str, bytes] = ""): """ Send ping data. @@ -337,7 +363,7 @@ class WebSocket: payload = payload.encode("utf-8") self.send(payload, ABNF.OPCODE_PING) - def pong(self, payload: str or bytes = ""): + def pong(self, payload: Union[str, bytes] = ""): """ Send pong data. @@ -350,7 +376,7 @@ class WebSocket: payload = payload.encode("utf-8") self.send(payload, ABNF.OPCODE_PONG) - def recv(self) -> str or bytes: + def recv(self) -> Union[str, bytes]: """ Receive string data(byte array) from the server. @@ -361,11 +387,16 @@ class WebSocket: with self.readlock: opcode, data = self.recv_data() if opcode == ABNF.OPCODE_TEXT: - return data.decode("utf-8") - elif opcode == ABNF.OPCODE_TEXT or opcode == ABNF.OPCODE_BINARY: - return data + data_received: Union[bytes, str] = data + if isinstance(data_received, bytes): + return data_received.decode("utf-8") + elif isinstance(data_received, str): + return data_received + elif opcode == ABNF.OPCODE_BINARY: + data_binary: bytes = data + return data_binary else: - return '' + return "" def recv_data(self, control_frame: bool = False) -> tuple: """ @@ -385,7 +416,7 @@ class WebSocket: opcode, frame = self.recv_data_frame(control_frame) return opcode, frame.data - def recv_data_frame(self, control_frame: bool = False): + def recv_data_frame(self, control_frame: bool = False) -> tuple: """ Receive data with operation code. @@ -404,15 +435,18 @@ class WebSocket: """ while True: frame = self.recv_frame() - if (isEnabledForTrace()): - trace("++Rcv raw: " + repr(frame.format())) - trace("++Rcv decoded: " + frame.__str__()) + if isEnabledForTrace(): + trace(f"++Rcv raw: {repr(frame.format())}") + trace(f"++Rcv decoded: {frame.__str__()}") if not frame: # handle error: # 'NoneType' object has no attribute 'opcode' - raise WebSocketProtocolException( - "Not a valid frame {frame}".format(frame=frame)) - elif frame.opcode in (ABNF.OPCODE_TEXT, ABNF.OPCODE_BINARY, ABNF.OPCODE_CONT): + raise WebSocketProtocolException(f"Not a valid frame {frame}") + elif frame.opcode in ( + ABNF.OPCODE_TEXT, + ABNF.OPCODE_BINARY, + ABNF.OPCODE_CONT, + ): self.cont_frame.validate(frame) self.cont_frame.add(frame) @@ -426,8 +460,7 @@ class WebSocket: if len(frame.data) < 126: self.pong(frame.data) else: - raise WebSocketProtocolException( - "Ping message is too long") + raise WebSocketProtocolException("Ping message is too long") if control_frame: return frame.opcode, frame elif frame.opcode == ABNF.OPCODE_PONG: @@ -458,9 +491,9 @@ class WebSocket: if status < 0 or status >= ABNF.LENGTH_16: raise ValueError("code is invalid range") self.connected = False - self.send(struct.pack('!H', status) + reason, ABNF.OPCODE_CLOSE) + self.send(struct.pack("!H", status) + reason, ABNF.OPCODE_CLOSE) - def close(self, status: int = STATUS_NORMAL, reason: bytes = b"", timeout: float = 3): + def close(self, status: int = STATUS_NORMAL, reason: bytes = b"", timeout: int = 3): """ Close Websocket object @@ -474,36 +507,37 @@ class WebSocket: Timeout until receive a close frame. If None, it will wait forever until receive a close frame. """ - if self.connected: - if status < 0 or status >= ABNF.LENGTH_16: - raise ValueError("code is invalid range") + if not self.connected: + return + if status < 0 or status >= ABNF.LENGTH_16: + raise ValueError("code is invalid range") - try: - self.connected = False - self.send(struct.pack('!H', status) + reason, ABNF.OPCODE_CLOSE) - sock_timeout = self.sock.gettimeout() - self.sock.settimeout(timeout) - start_time = time.time() - while timeout is None or time.time() - start_time < timeout: - try: - frame = self.recv_frame() - if frame.opcode != ABNF.OPCODE_CLOSE: - continue - if isEnabledForError(): - recv_status = struct.unpack("!H", frame.data[0:2])[0] - if recv_status >= 3000 and recv_status <= 4999: - debug("close status: " + repr(recv_status)) - elif recv_status != STATUS_NORMAL: - error("close status: " + repr(recv_status)) - break - except: - break - self.sock.settimeout(sock_timeout) - self.sock.shutdown(socket.SHUT_RDWR) - except: - pass + try: + self.connected = False + self.send(struct.pack("!H", status) + reason, ABNF.OPCODE_CLOSE) + sock_timeout = self.sock.gettimeout() + self.sock.settimeout(timeout) + start_time = time.time() + while timeout is None or time.time() - start_time < timeout: + try: + frame = self.recv_frame() + if frame.opcode != ABNF.OPCODE_CLOSE: + continue + if isEnabledForError(): + recv_status = struct.unpack("!H", frame.data[0:2])[0] + if recv_status >= 3000 and recv_status <= 4999: + debug(f"close status: {repr(recv_status)}") + elif recv_status != STATUS_NORMAL: + error(f"close status: {repr(recv_status)}") + break + except: + break + self.sock.settimeout(sock_timeout) + self.sock.shutdown(socket.SHUT_RDWR) + except: + pass - self.shutdown() + self.shutdown() def abort(self): """ @@ -521,7 +555,7 @@ class WebSocket: self.sock = None self.connected = False - def _send(self, data: str or bytes): + def _send(self, data: Union[str, bytes]): return send(self.sock, data) def _recv(self, bufsize): @@ -600,10 +634,14 @@ def create_connection(url: str, timeout=None, class_=WebSocket, **options): fire_cont_frame = options.pop("fire_cont_frame", False) enable_multithread = options.pop("enable_multithread", True) skip_utf8_validation = options.pop("skip_utf8_validation", False) - websock = class_(sockopt=sockopt, sslopt=sslopt, - fire_cont_frame=fire_cont_frame, - enable_multithread=enable_multithread, - skip_utf8_validation=skip_utf8_validation, **options) + websock = class_( + sockopt=sockopt, + sslopt=sslopt, + fire_cont_frame=fire_cont_frame, + enable_multithread=enable_multithread, + skip_utf8_validation=skip_utf8_validation, + **options, + ) websock.settimeout(timeout if timeout is not None else getdefaulttimeout()) websock.connect(url, **options) return websock diff --git a/lib/websocket/_exceptions.py b/lib/websocket/_exceptions.py index 48f40a07..c146fa5d 100644 --- a/lib/websocket/_exceptions.py +++ b/lib/websocket/_exceptions.py @@ -22,6 +22,7 @@ class WebSocketException(Exception): """ WebSocket exception class. """ + pass @@ -29,6 +30,7 @@ class WebSocketProtocolException(WebSocketException): """ If the WebSocket protocol is invalid, this exception will be raised. """ + pass @@ -36,6 +38,7 @@ class WebSocketPayloadException(WebSocketException): """ If the WebSocket payload is invalid, this exception will be raised. """ + pass @@ -44,6 +47,7 @@ class WebSocketConnectionClosedException(WebSocketException): If remote host closed the connection or some network error happened, this exception will be raised. """ + pass @@ -51,6 +55,7 @@ class WebSocketTimeoutException(WebSocketException): """ WebSocketTimeoutException will be raised at socket timeout during read/write data. """ + pass @@ -58,6 +63,7 @@ class WebSocketProxyException(WebSocketException): """ WebSocketProxyException will be raised when proxy error occurred. """ + pass @@ -66,7 +72,14 @@ class WebSocketBadStatusException(WebSocketException): WebSocketBadStatusException will be raised when we get bad handshake status code. """ - def __init__(self, message: str, status_code: int, status_message=None, resp_headers=None, resp_body=None): + def __init__( + self, + message: str, + status_code: int, + status_message=None, + resp_headers=None, + resp_body=None, + ): super().__init__(message) self.status_code = status_code self.resp_headers = resp_headers @@ -77,4 +90,5 @@ class WebSocketAddressException(WebSocketException): """ If the websocket address info cannot be found, this exception will be raised. """ + pass diff --git a/lib/websocket/_handshake.py b/lib/websocket/_handshake.py index d28aefd7..e63dc979 100644 --- a/lib/websocket/_handshake.py +++ b/lib/websocket/_handshake.py @@ -20,7 +20,8 @@ import hashlib import hmac import os from base64 import encodebytes as base64encode -from http import client as HTTPStatus +from http import HTTPStatus + from ._cookiejar import SimpleCookieJar from ._exceptions import * from ._http import * @@ -32,14 +33,19 @@ __all__ = ["handshake_response", "handshake", "SUPPORTED_REDIRECT_STATUSES"] # websocket supported version. VERSION = 13 -SUPPORTED_REDIRECT_STATUSES = (HTTPStatus.MOVED_PERMANENTLY, HTTPStatus.FOUND, HTTPStatus.SEE_OTHER,) +SUPPORTED_REDIRECT_STATUSES = ( + HTTPStatus.MOVED_PERMANENTLY, + HTTPStatus.FOUND, + HTTPStatus.SEE_OTHER, + HTTPStatus.TEMPORARY_REDIRECT, + HTTPStatus.PERMANENT_REDIRECT, +) SUCCESS_STATUSES = SUPPORTED_REDIRECT_STATUSES + (HTTPStatus.SWITCHING_PROTOCOLS,) CookieJar = SimpleCookieJar() class handshake_response: - def __init__(self, status: int, headers: dict, subprotocol): self.status = status self.headers = headers @@ -47,7 +53,9 @@ class handshake_response: CookieJar.add(headers.get("set-cookie")) -def handshake(sock, url: str, hostname: str, port: int, resource: str, **options): +def handshake( + sock, url: str, hostname: str, port: int, resource: str, **options +) -> handshake_response: headers, key = _get_handshake_headers(resource, url, hostname, port, options) header_str = "\r\n".join(headers) @@ -66,74 +74,64 @@ def handshake(sock, url: str, hostname: str, port: int, resource: str, **options def _pack_hostname(hostname: str) -> str: # IPv6 address - if ':' in hostname: - return '[' + hostname + ']' - + if ":" in hostname: + return f"[{hostname}]" return hostname -def _get_handshake_headers(resource: str, url: str, host: str, port: int, options: dict): - headers = [ - "GET {resource} HTTP/1.1".format(resource=resource), - "Upgrade: websocket" - ] - if port == 80 or port == 443: +def _get_handshake_headers( + resource: str, url: str, host: str, port: int, options: dict +) -> tuple: + headers = [f"GET {resource} HTTP/1.1", "Upgrade: websocket"] + if port in [80, 443]: hostport = _pack_hostname(host) else: - hostport = "{h}:{p}".format(h=_pack_hostname(host), p=port) + hostport = f"{_pack_hostname(host)}:{port}" if options.get("host"): - headers.append("Host: {h}".format(h=options["host"])) + headers.append(f'Host: {options["host"]}') else: - headers.append("Host: {hp}".format(hp=hostport)) + headers.append(f"Host: {hostport}") # scheme indicates whether http or https is used in Origin # The same approach is used in parse_url of _url.py to set default port scheme, url = url.split(":", 1) if not options.get("suppress_origin"): if "origin" in options and options["origin"] is not None: - headers.append("Origin: {origin}".format(origin=options["origin"])) + headers.append(f'Origin: {options["origin"]}') elif scheme == "wss": - headers.append("Origin: https://{hp}".format(hp=hostport)) + headers.append(f"Origin: https://{hostport}") else: - headers.append("Origin: http://{hp}".format(hp=hostport)) + headers.append(f"Origin: http://{hostport}") key = _create_sec_websocket_key() # Append Sec-WebSocket-Key & Sec-WebSocket-Version if not manually specified - if not options.get('header') or 'Sec-WebSocket-Key' not in options['header']: - headers.append("Sec-WebSocket-Key: {key}".format(key=key)) + if not options.get("header") or "Sec-WebSocket-Key" not in options["header"]: + headers.append(f"Sec-WebSocket-Key: {key}") else: - key = options['header']['Sec-WebSocket-Key'] + key = options["header"]["Sec-WebSocket-Key"] - if not options.get('header') or 'Sec-WebSocket-Version' not in options['header']: - headers.append("Sec-WebSocket-Version: {version}".format(version=VERSION)) + if not options.get("header") or "Sec-WebSocket-Version" not in options["header"]: + headers.append(f"Sec-WebSocket-Version: {VERSION}") - if not options.get('connection'): - headers.append('Connection: Upgrade') + if not options.get("connection"): + headers.append("Connection: Upgrade") else: - headers.append(options['connection']) + headers.append(options["connection"]) - subprotocols = options.get("subprotocols") - if subprotocols: - headers.append("Sec-WebSocket-Protocol: {protocols}".format(protocols=",".join(subprotocols))) + if subprotocols := options.get("subprotocols"): + headers.append(f'Sec-WebSocket-Protocol: {",".join(subprotocols)}') - header = options.get("header") - if header: + if header := options.get("header"): if isinstance(header, dict): - header = [ - ": ".join([k, v]) - for k, v in header.items() - if v is not None - ] + header = [": ".join([k, v]) for k, v in header.items() if v is not None] headers.extend(header) server_cookie = CookieJar.get(host) client_cookie = options.get("cookie", None) - cookie = "; ".join(filter(None, [server_cookie, client_cookie])) - - if cookie: - headers.append("Cookie: {cookie}".format(cookie=cookie)) + if cookie := "; ".join(filter(None, [server_cookie, client_cookie])): + headers.append(f"Cookie: {cookie}") headers.extend(("", "")) return headers, key @@ -142,12 +140,20 @@ def _get_handshake_headers(resource: str, url: str, host: str, port: int, option def _get_resp_headers(sock, success_statuses: tuple = SUCCESS_STATUSES) -> tuple: status, resp_headers, status_message = read_headers(sock) if status not in success_statuses: - content_len = resp_headers.get('content-length') + content_len = resp_headers.get("content-length") if content_len: - response_body = sock.recv(int(content_len)) # read the body of the HTTP error message response and include it in the exception + response_body = sock.recv( + int(content_len) + ) # read the body of the HTTP error message response and include it in the exception else: response_body = None - raise WebSocketBadStatusException("Handshake status {status} {message} -+-+- {headers} -+-+- {body}".format(status=status, message=status_message, headers=resp_headers, body=response_body), status, status_message, resp_headers, response_body) + raise WebSocketBadStatusException( + f"Handshake status {status} {status_message} -+-+- {resp_headers} -+-+- {response_body}", + status, + status_message, + resp_headers, + response_body, + ) return status, resp_headers @@ -157,20 +163,20 @@ _HEADERS_TO_CHECK = { } -def _validate(headers, key: str, subprotocols): +def _validate(headers, key: str, subprotocols) -> tuple: subproto = None for k, v in _HEADERS_TO_CHECK.items(): r = headers.get(k, None) if not r: return False, None - r = [x.strip().lower() for x in r.split(',')] + r = [x.strip().lower() for x in r.split(",")] if v not in r: return False, None if subprotocols: subproto = headers.get("sec-websocket-protocol", None) if not subproto or subproto.lower() not in [s.lower() for s in subprotocols]: - error("Invalid subprotocol: " + str(subprotocols)) + error(f"Invalid subprotocol: {subprotocols}") return False, None subproto = subproto.lower() @@ -180,13 +186,12 @@ def _validate(headers, key: str, subprotocols): result = result.lower() if isinstance(result, str): - result = result.encode('utf-8') + result = result.encode("utf-8") - value = (key + "258EAFA5-E914-47DA-95CA-C5AB0DC85B11").encode('utf-8') + value = f"{key}258EAFA5-E914-47DA-95CA-C5AB0DC85B11".encode("utf-8") hashed = base64encode(hashlib.sha1(value).digest()).strip().lower() - success = hmac.compare_digest(hashed, result) - if success: + if hmac.compare_digest(hashed, result): return True, subproto else: return False, None @@ -194,4 +199,4 @@ def _validate(headers, key: str, subprotocols): def _create_sec_websocket_key() -> str: randomness = os.urandom(16) - return base64encode(randomness).decode('utf-8').strip() + return base64encode(randomness).decode("utf-8").strip() diff --git a/lib/websocket/_http.py b/lib/websocket/_http.py index 13183b20..977a30f1 100644 --- a/lib/websocket/_http.py +++ b/lib/websocket/_http.py @@ -19,6 +19,7 @@ limitations under the License. import errno import os import socket +from base64 import encodebytes as base64encode from ._exceptions import * from ._logging import * @@ -26,14 +27,13 @@ from ._socket import * from ._ssl_compat import * from ._url import * -from base64 import encodebytes as base64encode - __all__ = ["proxy_info", "connect", "read_headers"] try: - from python_socks.sync import Proxy from python_socks._errors import * from python_socks._types import ProxyType + from python_socks.sync import Proxy + HAVE_PYTHON_SOCKS = True except: HAVE_PYTHON_SOCKS = False @@ -49,7 +49,6 @@ except: class proxy_info: - def __init__(self, **options): self.proxy_host = options.get("http_proxy_host", None) if self.proxy_host: @@ -59,8 +58,16 @@ class proxy_info: self.proxy_protocol = options.get("proxy_type", "http") # Note: If timeout not specified, default python-socks timeout is 60 seconds self.proxy_timeout = options.get("http_proxy_timeout", None) - if self.proxy_protocol not in ['http', 'socks4', 'socks4a', 'socks5', 'socks5h']: - raise ProxyError("Only http, socks4, socks5 proxy protocols are supported") + if self.proxy_protocol not in [ + "http", + "socks4", + "socks4a", + "socks5", + "socks5h", + ]: + raise ProxyError( + "Only http, socks4, socks5 proxy protocols are supported" + ) else: self.proxy_port = 0 self.auth = None @@ -68,25 +75,28 @@ class proxy_info: self.proxy_protocol = "http" -def _start_proxied_socket(url: str, options, proxy): +def _start_proxied_socket(url: str, options, proxy) -> tuple: if not HAVE_PYTHON_SOCKS: - raise WebSocketException("Python Socks is needed for SOCKS proxying but is not available") + raise WebSocketException( + "Python Socks is needed for SOCKS proxying but is not available" + ) hostname, port, resource, is_secure = parse_url(url) - if proxy.proxy_protocol == "socks5": - rdns = False - proxy_type = ProxyType.SOCKS5 if proxy.proxy_protocol == "socks4": rdns = False proxy_type = ProxyType.SOCKS4 - # socks5h and socks4a send DNS through proxy - if proxy.proxy_protocol == "socks5h": - rdns = True - proxy_type = ProxyType.SOCKS5 - if proxy.proxy_protocol == "socks4a": + # socks4a sends DNS through proxy + elif proxy.proxy_protocol == "socks4a": rdns = True proxy_type = ProxyType.SOCKS4 + elif proxy.proxy_protocol == "socks5": + rdns = False + proxy_type = ProxyType.SOCKS5 + # socks5h sends DNS through proxy + elif proxy.proxy_protocol == "socks5h": + rdns = True + proxy_type = ProxyType.SOCKS5 ws_proxy = Proxy.create( proxy_type=proxy_type, @@ -94,14 +104,16 @@ def _start_proxied_socket(url: str, options, proxy): port=int(proxy.proxy_port), username=proxy.auth[0] if proxy.auth else None, password=proxy.auth[1] if proxy.auth else None, - rdns=rdns) + rdns=rdns, + ) sock = ws_proxy.connect(hostname, port, timeout=proxy.proxy_timeout) - if is_secure and HAVE_SSL: - sock = _ssl_socket(sock, options.sslopt, hostname) - elif is_secure: - raise WebSocketException("SSL not available.") + if is_secure: + if HAVE_SSL: + sock = _ssl_socket(sock, options.sslopt, hostname) + else: + raise WebSocketException("SSL not available.") return sock, (hostname, port, resource) @@ -110,7 +122,7 @@ def connect(url: str, options, proxy, socket): # Use _start_proxied_socket() only for socks4 or socks5 proxy # Use _tunnel() for http proxy # TODO: Use python-socks for http protocol also, to standardize flow - if proxy.proxy_host and not socket and not (proxy.proxy_protocol == "http"): + if proxy.proxy_host and not socket and proxy.proxy_protocol != "http": return _start_proxied_socket(url, options, proxy) hostname, port_from_url, resource, is_secure = parse_url(url) @@ -119,10 +131,10 @@ def connect(url: str, options, proxy, socket): return socket, (hostname, port_from_url, resource) addrinfo_list, need_tunnel, auth = _get_addrinfo_list( - hostname, port_from_url, is_secure, proxy) + hostname, port_from_url, is_secure, proxy + ) if not addrinfo_list: - raise WebSocketException( - "Host not found.: " + hostname + ":" + str(port_from_url)) + raise WebSocketException(f"Host not found.: {hostname}:{port_from_url}") sock = None try: @@ -143,16 +155,23 @@ def connect(url: str, options, proxy, socket): raise -def _get_addrinfo_list(hostname, port, is_secure, proxy): +def _get_addrinfo_list(hostname, port: int, is_secure: bool, proxy) -> tuple: phost, pport, pauth = get_proxy_info( - hostname, is_secure, proxy.proxy_host, proxy.proxy_port, proxy.auth, proxy.no_proxy) + hostname, + is_secure, + proxy.proxy_host, + proxy.proxy_port, + proxy.auth, + proxy.no_proxy, + ) try: # when running on windows 10, getaddrinfo without socktype returns a socktype 0. # This generates an error exception: `_on_error: exception Socket type must be stream or datagram, not 0` # or `OSError: [Errno 22] Invalid argument` when creating socket. Force the socket type to SOCK_STREAM. if not phost: addrinfo_list = socket.getaddrinfo( - hostname, port, 0, socket.SOCK_STREAM, socket.SOL_TCP) + hostname, port, 0, socket.SOCK_STREAM, socket.SOL_TCP + ) return addrinfo_list, False, None else: pport = pport and pport or 80 @@ -160,7 +179,9 @@ def _get_addrinfo_list(hostname, port, is_secure, proxy): # returns a socktype 0. This generates an error exception: # _on_error: exception Socket type must be stream or datagram, not 0 # Force the socket type to SOCK_STREAM - addrinfo_list = socket.getaddrinfo(phost, pport, 0, socket.SOCK_STREAM, socket.SOL_TCP) + addrinfo_list = socket.getaddrinfo( + phost, pport, 0, socket.SOCK_STREAM, socket.SOL_TCP + ) return addrinfo_list, True, pauth except socket.gaierror as e: raise WebSocketAddressException(e) @@ -186,14 +207,17 @@ def _open_socket(addrinfo_list, sockopt, timeout): sock.close() error.remote_ip = str(address[0]) try: - eConnRefused = (errno.ECONNREFUSED, errno.WSAECONNREFUSED, errno.ENETUNREACH) + eConnRefused = ( + errno.ECONNREFUSED, + errno.WSAECONNREFUSED, + errno.ENETUNREACH, + ) except AttributeError: eConnRefused = (errno.ECONNREFUSED, errno.ENETUNREACH) - if error.errno in eConnRefused: - err = error - continue - else: + if error.errno not in eConnRefused: raise error + err = error + continue else: break else: @@ -206,89 +230,97 @@ def _open_socket(addrinfo_list, sockopt, timeout): return sock -def _wrap_sni_socket(sock, sslopt, hostname, check_hostname): - context = sslopt.get('context', None) +def _wrap_sni_socket(sock: socket.socket, sslopt: dict, hostname, check_hostname): + context = sslopt.get("context", None) if not context: - context = ssl.SSLContext(sslopt.get('ssl_version', ssl.PROTOCOL_TLS_CLIENT)) + context = ssl.SSLContext(sslopt.get("ssl_version", ssl.PROTOCOL_TLS_CLIENT)) # Non default context need to manually enable SSLKEYLOGFILE support by setting the keylog_filename attribute. # For more details see also: # * https://docs.python.org/3.8/library/ssl.html?highlight=sslkeylogfile#context-creation # * https://docs.python.org/3.8/library/ssl.html?highlight=sslkeylogfile#ssl.SSLContext.keylog_filename context.keylog_filename = os.environ.get("SSLKEYLOGFILE", None) - if sslopt.get('cert_reqs', ssl.CERT_NONE) != ssl.CERT_NONE: - cafile = sslopt.get('ca_certs', None) - capath = sslopt.get('ca_cert_path', None) + if sslopt.get("cert_reqs", ssl.CERT_NONE) != ssl.CERT_NONE: + cafile = sslopt.get("ca_certs", None) + capath = sslopt.get("ca_cert_path", None) if cafile or capath: context.load_verify_locations(cafile=cafile, capath=capath) - elif hasattr(context, 'load_default_certs'): + elif hasattr(context, "load_default_certs"): context.load_default_certs(ssl.Purpose.SERVER_AUTH) - if sslopt.get('certfile', None): + if sslopt.get("certfile", None): context.load_cert_chain( - sslopt['certfile'], - sslopt.get('keyfile', None), - sslopt.get('password', None), + sslopt["certfile"], + sslopt.get("keyfile", None), + sslopt.get("password", None), ) # Python 3.10 switch to PROTOCOL_TLS_CLIENT defaults to "cert_reqs = ssl.CERT_REQUIRED" and "check_hostname = True" # If both disabled, set check_hostname before verify_mode # see https://github.com/liris/websocket-client/commit/b96a2e8fa765753e82eea531adb19716b52ca3ca#commitcomment-10803153 - if sslopt.get('cert_reqs', ssl.CERT_NONE) == ssl.CERT_NONE and not sslopt.get('check_hostname', False): + if sslopt.get("cert_reqs", ssl.CERT_NONE) == ssl.CERT_NONE and not sslopt.get( + "check_hostname", False + ): context.check_hostname = False context.verify_mode = ssl.CERT_NONE else: - context.check_hostname = sslopt.get('check_hostname', True) - context.verify_mode = sslopt.get('cert_reqs', ssl.CERT_REQUIRED) + context.check_hostname = sslopt.get("check_hostname", True) + context.verify_mode = sslopt.get("cert_reqs", ssl.CERT_REQUIRED) - if 'ciphers' in sslopt: - context.set_ciphers(sslopt['ciphers']) - if 'cert_chain' in sslopt: - certfile, keyfile, password = sslopt['cert_chain'] + if "ciphers" in sslopt: + context.set_ciphers(sslopt["ciphers"]) + if "cert_chain" in sslopt: + certfile, keyfile, password = sslopt["cert_chain"] context.load_cert_chain(certfile, keyfile, password) - if 'ecdh_curve' in sslopt: - context.set_ecdh_curve(sslopt['ecdh_curve']) + if "ecdh_curve" in sslopt: + context.set_ecdh_curve(sslopt["ecdh_curve"]) return context.wrap_socket( sock, - do_handshake_on_connect=sslopt.get('do_handshake_on_connect', True), - suppress_ragged_eofs=sslopt.get('suppress_ragged_eofs', True), + do_handshake_on_connect=sslopt.get("do_handshake_on_connect", True), + suppress_ragged_eofs=sslopt.get("suppress_ragged_eofs", True), server_hostname=hostname, ) -def _ssl_socket(sock, user_sslopt, hostname): - sslopt = dict(cert_reqs=ssl.CERT_REQUIRED) +def _ssl_socket(sock: socket.socket, user_sslopt: dict, hostname): + sslopt: dict = dict(cert_reqs=ssl.CERT_REQUIRED) sslopt.update(user_sslopt) - certPath = os.environ.get('WEBSOCKET_CLIENT_CA_BUNDLE') - if certPath and os.path.isfile(certPath) \ - and user_sslopt.get('ca_certs', None) is None: - sslopt['ca_certs'] = certPath - elif certPath and os.path.isdir(certPath) \ - and user_sslopt.get('ca_cert_path', None) is None: - sslopt['ca_cert_path'] = certPath + certPath = os.environ.get("WEBSOCKET_CLIENT_CA_BUNDLE") + if ( + certPath + and os.path.isfile(certPath) + and user_sslopt.get("ca_certs", None) is None + ): + sslopt["ca_certs"] = certPath + elif ( + certPath + and os.path.isdir(certPath) + and user_sslopt.get("ca_cert_path", None) is None + ): + sslopt["ca_cert_path"] = certPath - if sslopt.get('server_hostname', None): - hostname = sslopt['server_hostname'] + if sslopt.get("server_hostname", None): + hostname = sslopt["server_hostname"] - check_hostname = sslopt.get('check_hostname', True) + check_hostname = sslopt.get("check_hostname", True) sock = _wrap_sni_socket(sock, sslopt, hostname, check_hostname) return sock -def _tunnel(sock, host, port, auth): +def _tunnel(sock: socket.socket, host, port: int, auth) -> socket.socket: debug("Connecting proxy...") - connect_header = "CONNECT {h}:{p} HTTP/1.1\r\n".format(h=host, p=port) - connect_header += "Host: {h}:{p}\r\n".format(h=host, p=port) + connect_header = f"CONNECT {host}:{port} HTTP/1.1\r\n" + connect_header += f"Host: {host}:{port}\r\n" # TODO: support digest auth. if auth and auth[0]: auth_str = auth[0] if auth[1]: - auth_str += ":" + auth[1] - encoded_str = base64encode(auth_str.encode()).strip().decode().replace('\n', '') - connect_header += "Proxy-Authorization: Basic {str}\r\n".format(str=encoded_str) + auth_str += f":{auth[1]}" + encoded_str = base64encode(auth_str.encode()).strip().decode().replace("\n", "") + connect_header += f"Proxy-Authorization: Basic {encoded_str}\r\n" connect_header += "\r\n" dump("request header", connect_header) @@ -300,40 +332,37 @@ def _tunnel(sock, host, port, auth): raise WebSocketProxyException(str(e)) if status != 200: - raise WebSocketProxyException( - "failed CONNECT via proxy status: {status}".format(status=status)) + raise WebSocketProxyException(f"failed CONNECT via proxy status: {status}") return sock -def read_headers(sock): +def read_headers(sock: socket.socket) -> tuple: status = None status_message = None - headers = {} + headers: dict = {} trace("--- response header ---") while True: line = recv_line(sock) - line = line.decode('utf-8').strip() + line = line.decode("utf-8").strip() if not line: break trace(line) if not status: - status_info = line.split(" ", 2) status = int(status_info[1]) if len(status_info) > 2: status_message = status_info[2] else: kv = line.split(":", 1) - if len(kv) == 2: - key, value = kv - if key.lower() == "set-cookie" and headers.get("set-cookie"): - headers["set-cookie"] = headers.get("set-cookie") + "; " + value.strip() - else: - headers[key.lower()] = value.strip() - else: + if len(kv) != 2: raise WebSocketException("Invalid header") + key, value = kv + if key.lower() == "set-cookie" and headers.get("set-cookie"): + headers["set-cookie"] = headers.get("set-cookie") + "; " + value.strip() + else: + headers[key.lower()] = value.strip() trace("-----------------------") diff --git a/lib/websocket/_logging.py b/lib/websocket/_logging.py index 806de4d4..b88cda37 100644 --- a/lib/websocket/_logging.py +++ b/lib/websocket/_logging.py @@ -19,25 +19,38 @@ See the License for the specific language governing permissions and limitations under the License. """ -_logger = logging.getLogger('websocket') +_logger = logging.getLogger("websocket") try: from logging import NullHandler except ImportError: + class NullHandler(logging.Handler): def emit(self, record) -> None: pass + _logger.addHandler(NullHandler()) _traceEnabled = False -__all__ = ["enableTrace", "dump", "error", "warning", "debug", "trace", - "isEnabledForError", "isEnabledForDebug", "isEnabledForTrace"] +__all__ = [ + "enableTrace", + "dump", + "error", + "warning", + "debug", + "trace", + "isEnabledForError", + "isEnabledForDebug", + "isEnabledForTrace", +] -def enableTrace(traceable: bool, - handler: logging.StreamHandler = logging.StreamHandler(), - level: str = "DEBUG") -> None: +def enableTrace( + traceable: bool, + handler: logging.StreamHandler = logging.StreamHandler(), + level: str = "DEBUG", +) -> None: """ Turn on/off the traceability. @@ -55,7 +68,7 @@ def enableTrace(traceable: bool, def dump(title: str, message: str) -> None: if _traceEnabled: - _logger.debug("--- " + title + " ---") + _logger.debug(f"--- {title} ---") _logger.debug(message) _logger.debug("-----------------------") diff --git a/lib/websocket/_socket.py b/lib/websocket/_socket.py index e8858fc8..f0ad27a5 100644 --- a/lib/websocket/_socket.py +++ b/lib/websocket/_socket.py @@ -1,6 +1,7 @@ import errno import selectors import socket +from typing import Union from ._exceptions import * from ._ssl_compat import * @@ -37,12 +38,18 @@ if hasattr(socket, "TCP_KEEPCNT"): _default_timeout = None -__all__ = ["DEFAULT_SOCKET_OPTION", "sock_opt", "setdefaulttimeout", "getdefaulttimeout", - "recv", "recv_line", "send"] +__all__ = [ + "DEFAULT_SOCKET_OPTION", + "sock_opt", + "setdefaulttimeout", + "getdefaulttimeout", + "recv", + "recv_line", + "send", +] class sock_opt: - def __init__(self, sockopt: list, sslopt: dict) -> None: if sockopt is None: sockopt = [] @@ -53,7 +60,7 @@ class sock_opt: self.timeout = None -def setdefaulttimeout(timeout: int or float) -> None: +def setdefaulttimeout(timeout: Union[int, float, None]) -> None: """ Set the global timeout setting to connect. @@ -66,7 +73,7 @@ def setdefaulttimeout(timeout: int or float) -> None: _default_timeout = timeout -def getdefaulttimeout() -> int or float: +def getdefaulttimeout() -> Union[int, float, None]: """ Get default timeout @@ -89,7 +96,7 @@ def recv(sock: socket.socket, bufsize: int) -> bytes: pass except socket.error as exc: error_code = extract_error_code(exc) - if error_code != errno.EAGAIN and error_code != errno.EWOULDBLOCK: + if error_code not in [errno.EAGAIN, errno.EWOULDBLOCK]: raise sel = selectors.DefaultSelector() @@ -113,14 +120,13 @@ def recv(sock: socket.socket, bufsize: int) -> bytes: raise WebSocketTimeoutException(message) except SSLError as e: message = extract_err_message(e) - if isinstance(message, str) and 'timed out' in message: + if isinstance(message, str) and "timed out" in message: raise WebSocketTimeoutException(message) else: raise if not bytes_: - raise WebSocketConnectionClosedException( - "Connection to remote host was lost.") + raise WebSocketConnectionClosedException("Connection to remote host was lost.") return bytes_ @@ -130,14 +136,14 @@ def recv_line(sock: socket.socket) -> bytes: while True: c = recv(sock, 1) line.append(c) - if c == b'\n': + if c == b"\n": break - return b''.join(line) + return b"".join(line) -def send(sock: socket.socket, data: bytes) -> int: +def send(sock: socket.socket, data: Union[bytes, str]) -> int: if isinstance(data, str): - data = data.encode('utf-8') + data = data.encode("utf-8") if not sock: raise WebSocketConnectionClosedException("socket is already closed.") @@ -151,7 +157,7 @@ def send(sock: socket.socket, data: bytes) -> int: error_code = extract_error_code(exc) if error_code is None: raise - if error_code != errno.EAGAIN and error_code != errno.EWOULDBLOCK: + if error_code not in [errno.EAGAIN, errno.EWOULDBLOCK]: raise sel = selectors.DefaultSelector() diff --git a/lib/websocket/_ssl_compat.py b/lib/websocket/_ssl_compat.py index b2eba387..029a5c6e 100644 --- a/lib/websocket/_ssl_compat.py +++ b/lib/websocket/_ssl_compat.py @@ -20,9 +20,8 @@ __all__ = ["HAVE_SSL", "ssl", "SSLError", "SSLWantReadError", "SSLWantWriteError try: import ssl - from ssl import SSLError - from ssl import SSLWantReadError - from ssl import SSLWantWriteError + from ssl import SSLError, SSLWantReadError, SSLWantWriteError + HAVE_SSL = True except ImportError: # dummy class of SSLError for environment without ssl support diff --git a/lib/websocket/_url.py b/lib/websocket/_url.py index 2141b021..7d53830e 100644 --- a/lib/websocket/_url.py +++ b/lib/websocket/_url.py @@ -1,7 +1,7 @@ import os import socket import struct - +from typing import Optional from urllib.parse import unquote, urlparse """ @@ -67,7 +67,7 @@ def parse_url(url: str) -> tuple: resource = "/" if parsed.query: - resource += "?" + parsed.query + resource += f"?{parsed.query}" return hostname, port, resource, is_secure @@ -93,37 +93,50 @@ def _is_subnet_address(hostname: str) -> bool: def _is_address_in_network(ip: str, net: str) -> bool: - ipaddr = struct.unpack('!I', socket.inet_aton(ip))[0] - netaddr, netmask = net.split('/') - netaddr = struct.unpack('!I', socket.inet_aton(netaddr))[0] + ipaddr: int = struct.unpack("!I", socket.inet_aton(ip))[0] + netaddr, netmask = net.split("/") + netaddr: int = struct.unpack("!I", socket.inet_aton(netaddr))[0] netmask = (0xFFFFFFFF << (32 - int(netmask))) & 0xFFFFFFFF return ipaddr & netmask == netaddr -def _is_no_proxy_host(hostname: str, no_proxy: list) -> bool: +def _is_no_proxy_host(hostname: str, no_proxy: Optional[list]) -> bool: if not no_proxy: - v = os.environ.get("no_proxy", os.environ.get("NO_PROXY", "")).replace(" ", "") - if v: + if v := os.environ.get("no_proxy", os.environ.get("NO_PROXY", "")).replace( + " ", "" + ): no_proxy = v.split(",") if not no_proxy: no_proxy = DEFAULT_NO_PROXY_HOST - if '*' in no_proxy: + if "*" in no_proxy: return True if hostname in no_proxy: return True if _is_ip_address(hostname): - return any([_is_address_in_network(hostname, subnet) for subnet in no_proxy if _is_subnet_address(subnet)]) - for domain in [domain for domain in no_proxy if domain.startswith('.')]: + return any( + [ + _is_address_in_network(hostname, subnet) + for subnet in no_proxy + if _is_subnet_address(subnet) + ] + ) + for domain in [domain for domain in no_proxy if domain.startswith(".")]: if hostname.endswith(domain): return True return False def get_proxy_info( - hostname: str, is_secure: bool, proxy_host: str = None, proxy_port: int = 0, proxy_auth: tuple = None, - no_proxy: list = None, proxy_type: str = 'http') -> tuple: + hostname: str, + is_secure: bool, + proxy_host: Optional[str] = None, + proxy_port: int = 0, + proxy_auth: Optional[tuple] = None, + no_proxy: Optional[list] = None, + proxy_type: str = "http", +) -> tuple: """ Try to retrieve proxy host and port from environment if not provided in options. @@ -159,10 +172,16 @@ def get_proxy_info( return proxy_host, port, auth env_key = "https_proxy" if is_secure else "http_proxy" - value = os.environ.get(env_key, os.environ.get(env_key.upper(), "")).replace(" ", "") + value = os.environ.get(env_key, os.environ.get(env_key.upper(), "")).replace( + " ", "" + ) if value: proxy = urlparse(value) - auth = (unquote(proxy.username), unquote(proxy.password)) if proxy.username else None + auth = ( + (unquote(proxy.username), unquote(proxy.password)) + if proxy.username + else None + ) return proxy.hostname, proxy.port, auth return None, 0, None diff --git a/lib/websocket/_utils.py b/lib/websocket/_utils.py index 3db2d83b..c63adfa5 100644 --- a/lib/websocket/_utils.py +++ b/lib/websocket/_utils.py @@ -1,3 +1,5 @@ +from typing import Union + """ _url.py websocket - WebSocket client library for Python @@ -20,7 +22,6 @@ __all__ = ["NoLock", "validate_utf8", "extract_err_message", "extract_error_code class NoLock: - def __enter__(self) -> None: pass @@ -33,8 +34,9 @@ try: # strings. from wsaccel.utf8validator import Utf8Validator - def _validate_utf8(utfbytes: bytes) -> bool: - return Utf8Validator().validate(utfbytes)[0] + def _validate_utf8(utfbytes: Union[str, bytes]) -> bool: + result: bool = Utf8Validator().validate(utfbytes)[0] + return result except ImportError: # UTF-8 validator @@ -46,44 +48,396 @@ except ImportError: _UTF8D = [ # The first part of the table maps bytes to character classes that # to reduce the size of the transition table and create bitmasks. - 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, - 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, - 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, - 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, - 1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, - 7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7, 7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7, - 8,8,2,2,2,2,2,2,2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2, - 10,3,3,3,3,3,3,3,3,3,3,3,3,4,3,3, 11,6,6,6,5,8,8,8,8,8,8,8,8,8,8,8, - + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 1, + 1, + 1, + 1, + 1, + 1, + 1, + 1, + 1, + 1, + 1, + 1, + 1, + 1, + 1, + 1, + 9, + 9, + 9, + 9, + 9, + 9, + 9, + 9, + 9, + 9, + 9, + 9, + 9, + 9, + 9, + 9, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 7, + 8, + 8, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 10, + 3, + 3, + 3, + 3, + 3, + 3, + 3, + 3, + 3, + 3, + 3, + 3, + 4, + 3, + 3, + 11, + 6, + 6, + 6, + 5, + 8, + 8, + 8, + 8, + 8, + 8, + 8, + 8, + 8, + 8, + 8, # The second part is a transition table that maps a combination # of a state of the automaton and a character class to a state. - 0,12,24,36,60,96,84,12,12,12,48,72, 12,12,12,12,12,12,12,12,12,12,12,12, - 12, 0,12,12,12,12,12, 0,12, 0,12,12, 12,24,12,12,12,12,12,24,12,24,12,12, - 12,12,12,12,12,12,12,24,12,12,12,12, 12,24,12,12,12,12,12,12,12,24,12,12, - 12,12,12,12,12,12,12,36,12,36,12,12, 12,36,12,12,12,12,12,36,12,36,12,12, - 12,36,12,12,12,12,12,12,12,12,12,12, ] + 0, + 12, + 24, + 36, + 60, + 96, + 84, + 12, + 12, + 12, + 48, + 72, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 0, + 12, + 12, + 12, + 12, + 12, + 0, + 12, + 0, + 12, + 12, + 12, + 24, + 12, + 12, + 12, + 12, + 12, + 24, + 12, + 24, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 24, + 12, + 12, + 12, + 12, + 12, + 24, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 24, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 36, + 12, + 36, + 12, + 12, + 12, + 36, + 12, + 12, + 12, + 12, + 12, + 36, + 12, + 36, + 12, + 12, + 12, + 36, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + 12, + ] def _decode(state: int, codep: int, ch: int) -> tuple: tp = _UTF8D[ch] - codep = (ch & 0x3f) | (codep << 6) if ( - state != _UTF8_ACCEPT) else (0xff >> tp) & ch + codep = ( + (ch & 0x3F) | (codep << 6) if (state != _UTF8_ACCEPT) else (0xFF >> tp) & ch + ) state = _UTF8D[256 + state + tp] return state, codep - def _validate_utf8(utfbytes: str or bytes) -> bool: + def _validate_utf8(utfbytes: Union[str, bytes]) -> bool: state = _UTF8_ACCEPT codep = 0 for i in utfbytes: - state, codep = _decode(state, codep, i) + state, codep = _decode(state, codep, int(i)) if state == _UTF8_REJECT: return False return True -def validate_utf8(utfbytes: str or bytes) -> bool: +def validate_utf8(utfbytes: Union[str, bytes]) -> bool: """ validate utf8 byte string. utfbytes: utf byte string to check. @@ -92,13 +446,14 @@ def validate_utf8(utfbytes: str or bytes) -> bool: return _validate_utf8(utfbytes) -def extract_err_message(exception: Exception) -> str or None: +def extract_err_message(exception: Exception) -> Union[str, None]: if exception.args: - return exception.args[0] + exception_message: str = exception.args[0] + return exception_message else: return None -def extract_error_code(exception: Exception) -> int or None: +def extract_error_code(exception: Exception) -> Union[int, None]: if exception.args and len(exception.args) > 1: return exception.args[0] if isinstance(exception.args[0], int) else None diff --git a/lib/websocket/_wsdump.py b/lib/websocket/_wsdump.py index d637ce2b..34c3d127 100644 --- a/lib/websocket/_wsdump.py +++ b/lib/websocket/_wsdump.py @@ -21,11 +21,11 @@ limitations under the License. import argparse import code +import gzip +import ssl import sys import threading import time -import ssl -import gzip import zlib from urllib.parse import urlparse @@ -50,8 +50,13 @@ ENCODING = get_encoding() class VAction(argparse.Action): - - def __call__(self, parser: argparse.Namespace, args: tuple, values: str, option_string: str = None) -> None: + def __call__( + self, + parser: argparse.Namespace, + args: tuple, + values: str, + option_string: str = None, + ) -> None: if values is None: values = "1" try: @@ -63,36 +68,42 @@ class VAction(argparse.Action): def parse_args() -> argparse.Namespace: parser = argparse.ArgumentParser(description="WebSocket Simple Dump Tool") - parser.add_argument("url", metavar="ws_url", - help="websocket url. ex. ws://echo.websocket.events/") - parser.add_argument("-p", "--proxy", - help="proxy url. ex. http://127.0.0.1:8080") - parser.add_argument("-v", "--verbose", default=0, nargs='?', action=VAction, - dest="verbose", - help="set verbose mode. If set to 1, show opcode. " - "If set to 2, enable to trace websocket module") - parser.add_argument("-n", "--nocert", action='store_true', - help="Ignore invalid SSL cert") - parser.add_argument("-r", "--raw", action="store_true", - help="raw output") - parser.add_argument("-s", "--subprotocols", nargs='*', - help="Set subprotocols") - parser.add_argument("-o", "--origin", - help="Set origin") - parser.add_argument("--eof-wait", default=0, type=int, - help="wait time(second) after 'EOF' received.") - parser.add_argument("-t", "--text", - help="Send initial text") - parser.add_argument("--timings", action="store_true", - help="Print timings in seconds") - parser.add_argument("--headers", - help="Set custom headers. Use ',' as separator") + parser.add_argument( + "url", metavar="ws_url", help="websocket url. ex. ws://echo.websocket.events/" + ) + parser.add_argument("-p", "--proxy", help="proxy url. ex. http://127.0.0.1:8080") + parser.add_argument( + "-v", + "--verbose", + default=0, + nargs="?", + action=VAction, + dest="verbose", + help="set verbose mode. If set to 1, show opcode. " + "If set to 2, enable to trace websocket module", + ) + parser.add_argument( + "-n", "--nocert", action="store_true", help="Ignore invalid SSL cert" + ) + parser.add_argument("-r", "--raw", action="store_true", help="raw output") + parser.add_argument("-s", "--subprotocols", nargs="*", help="Set subprotocols") + parser.add_argument("-o", "--origin", help="Set origin") + parser.add_argument( + "--eof-wait", + default=0, + type=int, + help="wait time(second) after 'EOF' received.", + ) + parser.add_argument("-t", "--text", help="Send initial text") + parser.add_argument( + "--timings", action="store_true", help="Print timings in seconds" + ) + parser.add_argument("--headers", help="Set custom headers. Use ',' as separator") return parser.parse_args() class RawInput: - def raw_input(self, prompt: str = "") -> str: line = input(prompt) @@ -105,7 +116,6 @@ class RawInput: class InteractiveConsole(RawInput, code.InteractiveConsole): - def write(self, data: str) -> None: sys.stdout.write("\033[2K\033[E") # sys.stdout.write("\n") @@ -118,7 +128,6 @@ class InteractiveConsole(RawInput, code.InteractiveConsole): class NonInteractive(RawInput): - def write(self, data: str) -> None: sys.stdout.write(data) sys.stdout.write("\n") @@ -146,7 +155,7 @@ def main() -> None: if args.nocert: opts = {"cert_reqs": ssl.CERT_NONE, "check_hostname": False} if args.headers: - options['header'] = list(map(str.strip, args.headers.split(','))) + options["header"] = list(map(str.strip, args.headers.split(","))) ws = websocket.create_connection(args.url, sslopt=opts, **options) if args.raw: console = NonInteractive() @@ -160,7 +169,7 @@ def main() -> None: except websocket.WebSocketException: return websocket.ABNF.OPCODE_CLOSE, "" if not frame: - raise websocket.WebSocketException("Not a valid frame {frame}".format(frame=frame)) + raise websocket.WebSocketException(f"Not a valid frame {frame}") elif frame.opcode in OPCODE_DATA: return frame.opcode, frame.data elif frame.opcode == websocket.ABNF.OPCODE_CLOSE: @@ -178,14 +187,18 @@ def main() -> None: msg = None if opcode == websocket.ABNF.OPCODE_TEXT and isinstance(data, bytes): data = str(data, "utf-8") - if isinstance(data, bytes) and len(data) > 2 and data[:2] == b'\037\213': # gzip magick + if ( + isinstance(data, bytes) and len(data) > 2 and data[:2] == b"\037\213" + ): # gzip magick try: data = "[gzip] " + str(gzip.decompress(data), "utf-8") except: pass elif isinstance(data, bytes): try: - data = "[zlib] " + str(zlib.decompress(data, -zlib.MAX_WBITS), "utf-8") + data = "[zlib] " + str( + zlib.decompress(data, -zlib.MAX_WBITS), "utf-8" + ) except: pass @@ -193,13 +206,13 @@ def main() -> None: data = repr(data) if args.verbose: - msg = "{opcode}: {data}".format(opcode=websocket.ABNF.OPCODE_MAP.get(opcode), data=data) + msg = f"{websocket.ABNF.OPCODE_MAP.get(opcode)}: {data}" else: msg = data if msg is not None: if args.timings: - console.write(str(time.time() - start_time) + ": " + msg) + console.write(f"{time.time() - start_time}: {msg}") else: console.write(msg) diff --git a/lib/websocket/py.typed b/lib/websocket/py.typed new file mode 100644 index 00000000..e69de29b diff --git a/lib/websocket/tests/echo-server.py b/lib/websocket/tests/echo-server.py index 42dd9e43..a32c6503 100644 --- a/lib/websocket/tests/echo-server.py +++ b/lib/websocket/tests/echo-server.py @@ -3,10 +3,11 @@ # From https://github.com/aaugustin/websockets/blob/main/example/echo.py import asyncio -import websockets import os -LOCAL_WS_SERVER_PORT = int(os.environ.get('LOCAL_WS_SERVER_PORT', '8765')) +import websockets + +LOCAL_WS_SERVER_PORT = int(os.environ.get("LOCAL_WS_SERVER_PORT", "8765")) async def echo(websocket, path): @@ -18,4 +19,5 @@ async def main(): async with websockets.serve(echo, "localhost", LOCAL_WS_SERVER_PORT): await asyncio.Future() # run forever + asyncio.run(main()) diff --git a/lib/websocket/tests/test_abnf.py b/lib/websocket/tests/test_abnf.py index dbf9b636..df5bc6bd 100644 --- a/lib/websocket/tests/test_abnf.py +++ b/lib/websocket/tests/test_abnf.py @@ -1,8 +1,9 @@ # -*- coding: utf-8 -*- # +import unittest + import websocket as ws from websocket._abnf import * -import unittest """ test_abnf.py @@ -25,54 +26,89 @@ limitations under the License. class ABNFTest(unittest.TestCase): - def testInit(self): - a = ABNF(0,0,0,0, opcode=ABNF.OPCODE_PING) + a = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_PING) self.assertEqual(a.fin, 0) self.assertEqual(a.rsv1, 0) self.assertEqual(a.rsv2, 0) self.assertEqual(a.rsv3, 0) self.assertEqual(a.opcode, 9) - self.assertEqual(a.data, '') - a_bad = ABNF(0,1,0,0, opcode=77) + self.assertEqual(a.data, "") + a_bad = ABNF(0, 1, 0, 0, opcode=77) self.assertEqual(a_bad.rsv1, 1) self.assertEqual(a_bad.opcode, 77) def testValidate(self): - a_invalid_ping = ABNF(0,0,0,0, opcode=ABNF.OPCODE_PING) - self.assertRaises(ws._exceptions.WebSocketProtocolException, a_invalid_ping.validate, skip_utf8_validation=False) - a_bad_rsv_value = ABNF(0,1,0,0, opcode=ABNF.OPCODE_TEXT) - self.assertRaises(ws._exceptions.WebSocketProtocolException, a_bad_rsv_value.validate, skip_utf8_validation=False) - a_bad_opcode = ABNF(0,0,0,0, opcode=77) - self.assertRaises(ws._exceptions.WebSocketProtocolException, a_bad_opcode.validate, skip_utf8_validation=False) - a_bad_close_frame = ABNF(0,0,0,0, opcode=ABNF.OPCODE_CLOSE, data=b'\x01') - self.assertRaises(ws._exceptions.WebSocketProtocolException, a_bad_close_frame.validate, skip_utf8_validation=False) - a_bad_close_frame_2 = ABNF(0,0,0,0, opcode=ABNF.OPCODE_CLOSE, data=b'\x01\x8a\xaa\xff\xdd') - self.assertRaises(ws._exceptions.WebSocketProtocolException, a_bad_close_frame_2.validate, skip_utf8_validation=False) - a_bad_close_frame_3 = ABNF(0,0,0,0, opcode=ABNF.OPCODE_CLOSE, data=b'\x03\xe7') - self.assertRaises(ws._exceptions.WebSocketProtocolException, a_bad_close_frame_3.validate, skip_utf8_validation=True) + a_invalid_ping = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_PING) + self.assertRaises( + ws._exceptions.WebSocketProtocolException, + a_invalid_ping.validate, + skip_utf8_validation=False, + ) + a_bad_rsv_value = ABNF(0, 1, 0, 0, opcode=ABNF.OPCODE_TEXT) + self.assertRaises( + ws._exceptions.WebSocketProtocolException, + a_bad_rsv_value.validate, + skip_utf8_validation=False, + ) + a_bad_opcode = ABNF(0, 0, 0, 0, opcode=77) + self.assertRaises( + ws._exceptions.WebSocketProtocolException, + a_bad_opcode.validate, + skip_utf8_validation=False, + ) + a_bad_close_frame = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_CLOSE, data=b"\x01") + self.assertRaises( + ws._exceptions.WebSocketProtocolException, + a_bad_close_frame.validate, + skip_utf8_validation=False, + ) + a_bad_close_frame_2 = ABNF( + 0, 0, 0, 0, opcode=ABNF.OPCODE_CLOSE, data=b"\x01\x8a\xaa\xff\xdd" + ) + self.assertRaises( + ws._exceptions.WebSocketProtocolException, + a_bad_close_frame_2.validate, + skip_utf8_validation=False, + ) + a_bad_close_frame_3 = ABNF( + 0, 0, 0, 0, opcode=ABNF.OPCODE_CLOSE, data=b"\x03\xe7" + ) + self.assertRaises( + ws._exceptions.WebSocketProtocolException, + a_bad_close_frame_3.validate, + skip_utf8_validation=True, + ) def testMask(self): - abnf_none_data = ABNF(0,0,0,0, opcode=ABNF.OPCODE_PING, mask=1, data=None) + abnf_none_data = ABNF( + 0, 0, 0, 0, opcode=ABNF.OPCODE_PING, mask_value=1, data=None + ) bytes_val = b"aaaa" self.assertEqual(abnf_none_data._get_masked(bytes_val), bytes_val) - abnf_str_data = ABNF(0,0,0,0, opcode=ABNF.OPCODE_PING, mask=1, data="a") - self.assertEqual(abnf_str_data._get_masked(bytes_val), b'aaaa\x00') + abnf_str_data = ABNF( + 0, 0, 0, 0, opcode=ABNF.OPCODE_PING, mask_value=1, data="a" + ) + self.assertEqual(abnf_str_data._get_masked(bytes_val), b"aaaa\x00") def testFormat(self): - abnf_bad_rsv_bits = ABNF(2,0,0,0, opcode=ABNF.OPCODE_TEXT) + abnf_bad_rsv_bits = ABNF(2, 0, 0, 0, opcode=ABNF.OPCODE_TEXT) self.assertRaises(ValueError, abnf_bad_rsv_bits.format) - abnf_bad_opcode = ABNF(0,0,0,0, opcode=5) + abnf_bad_opcode = ABNF(0, 0, 0, 0, opcode=5) self.assertRaises(ValueError, abnf_bad_opcode.format) - abnf_length_10 = ABNF(0,0,0,0, opcode=ABNF.OPCODE_TEXT, data="abcdefghij") - self.assertEqual(b'\x01', abnf_length_10.format()[0].to_bytes(1, 'big')) - self.assertEqual(b'\x8a', abnf_length_10.format()[1].to_bytes(1, 'big')) + abnf_length_10 = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_TEXT, data="abcdefghij") + self.assertEqual(b"\x01", abnf_length_10.format()[0].to_bytes(1, "big")) + self.assertEqual(b"\x8a", abnf_length_10.format()[1].to_bytes(1, "big")) self.assertEqual("fin=0 opcode=1 data=abcdefghij", abnf_length_10.__str__()) - abnf_length_20 = ABNF(0,0,0,0, opcode=ABNF.OPCODE_BINARY, data="abcdefghijabcdefghij") - self.assertEqual(b'\x02', abnf_length_20.format()[0].to_bytes(1, 'big')) - self.assertEqual(b'\x94', abnf_length_20.format()[1].to_bytes(1, 'big')) - abnf_no_mask = ABNF(0,0,0,0, opcode=ABNF.OPCODE_TEXT, mask=0, data=b'\x01\x8a\xcc') - self.assertEqual(b'\x01\x03\x01\x8a\xcc', abnf_no_mask.format()) + abnf_length_20 = ABNF( + 0, 0, 0, 0, opcode=ABNF.OPCODE_BINARY, data="abcdefghijabcdefghij" + ) + self.assertEqual(b"\x02", abnf_length_20.format()[0].to_bytes(1, "big")) + self.assertEqual(b"\x94", abnf_length_20.format()[1].to_bytes(1, "big")) + abnf_no_mask = ABNF( + 0, 0, 0, 0, opcode=ABNF.OPCODE_TEXT, mask_value=0, data=b"\x01\x8a\xcc" + ) + self.assertEqual(b"\x01\x03\x01\x8a\xcc", abnf_no_mask.format()) def testFrameBuffer(self): fb = frame_buffer(0, True) @@ -81,7 +117,7 @@ class ABNFTest(unittest.TestCase): fb.clear self.assertEqual(fb.header, None) self.assertEqual(fb.length, None) - self.assertEqual(fb.mask, None) + self.assertEqual(fb.mask_value, None) self.assertEqual(fb.has_mask(), False) diff --git a/lib/websocket/tests/test_app.py b/lib/websocket/tests/test_app.py index ff90a0aa..5ed9a22e 100644 --- a/lib/websocket/tests/test_app.py +++ b/lib/websocket/tests/test_app.py @@ -2,11 +2,12 @@ # import os import os.path -import threading -import websocket as ws import ssl +import threading import unittest +import websocket as ws + """ test_app.py websocket - WebSocket client library for Python @@ -27,18 +28,16 @@ limitations under the License. """ # Skip test to access the internet unless TEST_WITH_INTERNET == 1 -TEST_WITH_INTERNET = os.environ.get('TEST_WITH_INTERNET', '0') == '1' +TEST_WITH_INTERNET = os.environ.get("TEST_WITH_INTERNET", "0") == "1" # Skip tests relying on local websockets server unless LOCAL_WS_SERVER_PORT != -1 -LOCAL_WS_SERVER_PORT = os.environ.get('LOCAL_WS_SERVER_PORT', '-1') -TEST_WITH_LOCAL_SERVER = LOCAL_WS_SERVER_PORT != '-1' +LOCAL_WS_SERVER_PORT = os.environ.get("LOCAL_WS_SERVER_PORT", "-1") +TEST_WITH_LOCAL_SERVER = LOCAL_WS_SERVER_PORT != "-1" TRACEABLE = True class WebSocketAppTest(unittest.TestCase): - class NotSetYet: - """ A marker class for signalling that a value hasn't been set yet. - """ + """A marker class for signalling that a value hasn't been set yet.""" def setUp(self): ws.enableTrace(TRACEABLE) @@ -54,14 +53,16 @@ class WebSocketAppTest(unittest.TestCase): WebSocketAppTest.get_mask_key_id = WebSocketAppTest.NotSetYet() WebSocketAppTest.on_error_data = WebSocketAppTest.NotSetYet() - @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled") + @unittest.skipUnless( + TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled" + ) def testKeepRunning(self): - """ A WebSocketApp should keep running as long as its self.keep_running + """A WebSocketApp should keep running as long as its self.keep_running is not False (in the boolean context). """ def on_open(self, *args, **kwargs): - """ Set the keep_running flag for later inspection and immediately + """Set the keep_running flag for later inspection and immediately close the connection. """ self.send("hello!") @@ -73,23 +74,26 @@ class WebSocketAppTest(unittest.TestCase): self.close() def on_close(self, *args, **kwargs): - """ Set the keep_running flag for the test to use. - """ + """Set the keep_running flag for the test to use.""" WebSocketAppTest.keep_running_close = self.keep_running - app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_open=on_open, on_close=on_close, on_message=on_message) + app = ws.WebSocketApp( + f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}", + on_open=on_open, + on_close=on_close, + on_message=on_message, + ) app.run_forever() -# @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled") + # @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled") @unittest.skipUnless(False, "Test disabled for now (requires rel)") def testRunForeverDispatcher(self): - """ A WebSocketApp should keep running as long as its self.keep_running + """A WebSocketApp should keep running as long as its self.keep_running is not False (in the boolean context). """ def on_open(self, *args, **kwargs): - """ Send a message, receive, and send one more - """ + """Send a message, receive, and send one more""" self.send("hello!") self.recv() self.send("goodbye!") @@ -98,30 +102,38 @@ class WebSocketAppTest(unittest.TestCase): print(message) self.close() - app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_open=on_open, on_message=on_message) + app = ws.WebSocketApp( + f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}", + on_open=on_open, + on_message=on_message, + ) app.run_forever(dispatcher="Dispatcher") # doesn't work -# app.run_forever(dispatcher=rel) # would work -# rel.dispatch() - @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled") + # app.run_forever(dispatcher=rel) # would work + # rel.dispatch() + + @unittest.skipUnless( + TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled" + ) def testRunForeverTeardownCleanExit(self): - """ The WebSocketApp.run_forever() method should return `False` when the application ends gracefully. - """ - app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT) + """The WebSocketApp.run_forever() method should return `False` when the application ends gracefully.""" + app = ws.WebSocketApp(f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}") threading.Timer(interval=0.2, function=app.close).start() teardown = app.run_forever() self.assertEqual(teardown, False) @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def testSockMaskKey(self): - """ A WebSocketApp should forward the received mask_key function down + """A WebSocketApp should forward the received mask_key function down to the actual socket. """ def my_mask_key_func(): return "\x00\x00\x00\x00" - app = ws.WebSocketApp('wss://api-pub.bitfinex.com/ws/1', get_mask_key=my_mask_key_func) + app = ws.WebSocketApp( + "wss://api-pub.bitfinex.com/ws/1", get_mask_key=my_mask_key_func + ) # if numpy is installed, this assertion fail # Note: We can't use 'is' for comparing the functions directly, need to use 'id'. @@ -129,8 +141,7 @@ class WebSocketAppTest(unittest.TestCase): @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def testInvalidPingIntervalPingTimeout(self): - """ Test exception handling if ping_interval < ping_timeout - """ + """Test exception handling if ping_interval < ping_timeout""" def on_ping(app, msg): print("Got a ping!") @@ -140,13 +151,20 @@ class WebSocketAppTest(unittest.TestCase): print("Got a pong! No need to respond") app.close() - app = ws.WebSocketApp('wss://api-pub.bitfinex.com/ws/1', on_ping=on_ping, on_pong=on_pong) - self.assertRaises(ws.WebSocketException, app.run_forever, ping_interval=1, ping_timeout=2, sslopt={"cert_reqs": ssl.CERT_NONE}) + app = ws.WebSocketApp( + "wss://api-pub.bitfinex.com/ws/1", on_ping=on_ping, on_pong=on_pong + ) + self.assertRaises( + ws.WebSocketException, + app.run_forever, + ping_interval=1, + ping_timeout=2, + sslopt={"cert_reqs": ssl.CERT_NONE}, + ) @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def testPingInterval(self): - """ Test WebSocketApp proper ping functionality - """ + """Test WebSocketApp proper ping functionality""" def on_ping(app, msg): print("Got a ping!") @@ -156,15 +174,18 @@ class WebSocketAppTest(unittest.TestCase): print("Got a pong! No need to respond") app.close() - app = ws.WebSocketApp('wss://api-pub.bitfinex.com/ws/1', on_ping=on_ping, on_pong=on_pong) - app.run_forever(ping_interval=2, ping_timeout=1, sslopt={"cert_reqs": ssl.CERT_NONE}) + app = ws.WebSocketApp( + "wss://api-pub.bitfinex.com/ws/1", on_ping=on_ping, on_pong=on_pong + ) + app.run_forever( + ping_interval=2, ping_timeout=1, sslopt={"cert_reqs": ssl.CERT_NONE} + ) @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def testOpcodeClose(self): - """ Test WebSocketApp close opcode - """ + """Test WebSocketApp close opcode""" - app = ws.WebSocketApp('wss://tsock.us1.twilio.com/v3/wsconnect') + app = ws.WebSocketApp("wss://tsock.us1.twilio.com/v3/wsconnect") app.run_forever(ping_interval=2, ping_timeout=1, ping_payload="Ping payload") # This is commented out because the URL no longer responds in the expected way @@ -177,41 +198,59 @@ class WebSocketAppTest(unittest.TestCase): @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def testBadPingInterval(self): - """ A WebSocketApp handling of negative ping_interval - """ - app = ws.WebSocketApp('wss://api-pub.bitfinex.com/ws/1') - self.assertRaises(ws.WebSocketException, app.run_forever, ping_interval=-5, sslopt={"cert_reqs": ssl.CERT_NONE}) + """A WebSocketApp handling of negative ping_interval""" + app = ws.WebSocketApp("wss://api-pub.bitfinex.com/ws/1") + self.assertRaises( + ws.WebSocketException, + app.run_forever, + ping_interval=-5, + sslopt={"cert_reqs": ssl.CERT_NONE}, + ) @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def testBadPingTimeout(self): - """ A WebSocketApp handling of negative ping_timeout - """ - app = ws.WebSocketApp('wss://api-pub.bitfinex.com/ws/1') - self.assertRaises(ws.WebSocketException, app.run_forever, ping_timeout=-3, sslopt={"cert_reqs": ssl.CERT_NONE}) + """A WebSocketApp handling of negative ping_timeout""" + app = ws.WebSocketApp("wss://api-pub.bitfinex.com/ws/1") + self.assertRaises( + ws.WebSocketException, + app.run_forever, + ping_timeout=-3, + sslopt={"cert_reqs": ssl.CERT_NONE}, + ) @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def testCloseStatusCode(self): - """ Test extraction of close frame status code and close reason in WebSocketApp - """ + """Test extraction of close frame status code and close reason in WebSocketApp""" + def on_close(wsapp, close_status_code, close_msg): print("on_close reached") - app = ws.WebSocketApp('wss://tsock.us1.twilio.com/v3/wsconnect', on_close=on_close) - closeframe = ws.ABNF(opcode=ws.ABNF.OPCODE_CLOSE, data=b'\x03\xe8no-init-from-client') - self.assertEqual([1000, 'no-init-from-client'], app._get_close_args(closeframe)) + app = ws.WebSocketApp( + "wss://tsock.us1.twilio.com/v3/wsconnect", on_close=on_close + ) + closeframe = ws.ABNF( + opcode=ws.ABNF.OPCODE_CLOSE, data=b"\x03\xe8no-init-from-client" + ) + self.assertEqual([1000, "no-init-from-client"], app._get_close_args(closeframe)) - closeframe = ws.ABNF(opcode=ws.ABNF.OPCODE_CLOSE, data=b'') + closeframe = ws.ABNF(opcode=ws.ABNF.OPCODE_CLOSE, data=b"") self.assertEqual([None, None], app._get_close_args(closeframe)) - app2 = ws.WebSocketApp('wss://tsock.us1.twilio.com/v3/wsconnect') - closeframe = ws.ABNF(opcode=ws.ABNF.OPCODE_CLOSE, data=b'') + app2 = ws.WebSocketApp("wss://tsock.us1.twilio.com/v3/wsconnect") + closeframe = ws.ABNF(opcode=ws.ABNF.OPCODE_CLOSE, data=b"") self.assertEqual([None, None], app2._get_close_args(closeframe)) - self.assertRaises(ws.WebSocketConnectionClosedException, app.send, data="test if connection is closed") + self.assertRaises( + ws.WebSocketConnectionClosedException, + app.send, + data="test if connection is closed", + ) - @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled") + @unittest.skipUnless( + TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled" + ) def testCallbackFunctionException(self): - """ Test callback function exception handling """ + """Test callback function exception handling""" exc = None passed_app = None @@ -228,26 +267,33 @@ class WebSocketAppTest(unittest.TestCase): def on_pong(app, msg): app.close() - app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_open=on_open, on_error=on_error, on_pong=on_pong) + app = ws.WebSocketApp( + f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}", + on_open=on_open, + on_error=on_error, + on_pong=on_pong, + ) app.run_forever(ping_interval=2, ping_timeout=1) self.assertEqual(passed_app, app) self.assertIsInstance(exc, RuntimeError) self.assertEqual(str(exc), "Callback failed") - @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled") + @unittest.skipUnless( + TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled" + ) def testCallbackMethodException(self): - """ Test callback method exception handling """ + """Test callback method exception handling""" class Callbacks: def __init__(self): self.exc = None self.passed_app = None self.app = ws.WebSocketApp( - 'ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, + f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}", on_open=self.on_open, on_error=self.on_error, - on_pong=self.on_pong + on_pong=self.on_pong, ) self.app.run_forever(ping_interval=2, ping_timeout=1) @@ -267,9 +313,11 @@ class WebSocketAppTest(unittest.TestCase): self.assertIsInstance(callbacks.exc, RuntimeError) self.assertEqual(str(callbacks.exc), "Callback failed") - @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled") + @unittest.skipUnless( + TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled" + ) def testReconnect(self): - """ Test reconnect """ + """Test reconnect""" pong_count = 0 exc = None @@ -287,7 +335,9 @@ class WebSocketAppTest(unittest.TestCase): # Got second pong after reconnect app.close() - app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_pong=on_pong, on_error=on_error) + app = ws.WebSocketApp( + f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}", on_pong=on_pong, on_error=on_error + ) app.run_forever(ping_interval=2, ping_timeout=1, reconnect=3) self.assertEqual(pong_count, 2) diff --git a/lib/websocket/tests/test_cookiejar.py b/lib/websocket/tests/test_cookiejar.py index 8f835e9e..0de87517 100644 --- a/lib/websocket/tests/test_cookiejar.py +++ b/lib/websocket/tests/test_cookiejar.py @@ -1,4 +1,5 @@ import unittest + from websocket._cookiejar import SimpleCookieJar """ @@ -25,11 +26,15 @@ class CookieJarTest(unittest.TestCase): def testAdd(self): cookie_jar = SimpleCookieJar() cookie_jar.add("") - self.assertFalse(cookie_jar.jar, "Cookie with no domain should not be added to the jar") + self.assertFalse( + cookie_jar.jar, "Cookie with no domain should not be added to the jar" + ) cookie_jar = SimpleCookieJar() cookie_jar.add("a=b") - self.assertFalse(cookie_jar.jar, "Cookie with no domain should not be added to the jar") + self.assertFalse( + cookie_jar.jar, "Cookie with no domain should not be added to the jar" + ) cookie_jar = SimpleCookieJar() cookie_jar.add("a=b; domain=.abc") @@ -65,7 +70,9 @@ class CookieJarTest(unittest.TestCase): def testSet(self): cookie_jar = SimpleCookieJar() cookie_jar.set("a=b") - self.assertFalse(cookie_jar.jar, "Cookie with no domain should not be added to the jar") + self.assertFalse( + cookie_jar.jar, "Cookie with no domain should not be added to the jar" + ) cookie_jar = SimpleCookieJar() cookie_jar.set("a=b; domain=.abc") diff --git a/lib/websocket/tests/test_http.py b/lib/websocket/tests/test_http.py index d7de29d3..0d6031a3 100644 --- a/lib/websocket/tests/test_http.py +++ b/lib/websocket/tests/test_http.py @@ -2,12 +2,20 @@ # import os import os.path -import websocket as ws -from websocket._http import proxy_info, read_headers, _start_proxied_socket, _tunnel, _get_addrinfo_list, connect -import unittest -import ssl -import websocket import socket +import ssl +import unittest + +import websocket +import websocket as ws +from websocket._http import ( + _get_addrinfo_list, + _start_proxied_socket, + _tunnel, + connect, + proxy_info, + read_headers, +) """ test_http.py @@ -29,16 +37,16 @@ limitations under the License. """ try: - from python_socks._errors import ProxyError, ProxyTimeoutError, ProxyConnectionError + from python_socks._errors import ProxyConnectionError, ProxyError, ProxyTimeoutError except: - from websocket._http import ProxyError, ProxyTimeoutError, ProxyConnectionError + from websocket._http import ProxyConnectionError, ProxyError, ProxyTimeoutError # Skip test to access the internet unless TEST_WITH_INTERNET == 1 -TEST_WITH_INTERNET = os.environ.get('TEST_WITH_INTERNET', '0') == '1' -TEST_WITH_PROXY = os.environ.get('TEST_WITH_PROXY', '0') == '1' +TEST_WITH_INTERNET = os.environ.get("TEST_WITH_INTERNET", "0") == "1" +TEST_WITH_PROXY = os.environ.get("TEST_WITH_PROXY", "0") == "1" # Skip tests relying on local websockets server unless LOCAL_WS_SERVER_PORT != -1 -LOCAL_WS_SERVER_PORT = os.environ.get('LOCAL_WS_SERVER_PORT', '-1') -TEST_WITH_LOCAL_SERVER = LOCAL_WS_SERVER_PORT != '-1' +LOCAL_WS_SERVER_PORT = os.environ.get("LOCAL_WS_SERVER_PORT", "-1") +TEST_WITH_LOCAL_SERVER = LOCAL_WS_SERVER_PORT != "-1" class SockMock: @@ -70,7 +78,6 @@ class SockMock: class HeaderSockMock(SockMock): - def __init__(self, fname): SockMock.__init__(self) path = os.path.join(os.path.dirname(__file__), fname) @@ -78,8 +85,7 @@ class HeaderSockMock(SockMock): self.add_packet(f.read()) -class OptsList(): - +class OptsList: def __init__(self): self.timeout = 1 self.sockopt = [] @@ -87,17 +93,34 @@ class OptsList(): class HttpTest(unittest.TestCase): - def testReadHeader(self): - status, header, status_message = read_headers(HeaderSockMock("data/header01.txt")) + status, header, status_message = read_headers( + HeaderSockMock("data/header01.txt") + ) self.assertEqual(status, 101) self.assertEqual(header["connection"], "Upgrade") # header02.txt is intentionally malformed - self.assertRaises(ws.WebSocketException, read_headers, HeaderSockMock("data/header02.txt")) + self.assertRaises( + ws.WebSocketException, read_headers, HeaderSockMock("data/header02.txt") + ) def testTunnel(self): - self.assertRaises(ws.WebSocketProxyException, _tunnel, HeaderSockMock("data/header01.txt"), "example.com", 80, ("username", "password")) - self.assertRaises(ws.WebSocketProxyException, _tunnel, HeaderSockMock("data/header02.txt"), "example.com", 80, ("username", "password")) + self.assertRaises( + ws.WebSocketProxyException, + _tunnel, + HeaderSockMock("data/header01.txt"), + "example.com", + 80, + ("username", "password"), + ) + self.assertRaises( + ws.WebSocketProxyException, + _tunnel, + HeaderSockMock("data/header02.txt"), + "example.com", + 80, + ("username", "password"), + ) @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def testConnect(self): @@ -105,34 +128,164 @@ class HttpTest(unittest.TestCase): if ws._http.HAVE_PYTHON_SOCKS: # Need this check, otherwise case where python_socks is not installed triggers # websocket._exceptions.WebSocketException: Python Socks is needed for SOCKS proxying but is not available - self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks4", http_proxy_timeout=1)) - self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks4a", http_proxy_timeout=1)) - self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks5", http_proxy_timeout=1)) - self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks5h", http_proxy_timeout=1)) - self.assertRaises(ProxyConnectionError, connect, "wss://example.com", OptsList(), proxy_info(http_proxy_host="127.0.0.1", http_proxy_port=9999, proxy_type="socks4", http_proxy_timeout=1), None) + self.assertRaises( + (ProxyTimeoutError, OSError), + _start_proxied_socket, + "wss://example.com", + OptsList(), + proxy_info( + http_proxy_host="example.com", + http_proxy_port="8080", + proxy_type="socks4", + http_proxy_timeout=1, + ), + ) + self.assertRaises( + (ProxyTimeoutError, OSError), + _start_proxied_socket, + "wss://example.com", + OptsList(), + proxy_info( + http_proxy_host="example.com", + http_proxy_port="8080", + proxy_type="socks4a", + http_proxy_timeout=1, + ), + ) + self.assertRaises( + (ProxyTimeoutError, OSError), + _start_proxied_socket, + "wss://example.com", + OptsList(), + proxy_info( + http_proxy_host="example.com", + http_proxy_port="8080", + proxy_type="socks5", + http_proxy_timeout=1, + ), + ) + self.assertRaises( + (ProxyTimeoutError, OSError), + _start_proxied_socket, + "wss://example.com", + OptsList(), + proxy_info( + http_proxy_host="example.com", + http_proxy_port="8080", + proxy_type="socks5h", + http_proxy_timeout=1, + ), + ) + self.assertRaises( + ProxyConnectionError, + connect, + "wss://example.com", + OptsList(), + proxy_info( + http_proxy_host="127.0.0.1", + http_proxy_port=9999, + proxy_type="socks4", + http_proxy_timeout=1, + ), + None, + ) - self.assertRaises(TypeError, _get_addrinfo_list, None, 80, True, proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="9999", proxy_type="http")) - self.assertRaises(TypeError, _get_addrinfo_list, None, 80, True, proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="9999", proxy_type="http")) - self.assertRaises(socket.timeout, connect, "wss://google.com", OptsList(), proxy_info(http_proxy_host="8.8.8.8", http_proxy_port=9999, proxy_type="http", http_proxy_timeout=1), None) + self.assertRaises( + TypeError, + _get_addrinfo_list, + None, + 80, + True, + proxy_info( + http_proxy_host="127.0.0.1", http_proxy_port="9999", proxy_type="http" + ), + ) + self.assertRaises( + TypeError, + _get_addrinfo_list, + None, + 80, + True, + proxy_info( + http_proxy_host="127.0.0.1", http_proxy_port="9999", proxy_type="http" + ), + ) + self.assertRaises( + socket.timeout, + connect, + "wss://google.com", + OptsList(), + proxy_info( + http_proxy_host="8.8.8.8", + http_proxy_port=9999, + proxy_type="http", + http_proxy_timeout=1, + ), + None, + ) self.assertEqual( - connect("wss://google.com", OptsList(), proxy_info(http_proxy_host="8.8.8.8", http_proxy_port=8080, proxy_type="http"), True), - (True, ("google.com", 443, "/"))) + connect( + "wss://google.com", + OptsList(), + proxy_info( + http_proxy_host="8.8.8.8", http_proxy_port=8080, proxy_type="http" + ), + True, + ), + (True, ("google.com", 443, "/")), + ) # The following test fails on Mac OS with a gaierror, not an OverflowError # self.assertRaises(OverflowError, connect, "wss://example.com", OptsList(), proxy_info(http_proxy_host="127.0.0.1", http_proxy_port=99999, proxy_type="socks4", timeout=2), False) @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") - @unittest.skipUnless(TEST_WITH_PROXY, "This test requires a HTTP proxy to be running on port 8899") - @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled") + @unittest.skipUnless( + TEST_WITH_PROXY, "This test requires a HTTP proxy to be running on port 8899" + ) + @unittest.skipUnless( + TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled" + ) def testProxyConnect(self): ws = websocket.WebSocket() - ws.connect("ws://127.0.0.1:" + LOCAL_WS_SERVER_PORT, http_proxy_host="127.0.0.1", http_proxy_port="8899", proxy_type="http") + ws.connect( + f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}", + http_proxy_host="127.0.0.1", + http_proxy_port="8899", + proxy_type="http", + ) ws.send("Hello, Server") server_response = ws.recv() self.assertEqual(server_response, "Hello, Server") # self.assertEqual(_start_proxied_socket("wss://api.bitfinex.com/ws/2", OptsList(), proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8899", proxy_type="http"))[1], ("api.bitfinex.com", 443, '/ws/2')) - self.assertEqual(_get_addrinfo_list("api.bitfinex.com", 443, True, proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8899", proxy_type="http")), - (socket.getaddrinfo("127.0.0.1", 8899, 0, socket.SOCK_STREAM, socket.SOL_TCP), True, None)) - self.assertEqual(connect("wss://api.bitfinex.com/ws/2", OptsList(), proxy_info(http_proxy_host="127.0.0.1", http_proxy_port=8899, proxy_type="http"), None)[1], ("api.bitfinex.com", 443, '/ws/2')) + self.assertEqual( + _get_addrinfo_list( + "api.bitfinex.com", + 443, + True, + proxy_info( + http_proxy_host="127.0.0.1", + http_proxy_port="8899", + proxy_type="http", + ), + ), + ( + socket.getaddrinfo( + "127.0.0.1", 8899, 0, socket.SOCK_STREAM, socket.SOL_TCP + ), + True, + None, + ), + ) + self.assertEqual( + connect( + "wss://api.bitfinex.com/ws/2", + OptsList(), + proxy_info( + http_proxy_host="127.0.0.1", http_proxy_port=8899, proxy_type="http" + ), + None, + )[1], + ("api.bitfinex.com", 443, "/ws/2"), + ) # TODO: Test SOCKS4 and SOCK5 proxies with unit tests @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") @@ -151,7 +304,7 @@ class HttpTest(unittest.TestCase): DHE-RSA-AES256-SHA256:ECDHE-ECDSA-AES128-SHA256:\ ECDHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA256:\ ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA", - "ecdh_curve": "prime256v1" + "ecdh_curve": "prime256v1", } ws_ssl1 = websocket.WebSocket(sslopt=ssloptions) ws_ssl1.connect("wss://api.bitfinex.com/ws/2") @@ -163,13 +316,55 @@ class HttpTest(unittest.TestCase): ws_ssl2.close def testProxyInfo(self): - self.assertEqual(proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http").proxy_protocol, "http") - self.assertRaises(ProxyError, proxy_info, http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="badval") - self.assertEqual(proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="http").proxy_host, "example.com") - self.assertEqual(proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http").proxy_port, "8080") - self.assertEqual(proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http").auth, None) - self.assertEqual(proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http", http_proxy_auth=("my_username123", "my_pass321")).auth[0], "my_username123") - self.assertEqual(proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http", http_proxy_auth=("my_username123", "my_pass321")).auth[1], "my_pass321") + self.assertEqual( + proxy_info( + http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http" + ).proxy_protocol, + "http", + ) + self.assertRaises( + ProxyError, + proxy_info, + http_proxy_host="127.0.0.1", + http_proxy_port="8080", + proxy_type="badval", + ) + self.assertEqual( + proxy_info( + http_proxy_host="example.com", http_proxy_port="8080", proxy_type="http" + ).proxy_host, + "example.com", + ) + self.assertEqual( + proxy_info( + http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http" + ).proxy_port, + "8080", + ) + self.assertEqual( + proxy_info( + http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http" + ).auth, + None, + ) + self.assertEqual( + proxy_info( + http_proxy_host="127.0.0.1", + http_proxy_port="8080", + proxy_type="http", + http_proxy_auth=("my_username123", "my_pass321"), + ).auth[0], + "my_username123", + ) + self.assertEqual( + proxy_info( + http_proxy_host="127.0.0.1", + http_proxy_port="8080", + proxy_type="http", + http_proxy_auth=("my_username123", "my_pass321"), + ).auth[1], + "my_pass321", + ) if __name__ == "__main__": diff --git a/lib/websocket/tests/test_url.py b/lib/websocket/tests/test_url.py index a74dd766..792399eb 100644 --- a/lib/websocket/tests/test_url.py +++ b/lib/websocket/tests/test_url.py @@ -2,7 +2,13 @@ # import os import unittest -from websocket._url import get_proxy_info, parse_url, _is_address_in_network, _is_no_proxy_host + +from websocket._url import ( + _is_address_in_network, + _is_no_proxy_host, + get_proxy_info, + parse_url, +) """ test_url.py @@ -25,11 +31,10 @@ limitations under the License. class UrlTest(unittest.TestCase): - def test_address_in_network(self): - self.assertTrue(_is_address_in_network('127.0.0.1', '127.0.0.0/8')) - self.assertTrue(_is_address_in_network('127.1.0.1', '127.0.0.0/8')) - self.assertFalse(_is_address_in_network('127.1.0.1', '127.0.0.0/24')) + self.assertTrue(_is_address_in_network("127.0.0.1", "127.0.0.0/8")) + self.assertTrue(_is_address_in_network("127.1.0.1", "127.0.0.0/8")) + self.assertFalse(_is_address_in_network("127.1.0.1", "127.0.0.0/24")) def testParseUrl(self): p = parse_url("ws://www.example.com/r") @@ -126,57 +131,71 @@ class IsNoProxyHostTest(unittest.TestCase): del os.environ["no_proxy"] def testMatchAll(self): - self.assertTrue(_is_no_proxy_host("any.websocket.org", ['*'])) - self.assertTrue(_is_no_proxy_host("192.168.0.1", ['*'])) - self.assertTrue(_is_no_proxy_host("any.websocket.org", ['other.websocket.org', '*'])) - os.environ['no_proxy'] = '*' + self.assertTrue(_is_no_proxy_host("any.websocket.org", ["*"])) + self.assertTrue(_is_no_proxy_host("192.168.0.1", ["*"])) + self.assertTrue( + _is_no_proxy_host("any.websocket.org", ["other.websocket.org", "*"]) + ) + os.environ["no_proxy"] = "*" self.assertTrue(_is_no_proxy_host("any.websocket.org", None)) self.assertTrue(_is_no_proxy_host("192.168.0.1", None)) - os.environ['no_proxy'] = 'other.websocket.org, *' + os.environ["no_proxy"] = "other.websocket.org, *" self.assertTrue(_is_no_proxy_host("any.websocket.org", None)) def testIpAddress(self): - self.assertTrue(_is_no_proxy_host("127.0.0.1", ['127.0.0.1'])) - self.assertFalse(_is_no_proxy_host("127.0.0.2", ['127.0.0.1'])) - self.assertTrue(_is_no_proxy_host("127.0.0.1", ['other.websocket.org', '127.0.0.1'])) - self.assertFalse(_is_no_proxy_host("127.0.0.2", ['other.websocket.org', '127.0.0.1'])) - os.environ['no_proxy'] = '127.0.0.1' + self.assertTrue(_is_no_proxy_host("127.0.0.1", ["127.0.0.1"])) + self.assertFalse(_is_no_proxy_host("127.0.0.2", ["127.0.0.1"])) + self.assertTrue( + _is_no_proxy_host("127.0.0.1", ["other.websocket.org", "127.0.0.1"]) + ) + self.assertFalse( + _is_no_proxy_host("127.0.0.2", ["other.websocket.org", "127.0.0.1"]) + ) + os.environ["no_proxy"] = "127.0.0.1" self.assertTrue(_is_no_proxy_host("127.0.0.1", None)) self.assertFalse(_is_no_proxy_host("127.0.0.2", None)) - os.environ['no_proxy'] = 'other.websocket.org, 127.0.0.1' + os.environ["no_proxy"] = "other.websocket.org, 127.0.0.1" self.assertTrue(_is_no_proxy_host("127.0.0.1", None)) self.assertFalse(_is_no_proxy_host("127.0.0.2", None)) def testIpAddressInRange(self): - self.assertTrue(_is_no_proxy_host("127.0.0.1", ['127.0.0.0/8'])) - self.assertTrue(_is_no_proxy_host("127.0.0.2", ['127.0.0.0/8'])) - self.assertFalse(_is_no_proxy_host("127.1.0.1", ['127.0.0.0/24'])) - os.environ['no_proxy'] = '127.0.0.0/8' + self.assertTrue(_is_no_proxy_host("127.0.0.1", ["127.0.0.0/8"])) + self.assertTrue(_is_no_proxy_host("127.0.0.2", ["127.0.0.0/8"])) + self.assertFalse(_is_no_proxy_host("127.1.0.1", ["127.0.0.0/24"])) + os.environ["no_proxy"] = "127.0.0.0/8" self.assertTrue(_is_no_proxy_host("127.0.0.1", None)) self.assertTrue(_is_no_proxy_host("127.0.0.2", None)) - os.environ['no_proxy'] = '127.0.0.0/24' + os.environ["no_proxy"] = "127.0.0.0/24" self.assertFalse(_is_no_proxy_host("127.1.0.1", None)) def testHostnameMatch(self): - self.assertTrue(_is_no_proxy_host("my.websocket.org", ['my.websocket.org'])) - self.assertTrue(_is_no_proxy_host("my.websocket.org", ['other.websocket.org', 'my.websocket.org'])) - self.assertFalse(_is_no_proxy_host("my.websocket.org", ['other.websocket.org'])) - os.environ['no_proxy'] = 'my.websocket.org' + self.assertTrue(_is_no_proxy_host("my.websocket.org", ["my.websocket.org"])) + self.assertTrue( + _is_no_proxy_host( + "my.websocket.org", ["other.websocket.org", "my.websocket.org"] + ) + ) + self.assertFalse(_is_no_proxy_host("my.websocket.org", ["other.websocket.org"])) + os.environ["no_proxy"] = "my.websocket.org" self.assertTrue(_is_no_proxy_host("my.websocket.org", None)) self.assertFalse(_is_no_proxy_host("other.websocket.org", None)) - os.environ['no_proxy'] = 'other.websocket.org, my.websocket.org' + os.environ["no_proxy"] = "other.websocket.org, my.websocket.org" self.assertTrue(_is_no_proxy_host("my.websocket.org", None)) def testHostnameMatchDomain(self): - self.assertTrue(_is_no_proxy_host("any.websocket.org", ['.websocket.org'])) - self.assertTrue(_is_no_proxy_host("my.other.websocket.org", ['.websocket.org'])) - self.assertTrue(_is_no_proxy_host("any.websocket.org", ['my.websocket.org', '.websocket.org'])) - self.assertFalse(_is_no_proxy_host("any.websocket.com", ['.websocket.org'])) - os.environ['no_proxy'] = '.websocket.org' + self.assertTrue(_is_no_proxy_host("any.websocket.org", [".websocket.org"])) + self.assertTrue(_is_no_proxy_host("my.other.websocket.org", [".websocket.org"])) + self.assertTrue( + _is_no_proxy_host( + "any.websocket.org", ["my.websocket.org", ".websocket.org"] + ) + ) + self.assertFalse(_is_no_proxy_host("any.websocket.com", [".websocket.org"])) + os.environ["no_proxy"] = ".websocket.org" self.assertTrue(_is_no_proxy_host("any.websocket.org", None)) self.assertTrue(_is_no_proxy_host("my.other.websocket.org", None)) self.assertFalse(_is_no_proxy_host("any.websocket.com", None)) - os.environ['no_proxy'] = 'my.websocket.org, .websocket.org' + os.environ["no_proxy"] = "my.websocket.org, .websocket.org" self.assertTrue(_is_no_proxy_host("any.websocket.org", None)) @@ -209,96 +228,205 @@ class ProxyInfoTest(unittest.TestCase): del os.environ["no_proxy"] def testProxyFromArgs(self): - self.assertEqual(get_proxy_info("echo.websocket.events", False, proxy_host="localhost"), ("localhost", 0, None)) - self.assertEqual(get_proxy_info("echo.websocket.events", False, proxy_host="localhost", proxy_port=3128), - ("localhost", 3128, None)) - self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost"), ("localhost", 0, None)) - self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_port=3128), - ("localhost", 3128, None)) - - self.assertEqual(get_proxy_info("echo.websocket.events", False, proxy_host="localhost", proxy_auth=("a", "b")), - ("localhost", 0, ("a", "b"))) self.assertEqual( - get_proxy_info("echo.websocket.events", False, proxy_host="localhost", proxy_port=3128, proxy_auth=("a", "b")), - ("localhost", 3128, ("a", "b"))) - self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_auth=("a", "b")), - ("localhost", 0, ("a", "b"))) + get_proxy_info("echo.websocket.events", False, proxy_host="localhost"), + ("localhost", 0, None), + ) self.assertEqual( - get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_port=3128, proxy_auth=("a", "b")), - ("localhost", 3128, ("a", "b"))) + get_proxy_info( + "echo.websocket.events", False, proxy_host="localhost", proxy_port=3128 + ), + ("localhost", 3128, None), + ) + self.assertEqual( + get_proxy_info("echo.websocket.events", True, proxy_host="localhost"), + ("localhost", 0, None), + ) + self.assertEqual( + get_proxy_info( + "echo.websocket.events", True, proxy_host="localhost", proxy_port=3128 + ), + ("localhost", 3128, None), + ) - self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_port=3128, - no_proxy=["example.com"], proxy_auth=("a", "b")), - ("localhost", 3128, ("a", "b"))) - self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_port=3128, - no_proxy=["echo.websocket.events"], proxy_auth=("a", "b")), - (None, 0, None)) + self.assertEqual( + get_proxy_info( + "echo.websocket.events", + False, + proxy_host="localhost", + proxy_auth=("a", "b"), + ), + ("localhost", 0, ("a", "b")), + ) + self.assertEqual( + get_proxy_info( + "echo.websocket.events", + False, + proxy_host="localhost", + proxy_port=3128, + proxy_auth=("a", "b"), + ), + ("localhost", 3128, ("a", "b")), + ) + self.assertEqual( + get_proxy_info( + "echo.websocket.events", + True, + proxy_host="localhost", + proxy_auth=("a", "b"), + ), + ("localhost", 0, ("a", "b")), + ) + self.assertEqual( + get_proxy_info( + "echo.websocket.events", + True, + proxy_host="localhost", + proxy_port=3128, + proxy_auth=("a", "b"), + ), + ("localhost", 3128, ("a", "b")), + ) + + self.assertEqual( + get_proxy_info( + "echo.websocket.events", + True, + proxy_host="localhost", + proxy_port=3128, + no_proxy=["example.com"], + proxy_auth=("a", "b"), + ), + ("localhost", 3128, ("a", "b")), + ) + self.assertEqual( + get_proxy_info( + "echo.websocket.events", + True, + proxy_host="localhost", + proxy_port=3128, + no_proxy=["echo.websocket.events"], + proxy_auth=("a", "b"), + ), + (None, 0, None), + ) def testProxyFromEnv(self): os.environ["http_proxy"] = "http://localhost/" - self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, None)) + self.assertEqual( + get_proxy_info("echo.websocket.events", False), ("localhost", None, None) + ) os.environ["http_proxy"] = "http://localhost:3128/" - self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None)) + self.assertEqual( + get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None) + ) os.environ["http_proxy"] = "http://localhost/" os.environ["https_proxy"] = "http://localhost2/" - self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, None)) + self.assertEqual( + get_proxy_info("echo.websocket.events", False), ("localhost", None, None) + ) os.environ["http_proxy"] = "http://localhost:3128/" os.environ["https_proxy"] = "http://localhost2:3128/" - self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None)) + self.assertEqual( + get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None) + ) os.environ["http_proxy"] = "http://localhost/" os.environ["https_proxy"] = "http://localhost2/" - self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", None, None)) + self.assertEqual( + get_proxy_info("echo.websocket.events", True), ("localhost2", None, None) + ) os.environ["http_proxy"] = "http://localhost:3128/" os.environ["https_proxy"] = "http://localhost2:3128/" - self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, None)) + self.assertEqual( + get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, None) + ) os.environ["http_proxy"] = "" os.environ["https_proxy"] = "http://localhost2/" - self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", None, None)) - self.assertEqual(get_proxy_info("echo.websocket.events", False), (None, 0, None)) + self.assertEqual( + get_proxy_info("echo.websocket.events", True), ("localhost2", None, None) + ) + self.assertEqual( + get_proxy_info("echo.websocket.events", False), (None, 0, None) + ) os.environ["http_proxy"] = "" os.environ["https_proxy"] = "http://localhost2:3128/" - self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, None)) - self.assertEqual(get_proxy_info("echo.websocket.events", False), (None, 0, None)) + self.assertEqual( + get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, None) + ) + self.assertEqual( + get_proxy_info("echo.websocket.events", False), (None, 0, None) + ) os.environ["http_proxy"] = "http://localhost/" os.environ["https_proxy"] = "" self.assertEqual(get_proxy_info("echo.websocket.events", True), (None, 0, None)) - self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, None)) + self.assertEqual( + get_proxy_info("echo.websocket.events", False), ("localhost", None, None) + ) os.environ["http_proxy"] = "http://localhost:3128/" os.environ["https_proxy"] = "" self.assertEqual(get_proxy_info("echo.websocket.events", True), (None, 0, None)) - self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None)) + self.assertEqual( + get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None) + ) os.environ["http_proxy"] = "http://a:b@localhost/" - self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, ("a", "b"))) + self.assertEqual( + get_proxy_info("echo.websocket.events", False), + ("localhost", None, ("a", "b")), + ) os.environ["http_proxy"] = "http://a:b@localhost:3128/" - self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, ("a", "b"))) + self.assertEqual( + get_proxy_info("echo.websocket.events", False), + ("localhost", 3128, ("a", "b")), + ) os.environ["http_proxy"] = "http://a:b@localhost/" os.environ["https_proxy"] = "http://a:b@localhost2/" - self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, ("a", "b"))) + self.assertEqual( + get_proxy_info("echo.websocket.events", False), + ("localhost", None, ("a", "b")), + ) os.environ["http_proxy"] = "http://a:b@localhost:3128/" os.environ["https_proxy"] = "http://a:b@localhost2:3128/" - self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, ("a", "b"))) + self.assertEqual( + get_proxy_info("echo.websocket.events", False), + ("localhost", 3128, ("a", "b")), + ) os.environ["http_proxy"] = "http://a:b@localhost/" os.environ["https_proxy"] = "http://a:b@localhost2/" - self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", None, ("a", "b"))) + self.assertEqual( + get_proxy_info("echo.websocket.events", True), + ("localhost2", None, ("a", "b")), + ) os.environ["http_proxy"] = "http://a:b@localhost:3128/" os.environ["https_proxy"] = "http://a:b@localhost2:3128/" - self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, ("a", "b"))) + self.assertEqual( + get_proxy_info("echo.websocket.events", True), + ("localhost2", 3128, ("a", "b")), + ) - os.environ["http_proxy"] = "http://john%40example.com:P%40SSWORD@localhost:3128/" - os.environ["https_proxy"] = "http://john%40example.com:P%40SSWORD@localhost2:3128/" - self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, ("john@example.com", "P@SSWORD"))) + os.environ[ + "http_proxy" + ] = "http://john%40example.com:P%40SSWORD@localhost:3128/" + os.environ[ + "https_proxy" + ] = "http://john%40example.com:P%40SSWORD@localhost2:3128/" + self.assertEqual( + get_proxy_info("echo.websocket.events", True), + ("localhost2", 3128, ("john@example.com", "P@SSWORD")), + ) os.environ["http_proxy"] = "http://a:b@localhost/" os.environ["https_proxy"] = "http://a:b@localhost2/" os.environ["no_proxy"] = "example1.com,example2.com" - self.assertEqual(get_proxy_info("example.1.com", True), ("localhost2", None, ("a", "b"))) + self.assertEqual( + get_proxy_info("example.1.com", True), ("localhost2", None, ("a", "b")) + ) os.environ["http_proxy"] = "http://a:b@localhost:3128/" os.environ["https_proxy"] = "http://a:b@localhost2:3128/" os.environ["no_proxy"] = "example1.com,example2.com, echo.websocket.events" diff --git a/lib/websocket/tests/test_websocket.py b/lib/websocket/tests/test_websocket.py index a140066e..498def57 100644 --- a/lib/websocket/tests/test_websocket.py +++ b/lib/websocket/tests/test_websocket.py @@ -3,13 +3,14 @@ import os import os.path import socket -import websocket as ws import unittest -from websocket._handshake import _create_sec_websocket_key, \ - _validate as _validate_header +from base64 import decodebytes as base64decode + +import websocket as ws +from websocket._handshake import _create_sec_websocket_key +from websocket._handshake import _validate as _validate_header from websocket._http import read_headers from websocket._utils import validate_utf8 -from base64 import decodebytes as base64decode """ test_websocket.py @@ -38,11 +39,12 @@ except ImportError: class SSLError(Exception): pass + # Skip test to access the internet unless TEST_WITH_INTERNET == 1 -TEST_WITH_INTERNET = os.environ.get('TEST_WITH_INTERNET', '0') == '1' +TEST_WITH_INTERNET = os.environ.get("TEST_WITH_INTERNET", "0") == "1" # Skip tests relying on local websockets server unless LOCAL_WS_SERVER_PORT != -1 -LOCAL_WS_SERVER_PORT = os.environ.get('LOCAL_WS_SERVER_PORT', '-1') -TEST_WITH_LOCAL_SERVER = LOCAL_WS_SERVER_PORT != '-1' +LOCAL_WS_SERVER_PORT = os.environ.get("LOCAL_WS_SERVER_PORT", "-1") +TEST_WITH_LOCAL_SERVER = LOCAL_WS_SERVER_PORT != "-1" TRACEABLE = True @@ -79,7 +81,6 @@ class SockMock: class HeaderSockMock(SockMock): - def __init__(self, fname): SockMock.__init__(self) path = os.path.join(os.path.dirname(__file__), fname) @@ -103,11 +104,10 @@ class WebSocketTest(unittest.TestCase): def testWSKey(self): key = _create_sec_websocket_key() self.assertTrue(key != 24) - self.assertTrue(str("Â¥n") not in key) + self.assertTrue("Â¥n" not in key) def testNonce(self): - """ WebSocket key should be a random 16-byte nonce. - """ + """WebSocket key should be a random 16-byte nonce.""" key = _create_sec_websocket_key() nonce = base64decode(key.encode("utf-8")) self.assertEqual(16, len(nonce)) @@ -117,7 +117,8 @@ class WebSocketTest(unittest.TestCase): required_header = { "upgrade": "websocket", "connection": "upgrade", - "sec-websocket-accept": "Kxep+hNu9n51529fGidYu7a3wO0="} + "sec-websocket-accept": "Kxep+hNu9n51529fGidYu7a3wO0=", + } self.assertEqual(_validate_header(required_header, key, None), (True, None)) header = required_header.copy() @@ -140,29 +141,39 @@ class WebSocketTest(unittest.TestCase): header = required_header.copy() header["sec-websocket-protocol"] = "sub1" - self.assertEqual(_validate_header(header, key, ["sub1", "sub2"]), (True, "sub1")) + self.assertEqual( + _validate_header(header, key, ["sub1", "sub2"]), (True, "sub1") + ) # This case will print out a logging error using the error() function, but that is expected self.assertEqual(_validate_header(header, key, ["sub2", "sub3"]), (False, None)) header = required_header.copy() header["sec-websocket-protocol"] = "sUb1" - self.assertEqual(_validate_header(header, key, ["Sub1", "suB2"]), (True, "sub1")) + self.assertEqual( + _validate_header(header, key, ["Sub1", "suB2"]), (True, "sub1") + ) header = required_header.copy() # This case will print out a logging error using the error() function, but that is expected self.assertEqual(_validate_header(header, key, ["Sub1", "suB2"]), (False, None)) def testReadHeader(self): - status, header, status_message = read_headers(HeaderSockMock("data/header01.txt")) + status, header, status_message = read_headers( + HeaderSockMock("data/header01.txt") + ) self.assertEqual(status, 101) self.assertEqual(header["connection"], "Upgrade") - status, header, status_message = read_headers(HeaderSockMock("data/header03.txt")) + status, header, status_message = read_headers( + HeaderSockMock("data/header03.txt") + ) self.assertEqual(status, 101) self.assertEqual(header["connection"], "Upgrade, Keep-Alive") HeaderSockMock("data/header02.txt") - self.assertRaises(ws.WebSocketException, read_headers, HeaderSockMock("data/header02.txt")) + self.assertRaises( + ws.WebSocketException, read_headers, HeaderSockMock("data/header02.txt") + ) def testSend(self): # TODO: add longer frame data @@ -170,33 +181,38 @@ class WebSocketTest(unittest.TestCase): sock.set_mask_key(create_mask_key) s = sock.sock = HeaderSockMock("data/header01.txt") sock.send("Hello") - self.assertEqual(s.sent[0], b'\x81\x85abcd)\x07\x0f\x08\x0e') + self.assertEqual(s.sent[0], b"\x81\x85abcd)\x07\x0f\x08\x0e") sock.send("ã“ã‚“ã«ã¡ã¯") - self.assertEqual(s.sent[1], b'\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc') + self.assertEqual( + s.sent[1], + b"\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc", + ) -# sock.send("x" * 5000) -# self.assertEqual(s.sent[1], b'\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc") + # sock.send("x" * 5000) + # self.assertEqual(s.sent[1], b'\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc") - self.assertEqual(sock.send_binary(b'1111111111101'), 19) + self.assertEqual(sock.send_binary(b"1111111111101"), 19) def testRecv(self): # TODO: add longer frame data sock = ws.WebSocket() s = sock.sock = SockMock() - something = b'\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc' + something = ( + b"\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc" + ) s.add_packet(something) data = sock.recv() self.assertEqual(data, "ã“ã‚“ã«ã¡ã¯") - s.add_packet(b'\x81\x85abcd)\x07\x0f\x08\x0e') + s.add_packet(b"\x81\x85abcd)\x07\x0f\x08\x0e") data = sock.recv() self.assertEqual(data, "Hello") @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def testIter(self): count = 2 - s = ws.create_connection('wss://api.bitfinex.com/ws/2') + s = ws.create_connection("wss://api.bitfinex.com/ws/2") s.send('{"event": "subscribe", "channel": "ticker"}') for _ in s: count -= 1 @@ -205,34 +221,34 @@ class WebSocketTest(unittest.TestCase): @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def testNext(self): - sock = ws.create_connection('wss://api.bitfinex.com/ws/2') + sock = ws.create_connection("wss://api.bitfinex.com/ws/2") self.assertEqual(str, type(next(sock))) def testInternalRecvStrict(self): sock = ws.WebSocket() s = sock.sock = SockMock() - s.add_packet(b'foo') + s.add_packet(b"foo") s.add_packet(socket.timeout()) - s.add_packet(b'bar') + s.add_packet(b"bar") # s.add_packet(SSLError("The read operation timed out")) - s.add_packet(b'baz') + s.add_packet(b"baz") with self.assertRaises(ws.WebSocketTimeoutException): sock.frame_buffer.recv_strict(9) # with self.assertRaises(SSLError): # data = sock._recv_strict(9) data = sock.frame_buffer.recv_strict(9) - self.assertEqual(data, b'foobarbaz') + self.assertEqual(data, b"foobarbaz") with self.assertRaises(ws.WebSocketConnectionClosedException): sock.frame_buffer.recv_strict(1) def testRecvTimeout(self): sock = ws.WebSocket() s = sock.sock = SockMock() - s.add_packet(b'\x81') + s.add_packet(b"\x81") s.add_packet(socket.timeout()) - s.add_packet(b'\x8dabcd\x29\x07\x0f\x08\x0e') + s.add_packet(b"\x8dabcd\x29\x07\x0f\x08\x0e") s.add_packet(socket.timeout()) - s.add_packet(b'\x4e\x43\x33\x0e\x10\x0f\x00\x40') + s.add_packet(b"\x4e\x43\x33\x0e\x10\x0f\x00\x40") with self.assertRaises(ws.WebSocketTimeoutException): sock.recv() with self.assertRaises(ws.WebSocketTimeoutException): @@ -246,9 +262,9 @@ class WebSocketTest(unittest.TestCase): sock = ws.WebSocket() s = sock.sock = SockMock() # OPCODE=TEXT, FIN=0, MSG="Brevity is " - s.add_packet(b'\x01\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C') + s.add_packet(b"\x01\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C") # OPCODE=CONT, FIN=1, MSG="the soul of wit" - s.add_packet(b'\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17') + s.add_packet(b"\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17") data = sock.recv() self.assertEqual(data, "Brevity is the soul of wit") with self.assertRaises(ws.WebSocketConnectionClosedException): @@ -258,21 +274,21 @@ class WebSocketTest(unittest.TestCase): sock = ws.WebSocket(fire_cont_frame=True) s = sock.sock = SockMock() # OPCODE=TEXT, FIN=0, MSG="Brevity is " - s.add_packet(b'\x01\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C') + s.add_packet(b"\x01\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C") # OPCODE=CONT, FIN=0, MSG="Brevity is " - s.add_packet(b'\x00\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C') + s.add_packet(b"\x00\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C") # OPCODE=CONT, FIN=1, MSG="the soul of wit" - s.add_packet(b'\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17') + s.add_packet(b"\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17") _, data = sock.recv_data() - self.assertEqual(data, b'Brevity is ') + self.assertEqual(data, b"Brevity is ") _, data = sock.recv_data() - self.assertEqual(data, b'Brevity is ') + self.assertEqual(data, b"Brevity is ") _, data = sock.recv_data() - self.assertEqual(data, b'the soul of wit') + self.assertEqual(data, b"the soul of wit") # OPCODE=CONT, FIN=0, MSG="Brevity is " - s.add_packet(b'\x80\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C') + s.add_packet(b"\x80\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C") with self.assertRaises(ws.WebSocketException): sock.recv_data() @@ -288,7 +304,7 @@ class WebSocketTest(unittest.TestCase): sock = ws.WebSocket() s = sock.sock = SockMock() sock.connected = True - s.add_packet(b'\x88\x80\x17\x98p\x84') + s.add_packet(b"\x88\x80\x17\x98p\x84") sock.recv() self.assertEqual(sock.connected, False) @@ -296,22 +312,22 @@ class WebSocketTest(unittest.TestCase): sock = ws.WebSocket() s = sock.sock = SockMock() # OPCODE=CONT, FIN=1, MSG="the soul of wit" - s.add_packet(b'\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17') + s.add_packet(b"\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17") self.assertRaises(ws.WebSocketException, sock.recv) def testRecvWithProlongedFragmentation(self): sock = ws.WebSocket() s = sock.sock = SockMock() # OPCODE=TEXT, FIN=0, MSG="Once more unto the breach, " - s.add_packet(b'\x01\x9babcd.\x0c\x00\x01A\x0f\x0c\x16\x04B\x16\n\x15\rC\x10\t\x07C\x06\x13\x07\x02\x07\tNC') + s.add_packet( + b"\x01\x9babcd.\x0c\x00\x01A\x0f\x0c\x16\x04B\x16\n\x15\rC\x10\t\x07C\x06\x13\x07\x02\x07\tNC" + ) # OPCODE=CONT, FIN=0, MSG="dear friends, " - s.add_packet(b'\x00\x8eabcd\x05\x07\x02\x16A\x04\x11\r\x04\x0c\x07\x17MB') + s.add_packet(b"\x00\x8eabcd\x05\x07\x02\x16A\x04\x11\r\x04\x0c\x07\x17MB") # OPCODE=CONT, FIN=1, MSG="once more" - s.add_packet(b'\x80\x89abcd\x0e\x0c\x00\x01A\x0f\x0c\x16\x04') + s.add_packet(b"\x80\x89abcd\x0e\x0c\x00\x01A\x0f\x0c\x16\x04") data = sock.recv() - self.assertEqual( - data, - "Once more unto the breach, dear friends, once more") + self.assertEqual(data, "Once more unto the breach, dear friends, once more") with self.assertRaises(ws.WebSocketConnectionClosedException): sock.recv() @@ -320,22 +336,24 @@ class WebSocketTest(unittest.TestCase): sock.set_mask_key(create_mask_key) s = sock.sock = SockMock() # OPCODE=TEXT, FIN=0, MSG="Too much " - s.add_packet(b'\x01\x89abcd5\r\x0cD\x0c\x17\x00\x0cA') + s.add_packet(b"\x01\x89abcd5\r\x0cD\x0c\x17\x00\x0cA") # OPCODE=PING, FIN=1, MSG="Please PONG this" - s.add_packet(b'\x89\x90abcd1\x0e\x06\x05\x12\x07C4.,$D\x15\n\n\x17') + s.add_packet(b"\x89\x90abcd1\x0e\x06\x05\x12\x07C4.,$D\x15\n\n\x17") # OPCODE=CONT, FIN=1, MSG="of a good thing" - s.add_packet(b'\x80\x8fabcd\x0e\x04C\x05A\x05\x0c\x0b\x05B\x17\x0c\x08\x0c\x04') + s.add_packet(b"\x80\x8fabcd\x0e\x04C\x05A\x05\x0c\x0b\x05B\x17\x0c\x08\x0c\x04") data = sock.recv() self.assertEqual(data, "Too much of a good thing") with self.assertRaises(ws.WebSocketConnectionClosedException): sock.recv() self.assertEqual( - s.sent[0], - b'\x8a\x90abcd1\x0e\x06\x05\x12\x07C4.,$D\x15\n\n\x17') + s.sent[0], b"\x8a\x90abcd1\x0e\x06\x05\x12\x07C4.,$D\x15\n\n\x17" + ) - @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled") + @unittest.skipUnless( + TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled" + ) def testWebSocket(self): - s = ws.create_connection("ws://127.0.0.1:" + LOCAL_WS_SERVER_PORT) + s = ws.create_connection(f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}") self.assertNotEqual(s, None) s.send("Hello, World") result = s.next() @@ -348,9 +366,11 @@ class WebSocketTest(unittest.TestCase): self.assertRaises(ValueError, s.send_close, -1, "") s.close() - @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled") + @unittest.skipUnless( + TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled" + ) def testPingPong(self): - s = ws.create_connection("ws://127.0.0.1:" + LOCAL_WS_SERVER_PORT) + s = ws.create_connection(f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}") self.assertNotEqual(s, None) s.ping("Hello") s.pong("Hi") @@ -359,12 +379,15 @@ class WebSocketTest(unittest.TestCase): @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def testSupportRedirect(self): s = ws.WebSocket() - self.assertRaises(ws._exceptions.WebSocketBadStatusException, s.connect, "ws://google.com/") + self.assertRaises( + ws._exceptions.WebSocketBadStatusException, s.connect, "ws://google.com/" + ) # Need to find a URL that has a redirect code leading to a websocket @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def testSecureWebSocket(self): import ssl + s = ws.create_connection("wss://api.bitfinex.com/ws/2") self.assertNotEqual(s, None) self.assertTrue(isinstance(s.sock, ssl.SSLSocket)) @@ -375,10 +398,14 @@ class WebSocketTest(unittest.TestCase): self.assertEqual(s.getsubprotocol(), None) s.abort() - @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled") + @unittest.skipUnless( + TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled" + ) def testWebSocketWithCustomHeader(self): - s = ws.create_connection("ws://127.0.0.1:" + LOCAL_WS_SERVER_PORT, - headers={"User-Agent": "PythonWebsocketClient"}) + s = ws.create_connection( + f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}", + headers={"User-Agent": "PythonWebsocketClient"}, + ) self.assertNotEqual(s, None) self.assertEqual(s.getsubprotocol(), None) s.send("Hello, World") @@ -387,9 +414,11 @@ class WebSocketTest(unittest.TestCase): self.assertRaises(ValueError, s.close, -1, "") s.close() - @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled") + @unittest.skipUnless( + TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled" + ) def testAfterClose(self): - s = ws.create_connection("ws://127.0.0.1:" + LOCAL_WS_SERVER_PORT) + s = ws.create_connection(f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}") self.assertNotEqual(s, None) s.close() self.assertRaises(ws.WebSocketConnectionClosedException, s.send, "Hello") @@ -397,48 +426,69 @@ class WebSocketTest(unittest.TestCase): class SockOptTest(unittest.TestCase): - @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled") + @unittest.skipUnless( + TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled" + ) def testSockOpt(self): sockopt = ((socket.IPPROTO_TCP, socket.TCP_NODELAY, 1),) - s = ws.create_connection("ws://127.0.0.1:" + LOCAL_WS_SERVER_PORT, sockopt=sockopt) - self.assertNotEqual(s.sock.getsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY), 0) + s = ws.create_connection( + f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}", sockopt=sockopt + ) + self.assertNotEqual( + s.sock.getsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY), 0 + ) s.close() class UtilsTest(unittest.TestCase): def testUtf8Validator(self): - state = validate_utf8(b'\xf0\x90\x80\x80') + state = validate_utf8(b"\xf0\x90\x80\x80") self.assertEqual(state, True) - state = validate_utf8(b'\xce\xba\xe1\xbd\xb9\xcf\x83\xce\xbc\xce\xb5\xed\xa0\x80edited') + state = validate_utf8( + b"\xce\xba\xe1\xbd\xb9\xcf\x83\xce\xbc\xce\xb5\xed\xa0\x80edited" + ) self.assertEqual(state, False) - state = validate_utf8(b'') + state = validate_utf8(b"") self.assertEqual(state, True) class HandshakeTest(unittest.TestCase): @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def test_http_SSL(self): - websock1 = ws.WebSocket(sslopt={"cert_chain": ssl.get_default_verify_paths().capath}, enable_multithread=False) - self.assertRaises(ValueError, - websock1.connect, "wss://api.bitfinex.com/ws/2") + websock1 = ws.WebSocket( + sslopt={"cert_chain": ssl.get_default_verify_paths().capath}, + enable_multithread=False, + ) + self.assertRaises(ValueError, websock1.connect, "wss://api.bitfinex.com/ws/2") websock2 = ws.WebSocket(sslopt={"certfile": "myNonexistentCertFile"}) - self.assertRaises(FileNotFoundError, - websock2.connect, "wss://api.bitfinex.com/ws/2") + self.assertRaises( + FileNotFoundError, websock2.connect, "wss://api.bitfinex.com/ws/2" + ) @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled") def testManualHeaders(self): - websock3 = ws.WebSocket(sslopt={"ca_certs": ssl.get_default_verify_paths().cafile, - "ca_cert_path": ssl.get_default_verify_paths().capath}) - self.assertRaises(ws._exceptions.WebSocketBadStatusException, - websock3.connect, "wss://api.bitfinex.com/ws/2", cookie="chocolate", - origin="testing_websockets.com", - host="echo.websocket.events/websocket-client-test", - subprotocols=["testproto"], - connection="Upgrade", - header={"CustomHeader1":"123", - "Cookie":"TestValue", - "Sec-WebSocket-Key":"k9kFAUWNAMmf5OEMfTlOEA==", - "Sec-WebSocket-Protocol":"newprotocol"}) + websock3 = ws.WebSocket( + sslopt={ + "ca_certs": ssl.get_default_verify_paths().cafile, + "ca_cert_path": ssl.get_default_verify_paths().capath, + } + ) + self.assertRaises( + ws._exceptions.WebSocketBadStatusException, + websock3.connect, + "wss://api.bitfinex.com/ws/2", + cookie="chocolate", + origin="testing_websockets.com", + host="echo.websocket.events/websocket-client-test", + subprotocols=["testproto"], + connection="Upgrade", + header={ + "CustomHeader1": "123", + "Cookie": "TestValue", + "Sec-WebSocket-Key": "k9kFAUWNAMmf5OEMfTlOEA==", + "Sec-WebSocket-Protocol": "newprotocol", + }, + ) def testIPv6(self): websock2 = ws.WebSocket() @@ -447,7 +497,9 @@ class HandshakeTest(unittest.TestCase): def testBadURLs(self): websock3 = ws.WebSocket() self.assertRaises(ValueError, websock3.connect, "ws//example.com") - self.assertRaises(ws.WebSocketAddressException, websock3.connect, "ws://example") + self.assertRaises( + ws.WebSocketAddressException, websock3.connect, "ws://example" + ) self.assertRaises(ValueError, websock3.connect, "example.com") diff --git a/requirements.txt b/requirements.txt index 8c8e91f3..bdf83410 100644 --- a/requirements.txt +++ b/requirements.txt @@ -47,7 +47,7 @@ tzdata==2023.3 tzlocal==5.0.1 urllib3<2 webencodings==0.5.1 -websocket-client==1.6.2 +websocket-client==1.7.0 xmltodict==0.13.0 zipp==3.16.2 From 52819f7da6ca8434ecc632f9b1a155bd690d9b81 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 15:22:05 -0700 Subject: [PATCH 079/290] Bump pytz from 2023.3 to 2024.1 (#2254) * Bump pytz from 2023.3 to 2024.1 Bumps [pytz](https://github.com/stub42/pytz) from 2023.3 to 2024.1. - [Release notes](https://github.com/stub42/pytz/releases) - [Commits](https://github.com/stub42/pytz/compare/release_2023.3...release_2024.1) --- updated-dependencies: - dependency-name: pytz dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] * Update pytz==2024.1 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/pytz/__init__.py | 4 +- lib/pytz/tzinfo.py | 11 +- lib/pytz/zoneinfo/America/Godthab | Bin 1903 -> 1889 bytes lib/pytz/zoneinfo/America/Miquelon | Bin 1652 -> 1652 bytes lib/pytz/zoneinfo/America/Montreal | Bin 3494 -> 3494 bytes lib/pytz/zoneinfo/America/Nassau | Bin 3494 -> 3494 bytes lib/pytz/zoneinfo/America/Nipigon | Bin 3494 -> 3494 bytes lib/pytz/zoneinfo/America/Nuuk | Bin 1903 -> 1889 bytes lib/pytz/zoneinfo/America/Scoresbysund | Bin 1902 -> 1935 bytes lib/pytz/zoneinfo/America/Thunder_Bay | Bin 3494 -> 3494 bytes lib/pytz/zoneinfo/America/Toronto | Bin 3494 -> 3494 bytes lib/pytz/zoneinfo/Antarctica/Casey | Bin 370 -> 423 bytes lib/pytz/zoneinfo/Antarctica/Vostok | Bin 151 -> 213 bytes lib/pytz/zoneinfo/Asia/Almaty | Bin 983 -> 983 bytes lib/pytz/zoneinfo/Asia/Gaza | Bin 3808 -> 3844 bytes lib/pytz/zoneinfo/Asia/Hebron | Bin 3836 -> 3872 bytes lib/pytz/zoneinfo/Asia/Ho_Chi_Minh | Bin 337 -> 337 bytes lib/pytz/zoneinfo/Asia/Qostanay | Bin 997 -> 1025 bytes lib/pytz/zoneinfo/Asia/Saigon | Bin 337 -> 337 bytes lib/pytz/zoneinfo/Canada/Eastern | Bin 3494 -> 3494 bytes lib/pytz/zoneinfo/iso3166.tab | 17 +- lib/pytz/zoneinfo/leapseconds | 19 +- lib/pytz/zoneinfo/tzdata.zi | 3961 ++++++++++++------------ lib/pytz/zoneinfo/zone.tab | 24 +- lib/pytz/zoneinfo/zone1970.tab | 29 +- lib/pytz/zoneinfo/zonenow.tab | 303 ++ requirements.txt | 2 +- 27 files changed, 2344 insertions(+), 2026 deletions(-) create mode 100644 lib/pytz/zoneinfo/zonenow.tab diff --git a/lib/pytz/__init__.py b/lib/pytz/__init__.py index 98b66553..2355f8b4 100644 --- a/lib/pytz/__init__.py +++ b/lib/pytz/__init__.py @@ -22,8 +22,8 @@ from pytz.tzfile import build_tzinfo # The IANA (nee Olson) database is updated several times a year. -OLSON_VERSION = '2023c' -VERSION = '2023.3' # pip compatible version number. +OLSON_VERSION = '2024a' +VERSION = '2024.1' # pip compatible version number. __version__ = VERSION OLSEN_VERSION = OLSON_VERSION # Old releases had this misspelling diff --git a/lib/pytz/tzinfo.py b/lib/pytz/tzinfo.py index 725978d5..49b5c3fe 100644 --- a/lib/pytz/tzinfo.py +++ b/lib/pytz/tzinfo.py @@ -24,7 +24,8 @@ def memorized_timedelta(seconds): _timedelta_cache[seconds] = delta return delta -_epoch = datetime.utcfromtimestamp(0) + +_epoch = datetime(1970, 1, 1, 0, 0) # datetime.utcfromtimestamp(0) _datetime_cache = {0: _epoch} @@ -33,12 +34,13 @@ def memorized_datetime(seconds): try: return _datetime_cache[seconds] except KeyError: - # NB. We can't just do datetime.utcfromtimestamp(seconds) as this - # fails with negative values under Windows (Bug #90096) + # NB. We can't just do datetime.fromtimestamp(seconds, tz=timezone.utc).replace(tzinfo=None) + # as this fails with negative values under Windows (Bug #90096) dt = _epoch + timedelta(seconds=seconds) _datetime_cache[seconds] = dt return dt + _ttinfo_cache = {} @@ -55,6 +57,7 @@ def memorized_ttinfo(*args): _ttinfo_cache[args] = ttinfo return ttinfo + _notime = memorized_timedelta(0) @@ -355,7 +358,7 @@ class DstTzInfo(BaseTzInfo): is_dst=False) + timedelta(hours=6) # If we get this far, we have multiple possible timezones - this - # is an ambiguous case occuring during the end-of-DST transition. + # is an ambiguous case occurring during the end-of-DST transition. # If told to be strict, raise an exception since we have an # ambiguous case diff --git a/lib/pytz/zoneinfo/America/Godthab b/lib/pytz/zoneinfo/America/Godthab index adb7934aadf5f45928ce67e82efa92ca92391703..29958cf12a9df7cf775e3337b4894e4cf4b82f58 100644 GIT binary patch delta 54 zcmaFQ_mFRbGGoa`l?=wo6Bv(A{>UaeiJfgS3%l3ky-Yxf%@3K*Fm2w-YRrg`$_4-+ CSrVE6 delta 70 zcmaFJ_nvQpGGpmRl?+CfRNHkECigHNXJnrIkWGB@2R63J1x(qDrJL_ConZpYZeGG_ N&WIxIG1-A#5de#87;FFl diff --git a/lib/pytz/zoneinfo/America/Miquelon b/lib/pytz/zoneinfo/America/Miquelon index 5eccd861071d4eccb76fe0d8f5195bd1a7f646b7..f780ea990ff22675b5cc4e4dbe2c8690ae4e41b4 100644 GIT binary patch delta 23 ccmeyu^Mz-EF7thHjg1DeOdxvm1g0m<0BZ>dYybcN delta 23 ccmeyu^Mz-EF7q~v6&np=nLzaB2~1Cz0dxlmTmS$7 diff --git a/lib/pytz/zoneinfo/America/Montreal b/lib/pytz/zoneinfo/America/Montreal index 6752c5b05285678b86aea170f0921fc5f5e57738..170137333f9f6dba10ac3ad7f32876aaf518c4fd 100644 GIT binary patch delta 82 zcmZ1`y-a$-FR^1Et|{z)aNTsphZ_tFAKVn}`f$s5Qo?2d#`UaP$3FZA0+2k22B`tj SAax)bq!vVj)xTuh%LV{v;5Kvs delta 82 zcmZ1`y-a$-FR@h@t|=@&aNV@$!VQMj12;wUF5EIMbJ#4vxSmyO)rJ2+0FnpMAT=Nw Rqz*)b)PiWR`j>2b*#PJ9Go%0j diff --git a/lib/pytz/zoneinfo/America/Nassau b/lib/pytz/zoneinfo/America/Nassau index 6752c5b05285678b86aea170f0921fc5f5e57738..170137333f9f6dba10ac3ad7f32876aaf518c4fd 100644 GIT binary patch delta 82 zcmZ1`y-a$-FR^1Et|{z)aNTsphZ_tFAKVn}`f$s5Qo?2d#`UaP$3FZA0+2k22B`tj SAax)bq!vVj)xTuh%LV{v;5Kvs delta 82 zcmZ1`y-a$-FR@h@t|=@&aNV@$!VQMj12;wUF5EIMbJ#4vxSmyO)rJ2+0FnpMAT=Nw Rqz*)b)PiWR`j>2b*#PJ9Go%0j diff --git a/lib/pytz/zoneinfo/America/Nipigon b/lib/pytz/zoneinfo/America/Nipigon index 6752c5b05285678b86aea170f0921fc5f5e57738..170137333f9f6dba10ac3ad7f32876aaf518c4fd 100644 GIT binary patch delta 82 zcmZ1`y-a$-FR^1Et|{z)aNTsphZ_tFAKVn}`f$s5Qo?2d#`UaP$3FZA0+2k22B`tj SAax)bq!vVj)xTuh%LV{v;5Kvs delta 82 zcmZ1`y-a$-FR@h@t|=@&aNV@$!VQMj12;wUF5EIMbJ#4vxSmyO)rJ2+0FnpMAT=Nw Rqz*)b)PiWR`j>2b*#PJ9Go%0j diff --git a/lib/pytz/zoneinfo/America/Nuuk b/lib/pytz/zoneinfo/America/Nuuk index adb7934aadf5f45928ce67e82efa92ca92391703..29958cf12a9df7cf775e3337b4894e4cf4b82f58 100644 GIT binary patch delta 54 zcmaFQ_mFRbGGoa`l?=wo6Bv(A{>UaeiJfgS3%l3ky-Yxf%@3K*Fm2w-YRrg`$_4-+ CSrVE6 delta 70 zcmaFJ_nvQpGGpmRl?+CfRNHkECigHNXJnrIkWGB@2R63J1x(qDrJL_ConZpYZeGG_ N&WIxIG1-A#5de#87;FFl diff --git a/lib/pytz/zoneinfo/America/Scoresbysund b/lib/pytz/zoneinfo/America/Scoresbysund index 286d13216eb3b14bf9fec1fceebf2fe731472d39..9bf411ef5ad5f81f3863223ea75117404d5d1421 100644 GIT binary patch delta 251 zcmaFI*UzsJ5|x=|%zyznfg&Ib0;NFAxlzNANrs&RH=NAIuEq2J|HluE9RL46e!##o z*??W#n2`}=0+3{6B-W~RKBOqyLr{im^XR2qQuWP8|YiIyw H8gKys5jrGH delta 204 zcmeC@f5)d05|x=|#DD?Vfg&Ib0;NFAzEQ)FY4QO!naN`8T5dkRAq=_(MnG)Hplx6P zlxGA2kXj&vfmkCqe`R82fthKC-%KtWpj~!`HbC3#bbO8VO!W-(4Rm}B4ZtizE&#Rx B8D#(f diff --git a/lib/pytz/zoneinfo/America/Thunder_Bay b/lib/pytz/zoneinfo/America/Thunder_Bay index 6752c5b05285678b86aea170f0921fc5f5e57738..170137333f9f6dba10ac3ad7f32876aaf518c4fd 100644 GIT binary patch delta 82 zcmZ1`y-a$-FR^1Et|{z)aNTsphZ_tFAKVn}`f$s5Qo?2d#`UaP$3FZA0+2k22B`tj SAax)bq!vVj)xTuh%LV{v;5Kvs delta 82 zcmZ1`y-a$-FR@h@t|=@&aNV@$!VQMj12;wUF5EIMbJ#4vxSmyO)rJ2+0FnpMAT=Nw Rqz*)b)PiWR`j>2b*#PJ9Go%0j diff --git a/lib/pytz/zoneinfo/America/Toronto b/lib/pytz/zoneinfo/America/Toronto index 6752c5b05285678b86aea170f0921fc5f5e57738..170137333f9f6dba10ac3ad7f32876aaf518c4fd 100644 GIT binary patch delta 82 zcmZ1`y-a$-FR^1Et|{z)aNTsphZ_tFAKVn}`f$s5Qo?2d#`UaP$3FZA0+2k22B`tj SAax)bq!vVj)xTuh%LV{v;5Kvs delta 82 zcmZ1`y-a$-FR@h@t|=@&aNV@$!VQMj12;wUF5EIMbJ#4vxSmyO)rJ2+0FnpMAT=Nw Rqz*)b)PiWR`j>2b*#PJ9Go%0j diff --git a/lib/pytz/zoneinfo/Antarctica/Casey b/lib/pytz/zoneinfo/Antarctica/Casey index 4b98133d7af497a840e2630bc72a02439c4d774f..586a7653ef20d04440bfcb6645454ef215a1bba4 100644 GIT binary patch literal 423 zcmWHE%1kq2zyK^j5fBCeK_CXPdH%_rY4Ezmrr_Ow>Vx0PIST&HXD38(SvN#2;TMSB zDdG^*E87q|&D9_-`6xqt#R8iIpX~vO5luEpIx_>3EmCY!I5sjcGBGkS12G(eYyg3R z29PDQHZX8N*t!M=4B7@34BCcAOP|lhz5BOM1wpDqCp-7(IC%)Xo@||WdjTXJ6#Jd E02EY6j{pDw delta 150 zcmZ3^{E2CTxF9P70|N+y01ptePSh~rVPs-tVg_OmoY*KK!@w|W0|SSyfdPZIfdzxM ep&>{$BZRFb;1VjD<0ZxOsY=Fku I>6&o?0LBIr)c^nh diff --git a/lib/pytz/zoneinfo/Asia/Almaty b/lib/pytz/zoneinfo/Asia/Almaty index 91c916a3a5d7949cc304532fe3fb2eac117ab2ef..855abbd6e3ee338c3d46bee7b592f3d645d2c273 100644 GIT binary patch delta 134 zcmcc4ew}@SG%qIu1egFR&WRcqSW+JxQ<(U}n2~X^Hlvw{k8cQrwt*=Sn**^KSncE* hMg>%Tn^!WXS+eYkYoCHe1rxa`{yT%PTM%U>4LIxC+xl2z4acv+hSfMCtBc*n zeqCM;Z1g&Z-Z*d=HnD8R#cS-voh1rpx!mnOLWh zlm!cIp1-+Z@%g37x{G;tt_}~`qVK`By(YLP!H?6RC$#|X^}U3?cf=3w^Y4WFqB14_ z$>TJzTdZ#6d^iQ`_fA0H?@Z@phcXPk%JJ4A4OWk0VW9IQJb2Lo50)a>;AA{54AmY) zKOCA54`(il&oMUK5d@DEY@r`nTYyJn)bOZI`sv1Q9T2w}8?&huVyM{I_9mynxN;sB zCK5M^Y{C>RdE5j~Uil191y8|K*+$7PQ#cKrr<-8s?mP6;Nhu0COczRj{+VN4@XSIT z`dOcL(H9t-P0N%9J7z4*bv=aVR<63~@I8E&BV8Q5t5pxXKI}@~$mP~Z|Fbe-*<+t@ HL$3J`1v@2F delta 1028 zcmXBST}V@57zgloT8UO>r1^mk$)N8nNet2`yO2VNB#gqOZuCOJEpHN`bINU++Wa_f zZfZw!8W9NLEDJPhrkkHjH=Rx+g|I|}lTefxcAoz^H}CU%{{Q#v;!LMrhiJxwDngQ~v8U{OJ7%Pp-)GlQ~u)W+;m( z3ksF3op4p!14%Bhs)BCC@4Df~d^KzgKZL$9J%?({D4LO1-_jzlUNj@Gi4KHo?%zXR zd(lXBR{JJRHYX2D8WiesZ=fJ3?`4Aih2p*_T&O>r3Y&tnU{g+(h6YoG9yTAi4x5)x z!3{}&(QmkYl&6Iy=nQhp&|c(LmM78gGi!=hS$vB_p|LB8r$wVL6mHsj9(mK?Cfr;X zj=Z_OMDg5r_{p>Zmecv1hcNvg4rV>{r1Eyc(OZFbxnoLGXL!70d{-b~n~ zjYsZ!u6zpDay0Ux?&HXZGhFa6m#la)8GUY~J`9Udbs-j`nQe-@BH^*3HF#`g9v)A) z#ON8XRX&CL<}TRn&}nFJOFi%>?Hu|OsXyTf>k-AyT%Hz_SNg~t^Tc|{%#&w9!6R;i zy(e2>@5U>5D(#$xhN*%gcsiyRo}O=jeIcE&FFl5*g>PMiXL^f~&n#Y*Xqb(1z_Wf{ e&gK7&zr)1S#^1An3;v}YPRfpZ~FO(`0+7)t%#?JXbQIq=Tq>+q!gmK)8kUJ)E|wu0>p(?*S|!7#05 zl!h{hIm4&#B(bMVUwud&{?MJNb$di-++Ajr?dQtR6r(Cwc@@+J)BBA009T?-Mqbc& zA}9blXBox7<_)7Wu)HcL3(}*YDi{tj>Voq&LEOX@+nyjV`0ip9F!6n5=R(KwKl$-3>G|J;^n%AC z^g&^9M|#n`EceA1i}aH9UV3TF|L@;np%2O_ttI*9Ko2ul?w-&CJdB`+g)9CldVp>f tJ;3&-pcq&=MGr7NhxdWe40?b*KYDv&(U3;hAsr%m2t@>eLpB7VwAqqDlY>N3Q$u(`Z77Q1jFFlj z&>}=Hhz5tWbO?u{EutkP$OmtXNb06$LvX|kLBLBHyQkpjbwN*ZeCI&UoxlKZkf}bLweZ9nei>KNj7qTI+0$ym$yQw85m|8pmdS%OV3XXK5~!1NFMx`Tv+e~zm3;ja7_#xj zs}s3DyI+(0bBT`3=UeZFdC7;1!nCk*Cv(v|By-7Ekh%18OZ#m4%<819SO2o|pPKq? zj=_D?A@f7muI$$fnw+aYwFGwToLw9PatCLLS%H2sm=_o!J({b f;2Rm+0ql^0QGs0H%vlBWlPw=;5oO+jrvvGK>WF^6 diff --git a/lib/pytz/zoneinfo/Asia/Ho_Chi_Minh b/lib/pytz/zoneinfo/Asia/Ho_Chi_Minh index a213d290e1a920271e924506a57191f1f4bfc4c0..9c45ed991a230919d129c63c660aa8d1ad74d0ea 100644 GIT binary patch delta 25 hcmcb}bdhO-8|$YDZ}n$PW@L1qI4Ozg(}aoNq5+R=3x5Cr delta 25 hcmcb}bdhO-8|#yXxB4?CGcvkQoRq}$q+#N>XaJ1b3qt?^ diff --git a/lib/pytz/zoneinfo/Asia/Qostanay b/lib/pytz/zoneinfo/Asia/Qostanay index f8baf676496adea298f078d6d5931ba7aa64e902..2ee9ef7e9859bc95da2450e3b282fd4275cbbb39 100644 GIT binary patch delta 113 zcmaFL-pDaQnwN(G0!)Au&qR$2EU6EUDNOcZHfCg+T+i&p#=zhfz`!y2AhR?h1G@6f Z8yM#>a)9*X)WpTWWut9iYNu<;1pxiI75@ML delta 78 zcmZqVc*;IOnwOga0*rwa_e6~glM|SYCmS$2O}@h{jV`@;591t0WCfgDHrfVecDiO< E0Bdg$5dZ)H diff --git a/lib/pytz/zoneinfo/Asia/Saigon b/lib/pytz/zoneinfo/Asia/Saigon index a213d290e1a920271e924506a57191f1f4bfc4c0..9c45ed991a230919d129c63c660aa8d1ad74d0ea 100644 GIT binary patch delta 25 hcmcb}bdhO-8|$YDZ}n$PW@L1qI4Ozg(}aoNq5+R=3x5Cr delta 25 hcmcb}bdhO-8|#yXxB4?CGcvkQoRq}$q+#N>XaJ1b3qt?^ diff --git a/lib/pytz/zoneinfo/Canada/Eastern b/lib/pytz/zoneinfo/Canada/Eastern index 6752c5b05285678b86aea170f0921fc5f5e57738..170137333f9f6dba10ac3ad7f32876aaf518c4fd 100644 GIT binary patch delta 82 zcmZ1`y-a$-FR^1Et|{z)aNTsphZ_tFAKVn}`f$s5Qo?2d#`UaP$3FZA0+2k22B`tj SAax)bq!vVj)xTuh%LV{v;5Kvs delta 82 zcmZ1`y-a$-FR@h@t|=@&aNV@$!VQMj12;wUF5EIMbJ#4vxSmyO)rJ2+0FnpMAT=Nw Rqz*)b)PiWR`j>2b*#PJ9Go%0j diff --git a/lib/pytz/zoneinfo/iso3166.tab b/lib/pytz/zoneinfo/iso3166.tab index be3348d1..402c015e 100644 --- a/lib/pytz/zoneinfo/iso3166.tab +++ b/lib/pytz/zoneinfo/iso3166.tab @@ -3,17 +3,22 @@ # This file is in the public domain, so clarified as of # 2009-05-17 by Arthur David Olson. # -# From Paul Eggert (2022-11-18): +# From Paul Eggert (2023-09-06): # This file contains a table of two-letter country codes. Columns are # separated by a single tab. Lines beginning with '#' are comments. # All text uses UTF-8 encoding. The columns of the table are as follows: # # 1. ISO 3166-1 alpha-2 country code, current as of -# ISO 3166-1 N1087 (2022-09-02). See: Updates on ISO 3166-1 -# https://isotc.iso.org/livelink/livelink/Open/16944257 -# 2. The usual English name for the coded region, -# chosen so that alphabetic sorting of subsets produces helpful lists. -# This is not the same as the English name in the ISO 3166 tables. +# ISO/TC 46 N1108 (2023-04-05). See: ISO/TC 46 Documents +# https://www.iso.org/committee/48750.html?view=documents +# 2. The usual English name for the coded region. This sometimes +# departs from ISO-listed names, sometimes so that sorted subsets +# of names are useful (e.g., "Samoa (American)" and "Samoa +# (western)" rather than "American Samoa" and "Samoa"), +# sometimes to avoid confusion among non-experts (e.g., +# "Czech Republic" and "Turkey" rather than "Czechia" and "Türkiye"), +# and sometimes to omit needless detail or churn (e.g., "Netherlands" +# rather than "Netherlands (the)" or "Netherlands (Kingdom of the)"). # # The table is sorted by country code. # diff --git a/lib/pytz/zoneinfo/leapseconds b/lib/pytz/zoneinfo/leapseconds index a6a170aa..ce150bfe 100644 --- a/lib/pytz/zoneinfo/leapseconds +++ b/lib/pytz/zoneinfo/leapseconds @@ -3,13 +3,10 @@ # This file is in the public domain. # This file is generated automatically from the data in the public-domain -# NIST format leap-seconds.list file, which can be copied from -# -# or . -# The NIST file is used instead of its IERS upstream counterpart +# NIST/IERS format leap-seconds.list file, which can be copied from # -# because under US law the NIST file is public domain -# whereas the IERS file's copyright and license status is unclear. +# or, in a variant with different comments, from +# . # For more about leap-seconds.list, please see # The NTP Timescale and Leap Seconds # . @@ -72,11 +69,11 @@ Leap 2016 Dec 31 23:59:60 + S # Any additional leap seconds will come after this. # This Expires line is commented out for now, # so that pre-2020a zic implementations do not reject this file. -#Expires 2023 Dec 28 00:00:00 +#Expires 2024 Dec 28 00:00:00 # POSIX timestamps for the data in this file: -#updated 1467936000 (2016-07-08 00:00:00 UTC) -#expires 1703721600 (2023-12-28 00:00:00 UTC) +#updated 1704708379 (2024-01-08 10:06:19 UTC) +#expires 1735344000 (2024-12-28 00:00:00 UTC) -# Updated through IERS Bulletin C65 -# File expires on: 28 December 2023 +# Updated through IERS Bulletin C (https://hpiers.obspm.fr/iers/bul/bulc/bulletinc.dat) +# File expires on 28 December 2024 diff --git a/lib/pytz/zoneinfo/tzdata.zi b/lib/pytz/zoneinfo/tzdata.zi index 23d99be4..b5a03be7 100644 --- a/lib/pytz/zoneinfo/tzdata.zi +++ b/lib/pytz/zoneinfo/tzdata.zi @@ -1,4 +1,4 @@ -# version unknown-dirty +# version unknown # This zic input file is in the public domain. R d 1916 o - Jun 14 23s 1 S R d 1916 1919 - O Su>=1 23s 0 - @@ -22,27 +22,6 @@ R d 1978 o - Mar 24 1 1 S R d 1978 o - S 22 3 0 - R d 1980 o - Ap 25 0 1 S R d 1980 o - O 31 2 0 - -Z Africa/Algiers 0:12:12 - LMT 1891 Mar 16 -0:9:21 - PMT 1911 Mar 11 -0 d WE%sT 1940 F 25 2 -1 d CE%sT 1946 O 7 -0 - WET 1956 Ja 29 -1 - CET 1963 Ap 14 -0 d WE%sT 1977 O 21 -1 d CE%sT 1979 O 26 -0 d WE%sT 1981 May -1 - CET -Z Atlantic/Cape_Verde -1:34:4 - LMT 1912 Ja 1 2u --2 - -02 1942 S --2 1 -01 1945 O 15 --2 - -02 1975 N 25 2 --1 - -01 -Z Africa/Ndjamena 1:0:12 - LMT 1912 -1 - WAT 1979 O 14 -1 1 WAST 1980 Mar 8 -1 - WAT -Z Africa/Abidjan -0:16:8 - LMT 1912 -0 - GMT R K 1940 o - Jul 15 0 1 S R K 1940 o - O 1 0 0 - R K 1941 o - Ap 15 0 1 S @@ -77,21 +56,6 @@ R K 2014 o - Jul 31 24 1 S R K 2014 o - S lastTh 24 0 - R K 2023 ma - Ap lastF 0 1 S R K 2023 ma - O lastTh 24 0 - -Z Africa/Cairo 2:5:9 - LMT 1900 O -2 K EE%sT -Z Africa/Bissau -1:2:20 - LMT 1912 Ja 1 1u --1 - -01 1975 -0 - GMT -Z Africa/Nairobi 2:27:16 - LMT 1908 May -2:30 - +0230 1928 Jun 30 24 -3 - EAT 1930 Ja 4 24 -2:30 - +0230 1936 D 31 24 -2:45 - +0245 1942 Jul 31 24 -3 - EAT -Z Africa/Monrovia -0:43:8 - LMT 1882 --0:43:8 - MMT 1919 Mar --0:44:30 - MMT 1972 Ja 7 -0 - GMT R L 1951 o - O 14 2 1 S R L 1952 o - Ja 1 0 0 - R L 1953 o - O 9 2 1 S @@ -109,21 +73,10 @@ R L 1997 o - Ap 4 0 1 S R L 1997 o - O 4 0 0 - R L 2013 o - Mar lastF 1 1 S R L 2013 o - O lastF 2 0 - -Z Africa/Tripoli 0:52:44 - LMT 1920 -1 L CE%sT 1959 -2 - EET 1982 -1 L CE%sT 1990 May 4 -2 - EET 1996 S 30 -1 L CE%sT 1997 O 4 -2 - EET 2012 N 10 2 -1 L CE%sT 2013 O 25 2 -2 - EET R MU 1982 o - O 10 0 1 - R MU 1983 o - Mar 21 0 0 - R MU 2008 o - O lastSu 2 1 - R MU 2009 o - Mar lastSu 2 0 - -Z Indian/Mauritius 3:50 - LMT 1907 -4 MU +04/+05 R M 1939 o - S 12 0 1 - R M 1939 o - N 19 0 0 - R M 1940 o - F 25 0 1 - @@ -307,53 +260,15 @@ R M 2086 o - Ap 14 3 -1 - R M 2086 o - May 19 2 0 - R M 2087 o - Mar 30 3 -1 - R M 2087 o - May 11 2 0 - -Z Africa/Casablanca -0:30:20 - LMT 1913 O 26 -0 M +00/+01 1984 Mar 16 -1 - +01 1986 -0 M +00/+01 2018 O 28 3 -1 M +01/+00 -Z Africa/El_Aaiun -0:52:48 - LMT 1934 --1 - -01 1976 Ap 14 -0 M +00/+01 2018 O 28 3 -1 M +01/+00 -Z Africa/Maputo 2:10:20 - LMT 1903 Mar -2 - CAT R NA 1994 o - Mar 21 0 -1 WAT R NA 1994 2017 - S Su>=1 2 0 CAT R NA 1995 2017 - Ap Su>=1 2 -1 WAT -Z Africa/Windhoek 1:8:24 - LMT 1892 F 8 -1:30 - +0130 1903 Mar -2 - SAST 1942 S 20 2 -2 1 SAST 1943 Mar 21 2 -2 - SAST 1990 Mar 21 -2 NA %s -Z Africa/Lagos 0:13:35 - LMT 1905 Jul -0 - GMT 1908 Jul -0:13:35 - LMT 1914 -0:30 - +0030 1919 S -1 - WAT -Z Africa/Sao_Tome 0:26:56 - LMT 1884 --0:36:45 - LMT 1912 Ja 1 0u -0 - GMT 2018 Ja 1 1 -1 - WAT 2019 Ja 1 2 -0 - GMT R SA 1942 1943 - S Su>=15 2 1 - R SA 1943 1944 - Mar Su>=15 2 0 - -Z Africa/Johannesburg 1:52 - LMT 1892 F 8 -1:30 - SAST 1903 Mar -2 SA SAST R SD 1970 o - May 1 0 1 S R SD 1970 1985 - O 15 0 0 - R SD 1971 o - Ap 30 0 1 S R SD 1972 1985 - Ap lastSu 0 1 S -Z Africa/Khartoum 2:10:8 - LMT 1931 -2 SD CA%sT 2000 Ja 15 12 -3 - EAT 2017 N -2 - CAT -Z Africa/Juba 2:6:28 - LMT 1931 -2 SD CA%sT 2000 Ja 15 12 -3 - EAT 2021 F -2 - CAT R n 1939 o - Ap 15 23s 1 S R n 1939 o - N 18 23s 0 - R n 1940 o - F 25 23s 1 S @@ -379,80 +294,14 @@ R n 2005 o - May 1 0s 1 S R n 2005 o - S 30 1s 0 - R n 2006 2008 - Mar lastSu 2s 1 S R n 2006 2008 - O lastSu 2s 0 - -Z Africa/Tunis 0:40:44 - LMT 1881 May 12 -0:9:21 - PMT 1911 Mar 11 -1 n CE%sT -Z Antarctica/Casey 0 - -00 1969 -8 - +08 2009 O 18 2 -11 - +11 2010 Mar 5 2 -8 - +08 2011 O 28 2 -11 - +11 2012 F 21 17u -8 - +08 2016 O 22 -11 - +11 2018 Mar 11 4 -8 - +08 2018 O 7 4 -11 - +11 2019 Mar 17 3 -8 - +08 2019 O 4 3 -11 - +11 2020 Mar 8 3 -8 - +08 2020 O 4 0:1 -11 - +11 -Z Antarctica/Davis 0 - -00 1957 Ja 13 -7 - +07 1964 N -0 - -00 1969 F -7 - +07 2009 O 18 2 -5 - +05 2010 Mar 10 20u -7 - +07 2011 O 28 2 -5 - +05 2012 F 21 20u -7 - +07 -Z Antarctica/Mawson 0 - -00 1954 F 13 -6 - +06 2009 O 18 2 -5 - +05 R Tr 2005 ma - Mar lastSu 1u 2 +02 R Tr 2004 ma - O lastSu 1u 0 +00 -Z Antarctica/Troll 0 - -00 2005 F 12 -0 Tr %s -Z Antarctica/Rothera 0 - -00 1976 D --3 - -03 -Z Asia/Kabul 4:36:48 - LMT 1890 -4 - +04 1945 -4:30 - +0430 R AM 2011 o - Mar lastSu 2s 1 - R AM 2011 o - O lastSu 2s 0 - -Z Asia/Yerevan 2:58 - LMT 1924 May 2 -3 - +03 1957 Mar -4 R +04/+05 1991 Mar 31 2s -3 R +03/+04 1995 S 24 2s -4 - +04 1997 -4 R +04/+05 2011 -4 AM +04/+05 R AZ 1997 2015 - Mar lastSu 4 1 - R AZ 1997 2015 - O lastSu 5 0 - -Z Asia/Baku 3:19:24 - LMT 1924 May 2 -3 - +03 1957 Mar -4 R +04/+05 1991 Mar 31 2s -3 R +03/+04 1992 S lastSu 2s -4 - +04 1996 -4 E +04/+05 1997 -4 AZ +04/+05 R BD 2009 o - Jun 19 23 1 - R BD 2009 o - D 31 24 0 - -Z Asia/Dhaka 6:1:40 - LMT 1890 -5:53:20 - HMT 1941 O -6:30 - +0630 1942 May 15 -5:30 - +0530 1942 S -6:30 - +0630 1951 S 30 -6 - +06 2009 -6 BD +06/+07 -Z Asia/Thimphu 5:58:36 - LMT 1947 Au 15 -5:30 - +0530 1987 O -6 - +06 -Z Indian/Chagos 4:49:40 - LMT 1907 -5 - +05 1996 -6 - +06 -Z Asia/Yangon 6:24:47 - LMT 1880 -6:24:47 - RMT 1920 -6:30 - +0630 1942 May -9 - +09 1945 May 3 -6:30 - +0630 R Sh 1919 o - Ap 12 24 1 D R Sh 1919 o - S 30 24 0 S R Sh 1940 o - Jun 1 0 1 D @@ -470,11 +319,6 @@ R Sh 1948 1949 - S 30 24 0 S R CN 1986 o - May 4 2 1 D R CN 1986 1991 - S Su>=11 2 0 S R CN 1987 1991 - Ap Su>=11 2 1 D -Z Asia/Shanghai 8:5:43 - LMT 1901 -8 Sh C%sT 1949 May 28 -8 CN C%sT -Z Asia/Urumqi 5:50:20 - LMT 1928 -6 - +06 R HK 1946 o - Ap 21 0 1 S R HK 1946 o - D 1 3:30s 0 - R HK 1947 o - Ap 13 3:30s 1 S @@ -489,12 +333,6 @@ R HK 1965 1976 - O Su>=16 3:30 0 - R HK 1973 o - D 30 3:30 1 S R HK 1979 o - May 13 3:30 1 S R HK 1979 o - O 21 3:30 0 - -Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 29 17u -8 - HKT 1941 Jun 15 3 -8 1 HKST 1941 O 1 4 -8 0:30 HKWT 1941 D 25 -9 - JST 1945 N 18 2 -8 HK HK%sT R f 1946 o - May 15 0 1 D R f 1946 o - O 1 0 0 S R f 1947 o - Ap 15 0 1 D @@ -510,10 +348,6 @@ R f 1974 1975 - Ap 1 0 1 D R f 1974 1975 - O 1 0 0 S R f 1979 o - Jul 1 0 1 D R f 1979 o - O 1 0 0 S -Z Asia/Taipei 8:6 - LMT 1896 -8 - CST 1937 O -9 - JST 1945 S 21 1 -8 f C%sT R _ 1942 1943 - Ap 30 23 1 - R _ 1942 o - N 17 23 0 - R _ 1943 o - S 30 23 0 S @@ -541,10 +375,6 @@ R _ 1973 o - D 30 3:30 1 D R _ 1975 1976 - Ap Su>=16 3:30 1 D R _ 1979 o - May 13 3:30 1 D R _ 1979 o - O Su>=16 3:30 0 S -Z Asia/Macau 7:34:10 - LMT 1904 O 30 -8 - CST 1941 D 21 23 -9 _ +09/+10 1945 S 30 24 -8 _ C%sT R CY 1975 o - Ap 13 0 1 S R CY 1975 o - O 12 0 0 - R CY 1976 o - May 15 0 1 S @@ -554,65 +384,6 @@ R CY 1977 o - S 25 0 0 - R CY 1978 o - O 2 0 0 - R CY 1979 1997 - S lastSu 0 0 - R CY 1981 1998 - Mar lastSu 0 1 S -Z Asia/Nicosia 2:13:28 - LMT 1921 N 14 -2 CY EE%sT 1998 S -2 E EE%sT -Z Asia/Famagusta 2:15:48 - LMT 1921 N 14 -2 CY EE%sT 1998 S -2 E EE%sT 2016 S 8 -3 - +03 2017 O 29 1u -2 E EE%sT -Z Asia/Tbilisi 2:59:11 - LMT 1880 -2:59:11 - TBMT 1924 May 2 -3 - +03 1957 Mar -4 R +04/+05 1991 Mar 31 2s -3 R +03/+04 1992 -3 e +03/+04 1994 S lastSu -4 e +04/+05 1996 O lastSu -4 1 +05 1997 Mar lastSu -4 e +04/+05 2004 Jun 27 -3 R +03/+04 2005 Mar lastSu 2 -4 - +04 -Z Asia/Dili 8:22:20 - LMT 1912 -8 - +08 1942 F 21 23 -9 - +09 1976 May 3 -8 - +08 2000 S 17 -9 - +09 -Z Asia/Kolkata 5:53:28 - LMT 1854 Jun 28 -5:53:20 - HMT 1870 -5:21:10 - MMT 1906 -5:30 - IST 1941 O -5:30 1 +0630 1942 May 15 -5:30 - IST 1942 S -5:30 1 +0630 1945 O 15 -5:30 - IST -Z Asia/Jakarta 7:7:12 - LMT 1867 Au 10 -7:7:12 - BMT 1923 D 31 16:40u -7:20 - +0720 1932 N -7:30 - +0730 1942 Mar 23 -9 - +09 1945 S 23 -7:30 - +0730 1948 May -8 - +08 1950 May -7:30 - +0730 1964 -7 - WIB -Z Asia/Pontianak 7:17:20 - LMT 1908 May -7:17:20 - PMT 1932 N -7:30 - +0730 1942 Ja 29 -9 - +09 1945 S 23 -7:30 - +0730 1948 May -8 - +08 1950 May -7:30 - +0730 1964 -8 - WITA 1988 -7 - WIB -Z Asia/Makassar 7:57:36 - LMT 1920 -7:57:36 - MMT 1932 N -8 - +08 1942 F 9 -9 - +09 1945 S 23 -8 - WITA -Z Asia/Jayapura 9:22:48 - LMT 1932 N -9 - +09 1944 S -9:30 - +0930 1964 -9 - WIT R i 1910 o - Ja 1 0 0 - R i 1977 o - Mar 21 23 1 - R i 1977 o - O 20 24 0 - @@ -653,11 +424,6 @@ R i 2020 o - Mar 20 24 1 - R i 2020 o - S 20 24 0 - R i 2021 2022 - Mar 21 24 1 - R i 2021 2022 - S 21 24 0 - -Z Asia/Tehran 3:25:44 - LMT 1916 -3:25:44 - TMT 1935 Jun 13 -3:30 i +0330/+0430 1977 O 20 24 -4 i +04/+05 1979 -3:30 i +0330/+0430 R IQ 1982 o - May 1 0 1 - R IQ 1982 1984 - O 1 0 0 - R IQ 1983 o - Mar 31 0 1 - @@ -666,10 +432,6 @@ R IQ 1985 1990 - S lastSu 1s 0 - R IQ 1986 1990 - Mar lastSu 1s 1 - R IQ 1991 2007 - Ap 1 3s 1 - R IQ 1991 2007 - O 1 3s 0 - -Z Asia/Baghdad 2:57:40 - LMT 1890 -2:57:36 - BMT 1918 -3 - +03 1982 May -3 IQ +03/+04 R Z 1940 o - May 31 24u 1 D R Z 1940 o - S 30 24u 0 S R Z 1940 o - N 16 24u 1 D @@ -755,15 +517,10 @@ R Z 2011 o - O 2 2 0 S R Z 2012 o - S 23 2 0 S R Z 2013 ma - Mar F>=23 2 1 D R Z 2013 ma - O lastSu 2 0 S -Z Asia/Jerusalem 2:20:54 - LMT 1880 -2:20:40 - JMT 1918 -2 Z I%sT R JP 1948 o - May Sa>=1 24 1 D R JP 1948 1951 - S Sa>=8 25 0 S R JP 1949 o - Ap Sa>=1 24 1 D R JP 1950 1951 - May Sa>=1 24 1 D -Z Asia/Tokyo 9:18:59 - LMT 1887 D 31 15u -9 JP J%sT R J 1973 o - Jun 6 0 1 S R J 1973 1975 - O 1 0 0 - R J 1974 1977 - May 1 0 1 S @@ -796,83 +553,10 @@ R J 2013 o - D 20 0 0 - R J 2014 2021 - Mar lastTh 24 1 S R J 2014 2022 - O lastF 0s 0 - R J 2022 o - F lastTh 24 1 S -Z Asia/Amman 2:23:44 - LMT 1931 -2 J EE%sT 2022 O 28 0s -3 - +03 -Z Asia/Almaty 5:7:48 - LMT 1924 May 2 -5 - +05 1930 Jun 21 -6 R +06/+07 1991 Mar 31 2s -5 R +05/+06 1992 Ja 19 2s -6 R +06/+07 2004 O 31 2s -6 - +06 -Z Asia/Qyzylorda 4:21:52 - LMT 1924 May 2 -4 - +04 1930 Jun 21 -5 - +05 1981 Ap -5 1 +06 1981 O -6 - +06 1982 Ap -5 R +05/+06 1991 Mar 31 2s -4 R +04/+05 1991 S 29 2s -5 R +05/+06 1992 Ja 19 2s -6 R +06/+07 1992 Mar 29 2s -5 R +05/+06 2004 O 31 2s -6 - +06 2018 D 21 -5 - +05 -Z Asia/Qostanay 4:14:28 - LMT 1924 May 2 -4 - +04 1930 Jun 21 -5 - +05 1981 Ap -5 1 +06 1981 O -6 - +06 1982 Ap -5 R +05/+06 1991 Mar 31 2s -4 R +04/+05 1992 Ja 19 2s -5 R +05/+06 2004 O 31 2s -6 - +06 -Z Asia/Aqtobe 3:48:40 - LMT 1924 May 2 -4 - +04 1930 Jun 21 -5 - +05 1981 Ap -5 1 +06 1981 O -6 - +06 1982 Ap -5 R +05/+06 1991 Mar 31 2s -4 R +04/+05 1992 Ja 19 2s -5 R +05/+06 2004 O 31 2s -5 - +05 -Z Asia/Aqtau 3:21:4 - LMT 1924 May 2 -4 - +04 1930 Jun 21 -5 - +05 1981 O -6 - +06 1982 Ap -5 R +05/+06 1991 Mar 31 2s -4 R +04/+05 1992 Ja 19 2s -5 R +05/+06 1994 S 25 2s -4 R +04/+05 2004 O 31 2s -5 - +05 -Z Asia/Atyrau 3:27:44 - LMT 1924 May 2 -3 - +03 1930 Jun 21 -5 - +05 1981 O -6 - +06 1982 Ap -5 R +05/+06 1991 Mar 31 2s -4 R +04/+05 1992 Ja 19 2s -5 R +05/+06 1999 Mar 28 2s -4 R +04/+05 2004 O 31 2s -5 - +05 -Z Asia/Oral 3:25:24 - LMT 1924 May 2 -3 - +03 1930 Jun 21 -5 - +05 1981 Ap -5 1 +06 1981 O -6 - +06 1982 Ap -5 R +05/+06 1989 Mar 26 2s -4 R +04/+05 1992 Ja 19 2s -5 R +05/+06 1992 Mar 29 2s -4 R +04/+05 2004 O 31 2s -5 - +05 R KG 1992 1996 - Ap Su>=7 0s 1 - R KG 1992 1996 - S lastSu 0 0 - R KG 1997 2005 - Mar lastSu 2:30 1 - R KG 1997 2004 - O lastSu 2:30 0 - -Z Asia/Bishkek 4:58:24 - LMT 1924 May 2 -5 - +05 1930 Jun 21 -6 R +06/+07 1991 Mar 31 2s -5 R +05/+06 1991 Au 31 2 -5 KG +05/+06 2005 Au 12 -6 - +06 R KR 1948 o - Jun 1 0 1 D R KR 1948 o - S 12 24 0 S R KR 1949 o - Ap 3 0 1 D @@ -887,18 +571,6 @@ R KR 1957 1960 - May Su>=1 0 1 D R KR 1957 1960 - S Sa>=17 24 0 S R KR 1987 1988 - May Su>=8 2 1 D R KR 1987 1988 - O Su>=8 3 0 S -Z Asia/Seoul 8:27:52 - LMT 1908 Ap -8:30 - KST 1912 -9 - JST 1945 S 8 -9 KR K%sT 1954 Mar 21 -8:30 KR K%sT 1961 Au 10 -9 KR K%sT -Z Asia/Pyongyang 8:23 - LMT 1908 Ap -8:30 - KST 1912 -9 - JST 1945 Au 24 -9 - KST 2015 Au 15 -8:30 - KST 2018 May 4 23:30 -9 - KST R l 1920 o - Mar 28 0 1 S R l 1920 o - O 25 0 0 - R l 1921 o - Ap 3 0 1 S @@ -923,18 +595,8 @@ R l 1992 o - O 4 0 0 - R l 1993 ma - Mar lastSu 0 1 S R l 1993 1998 - S lastSu 0 0 - R l 1999 ma - O lastSu 0 0 - -Z Asia/Beirut 2:22 - LMT 1880 -2 l EE%sT R NB 1935 1941 - S 14 0 0:20 - R NB 1935 1941 - D 14 0 0 - -Z Asia/Kuching 7:21:20 - LMT 1926 Mar -7:30 - +0730 1933 -8 NB +08/+0820 1942 F 16 -9 - +09 1945 S 12 -8 - +08 -Z Indian/Maldives 4:54 - LMT 1880 -4:54 - MMT 1960 -5 - +05 R X 1983 1984 - Ap 1 0 1 - R X 1983 o - O 1 0 0 - R X 1985 1998 - Mar lastSu 0 1 - @@ -944,31 +606,11 @@ R X 2001 2006 - S lastSa 2 0 - R X 2002 2006 - Mar lastSa 2 1 - R X 2015 2016 - Mar lastSa 2 1 - R X 2015 2016 - S lastSa 0 0 - -Z Asia/Hovd 6:6:36 - LMT 1905 Au -6 - +06 1978 -7 X +07/+08 -Z Asia/Ulaanbaatar 7:7:32 - LMT 1905 Au -7 - +07 1978 -8 X +08/+09 -Z Asia/Choibalsan 7:38 - LMT 1905 Au -7 - +07 1978 -8 - +08 1983 Ap -9 X +09/+10 2008 Mar 31 -8 X +08/+09 -Z Asia/Kathmandu 5:41:16 - LMT 1920 -5:30 - +0530 1986 -5:45 - +0545 R PK 2002 o - Ap Su>=2 0 1 S R PK 2002 o - O Su>=2 0 0 - R PK 2008 o - Jun 1 0 1 S R PK 2008 2009 - N 1 0 0 - R PK 2009 o - Ap 15 0 1 S -Z Asia/Karachi 4:28:12 - LMT 1907 -5:30 - +0530 1942 S -5:30 1 +0630 1945 O 15 -5:30 - +0530 1951 S 30 -5 - +05 1971 Mar 26 -5 PK PK%sT R P 1999 2005 - Ap F>=15 0 1 S R P 1999 2003 - O F>=15 0 0 - R P 2004 o - O 1 1 0 - @@ -1001,136 +643,90 @@ R P 2021 o - O 29 1 0 - R P 2022 o - Mar 27 0 1 S R P 2022 2035 - O Sa<=30 2 0 - R P 2023 o - Ap 29 2 1 S -R P 2024 o - Ap 13 2 1 S -R P 2025 o - Ap 5 2 1 S +R P 2024 o - Ap 20 2 1 S +R P 2025 o - Ap 12 2 1 S R P 2026 2054 - Mar Sa<=30 2 1 S R P 2036 o - O 18 2 0 - R P 2037 o - O 10 2 0 - R P 2038 o - S 25 2 0 - R P 2039 o - S 17 2 0 - -R P 2039 o - O 22 2 1 S -R P 2039 2067 - O Sa<=30 2 0 - R P 2040 o - S 1 2 0 - -R P 2040 o - O 13 2 1 S +R P 2040 o - O 20 2 1 S +R P 2040 2067 - O Sa<=30 2 0 - R P 2041 o - Au 24 2 0 - -R P 2041 o - S 28 2 1 S +R P 2041 o - O 5 2 1 S R P 2042 o - Au 16 2 0 - -R P 2042 o - S 20 2 1 S +R P 2042 o - S 27 2 1 S R P 2043 o - Au 1 2 0 - -R P 2043 o - S 12 2 1 S +R P 2043 o - S 19 2 1 S R P 2044 o - Jul 23 2 0 - -R P 2044 o - Au 27 2 1 S +R P 2044 o - S 3 2 1 S R P 2045 o - Jul 15 2 0 - -R P 2045 o - Au 19 2 1 S +R P 2045 o - Au 26 2 1 S R P 2046 o - Jun 30 2 0 - -R P 2046 o - Au 11 2 1 S +R P 2046 o - Au 18 2 1 S R P 2047 o - Jun 22 2 0 - -R P 2047 o - Jul 27 2 1 S +R P 2047 o - Au 3 2 1 S R P 2048 o - Jun 6 2 0 - -R P 2048 o - Jul 18 2 1 S +R P 2048 o - Jul 25 2 1 S R P 2049 o - May 29 2 0 - -R P 2049 o - Jul 3 2 1 S +R P 2049 o - Jul 10 2 1 S R P 2050 o - May 21 2 0 - -R P 2050 o - Jun 25 2 1 S +R P 2050 o - Jul 2 2 1 S R P 2051 o - May 6 2 0 - -R P 2051 o - Jun 17 2 1 S +R P 2051 o - Jun 24 2 1 S R P 2052 o - Ap 27 2 0 - -R P 2052 o - Jun 1 2 1 S +R P 2052 o - Jun 8 2 1 S R P 2053 o - Ap 12 2 0 - -R P 2053 o - May 24 2 1 S +R P 2053 o - May 31 2 1 S R P 2054 o - Ap 4 2 0 - -R P 2054 o - May 16 2 1 S -R P 2055 o - May 1 2 1 S -R P 2056 o - Ap 22 2 1 S -R P 2057 o - Ap 7 2 1 S -R P 2058 ma - Mar Sa<=30 2 1 S +R P 2054 o - May 23 2 1 S +R P 2055 o - May 8 2 1 S +R P 2056 o - Ap 29 2 1 S +R P 2057 o - Ap 14 2 1 S +R P 2058 o - Ap 6 2 1 S +R P 2059 ma - Mar Sa<=30 2 1 S R P 2068 o - O 20 2 0 - R P 2069 o - O 12 2 0 - R P 2070 o - O 4 2 0 - R P 2071 o - S 19 2 0 - R P 2072 o - S 10 2 0 - -R P 2072 o - O 15 2 1 S +R P 2072 o - O 22 2 1 S +R P 2072 ma - O Sa<=30 2 0 - R P 2073 o - S 2 2 0 - -R P 2073 o - O 7 2 1 S +R P 2073 o - O 14 2 1 S R P 2074 o - Au 18 2 0 - -R P 2074 o - S 29 2 1 S +R P 2074 o - O 6 2 1 S R P 2075 o - Au 10 2 0 - -R P 2075 o - S 14 2 1 S -R P 2075 ma - O Sa<=30 2 0 - +R P 2075 o - S 21 2 1 S R P 2076 o - Jul 25 2 0 - -R P 2076 o - S 5 2 1 S +R P 2076 o - S 12 2 1 S R P 2077 o - Jul 17 2 0 - -R P 2077 o - Au 28 2 1 S +R P 2077 o - S 4 2 1 S R P 2078 o - Jul 9 2 0 - -R P 2078 o - Au 13 2 1 S +R P 2078 o - Au 20 2 1 S R P 2079 o - Jun 24 2 0 - -R P 2079 o - Au 5 2 1 S +R P 2079 o - Au 12 2 1 S R P 2080 o - Jun 15 2 0 - -R P 2080 o - Jul 20 2 1 S +R P 2080 o - Jul 27 2 1 S R P 2081 o - Jun 7 2 0 - -R P 2081 o - Jul 12 2 1 S +R P 2081 o - Jul 19 2 1 S R P 2082 o - May 23 2 0 - -R P 2082 o - Jul 4 2 1 S +R P 2082 o - Jul 11 2 1 S R P 2083 o - May 15 2 0 - -R P 2083 o - Jun 19 2 1 S +R P 2083 o - Jun 26 2 1 S R P 2084 o - Ap 29 2 0 - -R P 2084 o - Jun 10 2 1 S +R P 2084 o - Jun 17 2 1 S R P 2085 o - Ap 21 2 0 - -R P 2085 o - Jun 2 2 1 S +R P 2085 o - Jun 9 2 1 S R P 2086 o - Ap 13 2 0 - -R P 2086 o - May 18 2 1 S -Z Asia/Gaza 2:17:52 - LMT 1900 O -2 Z EET/EEST 1948 May 15 -2 K EE%sT 1967 Jun 5 -2 Z I%sT 1996 -2 J EE%sT 1999 -2 P EE%sT 2008 Au 29 -2 - EET 2008 S -2 P EE%sT 2010 -2 - EET 2010 Mar 27 0:1 -2 P EE%sT 2011 Au -2 - EET 2012 -2 P EE%sT -Z Asia/Hebron 2:20:23 - LMT 1900 O -2 Z EET/EEST 1948 May 15 -2 K EE%sT 1967 Jun 5 -2 Z I%sT 1996 -2 J EE%sT 1999 -2 P EE%sT +R P 2086 o - May 25 2 1 S R PH 1936 o - N 1 0 1 D R PH 1937 o - F 1 0 0 S R PH 1954 o - Ap 12 0 1 D R PH 1954 o - Jul 1 0 0 S R PH 1978 o - Mar 22 0 1 D R PH 1978 o - S 21 0 0 S -Z Asia/Manila -15:56 - LMT 1844 D 31 -8:4 - LMT 1899 May 11 -8 PH P%sT 1942 May -9 - JST 1944 N -8 PH P%sT -Z Asia/Qatar 3:26:8 - LMT 1920 -4 - +04 1972 Jun -3 - +03 -Z Asia/Riyadh 3:6:52 - LMT 1947 Mar 14 -3 - +03 -Z Asia/Singapore 6:55:25 - LMT 1901 -6:55:25 - SMT 1905 Jun -7 - +07 1933 -7 0:20 +0720 1936 -7:20 - +0720 1941 S -7:30 - +0730 1942 F 16 -9 - +09 1945 S 12 -7:30 - +0730 1981 D 31 16u -8 - +08 -Z Asia/Colombo 5:19:24 - LMT 1880 -5:19:32 - MMT 1906 -5:30 - +0530 1942 Ja 5 -5:30 0:30 +06 1942 S -5:30 1 +0630 1945 O 16 2 -5:30 - +0530 1996 May 25 -6:30 - +0630 1996 O 26 0:30 -6 - +06 2006 Ap 15 0:30 -5:30 - +0530 R S 1920 1923 - Ap Su>=15 2 1 S R S 1920 1923 - O Su>=1 2 0 - R S 1962 o - Ap 29 2 1 S @@ -1172,46 +768,6 @@ R S 2009 o - Mar lastF 0 1 S R S 2010 2011 - Ap F>=1 0 1 S R S 2012 2022 - Mar lastF 0 1 S R S 2009 2022 - O lastF 0 0 - -Z Asia/Damascus 2:25:12 - LMT 1920 -2 S EE%sT 2022 O 28 -3 - +03 -Z Asia/Dushanbe 4:35:12 - LMT 1924 May 2 -5 - +05 1930 Jun 21 -6 R +06/+07 1991 Mar 31 2s -5 1 +06 1991 S 9 2s -5 - +05 -Z Asia/Bangkok 6:42:4 - LMT 1880 -6:42:4 - BMT 1920 Ap -7 - +07 -Z Asia/Ashgabat 3:53:32 - LMT 1924 May 2 -4 - +04 1930 Jun 21 -5 R +05/+06 1991 Mar 31 2 -4 R +04/+05 1992 Ja 19 2 -5 - +05 -Z Asia/Dubai 3:41:12 - LMT 1920 -4 - +04 -Z Asia/Samarkand 4:27:53 - LMT 1924 May 2 -4 - +04 1930 Jun 21 -5 - +05 1981 Ap -5 1 +06 1981 O -6 - +06 1982 Ap -5 R +05/+06 1992 -5 - +05 -Z Asia/Tashkent 4:37:11 - LMT 1924 May 2 -5 - +05 1930 Jun 21 -6 R +06/+07 1991 Mar 31 2 -5 R +05/+06 1992 -5 - +05 -Z Asia/Ho_Chi_Minh 7:6:30 - LMT 1906 Jul -7:6:30 - PLMT 1911 May -7 - +07 1942 D 31 23 -8 - +08 1945 Mar 14 23 -9 - +09 1945 S 2 -7 - +07 1947 Ap -8 - +08 1955 Jul -7 - +07 1959 D 31 23 -8 - +08 1975 Jun 13 -7 - +07 R AU 1917 o - Ja 1 2s 1 D R AU 1917 o - Mar lastSu 2s 0 S R AU 1942 o - Ja 1 2s 1 D @@ -1219,9 +775,6 @@ R AU 1942 o - Mar lastSu 2s 0 S R AU 1942 o - S 27 2s 1 D R AU 1943 1944 - Mar lastSu 2s 0 S R AU 1943 o - O 3 2s 1 D -Z Australia/Darwin 8:43:20 - LMT 1895 F -9 - ACST 1899 May -9:30 AU AC%sT R AW 1974 o - O lastSu 2s 1 D R AW 1975 o - Mar Su>=1 2s 0 S R AW 1983 o - O lastSu 2s 1 D @@ -1231,25 +784,12 @@ R AW 1992 o - Mar Su>=1 2s 0 S R AW 2006 o - D 3 2s 1 D R AW 2007 2009 - Mar lastSu 2s 0 S R AW 2007 2008 - O lastSu 2s 1 D -Z Australia/Perth 7:43:24 - LMT 1895 D -8 AU AW%sT 1943 Jul -8 AW AW%sT -Z Australia/Eucla 8:35:28 - LMT 1895 D -8:45 AU +0845/+0945 1943 Jul -8:45 AW +0845/+0945 R AQ 1971 o - O lastSu 2s 1 D R AQ 1972 o - F lastSu 2s 0 S R AQ 1989 1991 - O lastSu 2s 1 D R AQ 1990 1992 - Mar Su>=1 2s 0 S R Ho 1992 1993 - O lastSu 2s 1 D R Ho 1993 1994 - Mar Su>=1 2s 0 S -Z Australia/Brisbane 10:12:8 - LMT 1895 -10 AU AE%sT 1971 -10 AQ AE%sT -Z Australia/Lindeman 9:55:56 - LMT 1895 -10 AU AE%sT 1971 -10 AQ AE%sT 1992 Jul -10 Ho AE%sT R AS 1971 1985 - O lastSu 2s 1 D R AS 1986 o - O 19 2s 1 D R AS 1987 2007 - O lastSu 2s 1 D @@ -1265,10 +805,6 @@ R AS 2006 o - Ap 2 2s 0 S R AS 2007 o - Mar lastSu 2s 0 S R AS 2008 ma - Ap Su>=1 2s 0 S R AS 2008 ma - O Su>=1 2s 1 D -Z Australia/Adelaide 9:14:20 - LMT 1895 F -9 - ACST 1899 May -9:30 AU AC%sT 1971 -9:30 AS AC%sT R AT 1916 o - O Su>=1 2s 1 D R AT 1917 o - Mar lastSu 2s 0 S R AT 1917 1918 - O Su>=22 2s 1 D @@ -1292,10 +828,6 @@ R AT 2001 ma - O Su>=1 2s 1 D R AT 2006 o - Ap Su>=1 2s 0 S R AT 2007 o - Mar lastSu 2s 0 S R AT 2008 ma - Ap Su>=1 2s 0 S -Z Australia/Hobart 9:49:16 - LMT 1895 S -10 AT AE%sT 1919 O 24 -10 AU AE%sT 1967 -10 AT AE%sT R AV 1971 1985 - O lastSu 2s 1 D R AV 1972 o - F lastSu 2s 0 S R AV 1973 1985 - Mar Su>=1 2s 0 S @@ -1310,9 +842,6 @@ R AV 2006 o - Ap Su>=1 2s 0 S R AV 2007 o - Mar lastSu 2s 0 S R AV 2008 ma - Ap Su>=1 2s 0 S R AV 2008 ma - O Su>=1 2s 1 D -Z Australia/Melbourne 9:39:52 - LMT 1895 F -10 AU AE%sT 1971 -10 AV AE%sT R AN 1971 1985 - O lastSu 2s 1 D R AN 1972 o - F 27 2s 0 S R AN 1973 1981 - Mar Su>=1 2s 0 S @@ -1329,15 +858,6 @@ R AN 2006 o - Ap Su>=1 2s 0 S R AN 2007 o - Mar lastSu 2s 0 S R AN 2008 ma - Ap Su>=1 2s 0 S R AN 2008 ma - O Su>=1 2s 1 D -Z Australia/Sydney 10:4:52 - LMT 1895 F -10 AU AE%sT 1971 -10 AN AE%sT -Z Australia/Broken_Hill 9:25:48 - LMT 1895 F -10 - AEST 1896 Au 23 -9 - ACST 1899 May -9:30 AU AC%sT 1971 -9:30 AN AC%sT 2000 -9:30 AS AC%sT R LH 1981 1984 - O lastSu 2 1 - R LH 1982 1985 - Mar Su>=1 2 0 - R LH 1985 o - O lastSu 2 0:30 - @@ -1352,19 +872,6 @@ R LH 2006 o - Ap Su>=1 2 0 - R LH 2007 o - Mar lastSu 2 0 - R LH 2008 ma - Ap Su>=1 2 0 - R LH 2008 ma - O Su>=1 2 0:30 - -Z Australia/Lord_Howe 10:36:20 - LMT 1895 F -10 - AEST 1981 Mar -10:30 LH +1030/+1130 1985 Jul -10:30 LH +1030/+11 -Z Antarctica/Macquarie 0 - -00 1899 N -10 - AEST 1916 O 1 2 -10 1 AEDT 1917 F -10 AU AE%sT 1919 Ap 1 0s -0 - -00 1948 Mar 25 -10 AU AE%sT 1967 -10 AT AE%sT 2010 -10 1 AEDT 2011 -10 AT AE%sT R FJ 1998 1999 - N Su>=1 2 1 - R FJ 1999 2000 - F lastSu 3 0 - R FJ 2009 o - N 29 2 1 - @@ -1377,14 +884,6 @@ R FJ 2014 2018 - N Su>=1 2 1 - R FJ 2015 2021 - Ja Su>=12 3 0 - R FJ 2019 o - N Su>=8 2 1 - R FJ 2020 o - D 20 2 1 - -Z Pacific/Fiji 11:55:44 - LMT 1915 O 26 -12 FJ +12/+13 -Z Pacific/Gambier -8:59:48 - LMT 1912 O --9 - -09 -Z Pacific/Marquesas -9:18 - LMT 1912 O --9:30 - -0930 -Z Pacific/Tahiti -9:58:16 - LMT 1912 O --10 - -10 R Gu 1959 o - Jun 27 2 1 D R Gu 1961 o - Ja 29 2 0 S R Gu 1967 o - S 1 2 1 D @@ -1399,50 +898,10 @@ R Gu 1976 o - May 26 2 1 D R Gu 1976 o - Au 22 2:1 0 S R Gu 1977 o - Ap 24 2 1 D R Gu 1977 o - Au 28 2 0 S -Z Pacific/Guam -14:21 - LMT 1844 D 31 -9:39 - LMT 1901 -10 - GST 1941 D 10 -9 - +09 1944 Jul 31 -10 Gu G%sT 2000 D 23 -10 - ChST -Z Pacific/Tarawa 11:32:4 - LMT 1901 -12 - +12 -Z Pacific/Kanton 0 - -00 1937 Au 31 --12 - -12 1979 O --11 - -11 1994 D 31 -13 - +13 -Z Pacific/Kiritimati -10:29:20 - LMT 1901 --10:40 - -1040 1979 O --10 - -10 1994 D 31 -14 - +14 -Z Pacific/Kwajalein 11:9:20 - LMT 1901 -11 - +11 1937 -10 - +10 1941 Ap -9 - +09 1944 F 6 -11 - +11 1969 O --12 - -12 1993 Au 20 24 -12 - +12 -Z Pacific/Kosrae -13:8:4 - LMT 1844 D 31 -10:51:56 - LMT 1901 -11 - +11 1914 O -9 - +09 1919 F -11 - +11 1937 -10 - +10 1941 Ap -9 - +09 1945 Au -11 - +11 1969 O -12 - +12 1999 -11 - +11 -Z Pacific/Nauru 11:7:40 - LMT 1921 Ja 15 -11:30 - +1130 1942 Au 29 -9 - +09 1945 S 8 -11:30 - +1130 1979 F 10 2 -12 - +12 R NC 1977 1978 - D Su>=1 0 1 - R NC 1978 1979 - F 27 0 0 - R NC 1996 o - D 1 2s 1 - R NC 1997 o - Mar 2 2s 0 - -Z Pacific/Noumea 11:5:48 - LMT 1912 Ja 13 -11 NC +11/+12 R NZ 1927 o - N 6 2 1 S R NZ 1928 o - Mar 4 2 0 M R NZ 1928 1933 - O Su>=8 2 0:30 S @@ -1468,80 +927,26 @@ R NZ 2007 ma - S lastSu 2s 1 D R k 2007 ma - S lastSu 2:45s 1 - R NZ 2008 ma - Ap Su>=1 2s 0 S R k 2008 ma - Ap Su>=1 2:45s 0 - -Z Pacific/Auckland 11:39:4 - LMT 1868 N 2 -11:30 NZ NZ%sT 1946 -12 NZ NZ%sT -Z Pacific/Chatham 12:13:48 - LMT 1868 N 2 -12:15 - +1215 1946 -12:45 k +1245/+1345 R CK 1978 o - N 12 0 0:30 - R CK 1979 1991 - Mar Su>=1 0 0 - R CK 1979 1990 - O lastSu 0 0:30 - -Z Pacific/Rarotonga 13:20:56 - LMT 1899 D 26 --10:39:4 - LMT 1952 O 16 --10:30 - -1030 1978 N 12 --10 CK -10/-0930 -Z Pacific/Niue -11:19:40 - LMT 1952 O 16 --11:20 - -1120 1964 Jul --11 - -11 -Z Pacific/Norfolk 11:11:52 - LMT 1901 -11:12 - +1112 1951 -11:30 - +1130 1974 O 27 2s -11:30 1 +1230 1975 Mar 2 2s -11:30 - +1130 2015 O 4 2s -11 - +11 2019 Jul -11 AN +11/+12 -Z Pacific/Palau -15:2:4 - LMT 1844 D 31 -8:57:56 - LMT 1901 -9 - +09 -Z Pacific/Port_Moresby 9:48:40 - LMT 1880 -9:48:32 - PMMT 1895 -10 - +10 -Z Pacific/Bougainville 10:22:16 - LMT 1880 -9:48:32 - PMMT 1895 -10 - +10 1942 Jul -9 - +09 1945 Au 21 -10 - +10 2014 D 28 2 -11 - +11 -Z Pacific/Pitcairn -8:40:20 - LMT 1901 --8:30 - -0830 1998 Ap 27 --8 - -08 -Z Pacific/Pago_Pago 12:37:12 - LMT 1892 Jul 5 --11:22:48 - LMT 1911 --11 - SST R WS 2010 o - S lastSu 0 1 - R WS 2011 o - Ap Sa>=1 4 0 - R WS 2011 o - S lastSa 3 1 - R WS 2012 2021 - Ap Su>=1 4 0 - R WS 2012 2020 - S lastSu 3 1 - -Z Pacific/Apia 12:33:4 - LMT 1892 Jul 5 --11:26:56 - LMT 1911 --11:30 - -1130 1950 --11 WS -11/-10 2011 D 29 24 -13 WS +13/+14 -Z Pacific/Guadalcanal 10:39:48 - LMT 1912 O -11 - +11 -Z Pacific/Fakaofo -11:24:56 - LMT 1901 --11 - -11 2011 D 30 -13 - +13 R TO 1999 o - O 7 2s 1 - R TO 2000 o - Mar 19 2s 0 - R TO 2000 2001 - N Su>=1 2 1 - R TO 2001 2002 - Ja lastSu 2 0 - R TO 2016 o - N Su>=1 2 1 - R TO 2017 o - Ja Su>=15 3 0 - -Z Pacific/Tongatapu 12:19:12 - LMT 1945 S 10 -12:20 - +1220 1961 -13 - +13 1999 -13 TO +13/+14 R VU 1973 o - D 22 12u 1 - R VU 1974 o - Mar 30 12u 0 - R VU 1983 1991 - S Sa>=22 24 1 - R VU 1984 1991 - Mar Sa>=22 24 0 - R VU 1992 1993 - Ja Sa>=22 24 0 - R VU 1992 o - O Sa>=22 24 1 - -Z Pacific/Efate 11:13:16 - LMT 1912 Ja 13 -11 VU +11/+12 R G 1916 o - May 21 2s 1 BST R G 1916 o - O 1 2s 0 GMT R G 1917 o - Ap 8 2s 1 BST @@ -1607,11 +1012,6 @@ R G 1972 1980 - O Su>=23 2s 0 GMT R G 1981 1995 - Mar lastSu 1u 1 BST R G 1981 1989 - O Su>=23 1u 0 GMT R G 1990 1995 - O Su>=22 1u 0 GMT -Z Europe/London -0:1:15 - LMT 1847 D -0 G %s 1968 O 27 -1 - BST 1971 O 31 2u -0 G %s 1996 -0 E GMT/BST R IE 1971 o - O 31 2u -1 - R IE 1972 1980 - Mar Su>=16 2u 0 - R IE 1972 1980 - O Su>=23 2u -1 - @@ -1619,17 +1019,6 @@ R IE 1981 ma - Mar lastSu 1u 0 - R IE 1981 1989 - O Su>=23 1u -1 - R IE 1990 1995 - O Su>=22 1u -1 - R IE 1996 ma - O lastSu 1u -1 - -Z Europe/Dublin -0:25:21 - LMT 1880 Au 2 --0:25:21 - DMT 1916 May 21 2s --0:25:21 1 IST 1916 O 1 2s -0 G %s 1921 D 6 -0 G GMT/IST 1940 F 25 2s -0 1 IST 1946 O 6 2s -0 - GMT 1947 Mar 16 2s -0 1 IST 1947 N 2 2s -0 - GMT 1948 Ap 18 2s -0 G GMT/IST 1968 O 27 -1 IE IST/GMT R E 1977 1980 - Ap Su>=1 1u 1 S R E 1977 o - S lastSu 1u 0 - R E 1978 o - O 1 1u 0 - @@ -1681,10 +1070,6 @@ R R 1981 1983 - O 1 0 0 - R R 1984 1995 - S lastSu 2s 0 - R R 1985 2010 - Mar lastSu 2s 1 S R R 1996 2010 - O lastSu 2s 0 - -Z WET 0 E WE%sT -Z CET 1 c CE%sT -Z MET 1 c ME%sT -Z EET 2 E EE%sT R q 1940 o - Jun 16 0 1 S R q 1942 o - N 2 3 0 - R q 1943 o - Mar 29 2 1 S @@ -1710,14 +1095,6 @@ R q 1982 o - O 3 0 0 - R q 1983 o - Ap 18 0 1 S R q 1983 o - O 1 0 0 - R q 1984 o - Ap 1 0 1 S -Z Europe/Tirane 1:19:20 - LMT 1914 -1 - CET 1940 Jun 16 -1 q CE%sT 1984 Jul -1 E CE%sT -Z Europe/Andorra 0:6:4 - LMT 1901 -0 - WET 1946 S 30 -1 - CET 1985 Mar 31 2 -1 E CE%sT R a 1920 o - Ap 5 2s 1 S R a 1920 o - S 13 2s 0 - R a 1946 o - Ap 14 2s 1 S @@ -1727,23 +1104,6 @@ R a 1947 o - Ap 6 2s 1 S R a 1948 o - Ap 18 2s 1 S R a 1980 o - Ap 6 0 1 S R a 1980 o - S 28 0 0 - -Z Europe/Vienna 1:5:21 - LMT 1893 Ap -1 c CE%sT 1920 -1 a CE%sT 1940 Ap 1 2s -1 c CE%sT 1945 Ap 2 2s -1 1 CEST 1945 Ap 12 2s -1 - CET 1946 -1 a CE%sT 1981 -1 E CE%sT -Z Europe/Minsk 1:50:16 - LMT 1880 -1:50 - MMT 1924 May 2 -2 - EET 1930 Jun 21 -3 - MSK 1941 Jun 28 -1 c CE%sT 1944 Jul 3 -3 R MSK/MSD 1990 -3 - MSK 1991 Mar 31 2s -2 R EE%sT 2011 Mar 27 2s -3 - +03 R b 1918 o - Mar 9 0s 1 S R b 1918 1919 - O Sa>=1 23s 0 - R b 1919 o - Mar 1 23s 1 S @@ -1778,87 +1138,27 @@ R b 1945 o - Ap 2 2s 1 S R b 1945 o - S 16 2s 0 - R b 1946 o - May 19 2s 1 S R b 1946 o - O 7 2s 0 - -Z Europe/Brussels 0:17:30 - LMT 1880 -0:17:30 - BMT 1892 May 1 0:17:30 -0 - WET 1914 N 8 -1 - CET 1916 May -1 c CE%sT 1918 N 11 11u -0 b WE%sT 1940 May 20 2s -1 c CE%sT 1944 S 3 -1 b CE%sT 1977 -1 E CE%sT R BG 1979 o - Mar 31 23 1 S R BG 1979 o - O 1 1 0 - R BG 1980 1982 - Ap Sa>=1 23 1 S R BG 1980 o - S 29 1 0 - R BG 1981 o - S 27 2 0 - -Z Europe/Sofia 1:33:16 - LMT 1880 -1:56:56 - IMT 1894 N 30 -2 - EET 1942 N 2 3 -1 c CE%sT 1945 -1 - CET 1945 Ap 2 3 -2 - EET 1979 Mar 31 23 -2 BG EE%sT 1982 S 26 3 -2 c EE%sT 1991 -2 e EE%sT 1997 -2 E EE%sT R CZ 1945 o - Ap M>=1 2s 1 S R CZ 1945 o - O 1 2s 0 - R CZ 1946 o - May 6 2s 1 S R CZ 1946 1949 - O Su>=1 2s 0 - R CZ 1947 1948 - Ap Su>=15 2s 1 S R CZ 1949 o - Ap 9 2s 1 S -Z Europe/Prague 0:57:44 - LMT 1850 -0:57:44 - PMT 1891 O -1 c CE%sT 1945 May 9 -1 CZ CE%sT 1946 D 1 3 -1 -1 GMT 1947 F 23 2 -1 CZ CE%sT 1979 -1 E CE%sT -Z Atlantic/Faroe -0:27:4 - LMT 1908 Ja 11 -0 - WET 1981 -0 E WE%sT R Th 1991 1992 - Mar lastSu 2 1 D R Th 1991 1992 - S lastSu 2 0 S R Th 1993 2006 - Ap Su>=1 2 1 D R Th 1993 2006 - O lastSu 2 0 S R Th 2007 ma - Mar Su>=8 2 1 D R Th 2007 ma - N Su>=1 2 0 S -Z America/Danmarkshavn -1:14:40 - LMT 1916 Jul 28 --3 - -03 1980 Ap 6 2 --3 E -03/-02 1996 -0 - GMT -Z America/Scoresbysund -1:27:52 - LMT 1916 Jul 28 --2 - -02 1980 Ap 6 2 --2 c -02/-01 1981 Mar 29 --1 E -01/+00 -Z America/Nuuk -3:26:56 - LMT 1916 Jul 28 --3 - -03 1980 Ap 6 2 --3 E -03/-02 2023 O 29 1u --2 E -02/-01 -Z America/Thule -4:35:8 - LMT 1916 Jul 28 --4 Th A%sT -Z Europe/Tallinn 1:39 - LMT 1880 -1:39 - TMT 1918 F -1 c CE%sT 1919 Jul -1:39 - TMT 1921 May -2 - EET 1940 Au 6 -3 - MSK 1941 S 15 -1 c CE%sT 1944 S 22 -3 R MSK/MSD 1989 Mar 26 2s -2 1 EEST 1989 S 24 2s -2 c EE%sT 1998 S 22 -2 E EE%sT 1999 O 31 4 -2 - EET 2002 F 21 -2 E EE%sT R FI 1942 o - Ap 2 24 1 S R FI 1942 o - O 4 1 0 - R FI 1981 1982 - Mar lastSu 2 1 S R FI 1981 1982 - S lastSu 3 0 - -Z Europe/Helsinki 1:39:49 - LMT 1878 May 31 -1:39:49 - HMT 1921 May -2 FI EE%sT 1983 -2 E EE%sT R F 1916 o - Jun 14 23s 1 S R F 1916 1919 - O Su>=1 23s 0 - R F 1917 o - Mar 24 23s 1 S @@ -1901,13 +1201,6 @@ R F 1945 o - Ap 2 2 2 M R F 1945 o - S 16 3 0 - R F 1976 o - Mar 28 1 1 S R F 1976 o - S 26 1 0 - -Z Europe/Paris 0:9:21 - LMT 1891 Mar 16 -0:9:21 - PMT 1911 Mar 11 -0 F WE%sT 1940 Jun 14 23 -1 c CE%sT 1944 Au 25 -0 F WE%sT 1945 S 16 3 -1 F CE%sT 1977 -1 E CE%sT R DE 1946 o - Ap 14 2s 1 S R DE 1946 o - O 7 2s 0 - R DE 1947 1949 - O Su>=1 2s 0 - @@ -1919,15 +1212,6 @@ R DE 1949 o - Ap 10 2s 1 S R So 1945 o - May 24 2 2 M R So 1945 o - S 24 3 1 S R So 1945 o - N 18 2s 0 - -Z Europe/Berlin 0:53:28 - LMT 1893 Ap -1 c CE%sT 1945 May 24 2 -1 So CE%sT 1946 -1 DE CE%sT 1980 -1 E CE%sT -Z Europe/Gibraltar -0:21:24 - LMT 1880 Au 2 -0 G %s 1957 Ap 14 2 -1 - CET 1982 -1 E CE%sT R g 1932 o - Jul 7 0 1 S R g 1932 o - S 1 0 0 - R g 1941 o - Ap 7 0 1 S @@ -1947,12 +1231,6 @@ R g 1979 o - Ap 1 9 1 S R g 1979 o - S 29 2 0 - R g 1980 o - Ap 1 0 1 S R g 1980 o - S 28 0 0 - -Z Europe/Athens 1:34:52 - LMT 1895 S 14 -1:34:52 - AMT 1916 Jul 28 0:1 -2 g EE%sT 1941 Ap 30 -1 g CE%sT 1944 Ap 4 -2 g EE%sT 1981 -2 E EE%sT R h 1918 1919 - Ap 15 2 1 S R h 1918 1920 - S M>=15 3 0 - R h 1920 o - Ap 5 2 1 S @@ -1972,12 +1250,6 @@ R h 1980 o - Ap 6 0 1 S R h 1980 o - S 28 1 0 - R h 1981 1983 - Mar lastSu 0 1 S R h 1981 1983 - S lastSu 1 0 - -Z Europe/Budapest 1:16:20 - LMT 1890 N -1 c CE%sT 1918 -1 h CE%sT 1941 Ap 7 23 -1 c CE%sT 1945 -1 h CE%sT 1984 -1 E CE%sT R I 1916 o - Jun 3 24 1 S R I 1916 1917 - S 30 24 0 - R I 1917 o - Mar 31 24 1 S @@ -2019,44 +1291,8 @@ R I 1976 o - May 30 0s 1 S R I 1977 1979 - May Su>=22 0s 1 S R I 1978 o - O 1 0s 0 - R I 1979 o - S 30 0s 0 - -Z Europe/Rome 0:49:56 - LMT 1866 D 12 -0:49:56 - RMT 1893 O 31 23u -1 I CE%sT 1943 S 10 -1 c CE%sT 1944 Jun 4 -1 I CE%sT 1980 -1 E CE%sT R LV 1989 1996 - Mar lastSu 2s 1 S R LV 1989 1996 - S lastSu 2s 0 - -Z Europe/Riga 1:36:34 - LMT 1880 -1:36:34 - RMT 1918 Ap 15 2 -1:36:34 1 LST 1918 S 16 3 -1:36:34 - RMT 1919 Ap 1 2 -1:36:34 1 LST 1919 May 22 3 -1:36:34 - RMT 1926 May 11 -2 - EET 1940 Au 5 -3 - MSK 1941 Jul -1 c CE%sT 1944 O 13 -3 R MSK/MSD 1989 Mar lastSu 2s -2 1 EEST 1989 S lastSu 2s -2 LV EE%sT 1997 Ja 21 -2 E EE%sT 2000 F 29 -2 - EET 2001 Ja 2 -2 E EE%sT -Z Europe/Vilnius 1:41:16 - LMT 1880 -1:24 - WMT 1917 -1:35:36 - KMT 1919 O 10 -1 - CET 1920 Jul 12 -2 - EET 1920 O 9 -1 - CET 1940 Au 3 -3 - MSK 1941 Jun 24 -1 c CE%sT 1944 Au -3 R MSK/MSD 1989 Mar 26 2s -2 R EE%sT 1991 S 29 2s -2 c EE%sT 1998 -2 - EET 1998 Mar 29 1u -1 E CE%sT 1999 O 31 1u -2 - EET 2003 -2 E EE%sT R MT 1973 o - Mar 31 0s 1 S R MT 1973 o - S 29 0s 0 - R MT 1974 o - Ap 21 0s 1 S @@ -2064,22 +1300,8 @@ R MT 1974 o - S 16 0s 0 - R MT 1975 1979 - Ap Su>=15 2 1 S R MT 1975 1980 - S Su>=15 2 0 - R MT 1980 o - Mar 31 2 1 S -Z Europe/Malta 0:58:4 - LMT 1893 N 2 -1 I CE%sT 1973 Mar 31 -1 MT CE%sT 1981 -1 E CE%sT R MD 1997 ma - Mar lastSu 2 1 S R MD 1997 ma - O lastSu 3 0 - -Z Europe/Chisinau 1:55:20 - LMT 1880 -1:55 - CMT 1918 F 15 -1:44:24 - BMT 1931 Jul 24 -2 z EE%sT 1940 Au 15 -2 1 EEST 1941 Jul 17 -1 c CE%sT 1944 Au 24 -3 R MSK/MSD 1990 May 6 2 -2 R EE%sT 1992 -2 e EE%sT 1997 -2 MD EE%sT R O 1918 1919 - S 16 2s 0 - R O 1919 o - Ap 15 2s 1 S R O 1944 o - Ap 3 2s 1 S @@ -2100,15 +1322,6 @@ R O 1959 1961 - O Su>=1 1s 0 - R O 1960 o - Ap 3 1s 1 S R O 1961 1964 - May lastSu 1s 1 S R O 1962 1964 - S lastSu 1s 0 - -Z Europe/Warsaw 1:24 - LMT 1880 -1:24 - WMT 1915 Au 5 -1 c CE%sT 1918 S 16 3 -2 O EE%sT 1922 Jun -1 O CE%sT 1940 Jun 23 2 -1 c CE%sT 1944 O -1 O CE%sT 1977 -1 W- CE%sT 1988 -1 E CE%sT R p 1916 o - Jun 17 23 1 S R p 1916 o - N 1 1 0 - R p 1917 o - F 28 23s 1 S @@ -2157,42 +1370,6 @@ R p 1979 1982 - S lastSu 1s 0 - R p 1980 o - Mar lastSu 0s 1 S R p 1981 1982 - Mar lastSu 1s 1 S R p 1983 o - Mar lastSu 2s 1 S -Z Europe/Lisbon -0:36:45 - LMT 1884 --0:36:45 - LMT 1912 Ja 1 0u -0 p WE%sT 1966 Ap 3 2 -1 - CET 1976 S 26 1 -0 p WE%sT 1983 S 25 1s -0 W- WE%sT 1992 S 27 1s -1 E CE%sT 1996 Mar 31 1u -0 E WE%sT -Z Atlantic/Azores -1:42:40 - LMT 1884 --1:54:32 - HMT 1912 Ja 1 2u --2 p -02/-01 1942 Ap 25 22s --2 p +00 1942 Au 15 22s --2 p -02/-01 1943 Ap 17 22s --2 p +00 1943 Au 28 22s --2 p -02/-01 1944 Ap 22 22s --2 p +00 1944 Au 26 22s --2 p -02/-01 1945 Ap 21 22s --2 p +00 1945 Au 25 22s --2 p -02/-01 1966 Ap 3 2 --1 p -01/+00 1983 S 25 1s --1 W- -01/+00 1992 S 27 1s -0 E WE%sT 1993 Mar 28 1u --1 E -01/+00 -Z Atlantic/Madeira -1:7:36 - LMT 1884 --1:7:36 - FMT 1912 Ja 1 1u --1 p -01/+00 1942 Ap 25 22s --1 p +01 1942 Au 15 22s --1 p -01/+00 1943 Ap 17 22s --1 p +01 1943 Au 28 22s --1 p -01/+00 1944 Ap 22 22s --1 p +01 1944 Au 26 22s --1 p -01/+00 1945 Ap 21 22s --1 p +01 1945 Au 25 22s --1 p -01/+00 1966 Ap 3 2 -0 p WE%sT 1983 S 25 1s -0 E WE%sT R z 1932 o - May 21 0s 1 S R z 1932 1939 - O Su>=1 0s 0 - R z 1933 1939 - Ap Su>=2 0s 1 S @@ -2202,252 +1379,6 @@ R z 1980 o - Ap 5 23 1 S R z 1980 o - S lastSu 1 0 - R z 1991 1993 - Mar lastSu 0s 1 S R z 1991 1993 - S lastSu 0s 0 - -Z Europe/Bucharest 1:44:24 - LMT 1891 O -1:44:24 - BMT 1931 Jul 24 -2 z EE%sT 1981 Mar 29 2s -2 c EE%sT 1991 -2 z EE%sT 1994 -2 e EE%sT 1997 -2 E EE%sT -Z Europe/Kaliningrad 1:22 - LMT 1893 Ap -1 c CE%sT 1945 Ap 10 -2 O EE%sT 1946 Ap 7 -3 R MSK/MSD 1989 Mar 26 2s -2 R EE%sT 2011 Mar 27 2s -3 - +03 2014 O 26 2s -2 - EET -Z Europe/Moscow 2:30:17 - LMT 1880 -2:30:17 - MMT 1916 Jul 3 -2:31:19 R %s 1919 Jul 1 0u -3 R %s 1921 O -3 R MSK/MSD 1922 O -2 - EET 1930 Jun 21 -3 R MSK/MSD 1991 Mar 31 2s -2 R EE%sT 1992 Ja 19 2s -3 R MSK/MSD 2011 Mar 27 2s -4 - MSK 2014 O 26 2s -3 - MSK -Z Europe/Simferopol 2:16:24 - LMT 1880 -2:16 - SMT 1924 May 2 -2 - EET 1930 Jun 21 -3 - MSK 1941 N -1 c CE%sT 1944 Ap 13 -3 R MSK/MSD 1990 -3 - MSK 1990 Jul 1 2 -2 - EET 1992 Mar 20 -2 c EE%sT 1994 May -3 c MSK/MSD 1996 Mar 31 0s -3 1 MSD 1996 O 27 3s -3 - MSK 1997 Mar lastSu 1u -2 E EE%sT 2014 Mar 30 2 -4 - MSK 2014 O 26 2s -3 - MSK -Z Europe/Astrakhan 3:12:12 - LMT 1924 May -3 - +03 1930 Jun 21 -4 R +04/+05 1989 Mar 26 2s -3 R +03/+04 1991 Mar 31 2s -4 - +04 1992 Mar 29 2s -3 R +03/+04 2011 Mar 27 2s -4 - +04 2014 O 26 2s -3 - +03 2016 Mar 27 2s -4 - +04 -Z Europe/Volgograd 2:57:40 - LMT 1920 Ja 3 -3 - +03 1930 Jun 21 -4 - +04 1961 N 11 -4 R +04/+05 1988 Mar 27 2s -3 R MSK/MSD 1991 Mar 31 2s -4 - +04 1992 Mar 29 2s -3 R MSK/MSD 2011 Mar 27 2s -4 - MSK 2014 O 26 2s -3 - MSK 2018 O 28 2s -4 - +04 2020 D 27 2s -3 - MSK -Z Europe/Saratov 3:4:18 - LMT 1919 Jul 1 0u -3 - +03 1930 Jun 21 -4 R +04/+05 1988 Mar 27 2s -3 R +03/+04 1991 Mar 31 2s -4 - +04 1992 Mar 29 2s -3 R +03/+04 2011 Mar 27 2s -4 - +04 2014 O 26 2s -3 - +03 2016 D 4 2s -4 - +04 -Z Europe/Kirov 3:18:48 - LMT 1919 Jul 1 0u -3 - +03 1930 Jun 21 -4 R +04/+05 1989 Mar 26 2s -3 R MSK/MSD 1991 Mar 31 2s -4 - +04 1992 Mar 29 2s -3 R MSK/MSD 2011 Mar 27 2s -4 - MSK 2014 O 26 2s -3 - MSK -Z Europe/Samara 3:20:20 - LMT 1919 Jul 1 0u -3 - +03 1930 Jun 21 -4 - +04 1935 Ja 27 -4 R +04/+05 1989 Mar 26 2s -3 R +03/+04 1991 Mar 31 2s -2 R +02/+03 1991 S 29 2s -3 - +03 1991 O 20 3 -4 R +04/+05 2010 Mar 28 2s -3 R +03/+04 2011 Mar 27 2s -4 - +04 -Z Europe/Ulyanovsk 3:13:36 - LMT 1919 Jul 1 0u -3 - +03 1930 Jun 21 -4 R +04/+05 1989 Mar 26 2s -3 R +03/+04 1991 Mar 31 2s -2 R +02/+03 1992 Ja 19 2s -3 R +03/+04 2011 Mar 27 2s -4 - +04 2014 O 26 2s -3 - +03 2016 Mar 27 2s -4 - +04 -Z Asia/Yekaterinburg 4:2:33 - LMT 1916 Jul 3 -3:45:5 - PMT 1919 Jul 15 4 -4 - +04 1930 Jun 21 -5 R +05/+06 1991 Mar 31 2s -4 R +04/+05 1992 Ja 19 2s -5 R +05/+06 2011 Mar 27 2s -6 - +06 2014 O 26 2s -5 - +05 -Z Asia/Omsk 4:53:30 - LMT 1919 N 14 -5 - +05 1930 Jun 21 -6 R +06/+07 1991 Mar 31 2s -5 R +05/+06 1992 Ja 19 2s -6 R +06/+07 2011 Mar 27 2s -7 - +07 2014 O 26 2s -6 - +06 -Z Asia/Barnaul 5:35 - LMT 1919 D 10 -6 - +06 1930 Jun 21 -7 R +07/+08 1991 Mar 31 2s -6 R +06/+07 1992 Ja 19 2s -7 R +07/+08 1995 May 28 -6 R +06/+07 2011 Mar 27 2s -7 - +07 2014 O 26 2s -6 - +06 2016 Mar 27 2s -7 - +07 -Z Asia/Novosibirsk 5:31:40 - LMT 1919 D 14 6 -6 - +06 1930 Jun 21 -7 R +07/+08 1991 Mar 31 2s -6 R +06/+07 1992 Ja 19 2s -7 R +07/+08 1993 May 23 -6 R +06/+07 2011 Mar 27 2s -7 - +07 2014 O 26 2s -6 - +06 2016 Jul 24 2s -7 - +07 -Z Asia/Tomsk 5:39:51 - LMT 1919 D 22 -6 - +06 1930 Jun 21 -7 R +07/+08 1991 Mar 31 2s -6 R +06/+07 1992 Ja 19 2s -7 R +07/+08 2002 May 1 3 -6 R +06/+07 2011 Mar 27 2s -7 - +07 2014 O 26 2s -6 - +06 2016 May 29 2s -7 - +07 -Z Asia/Novokuznetsk 5:48:48 - LMT 1924 May -6 - +06 1930 Jun 21 -7 R +07/+08 1991 Mar 31 2s -6 R +06/+07 1992 Ja 19 2s -7 R +07/+08 2010 Mar 28 2s -6 R +06/+07 2011 Mar 27 2s -7 - +07 -Z Asia/Krasnoyarsk 6:11:26 - LMT 1920 Ja 6 -6 - +06 1930 Jun 21 -7 R +07/+08 1991 Mar 31 2s -6 R +06/+07 1992 Ja 19 2s -7 R +07/+08 2011 Mar 27 2s -8 - +08 2014 O 26 2s -7 - +07 -Z Asia/Irkutsk 6:57:5 - LMT 1880 -6:57:5 - IMT 1920 Ja 25 -7 - +07 1930 Jun 21 -8 R +08/+09 1991 Mar 31 2s -7 R +07/+08 1992 Ja 19 2s -8 R +08/+09 2011 Mar 27 2s -9 - +09 2014 O 26 2s -8 - +08 -Z Asia/Chita 7:33:52 - LMT 1919 D 15 -8 - +08 1930 Jun 21 -9 R +09/+10 1991 Mar 31 2s -8 R +08/+09 1992 Ja 19 2s -9 R +09/+10 2011 Mar 27 2s -10 - +10 2014 O 26 2s -8 - +08 2016 Mar 27 2 -9 - +09 -Z Asia/Yakutsk 8:38:58 - LMT 1919 D 15 -8 - +08 1930 Jun 21 -9 R +09/+10 1991 Mar 31 2s -8 R +08/+09 1992 Ja 19 2s -9 R +09/+10 2011 Mar 27 2s -10 - +10 2014 O 26 2s -9 - +09 -Z Asia/Vladivostok 8:47:31 - LMT 1922 N 15 -9 - +09 1930 Jun 21 -10 R +10/+11 1991 Mar 31 2s -9 R +09/+10 1992 Ja 19 2s -10 R +10/+11 2011 Mar 27 2s -11 - +11 2014 O 26 2s -10 - +10 -Z Asia/Khandyga 9:2:13 - LMT 1919 D 15 -8 - +08 1930 Jun 21 -9 R +09/+10 1991 Mar 31 2s -8 R +08/+09 1992 Ja 19 2s -9 R +09/+10 2004 -10 R +10/+11 2011 Mar 27 2s -11 - +11 2011 S 13 0s -10 - +10 2014 O 26 2s -9 - +09 -Z Asia/Sakhalin 9:30:48 - LMT 1905 Au 23 -9 - +09 1945 Au 25 -11 R +11/+12 1991 Mar 31 2s -10 R +10/+11 1992 Ja 19 2s -11 R +11/+12 1997 Mar lastSu 2s -10 R +10/+11 2011 Mar 27 2s -11 - +11 2014 O 26 2s -10 - +10 2016 Mar 27 2s -11 - +11 -Z Asia/Magadan 10:3:12 - LMT 1924 May 2 -10 - +10 1930 Jun 21 -11 R +11/+12 1991 Mar 31 2s -10 R +10/+11 1992 Ja 19 2s -11 R +11/+12 2011 Mar 27 2s -12 - +12 2014 O 26 2s -10 - +10 2016 Ap 24 2s -11 - +11 -Z Asia/Srednekolymsk 10:14:52 - LMT 1924 May 2 -10 - +10 1930 Jun 21 -11 R +11/+12 1991 Mar 31 2s -10 R +10/+11 1992 Ja 19 2s -11 R +11/+12 2011 Mar 27 2s -12 - +12 2014 O 26 2s -11 - +11 -Z Asia/Ust-Nera 9:32:54 - LMT 1919 D 15 -8 - +08 1930 Jun 21 -9 R +09/+10 1981 Ap -11 R +11/+12 1991 Mar 31 2s -10 R +10/+11 1992 Ja 19 2s -11 R +11/+12 2011 Mar 27 2s -12 - +12 2011 S 13 0s -11 - +11 2014 O 26 2s -10 - +10 -Z Asia/Kamchatka 10:34:36 - LMT 1922 N 10 -11 - +11 1930 Jun 21 -12 R +12/+13 1991 Mar 31 2s -11 R +11/+12 1992 Ja 19 2s -12 R +12/+13 2010 Mar 28 2s -11 R +11/+12 2011 Mar 27 2s -12 - +12 -Z Asia/Anadyr 11:49:56 - LMT 1924 May 2 -12 - +12 1930 Jun 21 -13 R +13/+14 1982 Ap 1 0s -12 R +12/+13 1991 Mar 31 2s -11 R +11/+12 1992 Ja 19 2s -12 R +12/+13 2010 Mar 28 2s -11 R +11/+12 2011 Mar 27 2s -12 - +12 -Z Europe/Belgrade 1:22 - LMT 1884 -1 - CET 1941 Ap 18 23 -1 c CE%sT 1945 -1 - CET 1945 May 8 2s -1 1 CEST 1945 S 16 2s -1 - CET 1982 N 27 -1 E CE%sT R s 1918 o - Ap 15 23 1 S R s 1918 1919 - O 6 24s 0 - R s 1919 o - Ap 6 23 1 S @@ -2487,30 +1418,8 @@ R Sp 1976 o - Au 1 0 0 - R Sp 1977 o - S 28 0 0 - R Sp 1978 o - Jun 1 0 1 S R Sp 1978 o - Au 4 0 0 - -Z Europe/Madrid -0:14:44 - LMT 1901 Ja 1 0u -0 s WE%sT 1940 Mar 16 23 -1 s CE%sT 1979 -1 E CE%sT -Z Africa/Ceuta -0:21:16 - LMT 1901 Ja 1 0u -0 - WET 1918 May 6 23 -0 1 WEST 1918 O 7 23 -0 - WET 1924 -0 s WE%sT 1929 -0 - WET 1967 -0 Sp WE%sT 1984 Mar 16 -1 - CET 1986 -1 E CE%sT -Z Atlantic/Canary -1:1:36 - LMT 1922 Mar --1 - -01 1946 S 30 1 -0 - WET 1980 Ap 6 0s -0 1 WEST 1980 S 28 1u -0 E WE%sT R CH 1941 1942 - May M>=1 1 1 S R CH 1941 1942 - O M>=1 2 0 - -Z Europe/Zurich 0:34:8 - LMT 1853 Jul 16 -0:29:46 - BMT 1894 Jun -1 CH CE%sT 1981 -1 E CE%sT R T 1916 o - May 1 0 1 S R T 1916 o - O 1 0 0 - R T 1920 o - Mar 28 0 1 S @@ -2556,28 +1465,6 @@ R T 1986 1995 - S lastSu 1s 0 - R T 1994 o - Mar 20 1s 1 S R T 1995 2006 - Mar lastSu 1s 1 S R T 1996 2006 - O lastSu 1s 0 - -Z Europe/Istanbul 1:55:52 - LMT 1880 -1:56:56 - IMT 1910 O -2 T EE%sT 1978 Jun 29 -3 T +03/+04 1984 N 1 2 -2 T EE%sT 2007 -2 E EE%sT 2011 Mar 27 1u -2 - EET 2011 Mar 28 1u -2 E EE%sT 2014 Mar 30 1u -2 - EET 2014 Mar 31 1u -2 E EE%sT 2015 O 25 1u -2 1 EEST 2015 N 8 1u -2 E EE%sT 2016 S 7 -3 - +03 -Z Europe/Kyiv 2:2:4 - LMT 1880 -2:2:4 - KMT 1924 May 2 -2 - EET 1930 Jun 21 -3 - MSK 1941 S 20 -1 c CE%sT 1943 N 6 -3 R MSK/MSD 1990 Jul 1 2 -2 1 EEST 1991 S 29 3 -2 c EE%sT 1996 May 13 -2 E EE%sT R u 1918 1919 - Mar lastSu 2 1 D R u 1918 1919 - O lastSu 2 0 S R u 1942 o - F 9 2 1 W @@ -2591,172 +1478,34 @@ R u 1976 1986 - Ap lastSu 2 1 D R u 1987 2006 - Ap Su>=1 2 1 D R u 2007 ma - Mar Su>=8 2 1 D R u 2007 ma - N Su>=1 2 0 S -Z EST -5 - EST -Z MST -7 - MST -Z HST -10 - HST -Z EST5EDT -5 u E%sT -Z CST6CDT -6 u C%sT -Z MST7MDT -7 u M%sT -Z PST8PDT -8 u P%sT R NY 1920 o - Mar lastSu 2 1 D R NY 1920 o - O lastSu 2 0 S R NY 1921 1966 - Ap lastSu 2 1 D R NY 1921 1954 - S lastSu 2 0 S R NY 1955 1966 - O lastSu 2 0 S -Z America/New_York -4:56:2 - LMT 1883 N 18 17u --5 u E%sT 1920 --5 NY E%sT 1942 --5 u E%sT 1946 --5 NY E%sT 1967 --5 u E%sT R Ch 1920 o - Jun 13 2 1 D R Ch 1920 1921 - O lastSu 2 0 S R Ch 1921 o - Mar lastSu 2 1 D R Ch 1922 1966 - Ap lastSu 2 1 D R Ch 1922 1954 - S lastSu 2 0 S R Ch 1955 1966 - O lastSu 2 0 S -Z America/Chicago -5:50:36 - LMT 1883 N 18 18u --6 u C%sT 1920 --6 Ch C%sT 1936 Mar 1 2 --5 - EST 1936 N 15 2 --6 Ch C%sT 1942 --6 u C%sT 1946 --6 Ch C%sT 1967 --6 u C%sT -Z America/North_Dakota/Center -6:45:12 - LMT 1883 N 18 19u --7 u M%sT 1992 O 25 2 --6 u C%sT -Z America/North_Dakota/New_Salem -6:45:39 - LMT 1883 N 18 19u --7 u M%sT 2003 O 26 2 --6 u C%sT -Z America/North_Dakota/Beulah -6:47:7 - LMT 1883 N 18 19u --7 u M%sT 2010 N 7 2 --6 u C%sT R De 1920 1921 - Mar lastSu 2 1 D R De 1920 o - O lastSu 2 0 S R De 1921 o - May 22 2 0 S R De 1965 1966 - Ap lastSu 2 1 D R De 1965 1966 - O lastSu 2 0 S -Z America/Denver -6:59:56 - LMT 1883 N 18 19u --7 u M%sT 1920 --7 De M%sT 1942 --7 u M%sT 1946 --7 De M%sT 1967 --7 u M%sT R CA 1948 o - Mar 14 2:1 1 D R CA 1949 o - Ja 1 2 0 S R CA 1950 1966 - Ap lastSu 1 1 D R CA 1950 1961 - S lastSu 2 0 S R CA 1962 1966 - O lastSu 2 0 S -Z America/Los_Angeles -7:52:58 - LMT 1883 N 18 20u --8 u P%sT 1946 --8 CA P%sT 1967 --8 u P%sT -Z America/Juneau 15:2:19 - LMT 1867 O 19 15:33:32 --8:57:41 - LMT 1900 Au 20 12 --8 - PST 1942 --8 u P%sT 1946 --8 - PST 1969 --8 u P%sT 1980 Ap 27 2 --9 u Y%sT 1980 O 26 2 --8 u P%sT 1983 O 30 2 --9 u Y%sT 1983 N 30 --9 u AK%sT -Z America/Sitka 14:58:47 - LMT 1867 O 19 15:30 --9:1:13 - LMT 1900 Au 20 12 --8 - PST 1942 --8 u P%sT 1946 --8 - PST 1969 --8 u P%sT 1983 O 30 2 --9 u Y%sT 1983 N 30 --9 u AK%sT -Z America/Metlakatla 15:13:42 - LMT 1867 O 19 15:44:55 --8:46:18 - LMT 1900 Au 20 12 --8 - PST 1942 --8 u P%sT 1946 --8 - PST 1969 --8 u P%sT 1983 O 30 2 --8 - PST 2015 N 1 2 --9 u AK%sT 2018 N 4 2 --8 - PST 2019 Ja 20 2 --9 u AK%sT -Z America/Yakutat 14:41:5 - LMT 1867 O 19 15:12:18 --9:18:55 - LMT 1900 Au 20 12 --9 - YST 1942 --9 u Y%sT 1946 --9 - YST 1969 --9 u Y%sT 1983 N 30 --9 u AK%sT -Z America/Anchorage 14:0:24 - LMT 1867 O 19 14:31:37 --9:59:36 - LMT 1900 Au 20 12 --10 - AST 1942 --10 u A%sT 1967 Ap --10 - AHST 1969 --10 u AH%sT 1983 O 30 2 --9 u Y%sT 1983 N 30 --9 u AK%sT -Z America/Nome 12:58:22 - LMT 1867 O 19 13:29:35 --11:1:38 - LMT 1900 Au 20 12 --11 - NST 1942 --11 u N%sT 1946 --11 - NST 1967 Ap --11 - BST 1969 --11 u B%sT 1983 O 30 2 --9 u Y%sT 1983 N 30 --9 u AK%sT -Z America/Adak 12:13:22 - LMT 1867 O 19 12:44:35 --11:46:38 - LMT 1900 Au 20 12 --11 - NST 1942 --11 u N%sT 1946 --11 - NST 1967 Ap --11 - BST 1969 --11 u B%sT 1983 O 30 2 --10 u AH%sT 1983 N 30 --10 u H%sT -Z Pacific/Honolulu -10:31:26 - LMT 1896 Ja 13 12 --10:30 - HST 1933 Ap 30 2 --10:30 1 HDT 1933 May 21 12 --10:30 u H%sT 1947 Jun 8 2 --10 - HST -Z America/Phoenix -7:28:18 - LMT 1883 N 18 19u --7 u M%sT 1944 Ja 1 0:1 --7 - MST 1944 Ap 1 0:1 --7 u M%sT 1944 O 1 0:1 --7 - MST 1967 --7 u M%sT 1968 Mar 21 --7 - MST -Z America/Boise -7:44:49 - LMT 1883 N 18 20u --8 u P%sT 1923 May 13 2 --7 u M%sT 1974 --7 - MST 1974 F 3 2 --7 u M%sT R In 1941 o - Jun 22 2 1 D R In 1941 1954 - S lastSu 2 0 S R In 1946 1954 - Ap lastSu 2 1 D -Z America/Indiana/Indianapolis -5:44:38 - LMT 1883 N 18 18u --6 u C%sT 1920 --6 In C%sT 1942 --6 u C%sT 1946 --6 In C%sT 1955 Ap 24 2 --5 - EST 1957 S 29 2 --6 - CST 1958 Ap 27 2 --5 - EST 1969 --5 u E%sT 1971 --5 - EST 2006 --5 u E%sT R Ma 1951 o - Ap lastSu 2 1 D R Ma 1951 o - S lastSu 2 0 S R Ma 1954 1960 - Ap lastSu 2 1 D R Ma 1954 1960 - S lastSu 2 0 S -Z America/Indiana/Marengo -5:45:23 - LMT 1883 N 18 18u --6 u C%sT 1951 --6 Ma C%sT 1961 Ap 30 2 --5 - EST 1969 --5 u E%sT 1974 Ja 6 2 --6 1 CDT 1974 O 27 2 --5 u E%sT 1976 --5 - EST 2006 --5 u E%sT R V 1946 o - Ap lastSu 2 1 D R V 1946 o - S lastSu 2 0 S R V 1953 1954 - Ap lastSu 2 1 D @@ -2766,68 +1515,23 @@ R V 1956 1963 - Ap lastSu 2 1 D R V 1960 o - O lastSu 2 0 S R V 1961 o - S lastSu 2 0 S R V 1962 1963 - O lastSu 2 0 S -Z America/Indiana/Vincennes -5:50:7 - LMT 1883 N 18 18u --6 u C%sT 1946 --6 V C%sT 1964 Ap 26 2 --5 - EST 1969 --5 u E%sT 1971 --5 - EST 2006 Ap 2 2 --6 u C%sT 2007 N 4 2 --5 u E%sT R Pe 1955 o - May 1 0 1 D R Pe 1955 1960 - S lastSu 2 0 S R Pe 1956 1963 - Ap lastSu 2 1 D R Pe 1961 1963 - O lastSu 2 0 S -Z America/Indiana/Tell_City -5:47:3 - LMT 1883 N 18 18u --6 u C%sT 1946 --6 Pe C%sT 1964 Ap 26 2 --5 - EST 1967 O 29 2 --6 u C%sT 1969 Ap 27 2 --5 u E%sT 1971 --5 - EST 2006 Ap 2 2 --6 u C%sT R Pi 1955 o - May 1 0 1 D R Pi 1955 1960 - S lastSu 2 0 S R Pi 1956 1964 - Ap lastSu 2 1 D R Pi 1961 1964 - O lastSu 2 0 S -Z America/Indiana/Petersburg -5:49:7 - LMT 1883 N 18 18u --6 u C%sT 1955 --6 Pi C%sT 1965 Ap 25 2 --5 - EST 1966 O 30 2 --6 u C%sT 1977 O 30 2 --5 - EST 2006 Ap 2 2 --6 u C%sT 2007 N 4 2 --5 u E%sT R St 1947 1961 - Ap lastSu 2 1 D R St 1947 1954 - S lastSu 2 0 S R St 1955 1956 - O lastSu 2 0 S R St 1957 1958 - S lastSu 2 0 S R St 1959 1961 - O lastSu 2 0 S -Z America/Indiana/Knox -5:46:30 - LMT 1883 N 18 18u --6 u C%sT 1947 --6 St C%sT 1962 Ap 29 2 --5 - EST 1963 O 27 2 --6 u C%sT 1991 O 27 2 --5 - EST 2006 Ap 2 2 --6 u C%sT R Pu 1946 1960 - Ap lastSu 2 1 D R Pu 1946 1954 - S lastSu 2 0 S R Pu 1955 1956 - O lastSu 2 0 S R Pu 1957 1960 - S lastSu 2 0 S -Z America/Indiana/Winamac -5:46:25 - LMT 1883 N 18 18u --6 u C%sT 1946 --6 Pu C%sT 1961 Ap 30 2 --5 - EST 1969 --5 u E%sT 1971 --5 - EST 2006 Ap 2 2 --6 u C%sT 2007 Mar 11 2 --5 u E%sT -Z America/Indiana/Vevay -5:40:16 - LMT 1883 N 18 18u --6 u C%sT 1954 Ap 25 2 --5 - EST 1969 --5 u E%sT 1973 --5 - EST 2006 --5 u E%sT R v 1921 o - May 1 2 1 D R v 1921 o - S 1 2 0 S R v 1941 o - Ap lastSu 2 1 D @@ -2837,41 +1541,12 @@ R v 1946 o - Jun 2 2 0 S R v 1950 1961 - Ap lastSu 2 1 D R v 1950 1955 - S lastSu 2 0 S R v 1956 1961 - O lastSu 2 0 S -Z America/Kentucky/Louisville -5:43:2 - LMT 1883 N 18 18u --6 u C%sT 1921 --6 v C%sT 1942 --6 u C%sT 1946 --6 v C%sT 1961 Jul 23 2 --5 - EST 1968 --5 u E%sT 1974 Ja 6 2 --6 1 CDT 1974 O 27 2 --5 u E%sT -Z America/Kentucky/Monticello -5:39:24 - LMT 1883 N 18 18u --6 u C%sT 1946 --6 - CST 1968 --6 u C%sT 2000 O 29 2 --5 u E%sT R Dt 1948 o - Ap lastSu 2 1 D R Dt 1948 o - S lastSu 2 0 S -Z America/Detroit -5:32:11 - LMT 1905 --6 - CST 1915 May 15 2 --5 - EST 1942 --5 u E%sT 1946 --5 Dt E%sT 1967 Jun 14 0:1 --5 u E%sT 1969 --5 - EST 1973 --5 u E%sT 1975 --5 - EST 1975 Ap 27 2 --5 u E%sT R Me 1946 o - Ap lastSu 2 1 D R Me 1946 o - S lastSu 2 0 S R Me 1966 o - Ap lastSu 2 1 D R Me 1966 o - O lastSu 2 0 S -Z America/Menominee -5:50:27 - LMT 1885 S 18 12 --6 u C%sT 1946 --6 Me C%sT 1969 Ap 27 2 --5 - EST 1973 Ap 29 2 --6 u C%sT R C 1918 o - Ap 14 2 1 D R C 1918 o - O 27 2 0 S R C 1942 o - F 9 2 1 W @@ -2901,24 +1576,6 @@ R j 1988 o - Ap Su>=1 0:1 2 DD R j 1989 2006 - Ap Su>=1 0:1 1 D R j 2007 2011 - Mar Su>=8 0:1 1 D R j 2007 2010 - N Su>=1 0:1 0 S -Z America/St_Johns -3:30:52 - LMT 1884 --3:30:52 j N%sT 1918 --3:30:52 C N%sT 1919 --3:30:52 j N%sT 1935 Mar 30 --3:30 j N%sT 1942 May 11 --3:30 C N%sT 1946 --3:30 j N%sT 2011 N --3:30 C N%sT -Z America/Goose_Bay -4:1:40 - LMT 1884 --3:30:52 - NST 1918 --3:30:52 C N%sT 1919 --3:30:52 - NST 1935 Mar 30 --3:30 - NST 1936 --3:30 j N%sT 1942 May 11 --3:30 C N%sT 1946 --3:30 j N%sT 1966 Mar 15 2 --4 j A%sT 2011 N --4 C A%sT R H 1916 o - Ap 1 0 1 D R H 1916 o - O 1 0 0 S R H 1920 o - May 9 0 1 D @@ -2960,19 +1617,6 @@ R H 1956 1959 - Ap lastSu 2 1 D R H 1956 1959 - S lastSu 2 0 S R H 1962 1973 - Ap lastSu 2 1 D R H 1962 1973 - O lastSu 2 0 S -Z America/Halifax -4:14:24 - LMT 1902 Jun 15 --4 H A%sT 1918 --4 C A%sT 1919 --4 H A%sT 1942 F 9 2s --4 C A%sT 1946 --4 H A%sT 1974 --4 C A%sT -Z America/Glace_Bay -3:59:48 - LMT 1902 Jun 15 --4 C A%sT 1953 --4 H A%sT 1954 --4 - AST 1972 --4 H A%sT 1974 --4 C A%sT R o 1933 1935 - Jun Su>=8 1 1 D R o 1933 1935 - S Su>=8 1 0 S R o 1936 1938 - Jun Su>=1 1 1 D @@ -2986,15 +1630,6 @@ R o 1946 1956 - S lastSu 2 0 S R o 1957 1972 - O lastSu 2 0 S R o 1993 2006 - Ap Su>=1 0:1 1 D R o 1993 2006 - O lastSu 0:1 0 S -Z America/Moncton -4:19:8 - LMT 1883 D 9 --5 - EST 1902 Jun 15 --4 C A%sT 1933 --4 o A%sT 1942 --4 C A%sT 1946 --4 o A%sT 1973 --4 C A%sT 1993 --4 o A%sT 2007 --4 C A%sT R t 1919 o - Mar 30 23:30 1 D R t 1919 o - O 26 0 0 S R t 1920 o - May 2 2 1 D @@ -3008,21 +1643,11 @@ R t 1927 1937 - S Su>=25 2 0 S R t 1928 1937 - Ap Su>=25 2 1 D R t 1938 1940 - Ap lastSu 2 1 D R t 1938 1939 - S lastSu 2 0 S -R t 1945 1946 - S lastSu 2 0 S -R t 1946 o - Ap lastSu 2 1 D -R t 1947 1949 - Ap lastSu 0 1 D -R t 1947 1948 - S lastSu 0 0 S -R t 1949 o - N lastSu 0 0 S -R t 1950 1973 - Ap lastSu 2 1 D -R t 1950 o - N lastSu 2 0 S +R t 1945 1948 - S lastSu 2 0 S +R t 1946 1973 - Ap lastSu 2 1 D +R t 1949 1950 - N lastSu 2 0 S R t 1951 1956 - S lastSu 2 0 S R t 1957 1973 - O lastSu 2 0 S -Z America/Toronto -5:17:32 - LMT 1895 --5 C E%sT 1919 --5 t E%sT 1942 F 9 2s --5 C E%sT 1946 --5 t E%sT 1974 --5 C E%sT R W 1916 o - Ap 23 0 1 D R W 1916 o - S 17 0 0 S R W 1918 o - Ap 14 2 1 D @@ -3047,9 +1672,6 @@ R W 1963 o - S 22 2 0 S R W 1966 1986 - Ap lastSu 2s 1 D R W 1966 2005 - O lastSu 2s 0 S R W 1987 2005 - Ap Su>=1 2s 1 D -Z America/Winnipeg -6:28:36 - LMT 1887 Jul 16 --6 W C%sT 2006 --6 C C%sT R r 1918 o - Ap 14 2 1 D R r 1918 o - O 27 2 0 S R r 1930 1934 - May Su>=1 0 1 D @@ -3072,14 +1694,6 @@ R Sw 1957 o - O lastSu 2 0 S R Sw 1959 1961 - Ap lastSu 2 1 D R Sw 1959 o - O lastSu 2 0 S R Sw 1960 1961 - S lastSu 2 0 S -Z America/Regina -6:58:36 - LMT 1905 S --7 r M%sT 1960 Ap lastSu 2 --6 - CST -Z America/Swift_Current -7:11:20 - LMT 1905 S --7 C M%sT 1946 Ap lastSu 2 --7 r M%sT 1950 --7 Sw M%sT 1972 Ap lastSu 2 --6 - CST R Ed 1918 1919 - Ap Su>=8 2 1 D R Ed 1918 o - O 27 2 0 S R Ed 1919 o - May 27 2 0 S @@ -3093,9 +1707,6 @@ R Ed 1947 o - Ap lastSu 2 1 D R Ed 1947 o - S lastSu 2 0 S R Ed 1972 1986 - Ap lastSu 2 1 D R Ed 1972 2006 - O lastSu 2 0 S -Z America/Edmonton -7:33:52 - LMT 1906 S --7 Ed M%sT 1987 --7 C M%sT R Va 1918 o - Ap 14 2 1 D R Va 1918 o - O 27 2 0 S R Va 1942 o - F 9 2 1 W @@ -3105,19 +1716,6 @@ R Va 1946 1986 - Ap lastSu 2 1 D R Va 1946 o - S 29 2 0 S R Va 1947 1961 - S lastSu 2 0 S R Va 1962 2006 - O lastSu 2 0 S -Z America/Vancouver -8:12:28 - LMT 1884 --8 Va P%sT 1987 --8 C P%sT -Z America/Dawson_Creek -8:0:56 - LMT 1884 --8 C P%sT 1947 --8 Va P%sT 1972 Au 30 2 --7 - MST -Z America/Fort_Nelson -8:10:47 - LMT 1884 --8 Va P%sT 1946 --8 - PST 1947 --8 Va P%sT 1987 --8 C P%sT 2015 Mar 8 2 --7 - MST R Y 1918 o - Ap 14 2 1 D R Y 1918 o - O 27 2 0 S R Y 1919 o - May 25 2 1 D @@ -3130,42 +1728,6 @@ R Y 1972 2006 - O lastSu 2 0 S R Y 1987 2006 - Ap Su>=1 2 1 D R Yu 1965 o - Ap lastSu 0 2 DD R Yu 1965 o - O lastSu 2 0 S -Z America/Iqaluit 0 - -00 1942 Au --5 Y E%sT 1999 O 31 2 --6 C C%sT 2000 O 29 2 --5 C E%sT -Z America/Resolute 0 - -00 1947 Au 31 --6 Y C%sT 2000 O 29 2 --5 - EST 2001 Ap 1 3 --6 C C%sT 2006 O 29 2 --5 - EST 2007 Mar 11 3 --6 C C%sT -Z America/Rankin_Inlet 0 - -00 1957 --6 Y C%sT 2000 O 29 2 --5 - EST 2001 Ap 1 3 --6 C C%sT -Z America/Cambridge_Bay 0 - -00 1920 --7 Y M%sT 1999 O 31 2 --6 C C%sT 2000 O 29 2 --5 - EST 2000 N 5 --6 - CST 2001 Ap 1 3 --7 C M%sT -Z America/Inuvik 0 - -00 1953 --8 Y P%sT 1979 Ap lastSu 2 --7 Y M%sT 1980 --7 C M%sT -Z America/Whitehorse -9:0:12 - LMT 1900 Au 20 --9 Y Y%sT 1965 --9 Yu Y%sT 1966 F 27 --8 - PST 1980 --8 C P%sT 2020 N --7 - MST -Z America/Dawson -9:17:40 - LMT 1900 Au 20 --9 Y Y%sT 1965 --9 Yu Y%sT 1973 O 28 --8 - PST 1980 --8 C P%sT 2020 N --7 - MST R m 1931 o - May 1 23 1 D R m 1931 o - O 1 0 0 S R m 1939 o - F 5 0 1 D @@ -3182,107 +1744,6 @@ R m 2001 o - May Su>=1 2 1 D R m 2001 o - S lastSu 2 0 S R m 2002 2022 - Ap Su>=1 2 1 D R m 2002 2022 - O lastSu 2 0 S -Z America/Cancun -5:47:4 - LMT 1922 Ja 1 6u --6 - CST 1981 D 23 --5 m E%sT 1998 Au 2 2 --6 m C%sT 2015 F 1 2 --5 - EST -Z America/Merida -5:58:28 - LMT 1922 Ja 1 6u --6 - CST 1981 D 23 --5 - EST 1982 D 2 --6 m C%sT -Z America/Matamoros -6:30 - LMT 1922 Ja 1 6u --6 - CST 1988 --6 u C%sT 1989 --6 m C%sT 2010 --6 u C%sT -Z America/Monterrey -6:41:16 - LMT 1922 Ja 1 6u --6 - CST 1988 --6 u C%sT 1989 --6 m C%sT -Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u --7 - MST 1927 Jun 10 23 --6 - CST 1930 N 15 --7 m M%sT 1932 Ap --6 m C%sT 2001 S 30 2 --6 - CST 2002 F 20 --6 m C%sT -Z America/Ciudad_Juarez -7:5:56 - LMT 1922 Ja 1 7u --7 - MST 1927 Jun 10 23 --6 - CST 1930 N 15 --7 m M%sT 1932 Ap --6 - CST 1996 --6 m C%sT 1998 --6 - CST 1998 Ap Su>=1 3 --7 m M%sT 2010 --7 u M%sT 2022 O 30 2 --6 - CST 2022 N 30 --7 u M%sT -Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u --7 - MST 1927 Jun 10 23 --6 - CST 1930 N 15 --7 m M%sT 1932 Ap --6 - CST 1996 --6 m C%sT 1998 --6 - CST 1998 Ap Su>=1 3 --7 m M%sT 2010 --7 u M%sT 2022 O 30 2 --6 - CST 2022 N 30 --6 u C%sT -Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u --7 - MST 1927 Jun 10 23 --6 - CST 1930 N 15 --7 m M%sT 1932 Ap --6 - CST 1996 --6 m C%sT 1998 --6 - CST 1998 Ap Su>=1 3 --7 m M%sT 2022 O 30 2 --6 - CST -Z America/Hermosillo -7:23:52 - LMT 1922 Ja 1 7u --7 - MST 1927 Jun 10 23 --6 - CST 1930 N 15 --7 m M%sT 1932 Ap --6 - CST 1942 Ap 24 --7 - MST 1949 Ja 14 --8 - PST 1970 --7 m M%sT 1999 --7 - MST -Z America/Mazatlan -7:5:40 - LMT 1922 Ja 1 7u --7 - MST 1927 Jun 10 23 --6 - CST 1930 N 15 --7 m M%sT 1932 Ap --6 - CST 1942 Ap 24 --7 - MST 1949 Ja 14 --8 - PST 1970 --7 m M%sT -Z America/Bahia_Banderas -7:1 - LMT 1922 Ja 1 7u --7 - MST 1927 Jun 10 23 --6 - CST 1930 N 15 --7 m M%sT 1932 Ap --6 - CST 1942 Ap 24 --7 - MST 1949 Ja 14 --8 - PST 1970 --7 m M%sT 2010 Ap 4 2 --6 m C%sT -Z America/Tijuana -7:48:4 - LMT 1922 Ja 1 7u --7 - MST 1924 --8 - PST 1927 Jun 10 23 --7 - MST 1930 N 15 --8 - PST 1931 Ap --8 1 PDT 1931 S 30 --8 - PST 1942 Ap 24 --8 1 PWT 1945 Au 14 23u --8 1 PPT 1945 N 12 --8 - PST 1948 Ap 5 --8 1 PDT 1949 Ja 14 --8 - PST 1954 --8 CA P%sT 1961 --8 - PST 1976 --8 u P%sT 1996 --8 m P%sT 2001 --8 u P%sT 2002 F 20 --8 m P%sT 2010 --8 u P%sT R BB 1942 o - Ap 19 5u 1 D R BB 1942 o - Au 31 6u 0 S R BB 1943 o - May 2 5u 1 D @@ -3294,10 +1755,6 @@ R BB 1977 1978 - O Su>=1 2 0 S R BB 1978 1980 - Ap Su>=15 2 1 D R BB 1979 o - S 30 2 0 S R BB 1980 o - S 25 2 0 S -Z America/Barbados -3:58:29 - LMT 1911 Au 28 --4 BB A%sT 1944 --4 BB AST/-0330 1945 --4 BB A%sT R BZ 1918 1941 - O Sa>=1 24 0:30 -0530 R BZ 1919 1942 - F Sa>=8 24 0 CST R BZ 1942 o - Jun 27 24 1 CWT @@ -3309,8 +1766,6 @@ R BZ 1973 o - D 5 0 1 CDT R BZ 1974 o - F 9 0 0 CST R BZ 1982 o - D 18 0 1 CDT R BZ 1983 o - F 12 0 0 CST -Z America/Belize -5:52:48 - LMT 1912 Ap --6 BZ %s R Be 1917 o - Ap 5 24 1 - R Be 1917 o - S 30 24 0 - R Be 1918 o - Ap 13 24 1 - @@ -3327,19 +1782,11 @@ R Be 1948 1952 - May Su>=22 2 1 D R Be 1948 1952 - S Su>=1 2 0 S R Be 1956 o - May Su>=22 2 1 D R Be 1956 o - O lastSu 2 0 S -Z Atlantic/Bermuda -4:19:18 - LMT 1890 --4:19:18 Be BMT/BST 1930 Ja 1 2 --4 Be A%sT 1974 Ap 28 2 --4 C A%sT 1976 --4 u A%sT R CR 1979 1980 - F lastSu 0 1 D R CR 1979 1980 - Jun Su>=1 0 0 S R CR 1991 1992 - Ja Sa>=15 0 1 D R CR 1991 o - Jul 1 0 0 S R CR 1992 o - Mar 15 0 0 S -Z America/Costa_Rica -5:36:13 - LMT 1890 --5:36:13 - SJMT 1921 Ja 15 --6 CR C%sT R Q 1928 o - Jun 10 0 1 D R Q 1928 o - O 10 0 0 S R Q 1940 1942 - Jun Su>=1 0 1 D @@ -3379,25 +1826,14 @@ R Q 2011 o - N 13 0s 0 S R Q 2012 o - Ap 1 0s 1 D R Q 2012 ma - N Su>=1 0s 0 S R Q 2013 ma - Mar Su>=8 0s 1 D -Z America/Havana -5:29:28 - LMT 1890 --5:29:36 - HMT 1925 Jul 19 12 --5 Q C%sT R DO 1966 o - O 30 0 1 EDT R DO 1967 o - F 28 0 0 EST R DO 1969 1973 - O lastSu 0 0:30 -0430 R DO 1970 o - F 21 0 0 EST R DO 1971 o - Ja 20 0 0 EST R DO 1972 1974 - Ja 21 0 0 EST -Z America/Santo_Domingo -4:39:36 - LMT 1890 --4:40 - SDMT 1933 Ap 1 12 --5 DO %s 1974 O 27 --4 - AST 2000 O 29 2 --5 u E%sT 2000 D 3 1 --4 - AST R SV 1987 1988 - May Su>=1 0 1 D R SV 1987 1988 - S lastSu 0 0 S -Z America/El_Salvador -5:56:48 - LMT 1921 --6 SV C%sT R GT 1973 o - N 25 0 1 D R GT 1974 o - F 24 0 0 S R GT 1983 o - May 21 0 1 D @@ -3406,8 +1842,6 @@ R GT 1991 o - Mar 23 0 1 D R GT 1991 o - S 7 0 0 S R GT 2006 o - Ap 30 0 1 D R GT 2006 o - O 1 0 0 S -Z America/Guatemala -6:2:4 - LMT 1918 O 5 --6 GT C%sT R HT 1983 o - May 8 0 1 D R HT 1984 1987 - Ap lastSu 0 1 D R HT 1983 1987 - O lastSu 0 0 S @@ -3419,57 +1853,16 @@ R HT 2012 2015 - Mar Su>=8 2 1 D R HT 2012 2015 - N Su>=1 2 0 S R HT 2017 ma - Mar Su>=8 2 1 D R HT 2017 ma - N Su>=1 2 0 S -Z America/Port-au-Prince -4:49:20 - LMT 1890 --4:49 - PPMT 1917 Ja 24 12 --5 HT E%sT R HN 1987 1988 - May Su>=1 0 1 D R HN 1987 1988 - S lastSu 0 0 S R HN 2006 o - May Su>=1 0 1 D R HN 2006 o - Au M>=1 0 0 S -Z America/Tegucigalpa -5:48:52 - LMT 1921 Ap --6 HN C%sT -Z America/Jamaica -5:7:10 - LMT 1890 --5:7:10 - KMT 1912 F --5 - EST 1974 --5 u E%sT 1984 --5 - EST -Z America/Martinique -4:4:20 - LMT 1890 --4:4:20 - FFMT 1911 May --4 - AST 1980 Ap 6 --4 1 ADT 1980 S 28 --4 - AST R NI 1979 1980 - Mar Su>=16 0 1 D R NI 1979 1980 - Jun M>=23 0 0 S R NI 2005 o - Ap 10 0 1 D R NI 2005 o - O Su>=1 0 0 S R NI 2006 o - Ap 30 2 1 D R NI 2006 o - O Su>=1 1 0 S -Z America/Managua -5:45:8 - LMT 1890 --5:45:12 - MMT 1934 Jun 23 --6 - CST 1973 May --5 - EST 1975 F 16 --6 NI C%sT 1992 Ja 1 4 --5 - EST 1992 S 24 --6 - CST 1993 --5 - EST 1997 --6 NI C%sT -Z America/Panama -5:18:8 - LMT 1890 --5:19:36 - CMT 1908 Ap 22 --5 - EST -Z America/Puerto_Rico -4:24:25 - LMT 1899 Mar 28 12 --4 - AST 1942 May 3 --4 u A%sT 1946 --4 - AST -Z America/Miquelon -3:44:40 - LMT 1911 May 15 --4 - AST 1980 May --3 - -03 1987 --3 C -03/-02 -Z America/Grand_Turk -4:44:32 - LMT 1890 --5:7:10 - KMT 1912 F --5 - EST 1979 --5 u E%sT 2015 Mar 8 2 --4 - AST 2018 Mar 11 3 --5 u E%sT R A 1930 o - D 1 0 1 - R A 1931 o - Ap 1 0 0 - R A 1931 o - O 15 0 1 - @@ -3499,150 +1892,8 @@ R A 2000 o - Mar 3 0 0 - R A 2007 o - D 30 0 1 - R A 2008 2009 - Mar Su>=15 0 0 - R A 2008 o - O Su>=15 0 1 - -Z America/Argentina/Buenos_Aires -3:53:48 - LMT 1894 O 31 --4:16:48 - CMT 1920 May --4 - -04 1930 D --4 A -04/-03 1969 O 5 --3 A -03/-02 1999 O 3 --4 A -04/-03 2000 Mar 3 --3 A -03/-02 -Z America/Argentina/Cordoba -4:16:48 - LMT 1894 O 31 --4:16:48 - CMT 1920 May --4 - -04 1930 D --4 A -04/-03 1969 O 5 --3 A -03/-02 1991 Mar 3 --4 - -04 1991 O 20 --3 A -03/-02 1999 O 3 --4 A -04/-03 2000 Mar 3 --3 A -03/-02 -Z America/Argentina/Salta -4:21:40 - LMT 1894 O 31 --4:16:48 - CMT 1920 May --4 - -04 1930 D --4 A -04/-03 1969 O 5 --3 A -03/-02 1991 Mar 3 --4 - -04 1991 O 20 --3 A -03/-02 1999 O 3 --4 A -04/-03 2000 Mar 3 --3 A -03/-02 2008 O 18 --3 - -03 -Z America/Argentina/Tucuman -4:20:52 - LMT 1894 O 31 --4:16:48 - CMT 1920 May --4 - -04 1930 D --4 A -04/-03 1969 O 5 --3 A -03/-02 1991 Mar 3 --4 - -04 1991 O 20 --3 A -03/-02 1999 O 3 --4 A -04/-03 2000 Mar 3 --3 - -03 2004 Jun --4 - -04 2004 Jun 13 --3 A -03/-02 -Z America/Argentina/La_Rioja -4:27:24 - LMT 1894 O 31 --4:16:48 - CMT 1920 May --4 - -04 1930 D --4 A -04/-03 1969 O 5 --3 A -03/-02 1991 Mar --4 - -04 1991 May 7 --3 A -03/-02 1999 O 3 --4 A -04/-03 2000 Mar 3 --3 - -03 2004 Jun --4 - -04 2004 Jun 20 --3 A -03/-02 2008 O 18 --3 - -03 -Z America/Argentina/San_Juan -4:34:4 - LMT 1894 O 31 --4:16:48 - CMT 1920 May --4 - -04 1930 D --4 A -04/-03 1969 O 5 --3 A -03/-02 1991 Mar --4 - -04 1991 May 7 --3 A -03/-02 1999 O 3 --4 A -04/-03 2000 Mar 3 --3 - -03 2004 May 31 --4 - -04 2004 Jul 25 --3 A -03/-02 2008 O 18 --3 - -03 -Z America/Argentina/Jujuy -4:21:12 - LMT 1894 O 31 --4:16:48 - CMT 1920 May --4 - -04 1930 D --4 A -04/-03 1969 O 5 --3 A -03/-02 1990 Mar 4 --4 - -04 1990 O 28 --4 1 -03 1991 Mar 17 --4 - -04 1991 O 6 --3 1 -02 1992 --3 A -03/-02 1999 O 3 --4 A -04/-03 2000 Mar 3 --3 A -03/-02 2008 O 18 --3 - -03 -Z America/Argentina/Catamarca -4:23:8 - LMT 1894 O 31 --4:16:48 - CMT 1920 May --4 - -04 1930 D --4 A -04/-03 1969 O 5 --3 A -03/-02 1991 Mar 3 --4 - -04 1991 O 20 --3 A -03/-02 1999 O 3 --4 A -04/-03 2000 Mar 3 --3 - -03 2004 Jun --4 - -04 2004 Jun 20 --3 A -03/-02 2008 O 18 --3 - -03 -Z America/Argentina/Mendoza -4:35:16 - LMT 1894 O 31 --4:16:48 - CMT 1920 May --4 - -04 1930 D --4 A -04/-03 1969 O 5 --3 A -03/-02 1990 Mar 4 --4 - -04 1990 O 15 --4 1 -03 1991 Mar --4 - -04 1991 O 15 --4 1 -03 1992 Mar --4 - -04 1992 O 18 --3 A -03/-02 1999 O 3 --4 A -04/-03 2000 Mar 3 --3 - -03 2004 May 23 --4 - -04 2004 S 26 --3 A -03/-02 2008 O 18 --3 - -03 R Sa 2008 2009 - Mar Su>=8 0 0 - R Sa 2007 2008 - O Su>=8 0 1 - -Z America/Argentina/San_Luis -4:25:24 - LMT 1894 O 31 --4:16:48 - CMT 1920 May --4 - -04 1930 D --4 A -04/-03 1969 O 5 --3 A -03/-02 1990 --3 1 -02 1990 Mar 14 --4 - -04 1990 O 15 --4 1 -03 1991 Mar --4 - -04 1991 Jun --3 - -03 1999 O 3 --4 1 -03 2000 Mar 3 --3 - -03 2004 May 31 --4 - -04 2004 Jul 25 --3 A -03/-02 2008 Ja 21 --4 Sa -04/-03 2009 O 11 --3 - -03 -Z America/Argentina/Rio_Gallegos -4:36:52 - LMT 1894 O 31 --4:16:48 - CMT 1920 May --4 - -04 1930 D --4 A -04/-03 1969 O 5 --3 A -03/-02 1999 O 3 --4 A -04/-03 2000 Mar 3 --3 - -03 2004 Jun --4 - -04 2004 Jun 20 --3 A -03/-02 2008 O 18 --3 - -03 -Z America/Argentina/Ushuaia -4:33:12 - LMT 1894 O 31 --4:16:48 - CMT 1920 May --4 - -04 1930 D --4 A -04/-03 1969 O 5 --3 A -03/-02 1999 O 3 --4 A -04/-03 2000 Mar 3 --3 - -03 2004 May 30 --4 - -04 2004 Jun 20 --3 A -03/-02 2008 O 18 --3 - -03 -Z America/La_Paz -4:32:36 - LMT 1890 --4:32:36 - CMT 1931 O 15 --4:32:36 1 BST 1932 Mar 21 --4 - -04 R B 1931 o - O 3 11 1 - R B 1932 1933 - Ap 1 0 0 - R B 1932 o - O 3 0 1 - @@ -3700,90 +1951,6 @@ R B 2013 2014 - F Su>=15 0 0 - R B 2015 o - F Su>=22 0 0 - R B 2016 2019 - F Su>=15 0 0 - R B 2018 o - N Su>=1 0 1 - -Z America/Noronha -2:9:40 - LMT 1914 --2 B -02/-01 1990 S 17 --2 - -02 1999 S 30 --2 B -02/-01 2000 O 15 --2 - -02 2001 S 13 --2 B -02/-01 2002 O --2 - -02 -Z America/Belem -3:13:56 - LMT 1914 --3 B -03/-02 1988 S 12 --3 - -03 -Z America/Santarem -3:38:48 - LMT 1914 --4 B -04/-03 1988 S 12 --4 - -04 2008 Jun 24 --3 - -03 -Z America/Fortaleza -2:34 - LMT 1914 --3 B -03/-02 1990 S 17 --3 - -03 1999 S 30 --3 B -03/-02 2000 O 22 --3 - -03 2001 S 13 --3 B -03/-02 2002 O --3 - -03 -Z America/Recife -2:19:36 - LMT 1914 --3 B -03/-02 1990 S 17 --3 - -03 1999 S 30 --3 B -03/-02 2000 O 15 --3 - -03 2001 S 13 --3 B -03/-02 2002 O --3 - -03 -Z America/Araguaina -3:12:48 - LMT 1914 --3 B -03/-02 1990 S 17 --3 - -03 1995 S 14 --3 B -03/-02 2003 S 24 --3 - -03 2012 O 21 --3 B -03/-02 2013 S --3 - -03 -Z America/Maceio -2:22:52 - LMT 1914 --3 B -03/-02 1990 S 17 --3 - -03 1995 O 13 --3 B -03/-02 1996 S 4 --3 - -03 1999 S 30 --3 B -03/-02 2000 O 22 --3 - -03 2001 S 13 --3 B -03/-02 2002 O --3 - -03 -Z America/Bahia -2:34:4 - LMT 1914 --3 B -03/-02 2003 S 24 --3 - -03 2011 O 16 --3 B -03/-02 2012 O 21 --3 - -03 -Z America/Sao_Paulo -3:6:28 - LMT 1914 --3 B -03/-02 1963 O 23 --3 1 -02 1964 --3 B -03/-02 -Z America/Campo_Grande -3:38:28 - LMT 1914 --4 B -04/-03 -Z America/Cuiaba -3:44:20 - LMT 1914 --4 B -04/-03 2003 S 24 --4 - -04 2004 O --4 B -04/-03 -Z America/Porto_Velho -4:15:36 - LMT 1914 --4 B -04/-03 1988 S 12 --4 - -04 -Z America/Boa_Vista -4:2:40 - LMT 1914 --4 B -04/-03 1988 S 12 --4 - -04 1999 S 30 --4 B -04/-03 2000 O 15 --4 - -04 -Z America/Manaus -4:0:4 - LMT 1914 --4 B -04/-03 1988 S 12 --4 - -04 1993 S 28 --4 B -04/-03 1994 S 22 --4 - -04 -Z America/Eirunepe -4:39:28 - LMT 1914 --5 B -05/-04 1988 S 12 --5 - -05 1993 S 28 --5 B -05/-04 1994 S 22 --5 - -05 2008 Jun 24 --4 - -04 2013 N 10 --5 - -05 -Z America/Rio_Branco -4:31:12 - LMT 1914 --5 B -05/-04 1988 S 12 --5 - -05 2008 Jun 24 --4 - -04 2013 N 10 --5 - -05 R x 1927 1931 - S 1 0 1 - R x 1928 1932 - Ap 1 0 0 - R x 1968 o - N 3 4u 1 - @@ -3820,56 +1987,10 @@ R x 2019 ma - Ap Su>=2 3u 0 - R x 2019 2021 - S Su>=2 4u 1 - R x 2022 o - S Su>=9 4u 1 - R x 2023 ma - S Su>=2 4u 1 - -Z America/Santiago -4:42:45 - LMT 1890 --4:42:45 - SMT 1910 Ja 10 --5 - -05 1916 Jul --4:42:45 - SMT 1918 S 10 --4 - -04 1919 Jul --4:42:45 - SMT 1927 S --5 x -05/-04 1932 S --4 - -04 1942 Jun --5 - -05 1942 Au --4 - -04 1946 Jul 14 24 --4 1 -03 1946 Au 28 24 --5 1 -04 1947 Mar 31 24 --5 - -05 1947 May 21 23 --4 x -04/-03 -Z America/Punta_Arenas -4:43:40 - LMT 1890 --4:42:45 - SMT 1910 Ja 10 --5 - -05 1916 Jul --4:42:45 - SMT 1918 S 10 --4 - -04 1919 Jul --4:42:45 - SMT 1927 S --5 x -05/-04 1932 S --4 - -04 1942 Jun --5 - -05 1942 Au --4 - -04 1946 Au 28 24 --5 1 -04 1947 Mar 31 24 --5 - -05 1947 May 21 23 --4 x -04/-03 2016 D 4 --3 - -03 -Z Pacific/Easter -7:17:28 - LMT 1890 --7:17:28 - EMT 1932 S --7 x -07/-06 1982 Mar 14 3u --6 x -06/-05 -Z Antarctica/Palmer 0 - -00 1965 --4 A -04/-03 1969 O 5 --3 A -03/-02 1982 May --4 x -04/-03 2016 D 4 --3 - -03 R CO 1992 o - May 3 0 1 - R CO 1993 o - F 6 24 0 - -Z America/Bogota -4:56:16 - LMT 1884 Mar 13 --4:56:16 - BMT 1914 N 23 --5 CO -05/-04 R EC 1992 o - N 28 0 1 - R EC 1993 o - F 5 0 0 - -Z America/Guayaquil -5:19:20 - LMT 1890 --5:14 - QMT 1931 --5 EC -05/-04 -Z Pacific/Galapagos -5:58:24 - LMT 1931 --5 - -05 1986 --6 EC -06/-05 R FK 1937 1938 - S lastSu 0 1 - R FK 1938 1942 - Mar Su>=19 0 0 - R FK 1939 o - O 1 0 1 - @@ -3882,20 +2003,6 @@ R FK 1985 2000 - S Su>=9 0 1 - R FK 1986 2000 - Ap Su>=16 0 0 - R FK 2001 2010 - Ap Su>=15 2 0 - R FK 2001 2010 - S Su>=1 2 1 - -Z Atlantic/Stanley -3:51:24 - LMT 1890 --3:51:24 - SMT 1912 Mar 12 --4 FK -04/-03 1983 May --3 FK -03/-02 1985 S 15 --4 FK -04/-03 2010 S 5 2 --3 - -03 -Z America/Cayenne -3:29:20 - LMT 1911 Jul --4 - -04 1967 O --3 - -03 -Z America/Guyana -3:52:39 - LMT 1911 Au --4 - -04 1915 Mar --3:45 - -0345 1975 Au --3 - -03 1992 Mar 29 1 --4 - -04 R y 1975 1988 - O 1 0 1 - R y 1975 1978 - Mar 1 0 0 - R y 1979 1991 - Ap 1 0 0 - @@ -3918,11 +2025,6 @@ R y 2005 2009 - Mar Su>=8 0 0 - R y 2010 ma - O Su>=1 0 1 - R y 2010 2012 - Ap Su>=8 0 0 - R y 2013 ma - Mar Su>=22 0 0 - -Z America/Asuncion -3:50:40 - LMT 1890 --3:50:40 - AMT 1931 O 10 --4 - -04 1972 O --3 - -03 1974 Ap --4 y -04/-03 R PE 1938 o - Ja 1 0 1 - R PE 1938 o - Ap 1 0 0 - R PE 1938 1939 - S lastSu 0 1 - @@ -3933,16 +2035,6 @@ R PE 1990 o - Ja 1 0 1 - R PE 1990 o - Ap 1 0 0 - R PE 1994 o - Ja 1 0 1 - R PE 1994 o - Ap 1 0 0 - -Z America/Lima -5:8:12 - LMT 1890 --5:8:36 - LMT 1908 Jul 28 --5 PE -05/-04 -Z Atlantic/South_Georgia -2:26:8 - LMT 1890 --2 - -02 -Z America/Paramaribo -3:40:40 - LMT 1911 --3:40:52 - PMT 1935 --3:40:36 - PMT 1945 O --3:30 - -0330 1984 O --3 - -03 R U 1923 1925 - O 1 0 0:30 - R U 1924 1926 - Ap 1 0 0 - R U 1933 1938 - O lastSu 0 0:30 - @@ -3991,6 +2083,659 @@ R U 2005 o - Mar 27 2 0 - R U 2005 o - O 9 2 1 - R U 2006 2015 - Mar Su>=8 2 0 - R U 2006 2014 - O Su>=1 2 1 - +Z Africa/Abidjan -0:16:8 - LMT 1912 +0 - GMT +Z Africa/Algiers 0:12:12 - LMT 1891 Mar 16 +0:9:21 - PMT 1911 Mar 11 +0 d WE%sT 1940 F 25 2 +1 d CE%sT 1946 O 7 +0 - WET 1956 Ja 29 +1 - CET 1963 Ap 14 +0 d WE%sT 1977 O 21 +1 d CE%sT 1979 O 26 +0 d WE%sT 1981 May +1 - CET +Z Africa/Bissau -1:2:20 - LMT 1912 Ja 1 1u +-1 - -01 1975 +0 - GMT +Z Africa/Cairo 2:5:9 - LMT 1900 O +2 K EE%sT +Z Africa/Casablanca -0:30:20 - LMT 1913 O 26 +0 M +00/+01 1984 Mar 16 +1 - +01 1986 +0 M +00/+01 2018 O 28 3 +1 M +01/+00 +Z Africa/Ceuta -0:21:16 - LMT 1901 Ja 1 0u +0 - WET 1918 May 6 23 +0 1 WEST 1918 O 7 23 +0 - WET 1924 +0 s WE%sT 1929 +0 - WET 1967 +0 Sp WE%sT 1984 Mar 16 +1 - CET 1986 +1 E CE%sT +Z Africa/El_Aaiun -0:52:48 - LMT 1934 +-1 - -01 1976 Ap 14 +0 M +00/+01 2018 O 28 3 +1 M +01/+00 +Z Africa/Johannesburg 1:52 - LMT 1892 F 8 +1:30 - SAST 1903 Mar +2 SA SAST +Z Africa/Juba 2:6:28 - LMT 1931 +2 SD CA%sT 2000 Ja 15 12 +3 - EAT 2021 F +2 - CAT +Z Africa/Khartoum 2:10:8 - LMT 1931 +2 SD CA%sT 2000 Ja 15 12 +3 - EAT 2017 N +2 - CAT +Z Africa/Lagos 0:13:35 - LMT 1905 Jul +0 - GMT 1908 Jul +0:13:35 - LMT 1914 +0:30 - +0030 1919 S +1 - WAT +Z Africa/Maputo 2:10:20 - LMT 1903 Mar +2 - CAT +Z Africa/Monrovia -0:43:8 - LMT 1882 +-0:43:8 - MMT 1919 Mar +-0:44:30 - MMT 1972 Ja 7 +0 - GMT +Z Africa/Nairobi 2:27:16 - LMT 1908 May +2:30 - +0230 1928 Jun 30 24 +3 - EAT 1930 Ja 4 24 +2:30 - +0230 1936 D 31 24 +2:45 - +0245 1942 Jul 31 24 +3 - EAT +Z Africa/Ndjamena 1:0:12 - LMT 1912 +1 - WAT 1979 O 14 +1 1 WAST 1980 Mar 8 +1 - WAT +Z Africa/Sao_Tome 0:26:56 - LMT 1884 +-0:36:45 - LMT 1912 Ja 1 0u +0 - GMT 2018 Ja 1 1 +1 - WAT 2019 Ja 1 2 +0 - GMT +Z Africa/Tripoli 0:52:44 - LMT 1920 +1 L CE%sT 1959 +2 - EET 1982 +1 L CE%sT 1990 May 4 +2 - EET 1996 S 30 +1 L CE%sT 1997 O 4 +2 - EET 2012 N 10 2 +1 L CE%sT 2013 O 25 2 +2 - EET +Z Africa/Tunis 0:40:44 - LMT 1881 May 12 +0:9:21 - PMT 1911 Mar 11 +1 n CE%sT +Z Africa/Windhoek 1:8:24 - LMT 1892 F 8 +1:30 - +0130 1903 Mar +2 - SAST 1942 S 20 2 +2 1 SAST 1943 Mar 21 2 +2 - SAST 1990 Mar 21 +2 NA %s +Z America/Adak 12:13:22 - LMT 1867 O 19 12:44:35 +-11:46:38 - LMT 1900 Au 20 12 +-11 - NST 1942 +-11 u N%sT 1946 +-11 - NST 1967 Ap +-11 - BST 1969 +-11 u B%sT 1983 O 30 2 +-10 u AH%sT 1983 N 30 +-10 u H%sT +Z America/Anchorage 14:0:24 - LMT 1867 O 19 14:31:37 +-9:59:36 - LMT 1900 Au 20 12 +-10 - AST 1942 +-10 u A%sT 1967 Ap +-10 - AHST 1969 +-10 u AH%sT 1983 O 30 2 +-9 u Y%sT 1983 N 30 +-9 u AK%sT +Z America/Araguaina -3:12:48 - LMT 1914 +-3 B -03/-02 1990 S 17 +-3 - -03 1995 S 14 +-3 B -03/-02 2003 S 24 +-3 - -03 2012 O 21 +-3 B -03/-02 2013 S +-3 - -03 +Z America/Argentina/Buenos_Aires -3:53:48 - LMT 1894 O 31 +-4:16:48 - CMT 1920 May +-4 - -04 1930 D +-4 A -04/-03 1969 O 5 +-3 A -03/-02 1999 O 3 +-4 A -04/-03 2000 Mar 3 +-3 A -03/-02 +Z America/Argentina/Catamarca -4:23:8 - LMT 1894 O 31 +-4:16:48 - CMT 1920 May +-4 - -04 1930 D +-4 A -04/-03 1969 O 5 +-3 A -03/-02 1991 Mar 3 +-4 - -04 1991 O 20 +-3 A -03/-02 1999 O 3 +-4 A -04/-03 2000 Mar 3 +-3 - -03 2004 Jun +-4 - -04 2004 Jun 20 +-3 A -03/-02 2008 O 18 +-3 - -03 +Z America/Argentina/Cordoba -4:16:48 - LMT 1894 O 31 +-4:16:48 - CMT 1920 May +-4 - -04 1930 D +-4 A -04/-03 1969 O 5 +-3 A -03/-02 1991 Mar 3 +-4 - -04 1991 O 20 +-3 A -03/-02 1999 O 3 +-4 A -04/-03 2000 Mar 3 +-3 A -03/-02 +Z America/Argentina/Jujuy -4:21:12 - LMT 1894 O 31 +-4:16:48 - CMT 1920 May +-4 - -04 1930 D +-4 A -04/-03 1969 O 5 +-3 A -03/-02 1990 Mar 4 +-4 - -04 1990 O 28 +-4 1 -03 1991 Mar 17 +-4 - -04 1991 O 6 +-3 1 -02 1992 +-3 A -03/-02 1999 O 3 +-4 A -04/-03 2000 Mar 3 +-3 A -03/-02 2008 O 18 +-3 - -03 +Z America/Argentina/La_Rioja -4:27:24 - LMT 1894 O 31 +-4:16:48 - CMT 1920 May +-4 - -04 1930 D +-4 A -04/-03 1969 O 5 +-3 A -03/-02 1991 Mar +-4 - -04 1991 May 7 +-3 A -03/-02 1999 O 3 +-4 A -04/-03 2000 Mar 3 +-3 - -03 2004 Jun +-4 - -04 2004 Jun 20 +-3 A -03/-02 2008 O 18 +-3 - -03 +Z America/Argentina/Mendoza -4:35:16 - LMT 1894 O 31 +-4:16:48 - CMT 1920 May +-4 - -04 1930 D +-4 A -04/-03 1969 O 5 +-3 A -03/-02 1990 Mar 4 +-4 - -04 1990 O 15 +-4 1 -03 1991 Mar +-4 - -04 1991 O 15 +-4 1 -03 1992 Mar +-4 - -04 1992 O 18 +-3 A -03/-02 1999 O 3 +-4 A -04/-03 2000 Mar 3 +-3 - -03 2004 May 23 +-4 - -04 2004 S 26 +-3 A -03/-02 2008 O 18 +-3 - -03 +Z America/Argentina/Rio_Gallegos -4:36:52 - LMT 1894 O 31 +-4:16:48 - CMT 1920 May +-4 - -04 1930 D +-4 A -04/-03 1969 O 5 +-3 A -03/-02 1999 O 3 +-4 A -04/-03 2000 Mar 3 +-3 - -03 2004 Jun +-4 - -04 2004 Jun 20 +-3 A -03/-02 2008 O 18 +-3 - -03 +Z America/Argentina/Salta -4:21:40 - LMT 1894 O 31 +-4:16:48 - CMT 1920 May +-4 - -04 1930 D +-4 A -04/-03 1969 O 5 +-3 A -03/-02 1991 Mar 3 +-4 - -04 1991 O 20 +-3 A -03/-02 1999 O 3 +-4 A -04/-03 2000 Mar 3 +-3 A -03/-02 2008 O 18 +-3 - -03 +Z America/Argentina/San_Juan -4:34:4 - LMT 1894 O 31 +-4:16:48 - CMT 1920 May +-4 - -04 1930 D +-4 A -04/-03 1969 O 5 +-3 A -03/-02 1991 Mar +-4 - -04 1991 May 7 +-3 A -03/-02 1999 O 3 +-4 A -04/-03 2000 Mar 3 +-3 - -03 2004 May 31 +-4 - -04 2004 Jul 25 +-3 A -03/-02 2008 O 18 +-3 - -03 +Z America/Argentina/San_Luis -4:25:24 - LMT 1894 O 31 +-4:16:48 - CMT 1920 May +-4 - -04 1930 D +-4 A -04/-03 1969 O 5 +-3 A -03/-02 1990 +-3 1 -02 1990 Mar 14 +-4 - -04 1990 O 15 +-4 1 -03 1991 Mar +-4 - -04 1991 Jun +-3 - -03 1999 O 3 +-4 1 -03 2000 Mar 3 +-3 - -03 2004 May 31 +-4 - -04 2004 Jul 25 +-3 A -03/-02 2008 Ja 21 +-4 Sa -04/-03 2009 O 11 +-3 - -03 +Z America/Argentina/Tucuman -4:20:52 - LMT 1894 O 31 +-4:16:48 - CMT 1920 May +-4 - -04 1930 D +-4 A -04/-03 1969 O 5 +-3 A -03/-02 1991 Mar 3 +-4 - -04 1991 O 20 +-3 A -03/-02 1999 O 3 +-4 A -04/-03 2000 Mar 3 +-3 - -03 2004 Jun +-4 - -04 2004 Jun 13 +-3 A -03/-02 +Z America/Argentina/Ushuaia -4:33:12 - LMT 1894 O 31 +-4:16:48 - CMT 1920 May +-4 - -04 1930 D +-4 A -04/-03 1969 O 5 +-3 A -03/-02 1999 O 3 +-4 A -04/-03 2000 Mar 3 +-3 - -03 2004 May 30 +-4 - -04 2004 Jun 20 +-3 A -03/-02 2008 O 18 +-3 - -03 +Z America/Asuncion -3:50:40 - LMT 1890 +-3:50:40 - AMT 1931 O 10 +-4 - -04 1972 O +-3 - -03 1974 Ap +-4 y -04/-03 +Z America/Bahia -2:34:4 - LMT 1914 +-3 B -03/-02 2003 S 24 +-3 - -03 2011 O 16 +-3 B -03/-02 2012 O 21 +-3 - -03 +Z America/Bahia_Banderas -7:1 - LMT 1922 Ja 1 7u +-7 - MST 1927 Jun 10 23 +-6 - CST 1930 N 15 +-7 m M%sT 1932 Ap +-6 - CST 1942 Ap 24 +-7 - MST 1949 Ja 14 +-8 - PST 1970 +-7 m M%sT 2010 Ap 4 2 +-6 m C%sT +Z America/Barbados -3:58:29 - LMT 1911 Au 28 +-4 BB A%sT 1944 +-4 BB AST/-0330 1945 +-4 BB A%sT +Z America/Belem -3:13:56 - LMT 1914 +-3 B -03/-02 1988 S 12 +-3 - -03 +Z America/Belize -5:52:48 - LMT 1912 Ap +-6 BZ %s +Z America/Boa_Vista -4:2:40 - LMT 1914 +-4 B -04/-03 1988 S 12 +-4 - -04 1999 S 30 +-4 B -04/-03 2000 O 15 +-4 - -04 +Z America/Bogota -4:56:16 - LMT 1884 Mar 13 +-4:56:16 - BMT 1914 N 23 +-5 CO -05/-04 +Z America/Boise -7:44:49 - LMT 1883 N 18 20u +-8 u P%sT 1923 May 13 2 +-7 u M%sT 1974 +-7 - MST 1974 F 3 2 +-7 u M%sT +Z America/Cambridge_Bay 0 - -00 1920 +-7 Y M%sT 1999 O 31 2 +-6 C C%sT 2000 O 29 2 +-5 - EST 2000 N 5 +-6 - CST 2001 Ap 1 3 +-7 C M%sT +Z America/Campo_Grande -3:38:28 - LMT 1914 +-4 B -04/-03 +Z America/Cancun -5:47:4 - LMT 1922 Ja 1 6u +-6 - CST 1981 D 23 +-5 m E%sT 1998 Au 2 2 +-6 m C%sT 2015 F 1 2 +-5 - EST +Z America/Caracas -4:27:44 - LMT 1890 +-4:27:40 - CMT 1912 F 12 +-4:30 - -0430 1965 +-4 - -04 2007 D 9 3 +-4:30 - -0430 2016 May 1 2:30 +-4 - -04 +Z America/Cayenne -3:29:20 - LMT 1911 Jul +-4 - -04 1967 O +-3 - -03 +Z America/Chicago -5:50:36 - LMT 1883 N 18 18u +-6 u C%sT 1920 +-6 Ch C%sT 1936 Mar 1 2 +-5 - EST 1936 N 15 2 +-6 Ch C%sT 1942 +-6 u C%sT 1946 +-6 Ch C%sT 1967 +-6 u C%sT +Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u +-7 - MST 1927 Jun 10 23 +-6 - CST 1930 N 15 +-7 m M%sT 1932 Ap +-6 - CST 1996 +-6 m C%sT 1998 +-6 - CST 1998 Ap Su>=1 3 +-7 m M%sT 2022 O 30 2 +-6 - CST +Z America/Ciudad_Juarez -7:5:56 - LMT 1922 Ja 1 7u +-7 - MST 1927 Jun 10 23 +-6 - CST 1930 N 15 +-7 m M%sT 1932 Ap +-6 - CST 1996 +-6 m C%sT 1998 +-6 - CST 1998 Ap Su>=1 3 +-7 m M%sT 2010 +-7 u M%sT 2022 O 30 2 +-6 - CST 2022 N 30 +-7 u M%sT +Z America/Costa_Rica -5:36:13 - LMT 1890 +-5:36:13 - SJMT 1921 Ja 15 +-6 CR C%sT +Z America/Cuiaba -3:44:20 - LMT 1914 +-4 B -04/-03 2003 S 24 +-4 - -04 2004 O +-4 B -04/-03 +Z America/Danmarkshavn -1:14:40 - LMT 1916 Jul 28 +-3 - -03 1980 Ap 6 2 +-3 E -03/-02 1996 +0 - GMT +Z America/Dawson -9:17:40 - LMT 1900 Au 20 +-9 Y Y%sT 1965 +-9 Yu Y%sT 1973 O 28 +-8 - PST 1980 +-8 C P%sT 2020 N +-7 - MST +Z America/Dawson_Creek -8:0:56 - LMT 1884 +-8 C P%sT 1947 +-8 Va P%sT 1972 Au 30 2 +-7 - MST +Z America/Denver -6:59:56 - LMT 1883 N 18 19u +-7 u M%sT 1920 +-7 De M%sT 1942 +-7 u M%sT 1946 +-7 De M%sT 1967 +-7 u M%sT +Z America/Detroit -5:32:11 - LMT 1905 +-6 - CST 1915 May 15 2 +-5 - EST 1942 +-5 u E%sT 1946 +-5 Dt E%sT 1967 Jun 14 0:1 +-5 u E%sT 1969 +-5 - EST 1973 +-5 u E%sT 1975 +-5 - EST 1975 Ap 27 2 +-5 u E%sT +Z America/Edmonton -7:33:52 - LMT 1906 S +-7 Ed M%sT 1987 +-7 C M%sT +Z America/Eirunepe -4:39:28 - LMT 1914 +-5 B -05/-04 1988 S 12 +-5 - -05 1993 S 28 +-5 B -05/-04 1994 S 22 +-5 - -05 2008 Jun 24 +-4 - -04 2013 N 10 +-5 - -05 +Z America/El_Salvador -5:56:48 - LMT 1921 +-6 SV C%sT +Z America/Fort_Nelson -8:10:47 - LMT 1884 +-8 Va P%sT 1946 +-8 - PST 1947 +-8 Va P%sT 1987 +-8 C P%sT 2015 Mar 8 2 +-7 - MST +Z America/Fortaleza -2:34 - LMT 1914 +-3 B -03/-02 1990 S 17 +-3 - -03 1999 S 30 +-3 B -03/-02 2000 O 22 +-3 - -03 2001 S 13 +-3 B -03/-02 2002 O +-3 - -03 +Z America/Glace_Bay -3:59:48 - LMT 1902 Jun 15 +-4 C A%sT 1953 +-4 H A%sT 1954 +-4 - AST 1972 +-4 H A%sT 1974 +-4 C A%sT +Z America/Goose_Bay -4:1:40 - LMT 1884 +-3:30:52 - NST 1918 +-3:30:52 C N%sT 1919 +-3:30:52 - NST 1935 Mar 30 +-3:30 - NST 1936 +-3:30 j N%sT 1942 May 11 +-3:30 C N%sT 1946 +-3:30 j N%sT 1966 Mar 15 2 +-4 j A%sT 2011 N +-4 C A%sT +Z America/Grand_Turk -4:44:32 - LMT 1890 +-5:7:10 - KMT 1912 F +-5 - EST 1979 +-5 u E%sT 2015 Mar 8 2 +-4 - AST 2018 Mar 11 3 +-5 u E%sT +Z America/Guatemala -6:2:4 - LMT 1918 O 5 +-6 GT C%sT +Z America/Guayaquil -5:19:20 - LMT 1890 +-5:14 - QMT 1931 +-5 EC -05/-04 +Z America/Guyana -3:52:39 - LMT 1911 Au +-4 - -04 1915 Mar +-3:45 - -0345 1975 Au +-3 - -03 1992 Mar 29 1 +-4 - -04 +Z America/Halifax -4:14:24 - LMT 1902 Jun 15 +-4 H A%sT 1918 +-4 C A%sT 1919 +-4 H A%sT 1942 F 9 2s +-4 C A%sT 1946 +-4 H A%sT 1974 +-4 C A%sT +Z America/Havana -5:29:28 - LMT 1890 +-5:29:36 - HMT 1925 Jul 19 12 +-5 Q C%sT +Z America/Hermosillo -7:23:52 - LMT 1922 Ja 1 7u +-7 - MST 1927 Jun 10 23 +-6 - CST 1930 N 15 +-7 m M%sT 1932 Ap +-6 - CST 1942 Ap 24 +-7 - MST 1949 Ja 14 +-8 - PST 1970 +-7 m M%sT 1999 +-7 - MST +Z America/Indiana/Indianapolis -5:44:38 - LMT 1883 N 18 18u +-6 u C%sT 1920 +-6 In C%sT 1942 +-6 u C%sT 1946 +-6 In C%sT 1955 Ap 24 2 +-5 - EST 1957 S 29 2 +-6 - CST 1958 Ap 27 2 +-5 - EST 1969 +-5 u E%sT 1971 +-5 - EST 2006 +-5 u E%sT +Z America/Indiana/Knox -5:46:30 - LMT 1883 N 18 18u +-6 u C%sT 1947 +-6 St C%sT 1962 Ap 29 2 +-5 - EST 1963 O 27 2 +-6 u C%sT 1991 O 27 2 +-5 - EST 2006 Ap 2 2 +-6 u C%sT +Z America/Indiana/Marengo -5:45:23 - LMT 1883 N 18 18u +-6 u C%sT 1951 +-6 Ma C%sT 1961 Ap 30 2 +-5 - EST 1969 +-5 u E%sT 1974 Ja 6 2 +-6 1 CDT 1974 O 27 2 +-5 u E%sT 1976 +-5 - EST 2006 +-5 u E%sT +Z America/Indiana/Petersburg -5:49:7 - LMT 1883 N 18 18u +-6 u C%sT 1955 +-6 Pi C%sT 1965 Ap 25 2 +-5 - EST 1966 O 30 2 +-6 u C%sT 1977 O 30 2 +-5 - EST 2006 Ap 2 2 +-6 u C%sT 2007 N 4 2 +-5 u E%sT +Z America/Indiana/Tell_City -5:47:3 - LMT 1883 N 18 18u +-6 u C%sT 1946 +-6 Pe C%sT 1964 Ap 26 2 +-5 - EST 1967 O 29 2 +-6 u C%sT 1969 Ap 27 2 +-5 u E%sT 1971 +-5 - EST 2006 Ap 2 2 +-6 u C%sT +Z America/Indiana/Vevay -5:40:16 - LMT 1883 N 18 18u +-6 u C%sT 1954 Ap 25 2 +-5 - EST 1969 +-5 u E%sT 1973 +-5 - EST 2006 +-5 u E%sT +Z America/Indiana/Vincennes -5:50:7 - LMT 1883 N 18 18u +-6 u C%sT 1946 +-6 V C%sT 1964 Ap 26 2 +-5 - EST 1969 +-5 u E%sT 1971 +-5 - EST 2006 Ap 2 2 +-6 u C%sT 2007 N 4 2 +-5 u E%sT +Z America/Indiana/Winamac -5:46:25 - LMT 1883 N 18 18u +-6 u C%sT 1946 +-6 Pu C%sT 1961 Ap 30 2 +-5 - EST 1969 +-5 u E%sT 1971 +-5 - EST 2006 Ap 2 2 +-6 u C%sT 2007 Mar 11 2 +-5 u E%sT +Z America/Inuvik 0 - -00 1953 +-8 Y P%sT 1979 Ap lastSu 2 +-7 Y M%sT 1980 +-7 C M%sT +Z America/Iqaluit 0 - -00 1942 Au +-5 Y E%sT 1999 O 31 2 +-6 C C%sT 2000 O 29 2 +-5 C E%sT +Z America/Jamaica -5:7:10 - LMT 1890 +-5:7:10 - KMT 1912 F +-5 - EST 1974 +-5 u E%sT 1984 +-5 - EST +Z America/Juneau 15:2:19 - LMT 1867 O 19 15:33:32 +-8:57:41 - LMT 1900 Au 20 12 +-8 - PST 1942 +-8 u P%sT 1946 +-8 - PST 1969 +-8 u P%sT 1980 Ap 27 2 +-9 u Y%sT 1980 O 26 2 +-8 u P%sT 1983 O 30 2 +-9 u Y%sT 1983 N 30 +-9 u AK%sT +Z America/Kentucky/Louisville -5:43:2 - LMT 1883 N 18 18u +-6 u C%sT 1921 +-6 v C%sT 1942 +-6 u C%sT 1946 +-6 v C%sT 1961 Jul 23 2 +-5 - EST 1968 +-5 u E%sT 1974 Ja 6 2 +-6 1 CDT 1974 O 27 2 +-5 u E%sT +Z America/Kentucky/Monticello -5:39:24 - LMT 1883 N 18 18u +-6 u C%sT 1946 +-6 - CST 1968 +-6 u C%sT 2000 O 29 2 +-5 u E%sT +Z America/La_Paz -4:32:36 - LMT 1890 +-4:32:36 - CMT 1931 O 15 +-4:32:36 1 BST 1932 Mar 21 +-4 - -04 +Z America/Lima -5:8:12 - LMT 1890 +-5:8:36 - LMT 1908 Jul 28 +-5 PE -05/-04 +Z America/Los_Angeles -7:52:58 - LMT 1883 N 18 20u +-8 u P%sT 1946 +-8 CA P%sT 1967 +-8 u P%sT +Z America/Maceio -2:22:52 - LMT 1914 +-3 B -03/-02 1990 S 17 +-3 - -03 1995 O 13 +-3 B -03/-02 1996 S 4 +-3 - -03 1999 S 30 +-3 B -03/-02 2000 O 22 +-3 - -03 2001 S 13 +-3 B -03/-02 2002 O +-3 - -03 +Z America/Managua -5:45:8 - LMT 1890 +-5:45:12 - MMT 1934 Jun 23 +-6 - CST 1973 May +-5 - EST 1975 F 16 +-6 NI C%sT 1992 Ja 1 4 +-5 - EST 1992 S 24 +-6 - CST 1993 +-5 - EST 1997 +-6 NI C%sT +Z America/Manaus -4:0:4 - LMT 1914 +-4 B -04/-03 1988 S 12 +-4 - -04 1993 S 28 +-4 B -04/-03 1994 S 22 +-4 - -04 +Z America/Martinique -4:4:20 - LMT 1890 +-4:4:20 - FFMT 1911 May +-4 - AST 1980 Ap 6 +-4 1 ADT 1980 S 28 +-4 - AST +Z America/Matamoros -6:30 - LMT 1922 Ja 1 6u +-6 - CST 1988 +-6 u C%sT 1989 +-6 m C%sT 2010 +-6 u C%sT +Z America/Mazatlan -7:5:40 - LMT 1922 Ja 1 7u +-7 - MST 1927 Jun 10 23 +-6 - CST 1930 N 15 +-7 m M%sT 1932 Ap +-6 - CST 1942 Ap 24 +-7 - MST 1949 Ja 14 +-8 - PST 1970 +-7 m M%sT +Z America/Menominee -5:50:27 - LMT 1885 S 18 12 +-6 u C%sT 1946 +-6 Me C%sT 1969 Ap 27 2 +-5 - EST 1973 Ap 29 2 +-6 u C%sT +Z America/Merida -5:58:28 - LMT 1922 Ja 1 6u +-6 - CST 1981 D 23 +-5 - EST 1982 D 2 +-6 m C%sT +Z America/Metlakatla 15:13:42 - LMT 1867 O 19 15:44:55 +-8:46:18 - LMT 1900 Au 20 12 +-8 - PST 1942 +-8 u P%sT 1946 +-8 - PST 1969 +-8 u P%sT 1983 O 30 2 +-8 - PST 2015 N 1 2 +-9 u AK%sT 2018 N 4 2 +-8 - PST 2019 Ja 20 2 +-9 u AK%sT +Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u +-7 - MST 1927 Jun 10 23 +-6 - CST 1930 N 15 +-7 m M%sT 1932 Ap +-6 m C%sT 2001 S 30 2 +-6 - CST 2002 F 20 +-6 m C%sT +Z America/Miquelon -3:44:40 - LMT 1911 Jun 15 +-4 - AST 1980 May +-3 - -03 1987 +-3 C -03/-02 +Z America/Moncton -4:19:8 - LMT 1883 D 9 +-5 - EST 1902 Jun 15 +-4 C A%sT 1933 +-4 o A%sT 1942 +-4 C A%sT 1946 +-4 o A%sT 1973 +-4 C A%sT 1993 +-4 o A%sT 2007 +-4 C A%sT +Z America/Monterrey -6:41:16 - LMT 1922 Ja 1 6u +-6 - CST 1988 +-6 u C%sT 1989 +-6 m C%sT Z America/Montevideo -3:44:51 - LMT 1908 Jun 10 -3:44:51 - MMT 1920 May -4 - -04 1923 O @@ -4002,30 +2747,842 @@ Z America/Montevideo -3:44:51 - LMT 1908 Jun 10 -3 U -03/-0130 1974 Mar 10 -3 U -03/-0230 1974 D 22 -3 U -03/-02 -Z America/Caracas -4:27:44 - LMT 1890 --4:27:40 - CMT 1912 F 12 --4:30 - -0430 1965 --4 - -04 2007 D 9 3 --4:30 - -0430 2016 May 1 2:30 +Z America/New_York -4:56:2 - LMT 1883 N 18 17u +-5 u E%sT 1920 +-5 NY E%sT 1942 +-5 u E%sT 1946 +-5 NY E%sT 1967 +-5 u E%sT +Z America/Nome 12:58:22 - LMT 1867 O 19 13:29:35 +-11:1:38 - LMT 1900 Au 20 12 +-11 - NST 1942 +-11 u N%sT 1946 +-11 - NST 1967 Ap +-11 - BST 1969 +-11 u B%sT 1983 O 30 2 +-9 u Y%sT 1983 N 30 +-9 u AK%sT +Z America/Noronha -2:9:40 - LMT 1914 +-2 B -02/-01 1990 S 17 +-2 - -02 1999 S 30 +-2 B -02/-01 2000 O 15 +-2 - -02 2001 S 13 +-2 B -02/-01 2002 O +-2 - -02 +Z America/North_Dakota/Beulah -6:47:7 - LMT 1883 N 18 19u +-7 u M%sT 2010 N 7 2 +-6 u C%sT +Z America/North_Dakota/Center -6:45:12 - LMT 1883 N 18 19u +-7 u M%sT 1992 O 25 2 +-6 u C%sT +Z America/North_Dakota/New_Salem -6:45:39 - LMT 1883 N 18 19u +-7 u M%sT 2003 O 26 2 +-6 u C%sT +Z America/Nuuk -3:26:56 - LMT 1916 Jul 28 +-3 - -03 1980 Ap 6 2 +-3 E -03/-02 2023 Mar 26 1u +-2 - -02 2023 O 29 1u +-2 E -02/-01 +Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u +-7 - MST 1927 Jun 10 23 +-6 - CST 1930 N 15 +-7 m M%sT 1932 Ap +-6 - CST 1996 +-6 m C%sT 1998 +-6 - CST 1998 Ap Su>=1 3 +-7 m M%sT 2010 +-7 u M%sT 2022 O 30 2 +-6 - CST 2022 N 30 +-6 u C%sT +Z America/Panama -5:18:8 - LMT 1890 +-5:19:36 - CMT 1908 Ap 22 +-5 - EST +Z America/Paramaribo -3:40:40 - LMT 1911 +-3:40:52 - PMT 1935 +-3:40:36 - PMT 1945 O +-3:30 - -0330 1984 O +-3 - -03 +Z America/Phoenix -7:28:18 - LMT 1883 N 18 19u +-7 u M%sT 1944 Ja 1 0:1 +-7 - MST 1944 Ap 1 0:1 +-7 u M%sT 1944 O 1 0:1 +-7 - MST 1967 +-7 u M%sT 1968 Mar 21 +-7 - MST +Z America/Port-au-Prince -4:49:20 - LMT 1890 +-4:49 - PPMT 1917 Ja 24 12 +-5 HT E%sT +Z America/Porto_Velho -4:15:36 - LMT 1914 +-4 B -04/-03 1988 S 12 -4 - -04 -Z Etc/UTC 0 - UTC +Z America/Puerto_Rico -4:24:25 - LMT 1899 Mar 28 12 +-4 - AST 1942 May 3 +-4 u A%sT 1946 +-4 - AST +Z America/Punta_Arenas -4:43:40 - LMT 1890 +-4:42:45 - SMT 1910 Ja 10 +-5 - -05 1916 Jul +-4:42:45 - SMT 1918 S 10 +-4 - -04 1919 Jul +-4:42:45 - SMT 1927 S +-5 x -05/-04 1932 S +-4 - -04 1942 Jun +-5 - -05 1942 Au +-4 - -04 1946 Au 28 24 +-5 1 -04 1947 Mar 31 24 +-5 - -05 1947 May 21 23 +-4 x -04/-03 2016 D 4 +-3 - -03 +Z America/Rankin_Inlet 0 - -00 1957 +-6 Y C%sT 2000 O 29 2 +-5 - EST 2001 Ap 1 3 +-6 C C%sT +Z America/Recife -2:19:36 - LMT 1914 +-3 B -03/-02 1990 S 17 +-3 - -03 1999 S 30 +-3 B -03/-02 2000 O 15 +-3 - -03 2001 S 13 +-3 B -03/-02 2002 O +-3 - -03 +Z America/Regina -6:58:36 - LMT 1905 S +-7 r M%sT 1960 Ap lastSu 2 +-6 - CST +Z America/Resolute 0 - -00 1947 Au 31 +-6 Y C%sT 2000 O 29 2 +-5 - EST 2001 Ap 1 3 +-6 C C%sT 2006 O 29 2 +-5 - EST 2007 Mar 11 3 +-6 C C%sT +Z America/Rio_Branco -4:31:12 - LMT 1914 +-5 B -05/-04 1988 S 12 +-5 - -05 2008 Jun 24 +-4 - -04 2013 N 10 +-5 - -05 +Z America/Santarem -3:38:48 - LMT 1914 +-4 B -04/-03 1988 S 12 +-4 - -04 2008 Jun 24 +-3 - -03 +Z America/Santiago -4:42:45 - LMT 1890 +-4:42:45 - SMT 1910 Ja 10 +-5 - -05 1916 Jul +-4:42:45 - SMT 1918 S 10 +-4 - -04 1919 Jul +-4:42:45 - SMT 1927 S +-5 x -05/-04 1932 S +-4 - -04 1942 Jun +-5 - -05 1942 Au +-4 - -04 1946 Jul 14 24 +-4 1 -03 1946 Au 28 24 +-5 1 -04 1947 Mar 31 24 +-5 - -05 1947 May 21 23 +-4 x -04/-03 +Z America/Santo_Domingo -4:39:36 - LMT 1890 +-4:40 - SDMT 1933 Ap 1 12 +-5 DO %s 1974 O 27 +-4 - AST 2000 O 29 2 +-5 u E%sT 2000 D 3 1 +-4 - AST +Z America/Sao_Paulo -3:6:28 - LMT 1914 +-3 B -03/-02 1963 O 23 +-3 1 -02 1964 +-3 B -03/-02 +Z America/Scoresbysund -1:27:52 - LMT 1916 Jul 28 +-2 - -02 1980 Ap 6 2 +-2 c -02/-01 1981 Mar 29 +-1 E -01/+00 2024 Mar 31 +-2 E -02/-01 +Z America/Sitka 14:58:47 - LMT 1867 O 19 15:30 +-9:1:13 - LMT 1900 Au 20 12 +-8 - PST 1942 +-8 u P%sT 1946 +-8 - PST 1969 +-8 u P%sT 1983 O 30 2 +-9 u Y%sT 1983 N 30 +-9 u AK%sT +Z America/St_Johns -3:30:52 - LMT 1884 +-3:30:52 j N%sT 1918 +-3:30:52 C N%sT 1919 +-3:30:52 j N%sT 1935 Mar 30 +-3:30 j N%sT 1942 May 11 +-3:30 C N%sT 1946 +-3:30 j N%sT 2011 N +-3:30 C N%sT +Z America/Swift_Current -7:11:20 - LMT 1905 S +-7 C M%sT 1946 Ap lastSu 2 +-7 r M%sT 1950 +-7 Sw M%sT 1972 Ap lastSu 2 +-6 - CST +Z America/Tegucigalpa -5:48:52 - LMT 1921 Ap +-6 HN C%sT +Z America/Thule -4:35:8 - LMT 1916 Jul 28 +-4 Th A%sT +Z America/Tijuana -7:48:4 - LMT 1922 Ja 1 7u +-7 - MST 1924 +-8 - PST 1927 Jun 10 23 +-7 - MST 1930 N 15 +-8 - PST 1931 Ap +-8 1 PDT 1931 S 30 +-8 - PST 1942 Ap 24 +-8 1 PWT 1945 Au 14 23u +-8 1 PPT 1945 N 12 +-8 - PST 1948 Ap 5 +-8 1 PDT 1949 Ja 14 +-8 - PST 1954 +-8 CA P%sT 1961 +-8 - PST 1976 +-8 u P%sT 1996 +-8 m P%sT 2001 +-8 u P%sT 2002 F 20 +-8 m P%sT 2010 +-8 u P%sT +Z America/Toronto -5:17:32 - LMT 1895 +-5 C E%sT 1919 +-5 t E%sT 1942 F 9 2s +-5 C E%sT 1946 +-5 t E%sT 1974 +-5 C E%sT +Z America/Vancouver -8:12:28 - LMT 1884 +-8 Va P%sT 1987 +-8 C P%sT +Z America/Whitehorse -9:0:12 - LMT 1900 Au 20 +-9 Y Y%sT 1965 +-9 Yu Y%sT 1966 F 27 +-8 - PST 1980 +-8 C P%sT 2020 N +-7 - MST +Z America/Winnipeg -6:28:36 - LMT 1887 Jul 16 +-6 W C%sT 2006 +-6 C C%sT +Z America/Yakutat 14:41:5 - LMT 1867 O 19 15:12:18 +-9:18:55 - LMT 1900 Au 20 12 +-9 - YST 1942 +-9 u Y%sT 1946 +-9 - YST 1969 +-9 u Y%sT 1983 N 30 +-9 u AK%sT +Z Antarctica/Casey 0 - -00 1969 +8 - +08 2009 O 18 2 +11 - +11 2010 Mar 5 2 +8 - +08 2011 O 28 2 +11 - +11 2012 F 21 17u +8 - +08 2016 O 22 +11 - +11 2018 Mar 11 4 +8 - +08 2018 O 7 4 +11 - +11 2019 Mar 17 3 +8 - +08 2019 O 4 3 +11 - +11 2020 Mar 8 3 +8 - +08 2020 O 4 0:1 +11 - +11 2021 Mar 14 +8 - +08 2021 O 3 0:1 +11 - +11 2022 Mar 13 +8 - +08 2022 O 2 0:1 +11 - +11 2023 Mar 9 3 +8 - +08 +Z Antarctica/Davis 0 - -00 1957 Ja 13 +7 - +07 1964 N +0 - -00 1969 F +7 - +07 2009 O 18 2 +5 - +05 2010 Mar 10 20u +7 - +07 2011 O 28 2 +5 - +05 2012 F 21 20u +7 - +07 +Z Antarctica/Macquarie 0 - -00 1899 N +10 - AEST 1916 O 1 2 +10 1 AEDT 1917 F +10 AU AE%sT 1919 Ap 1 0s +0 - -00 1948 Mar 25 +10 AU AE%sT 1967 +10 AT AE%sT 2010 +10 1 AEDT 2011 +10 AT AE%sT +Z Antarctica/Mawson 0 - -00 1954 F 13 +6 - +06 2009 O 18 2 +5 - +05 +Z Antarctica/Palmer 0 - -00 1965 +-4 A -04/-03 1969 O 5 +-3 A -03/-02 1982 May +-4 x -04/-03 2016 D 4 +-3 - -03 +Z Antarctica/Rothera 0 - -00 1976 D +-3 - -03 +Z Antarctica/Troll 0 - -00 2005 F 12 +0 Tr %s +Z Antarctica/Vostok 0 - -00 1957 D 16 +7 - +07 1994 F +0 - -00 1994 N +7 - +07 2023 D 18 2 +5 - +05 +Z Asia/Almaty 5:7:48 - LMT 1924 May 2 +5 - +05 1930 Jun 21 +6 R +06/+07 1991 Mar 31 2s +5 R +05/+06 1992 Ja 19 2s +6 R +06/+07 2004 O 31 2s +6 - +06 2024 Mar +5 - +05 +Z Asia/Amman 2:23:44 - LMT 1931 +2 J EE%sT 2022 O 28 0s +3 - +03 +Z Asia/Anadyr 11:49:56 - LMT 1924 May 2 +12 - +12 1930 Jun 21 +13 R +13/+14 1982 Ap 1 0s +12 R +12/+13 1991 Mar 31 2s +11 R +11/+12 1992 Ja 19 2s +12 R +12/+13 2010 Mar 28 2s +11 R +11/+12 2011 Mar 27 2s +12 - +12 +Z Asia/Aqtau 3:21:4 - LMT 1924 May 2 +4 - +04 1930 Jun 21 +5 - +05 1981 O +6 - +06 1982 Ap +5 R +05/+06 1991 Mar 31 2s +4 R +04/+05 1992 Ja 19 2s +5 R +05/+06 1994 S 25 2s +4 R +04/+05 2004 O 31 2s +5 - +05 +Z Asia/Aqtobe 3:48:40 - LMT 1924 May 2 +4 - +04 1930 Jun 21 +5 - +05 1981 Ap +5 1 +06 1981 O +6 - +06 1982 Ap +5 R +05/+06 1991 Mar 31 2s +4 R +04/+05 1992 Ja 19 2s +5 R +05/+06 2004 O 31 2s +5 - +05 +Z Asia/Ashgabat 3:53:32 - LMT 1924 May 2 +4 - +04 1930 Jun 21 +5 R +05/+06 1991 Mar 31 2 +4 R +04/+05 1992 Ja 19 2 +5 - +05 +Z Asia/Atyrau 3:27:44 - LMT 1924 May 2 +3 - +03 1930 Jun 21 +5 - +05 1981 O +6 - +06 1982 Ap +5 R +05/+06 1991 Mar 31 2s +4 R +04/+05 1992 Ja 19 2s +5 R +05/+06 1999 Mar 28 2s +4 R +04/+05 2004 O 31 2s +5 - +05 +Z Asia/Baghdad 2:57:40 - LMT 1890 +2:57:36 - BMT 1918 +3 - +03 1982 May +3 IQ +03/+04 +Z Asia/Baku 3:19:24 - LMT 1924 May 2 +3 - +03 1957 Mar +4 R +04/+05 1991 Mar 31 2s +3 R +03/+04 1992 S lastSu 2s +4 - +04 1996 +4 E +04/+05 1997 +4 AZ +04/+05 +Z Asia/Bangkok 6:42:4 - LMT 1880 +6:42:4 - BMT 1920 Ap +7 - +07 +Z Asia/Barnaul 5:35 - LMT 1919 D 10 +6 - +06 1930 Jun 21 +7 R +07/+08 1991 Mar 31 2s +6 R +06/+07 1992 Ja 19 2s +7 R +07/+08 1995 May 28 +6 R +06/+07 2011 Mar 27 2s +7 - +07 2014 O 26 2s +6 - +06 2016 Mar 27 2s +7 - +07 +Z Asia/Beirut 2:22 - LMT 1880 +2 l EE%sT +Z Asia/Bishkek 4:58:24 - LMT 1924 May 2 +5 - +05 1930 Jun 21 +6 R +06/+07 1991 Mar 31 2s +5 R +05/+06 1991 Au 31 2 +5 KG +05/+06 2005 Au 12 +6 - +06 +Z Asia/Chita 7:33:52 - LMT 1919 D 15 +8 - +08 1930 Jun 21 +9 R +09/+10 1991 Mar 31 2s +8 R +08/+09 1992 Ja 19 2s +9 R +09/+10 2011 Mar 27 2s +10 - +10 2014 O 26 2s +8 - +08 2016 Mar 27 2 +9 - +09 +Z Asia/Choibalsan 7:38 - LMT 1905 Au +7 - +07 1978 +8 - +08 1983 Ap +9 X +09/+10 2008 Mar 31 +8 X +08/+09 +Z Asia/Colombo 5:19:24 - LMT 1880 +5:19:32 - MMT 1906 +5:30 - +0530 1942 Ja 5 +5:30 0:30 +06 1942 S +5:30 1 +0630 1945 O 16 2 +5:30 - +0530 1996 May 25 +6:30 - +0630 1996 O 26 0:30 +6 - +06 2006 Ap 15 0:30 +5:30 - +0530 +Z Asia/Damascus 2:25:12 - LMT 1920 +2 S EE%sT 2022 O 28 +3 - +03 +Z Asia/Dhaka 6:1:40 - LMT 1890 +5:53:20 - HMT 1941 O +6:30 - +0630 1942 May 15 +5:30 - +0530 1942 S +6:30 - +0630 1951 S 30 +6 - +06 2009 +6 BD +06/+07 +Z Asia/Dili 8:22:20 - LMT 1912 +8 - +08 1942 F 21 23 +9 - +09 1976 May 3 +8 - +08 2000 S 17 +9 - +09 +Z Asia/Dubai 3:41:12 - LMT 1920 +4 - +04 +Z Asia/Dushanbe 4:35:12 - LMT 1924 May 2 +5 - +05 1930 Jun 21 +6 R +06/+07 1991 Mar 31 2s +5 1 +06 1991 S 9 2s +5 - +05 +Z Asia/Famagusta 2:15:48 - LMT 1921 N 14 +2 CY EE%sT 1998 S +2 E EE%sT 2016 S 8 +3 - +03 2017 O 29 1u +2 E EE%sT +Z Asia/Gaza 2:17:52 - LMT 1900 O +2 Z EET/EEST 1948 May 15 +2 K EE%sT 1967 Jun 5 +2 Z I%sT 1996 +2 J EE%sT 1999 +2 P EE%sT 2008 Au 29 +2 - EET 2008 S +2 P EE%sT 2010 +2 - EET 2010 Mar 27 0:1 +2 P EE%sT 2011 Au +2 - EET 2012 +2 P EE%sT +Z Asia/Hebron 2:20:23 - LMT 1900 O +2 Z EET/EEST 1948 May 15 +2 K EE%sT 1967 Jun 5 +2 Z I%sT 1996 +2 J EE%sT 1999 +2 P EE%sT +Z Asia/Ho_Chi_Minh 7:6:30 - LMT 1906 Jul +7:6:30 - PLMT 1911 May +7 - +07 1942 D 31 23 +8 - +08 1945 Mar 14 23 +9 - +09 1945 S 1 24 +7 - +07 1947 Ap +8 - +08 1955 Jul 1 1 +7 - +07 1959 D 31 23 +8 - +08 1975 Jun 13 +7 - +07 +Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 29 17u +8 - HKT 1941 Jun 15 3 +8 1 HKST 1941 O 1 4 +8 0:30 HKWT 1941 D 25 +9 - JST 1945 N 18 2 +8 HK HK%sT +Z Asia/Hovd 6:6:36 - LMT 1905 Au +6 - +06 1978 +7 X +07/+08 +Z Asia/Irkutsk 6:57:5 - LMT 1880 +6:57:5 - IMT 1920 Ja 25 +7 - +07 1930 Jun 21 +8 R +08/+09 1991 Mar 31 2s +7 R +07/+08 1992 Ja 19 2s +8 R +08/+09 2011 Mar 27 2s +9 - +09 2014 O 26 2s +8 - +08 +Z Asia/Jakarta 7:7:12 - LMT 1867 Au 10 +7:7:12 - BMT 1923 D 31 16:40u +7:20 - +0720 1932 N +7:30 - +0730 1942 Mar 23 +9 - +09 1945 S 23 +7:30 - +0730 1948 May +8 - +08 1950 May +7:30 - +0730 1964 +7 - WIB +Z Asia/Jayapura 9:22:48 - LMT 1932 N +9 - +09 1944 S +9:30 - +0930 1964 +9 - WIT +Z Asia/Jerusalem 2:20:54 - LMT 1880 +2:20:40 - JMT 1918 +2 Z I%sT +Z Asia/Kabul 4:36:48 - LMT 1890 +4 - +04 1945 +4:30 - +0430 +Z Asia/Kamchatka 10:34:36 - LMT 1922 N 10 +11 - +11 1930 Jun 21 +12 R +12/+13 1991 Mar 31 2s +11 R +11/+12 1992 Ja 19 2s +12 R +12/+13 2010 Mar 28 2s +11 R +11/+12 2011 Mar 27 2s +12 - +12 +Z Asia/Karachi 4:28:12 - LMT 1907 +5:30 - +0530 1942 S +5:30 1 +0630 1945 O 15 +5:30 - +0530 1951 S 30 +5 - +05 1971 Mar 26 +5 PK PK%sT +Z Asia/Kathmandu 5:41:16 - LMT 1920 +5:30 - +0530 1986 +5:45 - +0545 +Z Asia/Khandyga 9:2:13 - LMT 1919 D 15 +8 - +08 1930 Jun 21 +9 R +09/+10 1991 Mar 31 2s +8 R +08/+09 1992 Ja 19 2s +9 R +09/+10 2004 +10 R +10/+11 2011 Mar 27 2s +11 - +11 2011 S 13 0s +10 - +10 2014 O 26 2s +9 - +09 +Z Asia/Kolkata 5:53:28 - LMT 1854 Jun 28 +5:53:20 - HMT 1870 +5:21:10 - MMT 1906 +5:30 - IST 1941 O +5:30 1 +0630 1942 May 15 +5:30 - IST 1942 S +5:30 1 +0630 1945 O 15 +5:30 - IST +Z Asia/Krasnoyarsk 6:11:26 - LMT 1920 Ja 6 +6 - +06 1930 Jun 21 +7 R +07/+08 1991 Mar 31 2s +6 R +06/+07 1992 Ja 19 2s +7 R +07/+08 2011 Mar 27 2s +8 - +08 2014 O 26 2s +7 - +07 +Z Asia/Kuching 7:21:20 - LMT 1926 Mar +7:30 - +0730 1933 +8 NB +08/+0820 1942 F 16 +9 - +09 1945 S 12 +8 - +08 +Z Asia/Macau 7:34:10 - LMT 1904 O 30 +8 - CST 1941 D 21 23 +9 _ +09/+10 1945 S 30 24 +8 _ C%sT +Z Asia/Magadan 10:3:12 - LMT 1924 May 2 +10 - +10 1930 Jun 21 +11 R +11/+12 1991 Mar 31 2s +10 R +10/+11 1992 Ja 19 2s +11 R +11/+12 2011 Mar 27 2s +12 - +12 2014 O 26 2s +10 - +10 2016 Ap 24 2s +11 - +11 +Z Asia/Makassar 7:57:36 - LMT 1920 +7:57:36 - MMT 1932 N +8 - +08 1942 F 9 +9 - +09 1945 S 23 +8 - WITA +Z Asia/Manila -15:56 - LMT 1844 D 31 +8:4 - LMT 1899 May 11 +8 PH P%sT 1942 May +9 - JST 1944 N +8 PH P%sT +Z Asia/Nicosia 2:13:28 - LMT 1921 N 14 +2 CY EE%sT 1998 S +2 E EE%sT +Z Asia/Novokuznetsk 5:48:48 - LMT 1924 May +6 - +06 1930 Jun 21 +7 R +07/+08 1991 Mar 31 2s +6 R +06/+07 1992 Ja 19 2s +7 R +07/+08 2010 Mar 28 2s +6 R +06/+07 2011 Mar 27 2s +7 - +07 +Z Asia/Novosibirsk 5:31:40 - LMT 1919 D 14 6 +6 - +06 1930 Jun 21 +7 R +07/+08 1991 Mar 31 2s +6 R +06/+07 1992 Ja 19 2s +7 R +07/+08 1993 May 23 +6 R +06/+07 2011 Mar 27 2s +7 - +07 2014 O 26 2s +6 - +06 2016 Jul 24 2s +7 - +07 +Z Asia/Omsk 4:53:30 - LMT 1919 N 14 +5 - +05 1930 Jun 21 +6 R +06/+07 1991 Mar 31 2s +5 R +05/+06 1992 Ja 19 2s +6 R +06/+07 2011 Mar 27 2s +7 - +07 2014 O 26 2s +6 - +06 +Z Asia/Oral 3:25:24 - LMT 1924 May 2 +3 - +03 1930 Jun 21 +5 - +05 1981 Ap +5 1 +06 1981 O +6 - +06 1982 Ap +5 R +05/+06 1989 Mar 26 2s +4 R +04/+05 1992 Ja 19 2s +5 R +05/+06 1992 Mar 29 2s +4 R +04/+05 2004 O 31 2s +5 - +05 +Z Asia/Pontianak 7:17:20 - LMT 1908 May +7:17:20 - PMT 1932 N +7:30 - +0730 1942 Ja 29 +9 - +09 1945 S 23 +7:30 - +0730 1948 May +8 - +08 1950 May +7:30 - +0730 1964 +8 - WITA 1988 +7 - WIB +Z Asia/Pyongyang 8:23 - LMT 1908 Ap +8:30 - KST 1912 +9 - JST 1945 Au 24 +9 - KST 2015 Au 15 +8:30 - KST 2018 May 4 23:30 +9 - KST +Z Asia/Qatar 3:26:8 - LMT 1920 +4 - +04 1972 Jun +3 - +03 +Z Asia/Qostanay 4:14:28 - LMT 1924 May 2 +4 - +04 1930 Jun 21 +5 - +05 1981 Ap +5 1 +06 1981 O +6 - +06 1982 Ap +5 R +05/+06 1991 Mar 31 2s +4 R +04/+05 1992 Ja 19 2s +5 R +05/+06 2004 O 31 2s +6 - +06 2024 Mar +5 - +05 +Z Asia/Qyzylorda 4:21:52 - LMT 1924 May 2 +4 - +04 1930 Jun 21 +5 - +05 1981 Ap +5 1 +06 1981 O +6 - +06 1982 Ap +5 R +05/+06 1991 Mar 31 2s +4 R +04/+05 1991 S 29 2s +5 R +05/+06 1992 Ja 19 2s +6 R +06/+07 1992 Mar 29 2s +5 R +05/+06 2004 O 31 2s +6 - +06 2018 D 21 +5 - +05 +Z Asia/Riyadh 3:6:52 - LMT 1947 Mar 14 +3 - +03 +Z Asia/Sakhalin 9:30:48 - LMT 1905 Au 23 +9 - +09 1945 Au 25 +11 R +11/+12 1991 Mar 31 2s +10 R +10/+11 1992 Ja 19 2s +11 R +11/+12 1997 Mar lastSu 2s +10 R +10/+11 2011 Mar 27 2s +11 - +11 2014 O 26 2s +10 - +10 2016 Mar 27 2s +11 - +11 +Z Asia/Samarkand 4:27:53 - LMT 1924 May 2 +4 - +04 1930 Jun 21 +5 - +05 1981 Ap +5 1 +06 1981 O +6 - +06 1982 Ap +5 R +05/+06 1992 +5 - +05 +Z Asia/Seoul 8:27:52 - LMT 1908 Ap +8:30 - KST 1912 +9 - JST 1945 S 8 +9 KR K%sT 1954 Mar 21 +8:30 KR K%sT 1961 Au 10 +9 KR K%sT +Z Asia/Shanghai 8:5:43 - LMT 1901 +8 Sh C%sT 1949 May 28 +8 CN C%sT +Z Asia/Singapore 6:55:25 - LMT 1901 +6:55:25 - SMT 1905 Jun +7 - +07 1933 +7 0:20 +0720 1936 +7:20 - +0720 1941 S +7:30 - +0730 1942 F 16 +9 - +09 1945 S 12 +7:30 - +0730 1981 D 31 16u +8 - +08 +Z Asia/Srednekolymsk 10:14:52 - LMT 1924 May 2 +10 - +10 1930 Jun 21 +11 R +11/+12 1991 Mar 31 2s +10 R +10/+11 1992 Ja 19 2s +11 R +11/+12 2011 Mar 27 2s +12 - +12 2014 O 26 2s +11 - +11 +Z Asia/Taipei 8:6 - LMT 1896 +8 - CST 1937 O +9 - JST 1945 S 21 1 +8 f C%sT +Z Asia/Tashkent 4:37:11 - LMT 1924 May 2 +5 - +05 1930 Jun 21 +6 R +06/+07 1991 Mar 31 2 +5 R +05/+06 1992 +5 - +05 +Z Asia/Tbilisi 2:59:11 - LMT 1880 +2:59:11 - TBMT 1924 May 2 +3 - +03 1957 Mar +4 R +04/+05 1991 Mar 31 2s +3 R +03/+04 1992 +3 e +03/+04 1994 S lastSu +4 e +04/+05 1996 O lastSu +4 1 +05 1997 Mar lastSu +4 e +04/+05 2004 Jun 27 +3 R +03/+04 2005 Mar lastSu 2 +4 - +04 +Z Asia/Tehran 3:25:44 - LMT 1916 +3:25:44 - TMT 1935 Jun 13 +3:30 i +0330/+0430 1977 O 20 24 +4 i +04/+05 1979 +3:30 i +0330/+0430 +Z Asia/Thimphu 5:58:36 - LMT 1947 Au 15 +5:30 - +0530 1987 O +6 - +06 +Z Asia/Tokyo 9:18:59 - LMT 1887 D 31 15u +9 JP J%sT +Z Asia/Tomsk 5:39:51 - LMT 1919 D 22 +6 - +06 1930 Jun 21 +7 R +07/+08 1991 Mar 31 2s +6 R +06/+07 1992 Ja 19 2s +7 R +07/+08 2002 May 1 3 +6 R +06/+07 2011 Mar 27 2s +7 - +07 2014 O 26 2s +6 - +06 2016 May 29 2s +7 - +07 +Z Asia/Ulaanbaatar 7:7:32 - LMT 1905 Au +7 - +07 1978 +8 X +08/+09 +Z Asia/Urumqi 5:50:20 - LMT 1928 +6 - +06 +Z Asia/Ust-Nera 9:32:54 - LMT 1919 D 15 +8 - +08 1930 Jun 21 +9 R +09/+10 1981 Ap +11 R +11/+12 1991 Mar 31 2s +10 R +10/+11 1992 Ja 19 2s +11 R +11/+12 2011 Mar 27 2s +12 - +12 2011 S 13 0s +11 - +11 2014 O 26 2s +10 - +10 +Z Asia/Vladivostok 8:47:31 - LMT 1922 N 15 +9 - +09 1930 Jun 21 +10 R +10/+11 1991 Mar 31 2s +9 R +09/+10 1992 Ja 19 2s +10 R +10/+11 2011 Mar 27 2s +11 - +11 2014 O 26 2s +10 - +10 +Z Asia/Yakutsk 8:38:58 - LMT 1919 D 15 +8 - +08 1930 Jun 21 +9 R +09/+10 1991 Mar 31 2s +8 R +08/+09 1992 Ja 19 2s +9 R +09/+10 2011 Mar 27 2s +10 - +10 2014 O 26 2s +9 - +09 +Z Asia/Yangon 6:24:47 - LMT 1880 +6:24:47 - RMT 1920 +6:30 - +0630 1942 May +9 - +09 1945 May 3 +6:30 - +0630 +Z Asia/Yekaterinburg 4:2:33 - LMT 1916 Jul 3 +3:45:5 - PMT 1919 Jul 15 4 +4 - +04 1930 Jun 21 +5 R +05/+06 1991 Mar 31 2s +4 R +04/+05 1992 Ja 19 2s +5 R +05/+06 2011 Mar 27 2s +6 - +06 2014 O 26 2s +5 - +05 +Z Asia/Yerevan 2:58 - LMT 1924 May 2 +3 - +03 1957 Mar +4 R +04/+05 1991 Mar 31 2s +3 R +03/+04 1995 S 24 2s +4 - +04 1997 +4 R +04/+05 2011 +4 AM +04/+05 +Z Atlantic/Azores -1:42:40 - LMT 1884 +-1:54:32 - HMT 1912 Ja 1 2u +-2 p -02/-01 1942 Ap 25 22s +-2 p +00 1942 Au 15 22s +-2 p -02/-01 1943 Ap 17 22s +-2 p +00 1943 Au 28 22s +-2 p -02/-01 1944 Ap 22 22s +-2 p +00 1944 Au 26 22s +-2 p -02/-01 1945 Ap 21 22s +-2 p +00 1945 Au 25 22s +-2 p -02/-01 1966 Ap 3 2 +-1 p -01/+00 1983 S 25 1s +-1 W- -01/+00 1992 S 27 1s +0 E WE%sT 1993 Mar 28 1u +-1 E -01/+00 +Z Atlantic/Bermuda -4:19:18 - LMT 1890 +-4:19:18 Be BMT/BST 1930 Ja 1 2 +-4 Be A%sT 1974 Ap 28 2 +-4 C A%sT 1976 +-4 u A%sT +Z Atlantic/Canary -1:1:36 - LMT 1922 Mar +-1 - -01 1946 S 30 1 +0 - WET 1980 Ap 6 0s +0 1 WEST 1980 S 28 1u +0 E WE%sT +Z Atlantic/Cape_Verde -1:34:4 - LMT 1912 Ja 1 2u +-2 - -02 1942 S +-2 1 -01 1945 O 15 +-2 - -02 1975 N 25 2 +-1 - -01 +Z Atlantic/Faroe -0:27:4 - LMT 1908 Ja 11 +0 - WET 1981 +0 E WE%sT +Z Atlantic/Madeira -1:7:36 - LMT 1884 +-1:7:36 - FMT 1912 Ja 1 1u +-1 p -01/+00 1942 Ap 25 22s +-1 p +01 1942 Au 15 22s +-1 p -01/+00 1943 Ap 17 22s +-1 p +01 1943 Au 28 22s +-1 p -01/+00 1944 Ap 22 22s +-1 p +01 1944 Au 26 22s +-1 p -01/+00 1945 Ap 21 22s +-1 p +01 1945 Au 25 22s +-1 p -01/+00 1966 Ap 3 2 +0 p WE%sT 1983 S 25 1s +0 E WE%sT +Z Atlantic/South_Georgia -2:26:8 - LMT 1890 +-2 - -02 +Z Atlantic/Stanley -3:51:24 - LMT 1890 +-3:51:24 - SMT 1912 Mar 12 +-4 FK -04/-03 1983 May +-3 FK -03/-02 1985 S 15 +-4 FK -04/-03 2010 S 5 2 +-3 - -03 +Z Australia/Adelaide 9:14:20 - LMT 1895 F +9 - ACST 1899 May +9:30 AU AC%sT 1971 +9:30 AS AC%sT +Z Australia/Brisbane 10:12:8 - LMT 1895 +10 AU AE%sT 1971 +10 AQ AE%sT +Z Australia/Broken_Hill 9:25:48 - LMT 1895 F +10 - AEST 1896 Au 23 +9 - ACST 1899 May +9:30 AU AC%sT 1971 +9:30 AN AC%sT 2000 +9:30 AS AC%sT +Z Australia/Darwin 8:43:20 - LMT 1895 F +9 - ACST 1899 May +9:30 AU AC%sT +Z Australia/Eucla 8:35:28 - LMT 1895 D +8:45 AU +0845/+0945 1943 Jul +8:45 AW +0845/+0945 +Z Australia/Hobart 9:49:16 - LMT 1895 S +10 AT AE%sT 1919 O 24 +10 AU AE%sT 1967 +10 AT AE%sT +Z Australia/Lindeman 9:55:56 - LMT 1895 +10 AU AE%sT 1971 +10 AQ AE%sT 1992 Jul +10 Ho AE%sT +Z Australia/Lord_Howe 10:36:20 - LMT 1895 F +10 - AEST 1981 Mar +10:30 LH +1030/+1130 1985 Jul +10:30 LH +1030/+11 +Z Australia/Melbourne 9:39:52 - LMT 1895 F +10 AU AE%sT 1971 +10 AV AE%sT +Z Australia/Perth 7:43:24 - LMT 1895 D +8 AU AW%sT 1943 Jul +8 AW AW%sT +Z Australia/Sydney 10:4:52 - LMT 1895 F +10 AU AE%sT 1971 +10 AN AE%sT +Z CET 1 c CE%sT +Z CST6CDT -6 u C%sT +Z EET 2 E EE%sT +Z EST -5 - EST +Z EST5EDT -5 u E%sT Z Etc/GMT 0 - GMT -L Etc/GMT GMT -Z Etc/GMT-14 14 - +14 -Z Etc/GMT-13 13 - +13 -Z Etc/GMT-12 12 - +12 -Z Etc/GMT-11 11 - +11 -Z Etc/GMT-10 10 - +10 -Z Etc/GMT-9 9 - +09 -Z Etc/GMT-8 8 - +08 -Z Etc/GMT-7 7 - +07 -Z Etc/GMT-6 6 - +06 -Z Etc/GMT-5 5 - +05 -Z Etc/GMT-4 4 - +04 -Z Etc/GMT-3 3 - +03 -Z Etc/GMT-2 2 - +02 -Z Etc/GMT-1 1 - +01 Z Etc/GMT+1 -1 - -01 +Z Etc/GMT+10 -10 - -10 +Z Etc/GMT+11 -11 - -11 +Z Etc/GMT+12 -12 - -12 Z Etc/GMT+2 -2 - -02 Z Etc/GMT+3 -3 - -03 Z Etc/GMT+4 -4 - -04 @@ -4034,10 +3591,463 @@ Z Etc/GMT+6 -6 - -06 Z Etc/GMT+7 -7 - -07 Z Etc/GMT+8 -8 - -08 Z Etc/GMT+9 -9 - -09 -Z Etc/GMT+10 -10 - -10 -Z Etc/GMT+11 -11 - -11 -Z Etc/GMT+12 -12 - -12 +Z Etc/GMT-1 1 - +01 +Z Etc/GMT-10 10 - +10 +Z Etc/GMT-11 11 - +11 +Z Etc/GMT-12 12 - +12 +Z Etc/GMT-13 13 - +13 +Z Etc/GMT-14 14 - +14 +Z Etc/GMT-2 2 - +02 +Z Etc/GMT-3 3 - +03 +Z Etc/GMT-4 4 - +04 +Z Etc/GMT-5 5 - +05 +Z Etc/GMT-6 6 - +06 +Z Etc/GMT-7 7 - +07 +Z Etc/GMT-8 8 - +08 +Z Etc/GMT-9 9 - +09 +Z Etc/UTC 0 - UTC +Z Europe/Andorra 0:6:4 - LMT 1901 +0 - WET 1946 S 30 +1 - CET 1985 Mar 31 2 +1 E CE%sT +Z Europe/Astrakhan 3:12:12 - LMT 1924 May +3 - +03 1930 Jun 21 +4 R +04/+05 1989 Mar 26 2s +3 R +03/+04 1991 Mar 31 2s +4 - +04 1992 Mar 29 2s +3 R +03/+04 2011 Mar 27 2s +4 - +04 2014 O 26 2s +3 - +03 2016 Mar 27 2s +4 - +04 +Z Europe/Athens 1:34:52 - LMT 1895 S 14 +1:34:52 - AMT 1916 Jul 28 0:1 +2 g EE%sT 1941 Ap 30 +1 g CE%sT 1944 Ap 4 +2 g EE%sT 1981 +2 E EE%sT +Z Europe/Belgrade 1:22 - LMT 1884 +1 - CET 1941 Ap 18 23 +1 c CE%sT 1945 +1 - CET 1945 May 8 2s +1 1 CEST 1945 S 16 2s +1 - CET 1982 N 27 +1 E CE%sT +Z Europe/Berlin 0:53:28 - LMT 1893 Ap +1 c CE%sT 1945 May 24 2 +1 So CE%sT 1946 +1 DE CE%sT 1980 +1 E CE%sT +Z Europe/Brussels 0:17:30 - LMT 1880 +0:17:30 - BMT 1892 May 1 0:17:30 +0 - WET 1914 N 8 +1 - CET 1916 May +1 c CE%sT 1918 N 11 11u +0 b WE%sT 1940 May 20 2s +1 c CE%sT 1944 S 3 +1 b CE%sT 1977 +1 E CE%sT +Z Europe/Bucharest 1:44:24 - LMT 1891 O +1:44:24 - BMT 1931 Jul 24 +2 z EE%sT 1981 Mar 29 2s +2 c EE%sT 1991 +2 z EE%sT 1994 +2 e EE%sT 1997 +2 E EE%sT +Z Europe/Budapest 1:16:20 - LMT 1890 N +1 c CE%sT 1918 +1 h CE%sT 1941 Ap 7 23 +1 c CE%sT 1945 +1 h CE%sT 1984 +1 E CE%sT +Z Europe/Chisinau 1:55:20 - LMT 1880 +1:55 - CMT 1918 F 15 +1:44:24 - BMT 1931 Jul 24 +2 z EE%sT 1940 Au 15 +2 1 EEST 1941 Jul 17 +1 c CE%sT 1944 Au 24 +3 R MSK/MSD 1990 May 6 2 +2 R EE%sT 1992 +2 e EE%sT 1997 +2 MD EE%sT +Z Europe/Dublin -0:25:21 - LMT 1880 Au 2 +-0:25:21 - DMT 1916 May 21 2s +-0:25:21 1 IST 1916 O 1 2s +0 G %s 1921 D 6 +0 G GMT/IST 1940 F 25 2s +0 1 IST 1946 O 6 2s +0 - GMT 1947 Mar 16 2s +0 1 IST 1947 N 2 2s +0 - GMT 1948 Ap 18 2s +0 G GMT/IST 1968 O 27 +1 IE IST/GMT +Z Europe/Gibraltar -0:21:24 - LMT 1880 Au 2 +0 G %s 1957 Ap 14 2 +1 - CET 1982 +1 E CE%sT +Z Europe/Helsinki 1:39:49 - LMT 1878 May 31 +1:39:49 - HMT 1921 May +2 FI EE%sT 1983 +2 E EE%sT +Z Europe/Istanbul 1:55:52 - LMT 1880 +1:56:56 - IMT 1910 O +2 T EE%sT 1978 Jun 29 +3 T +03/+04 1984 N 1 2 +2 T EE%sT 2007 +2 E EE%sT 2011 Mar 27 1u +2 - EET 2011 Mar 28 1u +2 E EE%sT 2014 Mar 30 1u +2 - EET 2014 Mar 31 1u +2 E EE%sT 2015 O 25 1u +2 1 EEST 2015 N 8 1u +2 E EE%sT 2016 S 7 +3 - +03 +Z Europe/Kaliningrad 1:22 - LMT 1893 Ap +1 c CE%sT 1945 Ap 10 +2 O EE%sT 1946 Ap 7 +3 R MSK/MSD 1989 Mar 26 2s +2 R EE%sT 2011 Mar 27 2s +3 - +03 2014 O 26 2s +2 - EET +Z Europe/Kirov 3:18:48 - LMT 1919 Jul 1 0u +3 - +03 1930 Jun 21 +4 R +04/+05 1989 Mar 26 2s +3 R MSK/MSD 1991 Mar 31 2s +4 - +04 1992 Mar 29 2s +3 R MSK/MSD 2011 Mar 27 2s +4 - MSK 2014 O 26 2s +3 - MSK +Z Europe/Kyiv 2:2:4 - LMT 1880 +2:2:4 - KMT 1924 May 2 +2 - EET 1930 Jun 21 +3 - MSK 1941 S 20 +1 c CE%sT 1943 N 6 +3 R MSK/MSD 1990 Jul 1 2 +2 1 EEST 1991 S 29 3 +2 c EE%sT 1996 May 13 +2 E EE%sT +Z Europe/Lisbon -0:36:45 - LMT 1884 +-0:36:45 - LMT 1912 Ja 1 0u +0 p WE%sT 1966 Ap 3 2 +1 - CET 1976 S 26 1 +0 p WE%sT 1983 S 25 1s +0 W- WE%sT 1992 S 27 1s +1 E CE%sT 1996 Mar 31 1u +0 E WE%sT +Z Europe/London -0:1:15 - LMT 1847 D +0 G %s 1968 O 27 +1 - BST 1971 O 31 2u +0 G %s 1996 +0 E GMT/BST +Z Europe/Madrid -0:14:44 - LMT 1901 Ja 1 0u +0 s WE%sT 1940 Mar 16 23 +1 s CE%sT 1979 +1 E CE%sT +Z Europe/Malta 0:58:4 - LMT 1893 N 2 +1 I CE%sT 1973 Mar 31 +1 MT CE%sT 1981 +1 E CE%sT +Z Europe/Minsk 1:50:16 - LMT 1880 +1:50 - MMT 1924 May 2 +2 - EET 1930 Jun 21 +3 - MSK 1941 Jun 28 +1 c CE%sT 1944 Jul 3 +3 R MSK/MSD 1990 +3 - MSK 1991 Mar 31 2s +2 R EE%sT 2011 Mar 27 2s +3 - +03 +Z Europe/Moscow 2:30:17 - LMT 1880 +2:30:17 - MMT 1916 Jul 3 +2:31:19 R %s 1919 Jul 1 0u +3 R %s 1921 O +3 R MSK/MSD 1922 O +2 - EET 1930 Jun 21 +3 R MSK/MSD 1991 Mar 31 2s +2 R EE%sT 1992 Ja 19 2s +3 R MSK/MSD 2011 Mar 27 2s +4 - MSK 2014 O 26 2s +3 - MSK +Z Europe/Paris 0:9:21 - LMT 1891 Mar 16 +0:9:21 - PMT 1911 Mar 11 +0 F WE%sT 1940 Jun 14 23 +1 c CE%sT 1944 Au 25 +0 F WE%sT 1945 S 16 3 +1 F CE%sT 1977 +1 E CE%sT +Z Europe/Prague 0:57:44 - LMT 1850 +0:57:44 - PMT 1891 O +1 c CE%sT 1945 May 9 +1 CZ CE%sT 1946 D 1 3 +1 -1 GMT 1947 F 23 2 +1 CZ CE%sT 1979 +1 E CE%sT +Z Europe/Riga 1:36:34 - LMT 1880 +1:36:34 - RMT 1918 Ap 15 2 +1:36:34 1 LST 1918 S 16 3 +1:36:34 - RMT 1919 Ap 1 2 +1:36:34 1 LST 1919 May 22 3 +1:36:34 - RMT 1926 May 11 +2 - EET 1940 Au 5 +3 - MSK 1941 Jul +1 c CE%sT 1944 O 13 +3 R MSK/MSD 1989 Mar lastSu 2s +2 1 EEST 1989 S lastSu 2s +2 LV EE%sT 1997 Ja 21 +2 E EE%sT 2000 F 29 +2 - EET 2001 Ja 2 +2 E EE%sT +Z Europe/Rome 0:49:56 - LMT 1866 D 12 +0:49:56 - RMT 1893 O 31 23u +1 I CE%sT 1943 S 10 +1 c CE%sT 1944 Jun 4 +1 I CE%sT 1980 +1 E CE%sT +Z Europe/Samara 3:20:20 - LMT 1919 Jul 1 0u +3 - +03 1930 Jun 21 +4 - +04 1935 Ja 27 +4 R +04/+05 1989 Mar 26 2s +3 R +03/+04 1991 Mar 31 2s +2 R +02/+03 1991 S 29 2s +3 - +03 1991 O 20 3 +4 R +04/+05 2010 Mar 28 2s +3 R +03/+04 2011 Mar 27 2s +4 - +04 +Z Europe/Saratov 3:4:18 - LMT 1919 Jul 1 0u +3 - +03 1930 Jun 21 +4 R +04/+05 1988 Mar 27 2s +3 R +03/+04 1991 Mar 31 2s +4 - +04 1992 Mar 29 2s +3 R +03/+04 2011 Mar 27 2s +4 - +04 2014 O 26 2s +3 - +03 2016 D 4 2s +4 - +04 +Z Europe/Simferopol 2:16:24 - LMT 1880 +2:16 - SMT 1924 May 2 +2 - EET 1930 Jun 21 +3 - MSK 1941 N +1 c CE%sT 1944 Ap 13 +3 R MSK/MSD 1990 +3 - MSK 1990 Jul 1 2 +2 - EET 1992 Mar 20 +2 c EE%sT 1994 May +3 c MSK/MSD 1996 Mar 31 0s +3 1 MSD 1996 O 27 3s +3 - MSK 1997 Mar lastSu 1u +2 E EE%sT 2014 Mar 30 2 +4 - MSK 2014 O 26 2s +3 - MSK +Z Europe/Sofia 1:33:16 - LMT 1880 +1:56:56 - IMT 1894 N 30 +2 - EET 1942 N 2 3 +1 c CE%sT 1945 +1 - CET 1945 Ap 2 3 +2 - EET 1979 Mar 31 23 +2 BG EE%sT 1982 S 26 3 +2 c EE%sT 1991 +2 e EE%sT 1997 +2 E EE%sT +Z Europe/Tallinn 1:39 - LMT 1880 +1:39 - TMT 1918 F +1 c CE%sT 1919 Jul +1:39 - TMT 1921 May +2 - EET 1940 Au 6 +3 - MSK 1941 S 15 +1 c CE%sT 1944 S 22 +3 R MSK/MSD 1989 Mar 26 2s +2 1 EEST 1989 S 24 2s +2 c EE%sT 1998 S 22 +2 E EE%sT 1999 O 31 4 +2 - EET 2002 F 21 +2 E EE%sT +Z Europe/Tirane 1:19:20 - LMT 1914 +1 - CET 1940 Jun 16 +1 q CE%sT 1984 Jul +1 E CE%sT +Z Europe/Ulyanovsk 3:13:36 - LMT 1919 Jul 1 0u +3 - +03 1930 Jun 21 +4 R +04/+05 1989 Mar 26 2s +3 R +03/+04 1991 Mar 31 2s +2 R +02/+03 1992 Ja 19 2s +3 R +03/+04 2011 Mar 27 2s +4 - +04 2014 O 26 2s +3 - +03 2016 Mar 27 2s +4 - +04 +Z Europe/Vienna 1:5:21 - LMT 1893 Ap +1 c CE%sT 1920 +1 a CE%sT 1940 Ap 1 2s +1 c CE%sT 1945 Ap 2 2s +1 1 CEST 1945 Ap 12 2s +1 - CET 1946 +1 a CE%sT 1981 +1 E CE%sT +Z Europe/Vilnius 1:41:16 - LMT 1880 +1:24 - WMT 1917 +1:35:36 - KMT 1919 O 10 +1 - CET 1920 Jul 12 +2 - EET 1920 O 9 +1 - CET 1940 Au 3 +3 - MSK 1941 Jun 24 +1 c CE%sT 1944 Au +3 R MSK/MSD 1989 Mar 26 2s +2 R EE%sT 1991 S 29 2s +2 c EE%sT 1998 +2 - EET 1998 Mar 29 1u +1 E CE%sT 1999 O 31 1u +2 - EET 2003 +2 E EE%sT +Z Europe/Volgograd 2:57:40 - LMT 1920 Ja 3 +3 - +03 1930 Jun 21 +4 - +04 1961 N 11 +4 R +04/+05 1988 Mar 27 2s +3 R MSK/MSD 1991 Mar 31 2s +4 - +04 1992 Mar 29 2s +3 R MSK/MSD 2011 Mar 27 2s +4 - MSK 2014 O 26 2s +3 - MSK 2018 O 28 2s +4 - +04 2020 D 27 2s +3 - MSK +Z Europe/Warsaw 1:24 - LMT 1880 +1:24 - WMT 1915 Au 5 +1 c CE%sT 1918 S 16 3 +2 O EE%sT 1922 Jun +1 O CE%sT 1940 Jun 23 2 +1 c CE%sT 1944 O +1 O CE%sT 1977 +1 W- CE%sT 1988 +1 E CE%sT +Z Europe/Zurich 0:34:8 - LMT 1853 Jul 16 +0:29:46 - BMT 1894 Jun +1 CH CE%sT 1981 +1 E CE%sT Z Factory 0 - -00 +Z HST -10 - HST +Z Indian/Chagos 4:49:40 - LMT 1907 +5 - +05 1996 +6 - +06 +Z Indian/Maldives 4:54 - LMT 1880 +4:54 - MMT 1960 +5 - +05 +Z Indian/Mauritius 3:50 - LMT 1907 +4 MU +04/+05 +Z MET 1 c ME%sT +Z MST -7 - MST +Z MST7MDT -7 u M%sT +Z PST8PDT -8 u P%sT +Z Pacific/Apia 12:33:4 - LMT 1892 Jul 5 +-11:26:56 - LMT 1911 +-11:30 - -1130 1950 +-11 WS -11/-10 2011 D 29 24 +13 WS +13/+14 +Z Pacific/Auckland 11:39:4 - LMT 1868 N 2 +11:30 NZ NZ%sT 1946 +12 NZ NZ%sT +Z Pacific/Bougainville 10:22:16 - LMT 1880 +9:48:32 - PMMT 1895 +10 - +10 1942 Jul +9 - +09 1945 Au 21 +10 - +10 2014 D 28 2 +11 - +11 +Z Pacific/Chatham 12:13:48 - LMT 1868 N 2 +12:15 - +1215 1946 +12:45 k +1245/+1345 +Z Pacific/Easter -7:17:28 - LMT 1890 +-7:17:28 - EMT 1932 S +-7 x -07/-06 1982 Mar 14 3u +-6 x -06/-05 +Z Pacific/Efate 11:13:16 - LMT 1912 Ja 13 +11 VU +11/+12 +Z Pacific/Fakaofo -11:24:56 - LMT 1901 +-11 - -11 2011 D 30 +13 - +13 +Z Pacific/Fiji 11:55:44 - LMT 1915 O 26 +12 FJ +12/+13 +Z Pacific/Galapagos -5:58:24 - LMT 1931 +-5 - -05 1986 +-6 EC -06/-05 +Z Pacific/Gambier -8:59:48 - LMT 1912 O +-9 - -09 +Z Pacific/Guadalcanal 10:39:48 - LMT 1912 O +11 - +11 +Z Pacific/Guam -14:21 - LMT 1844 D 31 +9:39 - LMT 1901 +10 - GST 1941 D 10 +9 - +09 1944 Jul 31 +10 Gu G%sT 2000 D 23 +10 - ChST +Z Pacific/Honolulu -10:31:26 - LMT 1896 Ja 13 12 +-10:30 - HST 1933 Ap 30 2 +-10:30 1 HDT 1933 May 21 12 +-10:30 u H%sT 1947 Jun 8 2 +-10 - HST +Z Pacific/Kanton 0 - -00 1937 Au 31 +-12 - -12 1979 O +-11 - -11 1994 D 31 +13 - +13 +Z Pacific/Kiritimati -10:29:20 - LMT 1901 +-10:40 - -1040 1979 O +-10 - -10 1994 D 31 +14 - +14 +Z Pacific/Kosrae -13:8:4 - LMT 1844 D 31 +10:51:56 - LMT 1901 +11 - +11 1914 O +9 - +09 1919 F +11 - +11 1937 +10 - +10 1941 Ap +9 - +09 1945 Au +11 - +11 1969 O +12 - +12 1999 +11 - +11 +Z Pacific/Kwajalein 11:9:20 - LMT 1901 +11 - +11 1937 +10 - +10 1941 Ap +9 - +09 1944 F 6 +11 - +11 1969 O +-12 - -12 1993 Au 20 24 +12 - +12 +Z Pacific/Marquesas -9:18 - LMT 1912 O +-9:30 - -0930 +Z Pacific/Nauru 11:7:40 - LMT 1921 Ja 15 +11:30 - +1130 1942 Au 29 +9 - +09 1945 S 8 +11:30 - +1130 1979 F 10 2 +12 - +12 +Z Pacific/Niue -11:19:40 - LMT 1952 O 16 +-11:20 - -1120 1964 Jul +-11 - -11 +Z Pacific/Norfolk 11:11:52 - LMT 1901 +11:12 - +1112 1951 +11:30 - +1130 1974 O 27 2s +11:30 1 +1230 1975 Mar 2 2s +11:30 - +1130 2015 O 4 2s +11 - +11 2019 Jul +11 AN +11/+12 +Z Pacific/Noumea 11:5:48 - LMT 1912 Ja 13 +11 NC +11/+12 +Z Pacific/Pago_Pago 12:37:12 - LMT 1892 Jul 5 +-11:22:48 - LMT 1911 +-11 - SST +Z Pacific/Palau -15:2:4 - LMT 1844 D 31 +8:57:56 - LMT 1901 +9 - +09 +Z Pacific/Pitcairn -8:40:20 - LMT 1901 +-8:30 - -0830 1998 Ap 27 +-8 - -08 +Z Pacific/Port_Moresby 9:48:40 - LMT 1880 +9:48:32 - PMMT 1895 +10 - +10 +Z Pacific/Rarotonga 13:20:56 - LMT 1899 D 26 +-10:39:4 - LMT 1952 O 16 +-10:30 - -1030 1978 N 12 +-10 CK -10/-0930 +Z Pacific/Tahiti -9:58:16 - LMT 1912 O +-10 - -10 +Z Pacific/Tarawa 11:32:4 - LMT 1901 +12 - +12 +Z Pacific/Tongatapu 12:19:12 - LMT 1945 S 10 +12:20 - +1220 1961 +13 - +13 1999 +13 TO +13/+14 +Z WET 0 E WE%sT +L Etc/GMT GMT L Australia/Sydney Australia/ACT L Australia/Lord_Howe Australia/LHI L Australia/Sydney Australia/NSW @@ -4185,7 +4195,6 @@ L America/Puerto_Rico America/Tortola L Pacific/Port_Moresby Antarctica/DumontDUrville L Pacific/Auckland Antarctica/McMurdo L Asia/Riyadh Antarctica/Syowa -L Asia/Urumqi Antarctica/Vostok L Europe/Berlin Arctic/Longyearbyen L Asia/Riyadh Asia/Aden L Asia/Qatar Asia/Bahrain diff --git a/lib/pytz/zoneinfo/zone.tab b/lib/pytz/zoneinfo/zone.tab index dbcb6179..3fa9306a 100644 --- a/lib/pytz/zoneinfo/zone.tab +++ b/lib/pytz/zoneinfo/zone.tab @@ -48,7 +48,7 @@ AR -3124-06411 America/Argentina/Cordoba Argentina (most areas: CB, CC, CN, ER, AR -2447-06525 America/Argentina/Salta Salta (SA, LP, NQ, RN) AR -2411-06518 America/Argentina/Jujuy Jujuy (JY) AR -2649-06513 America/Argentina/Tucuman Tucuman (TM) -AR -2828-06547 America/Argentina/Catamarca Catamarca (CT); Chubut (CH) +AR -2828-06547 America/Argentina/Catamarca Catamarca (CT), Chubut (CH) AR -2926-06651 America/Argentina/La_Rioja La Rioja (LR) AR -3132-06831 America/Argentina/San_Juan San Juan (SJ) AR -3253-06849 America/Argentina/Mendoza Mendoza (MZ) @@ -87,7 +87,7 @@ BN +0456+11455 Asia/Brunei BO -1630-06809 America/La_Paz BQ +120903-0681636 America/Kralendijk BR -0351-03225 America/Noronha Atlantic islands -BR -0127-04829 America/Belem Para (east); Amapa +BR -0127-04829 America/Belem Para (east), Amapa BR -0343-03830 America/Fortaleza Brazil (northeast: MA, PI, CE, RN, PB) BR -0803-03454 America/Recife Pernambuco BR -0712-04812 America/Araguaina Tocantins @@ -107,21 +107,21 @@ BT +2728+08939 Asia/Thimphu BW -2439+02555 Africa/Gaborone BY +5354+02734 Europe/Minsk BZ +1730-08812 America/Belize -CA +4734-05243 America/St_Johns Newfoundland; Labrador (southeast) -CA +4439-06336 America/Halifax Atlantic - NS (most areas); PE +CA +4734-05243 America/St_Johns Newfoundland, Labrador (SE) +CA +4439-06336 America/Halifax Atlantic - NS (most areas), PE CA +4612-05957 America/Glace_Bay Atlantic - NS (Cape Breton) CA +4606-06447 America/Moncton Atlantic - New Brunswick CA +5320-06025 America/Goose_Bay Atlantic - Labrador (most areas) CA +5125-05707 America/Blanc-Sablon AST - QC (Lower North Shore) -CA +4339-07923 America/Toronto Eastern - ON, QC (most areas) +CA +4339-07923 America/Toronto Eastern - ON & QC (most areas) CA +6344-06828 America/Iqaluit Eastern - NU (most areas) -CA +484531-0913718 America/Atikokan EST - ON (Atikokan); NU (Coral H) -CA +4953-09709 America/Winnipeg Central - ON (west); Manitoba +CA +484531-0913718 America/Atikokan EST - ON (Atikokan), NU (Coral H) +CA +4953-09709 America/Winnipeg Central - ON (west), Manitoba CA +744144-0944945 America/Resolute Central - NU (Resolute) CA +624900-0920459 America/Rankin_Inlet Central - NU (central) CA +5024-10439 America/Regina CST - SK (most areas) CA +5017-10750 America/Swift_Current CST - SK (midwest) -CA +5333-11328 America/Edmonton Mountain - AB; BC (E); NT (E); SK (W) +CA +5333-11328 America/Edmonton Mountain - AB, BC(E), NT(E), SK(W) CA +690650-1050310 America/Cambridge_Bay Mountain - NU (west) CA +682059-1334300 America/Inuvik Mountain - NT (west) CA +4906-11631 America/Creston MST - BC (Creston) @@ -207,8 +207,8 @@ HT +1832-07220 America/Port-au-Prince HU +4730+01905 Europe/Budapest ID -0610+10648 Asia/Jakarta Java, Sumatra ID -0002+10920 Asia/Pontianak Borneo (west, central) -ID -0507+11924 Asia/Makassar Borneo (east, south); Sulawesi/Celebes, Bali, Nusa Tengarra; Timor (west) -ID -0232+14042 Asia/Jayapura New Guinea (West Papua / Irian Jaya); Malukus/Moluccas +ID -0507+11924 Asia/Makassar Borneo (east, south), Sulawesi/Celebes, Bali, Nusa Tengarra, Timor (west) +ID -0232+14042 Asia/Jayapura New Guinea (West Papua / Irian Jaya), Malukus/Moluccas IE +5320-00615 Europe/Dublin IL +314650+0351326 Asia/Jerusalem IM +5409-00428 Europe/Isle_of_Man @@ -355,7 +355,7 @@ RU +4310+13156 Asia/Vladivostok MSK+07 - Amur River RU +643337+1431336 Asia/Ust-Nera MSK+07 - Oymyakonsky RU +5934+15048 Asia/Magadan MSK+08 - Magadan RU +4658+14242 Asia/Sakhalin MSK+08 - Sakhalin Island -RU +6728+15343 Asia/Srednekolymsk MSK+08 - Sakha (E); N Kuril Is +RU +6728+15343 Asia/Srednekolymsk MSK+08 - Sakha (E), N Kuril Is RU +5301+15839 Asia/Kamchatka MSK+09 - Kamchatka RU +6445+17729 Asia/Anadyr MSK+09 - Bering Sea RW -0157+03004 Africa/Kigali @@ -418,7 +418,7 @@ US +470659-1011757 America/North_Dakota/Center Central - ND (Oliver) US +465042-1012439 America/North_Dakota/New_Salem Central - ND (Morton rural) US +471551-1014640 America/North_Dakota/Beulah Central - ND (Mercer) US +394421-1045903 America/Denver Mountain (most areas) -US +433649-1161209 America/Boise Mountain - ID (south); OR (east) +US +433649-1161209 America/Boise Mountain - ID (south), OR (east) US +332654-1120424 America/Phoenix MST - AZ (except Navajo) US +340308-1181434 America/Los_Angeles Pacific US +611305-1495401 America/Anchorage Alaska (most areas) diff --git a/lib/pytz/zoneinfo/zone1970.tab b/lib/pytz/zoneinfo/zone1970.tab index 1f1cecb8..abd94897 100644 --- a/lib/pytz/zoneinfo/zone1970.tab +++ b/lib/pytz/zoneinfo/zone1970.tab @@ -37,7 +37,7 @@ #country- #codes coordinates TZ comments AD +4230+00131 Europe/Andorra -AE,OM,RE,SC,TF +2518+05518 Asia/Dubai Crozet, Scattered Is +AE,OM,RE,SC,TF +2518+05518 Asia/Dubai Crozet AF +3431+06912 Asia/Kabul AL +4120+01950 Europe/Tirane AM +4011+04430 Asia/Yerevan @@ -47,12 +47,13 @@ AQ -6736+06253 Antarctica/Mawson Mawson AQ -6448-06406 Antarctica/Palmer Palmer AQ -6734-06808 Antarctica/Rothera Rothera AQ -720041+0023206 Antarctica/Troll Troll +AQ -7824+10654 Antarctica/Vostok Vostok AR -3436-05827 America/Argentina/Buenos_Aires Buenos Aires (BA, CF) AR -3124-06411 America/Argentina/Cordoba most areas: CB, CC, CN, ER, FM, MN, SE, SF AR -2447-06525 America/Argentina/Salta Salta (SA, LP, NQ, RN) AR -2411-06518 America/Argentina/Jujuy Jujuy (JY) AR -2649-06513 America/Argentina/Tucuman Tucumán (TM) -AR -2828-06547 America/Argentina/Catamarca Catamarca (CT); Chubut (CH) +AR -2828-06547 America/Argentina/Catamarca Catamarca (CT), Chubut (CH) AR -2926-06651 America/Argentina/La_Rioja La Rioja (LR) AR -3132-06831 America/Argentina/San_Juan San Juan (SJ) AR -3253-06849 America/Argentina/Mendoza Mendoza (MZ) @@ -81,7 +82,7 @@ BG +4241+02319 Europe/Sofia BM +3217-06446 Atlantic/Bermuda BO -1630-06809 America/La_Paz BR -0351-03225 America/Noronha Atlantic islands -BR -0127-04829 America/Belem Pará (east); Amapá +BR -0127-04829 America/Belem Pará (east), Amapá BR -0343-03830 America/Fortaleza Brazil (northeast: MA, PI, CE, RN, PB) BR -0803-03454 America/Recife Pernambuco BR -0712-04812 America/Araguaina Tocantins @@ -99,19 +100,19 @@ BR -0958-06748 America/Rio_Branco Acre BT +2728+08939 Asia/Thimphu BY +5354+02734 Europe/Minsk BZ +1730-08812 America/Belize -CA +4734-05243 America/St_Johns Newfoundland; Labrador (southeast) -CA +4439-06336 America/Halifax Atlantic - NS (most areas); PE +CA +4734-05243 America/St_Johns Newfoundland, Labrador (SE) +CA +4439-06336 America/Halifax Atlantic - NS (most areas), PE CA +4612-05957 America/Glace_Bay Atlantic - NS (Cape Breton) CA +4606-06447 America/Moncton Atlantic - New Brunswick CA +5320-06025 America/Goose_Bay Atlantic - Labrador (most areas) -CA,BS +4339-07923 America/Toronto Eastern - ON, QC (most areas) +CA,BS +4339-07923 America/Toronto Eastern - ON & QC (most areas) CA +6344-06828 America/Iqaluit Eastern - NU (most areas) -CA +4953-09709 America/Winnipeg Central - ON (west); Manitoba +CA +4953-09709 America/Winnipeg Central - ON (west), Manitoba CA +744144-0944945 America/Resolute Central - NU (Resolute) CA +624900-0920459 America/Rankin_Inlet Central - NU (central) CA +5024-10439 America/Regina CST - SK (most areas) CA +5017-10750 America/Swift_Current CST - SK (midwest) -CA +5333-11328 America/Edmonton Mountain - AB; BC (E); NT (E); SK (W) +CA +5333-11328 America/Edmonton Mountain - AB, BC(E), NT(E), SK(W) CA +690650-1050310 America/Cambridge_Bay Mountain - NU (west) CA +682059-1334300 America/Inuvik Mountain - NT (west) CA +5546-12014 America/Dawson_Creek MST - BC (Dawson Cr, Ft St John) @@ -126,7 +127,7 @@ CL -3327-07040 America/Santiago most of Chile CL -5309-07055 America/Punta_Arenas Region of Magallanes CL -2709-10926 Pacific/Easter Easter Island CN +3114+12128 Asia/Shanghai Beijing Time -CN,AQ +4348+08735 Asia/Urumqi Xinjiang Time, Vostok +CN +4348+08735 Asia/Urumqi Xinjiang Time CO +0436-07405 America/Bogota CR +0956-08405 America/Costa_Rica CU +2308-08222 America/Havana @@ -171,8 +172,8 @@ HT +1832-07220 America/Port-au-Prince HU +4730+01905 Europe/Budapest ID -0610+10648 Asia/Jakarta Java, Sumatra ID -0002+10920 Asia/Pontianak Borneo (west, central) -ID -0507+11924 Asia/Makassar Borneo (east, south); Sulawesi/Celebes, Bali, Nusa Tengarra; Timor (west) -ID -0232+14042 Asia/Jayapura New Guinea (West Papua / Irian Jaya); Malukus/Moluccas +ID -0507+11924 Asia/Makassar Borneo (east, south), Sulawesi/Celebes, Bali, Nusa Tengarra, Timor (west) +ID -0232+14042 Asia/Jayapura New Guinea (West Papua / Irian Jaya), Malukus/Moluccas IE +5320-00615 Europe/Dublin IL +314650+0351326 Asia/Jerusalem IN +2232+08822 Asia/Kolkata @@ -251,7 +252,7 @@ PK +2452+06703 Asia/Karachi PL +5215+02100 Europe/Warsaw PM +4703-05620 America/Miquelon PN -2504-13005 Pacific/Pitcairn -PR,AG,CA,AI,AW,BL,BQ,CW,DM,GD,GP,KN,LC,MF,MS,SX,TT,VC,VG,VI +182806-0660622 America/Puerto_Rico AST +PR,AG,CA,AI,AW,BL,BQ,CW,DM,GD,GP,KN,LC,MF,MS,SX,TT,VC,VG,VI +182806-0660622 America/Puerto_Rico AST - QC (Lower North Shore) PS +3130+03428 Asia/Gaza Gaza Strip PS +313200+0350542 Asia/Hebron West Bank PT +3843-00908 Europe/Lisbon Portugal (mainland) @@ -287,7 +288,7 @@ RU +4310+13156 Asia/Vladivostok MSK+07 - Amur River RU +643337+1431336 Asia/Ust-Nera MSK+07 - Oymyakonsky RU +5934+15048 Asia/Magadan MSK+08 - Magadan RU +4658+14242 Asia/Sakhalin MSK+08 - Sakhalin Island -RU +6728+15343 Asia/Srednekolymsk MSK+08 - Sakha (E); N Kuril Is +RU +6728+15343 Asia/Srednekolymsk MSK+08 - Sakha (E), N Kuril Is RU +5301+15839 Asia/Kamchatka MSK+09 - Kamchatka RU +6445+17729 Asia/Anadyr MSK+09 - Bering Sea SA,AQ,KW,YE +2438+04643 Asia/Riyadh Syowa @@ -329,7 +330,7 @@ US +470659-1011757 America/North_Dakota/Center Central - ND (Oliver) US +465042-1012439 America/North_Dakota/New_Salem Central - ND (Morton rural) US +471551-1014640 America/North_Dakota/Beulah Central - ND (Mercer) US +394421-1045903 America/Denver Mountain (most areas) -US +433649-1161209 America/Boise Mountain - ID (south); OR (east) +US +433649-1161209 America/Boise Mountain - ID (south), OR (east) US,CA +332654-1120424 America/Phoenix MST - AZ (most areas), Creston BC US +340308-1181434 America/Los_Angeles Pacific US +611305-1495401 America/Anchorage Alaska (most areas) diff --git a/lib/pytz/zoneinfo/zonenow.tab b/lib/pytz/zoneinfo/zonenow.tab new file mode 100644 index 00000000..b6f29109 --- /dev/null +++ b/lib/pytz/zoneinfo/zonenow.tab @@ -0,0 +1,303 @@ +# tzdb timezone descriptions, for users who do not care about old timestamps +# +# This file is in the public domain. +# +# From Paul Eggert (2023-12-18): +# This file contains a table where each row stands for a timezone +# where civil timestamps are predicted to agree from now on. +# This file is like zone1970.tab (see zone1970.tab's coments), +# but with the following changes: +# +# 1. Each timezone corresponds to a set of clocks that are planned +# to agree from now on. This is a larger set of clocks than in +# zone1970.tab, where each timezone's clocks must agree from 1970 on. +# 2. The first column is irrelevant and ignored. +# 3. The table is sorted in a different way: +# first by standard time UTC offset; +# then, if DST is used, by daylight saving UTC offset; +# then by time zone abbreviation. +# 4. Every timezone has a nonempty comments column, with wording +# distinguishing the timezone only from other timezones with the +# same UTC offset at some point during the year. +# +# The format of this table is experimental, and may change in future versions. +# +# This table is intended as an aid for users, to help them select timezones +# appropriate for their practical needs. It is not intended to take or +# endorse any position on legal or territorial claims. +# +#XX coordinates TZ comments +# +# -11 - SST +XX -1416-17042 Pacific/Pago_Pago Midway; Samoa ("SST") +# +# -11 +XX -1901-16955 Pacific/Niue Niue +# +# -10 - HST +XX +211825-1575130 Pacific/Honolulu Hawaii ("HST") +# +# -10 +XX -1732-14934 Pacific/Tahiti Tahiti; Cook Islands +# +# -10/-09 - HST / HDT (North America DST) +XX +515248-1763929 America/Adak western Aleutians in Alaska ("HST/HDT") +# +# -09:30 +XX -0900-13930 Pacific/Marquesas Marquesas +# +# -09 +XX -2308-13457 Pacific/Gambier Gambier +# +# -09/-08 - AKST/AKDT (North America DST) +XX +611305-1495401 America/Anchorage most of Alaska ("AKST/AKDT") +# +# -08 +XX -2504-13005 Pacific/Pitcairn Pitcairn +# +# -08/-07 - PST/PDT (North America DST) +XX +340308-1181434 America/Los_Angeles Pacific ("PST/PDT") - US & Canada; Mexico near US border +# +# -07 - MST +XX +332654-1120424 America/Phoenix Mountain Standard ("MST") - Arizona; western Mexico; Yukon +# +# -07/-06 - MST/MDT (North America DST) +XX +394421-1045903 America/Denver Mountain ("MST/MDT") - US & Canada; Mexico near US border +# +# -06 +XX -0054-08936 Pacific/Galapagos Galápagos +# +# -06 - CST +XX +1924-09909 America/Mexico_City Central Standard ("CST") - Saskatchewan; central Mexico; Central America +# +# -06/-05 (Chile DST) +XX -2709-10926 Pacific/Easter Easter Island +# +# -06/-05 - CST/CDT (North America DST) +XX +415100-0873900 America/Chicago Central ("CST/CDT") - US & Canada; Mexico near US border +# +# -05 +XX -1203-07703 America/Lima eastern South America +# +# -05 - EST +XX +175805-0764736 America/Jamaica Eastern Standard ("EST") - Caymans; Jamaica; eastern Mexico; Panama +# +# -05/-04 - CST/CDT (Cuba DST) +XX +2308-08222 America/Havana Cuba +# +# -05/-04 - EST/EDT (North America DST) +XX +404251-0740023 America/New_York Eastern ("EST/EDT") - US & Canada +# +# -04 +XX +1030-06656 America/Caracas western South America +# +# -04 - AST +XX +1828-06954 America/Santo_Domingo Atlantic Standard ("AST") - eastern Caribbean +# +# -04/-03 (Chile DST) +XX -3327-07040 America/Santiago most of Chile +# +# -04/-03 (Paraguay DST) +XX -2516-05740 America/Asuncion Paraguay +# +# -04/-03 - AST/ADT (North America DST) +XX +4439-06336 America/Halifax Atlantic ("AST/ADT") - Canada; Bermuda +# +# -03:30/-02:30 - NST/NDT (North America DST) +XX +4734-05243 America/St_Johns Newfoundland ("NST/NDT") +# +# -03 +XX -2332-04637 America/Sao_Paulo eastern South America +# +# -03/-02 (North America DST) +XX +4703-05620 America/Miquelon St Pierre & Miquelon +# +# -02 +XX -0351-03225 America/Noronha Fernando de Noronha; South Georgia +# +# -02/-01 (EU DST) +XX +6411-05144 America/Nuuk most of Greenland +# +# -01 +XX +1455-02331 Atlantic/Cape_Verde Cape Verde +# +# -01/+00 (EU DST) +XX +3744-02540 Atlantic/Azores Azores +# -01/+00 (EU DST) until 2024-03-31; then -02/-01 (EU DST) +XX +7029-02158 America/Scoresbysund Ittoqqortoormiit +# +# +00 - GMT +XX +0519-00402 Africa/Abidjan far western Africa; Iceland ("GMT") +# +# +00/+01 - GMT/BST (EU DST) +XX +513030-0000731 Europe/London United Kingdom ("GMT/BST") +# +# +00/+01 - WET/WEST (EU DST) +XX +3843-00908 Europe/Lisbon western Europe ("WET/WEST") +# +# +00/+02 - Troll DST +XX -720041+0023206 Antarctica/Troll Troll Station in Antarctica +# +# +01 - CET +XX +3647+00303 Africa/Algiers Algeria, Tunisia ("CET") +# +# +01 - WAT +XX +0627+00324 Africa/Lagos western Africa ("WAT") +# +# +01/+00 - IST/GMT (EU DST in reverse) +XX +5320-00615 Europe/Dublin Ireland ("IST/GMT") +# +# +01/+00 - (Morocco DST) +XX +3339-00735 Africa/Casablanca Morocco +# +# +01/+02 - CET/CEST (EU DST) +XX +4852+00220 Europe/Paris central Europe ("CET/CEST") +# +# +02 - CAT +XX -2558+03235 Africa/Maputo central Africa ("CAT") +# +# +02 - EET +XX +3254+01311 Africa/Tripoli Libya; Kaliningrad ("EET") +# +# +02 - SAST +XX -2615+02800 Africa/Johannesburg southern Africa ("SAST") +# +# +02/+03 - EET/EEST (EU DST) +XX +3758+02343 Europe/Athens eastern Europe ("EET/EEST") +# +# +02/+03 - EET/EEST (Egypt DST) +XX +3003+03115 Africa/Cairo Egypt +# +# +02/+03 - EET/EEST (Lebanon DST) +XX +3353+03530 Asia/Beirut Lebanon +# +# +02/+03 - EET/EEST (Moldova DST) +XX +4700+02850 Europe/Chisinau Moldova +# +# +02/+03 - EET/EEST (Palestine DST) +XX +3130+03428 Asia/Gaza Palestine +# +# +02/+03 - IST/IDT (Israel DST) +XX +314650+0351326 Asia/Jerusalem Israel +# +# +03 +XX +4101+02858 Europe/Istanbul Near East; Belarus +# +# +03 - EAT +XX -0117+03649 Africa/Nairobi eastern Africa ("EAT") +# +# +03 - MSK +XX +554521+0373704 Europe/Moscow Moscow ("MSK") +# +# +03:30 +XX +3540+05126 Asia/Tehran Iran +# +# +04 +XX +2518+05518 Asia/Dubai Russia; Caucasus; Persian Gulf; Seychelles; Réunion +# +# +04:30 +XX +3431+06912 Asia/Kabul Afghanistan +# +# +05 +XX +4120+06918 Asia/Tashkent Russia; west Kazakhstan; Tajikistan; Turkmenistan; Uzbekistan; Maldives +# +# +05 - PKT +XX +2452+06703 Asia/Karachi Pakistan ("PKT") +# +# +05:30 +XX +0656+07951 Asia/Colombo Sri Lanka +# +# +05:30 - IST +XX +2232+08822 Asia/Kolkata India ("IST") +# +# +05:45 +XX +2743+08519 Asia/Kathmandu Nepal +# +# +06 +XX +2343+09025 Asia/Dhaka Russia; Kyrgyzstan; Bhutan; Bangladesh; Chagos +# +06 until 2024-03-01; then +05 +XX +4315+07657 Asia/Almaty Kazakhstan (except western areas) +# +# +06:30 +XX +1647+09610 Asia/Yangon Myanmar; Cocos +# +# +07 +XX +1345+10031 Asia/Bangkok Russia; Indochina; Christmas Island +# +# +07 - WIB +XX -0610+10648 Asia/Jakarta Indonesia ("WIB") +# +# +08 +XX +0117+10351 Asia/Singapore Russia; Brunei; Malaysia; Singapore +# +# +08 - AWST +XX -3157+11551 Australia/Perth Western Australia ("AWST") +# +# +08 - CST +XX +3114+12128 Asia/Shanghai China ("CST") +# +# +08 - HKT +XX +2217+11409 Asia/Hong_Kong Hong Kong ("HKT") +# +# +08 - PHT +XX +1435+12100 Asia/Manila Philippines ("PHT") +# +# +08 - WITA +XX -0507+11924 Asia/Makassar Indonesia ("WITA") +# +# +08:45 +XX -3143+12852 Australia/Eucla Eucla +# +# +09 +XX +5203+11328 Asia/Chita Russia; Palau; East Timor +# +# +09 - JST +XX +353916+1394441 Asia/Tokyo Japan ("JST") +# +# +09 - KST +XX +3733+12658 Asia/Seoul Korea ("KST") +# +# +09 - WIT +XX -0232+14042 Asia/Jayapura Indonesia ("WIT") +# +# +09:30 - ACST +XX -1228+13050 Australia/Darwin Northern Territory ("ACST") +# +# +09:30/+10:30 - ACST/ACDT (Australia DST) +XX -3455+13835 Australia/Adelaide South Australia ("ACST/ACDT") +# +# +10 +XX +4310+13156 Asia/Vladivostok Russia; Yap; Chuuk; Papua New Guinea; Dumont d'Urville +# +# +10 - AEST +XX -2728+15302 Australia/Brisbane Queensland ("AEST") +# +# +10 - ChST +XX +1328+14445 Pacific/Guam Mariana Islands ("ChST") +# +# +10/+11 - AEST/AEDT (Australia DST) +XX -3352+15113 Australia/Sydney southeast Australia ("AEST/AEDT") +# +# +10:30/+11 +XX -3133+15905 Australia/Lord_Howe Lord Howe Island +# +# +11 +XX -0613+15534 Pacific/Bougainville Russia; Kosrae; Bougainville; Solomons +# +# +11/+12 (Australia DST) +XX -2903+16758 Pacific/Norfolk Norfolk Island +# +# +12 +XX +5301+15839 Asia/Kamchatka Russia; Tuvalu; Fiji; etc. +# +# +12/+13 (New Zealand DST) +XX -3652+17446 Pacific/Auckland New Zealand ("NZST/NZDT") +# +# +12:45/+13:45 (Chatham DST) +XX -4357-17633 Pacific/Chatham Chatham Islands +# +# +13 +XX -210800-1751200 Pacific/Tongatapu Kanton; Tokelau; Samoa (western); Tonga +# +# +14 +XX +0152-15720 Pacific/Kiritimati Kiritimati diff --git a/requirements.txt b/requirements.txt index bdf83410..29f2c784 100644 --- a/requirements.txt +++ b/requirements.txt @@ -35,7 +35,7 @@ PyJWT==2.8.0 pyparsing==3.1.1 python-dateutil==2.8.2 python-twitter==3.5 -pytz==2023.3 +pytz==2024.1 requests==2.31.0 requests-oauthlib==1.3.1 rumps==0.4.0; platform_system == "Darwin" From 4468c3e4af05b2af04ab6241891ed545e7a2890a Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 15:22:16 -0700 Subject: [PATCH 080/290] Bump mako from 1.2.4 to 1.3.2 (#2256) * Bump mako from 1.2.4 to 1.3.2 Bumps [mako](https://github.com/sqlalchemy/mako) from 1.2.4 to 1.3.2. - [Release notes](https://github.com/sqlalchemy/mako/releases) - [Changelog](https://github.com/sqlalchemy/mako/blob/main/CHANGES) - [Commits](https://github.com/sqlalchemy/mako/commits) --- updated-dependencies: - dependency-name: mako dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] * Update mako==1.3.2 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/mako/__init__.py | 4 ++-- lib/mako/_ast_util.py | 2 +- lib/mako/ast.py | 2 +- lib/mako/cache.py | 2 +- lib/mako/cmd.py | 3 +-- lib/mako/codegen.py | 4 +--- lib/mako/compat.py | 10 ++------ lib/mako/exceptions.py | 2 +- lib/mako/ext/autohandler.py | 2 +- lib/mako/ext/babelplugin.py | 2 +- lib/mako/ext/beaker_cache.py | 2 +- lib/mako/ext/extract.py | 2 +- lib/mako/ext/linguaplugin.py | 2 +- lib/mako/ext/preprocessors.py | 2 +- lib/mako/ext/pygmentplugin.py | 2 +- lib/mako/ext/turbogears.py | 2 +- lib/mako/filters.py | 2 +- lib/mako/lexer.py | 20 ++++++++++++---- lib/mako/lookup.py | 3 +-- lib/mako/parsetree.py | 2 +- lib/mako/pygen.py | 2 +- lib/mako/pyparser.py | 5 +--- lib/mako/runtime.py | 2 +- lib/mako/template.py | 3 +-- lib/mako/testing/assertions.py | 1 - lib/mako/testing/helpers.py | 4 ++++ lib/mako/util.py | 2 +- lib/markupsafe/__init__.py | 44 +++++++++++++++++++++++++++------- requirements.txt | 2 +- 29 files changed, 83 insertions(+), 54 deletions(-) diff --git a/lib/mako/__init__.py b/lib/mako/__init__.py index d7339219..d022cf82 100644 --- a/lib/mako/__init__.py +++ b/lib/mako/__init__.py @@ -1,8 +1,8 @@ # mako/__init__.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php -__version__ = "1.2.4" +__version__ = "1.3.2" diff --git a/lib/mako/_ast_util.py b/lib/mako/_ast_util.py index 95742835..63b8f228 100644 --- a/lib/mako/_ast_util.py +++ b/lib/mako/_ast_util.py @@ -1,5 +1,5 @@ # mako/_ast_util.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/ast.py b/lib/mako/ast.py index a3f3ee3e..e59df3eb 100644 --- a/lib/mako/ast.py +++ b/lib/mako/ast.py @@ -1,5 +1,5 @@ # mako/ast.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/cache.py b/lib/mako/cache.py index db21bb3e..bad25257 100644 --- a/lib/mako/cache.py +++ b/lib/mako/cache.py @@ -1,5 +1,5 @@ # mako/cache.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/cmd.py b/lib/mako/cmd.py index 93a6733f..3858a127 100755 --- a/lib/mako/cmd.py +++ b/lib/mako/cmd.py @@ -1,5 +1,5 @@ # mako/cmd.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php @@ -25,7 +25,6 @@ def _exit(): def cmdline(argv=None): - parser = ArgumentParser() parser.add_argument( "--var", diff --git a/lib/mako/codegen.py b/lib/mako/codegen.py index d1d2c20a..ce6f83aa 100644 --- a/lib/mako/codegen.py +++ b/lib/mako/codegen.py @@ -1,5 +1,5 @@ # mako/codegen.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php @@ -816,7 +816,6 @@ class _GenerateRenderMethod: ) or len(self.compiler.default_filters) ): - s = self.create_filter_callable( node.escapes_code.args, "%s" % node.text, True ) @@ -1181,7 +1180,6 @@ class _Identifiers: def visitBlockTag(self, node): if node is not self.node and not node.is_anonymous: - if isinstance(self.node, parsetree.DefTag): raise exceptions.CompileException( "Named block '%s' not allowed inside of def '%s'" diff --git a/lib/mako/compat.py b/lib/mako/compat.py index 48df30d6..18322159 100644 --- a/lib/mako/compat.py +++ b/lib/mako/compat.py @@ -1,17 +1,17 @@ # mako/compat.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php import collections +from importlib import metadata as importlib_metadata from importlib import util import inspect import sys win32 = sys.platform.startswith("win") pypy = hasattr(sys, "pypy_version_info") -py38 = sys.version_info >= (3, 8) ArgSpec = collections.namedtuple( "ArgSpec", ["args", "varargs", "keywords", "defaults"] @@ -62,12 +62,6 @@ def exception_name(exc): return exc.__class__.__name__ -if py38: - from importlib import metadata as importlib_metadata -else: - import importlib_metadata # noqa - - def importlib_metadata_get(group): ep = importlib_metadata.entry_points() if hasattr(ep, "select"): diff --git a/lib/mako/exceptions.py b/lib/mako/exceptions.py index 31c695fd..ca225677 100644 --- a/lib/mako/exceptions.py +++ b/lib/mako/exceptions.py @@ -1,5 +1,5 @@ # mako/exceptions.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/ext/autohandler.py b/lib/mako/ext/autohandler.py index 5bcfc285..dff9b6a8 100644 --- a/lib/mako/ext/autohandler.py +++ b/lib/mako/ext/autohandler.py @@ -1,5 +1,5 @@ # ext/autohandler.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/ext/babelplugin.py b/lib/mako/ext/babelplugin.py index 907d0b80..cdb37cdf 100644 --- a/lib/mako/ext/babelplugin.py +++ b/lib/mako/ext/babelplugin.py @@ -1,5 +1,5 @@ # ext/babelplugin.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/ext/beaker_cache.py b/lib/mako/ext/beaker_cache.py index 9aa35b06..590fbd01 100644 --- a/lib/mako/ext/beaker_cache.py +++ b/lib/mako/ext/beaker_cache.py @@ -1,5 +1,5 @@ # ext/beaker_cache.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/ext/extract.py b/lib/mako/ext/extract.py index 9d33ee18..d03789db 100644 --- a/lib/mako/ext/extract.py +++ b/lib/mako/ext/extract.py @@ -1,5 +1,5 @@ # ext/extract.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/ext/linguaplugin.py b/lib/mako/ext/linguaplugin.py index efb04c70..22077e66 100644 --- a/lib/mako/ext/linguaplugin.py +++ b/lib/mako/ext/linguaplugin.py @@ -1,5 +1,5 @@ # ext/linguaplugin.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/ext/preprocessors.py b/lib/mako/ext/preprocessors.py index 80403ecd..6d1aaf5d 100644 --- a/lib/mako/ext/preprocessors.py +++ b/lib/mako/ext/preprocessors.py @@ -1,5 +1,5 @@ # ext/preprocessors.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/ext/pygmentplugin.py b/lib/mako/ext/pygmentplugin.py index 9acbf4cd..f422623d 100644 --- a/lib/mako/ext/pygmentplugin.py +++ b/lib/mako/ext/pygmentplugin.py @@ -1,5 +1,5 @@ # ext/pygmentplugin.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/ext/turbogears.py b/lib/mako/ext/turbogears.py index 2ebf0746..2a3ec7d7 100644 --- a/lib/mako/ext/turbogears.py +++ b/lib/mako/ext/turbogears.py @@ -1,5 +1,5 @@ # ext/turbogears.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/filters.py b/lib/mako/filters.py index af202f3f..2a4b4386 100644 --- a/lib/mako/filters.py +++ b/lib/mako/filters.py @@ -1,5 +1,5 @@ # mako/filters.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/lexer.py b/lib/mako/lexer.py index 75182f85..9d1f5f30 100644 --- a/lib/mako/lexer.py +++ b/lib/mako/lexer.py @@ -1,5 +1,5 @@ # mako/lexer.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php @@ -247,6 +247,8 @@ class Lexer: continue if self.match_python_block(): continue + if self.match_percent(): + continue if self.match_text(): continue @@ -352,14 +354,24 @@ class Lexer: else: return True + def match_percent(self): + match = self.match(r"(?<=^)(\s*)%%(%*)", re.M) + if match: + self.append_node( + parsetree.Text, match.group(1) + "%" + match.group(2) + ) + return True + else: + return False + def match_text(self): match = self.match( r""" (.*?) # anything, followed by: ( - (?<=\n)(?=[ \t]*(?=%|\#\#)) # an eval or line-based - # comment preceded by a - # consumed newline and whitespace + (?<=\n)(?=[ \t]*(?=%|\#\#)) # an eval or line-based + # comment, preceded by a + # consumed newline and whitespace | (?=\${) # an expression | diff --git a/lib/mako/lookup.py b/lib/mako/lookup.py index f7410ce3..d916db77 100644 --- a/lib/mako/lookup.py +++ b/lib/mako/lookup.py @@ -1,5 +1,5 @@ # mako/lookup.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php @@ -178,7 +178,6 @@ class TemplateLookup(TemplateCollection): lexer_cls=None, include_error_handler=None, ): - self.directories = [ posixpath.normpath(d) for d in util.to_list(directories, ()) ] diff --git a/lib/mako/parsetree.py b/lib/mako/parsetree.py index c5a12d1d..04686ece 100644 --- a/lib/mako/parsetree.py +++ b/lib/mako/parsetree.py @@ -1,5 +1,5 @@ # mako/parsetree.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/pygen.py b/lib/mako/pygen.py index 57c69793..820e101d 100644 --- a/lib/mako/pygen.py +++ b/lib/mako/pygen.py @@ -1,5 +1,5 @@ # mako/pygen.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/mako/pyparser.py b/lib/mako/pyparser.py index d9b090c6..9b63dc33 100644 --- a/lib/mako/pyparser.py +++ b/lib/mako/pyparser.py @@ -1,5 +1,5 @@ # mako/pyparser.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php @@ -64,7 +64,6 @@ class FindIdentifiers(_ast_util.NodeVisitor): self._add_declared(node.name) def visit_Assign(self, node): - # flip around the visiting of Assign so the expression gets # evaluated first, in the case of a clause like "x=x+5" (x # is undeclared) @@ -99,7 +98,6 @@ class FindIdentifiers(_ast_util.NodeVisitor): yield arg def _visit_function(self, node, islambda): - # push function state onto stack. dont log any more # identifiers as "declared" until outside of the function, # but keep logging identifiers as "undeclared". track @@ -122,7 +120,6 @@ class FindIdentifiers(_ast_util.NodeVisitor): self.local_ident_stack = local_ident_stack def visit_For(self, node): - # flip around visit self.visit(node.iter) diff --git a/lib/mako/runtime.py b/lib/mako/runtime.py index 6d7fa684..23401b70 100644 --- a/lib/mako/runtime.py +++ b/lib/mako/runtime.py @@ -530,7 +530,7 @@ class Namespace: def _populate(self, d, l): for ident in l: if ident == "*": - for (k, v) in self._get_star(): + for k, v in self._get_star(): d[k] = v else: d[ident] = getattr(self, ident) diff --git a/lib/mako/template.py b/lib/mako/template.py index 8c70731d..e2771727 100644 --- a/lib/mako/template.py +++ b/lib/mako/template.py @@ -1,5 +1,5 @@ # mako/template.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php @@ -26,7 +26,6 @@ from mako.lexer import Lexer class Template: - r"""Represents a compiled template. :class:`.Template` includes a reference to the original diff --git a/lib/mako/testing/assertions.py b/lib/mako/testing/assertions.py index 14ea6352..22221cd2 100644 --- a/lib/mako/testing/assertions.py +++ b/lib/mako/testing/assertions.py @@ -103,7 +103,6 @@ def _assert_raises( check_context=False, cause_cls=None, ): - with _expect_raises(except_cls, msg, check_context, cause_cls) as ec: callable_(*args, **kwargs) return ec.error diff --git a/lib/mako/testing/helpers.py b/lib/mako/testing/helpers.py index 77cca367..5ae9d38d 100644 --- a/lib/mako/testing/helpers.py +++ b/lib/mako/testing/helpers.py @@ -19,6 +19,10 @@ def result_lines(result): ] +def result_raw_lines(result): + return [x for x in re.split(r"\r?\n", result) if x.strip() != ""] + + def make_path( filespec: Union[Path, str], make_absolute: bool = True, diff --git a/lib/mako/util.py b/lib/mako/util.py index 5fb683b4..91188cac 100644 --- a/lib/mako/util.py +++ b/lib/mako/util.py @@ -1,5 +1,5 @@ # mako/util.py -# Copyright 2006-2022 the Mako authors and contributors +# Copyright 2006-2024 the Mako authors and contributors # # This module is part of Mako and is released under # the MIT License: http://www.opensource.org/licenses/mit-license.php diff --git a/lib/markupsafe/__init__.py b/lib/markupsafe/__init__.py index 21d31960..b40f24c6 100644 --- a/lib/markupsafe/__init__.py +++ b/lib/markupsafe/__init__.py @@ -1,5 +1,4 @@ import functools -import re import string import sys import typing as t @@ -14,10 +13,7 @@ if t.TYPE_CHECKING: _P = te.ParamSpec("_P") -__version__ = "2.1.3" - -_strip_comments_re = re.compile(r"", re.DOTALL) -_strip_tags_re = re.compile(r"<.*?>", re.DOTALL) +__version__ = "2.1.5" def _simple_escaping_wrapper(func: "t.Callable[_P, str]") -> "t.Callable[_P, Markup]": @@ -162,9 +158,41 @@ class Markup(str): >>> Markup("Main »\tAbout").striptags() 'Main » About' """ - # Use two regexes to avoid ambiguous matches. - value = _strip_comments_re.sub("", self) - value = _strip_tags_re.sub("", value) + value = str(self) + + # Look for comments then tags separately. Otherwise, a comment that + # contains a tag would end early, leaving some of the comment behind. + + while True: + # keep finding comment start marks + start = value.find("", start) + + if end == -1: + break + + value = f"{value[:start]}{value[end + 3:]}" + + # remove tags using the same method + while True: + start = value.find("<") + + if start == -1: + break + + end = value.find(">", start) + + if end == -1: + break + + value = f"{value[:start]}{value[end + 1:]}" + + # collapse spaces value = " ".join(value.split()) return self.__class__(value).unescape() diff --git a/requirements.txt b/requirements.txt index 29f2c784..32bd430e 100644 --- a/requirements.txt +++ b/requirements.txt @@ -22,7 +22,7 @@ importlib-metadata==6.8.0 importlib-resources==6.0.1 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois IPy==1.01 -Mako==1.2.4 +Mako==1.3.2 MarkupSafe==2.1.3 musicbrainzngs==0.7.1 packaging==23.1 From a4cfc6323da91472eb70cbb32a1dde21e0373271 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 15:23:15 -0700 Subject: [PATCH 081/290] Bump certifi from 2023.7.22 to 2024.2.2 (#2257) * Bump certifi from 2023.7.22 to 2024.2.2 Bumps [certifi](https://github.com/certifi/python-certifi) from 2023.7.22 to 2024.2.2. - [Commits](https://github.com/certifi/python-certifi/compare/2023.07.22...2024.02.02) --- updated-dependencies: - dependency-name: certifi dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] * Update certifi==2024.2.2 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/certifi/__init__.py | 2 +- lib/certifi/cacert.pem | 321 +++++++++++++++++++++++++++++++--------- lib/certifi/core.py | 6 + requirements.txt | 2 +- 4 files changed, 258 insertions(+), 73 deletions(-) diff --git a/lib/certifi/__init__.py b/lib/certifi/__init__.py index 8ce89cef..1c91f3ec 100644 --- a/lib/certifi/__init__.py +++ b/lib/certifi/__init__.py @@ -1,4 +1,4 @@ from .core import contents, where __all__ = ["contents", "where"] -__version__ = "2023.07.22" +__version__ = "2024.02.02" diff --git a/lib/certifi/cacert.pem b/lib/certifi/cacert.pem index 02123695..fac3c319 100644 --- a/lib/certifi/cacert.pem +++ b/lib/certifi/cacert.pem @@ -245,34 +245,6 @@ mJlglFwjz1onl14LBQaTNx47aTbrqZ5hHY8y2o4M1nQ+ewkk2gF3R8Q7zTSMmfXK 4SVhM7JZG+Ju1zdXtg2pEto= -----END CERTIFICATE----- -# Issuer: O=SECOM Trust.net OU=Security Communication RootCA1 -# Subject: O=SECOM Trust.net OU=Security Communication RootCA1 -# Label: "Security Communication Root CA" -# Serial: 0 -# MD5 Fingerprint: f1:bc:63:6a:54:e0:b5:27:f5:cd:e7:1a:e3:4d:6e:4a -# SHA1 Fingerprint: 36:b1:2b:49:f9:81:9e:d7:4c:9e:bc:38:0f:c6:56:8f:5d:ac:b2:f7 -# SHA256 Fingerprint: e7:5e:72:ed:9f:56:0e:ec:6e:b4:80:00:73:a4:3f:c3:ad:19:19:5a:39:22:82:01:78:95:97:4a:99:02:6b:6c ------BEGIN CERTIFICATE----- -MIIDWjCCAkKgAwIBAgIBADANBgkqhkiG9w0BAQUFADBQMQswCQYDVQQGEwJKUDEY -MBYGA1UEChMPU0VDT00gVHJ1c3QubmV0MScwJQYDVQQLEx5TZWN1cml0eSBDb21t -dW5pY2F0aW9uIFJvb3RDQTEwHhcNMDMwOTMwMDQyMDQ5WhcNMjMwOTMwMDQyMDQ5 -WjBQMQswCQYDVQQGEwJKUDEYMBYGA1UEChMPU0VDT00gVHJ1c3QubmV0MScwJQYD -VQQLEx5TZWN1cml0eSBDb21tdW5pY2F0aW9uIFJvb3RDQTEwggEiMA0GCSqGSIb3 -DQEBAQUAA4IBDwAwggEKAoIBAQCzs/5/022x7xZ8V6UMbXaKL0u/ZPtM7orw8yl8 -9f/uKuDp6bpbZCKamm8sOiZpUQWZJtzVHGpxxpp9Hp3dfGzGjGdnSj74cbAZJ6kJ -DKaVv0uMDPpVmDvY6CKhS3E4eayXkmmziX7qIWgGmBSWh9JhNrxtJ1aeV+7AwFb9 -Ms+k2Y7CI9eNqPPYJayX5HA49LY6tJ07lyZDo6G8SVlyTCMwhwFY9k6+HGhWZq/N -QV3Is00qVUarH9oe4kA92819uZKAnDfdDJZkndwi92SL32HeFZRSFaB9UslLqCHJ -xrHty8OVYNEP8Ktw+N/LTX7s1vqr2b1/VPKl6Xn62dZ2JChzAgMBAAGjPzA9MB0G -A1UdDgQWBBSgc0mZaNyFW2XjmygvV5+9M7wHSDALBgNVHQ8EBAMCAQYwDwYDVR0T -AQH/BAUwAwEB/zANBgkqhkiG9w0BAQUFAAOCAQEAaECpqLvkT115swW1F7NgE+vG -kl3g0dNq/vu+m22/xwVtWSDEHPC32oRYAmP6SBbvT6UL90qY8j+eG61Ha2POCEfr -Uj94nK9NrvjVT8+amCoQQTlSxN3Zmw7vkwGusi7KaEIkQmywszo+zenaSMQVy+n5 -Bw+SUEmK3TGXX8npN6o7WWWXlDLJs58+OmJYxUmtYg5xpTKqL8aJdkNAExNnPaJU -JRDL8Try2frbSVa7pv6nQTXD4IhhyYjH3zYQIphZ6rBK+1YWc26sTfcioU+tHXot -RSflMMFe8toTyyVCUZVHA4xsIcx0Qu1T/zOLjw9XARYvz6buyXAiFL39vmwLAw== ------END CERTIFICATE----- - # Issuer: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com # Subject: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com # Label: "XRamp Global CA Root" @@ -881,49 +853,6 @@ Mx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7rkpeDMdmztcpH WD9f -----END CERTIFICATE----- -# Issuer: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068 -# Subject: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068 -# Label: "Autoridad de Certificacion Firmaprofesional CIF A62634068" -# Serial: 6047274297262753887 -# MD5 Fingerprint: 73:3a:74:7a:ec:bb:a3:96:a6:c2:e4:e2:c8:9b:c0:c3 -# SHA1 Fingerprint: ae:c5:fb:3f:c8:e1:bf:c4:e5:4f:03:07:5a:9a:e8:00:b7:f7:b6:fa -# SHA256 Fingerprint: 04:04:80:28:bf:1f:28:64:d4:8f:9a:d4:d8:32:94:36:6a:82:88:56:55:3f:3b:14:30:3f:90:14:7f:5d:40:ef ------BEGIN CERTIFICATE----- -MIIGFDCCA/ygAwIBAgIIU+w77vuySF8wDQYJKoZIhvcNAQEFBQAwUTELMAkGA1UE -BhMCRVMxQjBABgNVBAMMOUF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uIEZpcm1h -cHJvZmVzaW9uYWwgQ0lGIEE2MjYzNDA2ODAeFw0wOTA1MjAwODM4MTVaFw0zMDEy -MzEwODM4MTVaMFExCzAJBgNVBAYTAkVTMUIwQAYDVQQDDDlBdXRvcmlkYWQgZGUg -Q2VydGlmaWNhY2lvbiBGaXJtYXByb2Zlc2lvbmFsIENJRiBBNjI2MzQwNjgwggIi -MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKlmuO6vj78aI14H9M2uDDUtd9 -thDIAl6zQyrET2qyyhxdKJp4ERppWVevtSBC5IsP5t9bpgOSL/UR5GLXMnE42QQM -cas9UX4PB99jBVzpv5RvwSmCwLTaUbDBPLutN0pcyvFLNg4kq7/DhHf9qFD0sefG -L9ItWY16Ck6WaVICqjaY7Pz6FIMMNx/Jkjd/14Et5cS54D40/mf0PmbR0/RAz15i -NA9wBj4gGFrO93IbJWyTdBSTo3OxDqqHECNZXyAFGUftaI6SEspd/NYrspI8IM/h -X68gvqB2f3bl7BqGYTM+53u0P6APjqK5am+5hyZvQWyIplD9amML9ZMWGxmPsu2b -m8mQ9QEM3xk9Dz44I8kvjwzRAv4bVdZO0I08r0+k8/6vKtMFnXkIoctXMbScyJCy -Z/QYFpM6/EfY0XiWMR+6KwxfXZmtY4laJCB22N/9q06mIqqdXuYnin1oKaPnirja -EbsXLZmdEyRG98Xi2J+Of8ePdG1asuhy9azuJBCtLxTa/y2aRnFHvkLfuwHb9H/T -KI8xWVvTyQKmtFLKbpf7Q8UIJm+K9Lv9nyiqDdVF8xM6HdjAeI9BZzwelGSuewvF -6NkBiDkal4ZkQdU7hwxu+g/GvUgUvzlN1J5Bto+WHWOWk9mVBngxaJ43BjuAiUVh -OSPHG0SjFeUc+JIwuwIDAQABo4HvMIHsMBIGA1UdEwEB/wQIMAYBAf8CAQEwDgYD -VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBRlzeurNR4APn7VdMActHNHDhpkLzCBpgYD -VR0gBIGeMIGbMIGYBgRVHSAAMIGPMC8GCCsGAQUFBwIBFiNodHRwOi8vd3d3LmZp -cm1hcHJvZmVzaW9uYWwuY29tL2NwczBcBggrBgEFBQcCAjBQHk4AUABhAHMAZQBv -ACAAZABlACAAbABhACAAQgBvAG4AYQBuAG8AdgBhACAANAA3ACAAQgBhAHIAYwBl -AGwAbwBuAGEAIAAwADgAMAAxADcwDQYJKoZIhvcNAQEFBQADggIBABd9oPm03cXF -661LJLWhAqvdpYhKsg9VSytXjDvlMd3+xDLx51tkljYyGOylMnfX40S2wBEqgLk9 -am58m9Ot/MPWo+ZkKXzR4Tgegiv/J2Wv+xYVxC5xhOW1//qkR71kMrv2JYSiJ0L1 -ILDCExARzRAVukKQKtJE4ZYm6zFIEv0q2skGz3QeqUvVhyj5eTSSPi5E6PaPT481 -PyWzOdxjKpBrIF/EUhJOlywqrJ2X3kjyo2bbwtKDlaZmp54lD+kLM5FlClrD2VQS -3a/DTg4fJl4N3LON7NWBcN7STyQF82xO9UxJZo3R/9ILJUFI/lGExkKvgATP0H5k -SeTy36LssUzAKh3ntLFlosS88Zj0qnAHY7S42jtM+kAiMFsRpvAFDsYCA0irhpuF -3dvd6qJ2gHN99ZwExEWN57kci57q13XRcrHedUTnQn3iV2t93Jm8PYMo6oCTjcVM -ZcFwgbg4/EMxsvYDNEeyrPsiBsse3RdHHF9mudMaotoRsaS8I8nkvof/uZS2+F0g -StRf571oe2XyFR7SOqkt6dhrJKyXWERHrVkY8SFlcN7ONGCoQPHzPKTDKCOM/icz -Q0CgFzzr6juwcqajuUpLXhZI9LK8yIySxZ2frHI2vDSANGupi5LAuBft7HZT9SQB -jLMi6Et8Vcad+qMUu2WFbm5PEn4KPJ2V ------END CERTIFICATE----- - # Issuer: CN=Izenpe.com O=IZENPE S.A. # Subject: CN=Izenpe.com O=IZENPE S.A. # Label: "Izenpe.com" @@ -4633,3 +4562,253 @@ o7Ey7Nmj1m+UI/87tyll5gfp77YZ6ufCOB0yiJA8EytuzO+rdwY0d4RPcuSBhPm5 dDTedk+SKlOxJTnbPP/lPqYO5Wue/9vsL3SD3460s6neFE3/MaNFcyT6lSnMEpcE oji2jbDwN/zIIX8/syQbPYtuzE2wFg2WHYMfRsCbvUOZ58SWLs5fyQ== -----END CERTIFICATE----- + +# Issuer: CN=TrustAsia Global Root CA G3 O=TrustAsia Technologies, Inc. +# Subject: CN=TrustAsia Global Root CA G3 O=TrustAsia Technologies, Inc. +# Label: "TrustAsia Global Root CA G3" +# Serial: 576386314500428537169965010905813481816650257167 +# MD5 Fingerprint: 30:42:1b:b7:bb:81:75:35:e4:16:4f:53:d2:94:de:04 +# SHA1 Fingerprint: 63:cf:b6:c1:27:2b:56:e4:88:8e:1c:23:9a:b6:2e:81:47:24:c3:c7 +# SHA256 Fingerprint: e0:d3:22:6a:eb:11:63:c2:e4:8f:f9:be:3b:50:b4:c6:43:1b:e7:bb:1e:ac:c5:c3:6b:5d:5e:c5:09:03:9a:08 +-----BEGIN CERTIFICATE----- +MIIFpTCCA42gAwIBAgIUZPYOZXdhaqs7tOqFhLuxibhxkw8wDQYJKoZIhvcNAQEM +BQAwWjELMAkGA1UEBhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dp +ZXMsIEluYy4xJDAiBgNVBAMMG1RydXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHMzAe +Fw0yMTA1MjAwMjEwMTlaFw00NjA1MTkwMjEwMTlaMFoxCzAJBgNVBAYTAkNOMSUw +IwYDVQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMuMSQwIgYDVQQDDBtU +cnVzdEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzMwggIiMA0GCSqGSIb3DQEBAQUAA4IC +DwAwggIKAoICAQDAMYJhkuSUGwoqZdC+BqmHO1ES6nBBruL7dOoKjbmzTNyPtxNS +T1QY4SxzlZHFZjtqz6xjbYdT8PfxObegQ2OwxANdV6nnRM7EoYNl9lA+sX4WuDqK +AtCWHwDNBSHvBm3dIZwZQ0WhxeiAysKtQGIXBsaqvPPW5vxQfmZCHzyLpnl5hkA1 +nyDvP+uLRx+PjsXUjrYsyUQE49RDdT/VP68czH5GX6zfZBCK70bwkPAPLfSIC7Ep +qq+FqklYqL9joDiR5rPmd2jE+SoZhLsO4fWvieylL1AgdB4SQXMeJNnKziyhWTXA +yB1GJ2Faj/lN03J5Zh6fFZAhLf3ti1ZwA0pJPn9pMRJpxx5cynoTi+jm9WAPzJMs +hH/x/Gr8m0ed262IPfN2dTPXS6TIi/n1Q1hPy8gDVI+lhXgEGvNz8teHHUGf59gX +zhqcD0r83ERoVGjiQTz+LISGNzzNPy+i2+f3VANfWdP3kXjHi3dqFuVJhZBFcnAv +kV34PmVACxmZySYgWmjBNb9Pp1Hx2BErW+Canig7CjoKH8GB5S7wprlppYiU5msT +f9FkPz2ccEblooV7WIQn3MSAPmeamseaMQ4w7OYXQJXZRe0Blqq/DPNL0WP3E1jA +uPP6Z92bfW1K/zJMtSU7/xxnD4UiWQWRkUF3gdCFTIcQcf+eQxuulXUtgQIDAQAB +o2MwYTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFEDk5PIj7zjKsK5Xf/Ih +MBY027ySMB0GA1UdDgQWBBRA5OTyI+84yrCuV3/yITAWNNu8kjAOBgNVHQ8BAf8E +BAMCAQYwDQYJKoZIhvcNAQEMBQADggIBACY7UeFNOPMyGLS0XuFlXsSUT9SnYaP4 +wM8zAQLpw6o1D/GUE3d3NZ4tVlFEbuHGLige/9rsR82XRBf34EzC4Xx8MnpmyFq2 +XFNFV1pF1AWZLy4jVe5jaN/TG3inEpQGAHUNcoTpLrxaatXeL1nHo+zSh2bbt1S1 +JKv0Q3jbSwTEb93mPmY+KfJLaHEih6D4sTNjduMNhXJEIlU/HHzp/LgV6FL6qj6j +ITk1dImmasI5+njPtqzn59ZW/yOSLlALqbUHM/Q4X6RJpstlcHboCoWASzY9M/eV +VHUl2qzEc4Jl6VL1XP04lQJqaTDFHApXB64ipCz5xUG3uOyfT0gA+QEEVcys+TIx +xHWVBqB/0Y0n3bOppHKH/lmLmnp0Ft0WpWIp6zqW3IunaFnT63eROfjXy9mPX1on +AX1daBli2MjN9LdyR75bl87yraKZk62Uy5P2EgmVtqvXO9A/EcswFi55gORngS1d +7XB4tmBZrOFdRWOPyN9yaFvqHbgB8X7754qz41SgOAngPN5C8sLtLpvzHzW2Ntjj +gKGLzZlkD8Kqq7HK9W+eQ42EVJmzbsASZthwEPEGNTNDqJwuuhQxzhB/HIbjj9LV ++Hfsm6vxL2PZQl/gZ4FkkfGXL/xuJvYz+NO1+MRiqzFRJQJ6+N1rZdVtTTDIZbpo +FGWsJwt0ivKH +-----END CERTIFICATE----- + +# Issuer: CN=TrustAsia Global Root CA G4 O=TrustAsia Technologies, Inc. +# Subject: CN=TrustAsia Global Root CA G4 O=TrustAsia Technologies, Inc. +# Label: "TrustAsia Global Root CA G4" +# Serial: 451799571007117016466790293371524403291602933463 +# MD5 Fingerprint: 54:dd:b2:d7:5f:d8:3e:ed:7c:e0:0b:2e:cc:ed:eb:eb +# SHA1 Fingerprint: 57:73:a5:61:5d:80:b2:e6:ac:38:82:fc:68:07:31:ac:9f:b5:92:5a +# SHA256 Fingerprint: be:4b:56:cb:50:56:c0:13:6a:52:6d:f4:44:50:8d:aa:36:a0:b5:4f:42:e4:ac:38:f7:2a:f4:70:e4:79:65:4c +-----BEGIN CERTIFICATE----- +MIICVTCCAdygAwIBAgIUTyNkuI6XY57GU4HBdk7LKnQV1tcwCgYIKoZIzj0EAwMw +WjELMAkGA1UEBhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dpZXMs +IEluYy4xJDAiBgNVBAMMG1RydXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHNDAeFw0y +MTA1MjAwMjEwMjJaFw00NjA1MTkwMjEwMjJaMFoxCzAJBgNVBAYTAkNOMSUwIwYD +VQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMuMSQwIgYDVQQDDBtUcnVz +dEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzQwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAATx +s8045CVD5d4ZCbuBeaIVXxVjAd7Cq92zphtnS4CDr5nLrBfbK5bKfFJV4hrhPVbw +LxYI+hW8m7tH5j/uqOFMjPXTNvk4XatwmkcN4oFBButJ+bAp3TPsUKV/eSm4IJij +YzBhMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUpbtKl86zK3+kMd6Xg1mD +pm9xy94wHQYDVR0OBBYEFKW7SpfOsyt/pDHel4NZg6ZvccveMA4GA1UdDwEB/wQE +AwIBBjAKBggqhkjOPQQDAwNnADBkAjBe8usGzEkxn0AAbbd+NvBNEU/zy4k6LHiR +UKNbwMp1JvK/kF0LgoxgKJ/GcJpo5PECMFxYDlZ2z1jD1xCMuo6u47xkdUfFVZDj +/bpV6wfEU6s3qe4hsiFbYI89MvHVI5TWWA== +-----END CERTIFICATE----- + +# Issuer: CN=CommScope Public Trust ECC Root-01 O=CommScope +# Subject: CN=CommScope Public Trust ECC Root-01 O=CommScope +# Label: "CommScope Public Trust ECC Root-01" +# Serial: 385011430473757362783587124273108818652468453534 +# MD5 Fingerprint: 3a:40:a7:fc:03:8c:9c:38:79:2f:3a:a2:6c:b6:0a:16 +# SHA1 Fingerprint: 07:86:c0:d8:dd:8e:c0:80:98:06:98:d0:58:7a:ef:de:a6:cc:a2:5d +# SHA256 Fingerprint: 11:43:7c:da:7b:b4:5e:41:36:5f:45:b3:9a:38:98:6b:0d:e0:0d:ef:34:8e:0c:7b:b0:87:36:33:80:0b:c3:8b +-----BEGIN CERTIFICATE----- +MIICHTCCAaOgAwIBAgIUQ3CCd89NXTTxyq4yLzf39H91oJ4wCgYIKoZIzj0EAwMw +TjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29t +bVNjb3BlIFB1YmxpYyBUcnVzdCBFQ0MgUm9vdC0wMTAeFw0yMTA0MjgxNzM1NDNa +Fw00NjA0MjgxNzM1NDJaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21tU2Nv +cGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgRUNDIFJvb3QtMDEw +djAQBgcqhkjOPQIBBgUrgQQAIgNiAARLNumuV16ocNfQj3Rid8NeeqrltqLxeP0C +flfdkXmcbLlSiFS8LwS+uM32ENEp7LXQoMPwiXAZu1FlxUOcw5tjnSCDPgYLpkJE +hRGnSjot6dZoL0hOUysHP029uax3OVejQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYD +VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBSOB2LAUN3GGQYARnQE9/OufXVNMDAKBggq +hkjOPQQDAwNoADBlAjEAnDPfQeMjqEI2Jpc1XHvr20v4qotzVRVcrHgpD7oh2MSg +2NED3W3ROT3Ek2DS43KyAjB8xX6I01D1HiXo+k515liWpDVfG2XqYZpwI7UNo5uS +Um9poIyNStDuiw7LR47QjRE= +-----END CERTIFICATE----- + +# Issuer: CN=CommScope Public Trust ECC Root-02 O=CommScope +# Subject: CN=CommScope Public Trust ECC Root-02 O=CommScope +# Label: "CommScope Public Trust ECC Root-02" +# Serial: 234015080301808452132356021271193974922492992893 +# MD5 Fingerprint: 59:b0:44:d5:65:4d:b8:5c:55:19:92:02:b6:d1:94:b2 +# SHA1 Fingerprint: 3c:3f:ef:57:0f:fe:65:93:86:9e:a0:fe:b0:f6:ed:8e:d1:13:c7:e5 +# SHA256 Fingerprint: 2f:fb:7f:81:3b:bb:b3:c8:9a:b4:e8:16:2d:0f:16:d7:15:09:a8:30:cc:9d:73:c2:62:e5:14:08:75:d1:ad:4a +-----BEGIN CERTIFICATE----- +MIICHDCCAaOgAwIBAgIUKP2ZYEFHpgE6yhR7H+/5aAiDXX0wCgYIKoZIzj0EAwMw +TjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29t +bVNjb3BlIFB1YmxpYyBUcnVzdCBFQ0MgUm9vdC0wMjAeFw0yMTA0MjgxNzQ0NTRa +Fw00NjA0MjgxNzQ0NTNaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21tU2Nv +cGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgRUNDIFJvb3QtMDIw +djAQBgcqhkjOPQIBBgUrgQQAIgNiAAR4MIHoYx7l63FRD/cHB8o5mXxO1Q/MMDAL +j2aTPs+9xYa9+bG3tD60B8jzljHz7aRP+KNOjSkVWLjVb3/ubCK1sK9IRQq9qEmU +v4RDsNuESgMjGWdqb8FuvAY5N9GIIvejQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYD +VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBTmGHX/72DehKT1RsfeSlXjMjZ59TAKBggq +hkjOPQQDAwNnADBkAjAmc0l6tqvmSfR9Uj/UQQSugEODZXW5hYA4O9Zv5JOGq4/n +ich/m35rChJVYaoR4HkCMHfoMXGsPHED1oQmHhS48zs73u1Z/GtMMH9ZzkXpc2AV +mkzw5l4lIhVtwodZ0LKOag== +-----END CERTIFICATE----- + +# Issuer: CN=CommScope Public Trust RSA Root-01 O=CommScope +# Subject: CN=CommScope Public Trust RSA Root-01 O=CommScope +# Label: "CommScope Public Trust RSA Root-01" +# Serial: 354030733275608256394402989253558293562031411421 +# MD5 Fingerprint: 0e:b4:15:bc:87:63:5d:5d:02:73:d4:26:38:68:73:d8 +# SHA1 Fingerprint: 6d:0a:5f:f7:b4:23:06:b4:85:b3:b7:97:64:fc:ac:75:f5:33:f2:93 +# SHA256 Fingerprint: 02:bd:f9:6e:2a:45:dd:9b:f1:8f:c7:e1:db:df:21:a0:37:9b:a3:c9:c2:61:03:44:cf:d8:d6:06:fe:c1:ed:81 +-----BEGIN CERTIFICATE----- +MIIFbDCCA1SgAwIBAgIUPgNJgXUWdDGOTKvVxZAplsU5EN0wDQYJKoZIhvcNAQEL +BQAwTjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwi +Q29tbVNjb3BlIFB1YmxpYyBUcnVzdCBSU0EgUm9vdC0wMTAeFw0yMTA0MjgxNjQ1 +NTRaFw00NjA0MjgxNjQ1NTNaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21t +U2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgUlNBIFJvb3Qt +MDEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCwSGWjDR1C45FtnYSk +YZYSwu3D2iM0GXb26v1VWvZVAVMP8syMl0+5UMuzAURWlv2bKOx7dAvnQmtVzslh +suitQDy6uUEKBU8bJoWPQ7VAtYXR1HHcg0Hz9kXHgKKEUJdGzqAMxGBWBB0HW0al +DrJLpA6lfO741GIDuZNqihS4cPgugkY4Iw50x2tBt9Apo52AsH53k2NC+zSDO3Oj +WiE260f6GBfZumbCk6SP/F2krfxQapWsvCQz0b2If4b19bJzKo98rwjyGpg/qYFl +P8GMicWWMJoKz/TUyDTtnS+8jTiGU+6Xn6myY5QXjQ/cZip8UlF1y5mO6D1cv547 +KI2DAg+pn3LiLCuz3GaXAEDQpFSOm117RTYm1nJD68/A6g3czhLmfTifBSeolz7p +UcZsBSjBAg/pGG3svZwG1KdJ9FQFa2ww8esD1eo9anbCyxooSU1/ZOD6K9pzg4H/ +kQO9lLvkuI6cMmPNn7togbGEW682v3fuHX/3SZtS7NJ3Wn2RnU3COS3kuoL4b/JO +Hg9O5j9ZpSPcPYeoKFgo0fEbNttPxP/hjFtyjMcmAyejOQoBqsCyMWCDIqFPEgkB +Ea801M/XrmLTBQe0MXXgDW1XT2mH+VepuhX2yFJtocucH+X8eKg1mp9BFM6ltM6U +CBwJrVbl2rZJmkrqYxhTnCwuwwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4G +A1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUN12mmnQywsL5x6YVEFm45P3luG0wDQYJ +KoZIhvcNAQELBQADggIBAK+nz97/4L1CjU3lIpbfaOp9TSp90K09FlxD533Ahuh6 +NWPxzIHIxgvoLlI1pKZJkGNRrDSsBTtXAOnTYtPZKdVUvhwQkZyybf5Z/Xn36lbQ +nmhUQo8mUuJM3y+Xpi/SB5io82BdS5pYV4jvguX6r2yBS5KPQJqTRlnLX3gWsWc+ +QgvfKNmwrZggvkN80V4aCRckjXtdlemrwWCrWxhkgPut4AZ9HcpZuPN4KWfGVh2v +trV0KnahP/t1MJ+UXjulYPPLXAziDslg+MkfFoom3ecnf+slpoq9uC02EJqxWE2a +aE9gVOX2RhOOiKy8IUISrcZKiX2bwdgt6ZYD9KJ0DLwAHb/WNyVntHKLr4W96ioD +j8z7PEQkguIBpQtZtjSNMgsSDesnwv1B10A8ckYpwIzqug/xBpMu95yo9GA+o/E4 +Xo4TwbM6l4c/ksp4qRyv0LAbJh6+cOx69TOY6lz/KwsETkPdY34Op054A5U+1C0w +lREQKC6/oAI+/15Z0wUOlV9TRe9rh9VIzRamloPh37MG88EU26fsHItdkJANclHn +YfkUyq+Dj7+vsQpZXdxc1+SWrVtgHdqul7I52Qb1dgAT+GhMIbA1xNxVssnBQVoc +icCMb3SgazNNtQEo/a2tiRc7ppqEvOuM6sRxJKi6KfkIsidWNTJf6jn7MZrVGczw +-----END CERTIFICATE----- + +# Issuer: CN=CommScope Public Trust RSA Root-02 O=CommScope +# Subject: CN=CommScope Public Trust RSA Root-02 O=CommScope +# Label: "CommScope Public Trust RSA Root-02" +# Serial: 480062499834624527752716769107743131258796508494 +# MD5 Fingerprint: e1:29:f9:62:7b:76:e2:96:6d:f3:d4:d7:0f:ae:1f:aa +# SHA1 Fingerprint: ea:b0:e2:52:1b:89:93:4c:11:68:f2:d8:9a:ac:22:4c:a3:8a:57:ae +# SHA256 Fingerprint: ff:e9:43:d7:93:42:4b:4f:7c:44:0c:1c:3d:64:8d:53:63:f3:4b:82:dc:87:aa:7a:9f:11:8f:c5:de:e1:01:f1 +-----BEGIN CERTIFICATE----- +MIIFbDCCA1SgAwIBAgIUVBa/O345lXGN0aoApYYNK496BU4wDQYJKoZIhvcNAQEL +BQAwTjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwi +Q29tbVNjb3BlIFB1YmxpYyBUcnVzdCBSU0EgUm9vdC0wMjAeFw0yMTA0MjgxNzE2 +NDNaFw00NjA0MjgxNzE2NDJaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21t +U2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgUlNBIFJvb3Qt +MDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDh+g77aAASyE3VrCLE +NQE7xVTlWXZjpX/rwcRqmL0yjReA61260WI9JSMZNRTpf4mnG2I81lDnNJUDMrG0 +kyI9p+Kx7eZ7Ti6Hmw0zdQreqjXnfuU2mKKuJZ6VszKWpCtYHu8//mI0SFHRtI1C +rWDaSWqVcN3SAOLMV2MCe5bdSZdbkk6V0/nLKR8YSvgBKtJjCW4k6YnS5cciTNxz +hkcAqg2Ijq6FfUrpuzNPDlJwnZXjfG2WWy09X6GDRl224yW4fKcZgBzqZUPckXk2 +LHR88mcGyYnJ27/aaL8j7dxrrSiDeS/sOKUNNwFnJ5rpM9kzXzehxfCrPfp4sOcs +n/Y+n2Dg70jpkEUeBVF4GiwSLFworA2iI540jwXmojPOEXcT1A6kHkIfhs1w/tku +FT0du7jyU1fbzMZ0KZwYszZ1OC4PVKH4kh+Jlk+71O6d6Ts2QrUKOyrUZHk2EOH5 +kQMreyBUzQ0ZGshBMjTRsJnhkB4BQDa1t/qp5Xd1pCKBXbCL5CcSD1SIxtuFdOa3 +wNemKfrb3vOTlycEVS8KbzfFPROvCgCpLIscgSjX74Yxqa7ybrjKaixUR9gqiC6v +wQcQeKwRoi9C8DfF8rhW3Q5iLc4tVn5V8qdE9isy9COoR+jUKgF4z2rDN6ieZdIs +5fq6M8EGRPbmz6UNp2YINIos8wIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4G +A1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUR9DnsSL/nSz12Vdgs7GxcJXvYXowDQYJ +KoZIhvcNAQELBQADggIBAIZpsU0v6Z9PIpNojuQhmaPORVMbc0RTAIFhzTHjCLqB +KCh6krm2qMhDnscTJk3C2OVVnJJdUNjCK9v+5qiXz1I6JMNlZFxHMaNlNRPDk7n3 ++VGXu6TwYofF1gbTl4MgqX67tiHCpQ2EAOHyJxCDut0DgdXdaMNmEMjRdrSzbyme +APnCKfWxkxlSaRosTKCL4BWaMS/TiJVZbuXEs1DIFAhKm4sTg7GkcrI7djNB3Nyq +pgdvHSQSn8h2vS/ZjvQs7rfSOBAkNlEv41xdgSGn2rtO/+YHqP65DSdsu3BaVXoT +6fEqSWnHX4dXTEN5bTpl6TBcQe7rd6VzEojov32u5cSoHw2OHG1QAk8mGEPej1WF +sQs3BWDJVTkSBKEqz3EWnzZRSb9wO55nnPt7eck5HHisd5FUmrh1CoFSl+NmYWvt +PjgelmFV4ZFUjO2MJB+ByRCac5krFk5yAD9UG/iNuovnFNa2RU9g7Jauwy8CTl2d +lklyALKrdVwPaFsdZcJfMw8eD/A7hvWwTruc9+olBdytoptLFwG+Qt81IR2tq670 +v64fG9PiO/yzcnMcmyiQiRM9HcEARwmWmjgb3bHPDcK0RPOWlc4yOo80nOAXx17O +rg3bhzjlP1v9mxnhMUF6cKojawHhRUzNlM47ni3niAIi9G7oyOzWPPO5std3eqx7 +-----END CERTIFICATE----- + +# Issuer: CN=Telekom Security TLS ECC Root 2020 O=Deutsche Telekom Security GmbH +# Subject: CN=Telekom Security TLS ECC Root 2020 O=Deutsche Telekom Security GmbH +# Label: "Telekom Security TLS ECC Root 2020" +# Serial: 72082518505882327255703894282316633856 +# MD5 Fingerprint: c1:ab:fe:6a:10:2c:03:8d:bc:1c:22:32:c0:85:a7:fd +# SHA1 Fingerprint: c0:f8:96:c5:a9:3b:01:06:21:07:da:18:42:48:bc:e9:9d:88:d5:ec +# SHA256 Fingerprint: 57:8a:f4:de:d0:85:3f:4e:59:98:db:4a:ea:f9:cb:ea:8d:94:5f:60:b6:20:a3:8d:1a:3c:13:b2:bc:7b:a8:e1 +-----BEGIN CERTIFICATE----- +MIICQjCCAcmgAwIBAgIQNjqWjMlcsljN0AFdxeVXADAKBggqhkjOPQQDAzBjMQsw +CQYDVQQGEwJERTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0eSBH +bWJIMSswKQYDVQQDDCJUZWxla29tIFNlY3VyaXR5IFRMUyBFQ0MgUm9vdCAyMDIw +MB4XDTIwMDgyNTA3NDgyMFoXDTQ1MDgyNTIzNTk1OVowYzELMAkGA1UEBhMCREUx +JzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJpdHkgR21iSDErMCkGA1UE +AwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgRUNDIFJvb3QgMjAyMDB2MBAGByqGSM49 +AgEGBSuBBAAiA2IABM6//leov9Wq9xCazbzREaK9Z0LMkOsVGJDZos0MKiXrPk/O +tdKPD/M12kOLAoC+b1EkHQ9rK8qfwm9QMuU3ILYg/4gND21Ju9sGpIeQkpT0CdDP +f8iAC8GXs7s1J8nCG6NCMEAwHQYDVR0OBBYEFONyzG6VmUex5rNhTNHLq+O6zd6f +MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMAoGCCqGSM49BAMDA2cA +MGQCMHVSi7ekEE+uShCLsoRbQuHmKjYC2qBuGT8lv9pZMo7k+5Dck2TOrbRBR2Di +z6fLHgIwN0GMZt9Ba9aDAEH9L1r3ULRn0SyocddDypwnJJGDSA3PzfdUga/sf+Rn +27iQ7t0l +-----END CERTIFICATE----- + +# Issuer: CN=Telekom Security TLS RSA Root 2023 O=Deutsche Telekom Security GmbH +# Subject: CN=Telekom Security TLS RSA Root 2023 O=Deutsche Telekom Security GmbH +# Label: "Telekom Security TLS RSA Root 2023" +# Serial: 44676229530606711399881795178081572759 +# MD5 Fingerprint: bf:5b:eb:54:40:cd:48:71:c4:20:8d:7d:de:0a:42:f2 +# SHA1 Fingerprint: 54:d3:ac:b3:bd:57:56:f6:85:9d:ce:e5:c3:21:e2:d4:ad:83:d0:93 +# SHA256 Fingerprint: ef:c6:5c:ad:bb:59:ad:b6:ef:e8:4d:a2:23:11:b3:56:24:b7:1b:3b:1e:a0:da:8b:66:55:17:4e:c8:97:86:46 +-----BEGIN CERTIFICATE----- +MIIFszCCA5ugAwIBAgIQIZxULej27HF3+k7ow3BXlzANBgkqhkiG9w0BAQwFADBj +MQswCQYDVQQGEwJERTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0 +eSBHbWJIMSswKQYDVQQDDCJUZWxla29tIFNlY3VyaXR5IFRMUyBSU0EgUm9vdCAy +MDIzMB4XDTIzMDMyODEyMTY0NVoXDTQ4MDMyNzIzNTk1OVowYzELMAkGA1UEBhMC +REUxJzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJpdHkgR21iSDErMCkG +A1UEAwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgUlNBIFJvb3QgMjAyMzCCAiIwDQYJ +KoZIhvcNAQEBBQADggIPADCCAgoCggIBAO01oYGA88tKaVvC+1GDrib94W7zgRJ9 +cUD/h3VCKSHtgVIs3xLBGYSJwb3FKNXVS2xE1kzbB5ZKVXrKNoIENqil/Cf2SfHV +cp6R+SPWcHu79ZvB7JPPGeplfohwoHP89v+1VmLhc2o0mD6CuKyVU/QBoCcHcqMA +U6DksquDOFczJZSfvkgdmOGjup5czQRxUX11eKvzWarE4GC+j4NSuHUaQTXtvPM6 +Y+mpFEXX5lLRbtLevOP1Czvm4MS9Q2QTps70mDdsipWol8hHD/BeEIvnHRz+sTug +BTNoBUGCwQMrAcjnj02r6LX2zWtEtefdi+zqJbQAIldNsLGyMcEWzv/9FIS3R/qy +8XDe24tsNlikfLMR0cN3f1+2JeANxdKz+bi4d9s3cXFH42AYTyS2dTd4uaNir73J +co4vzLuu2+QVUhkHM/tqty1LkCiCc/4YizWN26cEar7qwU02OxY2kTLvtkCJkUPg +8qKrBC7m8kwOFjQgrIfBLX7JZkcXFBGk8/ehJImr2BrIoVyxo/eMbcgByU/J7MT8 +rFEz0ciD0cmfHdRHNCk+y7AO+oMLKFjlKdw/fKifybYKu6boRhYPluV75Gp6SG12 +mAWl3G0eQh5C2hrgUve1g8Aae3g1LDj1H/1Joy7SWWO/gLCMk3PLNaaZlSJhZQNg ++y+TS/qanIA7AgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUtqeX +gj10hZv3PJ+TmpV5dVKMbUcwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBS2 +p5eCPXSFm/c8n5OalXl1UoxtRzANBgkqhkiG9w0BAQwFAAOCAgEAqMxhpr51nhVQ +pGv7qHBFfLp+sVr8WyP6Cnf4mHGCDG3gXkaqk/QeoMPhk9tLrbKmXauw1GLLXrtm +9S3ul0A8Yute1hTWjOKWi0FpkzXmuZlrYrShF2Y0pmtjxrlO8iLpWA1WQdH6DErw +M807u20hOq6OcrXDSvvpfeWxm4bu4uB9tPcy/SKE8YXJN3nptT+/XOR0so8RYgDd +GGah2XsjX/GO1WfoVNpbOms2b/mBsTNHM3dA+VKq3dSDz4V4mZqTuXNnQkYRIer+ +CqkbGmVps4+uFrb2S1ayLfmlyOw7YqPta9BO1UAJpB+Y1zqlklkg5LB9zVtzaL1t +xKITDmcZuI1CfmwMmm6gJC3VRRvcxAIU/oVbZZfKTpBQCHpCNfnqwmbU+AGuHrS+ +w6jv/naaoqYfRvaE7fzbzsQCzndILIyy7MMAo+wsVRjBfhnu4S/yrYObnqsZ38aK +L4x35bcF7DvB7L6Gs4a8wPfc5+pbrrLMtTWGS9DiP7bY+A4A7l3j941Y/8+LN+lj +X273CXE2whJdV/LItM3z7gLfEdxquVeEHVlNjM7IDiPCtyaaEBRx/pOyiriA8A4Q +ntOoUAw3gi/q4Iqd4Sw5/7W0cwDk90imc6y/st53BIe0o82bNSQ3+pCTE4FCxpgm +dTdmQRCsu/WU48IxK63nI1bMNSWSs1A= +-----END CERTIFICATE----- diff --git a/lib/certifi/core.py b/lib/certifi/core.py index de028981..91f538bb 100644 --- a/lib/certifi/core.py +++ b/lib/certifi/core.py @@ -5,6 +5,10 @@ certifi.py This module returns the installation location of cacert.pem or its contents. """ import sys +import atexit + +def exit_cacert_ctx() -> None: + _CACERT_CTX.__exit__(None, None, None) # type: ignore[union-attr] if sys.version_info >= (3, 11): @@ -35,6 +39,7 @@ if sys.version_info >= (3, 11): # we will also store that at the global level as well. _CACERT_CTX = as_file(files("certifi").joinpath("cacert.pem")) _CACERT_PATH = str(_CACERT_CTX.__enter__()) + atexit.register(exit_cacert_ctx) return _CACERT_PATH @@ -70,6 +75,7 @@ elif sys.version_info >= (3, 7): # we will also store that at the global level as well. _CACERT_CTX = get_path("certifi", "cacert.pem") _CACERT_PATH = str(_CACERT_CTX.__enter__()) + atexit.register(exit_cacert_ctx) return _CACERT_PATH diff --git a/requirements.txt b/requirements.txt index 32bd430e..53efa2e8 100644 --- a/requirements.txt +++ b/requirements.txt @@ -5,7 +5,7 @@ backports.functools-lru-cache==1.6.6 backports.zoneinfo==0.2.1;python_version<"3.9" beautifulsoup4==4.12.2 bleach==6.1.0 -certifi==2023.7.22 +certifi==2024.2.2 cheroot==10.0.0 cherrypy==18.8.0 cloudinary==1.34.0 From 13eb0fd6dbd2fe3efc108b3363979ad3e4b2d66d Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 15:23:44 -0700 Subject: [PATCH 082/290] Bump platformdirs from 3.11.0 to 4.2.0 (#2258) * Bump platformdirs from 3.11.0 to 4.2.0 Bumps [platformdirs](https://github.com/platformdirs/platformdirs) from 3.11.0 to 4.2.0. - [Release notes](https://github.com/platformdirs/platformdirs/releases) - [Changelog](https://github.com/platformdirs/platformdirs/blob/main/CHANGES.rst) - [Commits](https://github.com/platformdirs/platformdirs/compare/3.11.0...4.2.0) --- updated-dependencies: - dependency-name: platformdirs dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] * Update platformdirs==4.2.0 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/platformdirs/__init__.py | 7 ++-- lib/platformdirs/__main__.py | 1 + lib/platformdirs/android.py | 1 + lib/platformdirs/api.py | 48 ++++++++++++++++++++++---- lib/platformdirs/macos.py | 1 + lib/platformdirs/unix.py | 65 +++++++++++++++++++++++------------- lib/platformdirs/version.py | 4 +-- lib/platformdirs/windows.py | 1 + requirements.txt | 2 +- 9 files changed, 93 insertions(+), 37 deletions(-) diff --git a/lib/platformdirs/__init__.py b/lib/platformdirs/__init__.py index 3d5a5bda..75c8bff9 100644 --- a/lib/platformdirs/__init__.py +++ b/lib/platformdirs/__init__.py @@ -2,6 +2,7 @@ Utilities for determining application-specific dirs. See for details and usage. """ + from __future__ import annotations import os @@ -14,11 +15,7 @@ from .version import __version_tuple__ as __version_info__ if TYPE_CHECKING: from pathlib import Path - - if sys.version_info >= (3, 8): # pragma: no cover (py38+) - from typing import Literal - else: # pragma: no cover (py38+) - from typing_extensions import Literal + from typing import Literal def _set_platform_dir_class() -> type[PlatformDirsABC]: diff --git a/lib/platformdirs/__main__.py b/lib/platformdirs/__main__.py index 3cefedbd..4bf27c9c 100644 --- a/lib/platformdirs/__main__.py +++ b/lib/platformdirs/__main__.py @@ -1,4 +1,5 @@ """Main entry point.""" + from __future__ import annotations from platformdirs import PlatformDirs, __version__ diff --git a/lib/platformdirs/android.py b/lib/platformdirs/android.py index 572559f8..4acdb638 100644 --- a/lib/platformdirs/android.py +++ b/lib/platformdirs/android.py @@ -1,4 +1,5 @@ """Android.""" + from __future__ import annotations import os diff --git a/lib/platformdirs/api.py b/lib/platformdirs/api.py index aa9ce7b9..031a38a3 100644 --- a/lib/platformdirs/api.py +++ b/lib/platformdirs/api.py @@ -1,4 +1,5 @@ """Base API.""" + from __future__ import annotations import os @@ -7,12 +8,7 @@ from pathlib import Path from typing import TYPE_CHECKING if TYPE_CHECKING: - import sys - - if sys.version_info >= (3, 8): # pragma: no cover (py38+) - from typing import Literal - else: # pragma: no cover (py38+) - from typing_extensions import Literal + from typing import Iterator, Literal class PlatformDirsABC(ABC): @@ -241,3 +237,43 @@ class PlatformDirsABC(ABC): def site_runtime_path(self) -> Path: """:return: runtime path shared by users""" return Path(self.site_runtime_dir) + + def iter_config_dirs(self) -> Iterator[str]: + """:yield: all user and site configuration directories.""" + yield self.user_config_dir + yield self.site_config_dir + + def iter_data_dirs(self) -> Iterator[str]: + """:yield: all user and site data directories.""" + yield self.user_data_dir + yield self.site_data_dir + + def iter_cache_dirs(self) -> Iterator[str]: + """:yield: all user and site cache directories.""" + yield self.user_cache_dir + yield self.site_cache_dir + + def iter_runtime_dirs(self) -> Iterator[str]: + """:yield: all user and site runtime directories.""" + yield self.user_runtime_dir + yield self.site_runtime_dir + + def iter_config_paths(self) -> Iterator[Path]: + """:yield: all user and site configuration paths.""" + for path in self.iter_config_dirs(): + yield Path(path) + + def iter_data_paths(self) -> Iterator[Path]: + """:yield: all user and site data paths.""" + for path in self.iter_data_dirs(): + yield Path(path) + + def iter_cache_paths(self) -> Iterator[Path]: + """:yield: all user and site cache paths.""" + for path in self.iter_cache_dirs(): + yield Path(path) + + def iter_runtime_paths(self) -> Iterator[Path]: + """:yield: all user and site runtime paths.""" + for path in self.iter_runtime_dirs(): + yield Path(path) diff --git a/lib/platformdirs/macos.py b/lib/platformdirs/macos.py index c01ce163..b7b48808 100644 --- a/lib/platformdirs/macos.py +++ b/lib/platformdirs/macos.py @@ -1,4 +1,5 @@ """macOS.""" + from __future__ import annotations import os.path diff --git a/lib/platformdirs/unix.py b/lib/platformdirs/unix.py index 1d0174f2..ca4728e6 100644 --- a/lib/platformdirs/unix.py +++ b/lib/platformdirs/unix.py @@ -1,10 +1,12 @@ """Unix.""" + from __future__ import annotations import os import sys from configparser import ConfigParser from pathlib import Path +from typing import Iterator from .api import PlatformDirsABC @@ -43,24 +45,24 @@ class Unix(PlatformDirsABC): return self._append_app_name_and_version(path) @property - def site_data_dir(self) -> str: - """ - :return: data directories shared by users (if `multipath ` is - enabled and ``XDG_DATA_DIR`` is set and a multi path the response is also a multi path separated by the OS - path separator), e.g. ``/usr/local/share/$appname/$version`` or ``/usr/share/$appname/$version`` - """ - # XDG default for $XDG_DATA_DIRS; only first, if multipath is False + def _site_data_dirs(self) -> list[str]: path = os.environ.get("XDG_DATA_DIRS", "") if not path.strip(): path = f"/usr/local/share{os.pathsep}/usr/share" - return self._with_multi_path(path) + return [self._append_app_name_and_version(p) for p in path.split(os.pathsep)] - def _with_multi_path(self, path: str) -> str: - path_list = path.split(os.pathsep) + @property + def site_data_dir(self) -> str: + """ + :return: data directories shared by users (if `multipath ` is + enabled and ``XDG_DATA_DIRS`` is set and a multi path the response is also a multi path separated by the + OS path separator), e.g. ``/usr/local/share/$appname/$version`` or ``/usr/share/$appname/$version`` + """ + # XDG default for $XDG_DATA_DIRS; only first, if multipath is False + dirs = self._site_data_dirs if not self.multipath: - path_list = path_list[0:1] - path_list = [self._append_app_name_and_version(os.path.expanduser(p)) for p in path_list] # noqa: PTH111 - return os.pathsep.join(path_list) + return dirs[0] + return os.pathsep.join(dirs) @property def user_config_dir(self) -> str: @@ -74,17 +76,24 @@ class Unix(PlatformDirsABC): return self._append_app_name_and_version(path) @property - def site_config_dir(self) -> str: - """ - :return: config directories shared by users (if `multipath ` - is enabled and ``XDG_DATA_DIR`` is set and a multi path the response is also a multi path separated by the OS - path separator), e.g. ``/etc/xdg/$appname/$version`` - """ - # XDG default for $XDG_CONFIG_DIRS only first, if multipath is False + def _site_config_dirs(self) -> list[str]: path = os.environ.get("XDG_CONFIG_DIRS", "") if not path.strip(): path = "/etc/xdg" - return self._with_multi_path(path) + return [self._append_app_name_and_version(p) for p in path.split(os.pathsep)] + + @property + def site_config_dir(self) -> str: + """ + :return: config directories shared by users (if `multipath ` + is enabled and ``XDG_CONFIG_DIRS`` is set and a multi path the response is also a multi path separated by + the OS path separator), e.g. ``/etc/xdg/$appname/$version`` + """ + # XDG default for $XDG_CONFIG_DIRS only first, if multipath is False + dirs = self._site_config_dirs + if not self.multipath: + return dirs[0] + return os.pathsep.join(dirs) @property def user_cache_dir(self) -> str: @@ -99,8 +108,8 @@ class Unix(PlatformDirsABC): @property def site_cache_dir(self) -> str: - """:return: cache directory shared by users, e.g. ``/var/tmp/$appname/$version``""" - return self._append_app_name_and_version("/var/tmp") # noqa: S108 + """:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``""" + return self._append_app_name_and_version("/var/cache") @property def user_state_dir(self) -> str: @@ -215,6 +224,16 @@ class Unix(PlatformDirsABC): directory = directory.split(os.pathsep)[0] return Path(directory) + def iter_config_dirs(self) -> Iterator[str]: + """:yield: all user and site configuration directories.""" + yield self.user_config_dir + yield from self._site_config_dirs + + def iter_data_dirs(self) -> Iterator[str]: + """:yield: all user and site data directories.""" + yield self.user_data_dir + yield from self._site_data_dirs + def _get_user_media_dir(env_var: str, fallback_tilde_path: str) -> str: media_dir = _get_user_dirs_folder(env_var) diff --git a/lib/platformdirs/version.py b/lib/platformdirs/version.py index c2ef2084..cc1e3456 100644 --- a/lib/platformdirs/version.py +++ b/lib/platformdirs/version.py @@ -12,5 +12,5 @@ __version__: str __version_tuple__: VERSION_TUPLE version_tuple: VERSION_TUPLE -__version__ = version = '3.11.0' -__version_tuple__ = version_tuple = (3, 11, 0) +__version__ = version = '4.2.0' +__version_tuple__ = version_tuple = (4, 2, 0) diff --git a/lib/platformdirs/windows.py b/lib/platformdirs/windows.py index 751143ad..c62d0c8d 100644 --- a/lib/platformdirs/windows.py +++ b/lib/platformdirs/windows.py @@ -1,4 +1,5 @@ """Windows.""" + from __future__ import annotations import ctypes diff --git a/requirements.txt b/requirements.txt index 53efa2e8..a1f27d23 100644 --- a/requirements.txt +++ b/requirements.txt @@ -27,7 +27,7 @@ MarkupSafe==2.1.3 musicbrainzngs==0.7.1 packaging==23.1 paho-mqtt==1.6.1 -platformdirs==3.11.0 +platformdirs==4.2.0 plexapi==4.15.10 portend==3.2.0 profilehooks==1.12.0 From b7836102a9323bb740559ba2e8ee590e543b8a7c Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 15:24:05 -0700 Subject: [PATCH 083/290] Bump backports-functools-lru-cache from 1.6.6 to 2.0.0 (#2263) * Bump backports-functools-lru-cache from 1.6.6 to 2.0.0 Bumps [backports-functools-lru-cache](https://github.com/jaraco/backports.functools_lru_cache) from 1.6.6 to 2.0.0. - [Release notes](https://github.com/jaraco/backports.functools_lru_cache/releases) - [Changelog](https://github.com/jaraco/backports.functools_lru_cache/blob/main/NEWS.rst) - [Commits](https://github.com/jaraco/backports.functools_lru_cache/compare/v1.6.6...v2.0.0) --- updated-dependencies: - dependency-name: backports-functools-lru-cache dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] * Update backports-functools-lru-cache==2.0.0 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/backports/functools_lru_cache.py | 274 ++++++++++++++++----------- requirements.txt | 2 +- 2 files changed, 162 insertions(+), 114 deletions(-) diff --git a/lib/backports/functools_lru_cache.py b/lib/backports/functools_lru_cache.py index 1b83fe99..e372cff3 100644 --- a/lib/backports/functools_lru_cache.py +++ b/lib/backports/functools_lru_cache.py @@ -26,6 +26,12 @@ def update_wrapper( class _HashedSeq(list): + """This class guarantees that hash() will be called no more than once + per element. This is important because the lru_cache() will hash + the key multiple times on a cache miss. + + """ + __slots__ = 'hashvalue' def __init__(self, tup, hash=hash): @@ -41,45 +47,57 @@ def _make_key( kwds, typed, kwd_mark=(object(),), - fasttypes=set([int, str, frozenset, type(None)]), - sorted=sorted, + fasttypes={int, str}, tuple=tuple, type=type, len=len, ): - 'Make a cache key from optionally typed positional and keyword arguments' + """Make a cache key from optionally typed positional and keyword arguments + + The key is constructed in a way that is flat as possible rather than + as a nested structure that would take more memory. + + If there is only a single argument and its data type is known to cache + its hash value, then that argument is returned without a wrapper. This + saves space and improves lookup speed. + + """ + # All of code below relies on kwds preserving the order input by the user. + # Formerly, we sorted() the kwds before looping. The new way is *much* + # faster; however, it means that f(x=1, y=2) will now be treated as a + # distinct call from f(y=2, x=1) which will be cached separately. key = args if kwds: - sorted_items = sorted(kwds.items()) key += kwd_mark - for item in sorted_items: + for item in kwds.items(): key += item if typed: key += tuple(type(v) for v in args) if kwds: - key += tuple(type(v) for k, v in sorted_items) + key += tuple(type(v) for v in kwds.values()) elif len(key) == 1 and type(key[0]) in fasttypes: return key[0] return _HashedSeq(key) -def lru_cache(maxsize=100, typed=False): # noqa: C901 +def lru_cache(maxsize=128, typed=False): """Least-recently-used cache decorator. If *maxsize* is set to None, the LRU features are disabled and the cache can grow without bound. If *typed* is True, arguments of different types will be cached separately. - For example, f(3.0) and f(3) will be treated as distinct calls with - distinct results. + For example, f(decimal.Decimal("3.0")) and f(3.0) will be treated as + distinct calls with distinct results. Some types such as str and int may + be cached separately even when typed is false. Arguments to the cached function must be hashable. - View the cache statistics named tuple (hits, misses, maxsize, currsize) with - f.cache_info(). Clear the cache and statistics with f.cache_clear(). + View the cache statistics named tuple (hits, misses, maxsize, currsize) + with f.cache_info(). Clear the cache and statistics with f.cache_clear(). Access the underlying function with f.__wrapped__. - See: http://en.wikipedia.org/wiki/Cache_algorithms#Least_Recently_Used + See: https://en.wikipedia.org/wiki/Cache_replacement_policies#Least_recently_used_(LRU) """ @@ -88,108 +106,138 @@ def lru_cache(maxsize=100, typed=False): # noqa: C901 # The internals of the lru_cache are encapsulated for thread safety and # to allow the implementation to change (including a possible C version). + if isinstance(maxsize, int): + # Negative maxsize is treated as 0 + if maxsize < 0: + maxsize = 0 + elif callable(maxsize) and isinstance(typed, bool): + # The user_function was passed in directly via the maxsize argument + user_function, maxsize = maxsize, 128 + wrapper = _lru_cache_wrapper(user_function, maxsize, typed, _CacheInfo) + wrapper.cache_parameters = lambda: {'maxsize': maxsize, 'typed': typed} + return update_wrapper(wrapper, user_function) + elif maxsize is not None: + raise TypeError('Expected first argument to be an integer, a callable, or None') + def decorating_function(user_function): - cache = dict() - stats = [0, 0] # make statistics updateable non-locally - HITS, MISSES = 0, 1 # names for the stats fields - make_key = _make_key - cache_get = cache.get # bound method to lookup key or return None - _len = len # localize the global len() function - lock = RLock() # because linkedlist updates aren't threadsafe - root = [] # root of the circular doubly linked list - root[:] = [root, root, None, None] # initialize by pointing to self - nonlocal_root = [root] # make updateable non-locally - PREV, NEXT, KEY, RESULT = 0, 1, 2, 3 # names for the link fields - - if maxsize == 0: - - def wrapper(*args, **kwds): - # no caching, just do a statistics update after a successful call - result = user_function(*args, **kwds) - stats[MISSES] += 1 - return result - - elif maxsize is None: - - def wrapper(*args, **kwds): - # simple caching without ordering or size limit - key = make_key(args, kwds, typed) - result = cache_get( - key, root - ) # root used here as a unique not-found sentinel - if result is not root: - stats[HITS] += 1 - return result - result = user_function(*args, **kwds) - cache[key] = result - stats[MISSES] += 1 - return result - - else: - - def wrapper(*args, **kwds): - # size limited caching that tracks accesses by recency - key = make_key(args, kwds, typed) if kwds or typed else args - with lock: - link = cache_get(key) - if link is not None: - # record recent use of the key by moving it - # to the front of the list - (root,) = nonlocal_root - link_prev, link_next, key, result = link - link_prev[NEXT] = link_next - link_next[PREV] = link_prev - last = root[PREV] - last[NEXT] = root[PREV] = link - link[PREV] = last - link[NEXT] = root - stats[HITS] += 1 - return result - result = user_function(*args, **kwds) - with lock: - (root,) = nonlocal_root - if key in cache: - # getting here means that this same key was added to the - # cache while the lock was released. since the link - # update is already done, we need only return the - # computed result and update the count of misses. - pass - elif _len(cache) >= maxsize: - # use the old root to store the new key and result - oldroot = root - oldroot[KEY] = key - oldroot[RESULT] = result - # empty the oldest link and make it the new root - root = nonlocal_root[0] = oldroot[NEXT] - oldkey = root[KEY] - root[KEY] = root[RESULT] = None - # now update the cache dictionary for the new links - del cache[oldkey] - cache[key] = oldroot - else: - # put result in a new link at the front of the list - last = root[PREV] - link = [last, root, key, result] - last[NEXT] = root[PREV] = cache[key] = link - stats[MISSES] += 1 - return result - - def cache_info(): - """Report cache statistics""" - with lock: - return _CacheInfo(stats[HITS], stats[MISSES], maxsize, len(cache)) - - def cache_clear(): - """Clear the cache and cache statistics""" - with lock: - cache.clear() - root = nonlocal_root[0] - root[:] = [root, root, None, None] - stats[:] = [0, 0] - - wrapper.__wrapped__ = user_function - wrapper.cache_info = cache_info - wrapper.cache_clear = cache_clear + wrapper = _lru_cache_wrapper(user_function, maxsize, typed, _CacheInfo) + wrapper.cache_parameters = lambda: {'maxsize': maxsize, 'typed': typed} return update_wrapper(wrapper, user_function) return decorating_function + + +def _lru_cache_wrapper(user_function, maxsize, typed, _CacheInfo): + # Constants shared by all lru cache instances: + sentinel = object() # unique object used to signal cache misses + make_key = _make_key # build a key from the function arguments + PREV, NEXT, KEY, RESULT = 0, 1, 2, 3 # names for the link fields + + cache = {} + hits = misses = 0 + full = False + cache_get = cache.get # bound method to lookup a key or return None + cache_len = cache.__len__ # get cache size without calling len() + lock = RLock() # because linkedlist updates aren't threadsafe + root = [] # root of the circular doubly linked list + root[:] = [root, root, None, None] # initialize by pointing to self + + if maxsize == 0: + + def wrapper(*args, **kwds): + # No caching -- just a statistics update + nonlocal misses + misses += 1 + result = user_function(*args, **kwds) + return result + + elif maxsize is None: + + def wrapper(*args, **kwds): + # Simple caching without ordering or size limit + nonlocal hits, misses + key = make_key(args, kwds, typed) + result = cache_get(key, sentinel) + if result is not sentinel: + hits += 1 + return result + misses += 1 + result = user_function(*args, **kwds) + cache[key] = result + return result + + else: + + def wrapper(*args, **kwds): + # Size limited caching that tracks accesses by recency + nonlocal root, hits, misses, full + key = make_key(args, kwds, typed) + with lock: + link = cache_get(key) + if link is not None: + # Move the link to the front of the circular queue + link_prev, link_next, _key, result = link + link_prev[NEXT] = link_next + link_next[PREV] = link_prev + last = root[PREV] + last[NEXT] = root[PREV] = link + link[PREV] = last + link[NEXT] = root + hits += 1 + return result + misses += 1 + result = user_function(*args, **kwds) + with lock: + if key in cache: + # Getting here means that this same key was added to the + # cache while the lock was released. Since the link + # update is already done, we need only return the + # computed result and update the count of misses. + pass + elif full: + # Use the old root to store the new key and result. + oldroot = root + oldroot[KEY] = key + oldroot[RESULT] = result + # Empty the oldest link and make it the new root. + # Keep a reference to the old key and old result to + # prevent their ref counts from going to zero during the + # update. That will prevent potentially arbitrary object + # clean-up code (i.e. __del__) from running while we're + # still adjusting the links. + root = oldroot[NEXT] + oldkey = root[KEY] + root[KEY] = root[RESULT] = None + # Now update the cache dictionary. + del cache[oldkey] + # Save the potentially reentrant cache[key] assignment + # for last, after the root and links have been put in + # a consistent state. + cache[key] = oldroot + else: + # Put result in a new link at the front of the queue. + last = root[PREV] + link = [last, root, key, result] + last[NEXT] = root[PREV] = cache[key] = link + # Use the cache_len bound method instead of the len() function + # which could potentially be wrapped in an lru_cache itself. + full = cache_len() >= maxsize + return result + + def cache_info(): + """Report cache statistics""" + with lock: + return _CacheInfo(hits, misses, maxsize, cache_len()) + + def cache_clear(): + """Clear the cache and cache statistics""" + nonlocal hits, misses, full + with lock: + cache.clear() + root[:] = [root, root, None, None] + hits = misses = 0 + full = False + + wrapper.cache_info = cache_info + wrapper.cache_clear = cache_clear + return wrapper diff --git a/requirements.txt b/requirements.txt index a1f27d23..a953a789 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,7 +1,7 @@ apscheduler==3.10.1 arrow==1.3.0 backports.csv==1.0.7 -backports.functools-lru-cache==1.6.6 +backports.functools-lru-cache==2.0.0 backports.zoneinfo==0.2.1;python_version<"3.9" beautifulsoup4==4.12.2 bleach==6.1.0 From aca7e727157829edefaef01de96cc890916c61ab Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 15:24:31 -0700 Subject: [PATCH 084/290] Bump distro from 1.8.0 to 1.9.0 (#2262) * Bump distro from 1.8.0 to 1.9.0 Bumps [distro](https://github.com/python-distro/distro) from 1.8.0 to 1.9.0. - [Release notes](https://github.com/python-distro/distro/releases) - [Changelog](https://github.com/python-distro/distro/blob/master/CHANGELOG.md) - [Commits](https://github.com/python-distro/distro/compare/v1.8.0...v1.9.0) --- updated-dependencies: - dependency-name: distro dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] * Update distro==1.9.0 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/distro/distro.py | 12 ++++++++---- requirements.txt | 2 +- 2 files changed, 9 insertions(+), 5 deletions(-) diff --git a/lib/distro/distro.py b/lib/distro/distro.py index 89e18680..78ccdfa4 100644 --- a/lib/distro/distro.py +++ b/lib/distro/distro.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -# Copyright 2015,2016,2017 Nir Cohen +# Copyright 2015-2021 Nir Cohen # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. @@ -55,7 +55,7 @@ except ImportError: # Python 3.7 TypedDict = dict -__version__ = "1.8.0" +__version__ = "1.9.0" class VersionDict(TypedDict): @@ -125,6 +125,7 @@ _DISTRO_RELEASE_BASENAME_PATTERN = re.compile(r"(\w+)[-_](release|version)$") # Base file names to be looked up for if _UNIXCONFDIR is not readable. _DISTRO_RELEASE_BASENAMES = [ "SuSE-release", + "altlinux-release", "arch-release", "base-release", "centos-release", @@ -151,6 +152,8 @@ _DISTRO_RELEASE_IGNORE_BASENAMES = ( "system-release", "plesk-release", "iredmail-release", + "board-release", + "ec2_version", ) @@ -243,6 +246,7 @@ def id() -> str: "rocky" Rocky Linux "aix" AIX "guix" Guix System + "altlinux" ALT Linux ============== ========================================= If you have a need to get distros for reliable IDs added into this set, @@ -991,10 +995,10 @@ class LinuxDistribution: For details, see :func:`distro.info`. """ - return dict( + return InfoDict( id=self.id(), version=self.version(pretty, best), - version_parts=dict( + version_parts=VersionDict( major=self.major_version(best), minor=self.minor_version(best), build_number=self.build_number(best), diff --git a/requirements.txt b/requirements.txt index a953a789..fe84492e 100644 --- a/requirements.txt +++ b/requirements.txt @@ -9,7 +9,7 @@ certifi==2024.2.2 cheroot==10.0.0 cherrypy==18.8.0 cloudinary==1.34.0 -distro==1.8.0 +distro==1.9.0 dnspython==2.4.2 facebook-sdk==3.1.0 future==0.18.3 From cfefa928be5ab04dc72a20aeba9307bd887fe0ba Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 15:25:23 -0700 Subject: [PATCH 085/290] Bump dnspython from 2.4.2 to 2.6.1 (#2264) * Bump dnspython from 2.4.2 to 2.6.1 Bumps [dnspython](https://github.com/rthalley/dnspython) from 2.4.2 to 2.6.1. - [Release notes](https://github.com/rthalley/dnspython/releases) - [Changelog](https://github.com/rthalley/dnspython/blob/main/doc/whatsnew.rst) - [Commits](https://github.com/rthalley/dnspython/compare/v2.4.2...v2.6.1) --- updated-dependencies: - dependency-name: dnspython dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] * Update dnspython==2.6.1 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/dns/_asyncio_backend.py | 18 +-- lib/dns/_features.py | 92 +++++++++++++ lib/dns/_trio_backend.py | 8 +- lib/dns/asyncbackend.py | 2 +- lib/dns/asyncquery.py | 80 +++++++---- lib/dns/dnssec.py | 19 +-- lib/dns/dnssecalgs/__init__.py | 13 +- lib/dns/edns.py | 43 +++++- lib/dns/immutable.py | 14 +- lib/dns/inet.py | 17 +++ lib/dns/ipv4.py | 13 ++ lib/dns/ipv6.py | 13 +- lib/dns/message.py | 109 +++++++++++---- lib/dns/name.py | 217 ++++++++++++++++++++++++++++-- lib/dns/nameserver.py | 34 ++++- lib/dns/node.py | 1 - lib/dns/query.py | 195 +++++++++++++++++---------- lib/dns/quic/__init__.py | 14 +- lib/dns/quic/_asyncio.py | 25 ++-- lib/dns/quic/_common.py | 52 ++++++- lib/dns/quic/_sync.py | 34 +++-- lib/dns/quic/_trio.py | 43 ++++-- lib/dns/rdata.py | 19 +-- lib/dns/rdataset.py | 20 +-- lib/dns/rdtypes/ANY/AFSDB.py | 1 - lib/dns/rdtypes/ANY/AMTRELAY.py | 1 - lib/dns/rdtypes/ANY/AVC.py | 1 - lib/dns/rdtypes/ANY/CAA.py | 1 - lib/dns/rdtypes/ANY/CDNSKEY.py | 1 - lib/dns/rdtypes/ANY/CDS.py | 1 - lib/dns/rdtypes/ANY/CERT.py | 1 - lib/dns/rdtypes/ANY/CNAME.py | 1 - lib/dns/rdtypes/ANY/CSYNC.py | 1 - lib/dns/rdtypes/ANY/DLV.py | 1 - lib/dns/rdtypes/ANY/DNAME.py | 1 - lib/dns/rdtypes/ANY/DNSKEY.py | 1 - lib/dns/rdtypes/ANY/DS.py | 1 - lib/dns/rdtypes/ANY/EUI48.py | 1 - lib/dns/rdtypes/ANY/EUI64.py | 1 - lib/dns/rdtypes/ANY/GPOS.py | 1 - lib/dns/rdtypes/ANY/HINFO.py | 1 - lib/dns/rdtypes/ANY/HIP.py | 1 - lib/dns/rdtypes/ANY/ISDN.py | 1 - lib/dns/rdtypes/ANY/L32.py | 1 - lib/dns/rdtypes/ANY/L64.py | 1 - lib/dns/rdtypes/ANY/LOC.py | 1 - lib/dns/rdtypes/ANY/LP.py | 1 - lib/dns/rdtypes/ANY/MX.py | 1 - lib/dns/rdtypes/ANY/NID.py | 1 - lib/dns/rdtypes/ANY/NINFO.py | 1 - lib/dns/rdtypes/ANY/NS.py | 1 - lib/dns/rdtypes/ANY/NSEC.py | 1 - lib/dns/rdtypes/ANY/NSEC3.py | 10 +- lib/dns/rdtypes/ANY/NSEC3PARAM.py | 1 - lib/dns/rdtypes/ANY/OPENPGPKEY.py | 1 - lib/dns/rdtypes/ANY/OPT.py | 1 - lib/dns/rdtypes/ANY/PTR.py | 1 - lib/dns/rdtypes/ANY/RP.py | 1 - lib/dns/rdtypes/ANY/RRSIG.py | 2 - lib/dns/rdtypes/ANY/RT.py | 1 - lib/dns/rdtypes/ANY/SOA.py | 1 - lib/dns/rdtypes/ANY/SPF.py | 1 - lib/dns/rdtypes/ANY/SSHFP.py | 1 - lib/dns/rdtypes/ANY/TKEY.py | 1 - lib/dns/rdtypes/ANY/TLSA.py | 1 - lib/dns/rdtypes/ANY/TSIG.py | 1 - lib/dns/rdtypes/ANY/TXT.py | 1 - lib/dns/rdtypes/ANY/URI.py | 1 - lib/dns/rdtypes/ANY/X25.py | 1 - lib/dns/rdtypes/ANY/ZONEMD.py | 1 - lib/dns/rdtypes/CH/A.py | 1 - lib/dns/rdtypes/IN/A.py | 1 - lib/dns/rdtypes/IN/AAAA.py | 1 - lib/dns/rdtypes/IN/APL.py | 2 - lib/dns/rdtypes/IN/DHCID.py | 1 - lib/dns/rdtypes/IN/IPSECKEY.py | 1 - lib/dns/rdtypes/IN/KX.py | 1 - lib/dns/rdtypes/IN/NAPTR.py | 1 - lib/dns/rdtypes/IN/NSAP.py | 1 - lib/dns/rdtypes/IN/NSAP_PTR.py | 1 - lib/dns/rdtypes/IN/PX.py | 1 - lib/dns/rdtypes/IN/SRV.py | 1 - lib/dns/rdtypes/IN/WKS.py | 1 - lib/dns/rdtypes/dnskeybase.py | 1 - lib/dns/rdtypes/dsbase.py | 1 - lib/dns/rdtypes/euibase.py | 1 - lib/dns/rdtypes/mxbase.py | 3 - lib/dns/rdtypes/nsbase.py | 2 - lib/dns/rdtypes/svcbbase.py | 20 +-- lib/dns/rdtypes/tlsabase.py | 1 - lib/dns/rdtypes/txtbase.py | 11 +- lib/dns/renderer.py | 64 ++++++--- lib/dns/rrset.py | 7 +- lib/dns/set.py | 1 - lib/dns/transaction.py | 4 +- lib/dns/tsig.py | 9 -- lib/dns/version.py | 4 +- lib/dns/win32util.py | 11 +- lib/dns/zone.py | 203 +++++++++++++++++----------- lib/dns/zonefile.py | 1 - requirements.txt | 2 +- 101 files changed, 1052 insertions(+), 459 deletions(-) create mode 100644 lib/dns/_features.py diff --git a/lib/dns/_asyncio_backend.py b/lib/dns/_asyncio_backend.py index 2631228e..9d9ed369 100644 --- a/lib/dns/_asyncio_backend.py +++ b/lib/dns/_asyncio_backend.py @@ -7,7 +7,9 @@ import socket import sys import dns._asyncbackend +import dns._features import dns.exception +import dns.inet _is_win32 = sys.platform == "win32" @@ -121,7 +123,7 @@ class StreamSocket(dns._asyncbackend.StreamSocket): return self.writer.get_extra_info("peercert") -try: +if dns._features.have("doh"): import anyio import httpcore import httpcore._backends.anyio @@ -205,7 +207,7 @@ try: resolver, local_port, bootstrap_address, family ) -except ImportError: +else: _HTTPTransport = dns._asyncbackend.NullTransport # type: ignore @@ -224,14 +226,12 @@ class Backend(dns._asyncbackend.Backend): ssl_context=None, server_hostname=None, ): - if destination is None and socktype == socket.SOCK_DGRAM and _is_win32: - raise NotImplementedError( - "destinationless datagram sockets " - "are not supported by asyncio " - "on Windows" - ) loop = _get_running_loop() if socktype == socket.SOCK_DGRAM: + if _is_win32 and source is None: + # Win32 wants explicit binding before recvfrom(). This is the + # proper fix for [#637]. + source = (dns.inet.any_for_af(af), 0) transport, protocol = await loop.create_datagram_endpoint( _DatagramProtocol, source, @@ -266,7 +266,7 @@ class Backend(dns._asyncbackend.Backend): await asyncio.sleep(interval) def datagram_connection_required(self): - return _is_win32 + return False def get_transport_class(self): return _HTTPTransport diff --git a/lib/dns/_features.py b/lib/dns/_features.py new file mode 100644 index 00000000..03ccaa77 --- /dev/null +++ b/lib/dns/_features.py @@ -0,0 +1,92 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import importlib.metadata +import itertools +import string +from typing import Dict, List, Tuple + + +def _tuple_from_text(version: str) -> Tuple: + text_parts = version.split(".") + int_parts = [] + for text_part in text_parts: + digit_prefix = "".join( + itertools.takewhile(lambda x: x in string.digits, text_part) + ) + try: + int_parts.append(int(digit_prefix)) + except Exception: + break + return tuple(int_parts) + + +def _version_check( + requirement: str, +) -> bool: + """Is the requirement fulfilled? + + The requirement must be of the form + + package>=version + """ + package, minimum = requirement.split(">=") + try: + version = importlib.metadata.version(package) + except Exception: + return False + t_version = _tuple_from_text(version) + t_minimum = _tuple_from_text(minimum) + if t_version < t_minimum: + return False + return True + + +_cache: Dict[str, bool] = {} + + +def have(feature: str) -> bool: + """Is *feature* available? + + This tests if all optional packages needed for the + feature are available and recent enough. + + Returns ``True`` if the feature is available, + and ``False`` if it is not or if metadata is + missing. + """ + value = _cache.get(feature) + if value is not None: + return value + requirements = _requirements.get(feature) + if requirements is None: + # we make a cache entry here for consistency not performance + _cache[feature] = False + return False + ok = True + for requirement in requirements: + if not _version_check(requirement): + ok = False + break + _cache[feature] = ok + return ok + + +def force(feature: str, enabled: bool) -> None: + """Force the status of *feature* to be *enabled*. + + This method is provided as a workaround for any cases + where importlib.metadata is ineffective, or for testing. + """ + _cache[feature] = enabled + + +_requirements: Dict[str, List[str]] = { + ### BEGIN generated requirements + "dnssec": ["cryptography>=41"], + "doh": ["httpcore>=1.0.0", "httpx>=0.26.0", "h2>=4.1.0"], + "doq": ["aioquic>=0.9.25"], + "idna": ["idna>=3.6"], + "trio": ["trio>=0.23"], + "wmi": ["wmi>=1.5.1"], + ### END generated requirements +} diff --git a/lib/dns/_trio_backend.py b/lib/dns/_trio_backend.py index 4d9fb820..398e3276 100644 --- a/lib/dns/_trio_backend.py +++ b/lib/dns/_trio_backend.py @@ -8,9 +8,13 @@ import trio import trio.socket # type: ignore import dns._asyncbackend +import dns._features import dns.exception import dns.inet +if not dns._features.have("trio"): + raise ImportError("trio not found or too old") + def _maybe_timeout(timeout): if timeout is not None: @@ -95,7 +99,7 @@ class StreamSocket(dns._asyncbackend.StreamSocket): raise NotImplementedError -try: +if dns._features.have("doh"): import httpcore import httpcore._backends.trio import httpx @@ -177,7 +181,7 @@ try: resolver, local_port, bootstrap_address, family ) -except ImportError: +else: _HTTPTransport = dns._asyncbackend.NullTransport # type: ignore diff --git a/lib/dns/asyncbackend.py b/lib/dns/asyncbackend.py index 07d50e1e..0ec58b06 100644 --- a/lib/dns/asyncbackend.py +++ b/lib/dns/asyncbackend.py @@ -32,7 +32,7 @@ def get_backend(name: str) -> Backend: *name*, a ``str``, the name of the backend. Currently the "trio" and "asyncio" backends are available. - Raises NotImplementError if an unknown backend name is specified. + Raises NotImplementedError if an unknown backend name is specified. """ # pylint: disable=import-outside-toplevel,redefined-outer-name backend = _backends.get(name) diff --git a/lib/dns/asyncquery.py b/lib/dns/asyncquery.py index ecf9c1a5..4d9ab9ae 100644 --- a/lib/dns/asyncquery.py +++ b/lib/dns/asyncquery.py @@ -41,7 +41,7 @@ from dns.query import ( NoDOQ, UDPMode, _compute_times, - _have_http2, + _make_dot_ssl_context, _matches_destination, _remaining, have_doh, @@ -120,6 +120,8 @@ async def receive_udp( request_mac: Optional[bytes] = b"", ignore_trailing: bool = False, raise_on_truncation: bool = False, + ignore_errors: bool = False, + query: Optional[dns.message.Message] = None, ) -> Any: """Read a DNS message from a UDP socket. @@ -133,22 +135,40 @@ async def receive_udp( """ wire = b"" - while 1: + while True: (wire, from_address) = await sock.recvfrom(65535, _timeout(expiration)) - if _matches_destination( + if not _matches_destination( sock.family, from_address, destination, ignore_unexpected ): - break - received_time = time.time() - r = dns.message.from_wire( - wire, - keyring=keyring, - request_mac=request_mac, - one_rr_per_rrset=one_rr_per_rrset, - ignore_trailing=ignore_trailing, - raise_on_truncation=raise_on_truncation, - ) - return (r, received_time, from_address) + continue + received_time = time.time() + try: + r = dns.message.from_wire( + wire, + keyring=keyring, + request_mac=request_mac, + one_rr_per_rrset=one_rr_per_rrset, + ignore_trailing=ignore_trailing, + raise_on_truncation=raise_on_truncation, + ) + except dns.message.Truncated as e: + # See the comment in query.py for details. + if ( + ignore_errors + and query is not None + and not query.is_response(e.message()) + ): + continue + else: + raise + except Exception: + if ignore_errors: + continue + else: + raise + if ignore_errors and query is not None and not query.is_response(r): + continue + return (r, received_time, from_address) async def udp( @@ -164,6 +184,7 @@ async def udp( raise_on_truncation: bool = False, sock: Optional[dns.asyncbackend.DatagramSocket] = None, backend: Optional[dns.asyncbackend.Backend] = None, + ignore_errors: bool = False, ) -> dns.message.Message: """Return the response obtained after sending a query via UDP. @@ -205,9 +226,13 @@ async def udp( q.mac, ignore_trailing, raise_on_truncation, + ignore_errors, + q, ) r.time = received_time - begin_time - if not q.is_response(r): + # We don't need to check q.is_response() if we are in ignore_errors mode + # as receive_udp() will have checked it. + if not (ignore_errors or q.is_response(r)): raise BadResponse return r @@ -225,6 +250,7 @@ async def udp_with_fallback( udp_sock: Optional[dns.asyncbackend.DatagramSocket] = None, tcp_sock: Optional[dns.asyncbackend.StreamSocket] = None, backend: Optional[dns.asyncbackend.Backend] = None, + ignore_errors: bool = False, ) -> Tuple[dns.message.Message, bool]: """Return the response to the query, trying UDP first and falling back to TCP if UDP results in a truncated response. @@ -260,6 +286,7 @@ async def udp_with_fallback( True, udp_sock, backend, + ignore_errors, ) return (response, False) except dns.message.Truncated: @@ -292,14 +319,12 @@ async def send_tcp( """ if isinstance(what, dns.message.Message): - wire = what.to_wire() + tcpmsg = what.to_wire(prepend_length=True) else: - wire = what - l = len(wire) - # copying the wire into tcpmsg is inefficient, but lets us - # avoid writev() or doing a short write that would get pushed - # onto the net - tcpmsg = struct.pack("!H", l) + wire + # copying the wire into tcpmsg is inefficient, but lets us + # avoid writev() or doing a short write that would get pushed + # onto the net + tcpmsg = len(what).to_bytes(2, "big") + what sent_time = time.time() await sock.sendall(tcpmsg, _timeout(expiration, sent_time)) return (len(tcpmsg), sent_time) @@ -418,6 +443,7 @@ async def tls( backend: Optional[dns.asyncbackend.Backend] = None, ssl_context: Optional[ssl.SSLContext] = None, server_hostname: Optional[str] = None, + verify: Union[bool, str] = True, ) -> dns.message.Message: """Return the response obtained after sending a query via TLS. @@ -439,11 +465,7 @@ async def tls( cm: contextlib.AbstractAsyncContextManager = NullContext(sock) else: if ssl_context is None: - # See the comment about ssl.create_default_context() in query.py - ssl_context = ssl.create_default_context() # lgtm[py/insecure-protocol] - ssl_context.minimum_version = ssl.TLSVersion.TLSv1_2 - if server_hostname is None: - ssl_context.check_hostname = False + ssl_context = _make_dot_ssl_context(server_hostname, verify) af = dns.inet.af_for_address(where) stuple = _source_tuple(af, source, source_port) dtuple = (where, port) @@ -538,7 +560,7 @@ async def https( transport = backend.get_transport_class()( local_address=local_address, http1=True, - http2=_have_http2, + http2=True, verify=verify, local_port=local_port, bootstrap_address=bootstrap_address, @@ -550,7 +572,7 @@ async def https( cm: contextlib.AbstractAsyncContextManager = NullContext(client) else: cm = httpx.AsyncClient( - http1=True, http2=_have_http2, verify=verify, transport=transport + http1=True, http2=True, verify=verify, transport=transport ) async with cm as the_client: diff --git a/lib/dns/dnssec.py b/lib/dns/dnssec.py index 2949f619..e49c3b79 100644 --- a/lib/dns/dnssec.py +++ b/lib/dns/dnssec.py @@ -27,6 +27,7 @@ import time from datetime import datetime from typing import Callable, Dict, List, Optional, Set, Tuple, Union, cast +import dns._features import dns.exception import dns.name import dns.node @@ -1169,7 +1170,7 @@ def _need_pyca(*args, **kwargs): ) # pragma: no cover -try: +if dns._features.have("dnssec"): from cryptography.exceptions import InvalidSignature from cryptography.hazmat.primitives.asymmetric import dsa # pylint: disable=W0611 from cryptography.hazmat.primitives.asymmetric import ec # pylint: disable=W0611 @@ -1184,20 +1185,20 @@ try: get_algorithm_cls_from_dnskey, ) from dns.dnssecalgs.base import GenericPrivateKey, GenericPublicKey -except ImportError: # pragma: no cover - validate = _need_pyca - validate_rrsig = _need_pyca - sign = _need_pyca - make_dnskey = _need_pyca - make_cdnskey = _need_pyca - _have_pyca = False -else: + validate = _validate # type: ignore validate_rrsig = _validate_rrsig # type: ignore sign = _sign make_dnskey = _make_dnskey make_cdnskey = _make_cdnskey _have_pyca = True +else: # pragma: no cover + validate = _need_pyca + validate_rrsig = _need_pyca + sign = _need_pyca + make_dnskey = _need_pyca + make_cdnskey = _need_pyca + _have_pyca = False ### BEGIN generated Algorithm constants diff --git a/lib/dns/dnssecalgs/__init__.py b/lib/dns/dnssecalgs/__init__.py index d1ffd519..3d9181a7 100644 --- a/lib/dns/dnssecalgs/__init__.py +++ b/lib/dns/dnssecalgs/__init__.py @@ -1,9 +1,12 @@ from typing import Dict, Optional, Tuple, Type, Union import dns.name +from dns.dnssecalgs.base import GenericPrivateKey +from dns.dnssectypes import Algorithm +from dns.exception import UnsupportedAlgorithm +from dns.rdtypes.ANY.DNSKEY import DNSKEY -try: - from dns.dnssecalgs.base import GenericPrivateKey +if dns._features.have("dnssec"): from dns.dnssecalgs.dsa import PrivateDSA, PrivateDSANSEC3SHA1 from dns.dnssecalgs.ecdsa import PrivateECDSAP256SHA256, PrivateECDSAP384SHA384 from dns.dnssecalgs.eddsa import PrivateED448, PrivateED25519 @@ -16,13 +19,9 @@ try: ) _have_cryptography = True -except ImportError: +else: _have_cryptography = False -from dns.dnssectypes import Algorithm -from dns.exception import UnsupportedAlgorithm -from dns.rdtypes.ANY.DNSKEY import DNSKEY - AlgorithmPrefix = Optional[Union[bytes, dns.name.Name]] algorithms: Dict[Tuple[Algorithm, AlgorithmPrefix], Type[GenericPrivateKey]] = {} diff --git a/lib/dns/edns.py b/lib/dns/edns.py index f05baac4..776e5eeb 100644 --- a/lib/dns/edns.py +++ b/lib/dns/edns.py @@ -17,6 +17,7 @@ """EDNS Options""" +import binascii import math import socket import struct @@ -58,7 +59,6 @@ class OptionType(dns.enum.IntEnum): class Option: - """Base class for all EDNS option types.""" def __init__(self, otype: Union[OptionType, str]): @@ -76,6 +76,9 @@ class Option: """ raise NotImplementedError # pragma: no cover + def to_text(self) -> str: + raise NotImplementedError # pragma: no cover + @classmethod def from_wire_parser(cls, otype: OptionType, parser: "dns.wire.Parser") -> "Option": """Build an EDNS option object from wire format. @@ -141,7 +144,6 @@ class Option: class GenericOption(Option): # lgtm[py/missing-equals] - """Generic Option Class This class is used for EDNS option types for which we have no better @@ -343,6 +345,8 @@ class EDECode(dns.enum.IntEnum): class EDEOption(Option): # lgtm[py/missing-equals] """Extended DNS Error (EDE, RFC8914)""" + _preserve_case = {"DNSKEY", "DS", "DNSSEC", "RRSIGs", "NSEC", "NXDOMAIN"} + def __init__(self, code: Union[EDECode, str], text: Optional[str] = None): """*code*, a ``dns.edns.EDECode`` or ``str``, the info code of the extended error. @@ -360,6 +364,13 @@ class EDEOption(Option): # lgtm[py/missing-equals] def to_text(self) -> str: output = f"EDE {self.code}" + if self.code in EDECode: + desc = EDECode.to_text(self.code) + desc = " ".join( + word if word in self._preserve_case else word.title() + for word in desc.split("_") + ) + output += f" ({desc})" if self.text is not None: output += f": {self.text}" return output @@ -392,9 +403,37 @@ class EDEOption(Option): # lgtm[py/missing-equals] return cls(code, btext) +class NSIDOption(Option): + def __init__(self, nsid: bytes): + super().__init__(OptionType.NSID) + self.nsid = nsid + + def to_wire(self, file: Any = None) -> Optional[bytes]: + if file: + file.write(self.nsid) + return None + else: + return self.nsid + + def to_text(self) -> str: + if all(c >= 0x20 and c <= 0x7E for c in self.nsid): + # All ASCII printable, so it's probably a string. + value = self.nsid.decode() + else: + value = binascii.hexlify(self.nsid).decode() + return f"NSID {value}" + + @classmethod + def from_wire_parser( + cls, otype: Union[OptionType, str], parser: dns.wire.Parser + ) -> Option: + return cls(parser.get_remaining()) + + _type_to_class: Dict[OptionType, Any] = { OptionType.ECS: ECSOption, OptionType.EDE: EDEOption, + OptionType.NSID: NSIDOption, } diff --git a/lib/dns/immutable.py b/lib/dns/immutable.py index cab8d6fb..36b0362c 100644 --- a/lib/dns/immutable.py +++ b/lib/dns/immutable.py @@ -1,24 +1,30 @@ # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license import collections.abc -from typing import Any +from typing import Any, Callable from dns._immutable_ctx import immutable @immutable class Dict(collections.abc.Mapping): # lgtm[py/missing-equals] - def __init__(self, dictionary: Any, no_copy: bool = False): + def __init__( + self, + dictionary: Any, + no_copy: bool = False, + map_factory: Callable[[], collections.abc.MutableMapping] = dict, + ): """Make an immutable dictionary from the specified dictionary. If *no_copy* is `True`, then *dictionary* will be wrapped instead of copied. Only set this if you are sure there will be no external references to the dictionary. """ - if no_copy and isinstance(dictionary, dict): + if no_copy and isinstance(dictionary, collections.abc.MutableMapping): self._odict = dictionary else: - self._odict = dict(dictionary) + self._odict = map_factory() + self._odict.update(dictionary) self._hash = None def __getitem__(self, key): diff --git a/lib/dns/inet.py b/lib/dns/inet.py index 02e925c6..4a03f996 100644 --- a/lib/dns/inet.py +++ b/lib/dns/inet.py @@ -178,3 +178,20 @@ def any_for_af(af): elif af == socket.AF_INET6: return "::" raise NotImplementedError(f"unknown address family {af}") + + +def canonicalize(text: str) -> str: + """Verify that *address* is a valid text form IPv4 or IPv6 address and return its + canonical text form. IPv6 addresses with scopes are rejected. + + *text*, a ``str``, the address in textual form. + + Raises ``ValueError`` if the text is not valid. + """ + try: + return dns.ipv6.canonicalize(text) + except Exception: + try: + return dns.ipv4.canonicalize(text) + except Exception: + raise ValueError diff --git a/lib/dns/ipv4.py b/lib/dns/ipv4.py index f549150a..65ee69c0 100644 --- a/lib/dns/ipv4.py +++ b/lib/dns/ipv4.py @@ -62,3 +62,16 @@ def inet_aton(text: Union[str, bytes]) -> bytes: return struct.pack("BBBB", *b) except Exception: raise dns.exception.SyntaxError + + +def canonicalize(text: Union[str, bytes]) -> str: + """Verify that *address* is a valid text form IPv4 address and return its + canonical text form. + + *text*, a ``str`` or ``bytes``, the IPv4 address in textual form. + + Raises ``dns.exception.SyntaxError`` if the text is not valid. + """ + # Note that inet_aton() only accepts canonial form, but we still run through + # inet_ntoa() to ensure the output is a str. + return dns.ipv4.inet_ntoa(dns.ipv4.inet_aton(text)) diff --git a/lib/dns/ipv6.py b/lib/dns/ipv6.py index 0cc3d868..44a10639 100644 --- a/lib/dns/ipv6.py +++ b/lib/dns/ipv6.py @@ -104,7 +104,7 @@ _colon_colon_end = re.compile(rb".*::$") def inet_aton(text: Union[str, bytes], ignore_scope: bool = False) -> bytes: """Convert an IPv6 address in text form to binary form. - *text*, a ``str``, the IPv6 address in textual form. + *text*, a ``str`` or ``bytes``, the IPv6 address in textual form. *ignore_scope*, a ``bool``. If ``True``, a scope will be ignored. If ``False``, the default, it is an error for a scope to be present. @@ -206,3 +206,14 @@ def is_mapped(address: bytes) -> bool: """ return address.startswith(_mapped_prefix) + + +def canonicalize(text: Union[str, bytes]) -> str: + """Verify that *address* is a valid text form IPv6 address and return its + canonical text form. Addresses with scopes are rejected. + + *text*, a ``str`` or ``bytes``, the IPv6 address in textual form. + + Raises ``dns.exception.SyntaxError`` if the text is not valid. + """ + return dns.ipv6.inet_ntoa(dns.ipv6.inet_aton(text)) diff --git a/lib/dns/message.py b/lib/dns/message.py index daae6363..44cacbd9 100644 --- a/lib/dns/message.py +++ b/lib/dns/message.py @@ -393,7 +393,7 @@ class Message: section_number = section section = self.section_from_number(section_number) elif isinstance(section, str): - section_number = MessageSection.from_text(section) + section_number = self._section_enum.from_text(section) section = self.section_from_number(section_number) else: section_number = self.section_number(section) @@ -489,6 +489,34 @@ class Message: rrset = None return rrset + def section_count(self, section: SectionType) -> int: + """Returns the number of records in the specified section. + + *section*, an ``int`` section number, a ``str`` section name, or one of + the section attributes of this message. This specifies the + the section of the message to count. For example:: + + my_message.section_count(my_message.answer) + my_message.section_count(dns.message.ANSWER) + my_message.section_count("ANSWER") + """ + + if isinstance(section, int): + section_number = section + section = self.section_from_number(section_number) + elif isinstance(section, str): + section_number = self._section_enum.from_text(section) + section = self.section_from_number(section_number) + else: + section_number = self.section_number(section) + count = sum(max(1, len(rrs)) for rrs in section) + if section_number == MessageSection.ADDITIONAL: + if self.opt is not None: + count += 1 + if self.tsig is not None: + count += 1 + return count + def _compute_opt_reserve(self) -> int: """Compute the size required for the OPT RR, padding excluded""" if not self.opt: @@ -527,6 +555,8 @@ class Message: max_size: int = 0, multi: bool = False, tsig_ctx: Optional[Any] = None, + prepend_length: bool = False, + prefer_truncation: bool = False, **kw: Dict[str, Any], ) -> bytes: """Return a string containing the message in DNS compressed wire @@ -549,6 +579,15 @@ class Message: *tsig_ctx*, a ``dns.tsig.HMACTSig`` or ``dns.tsig.GSSTSig`` object, the ongoing TSIG context, used when signing zone transfers. + *prepend_length*, a ``bool``, should be set to ``True`` if the caller + wants the message length prepended to the message itself. This is + useful for messages sent over TCP, TLS (DoT), or QUIC (DoQ). + + *prefer_truncation*, a ``bool``, should be set to ``True`` if the caller + wants the message to be truncated if it would otherwise exceed the + maximum length. If the truncation occurs before the additional section, + the TC bit will be set. + Raises ``dns.exception.TooBig`` if *max_size* was exceeded. Returns a ``bytes``. @@ -570,14 +609,21 @@ class Message: r.reserve(opt_reserve) tsig_reserve = self._compute_tsig_reserve() r.reserve(tsig_reserve) - for rrset in self.question: - r.add_question(rrset.name, rrset.rdtype, rrset.rdclass) - for rrset in self.answer: - r.add_rrset(dns.renderer.ANSWER, rrset, **kw) - for rrset in self.authority: - r.add_rrset(dns.renderer.AUTHORITY, rrset, **kw) - for rrset in self.additional: - r.add_rrset(dns.renderer.ADDITIONAL, rrset, **kw) + try: + for rrset in self.question: + r.add_question(rrset.name, rrset.rdtype, rrset.rdclass) + for rrset in self.answer: + r.add_rrset(dns.renderer.ANSWER, rrset, **kw) + for rrset in self.authority: + r.add_rrset(dns.renderer.AUTHORITY, rrset, **kw) + for rrset in self.additional: + r.add_rrset(dns.renderer.ADDITIONAL, rrset, **kw) + except dns.exception.TooBig: + if prefer_truncation: + if r.section < dns.renderer.ADDITIONAL: + r.flags |= dns.flags.TC + else: + raise r.release_reserved() if self.opt is not None: r.add_opt(self.opt, self.pad, opt_reserve, tsig_reserve) @@ -598,7 +644,10 @@ class Message: r.write_header() if multi: self.tsig_ctx = ctx - return r.get_wire() + wire = r.get_wire() + if prepend_length: + wire = len(wire).to_bytes(2, "big") + wire + return wire @staticmethod def _make_tsig( @@ -777,6 +826,8 @@ class Message: if request_payload is None: request_payload = payload self.request_payload = request_payload + if pad < 0: + raise ValueError("pad must be non-negative") self.pad = pad @property @@ -826,7 +877,7 @@ class Message: if wanted: self.ednsflags |= dns.flags.DO elif self.opt: - self.ednsflags &= ~dns.flags.DO + self.ednsflags &= ~int(dns.flags.DO) def rcode(self) -> dns.rcode.Rcode: """Return the rcode. @@ -1035,7 +1086,6 @@ def _message_factory_from_opcode(opcode): class _WireReader: - """Wire format reader. parser: the binary parser @@ -1335,7 +1385,6 @@ def from_wire( class _TextReader: - """Text format reader. tok: the tokenizer. @@ -1768,30 +1817,34 @@ def make_response( our_payload: int = 8192, fudge: int = 300, tsig_error: int = 0, + pad: Optional[int] = None, ) -> Message: """Make a message which is a response for the specified query. - The message returned is really a response skeleton; it has all - of the infrastructure required of a response, but none of the - content. + The message returned is really a response skeleton; it has all of the infrastructure + required of a response, but none of the content. - The response's question section is a shallow copy of the query's - question section, so the query's question RRsets should not be - changed. + The response's question section is a shallow copy of the query's question section, + so the query's question RRsets should not be changed. *query*, a ``dns.message.Message``, the query to respond to. *recursion_available*, a ``bool``, should RA be set in the response? - *our_payload*, an ``int``, the payload size to advertise in EDNS - responses. + *our_payload*, an ``int``, the payload size to advertise in EDNS responses. *fudge*, an ``int``, the TSIG time fudge. *tsig_error*, an ``int``, the TSIG error. - Returns a ``dns.message.Message`` object whose specific class is - appropriate for the query. For example, if query is a - ``dns.update.UpdateMessage``, response will be too. + *pad*, a non-negative ``int`` or ``None``. If 0, the default, do not pad; otherwise + if not ``None`` add padding bytes to make the message size a multiple of *pad*. + Note that if padding is non-zero, an EDNS PADDING option will always be added to the + message. If ``None``, add padding following RFC 8467, namely if the request is + padded, pad the response to 468 otherwise do not pad. + + Returns a ``dns.message.Message`` object whose specific class is appropriate for the + query. For example, if query is a ``dns.update.UpdateMessage``, response will be + too. """ if query.flags & dns.flags.QR: @@ -1804,7 +1857,13 @@ def make_response( response.set_opcode(query.opcode()) response.question = list(query.question) if query.edns >= 0: - response.use_edns(0, 0, our_payload, query.payload) + if pad is None: + # Set response padding per RFC 8467 + pad = 0 + for option in query.options: + if option.otype == dns.edns.OptionType.PADDING: + pad = 468 + response.use_edns(0, 0, our_payload, query.payload, pad=pad) if query.had_tsig: response.use_tsig( query.keyring, diff --git a/lib/dns/name.py b/lib/dns/name.py index f452bfed..22ccb392 100644 --- a/lib/dns/name.py +++ b/lib/dns/name.py @@ -20,21 +20,23 @@ import copy import encodings.idna # type: ignore +import functools import struct -from typing import Any, Dict, Iterable, Optional, Tuple, Union - -try: - import idna # type: ignore - - have_idna_2008 = True -except ImportError: # pragma: no cover - have_idna_2008 = False +from typing import Any, Callable, Dict, Iterable, Optional, Tuple, Union +import dns._features import dns.enum import dns.exception import dns.immutable import dns.wire +if dns._features.have("idna"): + import idna # type: ignore + + have_idna_2008 = True +else: # pragma: no cover + have_idna_2008 = False + CompressType = Dict["Name", int] @@ -128,6 +130,10 @@ class IDNAException(dns.exception.DNSException): super().__init__(*args, **kwargs) +class NeedSubdomainOfOrigin(dns.exception.DNSException): + """An absolute name was provided that is not a subdomain of the specified origin.""" + + _escaped = b'"().;\\@$' _escaped_text = '"().;\\@$' @@ -350,7 +356,6 @@ def _maybe_convert_to_binary(label: Union[bytes, str]) -> bytes: @dns.immutable.immutable class Name: - """A DNS name. The dns.name.Name class represents a DNS name as a tuple of @@ -843,6 +848,42 @@ class Name: raise NoParent return Name(self.labels[1:]) + def predecessor(self, origin: "Name", prefix_ok: bool = True) -> "Name": + """Return the maximal predecessor of *name* in the DNSSEC ordering in the zone + whose origin is *origin*, or return the longest name under *origin* if the + name is origin (i.e. wrap around to the longest name, which may still be + *origin* due to length considerations. + + The relativity of the name is preserved, so if this name is relative + then the method will return a relative name, and likewise if this name + is absolute then the predecessor will be absolute. + + *prefix_ok* indicates if prefixing labels is allowed, and + defaults to ``True``. Normally it is good to allow this, but if computing + a maximal predecessor at a zone cut point then ``False`` must be specified. + """ + return _handle_relativity_and_call( + _absolute_predecessor, self, origin, prefix_ok + ) + + def successor(self, origin: "Name", prefix_ok: bool = True) -> "Name": + """Return the minimal successor of *name* in the DNSSEC ordering in the zone + whose origin is *origin*, or return *origin* if the successor cannot be + computed due to name length limitations. + + Note that *origin* is returned in the "too long" cases because wrapping + around to the origin is how NSEC records express "end of the zone". + + The relativity of the name is preserved, so if this name is relative + then the method will return a relative name, and likewise if this name + is absolute then the successor will be absolute. + + *prefix_ok* indicates if prefixing a new minimal label is allowed, and + defaults to ``True``. Normally it is good to allow this, but if computing + a minimal successor at a zone cut point then ``False`` must be specified. + """ + return _handle_relativity_and_call(_absolute_successor, self, origin, prefix_ok) + #: The root name, '.' root = Name([b""]) @@ -1082,3 +1123,161 @@ def from_wire(message: bytes, current: int) -> Tuple[Name, int]: parser = dns.wire.Parser(message, current) name = from_wire_parser(parser) return (name, parser.current - current) + + +# RFC 4471 Support + +_MINIMAL_OCTET = b"\x00" +_MINIMAL_OCTET_VALUE = ord(_MINIMAL_OCTET) +_SUCCESSOR_PREFIX = Name([_MINIMAL_OCTET]) +_MAXIMAL_OCTET = b"\xff" +_MAXIMAL_OCTET_VALUE = ord(_MAXIMAL_OCTET) +_AT_SIGN_VALUE = ord("@") +_LEFT_SQUARE_BRACKET_VALUE = ord("[") + + +def _wire_length(labels): + return functools.reduce(lambda v, x: v + len(x) + 1, labels, 0) + + +def _pad_to_max_name(name): + needed = 255 - _wire_length(name.labels) + new_labels = [] + while needed > 64: + new_labels.append(_MAXIMAL_OCTET * 63) + needed -= 64 + if needed >= 2: + new_labels.append(_MAXIMAL_OCTET * (needed - 1)) + # Note we're already maximal in the needed == 1 case as while we'd like + # to add one more byte as a new label, we can't, as adding a new non-empty + # label requires at least 2 bytes. + new_labels = list(reversed(new_labels)) + new_labels.extend(name.labels) + return Name(new_labels) + + +def _pad_to_max_label(label, suffix_labels): + length = len(label) + # We have to subtract one here to account for the length byte of label. + remaining = 255 - _wire_length(suffix_labels) - length - 1 + if remaining <= 0: + # Shouldn't happen! + return label + needed = min(63 - length, remaining) + return label + _MAXIMAL_OCTET * needed + + +def _absolute_predecessor(name: Name, origin: Name, prefix_ok: bool) -> Name: + # This is the RFC 4471 predecessor algorithm using the "absolute method" of section + # 3.1.1. + # + # Our caller must ensure that the name and origin are absolute, and that name is a + # subdomain of origin. + if name == origin: + return _pad_to_max_name(name) + least_significant_label = name[0] + if least_significant_label == _MINIMAL_OCTET: + return name.parent() + least_octet = least_significant_label[-1] + suffix_labels = name.labels[1:] + if least_octet == _MINIMAL_OCTET_VALUE: + new_labels = [least_significant_label[:-1]] + else: + octets = bytearray(least_significant_label) + octet = octets[-1] + if octet == _LEFT_SQUARE_BRACKET_VALUE: + octet = _AT_SIGN_VALUE + else: + octet -= 1 + octets[-1] = octet + least_significant_label = bytes(octets) + new_labels = [_pad_to_max_label(least_significant_label, suffix_labels)] + new_labels.extend(suffix_labels) + name = Name(new_labels) + if prefix_ok: + return _pad_to_max_name(name) + else: + return name + + +def _absolute_successor(name: Name, origin: Name, prefix_ok: bool) -> Name: + # This is the RFC 4471 successor algorithm using the "absolute method" of section + # 3.1.2. + # + # Our caller must ensure that the name and origin are absolute, and that name is a + # subdomain of origin. + if prefix_ok: + # Try prefixing \000 as new label + try: + return _SUCCESSOR_PREFIX.concatenate(name) + except NameTooLong: + pass + while name != origin: + # Try extending the least significant label. + least_significant_label = name[0] + if len(least_significant_label) < 63: + # We may be able to extend the least label with a minimal additional byte. + # This is only "may" because we could have a maximal length name even though + # the least significant label isn't maximally long. + new_labels = [least_significant_label + _MINIMAL_OCTET] + new_labels.extend(name.labels[1:]) + try: + return dns.name.Name(new_labels) + except dns.name.NameTooLong: + pass + # We can't extend the label either, so we'll try to increment the least + # signficant non-maximal byte in it. + octets = bytearray(least_significant_label) + # We do this reversed iteration with an explicit indexing variable because + # if we find something to increment, we're going to want to truncate everything + # to the right of it. + for i in range(len(octets) - 1, -1, -1): + octet = octets[i] + if octet == _MAXIMAL_OCTET_VALUE: + # We can't increment this, so keep looking. + continue + # Finally, something we can increment. We have to apply a special rule for + # incrementing "@", sending it to "[", because RFC 4034 6.1 says that when + # comparing names, uppercase letters compare as if they were their + # lower-case equivalents. If we increment "@" to "A", then it would compare + # as "a", which is after "[", "\", "]", "^", "_", and "`", so we would have + # skipped the most minimal successor, namely "[". + if octet == _AT_SIGN_VALUE: + octet = _LEFT_SQUARE_BRACKET_VALUE + else: + octet += 1 + octets[i] = octet + # We can now truncate all of the maximal values we skipped (if any) + new_labels = [bytes(octets[: i + 1])] + new_labels.extend(name.labels[1:]) + # We haven't changed the length of the name, so the Name constructor will + # always work. + return Name(new_labels) + # We couldn't increment, so chop off the least significant label and try + # again. + name = name.parent() + + # We couldn't increment at all, so return the origin, as wrapping around is the + # DNSSEC way. + return origin + + +def _handle_relativity_and_call( + function: Callable[[Name, Name, bool], Name], + name: Name, + origin: Name, + prefix_ok: bool, +) -> Name: + # Make "name" absolute if needed, ensure that the origin is absolute, + # call function(), and then relativize the result if needed. + if not origin.is_absolute(): + raise NeedAbsoluteNameOrOrigin + relative = not name.is_absolute() + if relative: + name = name.derelativize(origin) + elif not name.is_subdomain(origin): + raise NeedSubdomainOfOrigin + result_name = function(name, origin, prefix_ok) + if relative: + result_name = result_name.relativize(origin) + return result_name diff --git a/lib/dns/nameserver.py b/lib/dns/nameserver.py index 5910139e..5dbb4e8b 100644 --- a/lib/dns/nameserver.py +++ b/lib/dns/nameserver.py @@ -115,6 +115,8 @@ class Do53Nameserver(AddressAndPortNameserver): raise_on_truncation=True, one_rr_per_rrset=one_rr_per_rrset, ignore_trailing=ignore_trailing, + ignore_errors=True, + ignore_unexpected=True, ) return response @@ -153,15 +155,25 @@ class Do53Nameserver(AddressAndPortNameserver): backend=backend, one_rr_per_rrset=one_rr_per_rrset, ignore_trailing=ignore_trailing, + ignore_errors=True, + ignore_unexpected=True, ) return response class DoHNameserver(Nameserver): - def __init__(self, url: str, bootstrap_address: Optional[str] = None): + def __init__( + self, + url: str, + bootstrap_address: Optional[str] = None, + verify: Union[bool, str] = True, + want_get: bool = False, + ): super().__init__() self.url = url self.bootstrap_address = bootstrap_address + self.verify = verify + self.want_get = want_get def kind(self): return "DoH" @@ -195,9 +207,13 @@ class DoHNameserver(Nameserver): request, self.url, timeout=timeout, + source=source, + source_port=source_port, bootstrap_address=self.bootstrap_address, one_rr_per_rrset=one_rr_per_rrset, ignore_trailing=ignore_trailing, + verify=self.verify, + post=(not self.want_get), ) async def async_query( @@ -215,15 +231,27 @@ class DoHNameserver(Nameserver): request, self.url, timeout=timeout, + source=source, + source_port=source_port, + bootstrap_address=self.bootstrap_address, one_rr_per_rrset=one_rr_per_rrset, ignore_trailing=ignore_trailing, + verify=self.verify, + post=(not self.want_get), ) class DoTNameserver(AddressAndPortNameserver): - def __init__(self, address: str, port: int = 853, hostname: Optional[str] = None): + def __init__( + self, + address: str, + port: int = 853, + hostname: Optional[str] = None, + verify: Union[bool, str] = True, + ): super().__init__(address, port) self.hostname = hostname + self.verify = verify def kind(self): return "DoT" @@ -246,6 +274,7 @@ class DoTNameserver(AddressAndPortNameserver): one_rr_per_rrset=one_rr_per_rrset, ignore_trailing=ignore_trailing, server_hostname=self.hostname, + verify=self.verify, ) async def async_query( @@ -267,6 +296,7 @@ class DoTNameserver(AddressAndPortNameserver): one_rr_per_rrset=one_rr_per_rrset, ignore_trailing=ignore_trailing, server_hostname=self.hostname, + verify=self.verify, ) diff --git a/lib/dns/node.py b/lib/dns/node.py index c670243c..de85a82d 100644 --- a/lib/dns/node.py +++ b/lib/dns/node.py @@ -70,7 +70,6 @@ class NodeKind(enum.Enum): class Node: - """A Node is a set of rdatasets. A node is either a CNAME node or an "other data" node. A CNAME diff --git a/lib/dns/query.py b/lib/dns/query.py index 0d711251..f0ee9161 100644 --- a/lib/dns/query.py +++ b/lib/dns/query.py @@ -22,12 +22,14 @@ import contextlib import enum import errno import os +import os.path import selectors import socket import struct import time from typing import Any, Dict, Optional, Tuple, Union +import dns._features import dns.exception import dns.inet import dns.message @@ -57,24 +59,14 @@ def _expiration_for_this_attempt(timeout, expiration): return min(time.time() + timeout, expiration) -_have_httpx = False -_have_http2 = False -try: - import httpcore +_have_httpx = dns._features.have("doh") +if _have_httpx: import httpcore._backends.sync import httpx _CoreNetworkBackend = httpcore.NetworkBackend _CoreSyncStream = httpcore._backends.sync.SyncStream - _have_httpx = True - try: - # See if http2 support is available. - with httpx.Client(http2=True): - _have_http2 = True - except Exception: - pass - class _NetworkBackend(_CoreNetworkBackend): def __init__(self, resolver, local_port, bootstrap_address, family): super().__init__() @@ -147,7 +139,7 @@ try: resolver, local_port, bootstrap_address, family ) -except ImportError: # pragma: no cover +else: class _HTTPTransport: # type: ignore def connect_tcp(self, host, port, timeout, local_address): @@ -161,6 +153,8 @@ try: except ImportError: # pragma: no cover class ssl: # type: ignore + CERT_NONE = 0 + class WantReadException(Exception): pass @@ -459,7 +453,7 @@ def https( transport = _HTTPTransport( local_address=local_address, http1=True, - http2=_have_http2, + http2=True, verify=verify, local_port=local_port, bootstrap_address=bootstrap_address, @@ -470,9 +464,7 @@ def https( if session: cm: contextlib.AbstractContextManager = contextlib.nullcontext(session) else: - cm = httpx.Client( - http1=True, http2=_have_http2, verify=verify, transport=transport - ) + cm = httpx.Client(http1=True, http2=True, verify=verify, transport=transport) with cm as session: # see https://tools.ietf.org/html/rfc8484#section-4.1.1 for DoH # GET and POST examples @@ -577,6 +569,8 @@ def receive_udp( request_mac: Optional[bytes] = b"", ignore_trailing: bool = False, raise_on_truncation: bool = False, + ignore_errors: bool = False, + query: Optional[dns.message.Message] = None, ) -> Any: """Read a DNS message from a UDP socket. @@ -617,28 +611,58 @@ def receive_udp( ``(dns.message.Message, float, tuple)`` tuple of the received message, the received time, and the address where the message arrived from. + + *ignore_errors*, a ``bool``. If various format errors or response + mismatches occur, ignore them and keep listening for a valid response. + The default is ``False``. + + *query*, a ``dns.message.Message`` or ``None``. If not ``None`` and + *ignore_errors* is ``True``, check that the received message is a response + to this query, and if not keep listening for a valid response. """ wire = b"" while True: (wire, from_address) = _udp_recv(sock, 65535, expiration) - if _matches_destination( + if not _matches_destination( sock.family, from_address, destination, ignore_unexpected ): - break - received_time = time.time() - r = dns.message.from_wire( - wire, - keyring=keyring, - request_mac=request_mac, - one_rr_per_rrset=one_rr_per_rrset, - ignore_trailing=ignore_trailing, - raise_on_truncation=raise_on_truncation, - ) - if destination: - return (r, received_time) - else: - return (r, received_time, from_address) + continue + received_time = time.time() + try: + r = dns.message.from_wire( + wire, + keyring=keyring, + request_mac=request_mac, + one_rr_per_rrset=one_rr_per_rrset, + ignore_trailing=ignore_trailing, + raise_on_truncation=raise_on_truncation, + ) + except dns.message.Truncated as e: + # If we got Truncated and not FORMERR, we at least got the header with TC + # set, and very likely the question section, so we'll re-raise if the + # message seems to be a response as we need to know when truncation happens. + # We need to check that it seems to be a response as we don't want a random + # injected message with TC set to cause us to bail out. + if ( + ignore_errors + and query is not None + and not query.is_response(e.message()) + ): + continue + else: + raise + except Exception: + if ignore_errors: + continue + else: + raise + if ignore_errors and query is not None and not query.is_response(r): + continue + if destination: + return (r, received_time) + else: + return (r, received_time, from_address) def udp( @@ -653,6 +677,7 @@ def udp( ignore_trailing: bool = False, raise_on_truncation: bool = False, sock: Optional[Any] = None, + ignore_errors: bool = False, ) -> dns.message.Message: """Return the response obtained after sending a query via UDP. @@ -689,6 +714,10 @@ def udp( if a socket is provided, it must be a nonblocking datagram socket, and the *source* and *source_port* are ignored. + *ignore_errors*, a ``bool``. If various format errors or response + mismatches occur, ignore them and keep listening for a valid response. + The default is ``False``. + Returns a ``dns.message.Message``. """ @@ -713,9 +742,13 @@ def udp( q.mac, ignore_trailing, raise_on_truncation, + ignore_errors, + q, ) r.time = received_time - begin_time - if not q.is_response(r): + # We don't need to check q.is_response() if we are in ignore_errors mode + # as receive_udp() will have checked it. + if not (ignore_errors or q.is_response(r)): raise BadResponse return r assert ( @@ -735,48 +768,50 @@ def udp_with_fallback( ignore_trailing: bool = False, udp_sock: Optional[Any] = None, tcp_sock: Optional[Any] = None, + ignore_errors: bool = False, ) -> Tuple[dns.message.Message, bool]: """Return the response to the query, trying UDP first and falling back to TCP if UDP results in a truncated response. *q*, a ``dns.message.Message``, the query to send - *where*, a ``str`` containing an IPv4 or IPv6 address, where - to send the message. + *where*, a ``str`` containing an IPv4 or IPv6 address, where to send the message. - *timeout*, a ``float`` or ``None``, the number of seconds to wait before the - query times out. If ``None``, the default, wait forever. + *timeout*, a ``float`` or ``None``, the number of seconds to wait before the query + times out. If ``None``, the default, wait forever. *port*, an ``int``, the port send the message to. The default is 53. - *source*, a ``str`` containing an IPv4 or IPv6 address, specifying - the source address. The default is the wildcard address. + *source*, a ``str`` containing an IPv4 or IPv6 address, specifying the source + address. The default is the wildcard address. - *source_port*, an ``int``, the port from which to send the message. - The default is 0. + *source_port*, an ``int``, the port from which to send the message. The default is + 0. - *ignore_unexpected*, a ``bool``. If ``True``, ignore responses from - unexpected sources. + *ignore_unexpected*, a ``bool``. If ``True``, ignore responses from unexpected + sources. - *one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own - RRset. + *one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own RRset. - *ignore_trailing*, a ``bool``. If ``True``, ignore trailing - junk at end of the received message. + *ignore_trailing*, a ``bool``. If ``True``, ignore trailing junk at end of the + received message. - *udp_sock*, a ``socket.socket``, or ``None``, the socket to use for the - UDP query. If ``None``, the default, a socket is created. Note that - if a socket is provided, it must be a nonblocking datagram socket, - and the *source* and *source_port* are ignored for the UDP query. + *udp_sock*, a ``socket.socket``, or ``None``, the socket to use for the UDP query. + If ``None``, the default, a socket is created. Note that if a socket is provided, + it must be a nonblocking datagram socket, and the *source* and *source_port* are + ignored for the UDP query. *tcp_sock*, a ``socket.socket``, or ``None``, the connected socket to use for the - TCP query. If ``None``, the default, a socket is created. Note that - if a socket is provided, it must be a nonblocking connected stream - socket, and *where*, *source* and *source_port* are ignored for the TCP - query. + TCP query. If ``None``, the default, a socket is created. Note that if a socket is + provided, it must be a nonblocking connected stream socket, and *where*, *source* + and *source_port* are ignored for the TCP query. - Returns a (``dns.message.Message``, tcp) tuple where tcp is ``True`` - if and only if TCP was used. + *ignore_errors*, a ``bool``. If various format errors or response mismatches occur + while listening for UDP, ignore them and keep listening for a valid response. The + default is ``False``. + + Returns a (``dns.message.Message``, tcp) tuple where tcp is ``True`` if and only if + TCP was used. """ try: response = udp( @@ -791,6 +826,7 @@ def udp_with_fallback( ignore_trailing, True, udp_sock, + ignore_errors, ) return (response, False) except dns.message.Truncated: @@ -864,14 +900,12 @@ def send_tcp( """ if isinstance(what, dns.message.Message): - wire = what.to_wire() + tcpmsg = what.to_wire(prepend_length=True) else: - wire = what - l = len(wire) - # copying the wire into tcpmsg is inefficient, but lets us - # avoid writev() or doing a short write that would get pushed - # onto the net - tcpmsg = struct.pack("!H", l) + wire + # copying the wire into tcpmsg is inefficient, but lets us + # avoid writev() or doing a short write that would get pushed + # onto the net + tcpmsg = len(what).to_bytes(2, "big") + what sent_time = time.time() _net_write(sock, tcpmsg, expiration) return (len(tcpmsg), sent_time) @@ -1014,6 +1048,28 @@ def _tls_handshake(s, expiration): _wait_for_writable(s, expiration) +def _make_dot_ssl_context( + server_hostname: Optional[str], verify: Union[bool, str] +) -> ssl.SSLContext: + cafile: Optional[str] = None + capath: Optional[str] = None + if isinstance(verify, str): + if os.path.isfile(verify): + cafile = verify + elif os.path.isdir(verify): + capath = verify + else: + raise ValueError("invalid verify string") + ssl_context = ssl.create_default_context(cafile=cafile, capath=capath) + ssl_context.minimum_version = ssl.TLSVersion.TLSv1_2 + if server_hostname is None: + ssl_context.check_hostname = False + ssl_context.set_alpn_protocols(["dot"]) + if verify is False: + ssl_context.verify_mode = ssl.CERT_NONE + return ssl_context + + def tls( q: dns.message.Message, where: str, @@ -1026,6 +1082,7 @@ def tls( sock: Optional[ssl.SSLSocket] = None, ssl_context: Optional[ssl.SSLContext] = None, server_hostname: Optional[str] = None, + verify: Union[bool, str] = True, ) -> dns.message.Message: """Return the response obtained after sending a query via TLS. @@ -1065,6 +1122,11 @@ def tls( default is ``None``, which means that no hostname is known, and if an SSL context is created, hostname checking will be disabled. + *verify*, a ``bool`` or ``str``. If a ``True``, then TLS certificate verification + of the server is done using the default CA bundle; if ``False``, then no + verification is done; if a `str` then it specifies the path to a certificate file or + directory which will be used for verification. + Returns a ``dns.message.Message``. """ @@ -1091,10 +1153,7 @@ def tls( where, port, source, source_port ) if ssl_context is None and not sock: - ssl_context = ssl.create_default_context() - ssl_context.minimum_version = ssl.TLSVersion.TLSv1_2 - if server_hostname is None: - ssl_context.check_hostname = False + ssl_context = _make_dot_ssl_context(server_hostname, verify) with _make_socket( af, diff --git a/lib/dns/quic/__init__.py b/lib/dns/quic/__init__.py index 69813f9f..20aff345 100644 --- a/lib/dns/quic/__init__.py +++ b/lib/dns/quic/__init__.py @@ -1,9 +1,11 @@ # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license -try: +import dns._features +import dns.asyncbackend + +if dns._features.have("doq"): import aioquic.quic.configuration # type: ignore - import dns.asyncbackend from dns._asyncbackend import NullContext from dns.quic._asyncio import ( AsyncioQuicConnection, @@ -17,7 +19,7 @@ try: def null_factory( *args, # pylint: disable=unused-argument - **kwargs # pylint: disable=unused-argument + **kwargs, # pylint: disable=unused-argument ): return NullContext(None) @@ -31,7 +33,7 @@ try: _async_factories = {"asyncio": (null_factory, _asyncio_manager_factory)} - try: + if dns._features.have("trio"): import trio from dns.quic._trio import ( # pylint: disable=ungrouped-imports @@ -47,15 +49,13 @@ try: return TrioQuicManager(context, *args, **kwargs) _async_factories["trio"] = (_trio_context_factory, _trio_manager_factory) - except ImportError: - pass def factories_for_backend(backend=None): if backend is None: backend = dns.asyncbackend.get_default_backend() return _async_factories[backend.name()] -except ImportError: +else: # pragma: no cover have_quic = False from typing import Any diff --git a/lib/dns/quic/_asyncio.py b/lib/dns/quic/_asyncio.py index e1c52339..0f44331f 100644 --- a/lib/dns/quic/_asyncio.py +++ b/lib/dns/quic/_asyncio.py @@ -101,9 +101,7 @@ class AsyncioQuicConnection(AsyncQuicConnection): ) if address[0] != self._peer[0] or address[1] != self._peer[1]: continue - self._connection.receive_datagram( - datagram, self._peer[0], time.time() - ) + self._connection.receive_datagram(datagram, address, time.time()) # Wake up the timer in case the sender is sleeping, as there may be # stuff to send now. async with self._wake_timer: @@ -125,7 +123,7 @@ class AsyncioQuicConnection(AsyncQuicConnection): while not self._done: datagrams = self._connection.datagrams_to_send(time.time()) for datagram, address in datagrams: - assert address == self._peer[0] + assert address == self._peer await self._socket.sendto(datagram, self._peer, None) (expiration, interval) = self._get_timer_values() try: @@ -147,11 +145,14 @@ class AsyncioQuicConnection(AsyncQuicConnection): await stream._add_input(event.data, event.end_stream) elif isinstance(event, aioquic.quic.events.HandshakeCompleted): self._handshake_complete.set() - elif isinstance( - event, aioquic.quic.events.ConnectionTerminated - ) or isinstance(event, aioquic.quic.events.StreamReset): + elif isinstance(event, aioquic.quic.events.ConnectionTerminated): self._done = True self._receiver_task.cancel() + elif isinstance(event, aioquic.quic.events.StreamReset): + stream = self._streams.get(event.stream_id) + if stream: + await stream._add_input(b"", True) + count += 1 if count > 10: # yield @@ -188,7 +189,6 @@ class AsyncioQuicConnection(AsyncQuicConnection): self._connection.close() # sender might be blocked on this, so set it self._socket_created.set() - await self._socket.close() async with self._wake_timer: self._wake_timer.notify_all() try: @@ -199,14 +199,19 @@ class AsyncioQuicConnection(AsyncQuicConnection): await self._sender_task except asyncio.CancelledError: pass + await self._socket.close() class AsyncioQuicManager(AsyncQuicManager): def __init__(self, conf=None, verify_mode=ssl.CERT_REQUIRED, server_name=None): super().__init__(conf, verify_mode, AsyncioQuicConnection, server_name) - def connect(self, address, port=853, source=None, source_port=0): - (connection, start) = self._connect(address, port, source, source_port) + def connect( + self, address, port=853, source=None, source_port=0, want_session_ticket=True + ): + (connection, start) = self._connect( + address, port, source, source_port, want_session_ticket + ) if start: connection.run() return connection diff --git a/lib/dns/quic/_common.py b/lib/dns/quic/_common.py index 38ec103f..0eacc691 100644 --- a/lib/dns/quic/_common.py +++ b/lib/dns/quic/_common.py @@ -1,5 +1,7 @@ # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license +import copy +import functools import socket import struct import time @@ -11,6 +13,10 @@ import aioquic.quic.connection # type: ignore import dns.inet QUIC_MAX_DATAGRAM = 2048 +MAX_SESSION_TICKETS = 8 +# If we hit the max sessions limit we will delete this many of the oldest connections. +# The value must be a integer > 0 and <= MAX_SESSION_TICKETS. +SESSIONS_TO_DELETE = MAX_SESSION_TICKETS // 4 class UnexpectedEOF(Exception): @@ -79,7 +85,10 @@ class BaseQuicStream: def _common_add_input(self, data, is_end): self._buffer.put(data, is_end) - return self._expecting > 0 and self._buffer.have(self._expecting) + try: + return self._expecting > 0 and self._buffer.have(self._expecting) + except UnexpectedEOF: + return True def _close(self): self._connection.close_stream(self._stream_id) @@ -142,6 +151,7 @@ class BaseQuicManager: def __init__(self, conf, verify_mode, connection_factory, server_name=None): self._connections = {} self._connection_factory = connection_factory + self._session_tickets = {} if conf is None: verify_path = None if isinstance(verify_mode, str): @@ -156,12 +166,35 @@ class BaseQuicManager: conf.load_verify_locations(verify_path) self._conf = conf - def _connect(self, address, port=853, source=None, source_port=0): + def _connect( + self, address, port=853, source=None, source_port=0, want_session_ticket=True + ): connection = self._connections.get((address, port)) if connection is not None: return (connection, False) - qconn = aioquic.quic.connection.QuicConnection(configuration=self._conf) - qconn.connect(address, time.time()) + conf = self._conf + if want_session_ticket: + try: + session_ticket = self._session_tickets.pop((address, port)) + # We found a session ticket, so make a configuration that uses it. + conf = copy.copy(conf) + conf.session_ticket = session_ticket + except KeyError: + # No session ticket. + pass + # Whether or not we found a session ticket, we want a handler to save + # one. + session_ticket_handler = functools.partial( + self.save_session_ticket, address, port + ) + else: + session_ticket_handler = None + qconn = aioquic.quic.connection.QuicConnection( + configuration=conf, + session_ticket_handler=session_ticket_handler, + ) + lladdress = dns.inet.low_level_address_tuple((address, port)) + qconn.connect(lladdress, time.time()) connection = self._connection_factory( qconn, address, port, source, source_port, self ) @@ -174,6 +207,17 @@ class BaseQuicManager: except KeyError: pass + def save_session_ticket(self, address, port, ticket): + # We rely on dictionaries keys() being in insertion order here. We + # can't just popitem() as that would be LIFO which is the opposite of + # what we want. + l = len(self._session_tickets) + if l >= MAX_SESSION_TICKETS: + keys_to_delete = list(self._session_tickets.keys())[0:SESSIONS_TO_DELETE] + for key in keys_to_delete: + del self._session_tickets[key] + self._session_tickets[(address, port)] = ticket + class AsyncQuicManager(BaseQuicManager): def connect(self, address, port=853, source=None, source_port=0): diff --git a/lib/dns/quic/_sync.py b/lib/dns/quic/_sync.py index e944784d..120cb5f3 100644 --- a/lib/dns/quic/_sync.py +++ b/lib/dns/quic/_sync.py @@ -82,10 +82,6 @@ class SyncQuicConnection(BaseQuicConnection): def __init__(self, connection, address, port, source, source_port, manager): super().__init__(connection, address, port, source, source_port, manager) self._socket = socket.socket(self._af, socket.SOCK_DGRAM, 0) - self._socket.connect(self._peer) - (self._send_wakeup, self._receive_wakeup) = socket.socketpair() - self._receive_wakeup.setblocking(False) - self._socket.setblocking(False) if self._source is not None: try: self._socket.bind( @@ -94,6 +90,10 @@ class SyncQuicConnection(BaseQuicConnection): except Exception: self._socket.close() raise + self._socket.connect(self._peer) + (self._send_wakeup, self._receive_wakeup) = socket.socketpair() + self._receive_wakeup.setblocking(False) + self._socket.setblocking(False) self._handshake_complete = threading.Event() self._worker_thread = None self._lock = threading.Lock() @@ -107,7 +107,7 @@ class SyncQuicConnection(BaseQuicConnection): except BlockingIOError: return with self._lock: - self._connection.receive_datagram(datagram, self._peer[0], time.time()) + self._connection.receive_datagram(datagram, self._peer, time.time()) def _drain_wakeup(self): while True: @@ -128,6 +128,8 @@ class SyncQuicConnection(BaseQuicConnection): key.data() with self._lock: self._handle_timer(expiration) + self._handle_events() + with self._lock: datagrams = self._connection.datagrams_to_send(time.time()) for datagram, _ in datagrams: try: @@ -135,7 +137,6 @@ class SyncQuicConnection(BaseQuicConnection): except BlockingIOError: # we let QUIC handle any lossage pass - self._handle_events() finally: with self._lock: self._done = True @@ -155,11 +156,14 @@ class SyncQuicConnection(BaseQuicConnection): stream._add_input(event.data, event.end_stream) elif isinstance(event, aioquic.quic.events.HandshakeCompleted): self._handshake_complete.set() - elif isinstance( - event, aioquic.quic.events.ConnectionTerminated - ) or isinstance(event, aioquic.quic.events.StreamReset): + elif isinstance(event, aioquic.quic.events.ConnectionTerminated): with self._lock: self._done = True + elif isinstance(event, aioquic.quic.events.StreamReset): + with self._lock: + stream = self._streams.get(event.stream_id) + if stream: + stream._add_input(b"", True) def write(self, stream, data, is_end=False): with self._lock: @@ -203,9 +207,13 @@ class SyncQuicManager(BaseQuicManager): super().__init__(conf, verify_mode, SyncQuicConnection, server_name) self._lock = threading.Lock() - def connect(self, address, port=853, source=None, source_port=0): + def connect( + self, address, port=853, source=None, source_port=0, want_session_ticket=True + ): with self._lock: - (connection, start) = self._connect(address, port, source, source_port) + (connection, start) = self._connect( + address, port, source, source_port, want_session_ticket + ) if start: connection.run() return connection @@ -214,6 +222,10 @@ class SyncQuicManager(BaseQuicManager): with self._lock: super().closed(address, port) + def save_session_ticket(self, address, port, ticket): + with self._lock: + super().save_session_ticket(address, port, ticket) + def __enter__(self): return self diff --git a/lib/dns/quic/_trio.py b/lib/dns/quic/_trio.py index ee07e4f6..35e36b98 100644 --- a/lib/dns/quic/_trio.py +++ b/lib/dns/quic/_trio.py @@ -76,30 +76,43 @@ class TrioQuicConnection(AsyncQuicConnection): def __init__(self, connection, address, port, source, source_port, manager=None): super().__init__(connection, address, port, source, source_port, manager) self._socket = trio.socket.socket(self._af, socket.SOCK_DGRAM, 0) - if self._source: - trio.socket.bind(dns.inet.low_level_address_tuple(self._source, self._af)) self._handshake_complete = trio.Event() self._run_done = trio.Event() self._worker_scope = None + self._send_pending = False async def _worker(self): try: + if self._source: + await self._socket.bind( + dns.inet.low_level_address_tuple(self._source, self._af) + ) await self._socket.connect(self._peer) while not self._done: (expiration, interval) = self._get_timer_values(False) + if self._send_pending: + # Do not block forever if sends are pending. Even though we + # have a wake-up mechanism if we've already started the blocking + # read, the possibility of context switching in send means that + # more writes can happen while we have no wake up context, so + # we need self._send_pending to avoid (effectively) a "lost wakeup" + # race. + interval = 0.0 with trio.CancelScope( deadline=trio.current_time() + interval ) as self._worker_scope: datagram = await self._socket.recv(QUIC_MAX_DATAGRAM) - self._connection.receive_datagram( - datagram, self._peer[0], time.time() - ) + self._connection.receive_datagram(datagram, self._peer, time.time()) self._worker_scope = None self._handle_timer(expiration) + await self._handle_events() + # We clear this now, before sending anything, as sending can cause + # context switches that do more sends. We want to know if that + # happens so we don't block a long time on the recv() above. + self._send_pending = False datagrams = self._connection.datagrams_to_send(time.time()) for datagram, _ in datagrams: await self._socket.send(datagram) - await self._handle_events() finally: self._done = True self._handshake_complete.set() @@ -116,11 +129,13 @@ class TrioQuicConnection(AsyncQuicConnection): await stream._add_input(event.data, event.end_stream) elif isinstance(event, aioquic.quic.events.HandshakeCompleted): self._handshake_complete.set() - elif isinstance( - event, aioquic.quic.events.ConnectionTerminated - ) or isinstance(event, aioquic.quic.events.StreamReset): + elif isinstance(event, aioquic.quic.events.ConnectionTerminated): self._done = True self._socket.close() + elif isinstance(event, aioquic.quic.events.StreamReset): + stream = self._streams.get(event.stream_id) + if stream: + await stream._add_input(b"", True) count += 1 if count > 10: # yield @@ -129,6 +144,7 @@ class TrioQuicConnection(AsyncQuicConnection): async def write(self, stream, data, is_end=False): self._connection.send_stream_data(stream, data, is_end) + self._send_pending = True if self._worker_scope is not None: self._worker_scope.cancel() @@ -159,6 +175,7 @@ class TrioQuicConnection(AsyncQuicConnection): self._manager.closed(self._peer[0], self._peer[1]) self._closed = True self._connection.close() + self._send_pending = True if self._worker_scope is not None: self._worker_scope.cancel() await self._run_done.wait() @@ -171,8 +188,12 @@ class TrioQuicManager(AsyncQuicManager): super().__init__(conf, verify_mode, TrioQuicConnection, server_name) self._nursery = nursery - def connect(self, address, port=853, source=None, source_port=0): - (connection, start) = self._connect(address, port, source, source_port) + def connect( + self, address, port=853, source=None, source_port=0, want_session_ticket=True + ): + (connection, start) = self._connect( + address, port, source, source_port, want_session_ticket + ) if start: self._nursery.start_soon(connection.run) return connection diff --git a/lib/dns/rdata.py b/lib/dns/rdata.py index 0d262e8d..024fd8f6 100644 --- a/lib/dns/rdata.py +++ b/lib/dns/rdata.py @@ -199,7 +199,7 @@ class Rdata: self, origin: Optional[dns.name.Name] = None, relativize: bool = True, - **kw: Dict[str, Any] + **kw: Dict[str, Any], ) -> str: """Convert an rdata to text format. @@ -547,9 +547,7 @@ class Rdata: @classmethod def _as_ipv4_address(cls, value): if isinstance(value, str): - # call to check validity - dns.ipv4.inet_aton(value) - return value + return dns.ipv4.canonicalize(value) elif isinstance(value, bytes): return dns.ipv4.inet_ntoa(value) else: @@ -558,9 +556,7 @@ class Rdata: @classmethod def _as_ipv6_address(cls, value): if isinstance(value, str): - # call to check validity - dns.ipv6.inet_aton(value) - return value + return dns.ipv6.canonicalize(value) elif isinstance(value, bytes): return dns.ipv6.inet_ntoa(value) else: @@ -604,7 +600,6 @@ class Rdata: @dns.immutable.immutable class GenericRdata(Rdata): - """Generic Rdata Class This class is used for rdata types for which we have no better @@ -621,7 +616,7 @@ class GenericRdata(Rdata): self, origin: Optional[dns.name.Name] = None, relativize: bool = True, - **kw: Dict[str, Any] + **kw: Dict[str, Any], ) -> str: return r"\# %d " % len(self.data) + _hexify(self.data, **kw) @@ -647,9 +642,9 @@ class GenericRdata(Rdata): return cls(rdclass, rdtype, parser.get_remaining()) -_rdata_classes: Dict[ - Tuple[dns.rdataclass.RdataClass, dns.rdatatype.RdataType], Any -] = {} +_rdata_classes: Dict[Tuple[dns.rdataclass.RdataClass, dns.rdatatype.RdataType], Any] = ( + {} +) _module_prefix = "dns.rdtypes" diff --git a/lib/dns/rdataset.py b/lib/dns/rdataset.py index 31124afc..8bff58d7 100644 --- a/lib/dns/rdataset.py +++ b/lib/dns/rdataset.py @@ -28,6 +28,7 @@ import dns.name import dns.rdata import dns.rdataclass import dns.rdatatype +import dns.renderer import dns.set import dns.ttl @@ -45,7 +46,6 @@ class IncompatibleTypes(dns.exception.DNSException): class Rdataset(dns.set.Set): - """A DNS rdataset.""" __slots__ = ["rdclass", "rdtype", "covers", "ttl"] @@ -316,11 +316,9 @@ class Rdataset(dns.set.Set): want_shuffle = False else: rdclass = self.rdclass - file.seek(0, io.SEEK_END) if len(self) == 0: name.to_wire(file, compress, origin) - stuff = struct.pack("!HHIH", self.rdtype, rdclass, 0, 0) - file.write(stuff) + file.write(struct.pack("!HHIH", self.rdtype, rdclass, 0, 0)) return 1 else: l: Union[Rdataset, List[dns.rdata.Rdata]] @@ -331,16 +329,9 @@ class Rdataset(dns.set.Set): l = self for rd in l: name.to_wire(file, compress, origin) - stuff = struct.pack("!HHIH", self.rdtype, rdclass, self.ttl, 0) - file.write(stuff) - start = file.tell() - rd.to_wire(file, compress, origin) - end = file.tell() - assert end - start < 65536 - file.seek(start - 2) - stuff = struct.pack("!H", end - start) - file.write(stuff) - file.seek(0, io.SEEK_END) + file.write(struct.pack("!HHI", self.rdtype, rdclass, self.ttl)) + with dns.renderer.prefixed_length(file, 2): + rd.to_wire(file, compress, origin) return len(self) def match( @@ -373,7 +364,6 @@ class Rdataset(dns.set.Set): @dns.immutable.immutable class ImmutableRdataset(Rdataset): # lgtm[py/missing-equals] - """An immutable DNS rdataset.""" _clone_class = Rdataset diff --git a/lib/dns/rdtypes/ANY/AFSDB.py b/lib/dns/rdtypes/ANY/AFSDB.py index 3d287f6e..06a3b970 100644 --- a/lib/dns/rdtypes/ANY/AFSDB.py +++ b/lib/dns/rdtypes/ANY/AFSDB.py @@ -21,7 +21,6 @@ import dns.rdtypes.mxbase @dns.immutable.immutable class AFSDB(dns.rdtypes.mxbase.UncompressedDowncasingMX): - """AFSDB record""" # Use the property mechanism to make "subtype" an alias for the diff --git a/lib/dns/rdtypes/ANY/AMTRELAY.py b/lib/dns/rdtypes/ANY/AMTRELAY.py index dfe7abc3..ed2b072b 100644 --- a/lib/dns/rdtypes/ANY/AMTRELAY.py +++ b/lib/dns/rdtypes/ANY/AMTRELAY.py @@ -32,7 +32,6 @@ class Relay(dns.rdtypes.util.Gateway): @dns.immutable.immutable class AMTRELAY(dns.rdata.Rdata): - """AMTRELAY record""" # see: RFC 8777 diff --git a/lib/dns/rdtypes/ANY/AVC.py b/lib/dns/rdtypes/ANY/AVC.py index 766d5e2d..a27ae2d6 100644 --- a/lib/dns/rdtypes/ANY/AVC.py +++ b/lib/dns/rdtypes/ANY/AVC.py @@ -21,7 +21,6 @@ import dns.rdtypes.txtbase @dns.immutable.immutable class AVC(dns.rdtypes.txtbase.TXTBase): - """AVC record""" # See: IANA dns parameters for AVC diff --git a/lib/dns/rdtypes/ANY/CAA.py b/lib/dns/rdtypes/ANY/CAA.py index 8afb538c..2e6a7e7e 100644 --- a/lib/dns/rdtypes/ANY/CAA.py +++ b/lib/dns/rdtypes/ANY/CAA.py @@ -25,7 +25,6 @@ import dns.tokenizer @dns.immutable.immutable class CAA(dns.rdata.Rdata): - """CAA (Certification Authority Authorization) record""" # see: RFC 6844 diff --git a/lib/dns/rdtypes/ANY/CDNSKEY.py b/lib/dns/rdtypes/ANY/CDNSKEY.py index 38b8a8da..b613409f 100644 --- a/lib/dns/rdtypes/ANY/CDNSKEY.py +++ b/lib/dns/rdtypes/ANY/CDNSKEY.py @@ -30,5 +30,4 @@ from dns.rdtypes.dnskeybase import ( # noqa: F401 lgtm[py/unused-import] @dns.immutable.immutable class CDNSKEY(dns.rdtypes.dnskeybase.DNSKEYBase): - """CDNSKEY record""" diff --git a/lib/dns/rdtypes/ANY/CDS.py b/lib/dns/rdtypes/ANY/CDS.py index 2ff42d9a..8312b972 100644 --- a/lib/dns/rdtypes/ANY/CDS.py +++ b/lib/dns/rdtypes/ANY/CDS.py @@ -21,7 +21,6 @@ import dns.rdtypes.dsbase @dns.immutable.immutable class CDS(dns.rdtypes.dsbase.DSBase): - """CDS record""" _digest_length_by_type = { diff --git a/lib/dns/rdtypes/ANY/CERT.py b/lib/dns/rdtypes/ANY/CERT.py index 30fe863f..f369cc85 100644 --- a/lib/dns/rdtypes/ANY/CERT.py +++ b/lib/dns/rdtypes/ANY/CERT.py @@ -67,7 +67,6 @@ def _ctype_to_text(what): @dns.immutable.immutable class CERT(dns.rdata.Rdata): - """CERT record""" # see RFC 4398 diff --git a/lib/dns/rdtypes/ANY/CNAME.py b/lib/dns/rdtypes/ANY/CNAME.py index 759adb90..665e407c 100644 --- a/lib/dns/rdtypes/ANY/CNAME.py +++ b/lib/dns/rdtypes/ANY/CNAME.py @@ -21,7 +21,6 @@ import dns.rdtypes.nsbase @dns.immutable.immutable class CNAME(dns.rdtypes.nsbase.NSBase): - """CNAME record Note: although CNAME is officially a singleton type, dnspython allows diff --git a/lib/dns/rdtypes/ANY/CSYNC.py b/lib/dns/rdtypes/ANY/CSYNC.py index 315da9ff..2f972f6e 100644 --- a/lib/dns/rdtypes/ANY/CSYNC.py +++ b/lib/dns/rdtypes/ANY/CSYNC.py @@ -32,7 +32,6 @@ class Bitmap(dns.rdtypes.util.Bitmap): @dns.immutable.immutable class CSYNC(dns.rdata.Rdata): - """CSYNC record""" __slots__ = ["serial", "flags", "windows"] diff --git a/lib/dns/rdtypes/ANY/DLV.py b/lib/dns/rdtypes/ANY/DLV.py index 632e90f8..6c134f18 100644 --- a/lib/dns/rdtypes/ANY/DLV.py +++ b/lib/dns/rdtypes/ANY/DLV.py @@ -21,5 +21,4 @@ import dns.rdtypes.dsbase @dns.immutable.immutable class DLV(dns.rdtypes.dsbase.DSBase): - """DLV record""" diff --git a/lib/dns/rdtypes/ANY/DNAME.py b/lib/dns/rdtypes/ANY/DNAME.py index 556bff59..bbf9186c 100644 --- a/lib/dns/rdtypes/ANY/DNAME.py +++ b/lib/dns/rdtypes/ANY/DNAME.py @@ -21,7 +21,6 @@ import dns.rdtypes.nsbase @dns.immutable.immutable class DNAME(dns.rdtypes.nsbase.UncompressedNS): - """DNAME record""" def _to_wire(self, file, compress=None, origin=None, canonicalize=False): diff --git a/lib/dns/rdtypes/ANY/DNSKEY.py b/lib/dns/rdtypes/ANY/DNSKEY.py index f1a63062..6d961a9f 100644 --- a/lib/dns/rdtypes/ANY/DNSKEY.py +++ b/lib/dns/rdtypes/ANY/DNSKEY.py @@ -30,5 +30,4 @@ from dns.rdtypes.dnskeybase import ( # noqa: F401 lgtm[py/unused-import] @dns.immutable.immutable class DNSKEY(dns.rdtypes.dnskeybase.DNSKEYBase): - """DNSKEY record""" diff --git a/lib/dns/rdtypes/ANY/DS.py b/lib/dns/rdtypes/ANY/DS.py index 097ecfa0..58b3108d 100644 --- a/lib/dns/rdtypes/ANY/DS.py +++ b/lib/dns/rdtypes/ANY/DS.py @@ -21,5 +21,4 @@ import dns.rdtypes.dsbase @dns.immutable.immutable class DS(dns.rdtypes.dsbase.DSBase): - """DS record""" diff --git a/lib/dns/rdtypes/ANY/EUI48.py b/lib/dns/rdtypes/ANY/EUI48.py index 7e4e1ff3..c843be50 100644 --- a/lib/dns/rdtypes/ANY/EUI48.py +++ b/lib/dns/rdtypes/ANY/EUI48.py @@ -22,7 +22,6 @@ import dns.rdtypes.euibase @dns.immutable.immutable class EUI48(dns.rdtypes.euibase.EUIBase): - """EUI48 record""" # see: rfc7043.txt diff --git a/lib/dns/rdtypes/ANY/EUI64.py b/lib/dns/rdtypes/ANY/EUI64.py index 68b5820f..f6d7e257 100644 --- a/lib/dns/rdtypes/ANY/EUI64.py +++ b/lib/dns/rdtypes/ANY/EUI64.py @@ -22,7 +22,6 @@ import dns.rdtypes.euibase @dns.immutable.immutable class EUI64(dns.rdtypes.euibase.EUIBase): - """EUI64 record""" # see: rfc7043.txt diff --git a/lib/dns/rdtypes/ANY/GPOS.py b/lib/dns/rdtypes/ANY/GPOS.py index 30aab321..312338f9 100644 --- a/lib/dns/rdtypes/ANY/GPOS.py +++ b/lib/dns/rdtypes/ANY/GPOS.py @@ -44,7 +44,6 @@ def _validate_float_string(what): @dns.immutable.immutable class GPOS(dns.rdata.Rdata): - """GPOS record""" # see: RFC 1712 diff --git a/lib/dns/rdtypes/ANY/HINFO.py b/lib/dns/rdtypes/ANY/HINFO.py index 513c155a..c2c45de0 100644 --- a/lib/dns/rdtypes/ANY/HINFO.py +++ b/lib/dns/rdtypes/ANY/HINFO.py @@ -25,7 +25,6 @@ import dns.tokenizer @dns.immutable.immutable class HINFO(dns.rdata.Rdata): - """HINFO record""" # see: RFC 1035 diff --git a/lib/dns/rdtypes/ANY/HIP.py b/lib/dns/rdtypes/ANY/HIP.py index a20aa1e5..91669139 100644 --- a/lib/dns/rdtypes/ANY/HIP.py +++ b/lib/dns/rdtypes/ANY/HIP.py @@ -27,7 +27,6 @@ import dns.rdatatype @dns.immutable.immutable class HIP(dns.rdata.Rdata): - """HIP record""" # see: RFC 5205 diff --git a/lib/dns/rdtypes/ANY/ISDN.py b/lib/dns/rdtypes/ANY/ISDN.py index 536a35d6..fb01eab3 100644 --- a/lib/dns/rdtypes/ANY/ISDN.py +++ b/lib/dns/rdtypes/ANY/ISDN.py @@ -25,7 +25,6 @@ import dns.tokenizer @dns.immutable.immutable class ISDN(dns.rdata.Rdata): - """ISDN record""" # see: RFC 1183 diff --git a/lib/dns/rdtypes/ANY/L32.py b/lib/dns/rdtypes/ANY/L32.py index 14be01f9..09804c2d 100644 --- a/lib/dns/rdtypes/ANY/L32.py +++ b/lib/dns/rdtypes/ANY/L32.py @@ -8,7 +8,6 @@ import dns.rdata @dns.immutable.immutable class L32(dns.rdata.Rdata): - """L32 record""" # see: rfc6742.txt diff --git a/lib/dns/rdtypes/ANY/L64.py b/lib/dns/rdtypes/ANY/L64.py index d083d403..fb76808e 100644 --- a/lib/dns/rdtypes/ANY/L64.py +++ b/lib/dns/rdtypes/ANY/L64.py @@ -8,7 +8,6 @@ import dns.rdtypes.util @dns.immutable.immutable class L64(dns.rdata.Rdata): - """L64 record""" # see: rfc6742.txt diff --git a/lib/dns/rdtypes/ANY/LOC.py b/lib/dns/rdtypes/ANY/LOC.py index 783d54af..a36a2c10 100644 --- a/lib/dns/rdtypes/ANY/LOC.py +++ b/lib/dns/rdtypes/ANY/LOC.py @@ -105,7 +105,6 @@ def _check_coordinate_list(value, low, high): @dns.immutable.immutable class LOC(dns.rdata.Rdata): - """LOC record""" # see: RFC 1876 diff --git a/lib/dns/rdtypes/ANY/LP.py b/lib/dns/rdtypes/ANY/LP.py index 8a7c5125..312663f1 100644 --- a/lib/dns/rdtypes/ANY/LP.py +++ b/lib/dns/rdtypes/ANY/LP.py @@ -8,7 +8,6 @@ import dns.rdata @dns.immutable.immutable class LP(dns.rdata.Rdata): - """LP record""" # see: rfc6742.txt diff --git a/lib/dns/rdtypes/ANY/MX.py b/lib/dns/rdtypes/ANY/MX.py index 1f9df21f..0c300c5a 100644 --- a/lib/dns/rdtypes/ANY/MX.py +++ b/lib/dns/rdtypes/ANY/MX.py @@ -21,5 +21,4 @@ import dns.rdtypes.mxbase @dns.immutable.immutable class MX(dns.rdtypes.mxbase.MXBase): - """MX record""" diff --git a/lib/dns/rdtypes/ANY/NID.py b/lib/dns/rdtypes/ANY/NID.py index ad54aca3..2f649178 100644 --- a/lib/dns/rdtypes/ANY/NID.py +++ b/lib/dns/rdtypes/ANY/NID.py @@ -8,7 +8,6 @@ import dns.rdtypes.util @dns.immutable.immutable class NID(dns.rdata.Rdata): - """NID record""" # see: rfc6742.txt diff --git a/lib/dns/rdtypes/ANY/NINFO.py b/lib/dns/rdtypes/ANY/NINFO.py index 55bc5614..b177bddb 100644 --- a/lib/dns/rdtypes/ANY/NINFO.py +++ b/lib/dns/rdtypes/ANY/NINFO.py @@ -21,7 +21,6 @@ import dns.rdtypes.txtbase @dns.immutable.immutable class NINFO(dns.rdtypes.txtbase.TXTBase): - """NINFO record""" # see: draft-reid-dnsext-zs-01 diff --git a/lib/dns/rdtypes/ANY/NS.py b/lib/dns/rdtypes/ANY/NS.py index fe453f0d..c3f34ce9 100644 --- a/lib/dns/rdtypes/ANY/NS.py +++ b/lib/dns/rdtypes/ANY/NS.py @@ -21,5 +21,4 @@ import dns.rdtypes.nsbase @dns.immutable.immutable class NS(dns.rdtypes.nsbase.NSBase): - """NS record""" diff --git a/lib/dns/rdtypes/ANY/NSEC.py b/lib/dns/rdtypes/ANY/NSEC.py index a2d98fa7..340525a6 100644 --- a/lib/dns/rdtypes/ANY/NSEC.py +++ b/lib/dns/rdtypes/ANY/NSEC.py @@ -30,7 +30,6 @@ class Bitmap(dns.rdtypes.util.Bitmap): @dns.immutable.immutable class NSEC(dns.rdata.Rdata): - """NSEC record""" __slots__ = ["next", "windows"] diff --git a/lib/dns/rdtypes/ANY/NSEC3.py b/lib/dns/rdtypes/ANY/NSEC3.py index d32fe169..d71302b7 100644 --- a/lib/dns/rdtypes/ANY/NSEC3.py +++ b/lib/dns/rdtypes/ANY/NSEC3.py @@ -46,7 +46,6 @@ class Bitmap(dns.rdtypes.util.Bitmap): @dns.immutable.immutable class NSEC3(dns.rdata.Rdata): - """NSEC3 record""" __slots__ = ["algorithm", "flags", "iterations", "salt", "next", "windows"] @@ -64,9 +63,13 @@ class NSEC3(dns.rdata.Rdata): windows = Bitmap(windows) self.windows = tuple(windows.windows) - def to_text(self, origin=None, relativize=True, **kw): + def _next_text(self): next = base64.b32encode(self.next).translate(b32_normal_to_hex).lower().decode() next = next.rstrip("=") + return next + + def to_text(self, origin=None, relativize=True, **kw): + next = self._next_text() if self.salt == b"": salt = "-" else: @@ -118,3 +121,6 @@ class NSEC3(dns.rdata.Rdata): next = parser.get_counted_bytes() bitmap = Bitmap.from_wire_parser(parser) return cls(rdclass, rdtype, algorithm, flags, iterations, salt, next, bitmap) + + def next_name(self, origin=None): + return dns.name.from_text(self._next_text(), origin) diff --git a/lib/dns/rdtypes/ANY/NSEC3PARAM.py b/lib/dns/rdtypes/ANY/NSEC3PARAM.py index 1a0c0e08..d1e62ebc 100644 --- a/lib/dns/rdtypes/ANY/NSEC3PARAM.py +++ b/lib/dns/rdtypes/ANY/NSEC3PARAM.py @@ -25,7 +25,6 @@ import dns.rdata @dns.immutable.immutable class NSEC3PARAM(dns.rdata.Rdata): - """NSEC3PARAM record""" __slots__ = ["algorithm", "flags", "iterations", "salt"] diff --git a/lib/dns/rdtypes/ANY/OPENPGPKEY.py b/lib/dns/rdtypes/ANY/OPENPGPKEY.py index e5e25727..4d7a4b6c 100644 --- a/lib/dns/rdtypes/ANY/OPENPGPKEY.py +++ b/lib/dns/rdtypes/ANY/OPENPGPKEY.py @@ -25,7 +25,6 @@ import dns.tokenizer @dns.immutable.immutable class OPENPGPKEY(dns.rdata.Rdata): - """OPENPGPKEY record""" # see: RFC 7929 diff --git a/lib/dns/rdtypes/ANY/OPT.py b/lib/dns/rdtypes/ANY/OPT.py index d70e5373..d343dfa5 100644 --- a/lib/dns/rdtypes/ANY/OPT.py +++ b/lib/dns/rdtypes/ANY/OPT.py @@ -28,7 +28,6 @@ import dns.rdata @dns.immutable.immutable class OPT(dns.rdata.Rdata): - """OPT record""" __slots__ = ["options"] diff --git a/lib/dns/rdtypes/ANY/PTR.py b/lib/dns/rdtypes/ANY/PTR.py index 7fd5547d..98c36167 100644 --- a/lib/dns/rdtypes/ANY/PTR.py +++ b/lib/dns/rdtypes/ANY/PTR.py @@ -21,5 +21,4 @@ import dns.rdtypes.nsbase @dns.immutable.immutable class PTR(dns.rdtypes.nsbase.NSBase): - """PTR record""" diff --git a/lib/dns/rdtypes/ANY/RP.py b/lib/dns/rdtypes/ANY/RP.py index 9c64c6e2..9b74549d 100644 --- a/lib/dns/rdtypes/ANY/RP.py +++ b/lib/dns/rdtypes/ANY/RP.py @@ -23,7 +23,6 @@ import dns.rdata @dns.immutable.immutable class RP(dns.rdata.Rdata): - """RP record""" # see: RFC 1183 diff --git a/lib/dns/rdtypes/ANY/RRSIG.py b/lib/dns/rdtypes/ANY/RRSIG.py index 11605026..8beb4237 100644 --- a/lib/dns/rdtypes/ANY/RRSIG.py +++ b/lib/dns/rdtypes/ANY/RRSIG.py @@ -28,7 +28,6 @@ import dns.rdatatype class BadSigTime(dns.exception.DNSException): - """Time in DNS SIG or RRSIG resource record cannot be parsed.""" @@ -52,7 +51,6 @@ def posixtime_to_sigtime(what): @dns.immutable.immutable class RRSIG(dns.rdata.Rdata): - """RRSIG record""" __slots__ = [ diff --git a/lib/dns/rdtypes/ANY/RT.py b/lib/dns/rdtypes/ANY/RT.py index 950f2a06..5a4d45cf 100644 --- a/lib/dns/rdtypes/ANY/RT.py +++ b/lib/dns/rdtypes/ANY/RT.py @@ -21,5 +21,4 @@ import dns.rdtypes.mxbase @dns.immutable.immutable class RT(dns.rdtypes.mxbase.UncompressedDowncasingMX): - """RT record""" diff --git a/lib/dns/rdtypes/ANY/SOA.py b/lib/dns/rdtypes/ANY/SOA.py index bde55e15..09aa8321 100644 --- a/lib/dns/rdtypes/ANY/SOA.py +++ b/lib/dns/rdtypes/ANY/SOA.py @@ -25,7 +25,6 @@ import dns.rdata @dns.immutable.immutable class SOA(dns.rdata.Rdata): - """SOA record""" # see: RFC 1035 diff --git a/lib/dns/rdtypes/ANY/SPF.py b/lib/dns/rdtypes/ANY/SPF.py index c403589a..1df3b705 100644 --- a/lib/dns/rdtypes/ANY/SPF.py +++ b/lib/dns/rdtypes/ANY/SPF.py @@ -21,7 +21,6 @@ import dns.rdtypes.txtbase @dns.immutable.immutable class SPF(dns.rdtypes.txtbase.TXTBase): - """SPF record""" # see: RFC 4408 diff --git a/lib/dns/rdtypes/ANY/SSHFP.py b/lib/dns/rdtypes/ANY/SSHFP.py index 67805452..d2c4b073 100644 --- a/lib/dns/rdtypes/ANY/SSHFP.py +++ b/lib/dns/rdtypes/ANY/SSHFP.py @@ -25,7 +25,6 @@ import dns.rdatatype @dns.immutable.immutable class SSHFP(dns.rdata.Rdata): - """SSHFP record""" # See RFC 4255 diff --git a/lib/dns/rdtypes/ANY/TKEY.py b/lib/dns/rdtypes/ANY/TKEY.py index d5f5fc45..5b490b82 100644 --- a/lib/dns/rdtypes/ANY/TKEY.py +++ b/lib/dns/rdtypes/ANY/TKEY.py @@ -25,7 +25,6 @@ import dns.rdata @dns.immutable.immutable class TKEY(dns.rdata.Rdata): - """TKEY Record""" __slots__ = [ diff --git a/lib/dns/rdtypes/ANY/TLSA.py b/lib/dns/rdtypes/ANY/TLSA.py index c9ba1991..4dffc553 100644 --- a/lib/dns/rdtypes/ANY/TLSA.py +++ b/lib/dns/rdtypes/ANY/TLSA.py @@ -6,5 +6,4 @@ import dns.rdtypes.tlsabase @dns.immutable.immutable class TLSA(dns.rdtypes.tlsabase.TLSABase): - """TLSA record""" diff --git a/lib/dns/rdtypes/ANY/TSIG.py b/lib/dns/rdtypes/ANY/TSIG.py index 1ae87ebe..79423826 100644 --- a/lib/dns/rdtypes/ANY/TSIG.py +++ b/lib/dns/rdtypes/ANY/TSIG.py @@ -26,7 +26,6 @@ import dns.rdata @dns.immutable.immutable class TSIG(dns.rdata.Rdata): - """TSIG record""" __slots__ = [ diff --git a/lib/dns/rdtypes/ANY/TXT.py b/lib/dns/rdtypes/ANY/TXT.py index f4e61930..6d4dae27 100644 --- a/lib/dns/rdtypes/ANY/TXT.py +++ b/lib/dns/rdtypes/ANY/TXT.py @@ -21,5 +21,4 @@ import dns.rdtypes.txtbase @dns.immutable.immutable class TXT(dns.rdtypes.txtbase.TXTBase): - """TXT record""" diff --git a/lib/dns/rdtypes/ANY/URI.py b/lib/dns/rdtypes/ANY/URI.py index 7463e277..2efbb305 100644 --- a/lib/dns/rdtypes/ANY/URI.py +++ b/lib/dns/rdtypes/ANY/URI.py @@ -27,7 +27,6 @@ import dns.rdtypes.util @dns.immutable.immutable class URI(dns.rdata.Rdata): - """URI record""" # see RFC 7553 diff --git a/lib/dns/rdtypes/ANY/X25.py b/lib/dns/rdtypes/ANY/X25.py index 06c14534..8375611d 100644 --- a/lib/dns/rdtypes/ANY/X25.py +++ b/lib/dns/rdtypes/ANY/X25.py @@ -25,7 +25,6 @@ import dns.tokenizer @dns.immutable.immutable class X25(dns.rdata.Rdata): - """X25 record""" # see RFC 1183 diff --git a/lib/dns/rdtypes/ANY/ZONEMD.py b/lib/dns/rdtypes/ANY/ZONEMD.py index 3062843b..c90e3ee1 100644 --- a/lib/dns/rdtypes/ANY/ZONEMD.py +++ b/lib/dns/rdtypes/ANY/ZONEMD.py @@ -11,7 +11,6 @@ import dns.zonetypes @dns.immutable.immutable class ZONEMD(dns.rdata.Rdata): - """ZONEMD record""" # See RFC 8976 diff --git a/lib/dns/rdtypes/CH/A.py b/lib/dns/rdtypes/CH/A.py index e457f38a..583a88ac 100644 --- a/lib/dns/rdtypes/CH/A.py +++ b/lib/dns/rdtypes/CH/A.py @@ -23,7 +23,6 @@ import dns.rdtypes.mxbase @dns.immutable.immutable class A(dns.rdata.Rdata): - """A record for Chaosnet""" # domain: the domain of the address diff --git a/lib/dns/rdtypes/IN/A.py b/lib/dns/rdtypes/IN/A.py index 713d5eea..e09d6110 100644 --- a/lib/dns/rdtypes/IN/A.py +++ b/lib/dns/rdtypes/IN/A.py @@ -24,7 +24,6 @@ import dns.tokenizer @dns.immutable.immutable class A(dns.rdata.Rdata): - """A record.""" __slots__ = ["address"] diff --git a/lib/dns/rdtypes/IN/AAAA.py b/lib/dns/rdtypes/IN/AAAA.py index f8237b44..0cd139e7 100644 --- a/lib/dns/rdtypes/IN/AAAA.py +++ b/lib/dns/rdtypes/IN/AAAA.py @@ -24,7 +24,6 @@ import dns.tokenizer @dns.immutable.immutable class AAAA(dns.rdata.Rdata): - """AAAA record.""" __slots__ = ["address"] diff --git a/lib/dns/rdtypes/IN/APL.py b/lib/dns/rdtypes/IN/APL.py index f1bb01db..44cb3fef 100644 --- a/lib/dns/rdtypes/IN/APL.py +++ b/lib/dns/rdtypes/IN/APL.py @@ -29,7 +29,6 @@ import dns.tokenizer @dns.immutable.immutable class APLItem: - """An APL list item.""" __slots__ = ["family", "negation", "address", "prefix"] @@ -80,7 +79,6 @@ class APLItem: @dns.immutable.immutable class APL(dns.rdata.Rdata): - """APL record.""" # see: RFC 3123 diff --git a/lib/dns/rdtypes/IN/DHCID.py b/lib/dns/rdtypes/IN/DHCID.py index 65f85897..723492fa 100644 --- a/lib/dns/rdtypes/IN/DHCID.py +++ b/lib/dns/rdtypes/IN/DHCID.py @@ -24,7 +24,6 @@ import dns.rdata @dns.immutable.immutable class DHCID(dns.rdata.Rdata): - """DHCID record""" # see: RFC 4701 diff --git a/lib/dns/rdtypes/IN/IPSECKEY.py b/lib/dns/rdtypes/IN/IPSECKEY.py index 8bb2bcb6..e3a66157 100644 --- a/lib/dns/rdtypes/IN/IPSECKEY.py +++ b/lib/dns/rdtypes/IN/IPSECKEY.py @@ -29,7 +29,6 @@ class Gateway(dns.rdtypes.util.Gateway): @dns.immutable.immutable class IPSECKEY(dns.rdata.Rdata): - """IPSECKEY record""" # see: RFC 4025 diff --git a/lib/dns/rdtypes/IN/KX.py b/lib/dns/rdtypes/IN/KX.py index a03d1d51..6073df47 100644 --- a/lib/dns/rdtypes/IN/KX.py +++ b/lib/dns/rdtypes/IN/KX.py @@ -21,5 +21,4 @@ import dns.rdtypes.mxbase @dns.immutable.immutable class KX(dns.rdtypes.mxbase.UncompressedDowncasingMX): - """KX record""" diff --git a/lib/dns/rdtypes/IN/NAPTR.py b/lib/dns/rdtypes/IN/NAPTR.py index 1f1f5a12..195d1cba 100644 --- a/lib/dns/rdtypes/IN/NAPTR.py +++ b/lib/dns/rdtypes/IN/NAPTR.py @@ -33,7 +33,6 @@ def _write_string(file, s): @dns.immutable.immutable class NAPTR(dns.rdata.Rdata): - """NAPTR record""" # see: RFC 3403 diff --git a/lib/dns/rdtypes/IN/NSAP.py b/lib/dns/rdtypes/IN/NSAP.py index be8581e6..a4854b3f 100644 --- a/lib/dns/rdtypes/IN/NSAP.py +++ b/lib/dns/rdtypes/IN/NSAP.py @@ -25,7 +25,6 @@ import dns.tokenizer @dns.immutable.immutable class NSAP(dns.rdata.Rdata): - """NSAP record.""" # see: RFC 1706 diff --git a/lib/dns/rdtypes/IN/NSAP_PTR.py b/lib/dns/rdtypes/IN/NSAP_PTR.py index 0a18fdce..ce1c6632 100644 --- a/lib/dns/rdtypes/IN/NSAP_PTR.py +++ b/lib/dns/rdtypes/IN/NSAP_PTR.py @@ -21,5 +21,4 @@ import dns.rdtypes.nsbase @dns.immutable.immutable class NSAP_PTR(dns.rdtypes.nsbase.UncompressedNS): - """NSAP-PTR record""" diff --git a/lib/dns/rdtypes/IN/PX.py b/lib/dns/rdtypes/IN/PX.py index 5c0aa81e..cdca1532 100644 --- a/lib/dns/rdtypes/IN/PX.py +++ b/lib/dns/rdtypes/IN/PX.py @@ -26,7 +26,6 @@ import dns.rdtypes.util @dns.immutable.immutable class PX(dns.rdata.Rdata): - """PX record.""" # see: RFC 2163 diff --git a/lib/dns/rdtypes/IN/SRV.py b/lib/dns/rdtypes/IN/SRV.py index 84c54007..5adef98f 100644 --- a/lib/dns/rdtypes/IN/SRV.py +++ b/lib/dns/rdtypes/IN/SRV.py @@ -26,7 +26,6 @@ import dns.rdtypes.util @dns.immutable.immutable class SRV(dns.rdata.Rdata): - """SRV record""" # see: RFC 2782 diff --git a/lib/dns/rdtypes/IN/WKS.py b/lib/dns/rdtypes/IN/WKS.py index 26d287a3..881a7849 100644 --- a/lib/dns/rdtypes/IN/WKS.py +++ b/lib/dns/rdtypes/IN/WKS.py @@ -33,7 +33,6 @@ except OSError: @dns.immutable.immutable class WKS(dns.rdata.Rdata): - """WKS record""" # see: RFC 1035 diff --git a/lib/dns/rdtypes/dnskeybase.py b/lib/dns/rdtypes/dnskeybase.py index 3bfcf860..db300f8b 100644 --- a/lib/dns/rdtypes/dnskeybase.py +++ b/lib/dns/rdtypes/dnskeybase.py @@ -36,7 +36,6 @@ class Flag(enum.IntFlag): @dns.immutable.immutable class DNSKEYBase(dns.rdata.Rdata): - """Base class for rdata that is like a DNSKEY record""" __slots__ = ["flags", "protocol", "algorithm", "key"] diff --git a/lib/dns/rdtypes/dsbase.py b/lib/dns/rdtypes/dsbase.py index 1ad0b7a5..cd21f026 100644 --- a/lib/dns/rdtypes/dsbase.py +++ b/lib/dns/rdtypes/dsbase.py @@ -26,7 +26,6 @@ import dns.rdatatype @dns.immutable.immutable class DSBase(dns.rdata.Rdata): - """Base class for rdata that is like a DS record""" __slots__ = ["key_tag", "algorithm", "digest_type", "digest"] diff --git a/lib/dns/rdtypes/euibase.py b/lib/dns/rdtypes/euibase.py index 4c4068b2..751087b4 100644 --- a/lib/dns/rdtypes/euibase.py +++ b/lib/dns/rdtypes/euibase.py @@ -22,7 +22,6 @@ import dns.rdata @dns.immutable.immutable class EUIBase(dns.rdata.Rdata): - """EUIxx record""" # see: rfc7043.txt diff --git a/lib/dns/rdtypes/mxbase.py b/lib/dns/rdtypes/mxbase.py index a6bae078..6d5e3d87 100644 --- a/lib/dns/rdtypes/mxbase.py +++ b/lib/dns/rdtypes/mxbase.py @@ -28,7 +28,6 @@ import dns.rdtypes.util @dns.immutable.immutable class MXBase(dns.rdata.Rdata): - """Base class for rdata that is like an MX record.""" __slots__ = ["preference", "exchange"] @@ -71,7 +70,6 @@ class MXBase(dns.rdata.Rdata): @dns.immutable.immutable class UncompressedMX(MXBase): - """Base class for rdata that is like an MX record, but whose name is not compressed when converted to DNS wire format, and whose digestable form is not downcased.""" @@ -82,7 +80,6 @@ class UncompressedMX(MXBase): @dns.immutable.immutable class UncompressedDowncasingMX(MXBase): - """Base class for rdata that is like an MX record, but whose name is not compressed when convert to DNS wire format.""" diff --git a/lib/dns/rdtypes/nsbase.py b/lib/dns/rdtypes/nsbase.py index 56d94235..904224f0 100644 --- a/lib/dns/rdtypes/nsbase.py +++ b/lib/dns/rdtypes/nsbase.py @@ -25,7 +25,6 @@ import dns.rdata @dns.immutable.immutable class NSBase(dns.rdata.Rdata): - """Base class for rdata that is like an NS record.""" __slots__ = ["target"] @@ -56,7 +55,6 @@ class NSBase(dns.rdata.Rdata): @dns.immutable.immutable class UncompressedNS(NSBase): - """Base class for rdata that is like an NS record, but whose name is not compressed when convert to DNS wire format, and whose digestable form is not downcased.""" diff --git a/lib/dns/rdtypes/svcbbase.py b/lib/dns/rdtypes/svcbbase.py index ba5b53d2..05652413 100644 --- a/lib/dns/rdtypes/svcbbase.py +++ b/lib/dns/rdtypes/svcbbase.py @@ -2,7 +2,6 @@ import base64 import enum -import io import struct import dns.enum @@ -13,6 +12,7 @@ import dns.ipv6 import dns.name import dns.rdata import dns.rdtypes.util +import dns.renderer import dns.tokenizer import dns.wire @@ -427,7 +427,6 @@ def _validate_and_define(params, key, value): @dns.immutable.immutable class SVCBBase(dns.rdata.Rdata): - """Base class for SVCB-like records""" # see: draft-ietf-dnsop-svcb-https-11 @@ -521,19 +520,10 @@ class SVCBBase(dns.rdata.Rdata): for key in sorted(self.params): file.write(struct.pack("!H", key)) value = self.params[key] - # placeholder for length (or actual length of empty values) - file.write(struct.pack("!H", 0)) - if value is None: - continue - else: - start = file.tell() - value.to_wire(file, origin) - end = file.tell() - assert end - start < 65536 - file.seek(start - 2) - stuff = struct.pack("!H", end - start) - file.write(stuff) - file.seek(0, io.SEEK_END) + with dns.renderer.prefixed_length(file, 2): + # Note that we're still writing a length of zero if the value is None + if value is not None: + value.to_wire(file, origin) @classmethod def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): diff --git a/lib/dns/rdtypes/tlsabase.py b/lib/dns/rdtypes/tlsabase.py index 4cdb7ab3..a059d2c4 100644 --- a/lib/dns/rdtypes/tlsabase.py +++ b/lib/dns/rdtypes/tlsabase.py @@ -25,7 +25,6 @@ import dns.rdatatype @dns.immutable.immutable class TLSABase(dns.rdata.Rdata): - """Base class for TLSA and SMIMEA records""" # see: RFC 6698 diff --git a/lib/dns/rdtypes/txtbase.py b/lib/dns/rdtypes/txtbase.py index fdbfb646..44d6df57 100644 --- a/lib/dns/rdtypes/txtbase.py +++ b/lib/dns/rdtypes/txtbase.py @@ -17,18 +17,17 @@ """TXT-like base class.""" -import struct from typing import Any, Dict, Iterable, Optional, Tuple, Union import dns.exception import dns.immutable import dns.rdata +import dns.renderer import dns.tokenizer @dns.immutable.immutable class TXTBase(dns.rdata.Rdata): - """Base class for rdata that is like a TXT record (see RFC 1035).""" __slots__ = ["strings"] @@ -56,7 +55,7 @@ class TXTBase(dns.rdata.Rdata): self, origin: Optional[dns.name.Name] = None, relativize: bool = True, - **kw: Dict[str, Any] + **kw: Dict[str, Any], ) -> str: txt = "" prefix = "" @@ -93,10 +92,8 @@ class TXTBase(dns.rdata.Rdata): def _to_wire(self, file, compress=None, origin=None, canonicalize=False): for s in self.strings: - l = len(s) - assert l < 256 - file.write(struct.pack("!B", l)) - file.write(s) + with dns.renderer.prefixed_length(file, 1): + file.write(s) @classmethod def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): diff --git a/lib/dns/renderer.py b/lib/dns/renderer.py index 53e7c0f6..a77481f6 100644 --- a/lib/dns/renderer.py +++ b/lib/dns/renderer.py @@ -32,6 +32,24 @@ AUTHORITY = 2 ADDITIONAL = 3 +@contextlib.contextmanager +def prefixed_length(output, length_length): + output.write(b"\00" * length_length) + start = output.tell() + yield + end = output.tell() + length = end - start + if length > 0: + try: + output.seek(start - length_length) + try: + output.write(length.to_bytes(length_length, "big")) + except OverflowError: + raise dns.exception.FormError + finally: + output.seek(end) + + class Renderer: """Helper class for building DNS wire-format messages. @@ -134,6 +152,15 @@ class Renderer: self._rollback(start) raise dns.exception.TooBig + @contextlib.contextmanager + def _temporarily_seek_to(self, where): + current = self.output.tell() + try: + self.output.seek(where) + yield + finally: + self.output.seek(current) + def add_question(self, qname, rdtype, rdclass=dns.rdataclass.IN): """Add a question to the message.""" @@ -269,18 +296,14 @@ class Renderer: with self._track_size(): keyname.to_wire(self.output, compress, self.origin) self.output.write( - struct.pack("!HHIH", dns.rdatatype.TSIG, dns.rdataclass.ANY, 0, 0) + struct.pack("!HHI", dns.rdatatype.TSIG, dns.rdataclass.ANY, 0) ) - rdata_start = self.output.tell() - tsig.to_wire(self.output) + with prefixed_length(self.output, 2): + tsig.to_wire(self.output) - after = self.output.tell() - self.output.seek(rdata_start - 2) - self.output.write(struct.pack("!H", after - rdata_start)) self.counts[ADDITIONAL] += 1 - self.output.seek(10) - self.output.write(struct.pack("!H", self.counts[ADDITIONAL])) - self.output.seek(0, io.SEEK_END) + with self._temporarily_seek_to(10): + self.output.write(struct.pack("!H", self.counts[ADDITIONAL])) def write_header(self): """Write the DNS message header. @@ -290,19 +313,18 @@ class Renderer: is added. """ - self.output.seek(0) - self.output.write( - struct.pack( - "!HHHHHH", - self.id, - self.flags, - self.counts[0], - self.counts[1], - self.counts[2], - self.counts[3], + with self._temporarily_seek_to(0): + self.output.write( + struct.pack( + "!HHHHHH", + self.id, + self.flags, + self.counts[0], + self.counts[1], + self.counts[2], + self.counts[3], + ) ) - ) - self.output.seek(0, io.SEEK_END) def get_wire(self): """Return the wire format message.""" diff --git a/lib/dns/rrset.py b/lib/dns/rrset.py index 350de13e..6f39b108 100644 --- a/lib/dns/rrset.py +++ b/lib/dns/rrset.py @@ -26,7 +26,6 @@ import dns.renderer class RRset(dns.rdataset.Rdataset): - """A DNS RRset (named rdataset). RRset inherits from Rdataset, and RRsets can be treated as @@ -132,7 +131,7 @@ class RRset(dns.rdataset.Rdataset): self, origin: Optional[dns.name.Name] = None, relativize: bool = True, - **kw: Dict[str, Any] + **kw: Dict[str, Any], ) -> str: """Convert the RRset into DNS zone file format. @@ -159,7 +158,7 @@ class RRset(dns.rdataset.Rdataset): file: Any, compress: Optional[dns.name.CompressType] = None, # type: ignore origin: Optional[dns.name.Name] = None, - **kw: Dict[str, Any] + **kw: Dict[str, Any], ) -> int: """Convert the RRset to wire format. @@ -231,7 +230,7 @@ def from_text( ttl: int, rdclass: Union[dns.rdataclass.RdataClass, str], rdtype: Union[dns.rdatatype.RdataType, str], - *text_rdatas: Any + *text_rdatas: Any, ) -> RRset: """Create an RRset with the specified name, TTL, class, and type and with the specified rdatas in text format. diff --git a/lib/dns/set.py b/lib/dns/set.py index fa50ed97..f0fb0d50 100644 --- a/lib/dns/set.py +++ b/lib/dns/set.py @@ -19,7 +19,6 @@ import itertools class Set: - """A simple set class. This class was originally used to deal with sets being missing in diff --git a/lib/dns/transaction.py b/lib/dns/transaction.py index 21dea775..84e54f7d 100644 --- a/lib/dns/transaction.py +++ b/lib/dns/transaction.py @@ -203,7 +203,7 @@ class Transaction: - name - - name, rdataclass, rdatatype, [covers] + - name, rdatatype, [covers] - name, rdataset... @@ -222,7 +222,7 @@ class Transaction: - name - - name, rdataclass, rdatatype, [covers] + - name, rdatatype, [covers] - name, rdataset... diff --git a/lib/dns/tsig.py b/lib/dns/tsig.py index 58760f5f..780852e8 100644 --- a/lib/dns/tsig.py +++ b/lib/dns/tsig.py @@ -29,47 +29,38 @@ import dns.rdataclass class BadTime(dns.exception.DNSException): - """The current time is not within the TSIG's validity time.""" class BadSignature(dns.exception.DNSException): - """The TSIG signature fails to verify.""" class BadKey(dns.exception.DNSException): - """The TSIG record owner name does not match the key.""" class BadAlgorithm(dns.exception.DNSException): - """The TSIG algorithm does not match the key.""" class PeerError(dns.exception.DNSException): - """Base class for all TSIG errors generated by the remote peer""" class PeerBadKey(PeerError): - """The peer didn't know the key we used""" class PeerBadSignature(PeerError): - """The peer didn't like the signature we sent""" class PeerBadTime(PeerError): - """The peer didn't like the time we sent""" class PeerBadTruncation(PeerError): - """The peer didn't like amount of truncation in the TSIG we sent""" diff --git a/lib/dns/version.py b/lib/dns/version.py index 1f1fbf2d..251f2583 100644 --- a/lib/dns/version.py +++ b/lib/dns/version.py @@ -20,9 +20,9 @@ #: MAJOR MAJOR = 2 #: MINOR -MINOR = 4 +MINOR = 6 #: MICRO -MICRO = 2 +MICRO = 1 #: RELEASELEVEL RELEASELEVEL = 0x0F #: SERIAL diff --git a/lib/dns/win32util.py b/lib/dns/win32util.py index b2ca61da..aaa7e93e 100644 --- a/lib/dns/win32util.py +++ b/lib/dns/win32util.py @@ -1,5 +1,7 @@ import sys +import dns._features + if sys.platform == "win32": from typing import Any @@ -15,14 +17,14 @@ if sys.platform == "win32": except KeyError: WindowsError = Exception - try: + if dns._features.have("wmi"): import threading import pythoncom # pylint: disable=import-error import wmi # pylint: disable=import-error _have_wmi = True - except Exception: + else: _have_wmi = False def _config_domain(domain): @@ -51,9 +53,10 @@ if sys.platform == "win32": try: system = wmi.WMI() for interface in system.Win32_NetworkAdapterConfiguration(): - if interface.IPEnabled and interface.DNSDomain: - self.info.domain = _config_domain(interface.DNSDomain) + if interface.IPEnabled and interface.DNSServerSearchOrder: self.info.nameservers = list(interface.DNSServerSearchOrder) + if interface.DNSDomain: + self.info.domain = _config_domain(interface.DNSDomain) if interface.DNSDomainSuffixSearchOrder: self.info.search = [ _config_domain(x) diff --git a/lib/dns/zone.py b/lib/dns/zone.py index 9e763f5f..844919e4 100644 --- a/lib/dns/zone.py +++ b/lib/dns/zone.py @@ -21,7 +21,18 @@ import contextlib import io import os import struct -from typing import Any, Dict, Iterable, Iterator, List, Optional, Set, Tuple, Union +from typing import ( + Any, + Callable, + Iterable, + Iterator, + List, + MutableMapping, + Optional, + Set, + Tuple, + Union, +) import dns.exception import dns.grange @@ -43,47 +54,70 @@ from dns.zonetypes import DigestHashAlgorithm, DigestScheme, _digest_hashers class BadZone(dns.exception.DNSException): - """The DNS zone is malformed.""" class NoSOA(BadZone): - """The DNS zone has no SOA RR at its origin.""" class NoNS(BadZone): - """The DNS zone has no NS RRset at its origin.""" class UnknownOrigin(BadZone): - """The DNS zone's origin is unknown.""" class UnsupportedDigestScheme(dns.exception.DNSException): - """The zone digest's scheme is unsupported.""" class UnsupportedDigestHashAlgorithm(dns.exception.DNSException): - """The zone digest's origin is unsupported.""" class NoDigest(dns.exception.DNSException): - """The DNS zone has no ZONEMD RRset at its origin.""" class DigestVerificationFailure(dns.exception.DNSException): - """The ZONEMD digest failed to verify.""" -class Zone(dns.transaction.TransactionManager): +def _validate_name( + name: dns.name.Name, + origin: Optional[dns.name.Name], + relativize: bool, +) -> dns.name.Name: + # This name validation code is shared by Zone and Version + if origin is None: + # This should probably never happen as other code (e.g. + # _rr_line) will notice the lack of an origin before us, but + # we check just in case! + raise KeyError("no zone origin is defined") + if name.is_absolute(): + if not name.is_subdomain(origin): + raise KeyError("name parameter must be a subdomain of the zone origin") + if relativize: + name = name.relativize(origin) + else: + # We have a relative name. Make sure that the derelativized name is + # not too long. + try: + abs_name = name.derelativize(origin) + except dns.name.NameTooLong: + # We map dns.name.NameTooLong to KeyError to be consistent with + # the other exceptions above. + raise KeyError("relative name too long for zone") + if not relativize: + # We have a relative name in a non-relative zone, so use the + # derelativized name. + name = abs_name + return name + +class Zone(dns.transaction.TransactionManager): """A DNS zone. A ``Zone`` is a mapping from names to nodes. The zone object may be @@ -94,7 +128,10 @@ class Zone(dns.transaction.TransactionManager): the zone. """ - node_factory = dns.node.Node + node_factory: Callable[[], dns.node.Node] = dns.node.Node + map_factory: Callable[[], MutableMapping[dns.name.Name, dns.node.Node]] = dict + writable_version_factory: Optional[Callable[[], "WritableVersion"]] = None + immutable_version_factory: Optional[Callable[[], "ImmutableVersion"]] = None __slots__ = ["rdclass", "origin", "nodes", "relativize"] @@ -125,7 +162,7 @@ class Zone(dns.transaction.TransactionManager): raise ValueError("origin parameter must be an absolute name") self.origin = origin self.rdclass = rdclass - self.nodes: Dict[dns.name.Name, dns.node.Node] = {} + self.nodes: MutableMapping[dns.name.Name, dns.node.Node] = self.map_factory() self.relativize = relativize def __eq__(self, other): @@ -154,26 +191,13 @@ class Zone(dns.transaction.TransactionManager): return not self.__eq__(other) def _validate_name(self, name: Union[dns.name.Name, str]) -> dns.name.Name: + # Note that any changes in this method should have corresponding changes + # made in the Version _validate_name() method. if isinstance(name, str): name = dns.name.from_text(name, None) elif not isinstance(name, dns.name.Name): raise KeyError("name parameter must be convertible to a DNS name") - if name.is_absolute(): - if self.origin is None: - # This should probably never happen as other code (e.g. - # _rr_line) will notice the lack of an origin before us, but - # we check just in case! - raise KeyError("no zone origin is defined") - if not name.is_subdomain(self.origin): - raise KeyError("name parameter must be a subdomain of the zone origin") - if self.relativize: - name = name.relativize(self.origin) - elif not self.relativize: - # We have a relative name in a non-relative zone, so derelativize. - if self.origin is None: - raise KeyError("no zone origin is defined") - name = name.derelativize(self.origin) - return name + return _validate_name(name, self.origin, self.relativize) def __getitem__(self, key): key = self._validate_name(key) @@ -252,9 +276,6 @@ class Zone(dns.transaction.TransactionManager): *create*, a ``bool``. If true, the node will be created if it does not exist. - Raises ``KeyError`` if the name is not known and create was - not specified, or if the name was not a subdomain of the origin. - Returns a ``dns.node.Node`` or ``None``. """ @@ -527,9 +548,6 @@ class Zone(dns.transaction.TransactionManager): *create*, a ``bool``. If true, the node will be created if it does not exist. - Raises ``KeyError`` if the name is not known and create was - not specified, or if the name was not a subdomain of the origin. - Returns a ``dns.rrset.RRset`` or ``None``. """ @@ -952,7 +970,7 @@ class Version: self, zone: Zone, id: int, - nodes: Optional[Dict[dns.name.Name, dns.node.Node]] = None, + nodes: Optional[MutableMapping[dns.name.Name, dns.node.Node]] = None, origin: Optional[dns.name.Name] = None, ): self.zone = zone @@ -960,26 +978,11 @@ class Version: if nodes is not None: self.nodes = nodes else: - self.nodes = {} + self.nodes = zone.map_factory() self.origin = origin def _validate_name(self, name: dns.name.Name) -> dns.name.Name: - if name.is_absolute(): - if self.origin is None: - # This should probably never happen as other code (e.g. - # _rr_line) will notice the lack of an origin before us, but - # we check just in case! - raise KeyError("no zone origin is defined") - if not name.is_subdomain(self.origin): - raise KeyError("name is not a subdomain of the zone origin") - if self.zone.relativize: - name = name.relativize(self.origin) - elif not self.zone.relativize: - # We have a relative name in a non-relative zone, so derelativize. - if self.origin is None: - raise KeyError("no zone origin is defined") - name = name.derelativize(self.origin) - return name + return _validate_name(name, self.origin, self.zone.relativize) def get_node(self, name: dns.name.Name) -> Optional[dns.node.Node]: name = self._validate_name(name) @@ -1085,7 +1088,9 @@ class ImmutableVersion(Version): version.nodes[name] = ImmutableVersionedNode(node) # We're changing the type of the nodes dictionary here on purpose, so # we ignore the mypy error. - self.nodes = dns.immutable.Dict(version.nodes, True) # type: ignore + self.nodes = dns.immutable.Dict( + version.nodes, True, self.zone.map_factory + ) # type: ignore class Transaction(dns.transaction.Transaction): @@ -1101,7 +1106,10 @@ class Transaction(dns.transaction.Transaction): def _setup_version(self): assert self.version is None - self.version = WritableVersion(self.zone, self.replacement) + factory = self.manager.writable_version_factory + if factory is None: + factory = WritableVersion + self.version = factory(self.zone, self.replacement) def _get_rdataset(self, name, rdtype, covers): return self.version.get_rdataset(name, rdtype, covers) @@ -1132,7 +1140,10 @@ class Transaction(dns.transaction.Transaction): self.zone._end_read(self) elif commit and len(self.version.changed) > 0: if self.make_immutable: - version = ImmutableVersion(self.version) + factory = self.manager.immutable_version_factory + if factory is None: + factory = ImmutableVersion + version = factory(self.version) else: version = self.version self.zone._commit_version(self, version, self.version.origin) @@ -1168,6 +1179,48 @@ class Transaction(dns.transaction.Transaction): return (absolute, relativize, effective) +def _from_text( + text: Any, + origin: Optional[Union[dns.name.Name, str]] = None, + rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN, + relativize: bool = True, + zone_factory: Any = Zone, + filename: Optional[str] = None, + allow_include: bool = False, + check_origin: bool = True, + idna_codec: Optional[dns.name.IDNACodec] = None, + allow_directives: Union[bool, Iterable[str]] = True, +) -> Zone: + # See the comments for the public APIs from_text() and from_file() for + # details. + + # 'text' can also be a file, but we don't publish that fact + # since it's an implementation detail. The official file + # interface is from_file(). + + if filename is None: + filename = "" + zone = zone_factory(origin, rdclass, relativize=relativize) + with zone.writer(True) as txn: + tok = dns.tokenizer.Tokenizer(text, filename, idna_codec=idna_codec) + reader = dns.zonefile.Reader( + tok, + rdclass, + txn, + allow_include=allow_include, + allow_directives=allow_directives, + ) + try: + reader.read() + except dns.zonefile.UnknownOrigin: + # for backwards compatibility + raise dns.zone.UnknownOrigin + # Now that we're done reading, do some basic checking of the zone. + if check_origin: + zone.check_origin() + return zone + + def from_text( text: str, origin: Optional[Union[dns.name.Name, str]] = None, @@ -1228,32 +1281,18 @@ def from_text( Returns a subclass of ``dns.zone.Zone``. """ - - # 'text' can also be a file, but we don't publish that fact - # since it's an implementation detail. The official file - # interface is from_file(). - - if filename is None: - filename = "" - zone = zone_factory(origin, rdclass, relativize=relativize) - with zone.writer(True) as txn: - tok = dns.tokenizer.Tokenizer(text, filename, idna_codec=idna_codec) - reader = dns.zonefile.Reader( - tok, - rdclass, - txn, - allow_include=allow_include, - allow_directives=allow_directives, - ) - try: - reader.read() - except dns.zonefile.UnknownOrigin: - # for backwards compatibility - raise dns.zone.UnknownOrigin - # Now that we're done reading, do some basic checking of the zone. - if check_origin: - zone.check_origin() - return zone + return _from_text( + text, + origin, + rdclass, + relativize, + zone_factory, + filename, + allow_include, + check_origin, + idna_codec, + allow_directives, + ) def from_file( @@ -1324,7 +1363,7 @@ def from_file( else: cm = contextlib.nullcontext(f) with cm as f: - return from_text( + return _from_text( f, origin, rdclass, diff --git a/lib/dns/zonefile.py b/lib/dns/zonefile.py index 27f04924..af064e73 100644 --- a/lib/dns/zonefile.py +++ b/lib/dns/zonefile.py @@ -86,7 +86,6 @@ def _upper_dollarize(s): class Reader: - """Read a DNS zone file into a transaction.""" def __init__( diff --git a/requirements.txt b/requirements.txt index fe84492e..64458e26 100644 --- a/requirements.txt +++ b/requirements.txt @@ -10,7 +10,7 @@ cheroot==10.0.0 cherrypy==18.8.0 cloudinary==1.34.0 distro==1.9.0 -dnspython==2.4.2 +dnspython==2.6.1 facebook-sdk==3.1.0 future==0.18.3 ga4mp==2.0.4 From faef9a94c443c7681839725fa4d715c8a45bc125 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 24 Mar 2024 15:25:44 -0700 Subject: [PATCH 086/290] Bump cherrypy from 18.8.0 to 18.9.0 (#2266) * Bump cherrypy from 18.8.0 to 18.9.0 Bumps [cherrypy](https://github.com/cherrypy/cherrypy) from 18.8.0 to 18.9.0. - [Changelog](https://github.com/cherrypy/cherrypy/blob/main/CHANGES.rst) - [Commits](https://github.com/cherrypy/cherrypy/compare/v18.8.0...v18.9.0) --- updated-dependencies: - dependency-name: cherrypy dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] * Update cherrypy==18.9.0 --------- Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> [skip ci] --- lib/PyWin32.chm | Bin 0 -> 2648456 bytes lib/adodbapi/__init__.py | 74 + lib/adodbapi/ado_consts.py | 281 + lib/adodbapi/adodbapi.py | 1223 ++++ lib/adodbapi/apibase.py | 794 +++ lib/adodbapi/examples/db_print.py | 72 + lib/adodbapi/examples/db_table_names.py | 20 + lib/adodbapi/examples/xls_read.py | 41 + lib/adodbapi/examples/xls_write.py | 41 + lib/adodbapi/is64bit.py | 41 + lib/adodbapi/license.txt | 506 ++ lib/adodbapi/process_connect_string.py | 144 + lib/adodbapi/readme.txt | 92 + lib/adodbapi/remote.py | 634 ++ lib/adodbapi/schema_table.py | 15 + lib/adodbapi/setup.py | 70 + lib/adodbapi/test/adodbapitest.py | 1692 ++++++ lib/adodbapi/test/adodbapitestconfig.py | 221 + lib/adodbapi/test/dbapi20.py | 939 +++ lib/adodbapi/test/is64bit.py | 41 + lib/adodbapi/test/setuptestframework.py | 134 + lib/adodbapi/test/test_adodbapi_dbapi20.py | 200 + lib/adodbapi/test/tryconnection.py | 33 + lib/annotated_types/__init__.py | 396 ++ .../__init__.py => annotated_types/py.typed} | 0 lib/annotated_types/test_cases.py | 147 + lib/autocommand/autoasync.py | 8 +- lib/cherrypy/_cplogging.py | 6 +- lib/cherrypy/lib/cptools.py | 12 +- lib/cherrypy/lib/profiler.py | 4 +- lib/cherrypy/lib/reprconf.py | 2 +- lib/cherrypy/lib/static.py | 12 +- lib/cherrypy/process/wspbus.py | 2 +- lib/cherrypy/test/test_http.py | 15 + lib/cherrypy/test/test_iterator.py | 2 + lib/cherrypy/test/test_logging.py | 28 + lib/inflect/__init__.py | 180 +- lib/inflect/compat/__init__.py | 0 lib/inflect/compat/pydantic.py | 19 + lib/inflect/compat/pydantic1.py | 8 + lib/isapi/README.txt | 7 + lib/isapi/__init__.py | 39 + lib/isapi/doc/isapi.html | 92 + lib/isapi/install.py | 815 +++ lib/isapi/isapicon.py | 120 + lib/isapi/samples/README.txt | 20 + lib/isapi/samples/advanced.py | 218 + lib/isapi/samples/redirector.py | 125 + lib/isapi/samples/redirector_asynch.py | 85 + lib/isapi/samples/redirector_with_filter.py | 161 + lib/isapi/samples/test.py | 195 + lib/isapi/simple.py | 70 + lib/isapi/test/README.txt | 3 + lib/isapi/test/extension_simple.py | 119 + lib/isapi/threaded_extension.py | 189 + .../__init__.py} | 152 +- lib/jaraco/collections/py.typed | 0 lib/jaraco/context.py | 75 + .../{functools.py => functools/__init__.py} | 155 +- lib/jaraco/functools/__init__.pyi | 128 + lib/jaraco/functools/py.typed | 0 lib/jaraco/text/__init__.py | 18 +- lib/jaraco/text/show-newlines.py | 4 +- lib/jaraco/text/strip-prefix.py | 21 + lib/more_itertools/__init__.py | 2 +- lib/more_itertools/more.py | 143 +- lib/more_itertools/more.pyi | 23 +- lib/more_itertools/recipes.py | 107 +- lib/more_itertools/recipes.pyi | 16 +- lib/pydantic/__init__.py | 373 +- lib/pydantic/_internal/__init__.py | 0 lib/pydantic/_internal/_config.py | 322 ++ lib/pydantic/_internal/_core_metadata.py | 92 + lib/pydantic/_internal/_core_utils.py | 570 ++ lib/pydantic/_internal/_dataclasses.py | 225 + lib/pydantic/_internal/_decorators.py | 791 +++ lib/pydantic/_internal/_decorators_v1.py | 181 + .../_internal/_discriminated_union.py | 506 ++ lib/pydantic/_internal/_fields.py | 319 ++ lib/pydantic/_internal/_forward_ref.py | 23 + lib/pydantic/_internal/_generate_schema.py | 2231 ++++++++ lib/pydantic/_internal/_generics.py | 517 ++ lib/pydantic/_internal/_git.py | 26 + lib/pydantic/_internal/_internal_dataclass.py | 10 + .../_internal/_known_annotated_metadata.py | 410 ++ lib/pydantic/_internal/_mock_val_ser.py | 140 + lib/pydantic/_internal/_model_construction.py | 637 +++ lib/pydantic/_internal/_repr.py | 117 + .../_internal/_schema_generation_shared.py | 124 + lib/pydantic/_internal/_signature.py | 164 + lib/pydantic/_internal/_std_types_schema.py | 714 +++ lib/pydantic/_internal/_typing_extra.py | 469 ++ lib/pydantic/_internal/_utils.py | 362 ++ lib/pydantic/_internal/_validate_call.py | 84 + lib/pydantic/_internal/_validators.py | 278 + lib/pydantic/_migration.py | 308 + lib/pydantic/alias_generators.py | 50 + lib/pydantic/aliases.py | 112 + lib/pydantic/annotated_handlers.py | 120 + lib/pydantic/class_validators.py | 344 +- lib/pydantic/color.py | 285 +- lib/pydantic/config.py | 1048 +++- lib/pydantic/dataclasses.py | 632 +- lib/pydantic/datetime_parse.py | 250 +- lib/pydantic/decorator.py | 266 +- lib/pydantic/deprecated/__init__.py | 0 lib/pydantic/deprecated/class_validators.py | 253 + lib/pydantic/deprecated/config.py | 72 + lib/pydantic/deprecated/copy_internals.py | 224 + lib/pydantic/deprecated/decorator.py | 279 + lib/pydantic/deprecated/json.py | 140 + lib/pydantic/deprecated/parse.py | 80 + lib/pydantic/deprecated/tools.py | 103 + lib/pydantic/env_settings.py | 348 +- lib/pydantic/error_wrappers.py | 164 +- lib/pydantic/errors.py | 728 +-- lib/pydantic/fields.py | 2201 ++++--- lib/pydantic/functional_serializers.py | 395 ++ lib/pydantic/functional_validators.py | 706 +++ lib/pydantic/generics.py | 366 +- lib/pydantic/json.py | 114 +- lib/pydantic/json_schema.py | 2425 ++++++++ lib/pydantic/main.py | 2273 +++++--- lib/pydantic/mypy.py | 1199 ++-- lib/pydantic/networks.py | 1202 ++-- lib/pydantic/parse.py | 68 +- lib/pydantic/plugin/__init__.py | 170 + lib/pydantic/plugin/_loader.py | 50 + lib/pydantic/plugin/_schema_validator.py | 138 + lib/pydantic/root_model.py | 149 + lib/pydantic/schema.py | 1155 +--- lib/pydantic/tools.py | 94 +- lib/pydantic/type_adapter.py | 460 ++ lib/pydantic/types.py | 3382 ++++++++--- lib/pydantic/typing.py | 604 +- lib/pydantic/utils.py | 843 +-- lib/pydantic/v1/__init__.py | 131 + lib/pydantic/{ => v1}/_hypothesis_plugin.py | 9 +- lib/pydantic/{ => v1}/annotated_types.py | 0 lib/pydantic/v1/class_validators.py | 361 ++ lib/pydantic/v1/color.py | 494 ++ lib/pydantic/v1/config.py | 191 + lib/pydantic/v1/dataclasses.py | 500 ++ lib/pydantic/v1/datetime_parse.py | 248 + lib/pydantic/v1/decorator.py | 264 + lib/pydantic/v1/env_settings.py | 350 ++ lib/pydantic/v1/error_wrappers.py | 161 + lib/pydantic/v1/errors.py | 646 +++ lib/pydantic/v1/fields.py | 1253 ++++ lib/pydantic/v1/generics.py | 400 ++ lib/pydantic/v1/json.py | 112 + lib/pydantic/v1/main.py | 1107 ++++ lib/pydantic/v1/mypy.py | 944 +++ lib/pydantic/v1/networks.py | 747 +++ lib/pydantic/v1/parse.py | 66 + lib/pydantic/v1/py.typed | 0 lib/pydantic/v1/schema.py | 1163 ++++ lib/pydantic/v1/tools.py | 92 + lib/pydantic/v1/types.py | 1205 ++++ lib/pydantic/v1/typing.py | 603 ++ lib/pydantic/v1/utils.py | 803 +++ lib/pydantic/v1/validators.py | 765 +++ lib/pydantic/v1/version.py | 38 + lib/pydantic/validate_call_decorator.py | 67 + lib/pydantic/validators.py | 767 +-- lib/pydantic/version.py | 84 +- lib/pydantic/warnings.py | 58 + lib/pydantic_core/__init__.py | 139 + lib/pydantic_core/_pydantic_core.pyi | 882 +++ lib/pydantic_core/core_schema.py | 3980 +++++++++++++ lib/pydantic_core/py.typed | 0 lib/pythoncom.py | 4 + lib/pythonwin/license.txt | 30 + .../pywin/Demos/app/basictimerapp.py | 258 + lib/pythonwin/pywin/Demos/app/customprint.py | 186 + lib/pythonwin/pywin/Demos/app/demoutils.py | 65 + lib/pythonwin/pywin/Demos/app/dlgappdemo.py | 51 + lib/pythonwin/pywin/Demos/app/dojobapp.py | 72 + lib/pythonwin/pywin/Demos/app/helloapp.py | 53 + lib/pythonwin/pywin/Demos/cmdserver.py | 116 + lib/pythonwin/pywin/Demos/createwin.py | 114 + lib/pythonwin/pywin/Demos/demoutils.py | 67 + lib/pythonwin/pywin/Demos/dibdemo.py | 73 + lib/pythonwin/pywin/Demos/dlgtest.py | 145 + lib/pythonwin/pywin/Demos/dyndlg.py | 104 + lib/pythonwin/pywin/Demos/fontdemo.py | 86 + lib/pythonwin/pywin/Demos/guidemo.py | 86 + lib/pythonwin/pywin/Demos/hiertest.py | 138 + lib/pythonwin/pywin/Demos/menutest.py | 13 + lib/pythonwin/pywin/Demos/objdoc.py | 57 + lib/pythonwin/pywin/Demos/ocx/__init__.py | 0 lib/pythonwin/pywin/Demos/ocx/demoutils.py | 67 + lib/pythonwin/pywin/Demos/ocx/flash.py | 95 + lib/pythonwin/pywin/Demos/ocx/msoffice.py | 152 + .../pywin/Demos/ocx/ocxserialtest.py | 133 + lib/pythonwin/pywin/Demos/ocx/ocxtest.py | 250 + lib/pythonwin/pywin/Demos/ocx/webbrowser.py | 72 + lib/pythonwin/pywin/Demos/openGLDemo.py | 370 ++ lib/pythonwin/pywin/Demos/progressbar.py | 105 + lib/pythonwin/pywin/Demos/sliderdemo.py | 76 + lib/pythonwin/pywin/Demos/splittst.py | 79 + lib/pythonwin/pywin/Demos/threadedgui.py | 189 + lib/pythonwin/pywin/Demos/toolbar.py | 106 + lib/pythonwin/pywin/IDLE.cfg | 29 + lib/pythonwin/pywin/__init__.py | 10 + lib/pythonwin/pywin/default.cfg | 215 + lib/pythonwin/pywin/dialogs/__init__.py | 0 lib/pythonwin/pywin/dialogs/ideoptions.py | 139 + lib/pythonwin/pywin/dialogs/list.py | 143 + lib/pythonwin/pywin/dialogs/login.py | 156 + lib/pythonwin/pywin/dialogs/status.py | 242 + lib/pythonwin/pywin/docking/DockingBar.py | 679 +++ lib/pythonwin/pywin/docking/__init__.py | 0 lib/pythonwin/pywin/framework/__init__.py | 0 lib/pythonwin/pywin/framework/app.py | 457 ++ lib/pythonwin/pywin/framework/bitmap.py | 164 + lib/pythonwin/pywin/framework/cmdline.py | 56 + lib/pythonwin/pywin/framework/dbgcommands.py | 189 + lib/pythonwin/pywin/framework/dlgappcore.py | 75 + .../pywin/framework/editor/ModuleBrowser.py | 235 + .../pywin/framework/editor/__init__.py | 106 + .../pywin/framework/editor/color/__init__.py | 0 .../framework/editor/color/coloreditor.py | 664 +++ .../pywin/framework/editor/configui.py | 308 + .../pywin/framework/editor/document.py | 378 ++ .../pywin/framework/editor/editor.py | 516 ++ lib/pythonwin/pywin/framework/editor/frame.py | 74 + .../pywin/framework/editor/template.py | 60 + lib/pythonwin/pywin/framework/editor/vss.py | 104 + lib/pythonwin/pywin/framework/help.py | 173 + lib/pythonwin/pywin/framework/interact.py | 985 ++++ lib/pythonwin/pywin/framework/intpyapp.py | 555 ++ lib/pythonwin/pywin/framework/intpydde.py | 60 + .../pywin/framework/mdi_pychecker.py | 849 +++ lib/pythonwin/pywin/framework/scriptutils.py | 688 +++ lib/pythonwin/pywin/framework/sgrepmdi.py | 758 +++ lib/pythonwin/pywin/framework/startup.py | 80 + lib/pythonwin/pywin/framework/stdin.py | 176 + lib/pythonwin/pywin/framework/toolmenu.py | 284 + lib/pythonwin/pywin/framework/window.py | 14 + lib/pythonwin/pywin/framework/winout.py | 594 ++ lib/pythonwin/pywin/idle/AutoExpand.py | 95 + lib/pythonwin/pywin/idle/AutoIndent.py | 547 ++ lib/pythonwin/pywin/idle/CallTips.py | 219 + lib/pythonwin/pywin/idle/FormatParagraph.py | 166 + lib/pythonwin/pywin/idle/IdleHistory.py | 87 + lib/pythonwin/pywin/idle/PyParse.py | 591 ++ lib/pythonwin/pywin/idle/__init__.py | 1 + lib/pythonwin/pywin/mfc/__init__.py | 0 lib/pythonwin/pywin/mfc/activex.py | 86 + lib/pythonwin/pywin/mfc/afxres.py | 501 ++ lib/pythonwin/pywin/mfc/dialog.py | 278 + lib/pythonwin/pywin/mfc/docview.py | 151 + lib/pythonwin/pywin/mfc/object.py | 66 + lib/pythonwin/pywin/mfc/thread.py | 25 + lib/pythonwin/pywin/mfc/window.py | 50 + .../pywin/scintilla/IDLEenvironment.py | 598 ++ lib/pythonwin/pywin/scintilla/__init__.py | 1 + lib/pythonwin/pywin/scintilla/bindings.py | 178 + lib/pythonwin/pywin/scintilla/config.py | 365 ++ lib/pythonwin/pywin/scintilla/configui.py | 292 + lib/pythonwin/pywin/scintilla/control.py | 569 ++ lib/pythonwin/pywin/scintilla/document.py | 312 + lib/pythonwin/pywin/scintilla/find.py | 510 ++ lib/pythonwin/pywin/scintilla/formatter.py | 695 +++ lib/pythonwin/pywin/scintilla/keycodes.py | 190 + lib/pythonwin/pywin/scintilla/scintillacon.py | 2001 +++++++ lib/pythonwin/pywin/scintilla/view.py | 832 +++ lib/pythonwin/pywin/tools/TraceCollector.py | 79 + lib/pythonwin/pywin/tools/__init__.py | 1 + lib/pythonwin/pywin/tools/browseProjects.py | 324 ++ lib/pythonwin/pywin/tools/browser.py | 517 ++ lib/pythonwin/pywin/tools/hierlist.py | 367 ++ lib/pythonwin/pywin/tools/regedit.py | 386 ++ lib/pythonwin/pywin/tools/regpy.py | 81 + lib/pythonwin/start_pythonwin.pyw | 19 + lib/pywin32.version.txt | 1 + lib/tempora/timing.py | 13 +- lib/typing_extensions.py | 2142 +++++-- lib/win32/Demos/BackupRead_BackupWrite.py | 121 + lib/win32/Demos/BackupSeek_streamheaders.py | 137 + lib/win32/Demos/CopyFileEx.py | 57 + .../Demos/CreateFileTransacted_MiniVersion.py | 123 + lib/win32/Demos/EvtFormatMessage.py | 83 + lib/win32/Demos/EvtSubscribe_pull.py | 28 + lib/win32/Demos/EvtSubscribe_push.py | 25 + lib/win32/Demos/FileSecurityTest.py | 137 + lib/win32/Demos/GetSaveFileName.py | 43 + lib/win32/Demos/NetValidatePasswordPolicy.py | 127 + lib/win32/Demos/OpenEncryptedFileRaw.py | 67 + lib/win32/Demos/RegCreateKeyTransacted.py | 60 + lib/win32/Demos/RegRestoreKey.py | 71 + lib/win32/Demos/SystemParametersInfo.py | 210 + lib/win32/Demos/c_extension/setup.py | 26 + lib/win32/Demos/cerapi.py | 254 + lib/win32/Demos/dde/ddeclient.py | 18 + lib/win32/Demos/dde/ddeserver.py | 42 + lib/win32/Demos/desktopmanager.py | 246 + lib/win32/Demos/eventLogDemo.py | 142 + lib/win32/Demos/getfilever.py | 33 + lib/win32/Demos/images/frowny.bmp | Bin 0 -> 3126 bytes lib/win32/Demos/images/smiley.bmp | Bin 0 -> 3126 bytes lib/win32/Demos/mmapfile_demo.py | 102 + lib/win32/Demos/pipes/cat.py | 17 + lib/win32/Demos/pipes/runproc.py | 114 + lib/win32/Demos/print_desktop.py | 113 + lib/win32/Demos/rastest.py | 168 + .../Demos/security/GetTokenInformation.py | 110 + lib/win32/Demos/security/account_rights.py | 51 + lib/win32/Demos/security/explicit_entries.py | 171 + lib/win32/Demos/security/get_policy_info.py | 42 + lib/win32/Demos/security/list_rights.py | 37 + lib/win32/Demos/security/localized_names.py | 65 + lib/win32/Demos/security/lsaregevent.py | 14 + lib/win32/Demos/security/lsastore.py | 12 + lib/win32/Demos/security/query_information.py | 25 + lib/win32/Demos/security/regsave_sa.py | 61 + lib/win32/Demos/security/regsecurity.py | 36 + lib/win32/Demos/security/sa_inherit.py | 8 + lib/win32/Demos/security/security_enums.py | 336 ++ lib/win32/Demos/security/set_file_audit.py | 107 + lib/win32/Demos/security/set_file_owner.py | 74 + lib/win32/Demos/security/set_policy_info.py | 28 + .../Demos/security/setkernelobjectsecurity.py | 135 + .../Demos/security/setnamedsecurityinfo.py | 131 + lib/win32/Demos/security/setsecurityinfo.py | 132 + .../Demos/security/setuserobjectsecurity.py | 103 + lib/win32/Demos/security/sspi/fetch_url.py | 160 + lib/win32/Demos/security/sspi/simple_auth.py | 72 + .../Demos/security/sspi/socket_server.py | 201 + .../Demos/security/sspi/validate_password.py | 41 + .../Demos/service/nativePipeTestService.py | 63 + lib/win32/Demos/service/pipeTestService.py | 184 + .../Demos/service/pipeTestServiceClient.py | 156 + lib/win32/Demos/service/serviceEvents.py | 98 + lib/win32/Demos/timer_demo.py | 72 + lib/win32/Demos/win32clipboardDemo.py | 145 + lib/win32/Demos/win32clipboard_bitmapdemo.py | 117 + lib/win32/Demos/win32comport_demo.py | 144 + lib/win32/Demos/win32console_demo.py | 135 + lib/win32/Demos/win32cred_demo.py | 82 + lib/win32/Demos/win32fileDemo.py | 41 + lib/win32/Demos/win32gui_demo.py | 177 + lib/win32/Demos/win32gui_devicenotify.py | 107 + lib/win32/Demos/win32gui_dialog.py | 458 ++ lib/win32/Demos/win32gui_menu.py | 420 ++ lib/win32/Demos/win32gui_taskbar.py | 141 + lib/win32/Demos/win32netdemo.py | 274 + lib/win32/Demos/win32rcparser_demo.py | 86 + lib/win32/Demos/win32servicedemo.py | 23 + .../Demos/win32ts_logoff_disconnected.py | 24 + lib/win32/Demos/win32wnet/testwnet.py | 125 + lib/win32/Demos/win32wnet/winnetwk.py | 100 + lib/win32/Demos/winprocess.py | 230 + lib/win32/include/PyWinTypes.h | 727 +++ lib/win32/lib/afxres.py | 501 ++ lib/win32/lib/commctrl.py | 1551 +++++ lib/win32/lib/dbi.py | 27 + lib/win32/lib/mmsystem.py | 954 ++++ lib/win32/lib/netbios.py | 304 + lib/win32/lib/ntsecuritycon.py | 731 +++ lib/win32/lib/pywin32_bootstrap.py | 29 + lib/win32/lib/pywin32_testutil.py | 327 ++ lib/win32/lib/pywintypes.py | 126 + lib/win32/lib/rasutil.py | 40 + lib/win32/lib/regcheck.py | 162 + lib/win32/lib/regutil.py | 397 ++ lib/win32/lib/sspi.py | 412 ++ lib/win32/lib/sspicon.py | 477 ++ lib/win32/lib/win2kras.py | 7 + lib/win32/lib/win32con.py | 5083 +++++++++++++++++ lib/win32/lib/win32cryptcon.py | 1925 +++++++ lib/win32/lib/win32evtlogutil.py | 229 + lib/win32/lib/win32gui_struct.py | 999 ++++ lib/win32/lib/win32inetcon.py | 1086 ++++ lib/win32/lib/win32netcon.py | 627 ++ lib/win32/lib/win32pdhquery.py | 571 ++ lib/win32/lib/win32pdhutil.py | 210 + lib/win32/lib/win32rcparser.py | 677 +++ lib/win32/lib/win32serviceutil.py | 1071 ++++ lib/win32/lib/win32timezone.py | 1023 ++++ lib/win32/lib/win32traceutil.py | 59 + lib/win32/lib/win32verstamp.py | 236 + lib/win32/lib/winerror.py | 3039 ++++++++++ lib/win32/lib/winioctlcon.py | 1079 ++++ lib/win32/lib/winnt.py | 1371 +++++ lib/win32/lib/winperf.py | 236 + lib/win32/lib/winxptheme.py | 7 + lib/win32/license.txt | 30 + lib/win32/scripts/ControlService.py | 594 ++ .../scripts/VersionStamp/BrandProject.py | 98 + lib/win32/scripts/VersionStamp/bulkstamp.py | 149 + lib/win32/scripts/VersionStamp/vssutil.py | 204 + lib/win32/scripts/backupEventLog.py | 46 + lib/win32/scripts/ce/pysynch.py | 290 + lib/win32/scripts/killProcName.py | 62 + lib/win32/scripts/rasutil.py | 97 + lib/win32/scripts/regsetup.py | 612 ++ lib/win32/scripts/setup_d.py | 110 + lib/win32/test/handles.py | 171 + lib/win32/test/test_clipboard.py | 127 + lib/win32/test/test_exceptions.py | 223 + lib/win32/test/test_odbc.py | 267 + lib/win32/test/test_pywintypes.py | 116 + lib/win32/test/test_security.py | 166 + lib/win32/test/test_sspi.py | 231 + lib/win32/test/test_win32api.py | 268 + lib/win32/test/test_win32crypt.py | 129 + lib/win32/test/test_win32event.py | 119 + lib/win32/test/test_win32file.py | 1085 ++++ lib/win32/test/test_win32gui.py | 65 + lib/win32/test/test_win32guistruct.py | 330 ++ lib/win32/test/test_win32inet.py | 93 + lib/win32/test/test_win32net.py | 24 + lib/win32/test/test_win32pipe.py | 153 + lib/win32/test/test_win32print.py | 24 + lib/win32/test/test_win32profile.py | 18 + lib/win32/test/test_win32rcparser.py | 70 + lib/win32/test/test_win32timezone.py | 27 + lib/win32/test/test_win32trace.py | 369 ++ lib/win32/test/test_win32wnet.py | 175 + lib/win32/test/testall.py | 230 + lib/win32/test/win32rcparser/python.bmp | Bin 0 -> 778 bytes lib/win32/test/win32rcparser/python.ico | Bin 0 -> 766 bytes lib/win32/test/win32rcparser/test.h | 46 + lib/win32/test/win32rcparser/test.rc | 216 + lib/win32com/HTML/GeneratedSupport.html | 104 + lib/win32com/HTML/PythonCOM.html | 90 + lib/win32com/HTML/QuickStartClientCom.html | 82 + lib/win32com/HTML/QuickStartServerCom.html | 195 + lib/win32com/HTML/docindex.html | 22 + lib/win32com/HTML/image/BTN_HomePage.gif | Bin 0 -> 211 bytes lib/win32com/HTML/image/BTN_ManualTop.gif | Bin 0 -> 215 bytes lib/win32com/HTML/image/BTN_NextPage.gif | Bin 0 -> 218 bytes lib/win32com/HTML/image/BTN_PrevPage.gif | Bin 0 -> 216 bytes lib/win32com/HTML/image/blank.gif | Bin 0 -> 864 bytes lib/win32com/HTML/image/pycom_blowing.gif | Bin 0 -> 20926 bytes lib/win32com/HTML/image/pythoncom.gif | Bin 0 -> 5767 bytes lib/win32com/HTML/image/www_icon.gif | Bin 0 -> 275 bytes lib/win32com/HTML/index.html | 31 + lib/win32com/HTML/misc.html | 18 + lib/win32com/HTML/package.html | 37 + lib/win32com/HTML/variant.html | 162 + lib/win32com/License.txt | 30 + lib/win32com/__init__.py | 132 + lib/win32com/client/CLSIDToClass.py | 57 + lib/win32com/client/__init__.py | 714 +++ lib/win32com/client/build.py | 789 +++ lib/win32com/client/combrowse.py | 619 ++ lib/win32com/client/connect.py | 48 + lib/win32com/client/dynamic.py | 708 +++ lib/win32com/client/gencache.py | 799 +++ lib/win32com/client/genpy.py | 1411 +++++ lib/win32com/client/makepy.py | 459 ++ lib/win32com/client/selecttlb.py | 183 + lib/win32com/client/tlbrowse.py | 279 + lib/win32com/client/util.py | 102 + lib/win32com/demos/__init__.py | 0 lib/win32com/demos/connect.py | 100 + lib/win32com/demos/dump_clipboard.py | 74 + lib/win32com/demos/eventsApartmentThreaded.py | 98 + lib/win32com/demos/eventsFreeThreaded.py | 92 + lib/win32com/demos/excelAddin.py | 170 + lib/win32com/demos/excelRTDServer.py | 434 ++ lib/win32com/demos/iebutton.py | 217 + lib/win32com/demos/ietoolbar.py | 376 ++ lib/win32com/demos/outlookAddin.py | 138 + lib/win32com/demos/trybag.py | 77 + lib/win32com/include/PythonCOM.h | 766 +++ lib/win32com/include/PythonCOMRegister.h | 84 + lib/win32com/include/PythonCOMServer.h | 176 + lib/win32com/makegw/__init__.py | 1 + lib/win32com/makegw/makegw.py | 560 ++ lib/win32com/makegw/makegwenum.py | 331 ++ lib/win32com/makegw/makegwparse.py | 1008 ++++ lib/win32com/olectl.py | 70 + lib/win32com/readme.html | 87 + lib/win32com/server/__init__.py | 1 + lib/win32com/server/connect.py | 84 + lib/win32com/server/dispatcher.py | 291 + lib/win32com/server/exception.py | 105 + lib/win32com/server/factory.py | 26 + lib/win32com/server/localserver.py | 53 + lib/win32com/server/policy.py | 829 +++ lib/win32com/server/register.py | 672 +++ lib/win32com/server/util.py | 229 + lib/win32com/servers/PythonTools.py | 47 + lib/win32com/servers/__init__.py | 0 lib/win32com/servers/dictionary.py | 137 + lib/win32com/servers/interp.py | 55 + lib/win32com/servers/perfmon.py | 34 + lib/win32com/servers/test_pycomtest.py | 182 + lib/win32com/storagecon.py | 142 + lib/win32com/test/GenTestScripts.py | 95 + lib/win32com/test/Testpys.sct | 64 + lib/win32com/test/__init__.py | 1 + lib/win32com/test/daodump.py | 90 + lib/win32com/test/errorSemantics.py | 259 + lib/win32com/test/pippo.idl | 66 + lib/win32com/test/pippo_server.py | 97 + lib/win32com/test/policySemantics.py | 116 + lib/win32com/test/readme.txt | 18 + lib/win32com/test/testADOEvents.py | 100 + lib/win32com/test/testAXScript.py | 43 + lib/win32com/test/testAccess.py | 187 + lib/win32com/test/testArrays.py | 99 + lib/win32com/test/testClipboard.py | 170 + lib/win32com/test/testCollections.py | 166 + lib/win32com/test/testConversionErrors.py | 39 + lib/win32com/test/testDCOM.py | 50 + lib/win32com/test/testDates.py | 74 + lib/win32com/test/testDictionary.py | 99 + lib/win32com/test/testDictionary.vbs | 26 + lib/win32com/test/testDynamic.py | 89 + lib/win32com/test/testExchange.py | 126 + lib/win32com/test/testExplorer.py | 145 + lib/win32com/test/testGIT.py | 145 + lib/win32com/test/testGatewayAddresses.py | 149 + lib/win32com/test/testInterp.vbs | 12 + lib/win32com/test/testIterators.py | 140 + lib/win32com/test/testMSOffice.py | 209 + lib/win32com/test/testMSOfficeEvents.py | 136 + lib/win32com/test/testMarshal.py | 160 + lib/win32com/test/testNetscape.py | 27 + lib/win32com/test/testPersist.py | 231 + lib/win32com/test/testPippo.py | 82 + lib/win32com/test/testPyComTest.py | 835 +++ lib/win32com/test/testPyScriptlet.js | 33 + lib/win32com/test/testROT.py | 29 + lib/win32com/test/testServers.py | 52 + lib/win32com/test/testShell.py | 281 + lib/win32com/test/testStorage.py | 88 + lib/win32com/test/testStreams.py | 148 + lib/win32com/test/testWMI.py | 18 + lib/win32com/test/testall.py | 321 ++ lib/win32com/test/testmakepy.py | 55 + lib/win32com/test/testvb.py | 594 ++ lib/win32com/test/testvbscript_regexp.py | 40 + lib/win32com/test/testxslt.js | 12 + lib/win32com/test/testxslt.py | 34 + lib/win32com/test/testxslt.xsl | 55 + lib/win32com/test/util.py | 265 + lib/win32com/universal.py | 226 + lib/win32com/util.py | 34 + lib/win32comext/adsi/__init__.py | 122 + lib/win32comext/adsi/adsi.pyd | Bin 0 -> 97792 bytes lib/win32comext/adsi/adsicon.py | 340 ++ lib/win32comext/adsi/demos/objectPicker.py | 68 + lib/win32comext/adsi/demos/scp.py | 565 ++ lib/win32comext/adsi/demos/search.py | 152 + lib/win32comext/adsi/demos/test.py | 273 + lib/win32comext/authorization/__init__.py | 6 + .../authorization/authorization.pyd | Bin 0 -> 29696 bytes .../authorization/demos/EditSecurity.py | 255 + .../demos/EditServiceSecurity.py | 242 + lib/win32comext/axcontrol/__init__.py | 4 + lib/win32comext/axcontrol/axcontrol.pyd | Bin 0 -> 143872 bytes lib/win32comext/axdebug/__init__.py | 4 + lib/win32comext/axdebug/adb.py | 480 ++ lib/win32comext/axdebug/axdebug.pyd | Bin 0 -> 285184 bytes lib/win32comext/axdebug/codecontainer.py | 278 + lib/win32comext/axdebug/contexts.py | 62 + lib/win32comext/axdebug/debugger.py | 250 + lib/win32comext/axdebug/documents.py | 140 + lib/win32comext/axdebug/dump.py | 61 + lib/win32comext/axdebug/expressions.py | 214 + lib/win32comext/axdebug/gateways.py | 583 ++ lib/win32comext/axdebug/stackframe.py | 179 + lib/win32comext/axdebug/util.py | 141 + .../Demos/client/asp/CreateObject.asp | 19 + .../axscript/Demos/client/asp/caps.asp | 52 + .../Demos/client/asp/interrupt/test.asp | 4 + .../Demos/client/asp/interrupt/test.html | 10 + .../Demos/client/asp/interrupt/test1.asp | 6 + .../Demos/client/asp/interrupt/test1.html | 11 + .../axscript/Demos/client/asp/tut1.asp | 11 + .../axscript/Demos/client/ie/MarqueeText1.htm | 25 + .../axscript/Demos/client/ie/calc.htm | 116 + .../axscript/Demos/client/ie/dbgtest.htm | 16 + .../axscript/Demos/client/ie/demo.htm | 26 + .../axscript/Demos/client/ie/demo_check.htm | 42 + .../axscript/Demos/client/ie/demo_intro.htm | 38 + .../axscript/Demos/client/ie/demo_menu.htm | 16 + .../axscript/Demos/client/ie/docwrite.htm | 25 + .../axscript/Demos/client/ie/foo2.htm | 105 + .../axscript/Demos/client/ie/form.htm | 25 + .../axscript/Demos/client/ie/marqueeDemo.htm | 60 + .../axscript/Demos/client/ie/mousetrack.htm | 83 + .../Demos/client/ie/pycom_blowing.gif | Bin 0 -> 20926 bytes .../axscript/Demos/client/wsh/blank.pys | 0 .../axscript/Demos/client/wsh/excel.pys | 34 + .../axscript/Demos/client/wsh/registry.pys | 45 + .../axscript/Demos/client/wsh/test.pys | 15 + lib/win32comext/axscript/__init__.py | 4 + lib/win32comext/axscript/asputil.py | 13 + lib/win32comext/axscript/axscript.pyd | Bin 0 -> 93184 bytes lib/win32comext/axscript/client/__init__.py | 1 + lib/win32comext/axscript/client/debug.py | 240 + lib/win32comext/axscript/client/error.py | 273 + lib/win32comext/axscript/client/framework.py | 1270 ++++ lib/win32comext/axscript/client/pydumper.py | 77 + lib/win32comext/axscript/client/pyscript.py | 443 ++ .../axscript/client/pyscript_rexec.py | 49 + .../axscript/client/scriptdispatch.py | 115 + lib/win32comext/axscript/server/__init__.py | 0 lib/win32comext/axscript/server/axsite.py | 145 + lib/win32comext/axscript/server/error.py | 16 + lib/win32comext/axscript/test/debugTest.pys | 17 + lib/win32comext/axscript/test/debugTest.vbs | 7 + lib/win32comext/axscript/test/leakTest.py | 188 + lib/win32comext/axscript/test/testHost.py | 257 + lib/win32comext/axscript/test/testHost4Dbg.py | 88 + lib/win32comext/bits/__init__.py | 6 + lib/win32comext/bits/bits.pyd | Bin 0 -> 62976 bytes lib/win32comext/bits/test/show_all_jobs.py | 52 + lib/win32comext/bits/test/test_bits.py | 121 + lib/win32comext/directsound/__init__.py | 4 + lib/win32comext/directsound/directsound.pyd | Bin 0 -> 76288 bytes lib/win32comext/directsound/test/__init__.py | 1 + lib/win32comext/directsound/test/ds_record.py | 60 + lib/win32comext/directsound/test/ds_test.py | 402 ++ lib/win32comext/ifilter/__init__.py | 1 + lib/win32comext/ifilter/demo/filterDemo.py | 300 + lib/win32comext/ifilter/ifilter.pyd | Bin 0 -> 30720 bytes lib/win32comext/ifilter/ifiltercon.py | 110 + lib/win32comext/internet/__init__.py | 4 + lib/win32comext/internet/inetcon.py | 261 + lib/win32comext/internet/internet.pyd | Bin 0 -> 93696 bytes lib/win32comext/mapi/__init__.py | 27 + lib/win32comext/mapi/demos/mapisend.py | 98 + lib/win32comext/mapi/emsabtags.py | 874 +++ lib/win32comext/mapi/exchange.pyd | Bin 0 -> 88064 bytes lib/win32comext/mapi/mapi.pyd | Bin 0 -> 196608 bytes lib/win32comext/mapi/mapitags.py | 1025 ++++ lib/win32comext/mapi/mapiutil.py | 217 + lib/win32comext/propsys/__init__.py | 1 + lib/win32comext/propsys/propsys.pyd | Bin 0 -> 138752 bytes lib/win32comext/propsys/pscon.py | 838 +++ lib/win32comext/propsys/test/testpropsys.py | 5 + lib/win32comext/shell/__init__.py | 4 + lib/win32comext/shell/demos/IActiveDesktop.py | 83 + .../shell/demos/IFileOperationProgressSink.py | 181 + .../shell/demos/IShellLinkDataList.py | 67 + .../shell/demos/ITransferAdviseSink.py | 107 + .../shell/demos/IUniformResourceLocator.py | 56 + .../shell/demos/browse_for_folder.py | 45 + lib/win32comext/shell/demos/create_link.py | 73 + lib/win32comext/shell/demos/dump_link.py | 58 + .../shell/demos/explorer_browser.py | 143 + .../shell/demos/servers/column_provider.py | 126 + .../shell/demos/servers/context_menu.py | 122 + .../shell/demos/servers/copy_hook.py | 84 + .../shell/demos/servers/empty_volume_cache.py | 188 + .../shell/demos/servers/folder_view.py | 862 +++ .../shell/demos/servers/icon_handler.py | 82 + .../shell/demos/servers/shell_view.py | 972 ++++ lib/win32comext/shell/demos/shellexecuteex.py | 19 + lib/win32comext/shell/demos/viewstate.py | 68 + .../shell/demos/walk_shell_folders.py | 24 + lib/win32comext/shell/shell.pyd | Bin 0 -> 528896 bytes lib/win32comext/shell/shellcon.py | 1597 ++++++ .../shell/test/testSHFileOperation.py | 75 + lib/win32comext/shell/test/testShellFolder.py | 21 + lib/win32comext/shell/test/testShellItem.py | 69 + lib/win32comext/taskscheduler/__init__.py | 6 + .../taskscheduler/taskscheduler.pyd | Bin 0 -> 53248 bytes .../taskscheduler/test/test_addtask.py | 66 + .../taskscheduler/test/test_addtask_1.py | 69 + .../taskscheduler/test/test_addtask_2.py | 51 + .../taskscheduler/test/test_localsystem.py | 3 + lib/zc/lockfile/__init__.py | 23 +- lib/zc/lockfile/tests.py | 46 +- requirements.txt | 2 +- 673 files changed, 159850 insertions(+), 11583 deletions(-) create mode 100644 lib/PyWin32.chm create mode 100644 lib/adodbapi/__init__.py create mode 100644 lib/adodbapi/ado_consts.py create mode 100644 lib/adodbapi/adodbapi.py create mode 100644 lib/adodbapi/apibase.py create mode 100644 lib/adodbapi/examples/db_print.py create mode 100644 lib/adodbapi/examples/db_table_names.py create mode 100644 lib/adodbapi/examples/xls_read.py create mode 100644 lib/adodbapi/examples/xls_write.py create mode 100644 lib/adodbapi/is64bit.py create mode 100644 lib/adodbapi/license.txt create mode 100644 lib/adodbapi/process_connect_string.py create mode 100644 lib/adodbapi/readme.txt create mode 100644 lib/adodbapi/remote.py create mode 100644 lib/adodbapi/schema_table.py create mode 100644 lib/adodbapi/setup.py create mode 100644 lib/adodbapi/test/adodbapitest.py create mode 100644 lib/adodbapi/test/adodbapitestconfig.py create mode 100644 lib/adodbapi/test/dbapi20.py create mode 100644 lib/adodbapi/test/is64bit.py create mode 100644 lib/adodbapi/test/setuptestframework.py create mode 100644 lib/adodbapi/test/test_adodbapi_dbapi20.py create mode 100644 lib/adodbapi/test/tryconnection.py create mode 100644 lib/annotated_types/__init__.py rename lib/{jaraco/classes/__init__.py => annotated_types/py.typed} (100%) create mode 100644 lib/annotated_types/test_cases.py create mode 100644 lib/inflect/compat/__init__.py create mode 100644 lib/inflect/compat/pydantic.py create mode 100644 lib/inflect/compat/pydantic1.py create mode 100644 lib/isapi/README.txt create mode 100644 lib/isapi/__init__.py create mode 100644 lib/isapi/doc/isapi.html create mode 100644 lib/isapi/install.py create mode 100644 lib/isapi/isapicon.py create mode 100644 lib/isapi/samples/README.txt create mode 100644 lib/isapi/samples/advanced.py create mode 100644 lib/isapi/samples/redirector.py create mode 100644 lib/isapi/samples/redirector_asynch.py create mode 100644 lib/isapi/samples/redirector_with_filter.py create mode 100644 lib/isapi/samples/test.py create mode 100644 lib/isapi/simple.py create mode 100644 lib/isapi/test/README.txt create mode 100644 lib/isapi/test/extension_simple.py create mode 100644 lib/isapi/threaded_extension.py rename lib/jaraco/{collections.py => collections/__init__.py} (88%) create mode 100644 lib/jaraco/collections/py.typed rename lib/jaraco/{functools.py => functools/__init__.py} (84%) create mode 100644 lib/jaraco/functools/__init__.pyi create mode 100644 lib/jaraco/functools/py.typed create mode 100644 lib/jaraco/text/strip-prefix.py create mode 100644 lib/pydantic/_internal/__init__.py create mode 100644 lib/pydantic/_internal/_config.py create mode 100644 lib/pydantic/_internal/_core_metadata.py create mode 100644 lib/pydantic/_internal/_core_utils.py create mode 100644 lib/pydantic/_internal/_dataclasses.py create mode 100644 lib/pydantic/_internal/_decorators.py create mode 100644 lib/pydantic/_internal/_decorators_v1.py create mode 100644 lib/pydantic/_internal/_discriminated_union.py create mode 100644 lib/pydantic/_internal/_fields.py create mode 100644 lib/pydantic/_internal/_forward_ref.py create mode 100644 lib/pydantic/_internal/_generate_schema.py create mode 100644 lib/pydantic/_internal/_generics.py create mode 100644 lib/pydantic/_internal/_git.py create mode 100644 lib/pydantic/_internal/_internal_dataclass.py create mode 100644 lib/pydantic/_internal/_known_annotated_metadata.py create mode 100644 lib/pydantic/_internal/_mock_val_ser.py create mode 100644 lib/pydantic/_internal/_model_construction.py create mode 100644 lib/pydantic/_internal/_repr.py create mode 100644 lib/pydantic/_internal/_schema_generation_shared.py create mode 100644 lib/pydantic/_internal/_signature.py create mode 100644 lib/pydantic/_internal/_std_types_schema.py create mode 100644 lib/pydantic/_internal/_typing_extra.py create mode 100644 lib/pydantic/_internal/_utils.py create mode 100644 lib/pydantic/_internal/_validate_call.py create mode 100644 lib/pydantic/_internal/_validators.py create mode 100644 lib/pydantic/_migration.py create mode 100644 lib/pydantic/alias_generators.py create mode 100644 lib/pydantic/aliases.py create mode 100644 lib/pydantic/annotated_handlers.py create mode 100644 lib/pydantic/deprecated/__init__.py create mode 100644 lib/pydantic/deprecated/class_validators.py create mode 100644 lib/pydantic/deprecated/config.py create mode 100644 lib/pydantic/deprecated/copy_internals.py create mode 100644 lib/pydantic/deprecated/decorator.py create mode 100644 lib/pydantic/deprecated/json.py create mode 100644 lib/pydantic/deprecated/parse.py create mode 100644 lib/pydantic/deprecated/tools.py create mode 100644 lib/pydantic/functional_serializers.py create mode 100644 lib/pydantic/functional_validators.py create mode 100644 lib/pydantic/json_schema.py create mode 100644 lib/pydantic/plugin/__init__.py create mode 100644 lib/pydantic/plugin/_loader.py create mode 100644 lib/pydantic/plugin/_schema_validator.py create mode 100644 lib/pydantic/root_model.py create mode 100644 lib/pydantic/type_adapter.py create mode 100644 lib/pydantic/v1/__init__.py rename lib/pydantic/{ => v1}/_hypothesis_plugin.py (97%) rename lib/pydantic/{ => v1}/annotated_types.py (100%) create mode 100644 lib/pydantic/v1/class_validators.py create mode 100644 lib/pydantic/v1/color.py create mode 100644 lib/pydantic/v1/config.py create mode 100644 lib/pydantic/v1/dataclasses.py create mode 100644 lib/pydantic/v1/datetime_parse.py create mode 100644 lib/pydantic/v1/decorator.py create mode 100644 lib/pydantic/v1/env_settings.py create mode 100644 lib/pydantic/v1/error_wrappers.py create mode 100644 lib/pydantic/v1/errors.py create mode 100644 lib/pydantic/v1/fields.py create mode 100644 lib/pydantic/v1/generics.py create mode 100644 lib/pydantic/v1/json.py create mode 100644 lib/pydantic/v1/main.py create mode 100644 lib/pydantic/v1/mypy.py create mode 100644 lib/pydantic/v1/networks.py create mode 100644 lib/pydantic/v1/parse.py create mode 100644 lib/pydantic/v1/py.typed create mode 100644 lib/pydantic/v1/schema.py create mode 100644 lib/pydantic/v1/tools.py create mode 100644 lib/pydantic/v1/types.py create mode 100644 lib/pydantic/v1/typing.py create mode 100644 lib/pydantic/v1/utils.py create mode 100644 lib/pydantic/v1/validators.py create mode 100644 lib/pydantic/v1/version.py create mode 100644 lib/pydantic/validate_call_decorator.py create mode 100644 lib/pydantic/warnings.py create mode 100644 lib/pydantic_core/__init__.py create mode 100644 lib/pydantic_core/_pydantic_core.pyi create mode 100644 lib/pydantic_core/core_schema.py create mode 100644 lib/pydantic_core/py.typed create mode 100644 lib/pythoncom.py create mode 100644 lib/pythonwin/license.txt create mode 100644 lib/pythonwin/pywin/Demos/app/basictimerapp.py create mode 100644 lib/pythonwin/pywin/Demos/app/customprint.py create mode 100644 lib/pythonwin/pywin/Demos/app/demoutils.py create mode 100644 lib/pythonwin/pywin/Demos/app/dlgappdemo.py create mode 100644 lib/pythonwin/pywin/Demos/app/dojobapp.py create mode 100644 lib/pythonwin/pywin/Demos/app/helloapp.py create mode 100644 lib/pythonwin/pywin/Demos/cmdserver.py create mode 100644 lib/pythonwin/pywin/Demos/createwin.py create mode 100644 lib/pythonwin/pywin/Demos/demoutils.py create mode 100644 lib/pythonwin/pywin/Demos/dibdemo.py create mode 100644 lib/pythonwin/pywin/Demos/dlgtest.py create mode 100644 lib/pythonwin/pywin/Demos/dyndlg.py create mode 100644 lib/pythonwin/pywin/Demos/fontdemo.py create mode 100644 lib/pythonwin/pywin/Demos/guidemo.py create mode 100644 lib/pythonwin/pywin/Demos/hiertest.py create mode 100644 lib/pythonwin/pywin/Demos/menutest.py create mode 100644 lib/pythonwin/pywin/Demos/objdoc.py create mode 100644 lib/pythonwin/pywin/Demos/ocx/__init__.py create mode 100644 lib/pythonwin/pywin/Demos/ocx/demoutils.py create mode 100644 lib/pythonwin/pywin/Demos/ocx/flash.py create mode 100644 lib/pythonwin/pywin/Demos/ocx/msoffice.py create mode 100644 lib/pythonwin/pywin/Demos/ocx/ocxserialtest.py create mode 100644 lib/pythonwin/pywin/Demos/ocx/ocxtest.py create mode 100644 lib/pythonwin/pywin/Demos/ocx/webbrowser.py create mode 100644 lib/pythonwin/pywin/Demos/openGLDemo.py create mode 100644 lib/pythonwin/pywin/Demos/progressbar.py create mode 100644 lib/pythonwin/pywin/Demos/sliderdemo.py create mode 100644 lib/pythonwin/pywin/Demos/splittst.py create mode 100644 lib/pythonwin/pywin/Demos/threadedgui.py create mode 100644 lib/pythonwin/pywin/Demos/toolbar.py create mode 100644 lib/pythonwin/pywin/IDLE.cfg create mode 100644 lib/pythonwin/pywin/__init__.py create mode 100644 lib/pythonwin/pywin/default.cfg create mode 100644 lib/pythonwin/pywin/dialogs/__init__.py create mode 100644 lib/pythonwin/pywin/dialogs/ideoptions.py create mode 100644 lib/pythonwin/pywin/dialogs/list.py create mode 100644 lib/pythonwin/pywin/dialogs/login.py create mode 100644 lib/pythonwin/pywin/dialogs/status.py create mode 100644 lib/pythonwin/pywin/docking/DockingBar.py create mode 100644 lib/pythonwin/pywin/docking/__init__.py create mode 100644 lib/pythonwin/pywin/framework/__init__.py create mode 100644 lib/pythonwin/pywin/framework/app.py create mode 100644 lib/pythonwin/pywin/framework/bitmap.py create mode 100644 lib/pythonwin/pywin/framework/cmdline.py create mode 100644 lib/pythonwin/pywin/framework/dbgcommands.py create mode 100644 lib/pythonwin/pywin/framework/dlgappcore.py create mode 100644 lib/pythonwin/pywin/framework/editor/ModuleBrowser.py create mode 100644 lib/pythonwin/pywin/framework/editor/__init__.py create mode 100644 lib/pythonwin/pywin/framework/editor/color/__init__.py create mode 100644 lib/pythonwin/pywin/framework/editor/color/coloreditor.py create mode 100644 lib/pythonwin/pywin/framework/editor/configui.py create mode 100644 lib/pythonwin/pywin/framework/editor/document.py create mode 100644 lib/pythonwin/pywin/framework/editor/editor.py create mode 100644 lib/pythonwin/pywin/framework/editor/frame.py create mode 100644 lib/pythonwin/pywin/framework/editor/template.py create mode 100644 lib/pythonwin/pywin/framework/editor/vss.py create mode 100644 lib/pythonwin/pywin/framework/help.py create mode 100644 lib/pythonwin/pywin/framework/interact.py create mode 100644 lib/pythonwin/pywin/framework/intpyapp.py create mode 100644 lib/pythonwin/pywin/framework/intpydde.py create mode 100644 lib/pythonwin/pywin/framework/mdi_pychecker.py create mode 100644 lib/pythonwin/pywin/framework/scriptutils.py create mode 100644 lib/pythonwin/pywin/framework/sgrepmdi.py create mode 100644 lib/pythonwin/pywin/framework/startup.py create mode 100644 lib/pythonwin/pywin/framework/stdin.py create mode 100644 lib/pythonwin/pywin/framework/toolmenu.py create mode 100644 lib/pythonwin/pywin/framework/window.py create mode 100644 lib/pythonwin/pywin/framework/winout.py create mode 100644 lib/pythonwin/pywin/idle/AutoExpand.py create mode 100644 lib/pythonwin/pywin/idle/AutoIndent.py create mode 100644 lib/pythonwin/pywin/idle/CallTips.py create mode 100644 lib/pythonwin/pywin/idle/FormatParagraph.py create mode 100644 lib/pythonwin/pywin/idle/IdleHistory.py create mode 100644 lib/pythonwin/pywin/idle/PyParse.py create mode 100644 lib/pythonwin/pywin/idle/__init__.py create mode 100644 lib/pythonwin/pywin/mfc/__init__.py create mode 100644 lib/pythonwin/pywin/mfc/activex.py create mode 100644 lib/pythonwin/pywin/mfc/afxres.py create mode 100644 lib/pythonwin/pywin/mfc/dialog.py create mode 100644 lib/pythonwin/pywin/mfc/docview.py create mode 100644 lib/pythonwin/pywin/mfc/object.py create mode 100644 lib/pythonwin/pywin/mfc/thread.py create mode 100644 lib/pythonwin/pywin/mfc/window.py create mode 100644 lib/pythonwin/pywin/scintilla/IDLEenvironment.py create mode 100644 lib/pythonwin/pywin/scintilla/__init__.py create mode 100644 lib/pythonwin/pywin/scintilla/bindings.py create mode 100644 lib/pythonwin/pywin/scintilla/config.py create mode 100644 lib/pythonwin/pywin/scintilla/configui.py create mode 100644 lib/pythonwin/pywin/scintilla/control.py create mode 100644 lib/pythonwin/pywin/scintilla/document.py create mode 100644 lib/pythonwin/pywin/scintilla/find.py create mode 100644 lib/pythonwin/pywin/scintilla/formatter.py create mode 100644 lib/pythonwin/pywin/scintilla/keycodes.py create mode 100644 lib/pythonwin/pywin/scintilla/scintillacon.py create mode 100644 lib/pythonwin/pywin/scintilla/view.py create mode 100644 lib/pythonwin/pywin/tools/TraceCollector.py create mode 100644 lib/pythonwin/pywin/tools/__init__.py create mode 100644 lib/pythonwin/pywin/tools/browseProjects.py create mode 100644 lib/pythonwin/pywin/tools/browser.py create mode 100644 lib/pythonwin/pywin/tools/hierlist.py create mode 100644 lib/pythonwin/pywin/tools/regedit.py create mode 100644 lib/pythonwin/pywin/tools/regpy.py create mode 100644 lib/pythonwin/start_pythonwin.pyw create mode 100644 lib/pywin32.version.txt create mode 100644 lib/win32/Demos/BackupRead_BackupWrite.py create mode 100644 lib/win32/Demos/BackupSeek_streamheaders.py create mode 100644 lib/win32/Demos/CopyFileEx.py create mode 100644 lib/win32/Demos/CreateFileTransacted_MiniVersion.py create mode 100644 lib/win32/Demos/EvtFormatMessage.py create mode 100644 lib/win32/Demos/EvtSubscribe_pull.py create mode 100644 lib/win32/Demos/EvtSubscribe_push.py create mode 100644 lib/win32/Demos/FileSecurityTest.py create mode 100644 lib/win32/Demos/GetSaveFileName.py create mode 100644 lib/win32/Demos/NetValidatePasswordPolicy.py create mode 100644 lib/win32/Demos/OpenEncryptedFileRaw.py create mode 100644 lib/win32/Demos/RegCreateKeyTransacted.py create mode 100644 lib/win32/Demos/RegRestoreKey.py create mode 100644 lib/win32/Demos/SystemParametersInfo.py create mode 100644 lib/win32/Demos/c_extension/setup.py create mode 100644 lib/win32/Demos/cerapi.py create mode 100644 lib/win32/Demos/dde/ddeclient.py create mode 100644 lib/win32/Demos/dde/ddeserver.py create mode 100644 lib/win32/Demos/desktopmanager.py create mode 100644 lib/win32/Demos/eventLogDemo.py create mode 100644 lib/win32/Demos/getfilever.py create mode 100644 lib/win32/Demos/images/frowny.bmp create mode 100644 lib/win32/Demos/images/smiley.bmp create mode 100644 lib/win32/Demos/mmapfile_demo.py create mode 100644 lib/win32/Demos/pipes/cat.py create mode 100644 lib/win32/Demos/pipes/runproc.py create mode 100644 lib/win32/Demos/print_desktop.py create mode 100644 lib/win32/Demos/rastest.py create mode 100644 lib/win32/Demos/security/GetTokenInformation.py create mode 100644 lib/win32/Demos/security/account_rights.py create mode 100644 lib/win32/Demos/security/explicit_entries.py create mode 100644 lib/win32/Demos/security/get_policy_info.py create mode 100644 lib/win32/Demos/security/list_rights.py create mode 100644 lib/win32/Demos/security/localized_names.py create mode 100644 lib/win32/Demos/security/lsaregevent.py create mode 100644 lib/win32/Demos/security/lsastore.py create mode 100644 lib/win32/Demos/security/query_information.py create mode 100644 lib/win32/Demos/security/regsave_sa.py create mode 100644 lib/win32/Demos/security/regsecurity.py create mode 100644 lib/win32/Demos/security/sa_inherit.py create mode 100644 lib/win32/Demos/security/security_enums.py create mode 100644 lib/win32/Demos/security/set_file_audit.py create mode 100644 lib/win32/Demos/security/set_file_owner.py create mode 100644 lib/win32/Demos/security/set_policy_info.py create mode 100644 lib/win32/Demos/security/setkernelobjectsecurity.py create mode 100644 lib/win32/Demos/security/setnamedsecurityinfo.py create mode 100644 lib/win32/Demos/security/setsecurityinfo.py create mode 100644 lib/win32/Demos/security/setuserobjectsecurity.py create mode 100644 lib/win32/Demos/security/sspi/fetch_url.py create mode 100644 lib/win32/Demos/security/sspi/simple_auth.py create mode 100644 lib/win32/Demos/security/sspi/socket_server.py create mode 100644 lib/win32/Demos/security/sspi/validate_password.py create mode 100644 lib/win32/Demos/service/nativePipeTestService.py create mode 100644 lib/win32/Demos/service/pipeTestService.py create mode 100644 lib/win32/Demos/service/pipeTestServiceClient.py create mode 100644 lib/win32/Demos/service/serviceEvents.py create mode 100644 lib/win32/Demos/timer_demo.py create mode 100644 lib/win32/Demos/win32clipboardDemo.py create mode 100644 lib/win32/Demos/win32clipboard_bitmapdemo.py create mode 100644 lib/win32/Demos/win32comport_demo.py create mode 100644 lib/win32/Demos/win32console_demo.py create mode 100644 lib/win32/Demos/win32cred_demo.py create mode 100644 lib/win32/Demos/win32fileDemo.py create mode 100644 lib/win32/Demos/win32gui_demo.py create mode 100644 lib/win32/Demos/win32gui_devicenotify.py create mode 100644 lib/win32/Demos/win32gui_dialog.py create mode 100644 lib/win32/Demos/win32gui_menu.py create mode 100644 lib/win32/Demos/win32gui_taskbar.py create mode 100644 lib/win32/Demos/win32netdemo.py create mode 100644 lib/win32/Demos/win32rcparser_demo.py create mode 100644 lib/win32/Demos/win32servicedemo.py create mode 100644 lib/win32/Demos/win32ts_logoff_disconnected.py create mode 100644 lib/win32/Demos/win32wnet/testwnet.py create mode 100644 lib/win32/Demos/win32wnet/winnetwk.py create mode 100644 lib/win32/Demos/winprocess.py create mode 100644 lib/win32/include/PyWinTypes.h create mode 100644 lib/win32/lib/afxres.py create mode 100644 lib/win32/lib/commctrl.py create mode 100644 lib/win32/lib/dbi.py create mode 100644 lib/win32/lib/mmsystem.py create mode 100644 lib/win32/lib/netbios.py create mode 100644 lib/win32/lib/ntsecuritycon.py create mode 100644 lib/win32/lib/pywin32_bootstrap.py create mode 100644 lib/win32/lib/pywin32_testutil.py create mode 100644 lib/win32/lib/pywintypes.py create mode 100644 lib/win32/lib/rasutil.py create mode 100644 lib/win32/lib/regcheck.py create mode 100644 lib/win32/lib/regutil.py create mode 100644 lib/win32/lib/sspi.py create mode 100644 lib/win32/lib/sspicon.py create mode 100644 lib/win32/lib/win2kras.py create mode 100644 lib/win32/lib/win32con.py create mode 100644 lib/win32/lib/win32cryptcon.py create mode 100644 lib/win32/lib/win32evtlogutil.py create mode 100644 lib/win32/lib/win32gui_struct.py create mode 100644 lib/win32/lib/win32inetcon.py create mode 100644 lib/win32/lib/win32netcon.py create mode 100644 lib/win32/lib/win32pdhquery.py create mode 100644 lib/win32/lib/win32pdhutil.py create mode 100644 lib/win32/lib/win32rcparser.py create mode 100644 lib/win32/lib/win32serviceutil.py create mode 100644 lib/win32/lib/win32timezone.py create mode 100644 lib/win32/lib/win32traceutil.py create mode 100644 lib/win32/lib/win32verstamp.py create mode 100644 lib/win32/lib/winerror.py create mode 100644 lib/win32/lib/winioctlcon.py create mode 100644 lib/win32/lib/winnt.py create mode 100644 lib/win32/lib/winperf.py create mode 100644 lib/win32/lib/winxptheme.py create mode 100644 lib/win32/license.txt create mode 100644 lib/win32/scripts/ControlService.py create mode 100644 lib/win32/scripts/VersionStamp/BrandProject.py create mode 100644 lib/win32/scripts/VersionStamp/bulkstamp.py create mode 100644 lib/win32/scripts/VersionStamp/vssutil.py create mode 100644 lib/win32/scripts/backupEventLog.py create mode 100644 lib/win32/scripts/ce/pysynch.py create mode 100644 lib/win32/scripts/killProcName.py create mode 100644 lib/win32/scripts/rasutil.py create mode 100644 lib/win32/scripts/regsetup.py create mode 100644 lib/win32/scripts/setup_d.py create mode 100644 lib/win32/test/handles.py create mode 100644 lib/win32/test/test_clipboard.py create mode 100644 lib/win32/test/test_exceptions.py create mode 100644 lib/win32/test/test_odbc.py create mode 100644 lib/win32/test/test_pywintypes.py create mode 100644 lib/win32/test/test_security.py create mode 100644 lib/win32/test/test_sspi.py create mode 100644 lib/win32/test/test_win32api.py create mode 100644 lib/win32/test/test_win32crypt.py create mode 100644 lib/win32/test/test_win32event.py create mode 100644 lib/win32/test/test_win32file.py create mode 100644 lib/win32/test/test_win32gui.py create mode 100644 lib/win32/test/test_win32guistruct.py create mode 100644 lib/win32/test/test_win32inet.py create mode 100644 lib/win32/test/test_win32net.py create mode 100644 lib/win32/test/test_win32pipe.py create mode 100644 lib/win32/test/test_win32print.py create mode 100644 lib/win32/test/test_win32profile.py create mode 100644 lib/win32/test/test_win32rcparser.py create mode 100644 lib/win32/test/test_win32timezone.py create mode 100644 lib/win32/test/test_win32trace.py create mode 100644 lib/win32/test/test_win32wnet.py create mode 100644 lib/win32/test/testall.py create mode 100644 lib/win32/test/win32rcparser/python.bmp create mode 100644 lib/win32/test/win32rcparser/python.ico create mode 100644 lib/win32/test/win32rcparser/test.h create mode 100644 lib/win32/test/win32rcparser/test.rc create mode 100644 lib/win32com/HTML/GeneratedSupport.html create mode 100644 lib/win32com/HTML/PythonCOM.html create mode 100644 lib/win32com/HTML/QuickStartClientCom.html create mode 100644 lib/win32com/HTML/QuickStartServerCom.html create mode 100644 lib/win32com/HTML/docindex.html create mode 100644 lib/win32com/HTML/image/BTN_HomePage.gif create mode 100644 lib/win32com/HTML/image/BTN_ManualTop.gif create mode 100644 lib/win32com/HTML/image/BTN_NextPage.gif create mode 100644 lib/win32com/HTML/image/BTN_PrevPage.gif create mode 100644 lib/win32com/HTML/image/blank.gif create mode 100644 lib/win32com/HTML/image/pycom_blowing.gif create mode 100644 lib/win32com/HTML/image/pythoncom.gif create mode 100644 lib/win32com/HTML/image/www_icon.gif create mode 100644 lib/win32com/HTML/index.html create mode 100644 lib/win32com/HTML/misc.html create mode 100644 lib/win32com/HTML/package.html create mode 100644 lib/win32com/HTML/variant.html create mode 100644 lib/win32com/License.txt create mode 100644 lib/win32com/__init__.py create mode 100644 lib/win32com/client/CLSIDToClass.py create mode 100644 lib/win32com/client/__init__.py create mode 100644 lib/win32com/client/build.py create mode 100644 lib/win32com/client/combrowse.py create mode 100644 lib/win32com/client/connect.py create mode 100644 lib/win32com/client/dynamic.py create mode 100644 lib/win32com/client/gencache.py create mode 100644 lib/win32com/client/genpy.py create mode 100644 lib/win32com/client/makepy.py create mode 100644 lib/win32com/client/selecttlb.py create mode 100644 lib/win32com/client/tlbrowse.py create mode 100644 lib/win32com/client/util.py create mode 100644 lib/win32com/demos/__init__.py create mode 100644 lib/win32com/demos/connect.py create mode 100644 lib/win32com/demos/dump_clipboard.py create mode 100644 lib/win32com/demos/eventsApartmentThreaded.py create mode 100644 lib/win32com/demos/eventsFreeThreaded.py create mode 100644 lib/win32com/demos/excelAddin.py create mode 100644 lib/win32com/demos/excelRTDServer.py create mode 100644 lib/win32com/demos/iebutton.py create mode 100644 lib/win32com/demos/ietoolbar.py create mode 100644 lib/win32com/demos/outlookAddin.py create mode 100644 lib/win32com/demos/trybag.py create mode 100644 lib/win32com/include/PythonCOM.h create mode 100644 lib/win32com/include/PythonCOMRegister.h create mode 100644 lib/win32com/include/PythonCOMServer.h create mode 100644 lib/win32com/makegw/__init__.py create mode 100644 lib/win32com/makegw/makegw.py create mode 100644 lib/win32com/makegw/makegwenum.py create mode 100644 lib/win32com/makegw/makegwparse.py create mode 100644 lib/win32com/olectl.py create mode 100644 lib/win32com/readme.html create mode 100644 lib/win32com/server/__init__.py create mode 100644 lib/win32com/server/connect.py create mode 100644 lib/win32com/server/dispatcher.py create mode 100644 lib/win32com/server/exception.py create mode 100644 lib/win32com/server/factory.py create mode 100644 lib/win32com/server/localserver.py create mode 100644 lib/win32com/server/policy.py create mode 100644 lib/win32com/server/register.py create mode 100644 lib/win32com/server/util.py create mode 100644 lib/win32com/servers/PythonTools.py create mode 100644 lib/win32com/servers/__init__.py create mode 100644 lib/win32com/servers/dictionary.py create mode 100644 lib/win32com/servers/interp.py create mode 100644 lib/win32com/servers/perfmon.py create mode 100644 lib/win32com/servers/test_pycomtest.py create mode 100644 lib/win32com/storagecon.py create mode 100644 lib/win32com/test/GenTestScripts.py create mode 100644 lib/win32com/test/Testpys.sct create mode 100644 lib/win32com/test/__init__.py create mode 100644 lib/win32com/test/daodump.py create mode 100644 lib/win32com/test/errorSemantics.py create mode 100644 lib/win32com/test/pippo.idl create mode 100644 lib/win32com/test/pippo_server.py create mode 100644 lib/win32com/test/policySemantics.py create mode 100644 lib/win32com/test/readme.txt create mode 100644 lib/win32com/test/testADOEvents.py create mode 100644 lib/win32com/test/testAXScript.py create mode 100644 lib/win32com/test/testAccess.py create mode 100644 lib/win32com/test/testArrays.py create mode 100644 lib/win32com/test/testClipboard.py create mode 100644 lib/win32com/test/testCollections.py create mode 100644 lib/win32com/test/testConversionErrors.py create mode 100644 lib/win32com/test/testDCOM.py create mode 100644 lib/win32com/test/testDates.py create mode 100644 lib/win32com/test/testDictionary.py create mode 100644 lib/win32com/test/testDictionary.vbs create mode 100644 lib/win32com/test/testDynamic.py create mode 100644 lib/win32com/test/testExchange.py create mode 100644 lib/win32com/test/testExplorer.py create mode 100644 lib/win32com/test/testGIT.py create mode 100644 lib/win32com/test/testGatewayAddresses.py create mode 100644 lib/win32com/test/testInterp.vbs create mode 100644 lib/win32com/test/testIterators.py create mode 100644 lib/win32com/test/testMSOffice.py create mode 100644 lib/win32com/test/testMSOfficeEvents.py create mode 100644 lib/win32com/test/testMarshal.py create mode 100644 lib/win32com/test/testNetscape.py create mode 100644 lib/win32com/test/testPersist.py create mode 100644 lib/win32com/test/testPippo.py create mode 100644 lib/win32com/test/testPyComTest.py create mode 100644 lib/win32com/test/testPyScriptlet.js create mode 100644 lib/win32com/test/testROT.py create mode 100644 lib/win32com/test/testServers.py create mode 100644 lib/win32com/test/testShell.py create mode 100644 lib/win32com/test/testStorage.py create mode 100644 lib/win32com/test/testStreams.py create mode 100644 lib/win32com/test/testWMI.py create mode 100644 lib/win32com/test/testall.py create mode 100644 lib/win32com/test/testmakepy.py create mode 100644 lib/win32com/test/testvb.py create mode 100644 lib/win32com/test/testvbscript_regexp.py create mode 100644 lib/win32com/test/testxslt.js create mode 100644 lib/win32com/test/testxslt.py create mode 100644 lib/win32com/test/testxslt.xsl create mode 100644 lib/win32com/test/util.py create mode 100644 lib/win32com/universal.py create mode 100644 lib/win32com/util.py create mode 100644 lib/win32comext/adsi/__init__.py create mode 100644 lib/win32comext/adsi/adsi.pyd create mode 100644 lib/win32comext/adsi/adsicon.py create mode 100644 lib/win32comext/adsi/demos/objectPicker.py create mode 100644 lib/win32comext/adsi/demos/scp.py create mode 100644 lib/win32comext/adsi/demos/search.py create mode 100644 lib/win32comext/adsi/demos/test.py create mode 100644 lib/win32comext/authorization/__init__.py create mode 100644 lib/win32comext/authorization/authorization.pyd create mode 100644 lib/win32comext/authorization/demos/EditSecurity.py create mode 100644 lib/win32comext/authorization/demos/EditServiceSecurity.py create mode 100644 lib/win32comext/axcontrol/__init__.py create mode 100644 lib/win32comext/axcontrol/axcontrol.pyd create mode 100644 lib/win32comext/axdebug/__init__.py create mode 100644 lib/win32comext/axdebug/adb.py create mode 100644 lib/win32comext/axdebug/axdebug.pyd create mode 100644 lib/win32comext/axdebug/codecontainer.py create mode 100644 lib/win32comext/axdebug/contexts.py create mode 100644 lib/win32comext/axdebug/debugger.py create mode 100644 lib/win32comext/axdebug/documents.py create mode 100644 lib/win32comext/axdebug/dump.py create mode 100644 lib/win32comext/axdebug/expressions.py create mode 100644 lib/win32comext/axdebug/gateways.py create mode 100644 lib/win32comext/axdebug/stackframe.py create mode 100644 lib/win32comext/axdebug/util.py create mode 100644 lib/win32comext/axscript/Demos/client/asp/CreateObject.asp create mode 100644 lib/win32comext/axscript/Demos/client/asp/caps.asp create mode 100644 lib/win32comext/axscript/Demos/client/asp/interrupt/test.asp create mode 100644 lib/win32comext/axscript/Demos/client/asp/interrupt/test.html create mode 100644 lib/win32comext/axscript/Demos/client/asp/interrupt/test1.asp create mode 100644 lib/win32comext/axscript/Demos/client/asp/interrupt/test1.html create mode 100644 lib/win32comext/axscript/Demos/client/asp/tut1.asp create mode 100644 lib/win32comext/axscript/Demos/client/ie/MarqueeText1.htm create mode 100644 lib/win32comext/axscript/Demos/client/ie/calc.htm create mode 100644 lib/win32comext/axscript/Demos/client/ie/dbgtest.htm create mode 100644 lib/win32comext/axscript/Demos/client/ie/demo.htm create mode 100644 lib/win32comext/axscript/Demos/client/ie/demo_check.htm create mode 100644 lib/win32comext/axscript/Demos/client/ie/demo_intro.htm create mode 100644 lib/win32comext/axscript/Demos/client/ie/demo_menu.htm create mode 100644 lib/win32comext/axscript/Demos/client/ie/docwrite.htm create mode 100644 lib/win32comext/axscript/Demos/client/ie/foo2.htm create mode 100644 lib/win32comext/axscript/Demos/client/ie/form.htm create mode 100644 lib/win32comext/axscript/Demos/client/ie/marqueeDemo.htm create mode 100644 lib/win32comext/axscript/Demos/client/ie/mousetrack.htm create mode 100644 lib/win32comext/axscript/Demos/client/ie/pycom_blowing.gif create mode 100644 lib/win32comext/axscript/Demos/client/wsh/blank.pys create mode 100644 lib/win32comext/axscript/Demos/client/wsh/excel.pys create mode 100644 lib/win32comext/axscript/Demos/client/wsh/registry.pys create mode 100644 lib/win32comext/axscript/Demos/client/wsh/test.pys create mode 100644 lib/win32comext/axscript/__init__.py create mode 100644 lib/win32comext/axscript/asputil.py create mode 100644 lib/win32comext/axscript/axscript.pyd create mode 100644 lib/win32comext/axscript/client/__init__.py create mode 100644 lib/win32comext/axscript/client/debug.py create mode 100644 lib/win32comext/axscript/client/error.py create mode 100644 lib/win32comext/axscript/client/framework.py create mode 100644 lib/win32comext/axscript/client/pydumper.py create mode 100644 lib/win32comext/axscript/client/pyscript.py create mode 100644 lib/win32comext/axscript/client/pyscript_rexec.py create mode 100644 lib/win32comext/axscript/client/scriptdispatch.py create mode 100644 lib/win32comext/axscript/server/__init__.py create mode 100644 lib/win32comext/axscript/server/axsite.py create mode 100644 lib/win32comext/axscript/server/error.py create mode 100644 lib/win32comext/axscript/test/debugTest.pys create mode 100644 lib/win32comext/axscript/test/debugTest.vbs create mode 100644 lib/win32comext/axscript/test/leakTest.py create mode 100644 lib/win32comext/axscript/test/testHost.py create mode 100644 lib/win32comext/axscript/test/testHost4Dbg.py create mode 100644 lib/win32comext/bits/__init__.py create mode 100644 lib/win32comext/bits/bits.pyd create mode 100644 lib/win32comext/bits/test/show_all_jobs.py create mode 100644 lib/win32comext/bits/test/test_bits.py create mode 100644 lib/win32comext/directsound/__init__.py create mode 100644 lib/win32comext/directsound/directsound.pyd create mode 100644 lib/win32comext/directsound/test/__init__.py create mode 100644 lib/win32comext/directsound/test/ds_record.py create mode 100644 lib/win32comext/directsound/test/ds_test.py create mode 100644 lib/win32comext/ifilter/__init__.py create mode 100644 lib/win32comext/ifilter/demo/filterDemo.py create mode 100644 lib/win32comext/ifilter/ifilter.pyd create mode 100644 lib/win32comext/ifilter/ifiltercon.py create mode 100644 lib/win32comext/internet/__init__.py create mode 100644 lib/win32comext/internet/inetcon.py create mode 100644 lib/win32comext/internet/internet.pyd create mode 100644 lib/win32comext/mapi/__init__.py create mode 100644 lib/win32comext/mapi/demos/mapisend.py create mode 100644 lib/win32comext/mapi/emsabtags.py create mode 100644 lib/win32comext/mapi/exchange.pyd create mode 100644 lib/win32comext/mapi/mapi.pyd create mode 100644 lib/win32comext/mapi/mapitags.py create mode 100644 lib/win32comext/mapi/mapiutil.py create mode 100644 lib/win32comext/propsys/__init__.py create mode 100644 lib/win32comext/propsys/propsys.pyd create mode 100644 lib/win32comext/propsys/pscon.py create mode 100644 lib/win32comext/propsys/test/testpropsys.py create mode 100644 lib/win32comext/shell/__init__.py create mode 100644 lib/win32comext/shell/demos/IActiveDesktop.py create mode 100644 lib/win32comext/shell/demos/IFileOperationProgressSink.py create mode 100644 lib/win32comext/shell/demos/IShellLinkDataList.py create mode 100644 lib/win32comext/shell/demos/ITransferAdviseSink.py create mode 100644 lib/win32comext/shell/demos/IUniformResourceLocator.py create mode 100644 lib/win32comext/shell/demos/browse_for_folder.py create mode 100644 lib/win32comext/shell/demos/create_link.py create mode 100644 lib/win32comext/shell/demos/dump_link.py create mode 100644 lib/win32comext/shell/demos/explorer_browser.py create mode 100644 lib/win32comext/shell/demos/servers/column_provider.py create mode 100644 lib/win32comext/shell/demos/servers/context_menu.py create mode 100644 lib/win32comext/shell/demos/servers/copy_hook.py create mode 100644 lib/win32comext/shell/demos/servers/empty_volume_cache.py create mode 100644 lib/win32comext/shell/demos/servers/folder_view.py create mode 100644 lib/win32comext/shell/demos/servers/icon_handler.py create mode 100644 lib/win32comext/shell/demos/servers/shell_view.py create mode 100644 lib/win32comext/shell/demos/shellexecuteex.py create mode 100644 lib/win32comext/shell/demos/viewstate.py create mode 100644 lib/win32comext/shell/demos/walk_shell_folders.py create mode 100644 lib/win32comext/shell/shell.pyd create mode 100644 lib/win32comext/shell/shellcon.py create mode 100644 lib/win32comext/shell/test/testSHFileOperation.py create mode 100644 lib/win32comext/shell/test/testShellFolder.py create mode 100644 lib/win32comext/shell/test/testShellItem.py create mode 100644 lib/win32comext/taskscheduler/__init__.py create mode 100644 lib/win32comext/taskscheduler/taskscheduler.pyd create mode 100644 lib/win32comext/taskscheduler/test/test_addtask.py create mode 100644 lib/win32comext/taskscheduler/test/test_addtask_1.py create mode 100644 lib/win32comext/taskscheduler/test/test_addtask_2.py create mode 100644 lib/win32comext/taskscheduler/test/test_localsystem.py diff --git a/lib/PyWin32.chm b/lib/PyWin32.chm new file mode 100644 index 0000000000000000000000000000000000000000..7606f82b16c4d3653d70e8f4903f17f015997efe GIT binary patch literal 2648456 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 rQN;&sQ=Ti}rv)w;oR__lL__#T{5M7JI zQ^mp7K_#HLIsCI{%&c{l&5`+vNgMnQ7A;8wvD%SpC8N6g%w0_5E0F`0#u*nJkDUwe z8pPqOs7{Ns)SJxG%Vu__f3ea`93fI>9gGq2TizgEzP4bQ>kC{}hLE@Gfzz!L9eE*( z=mgP?>uhJI(x#EM+%|9Bv*ZsQ$m=)_z{Ihy_@_2^`_*h%F$RByLJq_?x@p=el4l^T z12)-8nyDT0S4Nj;^NkF^+8f~<&5=p0G0Ls8)j(X&w&2Z-KpEymE4rFN%%FK_8RY== zu{?8lqs>i4SvP;0k+|6zb>_Rk(PNaZPQ(7guW?7fyn!JDJZ!bRd$Q~Effx&~u1gbT#=-gg$zZppUN4yK9aNV{9$p_+1PMxUXcW!>0i#kRE4#tOjYM$ApiQ7j8zYybZQ>i_`J3|UnH+$sQP2gEtz z&S{2|u8StnB${NQ3`7=9CLkBfTehISXubFM?kx9O(Eq}k$Vds0@+s>`9%UW!kVn?C zT$xAKfj&i*SgO>Sbmk;9lK{j30A{41h^zp)+vRdBjRUYyksw7y_$|xgyZ|IwL7-(1 zl0bj~5eV{R7rD9by?1lFd-bz1vIvAPAbEuT_wjf-_P;z)s~e>UYImQ;mYvpIi!ZO$ z%GlTPE@!z^@nS+zuD4dC>!5zD+im?dj}^K{?w<9)VWiv0VsBCGD8 zwh5=$3J1Brt9#1U0Bdy`yT6X0>z=%;Ps+Zly}#NAP}!6)Za*sPahR{t(L`oJhxIlU z&EjfgBxpdsA7m*BIjGW0Vai*B&7CL{djuIyrVnK$3_Hk_1>=6UQb(^`?}!>J9tEzr zC%Th$mzja#kS)$neeSR*uE-xQe!Fw8kw9>VY|h{7Y)V&R$69-2eI+^AnM6mnQXe%I z?UB$4tON}^>gZ|+ks6Ph2LBpg(ZXnEz^1jaGIm~!YB`3c{=+j760F8YO)Q9X-(v#8wVAN!IaX4D-*)| z{adH+g29Mv1~9JAIc&WicH%O;!ww+J)weajr%ZKHW_h7%lo2Fhr7rk(_N6%E%KBK4 z6Y#-!xq>08 zQ!)VsT=ZS6)nQVND^ucCLh+swK(%)4jN;TWN14*pX(#yF*(99r0pE)Cw*IR71H?96 zDP@iaqmlI({h82qbfE&RaK?r3{<$|y6TU!fUs z+QX}V2o~J$FzfEkc8+ZO>kDZNcBY>4PdVQvXi$lH#+MN98P2lylw>|CGdYQMR z$8K;QN?jUeK8;U~)C`JU(}I@2JQ5N1LrA?Jg=H~bbQPo9=Co+J_omPe=I--jPMXmGiZ z7o!Qq|1uVckpqC?v%pUk#~kjA%|7 zBT^iYuZ-)p-WhOEiPZJ;Vn%VwSTkZi^8e6#aDT`p3_s*|i;uYQpeShqiMT`mNlcWp z=fbx3WLtOrb{*_9rjGDsl!Psy%(|LuZE?CHaMPHBi$OCMAtY$d7{akkhr$`ZhBWbL zXu$dnW!)e2J`6-9tQ3icITSV^&)m*-$|J&^GHbNNSBLYAYf(ny+F4Csu{|~!mPQHI zRGM05w$Q%@k0h2H9L{R*^z>6;6z=fv4ywT}=jrca|v1N!E z8;3KHA*_i>f|4XDf9x2rk5GP$ya6NA6zs2H@gUS0?H=USpLZpng8xmrfI&VK_M@#2=&`C{Sq zoF7nTbP`xLElHecI#pFPw@;KoOi&@Iz-u-tUUlct4KnarD~G)seU4fLp^6_*!9LmR z!5<^>abR%Cdc1gVlolLkHXv9kIKJVAb-hKWJ&>eb>*4{1m#t%qeC>H|r)ME6<4YTN z+vgXjj2EwZd7LWU_qps8GCba1Z;@Tve?Njwo4bxU}08@sirfN7MJI8@pni~ds-?R*L zAefTks8WfOa+xdH6h(8iPVqEUTm%B8lS5Z*Kq5oYz%4}8HMlaio~ct8h;b213h~t> z2dE_yzoX|M?u#ofaWQ;joJALmdYdZTcq+5T6{fXZ6E$T)SEL~Y{vH75r55#w|-`L?O`xI!2smTb@#GKBp8pACg65O>G#wJ~gqaB%3HxbJFJqU2#&@6{e8m9%7i#fZSImxr#&Yhgu4e8|0Zl+H9?8wWV)br&eC=#WS zDtsRvqP_g74yH1ThNWqrpu~~{(6Hy^vo*1{GD(V2(~)dS19FBW2t`SdHFu$T*=D!xl9)+| znv*j}SbT*Ek369sbukUC^UZ-1J)2}8Oel_(t1-6r3Qd!xeRhl}gH;|=5^yY}s7$`= zG{HGZ=YS}cFqK;TIh7<3hLq3>&ez((#G9-tC{5$tppRKpFf%X4GgLh?85mxjMY__{ zDY?$XTMS#pe45MX1}Rewm?O$sKgLColNzMRYnD=@UsA~Zo4dX$j?XwL#t*}!lZh*q z3{nNU5Y*~wO-Z8)tUUo#-cHh3rZOm5LPJ3c5(Udh5-3Z=DEhoOt1QySsG~RuNfhHr zb7cS8TA=xbZCq(?z?u+*r}+q>=C9^y(40Lc+_OeLwyrcV?9|FHf5Ktuql zY5)uY3@3g768QDYA+#>fHnc21I8d20UIy@?%VHnU2C^q+xM1EcL0ijkpEt7sCFlL8Fl(* zKB~})Afy#VGM`9E0d`eyo%zX}6K{tuUtY%TgjXF}c6k{W)zH&a-LSEBBkny`MQ65O zbzgkfp}y_RYN+v=%_`QIZPVVPtM%0xS-qRK4Qt!&ygIE3sK}Su-Otc-{AwrvY3@7Q zC*Tsz-Mv(=ZjA0b>;2j+|LoN5Y^rn}@N1DxhTs=MgX&2=nd-pvOr;{O4TYgC$S0ye zF@(HMNFkBEX`#fyq?Pg{GnyBZwknDk%nR+lji{KC=Sk^asPby8aAVopw@Cf?xM2w{ za#O2SU+$<=uUB90s8h39U!|x_$#Pr*(#E2TV2g`H+hJ6wgxTs%BQCH5JXT!gko#U6 z;9qF~TwL*)5Q-&$)Z|MT5$Ql7Xd;3e6}JaE^wL~~KBJ?EfOwmBU z@VFSMg2$wHC_`p}bcpPeZlnl*lGqHL2J*yX3u_?otk(jEF+vGLr<3g6metuoxzYt>AVv! z;dIdorc>mAXVOrAqI73{mMmo0DSd`&3TTaG$a}WNDG(YW2E^<&od6#r8?FG69hkBS zg-Pe6kG>NKtHK_1%aW~K1A>CCqtj|#rgNoT0Sdzu2xUXu=n2sxkqRw(%2Em&c)+Ke zX+)LjNk zlr!GStGW*hDufVj2?fB_u@x`(vEDmsJ6g9PwzW3UyP;C)IAX8ZBjkYptz73rcBURxZS) z7-_H334DxK7~FeCSwy;vfEwM6*r}fiWi0DbLti%>glvHKqvQ(N>>6wnlkN@cN0ZQ5!=ALCQdG^SmIWxqAg*sy|&118UC*GW1^d34TyeRl(o8=!B5|14fsV)vH%21rWb$pSW?HylCmJ?_ zQZRxkIYi#yg$owQ3M`BnFVjC=1f$kc;Nl!4$Onq`lwvMBDiI*%H8G_r1WxpZ(?a83 zFCGNfkbr2uHWTZnI8Q-ThvHX^2Hx(~*=LwNt@Ml>TzM9((08A!_N}Kh=w;64y5f$e z>$|^dM+0E0X#3JtQrX3*e;}PH@X39m2S^;MV!rIO9!vAq(`>@T_>&RHP3D zFA*@>mNDEPS*oPDVe=|n>yR|2n*I~$#`=$AfXy7bLjqMc>VwTi9mgRMYv z(T$GIse{vIx~a=&@51Eb69Je*9_`09%VCO4(hczC^|`GRp`q2mx^?7&D*>6qUn$N@ zg*ig#hZfs8Ykwj%W5w=;$i=Y0We#yGv%k5+a`L1*HO+W_dHDeBH!QKUtPkm2_7W@K zx$b&PVl|N5AHPFw zO!eBzl_U08fGX3t>)C}?xp>2lN!CU3EF|6TFN>x&J!*$NiwZ>o%3&vM9@cdmYV=uV zzSPXK`#DPw-(l)s!Y=PFU1sVDIhw|m6p>Yeq%qn=`%L=HVtGTagc$-+j2kAxY0^HX za0u$ONhqndU=naDgi2JvA$RieA24rl-=uvXrV8Ga5#}kGxxHA(H#sKrM2b#Hlo^1{ z>>Fn|Iw8$4~#os4&}vqh*3D^BiOZk0U_Rt$8Du5m@^@ z6M#BNOk8NGewITJB$3I05N04n*NI$E@y8!AE`Y+OkFoeqCr z(!%!tUYC4x#ZyR!f+D#p5$ny<-|pfcu*k>MK?Y(Zrlupwu&Jy=7~Ikwc17ZS1SH8IMC&oDRoSd zDshhBktt|RYZHmnOX>Zkk3fgYxab3gf;Xt{H4y!P;YM3!o5@A2)a1frBp8=bindV3 z3ba-`=sr)a8Ka%B#nt_jPQ0Ol8WxIf<0OY>V#f7R#XsA1fN;iQ95E|HIlg7n(A) zuSU1-dR}e&O}8{Aj_6M$tZ~t40zQ(@-Bh(b$hhNgN=9;NY2XBzcvN+bbSDLHz3t-I{5N;d~x@n7B+ps z0)BzZ1vZ)0hHZ8XqKMTNBo#J&UM~p%yyqK`lWf4x!Qlp`N})>jDo6WEoCUkdV{X{T zv`CUC$Yb>h^nLm|TOjzzslkMzVAD%G|0>J_38rF`v!ZbZD<8(6$k(7krRe9>v)Miu(>pnFtUX<{de}Mkc_B`)YPQAZ|`0M${p3g5P0B z7)74BJt*R@Y-^o&bHx#Jy6Y@7io^i*U&=S#ZL)}*q3N-;Sl*KZhNb}9x@v?{F**^{ zEs$-++nuAD2b`$GR`Vfip?RqiyxT@%WeXj{#2^GaQ8V zGS6L^WpAZPb-SO$Ln-Vh6c66+Vb1EgIh9V^YojT(p&AsxPiZ){zDJFjZNIhl`>CEi z<*ac2NHqWMdHvt1dyzLa9{$MqO9#zPG-W#T&H3PN?iUF-ThRoeU-Q!~ykA78AIf{l+0O3ASiIvI6X{Nq#pySM|-@^d=#>-@A8bM)9p zU=JRr8&OCF#{I>$`vCVtAHfgQK74mS?qur@_CM7?+TqsO)5B1)fqgNy?y}ThVj~WR zj$@p+p+6`d+((KVKR$GKS!zyCip4gXP<-WUm&K9gDY0_zkb#Mf50e?tf6$T^U9T03 z)3wcFnp(_5$vvQl#Eu`!II*aQnok~EWTt0X99t6c-Xj125D)?Y002WoHZuSK4`smA z^v`}r)51e@0}ev7e#_jAUshYMX=?@Wk|U-jQglc%CD;GH<-Y&~W&mhr;LxD}v<*^) z9S}ehfVX@>enu}75(yOq*d!5O1(54H-=B5czwLExx|elJ{NwzV3E++XI0KOw5b=e> z9}t2SN?d%9KvvTD#SDgHj4euh;xGr=pcM^#xVD)f08kkKj8FiKl>yaiC|S_4h8j)4 zdm^?aC#wys-wh1EGyDHJwPYEK5F(t0ci#W~lTq?#X|v|>CUWjN$~6CN8ab~_GDi%J z^68<|oIY*Nl9{`yTF=8%)8kI$KJ)5dr~dg1?>u;rvftZeclue*mtTG7!YRwAnav*i zsAg1oMgF=eA}?xAycRUs@?=vuAN2g#oJmT*8HHzllM8kx^mkXQH_O*6J}6(qK=~a2 zg!FI=JHw$CRV%vyvVOo2-r^>6&Te|>b6vy;QGp^9QUQMrNh{neyxkp3p&b%m3h;M? zw`-+jn^U&Q08ZNw@HXuTyW47S=S>+J>y0`S!;Efe>s6lxt7+DdqWTr*nAeCD;8bsJhmGD;W5LwqDi0=TXbE@Lu2W4xLq9-y~TAEBNp znqgs`c8%9KY|vKRX58x7v>-Y?;{`_BGAW?y>iuBobK#?*B(SBFIveS1pJt?;Q#zkd z5{EP#@n1KB3tfWY54#7fb6eII!5A6R$I%$VtoU{n?!C);rAgFG+i11NU<}dYbqg83 zy7s?(?%D%e2bW2tMsK&`+DL8J5~ioudqVIu+IUB!)?v_-)tOaSoxk)P4ThmXKMtZn zVHKxZY(~WVS*gh`TPEsRcb$55Wz&!VV$d4sWFKS|X;Ku9@|jHd_HsgNI(ZlwciRPI z`Q84`?BLRXo9ZP~QD=G4{B~zC(0U)$CYj%yfLe?Dpmu(2aLz3WYS$`H^j4#ma6)qU zkMM`$c8GZ*6Vo%J__dd*fQIH+*>CoGWyQ63DSMX5*~G+KOT;LEJ^`Sh>xU$!?Cknx z3b9pyR*c?;pC%`Gn@MCo{J%&DLW0Qo0K!Jbl7$rA^HDEuy-z~hwe=rDv-7zlGQwIW`3SG zucpu9y5RGxel$t_hkxciVVtsqz1RtQ_96s3a~sI}*k_d52Z%$W0g>SI;HWvT8DQc% zDqKm$JpE?>Nt+tC868k+rOS?TzunF6M|VK&aas3&;~~8ZE+Re`(gp%mYFE3_TH#EZ z>8XFH2J`#)P(#5<+W@H|v}UmYP}Til9p&p;cmUi_)-p3mZF80L8@(XFF1HHc-R-)! z*PR2YQ_EmY-c%~XNywp`Q^yg}@Py(BCE9ZJKGw|p9U;C82u6bnEPcQN;w&MztGhLK zYTM>`^CF{M7BNB}{^^Ln}V;RJ!Ul&FRW-WE- zzcBHmS<;ZQVRfJv%i3WtHjM~o^nhgKu%cW7Y%G?(1Mt^I55qs1FVOC z#02!ZWvo=&^_wfN@Cu2`tM)!a`@1He{@$aBX|Kgm5#9?I1Ac)=iwyn>o9RKoXcxST zmYWWhTj`)-+9mHQX1hYrTEr?ow z1XLRI?lPhnunnXlx=u&pX@CEKE7pM8+PQ%e)`eYa*&Nsg8{^Iwv)Cbv>Edmr9I#qZpGz%{GS@!5ot2*lfslL##|9 zKdzp7ga5SDFtakAf*O%c3JgRmANzf!8F6dzrH1M{a;dSAXP86cn^cu;Xk(_Snr1q7 zq^mlyB`h`>Iy7IH{L%0068esiOSzxW@Hz}uI4#>T+14qP>x;jfYep(UJBSEaHgZ$Q zOex58rCx1%L@v^?5wg9w&+ge%^eII1A!D-80GXExWRRFPb1^{wI7R^gM@%?j7!XYB z(*kE_2;S9k&@!SNBmt8XEr8&I*_Rm?UTufn0SwwL05M$`isu{LY~dlufUgBh02ZJN zVdstP-jN69oFAsA|7Trgzc;PSue^K*@3ns!eXhuMLB^DmfyQunASJ-sSwrnz=g`%q zA@se4>kEg5F9aUaFK*0at%Ggt39T^y@L>AS@Pd`V+6|0gmV~ZzxJi7hR!w4*@Ptub zgixLss|~b0YT^8^x5~T@9t`W`#6Wy5b}QZps)BVLi?W?jmx8|Jue(zs2KScna5o#b zLo^XYlOI81MYQ<50qnE0tNkbvzBfbUy5Mgv^%wZS|3Jz55)j1!9U$<7U?N-C-0^Q& zIs!iloBAPk0I>Ggou|Bo@-S*N@jMInh3d`dbxBi&?cYR~X}QbLu$~k6f1rBcf$yD` z!r95kqrBaWL>n0;7&citEp6WVfXj|~{wb0n*FK?+xq^FV-EuWs5^%e0?an&EXxYg_){vn%WV`;c3 zq%l=nkYN(3R8MT6z?Mz3jZw0gp<>;F{iD!IhsHz*L? z?IJ>?6Jmj8#m1es$h4@c5l4nrw}0r;Gpqo=#^v71!a=}(DFIi({Z>{=A=CCRBGp9E05(4s`vzoLQhLp(i_I;<1$Z9$kQk@-la9_Ygv^hwkF4Di7fI^Q(lm0Y znH>^`UI+gj9m2PGd(dxtYRfUm;M|{h1fpHtUILK>s-1PP@!_7;-xqj!tD&$mc?q@- zDlm`oFO$|V&F+2Qq5t0Fz>9AEIKKUFNXbQAOCGwqYZ|WT3vZ_kmCVif2i@@D5ApAU z6du~3>Qtr_V-9`z94NZ#o$jzxfB()w(;hl%DM4r;OA?GH~)TBl)?(knA z^o6o>o%|eNJ@ZOp(H^R02W_6K;&t_?W z8YI8}b)=%;9{-v{mu-X-3T7uVLij9!FDUZhK}3DxeCPp5!S37-W_yr4;4gyi zHk)pKI(754QYLd8SfDmOJs``5Z9BDZ^;S7}La|es6gqb6mtcD==;w`ChHipFLrL*R z*eu-K1C26*k&#umPD3C&HkY}N(r~2wh|5OZ-6H~N*g>DV*S6u$i)wR8KxbX?$_F8e zca2B)NsgY?2K0X6*5io8WgHv5bX_|y*A2BmZ+rpHeu>wQe|c5pU*ca$IP=hd|HY~F zQvd%qk7E_`GHNhs5YeR`wu#Zym$t_vDl?=R*Tet-<}eTd;_g@6>8)?O#Ep;NHxXj> z{iey-HotE=kkS8}HaW@TR&RVed~qbDLmhx(?E{C`vZm2HHqw>?ZCv?d)DRpfwuJKpmqGTh$j zQyU$k`WIE$HROOzg!vqo>HW{R39C+D*fS0ez0w{2^z`;f%*hoNJi5;U?YAKJIqLx; z(DNr+R=^5AwS@2L%^2gRnJoTx|FuU|%u9TqX7FJX-m7(}tS5hW^rhY#b@yn?#q8MHNweOic`i86{W@ z3pFa~!CfUkJ%z;B8l7~A9EMdGmGrAO9_$Ymnn3d+<63ROdVSj06R!d)^?9W((G}lP z2?k|4Rog$4jfcSp^yy0%`1|{IlO4&(R%M&aw2T;XM-Qi z`m5puz959gY)l7HTrz4E>DA8^xy*WtuGYf$nLq6@eR19mje>tP?wKF{-LLE=Bxx-e38W1U0a z=SI`6WM*!{Si1Z=r0Mx>-mmI9H(aJJ*W6vtIal>`aD95ca+%tmx#{2U?bZ0gW$Jv& zrt81wSFaDZsqZ}3YyRb~ao^y&rQ~UlI~u(ZpkO`L1Am4H9=n_veVC{mxp^jSrnBhc zYFy&;hFJ6-OhOV0V)eB_*o$?9z2uD`25a&5>KBGpKUIl0g7(8uA8>*c#Djm9xBA`p zE`F)wT9D}xe6EgL+N=iKh)Z2&F~%9>n!j}Ki^?LtE-nC|%hDp~^Q)^gxEi&t$l|@fY7ur`6$_oKWq?`6m^)!! z3sQ$eb8V^NhlB=CUnM+rVtX)nRc)4$i!_Az`1|w48(tX55Iny@ln3w{23M_m65;#| z{>%Oj3-G+<(KndKfAnP(HmRqHqtjN)xml4z7_Lz?d&!5c??G7Bklmx0jYD)c?$4pH z3KFA`01%fqP;fzZH;MWE+2>3#T$zWKpK0-3M%_NtdltbjANKlCf0R4Cb)Nnk?Y@WVP45wFH?*RPQS++8B z8;3cJ26rR?7UcX8JooBk&3N(5gtu3ix7&k$q*lyQo@!l^6U`L|v24BQBNE9#GGPor8=h^FtiWZ@kYZsy!4wcH0k<&w+-Ar=d6QJ@9&iFQ5nMn?f=z|# zh^5QUHl5m6->V7GLjws5Vc_=LOM}T*%zvii{ipg3e{9>}HT3^?TjGh4Nq|WmWWAuyk5rse&kzi*T4F>fV)vA8rEi0hz34nCgTIyr zfMLkdfP;ofd)z0mL%__^KAB9J0#u;F1<>xr#edkB$w1893}WF1K}*F^PQrNVbM((7 zEBz5&fWT2m00gd>+YdeFv9%LIC14#GkAa6jBTs`S|84#UE1OT_y)RTNwf{5dLBT+z z2v}8KDekOVRQgK&0d$taAaW5Sg9q{`aoeEH_6HOSD?;*x0*HRYlF*0`jbSCg7^(FH znLSjhGdW5wTp=g7t`DDk?!ZvM62%19VLIZP=!V=h9abh$RdUr`7_{bxGm`E;YDgn7 zPRkmm$zYPI$Ii++dtXpbs9H4y(|0?j^n2wk@sbaW7J7s1&C1FA;Rb-iWn|ZF(@-Fa zw){1I-2bv(ymdghL|FcR13B`50@##N%qObJf7~2_xs1W^l!x8G7If{6iqa)-+)!d= zj+n~1I)N(b_rL@K(5K6vP~@b}58Y!%jq@=Bk$z^t*l)Exu>bH^seO1-ffk*4mDeEt zwWoRIyBR9U|AeM|>c0zm|5XUucP)|q5PxI^JZX>L;)yt=5-&#coB^;qPsLyVnDQvV zprU4t;$l_=DAoV~5D)?Y002WZHA4UZ4^@FEMthiN7kog3;9_rC&Sti)mf5k}0K9vo zHMhydYO*(yuZ{ozg8BdeGc#v20B{IUN&-lNi9RnNzKnPy{ER~-Xg~%D7x7cT*S7n8 zwrlHYgQ!n0PRIw1R;lXeR0RxFSOtnzp~&n} z*m7ATv<0#@z>0a9v&OlUXD>G^mFB?$mxmyMC1RFQrJlHvT@9(gdR1~~>UB$%&{4`1 zAcU1FYiZ3(^6E2lO7g&i3#+)m;wpov_jyiqcU3}{T8v=Fky#yVXTgy~b>ag};=9&k z-(4mnZnHA+VauJB`8vO=L!gWr>xYYKC&MUosq^@)0y9_#F1yMWw)e*{rZ2xWy<}+LB_3!gBk)n7?fI;oTVvG>`A5!unn_O zo|en0ap+IF*+WwX27_8!g2syPy0+2vr6dp8T$t>eGbtV)ge_?cTSh`w<7d$1PIsqI& zXjFZ_Ww2rz$5``XGR`6m*c|E|zFU;eNjq0cTQ=VnDtCl!RM_B0GEOjbT73{!Iqt_Z z6YwtA06Z*+0G$gL({B*l_svzaTNo?5Zkm~S*PKt>^>CpKSPXG)csha!kFkGyqj9=2 zXG_BkYFZ3)^{EK(Lu{XO33Tj-bn%r$Bv~Eip?~h;oyQV*)-ZHZb@=f<4%ExoZyiEm zsY{iq3gd`6owOGW8IP9f9@}$imdpJxucfTf_;<1E`_u!F^n=7l0O$)6ABfnuAclZV zu)|>s{BU{zn->0Ll)wkGH^y`ua%Nabdx3`yOD9GESS#5+Yai^<-JFt05rtTwNU?=I z#pmQ`QqnT>Nw?c5_ZpHRAq__-^#yIk)>5;gw^NkI_L5b=;Sc~iYXpII+xXX8jQ>7m zIChWYI$h-Y*{${LeSrw(kxaoTvL9G526Ho46> zEcpCbAP)E}PX6Oe?XMwhgHt5pfl&$5PR0(B$Cl@5?DI0$O=X;o@OShn#7AK0HxjGR z@V(n{TMhs|@O#Z*7SS-k0VNbVRULz~xLR!veu!t}q8wlmuqA~}z?bHxM06;Wb%eG& z>IN#ND`kOBoWT`;+YEjZ6; ztvxqi|LqQqkfW$7A9qSYPe-*#y?h+PwrJ`iznuC9B(ZB8v7EZsQcdzCV04=@>9#Jd z3j>YCM6pABVFg$b?biRZhvxt&2}KM-DxUqxeYPYNMCit1E<(*@N2U^rB3xrJ7c)&V zV)l`gDh+5X|6#FNPkHB+~)K5DKxBi5IesVhgTg2S0ztpUa$fsn?oujMs~?@w%h3XGMuQ-J4{6A! zR=Nb|71dz9qg^|;z!=@Y@vLHO+9lfha?s7-nz(cikcBZvMapRO#@SygVh& z*|+#X-VpX}--52Q|KTa>G6E~awB@7Tu;ezz0ho@aYwAWQrw_D+yCyv&*=7FeWT)er zn6BpJ83fpIha~R`zh2+f{`cSXdK>{lMT9=0^TJhbXXVh{;wwsA^5(>f0lsI~@0;j# zA!?8e(sVuj{HOVX?G;NUa;zl{9fXgB7cN!uscOe@urALqxt5%-dU5*qZn$*g3nCmG zUD!_Ew+{Uw5WMf~XTzp>Qv9p2*V!U?3-!7-dM~{y&5SGV!Qf~&hkl#0zzVsETiZBo z{GA#r=!bW4S79vpK3}}=Vj9z!{$2UGBt}6QE^cEC#R1-XQt$=s{x&oLi$gwkC@AP# ztr1GAjPaF^XLx&EhlcE8P@ETG$5G|%d6Rg~c+Tr{KLlN`&KIA`{ku{KBK4P;6ez!D zxLma<%^o_NQ~%@;1+p8x3n29tMl8J5n`%W42`r@!R43SwH=}MEe5!&gM_OJ~648%% zaqw8>_OFyCsH3EzILjJXdF)(3Q`i22!@%&ZRTCkH(go2Xp&zh$m8I#4+CzZGnPI4f z^cxP|yv&@G``iQC_@nxAC2j0w1IWG=T!w}YmTSH@g+gW%D zrw-qNt15{Th~UVR!C{rhn1Y4)-wWBpfcWCY%3&PDBeEFcaeyb$>!P#$H7!zxrzo{66Fy_p3;vv!^02tD|MM(G9`GgZN4y{wX z8y=Ad)dXSejem@xelol65RK>_h>rnaM8`*zINSq%CjYe=3!=a-7d8ne_NCu>oEdrF zp_<>unUTf)cmO2Z6Ac$ae&X*q!TT?L4fWhr)4|2B$GiIK|=sEtWY&X%{5vP{dbsh}AD5!+eO}YH-rK${Z^JixSre}}L+K00 zu%7$~{hUXL(9NKKw^UKd(@@Lrfl%*br|^vZxN#-_PO9Bt0U_3415(o==v$k#4NLnQPv7xh zYuMfXIG^pwH_j`nz<;d9{H?SK;%3J(QKeXIm368Y(Z1`9%nc$l;9dD`U4TY||DOl& zr*nwGv2;3;aJK@95KsXF?Lr2k9jD8`IsEn%L~EfjA1LSmX@sAFp5N~HWwOi;I+%$< zfIJCUBl3Qv4ygDq*Bld{;?g1w10RYh>A3#Ix94H@;XXq$8URB=7ZASVAd>CkHaQGy zWwu)#bTHhVYzikK#t9Tp^9wSC8rR)7NIGDmb8Bpe+8XgdWRfrGS@4)<9{R}pC3pY< zaxnE9PolW_-Os*pF}!#TB1|CyDAAVDml~6^@5{gahUFQGlXDTokSB%4#^=?H0^7$n z45><37y=Z)t0dOr2bE>YdQ8oL(Yk1wM2sOCDs9sYhKFsqFE+Q|B8um?z|a?N(dF!d+n2B9aBY}n2xzs|xY*>@OBU5;1~fQRt9;w0I2 zv*dQJ8K!(fQxDRk!jhxoC8>*T75HNKjFyRMdN0k692p|AhDH%z&_SenwNtgh1-a27-9#K0QO-W@u(C2V0F>^W=j?ZPz zv)3F`4sW+0;}Dk*SRLSDw-&jm=M+BYswA=$96F+!5I+`af`9#;-;u*l-x|P+So83M zC_pHLuU+fXYzEs;7ASEkO-PuooXg&4#_mzkIUG0ab#_ zaTiD}Mp7!dMkV5oWC`eUc~w5E!uilz5-u0yH2{h8>}7gVN^N3!5M2@}gw) z6;xFcoZU*f^oI0xdN(>-y&rAu`HH$rG3+&(BwM0OVh14^!i_$jc{Vu|j`ki!qkD7F zHqX_1k81X3J3fh@Ky-7o2kW=t{ha-_bT~Ng;%C)xEzAAO>Beo$d1XN5hG1)`+=jII z#IeA&nuDW0O%18e|I%obp1R4a*K^i`SLKHMLmfGm=JIV@pC|U^=LT7@VwX)6H zQPl%{k(H9=Euv}>90IJAYe!wjTs58aoRu{MKtKeO+%<$J)>dOzGrB|)VeT~$Y}Ur}-{nx;pp-(4z{-OEyQ!66_Puh2JD`gOj^qB7GuGY;i>5Z#O5x^UDh zKd;ih&CUHE0%V3Izy}9(liC}NlHXS1L11$38wzb-33Gv97)C5~iD@KLtINN#Iu0P} zH`0TuZ1_g5zt&h7Rm;sG4rHn(8x7tlo`Tf$xVK@^V|;!tXAWto%&mgw1OlOzkgkT} z%1|x4Vub=Cn1MQk7jy3ePpu5TU5N*Q&^we=|Fu)C`8Qv-M`eb8$`R;?SVasrmlTI$ z*<~k5JBz`s&Jmj#y;yARbFx#k-QGieg!mV_Q{J(i1ur%)zCD6qZ;05TX z>UkGtYHEl{gG}^D2i2tB>tJ12z^aAfa+*0*Pzo?4 zbQBvZ4hl0h$^PMMGa?MoMlZ942!-p@3E!G|m_X%wZ^IuiEw{*skYxg#I za2;3THy}atr7yP0OY)Y$mEl&eN%$1{<(^Wf(7PV(m1^iSM2wkNVbQo=$t<9@!wEWJ237i^-q0KmJX; zjAoXM_~^Ovs7KDdj5a5~bMIFDk*Cl@Y_=+0CbzIY`YqYyEZ@6dGM3BN&=l3nsa~ws z_Ph+Xq8==WfJGcO_XwU%_cZZHKl!Qu!t>BP2>lDPkbpzz-P-kORk=rQu6>#dHL-Ke zDd&~HAw%ZTjFjnm*?5O{-_p7-w?OXAOTAyecDslz^JS((V>yI@b<+7V+s<~elZ?zM z$r6bI(xdaePpi*+(f@?VKp#qo5#*49{wZ`~Gn<*L9y9!HR!6jmcttxjI_b;bRx_C< z@PFgkbcaGe0WA-ZGtN7i7iQA(m$5)ShsZ2c)sfD0s{F2#c*DVZL|`Ho8PFOIV1f7Y zsRK<)?Tc<~09X(Z0ssI2GgUA%000kFz$vun^MZE~QJw~MYr9V-vt3u)KwPRA+e}ft z$;xRf|4#q^5Yz$ynvt*~0x(p77B~|jNJIcnO8HIrfUg0tiXg-@0Z8VC=k8|T%Vln# z%jGU}E?EZxygxob1m}4N>>`Pl1!G)4M~C}B=mr5P@o|| z0Du_)nVA5nttvUToMgsTo7+Z~$cwGVskOe%RJKf$PkbLtIRLw3Y-_ZUKoUSAq6bV5 zkRJa&C%Dh#;Nfy){Z8>7QEp(~r*ZM)u6zt);wX_4W?jzv{{Q2D>;v5Qyh71x^Tn=w z4kr?Sg@bTP7UU_H&_qTlSovMBRruQrbCcY_w;ydrssB&~vts8yQx#J~% zoE(>JN$X`MzAmuv{zqOs9(4)$abc<|ob$Y0*)$qxlwzoWe7WW>U78RTG;OSbLocd` z`YS^hplukAA=gU`Bmv}FQKV!CB7lronie;0mDJT{1sJ{fA~3Iv3-o$?Z#SnC<(N|z z8vR=1F@yvwYmq032`#p&N#nk=(NhK|vzQF%><#N1wW2udaO%!Uy-;Den`LkS!feR4 zN{Xr=L-@p9EHRLz8pmI42(*fL3JMbUbm=br^D1vv1Yj#ACKPFz8}I@e!^EPG$pm3a z*G;Dl&l!xGegimK#s?thvS&$)J>wpfxTz^ZI&w!zQSj$3=)ND@Uh0V#5UW%#Vgi<8^S%>}DN zSvCgr%EoXwr_yh~52EpmCTdQ-G402_s+V; z-w{@oa{~-!-YuZvNY~m6sZ>K#EvsHImulSAsm=^Nuq!gx#;Wv;b;G`u6wkg{iKZiH z7R#((%@2iPi`n!{18)T!ts7sFYfQC|sKT_DoM%aG50I;Qz!AD>15tW^|6vn8*5!wH zVo>&Z=7aKg1;Oweo;gG39|VMVp8@SPw5PJq zq4!z(mI<}Furj&kwhPvVisD>;5q@|>;Gn`}?&n!9`ZjB+Td6XZOYKO1c~>PakCzQ& zidI&1eCjhb^z1r?z|+ec05-tPh9SED25F_xuOodDx3>EE@@22i(@)Hy`~#LWtaGfO z43ay-s={W#!EEh@?GicExH*4V2+(c=I9f&rmw?$DJ!^^iUCcq8{6}8Ea7sfqYF^oO zA9&l)XHp^4fSyCzG>u?*ZA>quNjyn=5`2<-n;^&1!$C#G(7JJ=l)_b|7>$PMk~>$g zHj37!;6;$8^DQa5gSaGO?^nOp?J;heKdZY|XSXFCM()_kLr=4C4Cn)l>w5oOnk2TV z>L%W{xR~LYyxuRgUM|nzW`uo4mOAz^vFc~qs*Nw z^f?s(}Qc%UF8{XrxB)-R)=7^;}=QUrF%2b?Xm|w zE1G(|xfdP`)ifMqDTnJwpTu$-&OYmz-Rc)`_}efw%WMEg(BS$KTG!^+^vYmYERzJ0 zHrWe0+ws-+rB;S9i0&#=1!&6Vtqc4J{_So>tB{a|$x{ z<`z|6sz>*n7Af#=LI&@tsljL}-5Lfkh~w(T{zYDI4EX|0`d*ogeyek_A(hgn)X~7e ze@e=4+U}fZkOm-Rn}y^tMqmPVdh7dg^H)rBRebAMOzSTi;{DFc#94Y+B_54c=^N~Y^EVo~!>y@1=Ix)7L#Ng9 z2}7=+W$U`+V#DSYUb=|$D|zPB?Q^}>Gor!!7p*3k8vHUc6pT%H69bmWi#ec&p$nzSDQm4kX!P#B- z9!wnq&Gc+GY~R_gRWfTSXEj!ePK+uQOtm9#6_A= z*eflzRKioX(<+&6Z>`3+@NrCs0@Wfae2=ljTx^P(tNN3-i>z7+T&%V%S$sQ8BB5Xj zL?sTe>0&M^arYtV9f{r~+gVMs-t)xfi5FL$jCndfs8Ju@S;x1e%NkLsencz>K!|ul z;26dLOJtS@U$qbZ)7qajf*io~l8ev3ORwx%BKr+Din+CkqBHoddG&Q91+4pmXu z?KiQWaK`cHrYDQrwy=Cyfo8DI&dHOInSo(pu4xsl#1xTJO@Sg~5L@-PIPqeR zOgP&4LmBiRU_0^5850)DXNT@U#Yrv_jVD|uA#cdnNbO>SWRb5)+-o(B>aXey`B;@t z3^_(fTAl_tfQGJ+7Q24K4Jx>}{TlnSr%i^eMDZ`J%rRS%N#@_}_9czwBRX0gA0G`Z z)$E_m$Kl@Du1d$T0TcF?m{|2)Nj0P~hoFenD zmh0u5tV8cKliZZCRYk;r!`SR4orEjd#OsM3skeF%y<d$Rccs(s z=Kr#E09>UMFM6mu;cs;p{w;g2aIKpK*IkG)Rd;GJ+s!4WHmc5?ebFSLX(&1`V2Q~k z3cam%l{xD#;w6a)=d8THzmFbgoCwfJ$|XR?HP`vlj~?ps8u-96D1!A$WJ90B<5+SU zX*|3djqP8f#n3%MYD0%!q6#0O;F!OxR&x_`3AtX95p`Ec<*w?5S?r2)_Dh}bq(*6m z&SfdWj|&n60Qi68SuDS7tnbz|oJAr=Ue# z^+&QEnCDt8_7&r@SqxQ8aoFfR${7V9Fw%EgRZbyFjpPa2*58qDd>gldlentmBA;F* zmn1gqB9CgE3i6ii$77LO+!~UCUB~Qr(}<8~tXB+l)21wlI*^`OjS!M`{K`V=jZ#9) z=R>A+W-u}doLNeJydsCo$^-&qbmsHi`~wh%{HejA3~1;jQ-H1$1#WV6Z?i2Trh~1j zo=w2I(GExicg64S`wB}^5H4q?C4@y)Zm5!+oO#YWu-*EO{f{X(A+zY*Kv9w`v7{Q! zX_W>~j3Wv}=W#nVn_84B%C_8ygw-__4NMe_Ztb02EaJeAcN<;1XOSDwn46k+y6e~; zPaG@H4j-sK@orD^s}c~-RO$@Skj>Kr${hvKX@%buogcNLyoNgN|MGvg+(4RAS73Jk z3&O72Oyg#6+ozf$Ovos1;=_x*0q^4Cw1{)VSXsle30V z>cD_e3VdAu<=mQli3b@ABo>vcChoeb-L}v~CJOBZ%+*%Ar;O1dS1#hwR(12FPDFpL z;(ANshuxL>0#;?y>kVH3i$C1XSU!y-z$5#ZCL4_QIqTky$kL<~vuLGt)`nhpYT`C1 zVqX}A0BIICZIjg%vV*0}JtO$!uP}CLaa)lF^iISpBcwPa6@{-IeqmSK*5s7Kb-hGF%$>gfJn$aM-X=Y zod_Ivh5On~AzU=&+Qy&2jgiKHnqA1z;J}-CI06_!=(BQjpL5SqbNe~!fE}``fileF zWUw=HcW0{pvk)$~QNaFxDtH;#&h1`h~k%u)Z*f(0EV zKF1B&HnFO=KBe}Q@u+cf%3W{>u%;I?iyr@QcPIAtg!J|!5GczS;h5mvd8-aQ939$$ zXO5hM9zdf-i$_(FQZj*eB16!ws}f;?)d-F|C>yrlT50h!=$Po4-VU09lcis-C9BLHJ* zw-~wX?>w*!0UxFM+?jZI zG+CLRZ!_=A!4DwVA{=RFmub~wl{w5>Y`OFCIhSg5FaAc72?wz_Zl-R{!k|Y?Pk1!) zQ!Y4@p)yr5&jQoX>1|-YKRx4@FaPk317F%tcfa64I@zn~#l5|ge^f(!ICo5~xrZLi z#?-^vynCEska}6InHSS-4`Z#*)WabT3I>Bwfl4tA>1g=r#{Q0IEO#e$HFZ84#>v6Z zuV+tQ5uS6#b%@56OBHB&3lSY2y4*=ztQ?x#Pn?DricJxHMlM(W<_W|+2Mq@gOeCS| zAMS&6-T#s2&>^isohSb44E2xJC>pyy0Q%8CLsq~}k*dI>(edGyc#z+#q9jTOc}y8{ zKG5c|<1Pbe@cDn2Y)PELiy_cBB9wr*Z zgGE1m5V(WYxX)kYEUqNf`OXM`guz`auy)D93Fu7Z;Ia`g=nhg#XV3;ZV?KDZfY3Jj zG>lz+z)FFH=2!YRJe^c_#|f$B`dnG=Sd?pjzZTVu( z&MrHs@yb;KIVmdz488(YuS9FLGPGxZL zC^iZmh7+f7;5R)E-K;a<(7D+%=VxpsJ&ldxCrnMJiVyta;a&&`Xgb$upqYy6TgFyK z5fMe4!Pnw(ZJZ{yL37!2x=K_bE|Hw`-9t4RR~<@}l4hiooTV_(q#R`#Hds!y?C7%+ zdkcs8^}NnZVP8P)`R-lv)U~ol#aGy{Kwwc7E)4e*fG^>?1uBK{Q$lz!mxOesDh$Ui z@c>@Bb207$>W*i_dgK`apXYj0N~Hb8^ho%k5OH8%B0t`LS$#037zJ{WGkt#1&x%^C zskxL$tIB;`l;J{4A{BQCXR69Tq?ay(7(%W{9=-dGkUbuUMvjG3=qA{K$gVbSI74-h zY2d2A)ygP%KaY}7pJD@R4BH>~Ti9QA7Ah>;`UxXy<7Db6aHfKVv|3MP!&%!VPi$s1 zy|=5cGh=_5p<7jyMG192@A9=^CO7|<)#RW|UchNMqz@~2j* zrXE`-{s3SQ5CZ@J05fDpG5`P$MbcEY`}suDka2&Fr-33dWP*~CzkEDV3;6@&ZoAt} zbCoRq`;`9xhzI}?%@`O!0T2*au@WXNH& zGh^gwR2QaxjF_t$#eA-!_$G&$sWQi9u7_Umu;u5PfDw0o*#YDyd#6E8(qT4gd?UG&rb`a73 z?1MzRpBTnS;WA_FssjcTv|ItApzj#XzU-w2l5O8T8T6q1P+A(u|D|C$cwp&#C%Zcl zL2A;K#Z{aR-)ccjyR0qS{;Fi6LC zVPBPGj#II+%hiF2j1ho7FD6Rc6UyVBFeQITmMqk~AZq)*V@=HnF^MKUo(2 zDufF|kT!In4CshJUj0UI1V+?-{Bt7=I5A^S#4}j?7&36n4W-A8NO&`T!DrlyCg&e_ z%0TauDT`GDRkU($0fe^UFhEvSU#7zGReMckq1r`6771+Lo#usi!@vA0oNR3A@q%|0?RG~M7m}hB9{0vz0|T-4FTbae8k;h zZ{!>HM!u0Z(nj8q^`yO-Z`d3AM&1a^B!^>`C1f)&=nMmaf*{3kqN8~*=0?1RaE^FQ z;R_MvhIZj)zxvl^_0}Pb$y0EI8ag#7qob+ZFpcbt2LGIu&oZNbhK686038_#2Sv@9 z5ezV&h+g!pa#FRx217ilttSZNegXsHw;fVV$J&Pe+|-~W46@s?f{fC$3P0720E4G(Q9u=U$I zN-_6piVZT&%LZQvr;OXt!(5XmXioF@~W z3ITO>+_iwb$^So+r7v2rnjm>2BI8rnU_Qn*!h|Ve)9k{dvHg`RQ%wC9lpgDi6$ql)%%#b`84=1Xu;8u0&SsCHtfe)`H zMxedNtP3-OAnzq3-zy6yNcUP&0N937IO_f@Si`QKfQY=;$1K99)HRo(oTpTSEP2i$ zE}e4^d=}9WyAMjBK{;1OsE2PS%3Cpjl~VhFGh`nWX5SC{y1A^;%8D#ZugO)gt^yTCtU6|{LXALGrvmah`ZH&pSs?*Gct1I2Huz0*CEfCC>zK&WQP z2aLD!g0zT1{)+89s}b72f#eOhQ{CBoh{uG?&^r%-vBTz?@q*jsT_7qN@gxFXHD?|1 zcZab&;mnsjj1jiCVPFLG7r9F+%+oFdL^@|2BFDZ&p*Nr*uU1&&x7UaC&ey(;UKTLG zS>3B5==Pw)Ns%{oy;iZyM;wki`P&yM&RB1G^pZFE^{+R(dlF2T^`{+qlX~2o`#sI4 zW#nmh*o7W_X<2@>Os0PgwMb?j{jv`XB{VVVQsDdLQ#M}7Gxh*iyQkwdGg+hx>~*5v z0obtLMmrN#0Qn|Df;hqqi|^phSPXe1tE-xjGr^nF;OV-5b#%K($9y-MCc6J^!n%Eh z;=6xNi3@eb^;9*=a^$QlXT^A7bx{byTTV}GVPgFH_=MMZ$UySuLq(`-3M%9J6Ds?I zEEg)B`K)^Pswxc!X3TyWT$23!&^bP6XVw}TXv0(R#D4CdbOLDizHbwNaIbX-(tE)g&2S4WN{0rXM61Rl0+BYY$0?ag+}QYhp%N@k< z>+ARhE1_=-sxu!SWaWzhx@;LBf!^<$l0}h z*0>xskvtDF4N<#pLc?1k9A3u+mifW>$q5%A2yt*8g~DeI^hUG+Y?xkN6)-sKuEKmv ze@7U2ThT`$U$C$JopKwF9zztI@(ttU?_R|*z+X4Lc=r1D?Zr(-Q+KUk7lxt**xlpP zuvQZI%IKi9D{Jyt!F%#+!``Tmd|&g~0Dqop6$XNA{A$)H@=Md*w42)0Ec`j9PFCg*h zww~FS4Txs(p!U1@NNIpL@dyG@4PDB`qb13Y!R`K_){<0LqurB9-2b zdJ;9u5g}3EoKw|2oxF>Cy~4IC(d%xahvHT2z5gjd$cOMldlIlpy9N5jN~54dOQoPd zOv&BsmpTO%Rvi-(Evbz7z)#*P_{HP&No|a`Lky!|%g2I96?e>u7=)9uM+!(&+e1r2 zqR=KGh>NgxJiJTtkb(7dMY@Og<-d>;_4O+DHALtJ;zgw?5gH!jWAF3HZ1`il)Bc*% z1A>#)xzPm=YA4^6qY*c+ZDe0FW1G*6)2(CI^YDQlR((&DN*72)$1rcsvvC4_3zI-n zy+Uq#)W>|9RRMnm%Yt|_08y5S zyfzN+peb9XsA8d=;__2+192e3Gr;<9qDg>g0Pc-Pf49Tlqvs}9FP->On-M_fckzMf z`RV=d#ChzA=*Rwvmd77I;GVD9f0xWQ+_Pgwd7xGZV)~KP|6CjgqVw&)1&~hHAnElE z3TQug{v3MOO3b6EbpT}<`ISaS0pCI!hO9#oS){$0Z*d#A8{v%@+HF|&t`3Fux{zqE z@g%$0|Av+Pof`jiWbPtToG%suD2#~|Wul(nm8=LuV!0U&;RPAiEc|b#AyZ&&7=c?? zjBsDEc#1Rxjbl!|6yt@*r)$hX<}ekFcDDl4>>c9-|K)p@^FYv}_r^exp17DBppY%O zLbMDIW7p7BcrezzGA+)KvIDE@)RO=ea_&=lS=H`|n`XUky?SG=ua0pU%QBLz;5_Up z_}#S61AVPtOI?+;2outKRS?`YAxiGBEW)x4x->z~*wKKYPN`1Hg9c@@f_UHL;INmJ zM*d3Os(hOEEBJBASUlVmYObc_wdWCH(GQE>CUg=)mqt`Z)N}ZJJKpFAV{?P++|~D9 z>{%MlOQ$TyqZ-$0iVO!+Sq*$|mlS7nZ)3hG6m51{bg+TyCWHORflvLs>Gu`{0{pt< z=V8eUa$5b4=ujJ}mx|`a$PloZ%hZ)U0sxkat);vbN(BLa|W<&J!E#&=~-28JqWn4+Q zWI7Hn`*$mA%P^QPeEL7)D(*3MCr?u=n2gXVCE1v+l zaN+(^s;b4m%bjZ44svLoj*s8^89qrWqp*B#(dHBXfOo;;zY8`c&!11Xak70kRH8{b z3U@i1^jEWwn(aqbRED0}KoQ${=TL3OxI5%f4xNrZIQyH*EhNafxuFT@VbFy0Fnq{R z-5$mKe0Z7Z+pqGl1x1NAc_pgu9h5d(E3xpyZP$wDIg&?IgS0SbGc@m@ z9TWv6oSwpRdZrVX%*G?txy5asNL{lo%x|ZyvDxzk6K>$p3NYT2;N<2u+>9BBX>-Zn zy6D@bM+{1Q=ppu9L+RV14v~H+s;ZCj(0pr7>FDeUU)DZRI^a)AyZ33ItLHLSvCDjV zpZRP*mswOU^N)JWXZN}48Z#~LlK_Aa5CZ@J05oJaBLDynMeUQ zwlOG3$OIpdBtw#!?*IScWKMm%^M{==^v@-~@BjblzMIB(-+G^xaHP`rURb(iytTXK zQ0F=B(zv|oW}zPZ`MxB|%LIQ~x~VC;M`+=V9=Jc1rLaZOs7l0if=5dT$026@K+i*q zOxbDbLq}c&jLFEC(v^vmJZ0xfV$%gZ8ALc#F@xi=>w?-kTXI(D*#PXT-;GTJZ8R+{ zQIrixQ&`Iw7^G$n430EKOG-6Q;|VR5$0J${m+4DcahFaw!(;>CG%=eAu9b-QJU~O# ztkI0N;XLzg(B8yn2^-_?oXw$E&?Zqg*rF<-C)Vny;(MOy*+`()n=pj$&AAHD57l`A zYkGQttzEq*Q|K3Q;&Z9jBHIL*13*lPK`;iykU*o!hN$>iB6Em&3f`vI68aJ~8^gHX zp{4(kBU6d3L;y-n08TFe*mPIu(edLgG|S(AK?W8z>^ZtppBGVNbw5K$cJng*Bwc7b zZ($)u_MgQnhaHVPDyqHnF{db;(K?bUSuhv)Q>F+YSj`bBr1Lm(v85(IioyO*;64zkim%S!leiAMibjMcB6;?m3GbD z&*ZuD8(V8RisWlz!s&SB(N&^z&?OeY#I11HbqUc3(-bbmnOK@B?<3#jWJxIPZ{l>;)LzxSHppxYCc4(n7UfV zERC<~RvQJ&u2*EuXOLi;-3oDThN^R|*|YA@QifgCeA94kimQg@{ zWn2{o*a)16vP*HBI?IOz0OrI7fOF&|{FSJdPM-ASIu`)Ak_`YY=*adzQ-Ov@bSxj_ zn3Syx9ZJr5TK)MzW-D{4DM++V|2{Jm^aL00Qy|X8;~taQDbPU~zEE@8OUPnhw+;g3 zX5j@ZiO}hy4GFtyiCz~(oJlrBPw+_s2*7R~LQFhY+5L-Ggia5gM9>D_gvkIQ3{Sk} zAX}nzf#$qDiG%^*O=ApnPj_8_RX@9dMXS3NoA?wv?(4@txuTV;xvbA&T8(dqChev_ zPZ8T7rob>5Q(h=lJRTAHhZCap#e#tS@gaZ@y|!+D+@S8GTu|?LZsUAamCaA9C{Vr4 zu(46r-(Pr`J4XiT(wPCf_`oJk`xI;wTGwFBW`9=Tk+DgjTdP?RXlYcYY#eO zY#IRYa#5+2^Z?+FVX0KUiAoFwGA0H|8}x08pGR?VU=(Ky*1;B(Q>I;GD5M`aom)yl zfXfL0Ag7{xk+!@$^FY?D!;6UwNg3_V7xqOt6Bs?xTohTfGfB3l4r80NlPywQAE~?m zkV6CzDA5GP!izTO?>nLCFM}2w*`us2+*X#@KG!4Mth4@%|D%GYk&aPS7T%61)e(tS zm8t}FoV`lN1*kBhmTO&2sq2z?rH0#|(f5U_TOsvA8tZ@*sN&8#5pJu5oCdl&rMHtzr$JEQc`@Y7uto%5{db^H` zh(*rY?%*0}IAic8v2jSr&V`PTJzV?`pC)#}rti!;vR}phvr&H)PFMV(ov_~aQ_z)L zbA(lJ(z{a0-)Z_&kG}03?ag5fC|d$Tz=z=LNA>RncXRqvY!-YS3e})dA=eWHTXQyo zdt*qdHa$$lW3$(c!hmhhY~zPkfxMNiS;3IE1WsQ)C+5XoIlWF=9{XY>w#aeC|gO|Dtn+!=fQ+Ej?@ztlhuW-YBKCt z(Dt+PMAnZ4%-WT(4+vm^SbiZz3?k?W`{4>M;xEz{X%}f1c}3Jk+#=`5`Utv+x>~*8 z^#7|jf}zxKAUe~nw32jnAm)s1zpE>e4Z3B5@8kn`4n4NMvwnw%e9Ko zm$c-5`9gXdud@I`s{@Lm$H}i%yf?R+g#cO0>5US`LoYwVTUkuX*Ylm{uoQfltSgC4 zO<4R{sk~?)UM~oQA0Gfx1Tva7vk~u^o%mTS{_@Cmm*#aUF4g;dt*^;K#2k;MTMMDI z`Kv*??#b1eDjhHZn1l_AfOW*w`~RiboxFG$P(PjqD4|FG&zte#aFIVpmwiNbN9&9P z>h%)^Zj}=Wc0CjR8mm>msTW|&i+M!1-o%%ed5Cje*g+PVALMjar%ljo^do>7o2^~i)_WNpD z?hDwi_7{7!bYfrG_H!TE2DP8qi!j@duuN>SId3t|sP+p2%Z-M?!q*{ex@T~6@Hg~$ zaT3cB=SZ=FEcHI{A@mT!cG6|SwZ4VJw$(~3?@MI%NE3loQbnOnV(I7Y^m8lO>jTqO+lKtzQ<-^9Kdcd=hSliw4fX^Uo@bZYvL`51!+#>A}^iqD_FP}(=1O&ZV zUr`rj7y50$*)$!Jut6`^7o!@HZzCI#bDSTRYq>H?Z zyhYIb^~4eSbZPbI)W_AAV+^=&oMbyJ$N!fub76Zkvd-1D+%$eKR%XZm07GxzFVi7V z?zzIpyorqNrY!H-GV&NJ+GHMi*(1pRMidgfTEW9Fo4J4g3eyy*4;0^oS<26l0clTL z$CWhnX7Jwx9a;s6ZGA_0ItL(TO|McuMGsQqVu!5VvX<0k#D|FtiOAl-^Nc+ z7?-{UVt2HG=Kyg5z^gEVWOOvU{f1JAvT$RV1MNkF(|H$^H4yegxA;l@DmzUOwt=11L`y2prjKbVkh`{~8Iy zyw%6h`1h;c3W%%enT<{R(oVKaKq6U(JJ8eZ+ggVn8z(+>`>)tz%lj6iY_cy?D(;BR zucj*^$QzHXfZon3OtH7y^M=t2T1g(wr2x;;sPYvM6X;uGOap0K1N=Kp$?xz<|6))) zk3MEg`}xBxOa0)HFkRRZ}rQfP5GGOKLscg_s%y&M6w$Co?^HjBzO18cwCCI}0CYBE>H|oV4B@cUimt$YVen2iCA3 z7;R;dVK>n!@P>j`p3sH%a7_XWOS4L$?l4_|A7lrU2Q9#|2uZ8bPokt{V&lUT>ANn@8YeyC7hKqVZ^@BvE%}e#wPaf$JGhNR7BDhF-!>Uo zGBe*uPGQ#lPrnIi3S5?R1c)>)2}V-21f_eK+(o~vw zdkMmnq-h)O6TxwDeE`(NKYOQNLo2f6m=c4M%z1(8w{#GlhJ=_AIbb{F2%YlU%CltT z<{+3m8{_987*ln>1)Aq$cRh3Aztm`dIC!tkDdDfO{i-L~tf_(kB`XT!yq>L$I^|E; z=>yK4fCT!%$KUA-$%gYkUnWt2c+C>fKur@@0>={kB<3kC#vYMb4DKN`MNO5G5`}_T zD)V#-Gw-0%I%agOr5)b&8YENzcTJsNYJ_9TvX>!>%IYl_P~Qe|D)hlB>RxvO_U9!E zRX7Xj@?1a-8S1SkNEaU~l(?PLOo+CXcTj$-V9vZ8=c^u-ny0_!y)K8Gnogze*>c9k zpiUz%oCVVihy`xSi+g*#+j#YZU@6pcz;D633U7dM%mcp|R(Wp@YqB=MTi#J`wIw9Q z-^p`!3NPm8`+=)A%OQ4Vf>`FR13e4Ipd8by(jU6lWar)nNWCnX&|3_}dPNreJgKrV zJ6iEHagqv}%3z0^UFd=KZuBUZLcEI|5wLu7UP!dmhEp(y8&J$cSG~>v@MxC_Y!#Px zIxb_6baUBO9milE%8a{%3t40I$wRoD9hs7$4dc35+EFy}i&99uo0?xZT*KgNm`J+c zyj;zx8ym3pMhm$&+~mpNUPVSi|NJjs@A?aKu@rnGUN^F`*st|?2TTK6L7zw#rFd{B z7%&$MLy8qBL5GD8r(q$&>R1S1c8esM-oJ30BEgF-5_#b0jw>Lxc0K8w+{2!tPT!U9eTKsbwS3RaR{YLy}`PA76vX%Tcx zOTvoJD_zuDB;wN|>ZA6;7SAzV{A7fa4PRuT7uy>yCOE>$2Ii88E4uend84v(;VWN* z$3V7=dr`@w1dimecKfhp8Ik)UaZ++h&ryLj6Q3!@6V`FT!+H|T)&%d3Qx!{7+cZXt z?i>fya6HH|HKC*QufAIfe#xXqVg+Rh;y7)*;IwBZ*Fz`$-!Jh^t$o4*?7&L%v*f_O zCknRiZ3k5dhiZv->cRxQx=HrB z+{rB{h&KB96*h$<26VB0bD3>sU8ufx-KpNUU0Z+Cll>PlJ;|eu>2K`4p>a6uZxiC%Ov=EnbwIN@7JKWOcmCXK~{4DQG$AW_d?{-23+K#31Pxvs1ol z##Y8yl>G>uhIlwS4~vhs(Bh}B zhVGC`&9?xYlQO>^r6_Tv=NFIfU)%yaX2HUe8CmqTe{}{hK(Tgta2m0X_2@X+v%U@rHZWUs z!S;O{x%E36JNZjCJw?tEXj|e646SktjtQN(s%)=}b719P4uPl7PlC)6=xj5c1QA=` zZAfgUsnSQ4w$?bh^2+F6>zSi9+QCE{bzuVix^BK8rrM?Ja?pKj%wadpn_7;ez!)zxqb5fu{5U&=g>JtdUXyX9xUoI_3P#< zB*d$loJRq29-G&N#q$0JE&=!qgf_6g;5fi=1`r#7G6T#8UK(gNpkzRlfw%_141hC% z*anyza5oSecn!c1=#aOnfn)=-5CIkjoIS)hr!5_=6j|V-ge$z12%@(`u9dI00lool zAUE(EfFaN_UNi%M4WJo-YFpl`L$aFbG+oAiXmk9jU+nzxt69Nq9Cc|AZKDfsvlnIO?UNjEm)u5=P^0$3pIT>|+n9G3w5m34pv%SZ`6hmv1p z^86%9Zsba87!7fP?B5r7-U7CRwd_G_9zXSkoj86YD}s#ClWINL}d< z8TWOR@=A+(l8*$QdEQA&*vI}YJy9Dx2pv~`Y~p3DPL%+mwRm7_M1EUolIz8c;i3B` zs?jAA)a@E)x&ZZj>~G~g$%L`ktRd&-rxkK8w0gU4(Z|>KXy|bCKiCb-_NYf4=rtgf zJR#Hcfq#Ly7=0X#Lv!bitoiCnwhaFMqH=xsK6goI=w!V2CrHOB5ugrJLJv9h$L;_) zKq%=vmAKn0DAz|Bm}LAxIiNW=ouyi z(pOCWHh%sk_$1?d;4W;259`MF{6GvNXYK(w{fmN9qsdCpq79)#IW?a`kh6?EXf`W; zMJ_vM`r)p=dF-h*C4B#m_oT1nLLQ_GwCKm){1h4!FFf+YgAh&EUlETtp;MFeAXIn` zaSS~AzO5}D`k>-O91+_F)(wV*%lwh~qu@LUEa8Lam}3x6GKYxvml+cO=7I<3mt!`w)$H%QZy(vUv9Wa@7sAUfE!sXN5ljKyv>W0Ljbwq;k zI)$wxb9`fah!)CEaWICH>PN_U`nQU~!tO%SO@e1@L9`_%zCNeZqQ1gSU z>-{4d8oSFG;?eQ`>f#)v)LTurBX&CArVV-XV@H5QXi9t0?A(-?OqqiXPKf@_VIau+ z!wGd^xUM3}y6SK}Se!GR(EsPh=R1z%uuN~j_xh6$4!v_LD-PYvD(7Bdb1ddh{xKI% z{)ClQMh%YGB+t@Gr02iuPmgrb^)a;ho!@F3BsVW#sxc+ylfPA%n$U8FVpR*IJORXyR7^ z>>>`fKDyAaX%;Sdn+Bc36RBIXkx|E$P?dvoB?u^a?;?h+#UGl!rGE%AMT#D|cE zSh~&c_WsDBmTPKK@H=Bm7u1ywrpF;?f#F!#%+el$Y>9TgDl9KCd-6~Xg65Gd0tTC1 zG9&K*1UBXc7;Mo!aO~FK%wH%7s9wqa*Y9NZV{Zh0A*qRh*ZzgpGYS}9xA31Ym45e* zglB(A@cakc|3D%EtU#d&%t4|Feq66qq}I(3u~MR7oreVXzLb*|mBkUXdKnkc=8xP~ zkK4yA2xN(e(K{{mgiV!q@C1px_$J$2D}@~3 zH4_i8mxT}br{AE6`AyR32`0d?g|k4}QnVlr*uX!`QM%QgfyxN0rqsX{9xXiKq0eIk zaML~pya4?$->^1tH^>`0F9Y5NR^`G{<>LJzq{Mfsg2^^_gWdqvuXh8tf!y3s#3`ZO zM3q;%u}05^i&_{~2tYIg&9PmoNPke&x!=<1*sp22`Su||p6WOH28nD)H+^#}f+;pA2cDq8~&0Sm3%17g>((laE7?Slf? zRzUFgHbe|(bw`(&m1DK#rV?cTl(0cMxkH-nd}{NQ!RXi8cRG2>aPW&8cpHuL~+69+=WOZ`1 zfwzy7ZFS(XE7OU|gcHMpc<33^&2+p(lMLu3CjQeP`liGT!Tn4(%4P|J7%1_6$QKgU z6R#0oFH=4mHID?tM3Jg+A=AP|Te5e~=9P;ok(p#UxukQ|`;V(cCi24<4(1R%9z3OP zMbzp!y{Fx@QFrS>9oE;MG|H+Xv7+i0wCkB$NqID4ACSuz0YoBk=|yHtF2sd=Bc(i| zJ!Yi48mk1tuYU0-fiNQu>rTjw!2gIm5EB{WB&YW_SaybJ1^9=_2N{Z^CB}NsQwmw* z#m6iiFKZgEtV)LS6tRng$U?wu)x+trF>62`J4vahG{&HT9Wk3B+#j@E5%WY+U+w+` z9EFUCI1U+ud-Lngw}6AfHv2=xBeWi5c_Y}4O-@xEQAA)nr-?&-6Zi5EY&A=kM`R8( zFUS(a-oXiOMUcP(?e&6076{-Vb0p$aW*IL7-SYR-I~&f6R24?7jP+9|T6F!^x?YJc zPv^)JP8S9k`4=SSKJp}q*jirLBOo)TAOUrUY&Kwg%*X=OQ8D{l^)+CTa;3(XqkC`{ zG|d;ep$vz0g!}W-Bh5zx4rkZ~C2_^)m_mmWAqedD9zLA-b(_Q%mHOf zc5^!3VhFf^j^^^4N|R-^zM_|G0te1NCvhOoXhTs$${*ZXf~+^$WduK8tg7<6i6h$9@9zCAFLPzo;2c+4zy~Z3EJh#&kCw&$#}*`KouSq5x<%`NyP6bH zF!-*M~6|6vz@l@2@gtBRPRXc$eX%8tp#1)O6ENxPE}Z=LMj?+ISo z+^W3mQ`oBJAmdTh5vhqoW!rvljrc*2Yzyx4e5)mCWT7gNC)3VYsD9>Y^w~B06rT$s z@j-u8bHZP{1WxpX0XTwefuEQ5^PxH{T9g`&3X^La$s9I<4{NYu%&=B$S8Tn2zC@e|359iRwj59bPXv`r7$j|eDgY9pgNYz*`g(|^8K7?#I}hsWjfe+8mN z6xcor*oKcCVgvxi#$LGL{~m{kp!S19!Xx84evBUrPvxl>Xv|fv(4WTu;>MM-ZLS(R zvP-zcRb%N^96Ma;yvXq4CUS4Z`QBSdx+>pj*@ifgIkWF%Kie+|qP88Y0b~O@5CeDyRt(5xAb;$WF!Gka9y&ZS~ zRs*XBWEyZbuxdcsfZo6WLBOwpW!SDdru@iN;(*MPnJprFyZG=Y_;K7K^2pZeO^exz4-3Dd zx5nEk+3c{~LK-YO6|B56S|hKJm1lno=+yX?r$i418P`;BIOB{f zwQH=8^q!pLjtR3zfZ~-LFZ+!8nZiFL!ZLX2lpg|NY(KlNC`u&(AJsUSS`5w+WdP|W zCQb-Ch+yA9HMVT4N1;;>)0VhIV03uEEA!ZFwpbs=_R{faH}ums0JJ-P>YE?fE&pnR zzDur<>3EZ6WV;=DBh^Y1kij$^fkd(FysLsoaoZ);ba% z!q{ilnIR#3@yGhL@sdkfiq5&;tQEUzNZ~8cL#}-8d7NWGt@B zQvvS-s@HB*s;!C)tn;;{U^XA#N`lj3Kb!XMmz7T|3~MPok+}F$~gozZv*@}bfpNqLvi3f%$BDnxGJecqV_Ztzxm-rL%kf4 z3yCvCDa4QTYlO_NXLJp2?mcU1%}jGl>?!5w6nF3E8~af;+mwVvjR_Q_#9ja(r8$I+ zBSpwXUfOdb4^}n~SI=}gv(0bSu4?p4Yt9Wd$|WVx?szrqyODH7q(n3`&=+C?OX)o> z=sB0Jzmw3Z5b#QoQcy#Cxzi;1@}|ZR+t(M|Cccux@H=*_Bi=z>T`y{rC8fA z1h#TAQ!<9a?DC4bXchTn4A<&8976OBfDqS5dj5=pb}6~7`YLKSg}yzcyj@6>66 zbE|cDf#KCjE8Esio|RU-yf%iiI6~rF`P_T!uUd)ElM%Y!p-KL#c`F zyLILRTI^+4dLg_52OJy0utJblQ=mA~7mK3t=HzkPHpW3{IP0=Bu}FWbExLS$6rS z=5Mc@+(8=wwah63+vpT9Z@T`qs!aBMw=I;Y$DoDFYb^?S1%;vSpbl`~f3^|-$IWOz zw;|;Z+aoPaQ^@O?EczI*LCKPsAo-4bJeh4F1$-kZ%^VGtrc3hf#`gn@ ze3|T}Y@t$*CDKv1@-N7_SD?KY$t12jPp!yS#IbW3yt31JxT$4JPCo>xrAbUg1Ut8E zwie%rNaC&A{ePpaw#zbQYmL@~+ljM+Tj`;+(;*3WO&{8BZ}zpf2vDDrcYS7V;)Qm$ z%LR~IIU-o?oC)vK;OU{|e35pvfh~h=B#K~3L*^te+DPE_$Jw#&F_gK*fBAzY)Sc+G z8DqI^MHk}5K>n3YoxxJ`1ZnE=-dg(t7MuUFH*xeoPwx1|q!gV9;lKL^${Ab8q zTDBbqpr-s>Pz>^1;w;m@w9LTeFC~9K{NWhqZf@<3t5eX& z87c1OkUd@hS>D4VJ3GG8lG7(GzKR4LGh^P8oPKI7s?-bTl)HhQB4aSTyRQ%Ah+cC3 zS0AVkU{6#J$jtof8))60dI~aqiY6z?S}7<4`0V#l3bdK$vdfuYRjt_bkFa=3{FBlyK#z*RtK;V{NxD zV7lkY)?_{40}(xzciqhG;J%@uLZ$9dx#{~PkG&CxXZP)C zfwpBI46{VfU18|bjo1pddmalc)C63T4*ymndsK&>or zX-|y#*|5F`nw)YzVS*MN$?AQgP(DvY#c95aj8_g%pW$cG&L)cBh7eMsKh2O4S z)nuDv3xcmNe|=>HxJ{?v_nngRcO=4azal=7w?tmVRnk_OD`6FJ6`2*Z743?=BCSYP z#4GZV$kN@d$XDbQk&3h;?S8y#K<>g&2ip*8zZ?p^_x!PqBUO_!HC1DvOuyWrTRM@^ zDUX#}k*GnO4q>}3!R5C8A@)n&eG<+9BnF#V=zO1zZ zxpokp|E)2m-@a98bEz+nCf%8T_+AvS-$}v07mR>7lOWqhog48wA`*fp&_GlZQ(g@A zmvlKNzg1i-KJjC7D%(`W5Vq1h(x$$T;Q9hPB2J{)e>Zrx0K{&sE`k?I2eB?+VUXlw9Naq(X$sH&s=`<_y9=qSCN*7j#d?RbcdLw zX9_Vg4jRj=4wMN*Q?h5vbW1E5^A8UbrYi~rH=+M={J zy9(3k*KUpeW6Ax5|9DDKR*}_^j7cdI18}fNOX|UBlS%U)^|vdh#dS=`=5&vctd86Y zEp{C_pQd)bdwaGNa~0s5OH-O03fu)ue=F|@Oi4xq4)nqYh@{#%kJp{8sMnX>Yph#( z5!eVVgp(%wANuOgQp}@dZYRWFyH4px7pM5J8=C*jok>&T8JVp&puyLUzES9^QlBIW zJ7}sbxT3NAcK-sz*67(0pp|A+1!2Cth^=)qmB%GxSGL@M)yBCL=?XC{8uaUtZMNH) zZCu`9JKj2CoBnmkHb3svKH+c3n{pK_(Un<_eQQ(wT3l4dD#0<&x)e!<1owv_XoX&( zI1Cadr)l&tyGL+rjvr4BEr%;b`;m*81p!gDUL76X^=#PkYjSp(MruHmiI5$mvR-p= z&;WQqhrgIvf|foTX>L7Cp6E(_=2Se;JJ6vsRypGL)|U0R^yTux2-VhZB!{@8>dGMjxgvjO}?&l01ITu|52+3-e_7_i$`Wb-dS^9Y~}IC6DMt0A-| z4R}zBo#8&?5HUXf**$V}e$fG@jdTRC1ziSzqonlCC*DaS8tH*+qwx;tH<}a2eUA=2 z+x9NYGq%Wkwz||P@XQz7{LpWv)4*nFb@7(-Gm^ZNNn%w5lHro%sSr zuo@HkR*cE?UdN366`J%_Mr`+q*zp9rSLOpD3R14p&8&(q{~SY(rZ}$ffNB=2RcJYL zI)c{X^vpbw?*0HmXe|cVz4|P_wxPTUQ?$Vf42yle4UXM0u8?Uasgb4o$Gt&B7hwQLobUQ@=f+=fvkV&i|FB;YPld~2aQfO={* zic@?1x5f$f9KdX}s{;%@Z6*J0pLAXo1kHzA_c7%mcW0y$dHsuaj<2F&^84(}lp73C ze9g)Z_>GxpHou0^*}4*7h}EaySMD*~>O0@CR;72KVb|uCgSzM6Z(%cVPp7j10xq-4 zE+plW6QXzRCyDdY&lH88o4&$Wt7(nSpw;kicelS^{XTaB%dZYEZe0E3QKaCctYr=E zDeX0K1N=UZ)Nux*(fkA;>Xo-R#tXgiEJT$A)yQ6B0gpEHs*^76Z_Y|3q=)N8~Y-D>9hLGPz9hC8UZTY;R?&$c96!qtJg7bOeTfiq5}Y zItsZTG&4dc!$vz&++9l<3C<$$RPItf^CtA1ez+Y{dE(Ik z2CN&6ct+L#z>UpdzX2tGhnsGlzDkz$l@%<3%JnwE33=qcp5KdVth^B87^9{J9=$>b zFqmD;2HSmV&Jb<#0jMTQ4%jf+t>&PQzXge-`#HS9Xe}S$z!X2h4^Hm3-*9~K@`r@H zs(D2SEo+7%5L12sUUK&TN%T<1W(*Lc#u}Jm2iQ(xMaG13cM0Duq>0ssI2 zLsT#`000g}!Be805f@E>p<5=rgyu$a#nh7CR@$TpUm%n^ZD3(?5d(*=(NX;2dJLa=hYtX#A& zUs;4`fM1n)2XMasOFB<6Lori_0khLZ57)Q!KLb$}ZaUe5k|CZNEHxTLkbQbou0ca) z&=xX;BijG6M$IdS-SOrpx_!>~y?(9BCd~_q8KYvQ&YIk{Xh9+m?=7XDCUtu&S_tw>~uMOV`)Mb;-387s0h1eQq7 zMzVN8M;}5ZatE~;aRIp*iEdcC>N$^U&y|w#O&x>F75tiGr2sEgWFH&ndlq8}cH19` zx(K&m{YKcS$Q_u}jSFz8iBZJV=ya&bs`D9yg0LRYTLhWk#gK*lylHsW2i$~4n!GLd z(g5vwk!XmTg%YaN(a2g^1a_%>fC9cxD3tvOiAnl1!JYJ-2N;B2&jh02Hl@&64`Jl% z>dgSmBg{#Mol~YxtA8p`a+=~)45~%a2e1}ttKeE6fr@HyA>eyZO9GM;HRYOt;D(1e zG$EH>Vm?o3A#2oa;VO=VM8Rh`I(Iri%uEye`q^AATix?^%g?-J`m^`kD~^qpNSIcG z0ggwyJVBJc`Ci%wkx>F{K3WQWH`m^AQZW~9REw0mOmP!6hp?L)I;;>>7GjdP2-$)U z4)pUA+C1b(29O|l2P6T3MPYaeTA{Wv&!jy)cW|sCFECVv9k8w=(iJM+b(g>UZd0_^ zBXVo%@2u+uK?X5?NSOYm&|VF&6QM&s`wBBJ1FrSgjlds#{1^|d{*nh*V*&HXvG=&c zh>9`z$|w0NaWj{@5=hGtwgl1RBMQLZP&Bo|04;Jcu0! zf!WWY`yG7Tav=JwXa|s~mCR0m)h9CT$pI|%qa8v+a9V5}9HfQB<(6^)gyIqp@M}=! zhn4$%xhCN%)+vTnql;T1NJApTQuvDccjNs9Q}B3Mozbpp-J-|#Y1nNBY% ze}aCQX-swj4q}-;NG|=Pph5pu09+RuhpT~=bS58+*Rypp%C00tXzZ0seQRA!B>`av z9SRJTC@UK541VamZpe2@p(%3*(;rK7M5+mKnY zI6Lb&8hyhox`T+3bY2o0BmC5QmGG*YRV+VRU7P^bjMsIlQEjOXxyrg{8@0^X9yJ^n2UA1fEcVO`RV_C5K zYdK)`%N(!!WBFVETJ}5to9oVhmif9rmiJY^%;~bfmh-khmhnx$%-y;_mhJUF<+|6e zb9A^1eE51m7tdDjv^&og6jPz`M)E?dh#hI&$wN6DSB@QGjk-f>YW%GgdJXu0&g&+U zh|)}}2;Q|ybWH6UmrXN=M%w%bo1A5&Fuz+eop=G_Tuey@WxxR52UE#*wma@!tJ%PT z0q^SAJxEG5bPlZdy_el&H0yTSr)^rLd`zS>IZdkf*cod1+S#rDS987Z&SJ~Q&S>k` zYPa|GnXdWRS#SK>1NfhjW=$ifGPSXVLcK2NN9bewc4A5R2gZnN`V%~?sMJNdCc_Fb zjk^;FD$m`}b4NS%++cN7oz>=4T+DEx6tvzDn?X6ePkh;#+b_u46(YS!YvMxGHCsmA zHE8m}G}?Y=Hu;}&Zh4g+b8yZ%=P6HBA~XbwD4R8%pzb@29#;g`&e%o8%*$f`jiE`( z5b?&JB{b&B^bK1~G@4GWT6@eP9Qk(5+Yv%(#@5 zm>PN#50KSLO>U8YRg*w;=Wt;#Hh&K{F=6-7oU!%>hI{iDCFE0s>)!A%=Yy3G^xc5V%RE)i@EB3t|hK`$IG{{=t7_F|J^ z(?SZ}Eug_06;wW|#~tTrf#S}2f6(u2GYSdl!oxb3|4j^nG-MPELycU6;uD+j6MkUq zVFrPH`=c81zqE0j2L6d0yS9-S>6S~nXm4iinM*K-I4=t_4D2HRAfNkZlf*lPnZXz! zXjm`|hc)4UuFUTdZ;S*{)ja(aQ%S~RfqlrZmOH;0X~Yian@A#sUvOqrEDR1b@C!Pm z-@}0~bA#SJ^DQ#CUobXc4={s?_!s?zAq1k+afcA&3}FfK{t?$B-tS|M#Md_97NP*r zo_1Dw*)?3(At5st2w(;-DEbOPiBBtw>FiJ|DE;mdB2aFD1N%bQZ%>eq6pcb0JT#Dk zXp%p)*PNv$WPwqL4IIy&fl_HZ?fG+IClQA?+9X$pwP~)DO!EzE&1A{|8J?;>J`kxC zktY=!CvYJTjD$6ncIMBV zbNrk!bIz!lbLP&RnUizoM?SDKf946>DY7hr7{lEa`9EyEZG&Nu*R_qo~*B6_a z3OvFCzIBGmJsqiJ7Z zNHOka{`UDLWSu8+`=j1@tMV5FEkuTf&p)a>^1c*N_tY7&BxN(Akg6BaoG8p_5EPTV zwPE~}s1UhKBA5zH6vXVKtMmeHu-fBo>n_|12d1}PJ}bnZcaIlX6MByhUPVNY`)!4b zo)z(+c8@RW<<_)`C?RbgG)KLo&^xTG%(Pw2!5+|i zJTZ)g&lnQLKaW|+Izh@JobL{kzLdJ9R$_azG|-ZshUd+Ss#-sMfFX{hrH1&jW(0N3o2OAZcf_sL80Yq<5htPF_?PpZ*M$%ab;q;g^XDk zN6#=^5Vwr0uN=u{TSQBz+EO*e4s=C!9W;N`ce>4ubw$ThVMoJ21Bve7!*zjrECl@x z^TYvmX5@8%3Jz2~RD zQ2jfgiN%3XdXiP7Qsk+>yB-0cHmCryw?|zZK^WX}xK%nfi(bnW1AL_l#N&0B9;?#<1_tQDHO{`_KGglNG zVU&Y#!J3>5J2rgN{+W!ux#_|*S}YM`Q|TsVD8wM!bE$;_i?CxW9ThMVwAb;*GmuA1 zq6gSxGwxjwx_@jyC`1^7*=JRfc!xptGWxSv{^z8~mvo3jCYlLwm~4j5LN6jO%eV$1 zB1c`4e7IM98%z=*hKad|>q0WKcy7q|u}~C6>y+e_Tvr#*<|>FWD3naz?4J*+BdHOZ z+%}D}J!Gu9=-AQnz>I-0glT^YAS%{NO0WFWL{C^%LBK5SgnV zP}Z;iw#_J06`;(w#Jc6%lp@2a_MO6P+S2$12(U`L4dXBG`I9}cez?M>tt?)QaIQ8{ zMj-{+=j@F|6t9FWxm9JMVr<#W_C>;Tu!Sp&7h{~OMiwZ*5SzKVW3k0+VGC{*QD{N7 zY-jtz@wsbb3&j;-Xl^!9Mj-{+bL_i~YKiOA*0@lWrCsZ1wu`>` z-hKZP0skc{*hNV}#ppC(5cMv$L~T6J^R^y!RoN0g8oxReHbxmz^mdf>0J1rLjbu5L zaaIqrAt=ubJFn@oO0l(>tQBj+q9?TNBTL|$rJ&ISS-vatK>2W@+Cf%x!Pcg5uikj52}A}{Dc`9nu_OPLi~fNDsAO? zS6?Z)(X+@7HbB0$X+V^``}liuJ9EC@G1-{Sn&zO*cAY`ovYEdm<;_V-9(EBcH$s|> zkx=IS1RRlhw}30lU1J(>RqT0KoAp85Z}coe0RhG67RvX%Ul>Ut8~?8|wEhw@WKHT2 zsPxEbfKnt!rb^fh=j=q%f)hS)Jb%{SOxHsAVXCG<)Qz6+j!FgQu51M8?ra9sI&)_Z z%u)FBf!{E9WHq2WvL>jVo--GF4zMwb>kdJN9=)mKbo1_{J`wm$5D)_Z001)tHY5N5 zZbgYzYG?C_(kh93OXCyxBwLycoJ^`p{BFVp?v`|0esI74BIN)8GXh3L0ALAFGT|Y` z3c?xRM0^tQCIAo!REoqict)}fdNc3#e{W^GZkAhSNt%69nOXQRO^Oo`K!&h5;s-hi zQDn;a;=os1F^G~l#3>w%Rwf%xU}z>*fdBwZ007L)0FaphxO*@-YirxFvRxEaTavpZ zz4YXeo_^_QwCO9(F+Xlb0rwir^|86@OYywfxowJ z`nIZyFWHtKA|9$(T@VchUmy(>Ybd@WIwn$V-&H|~KI2z`{*bG|!x%8s z3+%`=&4`Z8Z*GZZtqZW;??nRqC=ba-fZF_9wLH*qmOp)*n0SHo7e)S{+pv|yMVyv5 zv@GfT2SwwE=5MB;HTdBCo&2&C#UV9?+-8HZGW-bhFjOX}l~%xu;* zPRkd05gxs*fO_Ct)xza};KSdi2@|(jFOy+&8$gtJC>n8tuztm>pvjvCVLK++_6MC;Vf`xjBXX(uV{%5VRsEsh#f3}3jT^y( z$d)=#JTAcp5Bi82hCd~{;K1UVbV>w6Vz>MVk2Xe31kYCq)9lX-QdVG9}F_&VIe3e=miLC%40! z^m~r}s8xV;1kZ(}h6ig{#@1r-hERU`d=<6JR}#G@Pl{uKKnci#!Wx--Qc%JPfDADl zeRW!*#@Vq_Jmge9;l}dcJ*syn$z$u}@1qHp1yEAXt!Edkx=mR3&fH!y%A{aI6t4|V zjpKP>Y20}lxX*;p0DvhZ0DtNj^e@6o%--MLHQ}b{^hHeB*2~JGNvbE^hE-~^i<{ei z&9%Rg%f6RY@>5{bB!xN%!xAVu8`ZGtXz4+#f+gs~p)g=DBnun4Xn&Q*ipgE<$@qLu zA)*(#A>wlk#)d$1Lrd^uQWop*jV3?}8g>F#hS*ofo_~T&gR^Bc3Wtkp1zPz(zZJzO zA7UFuv+FQzp($Fjzz+=Glv@`88$^}Szksp#`Lv;i`U*XlI3#e1m^G7c<5l`-Qxf_j zrhm?7e!l;wwI@3K7Yx$e$N`vu#gvH#eYNyo@*toD65LjIB)> z^tx9}QsQ9F@FHAr0E1jWSi_$leN;U?zE6Mr;9Sb!u|`K)%uub}CaitvsX=|A(|OcV zBG(aLVi7x~hbI7$C0KuQS#>+SDSI<;IC{Am88~LOfuEk5ZwC6)y!{PFAs=m}=E>jg zi;_20=Tp(&cUDQif@J_SDMi*VSkqhbc3ST!x?Bn!Y|%UuGwGpnC?-%mVy;# zL>8TclmJl$rbMw}-F%)XxjIt$z{AA|z&Aw{GGwcx z5&2x`n80FSoNzIqED27vPhdsPPf<h1?Z4|eH(wjg^!|s=2&WqC<~a#%!0Bt;@t++?jWcHdHaHEOow*WFPA(8a8Vj3?+R%g z$u5GsKfhRT?kH6Y$T742mKT%)m!(vSuEK5q4c`1^R@wiDm1vSV5@`?66Wr1-; zxfr__2GAKPL#5%h9}JJiMNLgm=y=rl64mS1<;ZIK@DThOZ}H?LH8%i8eU=VK=nN4K z3&-P0tBrcBJra+;B|a|<UTSqm4~}x(|3{PG{Lua% z&wcDW@qaq?Ltn4|=$VgveD;}7Kk)C>UOM>Wr@ic%i$8SMN4?(u%99`T&udkp>=mz= zqEx~Iz5(=hZ*$9e3|zJ{=~Xd2dNonEZ|CP?ND~eUfo>hf^qh5dxn&bd{(Clq=w%b78Ob^dyS+aThM*tR6T2QlZ4oc? zyQ7SI^L+2+ZTnn#4_!(x|LgXz+*^B3&%Z52p2n&dfV03;^||?BWcn=DJmZQ)PV698Opkc%;!RUfTOz>2%sm(xRNR&Oz$1_LPK4JL5R#zwPZptR${bFtbY zV}O&XMTgxGdc3DxlqaECiNt_VF^&KeTP8CFuYdRMn{)w4U?>Awa1f*tJ5r`!Jh|h` zdy%s2`6@w#zLs!tOX@|BXkCnAoC$6SCbob^m~R-Q=VJyV`W$zMD``SKa(-(VXeOYF88$!#r4xp`pM0oq z!q@+O8fBY<49q!Bp!^$NB$v~L&kt3vk1_b!HG($)%!khF1mL#gUXH6gAig-dFs z0R-VPI;nu7xK2l^0$Dgd6UEeu>KZ#@)rRU6(&E10gE^n0hE@Mkh){3_Sj?O1)&Q9w zYe%kmEuF5207Q&fK;zs7z0P{2Pu=RD9M`?7Y@vYwrp#ghAc`Fc4N4w-C}B`Qit`de zyhpEElWW9SE(B{&H)y#py72OVc@MLz;)CsQxM0)nLT%2L*%(BZ0X5C(jF~`3=F?hv z=FzSj6p3PM!9JwVT@=7NTUJ&V6{$tnsNa;mjJ#b=5;|lYHT@U>fk@|$0HI6DCPpU5 zm9pw4x{-uJgg^$+7!p1t(&JH=B11)Gw6ZZ2O@^tDHGnVJ(`)mJr`XC%mQ}Idt!Udk z7PAoeg@t!40wBn66a`Q~S(oFKesY2W6~O@Udt z;eex$;Pt>7Ne4dCmL`1)1`sGi0XR zpPXEetQs-4Zc;Gd_7+`t272QY2B^X)!Hh!`nyPYL|AC&4$%7T0ic_Z<}RSY&^owCn1oD>VlUOG64cx zgws*4MN&^gi}XmnG_yplS}*1sz3c*$ZNT!IOlOq6_8Cmd;H_Wo%x4dXJZ+ey-aVgee8{{U%~|5T`blme zKLOKm8w+O*ngEo_Ai2g2F-I1lD3UXS+>(50Coy@Fki;}-XL)*ls7I51fUYTcN2)^U z=cteRLF&W)R?dcO&vU2RXaN(Qsoq}j)n{5fFI=R|5AZVrob?cLGeSU*BkF!EeQKoe zgnI%R+|88JdIe3~&%fmEe|HtJqN_62sO|;X!D9eGas)t7p8*LyRx!H>0O@DuuT>Jp zk?X5QxZnIs49Z31JfU!H&YM4`_m%R+&Q+eJo0R=xN)_QTF`^sB8i3c$3wjO z$)mjfRJg|i?I+i?&5^k&o|0Cx1kx7JsIWY234V(7sqqJxt zN<@+AbqB9J02z;Wc}qTzc2xe#1fuIiSSk)R5i7~8dVXbw7$e|*I~r<&P0O?oyLgko zLgddtVF>ULpvLBvfBb=Va-N_3JI`C9fWf8>jg*M#3<1k;2tcrBRp8xHxdPfv?d~5W|Nlhl003qLj)(xx5uh6Ih5|vs zvYw0hCOnIHAs`7~h+xfZ-pt+2@7^S{o5i`A`MGIX$@WbDze; z@x?qmAB=G-(iyLq@X}Wq&z8i3Ypx!lfoEg+Wb*UK=wlXfJm&hh>57+fC!6BH$7nm3 zS;<&BYPe43QO+n<>*~#9Mqiawmu4)^Ab&4vUd9_mz%9>2LT32$FJlntf7qZh_)^#0fhCl?epGGDrO(ZduR-eNH-5ld=Vp+~BL{ptuu?Os< zbXMhj`A!(O27GZG74*-`tePfywV`XsTno#|9qL6bW~Hm<;WXG9Ax?xm!2%putxCqcId6Dt58mHWBM=hkLH(vmtd=)S+~ z%DD!$lkeARZ64lzzp_9uyXJ}w7yrGOq~)e-wx-4%J8@HD6f!h>BCSy$}PAJep)_cX(N z-u0mGyn4=E`#Y=mm>*WHpr2Qra-L@@R`n@ykp zK-pH%miVoL!7%xBn`7lVxa!i9<77q zqK)Q-L)H769c)1}4da3OBU~)N0QG0MA(+0|f+c6zekoN_hWmjv2XQ<=HG28fZ2Alc zW))FTbyjT#MENpqzq=kVxb@Hgr zorJ7|KqFI?x`0m7YT=!1ssCoW34;!O?0_IuP0UGd;Ne)aXBWTK+MpJ)?+hz%{w1KHxW@`wU<3DX2cg zPsqK^K7;SnR%AKSI0C$rwH?61>#Q-)klkEg-fq_m%q{)jPs(s+DU!liTJ#38$7t-< zSEmQh0QG0Mh2IN5f@t=2@cQ5VmtU?G{fFMTxJ*ysfr@ww7*wNURw)TP+G^LhwI#0Z zY-^*|X#A5BO8x6keo`j|QsFv(_>-ShQs=RM@<~3alloNo0Dq(gD*We9l~E<;R9;sK zLA@@giCklnZL_~ywFRo{(_2!WD;yuNoEhNzEiDgvulB}YJ_B3O*8B^BduJqaN?>g6 z+@Jn^+ar(oTiY8!YzlPHyD&Ygd971+wB69%Abh)rDChWg9n?11FxJ9gvW@!>^bLcG zh}FEC{vYWn1{q)+pxZJ12)sRq;2;pgbQ^IU>>WrYS~zcev4eZ77V80bR7HflqLNSV zm!ei-buCqPw0-&A)-1cbZGCrbm46-6Wp==3zjPo=DShf{%VsaI>HLvOkN(%oJkbqt z%dS_;6rZ%$#b~?b7|e0mf{uDKLfAA@pZ!bI4cV*L*n1hPxEcQUujEc|3PjIt{nb0T zlKJm_I+8u0@88E#tp8~jMs$MDks*g;>)t}5W?D0ikN`AYkt=2FkkEM$-PqiyY zq@lgg^w&WMe0DbE{WSo#KE_S@{-f-8*neAP-loc^A+Mgs)FAJ{WtoXt$XOhJA~?JEkgXfw>IAJP|A}x3enP4 z-2)5h>ni>et~=`R>cH6z>OtHUf8p51-to&H^Uj~|&0m^-J6OwN&5z5x%}uhY?sw^? zgXB9Im$7@+29gzSG7>pA_=O>|^6(L=?zjhCJ-+KQ7`MB{WTg zs{+)BxdN9Hg>1;S^7_fUND;~ zzk|ZHeDM03cxBRrR3GojD+q>){C89Dl`|spj_1>=0*$N44mGqQ5%Z%871h-R2_^aR zX7&0d7_cM~wkw!6skdC z+EO28vqAujbCuznvWoI=%8vyD0Ekl}_-l#yP3gCaHH~H_LL-Fq6?_Yux$|wlmGPpF zVXBwTMbN%b6VK%D+h{sQZ9TPEZ^0WjB>^=1!_+fGV$lx>Ss5*J?w;GF)_y^z_>(9F zYj;x%FxOT8y}PW1nCq8(y*t+k%JnQh-CayX;kqpyI~K1Aq3Q*n;6Sidqs4=#05Nr+77=30@Txql5=XGF@;p|W@*`egpDlL z{+d)(Vj<|}tXigr5XL<6xy(FxlHVI~W^j&z@euuopRiUYAnpQ5hun!9av7shQxk`V zQn9PVBOYK?W_-wM%=s>Egtf46;xcmazA`SxCO+9g(LUVl(-fK5!mqlPrpjU{3RXN( z)oAlZ9|Y**jM9Os$0~*&nu3+GT4AaQ#}q-8J;SLqmC465P(@fJ6x5X&k#$+uWMzDJ zQZ|ds=3M=vMeqc;*v;iKtOa@m?F_sc0ttulp@W33z0-n z6widRQH+4GyA~E3MZ(yK3#^V)6}9$I;7+5o_Gmem+-cGudY1}u!I|X__C5tdfkVn2 z?42rv1gDid*?ScT1dc0pV}9_POeXM`*R**ZZ7|aDH(3|PQPgDb#v<(iuo6?T7HI%G zE8`Uk5j(JBsdrdd{HYy_gMfvVbPt6?|F@w5*n~m=pb6T+P|YA)n|)6arUrs;0q?=t z&=hBCE+{_mh|YtjJ5zT-?0|~!G-%tiMJCMU|C`ZfbqGcicnL=no*HY&c_B^scr=he zqSrxK!88uxUPIA~X+pxIhBOkr3CItoP2#BkzwddvKyt@7=$1EA2*L-VieN(=&p7!A ztBkOm954aMfV3L|>VW?)y)JxSff)4kVj!Lw0PlMszlbwL|BeTuhqy!B>@aZjMuiKF zPxuj02s#r!0<{FLg3h23IM*%EM4%zw4Hji{+5*i45kl9X&@-Sd%0w0+GYzd5OQoOZ zL->YvIJnPtYR}&u)d=CApY{B|$qC?8q#BA+h+3d7GR*}kBrQ-E5)DNu1T9b(d1iwY zJ3}KAk1N#NyqvNls|l8{Y4=R&3)94_Kni9H;)Q~hcm=64aG^-0UV%ITywI3ZuRuu# zE;JDuUYyHEhiuK%(>p}dxXgXJeB9#!g;G5yfy&yADU$9q092{Tl0xPF#Xw1|3K|`| zl*YToX_9TKP0i!4FpXQfgxz-m1y}tg0oyu^DYou00NAU`lY;F&#(-O$4H|WPmDb~a z8Z47>)%EX9+4?S2t(yQut>2TPtA&n1*g82Wv|7&rMO#ZJgI0ANXs~=c&kluRZOYw3 zhc}M3#cb>gOHNztn9u^@XMB>ad$#!ZyiukfmGcs+_$py&Du*q{T`x zOmA*k_nyc1cZks|L2}zV{N0DBy?rnbtP|h8h|Sw~bJ04%-P;KLeTNUd6G*+R)7kQf z|0Qb45*+NxW*FL4$v^MLiUVGK#$(ZmVhmTM@sM<=97AeV9`nvMV~C0shrDR#<70SG z>igi7!uOcdX?xTnzmPge4&OSee6^z|Zar0pS{4_+m+0YJL)EX=^n|T1>CgqC)iW=b z%ol0V(HbqK)8;+Y^yp9ufph{0ill%AlLYZXO;W%DC>;PoDyd+BECIaGOKITc# zsbnt~;!V${L9K_rT8+)*GN=TN9i&7~sUU(@0cb>CsThK04rn5`R1iVC05l@Mehe|J z01LfDt`v)ev2hk?8?nL_SVgGVQVVjA0*D=WJ~Utnkd%(rMF?mOlwj5n2!0Mdx3j;` zBXp`wQ*M(@pffwigD|O_s9 zg)2`nH5$BOHo|h(?$=_M@M1}vA*5jupP0|j!*ck}$;!c@%)=hntQz7o9O+v@QxbCZ z|9mZo022@p0ssI2G-NO{003@9;8V2wbI}uD9|M2b| z=)2$j_;mrN$y{xW{8M`s5S6*&CNeQs>cznsZPe-9D!%YaKagfEl7YapTFVLCpo&VG z1QaP$5>U#a5x}6*W@vq=_=5qBXO+%?n6&{^qdX$xw}=t&{{@TydN!kOa&Kv74v)Tv zSm^H%62eOa2jQ!$(d1Z_A72DjzNH}GV`2sHCx!t&Un7X?lEB3CWF7`kzhU7F7o zzYNBzFT0&mY?5y5;7wuB;O0~YH3#$Y+@r`0ZbFahOHGm{^BQ@1NRz7s=715>l@I~2 zua1$gV39ZMQ$Vmo^o0q8*rMr*(N^>1jJjkwM?;Vd+-+plbwbUvq2YzXMQBCKDu!D{ z&|yYYnSRt7RkBU5bu=(F@n?;qG(WI%bOe*KxZ%|9rfViXe0vATID=!Sl2SSVfZ_u3lH4yq;9L>vIA5ah@R6|NUCt7PMSy zc4JAJEo~sw{`FoL#`DK7Uc;ra9!gA`V_~zi0*)9qxSpa%g?ud!>V&#H)XRN|^Nr6I zFexznOsc;;chbSTG`TVq;b$;~YxEBOdd#jLY$mESDh_~gI8)!d(8C?tH2z7k@c}$V zjbgfST>WQP#n%3J#n-2I6=Uz;gl0XZZ8rA1X(SPo|IAuq>VcPFGqOW;C?up?fuCOwD>Mp zt>+7DVQ4{HZd2uF2dXAZMq<=pAJw^Q#Dp$p43)F?~n9 zGL3(|BcD$XOzTsROz&aOx%2$#_tA(86qqP6ESzN|&8t__Y54 z{EPtO9};E(aV7?{7LyTziUPSW#|Iv~{7fIM{&Nji^J3(kQ%H&<#0*IpGKUpDawvMl znvcnR&7+eBpDh+jMY-Tdg8tr#gDQr#)?LFRt<=!g&8X9{ATFjW&iwq>Yp{a9 z=Q@HjXEl)ik@si0PA+A7DPFZKX$Pz&3rpOJuC6ddJ#`|T#{6{sJm3EsBKz5hnT|dB ztcGv@BTvq9l}1fLu%G|g?_D^tXU>woL92kEej#!$*K8ogmwL==YkL z9}R*w2GXpe$AUe=*-1zxW-34}MH!{I-*amRe!41H4BcoQIh!0xhn0RDt!Kj?ug?3^ zut|;wVjWO&s?JZlY0Fo4OXKCUIj|e3dsu=F{b<35fDG?z`3N(e=S7S=o`C@48fx@8 zjbGcb^#K2|C>J{tvStt5yGYd3$QDr3XIiQJex|O(GwMevWFm~6|-U*O{-6Pnj z7YWZm^w8nR_c5@P65c_nb5jgLM2&&xDt;-yVr z+T~4Nc@mqk!z6n)lawEX5SX@WfkL^~y@KvaSkP|<5`}FADE1(8-`R3>KPjX-oqz;| zifL0HW9J@UV*t3xpKkppm{h+MG^yO>qUpA@)StevV)PH&2=!wd3ixwz3z`xVUu>UC zy8mNndyS&MAsIkTVm6Mx5-1b`e6aUV6W2is}h|T)ru6 zph(+M_cAhkqO3G#Q@)PB8$)T~dlTKq(@nu0TG4KrDTk~+5x9)BslaX5m)B5ApBqzHJtH6IwO$IP~i1d27~xhfX31LU5xuZQIsBgGRKQ<50mD}dv<%N>8jyALapo-=Zh3MJs87A64X6)135Vk@aI zHzbxK1R7|ygiaPF*=NqYxH+n{utgA*yoZlUgWL%uFrpBSlac{Q)U=yJJ*BJJchzc(-T#c@WF*xWaTjG@k0czZ7+V$!ddx!B)oe+qxPNBYDE)8mTlIDeXGsZ|XYim%{ zU-b&+V%ur1F&!>5hu%h` zW4y;(amGNKaYVv^Lkj&pr{SONe2`El{`H%hB^$4{AC`9pL^j&;&_Rl;4SR3g$r*Y; z#bv4?Eu85Iu&G(&X^P|0d|uIBnprkN>S5iRP$jNu(#7zEIu)h{{IEsV{jJ*1UTm8+ zwYLLl;cxX!{40+LkeN3G#K9};!C0Xp=%;yB$=4MGCWWbCmITM&i(tXe{{BQ>N}#-u zFffk>9F}Vfo;VZh!sebhjSIHEpZ1&d24m~=HfEHQw(eRljOtsE!JndulrY{w45vi} z9I!QqHlMmA9lF03aRJQ4g*fLB;705pr<3!LzTelS&uE9y8^A{rV$^{CHjvO<_z6{q zRY2`Xwgmzx8A1i`?|*}X_+TPS7Dt?>Pr+?9p~%L$FS*@LuB);ZSMc2-Nv(b_w< zr{30^t0qFk@B#QKh6>;TTlOk-4W5LbSU#R|3hmL6_Sr=l#c;789Z~8{AOO-cq9@zVV0|>Jf^@N(xm*d6i>uF)QegC21 zdZ-Z4jhV&Ep~+ibujV`8r?HDeXxa_OAYawWcE68<4SxZ+Zr$7qTg<=f(83HkPHm7S z-={3{RI=z#z1E|(d|52U)ygbL!T$GkwAA`#RO?k}?O5l_#h&AiGll_GLI4F2?F^`k(OYok^p7E2nJ7WwTo41` z$Wp=@z-te@YTdti4SK)!9x)%T5ueA&6@0=#fZFYJWo+yVn)CuR<{1b$wT0&07T6Fp z9pR8Q#nOuRAxP2p?N5U*epTn2B&*9{tK3gE~j}7}Ca5Q^Q92qSHxazt08!3nxF$W)qNB}*$P=Ji>5Y^xE zUXDV-=2u%q zT?6mI{O3W%T;s_zq5+P`hCeLxa`=Q(Xqkt8YeXQD&)V7iCqjMxMQ8lWGo?*~_W5h$ zrJm$hhCjhqAt8Z)2{jtDz2$h&7vQ8~EKy-uyh8_W;@W#zzQn_to%G`yUTZJ&K{E4` zw9@8Y+sj9t<>D)hRMI|mUCZe5(l+#e6_pDrqogkpz!}C){JG+3YBxFi+^F&@GlDJL zVmu0Xv`Jncb_51`i*9h{c)#0<7A}qEvFy)(Hp-6YM$xvcSf6LpJ8whi`dt*yzZ@Fh zV4&|bavRFmx~j?CGYw!zLmVe#0v+HAtk5VA6^o2_lm;+qw>Sfh>fP;?sY>dbP6zb# zd!9Vyi7-Kl;4*2P2IDq{URTF+msOOVJS5goDg*~oi!BhpB6i6BK>Nj%^lQLTf1^@& zd(CE-tx0?N-MbKPxS_v~Ts3jEHnO$*-TsJe_dY#TMh++dL=X@H0000pWHvMa01idq zQ?&c$Vh1WL$ge>(b}{!J#Uo2ae48th`(>q;yBpcxi~RS1pa1~T$k-7S0D&H?Ax;Po z2{OKmcqKd~d=>EmBM`8{$7ODRuJ-Pk{aag^{Sj~cR?5~%{WJ*A_!nca`r;I^Y?CL zYg@W$BS0XaFS)V1yDe|GmBc6UC4GqxqF_@0KScV&JAyUsx@b}C*d6!(-}e9P%T#w^ z(|tVLlD-jfmtVIv5siCKmXQYy;#J1?9w^49<**?!n69Txv#KrtNtWCXKSRc>89;UJ zm^N@upMLt`7uLOx-raYzc-CY)RjVH6yOz7KROv+ayY(ZL4PCuXiamiM4NYagi9Dof zr9ASW#DM~0R*K}CXwAs9^z9IAbQB*Km3Q zz@(l4JetRYB^OjQ$yMcS^ZtwnXi*-#>SjA;*`bMLgPI z<0HL3($ot`JD}Q=7TSfjSi+Fs#zU2$EQqqAvQ22`Fv(JqQ81iE0f0yf16bi&e8yQ} zSPpjLu!gvMnmmlKB&%x%19E|_65P@&?{Q*5_`89+?`)nj<}2UHfu&pBzD{hf-c{ge z&Rt?Q4&4bU{^$(r8=TPc^%WMI*(Kvb_RB3cniYp=_ZO9USgbwsd#!oF>3r2x>a4bo zFI4=BP7vqq`6&Q#>8b&p?KO0Y_P$UlE`GuD4ySyB=mVB^A1s2<-pt12{q@VP8q~?7 z1frV?Ltz5n-w1T7?l#_q;jQcNiX8F`xnKki=wJ@v!5+dr%~_`gXh4#kNaV1zOEto% zJ^0i`y3CO=^4YwCDA4Ao>Uq;28Nv0F#lQM4JcK*5;A&KjPUsM&{f_Erzl zxwG@%JvDtZ7Kj1?kW-Yae{iX^@X+V})lU7G{Llh##uTmQUC072Ur3_Dz*+L+U@eT%y!TIJZGfVb0W4xImRD~esd+PP zU|`YftrX@xzFJonmf~HxnASr1J=VV9^uFqS`(Wt66_AB;46*bT*)H2&{frIhuQIe4 z83FfM90l+i1Ua+qJ4vBYix5FSx+T!}sZM8|%J(wujQ9zu~sWUY)e& z);BrzRfPa7Z_qywDDSi!0d83ankbQRu%kE}GAB^l9Lwkok!L}DK*F%Ea02o;wEtYH z`|Y3YMu~i6eF_1P+iW1KwrfhfGfd(YePVpW@~MD9dMaRO-j(-L)!1udQ+;-hO_muc z1%V(r#Vl}aBh@A1R7c_#5(WXGGrmCmD3{=OiXnQhU!O~s`F%zLkf^|t3Q0iIJ_S5z zsIAZSZ1fe%=;4E02r8v z0BW3fe<=>zfpjxNTOxOdZeMW-?(Jj?!v6R3q__%;A@hgnG9RUnnmv~Kz4`aopR!^)b;+1a$dM>YhMUi zBd}-Ht_Lfi?`w)E(NqMS2Soa8K-7^Arn{wwE+kU72kFU2w%wHx3V4q77+9ga6shz&u2M_p88fI{rT;9;Ik_;)eXK< zs&N&WGKe5(wX6r?~wEmG&c@5V;P;B<=`?C3ai)2~1$NvJHNQO%;UCX)&sX-+8su^Bs(>!kr=r$ zJJiUH(vD3$kuy3ZV_>DmY-J=kXlr#p)Lv!tcIs`?v7E;d*Rk#EGX2fbVBg9OYltU6 zFc%nepooS-C6DxTXmeiYZtNL#hd1a6q92FiHW|yy>alAD?c6m2_e5PW-o_J^38Sy8 zH*UX&;bM>aW+qbI*Xr3Pt}>r9gU<3-uo^6wbeF5Wlhl3vJr z*T=}AqfU`-eB~7oWSzDn>LSxVK(>A|1s7!I&L-hsx}E&p)1R);6QoUG$t3^*DNcY5 zPml5gQjl5b&bT51OiU;0@1=Ix6^VDSvCpT$)n-g{5^%X|ll)+y$gfT+Gq!*?!2k+l z=;9B#Yo_Wn%L-@#I8_V?;IO3?1|4#jJ#_%w_1h8c)t|s4wx^?TqhBZBHgC_1CUiKL z@WjvJ2Ylz@2^lznABGX>a+DfVqa%l_Yly^S;-OW*SBwGMf5k39trKkVc;Go#~7+5p&hduf{f*R*B={0Gmjae&WE}U3E44F3+mk)vxZikLwn-| zqk$oaQwUpht^kq-4rrS}vnxhVh?B3J!h@}=VbO&;O?yIYGfq>?W@6i(BFIb3!eJX5Bor7fDqWiY>mjvyxw z6e3bp@Ik-rGJp(43uWAbBx??eydHj6X3RcimLM0NRZ(*E+x%V;(fX-VBhbxC!b)Ox zAoiB6$(%{%4QB8Qof(Nq_lqmDyD6l(RYI0YwL`&9xhjoU-{V+TS0BZ%{Bm_GjgJHW z@egbGRj&zPu%01HPv~6a;{pVo1_i z0DPLS)2CVFx!KkK30D0lo~KriH){UwG_*Rr`Fed}XQ~qlc+EOb!J9dLCxz69a;P?x zWESqy9htUhY-YNkS>A0eMtS;+bK4)Q<%laQp?q=jo;uShmFd)`s(*@!Im{vg5M{I^ z{f~g8nV;0e=|WY#tQNRdgI?ryXQ31JqFP4Rtfs=ukAP6aVxjYpB-CPDj-?$NX`Xnk zLRvirplFW(Snt`-6(yPWPue?rgGp@~zVEA2Cs4;`y^u5fd0Wl}-*k@F9l5A;DvtTk zHV6VrO#n$NiI%$bdbILU$_Y~eyH5bY&Gt&^YewX4PGtzu?q>%Kw5qAdGMk%l?tVAs zvNqkmT8?28CQPMor3_USos zOW@@?nG!>0$eq|zzc*4{E*aA&hK-+^g7zxtyGUcnJCY=c@~jY(I*s4HI#v$+5^j&> za{f#yGyti=zNuFbBwf2q)a31m{z*=_CQ96T8C}U!=c}t0QiV{QqM*!@5z$K4&L*b} zn3`aznm*#Pu3H#7js(EhAu}Oo+|KiLAg=>>9x32|Z_Be@Ix27Ac`qvGeEFt5xsP^_ zmale__Q3PAs7&IX{i2^P4uA?IDR1LFU9I3xj$rz_sSuYCJ$*3leznq~#6ZkT(W{o+B6V z%XQ3Yk<2*C7#9;98_+>oiuU8-Ha}kqp4N|Pk?8NWM*J5wQ6Hu^=Tf?VmV=6Z;ZlXa zK(%5|PkjEDrhFQA#(f@Mh96g=%3tH2%-`di*z0}KV<%fqgDx5X1cs2wn}8&ia%ABD z&`4{PpWUWfMolVRfRGU(;v|ssKgxvf(4u)ot`;@H#r%wjTm)dz_(;n@rr1$=K0)};xwD$|lKClA~2|#$5 zL1J_ULGj@c$0p*^o@TvwFIg?$n`b2hV4iNu?75e#E#eo>sv9<)`EVfvtoHm+;Q)}R zvX;%=>l*Id8f~a`>9UUVwrkl@cll?pR*L4CUmyVVdxRW)5l*IB;i_`aCN0k~xd2Ei zuE=Q*E0DvTmy^~}F^5jp^2w7=mZj#()&8K{k^=$WgAhc*&#}+rC zge3=dHzgK>!S=+3?x_gKQGiW~n_Q*Tir58Nt`yyWU31v8t>|odOD{P>e&ASKrSDFCWVEBIx4vYGRN+Eo>ic-mB&i6qr9o5YF zm(&TNuh1?=EUa$2k(n%dx8m$9&Sr?o+RX+kFwNq?vNxpQt-%g&B+{N`CQkG6Wy#OI zv%Y{mJ{47kK)|47Wn9oWw51x2>GCgW6>3Ud-2kM!iIg4zl4q_149=5(YB`TX4MfPU zKq-;uNIMdlPo@Y&la5X0=IW5OhXRB z*6SfGJsm2Z=i!F(tk|#~bRRa%4|eb#1rtFM$@z<7I_H>iiyF%wEHS3Os=jfhKh$+O z&UGtCp|ifU$fxCuwDwIWMQn<3kyP<7-01+Ifu|txx;cdFwt#9wbw%ACg z4PxIilI874vRx2-8}E|!|NpKf>3))R;nK03T{4pCvVkCH5=F@(Zir(9gSo6@qZV0lb$o&Ei<%aG6&@B9yuGY%AUj8q7(H^Ss+TwWt&rQ2^jL8wI6VwJBFW3eUHT&uCwG$H#mJ3J& z$3v2${>i#U^Gv{;2MwTgVLWxKKyLN6Le=SOqj8kah^q-bh5^qHpG|~7223?ezrS?E z-3qMYWe8H}oxE{eUU3|s74yUA&3kw^P|5+hh2#z@SU;|xG<$eb)Bd1xl*rj)PLxuH zMOP27bR+a@pp56wq1}eTeT9*p!QjU7*>vgHw%sS`nQ%@`h9Ib(;bN;^rAL?hnQzm< zb720c0boUWpU1qb>FLuu<+xnxVJJmC0o{dk?1ki3)%_Lf+U$>{G87Ck1 zU1`l1J~hw#rwsO=39{858ky;{>y|NY^1{-Gn~!s% zj%szLlLF4qLmm_k(K2wFkypZ`ODT@Xq6^?34Irp<0S47C^-}fDmN=3wX%jMH1{gDD z20JQ_=ZBuds;ej~Enk*Y$`^3dqdnBvUvIEecDIa|yQA6+-dRn|?RvdzFW90XTyz@s zQ3Eh~cxasw1k&$C`C?!mdIpnihH$JLZ~|E7umV!8z>+r8*T-25n>}oxWWzcO zBaonY2f!BE*X9sN2eV#=;V06XE~E+09i6N2aGahJ#7^7v7Hz61hH`~0zCFNmPb80ahSRP(vB+=h>7 zmEOR{VduXFEgJXUi1WllidpMUBU6f?->7A?M5@!zvsbSyYwe!~WBzbJR!?V_t=-ic ze{b6&e{qXQeWm=Wrf#oqM!v9H$G{-dvGm&B9ol#u9Y$YuxISjgPtKYo0q@W7(d+6{ z*Dbv)_k586I0)lYSAhbshr#qt6ae*7)Zq2zpG8Sd@L`zR0$U``mO{3$*zG=88AtXy_KRmlHjyCT_l-a(*q;oaUgwbLCL}+HX4x{^_DG_MW-mtVUryPk*?Qb)s3) zZcwT<&Q7JKrPod}dB1r9C?(B<`NDZ!-T!;$qP|?!y+gC(>lAyWka3t`$PGA6($Y)V zQgYp4sNpm*#*_4k9Za?BdZ1-)d^`Y+5D5T7ftVUyycB-lzvRnk`{-qX!@Y;FC^80C zYJ#=>0dc6<`JeVfb`zBwwC@u26Xq^4Byk%d1CRXr7}$W6F**U9%73dzHYLVM5V8mqLHWFa8U?5HI9~(31Q`Nel4{ISY9UL4}M+*etRxq!(fWcH>Kx zCy`lH@ucZego?J-^(c>$-peD&?^kp7pTBT{W>+U1%52o1^goSZSJ`h;g7t}G3rRb` z!5_1azGWa*u^y#h#nyubdO-w=lz>Mam&bD%#HAZo5hoQgkTU`l$sqv;<)z#fZ`n@(1@k>#r zs@QJz*P-oy@y*vr4%63>pK%XN=niO*0b9<)(R%n;_u`Gny}gv-?D(Ao!xy>(0uyKk zh&9yi3_6?lzA3Ryxs_QLQv(K^Xl-z-Q`7NxOO5aQUYqSDF^iBX{{mQq{{*)ffU4ORY(!s^T0XU&)&})_tVaM?^a?YgCi7`413FML8wMMkGh`Yjktk#9k{=HJ^MXX zqDX;H1{0tFj48lG8!X_MvTIp%*l+9uP~<$5fVmmP_^qV+S#B8SZ$fF)}5D3+M1$Xj0JBT zB)}lUA;1pX7ssNLM82g`*u4qw%R5$~vOXp7aPMFgyd?~R^(NiStZeKc6i4|zHUxvn z1`UE@mw({V$Xgk3EimEWpdlGPZ~%f@6Irgg-Qm?oip1U2WB}lCVnH$h08--dUn_$b zu}|IvxIym$_SZ}GfBtG7Mg(vt0tAjF0HLL4Z&~MbWv1|`&wgD4949m&e+_`w5UBv1 z-;QGjG!ymVv)QkgHvlDxaR>?xIMRKxZ(b6x-^$6e2Hbw- zW*2?tyX53Q&#T9YGKF7Z zy8kqB{oROZEI7WP88yzA;jmjOU;CW!Y5An-fwJJpeVV|sklAri+s7b#v9LT|lF|}{ z$FRfIguv0+UHU`bx0j=ExT_>kOj15LrY9;>?I=+xCwA&!<*1;L<;y|1!G5b7ljR|M zFgw=zk#{h)V_T(}ku2k!swoBVk1%;XGC0uRheI1A3FK01h6#W)0I-vmKfsd8I(A8u#k%=#kOK+Ii-{=%;#-YwyM zEq>hAd>|+d=pSB>@jHW|n>I3WY>%$Yw{`g2Zn{zDY3I(Zzkh=d85S)mIjj;~k!JzU2T@rvKM zBx12Ja1$dCbP@sY%H0jhvJ@-)<~2!9oLTkPX=5xw+If;6SSK`FDaX|)v!te}{9Gxou^&8gEN zZT}35KRq-semiR-lhxf$D#PWnPV0YFmnRuCT_)Gt^=Me6-_ydES7!lz9MXV4?$cXu z)y zCj3SQ98>^dwuin5k=6nR{ZIIU$ZG0n@kjTN&wpQNtq?$9hamB}4 zpo3Y6Y-sHzQ@;P9FT`So0yz;YqLE_0w1f@p;6l`Z090FeS0jTEf`WbjC*D_!uB zVS?=;XuW~QFwJS~eQ&GOJ*U`xKe*pro0X9l(*@r^8UYtegHEmxz6K0#n@_ zs$sPve2@gA^^kHM+;{j454JK4i8gW$jo+weS7T5}11O_MDnK2C`Yx3C#tNBJBGUR5 zz$2f6)iXeTY1VK4)kL4<^H3#>uNf!Ta&755LKjS9tJ96FmAisg&emlAcw*#GjISdzgduqI@>)RSw zxeU|X_aFk8Gdv|E}bxc;vQ79GG0!yH2FKy4E_k%7dKfq{ty zgIs+&do?}Mb!`6$4FCXSN57eX^0OssW(|I_BpFuzYOLUcncv(coS2*P6|`O7#DRU342i!5Zf85#o0MfDjM@0000p1U54O01sv0)b#KCVqA{gWPoXMAuS6{(%H&i zXKb|rd@YU1`q{ZQtVg!L7y0i1K>+|78ZaX$0006(pK?|k!64%oAXvl<_ySa+fWQX; zTknRwT-){EcC4+ojb+KC!Qh`KVG7n@9HJv}prn{U;v@~@0fi!fF*0eU0Y_v6M`m=P z3n&z=NC@x%m;nG8nE;?G1MO~rix6RON3ac7yKceV|F*kpyD>Z)j~2H!Mxdrm4u3+l%7f=w#T!0-5(!urhvmW+($(eHxf4h7EO;=!4`yjPTk zp=IWWkhh{v;1CR1)-=XJ?3($Ed;~+84`7z|iK8^d(TU&Rpr$^6cGw@*%;?KEWu>p* zkgdNUje&m?KcE&Qvv8g%?%I(2`P7bC^C4E45KNo-2eUR4wOmwpY0S1w~v0JvYFqTyj% z%}HP~{jM#wLk(mg#Ha4@c}TeB>VfQD8H#MC3lp$3*TW4Lo_*(zz&_ip+UP%T>)3!(H(QgE!#Qrt(UT8F(UB5EKlW5=NXR;u3EuCL zFg)wzYIQT(<1h5=Z)h+h^{M}G41uOF@)1U0a2J%>_LV|8f+lo>jRfJ5T<+*;UM31; z^>+Z%kRk}{eRkIW_e)az>!s2c0Rbjn0izjOS#@4cW{aone)N0m0`@lHW3$-TQhrss zmma%-*#l$uB%U`39mMZIt`yi<`VbxAhU{UJBIYrkC$Sp+bgD|y>s1}z_7#tt`N$M{ z)@x>-Xaey*5ho&T*Vq&TTjBuY9B&6aPKz3$ZX1CBdGnLI5Z@iMxr6XkD(K z35>&?1%F~VuDlS7VRAU;`qUeNGpDJu<+d3; zKh1phxja^RzIN-OU~Bo|X7h`T*X!)i+5-1($JWz{%X;=qV|TGH(uGHU9AQuhC6#D? z(oHb`z3xPpuj2G;&py@$U{3-{Ft3YdaO9J^8Yuyh#Q;fc1sF zPmt*hH@RPm(s})LUu-&%ycO|EFbj1@Gs3Rd*RfkM2NPQUXPwJRlK8Qi2ie)PECHW8 z(>q(@rPU}M#7bF8wEEO*CtqBPV?lm^&Xk`_Sud7fEvncaQ1l9>I1woQ0c48zg5UEn zBgRRZfIydBjdCERv3E@xH+F@UZtV`_{R&ZcvnA91T+K9RS8$(U%-J{AlFNMmYJPib zzjy+ffY-AKBf|747{a!1lJ2Iw^N!!B>Hj^FOFNj*9_=6u!#H+Afh+ecFF_&T2CfF0 z^KDhjV3yVZ&^~z)=4Mgi;|<&9C2CF#2h1@A;@u03_IZi)>Ue1l%tdefT7e;c0|5xV z>)d3rYFWOW_K2-}C>HC^{miM(Fz66q5ZxLvp!L-S)pg~Wt#3f^+*(HqVM=voC%+6V z8@GW1Fy{z%NNnx4MzHYh=Gz&dXU0bk2|AFqMu2RKcp&Xu*VQfg&Yy){M~w4KzYD?g zR>pF9vbr>Uv|x&Ntz;hySU_N@Dhk7c6dg58vr!YtwB85VjH(*~EuHy&pn1Ic|FcW# zYf@7F_c*FZ3>kWIz{E4igYk$vIxnasJVfI!Vav3fZP&e{54+5?pvbeK4k!;3Ofa6eiy1-mYcpKFX{l;sKOWatfJ z^Z+6w(QV(comZZa4v*eQr+Sa=`0|K!zWjzAU_T-W>Tul3M>7t5gEPTLID`Fi9LG<7 zChIwO4&bQ;DI%X3Kwb5>t8}6(IT*a}w zc_CVFX1vy`TZ({8uw21nJy+a6ZK0Xj0vepXg*8PmIrXBHmr~J`6cO)Dy?iJr?Y;Mp zb(DR)@_K-LbJAaI5!;&6#)BnWXbtHPSkc54bt}I3z zK~3rBfWtu|a7DdjKM09DiV&H=>q^On+T1(!YTGf_*d&n)1U~tQ9Rav;QA*R6>o}CX z_vkW(L5@OQH#9G)hQ*^YMzS~2eac-TN{@FSJ?2xz?RET~>hhzJQ56>Q^#L)8>Hs8H z#5Pp$HDi!MbIW8AeJp((Tsij|{N0cKsRpM=>Ev;z-l>xt5wE27Qt&|8!w#dy?}YpS zdK|<)rb#4hf-_JFOHumVf5M%S(omE1G(*O7MmRr>5}f3)N5%J z!)+z^LEFlX1snD9$rSu;d9Hp!E1Gd8UxXArp+N&&TW);XGa;R--~hg+(<3k#NCE(& z$_16+ZuiGe69CR<+9PlvE${+&PO17uLz;7VJ~cRt)>&Z46x|Q-*IsH*9-MqHdzk~fQJ1<|4p3dxv?J(5x&!cJlgXr4bYBky7+&&`XD*s^GCTloP=L}p%p&&ogo+36P zf2k!zFXz_GKMx>7A_oDkl&z8>S~AJaAtRZrAhGo*4>qID!@)SFby7R>OhA3l(!D62 z5|nUl&$XKc6i+Xb`Lr>#euLsg{7pn1CZ^8!*klM|(&}K3Yle6&P3jPjZHaipq|~_{ z)2Horq!MOUqJ2jhnp5wR;djYDt|-0BuX zWcN)!q(pk8cjNQ?kRozT-Dy!nzM-cg$OJj$^864Zf<=&4^TB2Vv|xAn`LVn{zd~M& zkOCRDBH6)@E5HU^gW?$?fso=>uQ6f#_vWORo#Yv(Wqg_jEe{NI-?(60LSCTLgh?h%^p{-P+QwNsz%&;9t zUMxoOdZjfirO#_(T4KWu75`4N%~^osned(CW(`k|`w#8>LKEpiN9aF)`2TvHntcR_ zXn!+(!7OhI5_9a(V2l>@*tUMT1Y>tl&K4BbJjg2%wh<&YJ+?$1o!Sa^w0?M8GqBy z*|vbdIh<_s@HOEra6JjYiv{6DPE)H}C@)Hwz7B{ z5A7im&|)VHgm7j+LkHnIbQfKh;FOYb?`y%i1s(A8V^(mPf@XfK}LXc87@@M~P z&QFzApFEp1KT}y^tGE!KH8>5aRsRVY39WX;7PwYUs3_o~Gqen$s7iq7`nOJ6xCjOW z>4;{+c%vEc9+TR4|NQH3w%#Eb_rIk$&EWW5)L_%g>J`EuPuKt~|rE zMs>uf4Hiye2=A`uk#L^mS%5y~nFBjnL~oUj=29LHn=EMJmkdoB<8p6O&fmw(qMI%>(gxaG8Lep^QLJ(HyKC4aI#;@~j%||4zyVVhPuN@(TL!lOng9Pp>Hq*{W{ijczz(28G=Qf(UA_c(GUAKBF<$|!gbW)Q@f0Y_ z-Mh1MGk-I)+{`RTwrX^L3Su23UmApjM$%})5e|X?A}G_*(hjhV8!W!fZ5Smh_@QAQ zB*%^m4SHl43;-B10GS~G8>#}7mSZgbn2FcA#d)>cBLz0w{sHK{CT~q=1*AllksyRk z4jymeEa5D>umAp-h_Z+itjCt~fu}z(`mell8q;&a(3)5ECmHxme=zVe#fR z&z4fd&^e=G1aCeh&-$P;61LJE07-@HAXG9~OY<<$*aVt`hZ`T8<{uG!vBzl7eCrz~ z%;z-QYK%3VRN!{zis**>GV!Zt(@w%qc{!@q)n1tmO2<9be zK6ESZpA{7oHU}z90S#540t~i>Ua+idF%a`J1p-Q|p;j~zpxoT*;(aO@n$2pwt*d>Kg-K9sJi5NlF=r+vmd^n7$u; zi5CVh**khu$KBV!m7Ho%qIMM+1NgDujqg_M*eu19?>F|w!d3~iGZ-YKd2Wdrb z9}Lp_OqNrD0ELL50L6%GSlQ|X`d?I>>h1|nr>E5?k0dToQ!j|-$>xbHZzEONwUi8+ z!hs~1QVbeO5okbLaJMM!d+))G!*qx`-(VLyFkQQ2-72U1wPRWLhFMV@f`fzn6ci4F zwURuvzMsc;zy#xz3j+dxgm@e@VsQ(|HD?Do3FTZki>I0+Eu<{e ztOvzOW8r;_%zWzNy5~j4Mw$E(dE29 z@;e5er0bt@6$U{Lw!p&t8V@`60s}|ON#xy{5Wo!?LENDn6c^2dPvb6wJ{-^aq>)6z zr!mJNsyu>kTnOO?>I%b;d#9R=T@O96Xn-_5A-m}STgk48rJJv|`1(%7^6mJM#mHsC#d60iA$R^}Z zrm9fS6;7xyN&{I%vC?0oZ*14s-X5B3(m97gGoQ(L&L|U$ytTTamx>fFf`J1D0a&mNn1-ozQRkxHV@z&;`z- zKmeA7(^+oUzw81NyBR6m1!!`(C){)A^m8ZVQCgt$Ns-S0$^-^vFqjoo<*|7F_ixIg zXZX+umIZK6#A54=KWE(a6@ zIVmBqtReU3=*!*e+Yn%v6TqUa4hdWMC1j#qHMNSpz#Cvnmvl;!bfBx(cO?T<>X#I9 z*fl6N*Hqcyu_4f~BS+XMNv9afZaFf|3d(>r{BwO$6WWdgvj1O&S0(f=g!Vj7+(##cf&n|`XnDv77t*#7$)4M4ww0qp)( zua<3{C|!t`vanna?_6mbs@TVwpAiNU@3F^wkNzW*uPA z*10?SCxX&lB>4Mvf3z#qav9Ck2qIc&)riT9XD~6!`WrR6F%@N!4t`zLKi0Nx}D#1ug{CW!ET&q$ho=}FL8 z#DNcWj`;iB8*FH6?QGcGgmLli4w)=7kIKjtKFFSnKAyUpzn*&QeeYlN@s!~7^>pz2 z?yZczo<^KLo??E#y+26XQzc2u(+ehx687;YhmI`GVEcT3gi2Lt3(`a&yqkdu&aiYJPbr65xy9mil4lXf@==5=HN z(d9p-g}wZK2Ae?%I

    APHaN1yg%`mk&N3QvIkq^7-4H1FYFsSk^;zi3HkeW>>Ma* zfSSm`Vmu$ke*K5sd-#|W7}2p~+&A`QXn2Z5x4DT7(PZAxFH2)Ayf7r`W_)fk1d z^f6(um!be@yt=gmP7;XJT-*K7`$|#hJw1vc!0nohj_v320ZHJ?sE@(`e2ZZNwi-bE zkZUG_qd_>25@y?8Z^7OYyU#?Vr6h?0%&2%AFgI45#Zypa-*FR7lo2xGIH>0CiidH^ zR#`YJnQ<9Uah1cF%8u-Kj;kckGfxRE&k@o_fJiOSoG1njLf3c2;zMv2MjW+h!eQeO zcd9uGo&twMZzB+T%H#@nN;yNGEO&Bm9wDg5Q=qtBY-z$O-VhnXSmYdIo7pEj} z`$nsUoSvx<2B~>!X+i~kLK6?$dk2fhebHeOQcFI0AR~hFBTZifH3{KmJ1^9q+}7nR zd@ymt>JN0KTkXpvc}aOmc`12GI5%^3$I&uN5F!!i2nU;E(w0CULjFb~?L_#JRpcVg zO(PJ(MDX$WcB5<|gd*DOz#CxUzI3JBuk;gd2AavAAv$BJbeJb;{+r$ys>nZbboJy9 z)DT^h5OBmqiDYfERfo7Of$vXpQqd(<8P?>SKysVmT>EzJV7KE!Iju{91Chaox$px% zu$ciaMuCHF!G>qUN*q2_LY{<%Tnsv@Nv$Otw zNeWuvvtje+Qs!0m0=k$Lz_+qQ9lrP6=5+NkBTzLzHU={AGw3$pnb|6=sHmRJ2HCcb zTg=D+Po79T*@`YJ%E#M}ZOUthi5?Hk^E!_-fn5HfOJ*OejsI>yWwO@n?xYiR%;8x16cjlbOzIDtozmINu57 zr?oAZHxG=ui66c8Qqrvn+i_eITjRohZ;W}99)p7!IWB&K_FWn>OHYRyuV2b9=eRdU z+2GN|!x6}+Bm~B|%LDFqf^6|I%kd(%U1WK4rgJN)24S5}ekEJ;$@1tlGNsv2<5C%7 zb#G*b{c@N+lBpE*rc~obQ?_skHJaI99aWY=I=wxjc6>zPr5S^lT4jUA{Xd=z5gv~f zt|Sqw7kH*z<4#lF0ukDVYT?G;wx0cxQ<}}rNtSNn$J`k07zi*J$b9LUg!x&^Glj&o zINTFl;c5aq{mOISNs;nDaiqYLixFxtv#0>>c6mIGL%uE#zXJD!q%1gmu1&kmt zuNa!z?b=KL=;Z!QGd&Sy1zKQ8g2Xt&C^5yp*p0U?U`k8r%qs?zr-mv4rnnDd7=|4 zs7MYLs+0s620n8sf?P|T7>j>>pe#dnaed!G^Tq2YnSKFhLbMjrpP`zu@UG6D-R7_y zMJAilmTo)#<*NTnWzpu#amW4T+Aao;8GF26y!QakUeqA{se$ml`IHlK7Wcf_V!nhx z5Ne?j`>*GI)%vO=7Yrv@f(M*_4HsmYp_^bkl1H3Yq^Y^aBKJLxZsO1ZVce}8y8j=) zQ(yr9utMeQ=)!lK_Z#!<2(nVd$}eeQpw9u0^#R}zKOq5e1J(1f&bJ5S*e#TX2e)@B zw>LBQTXh_=*g&Uj8$wLxb8kQRkm4%)#LrY{~6xOa<49*knQdK>*3Pk(<;6$#R9ZhGD#@6%Rs#Q*FI zYLPxrE#V1HHQZpY<6p?yoiOhlmOuMR#t~soG)zZ65Ga!e91A3y-{`TBDf=he1{Y<) zU;?bzAKH%|@qc0{(6Z7bU`mtisyzToi+DEqiWB9NSGgm$>r8$7zK z%kVo2k_QS^mj={-pPim$#@_-Jp04R|+vN#oo($W@U)tcXa>&`lsoviD1?4p z!kOr>w}n-|z7G=+N?~7Goi|Ow+kXoe*qVQ)lRUAVqpg_XBzcCdq^gp>QeH)0B`@qR zy}dvFlHTVD6MdtVF4Jj!ksEROsD+sX?ih9LDCej-VCYxpqoF9cRFkYCLK&altXqQX zGI7OiKCVx~^UJRpeCyKoqZP z)8Iq1`g(1(f$IOyM?+pjUVmWWQjR~IzF;3#21-%|x=G5oxqK5CNy`$&ky13a6Ly1* zM8?3jwsVfykMk!oDkGFUHw|u*BU)FH;tU*DKP)i4l1Ipql$%>Q_~=dLzpzid4Y&_B zLonT(vvI~#aO}x=*lKeQ7Mn@8VT>L51?D%Au~7q&VTMiJr?N{ zt|%fd=x@9y%F$wL0{_gIc-{?R=`|Tb81(O#I3d~n55t1sQfoU%aSae=)5+oP zh75r&L|}45*E|`ZV<1@?F$AOR2%0ssI2L}W%I000g};8V2w`NG16 zjH|G^GjiH8#kKvsO3VnLCu{BMn`F1LDt5o$`R@Qh0RW;IFd!%ZNHn8Ic|oP9lkrc) zj}fzkWx^X(COipG+1l+0Hgo_W@x}>$^dN}v2EYRcQisS2mygepJn!K+uD((BfAUX z7{%Rzx^*YXCs%wf1p@o;>HoX*3F*_%BjEisgZKaczWqG%=m~@<^6gk&$NK!jeJ9Yq zZ9+2-MbV=#5cH0oKNWG-mXp)UQq5AOTDi8)7Jk!ugr@IBH}X#Zj7-a~418Z~zz383 zwtV`WSc^;g>UXH4+0NgF@8$XoDS9)hK&lThLz#X%(4h?DQ`C$tQ}v53^sF*&p_`3L zrtTf3zTGmnTIWczpR1b5ZJFtbMVEN?nwk-pOH&Q5kafabgwCk>EbjQrB}jEJ2X3PP zIFQ|iwaFwtpZSJsQ+1@E)3HkE)gemwxIzgHh}h|?Lje#^2>L4dz?86q0Ay0aAeZTw z&!jQ)7E%eptf9FWHHR&%&bTIb1e>;D#|%#1c#->wV5OA3#uMcJGLC>7L(tSY0*5+7 z_@IYK5pZyR3jLzVHSL92wIw`##+XbM_B-o=?q|aouNK&z!hTsP2^Ke&&b^C!p~$)eRF|+ z#T{b`h9H3#_`sgH(tmkQ7IZR0$Z1ju0r&$c2Zk0U?D?uvW{5h~jURQ44&T&mXH|YT zV^(z@$DD-Ymd(}kUlz4PUmBcqk*yqCtLjg^l;tVJ<;OrcBa8}f_#EcQtSMu$Wo3$s077m{6w7nAuA`dI~nNX)`0aG%K5%Pjr*Kkwcy#*!#x{ck7~OipifuOH)_kvZk;Yd-Tm*nd^DXh;Rba6^a0j zAt}v(f9I-;p2fqpHBT=9Mb`*PHfyhC$g_vOBB0_M1oeJJu=o1eXswuNgOyVauomUv zj4{Ww*_U2xtfRfxr^6KMCu9UR^mPGpsOuN>zx92>e26I2TTMT;xR{=TQ-Xq$sf461 z7bNM3UaQjS3I8UP?*n+(4*+C1XsE+ zOgaCY*iha0KvwShBAXX}zD4``ju_zWHm^In^;SM>ZT?zx9(@$Rj}Ha5_Y>Ls%ScG$ zg-(UwTS_o_OOapiod+dyYSvuiHO0pOdmE|xccr^oJ=libVe@@A?~SR5g4BYyV5#rg zJXIYXh|V=os@f|!Ds~K(ZJjT`lrGCzQq(dh4?y`CUdg6t~y>^&pacd2eS z#HqX9TZ4_AUew*#yV3ixT)31^drnGQUa`>FcdVJcBHw+l($9ffFVj24r8{4uSaB0>y2RyaT-hQ%)en5#Mov_+^h1cHvIBj;H7|GSl`W+aR9 z_l%KI8FUe1j{WG3+``t>_Fjmm-CzU2Esev0Hg@1cvacoVVVS7*GQcJ5 zVVU^&9DZz^7d{yV&E|wFjV6UHC)38yj7O;`5vi-8%okYT+;Nvp%N;fCio1)7)lh66 zs~H!k_zb`Sq5aE;?PJgRW;~hBXRw*ZakxFbRUz2S)UvhT_!JXHqJY$Yk*arsBS-)Y zgzJH0=FYv@Jj184fZF*MLr}lZj&2@}5ZC?H7jhY>(8=&rV5H;g*9tJ^cJyCp9z>g( z2ji}W@crj@PTH!F0*L&^T@kWM#2Ff+@vU9sTUFuc`&5m2L^R`W4^`Nkq3}hU1hP~{3%U!VO?kH@udVnnPLrdcIA9Lp60#ST4t5ie^7Jac3e%%K zJA(6T@0Z1XoR#}l<9Zu7G56=;PU_Q;;iG{)6@vrCpKBF2RkyvNjbRx3)7$$Dk=y{3 zJN?lyUeV{#zg7pX!C>#^%ZtrI@tb<57oqd<-c)nqyW7o*Zf}=i#Lg_8WwCJWmeV81 z8nx}5t+@3zXvXfhpJUX(&(%6{_!_k0`E@kRS-zeJ1zqtOLJbNb2zyV6iUO*v-kyLw z@MO@8Q!dd683(doPA=gmal7qanCo_Xcjw%vKb|g}ys04)I@U!(i#yuW|CReWM>|t; z364lc5fbf|Ww8O&|HN#!y(tT0fp}9y1AB%D4E}CNvUZ)dP$jXJ3+4hksgwi+Ry?kO zT8L2xW<(_)`9s%yxCbjD_=}GS0CVXsU0%MWg(Lt10F)sJcl#FraNv``4hSAN+hWV} zH}z4^s^GW>wsp75?NI^(Z6r8QyP|Dv%6GP^gst^rg&ux!A-G_K8ZtQoVl~>k%Fz+W z$g7Hm*Nno$8lw6NFB8kO+VraXHQcj~*KCeEYtyqX*JMsRpu*!F;;suN!vhUF=^=-o z`4Hd1nvNi8f#@HW%vEQ8pO-Kgjn0SVC#teG3G1%4iMyCHc5S;+J0~=*Q^)h^!yS6=f z)g)J5wMej+1L>n*M#-aI$S>R1leJkd$d~umU}gEsf0>WLcicM09dpeFbuDTw>t1)- zq}wlp%d|E08~>TK414;&^lPk1)XVv0{Tgo(^)h}LzeZz0y-Z(5myw_=qtp?&JrRB~ zq6;-31p8(1nfG&lh+j7Vg3*lN$CtqduNi~iU*iy@UB+LgqnW60y$oMwMpPfv>>bf*L?#a^KPtOrX%}*;_?N2al z6HwG+wr(_9l^c$jZ{r>1$Vn^n7%wb=7zhQ{AOL{lauvgqT2{p?x2ncG zwQ7UT6C7E%OMF0HNRl}va43>WE9i3FxMf;|*`P~&ghk*h*_}RD<%e+M)(EUD82rzu zCdrCMP)C=xf~+O-S5Y2aXFHGi_4QI}!p}RQyf6WaTjGI_S?1y>eWLObRYABVRmJ3$ zoiF5`ps^KmfC9USFm!kA1>@&8-9Lmy!Lg;CP(ksDu;J;hsB+q;Ct~$v&=SH2LM6>W z_&Zl_T@^pM%!kcrF+&&i5x|-+?|=uMJIdzitih`NHb|8p2Tkt-ApGSnR*7?6J$hW2 zMD`Xmh9G%g_Lt@|*~)?&5D^{Z`t^bHs<4~Qz`))9C1qMU-?&JE0LAQm*f7S|Cu@iffkU| zjejU9HTp7#j%4s`qUNK5+^LWt7J`(@nh{|esSQreja=K+uEN$Gm1qhm-8bPGvaItG zp2i64`o+bZ&tigbIyEhu*5TvW)%Cdt`|RtaPW$7AuX z3K;5`Atk5UW=5GA_<7ZXeJEqaSh;hZw7I%w=3MVT?&>NsB)sfE%Tt6P!HjJTkw1T; zEiL(PF}b}oV0P>cG0QHS$HB;ZRMfE^>K&+tUa+|LoYni@!9FB3gFvtgTr4LLX}dGB zgL*Y^pB1uD*ck=;?9khF-p)Gmth)v-dq`MdkuuK&R_ne@FT>BsBiMZzU*>eIXDuA8 zEp@?m>SG?ZYMEmmy&oMRG!=hW#LaKoOmQ+}R9J({*`=vc=XDKLcD%%A%KDBYipQ?> z?ie)-|Gn#`mv#L(4Bj2ZLxlbjaLL7AzrCyCtdHl4zUuf>(up2fNK_pbAdPr5+0WEC`%60Ke~UWrsO1BUwMH&*Yl*^O^M(HI=II}^p7S}Yv;I-v zkv+++NYVC(kb>L0{{R3Ljy%J000g}(p0K_%qcXc8sCY>3lz9!U;)VlNgAODZtGpR zZU#$||DW~$03reaL^EJUPym1m5SFAvXGDCAK1LT4WWWp%RzZL-8nBxgcbR*0cel*_ zxs-C3#MvK0vI1g%qzO1wAtkWHh#x-1NF*5X6|Xpu0g`2*29J1AMwUi!1qFZx7$5)u z83Le@0sw8QwA+EVVu5nt97i5=E@N)qQrZaG$bgO8i6wew2^88+7!+d!m~nWPf0qCM ze3_H4u0lm^kT+GyR7jArGNY87ZX%ES@sD4(w?{sy{H)T=!dbn1YTPGu-O{-3+L>(M zQE}i(PNxS2lRIVVGVjdP0;Fwk6DLLHGl$;pGTz4>_iyPYV@;acV9jJC z`vo?`SP`5?u@^hDSQNg>6|yMbNSXfYx~S?t@`YG;%R5TV_o(lgA%{-8Cmx+|hYGCE z?Tw~G#*(EQqSYcJP!x+YN5uKTp!d+RgfhW`Dnn6V%Lu_HopiO*PSX1H3Le^`%erAUTazrCaiIU?gr`0@Dw$Kxj z3m6r%h0=_=z3g#GvIL50ToJYy;Yx5uNM0fydNkP}l4x1!Exhb>21E)Ia$#b&)(cbBhNY*vQHihSyra(;d@_m%9Uh_J!XD17ZMgSNlC;;`Qe{(_F*4idG=YX6+HIwtX^KDfxO12~@dDrJwRM5-B-i`;M=U zV2LqOoPV2qvS5%Mlji=^;3DlEFXuC`#jEJ=Tge4V4WH{^oQ5wzieVW z?otr|-A^8}pEa#B>R-xSy1e2QfxyviBNjUKH8OiCih=x? zg$fGRLgt;b%Z6OBSatz2Sh&nW-A9;QCOPnRnC9cxFUz^uEy;(kt~4IMPFc>yI*B{L zRdRWRd*nMC6_R&|>tp*ExMQjH*(OSG+4?&0-2N2UQleAu7vwhS5`0_O1)FK+u(o4s z_HJws>#Z-sJ9%W!nw+VcJ+)<7*OV$tmMnE$%^9KP-I=1@ZkyBVkb|X45M@cDyQ@F} zjA|7qTv#yg$lN(#Uh0s!bGmLRBIlsfzcf!`f_RDvOn}N^NPuB_VO3u+pcoO2vae$( zdq~ClR2EZM?IH;kkO?EP^Jk9`R2J&(+Zf*2mkcx}7u`T6LfGvc=^Cqp=p#JB6DdYv zgua4V(Aq;yP>o?HPx65mL>AY{8?O#I?HwCSYz2YW47wo|#$lK|Vu+{knM;P`j4h7r zUyGtp`C^1_UyMMlcD(}FJ&rD1V|L)e9-)40Jd$zi&SsJgYhe`P&XApKzx?+ssr1&C zX|_ipBxuJ15-R2~FU*!?%nYn#=B0bhrq@jN^vw}okbM$Z_Oh3*%+2>65I6+e@N6)5 zWxyf09#z>)d2v=9>;QQNu6S&2CUKa|tliB*Y(~g;CMMkT+gy0(I~Z7F4NSC35Ddpo zgoJg2Y?Gt{im#8sTqgd=^^F?~mj!Cp0=5J|f`w8D$l_jz?CPyDC9L&jQe4aR3Sj!n zUzlYkr10KDlgbYvf}8uxk2DVhr7Sb}{5hPn;P)XG%UfBIJiNxLE2VRNt1G>k-27PS zyxRVj6su{m((18rNFgSPSVXafpN)&z;C4k&xt<{3x1$P5`t2^nag4EZd$8DR2RvV? zMeqqlp)-%kdym`>*4afzfUjpL)nJ7VGa$q6tgr%~S=jfA5~uBwHK3AaFggi5+yRT= z0-&js+rc{&UIy&gd?Cb_L!VlQwx_Wr!-~LLMNBgt0H*|r6H-p36-cfgw-V#xzAmQe zLr#KrovVNMA*u^LZA>nKYMltQK{rH&#fUY93BBH0kjhuD9W5fDxA7b!S(H#@r6`V) z6$KfyI46`on8>G2AC(fW*Xcm6lsNF|IrGCeJ1Gjqd$dsAd^jP;H|z zAdgUp8f1BN6V4E&3UYuh6Xp@!6Xe%k&Au4u$0p^CK+Uxd9HA z3MNXp6~Kl=0j@b!fF(k}d+c2Vu^jP*Ad8B0RA_hu34nZq39zukrsLH*)cHjn?0`$h z24jH&!J7mCd@}$LcBU`@j{uZFNNi82VDgY(;|1lU4nbO2H^mNO%?N7`XFr3K@3r^%|D_ zDveDf1V)TAfkkdr7&A779l@l~QB#~8Nu+PYH zb9-M2TmV-HE`BAheG)<*0v4>TbtQqlrGkk)C4%=oZD4Akm}p%X<|khZ8sI$YR&Nsw zvo77Qq;XE;Hifw-^WZ;aj%1sxzlu@e=5JjjADTCpm9EGlE=`4f`X{P@(BIvqG5A9v zci*Kjmqgt=vn@sT$?k3Z1&01ulwkm1v1b}La>q8x(1GY+;1gjwD(B7$MF_$|uw%s_ z;DSY%K+>O+n$IK*sT5^WnNG*TnKhPedTiZ5r9tA8(cUDE zhr8Hl;>3Y8KP|j#(?Z@F{vCl63Zxs{<6R(^^42vu;XfjH3u4iMVCd1TD%$j9V)zo*>o|$;fCd3iMGHAN1gXLWQemYcm+*-8zL2)BghjC_HNS;@K>&0* z?7xB%HbG;;LJXCgC*6{YWho0h5?cWi<{b!RP%R&JE&qjVU>^ytf(~qDFq9@Q==>Ch zWg3a5X$WNFfgHDFHs*VCXdAD*TPnEsDeJ6HW06>3NMIQB)(W~G17AkPH<275CU2*> z63cF(dGD)|OBFwlxsBt9C3!xh)Lat_i)*4RL?}IuQ8?Z~1=pS$seKZ`o{csr*$j_A z07;!q!K^R=7_dhGwh~EBv?_2kgJDAMG8F36Dr`Dz=v2;d2tHU{VvRib_Wd&!Qan1X z)mWmDEiW|y6USe$Oir+*->IFpjpxzT1v|UTv@ud)PvePD z%}`SpOWTLzxp4Ji>`O739(ke@tspT>rXmn1b=vOdw75|7jRD(y835I5KDs!7ch~=F z+FkU&Xtag5v^oBky{R{=YZ60*($P>ds$dGPUCCpc+&eWq)KR4k?7|a6uEV+p$KVII zz6>Ssh){o-EPsnZ1S4q5@FDC1c2IUP{K)`Um=u1@VB0x5tD(J)tuWc8rsX@xpE9o= zpBx&hS}ohO8??uRk{(Kd=#5|tU>50~D~$0ccwEOSi=-6h&I5^5z5*m_l?8#?ZE1X! z5{2lKdKoOhV0Rlq-y$O7*O!}{Q7}o5EH(!yfT?dZ8uvisa!L`+{%6rf4*GVrV+%HR(of&ItT06r)w!bfjj%O6*E-EIE6ldZoVl9k1vUTzu&u3CYUm8RbVDw0I=#m8?pW~7Hg>`9SKeHA z>vq`@l$~S?$B!uMI+=+$CQvCYM)?M^u?*1_XNLfdi=iQjeh{B7NG#2TqQ4j?J?J_r z9Nq1$;zjVFd36xziKGh7Yy>0!)bt19KBT0STQt% zd4(m*q6OCU#Xfjp5+3<7$fD?HwQAs5?QP>PK47D+o_M*}9=XeQhcn7`r)=a^CvLGl z(Ts7$85?)Kftzf%Uo);Xcw<)@znOmq7c+LKz8qXFu3IoBhpkC}+TU*Rv0+4D(XvjoB-gW^R__9oy)}#+6Ctc>U=)^Ex%e)%=^YH^YW*XZ-6ig_g{sc>dD> zG<^*K^&5DihM!0Usr86|G2gF5_q>EHOIly`07mu#D}G`8k8;<8!1v?NRPN;ml=1#V z-xGqjxJ3NMTV!vUjg)-VZ=afT404qKfO4-ayE( zb{(zwt+f`c>+v}&8ouzozniS8{8lwJ+@z0sPhA?`>J86Z;vjnH9d!8cM$IIDF6{j` zQzz`=XD4Q>SXQr+D)=yLu6&lz|3Aj~$Cgc2x5X;>*s*F72znNfJeC=32?|Dg>J5FAcD?|+|Cz4wV0RD@0{{R3LsT#_ z000g}TN1HbN}YMUOP=OmE0%LiCSrvaqT$7YPe@73P9!CR9HyDK+8=o+e#Z97BYDCqaioi)(D;N*a|Yh!r-&;Q)bw*VG3m zwr@EMD(VqOi(56+mxV~k3A5?|dui4JQc)EJpOkzwVL2>D#C20NoJ-rR=T!nFC)P%% zvlsQlQ0~-T2_ghKI59@PqMVY6)&=(RVH5C$!W^*z;Ko@6ty%g5Mc*5323oK_G}NE~ zi2;GqGuIDTwr|HeoY1S1lptE)=ZK?0sh4WtX@z(HLWsyomWSs~2gy*hTGEM<_jIXg z9(NmXP6P~yc2E0!fPEzBa;N37&{Df|LOf6*a=g%xp5n^R<3zNObW;NjB(Y z!f>a7Ik+e@O40d%#PH1yN_J#5UY;dol8t0dawKHwOvcrFWY^c?+n&}Cjor0!u3mrE zs*T|!H6Fuxg8tn4u8ZRzjh60*8EX0qYxxW#^3hAh1qYOHSKA-0qGoKyIa!`f}U z4Cv_*UiTy3ajBKWyj2E_heozG-A+qv=zH2JX9O4>#zW#(0Nz;^1bm;(;5v#t+f&8I z+GK)Hrn2Gcz4egT2aF5W`OyjkSG_97O_#^dlb#B>Nf!KLW&73+_e8?7ol_w}C$fos zmwoiRNKe6gF!VyN_V@Axww|)xN>uA)H@OlraXD+UT(+X0Z7`(wkGILdU2rh$x~0;) zNmaf}*ju}M*ml|_^7YF7d_NBu43_3YP)e_4mCn6fkr8lQ)F|igC_D?~GTRqi4tkBG zVqd;moQHir12Nkk8U;`CF1t16eUFilrOh>y4qtU99ZY9=bv^}d{f5a3c)8L^Q0F@z zftZHdM!CJb7DE|j2E(?xxH~}E-`&+RI0O%=9~mWsbb7gibC{g{wEbQLkIb~b>H&74P zNu-K2lT4*tF-f@;ktUK%lxrs0og&gC@+m@1>!FW}%{{g#_6Amq$q6!!67pJF<7&O+ zOPS$s8JNKUxh&XV<)y~-&qzYmmGg93#Pnl$yMzE)Pp6uQ-Dqu#-GFtE-GRO5aav9* zX*B}f)NB^B&O2BgLotj6reM>F6}(x+oe642%9`fybBKf5I&|2QJ#E2|TlVcrLV@&# z85M{Ru^eM5+~c)C3=kj$7Zyp(rwoC6%s{N3$OtXO!9b9}1^_h1iFzx$ zF!;)5HT?74!r86mo{KNHrCi7=`j*(*88zEqBTJPMC%{K|E-M@q)j=$ihVZ~(jRxo- zX)|zqjTAD+WUVvmr=x{&rn~MwV7@FZfkd>|JCV_Zm70bK;MUPcFE^XBf^trf1tD`Ug;1!I}u96eiBUKhPGoetP3;`i07!Xxb#SfHp zruJ&OQ){Z-f|fFVATk|D>Q;rwmO7Ow4L?mjD0EAWlys&}%Dc6S%zQ@Yt$UVEt!&ed z^)7U+YH8AC)YG@?lvK7S!%(4Qe@)LPp2D`L)NjLC5UV0^gBu@Xt0TPI8>1^yAa=s^Y zz0EZUUXm5q*JKWL@1~`4lF$n81&6D16|SpwQttY@7kY1SSPG%5&*mYTGN>mJ z$RMZ3hqBIh00$!*;)<=>48ej{F1Flyd%av(wbfR1?DfyvJ}sh`$rz&2!nXug1HN#G z0X0+h*opRjfe*DRE~Q!&gM}f14G2>VEbY+FF+1sR``$R|q!P!W6VhI9b# zJ>oU>s(AK#`;t%LXI4=-k-c7wDcJ^c#;t!U$bqH9`$rV)1hoVV3LwlE22>J<(kUO~ zBqD4+k+`0rG=`K8Vtg#r5<3u3#STi67Vq=YPG44gsiY)oMjaj?P#76XcSbG4P>U@V z3b3s)8KkwkR{Y4tH%frke_SSch1gm^hgf5WsN1|xwNKa`@Yb>h-oG#)7B2s)+S)p? zF&gIGenLj}k@z@})K|MkeygKULC0k%b#6W>KGuB0>^Ii~|7v%A{;#RV#btH{;1_rO z>=%aj5_fj$9m&?z8_o9A8Pyfg{mFmSw=cbp!GZP&kPQQpX_45!KA@;NI+;LmFc5?o zU_ews{4<+2k>>!Ct*i*<8JLp^TNU!(|7r@#HALIhci>-{r0@0XoU)SYQ0Zi#osI?w z?Mydl1M0S`r-!gti3s3=p}^b}&(~@9TGIOIhU`4-N4Cv&iupc$`6X|1hyY)>0zQa{ zPG3X{crWWd%9n75T}!LcLGWw<##e&~zGNk+=ei1?2aWj%R4OwZs{F2Zp8`i*H(XDb zN1R-fSq|OfQd?$+g{}*HAU$5;?NPto#QO{HF2(8a z0054sUiIud@Pe=(k8lAIhJ%uO_6zU;6-fIsJHa~>Pyqq3+=Uug3U({ew0{DOKs69Y zy&@rM9E~^{+_+ET0IPfg>T1>S?e$SHKo6nNf&LJ_KJQA8GLL)Jw+t*CQy8Ip!yx_} z^x%7_v;v@CEm-&;9TtG<(Y`ke?VCo`QX~iripGKgs2bOvTz($VSu$B2%H`DrCR<~X#L8O;> z;1kNcyOm|rH$GY$EuU7!>BoJzVXHeRVk@oZ*UO%a0&Xo6z*=Ksn5!l#s~s&}*h=fU z|8fIZnDhkPw)_V_#4nt;Lj||0=zv#oR&d*fUaP8oQOA!whXiaCm<#j36oxMu^%0IT z>m9H;GHl{3Fv3~%T)(U>XX2bh6GE_8{e*ylOkpGbtENx927n?K+!gHakNQkWppVO~ z)>uOL4Gsik;|s zw|HJMY^%5|u%zhH#cwQ|AuHtP8{3!R0mGB;1~K0RndRYnc$;9W$;%62-t_SbY6#=i zRS2xc%l|h|E)3WD`wGT2+r8|4A)ub9aa(}JCys+lZ*Uy*-0e~XuvG$%4Yy`@nNZ?2 zT_AW(Bgo!U1*wvvQP?`RhP|*Y2G@2Qj=n?)8if&ia;G9V)B(n6K8@38joRov`qSUH z5c`Ph0_Jk%fG&3~>MiyoYzB7xj>k5~MP4_MCug1gLY4x2aDIGfKLs>M3SQSw*Sb5; zqZnKTxJ7aez!%X6=;M*oeHwoe42Mr68quVGr&0j-I$=Ls_Wt<@ISB|QwZy=|0WL)b zroit09C4qX@mb&-Ph@M9lEFwnBG5bhjrxc^xzqL+BFOhNPov-JW@!^&r`eZlS5F_M zKbg#;CFesxTmV8CAVaXwL#Fr^`2McA@)0Qg@B=`(o%OC4NA{kiqvM&H&3gK;o|pd1Y0pOe^gQAu8H zYQpS`4TBg}Mw8})x~KZM_9;KFKV`$)sOY>JRs38B+Yho(f2N}ZQnLqgEJK2O2IArZ zlAGs~xbaoLz1SLBC8&BjVTrvZ(11)QY=_mb?{EuT&0a-Gii?Mx;g`fl{7a=y;6p^= z2fNZ=SHf@ozz3XAzEy++uHIJgX%oOmu7DYJrKnSDf?EuBv4I1gZ6e!KI$SJ`$+-G0 zR}Oe*0I6^Q#n*;@UjzbEh3j^;36KS@*W&gPYN4XJ))^&{td&Z6REkq)vI;urmU>+3 zFo?w>fy9#s4lbB11lo}}BcgPQdm&L)+v9cE?yEeO^*u&_2SUa`WzdmCvT!4K;wKEs zNg4}E2@y|zB4MOP0mf}4hhJeDE9EPbI6n#y}B#fuId zBCslVsbD+4BU%=iACYOt98#}4V6&Yr4wsnf{O~odEbS7^tLLk$K8W!x%mf8-`ATSQ zV2C_gOifW~UtC`-fN3)m#Zq1@>;Iwmy=;YgcLdlT-v1~A6bxejgb00xLi5sZ8QdhGS{$TZJ_Dr+sQx#PTN|%Yvt#^Z#9gF8o8GNIj{boLBraz;B6E8q zh#&$&7|LB54eK*>OQZQjK`1odCG;;|6^sK|9-mCx1VuHmpPXEH>>#0 zmMrU5EAzVDK1K&xA)lwbLWb)_k!;VodfNs7%R%b9Ozp3k` zpp&BP)b@}$U~!=}f$fiIc-j!v$UI%2wYAu_KucDqRU)59%G%AO6@KbaqeD5(X=j+X%FPG92?1AUHCB6 z(xf&3V?dn0#s>fBDf){7Fsn(>SnB|FRsXH+w*82VwM6K)Kzu`(8!~pz{Cx+!uqF)8yqZH4L;wqkx3{t|X4`ib z2Ph;)M+G8{WdPw25CZ@J07FwSLI3~`MdVf5y?mlE%kpD^Z;3}!0JwI!1x-rQnnXy= zHp9_6N=XL)KkNShL}mbpX26V~01yZ!7RUi9fEeHrPa~f28^jk4SWkvV2{#0HyZU}@ z=KtMucjhu|S!|U00}lcLnj{=>Bt}4pkvCj%5QA$*;^X6iER4iUk8fini%DI0)*rk`0L~3d|H6Ub~460;b-;$(k0z^NoXnL>Sm6~Om+a$o!VLo zUj18fmBT+;i`0sEb#;|}ikS~uEoxNGe3K`$tq$ipW!=Ad^XgPWDe_UF&NLZ5()2tA z`to_5WW+bI)Y7XT|9|_5v$*vtzWx!?iTe|aSN|-FA7}Q*61F<*%*`p{v8UJSuC3Ag zazj0oadYQe6|ze=LVB?YYK=@gEH^=g>yJkK*Ix({qI9J+^%&#c1rRsVH-K(Bl9V*d zCNa^IfyB)PCZHSIS+z5U$vZG^ntC7}h~l3p+8HIzCV&U}4Pb(5TaE>Bc1QD~$DR;% z#(2d~WFtwYrr;b<71dDAyX6{jgVUk@Zu0aH{9UUR%8yPk3|wmFc=#ym321p z2yvvNr*T3f(@aeh`3i<{f_Mnc9Y-@eNq3-G0VK3SOK@|9?J&Ur3~FQR?KOqG4}3mH zseB~k+#o>XsZanWeI#f)5p8cq8dEYcx(^gTb2l`=kUKcyp1u8efq4JCX8DdoZYc}j z@Jyg`2OsH_Yx(0#4!j~i7Y%7S=8*Y^B~VgAnTa$`2O=~lO9PndgTXaldx`vi=Lo3! z(ufR0&jesF!2k)$W4gC!;eR9@vZQDHg!AkqKzXt_fGBna*6q&xeW?kP9~e9+KZnSS zAu5i$7xb?q=rp4d^1vXJSD%IRI}Q$e=VTN>Lr28$R)zl%dQxm?1W+Y|_Y(t1@|_?j z2|lEebQDDZUp(3P?5o|-{xFnLRtu34!!9y!$9hf(Wliq9k{c)6kl)9&iCi}sn{IfD zT`l*w7X~Z}43QDw7V_ZhE;4fwPszP~6gWXH)h6b#`qTN~(QnYR!%vp<5K|x5>d{kM zM?NE4Gm$q&ngQ%vY43LVBw^f9*?Ad)wo$uUKbgP888BwW1-4~A?;39!YQqndgLGto zVXBW9_ZsdVDNa%^Im%GEGuN${1d;@G$VV6HxObbqil3kd8SsIuczsJKfbn#n-HEd*rp}>UXH6g z-sI*6uEssmHmFjV>@$qA(Yg`VsnsZ>(&N#>w#h&Nc5sVLSv!s+F4hbLZR&jv{qCSm zN8od&&-+R`z#d=~6ntslv9$cGU*ET*TrzyU?|FG_UM%G+ew!N<>ga!9aHzZu(XGSx z1KjF{)bsPAj^^COk!zi<+Zxi$ugS=faq5jB zmNkUbi@HOTlB8j#Go*LpTLb{n5eK2UeKaaSLx{p|7o7Lt_k4|sFZtTQCpo!HVJJZX z46#FLdEQPxkhlQR#zFUe!nO~`6%0Ytu%OTZX57KF>|WIb$s3hV7x|UK?s#cq0g^Tj zsW2uE7v|_J_e@{^e#;`?!|o{aL5Gv>N5O;;Fxdxx4e7@Tg#>F4oxlp1z}0!w{O}!+ zheRFKHmJHBTBn~K!Pa01{~?fE{}uQU040-7tu4soA<`Jl-sd|_PGbbD;o#+3FSsxM zu0U!P`)GGDK7}WcR zpFULdyFbcj8$S4UVvM)RBX=}``O5>)^v=$_Xr@$qA*}4%ntiJirH?|!H60du13=_e5*4;W#yXCq`?ZR+Ow?hy*1rbagtVu#)-cSC5%AgNb+*Y&%{o;`Ab`ilk= zD8K|C5EW$4+AmC32&1!lCPNU)YY=NP{0f?`Z8-6%bS+zsKVNiHLQfU}Fscl~igsK9 zNPhDBR6a^&Ln#2hJ%9i=MIg+G`IMaU?}9PoT?cU{eI!`-Fr>f9d4?5cE?@JT#*#Hq1BS)^>%;rD($m zcfBcpH1mmsAQVJ*92iIiMGHbF4kx26y%|0t0OOy=VuB3_P#u2Di)~1d?DijN3iSkU z0$0?AQM70`cs^V*N`*r=3ZZX~Qqj&GnSKcu1LE(7mtS64r`CIpwmkX!b4h%E(mhrH z8vH@P&^3%T|H((n*~+g?uArNVmT9Drd>RyM2dLmDA>J!rBVzXgX!Vub9RLPMITdSG zyF)(uC^@QV9FTKgSwwgNgG1p4QO4p)J5)OIY2edIQuATz&_*S4h>#gO_3wU8vC?Tq z=s-rU|HN{p=k0^Nw?`Gzh;?ju#$74NaT# zDGGRP=1fD8QEv=0lUYUtJ@O$!;4&N=a19*=ygH!+HKEYG-Yvs{w|(ve!C!o~A^VBCeABRbbxM%Ojn!aa6$aMSDw z9|H*Dsr?9`&c>e0rLCCin&cf;sqMhTTVV{eA1L%O2I1R~%>VL+xj<$Dr$^*hGM{$^|}#0)UvBe zMOA8=u&J}AEHS=UOk=zrysrprg(|7}o^}{&F)&vmM}?EVx2JEu>Yty#>dSv!Ax>VX z8=IE1du@qPjCNeX`|S_Sd$u)O?iGs41yMQ3kqB#V3y#$_%t{$ANe*nV&Bc*ZtUY z7&RCa&2M>L-?`zerPSB1KJk}efsmh%bP5d&8Tj(J&L}dX>)C%!!SL+8@>*T(+D$&^ zMgs1=9RUC2M1cM-yCw;^LFo+Mj5?wJHAKuKC=Zb){0) zI?^fX?Vx5lcyOZ*DBrMUCRQt`!L%iCGqe|cQ_qA_*7ei|u^=!eZ~#E^ASS7M?!38J z_eu&@SJcWro)`wYjuJz^S0k*$n*`yp-|ufpDw_K*tSmlt=c{$lu)yk#RB z+=yvEqheyuIJj6dnpV6iVyBmSgzqTnTd$SHs=iYH1x!p)pg-uq;(Pe6#AM7FAR(U9$;eP^8Gp)p}Cw_Evfm zAa^G*AiI_@(C*9w=F1rZz5NV9@S<_F#iZE1EIzxuB>_6+HC|}rp`pVsvqT%-W{YOf zjw}vfW+yh_W+G;1#jZv=#ItJa6tXI1y9Q*86bRf*6c_9a3WazQ7{ks3Ch)Vs@>N;a zC}`AK_mjq+dHZVe_;AwAGlxqJXkvV6u`MDlI7eg^r-{zww6~O9p1mn_ng-|AaeSN* z`$egUnNP~%W|LyDb2YXUE13Mo4+8M<1On{-f{#OKwO%Pl$M1+DZyXh!6x0%rUs5Z( z{!_T9R$z`kK&UP!JnYu&;#_`egl;rN}Ebw2mSd zI3jNT#>MV$Z1A?Vwrdq_iGsPUdkXYerrYytZ?o@AR{}?yXulg$m8;{puVt&d%b%_9 zHr%!i|6YCI80VxOjQ{~8^Lq@kvbosKm=1I@2lyNw9Gz=<3nI@Qs{u~os<4c&8Z!pU zz}U;X3LwR&89$DXvwk$c+~V_7d^~I8G7hp96?o%xn;ZJ-dRBDX{c^MnWaf3u9W!Eb zFU@iMN(#Gu)-^c4@DDC;e8Th8B$3lbICS=1Dl19G1-b!?`|)p=}yb#o52*m;bd_u9vAHr{&cZS zai+^N!?SLN1u4t2rgF9tqNIZ)%Lgu(O*fPS>$RNJqDrR+yqH}A0hU)m0r+~6@5d8a z*ptVzuV2s0uFj)nQRzSblc2~!77pXWwN5tJ0A^Q$J+c+I=%|_OMC7hJD_0z7nICeC zk)6ml_WLCXQP^ILh;~;dD$fqa~+hmK;4SdbFLjbuD5CQ-I07L^uG5`P% zWr5VwKmAO}jV3n$Lx9QiyftfaUaR|Hb2WvgT@sSi9t>Q6S210)AkLpc&^ zAcyY2FIeWNa&kGBLp3BMaS-KD(HP$VzzqP63;+}t0o!&PKn9b9noZ0AxMAk^ZM(f~ zyCb2eZBWX$kl%L#Ta8STCcjVM-}$4qR*?4I`J`1=I=j5?C^b90HbbxcT;TdMr5e-9Bx(V54u%pPrZS!#lA zb#q~z2IMk571f=~ueH~avS(s+mY$!7Y3u#X=jfULc?Wjb^;E4uxfrfy(0HtsTQ!@3 zE4^UufIuMr)>bKeps8X*&;~8IzN=L=t_pgIs+6P} z%Yey5b{B9!1@!>NwZp#5%=ehhrvdvMdk6FC6zl3r$*R*8)pa7mnvSHd-@X-ue*nMD zbY_8p&bQgbWZlvh;K1FkD|7HlzU-C~ykTL*3zjOp5%zK{A1}_1VY_jFeSSIX@q|>b zktSe>&>YZ@$npzcGiun8yx(-(UR}X6mSAJXLU@dI4W&)i_1Cs=_hN44*M-ypkB`Xa zR~$TYDdLrjd1|b8dTMa7BJI<{SBZl`uKs$Q$P?wl{-1;Mb-M)a&m_#t;Nb|2TO};#hVCm80Zo{Ro+FGAe8FBj{F!)lCbL!D>Zrr8Sb{Is z8SyoWL*dMT?{VwPyR>owUhcN5q`V(2wtDM8hhB3kSF$WPP|hwp|42_C|U zC~WxJ@z!Y1K;#f7xl{w&K>t)ueTTi%VPs5L4IPJx%cimobQ5 z4j~r&#NxoEPt_rws5jX0{h(v{2J@^)mO={l|++J$=$GpxXGUKsqj! z2FE8W?hNk2vy-ouFml;5o0H3sy4+~`q~{pe2|5n;KpqBd-x6}C5NQ95P%IpUWQ*`O zi`4Sp9$q#r0%i0Q_vs7R$v}v?Xc7yEfDgH#72Q=MhzPp+DeVWoyHqycsR;?kQj=~+ z*fzvF+t?}9GrRYpG^mp}7s~OuEDeieot(R-2aD0Kn3N93T>5#7btxzyYG!gGZZ>iw zb`EmmBuFq55sLZBKjx79IM2aHTL$_d%m^)npQ(iyQd>;&a1tdwI|&o`BD^ASlJ)Pl zGV82tTeil1w>bQ*Y)!4YuG!eK)4FCsDZ(WnW_Sxg#ck`qXCsU^RMbdHfP>A5rkjrv zr0&@JV}_8^DL}zVLy|5}y!3u!EZ)Xh)i55?aEX zSUA>!C;p!?uw6`RVcEVSKU_Wld+GdXr#egFd0V;?uy)C~f>h_R zv%uqbrG;H)WwD?C$Nr3hlE@HA>jVaowGBOQj+D1R`l7o_2(h~nK7G87cH6drpxtI0 zBnGQ6{zDf7}V)7kXX z(}ki_bZKsD4b|X2k(&Dm`mrIe8on&cMz71?(TaJ52%@w40OcUB(j<^Nu5zV6Rn{Y+ zB)#;o+J{J+NK#f+BZ;#;IBhTm&?5T>ejH$~TGs60b+OS-FT1{}hIMiYfR`5ZK)TKT z<3cN;B87{wLWYfD(H4VWW7e77_Q(mOLwouX$?%pY_`H{++$4uayj`cS{H$fo%9Vs;jl*QkU^4 zTzu#1n7#pcY}<#S@r4wRH(qQMNLryGFmiD+mZ>40av?Kt=Qb&|^;3{!$9~F^k#Q`A zj$(|tIOx(#0k_r@T*mfsopyII-p&%d0<&XQSs7fB7dgoU6ga+>&%^l>@VITzA^IV0 zi0BaT5Tx%gH7Qo+TSV>W4I+1TbGzYY%-5D@r}q|Tu~M*Gw_)_&CBn|)wZqTza@qXc zEDTkpN~D(wW&jsdXzPK_80Fs3A*x2x6OOdyw$oC^gQZ@txb+gtHT{1y!ov9X`^Xyj zGZWezur9WId(ZtS@D?#ZGt9uzSm6cKs|ra_mf|wD+Bv2Yg8>h){4fMj;;euPMNke)^|YSvx`BN!ii*aooJH~(+HF6RCw z46or=j945S0~pukFRRK|onu|Ha}4Zze#h=sgIgh6gKHsMeZiseyOTlQ(d{%gx8zb| z8@a6C3W?hQp!*(RC`pR1*QXTK&JC)rYKY`2vPRnHCHPKmB5!vriqA7t7b&X{6#%P3 z5D3702mzL3KsLH+s1!OMA%UtfxFej!tSDzO=gyhfI0A3dg#*{J1qIv7;tGRwb+Qv{ z0}42fxyyowVT(CdAmu5TKbEK@QHA-7y)Y3CJ z#%RinC7iK;(HamS0J&R&pt}PM+8!WQ-uI6;>}o^CSZnDSOFdoVFS-HVI&}lQdGIEo z`wxkA2z>~l1tn%}i0}}F7StB7A-_Xvx4A$A>7-~*2h52OQ3&|>enoq+3bBB=*;&Z! zEG%Ydu@xgV1b2u<3#~n1x$e-LWhVg@Qo88I3dyy^O67i5C0Gj;SO;Rk+hfx zZ$m^7@Z$dQ9>5R#Lp_WAKlc!Rh#kTm0v|#SK@X9Kcp>Zv_`rYuhw6(!#Ln`t#AkZA z;`1K=vmHVoB4;t+qa7k2LJvWQfFa@w`~+R6k|F+XzxOa<`DF}p@HoQZ&ph}?pZqv_ zHA_{t;=bW#W!HL{nYNn0=HD{DPgoMh&3Q4gyDz?QxWb++67W`?$Qc1*8G;tHj1#fO zLBnrv@J2yxVH=+mDFQ#aA!ezD0mvm4SPKsDkUt!)KkRBxP~K`l)T9l>Pv}5~R0kt` zze*LyrB;y%s;3}9u0twvE(yT7ECbJ!wsVm?-@Us zZw#rvXG`rz3MN4UFNr#MHS|&DB*!ii{-k(++*q0N|9?>^_O!pmWLT>tEQM9dgxudU z2dSFOji<)*W7J-=l$_65D$eOF1@rt%eRDfYc^N&Wy4Rl?HzTz(W@PT;bLTFONA)qR zQHO=Qz@K92B7BUW%O&8VmNI(@jB9KFW0Ce7Kj(v;#BqFsfxLA<2$l;%At>P5Wal(I zo$k<}(Ig3jYI(^_lT*Q+raMF?7!84utOgd#*P;2wu^Noc^@9WRnXv~|qo=<3P*=nD z>y0`p-Ey05J&kwo+6~UMZnsJq&XvkGB+|ZN1A|+0lnbOCnzYX?070+3=5nf=W>7w1 zY6+ogS=zvP=CPrS#`PKl&CP>D`O(f*9m1YHW7}xMb3w;U?e0e9422GTCkfyQ~NlfS2 z4pxXOADGKup^XwFmuXUM@B}R2fy^R?RLcqyXDM(%pYPD7t?CH~ys|hqymXpUiJjsft6Y~@R{|1S;PauJEY%f9k)LuKq-kR-6|cPNoF#JmH}*fUeY|w&w*=R6C0u6q zx)yEPQJFJsc}{TBaZ9EK=UTT#C0Cq{kR3iztc0Y!n1$6Fk&| z^LD-)m|RCJ8J?l4cP>9MqD&x2pgSU=FBL2FXejkE&)Rc>O{jIP4BUH8PD~5a(%;F` zCZ1%jQB_EZRXZ(&ZR7+FNBwt!lqlmJBES+v6GFEeVJ1lQg@pbg04FJxFxGdm+O7sJDph^uG z06;M@R{DTuH9t>4oeI#%zLympc=~kue&FO?VhhLb3j8?d36RmCV`7>lofylL>roh% zr+;FKEd|PSistSfi=VAdI}lY?k|rF9iQfvr)yC%1BB9!Ctty;z$k*-bAL#76NFEUP zM-Rwlu)$QDP@N-WPDc4b z`huo_XbT&{5CrUsY-uKDhY2L650YKk1#g~vq@~|Qq-f~B>@tFZSC7PC9PoDq)0|jg zUUL0000p z1TZrI0B>dBl(g^pVughCAM$~14cykd=C)NhvN3>l98xFPl4n`_B=_H-`~ZNA01?pu zm;w|7M5?3(JUj;v0>_AC!VC}=@q;2K;!S{=-PxU)yZ*h|Zsjgpk|VwV>d2pHDjcW- zMFfeeIF<$+!U9<! zB}*typ`PcJdx3tJZ<5XQWVRWK@+E+w-P!Vzo1SFf|IGh*-OSs%{CRn*+i5ye|3hy_)R++3U-crUU^qBk?`j_y!cdv7aunzh&3h3)_a=x ze3F+*HuWG#24_WOC6HH>d?KgwvQJcmd^f}+0|I>`00RQ3SffPp_R5LR>2FgD>RVut zBm;dUB;?tapr_y=C0rM5>d2C*!jl=(&Rg9(E$hz{+UnEw%H|Luq3L+Bq<-lnrcR|% zI^-M}At;O-e26R~*nw*h2fy@^3~J+WVbreM=B0BT6Z?T`gxJM%qeuF^K{x(FD_4vuwJerifxNYfOZ$Bi`E z)`KJ&ycHqCoXfX#ta)XHlTKC}VY1N&(Q>GYlxo_nhsmLjDg-}zn7^t%Yx&uQk+Wn? zsh+t(raSUCQf~9fb0e7?Q5b%3FU<;ufT{uVJV0 zOe`*1O%@BVCGIkc#H^H7@l_*Lib~2qIe$5kCu`RfQ8uq!!^`O{OR)Wv(ox$Mz@c5< zZe#SFRJ2q*f%I-8%(t9o0JqJZG`MW)ZJt3 z`3|+Tzun+&pB`G7GQUJkbE*RXP?2D{LW6$a9Q6_*4L1+unMIm8Px459$&^-`hXiPO zlBuO;bbfRj5wpPu@pH&_B*_BznK$BP^L(Okx{{?%N2EyA%&}aJW*32KZeTmcYva@H zk`WCX2~AplPgTR5JmQz2X^bca3kU_>Ru}BrPHnMdrvku(X4Cf~ekWB;O+_T_*y4-4 zR#~~JDRPp(gi0&TLjtrsO(nEPOCIl?>fUMdJbHrpY0PQtdPLLZ@oQ^H(`Rp+Oi34L z!71Wvz)_;(zZlbDn5KyB_oGDQc~^VKSAo2y$MV3bTR;ztH$Qtu-cJJ zDC-|8?Cp&!&Sjy9qH^KIwqGzZx8J)_Yxr>m3;!-}2Q_7_o5^LYXTBJQHVWTKTT5D} z9YU~b)99^My{EM{EWpCHi`&^r!K-azK{mHt2J_aGjjrPxmiSk8-D|=D`wR#5w_oS^ zrW%>IO^9Kvnw^F6U2b^e(1k@5+T7MqGErjhd{HuYKZ+8hdtHdAtVN*B&VjUtqmiN$QNiScY=m2Pn29Jhrb$Wa9C5HD94=@4o?T79M{(QTlzEwm# z0ODHE<-G665(-a_ffvZiSUqG8`13-e5dp}WB3(dx4J4(|ggB=KAm=RT5~Xj5L!wQB zJtAbpp2o5dGh0N+ED&l}r)>2-qSnV(+bvgzph};xfx@5v()5he%H1PSto4fQ>1=m7#UU zkrwo}iX_Q5a|H=61wceA{~42wHMD5EO&(-a;grUgwBlC3JP-@ko6eU2&GRFCGI`xd z6R=E8BY0@iC^^lhL!WiiTVe{EH`#8m2QgOjHf;R7(!BHbjoRCfPC;Dpl&ecs`H`|x zJ?a+=`3U=XF4$+?_@wtl_fAR7h6&(|2v{&PWZutRc*T5zd~|%;pzQkgVC|3|AmWz5b;A(J|U^UeCt~N@i%e)>BFWco>=9(>L4TfxJa_l-LlF#`fTZk zHn*jgv~l`q7#|${{z9rN;x11 zFR>1Z0_oQzo(M41M*c@VKCyU_G+)Yu%2sdk-_Q?6X}FVscm4z;UtkM++n`5?3p>Hh zW4ZU?J!Ury0y{Yqfbk)3?~kHnoi<}W+#4zOC-nM}S%;C15a5Cc z!vc}R>q)dg`TP2`1Ro>^&|$)`U?9g?;Jm|Kj~!0Bs9Q6hut7fIgg=_GZejc^NRTI3 zRy4!1gzd)Sgd8ZX*+7YAeQdXT!Zc>g_U&;`*v4+%o;{8U!x-+|)5kGkxywC!8aS3r z_qr!fW5;yu9`}T4Y}oGA-?MdqEDhP>AmYtlX(mvnDdU=HMiTc;YR5^4`Q}^Ev<(*< z#By=|IDqR{gG`j`ULo1h?z@RKl#(+Li`V9%xK!Q2*ZH-uyeT{UPuGSXJ2tR%`NO3)|1W(Ns1f|-}Mce%H-e^ z8gUr#6^_!}0(Om!rjHT&Qfb;%s%COFx`+l1&%R<%n=aINioC?0@dp~(3~`3*!_|t$ zn`L-292sg12Zq*QB%o$@T@CU6Z6SBwb?D{1&qMObojZbK8?gkNvVFqg$_B!~j0uAo4GED6-*;((16 zPRP_n6B>{(fw5c(uAyOsF<+r54LFk1+^A2{PsFy}EQx4F^(;N=>^iG#p1gbv&gk=} z)F#6F2KX?Y6s|W`xb-@xPJ0B?#Fw8LRb-3ftUKA{KXj^dw2RoKiR_OoGx>?#vqFqn z$z;j!?7{OpW@janCBm}`O$a=+`7g9V2pqx~84BW*3=Krf_6s}Mdyvc7 zD{M^c9Tw*I68ZxEnF+|am*Gg*2nk_g%TMBUa*Tc%n#i;DO9J-Ih~SGL)SgNs_Y^|< zd&5LD(Cc9p20qX~BN=Nd)uB_-zdWf#QY|VA(%OKc?kH3$)r5TicC%VX>PMx_S2(Bu zOgPYoN{2Eiadi3rc9BC5P0p>v{=wvmgaZm13-C(jXJ2@&phpexNlWAoDYHehPfHCk z=3?*zDZnMrQhYKP6Ck;azy5HGK?VH0QYr9Mczhkf36Q!A2cLfa)?SW9h3F^JXQ874 zKA?Otxl{rum-jg(&ql-czs1w={un}!X+VRsq@U1Em*svcI3@(KPYF35>LscQc zkrCp$caJ)73m_=12M89cfrCd2>^~`iFJ=i`Fq%*WXbs746UraQ;8hZ;jK;Cv-x`SC zzzN2$U;%m4WN)npKsT}kqAS?~)K;o72a8=)0le%|6}8UVOT%2*5>@BMj|xrpGN1LR z%}-?V?{oA`YD=f##LRR4PJxG3qbOe>@bjn(uYNZLgGJ!)17s{MpXj5f(~UmbN$C?E zif(}yKX0MEBNP8zkf{WeLp$(?RbVQyo`>W~34PtfgumuN!{|5Q3E$G~lEB)KOC+?M z`h|AzRQ@QellsZjqPw?Gd*FZamgRc`UNA|zZqnd7%l?aGYa1s4v`s(~q0pZE(9pi) zqX!f6O*(lF`I10AUJYXJ^VhGo(J#oa)9Ig~bUdAK?l1BTfe}gujXM~t%+a=9%m>0- zK_3chV%$%K0@D}T5AYkd#Q%yb+Lq2px>X`ZJ=vkMo^X@~2R)2|Vhp5rqsFQ1UvjSL zD958!J)3mxZ2=p(0=@b<@PBoxD!&rx!N9~pfMFaMI2KcmqF7#{z8=Jbln&$oWsOE|wSQc_3r-Ob)ji19=X1fCy%&_;i+oKal0nH! zElw!VS}8{>3l#c|NkZnKjAQ4LomX}^77 zHvOOQyhvV{1dxsHTvjFX0)8qm2Z{OdsDRgdLj^0DrXWVpylRVzhgnDH2(lRP27NL@ z=0V4J6fd!;K&I%Ns8yKdP!%{oXtQ+he@@{x<4$oO_eZ(XeG4}=K`b>*uh3a(KIZ~3 zXBIELd_{$?_>Put|I`BYUvk2FNKGZZlAqf5veLYdmH8~S6QyJdJpy3tUI0$sn+l4F zph4*$qh#5}AG1wAXtumK7=CE%o9;i7>7AM@ZhETm!T}&cj+-_q^s6cf%ULmG}Wv$C<1hL7YATc+uYg zi~Nh}aFQP->;yJp?}kO_JLgZ_eRieqmcGzk)id>W|2cIFY{daVv_%TFmpM=R z5)~@_Pv7qhP0MK|9t$jD1OgzHS?l%!)djv82NXBQJ)j(=`MTS$p0WS+XwAlKgV9b3 zyJkIp?H$1aZXZ;<`ceUF4{`>>57=G(3w@Qpg;D7X+%Ebk5(9}Ywn7+?06;z-WIC?R z$-);9+7srOWfqjxdqKmfS(KgYse&vzPZc`!l)+?=S}$=u==r}`xd@?$0nj-Q2tNY? zJS->1oB&XBWtlIrsvo(9D4XSd~~?7Kzm9PEom1w$blq zAM0-ZNCEKT)LBY0luznQk3TzqHj(wd>GfTbS8dULU=h;`wi?|=AgjxrxjsmvrKLtb z3ZVcIz~f?O0PdrYq6z`rLou{%Ky$MHLq<1shLZ;Z9MLoHKmfoH5CQ-I05b$eGXMZ? zMFUetJ7F%&px{D561!#ABU``gmrrCV0J~(W9J^Vz4d%A~dzAkG2pIq(qJX;q1CJo1 zL>1T?pG^F1AOpW9K10$26A>!y?(WU+?YDbw|7~{5-fz1PEhPE-CvqV2&^#Bdt^on(d@S}7EsqKaxx=s~CWMAW$` z^xpT;Cmi~*Pj}%l^60piLvQyLg%cn9!ikehPcKEj50|E&GG%{ln&^>w*k|-RD~Llq zpFii8iY}LD;oSFBPBrS)JX6Q`E|N!?s#1xJq{#cGQbQl|M~uLFamQ|igV5#aPcQw- z9)@O>HYS8ABb_TxSH%1fses5@hyY1doIw-vIearN(N2dATR=f3Ty;SVn{zVqk;WYH zE>DRu_DG4;0o0b}Ho@=9dy&lBC@mrxrE_6!8lrkRw8*WnTl|$Kw$Z(Frz1T8cSeUN zbzO2BEUZglP_sL?*`o)C^~3de@Wu8AT)xnC!z3xuKV3W=Rn4cWn|kw4XJ99VK(AJW8LEpL}sQA#AjG%WfIHF_!en zof=DSrq695-o!J7sGRbsiaB3a>JWWNy-CgjSehdMSNxETCH$~bO92qeE$>BVh&&KW0wszq0ZYq9H$sVf zmMet`0F}cC0IBD%NYl~!$olFg1^R;Kg#CtBqQ_fmMo!Shte&B?+?3t)mu`^jna-=! zp&iJ-t!{URAKX_HPjVqU&T+hqT*!%8`IjSSbI5c%=Hcpb(BoBV)^qha56mn!@w__C zC=HOhdPP<`T@w{u~vvuQ~{+qT5Co>wgWG@ahvBpsmDWFDbr z;=Z3$qprL!W$eT7VhA13lko^eGyh}UT2=8=Y*fdOu}?Mba%7h}#e;q87}s^_E{wIP zTQSwwuDPgFhhwH*oyd~A9q>iV2(E|3RjSvP<--b`&Ly8cDQCuj^SDi7JRm>?dDmFH zPSjOZuf=u-^bBDMWXxa|bWSjGt`t7Q^e_}d2atpvq#7O-p+L|4r@_bk8yK>`IIgWd zZcl=nEUyNA-}M`e1O23OL_qFW;5az#HSyX{hg!xhQ|M!um?QW$-v>kQ9nh0@C^0$3 zI}K28fIuAu_SL-e2JQQjC)8A$S&&2}pvMx-gJ<4#D$2*D&vQ=_uB8X#m1ReOqm*o?HJ$yz0 z=nn}BwGG_A^o5MT^^Gjx`oe8zG!N(1ZhOG4WjQ0H-wm0GO5W3?{n9_chI1_HH?O|b zyDmr&&XZ4tM&T@WMk>VF>YxdgahFpqNz$#~92Z!Ajv>HK#r$dxq@DU*0nH(RrRP|~ z!giV+R1}Q=Xz<0<-PB1A=YniU_yIp-e91@kr%vO}%%`DmjteX<#vy=>ed|yBeAdlw ztExkQ7y3B~0c*yC?VX}|#TSjS@3k+JGVD8Tj`2Z$4)Vd^7TrFz<8jX%|5)FS7r=gg z0q?1pXDR`NQi(%Tk486$f>+^)}uisTAx)%+(JBaH?_lH~< z(QSG|AM!auM_at{06&T-Ru?+7SV{M%5QL`nD;1&@pz})#on(K%A{d$U^1xFuukNZq z<~Qb5C%2-utJ~4xgP8bt2Pfa1 zX;tD$1E%+EF(uhYlI*$k`1Y4rKwU$qD zxXe_?J@}U-H)C|6)S4ZDmP+>llx-_Q-_P{9^Zw&Pvi(0gJJUPF~AF(hod>{t{D>L^kL zhmrDy1@GevGqC-p%KC@?6Nbx=Owen@Pwfb$oS{}7gJT9PwmUg=* zcWCF2u+%!XC1S2&V5;>VbObFt>KU3m>%#Z@$?7E*Lrnc@bZ+h7;9o2xZ`l&WR@L?2 z(PdO(6F4>PmJ@H##6#z6WQ4OF$doCrqW>_oM(a z1U7i^?O*V3N8hJsUUiDN0Ti+@3{*YwJ?Ro);GO9xOhX;SwDfUV$~niYp-Jb+oYPMK zGkTqDmXzwCa095qgsP$&4rL8(YvupJ6pONaVBVtLBa{N5h=J|?!9@T-!}baRcl|Vg zT5{S!u9;S@*|ia}dTP1!+N0cIs~S7o?T1!IdO?Y|RLRFGq%ZuVFb^DpJ354pZU}I! zg~Rq~ONadcr$AW0sFl<=;SQ_HiF33o8V77xZ+EyH8(+nC5Q+%mBYu}rqiEb}arEwgfGG2bv2+G?xk@2hOPV=9YGYz&fdwP9V4 z67CH$!dyjW*sEk}ZC9{6l-YiWqrO|60#_WB0LZvI04Nm z%!jtiyU(`8(Iz(6I%pY4b_(3yT`K3)pcFycCQQ4^L)E%V{SI{6(a%T_4jh!60yGAm zD2C0Pxn6 z-=GHoW=Jsr8P*U0hIT(YsmN7A)Z(tF#AAb*c*FqH&v-3S@7a~Ip~rg9Jd|KbhdwKf z)CUsvdatPpY~>xA&KW+OD*+CvPJr<4@!xYYZ*$i%H5N1B^Ns{&jnD_mU9^rzP zsrKB{erA+@9pQ_B5}+iUVX%sHhEof>0AH9)~=<|MefYHxN7qhohU&0#yH<;W!b z{3##(=aCI@1NWGz{ECGEG~5Jt>(5NK)3(elc*}2@Ei-BIrEr-`7$x%fV+a61f+7e2 zy;)33b8?Q(*ut)k*~Y^Uma@8%j29loH2zXt`)|cZ0dLS`*X@IDjS8I`Lc|BQh(}_@ zmktFLwOMt{#8R_U3jod$0JKz0Kb?ujN)XvA6FdeB2UD@AjfEv6u?b4#3XRz;kuuTK z$d?YABP^g85h}5a4w3N4QO;zn$RZ`m0hD}=#cX(gka8`BxCvX{!s3O>_;aN4n?|$8 zfU+o%j3s@5R385hSkqKO5~=s5S66_}6%+>Y@E4TMCa)PfVN;IC5osVx1AG0V001oz zOy(b{5B3@v$#e%Jkl;WTg`r5r6Su?N*gYSH~nQ3Gbi$|Nt zj4!*1;z@OYd4v{YS{S~6xN(mF)#25kxK#L1M98)rf!Bl68b;%Dkt2M@-H?B4CtNRS z1=|v%0xBy{`dTIJVtZ+#;(ju_1}b@*Zam5#7Ne zEDDQJAa?TP@q#~(wsn8@QkXr!Or18tmF9kep%KVCeFmN>!$5?Mloq)-4R zOsN0>5E+n+0RX$1Yn8QCFE$Jz1|aS3_X6E>)yir86ln6@_e{FrTYo8S+HDgCNoIT| zo*B=K^S_(t>rOl(_}EGN0(?XN+q9LhnY>3fv}upYe=17da-t<`7zq{89!j?UG2)!* zc0%8s|NqnW0_{_x8pNkZ5;K5}ya6wh?YJiL<>q48G%&8+>@+}myQFtmMc>vF_xnw{ z?=JhgY11n^rXnvVPT*MWmXpWhX~-8V5k!?^{#yMt9*#SVvi~TG9ADplCVcFX4Yr*% z3@X$C;2sakRhZafRNNucw(5ckZ6Ja@5ZFa!_@myWY{QQg&B3}ZX$vdtgMW4kFOYtR zx0aTpR9T|0h^!Nc@kl6a(KJM?WJqL5+@S$LW*}@G}VJonW1h_ z^o~RX#};yfC%H=D?5G;mnvEsE9#C zxNIgl-*ucKIy}A?`@YpT*JmsR9t`+nC0_BuH^!q;LafhRywF1zRSX!&q){wh->n%w z0>pD@K$$V>pv}TgcNZeO@b0o-5BzHTiAMs)97Vx|j48RM?kUQoL|m^Wexe#qrL<`A ztNEhG%ZQW7GGos3>s(FgyQ|qPp*Cf0aUTVv#yhZ^D zSaBgYI;HLl&!an)4(mWgi%CI?k6H(_-4~M=>VlpV*aej|iu2?!HD~71`T}$7m(U5z zXKF>dC@8NxfhpZWPo0iqCFbBecSCsGG2D6N8AJB+4Y_{_##~^~m&I@>@C6XZh4C~xvw*sjCR+#J32KvC4)^bZT?&^DEC6%Tuz=|RJ3)y zxoBx-6dB!473^+D)jMxX%Wa<%eU8hI4Cdve53CSK00Xc+-&RF!Y2(d$_D^n zEFoarvB$Y6=>)(cwP!g%$JjAt; z8tdc>>B;XZV%^tW;Xy?JA)#3ED$uunud}0Yt@cf+mzKGf&5yTo%Q3xnEGkwwbRmuF zugnpz*t5*>?4kf41hi8c_n9)ia{GNws?;daUA!gNFzJ=OAotp*9NZNvEZy65c0X!L z-Yr%*I?QKU55b=vfYh_&E zQm*j;_Xi!L^IrTK<;z+wSX!+3>vBu_g&2A-SQM!E>Ov{iV|2PbgF@pb?YT-0VAk%i zmQncH+PYqpjdyllXlBclWI@r4m=46HCeE_@m{eoN0QDGZV$b%y2IJdIIGh_z)=I(P zQ|`)<%HLb=(ww7$K~1X`u=N*y|6V>iUPJ={Bk>AQ)Svy1x^vIpC!GSjsGjF;DpKdW zR7Cu7k|>{2aN{aoEe~d#3B?9=J}G zqwkByQ|M77SM_;eFv5TgHpXND$eTprm+1NYy$n(v3s+0wo7~8gma_3EN(uB_%|tzP zo~S?aZxR4Qcwe_)oK(-JB~Y{R7F5I+HlKkDNxAe(lcFU*J1G$piG1S3d*7-qISQe6 zWodCI1*6`kvt4aV#J)n6NA-DeEJCn@pBC^0ei&#o|8CehYgF!Y7So(GA%SI}@j_v6Pmnx9?!}Bv16>6% z#MrXS);(YSx_hT(9v!{=_#{%F;`TD}%sfS<8mcsl0hxH*?&QNI8cp zCLdGIGzEX)Faji)ivfKf+u(J2v9a&0npPMe(Om_>5zPXbS~}QJ3xj%lf}l8iMCmk zn6sBlom1OvWWh(m>cT_oF$f3!OlqkrS%ZS#Q%Ex#S&+h8sTU>I$<_oS9op?^nw(S^2zwj z30lw`z=lnde^??vxL412EF%#BGUx$Nub#3V5w8dEN(dZgsbOZI(Ggdn;G0$d6RTLD zyhjdWUKcbX;}(;8%^x}TTx!bm#C!n!&?i7negtQd)x$~ul7GSnYg@2f6hOe*Gl8k~ zR|~lhY_{dK+(YN|V~hzJaI^#!I^O=yBs{%wI?={N%7O)j%fgZdh=cZc9SVQJ8*8bF z{kRM|MKN8lFeVGY)2zRYbL#fa>JQwl+M{=^?Pz=~fsQlR^EQUiy;QQFEm7sQE0QfG8s1A4Wkb zEj&o_XXm$48AGMI1RR_y3ujL*_D%id;5AOgb>So87$CaA(w~j}z>AO5+!T%lj`3L# zPA_zGHUC)DeKacALREC_AWQGNFb`hyOH|jUjV=dddwdU!9I+TL zG7eN#2{~ZZQPAgzkx20RlhtF3mk)v)eCfp4TNmQp1*Olu;PRy!ALo} z*-@tQC@`Th0KFB}7 z?rB86Q46AW;8nLT*KrTPC3gXoe;2z}4oe)y!Iq2YQXUr%2k1TS!7RO8@jo+Z4*f0y zGsUiDTwvY=AkKOO5cR`zDI+-qH4%3Qyn3qTJdTshM|NylST;@H-^O(sT~~G`iNAT zjlq%FDu8%FD9D*@imO96l}%vKotNJ24`hLTXyCGP?c_)rWbp`=RO#2$p9F_eaqAKn^G zP}{(URJOG-WUa{9L^9f;9!jC4O4{Td?xB!Gg%TyBbT+eWwnCP5sKlW2VM83(H4t*` zTfv-L=y{QlPmZRr8KP)*?QBHELPSSefs5NhWVWJNfYnSZA!5T=FZZKb@~o%`hm+AH zGUwHin`^iTa-SM9bEQG>j#eLTGEU*BO(aR48hnMaIyc#a%lu`_#yW*Suj=1LF?gne zlG*b<$ft**qQ|-TE5o__zi!bO078O@5QEI?D>j8pJPLQcMDqbNrhK-c2@fj3yI_0hz~x`olO>~0xRSkQ!{E#TBa=5N$R&5P&w@kw!s1cpM0;L7Jf9tUK$Dm{kM zb2_<0E=(=#&U%RZtQ$KQYedaK_n@(pF@g}_Xuu9CbqGe}rLFfu0?z^~;8E-VMHqqu zr~@*2sF)Z5E1e)5DC<7H4WEuhL`jWR;J}IHy>pB5jrQQ8We`Y@p)aXn3f^p1{wt2e zJ*zgv0R#mXsD=4#(`0(k9(U@ypgaj$@Vo&0%oe7+ks!Vf7)_4Qd+)3gCE;M1?>I)A zT-I0yq|8W+Mv4SET0BA=_KPKlU>6Ir=ti0%A}e)Lg{AGqk7W&*2LBcr&Mla0&9*SMiZRJeA0_L>kiie`ApjkuK%8BJ&G!b2^Y%nboLfJ2t(aP))mIL=jvPQrM z1R_2OjrQ1ZAvVGn|3O5u@1&8!nd=hzVpZr{(dw=!S#R_6?EmdK&3t+;U;)O z<~WToxivaS?L9>`-CEkuZcSSE?4@4*;wS;%y%l~2<5uT$e8C~YX2IL0C!-z?EZ)jU z2^~5Uv>6dw1qj)d#+5HV7CKild--9U7R~(2sC#;=ay&-QhqxK&AFl+}PHODm_bCkX z(&}Ne>p9veLQc0LvZ{}&6?q0ODiU!m0N$dEAR;c^=~ElW7TUM**044@gmH|JF6hE> z7kt#PWrdMqgKOY4%+-1(xoOL!Bnkd-kimcuZc2dALjwnGM)es^Cg&S5E7N^HGdc~o zjZ{8!L(!f^8B{sHQrG>W?Eg*q>qM?|FWf|!I54v-{WO6b>HSBnb|qlSa85x2Xv#4I zV%~iIU#YJR69xldV~z{J^bd=K8_w$Ie-zsB9hBSV6t^#7BT$`~4@m!@%=~#LWIp2P zU}8s^a3Ohx@ycuzwWu*|pLRPS)Nz-S(5&SY!+1o;N?bVo_# z&{f^%y(0JA)kZxh?k4$nEsVFEMrILQL`=x)ZG>04NFni2zA?zBKhDpay)hpg^QeW% z02~ky0{{R3LsT#$000g};C{m1^|dgz>c5*!uJVkKn?gH;>(CH!pHDr36;+v&j^kQdt>hQ@AkHRx!lOQ>E#a) zV9TIS8bSj^iGZ;cwbfQ@$tp}D1Jl3_zt8>m07Kx) zPiAJCRaO}d68cf*!lR#|e3th8o0&s1gfid#Lj!j<-f{o`ZvWrD+NkQqk=D|zN;FZpexG7Tc!V8O#cpaG*o^0;$zX1tVQxh?CI01BOfG=ZxS(z`6Z zbHmIiC-BQn6cVr@C`K$P;D7fEI76o+z=_!E0pnLueK+?n&F#9LEF76h9bDlYA|S#s zp)jLSH?&jpgNZ!y5nsb$ln7SRPN{P>kWA`=OKN&1E4hxINh&eQ(o;x8A5@K4bqHo? zrCNb3baAQdic4>2$5MMaNMuDhg#=N_a7BqA=L^eS{E)%zjj(rMd_D@)Ygp7Y7d_MyFZA87mK2$jYsv$`5J910rQXH(OO@5ocZ_1}(l~;X#WCR@ zqfs%SVy6k)t^tJvtCC3LtuChJqIRl_l4`oEaDC21v&E0IO6fBxWFhLRF4CDx>qWh& zFxeWHV8JtY+1=)5c{5|c|7qt`A-)}5#O!%LIr$cn+Jn9M93@2sxQ8L~M)~=h|a}2|Z&G6HN7t3)i`sGCc)E^=q5z zrp&pXo@uX&?sg|w+L{-#?6Wg@^xpY@K_^Mq*pT~LxHMBWfp#3&!KaUNXld#_!ggmu zOG@H;`r}XeD--Fb)9UCAeN$H95G5kfmvA|Spv8WlQZXCiW9onU*9>{=!NJN1EC-uk zpY|Z>ih7f$9??J2Qcngp5A2*T>pkU!^>j0dd1=l^|>)sjn(ay_BSs zDP^TTsx4VkSW2Z-O0iN#>XX}2p~bq2ZhVX1-QLtuG$&;n;EeAMIn{X+gX&F_R44%Ygx~{X zFrNI!2ph_0XO|?Zj)`5E-k?5jmc!%}L2PAvPu8DIS-cuE(({-`x%RFUN13HR?>s#g zy*of3Avn+&jppCnVAH7&Oxod)d_-}(`rvcwZ&<2M`kZ~je`=NpU$P_EEL9|aN(cJ& zX$&n>LW9^-?1_DBFVz;Q^rF)8 z&STwOpPe?B`G1a0QD*T=!T})gM+0nNh1#RfB4=K(jz*RcG8j1n-&-}KdMhmJdn+SL z#CoUUnCTv-*Mc;;rVXyS86pOgcvdMdDiQ zeNOra))Z7u>WlzkIF7HBsm%QIsCDa?4O5sI2%I>UiCVhM_|xb!oN&JHoMHZUT)BYJ z7qzmx8?18I1T~!YM{af!IzPAL2rG9Ds0EGzeaUpzu1;PA7qunKqvpT@XYVbHo{B!E zAK85`F-)>uOS#7_kju(m5?Cd-7Et>~%MUHQn5efxaV<)g;}jkw1!7CJ84GC3Bmx$3 zm&Z2K+wj~r3^Z;h{>C&xs7vC_z`)lj8DX$1A&AR!(}(8xT4W! z+%LkpI_e+8l_N8xu9aYcaFqiLyz7j180u9#|B&AePR2j?kmxvY86o-rVMLN8J*WMZ z2i4ar8Py-sVnj9pkYDX)<{>U(WQyd2nMKBo6Fx8r`QB!0>)#^z1RDWj-v#f{ke0~r zD1?)766qA+2ow#Ma<_wcNMfCR$v02I*S1SPN{34T+jXM4MRzWj$BXXNEwb!Ic+Gd@#%{OzX(}>%uV4k30l)~q>;oZB z-7~E2-C&w_ov4D228a7>HN|@U@w_sw+M8$1yqAm?!f0?{EX4$m9;QE6jz$#U=aJCa zq0e_ZqoHdDf=)#7f?_a@X=>2M@7^;*Lq{xt02*MB0W$xXHKrmT&u3`zKwbyasQ+VY zhOLY)&gn*7O00T+r_;K{_X0L<369LQ0I3|G68|el{UMLo2D47Y$|TB+sS?TrA}{C! zO+3S$rW*(<<$gqJNq*uy5g^}NFl47A(7kt_-Ov7IgBjNaIYFM_d+Yr|NgN9nAvC6d z91iB#Lx=cQZ)w)I!P|CoV!+IZB?nJ1#k*Tml5M^mogu=TQ{M^97tQ6(K*8bn&GMg| zh__Jc3&o@15fPBYdL(XX0D$o?grrNQI$8$)_97iys5J27p~cg1I*{`^BKlI)33fOp z`R5I3D5cTEIVofzIJOaKaKb^WyVuKlW^cD3WcAhM=%IP8JrgIuT&-7bA*w!3u|q?4tdspzy+Zpzz<;ab#Z*?eqP72*AhR0O$G1OFo4oI>5)d2Ex>c=G4d^ z_9nv49^mF217WFY@`vsTnbQvbRAwR3TcV;tg$0{0I8rAQ=I^noyKTOK-^^wA7P%?x zr6hITlET&34t?+dI3$k9148*ADAYjnw#Hm$3+KE0Lk_UI>w*-8gNzV9QQ83JwtMr2 zB_RaYGD^>YGn)-nN1LI8I75D`2nhJ5ArO0Yzi}O2e8+eA_&2u5U49Y{9h&}5gDeqg z3lv0%YJ%e&3HRd?Re?^0V(r*d{dC(Ls6P`Q(2EM%l!#L(u23m7bgD5P2mrlV&AM0(To)^$ z>~fDpQAt{Heo$)PHy~^j@ay{vEWL=l~&Q zNMvh*v4sgL9kyjc1hlRG%dZjNaJ+aDK;T3PBzN<1AZK$jy5QCpASiB{3xchuElVMH zR^^nttLpjP^Eh?}wfVYIrSZE{$-KEsMS6KDODU%Ck%u7kq-!u_(m6P?=_j9-7drLC zLsg&v$f^Z?xDoD(S5Em9F)~JsNKLYF!w&acXz*AAQ*an|hR=X*z#_jwWa(wuN)_8t zJ=`QDs}h`*7p!Cq@+0!G#B~0|Y->^=LS#wFBB0`U<*k{%E1uKKZO64A={7Z$6q8CLkN)QQ5cb1;sRCfES;5v zw#Jef`7Cv0k^~aR1_dL46%amL)MCVuV*mV$zS&55Dw)eOLBc%}{tIu=V&Re`@TG{o zcY!GQ2paoeWk^g#rA%7WgG;Ac9>bOmrGx8{_x(p|lQJKoXG@pnGKTEt=Zy$&*5`Ad^>TwwdxY~Vm5liSl&!DYRB07ocZ7}jSMLw2yi?2Uh}wWt-hRWTBj3mF=u z0>+=TYlubZ)b_?KGch=FMa{c3$yqdekg#L;jbJM{qNg?`sFALm=pikdu&41sVn6Id zSzeimTPVmX#D_4Of*)}!&gawbSkWk0C;~3ym;yBJN0$2?7>HU-Vz5MICk36wHc3{P zrhdvYY@0-sz{4COEJQd$M9u)+<@h>92-b=B#3J^dI3*kDVxKq%s*bUgPcX+S z3J{Ko8Wa!Ot1uxjG%2=55`dCn{$Jr`ZL+n9T@{>RY}mE$^jYaDEy5>7Bp@b3`<}#} zO$Tai^`=u~{Mq-2a%?^XpOg!Nqr2sRX8V`>Gg*iypx{?whSLg10f|FS%O^8!kks;- zvi&Ej&{A}u1PdOaa%PaWvwi(f&g8D35>)OpLXaPwP12xlKL5wlEE3-Z*f@eu_f3hm zP?z321Zg`057{bU>b>oB1HxE<7Jmhl#1~-Q{R&!&+U9;pp#qEM08AW50E!(|I;hEs z)_cSq02(CNuhZ^IplxXi2_e1ULVyzd=&(R{XxD0RT4MhiPy$uSe)M?+L@8G!0BlD*#`{=HTds4VZztdYWQ} z;UIy@I1@Xw|?_g-jQ zk7(?5Cj!OpMThLV1MO}RBiF$q>~<|GaCf@XDdNl$%NL%=^^lNRkeE&&U; zuO1j2kboG8AmO60;>c|TzND0V!*pPU_?v6uFquX7{*LJJv{yoad^SyUOt4qT?zVbqJQv`0<5V#_qtU1fA_*~0ALUh0{{R3 zGgL4_000g}Z`0=XUpY@AjG7+;Xzqh|B$e6p(!V3@12^ z1D*gyNc_a19H6jR6yq!naiA|^*b))C0#_(O7b;=I000>PnwbDNw=27LbzRny+MJ@M zA+GP}_ge0L`|g&t)5tVx0>leRUDDl^eYaV+gIvZ>Krp}$FfRhZ4DkO2LH^8o_3gPi zeaRDVOUph(bD~ZBBKIn7!v4cNX1FoMaTy;bMWiK_WCJtI^2GnYxBsW!R+DpThHorS zJ!PaKspWo=8hsCZL>=UloKYc?n|a#&)Y+JUviQETk-7X($ro>sZ=Rv7{>>C#A%ES2t+cz@63@4r!LUunS_}nT8lp^79&okr6yV0`LQ~J>1Yv0Y~qQh zFw8J73X4O89*`KHmr-LowHNr%|f3Xl2vSx?S z?qq2vb8Ok~r?j>^b}+bGteLqx_E+x8kF^FD%Z#=uaJGBBip%aU&K!(hBV#9<*KY;! zO6LYHOmK5T4i6P+Ol}^`(ZWPJqcAroI|fE-WL9OA=j}(+C7u}A@(V!O-`k&E2-Ot+ zj6;MZ3@)UdM6Q&TD4Ao_iO46x3EUHb$6zmwiAn#KghxKW*KVIvsGpD3{lr5L0&K6a z)5-<#D}H=%u+JEe29WdwZshS{;n9MdQdz+pn+@5f0HfT(ee!FN=25lZno{&a`ONay z&Cng@oerHgvIH^K8!I^W3r#v6z$(M)yCj76(lRZI91&CQe>Bnjhw-RJjconq$++-w zx2on*03_moVF=3RD zCuIZ95T5-6lb&$*!RMdE7xQ8$^5AY`>UZ{Yd|Z+#tTaI_*7IqEGZ-l+CrZoEnUz}~ zwVdpUay#}!xt}*jdYnhUJ}Akd!p!~imVxX3^k2V+6R+-lUQ+N+l!H`&7#N z+#L1w#syC|i(QDHg{H(gmi6+un|2qs0hLWft0|o$_hqjX{;&xl z1@aC`<${B!DCx7IsL(EdOfRi>a!^SSUT<5dbusfqJ`gG`B#L%_y>bX?mI-pW4R~t+ zHQFZ??QN8%-|E1hz>^{52nsP8cWZ>~I%V1XMb5FS>k&an${`d|Hc)kZT>%58N9-|@ zMmIxADc!+6*nLXU;Tn_)!#!dV8a^j_TEBwptBaKCb&|jV2{XWab6o|zWSF_3$}gpv z7SM$$7tynP*0YH^jV&2=k0o?>%#V}O{Ls7G^^!t6*sKnBI7JX}$GQ>Lh;^r!?otC+splgyaqa;0?meUfE?{nKG0?Qces(d9T5WxbZ zGSR+P$sXu6<*Q!&5}BtF21FB zZY~K5Wj!2=vYLvLO|QV!AKJWJM13a7d_R0w+Ejr>CtpaoJ-JJfb$ z4Q)H2oz+LQ^LvspSK~vW0&@H2c?J*+AsHAD8Z8(FsLsSrcERIC7QFiUI4TdlJS?G0 z?k>L`r%jGNota`-`T8IU#yhEgs=pT&TF}yJCFaOG5(MI<83H_Z+YH(8uf3y9_=?Ql z*!m@Tj&&4hy+>X_S}!vo}T3TV*E;+1xu=_KV? zwqk4ro99xdx7eRhcV7%@zP?#aV`u^|e`MQ?2Kag$*7th1?Ks$5P|Q0u3L4-I*kiR& z?0CgFSotsg%vQ#@&BaNhO!K22mgoVmlKroy3k!Y?Y%G9g8Cz*Nu2ab-6nef~x(@TD z6+G&Eoee2{pY3XYEprSg7Bmo;WiwO5bVyRKdaWm}&lVQBz*T0sbb6Cs^jMpoXjyS@ zu+|2DwKRDYMI=4(84-_sByT`AQ}mg%Xmjlp7!a0<^0iz;Z8iotAURstIaUavW?C>l zte^QoB&kVB8QY99yJ#D=s=w3;GaYH!3st*XqYgJa+Hng%coD`=UdHw#9WpUs;^ou# zH;=v_e!QO?KBzJ|u^pRZ+ao?EEICyAq-P|a-HIp%?t~VL6YF0%Kvq(lPuk^P5z0mRJ(I(e(zU{q$oo)AT@=3PI%q992T zr-Z3<){we(|M=DcLr(&pgBTM54Df3VEB|FdNl*~8wI$tpF{-wDIQrUuBx)sLGsquV z8aN;zDtJBxBd_!&68+997u*(E7`7Lgytd%|L3*TV8QjKL9>Zg&0jO*1l?sB}h~+D6 zrr1*TNz+bHccqDs0|PjDFxa+No8<5yhq<*LdrBjq7(h-pkR!Jkh;>){{l+#uAJZBm zrexET21kt(i+WcSNn-9dVp5ABL~b@e9xQPk^LN`=#vkepkV zh&OdG5;vgk1Ovdl>~g`qwX9uh44|wMgze>}Mzxvj(q9A=F_QzCSpSRc{QpuKFt-<_ zvhHfT*W<{b0Tq$bK=9zw%|}_ z1Qjuo!3v*d-B;O!{i2@O`Qg0c1JqcNPxzpoKFL~?dTATq0`m4HJp;OTL>Ak z6#`Z)!bP=it&ihBPaL|zP}qy1_#H7`002f@TP;L*S5E*WC|0sh>iGYV1ngBg#~>NA zg?gFlKo*g$y(+$H_P3jPAPZZ-06uMC&+EG1Pzd(07gpw>vC1+{q()PLWgGK zI0w$j8vqq74@Ca;?A}FyHKk)h4g_$34gSFkVo+F)aw^6Wf;8|X0v$oPL7`z&xj*>i zQb`P}YzO+tI}jMaSs@?c2MYbXPZ-_Nh^zU(pLovQoYNtcfXN}^CqIeb5Z(@My;Dr;}Q=b&Q)=8(Yf=pZiMr0xCiZB~_@%sw|Qj6+J4KF#v4 zYPi2UAzRx+UNR3(!}HidUmKEY_hx96ubs%Qo1dH8&+uk=iPv>Hq&+hU5-{pX0#rSb zbm&qNFC}J`C3N;$vMkGBda;4y;+tarPj=!jYQ+5|O<2EZ1Jfd97yCfXqQ9*1;Fq7e zz09PrO9V3J(792%*WG_-mXf1*!0S*a$t$=gkT#x~pnGGhm7RP+?(XYK$og4tolHEQmi;$F32Q%0Qe6GoW`8`JOoM7?Etq4^hb) zWT21yRDgy23jjJSj}5H2Mk0ia4WvOr@`Ad|`@-7n>ivxXyw;4fZ;o*g!%}LB0lH^h ziOCBsh)v>gO!Z;kEG_qo7pK@%;K;tDDpSN%=>_MR=RuZ{95)a9Q>BJDnvVEinBwDr zpoHjeX<>9X9BDDx_=Q0jD@63}wdCt`l)_0`8FY9`X?}mDM5SIt^)}~Vw zj!nuHk#=7wgpo%SM`Kb{h|D=(hS5$ceD*!7-fBohVyrLtdSL%sc7{yPkypGVn3JR4&O_aZ~7H+nkD-e+O_ zwt6E=>w@s&$*JvIlpo)`aOB5O= zLn=w9%u+9s!oVR4qp?z4aN<*WLd>ybhI)lUf!ptaDNn#gakfyh?-yQSZ%CeFZCJO_ zGc4TYEfF@h@e*9{Iy3`$pJ8n{7CYMH$d>Kqrc=xpV5XJI*ea=2i4S?h1^ju0`Zx0W z-S7Wuya7!x<&5}Nsdp!?tYIOZ<7tpByJ;hQOC*Cw)G&N|Uig=-QeB`0Tq`uBg_BtN z3s~7fD;J}ud}$Y4SCnk*ij6Z{@*}kACY!x6+OOSFExAl0vCP(bV@)7`gK&ShZ;|+k zgRz^J6=i~TPds>${6Jwz2q3A6Q?UCF$TJhast9TP?j8CbR=(g65D)?Y002Wo zFf#xEZ)L!gwBN9r%nW%q=01SY*lDti+e)OkmX?~>0bJxrsj2jSdg%Vo~$wGHJ&qeXy_meS| z(KBn-_x(8OI_wbHffmFS!fUa=d8`Z`ng|=m%zN0b!(3&JDr1KlQ9Dp088NM!$=VQ$ z6@%`9Xn#r9Uf|)i{@VVwlQ<)F5+U4Gut^cygT{DIN)ZVo#$w{Ynf)W%-d(_>NUf!Fat!o)ss3Hs92RH`AkWE5KzMho zsAsQ023zK;%K$>#%hti#UymX+=+=8OEa|0pN%>$1NstMenJ{XOv`>bQ8 z@|NN(&{hkyQk(zNoga=wnd`wc?6_&71_C=(ZeYpHBj!xh)@NyF)R{Jo2*DW9cdD@_ zpDHL=goRV%AQniE1apW@F2OMIzd0{sL_N3pELC>&QdZRSvrkfWch9b6o|k^2s#|@Q zRX4;k^#qA00%ftKOhk2dZ(NCJ%!DkqHlK(wOqgQJywBab)kQ?;-mjSH4y6K2MqsAP zp`txNZFbL@1dYUX(8dwvwt_yVdVu3=yd3oeD>Db5$;j7h6ol#)Jw_xzX6oTFR+339 zv;(RBLxhy3jlXtU*(I^^tPG{;{46_Nz7opjU0$U$i$7wg^HHjZ<*`aaWV74&mRJ2q zW-im?ZxQq86pdXEHky0wwsW`#&^2NlEw8%N<*!b4{;RJpi972h6^^T?;A=*00(nMe zUIl)!>UUipWaF>}Xnp4y+8V?a`|Z2ej6Q-GR|Z~(d4_~wOkg`#o>SHP$49`P0oxjK z2`Dd_stxm$@U~~f?R(&F0grPvz~uGA$?MvEeF#nY46lseT#tJ50zq@VKX(-#!qY@5 zsJb``Rl7(*wa@9CGQCTdEiqXnsSB}jb~|DjP&?=2y~W2$e6oq#5%nXtGwI+P&-t#W zPr`gnGW;jTX9)nzzAABcuh~OuhibLdYmW{_U9F(7SR0v!9&0e$)e4u}Z+9r)q?18T zQ=>)(6lsIeRoWvt(tk|b@cMwwirky$EJF1f#?4N4VDv@jK?^4PJFLp^5G-XulUCY9 z(wzlCNJOTwq@v;z*P}!%2_wc_-oPsQeLCJcLpj*Wa0nI2LXaTHQPxHXk**rO4YbvW zX}DLNa;8~pW1@1_5=)7)<^mN}nhmFRb-t$nXF!<0zCg1`4Is}*OM=Kj>;@OZ+DGvm zmJvX>fblkRngP~!GqXuS9x@}D;@7O>fv4WRa*eHsWYAmVd2QAH>a}!zJG~=B{pNXU zEX*rlH23TPTXBg<7|h(C3Tt>o>vrvpVG!YTX%$xWIQADi$55ToiE0>Fcs>=KmnMlZ z=pwwk1F*%nMm#EPlE(8yNLsx-aRPd(e&PCeAj zs(SjdqWGeW`ouG4F#4{c2I1|#*2^(h5jfQMn4wZrIle@yvFD~h zzI*B)z55={ll0ggb_?32Hz^tsg6ffP?|yC(`sZU(@9zk<5^#FvV5jR@r(Po@WP9d` z>5`cje`@u%eeHckjL-1`t%Ny=fV((Psb`dyR+^eqRJzj2m-%<#UL!1lA{XP*X)~5l zt-1tAn?3bth^zAXqM+MRifR~Gh`tt?ZQhR=CKROf1PA4oPC%hK84{hB&eA!l>m{mO zQ>Q|5IHy)x+sn>VQEkMV9*vJnS6cPikr%t(rygC^fr_C`Lob2iB~(_RVmi-fD1qFZ zg+UHaYX~B%+mmryY1bY9ITxeC>Bj7_(O{%E##89${k!YEJEr;SYIHf735_~Ur_qZa z@Yzs$X#2{4rW8RiVjPlgZ1a$jM=IiY1s8GXfH2!o^rp@E;5yGNHgxYsYYiQ!FTYdzrsOex}W%x;|i`N@&~9PL z=r1ZV94F9}FdEQJM!`;SN7^HSPOh=0D0HbBfCt`->=gvOv2PP6M3*vZx-n2T0s^Nc z5a4Qu7Du0olE|wXj}{dRZdtU#1{C<*AdXw)@|}+Gg-q719R;65+f<^Gdot;?PURHV zNvNVVkH;_n8B#e)>I>0PqzM-cPK=B3AOO()moFt!a#H;7mzSNcstdeOh5J_(;sS}f z=nz6Fi4evri#m#OZ3K=m8S3^XrJ4kqhF}xviaHXs>UxG@T{yoazK~|gzpy#UFZNy6 zM1qzUqOJ;&ghFee_7g=Qop#E644A==p78|}|!%&=sXQ7BkFh06niO-rk- z&#V|WGlQbl2CPtX`r&O{$5S*QkN9~Cw%eA*I)p+z>LO~~dF#a*Vk0mOM3G$=qZ;&I z%9NG0zrK{9PJ%{CtN~tUx#XpmAzzwqB1fWAT}oqAiWi5!ga_urPCwP`bE}G!#}%|4 zL17V|1VoUq)6Y0c_flk;3j|OZg9K!hLBYI$ypz0JRttkHC{)puKN5_dr60{leWSxL zZD_)4sUr%d3{12-jNF%ya~ML>dj%CU@N$+E`A*0ipYt1k!=)S6F#BFkejqB& zT_W`a<3adOmkWja(eW~K;`1{D%5^uab_D87+9>7&$-EvU=&$aRwnZMd>qUoGCx&Z? zj}=4+0;}4xSa3c>pOQJPWZn+YR6!OQXczK1XokO;=}J>x;q*R;gTRF02!Dt z0Q&p)_8eNI7LkfIVo)?0i=wOeeMbmYxu9;!s@+_5!61xX)QF@OHVMK;$Jq{bsvZ ze9qjNyk-E(?1jKfPMGP_#EvTg zq&L2Hy5HmMD7Ms|3A2O9k?6s|?32Bvz>+8rIZ4MfVlsxG2#IJ?kH;xXi$1tDTE%yO zMw0v@X1bq}DFB?s!3W$wDY1@Fj_+$M&@sS1aBAO^?;A&xulGc=lyP~LT6rC%L6gHT z%X9=;iME;#{GuTc_o6$TeCFZiOe(d*G=zjkQsmJ4*Fq|nN9B+Iq zx?xu_l1nI9E-5t)W_t_1oYM>y@iL050VGT^zM=;2k$8;s9fApSTJHnyQ-zMK{b!vr zY$jARr%=x7ebcSG&&Fx+o7=?0_L>o2gN{`a2AWlw1Ec?scolkdN~YaMc#$A@iO0UE z3TiT#_Rv(vz2ap~vX=<@4WW-L)ysQ1=;_9k#oZIXK6*0&om56e-rWeLk z@j=OjeXOKQ8Ja`t@8~pWv+=T5<0ZrMWL;sJJM7;@}_~7JI)m0P4v2?E@SO+#-`I2$Fklyp^`UP5k=iy zcB;iBv3E^FcfAZVHG3T9B=@36<)mZi7wF;Bq}z97>@lfI;kJV=`1~zOOb)FN42#)X zdGR`u_ONxuV|>=M{5zL(=gr?~))jqz!_f0<$A2B`i)0jyz``YHI0dYu)qE^pSGI?{ zKW*b^GB#0+&J5lU+wE*?$<1UH{V=w<)jM&q7;6XDG_M!+G^UFpayQXRe4x>BL`v)j zZ6<@lN3gK@x!D>(A8p-k7oIgX1KY|=xXG47JlAf^#(0P-dBNXdVTu-FQN-d2EA_00 z+gMl<5M&K3W^o9FGy$h0UPM^DhOC)8o8t~tb*?X7VGj2+H$)!A*6O%CZbjo;S8XeM znc58&eAD8ew??VY%z? z^U&Wo3F2erTP@4w(*^xl(%F0fD@wr?XVisWG-+p zFCsFnxqf>CIbYCeIbY-EHUeq5fy9~J^yn4$HGZF!(B126mf^@*`4Oa{;swK#R!I-w z&w#}Ix{MuYa2B6c-4?UB>%(8O-SCb?NF{CcMi2i@kOH0p8MQCMGxvt+01`P?^2(JN zqgG$>gD%PM1@+ySsJ38{Lw%4U?rb{#1hm%Zbm z-leNn9+f~q+#-umkU}^+t~e5UuHKRbJe{UL%!_KjpC{dc9U~sn)DQtQr=<>LP%|G7 z0L1dLd(S!*>jh(1M}M2a7Dp*LnUN0(@ zl>z_JB^lQILT6yW60qZ!&*EmV>`Pc1+ZZIf_$SK26Qzbq;a@*@6-EAG^i$r6kL-C} z+|2WpJp>E}O6=0q=(u3WTOw=z`f-3nED3hEz{>Ev!%KZGZTP(5cVLQLT7KGg4d&*n zb@btxNc->tEeKrr^1f}HkpD%UK7^YSxXp4^@Je8|Dv>}{#AS?ttD)5!0p7*FRS*(y zy!JIM-hkF?-Hc^t-o&)v4%oibH~5__(pEeyQp^`H#luD`XkaSNYgl~$Ye$iHb8)p& z(}vy)DYuY)toa=ZG#~jHedA$g56O^KKe>ZHuE%lb>Uf=r^Z(|&_H!T6%kPs~{}YC+ z_PJ^3Ef$tvJ-x^?xc|=6c0KJ_A4-tTOpn_w` zU~p*C%;okV!$=JD75M>=Ulp^GT%UewibnW#gKVtSTK;IlR6O23sjd~d^(8ypNS^<_ zdQJ=q^bRXObvelz?m=LCQI0!9?PM@J9Ls<>CiP=Iv~tMmG6FgK4#Erawl1z(6-dJn zU3XJN^AZnP^ zP;@0VyiWRlf>V13M$%1t-sAg|IP4!fg!%;fWNjN0sUA8yJB|5(buOxr4)d=L;GKRa z#~)vWU#sK(vajji*RX6v>e#SCbgw%QLx#z&z8xIBuz$6|yVARTqsb#BeV6oK(%=39 zNl9NNeV6olV{e`_xBr_?9)PmHPidP|;+*bh?jXB_VbdteyWV0P?W;#caRv`gH1PM| zP$Ex7PzHW4_-F-hbl?!W5us2Nc))KDdVa2Zh&KZ)T<5VnL29z^+o8e!GPFE0D0d~0xjVMM|&XQ>WuOsAVlFnkH%{m1`cx&c>&-*luZ+T zj(BDXn^$aq;Ev$t@zee1E1I(wRB(^0vX8E5NT$Qi4{#GAkK^=`zQ1Ttbiy5F4PE{u zEjP%%_Q0F-V(RpZYp}%QmydfK(co>{LGTLbhfhBb6@=#g z`J))^wud8W>5%2Z_f7>ndeUyEF;zae@q|at_jyilA44mXme)G z#PdhlK+tMjP2na{J9OljY!wO2`>ctrlotsJfN1dSo9HYCo&P3+nE4v zgw;K2C!(K6@gSy?Mnc_3V#3mU!|TmEr$~9YOm6^M1gdRzUw=EZC!9Z46a|1D!r2@B zv6c&j`8WjW5PG)1B6I^>r*@Pq`X9ueJlp^GTrlK=n^5CZ@N07FDTG5`P%RkSMFt7o+}iMMFoBdW_QOLSEv zA%rP7496rSX@M?I(jB&U#cl)tZ~gy(NDKkZ%z|AY0P+FvMCZ)@(F%Nj-w>H1fZ$(* zW@-hB#G8|%-@7JL>)*2*Rr~h)H0^In8lioj!w9aoes-6w_3;GaWUY8SC6ib+p3ITt zS}ne~u-Uq;G2)I}>CwbXw~MV<3JKk8BjGpzQ&a#%R6rwC0OL{E#$nhzV6piH{$1Tv zP0!S-BP0~aqrjuTx$oaA^gi^*Bfot^#I&^Pfc?t}|Kj~97DdAl(%KyUKMg6Z-RF~X z7sg{<_%FE=-;nhG?fTiYA7u^?vN|CP!)9nOd(pza9R0ZBRGmqyOW(43ApAj?AHc=igdP{CaKc68QYkq2f9Hj!=^DKRxQOEKj*cN6AH86}f; zWf4=3p2cI5f=T!D<1}rk(dSOWG$ms!ql&#=iBp%gp+j@rqhKwCY z1Ifx7U)C8J+H17q4bu7J*liv)+KIB~>tR#)40ExzIA4)elwu+hH4TC^ZA-`2MEm%# zC)M&-8+tTx3P$8_OVoW!wWy4%>0RQ6usVFEigyarz)A`-QQ{a2(HC2Fp0pVoGlM_} z4dR^#)uFDnx&woTSzi(ihe*knG&NC!Li%X91IRkJdf{D&-HS|(f?#zng2UYUavjy^ z*^X{C3OwO1E}lQ=6+EwkBIE1BL27H4<`r%%)=)AdM~DcrzYzMcabb6K3k8(qQWj!) zrvWAk9YeBO5{QHi`s<|@;f%;lP3`-0ub`|5k|x$xXpS4i-m4dl1B_hI7r8!!&Ehji z$<@h&9gJhbdCsxmYXNCj#j4pJuc4|T6Bmv;O6qp*#RghupGp-7!u6M9tNt9{bRwCbF76r!nxmgJ)Z} z+Fwq4J?xMOsK4Z~2W0fd+#^%&j&VxP@DN6*V)nF6)2tdzv2(SZN5ZPfYrH*kzzOs) z>Vr_TgPsv#i)?WtQFIZZ@s+T0a~Yo{yXW}O=VvVNb-^?0`dL-AEl+cWw^nYAotmbF z71^yZ%pOp%2niza8;|!v_=znV7B{NpX`5Jt5l}p#D&L<#16Um%@n}b!Jf^K$n}Dng zA1;J+HXszbS?7b`zC%4QD8^#&4w`SYMOaC^v8{p6rVxwdokpkQ*j*m7a`!&+DK3$} z_%JmhY^cCPINpi5+S#i`OMrBf%F|>qf z+ElBq7oht?4UV+w4P+Hzs9^OlZ@7zTa^%ReX(M-dZ{pscJwojBkL^lF^ARu;du3)g%J-;u&x+6?}K>Td@LyoX>N}jU=r9T zgdOiXTSIxKDh{P}GUcwPpIwXlahFxN^I=344;r*PiZpGg(cBMs!_E3D-y(8=zzR2S zbshlqo<}@i1!sR$a+MA4L2y((wQC{hVCFI?5sY;~7sJIZad!zXu=`A6wzpStD zhOUSXw|a%@hv)Zo|?9aR%zt!0wu})N{30H@-7dr-olz5+sM2?Y6^dXNUKI zK1D(V)U#+E@dNcd%S3^Xx~?kfW*k~LMVFFIQe5U<^p!t`8yCX58M>e*%w&1B7KU>g z_-z6EYIT-f`Dqh+CKbse`dyLintJ* zd%LALbyLrFlU=kLog+5t2&p37DZMNR=dKIL%V}7kBP)u>G^izzL}M}8zhXV+%#1z^ zlW$qcnQ-ysoex+@2fY)=HAD~)V$mW;rHWQd;-j@|eL9rJBw=`QRpg&bnDb`bnXyKy z*9bRppvqBzs$Jf5&9jnxndS&+P@I=N3JEDfT*d>raP=61YA=tzCcZl&@kXgUpWLSU z{S4i>j8&;p363?z%`9?>5;@9|%k7Q{{u+bf)bF$Qx5yeM!ha+*rk>XTToO{Ecji8Z zjWx2&j;e|TXcwm+5_MD#%9_h#3dbog!3@Gmxo=d3CnkRGTFWPlca|StFw_KH6uCd- zyHt;{mXWa~O|0_eW~#NcBI~S^JLYP%-_!j#6%YC#hjVkXr4XDASlErNb6_xQ$bz7*@J(6NiZCdVuiUj;?kW7 zk=WWlu2ziq&(THZ%D5CZ zQUP*tQTiakdL=u&7!o)j{8P?|Gt*Yj&6-=c{{tGe+UTwgi$FgIRyz!pV{xrulWCLk z6ag=O>(@#EF^g2-0bS%A-BSZjxcA=iyToBGF}A~Ya7&Y3lmM565K@VUa&2PJTqW;0 zk?A~GXR-(iI@zODn}M?toovvgg%PdYXim$`YhVBXxCrxJ3)I~uywLfH2mvm=E-(ot z_0Ce}M@BAfAFEo`YsIou^_xmJPyIa@41N|ogc$0=o=x(JWG<7AN%0%I= z)8ciKuXzZ@jG5JJ`!<@iF11UENEV@(Itb?^)?9A!z-+IdAvGLcL_Sm^5)CtqSh0lB zti4w&HMpEO0EIsu26NAVrnVYquAuips?v4tysD)fT{8PvRRUBBI)@|2a;t;JPrf*9 z1OP1pa)Da>leWb?7Bm8<7iMiZ44@+^f^n?Iu_)U-Fhd0$LH?=&H>DSK0p)}wE~Yk6 zavH&=#*&}?Q$!gO5IWRlCg7Zdj$5Q2@wMez`<=%wvNmWZ#6^GPFz`z#gH5}!9orow zJvIHz*gZ`+2molR~AOn*|(9v)x8J5X? zFgyTsNTEzfTsgvU7P3)8UF_8xYgPc#~F0!m;5;w^!mD2cB-*efGcPkYV20GMA zCPaTKE{pExGGFm_{VpW5*C-YEL~rog6GO%&DEnM{$L2N_ax&&nC3Ml=v;2CO4V3IrBd!De&K)mOj&niH>Z21XW5 z(>|@G-o0k1 z!bSEL@AzvG#!z6$87%~xrqNnj6STnUlC2_SF==}`rks$BPU#S6rt!Fd3&IDiwQbcb z89b&`Ikrd zUa3kbqjDZK10{+P!70Nbacc_Bc@S$IvuPuN<^?mh%G)@3W!kRpuY5cQ<#(FYmD-Kk zfg`nQ6z*A^xtVL3mP{7Lg?i5I>6?Z^ikn%Jv==-2N#(Amtwai}r=xXksnvvMuKJ+`^cV;> zj())XU{M6kw~(vv+*!#zx-_x>1mJSJZudqf!a7qdPl|kug#aFi*@eE(0nC=;*d9Mv z+MK|^*N55gSU&pVllaMKxFd`{G1PelI4`W`?%lV((e-g9{XNu7UA&+EK_~H&Lz*^f zZD|73bi|M|F8y|w4cAhwFr9Q`*WI30NbsdAYWW=u*al zr-v}}iMF~gN3(&r4lox~r373LSo;R>cHPEcIt@HDj(RhATTM5M32|(eqd>@qcG2~= z^7B$$y{_OZ(~bK(9+~xN%hsmXq2n7t5xZFEi{9o&f|mI5pkj27i)5!hq`BJCq48b` z)Cu>efkW<&0L11XQIgr;dHeW(&!lxhe$$Id7$!hr{v)8k%i z1|Br{C7M+lRo}gR!G-94iO2>j9A-_#X4Fy(3f7HM_Z;oHk}I6%nVh}ZE4AMaXP(te z^{U~1XM5V&M$R>osU4S$f^<~c#^O}bTA2-sO%tRWsLKOwQQKT|byqjGGxm^z}_&c3j0TpSL`Rm}+CBGWRQ@y|b%7=P8);lDojrEze zYHT+Ocp9IV&mRp&fc4_&uNb{{94Y8zUHYeiMOz>mB`Q~K8rn43(FCmWdH;pqP#S19 z7JH{XmJrbqoQ#-7^zd!;4c6S44J;NTjCfHFYWNKPfiQ{*gJAvJF=HGz%dD=#T{?RR zo8xS#3*qW#@a!yc-IjyR)pnmT0PbD)S3COFnkFCfB+Y}GtN(l}88~i?!62?{iERe) z!$-y%U$%G05V#OK{uZo^nC$ccS}X_&>E3v4!F!oSfQ|&VO~Yml>eO7dnP#cXwYj#} zn%c5!_GPN3y0cD8ZAbCYQ@AM1{Bvy#9c!@?Z>#Noo8#0Ys^AE-UE3wcGi1XXzJ5F< zn{4{X(trK;_AxC#uH42GfLaBY}To2*Jo$U zYQCO9v2*4LQS}?k1K22z2+E_GtCBC8*Gu-bm%~wWS*AgWJ{4Atoa&*Y)d~ebY@HyeKm;?(l;Bv*RphtDwIzGb zUZ&bqOC8T8tFzi{$G*!{O96va3%*|lfhCgz7Z22Gnk7V;N)anYd_Zkl?MRUApXLgt zu@-MGwjf?OirqfhjK;S`^Cy@C-wxkuKN8NpGAnM}{CfDWjI^O5OhV1o{z_cjwi zk74QxiS{^)t6{6&X@Ny_03o#OrJiMvntWr34cS2%_HJ*?aL6XYy*=x~eYzQSwg+oS z1~Q4+HCVtPtm2c61JOAA{ zoV2R-g3;ke%UDQ(w%i4d7k|5rZKB=9N*?W>tsP3br?wxBFw*lLT7$aQjiGsqd{#H0 zt_2|v^xB2(b={-8_E&<1^ji}>`o*Pa=PsWmO$h(x{g`#;T8K+Wi&OZz!0PYs(csS7 zC?2j}^hUzd+?0c_qAMHxB zKWJ&@V6F+%Hgu&wNq@o>%7rJFvi?kO3V#G`n9+T+%xzpet9~XUFy;SL%h01T#811v z$svMAA_(0kD)PZyLFMPxRGmqqXG@8OA3rx~|HIZ0>DT;^1V7A^2Qz&WA7B*6ZEtM- zd#M6Jj7LH67TbdW5CzK}2cv2~69%|neia+Rp`_2PCc;@SN@OoaimuZ&E(pTKXLH49FSVDa3dWKzEeCt*yBGQ1B)lal`(c} zyVwt|m&EjpYZ#4_!D>V>=D~|vGRuLeHP1p0>${7(U*$0bh#2<8x43ZdSC>$%J9dd^ zl*PfLz(-?SNk_oLzbs@6t=o?jT8}}dj^mV5m`%9lfJl@JR{CwraG)Z_np`g|I<|g$ z6%h?qZA{SM1`*iQ{|-I-$qJtGpE%Tqc53xc9`d2UM*s(V#~hLKy8_t8m2EyaGJq$AaK za+m`YNbOQ>TWVuv z3mg@jTgIZAb!vl9eO|QYW)Glz5?Brl!%k+2=sZR)m4(+H+@h2)qQ?s99QX1o zNw?}4{KcMsi7_u*sg7#w5~~wPL&OQ)>6d<6c`pl<5b1g_kaWE`P00e6CPh#6uDmh zZFJW;>1VK72I`-=&Sq@~6sw0FywN`%xGO0AjCJHOrELXtYH&4r%x@neeO>*9vN`0; z|$G438r+2_5dODcrY#=lE52MA6$a;#C zo5Gs-sqIKwjmT*-Lh72#ItDWCkI*-a{0#-cnjZ>uY`asZL^Yu?tWQ*zvW3URQog($sYo^uBX0~5H zvdSK&H2W@B%B@F|%+x>cIXcR4oy&l%sh=#x%lo=ctW%#O`1DPX7XDzsWix;Hyh5rc zEi=Kvm4}+8_>79YdA{Dg-CDeM9+)$+{-EbYx_A)5FYA#c**V_Kp!zdMl^#1YQ~pp) zsSjk+21fnbKkm-V`T0EB|9q56sksD4u&@UF&-|8Od-osymuJxy<)>zN;}^cH-1zTP zFYK1e3#v}L;2VS9AF&;TWddE}WoDvJ$lK{h)A-?jB*!2;A=FcRlunsBlnnAW?^K~B zR&XA4TbcaQjVs+G@b@%_zopC{US*PdrFvi1It~nQaO1(|>35y)d~5`H`u*&lb0ZPVt=6a6;tIyPm>_ z?i-(q)$x)9e(7+iX9~{lT#M$FI@}Il<9kf#(~(2gL~6|>J*tGZl(^Mex{vHV%o`T6 ze`sBa_6g^Y*7N)*B7QTK5F_`P9g)Mrh{UkrW$M!yZ`L3b5z9y$p%E9+G%&iA)+dPi zOjWpYJ`E)Ud8>&@t`EN!@UYjy8i|M*xmoXe7IuRkqxb0MsHN0CA~ok`&h@1|Vd@4@ zTb)wRfNZcLN_RBNKd3q~&>9AUBRuse);XBFbnJgVnGwBolYuQFRH?4{oI_T7NF<=e zeW)SAHpj4Axz343+#ryD*$Ub$+ARoHkw`-;UNsQt7Zya`>m9kePSZtuiY+*Bf&ZiH z0DfRi1z!7o-chk2{NEcIXV7!e>LP9%VL`{qfRn zPp`$GtPWK}Ly^8TQ&1;P6f}rsv z(`8AI!#lc`4n;eqEJyDq_x+DWi9Q7Pna-&xQ2ufG5ojZhc#3S|`D@EaWxJ*?_jeI; zVzN2bBbpza0DD0`iII+l$vrL!QO{Mp(mx=G^-}?_`2=5138ypH1FNs;%cg zt>zA%n@76+G;$skMv=iBoD6ScfZn{g=FxPta9Av<4Dz{pMN5MCWCmKmx;>d zqA?8g$mzA-{FspN`L5viaa*Sz0g+AL?-PdCC%eh8LsP6uRWmS$H7MqCnGb}ZTpksp zAf)W7sQO6@J{6_AA0kn;CC0~DsFx`DsP`P9F3tOb2vX6KVotFUHWw3ZvkgU^W|smG z`5fdpk#-Sk+|a1k6P77~M5r{hAyW~cxL-{b>ic`Ab4=|(pncsfS8 zxvEbHAYBS%VUp&amdr+fCyW0Wkqk|4TPP}aX|vCzvP$?W_|UOHZ)Fry!Hxq_ZyEh5 zP7>t3+bWuhA5kyMaCbYIs@}02{Wnh(-1WGMM|$tU{9k~mDBj+Vm6R|W(Mh|&LbjQ8 zA;dqqDaK*HA0c|dT_lby{Vd*|2^9q?GLvg7p{5GW>>q%Y zFt`;iK?VBfX9Z`9W6EnvFFNIqW$yG&Q5enfd&;erX%$;i!IXj*sG@)bTkUX+qR5+q z$yAwq!@D^qP876&rkUM>`BBYGcr1x)kXLO_gPE4XSyNV0rDnY?G&7WF^oSJpjqx`+RRloq0KK^jU zNunlnpNZfc|M`#V$JLB@m5F|qN3%%!*YCg&%)4F-=G5Fgt>$652RDJ@Qy3XeAn|BmDQe@id_ zn&$Ky+~o6&0(_24x@#wYwJU{RM$sq-_>~JT^95jZ8RMWXm%vNRC2)A5Nplr24ZM|2FpwEL5^) zH^;T;|6y)f72v2JwiRaK)C)0}g;Mg@!q?vr7>i8rn$cWUujpw=mI-JRWs))@Yz;~J z9Rm{Qo#KVRnG@i%Lx`HVHf1#pYx%MMK~@=vX_U(g;kK8Af+c^CXGOz=e!9T@T3A%X z3FM?k#6=a+k}xG)FdWg%yZ@O0gq0{OC~-&pHq06-2ro|4d@{D`e~TOr)omr${L_U=d|@ z5O;7S#P0EcOBL8TX6}>HuFG03V=|h{-zmqNi-v)V`v!lk4X(BTBx|`5!TN_P?me*94N_(lm{NE8-D8g=a(r!xsZm=;uiA9 zUt2mPignlXNLnn?)92QOlN|_#XPVcv zbjxe|1ig)R)rhR9!pXYlx?;ABqO_te91;WsBwhM?eYt$fA&4pwQt~AH!{uO6;Jv9< z{v$!fZO>Kv@;NjV7}-R`>mM(LfD-}Ydhw~mic%T?Fc1&}0000(G&VB;0B%JI~o|Rnl#itg>aEB>wx9{{Rfk02PTOroaJY3GLUlCQJM8 zHaUKlq<%>4C?ohwjJg#7+M|kp@0Y*tkh-}3V+S(|NQTBm!{REkI^nL$UB8a&&)(rzS3=iS zL@5`p%PRiA&VTs(gLPe>rPp74Rx9fZd*vVc`MB>wxSYLJS*^?7CP3=sr5Qony8JzC z|7r$iKz_(_Au6S{ITj*S>H4`B=8<9bT4Y#Oi#;P6S{SNjW_PvCY~;{ajjI^SG;WfL z*4ERLs78BrtqkB!-69&=8o4b=!BDlEFxPP_mb)&V)_apJMWO8h{kuvrwnY?DbQi0Q zTBKtdFb*;kapne!J?P5oWK}XiE-3;+2vQCT^EBp~j({OQa~u}hJK-(7fQ)D%shz7F zDH2no;z|nyQ+t&~5!Ee`L8&1Hb=rIus&!@-{k87ucdOkDpTE0~NfNwx>R}`%3`3C|DP+1{1+&vJanH1QAvP4Yw(TztViqp!n{rVpBGd?G$Dh z!qe=S5?-&n>gxvD+!!ISWPQGGv$VfZ1EGkvmRymDr186f24!Z`OU7X_iT(!%Y?jd$ za{ZNBPYvn!#*+NrkJ*;3x4DO>;fVYMk5R2RnkK5fD2QEbxQPV4TlYU@6v#)4%%`x8 zAk{5yX;8@}iAVyAM8~eq2F<=th>IKhrS#jNJ0ah9KzA&*VSLhmJO)RnaOht(k6nS^ zI=9$N5Fz4^$RxZLt$J!I0pKtzPl;*8Y|d8Byd@$)9JPz?Hd{;jc*`|Xdx|d zR@`}Kuy8RS*H%Os%|ymPqeVYYm^p6OP0i*xoje?bnSn&l>yXzUf5&5mP6{+;y*j1o z4O-#7KNH4(63FNoed&Zb@J@iaEJ@&lXC=fKN<{0@6ud4bL6^B>v6e_v&1Db|Ac zgF}hzKJ(AO1tI+H$fmvau>!`?DtZx z_(AX-Q~!aGyQaGnF>exK1yJreP$L%suQCL}7@=JIS?Yqu`l~!XOra6=SS45p6|_rx zwjBlv^i}4|Nb@1+%Qs1pRPxMyX4s! zGS0$nL@{cUCOn>XGZARfNr<;6#%aV<7#@^b076Vltl3b;f^;Jo!bWJw2g)OcD35-w3kFnk(_n49x={&&;};k@ zwabSa!gl;3J~y|Qh_vkzv>g9OK_TGDo2xSYB5OJLGDGhJ+4e!k-Hz9|Q^|7?A+#;V z!&x6R8b|uYh~g^uH`NK=Q^Poy zHGA3@xUk7vzSU~Qnpm)yox*m*HzCyTvoUdEKYhG?7+1hXlT+aT<<4q?K{DNYpR`0= zJU*SbraM*-8n@L((O4k0D;+$z!UPjx@IEg?3Hq@bHnJ*x0UFyA({V6j{(#FqnKx($XQLd zk1p;K!Tm$Jk?aBlr7dZ2mag^-PSPfTeJrf)2o!;#c5q0fmLVf zTJ-HoUD}4K&A#2jSk3A9Aj(-_#fzepq@@onQmfC@%Zu>mrLMyk!)2#DehB$q(o=#T zGj@n(x{0^ ze5Q~ldnU?+y>LWE-FbZxChW{(SI=2)tY5lz)Q>^W;q$oj+Xb-C#(81jR+l`}4O8I% zMpkmQs+^1hCeB?A*%fBd)C=Y~I*{&Z*rJANX-^;?Ij+($NbK7M=1qk7;smn~Sm5U1 zdxQ`e!T{9m6{K;btuTJBtHISQYEGH7f$`)g$gAq-c^zOIFpe3VqH>z;H@xg+uEpe1 zw2ASpbdW)3*dC4o1G|ND#!^&KWAzQ*MG6aQOJI?fKN;G_3JUTpv~cl2qvI?o;kJFa z^sVDMFvn_l;b<62j{j$vDTTHhMc069=`DET#6ud-HBy_i#ndURnKvBs+~46{wa{J+`5CpPqWEAQ}k} zl!~WLgL_>SGIUdfUzfm)FQju3;G$&(vPrK=hct=oQW=z4Q*n*8`Y<3@P0S&WWDZFS zR!C4WYW}z766)(K*Zq+;j(qiJx*9T_xnnGENGYP6CFF+ihI>P`A-$mo_A@*TpItFw z-$@*0YDdYVGeU%R8@fYQ+{`jW6`>>%PQ9B`B&3^WxVj)o#P< z04$>O2)zv+mqtLslG!*el2EcrXYH=0XkUBD0>+e-G^K{b?V9^6IuWro!#T#49th(O zjtixf&^E?(mfdK+n1Sgrp9mrH3C6AMMySeZ=^P=H_03J4Ln7NU!rfl8^sOc4f=+)A-$nb z(P9$l8`g&RhAc%0sIqUx8}tpbZ0ydTlP!Ilk7q z&SmX;L<2uS@$f(62_M+{@7x{JeU+yGWI&t0*woy4@?-}G^zQ)g zCpY`<6I&V34o~4X;1niCg`lxKi-3eB;E8dTydxfO&7k|5J2Awo2!+KI`_Ps0w2L8v4mb{sx3N9bzaM{W^c@8dYN1n4w{QI zi=Z?a&m7d9j<@z%XC}k#HVn%oERs%vRDoZ%zRzy%DejbU1sC;&X@u7BP%m&mhly7L z%(0xf4)9UUaT^H6cM2Vbk}RO#WWPN;?uj|%NvPDLau)m{I|Rb>1!f*DD|^q21|FPE z`-K9@`Y%gh=bTdX<>{Gp^$?DJ{2l@!B-zQg_e@SQCkUJY6miN3H z`=rr&ZboaBdg>Ko_zcgxc<7wK^_D?mc=Xe9a#gr@XzJGv2#T0NeHS>olLriNW?1A?cdGf!JSPvUDH#DHu3e?W<3@A z@u&Parvr25`mt$$;MYHGy))B~JnQU-DJL{t49hT!0+Y5Gi_PBa!XUysQC`$>5kLCM z#^;A@if}!O#{u3T8?WdVL8d;P>J?>+hB(TQeZ;qVODa=d+CtoruV<@-WqQUh_G?GC zN@zH)N}|2WsduACzSQt=)q@`@@Ml8G9AOq{vFKlTz@!$31ZEUlA;|7UrLy==B3zfq zFrvy80Pu)QcWZMy)^Zq=HhBwsqS!N_A+2E;tonGtVS=>HUO9m%=@#65%Evq~4uivWft z`Ekrwy2muPwo<>MT$WqyF7Zo8Q(Y*#!4N;2h zIE~*B8>$;hDw2jQ)G5P04GL4G7y`kBnAmOzZ76SOHgu@8rhN@PMfpNZ6T;#K`kFe$ z+lL{L5x5kh`i6s}HzW<=4ZTJAJ3K&1O!^yI7i+3aS<@?O5py{+zQIX~0shy1rXqhzZwhIwih3lYFihxY!@#R3ay zb~O@f{cyF3e@gZAL~bha{B&p!|Dbe`Ma7S>q>#`{4$*0~I6w@SF49-kr=yk11W1KP zgE>&~XpfK%-t1H^0Se67j3L>Mtwi$MqOoRa1dI^xGdYf|fq4QG_Z&~y)Z>6zx=77^ z2L?=pNIl^hj_X`?It)IW+oExN_fO>YaJ8d16G+}6GR#+7#vc`SfzdztDT?v`aejX0 z@S)nza@jGZcp^dwfTK`4qS%tPM4pN~xGsJ}6*hh6uxf!RmS$%B zN~rkAvZ18bdW#_M89j8w7oE)Ht<|v|<#t;%h2`R|h`HtYE2LxhCKxS*{9LJGfH%~~ zqQE<13-+|GOPK~m6>;%{i_LX$K@#Y2M~;^vPlbpf*};FMxzZ+EuM{>{M+(DC0__lC zL4dbtV109~Jq!&wYav36NL~myNb4LjUxRE=gE&h70+hk}br0f?{q_PLU}=2(4s`9S z8o}TxnM-XB71PWc?F@26IftzzYgAx96@q~qVwg-v?+!Tu@i_Dl6t@9d(X<`N_!8=X zOI*}YNM(B#;5uyVSB2aN8`L1vU_Rl~B+)(|GQJ+Qr6_Z_Ddg5If(ArBaI>Ylyr9ai z4rgK3Q47)m92Mz-0ArUr>l)hrUnsz|I(NXOUxZ;?%+hiZ7a`y&oHvs|EE_Xj8=exIFOz)d&-a~)8BriZf5YkFzOd+MozHK`pcU_`tQ=fsS3^>ph00NExx^_34e}p zz^Y)T@-x^)Mnwr5%9(9OxmXU4VVYDsJRYCRuWmV#6w@N~O{3|?Z&^NoAZ5_}9WsF% zwz{&;kfe~0KcvCeIrA|YDFi-nIFwbEvWScM{n$tKQ?iX8P0238aTK`(^(zYqi8XsT z$rHX3G*2A0GSHkQd<9w62jJt9A#Ivg#lqEQFuWH522R&PA5z-GLtIl`ZxZp0 zdGSDUBHUNVQLXx#t(Ih6`P6txMnuF4dppN&=kUCKWu$5${mK^$>rYP#vki-+^S1 z-)Wx{_!feob&VI3Sujl(^#-*@ok@A_R7FsT!nN)kpD6zK4OwO!rUQgC431+zVnmBl z6y?tR6cY0VQK!M3Q?h+1vZ0l%MLTzW%PMSxpr`fTH*&Ct9%kAzh8#tTqXy;_WHY($TbxDkB@PlBdT^Pz}j`(wI*bX?NX4I7Xf;q||GfoVh@_`3}yAw?*};t@d6T3c8{ zTztGaQ~}qxUr?1^vJEgPh76+mEQ{h2m^wFuD8dbvs>h(3G6g`HN?J0~J|qg7N5l*C7(#eMzM+%*esKenKfmacc?EYgb%DCR z^sE}ii2rb<%2238IYfIKT7lvKJ6!Bl?PBJ6W)yTc{y||>PUuS#P$5o!>OjU>B&z=w z(J6zAhvZKq#dQ3K{$TPC93}Wc7}73vUIP?Lv9_m6$mYr`ZC`7c@sHyhN4St zal9k4v<&$z0}}eUA<4MCtH4gUD=-2^hU&wfUO0?~Qvlb<^w6QS5`SIeEpQot!kow$ z*IWB9I}_touF#JrGN{BEB-X&;5}nzK9d$4p4jCfOgn@C%kgl<}RoLwpB`_AqIaSz( zNLtfgJs>jgWu8H(+$033Vme6hgti$b58-4cl{aUm|0{EQYnWaA!WqPLhj4US!2FEA zXUhjsKEEkzcwsl$M?O1^}rF#XISN@i>Lfts?^G+G`D+$mc-Nz1cJ zX&q?_eh?^;2H<9ujs@h9%|EAiZoU{R63`zmenMB*dl$Ad+~HqkgakfIpn@IkQ1Qd@ zgYZ(I)+ad0Hsl5+BnlcRpmIvH&}k@<58g&G7v?szkFL%dAG}a$Qu~O(_J&)DMA&VK zxSY$Cr`a0Ne0AvWIB+&pX(L_4Iz_@tft;w6fs)`f_W)8yb2>=W&U`Hbg`38Zv;H&w ziG%<~Rb>`)b?w9K^8lBCz;NI&TqcJBj4y;;!k~be#p=WCNdrv4U^r;K;iO{z&B>Di z9x`RYKH~(54mJwM1~*8e6*{r($tL(^qkOQ)!>Kc2)d9-{0fxHF28Vv|=~QgscEB#t z0N@$MLKW%g=`d4J?Ab8Wt{pf_HUSl+8qq(kYg{j_eW0d?o#UzRe$39y?DqIDN*vpW{j5%) zA(O|xY67GMZKz7O!qilfXGqVw1D3*Ba{!=%N(&lvTT@Dw=rvxB@J}SS8Cl5tEWFUH zXAx}xhv)_DREPs`VBtZhA{s`aA21#+Rc(<)Z-^VBOj1)i4FL_s4XuXmA@PQ=12F-I zp~#`N>b*^e03~e5jur8I_yZ_FTDl1lEkh*FgFU8DgfR@WfcG3Wt%S@MC$*Hc@uYb+ z7kI{q`h5^D5w^o|ozPSeo%K7hMMB?@c6Haaw(ONwl6lY~6*Iuv&f3k5xNAYxCSs9fX&|f2c;V$o{*q!QVY<0E0s6er+fnpT zx}^-dCNxxoq4(88SSHjGY{U|{ddK8;AOt1fWXK8^J@z^6CiyE8ajC6v8D;=@5Gr7V z!R#q3==~B^4Jz;H(DK**;s2k;vP4IrcuNmfdal4zh6aYG!X9Tt;gWh+gKuofh)k5fIQ36JIIKA5D)?Y z002ZZFf#xEZ&raQM0=QLJE&sF{?PQ^-&&nGx_tm*^x~tJ*{REHePn*m-~U1R0Dzep zGa3LyJTO=I(l*3XkfJ{2Bos=TNc`ZBOIccETiT^;Ha~ki!0zrHMY61ar%7c09&#mF zwUdX{jF^>ghojUYEbp8ZNvUdi%M_Ob10!O&Waz1JYLI|jlo`;r1WHY!+BN_Hq5_ej z001Z|pnQQS1Of0@0u%`Z&LlJQTs!c)@74SFHT|wENuR8w`(eaNyi?OtENN<1Wh_b; zEWZ9VY-h^;xtmnD1dhM?NymTN@DF2u)#mL!ZNBj*YiKHJlYd<14)L`*B4)7aH;ETD zh8C9{##Z2E%vI?vsOkR3uDYi!+34-mMR__kzS*nw=hR1+~!hCYqExdMH zF)HZ+oCsEqyJ?89me(GU0%j^>QkgUjn`WYAjyo0keejk693)r3va+qB9okpAfpa@Q z6*QL`#$L#wB|l#Uz@B4uD;2ITU5Oq!c&8UjMS3d*M9faeh6{+oJoZcwYUSCmR@Uf9#|>`OzrTZMK-KjO$Wvisbqj)YgJ@q99T*s ze|1Zh+zL1c=?z6=%Zgb91s>TY;AIg0AFvIxGy7l;lIE9J@mqbvIN>S{rmN$?t}=31 zo;MCmClRAMB2gJ*Dpz!MdD0R7MGVA=xI`8=tlrI~(QUd*CG4H5y=DZL+lu*Ts$^ki zS?Oh^I^#|}X;)V@cbtSnu1TtPE)7%VLP~+8SOLGDvQ17dCPYtDt5&HIXjB7_Rsn{} z(iA(d_OM*MqrTO=1+(f!pP5)465*#~?8~LKxKWO!wDlRRzw{l?0|rIalTUHxG7bsG05+={NtD>U}uVs`hZ2D(m77?ycP*+4#R>t~DanhG; zqg1bTDkes$@Z!}_vtKk4ALAz;YbFPHzaj};e}p&29}lkeQ7kNnaSmgd%_<5z9<`!x z6XQ%%hpuN&-jOR{0U1}O^Ic{du1JVDhOrh0N6JZ z)HR2>B@`Q%BIgtqR_<$UbHk>#|3a3XyJ7YltF&=9y@BO=(4nJ@)UHYvXR7}K`{6nz zUXc`dwX2_6O{go!%riMKs}TFAVqgBAf3}p870lMOa#*L1699`@#2FEB5iY@-#K#$n zv8kMkOGJ)^Y%j+1uJf!+nPOXZ%XrW=C$DrWqn8e|mKsQD36p#+4u(-jn1HL8R{8$& zXPjrtWci}4@nsFQeJPeU7Q$gH!g=Q;8*St->1uo5NS%?TWtM%Q0x`FyUQU0nzZjw^ zje(QbyIVO7 zaZx&ZAeXu2DU_2xkpo%_n{DkEn(M;85#9U*kUwyv=VoDL7x;$(a`;fLf$l=O_?M-X}CI2ZaVJG=G z4c;wJ9$*VJR$6SD`eat<_>v|BjhS9(v6}?TVa|lep=+5aB~z%cJ>!8@))8VM62|ryTST zGNfO%8=oeO=LmAwNu|}QtBxF+6Pal-C~!z)R>XzFl=PCWV+F1`Qda1;$4WgI#avG0RWWNzJ zHlIIk#x5H=CPf zZ!*Q&H=BEfZ!)#&^lwo4oS$N&eXav}4vm?9i{1WDxn~;DTGXT)HFotw{~=!qhJ`>s zBc!XzHv)D&i7`-<*qMTX)|IU?-Hs}%hopu5|c9aq>9l3q^kSYQ!iSpgK zO^90OJx&^$6-`w=lSbF--KZFTGx$~lth`57DR!+Ba>er(gajv2<;R$E9s0Q13IUi_ z=!$AYXkUOXX0BW#D^iMEbHo%BHlq@@PRS9kC>rC-pwgJwai@p)pTr`p4dvZQM;a0d zP@!nVUw3H8ku7+vlc3Bd8)AXn_Tnw+^cxC=a$?+Mp z3aF)wM=4XQR%D{6%K7Rckrkmh#(C#n%O6!Q_)ke1ld*Yg}N80WV3P(-JFx0_K$m5$ov zt?KkIgw%2C5oNtoo&YfAP z+Gya;b}_yyt=5@kZ()Q*yF18XW{)~>sc0O$f$b?G^aw2&^HTo2CyVJrw_MbBCf0{V z4gpANlH|H)gp#4ygG*$*WVx2Ou~!e~ODQcwwFGuJgO0kCAo}pB}B*vI$?=UyP7n1I7qg(B7fY*M#ZKK)g3~HKz zI1;Pe`q#)eKEySO%{qkiQZ(`W*kBr!i-_@LI9en|CQ^hUR4G)0I?u49{9eqSQ6z)Q zdSbzEH6j5F(og*C+*>*lCue(VGT3L679?6cX2pEUNtvj&qK3@NDW;O((aUBRRmoFd zIFc-9QZ-Gp-^Gg8oJ?3uGUAl$GWV^MW}*7uJTsZW)v`&E!?VCa2BJPCrOdsBza++K zGATiF$XTb60^i5CyE!wbC%dmcJwYR6%8f|v$zgW|RwR^nw6QIV&E?(hoW)meLTV(=B3HT#Z5ND7E84l6bc%eIf1Z@e4J-mgirhPlej--Gvr{wL8mFz7f5eP(Pgh*tH@|Dhy0e_fU@SK zwWPF=N%sQcT;XBptD+DK$PPB!96dG0LHWP%0!9XTD5r6kWCc}_w+&klLA5|JHNdK# zX^--CmM~x-cjG=UsUHvTN-{wroa+2Y8C^C)?RWA!myt4y2=@hv&NLkgp-kb?g!wjb z_(BSiwY(0sr;O?x24EZGOd(H>D;4^E_@G_784Wy=HeQ}r_gTCc=L`obEa#s8?mNcu z(fZS{z0EIp!F%s_igTXs`TtNajQ4WaTK54qr&3rQ0(-fR2C8my3pu=iPM!5ch6n*D z9;1PichtaVROj+S@+PPsDW2h3j-;0K|315rze;_X?}Z^na5zq4Rtps@2E~;DL*syA z8j6+6u?IXn#gQYUTyvx|@m3945o33J=%V+h1PO!`(C;0fi$p%}bX?Eh%RS@J{EaA{ zUQ6BNb92L^itU1i$pGh{!=I?nUcE?}(h?4$-s2s-_mma*6Me4ZMiZ0502x%$*?E~# zz63zLMD~*Y&J9QMv%?6d{(~Z8aK3yq&CdI^(W84L9gx2oG zDp+v5&|q|weDjcngM-r?vdBZ)8K?mQDx-+m94alBoOJaHs9|tbTGH!#$NTSIM=APM0|ZQV zG_)YkcCfC~lYzYRUclUJcCR-B1>W!Hp%FDF0S#!-6UULMQf*t>klzf&$2sHrp81LL4tS9y~r{soFoogh1;${!C4KPLP@rPY5Eh`mf zP_IdG01uGi(O^or8|7@U^jOCPi4s;3@*rrbh_a6w?p9|Qz)pMLcN!hwd4gf)VmoyX z;*6UX&WUEkI{9PjV5E@k)wzrn*W)(mv%s)zdqj&jY_5ygZ!jwqvyu}!eQPQ|lq4c? zMpsK%TO=rwD`k!C9qXg6X*rCqm7rh|{1jw3_O9Ys@G*h$!bO10;fMj=f)kcW(2~-s zi=@gKas89}-nDgTCc3&wxn%ZH@Z2Yfqkh-zN@x6{>*b{9^%qHdDu;mIip+^rcSJK~ zH{WckrY$K;3S=pdxXPh11Xq zEc?^_|InX{w018xrtH~=+lz(Fx=zcI0pDwye@dX@2qngZR4}|D`bup>Q}4DSVMm_^gh# z6a~^93`D~)tj07MMF98iKT~wcdRk;!rt8uXDGu-S+otwn};5*I{3Au4X-GE3~=98mwkuHb&rB{0R>a0Y; zH!S7GF?e{cBf*$q3!o&Lc*o!oq9dUlM1LJlfv>_IbJ?#Y>bGIrTc&ahBMWA)pWz5t z{$frbYdl6-lsDCbnJN}y@G!y_4p5yKEqfP5P&O`)oa=!`K@(#be}=+khM}C9Z=0P% z_a~aeL0vbD=nkcR-0$kM=SX3$1lX_B`oJh1CK|0`vZhh_2{{C^MgyvRP_Yy)(jted z2AsR|F^V_8Wn%rJB!iTQws-jGb0u|L9PT_^89#?d^5gcdy~Vz-&$)vjNJ5S?@cPi4 z1#?vH;7&bogwImTj@>22UHvaBwM`XvM07XvPrUM%F$ko*=pEgfQrOU>AKbXxr?1o@ zuaVDe{smTT(}EHynAk4&=0h)YBd0~=fYdn~HApz7pDQ71kw?=YT&UqMi?&tFy6XJUKSyB5>d(Qw~cwjG|iCfFK2COgfM(Vru{-IhcQ(@Xs^4&-l z7Z_3I!v<`WU3pYE5ad|{3YMYb*lWkKS|sz*bN?{}(Jm%sG6>{ehhtUG7J8I%oQ1t( z;Xx538poda=tVvYVBK19wuzltFK6s8cy#IYdr|2{5QZ4rHfmQ18!n!j>u0 zO3U;rNvzut3#vLi?1@RMff~ozB^G0KZZW7GDb#|3q!7jseX@AkKBI3Nq$1o9NJjOo zt%Cz8EI82G3L(wW#mjCJw6N)`@K+?ix6R4pBzMI$xO-sL>Xd!=vWMTXP? z7}ziQ(sa{qtpmj=>w3Q!Z=kKbpO7eCA_GVu@Z)CH!@qr)9VvTtin~lM=pha&o@oLc zRfbRlC+li2j}vOr)TsIjd?gU0V_891Z`|TY)ZpP|eIMZaDtsYg*dPsicG-0;Z_f3e z1vxuJHPplhTB~%{Lg5WIqDfI#p7=DzNlLv>|v zPw^cpErwA9-`;X8E#VC|*T{+Pi0MKWo5OX-Q9m^0%h#ye%A=bxvvSR3cmMM{p)xi^ z={V}lPB(x@pFyOqX2o*3T+Bp=%CB)%=P0P__uM%XE_pZI~hHLm}4M&|Oq|~^AUeg4`*C{ks_7qJi`}3u#$%~zM z$3tgRIMnRzhxUl)nuPQWO3Hj4KnTg8q@2{Dgy^mbp*+mx4?*WB-wW?^Gj)D=CK!j~ z-zY^apGxDxA}qYO_3j4f>qcx!lEfsjZc7u=E^+n4w&c2jHqEwqXl~(1$8uR+lp8Ym z)|Nu~Brw!$4j41ATS@{+KWnW3@syJ?Q7!kVzAEibvZbZ*gSha9K~i#n(a$m5;YK!k zCF*merM$nDt_iu*CB?J1a{>f`{5Y&+++|PlUK$q3a_TP3GTA5+3e2-UeWS6+e=V)* zg}s+*5baa~QWU^IpE-oQ@GM9%JZXibu<_=DI zL5;xxc7^Cz3&FK4a(r*VgCKK5r z=&DxRNeCW}L=KF>F$lrmADL>#R}p*tb(5#Sh++uy1{$mZJkauIl z>g-A8z0N($U?)kmxd}#MC|GfYIFsK6nBr<7N2#_oQPnK&F=5J@W|I*S7 zBunsjX~&&pf(^oSQUSgId+)jLzgNP2e;bmt{!>g-Hh$02>vs9f>kK>k`ij&T=Fu@Ncm<`JGE%p|56@KNoJJ;Qa0MkQq9}Or72Qf(77S%*wQcJNUy>&|my}IL zlF-Tbq&u{=*p_II?Vd?YLrV*Gr7}RXX0Q?qv#FLu_T;8t7fRbU=uPh$QI#(i$ks8g zVyNLNo9gz=w61DSjUCwS0dhZrQb?0?{`EFo^tZIYCr8zdljy51GEGYrP59T`(E@_c zD}QAe%bGQw2nBa+boY_2j_Bh;!x{?37dx|#d@Lv0IJi74 zty|rOi+V!+p3n~}w*sry;*D|feGLa3aoo^ojnx)2`sJLQG&2?l2#F9vk~8?S&DPC* z;ZJ_i6p9+ra9`mwT#w-3vhjJzWfm?1q&%+htuUc-&p4 z0R=IW+C}`1K-OknNBvOSsI^9ntd47C2TIaJdRk8uq6xFNwBWMhXnb#lB~78HC9!9j z$Nsc@H`5@O16+7mN18j*gh{($%Ztpc9_yYjTm8No>2tHnzRhmedsFngh2|TNxPG!w zPPVwLO#KV%4Y`=C3_x{M_dy3oxSF*x=1oxCv$<agK z=$lJSOOo}dtxQlBwj5E1;M&Rt^zPTslJb%Dt0f;NjBckEHH0OS^-1R~pI?L7YOJRu zS0M}mh2#eg>LzO&aYu8Uq6$SM{MoIBDmEq}*AT*3$Ea-+;QNRQIdH96Y4Ln~8TRI~ zYqQ$VnD!44C@<)6+}yxIgA_`5^{an((my++c1(vscISbRmzA=LYV=V{XBx+_tq2#a zlKDcoXYz7m4u^%z7>5X_n*R*Nx_E4_^ywk99b@8@SySNYk++attV9*NTkKk7D!c&n z>;|)t*>Z0EU-52vDh3X3{1LA5$GwDP@uYHi8mwK^qK}FZY>e(wk;fZk5$^DG38J_u zk7#IHj7n=18oVKsr?6TDcgtmEBRSI}k_3-_hbE(S;$KQytW=lYR<14aa=bPY)uo(Q zsjv!f0Ek%*$GkAc2YLK742cZM#FN216J25wgj#m0kp$vZ^GX$|Y^z%E`+B!asL&0L zx)d9Tybq@LQgDpiWhvtdqw}VZXvWAE6Jnc zm!j7WEG8A9;xKQLO_deO`j%NyW7Zng$D0UXix0HR&_sMc{_tuV`G%%;T@D=VHneDijqy(9cp(o%j}~WxIIcG1#~OT${7Qqvyaz@D0%8zC9&BkzndFdMJ23~v zEDN?{mNNsjl4*8tBy~pnSOKTZ4=LgpE)|x*$1uGxcO!650E#n zDO~z_)1@YgE;DtaWg-+O4?B^%(_3Llvh00Z92`(kQQ~#FPA9V;U-UOW`)G(AIB{_cFzOTxo8Ljq7x_)cm$1U6^k|aa#i-{@> zy0td-N2{Z>AxNacP`jnKtz|Y`?PuS>RkL;KSmCcamJIR-GgQIJ-^daa#f6MD?8WQTc2-tp8K+(@{!`oP zsNwT0TTNRPa5gSbO3LYGMSS-lnDu!fiQzgaoAv~2? zIT~|Q$%U`_&uK+kn-vo@__;q_CRSZSGc2${NW@ktC1Wj1=p=jC8dGNTfQR+e?$>fcvEF>{SyaQ&In-hixKp>R%JHYv?6Qq|bJ zm0meaXCu}hWxog7l_SjhiV^7@Qq`eRS2-o~$t+BECGcCZ6^@NHGTTG#2$pi()YCa3 zS0pIZ=9{q#qsWJ}j<}(K;mP6ZD+Mh!HYIw$EeIugl|ev1V|aKSU5*6j%iS|edgBBu zqgqCb?uNVpSn-IpW9V&3LYDC0-Hg8&fLzzj1 z^fuC|8ShEJQD)iaDXZbrq~;T0COtfb#d~&5_$^S5;iyB)FwnxWZ;Dn4FjdL)sFd(@ zXm8B#+btA>|TsV-D`iY0~M~iQxA-Z0I%K_vfxg~{5;k7v$a9LYckd+^{ z@;V4Vsf|o41@pd6=}9ALj)X|Yv#hNfLij1xavyoGjDm!i-&M!BAQM& zJhXdnR1tH^dS*#B3h5-;?}4tF7#-nNS%VLoq@h1ldrmvG$?tD5y9;;i{`JJek4*2C;GhDnsWQB-I?qm-1-Z0`8)K?2ZVcTca;4vdZ@L+oMPDarHGqNnK9vveK;5 z_Pc6x$yv|#kHr8Z$Y^Z9`tMkAxPY`016n^x(bcupMQc&bFo-J-3mF>Tx(8gyIvuVB zl^Pi&orqROZ&hLXC>BZa*gM?;OTS(*P4%qdrQLJ%p=6|Zo-I;W6Km_Se&ZV_{3Foe zesfis^k>!l0P{-N(;qk>nP4r?zHR$xp9+*53K;e1tPys+ikP&F6iFSWV~p4;#_P(> ztWaX66vGkX+2&^tcpcik6BL082ptb&hHdrlvsXa5ig{cs^jITEU>ATk@HWMGMHV0v zIfcWE9u|{(h&9_gRvol9+GG*oxr@wu%~h|AG;*}~I4$wzvx;S>vFMrTv;`BQP3%gR z$%Y)ei7tG6lj0Qlh&l};v$0k4V%T}XCCzmh+Y$x*8iWG>^=s(=WZcLQ*$Jub&Thj1 z3aGw8C+b9KoxA1f1jM@kIQqOacNEuRs^{xkk5?Qh2Imt8Dbi0}nb1|`tLX(`hq^_Ygfy^3!5c{SY`kKN))HPDL?K;2js_bHRHlq5KiJ| zd3Z^Ay~S@Xi4~!_78!E_I2O^XmC@^($BvYFszh5oXaF8|>v5r8fSN%XdhK>}{2Ke- zE2Ru4xqNg^UZp4k5LFxm4^!NA_yC5V1AQO*IlnoLCXr!NM87>qs?s&2eDf=O(a{pXjAxk$1VR;oOhGDZ zkq;pRK4iS=shQ&JCnYTjEY(%CSU1)LHB~Oxl-(!FU_%7f$$)8OYuVd{TlrA~{G;BazBq!Oav5;=1Q9LohM#VS|xh$Q;RwboOtc|=} zmI`rJRmes~NsfCbW1FvHVrDpAv+EYeCW<%^nVc-ALu6WO({Gk}aEqiBrJ?I(&FxJa z6RU}iN98$AeJtWgiN_iX+Gm<`Vs+=DlM_ibiUQNinUFJhV{nZ>q z@v39o&d%58L1xECLxJJV%1W&YJ}QuSrK|0F!?>K7a*7O@9Ew*4p36>?evh=iSW=w2S`T$&?`gQ3GN@}PgoM@_p*KP=b!%b&bk}S3x4BGc~yX5p2F?qT4Fa{n9(Wk zjZmn0r%srZwCNqQ7fp4u7e9>d`UP&ztAWv0n9QNnB*8%6re_*>- zMqOi?Wx4X@XP=T2nf34dq21S^Mk}B!9B>j?eJ|jW55alk zSK}X^4uzjD{3NQrVNy85_cznR>>&F#s92{`+w!@vJl5Ow#Z^JxJBH;&m_YQN&d%>( z@ee8=oePB71%_KYE}_uTe(2Ja@~2Xo@4)}$$!%6sPS*gRt|H)cDOn51F8bep{4il~ z8W=4ozl{*^oq8oc>&}chAw9dIF^kZMX;}jTlCRx8-K%SC6k>Wy^RN-RP^z=_9~G327k0 z>Zg2WWSo5b+R`vJH+#PdF($R~XcZ|H5l;7VB%8HkDx zAngo#F-Uthct-7Ft(iXuCkk5BL(~mrtu)k526cr(KbU680Gl4}1iN$UPO~&o5;SLw zb>2bRkLSc|Cz+jp42d})7e};>C*D=J90&;tdNhGKfzM#Y6Z*kg3A*Xlovv&6fUOtQ zJ_29+-=&4*oGbm>mY*+4^XO?MZ1e`g&dEv%IZvtxw^Ge6YpJtjdga!bA~uAkmuV_f zNg>f6(Hh}UvrM1qR&!ZDIe=d2=F_xRGF4iom)uJJY|rZ12I~6olTU2V4WVl+#s+y- z^j3pkR%NAD_`Y8RsLA(TCH&`kwe!*x;fQjt>2IWCe6x6@yUn%A>C?oloGABegB$Kr z*m&WMedgA1!=J73mXTx+J38*pVZ9Br|haRYP;9=et@7po!8UtH%Zu`esyMVHL#RYK7BOK}+T)vF>pW{Es9a3uxeOJMd zqrczoMC?$wx%XC~vdS$eVTDu9`?H4CmX7@T1D?2*roku9S6^ft>Zoybj0QZ%)>W{1 zz)7iI(&c>v^Voz;9xS@QE6O!`y(h`po9IkJzPUoG$U;w@($F&chzd2;!MvZ*OiC<# zaclEzt%M3{P6Qx_H-k>;t}fcb*ej^@jXl7lkR`eCXvR3+vA>7KfZtFo*;mwIC+fQN zPydI`30BK9OJz>!E2}8{Bh#rt`G)q5@z&*>F6sUC6QI)&VotZ|@eNj_H7shpws~VG zZc0}!+=wXfhP3IrS-f!_#7ujVN769LCCqxDIuFK2zw!)BXTq)&Fn&ZvodP~Vv-|qk z!2Kwm+PA9$;{Bg|&UqzWnH|6m_hW)0|5A5Ux*wVQN&utF^3eFC{UmJy5Ojhd9~{5$fT-T3HIGO5j|cP6 zK_}^Mn9%MK94IjOaIk_kl_4mL2Zl!Fgqa4Rq_5}`Rulw0*r$_-%%?c4P%#-SB6Ow; z?b}UAaO&4vZ+m0d7=?)pMA-uamg7#Dr614x)-G_xS?b}6#fikNx6b6_M#p020kDqq zJY9w5wtP{eO?Xpo{L7rK&CK~bqC^eG-GD2|A4M%XnEYt7Vl|`PyIivR_uX;#JHqD`kbOmzzwoFA;o?zZz|MG= zzG104HX3DOM_S|P*`Pxx5hy7HiOxL(5Hp7`7V+h{l2e7sJnhk;mnUim7A_N^&2_c2 z8DW`@#fY8ti_isO|FHW`=}=zL;=WnN8Y2D+qs!@>$)T1(#p$4I73XSXg?v1Y7^INR zm4uzo$~qs(?BEn`9l~mq0RV}eF)$%E#W=Mv?6_Z^&s>nWTJJ_^?nr1M}`Cq=TH{fb-D#f7XsSOM>t)zb41d zy6u#q$0%Y2o%huDb4$nWtl{-#If6s(3f5+-mpx=U4&qSHlAzop2h{uy7+9gIFe;pI zx;Hr(T=~sYeS>kK$M~iwgQz$RCwUW6)3&vxEMG~a-Kan=2NMS+I0hffDdwT*vCwp8 z9EhQRI=(Q)7Cb{5dNOQo@@7JweSduKAj#Y4Rd~!$YoOw1z&&)VNRNlKhskc%@MFAS zY2%bY;88RTDJ9_?U>O0@J*;f`Y-3rKGi=sEqdBlj5aeK*m9lq^x~&Er z<&m*YP^!ixOo_$UG(|CMSfbmPG;RD1L z;(nGZVPLjIj-tjx20p~-ArLeS^c_TeM5j)$=nxPB00sb5L`EY301j2~soj0PC@8UA zIqEVp!ZJq}SKk(m2mpgaN)3nrJ#(T(`>ivcG@Qx%s^p((Qi_B(~+vL(9^)?tfd>cHzmFbWOvBx9`^7 z91Ab-n05BKM>$?gZ{ecXRe+D| z@+q*bnY~GxHA2mIt}Wsv?WU!(IBP8YC2{lN3Tw&l`~83k_f+yg{@+4V5pZPrtc4Wo zrC`H{(<`}Z)V1cKmihcp-KWSW!mPV0CeFu`Cjegz9}+}|bfSI9Y@(QMoYI6!#99(- zxv^H>ct?GeLl-OZvS^h$?Ga*ebVNN|W}LOY2?z?v(~7dPtyhx@aVuS$J#oLV9!mP+ z*}!Cy=O!;ZDmHzJdX_v1SQ6%KjpkwCF@nVGVVUb!QtQoTTK8VkWbIe}6Sq5?VJWsL zF~Ree&zf7LS!~-s8gBp%4cejj+2a=pLeS38hQyBl5b%TSdYy_$#`SmO6o;^oeh};E z?#OjUcYH2ORHQDc%YO&jS2~5<~^y9So7#z z1lxN0fC);)(!))qK|+MSaNP`-#3CqBX<9qgGQQ4=w@R~f$)dRhb{lWz(ZSP%xe!7& zMIna>-{^J9ckCT|huERtA$Ld}vWM>cdZ(waWy1bSm*ItaG@Akt8|dydckVmxE<9Df zatnd=-s6k8c@sPkh@Xn;KFo;2%lw)@5aEoN_wCX?+fB!!p334TG}3n;Dnk%MvDLAy ztc>5KN%3&@Ufi@(B4;;~P>PV9tNRVc@w}ObJcorN!KE13o%%u?J>6RzI7QV>_vj*uo1g&ISv#z{sCs^U0DUg$8l^4JcKJOu+5Zf++JI>Snkc2)0VQh z{QWh;WBelVBp<2IVY2~+NE}iiw5cGHmvk8(yI%GSY7pm;SZi3Aj|j_Dy52T2Yw9xM z@LXV=5K%jum~JnEO{w7PP~%rVn-eu4C(E#_97n^16%qs$rP?SQ9a+&-y2H^#Lf=JPWWdd-Fa!$bx$AMH79we0rGj^^0HMGCCLOXVW?0rI zq@JCyg@&PD^M~Nz*m=a)ukwjDXN9|218*x?#uxz*R6cByIu(HffA|T(xv>qX!Ky;e z-25db4oiDJ1cu9%D!Z;qJC;r_Y^p~AZ|W$~qMW5ypcFRJBySY&~?anXgg#biVo33^`W|<*B0NXxc|85hwl!ky{WTAm=g%8M>`tY~xZTG0&@b(wXZCyEWXVJgi59Tb#N^S_Zx$46+O+fjywhp*w ze1FzVj3O>AWS*_&;?6$g1TpgGQLMsx?=cZ=Iyy305R?M(r4CY*G4l(0F`3&lBzoeV zc+~r}^f6|7%f2SCcxQoCF(Ib+KG1KTdVDZ?(z$x!TtU%oukUTw97UH?iChBV<(W4p z^2=+lxM?$Q53FR#o6jqp%ReiZ0*nI{cqRukv*byw4c|S;(Yidua~))wIajAH?xW)25Xaw?5T89DG0S%LX${ z!e2&!ebPKMg6{i1-gdf@`{E`Yu$glD8{5J)Q9)@jVkgDWG_3V^v%SinjljgrA_zw=GjExq17FiG`}{ zTP^$!hPOr03Oxl6{qr)oTV0$EhEhff7W#W`9EM4Pq4XElOpdp}Pn7i3{1#urU?&OM zq7dKRU=N3UQ#0{J1rGi6G(H(QMUBskCtiPMb_H(3KB5VHio&F0rOFyvx55%t&-Wrl z*3rIE^+)8@uvl}JoYtyu$Dx?eKg&-FwGo_Wfl=t8*x0G}VjbcgiiKtIXNg8xBe)|R zzP+2OQdj}D@Dr?mjC+MwEW)VzmRt0xVktvmWvgRlhaMgu?l%f?82N@vH5Wu(ghLpL z9=srn&>&$Xm7X&m&bmG^a!H|^tZi*%_oJ%PP6$8_TURpj9VylnGeG8KoP{-kf{irK z5=?gEj^KEgh>X1pi#sldQ~oxOu&=yD=ugvblbfwkpsGGH^IFzvB+Zoxng0Zl>6299 zKW#hypQw$W-DEan|9}7fPhpY5b~~;4@BW^Tq9obQJClK;EdKaq!;Z=jK1AOwYDc|1 zIQW?PNUw%Obz-Bea1!_aDIx0q-+qVh&_n)+zy5c>LwATn{%F6#xZqg&f*sly}5E{TOL z5FL_@oP0&GXzT2w@+w%fPtV`Z0lZA8`b%Q^rlWcvlj<>B-x!|2z9l$|7wQ;w4bC z&t$FzY*pzVB1)$=tXU<-E8A!z^~m_~x0YjdC?+||JHU#lCJO2wrA^={71BGfnM{bs zH&hhz4Bl|dPy7cEK#>$jSs&o?k`6kg_g9&--80@&48}Bv%cQG~zl83a(n*>t?&LHn zZ~gDn{z(s|kQ{d2NCS5Uo}AmeLXRFnHrc^$LK6<7BFN{=cMXmkl3jmIV3?2@KmOEH zrwNg9gqtq5uTQxJ)|;X|l@NOK*D2+TX{oEq&g5%pVE})#Hf@M5Xh&2QDnWibQFLe~ zzb*Kab2Nm=RkWX20(4=Vkn|%Ku=28Q_l?1!PHlFWaeV>_^Y7-Dms1Cq39-0sWjX69 zu;9a!p9cLCN^-E$ldvKsj}}LU?d@0bgc#4gA14#&0i&!UXcx2gquHH+nJSnz2u~c~ zvsuml%4vwzVXH#9O7#u5Y|10fkbH%5h+WClcsi|c?zto>1(X#7d|uPYQ`2dtiJ`H- zf;WY`M#ErV*#oEdBCV7*m(eF;NYAzgF?aNs#_5kbb-he>tZMm-8!N9{kX!k|W-)cP zS&B-K{YRL!19C=EuUqAd9_f4-a|k6JDw}H*9_I=E3~6aUQi*hQgAWzz`UDpbeYj+{;D#eQa=oh|GZvMYi6^w=Ah zQ30R2{heS?Dx`ONw{}wJS7g{Fv#={C^b;ehXs3ayC|&|?j!d}*jw=-AD76nyP|zUp zc8?GAIkHWV+fZVGs+Q+-3_S=XJW5}b9?I&GL&%0vRuRD4+aRa$?EzK&+$?yh7VsIX zqplviK@*bk3|j|OML7;4OU`GMM-@5_F^fb`AOj?3Sx3b%5~n7tB)d1i-J&v>NKz^8 zV{+C zb|Pb`76$i0-93a6u5a5Ho%b2xy-~5FNsY_|$)NY7F&v&hU-NnN)R(?bIsOGL@U# zZd~6Gdlq%8SeaKZ`&4s8&+p5V1rQ+-+8}q}|1Y@7N#*-+WRVpd$hW$b-5TX*A;t>F z5jRqv-dE~)<93>l0Nuy15vAe#BnVMqot_`2Z~5r|OA)uQ14@L!J@d`(n-2c$Od~0E z&$D`LlxSTbd^39-u$n+ZlF-wO)-i6UVuAq~YK{U&Ab)&4(I+#)8M8xQ)X-TajuuDL zhF(hT1%EW&Kva(DSi$x4{bI@UY$DFxpQWhmqmFYrz2Wb%xTdv`X8Y*810`@XSp-}J z!Lp~)=sD)>c^X$Hvnb?Ht9Z+2hISm8v|9ubLQ96$+sl>AjAW=*DcHfq`i5m$;6tST zo$Gn*-h>hvH$dw_8k4M-4uO)?y>F(vGQC4l>$4$c7bL1yR(HtaybIKr9zuf{oJx*T zLBqB6wRwZ-TDITYfey47=gUS-GSz|}BDC%l%$r_QM)}mlAWF(B8r-PI4y#JRby&x_ zr83x?HXaSmyLbcW>H-jhvA;3-uH8UB8d2i1NH@)`2xz0hIt1GM zl@b|Mu?uE?$A!bMZ|c9RZ((Cfd_3BifqX5mz9`PbJKY<|XwN+$iaj9fYatDy-&VhHteAbgE*x1C=ucwb|3f@Y83;s#29+{RMHUMp!4f_tV;{Fi&}_ZKK&cejN8L)i>a`@?sCdWmr=K6KQU% zTKUYK6Irdu&R|w5mTd?o3RHk~pl>GQt#mO=v!}6cUP&UCJRX)SdBuMDm7IzM;BpU# z(qDTVLCPW8Ox#ioccO&g7TZmV1W7FZ+otb5l#$)kEuuAR8)` zX0%t3cx1X60#HL4t7UKGT-yZnE1v}vp#EYWmQ!xqkYc=UPv@*A$;Tj9^1?{LktJ5#*%~ovbS?-ll$@mMK@vc!t^# z8F`>_<~BVz0f~P70l7}H?T%Dj5J5{Bb-BXaMsnyRAO=V%Cvfcgh;C=NA(@7vl12J3 zbWE~VMs4dWj$KPJRD{IF;|aM4nsJ(SH-qLIDnT0kaN=`nevkPpP)vorjh322#0+7R zawO#?w@GPLvs%#b3=O~?vVk1Z=Tf~3+d{T0Q7l`XzG^wnBY{ITuP$nY4~3xGF0YBT zlv&f%8u-qTLn8l{;mDjMUE+dr8Z1@PZZcwTymH#Y2q7tX2%Zqfl*VQ8$o4_$RW$jD zLmnc@!s=c~Rov5z1tdi)+%?(Ga2_H}oI_Cx0x1o9U$nHsmY1$-8k@z)z7ra}LfKR- z>gt4)(gEWGBYEcV#t>_17yyo8Ado~je7F5Vo+QsE#4CEaNr3ATq%o;W87t%<-p(M# zpB&4KhHk~pn-kKEnqhEGUC&!F)8Gv>h$QtS-C=~NnnBR|KsS0Um?Kh8SLrkIIhA?K z=EbD8!otl-{f7^Nl&Nf`LC6~ zHr6;6mdRA|J!f9EsVj~oS0ZENX`XAPH&`n;ue`-Ufa#E~%nYiiFb5IjX3A_3$vO7` zD?@-%Xjv=-1yv~yLzq;!grNNrEUqD@unl4kjk-3obzh;k4_%E_500p!2t=S^U4z{J zGAf9ifjrmK+p|_pPJL16=E@@tlzpbE-4kdKAPmky>ych}4S6VKXqHxjHHJ`ah1#QkUr(l37(G*x`dPq!koQ+Ld?4GL#V7J}EZSJPZ&iY1+!%D>2auqA3mB)A}V%3JEeH(1X)4oBo0G6pChP{6f=A;;GSKUK)@k7ZwH~U^AdF{+}`jW zP62tO#oa><)Qk3Q@`|37nQz<%N1`=(cl?Di$V9FI{UpeaMq;P{VY0@k{V9gUB?V=v zXn?bouBB-!rP5;Fy#v}S2;OWUEz2RmMj+kwFhGl?to6iLNd$z`8=xDhWn)C6jk<7z ztWrTrkQAZ^xTFRS=H|@0_b4!{^_PgV$k{P2GToNvq0Pr}7T5io}idJFAL>ak4wD zDiE;9?y{;wlp(tt+L8w6O^{U~yNKUdtC~?jhSZ}@6e-nBMzE@o2?*~`=OMy~-*)GO zr5Y3Q!)vM0h>vLyh<4jf&6j-?7}vQ3|1lQrRDu<=6P@7RA#zz8(UV$ z6w)M&0rl!$*p{tF4b80eFVeVO%@5C#eln$(3mQNaGsU1e(DSByhdLvc{YDQ}r4i}n zgWf#ru;nVnNE~ffK_#u&5Q$@UJ@wfoMZXi;f1XxfA3_n~emgm>FGs%+8nZ&Qm?;;U z?hY%Z+1xKEN8EHlp(d!?-kVEisDgh#G+we;gFgy!(astm5O2~O>N5q?gl^;5!=bh78ts>Y;{qx5iQChtuV=QSz& zE%c0QmuhBVLs>Mr^HIxu+YWg}>B^U zXN*rbiB`cZJDE!Pkl~QuN}%Nuvn15BSBW7fV(hcVVmS$tN?Ro?G>3;s^wZjtY0Ae~ zB7&M5m#XV5;;gtEYXjn%;o&GEL$s4aIp5K;v~tP_-^V?KQm5V2icJhrqgNr6hP1p$XfOI#VsukoX-?ibF!Qx>m09 zUla`iS5CrE5imlb%KtZ+P(-ELtv~jXi}ljr(i>TopHivcfm{2hcH5qvtAOknjv^|$;dm!{Q_bLQ+fCfA}1~y==OK?WTB@WhE{P zuEr|y;xfI^KSfa~>NYCawBa;Q>MIwz5+^<1&-ITBmFHU-bd0q71b@0f1Zn9u z$QhYqhdteg^%_(THuF7aNa{V1C4u*$|1XkHu5WJ~@A!7))Z56V+m^1YloV73Vd&3$ zS~tf&8LD~twx#F{hx6$J{fHv=o>D2{=uY$H1-e!whfOva@m|WuIBq=cxyS$AK>4D6ORYzd4@!Yc&Nb~B$7Fa&AXH)C3)%MOi>c% zRdv2(WozgxKKscsH7a~R88wP;jgP|rFKx6D;8U`d+<8{NiPq}PE=Q=M68kn-I^3zU z-JsNvZSm+#2fY|(*PlHcbO7y<^QqY7al%G$D@@$I`%a%Y!9hSPo$=;(j;@cIot72L zq#%zITqp$c8R7=V!9TulO-Ax3)5wi(uioF19I4$5y?l&+#3WYV^NrWy6 zC89~uol@!XT!aNlu|=~RU1NcEHLK|--6{mBc7dhJ6&jTVS}NT`r0&fEA0$D7-Y^F4 zKrQN-_OGKVuc;rIy1`3gg}fY^`s$z{es?O=K0W>aZ6@6l!^BPi-4GB10000)Gd42- z0B%Jc# z;>6KUsM^BD#}25KEj2#Ajj}8?PP}z#Tdi^7ttD%+q{2q*Du@IC3JL(Gh@eEM03xtR zGWRNo<*FYcp-#xvUDe%wZ&y84kI$d*=VCgxYgW?RWwyj-hH1+jjD$a@#P@yM>!0`f ztHhtz_q)-3&-!mH+q)~;&s+BmZ}0tMyuWLvosZJHdfLZfOk3PnY&B-P?!U|i`f(x- zwVAXseim+xm32P#-}@$vbW~y%+aVB~%U0tzY}b3V9vGLudHorfu8D29Y#-~A-aQjc zxx^XsM6QA>@{xbeifCn>Cf}f|G)dD>M5{Sq>wz>iN`JFB4}_Z|XxcnUA?88_Hoxm0%ec`|J-<~4L7WOGFNSHKjLtXMufi@EJv zM}Rgi`F7Y?BpCu&%-QkX5HfOe=4=;}Id%qBbDV^jGvl!r;b(J$%waW1>X=2U)R8y} z?_28zDXFv-%6uj9Sfc%JtDGoUk47WPyqjjI4CfO+dm1^DzzI>5!vJ24id;?@Bn+@v zwmXUgK%0^dXTGv(YW39TY-2AANpF3k@4yfLwk+oDyEEQw{ua`+!iD)S zGc%Tw_~j9gEoKBQBS&XC{PP``T0Aiou%+5+hGKh!!7;IZY|9jovMGz`1FxTxrrv8W zy*M^b_O(5!ya8H(bXed6D7x4``|TScxpOx+Wp+ZXm(6(mGxJ88dNOI0xHC`U+9rN# zCZ!D2E(33UZ0#a4=f3450`vmmhWpwtg>a-wEfnG%hxzdE_DfQ`Y|K#e3X~6p{FHl{ z%yV@MaON`9fmyjzsruT`^W&VWG^^Q9#}0@5g!V7FB^39yAvcZ^PUcvH2zj=$U0O83@>b%*)+{Fxo z2vDbotbpp2S;~-Fh(i)2AKp2mjAgp=zm_lp=!VeVk^h*s!8c(enn)-gZu6Kel6>~mRg*oP}Ed1nf(HA`0<-m=Nymx)Tw2{H{8tvdl zoH5MC89!KE=4)gl>Ey*hiXFFnh9)@c|I|$5oRQ+-{&a`)b|NZ_;!QqtPstbPzYvO$ zYiZzZ&h)_V%>yrWS>VjrE+up5#@#Fw2}CENYKRhw+rRhBSrlN4Q7cI@v6ZsgMSzYD z@dFe?Qc_^e8E1k?yQ!Bo#l1NxH2U{Q>qI9wO-7rI8JT&DnQJ+M2XIJoKHIFF`(KkBp<&ih(H80Jcq0dARO_PWBc+^k$|yt5rM_BC0)jBEW;p*|X*pq4|>VF-tBy9Mj3I6)8yOop5S6rsoy3 ztS%$P5p^J?BihRMr(5Nq_C1e$xn|V$4RZ)fx@*_b#TYCdPZt#b+HW18FHSzqV9?d* z3RL9>s2oH$&WYge@WywC{HBX`mGuH?BGJfGK#zIA@rthy1C-PU&5inmg%mgW*Sx4R zZD}fqW~b7eyFpM}pcLZfgsQZNkeKC>lx>;-UtH8a(3+NzWXSfBwL>&e-jMUx_h$j$ zw&4)PS9j5PvqidtD^ZEmA8M7<0a;1a30^{37yBFT1~dGCs#^ZqfZRjWBGN|e+p5bwM8Ea(Ss|?6I`WI*M{h>MmZxD@ z%8oF?EctC`w}FY07+9~D>v?OK?p>8KbeuOCRg2Hd!P*A3i-8-pA-SfWF{?MFkYYsX zLfisM`eKF*8O_z@kU;wKvpv3YmDx*H|B#6ze;F618DTSK{YIJz;a5{VnaVCpzN zs%!?yHXCo0>^Il3bcw^iH(g1eDN5JcZpVU%CmN~7$$$92Pg(GPkO0LW#S1MJkURq+}G(OhZHArIL8M_>S%5j|Y;OimVPVzBYBoya2{ zNYhDiy!UV52`iCkglFpJj{qS^NW364D8nW95{5Qv20)n+u2msDkC&hrFQw%OkuHkXNvZ-K@kiZ=fSnfGPn& zLSbsGEhCCm#(p9o*6?4@fA%rAE}k~}?6C;`(+?6Y^()rG=fr`YY0f55LbfR|GL}Xk z3b|we$Tl|uVXsUWAyrljGIrnmea<};#$~#$xJMD(c`pY9R&=2aak@-jYGh<%9RxpP z@$qJ%PEr~uVXjP9GMQ5=`qzB?O>!i#auH1CbS7?M4uI1}aV9AZ`WmMzZvLo@Js@C&6SB9|K;y#@!bf%(OhhNxyUcOl(E92pr3)dxn@fQMq zY1U{3R9fHqon+ZuhI!21l}$LK6m=_xl!DKMT=ap8X*A&C%84q)K8bMEJLr!n2;{@E z=1^uKPIS72HDwXR%wgrZ5kg+5kYEVU6)6~Yq@DfT!~jbl`725XiiC1o8AN!S94VgND<)`cW{GXvr+HD2pB_^ z@K=sh6}6BW$HgtFpX$ zaLgyi=1O}-z{JtZb?>g27BbI39UD?Dzdwo*xk{)J@{EK}~1Ba+5;o@q2e@(9kvX=_I$2O+OFv}`CKzBq;4vGExJ8xupku(6UJ z1`$_qRqdmN-(^t2$(!gU|H}Z4P*7b<(1)3&NyVI(r1Hvz62m1*y~SE0=tRwoOslf4 zAxcJ6#i$LL1mjd(xvylw%d@VowaKi64K{I;R;ar^VvtuGjCGYZ)JmY(5Enz&7-}g> zkP@L+cfp9DT4fN^%ATDD+=)=Vxmd@+kD}g(5q_Fh=RgofMJ_8FjT^opc%sh(5eX6L z1KiX}3xrG_C**Zy{A<=UgtM`nn0=}MwK}tCHU$y2AgU@xT`M7yMijmy5n~RSI+N8d z1tX57rn=lw+kmb{St}>VAi@=NH70AwJvB&>r3l0&O3!44(%U>(i5b#itaeckkw$YR zShzC1l8a-Uw}mC;td8Ej0BLQ!*qkP#u9^bOymsCa!IZTSLR!A8hrfZ&s)o7y!$rSy z0&H^a8&y#CihKT3ctTz4Ak0BbVCYy=&I)d3R88pjnh~X zQmGBUO@=A3*mMJa17@88-xyV`gt99kmva()I{D6wnMTt}O2ckNu5f(sohuTkI+u7o zdZs}G=BPa76TyW6>TG8C6AB^~U zJI#u?vbutKBO2)H8mTbQtEJ8A>3tp`7iJNE3Xa$Ljg3wyhP74yEQYlMrYCci|!B}RNI;36JTjD@yE~GU=M`kW7Ek+4!2#YPT zKuE|$Bht3)`m!hi>+sxv`Da4~>QU+)zbliZ>l8@c6lt_ln)k)QtlECTeL^6uLHs!` zFmdX2ZLlJ0Gj4&8bSH38DyzMe7#v+*TO6F)40@o;=OOKp8TGjGMPF7YU04|I+2=2y z2Qhvg*sY@aLK>&l>u6HdX6FOoD(-CnfPysVuGC1VWo#@L_KRjJ)YT#b5GHej`b-XF z-wtI;8Dw4cdng!%${&DtdUNtlM8+za^a&t}qolu3YARXREIUZ{3%CTq8(y z_s%@-dC_KX2_W$S=UrrcWMlOU7{0wc?p2#oAqZEiiywlAE4nI0`~=8YS(zs}TsK&l zw-Pv00mHj&L>ESJwB(`W;L&r#l}-#{1VUa;uroLz)Jo3c?1WH3IrDR)vsiAt*y5F@ zg`~q6!;0FavRK{8|p9>S%(2>Tk=^uw+D9X2eY2u8S&t`LxjQC-S8L&C{xC?Ryb zE-J2Is)X{+JuhmN^&{l>4htigqK<9YxakHbP-DliP4*fQS4mVW+&P5i)A~+0q5=!V zys>3%6_(SL8`x1V6z*7ek!vp63+@fsSYF5{!;kr6zxMib^N2a9P3MhYB{8wkE$RnK zh;;~Iw*5fwyCp>hy~^*Q1@P+D$a>f#2#|}i2&5%57m^Rj{9%hRCopq&`K$tR=`_If z%BK|$uF$_RXyKiKqPseoWdT11iYbw8MMdSTtP}C%4TWiAoIzb!tfeTfu3|wBpf+dO zr|AIuLbJJql8P&sSDbtf)ydun!Yy?R!Vi?PyYN>iR?#1A3ms|QJvR>CVH0v4*Hm5N4TqU+%BY2T#i0#^?05*Iy60))G)ZGFmx0L(1xD|UzK2jo zw~W4rv_rQ;%tO{g%R|*e%tO`?-l+Ck*CAM=>LOo5*ihbR_R@QT9^oD-4^apK5zpvWQA+k%@vnC%**6y-gu z8in+G097?e;EHjIkY5>)Aoqb^V6NXlKgMyg?qI7QGZvPG6kQ2K*Ctmt8@{6ow$E{qdH)}`F zG{t`zJw{U1^SE7oPMJ7N$Rn!ud++w#f@08}9Z^MUZcH>P*0qqzkP#bE?JNUKtme!AjY?wL9J(oqqA3JhUCq<7MtW<*K#i zATAxjmb*rh7cKF(`u2Ynh*6}!C~Rr(H}QM`))Nt?PKB&qiIQPS_|3z+jcJZvz7N~n z*b|cX?^j!NvqEr>*qY}9zigJ63K3KKoW^JSo0otTEN^MuB~&J*q&OTTED!>!%XH4x1 zV~|!`;5>s=53{Tdv9!gUhpmSM?os#DZd!vCLIum(8rc>=Au*3`RuCnHsQ6*vgp@>- zf=h`ZDpXj-S*#c+stv(#g|vs-L$kWMtYzTzIR#G*$u-1svkqevnCUfBa$z}%2kQ|dDnrQWyc zkuo5$$iOuNZO@^9JwNN@qqYE$F6T7a5uf5Z6_N=NiXlSFu=pHVFI59a1&&T`v&vHFGFsv{jSoaqHUSlN(Vu};Jys}iSA&EiN=+{0 zXzWuhUeqb@g2S;saewk;2*XhZrZH!1+{s70WafXJBi0lp#9JEq?sCHws7&X>j=gv9 zakW8(5-!t)N_XK8mlv_pi%M=PL9t%pN<}?&!8r{mbEN3*&y!w$o_L$-H*b=y=cUm< z#7aNgyaSvi%J&q)6%63WuhcdwmOQ+KWvyvCJRx&E=?wm1_@ZFGe8pXtCD!K zskma9$KGo}CLuhy>3-j&aum*^wC2~EbUuj~SH7fypruua?u<<+%=3O1QD1vgFNMrL zW%&+w)ozZsGL7N_fUVqYIa)U1XW_7=0A4_$znIS2Oak+%L^pE`##;BHhsa6(t&-T@P#`gO8qTk4VtQk3-3z*3?n zgcEi`$q3I5hR_~-_^p&d=(jgQPG}~Gq3H7uqeH|E3-^iRg@Z%QukD98vB)*NRQ$wiHRfXT}$<#EMM@&^Hi5EQ1Jrm8P(29w% zfnG-RRkJ;>DyDfNf?kRgNH5}hk{KYNnMbUQ{WPo zA-*<5Erqcwg6UQ3W}u;ztYgzv0>;h;-?r(0Omj; zJ%{T%2K^xb{6o20*UsU_k1KOjCWYleHCl%p1E-a8$QEI|o_83v`H{i>~{|_>f({a%T9x+Dn_bg6VZ`#9Vs_+vM0{{j9Gekf#000kVeAR!Jr>QLZ zHCOe>-Q$g02VnLVI6%15#UsAC1zlu|>2i6r=ZM4A8qs>VjB0Km=4t*^FKzpWM5 zZL4vsxy?C_X3nj*n-FL?69@^<5b$o22taf~@1*|wwS-AU!U$^kw?A8zTUWP8(1+Ue zQHXjpu_%C*c%;?!1pBY^m29SsOW64H#2=>95B`7t;A1~I_@+7y2Mai-PX0oK?+5Se zLV~1mib+d+NkudW8&a+0D5Ddcc+g0s^F1NXYNs|lSD10>F1xK zlLmwdCy(C(z+;+^85ecy{!wkir=gQVjz+@C=IfT037Y}k&(spr$q>85o;s{UsfZr; z0s_)DZDeBRPCS1y<={{whD>s5s$OeP+9cnnk2t@RC`aLUh(~2!4(<=L+rLr=nL~-3 zsBmJUBL^jvHo^iBH4TYsn*|y9?COQ?KiQELW z4M`t-$*F#)%vDRAH#bpIQQwl-OhGdc`s7ow28r2dL`FtzckIOzj=o}~nM0g0LA!iKU*n(Y7!-edH4~%r;+Ap&oK8Sw#~t-&r2bo^t17r*5fp zMO>{=5+mvvB|Ge+mGgsB!}R7(DyG|;L?2m(Ws9MOCnL=tJV;iymLjWaI;M&wDG@7U zTZ{!Paz4Ru^rgU9K}RBm5N?xpvo{*sZj)o$+eC$Ljw!PZh7tOBLZVSn2u2NGXU+%K zdM6~2rXGwV;`RF}cY-L`4L^k>H2Py@XL)U)B^p{7J;A<=42sU~42*qz!Iq_l5sskH zG=qb{JPLcb@F`A?kS~1lOB^YLj}&Q2u=q4WTyoEi5nM^&Z{ONafIwNK>j>SJLN=P3 z<+9~h$y}I(&gOYSdD+{ovi~)4iCDLv!7sS=Qg{qlKlPJC&@!ifkVSa9{L?1nchY}>gnZcLL)+X25{!L?7R_5$@v`wTa zvX>@MSTT8;N{L1a%kz~$#YJH1%S*30nk>eWo9|Gy_n_-;sacaTbqR5Iic=1Kg5|d! z`tbUl-S*5@v!Vk%v;OY50)Yot;&O9I6((e#IHX8=la=bsG}leM#6|o4lhFho%+t}G zCCQftTbAv3+-^eZMEVRH6BDL^opwsSrkw+Zl6gSCg6d&**SN(yDM;oIskl?zl z1$+G*Nw;Ye)6hM6##zSs|2o%)d~{Js^``ZnbXcltxM9A2)Ui|{qW=;kX#7}sGgEU# z3;)#rCHgKqK$vgZM%W}gn5^uSG!smkm^9(AM{kyj%;#Pdc0jMB7!xK-$L_a=fBIDv zBj!3GyS1SVc1b_Pq-`3f8skB;fT1|Xn9M%Uk<* ze}lJMC3%$W%n2MOi@Z5=XtU|oi{(iIH;t8(V3S(W2oCqfy7j3#Byx4h3QT_Mn>WZ{HVvYIWHhVdOK*jg^x(-IUl!A$2@o!EgH6*)j|! zNujIO)dVq1VTN2<2#+4eVavBIuWiDpnNPFnje9!c?MK@;&bOwgRcObwnL=BKHQ-D# zIoY8TiskL;e+~asglN_xD$*w8X%&oy9TJ1@3@61+S5eU=%1rj9+Otl3r#+hY!|to~ zY;8=Ox>7#4c-jf&XFi(`R;lUgEb4wgJykFVodK{#yan!X>6%E`q|98mU)ISYbd9?gUny5e-9 z78{FNOv(^u=J5ttq1ki^rg|)KpTWl}h|ST;MDWk%o}QJKMEjMJd^O0CMv}Z~DZ5s` zR@x--k{)SPX1y(DBXq)ZJ2!J9M)y?ber~x@H(FmjHBIbGo~p?5Xy%d8__^gq+~`F6 z;r8r2TDXjoNSyHS%Bc>wa$Faqcfb?8ig0qL>^-|jq4XTG{T}qMRc;7 zO=c8V$(S?AyKbwYf>wsn}vS7z}KdG*d6B*&8xIRWdJg2YPlCQZSY)Q*snlgC7rP9?@kR+B7W zvr;BYLh5@dq0U_PgT{5q~#4!%6a zyR@fFGv8~`#j_j3d0rFtI6>eb~qJj!QmFAy7p6kfw}vg0M=Jy%)DK&uHXWXhH-yCwr=AJ;?l*z1iI zT0QizA@k|+{d|Aa)I4eYc6wi8b&ESWxs!kPow}63#7Ub;yQYG<(fW*k(Qo*($}ut5 z+qEwoC%G@kZR+R4#3QjYXt(!|@h5pWOoB=1|7IpddW?4r101!sN6Qj z8e?SU_5zW{BJL+Z{YI8a^5Dw}xP!O_Qm-{^1Rq(e@}sz73J211I_(H|5^^1Kx1JKy ze%bp)?!zVPmsSo^UQZ4C&B4F@qcRvf#`P5~vfvy^7Wl6IqYHsVtyCboWpTfg7cebG zff9koeEBs!C~|8|MJ?#zfmR)f;e9UV6#D~N=RkFvKHWQ9w8*7YlUWfp94a?Aw6s>E z8b+9oU^hvM?T?d=x1*o#55ILX-8Yo|HGylHfnP{&G^8J}AkGS9!}e>15RD$bdVK#G zJH4SbL}h4mt8>lnWD6Qn86-v0I}0X#*P*eebO$_cEgXvO9cgoAZfbXjO~YOx5`9{a zyIuWJS*i*ribw4XWIaWcrBP>r!Xz8eD;5PS8|dO6-!0Q3cYvz4OXH^_&bL(TQ}~{A zK?GrJxrl?_)@lJ3iWBn+K|*ox1RE)?0yoF#VZs49IP)0avqH#ZtdN>ZB^W=KHT-B} zZ5&Wrnpz7-sMmpPU=~@&PBp49FsvqKI}}P70&2o+(FI_;OIN7DWTmBn&VXkr*CsSK zL2(ysEylqT#7YRZ6h7)_C}NL&*PiT{cG05P6=0Hp@s{;rFQ_9;>xH>N^8f~5q>M(N zZ4p5+X;f(RGuXrmKAixJlhKK5TZU__33|emt}R@K@kBykecX1s$ha8eGm2}sxZ6#D zL0BlI8&h;uP3LXT3T+h}s*`oPO&gc6QcRE}FnDYMpLkRXQtDuAB*RmsGK*sPikcI|}PtFS-rYRYE|sgJ7;8hE)dJlr(zkjx^FVqEOe|7V=QmO`t*8DYc>4 zTdHI+nFC_~mB++m;bW079w}dTsTYC1m4M2)FTStsXe-piocTY~OaV~i(+k5!D-6Dt zNn4NgOf%-mg@iirb|U+8;Amj}9I=KLf{onqSeLM;50x=Yukei{$GJS;!36_^9Yz$X zf;mDMI82mzSwLQR_>3$H%H$|w(aH^TI}{c;c}Im)5Js~FiGf_>333)}k!G~Q;?|Tx zk&Oi}J0s$|93A;4m?uj3tRtRAHBv(3P(e$lHT{0R zslf=0$Vd zR{j+bgk~^?CBrZ4w_!EQH^<6)z^NK@0n6VHIvWD?ayGxt)nr0ITf@V6>gsIef?lEUI`p8Oy9Iu1T2q-pM74=^<3>HGs{ z#B7FPQa^E^5QHhZWur&0LwzaOEe<_eM1ypJqQ+tPQvh-stBs+`!o(?KaXaFt9?@BQ zb!=K!iT-2-PIzf?5oK3JF5{hA2PL%rpxWK zw!jjs0eGhfjbWt3n{5bl`C*yS6HehoMtT(IV{QQcvbntYOU69Kids%Xr{IqfV&xIF zJ|-^JHQOd@)6$M81v6+|DFn^hC7gp}_p()tvSpCw`(TY?h&HAkiAPI--xVX)+KHI6zfL0BMF87a9qq0wef z&k!dvLj9nzyMSB~IATiAxWyaE6$OT1<4|W#i?u~@Nz8g0ZfYiB4Y!a7sERDY_1c9! zXIP?$_ygj{K4Pt^NF)l4OwI{~F(sZXbT7apFpid?Dn=oY4JWX|so;Ja0Wo8~HSrY^ zP>qt0%t0nilp9+;BRs@_*Kw3i80R=Lth;ql#RC_0*ne?O%peJv;f#%}aT}qqv6lSS zz>|%d42;AxY&D0|g6{Td2PTX0qJ&@_+tDX?;RBn1&Xv=Zt<=F-pbX~sIa$?35)7ix z#)AeL7t=PA7`dH6P80+UV8UjW-~L=*IaZx{8~YdQc;IfTLGqVKtBaM%5RlyMr1 zAy9;I|6csxZ%^J1*1hjrvMNk)gy>;09xx)b{~7OUt6Ad)>!zMPPwkUnB&XOc(H!8t zM}p*}o9@f={djQ#^dOZECWDAygi`8 zv(b@bQbq;mBa8f-f%5_!J3JA*0jH41{A)JHt4IzjSY8g_^MO2!JHOk|ojTB%#`f9wsujjeiwn1r=QiJ4$4HjT9 z`v@NfQsm${vW`R0wLD28Z8U^om6p%{(9h>~v`g|*qOpYab5L+%uQPOT>Q1&@eFY2b zjBRiG6M+VLIYm>`x0`R>M!EvL2v^w@CgHn~QMYM=mpsT)Z8s%ydk*=xo$*ZCBFGo{ z`RaByAT_8t?sDqJPe>CX!-HR8X>l5IhRg~tocyt0OwIQnf|eQxF1(`lG=v&`X8hXJ zU_Sh&?P>SI5CU?H$6LYd=(8gKi|QP&b_wJqSGn~i*r|%-n$@Y4DPX6o&aXZA(MI4p z>douyb&*_48iE&0=^hh2&nxeC^H)n(#>)L`#%{aB2qa{geP%a~J^7o4o6KVuA}*3>&S#&g#EF`|3$ou$Tr%` ztjzUG=YxlGbsKC1Kq+bFX~0sXqVFknJ+cEVvWPgj7{|X?y6AZ?PP8((_sTE2$av6i zfMJ|una=ytiN(Wq(LrqV_r;cJzV|JfOZ7xAW>K>2_uM4C%iuNWqnkHm%SNSZ7Mp5! zbZh$PLsrXf$t-WdnPPu$Ngo|@%Tg?6wPl&_>6GT63b}=Yx>BwGKwhMGsHXi2$b9mvHUK^-K&WHIJP2C;b3tzXo(>je4-T ztDkF`D(K-vGR_uv+j+8UuD-(2{Ix5(NiKlDryUKTXOhhCdcC_M5k+JwdQrk<+L7c# zh29Rw$Rah7Lx1Punsl)%RDP>|G6B_%#xKo}DkzHkk>Y!e=9GWVb7Ej%yuDXa6USP&Cx1}c+tTdi}e!H>q z%rw#wL|#iVSKR!IR?s{m6tJ^dG?!3?n?gTXZ%uD;|E}i~YF>@r^K4PkMt-fhbd%qn zUDuSeNj-@lvhjkhn=kL3c0Vq6M^yZJ{e*MPare|Uu~~4^p)FHHH~LKehJXw)`?*F3 zuCe8(h2pu*IB|U9BE$*v-ml1j^fJd6Bb7^G?~->0Km{R~;m@3^AQb?Tm%&#dwio*; znFE!dp5J_ovp&}HC2Z#hFL9|SYI7ZymTx=9Z?H@6xWri^&3JP>c@V6noJGZ*O9yP~ zO82w!>x^qewkc6J#$m7tskyhhKJ`Mo;` zhPFE!vn?VDYLd0!!B*z~l@dw07XS(-D7G&t&bX$@#+P^-KN|%kuiRLieQ72*LB0Re zLFN^xa!dm)3&sXce$58yF#aF|G^pGs+!mnsuP5l?(>+4TH9|qlcCL_h{R2SsKbSS+I<6Z zOy;kaE5MJ&&Uz8cV(-!2V?YBKVEe1n4Q|}K%Q$!B#bd~wrVZ%1{r;LdQuYCJ0M>+>0! zvRa&sYFG5cH3i1cN%l})@)zWs27s4D_-i~`pl_}ZL&HWy4S(E2>)iKzuR$*B+nM%h+h${jWeqxbL>OjqAc^&`OILoTdpc9@ zR-0^}FzmCg%1nt=EaTU44dr_H`-{nwuE_9lSr^4nL56f@jV#yNv+eynLaMp(!NrC2 zYA(D`=7GQK{J|5dUJQqb+g2lvH3wX<^P!JjDz?H(!j@>TMvj(XJ^EzV5=iiBgSI}j zLU4>JZ6k^!;TLVhwh;L*qrcx9>68q75z zU)DV?THipQ86R9QI3w}32ga@Dgoz&Bct6bA@dN{iCaxYT%`J{mYYU;oz+T>hcwc89 zoDbx=P`_m@`rsf6GdmE-Nm^%V3GS@~|CUC6Oa`~4=VsRju(nj;&B>OvamSd&pe7$j zU=$Z=nArW9YHZ+&fLyIL5$3b)er4tKe)Gty(S|elz5VRc*G+K>Re)h~ob#2xb3lX) zi!FBCTt;W|6xC@kam4uiVX*UhoNR zOxKp!L(0vHnGL;krt(HSet3bE@aWEUX3+zj4Z1`yLe#hWBMyFzmv#`#fndl;&_bgJ z%P73y+OelO`wWaD%g1gS<9M5b#=&oTMH(L&>uWzfWylrCx8BhCR}so1c3r)5>6$mN`3R=9g~EBZFINulaJjma;^6e z_i$pHG#Q9xt_d|vu*dK>UP+6JWIoSv3OU{C_rF3}*F+7C=Vif)dutd+IpqmR_-lyS zHG|y|I>;j72B@%Woq7bdvTTPr7>7;=E#9q!o2)cZ-TR71AROK>7v`=(*7VgBN3)fc zPs-?A+Wh2wc3g*3Cb_n|65P2&?Xbd%5{#f%n0+UL{pD!)97+>-CYgm@m|4Z*n#9JI zud**Ww9^8fAo?*Iw2$U@dpxd@R3 zg83$H2RMH7-U=XCOYCroN^KQ`MPAjzD4IgB4Z2%@NUh6^jgXL?)-BVxYGlk?Zc|yq zm&U^U6(NJ>j;thhwv2{1^oQ2bfOMC$Dzgx#&^>e?x&p!8&&zL9)185U5P6$(j-B_` z0v3b|kq+|i*Z*bLNX^SVj-TJyFo?^0m)UM-no(l&rAD!uf23Xfkl3kSOd_6WR?1fr zo}cn=_6)nJfSEOgj5UQ+^*^-7bL5L*EF0e<>4-(4ZY-9@ZT*QlYT>f!6EU%d55oWHxXS;4Fl8^F} z$d88&fw*A_ZI3R&z8%l_d&1uuS{dP3-A`GF3E+T6^Mdh1TTQXzH^{L zupV6XPrPP7mmbd~>WUe!ZVj$zD6M<(!q~427b`?YZ8g4sP)^~mgfL6Yr`2L=Trhat zFVY96MtA;MD4vK%fbKDyKLD1JbpOn|c`UUJui3)`9_PLmXkJGj zA``iR^vmTrAIHtSMm9|uir>T#HQkP9njdZsV=?c&8_}HGH^3 zNz&4|c)3T`ws>PQ32S7F7FX};N*5m1PO>8lEObzkfDZtW5dh2(K#dUqy=VMA8-&{g zwn>mc00Irhx~F%u)>T$rU1fh?-@n%49kQ*SOWagFk~<~Ja)-ah3tj)@A1ePV{J)p} ze96k6DESqC$x{A2HOTk zi8l9jKMps%X8L3JZL6wQT@=IY+4Z^K_Rn!+z_#_@c6c>B#Ldpngq!R;7Czyx*IL)u zknF@F$i2F@?DSDm!yUyB!J9S^*5JELqeox^lW@}my`Al~%3k_Aq6F?DUGw}B+b8os znjN1x3~=VTgC8byY>iLE7oFo1#mKQJ25(vP;r%hV)8@6c1pG@o{Yo!f1I9ye0q#Gq zX)7n1u3_U7Ng->DH!ppo&U0=9Jy4t2c&Dzg!n%$nM~VqJGw?@%myAI^<<#eAoI zGjlaX+ZwG=-rm6`IAus_+FFOjwyA}+XT%XDopXi7M1GbyLu~KX6VkF6Meoxgo_RPsy!AKgCEfhrf?gh;a0+B8OAVKMPs!sn7UO_ch%79DXg3e;(hWi zR<^G&``F^OXRf@D1x?U(=&VDr?){05xzAWMl9%iSM*Rt1fxP{*!H^}R$v|PHvOLwV za_@=De_$to9LQf!{Qw|ePy~~(jdqUvqKAk_9|~y%Hcfg1o3V^3nVh4Q{wd-#2yS-dNOax3TYO;@g~ga*<`w%` zVZ^TG$(0Ie={{{jc(bp~`Rs|meyt_vifSb4=T3uLBmX72D4|w!E^O8EeSOQNnXR8v zbd9FXna!GlZH;&3Y;XLOUQ1+K5;yf|&}>9_BeZo5?Sl`QPKCkH5RtXEBi2<5ZC~qU zGHZ^XtNL%ju~Xi}KEWN}r1)GdSWAX@I#c3(^EICj$;=2gcu~7hVwKv%{NupTw4{PB ztkCGY)O{i*r(*lKzsYw17Hx1Y6ATgWp0|rbeQ9^XG#tSBM&CfD#0RW zlGnwEHPP$3n`>~0LQDKmCZoBoXe9aXPmOAY@l$3kN~X|~Gn9CbM_N`AU2#Yi&KS`LSy`Z zp`%UYJ)EMw6vH`d)|vsw$&XM%+~!};LWA?)s42OXHc6ra1d>^qjlLI@C~-Q7zOq3t z(0bUj?|D6&$z0SFXJdj_>E~%dj3^VGvmv}+mb_4g<=2219BHItWn#;l66VQB`Q3t5 zh+Sl4-oZhcl30_7B(pQUsfUa)KxOS{j3ZT5ybI1w@z!z7HJELeeA+Pc?bzd6)AmUo zvjes!y_uWlb3DL%Fr`L1#*tqt(iP%sDCvm1ky&Vl)w8bRNiMq?!scUQAW6z%v>P>4 zWY4h+qg7%hpy`v#vh;rET&As`JC`!{{p7i<|Xu0&k!++0bQ6WVJDT^K8X5eKc&l`q}2;6 zxoEUAh!^=LU?lCJ3*P-}D^>ZZvjHaPc_176D)rI5(kx1v+|YiI?rQr$fY zT;B0h9bUxY`CevMF7dN@uKp$t3VT(%%kUcNu2x>)I5P>r zTd*Y@L2RG7tY7=9jIDtwYIvHicbn90T#7>^?bmwS7^ZuHq)QsM_qT3C*M-8Zj>^{b z=i<$;FCT;U=;x|CPfgXak>I9U$KlQ5SK99B#AHVg3TfYC*vVC6P1MWdzKO7j*HuZ& zHQvbE`ljB*zc4Nf`*w zbz`sa3t^Z0g)^f+{nixu#6kTNOi+@@ia_0%>7+ZBZ1G)TK4z!bw&SWD2mT-)WTNOH z+aadNBDSmIOjq~m?T8!9MUna~cCxG;`K8d04&tzrW$ip(L&)3jxfA2G%FO$yWP613 zEbUw`$i2P)V<*~n47}(kxH(W7*P1;^e@~$80AkR_K&|Z)h#n;qzk~z6g%l+~YY~n( z46^gO%Jn_i?jV@02N`Ny36saWo-}WhBLMS^(%_V-IZz?!+RJ+Af$PQZG`R#^UEoA7 z!ae?bKVq8}N`QnbmkAP&kXl7A7(ZKKRP58>1l zO<&8%sHb^zqD;Ya*Fwpy=qS{ozLJsEfYp9nw31VPv{-&kLRxvw}QXHkl(-(+(0{r}exw zC77%vRqTD$3~Z1H$+^1NYl-Ttv<13IH1I$>*LogJ5<1_S$`J2%Lq(;bVxWltE&|RM z)oHw{2Uw?gyy7r>1;QxOoVfGCkYOq)LO4={cQZ@}b%u}-~xs8&c@A{o7K4m!esmBzGSYN=BH6(#GNg= z#G4?ZXnN9!7D}e4uokF{?$Hu|9>!~`k{9d6qwYwe7Zo`nFA8V)5Kj1CVj8eXYIIWg z*djPkMzhVlXP@#pAcxmLT8GQ$F9#8m1>E|!t5taO3d@_YuMg3L^Kb%sgOCErF4PdBY&=6c z-8iJF+)s4enx5O(hbC|Ak7day^He*5$Q(-2jx7*5>B=K~TwQn&8&e*|xdYw2+z^zZde z;Y_$|`gxt}Ce)oH(le*uJ3siJw`D6E@V8OP_KF#go!;Ivf^txg+1Pk5-k5Dms0V{sZa}w>Kb(r(9m1 zg-6obtvF2^n@^KQH}15KR#>!Zx~umSOhqaQ?2Ym*L@jt8uZ(BF4PQvN$(KHiq#TYT zF60^e|K{N%B0PB$b)$qio;^llwkH!-KtZCYlr%Tm007pTIx~G;b+Y5hW;NY`Dg~mw8|+#ID!3 zwhaslRk74Wi>8|hjEryOkfg67@zFlfj;X;WpPUyUEExx1R*0A@Hv^KCwTMZTOs^4S zaimfd`7Y6;QW9)OVbP#rCQTed*E55=9Z9a=)ZfsJ8KE2Ww6&Lew&s!PKGXVOR~C`)^rC!(fr5LW}BNl zr37I5=c_daVJDZJxncwLiajN2(od+eWs!m&dl-e-l9_e)JBeEfVe)~=Vv*^qv6Jhi z^kg0IpIn`R8JaSIqC{dbS@pXwgA^wUjbWjj%_%Wb6$m(6;S@(rKx%bYEfF`H%U)mM zn@DLy3FUF-Xr)S>QBysI-?OGc+jrnT))LrgNYX19zlQmqrrcx_xQ{vpomb{-onTgm zVMkIysPk#4mNYpWZEysxaAtDijGE=C&KTsHY@FG*g{YLsnM96>9>kR0nfGZE?4=|t zDQm73;(g*K0KnzAvx%Bic_}b=J72z$^}^qM4#%GC<2-In8)u%*&fK0i+|oDB)}GGX zo;TduH_qmtGq>lBTja)>|MPR}-8f0J0s?NS^b<*T96WpfWTW692K@N9sv$`uXQRMWwUJ zE>WA1>Eia0$kv2n@X)G?(KShTlbOJ6NYt~Id)j3l<=MUr3_jmhsGX~NOwf}MX^fO-5&*4UxyF5x)RyuD~3X)N7YcUH;bOW4wCst6cD z(GNTXI^3Jp0v#SXZATRgY+5BK4sngh&RPcy~0b4}rL7sm%}cFOSds8l ztnAvHlmQ=jE(QWks(Ax z821MG`Jk4(S%d`v1lYWbA}u1NEd_PZFYGy+6CD#`rdg2?Y63AJ(~Kr18^Ew-<6;E_Ix1VUWU!=_?t8IK|8Xf8UF zU=s}QpaKEzFf7-rr>}%IBbWsZQ?gFj$k?6T=#B(E=PkuF&-(?UC}IsEsT3sHp$HFc z$?Be}65vdv+(EDFD@>U59mF|JM?gdauyq)?Fv%50Nwt-*@gCb=pHkrr_`qA{dYYu{6Af3q^ zR3v+^?}e8_3nliM8ShNZ>`ModJ5*BjtoH$}NtC8S26gZv9#k3oC?ZeMl7@PSj=J&n z7Qh!oO#@(V+BI`~t^qCW2F$d3b06AnL*R!ZmW!txnFC!8IK9Rjvo)-NR%7?8;7ZX3 zY>fe9n4cSY-3)Q5&Bn%fJ?xDAc>7s znkZGekp)!G`9$FW2R8A-;4Vl4d`7Va5}K~dxZny7VYRnzl==dYRZx^3_Atjnx-i}oGI8fW1G6<;14=ncQgU7Av%zj z$EBGkW4upCmvGr1k-?*&ii|EEz-*>p&MS!*h%rn!0fA6uyJOJG+Q{p&b^6@XnzO_O zR7icqt10(nfC}i*k$C%M?fMY|&dg4LgGBGyDGfCB89awEJiB;wAg*W%d3gM*pw0(`o7as5|AwP%9KR6662N3To9nmC|^ng-uNl_F1+8i(}J0>|2 z{25umcLgVFegmW>^Kh3gbDCUX2%sd1tX7-&>%_}|i4o5v>SBg)86>E2-7gJGG?8p; z(@T+jCZ`U}<*7yfTNu`NZgEK>Ru6nCJ(?2_6ZGOyKgbT@dL-+PfV1Mtc6Gp z-_&%D=K$eJ(Dsb|Vgjf|`TWfHs5)zRWwaeGqw10{Bgrbet^*)RRYB?!iEnN zN{AYxgvvPTXy7DgG_61s(v%Vzuow~*Hs?f-q6tD?LC{nYDHmn59WFAW9CL-nxJ07O z)50fI#}Ps!xS*p=d?{DEmghU)u;sSpA=~a6mC0yMxL|HN+|p~niLNw)n|s?|-@jTS z>3-yzby1-iv7$l0xO!&SR$Uy7g|ZAp6!N#b+D#A31(EH+HGY7(ywxICwy6sFdtH|} zaie5+%849k|F@Xzr?h+@D~h@wNN9ElhD1n$QXQcG4%%Xq$L2JTAbKr4E{n#h(HNWH z;JmVQj~-^l`&xtWvBC?3kFB@9bjuf@^|5Wj4w51Vb|KCrwwDM0c=M`YB}?{6bD1fW zBxym3LL?(w>UH;}9$kG|yAz_A8Cp%bt(mf~j14oIWTm<&4g5*cXwJGE6A(|)v{!jp z^{TN<<<=`G^GJPpBJ*HswfuZt$thTN*?kE+^j3S5I@K&da-QoFKBP5wKLw9Xr)UZl zCn0U;`N{Su`8Qi6QmVhXeARSN#!?VPC_&h>>S#4_ zwLkezx^6mo4qdsSLt7&F!=XcC)cdMdleW6BM&bKYcq94+dGDi+^3s@nqG4g++UJBi zG<-=>{X=ZSexx@Uf=JvCb0yBVtrFk7s-#}koltZN4ZR?cx<$XO;)T8X%fj1#}6@_G*f{};+e|ZLd z-m+RHPf8~sP2tt-!4((rsOhrbDMS4qD=Fj_l~xFiDo?a zg1Y$KJE|htRh&KgKo}uHSCi z%7M2rsMJpn;6CRX@~wNv1~w0VLN+oztKJv*_qj?&8k0I8>F2hS?_;-;qc^H@u5F)e zodH@XL|TWiYhU3DA2kmyi9jgum!-TwxD&g)0+W5zrAG5@i% zBTid(Eo^)L4}A_>zSWcwzw`bx=Pq^tSwN=0Y_#iawReblBa{UT`$anZxvh608+9Jx zZtMGa$FT!UmsIMeoXU12{%4pI{8N<$|E|6!yfo+@qrX0u{j`aH6zqCC@=8ZN{xwlm z_TeduG3M7oD<)Z5XCJERAl)Ygo_$6(vnZXsg7s?@V?)jjvUTBSl$hX?#=Gr@O9OpK zZ2}q^QQ<%AA#yT4ZFrRa`O|_1Wg%UDOO0qSGd-GWv#{ zPVcb23yP-2b!Sk9_dEQ}-9PHI1hxx34BjmEs;J{d+fOGm*iTb>)-Ky(SDI>qKFMXdl?jADLdT-35}- z>D?6^Y5F{=9ZuLTF91LgK~E78J?OLm`6%&>iS$LD*w|6OXGK-sU11sxi4_*$7rmWe z5UJhTZ>YykPZF6ZmkCpRs@24?2b#IDiu+I|s_?-H*cJ1&^BQMEW7Q?1sHL-wa~cvV zESC=bzG$TcE=Z)6R8`k~+6{3eiHZsc!!}W&{rZv;?tACEYU(nVbfxSvWgSu4PTMxw z^* z;cr`DUQZgGqqu+sMfVz`uEzwPX+QnEbijW!uL`C^kMXvR@_p0~>-t_HtcageH@g4{ zKcjBS`hjMOWGia4di9e?68(X_7ZE*z%!r!KKZRjRGNl)@X(c-ri;+w_Rls1-lAFqrP_{-c1WqP1TP^7sD1w21)6tx_?$U=qK(;R>cB ze(^U(+poE8phEcF{7xe1!X5mY03dh}5CQ-O07FASGXMY&W%$(pK4?gd8Lfu8Ss<3F z5!RVm_e(jhd+y%EaY_NPt=Zq3P~_cM>Hf zO>$pWN#)wU)w<-&w@OKYSl80LluFf9wY$O#4R(rleG_qb@Q~Kjajr&sB?6kC3{|e$=UpI_ zTs^3quvQ9adDll5pmkNntgNfGyfn6W6FOI<<_yzt|unq=hy< zPu<+9U}^Pt(h1;APFQi#V;iCc-Zhj&T6lDZCRY|qrw)-q3&nw{Bw4hrS zu8EI0kfStR4-Q7ogUuMSQqCtLN)ByS4+ExoU8Vw3oOA0KB&(#j>cN)I>m9yD|Dq!g zei0o87&{W_kMi78-Ct8TyhmcN6DK~l!(&XlmO#N8Rlcrk*Aac+kCdzM+L}VwxuQf1 zQcY4y$Vjs!wt-AmQ)L#BU@XxF6m7mm{@X|v#q06sI|bwxNKug+EcCvM3~89Ewe8{kFdp^;%n937=&Hx#OM;MmO3Q(9Wh5 zIt)*#cS?Aq105bE((jy)wsOK1@)6OyM<@<&_*R@nMH;%P0jvY#K z$}0;G25XdRJ|PK-<|%9rU#VZ{4-8a@hHcVBy8YF4K2!f8xpoDKoG2s`J;M6S<%B)i zEyZ$NLbnGSjUwPDbbMf4N(yGBhe9y6(}EMTp+;KUEgb!8@mUZ_ztG@* zn=DCTOV~WD_BdLPvEUPGUYC#MdYG|8nSO0tYjXcd!|U>M6E*)MjoN}WQ_WJJg-{96 zPKq{0B{cAdo8rc#3kFNz;F==Gi1hoG@(@eVaMx~FqJ}r(iq_4w%Y7Ee8z<-!&6D`4 zhMCvPQ91qv^r5L|Rm)PuKo5Y6LcS=d6VuLu7!pZRNG7fTVLQhz(8@9?223F~hp5B~ zmkEtsMNbrFGh34_sq$*R2_gjkYLu@KasfzdSwaa3M?C^Q2ypr$^j4F|(V-!t&DknD zF$)J6Vd2LF1ST%$UrV9ZBVQpoF&2^EYU{nVeGSToHy;`&l9hm~5n-4N`STJG*N3L} zmSy(t90;ChTioXQEJ&*TMAFS_j5f?0FEK>;=V8^GO;Tr@z&3DjOj2Gv z4>W}e5=Uz`k+p&BHY#Z{TcvR}!%${>734w5B@->R@I08(>hC8OQ(qwqF!dM(4i_fq z+m?!zETn+EWI~1uznjH%tX1lDkU-U-osQca^oN;(=oTQ+JK-O{F>u{uv5@GeRBGv@ z7)_*-LQE3qB1(*%PuCLaS(M5_iGdOAh&gn?Y+_XmTYzIxR0Szkuh41dMJ#M~4TUfQ zfC6`%;dDk0B0r_}@=6-5Mm8L4)5bgIvRL;JsR2l?da?AVz~>e+kg%3ii)%^5q9*pP z&Z2=>X7g`0aHDCsC1xX2^YkeyY?YUg475hNs_^KNr!aI zINCkf5)W0AMeeLuP-Gxwksn2{3anmBl;;(~Ddc*_LNUj3WML2j>aoctlEA^J)>iT` z>;Q!xAr7H699(IgcEJ+3d1W^NlLTG@_PN=Op3V4=w4tImn}5h_9KF2s7@FSjI| zAX0H^yUWf~CtmlNL(!uD`S4CQ%u@Y$Od^DnNhMZa_?<$Is>VXjyNMD=4@rYLRHw1TrEp0y-?(=zwOl~4+3TJ|z>(hV>ah7No!vJ#; zJW-(Q@Ed6`vFu_>e&U@KJ1xo}gtmma7zNS}A9S{=$BpOI+9+1n{S+4??tV}tIH=H9 zLyZ?(!kr4Hb_-$}FDwxf6|CHzhWs#oA{rIkVJ2Egp{$@dXu1iy1CX>Vk&+ayBZWlQ zj|r@%;TX{a7ylSZ)N&z!iwmN@(*rBuBE%J_gdQJK>;fZUfHIw{v#SlG;_#v!B9IA& zG`IWZ0PIneX{ScF#yFo(OS9(rlaOL?xzkq4vEXTr14>>;6U53GwzI%Y6z(2CCRoOl z=9>%{%3)Hf@&Y4d!R|+b<`nfJaV65qu*eu@%;oY1tH(>ceN|21`C!LjPxV+6Ss6pJO z9CDu&OgIWXz;b+y5N>2%IHBm6`+R+sIT1Zug$w%34v#`PgqHdWS(#>p)Ew+7^>8r& z_3?9k#nVnUQ80viRuu};K2Nj^!m^*>?`U_XWJ6HXofU%=;VlTQ!&~=cVipcwn%vPm zI_eCU;BpcJBeH?hW5&B1SR2U+Kz|y8npo`2+Fk);kI5&UUhVYct?Q9@(!q*^>~Zpt z>-acQO2Y9*(Xw>Es4KcgG>fJ~-)v$*cUmDSb2;lY@A}ZFiH2C&tZ7oDNNc3gQZ2#Q zX@*zXM69+l+|gY9GSt{+eSfL5Vr;z>y0hZy2kBY`&Vpf7uh59i`gnR5kFt%%qM8&l9WWnmna)4#=u07F0p347(2a^t=cD#2 zebSa4`K_l;Z)+E8i_m9F+hrHm)9s77a7T?;)Ycr*yJJGFv3B9*aV7e8llvL8fBmbc zhjMZ69h^XO6r_4ziCrE{32>$!vl$B=k} z1Dv~tULJ=MwP27V>{Jr6S>Y!#f@J}sBNbXTe}8NeRfoKA=jUy>EWr$q}}O;MZMzT zUVqu+hLjilL{2ZAQ4?{jPcc*dgCvcs;_3)zE4L*Nh zwtC$T;&W5YR5qDq3kA?EM~gQNs`ecVKzggFy<0Ev1hk34;Uc%80Ip>bM||yy#&mI!QQ!A-2}hYor_{n86^J zt8KWbXabPk#HlDxYt2yZ^$O-0K3rZ=H2b9%8)(T8a^G1c(a`2`B?K}RBhfDVxcmKH zg9r1nDoAgW3K_<>JpYv+TrMMU*Gkx9LE2?7i-rvJ?tEJkpPQSgP0?cFYY)8qL_I9* z@+GY%L!!_pUb0|NyQFp?f`#z1>qEV=3fHF{9qTc(5O971!gyoE0%NY69hR4zJ^{Y` z{V-R2#}IPUSumUhhPuvOrlGN}=0o}-z})`-5I#&*|k?1#Als3`fWh1R^Dq+p4r zxcpazbsq(93(mY*?a?s-rDY&`KAL%6Ih6|>m5=pGP+OlBt+kq6c}AjNcJk7wVw`IK zywvKYIf`GW%I+_ns?R*!pL#j1>a9di^+Zt6{)=|#pEh0ZLRH~J9i_nSG3|uuRK7$C zIiC*{agLqDXw-sA%zoJ21DW6Rq^41FC1D>8A_KC2pjhn5cqW{Q(iiHUy{2{|wcjFVJC;-;}|p&qjFFNia2lpm=j1_u!)}gSvhZGoQbI|wEes_{N-yt=tREE zDX58%iLNbq*%@!ubP(u+oqdic;bA3)E%j5bDkE|^!aNDOgIGP}r>aNDpC|n#b|9fm z1|aHv#Twdc|B3y3Y(5$7DXS3p(N59{I5LN#$H>2HR|{GCvYD~dK}mwy3jfeLU_7;l zAlbz~b`T(hr^O)tw(0=z)Q;c;oxrm^g$5xTQRqaU=vd$+VR)5MC*gj5cdAeT65?3e zxrBuF4*}8!I4H(L_@$98uyb9b z)0>b<$l@n5$AYKR4fqpb{{%rj#pQ7BG^i$*Pnj&uQLzz#bkfZq3h|LaeNp=?bD7s^Qcch?e1PztvN4Bb*LFg5(!ybO0eCYxW@X+e6x(iG2u=q ze=v(Qota}K34$-$&+^zR@NI2u=(j%!#4raM7U?1x7oCESX~^wJpOEHQTuS)A{25%D~nk9RTc_}Dg-B> zQYbc#w}W>bc{V=A&oD6qnQ95Dii6jPy`yIV)UbZu^t@7ffG>b|)LshycyEIJ11){% zh?xV)Q#Th?oy!Hurz5E+W25Tw)8P@M>%tW~m4(!s?)jBwV${UR;rEFXwN~gKOx`9Q ztbdL}maRs#G-~bieFu@E?=Z1QlEs(y%HjM3C z@eIn(c(`BsV6iIoUU`L!+ks}O)4%ikvKSSzKu>_kwRSSkY$ z%!v#^_{w;~&)q<+p;aB>)ZqQ*;dTzkQkL-5n5Il+*4?8ZJRO&lekj5*CAWm5<1IZGz$9q&m1 zWCIO8fZ!#}^sbQJLE4i@x@A({uAZdg^^-$-HKg^c{1WS&!9AG-Y{!8?u#=mFomolY z0gffh%SR{MZ@3G@1TjSJdPb?5z=ZEK7x*H$l6fx$!pt$isekx<*@TDS`l?4liH48$ zo9xM#88no-zlZ6nD$;?k!)`%TT^Z_pDj9W@$0@P~#f!s$%q6p$6EYxkv|RWG4_y5M z@7&Pli7i=V5fAt0c?oGm7#CWGJH8rRIVyyfK9gyA8V#O<2YlQYz&)woa!CWo27-`r z@>8A%Ggp?sJjubErENlA2<$8p{6PR0r<(ATNsD2y6VG*>umLgUAo@fDm6#J*@5w$= zT4J8YK_V^qC~`vzSkTGv4)7Km@ZA_a7IMcMO%km_kXABDt4_@&)&R1>$F1}&_9u!U zVmBBdhgOKo#5|RRZa`18ytsQ|OY&;S$x?y|gF4VYXdh1i8sy;MRFixIPu^kE3{#O< zGK>>XikCnfWI&t4O_Lkg8hl{u!)zBsATJ3bEfOVTkhCn_hMdyN$ONQ})@)p;TKB8$ z(n1wdYy;}BF&P3PHVL~p+~MEhI|(Z~*o)VhETF0!KA*1FsizS#7xlRd$%N&gDF)1k z)6>3w^#1~$!**iQMPmJdWYfw`UZ@AH)lmvxc7)Zto?l(R=@+VZ9{SH}4jRu^sdcvf zA!C#oqhAW|Egja@hZ-q;w7sfo(fQF1&zgt`7mhp(FoFIL^!cCATJ1Vy#o1NCW3uL&+E&!4dO)f07}jmANz68+W@ z%FWe(R3+~C8YJ9SsZ6W^z6fB+W^{vznn9>39aOBK$W}lBA!G-mO!wy&!~~TP?7G(w zADuLU;M=EqSp}fzE(JmDv@=*ht?!f=giV7+6E?a%pE=3A#Y95_ccKQ7h7X>B07!+B8PmHU3S*DNryJetDXuvE5eMi<95V3Jiy_A@ z2eBY9M!_gyuRT}{j0BC3vK_%*NhS5cH= zIT0WL>ZZ@!1UWEr?R5r;t4cYF;sY>MA{P$gK+3(TmSUHx4l5I{oJvSH_fg9fmL8)F zp!>V2+hGL^;Q<#(JAAOx=6qfy_e~TCLh3Bn69g1|r@|nq);qBr zw9^GQA_8c1S4S}NI;;?v3@~_NR-2sw669EM6e18&I_YjJ+P(Mf)mMoTX0-29`ZJ@- z$*9+6o`JLtH>cN_84;P69TH(Tel+{(qh^Z-xbt9DqcP=BN4YUH#Le^02I;epaeu==zdsl1rY4 z^Cu@e2p@$;kM)2mSmP|k+rbj6Q3s+xZlNgwC?En>58YukE$VYkzSxPkEnurj#QTYm z66;!|?iKsLKjqAVY*d(a#Hr2;hiGE3M{(fY2RztghG*BUBm7h%%5<_N$o0 z(i){k#4Xjw@lPoS!B*GVrWcHA;LL3G#oS2g@x|&jNou72R9+CwPG>NHv()Lw^sQJc zcxre)SAyVB_V`xl<)lCP2^Z$D;#3N5Fq6s=XJqWu{gGAx#G=a=A11BWoj`4%(1yYH(7goY{I5n(H5ri~S?|>0;>;U1Lc40$;#E z7E#XYRCX`uFMwr)I2_0^Z6F+BOC+5$ClCQBiOV=y&?0~#A_dBwnE|+vZQPVJ=Ui9; zNZ!ezoWdZqKq5C&e+V58Mujs#p#yF@qZXfl0mX?!%}S%lz#E?OtQ2 z3hy>!U!n=KCTb}LKV-uoC}YmC3MD!;!~U-YV2Fs`S_+Obz~C-2TK>%oD@#yhVdi`j zwC}Ws1t|U@N>~$Z)ErUMM#$;P1K}q!T6bvy%5!koFp2jn*zmVRRR<9`fU2vFUv$C+ zOXp?~Np6T#*o6t*fb67Z;q!jLyod(1@bCw&%=^nha;^<&*L?lyu%r2CDGH2X#EetN z(B?vk=}&6*6D_rIT3*&Z6W1FiF3&TxspUbk=6~eOFjd|4by&4e2Vp~p^Au&vEcmI?bDEU++sH^7e+)|`DDylsb3KL4ESRlTPq?`c==X7$UOG`=oB zd!D5Nwf4`^A6HLdZM0T9&PEFTv;lOnFBpOlK<58OG+ci(1p=_4->BIL&Nctr+0e@1 zpK0Z{H1J9p~Vo76qV5Rg2 z@J%)1EoxYKxa>^s&m8V{SgY4HBBY+WugBo4UReqFXtn`-va^1MeKp|52QALpU^rMN zmJNFLNvckAcg{~CLf_MRCS4TiRyJteue&K$J{$W^lB{!FI5H)(t*lK_m!{c@)6izm z>o!!kWe)+Vbu*q%`<1l`5a;Gvh>c%geDZl^ZS2wTGy5#)pmiw`nreRzNGW=aR27Nc z70uoaohL0t`?xaTu2i}lLFD2QRSR_kz8w@Sg*(|_mnMFXBE;8GZ){$fsU2^iCFN~O zTlLn?Wah8;V%OdKYOn_UW@yc)R#zo6aNe($K}FR8n? zr`kvl#P`A<6dSwE{oJlv)6;E)-C%R>wWPPwiy6rFHmoVm4<(R{6}Q@ z!W8#q%4=r_UB!}_P5;rHWMc_Qj_ct9o|UG8o{%_zu7$7O`tfhFVfAm@zDr^xQ)9$< zPjK=a26{lQx4D*tNMM?EgdjM$^(ZdExapO|LT|e+DrX$D>s`5HBNu&jH7~tx8^CY> zE&%YIoBh>2u?jow|Em70(e#cC?G4P^WVV8OV`05gBRqiEx5K~7 z#^Jgj-u8B~lQzNZDQV1qVNJbi>KZC=wzJ-iu-rb$o{Uh+N438@65HWXuu7DmeE%J; zOL^;?#>PM(((VNV-_l)wVywN$eLL3Cs_Vz8=G#&QZT_eKL7vKFyG!!MI$$3C<7n~q zDI0hJ2*6$w0R`}TSlR82o#}7e)BncXTO&qHBd$d$^4z}5jIz7S+b{2}Rw8iX7jf0$5~_Z!d_FhZE%fhbakSWnONQmEfulIfAZ7AkD#FfvU4ElmGk;dJl9s~U ze|+txrY`KYkc*EWm(ew`%~`v>YkqiY5y?6=Mp>82dKmK(j{3%5((uV`m#uu6R* zz2)d>efzoUaJGC4ye~$;!ioGj;GpQ5qmJTP_A~$a-}&IzQ;#kA*`}-WPD^iB+T?rD z{o>zX?TN2(Q|+tK4e%>gtE-m&-?BJ*%l1wlQdMhFb{Dy3s7u2G|G75|!v78a-Q3BU z)nWB%`v*T%BrR0eY(yS1oZe#iCjqxakhdFs;DOvCvnfRxcH++rs?#fve68Q~o#od) zKg0Ll#6niX_#!frCD+01Ituk4HYd2- zuo%gtXp+SW#vDHoz5x^2S2HLNad&^Py%AxxS6Gcy@!P)mlcjwg=@EWpv3r7&yxhN< z5g5d`+1Ay3qVa(r?E9J4Qd~AzP9qj`YhakA!CU&*OIOf5lzW_+4sw<^1>KL6I4q(Ym0S zG;xjPR4VVtDzrBJMre06xybFGl!o&rKn7!4Os{J|I_XVK6mcD8l)CI!Zp(CC(TXtK zHkoDqm7Z3|)RP;TTiHL$_i4?_xPNEAnoF7{Y>3_Z0U^Elj7KX>X6_d>XKx(HFW)Y& zOeUgvTXz%V_FaAgBp_Pkejiluj^xB2t54*K{FSG}D9R@h z*?w}h`P`f{U-ZMuZvx~LV#aq0ODZfLX5SMWuzGpv8%Jvi!}eR47JtzwhyZ5QGZPM( z%V(dopzFmC;`|kDxo-uZd@+(HZ%MnHqQo#v2hJumOQ&_Os;>pcVA1;YS=B8(Re-k4o+Xn>rHyAj^1W5-G*bQ*>I;ZEZ z@LL)3CT>+SYffsJ?f|F|5CZ@P07EliG5`P%W_XpKmnCY=X?CjJ>$W+onvk_?pxcFj z2Cr_Bl-vvB9+(n(2wfXL&Hw*8{{S#U1VthMa0UmtxrUqE=6BsmW`CE-giUf8l4JZb zcP&i2yHcoas#LUmEmMF;x!{gFv>ud{@{|M07k!0C6;Slp(_ewML=>IT7fuTO_f9LkgIW@0t+htqIr1r{pE^Axe zx{h6J$;wiYGyx2Ipk`SlX(mB#Fx&vyt(GOtPqC3rupuM_cnB{7ya zdb3`1Piyoo=xcB;*b{CmGSOJ2g&1Qtf-5S`7*|XzTe7kx9%&Dp>ymYSf08@dRFte( zsCBW~8MIg;sYOpYo^29P2H){S78FHHQJEU`An!7{&4~6y^f5jHE$gyieWjB5Igngb z9m^6*GeH`Pd}gdsNRFH^NB_QWAXp_r!ljtQP1=r3fM69gdIM_ErY3EgLvC0z{_7=Rt8|rOZ1%1@64p+k0hiv=gVHQMxr(8SLu);*Kd8c8E?P})XZuDHDuMM zHeGeqjyu_^Ks?cwGm#<+R{MZ(&VcOxE8gqrwO3nTn=atHK@8tOTb{BV-$!@9U zN3ByySJt{}f+s;x+++O#-B!!C9@dpsb;|@Et->rA!BB#5GeLb6 zpGgNIPs+qAcUkUDO%`sOpKqf~RjH%e3VP%PrBbkQ7Ut+Z36Dv@x=KpX1mjka?Aml& zFIreiNicgpPlMF9T1A=n?b&PDO@?~t_ZeGI9T^XMu`e|algG>VO|Jq|GP*#oYl++O zs8A6+pk2FFt+{RNKd%=gx2eb>QTMt+TdX)7Vo$b{&i{=vR*ShNbMvYGuqr(RA53$o z*@deI>uZ}frFF)y5Z|2Yt&b9N+vna6$rp?4OODr-nnJVO{n;ekY5<^17MhXdTK<{F z8X@1Y9Hl(mgl)Gj4^pDVMO9gkZX1s>J0Ss)^od89DsE(MU@VK-g+d!ZjL+gWBmrq= zxfvfkl=6USBcc#EaunhZ3Hf+!eC@fxeptQu=F?j#mlsTt*z3#*DB)Q$e3E6sIKG4= z_X<=vCA@hI7HHPH0m*=-8*AgBR${O~n?8MG?_@Gad9ZO=zA_jcG1J?-9E$1G@HqPqTbE=HhQY?FjC0prg z4n=^+E%I?qg&H({xgU#-c?)RH9BmYW+;R&+d+X#nGRcY-YEK~`bx($4n3jUcc$%X$!`PNjE_pLa&kngBh~Dj^-?D!pef>-hGZf+*ql(d^1~Fu zQ*p87J|Hc=AIf{BZF$C|Qa&#nke?)ld@RuJG;Hsgrb@YGON7FoeI(eBBBu_UpVBMm=NHBkg}_g0$(hI!S9#;4{R7bhba7eF4HlsgWn>m?U#^zO5fG( zC|8owPu%aRlT!Bm`1H!vikkBD?LK+xvNh$OsQ&pcfMxAQ86ha17a48^Uc}f7U>0IM zz%HqVrgBvN+vC;sY^B(MLdR}xz=;h%5ql3wg1SB>1TOYsHLEAGb0xGH@+pO%Qp_;S zo!RQeCYqsNlw3+HB>YE=9)}`6jlXvLk)8bBh0bcmbx)x?pDK-Ap0^FPTZ-`9Jkj(I z+hjpKzFtei@SoC}`byQfJo%-6zuu>OVT?b6TZaIb4a5gXBP>vQ2?|zsf}&@&>(I_Q zV=DNX+{wjCwmS!E8?2|Q_G%Tt@l^|3JJIC5* ziyK^KE2OM=KPu|h&+db)(S}AUF_|;wnIP^znjxBi2=@1iMxjM4w6R!)IBb>Lf5WG- z3^uSAmMzM$3<#~QBB~;VT{V!iYp$ zRzDe%a#q1W%I85WH!uDsrz@Tw?w&xzjU@;V`N4lK+4#Y6=NyoSjaDVP=cmn=mR005knU01~i{_;)v|rkCKyy6AwB^<{{&7!PSUB&FJlMPJvNV9}gd%A^z3cghr;sR-NF z?&;E8N|kGjFS-izFoe4q8WZ}dSTlxW=aAHq0Ht?}ViaK{u!`}9Yw{IF?Mel8o39$K zEYjwa%*r6M4XZ^?h_$aUyC*Ce40$OER_WrIlKozlr;SCbZ-L87SaSHDI@=yyscX(g zlo74@_X%u;?X{*A&j(J>(YHZ$&SqsC5UbY+f8`_H_Arogg8V$SGbX6TR??9ol`d#y zpRhIo?OZ$N4*6n<8&|8^@>^|E<7`|p$pHLX!*Ycam1tg3Z>@Z8QF+0om9QaFn^8ou zr@zAPFMG%&-nc<$q{+6aBoDYHAD>ZLX1qhi3FurZ@It#Lng%AI80i&eN!&bY!|&zq6bf>x z5=Nzui>q0S1^z-S^F)KHcnBjPv}9Q$idfNEJfk*ve$sH!3(O`pxOiecmY3_sXlam| zZz+aVpMs2#VX9Repi9F*TgjeF()Jy&01pASq*c6DZ<;oBnzB#u6p$(_jY7a=F?C)6+Gbph8fZkS65IS2m_-9f8V&@L<_?w*Q?eS>+$eLS zdQYxn0hnq8eNkkMvqi;GU>Af7II-7tWCkB`ck*brlyi9}>`^ygp>@A`nD0JV6f@XU zvG6+fXW+PJCZUNhw}7LJ6-BRjpoRp8Gc!P? zXZm(8Y`xLGLyugX?`sKg#~}NR`qd_x7E&2$YhQXnx_1j5bjKNvn z@5AVE$TRrxOZMRH!>pai8Kz}Qn?C$M8l{;HYEP$_bc2a9kF$}ki3guvEc-GKPmVH7 z6IkkR7~Dl{bi_fV1_@Yr(KMPD+M7ClZ?ult=eN5x>UJy^5UbaZgTQD@a!;NJZjjhS zV4(fJHyXf=Ct(*q2}5#ksHoNj6Oed9Y{s=dUt~` zD+7v}$6w(GR4SG>Gcc)m zypum2z#uljqOS~V1DSygT7fm*xD9u_7Y6ei#fqON;jo`2Vh@DE4+TR^fY&YVE@7q8|Ym{FmemTc=(DCDBN{y^96BA#FZB!^ie987)zwMS>}1N3JX?7C z2tW%I>D{yPN6H2+#)nx=DuLWxjmm%;lmZMfS-oF-ADGRj$#O61?@B=^-JA6RgL4k+ z&{yzmJ$z-ux;5gyk!1C}N?+R_X#|T6Z>aRWy~uG98gB}(jO8>e6$y?LSL+PbJ}&M? zs=-wxvt1%<3{6RMLc@YrrK5;qp*pS@nbhfuzM2!T)5?xyb*6MdRv#sXLG9_- zqP|JLbJMRYZZfgze6|dG31HBnY`()2Gz#5+_6c^Ja zU=e8|)#_;*2-O{~4`cY1ys&NlsVY8K2GhvuyvtII8P)@=?{Xx3-p2!!Fa|inO!_)E z;>Ya2*o!EfSVbx`Ytq#{OI#`-F5nZZ2(W`7Kfb+5kI1*qb=td?v|u4w8NYe?6zHmX z)#+tOvkNJ7^aTUcB))ah>H-@90Rp*l$M>uL_s(0aqO^tdvc8^uYazbdo zeF?X60cn@xF4{9djWc)MPhd#O=uo7w6{P3H4M_#x)6s(bU|(cA3!bV>40|N$4fun9 zJ_7K*l;DD7U|@+3i#8*9Fv5q#-&X5jirW<}ki=F;37x?xp+~mB^qybVk?*L9WzuF) z*_@XJYC`~Aa{INLr~qKo`PcR6^hJ!j{<&oE3#W08urH4+=N1O*fzhq>PUG5cEYuMj zS&WvnV7%#6rU@m|sx6{!%BM_}*&FRF! zVrpzjUP^0#Pb!+XA3~b0e(V_tyc8C)Xp>YxDkHXxOfi9d*zCuq!E^MRzZ|izOO7ze z#*(Fu^fa9ji)k(+;u<&Hss1D0;5l1Hf0;8J?}~jtUo+G%-}P_&Xjd7&)5L!>c22uIp@l-bbL6cOqgo#fgQL?jsx>HnphPbu) zf?96BLBSkj{Fgy>XZ4D>fd_cM1Qby}WhUXL6oE+P3kQ1em~7D?b}trHZ0_$O22A_J z%@hsKr6Hal;f|kg3~!RhDrewi(O7SiqV3-QZqo- zPZu=Mfasp!)C*4hxR!q|E`AKR7sCXX`w9AzKDBa&O$!EX&|M|>)^KG=JQeOJ1w@Rp zN&}NZP~OpYY_>jXSnrRSH=JJ#=7b=BbVDN#(NXHofh(YSG=l!ad(d(Z#wBb-vD2+W z`!Jw%6E4~Zvtno%t0gzP|A6Jln7C+o`eRHk5ngJ0Wd~2R@Tf4hnQ#rfK+Bn|_M2t~ z#_71b{tE)QA6(7}oW{mZi>b^k7K88Aq|J_>)R+mV$Sd(MJT5mlVjPeewK?J&gRn9R z7UNvORGnPATZ@)btsp(OPVPs{&@rdDq(4PP3_0^{IeBo@!?TQ3LB+N!Mf4O{cL)-Z zgH2gp;iF?phUSFNiP0`3(warN z+R#H9nQ22&BQeVkrwCB0$bCcFwe#9!qFnmm>!Xd7f&kaz%`I zu`g<4>e@w8GG!L&gJth4jJ65gAc}~sHd{6)5W` zbt1!XubgB;%{saQ0>5q%>t89!P7XmISKrgDcDP;7)nfGXHK0iCIhIOL&hqGQxXD~0 z8-wyQo_|6aip2&MY1sbtO!Mj7hi)WqMr*kD7~+JDY#z3iN^7I~&%sSz8O-lew7JU! zx{JRa!U~NhGW(q~eZ{S_c7#iJ@}zBh#eH#oHn5x=R8IL3o*vjw6~uDkTI77?g&)rD!|`im7?LvdCT?#lC4bYB>^<1+^gfLn zYSdjEk%kmu%DBS=$Dh}~g7m_97;-`uD1dVQF8gFZ!_m25m%I@OQNkfyn z;zB>dMcoG$Pf`ZkdFdJLRT0$llwiP?@|#H^R3oD(&xR6eF!Z~Gb??3%ML(x7?x)KCl>g6>V%Akk~SA1-hCM8 zD^T|z<2SE>ldHA6ajl)xZ8D!c4zhzK@n%P2>5vZ-3MCSBA7949Se3G2u4b5)ZSQAB zTMv&A%z!=?mpdhE*?jo8Y5sv&#!`IoH)sqJ^(S}dLUnPftYkjpn@|@_QNfrTYHK?7 zof;kXyT>OcW=wTK7>yH@vLGm7YS;72Av7BWE z{s{h@4?!4F1Qq)tHXy6Qw?snnu*crC-~jQ1>TbQt{nyz-eyOeCys1-9xScx&eWHqd zQVdw3qgcUyFbdiLJCdp9a1eSKQZH=xY1dff4!RiBO@(n3pUGFccMJxXQK%+9Q*)>& zpGMS;5KWW;)fT*&VuUHt;p~)z8D-1`eY;!E?GE&^>nvN|tb*LbY$@txe`h6L>kU}{ zZdV#U^6SZ8b%~OE)TvdXi(NWuLc8NCbPJ}I{ z5f%7hVE;Zbqx%~P)l5j+Rw*I+>qgE2mJ;M1Ca&k~XrP*BE!Ubpg&!gab zlErC)E#1MKWHl_ZF@fPZh7^rr7Pergd@E;r43Cs=M`ms>nv;xwvuAfONQsh@F)PGekFfO$gsBw5{`i$Nby-D zx(E1+y81f?TFKc=^if6gjGJ=55b2Dik~V%Ml-{vc6^DH(I>_on80RuAx>6-5gxZL& zJ_dreXj%|=?_e%xEniQQJqM?3kD^{Xd*$WBb`cZv$$!MfAZuB1113D5tg7nvmH-`4 z2)1+b^QVa;jXYxMV&%?0;Xn2KVkaC)&Lkv125(f!p7tK zRd~G7k+MWAYE+*%Hy|>Ud69LiCwq^-cjw6zk#ldqBe{(@!&T)S+(R8HPII9y;k&)~ zVN@CV2MwG|mlGyERKTx_`$%V zqqHnmn8~AfRNGj_cu!vZFTHQmz}A~LPW7g-&K4-y(8F?1D$rm;XX*BONh4r>y%b!Ek-h9*Ta799 zac+4?(-vsWV|dGHQT@-za6dLZV)^1U=h6j?f^jTTV_mMn20ys2fJ+5oYT<*&suSNt zF@dsP15EU^3=-NSkBf8K5_(L?@H*)ZtCkTUQ6YxGE}{)=B@G@t*S@*gpz@3Waae5TJB zwrH;tBV!tQlpzQOupG3O`ymxiji(xz=2r$V!#pWm&mmQl)$ru$Ok zo&7Kd&Ose%@BXjv9aq_35 z2qG#S65wu`l8m*jirKwZ-3A?S`*63$n4=bF{U2U$AH69+VR3Oc7(uw#*GDipglj~N zCy*ZT*qQ2}EXV-o3^=yhOyMFNzeQ>q*@NK5)Q2QKenVWbyQb5#U^Y zBW0L9?P?6d5W~gOfQJ#QL!~+3g)ejKXQ>4@{W*_83il5A<((V%)hLDo%V<*E5@1;9 zpS_2$xA2inarUqoi9KTXBJ#UD0Rzqb%GD~M&w{Eqy$86DPNW8^R=%#rp5|v1Fw680H^-1s34o*6YsYEwSuy^LF09pUp z=rR?F?6Z9RcIr*Sv#Td8=;mrQ&6Rfne~4~aNMDr_uPv+U{WX@7BiT}D005!STUCWB z=VdV137B2bd{po9Xl16kDG$wf27D`Ai3fSxEP-r}8QK7L<1>OO=iBkk1h1KIt_0Mr zr;BOgRaE^o3($l#uv0)_$cG-A5yZm9=clUBfUWTGgNxGWBRnS;kD`d`!UzH$`e6JV zRUK+}=x@0`b)0F)ULD8LrGo!=5;_8QpS8`IvTd0vjN?3PW{Y%<8-~n0;gdfNkSX8! z&_M~k;PiLLSz-${UzP>;q4_!cOP`S9{l+;STn(W3%2{#Es z(6a%h0!GPnK`(K;B@U>;0(1FM&$y^_iz{)?!P|h^*E-ZN#7Aif@q8?{_02rrw{k*; zMB6*=jqo_St*@1F4Gt!xxvDW*?3s+&T#REA+{)UeC5dQx`8k)gxcFBTEJZ(OVk&&F z?q0S^J%+bO=O~t!lCIh~^4IfpCB&F;D;=BVpkay}YIZ{)=bxeA_{{$+U_ZuQ>p)@4 zS8@*0*>DC=mCdKW?;%*Ssf|fMX#OX!*gt&`i6AKiF~rz@x+7+hjVsBsSJ^=W(f?LL z`YiQr(J)|9YNsNkXrJ^MdOob3p#AH0ct63wW)RRjj8Y>o_{}^ZQG{DZPs1*m{hi3q zl;X$1SePs+5E{$?X+{1P=o*p(p8c^HrN?IBOsRDxjbDf^FAFUJ>;sw@t^j7Z(6CuT zQxA*Fem`9@uU*&m*#E1$SxfSFLx*6PW_c1c#=wGI!P>3-Se0ol5P_S z*D6rm${HL&r12lH8(blEC^)}|SI-<*dc*|VcX_XFU56Jbx(p&}9c-v|)C^O;+vnzM zFH8#Qy2&8Ao!^`OUUXd!@w{CwARtCzArqVbg@5p`ERSUlJ@*zq3#YN87V8i(7S4|~ z#vo+srW~eS;*93e%5uigx~;73RpT$I($RQ0ox12W>=zsL!R7ORpQm2QjntfU;h(pN z#PtV<84@_MY=9{rLb68~o&bTteBqX#3dB9dDDuzOXqkeB5D)_Z1OPKsP$K{U4^`qS z?O8-sFqXS&dmAyUTqDYRBmsmm6b@^SP0ghX0=@0z?Y5!q#SQTN+ii-WuPq-p`xpU9r)K&ZFSWRd>0Xg1=Xqc z^l=|mr9~7y(MO(Afr_E%#fJ1z4HP4a5U_w5XIG8_N6C^6^l|{C3IJ$Ez^JYO_xpX{ zZ@+hUyL;!}Wp0_>mf&Cp0e7 zd?cB7(j;Eq7=7LqVcEH<#=$i59gbCA0r88;VCN>~OC~tu=wwoYFto2PPMa;C>*#RI z7YG-)ug8Q&sAN1&kOW>ZL*G1wVF*{DVMRLl=b)(9rV~fB9Ak6#^+0-}JAnNHoB{AO zqWyY->h{%f*9k#sDg6qz{!j+Nfgfo7%Ds1G2ub6d5eWomyb%oMZYu$XKkIz!o_;y6 zCA$uGBKp}lrc_7=Q+d(_GnJ97B6|tlXQ4hGeW-mTbPQxSUm=cDxsfLoA;3)AN`YYj`>^m&O#+;B1OA#g7z$jN`U{C<@ka{}8vi@y=;S`G4O)p88W(rLwJk@{i`kWYwzP0Fr zM0w+gchviZ3m+0*T_6z$UjYGP4N!PB@#V8pFvzKkgFk>Da|jo70x&cn?y`|ajA{5m zvvP5ZLggPcAjm+Y{T_C73iIY5NyA~2+O+A0+0?Sq0Kz1oO6!r3z=%|GQ!B+Nq3?X# zM9qqlt$|TUE-;7gexC$X9E%2#Rs0c}es;xJx*=g*(ks~+O)H?+hE`JL{IU0&#e;Ks zqQ{=Cvx?H`CEv-BDpqdZ(&@=7sF+ibd@`e`&2(h^<-XgmN10v~f0Jci*qey@r#HAy z+PO4P4f6uxI&Gq(n%Ca3dbl&BLrZuX@Ms}w1~Ujgnhx7NRk7L0l?BkXfZN8}Bg%JGFjrMd31R(N&ULFkcV?2r zI1KENvHuYEaUZrKMgJ`l-p$R>!Acb7kR-2hz&0u370vPGitwh?OCH-Q^u4J}c|ljS z14k+)8(-CE2o{7M;Hi>E;=@%)dTkBUv*STPOcF2HbV3BI@^PUS`ZQ(0cnFF_4-T6V zP(`7YHy-SH%S9YfgI}hJ32MQ)ixAb&u&oFWM0*cjA_+n@86p^zUTt~{qzUy5x%+me z*YxsBTPB;-fwxH-wgRz=wIoQtRbe%eS=3nq^4E^CUCRu2u$G-d zl96Yc`+baXT)-(nMjUcf%(Ld9zF9!++JD`qp3a;0tb0nL`eah`IgR&Ja5;znSKn#q z58U$7WDt3(xt>Jdn$1FJQzgiz6b~X*o?%`EkDTfk+JG$6n)m!OrJ3vHZ#LPtd_L(! z%cQ9k)Ppw@QIUZqmnCr{E{jy)P!`{m{2KFux?pZRk7S`THgj5XHcrhPmMwh!FqVtT zVDvnBz9?cGvMh>dKiP!#S{v+@IBq4zJn8iBWfvHO8Mnzie9Noz;R;Cmc6~_782%;uv3pIs?J8Gp!b+Z zz`-c5+Vne*nh?v%MH7_Z&?UI?D)^RM^*ri{RuXUhT zc5?!zTC2A&&~nwJTcX;HN*cCbuy+AG)I|hdWTvZfIwp4lR5==}bNTTEV~zNiNjf_M zmtV{?@?^MrOeE*xgwP9DMo3H=f3CQ}nyyI1R$N@MC)bhP)AC#5iQ5+|2aVZ*`)rU0Tsd!Ytw;LM^>Vay}I}P4j#&KZ;p>t z5izU;SmHfHyws()gX-m@nR%(MNa?UdZ#W4X8qrpm^hZ9@QZ1L8(pNI2XZXKZr)3>D zEio;6ke0?V;&zcPU^F`Lhl=1;7T!eyZbFvqJjUPE4N%IdL}eFso_XPpeFIEo*4JurmX|@rum|*>tV0hlfy#Zts};Ow%6Lj}ejGsTbH}WZ>olShC%=JovL#ye2-~d5Yx^T9Cup zB=l_{!H`%qHk`XX+{AFFA1NhQpR^*?ZEhZ@jR2%XSze3Sl+PNMuG!iI*|24X{0{P8 zxRsYg)GYW#zwNnLrVgoY|g6kWTP9^}LqPk9c{y^uPf-`y` zSTvS4(}FNsMez0BD{sKcAGOmf7^8Y-+v!3<1f4J&pP27L%5+yK?Qd4MPDXj4jXeao|V%n7M z0y<0o)zO&`*$V(mz%yk=VW~-?w#|k1vwK2`XX>vV7B19 zCVI`+kJxh7A{A3iUXA=Rkv~mtv-X=Y^#E?Ogcb>fT0{3fUgWJ|&Z?*utw2%G1%Sxg z%DlENrv-K~Ep7`vV4pirF8mi>B|#<@QG`SZ{J z6E5wnAKxZG!(@p8CYL6op>NXipx$4|m!JG=IoMZOBf{&_?E!mSOLgT+|IV!=ol*-r z$v(zw3x>YStsmNxv7z_N8Y5r?AB|v{iz~KExkgHJjgKdKC+Mt`>&!BryYN0tj#$4m zVxUxnDsN$)vox0+q5J2faAnJNx5A9oN4kOgK5d+x{h*t?O**U#nZ zy-A2Ek%#Os-5I^HtODtZ>iI>xQd#j7@x42g8GPn3qEf%YZgilV$%`J>vqavZ=b~6s+>T-TJR*aM&)Hl-D`99n+zEphBClh`l`p^R)o@qw70MW?_Iyy*UBrw7 z9UbP>VKK&j(puV8&`lku4L6Q-9ds&OoEs!cmP?G8=X#`p7m9;x2rLif11wE|$U>s7 zOy$8(f3t7{ry>(@QfzUUsO^STpK_#HZpK+$SHZ=E{tu;sQkwU?Kb@KW0^uw2yAl~dceOV4boY6e>UlnlTZK#U<&L%0|}*XAcw^^8wHK&OQ3upWc&T z2Y@1~OypMa)a2&`-kxCI)~HrXY3ZUSQP*%bp*>5iV1y@MXK(n=y`Qm0vb;W?AvJ0t|mP zd@_%$C_{RVN-nFNAvYmEDz5IFIfkv{$9p7Rt@EafJBEz-T&f6H3Cb8Go@byUjyL$v zN!(;VfcTL8Jq`ST*YYeD(ndZOg|O))`G>v^UT|FEkF}q#{rFD?v@VNG+KI2;Jh@Pw zJ`5vzL2_uIzO%;8htZQJd$Z2OnyR(${UGc42WeajI+5w4)9k9A>~HKek0wsJj^*Oo z+{REpG7xM}Uf!i2WV+NOGzKePWcNEC?*RXa2*G+OJ)EEef_?7t_iU`&@IpT{uni_& zJl~g#TbkOed7in#Z6turK-rftGu~QC?XM~pmQGJ0BL^vV|IX5#=OchaJ#-cRxSf|_ zkD-MU(?b%#l6Z)DJ)*Mm#gP(4j!4uOOlO*h6}9@|NaEa8xe5+6wu&6Ws~5kv_QJ3( z*j)InB_&5<2l)Tz>`d7MUDlvzJ&tg_LYl4Zl|#ON=I3&f7-Ocrj2-{ecBIP-2U;Vf zD7cM`0_xNUp7c+>$Ncsl$s1BjZt~yfoC{+DWcmIH^;Dc29mfYQXj0W6Co_dmBGPpP zv95hg*YCzeoIEqpYj!IUC}FK^GLOOeSz{!wt}4OYx12sx>P$&z>;e@s(-N1rj?feuqE}QKs)f!6JEl*y!2j z?MhxuZ^!s(8ar$pI$83?0^Xop27)ms#jRfe{BU^71%)xAx!z3cv7c7>R>^?x46f{! z+N5$0qNWiNq)ang@&aC`_8CXlXA+)x*0sAVYous&VclbCHSAB8bQNd$O4y&R<#m4In1#Q~dy(yDu>ff}DSFI#(y8wW1$U{t+|6&5^AZHRh z$99}AVsg>0k(OdsCT%7$d>Wu)jz}PPg1T{}AIpO#FVeYCSvupE(`p2#iu2S+r8d58 zV;Y!BHk7$koysw*KOq|>oQjBpRB7dKj59&Z5iDKIP`ZB{`yes|y5YB&l+5666TC`G zm#UrgNqz>p^>)69girIL5oVj}fRGY80}$E9@&0BDsWy-E8$K@zA^`4R7Y2ay^W`eQ zGRWZiy9~t3MF36{7|w8CC@M88)};d1L_Gt77-YHNJ(9AerqicTOPj?{okRuY#-Khu zSGi6Vy9Aa+uq~Rxm+ZN4LwY9f9&rtj95JMb){0wbR zjs~noNh1naa2r&9hI5DTU##48bF1REK}13Cbw@D#iideT21#T+#;aUTp^rO_hzuWw zUKx;a+V+Yn8UJqNI_}{b-A|I(BU3H`K#YPI4?yU~?Ic6C zRb6f=_`;=E!tJNXIoXUV$Bp0qkI2M>_rE+w_{-Zsi}lxOPbbX8&F_Uz2Zg_T3B`45 zPiN*V&#G1?Z<&oo-!O@;M%UHJv9UY4BoP*e5EoZAjlf&4gSd5QP;f*avHuj9+Y1*C zuaP~?Euk%idw5u%6PZjCSl;5!MIOt2qVl2xF55Xts% z_s1&*vO2)>`z5PLi(u#LhTY5R7uPrIl6g?b4u&Gg+(diU3)=2gU_)M{~&&hsR1 zp<9QbGb-@^xoSSXZeK%`bz=`P*>W=t;P@kCxaKlutFMz4ZV~-~w(daFd;Yetbmx$7 zUoC9)`)G6TRka>yd7v5kw(3iXJA6H$fr7q6c`FYGk1^FPa<3T{meQwFr4zp0+eZaVk6uHZiBdH*lVBmv;ssgGeatl z_=Q&$~ujxxJh|9=jp(e;fgY1I&HFK0KtpV(hRTUA> zP~QNF9V{8l3TdiszjQFqNR}*&^`(oRuuq@BT)3Phq-&NZywTvqPUXud4f@e)(@_oz zDLR9~5yKV5WWv_=hM%o!|TK05UB1Qh~IJVV9@sIL73RBTU0G-!tEkGM9}0^t*I}5 z7#sjKyx53xA7+@4|3%r2m`C9Tn8x)IcS+t{RA(Ui1pL_p^=0lIf3c{xeiv{Ugc21cb?E4+kbOUA^iENp;(6}JTnpd_LVp5r6K8o}9aT^UTE%f0n z6c&R^!rz2;IBJ{#qGS)=h`iiM!f=|2@Ag}99lH&d3*yl|Ht>XK5>ipPw{pTA%Ks~9 zW>gy>csl$!O%8sDogmv0&7!1lR5{d<9#Z>g6;?eme^J}cY+!7 z9+JJMXHr9BLf{ca4?C%Jb)uv07X;9`55_QXUQ+jO{ZZ8OCXVy;8ms6heJkC8)d5&C zx9YqXNf}N8?WFEyq!IJ_TnzBt>*7eKpPpR2{{pcR1&b`%>!e(kta}Ur)VBQW?pgZ+ z6IQAm4cwrIgit5J+cl1>2&qWB3Ox_6k4GIre0;Fc6WrAW=1-L6BHmI@^UW69Gk}W+1!wjpPeG=CLpm;-)rxLbg^V+rKxIHA;3}% z+kfWe?&ZvBG0vDo z`2i-e5kXM`soJ{>2;g3VkLbAs8M3Y-nS~SOG_wPE6XCv+ zIb*OiA3k*TE+==scYaeF^gVOV*WN^E=e);gAx+!QHv<;?=L_j zQzNWCBqiZR?Le$G7rU;GU&s_#FTjjB$&N03yU<7HHJTm@T-3q><@b29K?okH@oMN0 z7Yim_V$>t)PP2^D5k4Xkxtbz0-kLy8rjH-_e$TgWa9&x{-PSadeEJz?qLY2}9G($$w>q&7h6z;II z#`2FFS1~D9m^fdNPRp42|IX5jPE<&}WzI8b3joysN!=)R`@)7n z`>K$B#tl>^FvE~_rq~aX)phCd3HGk{by<{^z9)Abe0prmfbdt%eew(A=-4DBHJxf* z?8HaTVSncr<6SgXIFh6ngpPA`-*kB?dEQ2BI#x*TLI!;Ar5RLobTSXhy30wj3P2Le z=dy8`($V#7<|yu@2af$hnXas{eX4NzTS_;{Z-yg2iLMLskXQsu_4*b4KqHtA;ei0z z3}%w?D#u2NL~&|l$gIoonE%@N1CwLb2&)#&88^+Rrfe%78~1cO5SVR(Z3r(eN)_zuuPdce0?%4uVX zZcAQLHA<}~GA3Xkb~G2%cdEqNl;!4b1kn+=SuJ*>Ys5mDCGSC=!M*7qE$!6l1l(Qw z^Gm%8FeZhD%Q`)J->Z@Ql?fNBg*F5}d|8`i&%=N7g7J z8s0su-(atOBWOifuj^--r}4C^kKk}P!H5eEtmUWgdQbgT$#T~N+0ZQsXwlc@>;a$J z$#Fb@y~6wt4{lv_g3pmd2!NQ_$~Ly3x>q-=b-tR!u~}CG-^SQ_yl!vvLVZ2ZMKMRR74S*2OPy62 z!20$>`k#ewqm_Kw6cH^kbv78mQKe(;0mw4B8hh6y-%c!n&w8XLE8csHH)glMt3NI> zv0h|Oq4oY{*>2zSBwR|f&(wUrVx1xF<=)%?EbcXk%$hP#f*=e`AAq~i(7ko^;r?pZ zb0#0ArpUgp5lHHMj%Sk;L!e#BTzn>2OQrR8=Hcpn)|EHFdu93WDxP*aEc#7m>%8gu<}{ z!1BvqByqWu-^+4)sA8tlGzT-$Z%<1lyU)C3O=6U-wZL~1buk%^xU9T|{k#YScP?cN~9xHFYzZ7(c_?m<;&$=H8b%~`a} zo*#)d7Mmsgx#=UGpCCrx$n=n67s&=+FLbydabbKlb%0F`?9Lfr%}&ntcG&i5gr`Q> zZ}Tvn?q?I-VRyd+zYz0gX}}V6@y~xTday) zD#3@1R)x5^>vfwp2x}m%xZ~ePzNmlME7NF1xjQCA>T4!eu<5rCng>U@HrMVDz znScr4$)XhVq>QR3bTk2RUjbePM2q;)cf*>d9R}y$Zeb5^JtvEbLMY=u$EnW&hnJt} z5Nr0}F~#rNzpv_PQ>i|=QzC@KM+tH**&aT39KXZ`zaFJaez`RV*g)Go`=yhNNfw!? zQ?i#%x%R8pEnVG6TFg9PVTDLuZwR2$Lj#wSPI2^#P&7UwThv6 z!ez$BA?S4A$;7+@i_D47_wTkJ4ZJMHHFv|D?I<93A^GIRN3*wlVHkUbc?(GDN;WH%7%am zg+MAHrnVc|x+QjD9vyI-hW-O8bH$6V8kw!N_JdE>=@TAM#)_a+AMj4z5Zno4xPqOm z$jZEDy6;?(fNBF>>|_tZenp~36|!nA7D)=W01gQhh=4R{O)5Z{s?@YDq*~76LKi@< z(b#*|v8uxoYM*-}M>IzGz`=;RR@|t%QTuB#iuu2L!63`8_eKH}n8Km`x{DB8Fxpt*?!|%Abmyf3JO&wff9BgX&A2)cD%q}pa8kg2%?uRoQU=D77-d3Yv&`6l@Pn}LhQYbc zctPxar{A~B8ok(0&w*pKqM))jk%Ql`LZP9%_d%-~N)F!>F%L#*vv;~Fyg6NOFu=$U z1J6#mJk(uVw;yI3J)@YoV4>YW8spya6s500_^UTQfm*C^ZK8qneYCvKjyYFp>$$MA z3aj*GI6BTcKj7J~LyObDhhHr}#Aq>c*cy#8xSDtOJ+i@*3BK8~Y$-XD%dra!71QBk z20IQNk1c$>4e4~ZTbM+88z!ns3e~Iq_&74t8!%~UZ33hgXm2>2{^Rj0s#Tg-gnX3g zTE+6oJ5}YSjgltI0tyPWYRx9Hj8+m$kw`&=0kJg(f5#C0Y5no{w5h|0D#Hbetr|_q z%F)ZF<$Rna$?#Cb;H>ndO}*-D-m_>Cc&e(F+5e2|?iQXM4CR&O%A&?e&hnu68P|}q zIVfTuWJnu?XGu`{0F}lKu5sxG=75N_t#7pryJQ&dm>T~yT~A+w;z<{)By9!U4a%WI zQ<1|%3bt_w(XdZ_>{=D=h&61+A?p65f0>)EtqRUQb_2B~--TYwxV_0exV?SV z*LM(sa`WJ@(uQDuIxHEOS#1H~9R*-*4jkIqeSYHlQE-cpHw&*bc$_PE4p;4Y#KS2= zme&MoA%V$ahvH`81p$X8X&!mh|mq zIo1Wi-9PZ_jV8f?U?{f`6UxmbrmecId_@_GeewVV9!?z-CNINXEWipw>XQ^tPD?p1 zGyAC3Q#8Fu2L=r@5UyRhNc%ZS>e2h(WM{1&Hi^-!m2ofajtqv-%36M^u)TA0n4?MY zAQjr5G;n2Q*v3`747rt^C!;b^zjCvqmiq#jf2s~UR zl_w@y0mE||;Uw)K-4Q`SO#{cwLH3IMgB}Ed=W6ovu2vw1I>+QBh%+@6R3T<7EIp{P7 zU3bbr9^0Q}vdJ#z?OKuH zb)F#iYTMC1vbF?F41&A(x3jV4-vrvdKRs{?1gm;hdg3Dj3Q#sod8O7tAl&)(5!BZ_ zYIik^zI3s@Xbj^^a%U}(({O`9NyBEEEnMbXd<>!ipP%#5?j&-Ie!y^|Y7jE;hP&E8 z<>3FcIm*%TNq5u*ZLj$;-e19?ziow?PFKldR8`p|qR{!7ITj)K!+rxE(gy39jG;1K zK~%+54^%l{J2#I7hHhW<0O~C~gA?{d^%JjOpog~H~Q-)zX%>WKM_n&B1aLMS@AeXB) znyLGD_C}I%;jWZS0R!xJ*nKc!4`N>pYgoio2SpV{14urp5CjZ@$D*8hsq*TV$dg4w zCf&eN%=5U9gz{0Up>wLEQ`-)0FEn^@-`iyoFBi;Lw*9sEMvEo(d5V9(yu@VkFVycR zjF%sk%TA7DG!2c@khTqh+`o`7&%n&AjQfoF@Bcjir^iQ!{Cxg(GVksQ@d-cUp#a(0 z4-)M?_{iO9!=dzq&wSM8VYRPMP7t4mBb_&&^T;2bAf6yy;Gcth&(6^A9#2EgL^?<( zB7&T1K@U8rVHyGa|V%?~=}<>z+`_m~x*NjR3n?kFTR<=ao1d5W++gq~BFB-3ztHnLS9IL(cSaXb_X zfh0Q;dPE`>Mr~;lC8!ca4m9dh@_HVZU=jzB5v&Agzw*q#f_Kl)&ExIPd35&7pT@fj zwXf{t5UYre&>$l(k)3sVB^}eAWKEo)DDqH@%*Axqe49g94pahjp0 zSC^C!ZBpC0nACzd^MNGZfh`b6SY*6;Kq0cSIs`DZYiPnRS)!cR(z&Lk7r*7cz`sM1It3IwwCJ8^P zerNys2@&zBLMOz!_6vs1R`x+ZUNXg;_^<``h^T- zbyt3l-ZL_O)-_6)CcW;i`jDa_&?s+Zk*iBhNUA5d2t?iwBrLRW`rD4BW}I;Oq2NbP zP^$o1gCxrS#{B~VIxx8)rSUF(gp&N6rXQaRI(t8HMglORBwgp&GuR?t~f|KzT*zT%(c|9Ti%VmQ|zx#A@(b zm_JOz0I*Eas`#{2XEL@)g?$RToFJfqM?om4r6VCKt8&yzCYFVbmNn6aNv$A4!KqTb zA0xB{2o^2`_in6Ef&-sURGV)0l@>JU&72U~**uHko>Z!9ruC-i^mHVE%ep(3-Q}n? zSDMlrMPrrwvWoV`m7MFyf$`mcTd@EbHr@iS-#i1D;J11Bgs0RnRX1 z$AvBhHXYIaBPG0Pr4@z1&m&3U!mAGgOk$e@h^)a|6}`~VTOxc-kwZ(xNF?d7?`JYc z&*>v1AUt%Wh@L9+R+FJZHDy)Xx{`8eX8$$;&J|*zso-_u?gL>)6+ONtc~%a_2!J)6 zJfJcv5W=Ht*3{bPMFxoypQ}hR6{jH9)3f%9D4ex9okXlv%0Snej$pDuJ_(o~(!lQ( zzHm^{Y#!5^p4paX;gp8NT8DBp(z@_)C*D2fULRLu!Kd>COJ$;Zgh&+hdypjDT3iYF zV|GbR#O83N9wE~rzS0LC2QP-{m^$$Tnw41raxZ`iv3pMhsqk0RUPNyU41uf;#SYcd z6KKEQvsJ^qE=G{MKkQTs3XT?jVPJXB@FaU{!L_eD5kQSTEF))0qrO@ILO{L0IEt0n z-Q;#uUtOU{E}l4po+=4ERK@q8$DaR!oeTevv07o;aCA5#kgez~rddqrIERW@Nd^6~ z2JQ;CzNTl^+@68JsYxa+w)(_Tr@=0Y_Q}Yb)Ch3>Cw$CjbxFmu$z>!c3F+4g@1shM zt!clczJkqOOJTUAgBEM&K#K zKGdKFe)h- z3Acx&Q2SQ!twKcN8*oFGSVI|FCLuEqa}h+~MDNrI@=X_HZs(p>OATc_I{dRphuegm zh`_f{Dl%%~;TREh3tNzZhHa7`qJczwxC+kWwGX=Z>ol)&R1 zI-1n9BBW%YDQsJkrE;KBKxcqK=OqWF*_9E=D#KL}vdrowWH8(87R=11nU+|{inPH9 z{$unS>PwEBkS%4u$mR%)+)Q~)Gb zwKLXt3o66-!Nv~f5|OlLajO;`20;c3nDZ|y&NZ6j7qMr~bKE&usPwcGnrjcnj5F;; zYcLbL&`yA^Tq2l{#)W`#j-E5$%{)MagcWuFkl9a!0A%7e8G9M)8b4<(Pf~RqW6AYB z^CW-e|FK|1dHGujK4E61hrW#C4QEF|!(;R zhM8RVr<;ku*mZR9d)~2VR*zUYPO{tPNA6W?vOYg`t|X?v@l0YiGc+@Y;=H&H zyk)ia5V%uL-0fbt+tb^2OuDsf*kQ1g$!(%LE;t0x!oX0=_w zV#eeJXF6x(g<0GR>$aB^aPh9#h3(7ao9Fi~qojBo{2Ns;Kh-t*9bn%F{fXp%{<09b z33-ZjCq8AWVM0@&m3Xm}V4^M)XhU(;?61;aQ6ics8KR-Aj)_>XC+r^$KA5_YNO9>^ z#|wj*4vB(ipSAk&V~>_g#$shNf)BK+!Yzxzo1Jd=osI)hj`vP8My9{c&xcmaB?dvQ zRDs}crk`f%6StsTY%)K9N*ad3#QiO`ZR`5J@E6 zY)J)Q?Gc>;0L;w+hpLvNsppiN!=g+46;43ilY@Gx{vg=cj=UJHFl>?PF1E)XAbpAy zy{s5uLkmX+Y;4CyUr5BeUbJIaUr5+I*~te9%A#I`EmJ05lr+RkV<7$Ym0aZwHd0Ah zn(N7g7ESIA9cUW@%q9fdmMNSQ3DnZoB_G?#@X()8Y{lVG@fQYC!>$6>m;5ZxYPBN0LX4!j3d%zg`^D!XNcE>=&H18f_gnZ?Z@t;Jh;GT zCLw-Okk7raVseq={Vbw3oLUpG{2n#?1I1^F`((9rbhVUyDny9GipT9=XFq9xSOCu= zxna?x#b9cpf;DaknC=GFOEC~ow#$k@a`$QRxx5puX-4S!sK#wCjt5$N=Ni;q_Jllb zu1x5pAeVABFYu${dM8IJh{V%R%_Gn{K{&0%$$eBtp3ss#m)sM~nzw^e+720!R3XME zc^h!A*!wm<#)hYpSRc|(60wlT4OR{$avZ{tX?brvKm^bWtGTx68U~`>8dlL!o_FFn$VN5^L|aM>dxnd{2)W!Qn32$ z)#O)Pj~xdE-0x>D+RGJspXuk%8( z6#w-u$Op%v%tAYW`az>VandJsD8(|h>^@+Py#L>y#5CFUL&yvi!;^VW_w3mr%vI8^ ziijP6wRzuH2@*pNB9PbPR+fn|@pWtsttREF4Sh`@5<8kK-wIcY&RQOO&mA~~4*zhq zLr4XDZ`>RM<1c(ObnOO{Y`O!db0?f?iDjQ(4e<`bJ-YEIIAFy^`8sUEiY!eGRHs8QQIcAx9M-yDFs4UvbHuDq z6qhREJe95Z=Xz9Novs|2yYLzc24n6$(!j8b0W8)1=e4>U`R+?@2+r=4PMcI5qV5A( z8RUJk9}Tf^7-S&jq5Z9Qx22|RP5$1H#9m~Y0*{;2#NW#-OY=T=5%Xo^)VNf~pG})r zI%I=qw835g&TsxxzOQOWQ`2FU5yuM)5tzHbv-e`zV`c?|*Ns`D5Qr?ZXeF}4`RD?hEt@2l z&BF#_n^~%>PF@h5t{p{&hC*<$WxqU(uO`+kE$JSA56vNQKSivqz&jZxU)^Tln z``KuivbE=f2NDaMTyPO=*|+jF%7iT^1kI zJ1dXjJU;l~|Ec%Vw7Wx_v#p)#bj|1H$$wP2lVB$0Np}mKR2%e|$8{bV4)}hS0FPlP zk%&5pVpXXCBV)=Xg+IpDOXzbi10P4dNdaW8#QhR!+f#POH}xu^Iu|n`26v{ABE5xg zzd^D3fEwWU1}S0O4+O2KB+w+virjItu;jCt2&>9c>L8l5lCTjGNn|z0F4$Hq2o|cp zIkF*3Vyxdn2TZc$`YzR&NAHSKZupnvFYKBiw`wvZDfy)H`K87>mIC$?8dY>xj0kgqY{V zxS0IpERW>6Xp21_0;5+mhIP~ecYazLpYVL=%4^|6t%4B!m9*ox!s-!;y8`)wzi5wr zBDTOt1f2ei7OBXUhL(2D)0Ua`{7T0Ha4nK+^K;cCh{}(8&*f{2;)8hR0&32&UnK*K z2nlYwxL&2ZS%PCMV_;i98zDxqNX(JNwb1j2lmBIC#p%!g8E60|OGsKA+<@%pHTGDW znQ6tcZtoW*m6UMws#=KP4Dz{(u2ae)HC!y&ujm(jTd*m)ligpPJol0A+KQ6gMpiP( zPU7#BJqnPcrky~(a$M-UTcv8ihV~k+|2Ep7KecSz%Nd@wnQpq<^SChk{7;90_DCkR z;-HXD_X!pLoL$f6$~3qh(!Lzmo;AqsmtEV2ullO0YqI-t)vOfpdWqP)Nz+!mZr&

    &d}QPGxJoapLSGg{vKg(D>krPt!$w`skXeSeiGQ259Fo4`9OhB6~^jG9@uP+&EXd9$J9VTFZrIVC#EnhmZ- zdl-6WJ}eg!P@x(s$sa)B;jAtZ$AIkS-qdjuGNAM4`BZxxA4$qnQ2HvZm zwV)^DybgYi**|kP?#E1J5r2uZ*MA_VJA)uMVw1HKyPW6V4|;WS4yv^NgffbII}Y2O zht*r>SrZ!Vvj<4X&idn&v8Sr13qEqLJdVMptY*k-r`_7?9TG|y47LNzEY@mh2eZkK zZ~xMo3a$Cd+d`VMsIcNtRkJX4B`P$!JMfx(4v>X3<`M0V?CN+Mj{9luVdUVwQ|qQJ z9Mq%c0w7;w7@~NA6<<4j2mfDo?~v|fzR8J49^!INB>Q(}V?fHgK-ORk;KZV=7A*&M zX4d%R<*^$HcC(_MJMO9M;gaWOQIrTAo_CFk!5kwoqIB$4Hog^;61DK1@ecLB`4e(y z@XkVBpb9FkZ%h3r_xfp!tAKr2RSwHMu5BK86|XXHz=nwl+Ujkf0gW(wp~qRpMUe7| zW0)~$>`UM@6oX1*F{7SYwXY;~mFcvC`Uj!`qbQkA?rINlyr*bi%8;doK@e_IMhyIc z;4BBCdhcRDNQ%4xE3^H=|Uy z!cAjg<3t$;EY&&&FPX?4-YGj) zgXIOO!|xKXXc)Vx*893p>LMDU5(7A&<8nK$X`!A4Cb11iK=xNZ~m}s*T;W#Hk z_ld~$ufD|Q%(Qc7Yu*JJ*ZJ=bIHx2=qjl?@BfP?{strt*!o_N}x3(0|62Y9}0dN7p z7X_+C%#Y(xUy=zv7KSzSow+0@f|gRU6YHV3Zvl{wD?69ehBIz>jbq&6tQ8KOe8>+t z-Gq$8>=UQZeZRUv!M;Bo$?PIu@dHJ0?S3!RbBz=|^yIwfc?ULv_1}|5p$~^$VJ!RF zGiwa#_V)lM8F?No;#?&E2>`Z0AX6_9pJx|3BLcZkAceX#I(9!i8J@r^m4Rn@D*5f| z*}K2xJAV1^N%z(4DniR^QOE(kv^&Ui(*NKqF2Qy)Tuj7Q7$eAZSYv3XVsCC%bN*)` zXdD)tX9lsgly$3>7+r#Y&rzvy&qzJxV)Qh|uvt{?7JZzRQI4rN^^J21`v8eB6r^L> zDs$gM1?L6_lEW8Yb~yMrdE#b#FO>FW?1lq=%_&1O=P~^Ss2eLw1u$~3;cJ3?eNOad zn*2|Ac>rM5O`O_apD=U>S_8P*^gD%*2G|)8`3FzD;KYUf!5oeKt);cW!#ORoRi*H= zNr00$&fP9sc#j3+y#Jl~yTko&p2L#nsW}QuJoUp>B3W?ySF*_9vdhq+l;h;bY^sc& z7@xAG2$E?RiE%a%Owzy^Vbl!Sf0n@D<`wpZ%R(r|mXwm%K(M&&o~vr!U^1>0g_Atw zf!t>|x@k1dkQ)O@jgu%A7|C+41zmo(0ZAh(#*$_t$7XEb_SvJxcrCmyF>UEa0JIo& zgq1;sY43QMeL#J-;n+y$*r{=|Z>^|pj5QZc`sEzMQ9W`z1>tS-w2fVlM!xv883n`eb01qVj}HbZWtmOV$v+<(S&R@ z-+wehi0p7r_E@y4m$dF;IW`aOWWfz@t7Q`-yUt%+;SC`|bGBglb@hAYClCl)k3eVLB9^QmcmH{w6250UK+F2O`by5zb6i>+`)t#)y zbSm~2Ll=WlBV(*3RR*QL`k&I?X_8n{X+B`qDSiC)br&NytE3Ct`fUIUbQ7~ z{ia&~{=&VP1aAiomkepI9nQw)6IOY{xZLPl&QZNYjxjbu32-s<`eI65l`?lt!ossC zEj8D?vL@?Ts-^qoq`Mi}f*kAkvqq`&`IbF6Q}?4GS%ADcVgwkJR@BCD18+5OeHRy; zMa0)zX6To)FkEj(X9lMol2%n+dl|C>tPqg^VjhSp@~?!aTKGYNK{W{?Yn9P~F&-F# zqlvumt!yCUs{O@p6prcW#5v$|T(T*#Dh2I!wtMe)DF-@bd=2VFZ#4lid(u*nhe=6p+Dk@DDgv zKEaGe@9?ZhJTl#8@2H~#{FE{}&N`Gt9M$idGE6d$yyuz1SH`mkH%I~{gV{oAuM47) zn@jLV=Bk%&r$rc#`-H(FvGKOjI!O!NRB4D*ei(PE;xwBioU?Rhx|K^36a1)+!enNW2r{I^>7+xuC^#9 zy+=;P=?l6wk4efs+~Ybt+Hk)3LRc8qHDgp<#9d^5BHppkCNEn=Wre;O7l1CXb)NQX z*Q5yad=_ZgGK16s0w+?=r4~9Pbp|NUhkYTRR;ii&Fe=wfy63hx>X9jpLcfF1*O&G!anN z&#h5=Txz%DEbXLN#%BIs1<26R=T<*l1cQPJ+a_wm=e;&O8!h(PW~!_10^ zj5$858T<;3Da}bKs^JC(6#AFDEa7Q}4C!1*{nsvw zy-(2Wn4aA1#Z$ryUx4Zn*K3K*7ZobbE+6=q8J4+8#a|*9ff_`%AEqm47d@ZgfMT1p z_b7)}7#Roi?Vp^a49$i@qVPyZ(Vt0VaP?cmQ-+Q{Exx~bJM%(Qy7<>laYub#(12Ta zS+R3Ou~cDGzuDB_C}o+?nT{bb@8?7;ujC!LgS%LWQ5x^x`9xBYl`yt^puHEq)SF6n z6YnW^5K-b3P|jDJ&z{o1&gc|rRHy~1l=iGdQbG!YwH0dU|K{6!USu3u8I`hZvTG^Y z%$L<8yV)G>J{n9J9wN;NJA_sjF!F?*1q~LM!S~d&1^`VvWUF3~TY?#^L%Q28q&1&N zw6$p)QwKcQH|CsTu)~-LYkLcHwG!5fMyFD5KxZ@dggfJl~LC6VbfdozcYQ?~% z=XyZ5z8ICS9_6hD#*>K@uNbRTcx5*HhE9oO+P{?n6R#!BfXhZ408%u1&VFLdIOX-A z2k~ytG*Nze(5cd#g0R}qgH}Tp$3j6R4x!EzOjpx-=nW158X4S)japKt8UGkD3?U7049Lr#Q*DkZTy>&1 zJnGL9?Qpk$4cOMj(IXcT{8++k!WY!*U9lDf<45i?Ari{wE2=#I6d@3Xgy`swfGQV^ zoCkYML!_6HD=SzZw{M{tef%GVX<1wd%{`A*edIT67A2&S1A~*m_B4FyJ%}o5B%>Cv zmc-mo#{Ibpf))}s@vu*BRUO~vrKXefTi+%ItW?P8Y@_>X#Teu|&A`x=Q1ODo|2N!_ z2|6TN$w>RIA5`a;(zLQdP-XZ{YYxBxc0j(b^V}vABF_O3qj&=eO?SlYlvKw<;o>MI;VCF{&(cmw`jJL=-v)RXm8wsymI-a{{=an8(RQT#Fs`IJKsi z8D~E#JNvR49bWBqlR*L5oYA}Wt!?~HHp5O+3SN=r^|bq%r7{}6VJ^5W9qbkgBHG@x z7IByB>Td6*|M~86qDx+FqZ*)9Oo8a+1exB2dWIwpqj5yDEP$R8Es96I?K@{LIm4PknAbVta zxiD}Hq`W{$-3tx<;R(z0lYE5K8;2*lk$7??$5g^@CgCjw^Qi2FwbF(+<|X;HW-cKw zryd+8Ae;saDSD82wg6_1$yhv%1qbbQ6)QtgLofJBK0X z&RK2C_=gG(g147e((M@BMpKd0=267*{EhN8RI|=~EYN*Fx}QCQe}94dfS*98(zU1j z?aAl$3<~b>d#XB1u77+fjHCeiS5W-lQQ3iXg*AZ6Rsp0HRr!wYIE_Y(AN-hKWir^4 zlxfZ0L5}wB_~Tf(@>r&%tAl*Z#0l}lT*$%D;^;R@20YS)2*oL{M&TaX)Ua7<`3O{+ zG(Ng7LA)kx^mg;UbxZC&&^y0B`#?II=V{p+9oW?OXa(#;+V&g?6QNsI>v;AJ8OCT+ zI_kbEyZ#R?&5~EXvRQLa6AC5iqnk&9J>0jGKM|tk8AB^&fgij_RtV32Ud7&Zyj3|0 zae8AvFtdkf^0Qkt!Oz&sCVT+PCgJXUxw1d&zUkA&7ogzlzhv*f<+{FxS#)*qKKA%5 zzx$tADj53%>bk?jyg$G2`SuQ1qz!2OPJX+5Fl>Th2A%la%==Fzeltfv#4~4QlCsK3 zZUKdD2;i1Lo7^!8x3m}lfDjM^00saSRNEk(tF=*5odQPXOO zV$by1;2l+#l9JsUj`k!BOaK7L3?0n@fInRKeSY8f`)_yq-FLg~b#A*Yz0Nl4lC7ZB zF5B9I3s}?>T_I!f^N>n*aaL`<)2wQSSjo4?>}&8tFkk)h>%(Zw(qT3S?HRhx|#<_O`4_Wk@m zp*DJ?Ni-J3ZNMlcj0!^Vo#yd}MTtZEh;-iqC6*p)?jPijnY)g*0t!eB6>k;Optc(M3tCBQ>-nd6dpBde27n}t@%bk8iFE0qhZU zMC>MX4YFiBJT02F$kI5{L3K4A>`^*{FkpG`$V zjFrh+YSPj1vU^yiR!{BYrK&vXNvN6_Wvap~$-pdko)CjL$`9@0?AGe9B}E~Dq#jrw z%fHXSYd|6eibMY$3EM~`_YW1{^23`eb0z}V+JG@SRY3pwTgq1 znURMQ7c@@7^tjH37A;y>5V0F+2QM2!S{#4y zv@$~&eMy0u)F#REihElXZE3Bt*S6w(z2;g z9GQO3q0G$wTQ*Z%&kI`i*=VA3M_g>9Kpk1thEpr~HtRo&hDxLtL9%vdT@^hjB3+B9 zp)0NmTl^JbBeAexDo>T8!oMeWUnM!RI;lh_;|ShCkmV-)T@3pHRS|$?Dcg$1B`6wh zso*|GuYk@KQW~3FOe|(qG)ks?I|B{bDpCAqO95gpPhoSagSiRUztMy9GABIH!w17N z&@k!8_U5KGVGSNVt~c>|gXB-|8!OWv54-_>B{-<5fdfe80nt;ODMu?JA5=7*(K|1R>U5Z5@TypmMAD+l89u~f&OH1S)1rf z%;c0>6*lC)VubhkGP|R~{4+I@wJAm}3%SMIa#e&SDbAX7C-Oq-uqf0VU{LCL;;QoU zl&>@_q4Lnpt|MI%RI7LcB~>9rBQ!}!tw7CHkq2bNco#q8i>%~O>)4LgTPZEnMH!Ew zGi&#|`xb}a>e+5_2Juj_#tRw#5t!TJaP!6&2;~#^8zqBkOGk&zTks{8vhk?1|fN(#46f0n`SCsC3pjVLoB=ZKY^@U7)NbDj zakON_U0U+FYd;(cyR@0SbfzTC1a6WN_6UE*q?7myZ>DY%^DpKmz~lk4hzdICZyNMF zv+m+z>>m*>tb0YZLqFJ!=w)?57#(zu%@;Q1js!eCYf&h3-VfPJ%x@i~WQDVF)Ru`Y zgZl;krLHK%oU{mp?MN{gKKLUnUwqkFU)m9lgmct|Di-cnu(p#x>FQ$es~f?KF_u29 zHCwBDLQlXXroQlpJj7`hv>IOnX0B1})|t{}Gj7fzLtG#O$L-@aIPeH)NBKHm6wI*| z^?-($=2sI|VravNSgb&RAe%U|CZ>n&WUzc;!%G@z-xDQhS)4A^6r0g-L7AY711{sZ z|L;#*%z}@n+d78N6}>#-I$xvKO+SCe?P`Lz#9JTPV#M$ZKcw;yc`zQ?4YkI91@s*I zO9^FaGWH^AKQ1o&Fk00QkFbY75y{R>wjrQMx`%*6$G^k>vReO`_yDpt^A{FL1%P`D z3Yr@e$nhTn!RnJ>Rl8Uvc2Zi_i$-7wvG*zj4Q~vJJmt9)&&^$|!Y!f2ktII1(Y-(prFw*5bNvV&M>cj{Qlj zhT6go_yv6a;2-<6O7Bt=j;xz%`RSuk0?7M%TFnd-Kv5h=&2J0;obEL$pk0kWPuyUx z=8?SfO&Phqvm!^!Hsk7ukBr3c4Cv+j^4Rs^CSb(%_XIhy8mLQ;773QV9;RfY4TEw8 z`5G#ALcuM4r_2gh3}uFVnTDlGl$Cc=gtjNxN}h63Vn@Q)XvJ$?99mdcg%6tVP!sl) z4Ctx8hK=>6!d4myro@R>+vWLhYT!QK+|W+Pw&izt?Rbln z=O8tdiIP(oXskCd2e8amz{%OcZis4>>R|~NcLIEM1 zMh#qnqoO2Lkkaq`K~PnJDB@Uc3%HcOJk-0MnSBcFeZ&E7g>fflKD%Z*5hLIaIcMc; zQj4EXP88X67CZw8k$L7Na+DS&*Y=Xed89%Qwxm_#indosBA1^8SS<1jvHp;sRD1<{ zdyCRMnUu6%tvoij)ESX>G;f4tlhG@}V%1PqcPf;83`@6#oO;x$`P-F=ZF<5ORZqY& z2I2;m{7epW-JO{DGWn;?0ohv+>_tWMJ3%gu%;R_@% z`F;>SDf9%F!@?y@VE@K3F6W+6>$UGYZj`;Xtt&#w=3bd`pzm&`P7o}YYO*;?VPwK0 zTrT5sN~QV`O-)LF`yhShUh*30rdxlU{#M|fB#E*&m$d?tW5DZ?2;jqoch*etVq@+w zjxFwguG~2J2!p}lmHu7dt0=tTc!C1DgRJo$UKrt9?GuZ7cq$eq&Df`hN&yf<~aVMDRh)z&bi8T}Nf*SGK|_od=?*mJI|B7$|a7v z+6P&JQwc&CEd>Yu!jMbCHGXbyCMq%C(l1(O$zlzm1YjSp<_*@c;hyIta^DY>5ySdd zi@Oa1S^sR^9K9qq)z{%oT3p!{MEX-#a$HV~Ltf)K*C9uUt5TmfNzISyi1X20k>%*; z1f$h>vnu7u3W?cjzD)WeU24Bwcq6+N&-jQ4LHmdPms=K^LRHs|#d!fHaj(@={(q1^ zpF6+FiZ+YTcm8Vm5m@~VmxqT{Lu^M4xR%tBgY10D z`ij5&8EE>tc+($l5`ZkVK#4(N%OsQo)*n4+UEmQ3jJ5E&^L;4od`(Nsy(s)3jbK`$ z^p91+h;E>PD>T^t^T(bMOrDuaSE3_1=9=io7>3jvw`n)nFbpWBNV{l_4!lJky73L8 zqiGc11mQt$HXFy0u%GsU;$d7`q4Ul^A{ueUox*}U+Ak4s>FBaH3UAzUm}I{qlBFBU z@=?iQZ$$e*g!#S{Q zN39rw3h1|w*Vl?LoEq>|c#Z_7E=vI_rXmWUr%@AN3Tl#@@i&4<+n%&7Yp!)cIbvLk z14<>d6uG5b-hGhRYd3K4x1_6p*v;MJ_=Ny)&9>e;75gS}xDc=}T26q$eF=dctb-~P zW%UM37B><=Q{qeUtNB&N6iv=n>2*_a?^c(H4PJ$+P3Kt4LcFegQ% z81)kM>brwY4664UEnA&cSeqNlNn{UV*@%sq`Qry^{HO1~{a|r~YiHp>ZQBFIeR-fB z=@h>I`Jwk)Z55rWTyVv7D0Cl;_m_b-x_rL&Ec<&OtH8f_$?roTs7<_u2ln@h#{U=J zBSot6e&+vQqfWH{ah0Mh^3Anp*A48~RW0{#Rl?U+u>t3DP?$nR57&B~ry~1R5$m2B zZt&4pM9fhhj4L;~YvdOf2aP~uoO1}n8Q4KZQ9)JId(v&j*}eGZtKmhj#_}gd{qDd1 zo`#7CW}J?WeDK0pEesy~;jIp_f|ZS|^khlq7nUu8UQzOq*cGWRDUER!{fo#iWMXT} z7@3?=lhEVfvOIk`+Jy8w?c4JOrl@;3qzkBdtVse|{CBmG7-J=+=+SS!x&7?Dzuhec|L=N3$id)i7V<@#U3P3m?bSH~R5cIN@&Q+$8GDXja1J zzj3@c!)>QRf>ZXjzLYqg5k7}UQFHA?w;|asOl-|E7CxBdA0<}vXSZ(I&G2v*?W=L5 zZam2w*tv1G`&oke{LJ-;%^q+<$2u$d(wSh*@u$Hq0X7JCF^(nQyUuHBdvj;kFmfQt zK?IeW*iQVLYx7vl4J7wMd-bG#NMduAr{wJB;{Q4)vS-;`DDc{up&fS`Jlr*lkcuhg z%oQy*(%M?S1zyVs7eM=sA-=RDST0D}r4)VXf+Q9ei-k{(LV+xREncu; zT#M%4=WQjk&eAcdgO`yE3v2$-#Yi9Vxw+L)F5m~hP|3NVQLq3qexAT#Ne`Qd+E#0m z{Eg~XwR8G$DjT-Fk)LlqSNL6xbf+KwyS6>FBX9-*NY+jbce*Q7>Sf?9d}pj)K~v^| zIqkl%5}Yo)@Hm{uJKS8}D_7tvS#6Ob`$?ZIHix=&j#qK>On|r+63|>KdE%dT+UI03 zW5Q~S=P6FB%DXqpoF(bh`Y5BTxK4XFn9~PFSlQ7=y+e@#Sl3E2GSF1?&CI}NsoW~k zQ|Xr*JsW?J-K^0l*8h%q(O?$CCynX7rhdNluW85P6_|79(UTMiWD|bOQUI@A0GGbG zF9zJ%NP8%7^h>OyPnP+Rzv)3)){{FA&0i)Ap4mF8B+|HC468dM*A1I6y(v72)VrJ=I!nxs##id^w|VU`GqmJXPPJHHb<$gp1|Frd6T>hD?3sl%l#oTfl% zMi#9b-#$X^a~Uj&UTti{POe>V77TKMWl_-;d#=Cg!7R$n8HHtwRmyaSSc7z$gdeG z`9F@N@aQ3dlhB%K<~vJVFC9Bp{|3+{oyQ+I42;9G#D|E;tSJu7|}@4;2Q4F z9Sn1H$ZPhrI<*OgseblfQL(j<0`{s`i*H2(S&xzUdT8v$94WABS#&+S^RQw7C}h-# zXd@e1Vs@BXLAqYVI}t~h!qQy=zNS|JY!a^$xJ$b~sHW54@a0lKFL2$EoZ~+=b5R?Z zMc$?u>Zd6!ZD|FHLvx)ZrW?5klOIR2BWq=>uZ6@K%gJVqZehA_d)LG*=)JO+vdj89 z9Qzx`k7>&HIXW?Vi5d}wr6Tp@KxSulsgB}8rF798$w}}yo>sFv=SOV*3u^d<(udJ< zS`l{OG%sTdgXQx7CMuee&4t_Xly>*us*u{c>chAnf2DSPV+8b!9M$aBE@c(_$1`jH zmz8kiq*>_uF??rjt)vL>JL~3AwxWV&9jl`a1$0{G-8#e{_ERw+q=Y4#6Qn|ri|&p- zB;18h!Xp+U=b%~08tD=XV-J>Cr-{L4R7JrX#~k}6(N*L>(%VGW#1mm);G%hEc z$>DGg(w28+fnbLscXw^X-3XLloq=9pxJ;@_mcVa3d%)?bLe`MdCheU7?O?A1S2e>s z+?9esC|c0k@rwGE#6)T$vTl%+NTR%93BF(#rj~+u;F%h~eF0LwD=^3_!RTmd(OPhE zfkYXNdJ599lZnSYD|koa7;_TLqGQP-rkxWMvZ5>zJ9+j{Oo@ zSvPx=5`hj$sXD>Uf4%PSEhs$dPRcb$9W*0J$)*x2wuGe-OdF-cr}Xr1Ab@%K1fnpC zwwzB(jhA&=7>lyJgkedN|Lr zpM;uDRgH(wXN*LJksMJJM?qRg%59y!;Mn~Z$NdKsQycH<@1nG7C?y;SDIU9IcZ_7Y z@1g=Z8`#}D5CAwocl<-GKMv|Z?-O&<1nw3d(cm3?d9v^0&wFI(93|z7WTN@#Lj2?i z^B)$vN?0@O^EHfF6z`70_lVit3tgSIn4&tm!$PN*>P{aPDvS+~qs~Ove zcv;(yu;6S*}Rl^^1F6^!vVA9Q=;J#~+yqR(ni z^5r{m7~Lp28BpR5y11C3Jj-NL{v=umIE7#WcPh$Vunz5lheR9FE`uTux^R$DTXy-O zNiccgWptiZGDR4|EHZI$zb8WI>`7=c@M`4no27IW#z`thU03IVV7>~LX@r9Oi^a+vX$A=$RR z_c|9(08;wBdDFlk!`^F1AIE=M_UQO@>j`zP!)lwVR@roH6H@#e}rXnBYYlS5P}Yr6>1Sob!!gba_n!na>@R{U!7=ysuI# zRdpvlw`6mS@VcP~WSM#2fEf+Dg`(VFp%HRj^ch$EOpWA?b>tF*!##BcZd> zz{{LBGOj7Sw6+QbjL{KqO)YGU%=GS#Br*TbW{Z=)&B8`m>#3A^bX78#By}WOIRTYN z$ThRAi~4(plCEUtO|Xttt@yL zE-R#i!^*=qW)PyCA#i3;3A2K^A)1AI?Rpk#KwcfP_MfJ-(cncx{s494PO*;PHvfEG zZvM?o{xopAga@%zXmYh3HpskU3{EBU;L4->t|_Bc#2c>`GWuk}Saib!JUm4~RzLKC zPDw(Y297IeE}S?}N{rYx!^3~gZscmmuUrWs1vxK8+xZ1ld}gfQ!B3KZDT(>#IC?@a zCa^0Dja8i1*&~6Tj0yQhzRX}*lHfPMmmFeE-xT{7bb|Tf7n1*qn2SRQn?22s8mx_` zWDP5GTK8}VsxYlq2+>`A_%hBGNQN4Ef~&QERqHfTJEKp zC6Q24lXp(LM^F2JyNICL1xQM^s5wi!RmW*~zvUC$GQ% z_@3>|aLlIG0?2{EgJQ)L(IvCkXI$QeFU%@CQ$K<;T?LQR9-_?|)a(2exhq1C%^mo9 zvPyjKAJG{z#aY!$k^jeoVWT4iB9c(yJ29}v6PRW?61h~Tbu28^oo-5BM}r2no@1pt zlh0j90~L0uQwAlUpM)YFoFRQe#ePgm#e}pNZZY@TL~&gRcLpT0RmN+xm)$PsiR0&& z2c4?!riLbb^g4NoNX%AZ?vq;dk>TOS+2!R}p#nsm$3#Gh>#cR}j5+l}0?}a+pdDuA zPF6o*r0tnPa!aWdCZs#-SI*E2?usG6I+->I^YrL^r``;-`uZYC)Uo#B5Sy_h>QBR3 z4SJW)-@f3!>wj_Wm2sLX>D*(6uvRVl{=R|0bsh}oRoU%zo%%cU!vF8yb7F&&Yu=9m zGUF03)F(&KJBfZmiSYnSK(xR2Au|eX9*W1OiH`R1B>Qmv^i1jxR*a+^!9q%ktjsMq zBVB%8Shn8tT1q!tQJmM}g(F2Zd7-kptBAGgxB*$F$qD=Z4!?gZD@GV0Mopc!&Dbdd zJ@C6a7!%`H6T7bn61GEBA}6F6>j85*NyN?2GfDRD90&+YDL_389YTJ>)P#2!2UZro zWW_Wqfw(UJx`aS?$hx;n377aWHa8*#gPh3N*Mi{Dc&z89QoHS^B#_^5;ha4H_m2lD z-H?jp)W+x*@#3AspqQi{+&6@WgN28L{6G)nX7Be7GQJnhe03L6KdO=V->u?L?fb$H z=)P&t-(UT=s?9>QeT$Ry$<5ZUEcO;U^rn-L@NAnCV)a6Vb|y~=9raj)w(=nRL!l-@ zj|j4Q+(hD={=cdze}tQT(*45xuumbVAQ6Itdz+IXjEI3$kgpRE|62V7!vbrZ`gMe2 z_|lB427>->hMxyT!wyyR0s~CHGa7X0Z*yo)XH}{aeud(V$k!{R;g{Smk$&&{+^-aJ zB_3p1&`|5IDfh-;mbkQdZ55Ivn*D|$f6@D!F6#Rs-%Ty)PMva=^mXMASW650q4-P@ zCU;)9jT6#b5YQBo2MR0Nur%p3T$%zY2Nsx+r2Gn}9tH^+5dYJMr#~X&JfujqdiLu` z+HaQ)_mAK6WZ_Z&a)qfMSeu@w)TZ?vZ8(`iT8-*Mo0=)dS=cn~Q#S zlq9!Z2<(`1QhQWU}Lqg^%%1D zelFRiy+pt0^lX;Zv?&r?#>hco?oJXKso4ete)^c>u za>LnGf=>Dg!5*lcayzrIz$?f=m>6fmp)RpyC2iw5o~2=Dfle5#f|{PNK==1o4~)5u zG6p2z{*SVQ4Tmdx&Rv{ZEFu$da1+2xpeS($TDYy=1rJh>uC^<@s8dj(p=hS^d<~JY()5Eu`rbFLu)E3=te9hc; z;*%y|C7fOavcWMFkEYcs#tQDuDT|->nAmS=bT^@_f7CjZdXJI26}6oXyevZ4RrCOY z&AK+B1_WDK$_?{WaZL`RS0VJjX3t`w4_=mMiemBm5fr{YhHT%AqiF}1r`9HE*BP(6 zxcZVGJ*iAe5DtbwZF~q-9JpTyiuaG&wiwk9k1(q23QJqs~O6(EF-rIWRU$9>&Gp0 zNKu*JbXU%#J05Jw95+Pb>kB`G1@;Ul8iV&q>$~%_(Oe_~`8O>iP0G>v zAp*kylPf=FPDkXqQ3yx( z5nf|f%;HPE!_krRG^BdMhL|CB#VZwItTg!bN(3YnksXp4njsZ37iTW}F3oimE5Hz& zkEK#pSsG<7rY8B!Kc#^J0{O%*9kNlEq&_1O&#K~&^POIUwwL2Jq=D4%-sBgPt6 zYbJ2EHU?-)w}E#N3$@!m--p^OU^=TXE%Pew#=C1i`1O!s?N`qIdnWOKWlnCf-?Bc_ zZ!D7b=ERr|++Cef$&$29=e1CitoKKHjGmy*pYzhu)EAgA;rN`;kuGcy@&CU3u^ox@ zehY}`zEh{BRHpFeJZTbKNrkCF zSs?yN%3et}2B1za%v2d0lr{#$$;igSkS-7q0{{R3Gc-^m000kWG?m()oU(Y2G|aUx5QEc=Yt6(*kJGf|-vSCiQF_v;PK!&Il1_|_yeRA_ zg?FwHqhOUB*lLG?z+#zk!Hk7}X7)_tL1MF)Poe(jEpHJ)(&Jz+H}Y6Ynkj!&14&(SDJ!enQ%B3RUE z&7~@`D%inht&m6CAbPZ@(&~()GD~~o4bNpfr7!NLBJtR0X~n$!O5T>zv=)(BNrf&W zypdSO_9x6rS6RZUoJqSgd!+@!0WXc*6x)&KQ9e}!-ERcpvE$>CsfalRbo~VmFVtKi zjHjZmhZAzNjY;82<3lZ+E#W2xxn>75#kI4^5w&%f0_pxkKAv>Tt77~Fqyr)mbn0%T zFn_hD*`s@%at2V2eUKg>6%GXGI4)Om5n_Is0l9H!7T4pb`&mx zW?jaYef!=2N{}+D&O*`y3UNFmmNevvI%vtToMBD(@5nL{52@I=)ZwMDI!#*SNlEuj z=tA>~x`a%V^^LYzY}RpmV8`T*H(2i?>tPb9wut4Vjy!NlWs)Lef!ScI@8$|ysZFK1<#*riB+o4dC!|9@lk zFs83ILr7jW>5sYxh`nsLx3eKj)u_PU#w_9Yx1B?4x+6!!ctw=zN+u$tp4`OG znK~t=UrMPCuOhq>mU>c3n8fCzA0x3+(uYseDT|@*jc6Hay;(|5TM6DYr7{Mkk8jXk zoS(Be+aw?L$#PGFg;a*5v5nj#@9oX5>6s8o2{p`incmiOY5Mk{t+6J|yYvDYh!M=# z<73vi)h#Wut~aOa7K_BPjW)g-33cGx@@X1Liqy2FT1Xs{MUkx$hIQtQDvwN+xY@ zeZ;CkEJ?g1ugeicOyD)9eNr-~q-eb9zfG5J*EGgvQM``q;f!~;M8-8&1J~XW7&Y;a zo8xNdo@Vkg>781Sy4CDuEM(r^r) zJ6Q^NJM#!u%5(@R`Ek*VRNUh|MvC(RA;uXb> zCkE19;Z(;4yigZCJ_N~N{fBDDaHQX``Hixe^|x~u0eG^ z^MmaiC;;MPffXfS6AH*D+nxPuD1a-H(PVV*6PpGUAP(Yju*z`B=uS_TomolqtB7eq zZQLC%n4o=GInYDTspL1w|IS;;=qlINawg>=km3_6ZzNMs!CJ+OZO#h!c`U0mpVsnJ za#80|s|=K3T1%^0$-zWIxr*R}%zfA@t@OR2bN{z6k|}W+^pUp^TbX-TUIX|@M;|9G zU{=T_b2wrOE~#QZRF(0C`|i#e?7w?2R9q&ShGeASQ`!*0fgT?UyipY~l}l&9zSOi^R=ETZ;me zXurk913N8`F3C4V_ZW>^js{I@E&fiC3kKx|1{Li!ujIKeWf3m#a@(;#c;H+-i6<4j zt$nCW(;1fQCY&FIih~uO-Z4vsY+rocrQTs9Pcc z7p<8RaU*$2;Z}rVh}Llz$C!XYfp`hVZYmf+K^in30tzV78X#ux5D%Ife;WgjE5Vu> zeBjoB3brZX6&SO^AfX0vu&N2gQOu;0eDL&&J#Q6eHcOtZ0N#z!6H_ z$*YNtP>g20b$OXLkpm7f^n9%YJe+q>d3e4#J%gc&3cU!lYRkoEB=a+-*wVJK4ZnCe zL4QTk-O8b8xFs^2kwi;kIrA|D%>M%HCP@nP3uJphTZ1{qZBWKB+XMgPK0lysef$pWam>AQIP82%B4$88fd zaOUb3w`O?aDzVS|vBX8k*GF}8n|KaJfmk$MYfIjxnQNkQndo{ET}BAicNfl&o7H zMEF>YP7F%NlbFH5xtyE+O**fx4I4Q=4b~xVK?7>TJ8yn(boZ{-FpLNu*0-mOrC{WTS;~PV>Vklz{y)n_bds{2XE;2ZS4~@;o8LM zdz>>=-kB$T(no^{ z^+Lpr1pu7yUOXz7g4Zo)fmjM?uq|Dam3BJ<%~}8;4Kvo@k( zEXd2?WKf3!o}^-*lfKxJfC34NcD15pL3}#NGklqf1*io3N~%u!2y`NU!;$bQ6Y1k4 z>M)G>X2V_BQg)%56)K6_$X(FElYo#ks$qYfCJ(a$85`i!aD<-@;IQ0c) zt7f9=i$h)~DF>=zA$wVw^=fM(%`;t1ImDr$WMe}Ju-$+?l2irQ%9WIT3|%Hpu&GxV zGUI(>i0scLpo2?nWVh3q=q^4fo8jh{mEUpE$wQpP!_sUxn1Y9c<5K)$P#5IE^9lBs zq7ANv^q(~Om{DTAI(At^6Smd18JUKx|WJGR6s6n1MMEdr5cB6i+DHrt6 z{x8G@TCI>Q`6G)rr+y7bOz^>tXD{HCmsHC3n8|VZN0o%u=GZwcQHxXL^`%upEBeSl8;_#Or7kzk3WP}F9x6eMpY({n) zTip3VXLU8(lnT)tv=_dY)wZtZ0YPKCqk3F~7_9rV zO)ju!S~fNM-p| zG*EwgS3&>Od7*Hf=2-5{H^ngEL_2PX)wM!b-YS{0ps$NXx`v4<4YftqTI%J`9SGfl zSggCQO%M!;z5}J>2R_7u^lR@GAZaPsCmKS}yj>FtL0=~}R=;)uIX?jPmBc=2p{&(i z9bX2um^&j9{?h)-aal~W?KZk^Imiy*tRfE~zAr+GjOdcWL0GQZg*0R`WA|=O-ih{= zIIgkH;Eorn>1Rl`koMfo)2t25`RN!duQr>-zs8>6Uk#7m_rd($=%SuvR>brJ+ZY=+ z&8RT!k>_$X2NJa)#UU(P4jvdYE7_1#7dNg%-e7cQtKl-59akY`pENtl1&D@Fqy--o zFo7?ae1B&~cb7X%h8GuuT<;>x6DI|^0ZXM8uvp4fk;IsPi8CptWDR)d?Q_WGqrU(w z621J18KD8*xai8e2cnQKtU7!eNRRVS!Z{?C5O%WI{Bn~Wvjl4o9vr>R(9v3O;GBf?y%`y^0W9mS+W}?rH~hd2 z6B5jI*I)e-b|t1ElFO=YFG1nQE;kl>6T-{SYzaLh*`dTRYO%%}M>DNSH6I2@nI#v7 z=M=RUxX(RxHVbrYy@eXjrss;RbVF#+WG zjNMAd#a*5q`gGgDy;?X!iGt4Z{ipWX9RStC;F+Qiw)Xe{BB?-VTdllLyRNq?P{oM? zwy=f-NGFmgu3u2uYg)0TbMxitAL}KWVxTFMpuNuC9!&b+V+o7Tk=iTyV=d@NL#vHs zEQ3|bDAHy0NQ}!3)Ahnh-5W}~>x*)v#yY8be_WZ0GZJpZfyUAa#xrEIymPdkzj&)A zDVALlIf5^^NiDesrKpw9aeTich5?t784Bj}_72n=oUTqHb|PyS0ePY@CzqZl{q2Fx zvOuL@=Bkf}2avzgZB=ap<>BAhwE%hj3*QDG?rH+b;pnUBU1Jt_ot>?TtX-=o(O6&0 zTH~)7qzXztR^6;pIzID!EaMZE7INP5&sGu|iz>t22${A^&jQds4dHeMf^?pqR&TF9 zjnrKX-@*b>ke}4c@K5z}^o^qID_-f9W`_*PM3LRuQ@hRdHQHZ#y*i+C(EhnP$^+5) z*QDR|_&=(YQ&r4ZaQ-9jb-JZ0OBm82EA~cN{it-$4{eRqP85g$a1}U#AzJ81{yxE| zd02Vplurrh@qVJs)fl4PxLI<7CAx|E(qV&PMWiSaa=28ZMpo#Cnl<9vx+1$=D$}ER zGsHXE%SM=d-29;Xb7g5LA<5;7Fe1ye#RyK7OIfD!trX%ns=cek zT&hjH`Q?w*NmZNBCewbL^m+(Odc71RjoF6iwfSXS0+8rBC`v%NKsu^ndGB9mqsr~P zv;+|1`F)c*%^zBm|4M&r#W1_br5EeD$wdtAhU8{*mv@S7Dc!e&bEEZ>%@wjEVMDsJ zoI@=!kZlP*=QFdQ*k^&#Zy7Slrx(X$+KzSR8jNtrNtLVfm!dx?k)O=i3V8o$S}aTV zr0!u?$*nXD1RQx=@F^DDB&(mX>x;M4*iBjsB#xV;oO==88#3HjNIZ~;j( z?2Cu7FGirDCjTtQ``mf+4tvKKS;g7L|AIk_Jfmp|O)N9`i@O zpQV#KNRMu!!Ow@{di_X_Cu~KgBx`@1g!sPyUn{XW=~cYnqM9hIlzAlKEP2ZM+L?|% zhnHMVntK43CiC&_CY7IAZ(Imwyj%eB{aG%zN{fQ`3Y83xXXwHQwg&)#tfLAJSqb?- zFKENQejgB)svoN_t8OnTelhG_czEa`i@I^2e64p|TP4pXRrAYNPDZqxvpcndc6dG+ z04k!7YP1f!EB_f{YNvrX=t#&iUxg-Z%i!vf={1GbzSqA+Y=J}-AogFxi7u>yBfm*Y zP<%1ER^OqwBqYK-`eSQ;nFMt{=Ps?kbKeun!xb>Iy1Sx%WVIP@u#8Val= zk1~IJz^RzMrFJ-ukHABxO2fqiRYS22I3KWn6~oeTv!AXs`WJaaOCOy=3W{k^&72E| zhJu(5tlw>rERRgR72Q^Qrsja}>ZlH^B>BD!4v5%*&&K@8ZoZol!!vC!mT7UoA_=#4 zghM?8LfiNNd3ws&vJJReNd>s4FVa6mOc(ESo1d5~Z$azrLaS{JelCW3@#X%(ICgN3 zE4TW7z8lsJnX$tLTM)RaTS_N_?ZjAkV?R_s1okmylD*`h@Mv*q)*!tKG`6vTF6|~k zvX0tCg>$Y(JNYf1?A|HIxk^^E(7@)K zi?euJ@dI)Spb)xnb#lQ%1ISq5@pda9K*~BQgQSn!b-n3hYOM&dGzcjNkoLum3dDG1 z!h50G-=H7_5(ZI^q@Pe}B79Ih8wK!zB!Dl{j3|@&)cPY>z8A}VFD7z*Yv$#{df=Nk zDQvc)F|Zv(WU$s&b!&c4wvNnp>sPv!pA3AEGJ-1J$WjwFyawW}ANZ2IDf!mL&!yp0 zt|f))y^G2cla1B={7i%rs1w6xZ-zAWos-T$-n!)Ky)x|W>Yo_NsLKe%ng%mp!H-OP zyWl!jGH>x>&_HQo=BB#9cCr*}I1}2Zpn?}*8ZhZHj*j_4Mazxi#X<~_8EufY)J~04 zL2O{fbmLG!HwP;W$^lIaW)n!3=Y}O(s2$t zj9r}q5Kj$8okb%P&u`V&ZR2v58SpGpOj{}IJ%>-+wJOn7JyY{yI)leY9`H(aVthR@L zRT8R%Udkt!IbPZgr~^1ao#Z}}78_PNZkhrIBYOpM%Nu+BL6*ATlt_+MI-S@*}9Im+D`ktqVFK#GGED*kU zD6IoD5T(i;pO0Otj;#_G4s!ihtksD-;)HMe}%4mEWM%D5P%Jb<#iV&Rz z>z&p&F6)z{?{f<{wLGI6QN**5r(s91RqKtTu3E$qKa>w=L#n2yYmgQN&nHM6TKDS- zTmcoiRC{_4*Is=GBB{?cBFL!)8>FhTNZiY~4wdDdtLqXzf z83;iafWm?Le9(Njc|T1d2i)Rb7aUdrIa8qmx5`4Q_ZFZlLVjA>C5%Mx5qQgxQ`VD$u$sSujIwB|M*pa}SB%4Pr3YaAnh(TqS%S+c-iLu)W|AH)^Gq zF$`h#bJ+BWx(rKpFyagl8WjJ~48!;1Odlcc#~I(8jO|%yhgP9RlvUWWGK?)(Y|7gQ z^G+iz8pC`;c?E}@6a$yr%H~l`mg)QsJo5c#nmjnol-P(|0A6YdkYJ;gK0OOq)huW;=I<+ z`c*P-d3uGu;idJKVb}4c!JGMWslT8G=N%0>Ifc$`J%V_v*F$2rtiAH`dkjVmA2YlF2}sZP8y_t*`4yt3q~VX(S??Eisex!W zxWJbCgY7#@je1n^*h>zdd&NHOxSGqIb@Y9lM;3R8nlw>~@c}{@0yO?8AMCWQ3t9-#+C5oz4qrJKTPMStMbmO6BLHQZ+Gbxp=_KBewF&L%nGE z144JTGM_42+~Ve_s8#RihhHcVM@_)L6+nv5%mKNwyHGe^)b~N~{Rw)%d1dokOu6b# zcE|Ay?mnc>6G;O7n#>S98w&aZ^oW@~Mi6=lcqTU{?mebXov9A*UpzGw0zWjUGmVUR z`1IgN&BvgTIp!=7AT=%6%~}tMR(!FM*U!Ydh;K!DM$Ztt1a^mvCOG9wJ4`!Z;J33p z9&~>|kE4@ETYwWG?Jw+V`@ohz`%=ch`-)L|2S@;d4 zkjHBo0kERclDSBrl-P#UrQqeuEWb$^ZN1-25%G29KPJKPx~5xaqlwv_e;mab8X?aD zjcf!7@v{{YNCVF$m)OM?16-Xh+bbCh*9CN044?~B z)VB1}Hn_Zb+7e!;n3?QkCv-%947o#*?>@|udOJ5k9*>VQV#lZdckFim1jo&)HEi`b z6iPE;?hnmG;Ir@O+@tpq6lzP%ykVl(dZ58K!XrSkvm2a~L8=_Nj2CGDa=d|%Ee%LP6HF$RY>Lw_GZ<@nD82Odt~ABf1XQvjSJY@jz!VCtaK zpz%l*fKU7BCGu;s#8S9~f6T|;|6xyk<?bZcScpAnv2MG zr+Dz=bmH1eMv_6_W(mymnk0S`jMV90ibL4^%mOSH#AthAWewyp;{b!Wap!dCajpO> z*ibHv?5YTm(ljsd{g4Ke8dsZLfXt)fzO`7j+q~sDS`~MC>L2y76%!Bu973>ULOl&p zM}h{6bOdgMil^dH#07a1dzSaZ@DM6L{N~eLNIsfX3jyG{FwP`&?n=o>vkk_?2So!2=8m1xfItSgE3TNB}*c2 zZTH~(j^DFFLZLm5-2kQ>En zs&T|qoU0xa!=ucKB(1!auc`r@)&9pYa*{dBfmv4;kBE+qP>PbLA~qQ(W1@Idr>al| z-4o*}7$?$V_{W5eF(@hC1FF2(SSJ<<7qII9r2adbO^O2nDVWw96fy%MFu-4izga=D zfZF>SMx`F$76rr&h%Geta=i_l%>|w04zLZ{KnezwFW6xO=RM zaS%8^c-HjUs*OHJdLz36h(7X>n`ai| z=YD!^xC~(ET72<|K^~c&D@Zu(bv5d*yuZjrf5F^(<4xm{y>Cvubh(g|Es5#nRPUJ8 zBM`_7bXAoj3^csT!odL9{*p2Ns7FXtLMH92VU3~c2tel?G?5Yukp-{Fe}T6@20b>O6pD)qjxObUvEqV&$J9r%C$7X8zh zo2kk1C{yr^zVX`!sMSBNN%b^85!0FeQCqP-`LHy@uF(OC*%2>rX#z~qJ=1DSqwCfK zHPe0=+rubH$_-bF8pkm7min8yCC^W^UqS|uPqrHz|AfS#6W6P#iOGm`LqGvnbxJ0 z%CS`I!~0#EcRsN37K)KM1P~NH)J@25ownRThmHWZl8d*2-2>!HE@)@0k?GdmrpBUs z_<<%_5ESQ;0;hNhNE8#D&w!Besf+;8kld zcEbFwczR{^>8O5M$|L$%4a`O7_5%j{!MU~kfCMyDKMrE3Vf4fR2A!q%jli%G0CvN; zSVw>wcrf-czI`MjbwAOnGfPFsdqf9#VOIY}yGNpQ=di0pk>Rc4BxL@x^;lLQLn#TH zXC9tka}%jSutfUob8qe$Rge&KM-wn%z~B&z{NO_? zo`O}Iw_dM3xC5jFGHJLB?Z!`d3$+xi;cj_@xd`M4BdYfmFkm$P64J30WCUJ_tjY{A zUb|7^wBKQUc1kA|t3Lil(zYGYn9j^T20}!)?H?zIKWZe_IoSWO9BFPmysu0qgr!S;r?Nx$yWar(B8+3*g8v-gADmH$!>55kC%TgC^m)i6;vN zEXQ^k9Z0p#H`Md%!TmcGEffGO5D)_Z001*YP$K{U4n>JoYG&N* zmoY6RE_T!>tx=&8blJgiu;h>%!=R)fmJ zs8&E(Nlk!H!o;1%6ggRT`N?Qms93{TsIfd_hoi-i!bYp-)$tjtYW2)K$r)1#tAUJ6 z^e>-JQmd3IA*-noysHb7I3#utNj=-x4$+5vS9LkBDYR8ArsS-3-B$A>`P)Cz986peC$Wt^2 z>l#p9N?5~YI{wZENf^r61#lmy{_#AoZv3H9=3IJ8&m~WZ*|*6QIIu{vpCuT&63j4B znw}QXPbR}OR}w+o8c;NstF=36FFNU(U(u&4r%<1kT20bw5vviOe9xTooo3;Y*Ve&7 z6Uwzp<;21T5RlX{h`T7~trwIs>U7lmVl4;MIi8WKo_uFPYauN=*4l)kQ}mzn52F@1 z#mSR(W+*u+XmXkC_4KH*K4(%NpmvQ~_Y^$(-Jt&exigvF$nw_1wRy zpaW;YuUYydQiy6#Dhe{Pllpf?`QyU>F|f_Y$KGPh{sAf;IoRb=fjK4cA5rjW%7U~Eix7uUD$YL2#=|Ko}P^~DCpwO+Hw3Xy+{ zCO{u;fWs(e;snHCmgiMb;gmUGG701cx?rxr4{WD-Aq8v3ZeFCeb*>a;%&VlF)ujEB zD$xbU%AWyln16|jrkY5UYJ=9{DY77F(;OP+AE&V&K#!)$u~t@SI*J^kSr&h*I3VNViS@Iwzo)u6TptPmtWxPUfG1wR)ihextbr9c{sSug~ zXQ7#nlRXPPQ?KmhytVZ*qZ(VTa|kP55yKIut7KXR-7Y}Nh0-{8G1^{Xs2Te`@*e0e z%w`gj;WP-^Qfs53K%vYiwx*GnJJ3<&dbG9<49M1jiZZLoI9iGBcZ`J)Zl~+DA=sfS zCtVxWFj;ub2%VNvKBrfHQMW#(BTp0Ol`Q1>FIt^P_268Cmyau8d?BstXpdb>2H=}f zjI4E*lG5SXrY$bF2u@gVhaq<-B{foJ<}1_R#wG?UHaRgaeb38!!TxBM0GcsxGOmlj4IEq%I)THdQnuE(o=!m3asj6pD=?C;r$zBg?WBI z;O-|gi%8lOuoL5;3rG9f86ChkDlnHNoN+7QQhuGuaro}iH-D@izSPZ4d7KZyeI?+@ zL~+w?Z}PjmDX)F($^^jkhn|)xEXj|7ZJ)0x@;Bzw=D)JY!pVc&iUIM zOl4bZ3E9+s5Uty)Smb=PMn9H&8r~PaVGCI|!2#ls^Xmf%8x=@8UKvuD<8RtX+==>k z=?Il&YC3kXN>wkIAx23^(>eCOpWC-O*U>sAIl`4IKYFKz+)6D~AiwOnkBa%BSrRP* zZ^4c?7|o1otpzo7yUFVUtLFV?;Cshk=j~m4~kI|8cyLGW%Bd#^Hfyc>$_g5>c{!^4F~@2aR=ms%|%bC5+$ zc|1WKtN8K8vIzx0cje>3zjw>c3W(y-7 zN&{Fe`qGp6m7H)If7{b0B^`b;wP`9W`mLrf&`JdbFo<)CnWhA}2vp(nACz{m}zWs`3 zRy3AkwJoHfIHHNqhieuswexb<8Jz2VN*(dE(6)*oI?K7!vh55X&rNs|YE)c}z3o-L zR96+8SfaR@YGA)O5A*0%SRv5iLEW1APOl_pr~@XY$+`(4o#tN23LUCCWNhER`UiBS zI8@e*}H9O>I)t8!DkP)ruESi1{Cvx~}H>~+TbLMl2-V4suq zxy!%;eJ)R|jH-sPJsgO<9A25|+kN^NAyI+OEUU%!ygJLn*%k6Fp;Y=FUZ22yp^RYV zNi?mFx!7aJ{NutS%6YNCkuS3fd{17{+3=DguXCjvS}hMc7`Jv<`lx#j004H;iu z%T2bdOM*43cJ{ucW8XT|#|7lsUCX^_Cl7^D^VYX>szHgwgKQVRsP4|yg`Ygy08%5W zcY)$f7gk7-cjmpOQ(SPws;|g2zt_mRTp{Bhrai0&s5h9S;jrCbm3A;?EGCtbKDa`D z)L`xokJr(9mN^*nOzxtp!90-R^JeDEV}y-S-@kQ#DtS&TGZR78D%}#=0PoRv0Y-bn zYE=E`y4D%>H-P?tSoejW-Hc}-g4z(99Ysm;RGJ=GhVz98nMYEKYN>Fb47!2{hBxg2 zARidLTsbCyQ+}Z+nyU36?YG0vaPE}g%1S0(;x@w7j$fNK# z&V@#x#KpwNOgF^e3_@45Vd%;cM#l)a6v5_X=|d=3(ZPrTBw%xOoD69fA9*hY!*C#5 z*KMMCAGgxj87oy)+z{E0UUF3%WL1kwW7s_vDu!luey4QxEGfw_`OCZp%Sw4D&d>Ai z9<5t?^9Hl~PI^{sENMCDq+FFSWP)@@X#BhqUz0Fx+?Egr*k0})Lb1ojMMltIn?IoI z_;ub6miXTpf_xzy&i&DidRkHtZ;ljf*0p#k;7Qm{y-N?iL`W0v4q{{yiQigI_aE%i zcpL*}Q)ErEeNJGIq5&4VnjsO-^#QrkaOaN&@Mwt5Omy|Y?Rw`Z*H0^!M+(+D3{215 z%cGxB05^p9`v`zg*tApz`z$B zcgWLbL-PTieIh?ym@uTID*7K42PnqVi~cw5)|-R2o>_JIfArBVBaQ(oy;=L}a6ut5 z36RJTWj=7GO7~7r=2ly2O0xTL3&V(e$D_>60or8hEuCg!4n{wFb?ArHN$8V5*^hzV zSVSz2-kU*#I`fn^;Ml(88CAVsh?Dd>>cbt?{r&G(2D_aXs_}f6Kf5Ij%YZrgRgq&u znx1%Tt!!h%5AKmeRhZuN+>z66*HIf+<O1ELZQ=h*jMpN`Llq7V$q)#ChUX~{_?OlCyHQ2+770pLr zXRYZ2q_dDpkDp)L5AA;!hgu%|R1Bq>#&8}>r`;0NU(_+Kl6}e#L!tB#)NLZyWuF5S zg-I^ok>U!01g__X4CTY?KSI&uQkGt*$j>o7L2IaX^TAbG`&pz}v}AY_7c2LaoV{tU z%6uNPOEmNTALJayur4d5jA1-{X7MO+egPDM;Z2wh-%MWWe~EPnGH_U5 z^_)gY8Nt64)NFA(ZW4S*M>gjtUK_l3$pu-a)z2Q^I*;y&l?-Q*WpHXAU>D?Z<6xlf zdD^btvfwfz0?H;6E#`p1PRjpxU=PaNf7XRTgJ9AED~U{hZr!iujAydoQo% zcMQ0@>O<+gwp(|9-{|^Uw}IkG)5b*7yMvjL5dI6UTgAkT%kPv0R^(*H&L zKv()JSoD4N^+h52^rQK%c)P zlaw?JUbBu=bdAyyX9qtegDfN|7Az#aZLo$qj)artk+0@qK+sedJ!E35a-~xIYd0qo zR**_ew>_(|I<#U7(qUc$N1Z)}#5%<+tUqveX3R(zzFLHvWc3LysX$XM0

    ce5ljLd(9|WUw&vieuL2`dqc2q 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

    6c(*zDwjs_a3mv`X;LRykx!JJKd|IHtJ8PS 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�R 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≈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

    }ANdq58Dhya73SFetn;J_;{IhHE_~@~7)Vf(urp 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 z z`dR1BsizKTtMcu4Br{IW-1%Gad!D0t8B@{zuum0QqiKWx?=#1w*5`Mu-;a3+_4SvZ zcQGyk3zR3kOz6f7%2dq!|LJML?`HmmDv-O?K_lo&T$kTo;u8o&g_F#PfcdPdQRsO1j&@u z%)|N(2ODl5!@p3+@Twsx{tzHn^Bd3QdMwA!pIjpot|H zrHYDDG+uM}vp^R1r$a`_2b~j&Aj6MR)JZ0Uqa^YwyzjHM2*bo9clQS)Of8k)`)J7J znXc-$aUb6{oI9hXBh{r~DA*SpLQOOYI7&tJ4x5!keCja|E}v*8m^E*Teo;-o;PRLCN~Ko;-%W1fOjmBI&}7BsOzcl&uJP8nPWc28^k~V z`%ILg$@Pmm299I<*E^hGmvm1pB)|6)*e(Nituv5QasNQdVMc00@CYD9^#Gi|WWI3<@J3Q(>V1Fc=q@G`jAhygUa8W5L01cID1#hr`{ zdNb_$bH@!8Ef3)e4XXj$((VJG{^$iS3k2ugZkh0?oHiSHI&~;*C++C!=Bk3h;k>!6S7!l% zMZ53|>YSw;h$t;Y zNQFX+J{}h*(~k!1j|&C6ls+RP_k7fpAAma`h%oj(SrvHj02qQ;B`3l5jNtj}8kV83Yrw^q9Zw*-QV~ld~&^-4GCGn)I3se^72?{t=UuGub37f)!>rZpffx~Dg#TZ+k z>#Vd;-Sb4M+y~z?EtgL5DbiU=@iNAqZ2Wfca;qZnh6Y%d47@R0i*8x-3rboHdBrl( zH-RI899C0@{eXJ-8I0HKzG+BUkgM*JCtSMIy8)y~Y9(rG6qbcYy0|{s8ijS+8yjK+ zs{{GqxV5COuj_wia|s1Q*vq3AZ&bD5gDrPd9v6Pv&-~k7@UCM+V&MwEQ)4UR^eVPQ zHBe#j?i)(I@h;HOOlWYis?%QH5j7>T2I`*Pu|dwTdCoOpnU@!cF)C*bc{#E`F6aTr zLXF`N2Rh`-Iz%ugO_e5Au;xA|Z3*$-t~dJFuf!b(a>HF+Q!uzr-Q~1g@#G6RXP`ZY z5gFf0X*%?zu~gLd(On6{RkWfS-=?0rh>{}nwQx8X2qU^s34Q>%)|WZLs+3D61eT_N zk{FR(LQN#0Wk2D`GlIDp)U_a2ACd%j6`JbN_amMMQ1L-8WLqXu`P6KLIdE2-P>H&X zEYEO;yK*P;H>C;M5l}~VMN@CKTtw^|Dy6e0**%c});w3eSQZZuT-mEr!x=h5%yUqZ zOU@)3j+EaC)w4jRvy%?WsgJ4?<{^a<MlaWAp^Fm+beBM8}!H@I1%O0(5YlfQgbn zIq>ZxE{|B}n+#j<30ZKnLz`mt7`iotk=yc_S+l`4+J324 z;^L2gWcJt@hX$DO3D&<`&UhmP!C*SnGNQC3kS+J?h``BbDbw_M#LNRCP=ner6w*6j zW(yLcr+U>-KtBq%*Iph=;I`z=BTaz#9^6$*Sa%aHCTZDo-*g9dC@>OP=5og|%@wY-&O71z1o7QF^!JyyL46-G3ELhn8Z5Cr)=Z-c(P zRl;xJ%vD(>zo&svjK$~YlkSD)b=|;BUX?e#;1J(lMA1vRCX#l`AE&rB;dT|L85E9d zbExvO##9ZAo)=<#gIlQ!Eu-X2^+lhRUtRjE^qkW93Rg9}3u@m4K9?^h*DuEK@CDYi zw{B7E%`={~Uh8B3!=(Y56#D?%bB{ zX}Xkz{h>=;>;e&LCsus+mA(zCu~7zzhifU?02tubvB^e&e4Oz1doMtqXq3>vY9|6K zv0psr&Q1shydE^^3m-^%X5VeI;n!~r zL)?LJT)WA8G7|x%0U1N|9THl}wlwudSfEaN`M6(~TXU4f? zD!2;*VVs8;VMaI+5$lI(uUFiD_vQ=duGpcy@*-({b|k-dw^`Od)o}Z6zS-0l6r1}8 zQ=C|3>%k3Hrh^s1Imlle6tup}CW)i(0FTo_V7{r-(__n~@nRQmhap~!ctpHbUvWAN zyTq?Ky;)8A@_$ncp9IRtw?RwvdU7KN!@<{E~fb|b5g^65zjN4p~H=6VM zwE>PNwPgSfZN3gyVGBpi@{=llD|Rt(?^s|5I?fJob0?{?)3_xFjDb!4mR`Su5(-L( zydA5HjD+a$7LA(pO%F}s860{GJ2osAB{R^SVMsQqGq({g0-f9_s{BJw3j5W1v0}eI zx64XaR)O*iktqGHr;d_!&8Zw8mr0QVX|5=%Yx;?wd%n;t4e>HGcB-EW+G{4eNnO-F zJ=fbRw$0r#@E6F?(w44{O~1`$yKKGVgA&=er%q<-uEm&+N)BkhuJsQ_*`4}ifU3R&C45+;Z6@a3hqgESGuz)>+Ft`gnbeyd zC-{dk4CnMSS?yQ9a0GfJJa#(_Xew9g-x5Z($^j{jyw_{tz+`4hH+Wxv`@yV)21DPP z3dA=lq*%{bZ|%?=>mBPaDA4gN#@|WKNx5R@RIODDA&d(&q+|Z1nt0sPS1k&2bRM>V zGiyPPO0`L(=_6zqn<>m~zWS^5l>kB@$Bu7q#*gl^UbiE;|JR^LY=E9d ztojolT(Z90W7q=|>zh2n)8EvqQ{m2+IJMZt)BEFl)0YCkYB0 zB1+21t?13rVQ=WVKRO@~=~oL`hHgOUoOm&tQCAiJbI;}g0c|&5T83Pr$Gx?ay^HvW`dq<$%iWd^8w}k8K0xU>>qX5p z{{vnNFJ%gx16|L+gOG5;XF$QWLl{MP81e66-@XcuEE|GK$y_4ns1{6cPG7j90*YM|m;K~vTB`j0J~|QI!6d7aH~XRA3P;pSfp)9IxPlr)$hE-fxD2-i!9t;%Vx&y< zEk!q@_3@+U%?h@11tO*Qi2?5*&|GECAzD}^CsCXhzD3zI7KQk?}q&j z^{qBa@a7!n_v2fIzgKS_M+^$jbFEMKl?i86N=_6O7VFT~MZOmsLchbHE}@dq@`g|d%ez659SO)mbL zqQl8B4(oJ*pd_0h#8$s%G|ttdEWgHqeRAH&;1RFcfwV4DM-WD2XRp|qwuopv!&K?V z!0%Vkfa zh-fY;DFrf`RljfzRxUmmQtS)TG7Y8rSsO*hi4TsRt57nDR~Tv$dVNfENC@kvuhM`7j@iXp==K^R)`eBZtC`%XiLgJNe&B>@XAgb`pHcH9~a=3O|gcHK|q6PCJjKS z*f(}qdJ3O6)=1HxP^5@;75kNdPoG=g@&lBAWH)OaOP>w*9fH3!(wuI?v=`F+jy}$u z&jllPCG`X#2a);#`mUL0%Z(fdf!vHc2E83*RSjLTN7~; z_lsFNDwRZaBzFN(!eS=0y+K}sGH~|xO%K6q4ie5$&)7LFFf}>v#FmjFYSQG$Y+~sI zq#{UaWBW?Q0f>N-u^nlF_c7s)3;!8AeedTK9lP(}jlf@@kfsAUL7$+_m*&5cBDZ3F zAiF2zD4GVx28n(50j}S_L1Ks!NpB0u)GAldY?JPa50k#X+xuyIfv@1&A!$pE4ZV(< zMn8p6;kvK)f=6hOzAyfv;w~D|i-y4CNMhqh5=2Sgws8E3&~b$Gf+f!0PlX?d+zV)Xb*NhOsk2PdtG65=F&NJa*~RYgIX!MualQ&9ru+k)J_>ISLqEx z5hkv6N;Ex_WtIS9K%Kw+u={kG5QScm`lUk>5+oBMB=6;xPtyPO(W@X4d66z73G$;z z6-GKBN`WmKml=PWrT9D?UrxCE6!K-tHUDx)X!-Gkd0H_;VF~>qgk+QHrNqX|LrSGa zONacLk+9G)(}||W&4o*+DoSDiil3fJCJ_^A{zkbE(3y=T$erJ~lDIA!sES|qFG7|n zsMo>Hk0eNxUCw`;SMRQ(mLL^=pay@1AaHIxpUnuoBT zr%9EUvia%I;_}H1Bx?1w56d=}<_AWSom*8FU6N)>8lWleS8o08ebR%BN>-4S5_+GU zcXnRMqNv+oTUq{}@VrUm3I6{6$Zu-Af5#pGxyGUj5xHcF=vYGa&a9KQHmeI^f|mdb z{gZM~5hSQ01z@j#Q}V4@Yi5$Ty0dy_utw|U07+s7*f3d>2o-LFBL#vcE!+N)S^>k8 z-qXvI|3Vq>n#r|_Usds z+Mxp}hejFnssXq|pLRCgRcMuGq(-O>&H=AU>rRJO1;E)%nD!X^Pz#@K@jQM@3$+=e`!h+B%)YI zlW4BFYN@u-DQP9v^Ju=hn^-=|p;yjL*>3=8GV%5y-1+G!{9o8*?Hv^7g#jmwX6 zJ=-nPeCcPk`OKJ0UeLUAxJBsbA4PbPx${Y(UOQ)z?V(pLD=Xhk2CwCk&r*HH=#TiO zZvJV^*e%BDohFbNDAzc_ML;xzaBeapGg%Zs%~s2{0vsl~WaSaj57I@}L=UI}Xp(6t z(x$ZhZ!CHfHE1b#+$=s&bIn3gb3xTzdVj@5rqHZ$ci_Cv%ZOjNHr89{aV5`_Pj6*! zmRjvRDbZ02Z6&M+PC{$PcW|sUGhMtAPR98QN0zse)%`S)*_&yJH@;|Wi#9a!eQE7k z_HKbscNm8Ye?gUt0JHior2$2_I0h^rcUQ@&Vjhvlp*z7`=tGWkS}n9$IoCdvkYgw& zyzkE5u6+5TK+)$2O`pbkE6CCMWju10v(jk|05@Zf(%Sb((8@NNQW27*T=7wRpL`2( z;(a64p5+<0{iBU$(U3~^2;1AEY$A^^GQv7N5V5J5m#ig*a58KSD`VD(Y9Nur!BO?!D%@lm{WxLJ5%EHIoFuX39V zeqwvVHh?!81aW39m$lHYR>0Y#=|=Rk|L7&}XKRBpM=5&R$VNk~Zn;RwU_A`sJWI;T z+iYMjAbYHcGQ?(2O_X^8)4e56Qa4q)XDt*%Q@QL;6M+6`X85GUw4Vl?UV4tvvjY|M zMs!=6mjYW3b^^^x*$h*6+WkA4*@w~1cP|vA72JU%L%xY@jl_JJ{Rjy8Z#3FW*Bvzj zZdL>i>OBXy)2G&YeyvueRsU^$s0J@T3`QZeplo^u15~S*Ev>pq?ksj>*J_%e)}fHc z^~|~;lQ)<5guclEf`ZOq+-fe8xz-J*$_v8)KuFSOiq;C2dh!~zm#Fjf<7OOA74zAu z1X7rRSiywa_D)Q#GMrQrd(HKG)FeHGOo{WtCx-UP#zD=fla@|FZSIAxKWNWi5 zsUhU?YzG1tifCNbgVm=F>ESA7RrO{_CNGTuUM!A5vwOv|0nD*Zl)_%poY!)gx+qom ztvSk#1o%6!o`--+PnzFN6L4L+0YHFIG^w~jyT(UMJm%;_y#K@ z8kV!(+>8y|Mhv>HXx)9J*&4PZ+rrqlf^aY0wgDD&F~a=-Y7{o5Y*~;q2HjMyCJvI6 zIwg)EFkvOk2~^a)>x13~=Nz3y@i$CR?W{P)C8C7H37|dG3Defts&)q1zuC|r>RapF z*Q+_A(N$4hHVq70^+MN;w9psdi)FO=118#Yv9uW<$~5IFmXkC0!NUB6+N5*R)9v8j zEaz8>Xj_qUt@+Gc1vbaGbTM140#TSE>?jjZXtWiPh$O!D8|RwSCW&FThlJsoC(8UK z+6#*!$`q%702cqZ;@r=BZ*vz#9`r!*A(H-Zo^Dv_9&A!DJW79?4@hph1WP|)db{(T zTS@KpcTf`qms#qMWd{hH(l%gR1gwfUzLU@l9&KjJK^MQBZ45(b{4{Bz3u8B=pcElnL7b8goHC*3(#5RUA=R@cPaO;)CB+PZK z8)?jyIoJkMrTc2QPs|4U@>)I9AZFbQw-#lrr$7Og2t?!5e7S>>IO*ftiaK^(3jiAX zsxa1KH7d(@b|Bn+o-V;Ik{c^iwl6r2;_*>9Hm3`GmF;6qB7-_}pghF}ix8g_l7w4? z4djki<dpWcEJv44x$l>cyFYDwf^691T zei~ALzB<;Y9P6rn_F*}*CDa}t(jANBDRDJUzWPbNW#&TfitB4b+e%slWyq6Nu#Iwy zVayoR76%aauE0+WdA_--#=mjmrmIs5;LZbj?zA%z*>k*JAACNo+2V-LSPYX+-l<_- zfYv$%XDuE68-4BZGWV?8(zm9pZU&%O?vQ_`5g>n%O6qicaBW=I5JE?=Q`>PKip?JN3FR`pH}6c?e)vg zP`Vu)vcOj2JIs@-JDvr^EyJ{-f;yYtbShvX9~3nLse+OK-zzp4g5bL6bJjaB62*e) zVuCm7xu31W{z6f7M@B;Rk$K~ZBB3#JvT-8vIVvPJX0#;}KaE7XfHbFj-l6?vk}e-6 zS`ek0vE-$tMHCOtpfIU2AR2k*_==yiO0DYJtxbGhCN{ynvxwdvU8%uju$%rSz6dV#J{~2lUCaB zg8>7&{S6`aep5`eD_jeIG<6$qfJRU(;J|bDoUqnZc$+$tqrpAbls>w_$`M8Skgvp+m0Wc6u=8uJ!{7gYCDV=-iyrjujNsu2-(sjl!a^DZ|9jCW`z<)44C9S14Cv2oF4hyA}r>+67*S$+_@! zSGA9yp8fStLPwejOOA$`hl{E0jvaS(T?yX%my|I4N5V^ghZ1|1SX^WgDThR$wcVGB zg+G`tT_Ttpmx-*#D`E21#DTo>mVGCm)pqh&Rx*2YR=c^hz8+CRe6*^k{`yC;Bp3ZE zOB`Kmww^4iVngN?qxL&!(e;Uy>%HAnRlT2&_5bjK#u3uT5Y-V{Fcnz*R_W>=MV7i7 zlQUiZjKvYxVSbdbRvJQx`4Tvv(`Jbx6^(p2|7<|+fjxA?Y-Dp@?`#vSW@l^&vOBq4#V+rl8!Qd>EIJ~_`kb_h0 zn~0h-^g~oq8g*L7TUHe$z>~e~Bp;KAXKZ!hVQ7JKMjisXXB@Db-b?XkJ^{$-!+k+XHPTfUKD0+*MJ=(RHCw8wXAdC@9?Abbo8v+H2b@%FH|9Vby(WPa4jj z%Wf~oTwQlHB`o6x7m;HH>fQbYC>qO50ycIcBN_Hq$L>fCmQutGZjym{SdGFsai*yF ziL+BBk$zBhG(!rSh=E^a@_iSC0N67y0;I<+Cr@%;tI`=uP*7HsZNcYnt-QSL2!YTVojBDD55_0IjRs7^2yS%oRR!zvb z=UE_&IRlH3cu&$r5+D!hDq0I~6s_5vTAa_Os!R8sJ6z_SZ~NPGM7i}ghY)sn@1b{c z#ZQQ3)Q!irb56LuQX%M=jPFlMAW>aP?y)|_yqMJN(+?h>P<_vvLZ1e9cWcdo6T$ET zpv9{7+a@`%t~dRq1Jhe9;{v4!{H)yz`d{FtfZDW{Dy#CIz!hRP0^vUSY#mOrZ>gBm z-7FENU9^EMn{Tv47ui`X63Z#O#drnec-~2H=|t;ow4wBhifZcL8ISl*Z4feB>NYsn z2s~q^w>$N1&&*ZohiCVA)zGE#yHvWq(Z5KQn0MT1(T0G7hV1>a&`Eev|Ksa0LF|$( zcdHLdP!Qr||6Bz%_5*laR_SC>s{Eb069RdGe>7G9j-nR0GIP5&KIgm$IChjBm9J&c z3&J$2Og(vL^o0ILqs6*@sm@!FZhza&gYm*f%dlTS52wZ^+R_8YI15pjKdADcN4U{s ziV##Bw@qxlbFs~8Wc3G#E)QF|Hp$UF`qP4k#L3_F&{I`#(n{u(c8 z9e8IAnreQ2BVZDVFekQ>{fWuKMS<6S{x$;@aA)JmD!p7Pp?8}t z+m`nC{sV{dD??lv7H5)GfZm##CN&{fO>hO!fZ88G zgNBqfBC>PbfDZ`=doj2q zKLHv#qsdCrI$Qh>vySVCx+QcM+wjrxzo0PZ=Ya|L6 zjyQrF1`-BuW?ynfIN=4dPP?ia1@QPzy2)HMSE#NA3t(tu3peBFQ8!qpYWVX8eKRCL z1#Dgy?8+wG)7KfL1{p}OdrL;gTZ0uei6uL!O4-`biZ+)sMrlSJyHC-P zS-DlOQ*mO|ES4+je<56Qs;a9ERwlQL$oV?L!k50PFX5C`e0EdJTp2B@n*0-Kc-ryB zS@#~*RrLfYY3z$;d15+$3EIEgch+0?21ou1aFI!1RX5_`jd5%&EV&!13XG)?vd`}1 z<6-~K0>SrUYZ9^V-5|RXCza@9cW>8i#w?3=fC_F2)`yDLx~111Cmg0~ z_@b353gC2r>d(kb;5{#fq(0<1B0jTUn6sO1O>(a>^ahl+N5#vqJC4vzy3=(6Ih?As zb8L!21-KA1w*W)VXU~PWZcy%F<3bjpXDwPIUWFXzB~f=*?qjj{Vr(<}HP~KL_K~i4 zy=rgueOl_Fe2=M36}3b6teQ87x`AP8Yh!@Mx%V%duT|=ZJ7`(@8F7alrd!Mkl3xYI z5_AGq;7V5#9iI|l87wWSnk*Q50&Ub344rcr(fO~q6pwu_mVs1Qb*@&&SiR&nW7sSM z&#>$|KsSQ-ebz!QhSP3?B(T`8UrCZE60Rav^-3A!q6sbOBpql1l}}t3yH~&A`&uOz zo~99ll>{WhXRls&Bf&DFeP6MAxYtZAn&YuFB z*rjh;*rt&fXeCz?XPaq86sV}!ASxJp>aH8He+=g`;yFlnUtu zcFd&7X$t6I)Z_P0$Gmkr_FtYb6;LBb&p9ZKITIQ6!_*FIexP z4pXGY6n*2#&B&g!$yuqUUC*pv(~dR;i4_9pjfbvF%&4%oRoGVL=e}CODgrX+OuW+e zgZAW{=~oVqqPQ}B;|ybLFIY2f9$&aE-0pq!2Bk54go7KWAftV`g;rnG%|A0?-KJ%@z*)Gd-DQ1iR5ztvD7{8#-sW8}t4kOeJ zZ2xcdddjYw)?f1k)8;Fm(+&0&y%W|3ebQ=)_Ur&RWhW8*x8^y{K>@g(mL+}tU!cR{ zAMEMLCRz(p20_Hu{wjfwEqw71UVtb@MUD=$-8 z`;P(D`!EwqXs=dour{qANG+%j#`S^RoHCAV>QiXA^F$&Ad+C`Xsw2cxO^HztRrKmJ zHjoY*Qb%KRC*VR*7$_@r4oyC&-#j|H4jnD%5KMvOg!_QE#k+7jO>J)(`Ye#eh~<)1 zA%ZW*z;s3^-7QjfSr@@2`dKPU>l=(7>X`aU$+gIBlEO^`5jt7$HHRuXknLcjg9u5^X(*a4hT`3;#ICKYGpzZ3BHe=eE0EPs9DVs5&nloofYCy{> zt6Ro9qj3(f4$?oDE2d`LAH(X6t}d_x+zI;F1EyW+N&BUf9J)`1ejwrm0QAyKYRKqC zz;q6N-anly4^)-#KGgBZv%F|Z%8Mg(f)PcXqT*(E!RgZQxKcb>e@;TR_l9f_&J2_b zWqv;`#T&Y~kBwU!%M9ebQ--A@JePb8e?zdRVrJciVZZs(#d-DB`CBLOXdQ7{*q5N}>XNdQDz;FX^{ASlDD_Y*$@VUM$k0u6Je{2Q65*Mo}24a~PHYUCCa8jin_*oiS_)td1)ctQ zhJX&3eUpgW_beouBwD{$lt`whyl)q7+TE!I4thR1_yk<{E$TlslTb7GlT(?vL3q>P z{`G%sf`JB*x5qR`UeLJe>^cUMGCJd?E) zApfB7q3$Mfe;p^^f$CHYc9@xeUD`WDpq)YutNGATm$E zI1wNg&2FfHbEMo1#x{C@?C&HZPIwa}k$e4K>TF-hrAU)*wX_7e+h@`k(W zL~|KX0RzK_VxIT5hV@vr8+YG+82U0$R+OGo zOK-cboM^L3GZffOg$3KwM(LcjnFJkFL?)yTH1`gc{A%ai5`V-@?>psDya7u=qYEiQ zOc-T9Wl7zmS^&v4F{f9;1EU$p6FcDCs-MP5MIE)h6sWS{DY9VIcQ#v*;$RBvpT--; zH?}pdZ@`TU4L_8Q8f!TWq{$8<F_f26PogM&oV^FW`HKg9zvhYt0e!{P8Zepiz|t*p_>49uA?nsgw4dMRb z)CzU)3di8}`FUNcPd+l~68V8=*vw@<072)umwPV6Lva{y8mV;HE4MV)-#l3QiC-Iz zyBI=c%xvTEnrQ@bN!(nrX~FqumGP4kP||gY{8ptHe1f%2TAKpl1on)T58F=prMy?# zg@&5u(ZbibDfHFb0?V8IuvkV%a0>t55APL+0PxiN)8Fw9<`U0_0^o<{Wa*gf(KGhC z4-H1wQXsKmo?4K(W(Id1kxp1y{pDpP#zzVkaiI^ZaNLPc+a!AdHMYxO=0*Sr=9}0D zp5u9M2O-9fQ*Rk~2B9GKSSR%X7{QRaMi>}`wpzz~c_H^9X~`D$TfR*VQ&75o1+YMQ zwyhy18LC(f*LV+~7G0rB?34~j?5)Hu>T|g#OBeyey2G zF}W3BqseLZN>;#Ss-vOta!-2R#tEa14`>yW7aFTCwM$eG9H`v4Av}&wm@wuEc34oK zjexW(z!A8T@FpiYM!2=@k zgOi6{rs4SA955!p;K!MN)-OZy=m3gwYPIyQUZvwxsA&!HcgAx$vcGAFpp-SW0$J>fQHP*%Kmyj$GtJ7nDU(NOBJ@R<$}oZ z`Rhyu5-4Ti64SyRlN`vzs`2K;+uS#_Tp$d~IT=Sk5J=y!RD__afdnqMTLLYeQ0Mh- zeJOS7 z=z|tLC7Z#3ba3zD@i?k6@d1yA7Hz8IJR_MSkEFe37_}-#!j-Wz&7fV~%U7h6whgsK zB;NN}pQ@hebHO-l9nMo`0>dik4(^97$gUHM4r7kG-!qY-kb3@m`tzw5Q%td^1;f+? zZ`3cE()Gpwf|r{zS=uXMv*l=!9%Jq;4Y*oA|Cp>!n)^=(J=C>s%JwEC zFSiQA@ssa;$t!RFfAtYa|FoyYBz3VUH4f?)C)s)WJ}obCI&NYjBVkGe2H2m7!+NnC z5^!=8;O{IivX~f->RNX22ZYo{XHf&wO5;OI?MU}11Qc9w`eIkgvWgeRyg`*)CE=yd zUKalyA&5^8cSPU)H|u0msB#%zt8F<+J}l zpr66hgoHo-z6W(M5Hi4|=3guDqx|!PKLXV_`k6I3h2E|t{E59NAHXZMT4*{cj`uHu zDX^XWA~kX^K*r#I{a})!@lCF7gMm-|7PM+0C0+Lf`*h-~{6Kd9o8xH)2U+JWYe}Zr zjGQX!%zp`ILec+x`PUjOwK5uL@rFzOzq=m-v5-1~gOK^ePprI?k68dSuhhNGIUO`c z2^`=C4Hl%_mSx8*DN=||oAN+&+aCk6I~jwCO8k76t`C#Qp?C{LC`tqrVaW40*|#q= zBeh;2(LfmZ<3ebG!CT)DES_%K#AqvLHIueO#!TD z@*z!twR`n9kPg}UMx#rovx!XTxj3B>ZA*J*Uz%DaQoBz6{ocM=ty$dER@`;oLq_wS z|Ix24dbR2E)fRaUi{y+a9KOB*0O#dQ6b01>U|XnB8%KJ_2huSL z?NO;CkLx#e0h-QkhOGS|H=?b@V;RJU&Pzoy(5s&fgr~m(^9?0~s-pYp`L1N>n%xI+`EkmK|+ z$WG4<^%c;#Q4KER88+2@_=bGfeOT{GP*gMkPKY6u6$Ai6EXm3mdkssA1{Ai~#R*Ab z2IQu;^-u#=fisUG@28!G--Zq-cyX2;F+4Ni;{kvdpmsSgy%3(~_STtwpm%AOy%T$; z*NTWVYzxRY1-09|1%R+{`wI}O_iM*~M<`;p==~vZH*=K?53|uc%R*zd5|Lz(>frm7{_a5V5Jr!2c`=Dqi~`>X#GKe=(60(I>;XtHFLHjq zft;5vXZOtBb10ThidindVdRYi?_}#rGc4Z)1e_fr@Yd)(4ZKTN1D{-SynP)LHi_ZG z>srdnKwmBu%Fu^BLmDhR#d7am*IakRjMFL+C!N|7bQNDO?v zM`FPYBUL&MOXns(0VL*o3N>fCy}M2?8PiAioi}k>@2Rjz4ct z)IPMH3>@|Z{zWMMv?#%%J7j}7hIq5cAQLI^aJuRo^x&5GBY3%YA4&*oDT{cX0EMBFt_m8vI>+h)s;JG*m?A71>0^t7)>)!yO&{;wf89!b0x8>2&27PYXWGolOtAvHbEGW zrsCJ6(CJe&}ROYb3n2t;eZ&arauAdG7 z*l7W%MLd^EDzpqZ`JJ?JfwzzaA{tvxk_il1h|B)+@XSb#mn?FP>xa=E--NX zv!D#H<9H(l1zb%6XrGWYp(GHs^?twUd8rP+XYv{Fmy8BJupku+fzV`ul*HC1gGQwT zCbT9a5P^wEUK{z&7K7}>RQz#!JPdyd$o4-am=@k(U)=2#%Y!P+zO=ewNrN+HH-pJ- zzd*OhFv&1bC(*g~>+}jo?aZxyJBMXaty%5$zAk#P=OYnbh|NoKt0)QDRFcJU& zJ~*!LCg!v6uh-13f5$Qul1!2rjY*T-cO#j7D2?GiR9;ZEe+!3}pxkmFeudy)5bnyS zofbeiBKl4Teo)$qQZW|2(Sd$Yp^8w@2zn}u&w^2C)RHC{@J#?M$qK5RDM8)2jTYnjU`RT#l#5z3B9xqyHNHq8HX^ zmZ!jwLrW8D49qpMm5QSR^4#%0D*b~X_)`00Rcby#HVP$Y;Bv{S2|<_8L5lV!LJFkHesw>gWI;5lj_)?CVWA8ZBhlB`35Wc- zF(?49Ff&uB6eOj!x}qqFG_Oj<0w@nMqx2Bh*0?lj+9PVkLf9<4&oLYX_5BvKY77;4}@yz_CQ)xpcK1V}dS`cw%%3Z{Yd_bt5fw9;LB>~nV zp;ONz(r#0MH&B=qn7PhYU4b6SMZ!Zsv2dH{;jHHpBIt77U^M_gXs5w5szr_Kxtgpf zknt~+r8)7y&IZQ>w+mf8k~tkn$9u z#RVho+dWJ0s{<+VM^~zy7xZfjseW4m01CB#$~^0Ip<+L*jp>CwF%GyGHv>}53YhLw z-h4s|;}|2+>J72|Rt>mDs7PI%^-JL$CCMdm)dg%5l}*LQuICbbC|v+tKUcIr)Mgkh z+U6LbFuej@TLb_n%%BE_(K*)A1FdeajkXL(3m7XC{48Ynzqj=5daG8@$e5^7Rj549 zrVA0@ehaEigaLW)Pv|Moacy%USoT|x{{Hoiv?`@7m*NSR4;Q9jv)!=NXn~3~vk`F3 z4e*PTOH1cgJ^24^WRb*!WEv8J#=x)?D7nDdN0w|G@Q0XTDt+q;V3yuo6E;g0L%u{4 znN{a@H_J>5B;;d*1VNdEs8|y+JjSPySjwtS6<=s=!xWrCa{X6X8zp~8))PjLKhnRn z2nPW%g&m&H)@#}^jXDj3!40+X@o6!II`E6#i)q!ADE5aK~ExBOVMo&ju*YLY2~0TX=)97r2sX3)?rK z#?1o925Bp@I>^hlB!gg*<=wDdu4R}Q!r5dr>{AwZ0eDuWDt!k#MZKW0UoX)Bv8ENJ z!|hIP~8|F(%2AEWNGcO0+h`R;Bs=#C`|5(R2pUyNCW%u7KL|H0i@P3 z1C2`%42clHUMqH$Y%Wrgi_vqpKg?5Bp3AMIs*V+{3t{M~ivhhqRtPd?aX;Yz`2Y+| zzQqt~Psa1NdICOzSHDslNJC*!Jcg@Z|Ec*BeGC~}ZXsZE&Kl?z1ioC@C8zozJ_7V|N0_=AXU{%=bkF;I^6zUj}5;`-P_G9o?Zw@#uu`F3P?+X&PP2q8?(Ql#bL z5yyI=aC6Rj&gs89=K@z>9uVZ<0lx(P`N}J+dQH)k<)_2>e-BpMa?%^r&J?*yoN?5^ zDqh@-zNQ>Os&0FLK$4LwaE=+#5p5u>4Ol?T9<(O3#qMfw zw}88SJvxdl)R*(U`&%Ptp)CdIuemPFv{<#Y(`-HJC*b)W1HDr$cRXnptX1n31We>4 z>luN1MH|G_Yp|9c#MSG4A>8%AZ27uCvVZ_NZKxb5er%{2vB!~~uOu~JSo>3~xX4rR zG+`-rz{zzrN%n+H>7*vjW3|aiG)V!YQ?4?F%X*d?Sosc=JaEJ{yTx)&#JjQ(wHQ9S z8n(8kFZl%H=)E8XHm(IN-OE-&JS!rBjt#3t@0|c#Dq2+63OuTU^2k*HCYcjOmVVok z%~(S6DaYg)_Z6&(q5x!XG#AsInEu3o1|WJ5(QO54H$Xy6)Asy&FOt?>)46+Ro8 z*$;U4#G*g7ki}$KnQ0GM^PcXnM%G28M7W`*zyAf~mEz)DfVscx++EZnS`R2}Q0GBY zeO`{T*JtK3iW|lAhC#BIR7n8eCACaKagD4X*v5mz$CJlHV%A0q82XkOkTj&CY0MuXb(L55j{W z$umjd62*{q!$G-In{N@zjIWYrrjv5&Y#6`&#!20lTs^ z%PeD0G8ns8<}$%r2g%MiN&$3^vId+Cg_rPJ8Ek8NO|x2hXYXcfN{HI`Z8^(o5JQWn zbIGCwSOW7~a9f3I)cZ+oK4c4Om;+VoQn7hZX#ck!d)w)hNdJqq~@OxH-Y8m$K59uGh zQslpbt7mgOTzbFfnNAqcx=Pp!5)1kt++GfgADE~Gsl|Ap#DZaX(vMX@1)qcvnF8W7gqy?+G*Ho&&+h-xfhapX|!w>84E6SQgTRu%9`#Wc1 zwNZjfBUBC+@{js|_-7oN%@9{sIjZM&O{mW&iL0t&1Z**_aLb63BPr7-hR83iMf?Sl zvsnM)gb8oZf^m@bP-g62)wY+w8}jyApp-m^O?I+OQ=P>4OxYzRWPlv{u*wtP z3&5V8C(|ghg^BK7tGZ7_#ee>N_t>@}ENUeFzRl5-5-*G%>7^IV4R6 zE?X)kSbs2?Dvv>pP^?lVilh(S4Xg2+LLZKS%#tucUAaveLefAHtJDjbK)Z*ECzcUU zYncfQc3~C%(X?*6-!$W5YqS@7MqQ+}>2-aJMt7*ndy$Dkp^M%qcTA5dJr>l5)Upay ztOlhmG3~E+-5rHu+nd&0YhU9u6?A^k0#05)#|3bswDMOeg+_ZwXStt8)JFmZqh0>s zj%C%5we%Ux&y;&rw&Kp?nUiSr7fh#9RNv4`LD}O>BgjFp4hJ3K+gp)GgM-kH=SIs8 zstib&50Qu@vvP+Wx=Tfclylal^BnNt3vWA1Tq7$f1xb5EZNf%uauKx$0$;R{)U}DM zNz>0*{NX=6T&VhT1Jp~Pr>+zaiA!)g*$91?4WJ@Tnftmqa`6Pw#VV|J$%$y9D(qA< z)PrKSubo1u?5*yiwGIXQR0ZMM))-_dEV8)QDmwLpCDtD^Yv}`;3P5!>-wu};!}M!FevMlLJ7$vD!nQ zdGqMU7Y(;M)n;GIq5>%A-CDyI@8H!aKiHP|Lds3&>)E!$fW~0Ttz2k?FWCp4#ZIzc zZOERm*0=)Y91<1(gtj0H=()`~8{Im_4eVrMc$2+`Sn-M~-(57|iTvXMb7o+a9MJh? z8@+>Efl)f&_Yu<4G0f_@#vzI@?g1JE$CgfuCYkuYB2kjts3e3~8>Sjf72gOPQ;p#U zQSF34@&|mB)PcX*;nrUhg>_-@wa;$N?^^*XM3YN!TEn})LwA~SxI@F?r$jQ!yLMt2 z)E1}wM`S!byfwWJtqiaBzBasj)f}JqNpMlH78Zpt2IM35Zd0*90<(m3?TI0wxZG z0?gUa1H|$$nDh@Irkq4lE_!@I#KA2$Oh@S)^M?#bJeXK)@W31muvrcKo5)wpUiN4B zq*4o49#|97(4ZP6qqlMwI0F=NZhFUO;t~7L5GmJV7v+~}<-AzlpBjg@z1DNTk&yjl za$>Zv=qlEsc$5*lBv@waMFg#v!h3Tc^SQUpS)zzoZk~MUB9U9ug(%Of1WiB>>eZhHHKlEn$uYWEuJ}8GJGG*NY#SXU?1fP}<6Ve|opG^pkpAdvL>B|l> z_gY!t#l=UQWl829OK8qkAq+lmD3Z7~&dy9ff7m0=$b=+RW4p0nmKiBhiH!_0NEIIW zwVn1P{xa?G383j@S8UnS^2d}1>AZG52egMWel2&MAc+x)cgb1gWgvYqGQWUwBvY={ zLQDa^NApvTc2qBrEI!V&qnxO_=945-&dHwnKK%t-8>%#Vl{)9ZM%tS&6+UmGwdZKMJq;n#LID7bo;=$wpfSSL~(z4cI3YiEfClo(U_nQccx);6i=A50To28v+ zgfJ`Gxuj6@kB+5`XP~DkghEX{nWBuTvisMaQhZ{qS?#PeRj2wW*v?Oxh;Hdw&|Wyo z#Z_j3ZiPOLD$yusLe{49^wey|p@k&1osonIpl^hwR)vWpstaR6Q!PaA4TRQ;bWbV( zHMpFA^VzB%mj>%*S|xHe1)?BEv&mONblc0EFMrDFgFj)qa1Ii^499f8Z7bnyWx5V* zaS1!g`z=)cdyz1EM%fmiS?H`x7uo~Zyhv)^F_1H7%ak12X;H-_gd_l2HA_c80%0dP z7GeT~zE0t2bBVZE!FNsW0#=sLDlW^b@v{niF$(Z(um(mi8erM5%W*Ewl*F5t_9ff~ zTvVFSx#Qq|Q|RWZtOS@j2cC-cI!N_3yH@Bv#k_Ef1S4|&&0(VS|28>`F#-Q%S}bq zK3+1MD{iM?uSIEeK>?(rXXcu>jym;z7!Ul8~e3rEBe^MIAI4m zN13HoFY6DN?_R?Rp-3p=>HV*ltIj~q0NzXu_CLu{8wQfn>Fpy2y**Ig8W zU=n8(BAMlq1N|=3cPsl1A)X5Ym$!@pvp)&*c6BokuzHO^1kR~FK@67W)Gc6JgL6P; zgDx$J|9~;K=KdT4lKQ@^aVS9}u4iS}y%`zO^pafdE^(&57QAvS`3?X}E9>4RJ=K8J9Y82H?%CW}gBoD8hp|NO|CUJjJxp%vSkLJ}SY|JMF9c$= za~_WwQ}r7^8#@@!aWXgmJn8%SLjw%-eoMsY>erM131eBFOxKfkyu3?>>P@DPT6g|G zYKhu2{?BT!H<_9zKS;j(vr);4*z#P5?vpL^pyeAKFYHWT+!NDs_9UN}VaFA75cFd% zqQnHXdO(^<%gl~M1%VuFA^x7W<%o?XrxDZs=qcIL#QDbPuyI__>I-%sqdl-tiFNK3 zI3BnV+Y13;ok7AR9=NSS6=<#gNd&g@%*xgJ1Ho!I-?&^@SQ+X%onva2 z#^8D=48~xgEAK6wm$1WF%undEN;_oT55bJ=;Cf(LTz}m$E^VES7JyxtyH)Ic04bKT@XGT5QjSMf&~b~ zS*;lBK(^eDNv`Tx#hS@BFe!F0TJY{=91C}s8vlwV8pC-w*37(fw$BpuyZSI>P4H*C zI8Y@a;@!}{zF@xSyZLgjUn|l(^>#(!OczgqyK5uvEsmuo4fxLpU~`J!SLL(D@qfzX ztL#BuzR~VRGREZgmF)QWS8#*aj+KZ4c=S-4++{N%jI7E!Q^0b#x^ z^^*L8omO`}R9l0lr0Hy}OQM7~NrU#WqS?eQCrP>PNXKmlv5|4O1I|he1!r)3`3AQ9 z)EgKD+Ju6*)JfxhoQcFb$KyPW()BpiA~et?bH*bFI<2jb5&9(DF6wi%=(-7{ZEe>^ z=&@8NXDYOpC?JcblPUGD-3E-Rm$GDlNEg~?%BbxE)K3cU`%92W9CfF!V4IEd8n9LQ z&Q#!Rb+kKLs?5^{8s)L&YvgyI24CeU>;UHOa{naguUMa8Wzp_BjlkS~4Q{fOuAMO8 z`)%+6+V6Y4JH9e9j=85kjEK!c`DK@?+cM+r;l?EK8!d^2)|{@8L(Y{D*=nR#Cx_7g zPHBM<4CP7NJa_O?x8FJ6t!jK#c&vxNZFfmkFl#essZ|u#VqcL_37y1|S}UegZD9A7 z;@*qcY*z(-yaT4X7zqQ=%=LzHIzjq>d&~7HUEM&6-ISn#bcEv1NCP0;3nQ8(@Bgr5 zRIW;V$#S(r1zmLLcb%c>uAQBtuBm5TSXv0eG>=i8mw$bFlEGk>6x9 zzCvAz#KD)gE++1mZ`$3x`23dAO=NdxempR4K0t8yi3PD+=dSc;+w_o0Gazd!LGFlL z05Q9Il+9hxHQ7Gk{Vz&KV|zo6OVPU-NAw;&X``?DB>N;W;Sa4f>X9_~FK&NKR4RfS`^W*uxN*Y6Rv9dlZ67tPN z>iKx%$NdMmSH~AW$_<|;INPxp3kAj z9lzeKFyu?9gAYegrL^OXJOtI{AodT)-5bxT0@XVm!Gm}P zuPwAlVtlM$qIDUN{NE<}%)F!Bh3XtQXZkzaK5?T7LHbf$AUurxVa;0QE*=FJcQaTA zkY8Ynjq_Oh^7pgv#q<~h0(*$AX#xK}7F!R^F*Hu_&vIjZAW%*?Ha~vyRm=bf3OFE8 zu^-OgvsA7#5MFdT9@7S#r0kYb5ZsACL&)&stKePkHTCq3gU6qmdyGXckMG<{ z)}?IReIZ+q1hz=v&AsWYnFNJ#AHz5!HN@x-auc0vQPUs9kf<{s}^^z3&Puf;RMO)-}8A+^YG*}UPgY0m2Xbn}|0^zS#DalQ{> zFW#3NR$i9JtB*4(HGmFKxRKxJo9(tEt2qR zlFz8Yd6-?oIG=V;r;|j6hy-Y_rW%aEk9|_Z*A$n>u`JYi^JNY(k^gICfzO@AE}&|F z4L*tWKSu5~ztYfwcN7!d;GK`Wu(5Qu9sDMRRIKK6k`Xi3pCi-=UOQ_nzQvy?{Ge*G zcBaS8pQGl_2`xOdqH;+*S(X90Rc#J=+TXlJpML0qT#tQTIADdO0>KB|=iDjeV^+6P zEV=k3XL%eTo#jzA#0a+VhHG4P{Or7=FM%?Gg=|}J+a%7Q8RTyZYeahl^Bo|=M3@Wf zgO2XGIBXU`zc-;Ynzmzp!lR*Omifc$mP1Dt+8o>MS#ei(16alD!)qH}UX&P4tX9y? z=&U0+Y@0)ZPC-&uGo`5Ms8qNYpOL=kBtdP}UfgW$$S?8Ktf=|M(sk5CT^w@!Cc&an z7g*a*XE)8v0u$DEaHj{jwaTMq?+&>OB(JqZ_6{Fu6o1a1aA(byJmyt`J6&9tAXxx* z@bg05a*YlZjvWpNhDN#q=P)tuHYgmSUfyS5*}LWOs-Q*1mFl8%(8z(;wx)89KYbMW zu-6wvlpr++cf70Dj{=NvyzdLAJ>!MJYd+RGTi$LuE_9r3@+U7p`GgK{uOP+Io#R?d zi=UQ#hNRtc`mXocAi_M9YYzlR0BqGjuxo{(Cw0|skAxvRI>(J_1w|Za{=~9c;JER* z(}|mBOW`@CNI`M@jNc=a6tMS#fj#6QUwbH_ak@ILSNi!|n9}w5m3>}k!61&RUv!rJ z<-kp%o5uC{mgB2Iz5#`)<9n^aQu@QUXg!DSB*6d7sy z(|UMz_?M^p`E51uCY?`G&)7MAJ{8o5s!;a>=SoYC>@zWfEB7{tw)(fd6=xd%fZm$F zGG%n`D75Q z4h6eqyu)qES<(N9Z!oQL#!&I`TWl4aEmYL-ma>(V6ruS|DXVJ*e1vJ1Gir+Y-r!m0 z?4BaNw@6kwGpTs=t?w13f}nd}i49!eD@p=j{9h>m>h6`Lf4_2&l&9QcJ5;XipJ6+I zPA4?n^fjCgV8UUB_O0oycG(6uL9R|g;gzS)eW?`)jz>(=8}DbPj$2iFlFPuQ4bK5? z%8`xz$H#m}Dm_JKC1*^&4Ie=I)BZbTp<&A5pey^tZnFF~_Tj6io3FJol$}hk2i|WP zxOgDG6C1+6^28mr5Y2snLqwQT<%^EmE&_fobbpMqXKu zDhp%Lh4r)c1^GVxUpN}yD-;rxgo5L`-_|VR8LUC2;YUF z2SD~rM7UnLDAI323fElo?4kF9mUN59{ukKZKB#{Vk6UocoGP;H_e7hL8Dow=Q! zFnJR)IgAT0mY2ga%a{qh>^GI?KkO{|`}y78a0MZdf+wKXW7~)c^heY8>*GW6z=1%y zt%lq3mV7S@H+K3e*ut)b`jRa=6RFySRNIAI>x@Q*wHDHaQs4PJA64W5GZkTw0ObZj zjSpIUO4tKuXGx4c+%_CGQK3}p&!Ld3^ey1?#ri%zZ{X_};iMRq!rw84VaL*!z$LS08c`$F(U|wcT z+%@MqXo#aJ)r%s5e{SyY)!g6oc)5ZD6-@$P&U&bit zi4)~d>V}zJdXh?l|uZ6VuGN_ri#$I?Mp9VEX>F^4l0N&cO>?dsI z?wibkK~D>+1KR1~Y(iSpLugn%gnCAJWNqT2$u3f30tFV=-@?On?N#z4K|2tHa;h8F zvzEJdB6#QBNh>*HK${M(SSO-k_#KN_ey>G#ccPXy_VyUy)Fy#S_Xhi+h;xqa}GERf7OEMS}nUp$Xg z?yor?-jU~bTeB4=*UAKtm82Hw3ZVHzA44~RY&L97i5U!V0zR3Q(YIV-8AhxZuRO&8 zS6uzmi9xW0+QBebbet|q2hPD`Ifc8dLN>nScOC%smCxy7ukyXXP z?rrOoMUJZKg6+CzygFB677PE__88-2?q#_MJ*FEoj0bhsXIhe&s}_ zLMP|{wq&vDut0K1ltc90P;jdAIb0FHJ~OG_hoky`IMr9qx${P86}X)xl&EP8u==?*;0?46@F6!`KElaWsjXi-FU9$pvZ z&FeC}!(FD$f8*w4OMV!eT)nLK3-v$p*lwfSxL)+zc-y6V*OVS<>*(xIXY0}p%|due z%4LPRBM9uC*q_L|uJf+mU01v=eE;P8<`TZhgM=b%j+cEkB=sL`HILqdz#b!+P+6q`}m#zz@WldAbE>mPS9V32hwK9y7 zb!7!l;Db>c&cr$t*C~11B(Z|_O^_)hOA}E-gN(8~(j)5UyhDx zBMY8V!EG?&FK;f43;|BWk`G4*QEk4K=O*@lZSUwm3~%BsBSD=oRsQoaljiT*z&KeFmEh! zl){*)`UUv>2qrxe!WWg(3QF(UVwQ+*oYSR#vhm*lJYjL!Z)YQ4eC52j8sHL0w4!_M zx}#Yx-&mrJ?>?2pey>fu>&?Fja1%bH!vW~`BxKKW_Y0W)_*IE+qF=c@A3&FZP;e~*sLzQ+#6_wkktm4u>UMZU8JlK5YLlf#99kQFIp z33?8NY3>+T-BRwZvbklSz+*{=IIkZfsR@KZc_{aDC*x7aTob_RAQ;Cd72J~7ZIRp^ zKNZa-NaKOGd)};STJtLeL?RSKtDG%mz;TP1s&@r@4um_|&pSX&GNY0~?_vgiKe)a= z{!xcM3(9!WCXciI;{~6`RP=wAHY35J$(C**--lfj(BlV=qNg=o2@n=Ra>|;?6tQxy zItdqwH{#<3xNGcy{M;Bc4Swk}|12-*@rDvQY~IK(IVFwGLqLbZ5vt-X^k3-7!4nBZ z89BDT^ZPt13WgP!VrKM2?@=t>GkoSsS`q{pWb)8&D%igAxYq91kvshfX4#{csBmx~ z3ZjnrI+__;9a$FoQz$N4W8eSckEQZ$FhMZI zKRNMcGJyLIZzwl{Y#YkS-lqmbjwBCKa*;Jcpleo3Ejkd0+)p;MJ7~K#=d$QPp97z) zhtPJ}xrJ}ZQ)HXDbO$WIyO1E^_07A7jm*^@`T4Lmb-ozb5{qoP|J(+XYu1g6p!E5eWp2Z{ReJVx_Zw6txbkHA` zcwq?|Gey3!gc^Ha@7pe&aiMTE=f9nq)y6;J}L1u>cJS$m!T1OYkUPLRj0NcA$5D^0Z-+ zKik4leWc$5vu1@-(fYeZh(|x*d0%`K)fv4obK)S|`%0-=)f9}{OPrXnpyMT#z;E~D za5cC~^L(QK|F4Q=LYnuRm$E|l2u2?98yG@2392AD26p&IYLO$n=Kq_+$qex96UE?8 zt5t-AG06*So|LnIY5mnOXObxq(pJl1?Zr29JKldd!B&%u39b0cHR!oLVAk|#kS$__ ze8^QCN>F|^>-*r`T%OBnjcpvzbR~iVs4QTZE1j#>nm2^yT9ip)X$2NdJp%}wj zr61%seg56j;BhVL!4*Zu@xd>~XAyCH-w>gf*!8mLEBt7!8YI?b3pE})M|s%I}A@%*77X$T)x#_|;}M#JF448S9c`QP3? z1vd^!VQb-lZ}SYuV-)uJic)Yp8b}OWE{Pe^=KtqgnyUeyN}4D5zU^nOWTts$Wo~rO z6&c3&PjEem0V4ladTl^Mu{6W*VBBxwZD0>t9qQKJf*!gj7Q`8d>ZRPs6%Rr{z`mXo z8f#vbeWS3UB3%<89tX-6^@{zDNwXwn&;@-R$zz;Ytpc(gu(5eDOT;Gd3g6_&G1J9p zA0&eFq+=6I%v~k(Y&J1sW}sm@Tf#(HTM;E5F|UMtev(bLO5IwQTDkhcm2>P~GT7Ic z)1brB6R{<2`G1VM-N)_nAa{tw_uaekIW7t$foq+wCJZ8Iu8Q!YGRDeZ-8;NIw>92r zne1ot7UvU*d4&8Zx;5_^CSJ#$$#P(aV*uq)g3myX+pKQ$`B6;MpXI0P_Pd};$v;~+ zyc3`E=zHSsvglUTEvMIpa0nau_RkSV-eE`GKR~8y1`{D0s*gBr_4!ghG{l;Mr zkXPb>9p^~H4fw$0`U=2C?1A9Wwfe37G2583`<`9=8(i7j)ieB59EQzgyrKSnqyM~{ z``Y}~Ed1NPG+H9S?}G+7#=*HW!IV9I#Xy}e#r`FHOwNDay+<9KD+I?og!zdA2Ch7R z)J3DbzkS2&!xV%LPX$sVl}Hi?DQQj0Yj9x(_2|7a^d2j5M!c8|oUc(;ln?lh;nmYt zDWkonZ6<;uD41~4$!_!Il?4mRAaf|JX8a+H3KVz$Sg`VA(5n-Vl9Gu=oX8a3XMUd$ zP>f@|N|$p!m3Yr1S6pra{NbMEf$T59)no>(m`#I2e4g+O`mgFAm1xP6w%ZTdhwD~e z(?yC_#U;NFtF9FWJRWC55I^jUDrli}KJyEe2)B{vF=B2n5GtTA&o^iY>US|WDZcVR z=)kkQq$@U`#waF-4d$>HWDK&7Fc7i(fnsSVs zisdlHlfY00p}&$fgwMA)`?|!#*hWIenGzZ7RfJp-S`=Uk#0SBkTkFNk6eH4WyR%VeKUq@W&<;O zTmekIkQyD-Lx=!U9~nUeT7Du(I6mmoLma%wD3_Kr4VLz1kp!SIzy_Y43!16dh}jl0 zsG}8BqmoZSlfcjx(CbE`mdbHHEjF6*gKXDMRSz%vbn*a09WYL>_X)yvjBSi%+3=*`C35U`gn`GaTIAG`0AC3uc@{_T0t-xDj@iF$Rn46jQ zxA^}7Mg;K|(#Wlp)bw>?)}Hg#$zul{--Ct{5CM)6n4#3F{gG?6Y*D;l!v3D8LK@xB z!YX(>+DF3TvHS;3=4ltDm0khFwWF&P70-{0j;m8is%80#RV1(bR9ou)Qi-+|YZkY^ z*$R`Z?T5z%avAlowhV81OHqCUwRhylL;ss3^SO!oId1K5yU+ww;Fc<3pBkk9;Q^C< zePcwO@%}hZPi*7f^448tr~Z}ZUGk`*l*AadJHQ%D2^f9K^deDGlz5Udsd{=>i4F*e z2n%Ic;PJA$q-M;!@IZeM5CZ@O07FAiBLDzzWnz{4TuoJuB}8iIHJA9D5@(J92zwJV1(TbkvflY~8iU@ke25btq z0Dxct?8>G#1u8&l$(anyI{@hc0GXjEqB8({zxUqzdw08SukEreyX~^cma-${+Srzv znkVmP zti~i#u&!2Nrb_jEi9u;CW=X82_mp+eT$Noj4vHp3ErU3LCsje%{1&8>oT0A#*GY$pn7U5 z<PkBHLvnN+gb4gHj|N<7;uWM_cPi?aq?TZJIEUVa(=4FBhpV5Nv(OqrRdNR+GeGv;%{^dLy9I$Xh zqVGl_Y>0FBy|zad(DlO{cUPmF=*C6y3G{|dVBe`{zr@jL#F#sSo=P^D(N1GNTEm*A z*}zBOaF#cBoK4a&3H(09?X%0}1`J2uVh&?)y1y{BZYpcqK+?9Y#NtkWRq(q;3Py>| zR2r1ePUr;r9`5frB>jrPwwY+=SnIMpg_csRp7HVVFXy^YTkyJ5o*K@ztq1T8d%^@20ie*_gldn zKe>XX{nVFs)t1coFaTv9(A@I|GPdI0qfFnYD+-Vp_qf5@d|1sjxtH56p7>u~e&p#o z19Z95@Nz#a%E1m)ntOA!RAw$~!u%4g)mM5h>n{Y!$>~64cKzV#hsCKDro3Vt-pym4 zvv!&Hb2##~0Q;F@eRD$4@Uw6cU`L@15saL7U5Av5M*TzWtmqrp&gVWzbxz#neN&&Fm3hBhg8aE2AB% zTm-7u>DY0zBzWHvoz0mX8=%CC)7UoImP5nI*YRv%_zkZe`Xvb)nt72M81*cY^3A1+ zX6Rh!JhYj0BfMJWdu4+vkT&CwxB6$0ET<}2@-vto-5A{7%>FJyTF(U$E`zh=I8>OR zS0<;oy|=8f<%9Mqf}i53BQH@p>B|-j4Ky=!sVRFIBHUb5x&p2jhz4BBLYR4yPyDae4$h&KuAq*97UI*ay)bu`dYYV(`8_ zeQI5JwPcc!-kNZQ;3Bg)OSzm(FyRDeR&nLLxK(!$gi)wOM*2Y%I^S@P+=H&a`qA6> zU2_*|uL54!6l4dBpc@)uos^!N)PI&?TRc zfkIIr*nd=}?VI>r?1BD(XV=$kEz|%+Cto+xng~9)rWKF~X{rEM7)L~Vg=8MRx6#oh zI<8Ku9v*6UXHNl-f>?phuqv?7D-PC-U|XzTXW9#98%W!n`i)zM%nA zw|v|Hax=wzX3^ku{<1{%OQR$Y8$e@vquxcVql|SjC-(Za!zfTjVGW>C8wH6uPhr0( zPGM=i9+2i4c*3dKC_FMTNv@OTfTJnfjEUKgEHxy_OE(Py>t67(I;7X}@aN-PtY;uJ z^8O-mO|z&V^2N?V#6qA9kHRgEAccyJhT@mMq4+ORv?DFRsc8h#%K#cxR?)1;y_G{vny+cY6 z>6jJgmKKX|;frcHHx!NU0<$rMg~be&p=d)+g_%Drh>O+L&Btq@+2ip0)8}>?plc+; zU(yjT-$2vAhHkP*ERJ1e!Wd5Z`jhEi0fbDzjH=*{$udm1a(hh{K0GDG6{;)J_91Ec zyREL&rQghu@5JSKj-E&HNX{!NxW?n}s!W(5%U#b?2}N}CneC5sHDU<*k&rR&$LckH zAZLREURnRIxAs}qjeIQjjejP?k#kYg{@9J$i8S3{6RgK2*<8ir;P;%xr;fJs)qamJ z&-`_U!z!}sxrt}k>2{ssZpUGwqJ*da0bxz>z!4K>E_5?)iFbq8PZk6S1vI zWsgJ-q=n>)H)h|weWnq~_|HibFJ$$dt~<}jxB36|=4~4W(%)%!^@4JDz7eH z((RV8{fiG2nW)|c)-vK6oK<(@;DTIJ@XQl_sy^+xaX{bx(ycvoE-j$CV4oP>PlL#B zqLojT)h=Yps+m~aYgmBfgmuafSX> zTK}@Xf|FqsR7l4s#qW>epzm!6c!R3i_-h`cq zR~}f@!MG6qZWSU1*a4Q{Fb<*(?#L>S&ShnXh zymtA2NF{p?)6zCBhwA8SKa3IUQr{&4?SOic5V7Mp9SuG+&aV>9sNKeFA?<)Hc1$MkwIBWi4vdE^4V zYtPEt(Q$?Ox}HiTdQ61|8q56EWX^e1@jG0KIl?@vaE{*|-7Fys(RwQ?_M#5pv1BrM4^P z8!nL>@ONK7Xc9suE+R4;88HinSQg4bFNC3&vyBF`-W6}36ODx-ucb3RiY5Uecr_BH z<-pMl<_&_3Dd&lN=-YSxJe%`?sjCpj`0)041vrME1#k@S7v z;0jnFxE1rpd*Y8ZBHehX?Pv;-2>!(!I4z|e9Ylm?Y&Rk&bs|+Q?u!NJXOKs_g}6yc z?5b_GGx-@eFA={9@&Gpkw;+n9+qXRAE4K+-Z;vukLU6B6FK_449f92|VbMo_#|_s{ zZEXON>Oa#y7%QiC>xF^xz$Ie(zx8<&K3KgxnnpuI#XBPvzw=Uyq2b|ZeypfiMR9|d zl40g3uxJpH9rla*N6_tIvUzM>DV~Yo#_EcAtD~nn&^W*6BBI(-)JUqRI008+_s6u> zYmuak{id~5S2_8?TR&a+{Ptsw?tWCcUBm?q66Rk%5dua|-*f%Nv;mCPyt6i_OO^T+5E)LLDiCK+wF&H{~OMa9JorNP1r;(i2oO)?6 z_Ic+g-sr~s2eLVF-LDBhDB(TOZZs;40;ugdbsk0rpbzVDyR)KSUQK*UlU;n|1~j|N zb%fL2b>n&hACS+?PpAA-KSF|#U-Wqvg&?Ja8Zi&0O~#{!dI4~_B-nJvgJXze6TQNa zU(+rSoc*?H9lC+Df(%1!p(~upHa=f0hY*x z+lVas3IVyyK;|k z%O`CQv@?yhfg5yPm2`?A7lf*aqoPU}30~ClTG4r|QW$)Rc2RtzFVxrJ_*j;H17d7t z`m^jyK)l5Of3A0p47vHk3%*1G?VN`o4npUsX5T<3s6JAHgYjtUzfF;t^e4NturD^$ad{pZ0h44)4*o`u7n$P~2|mCt_4 zD&OnU0~=D%g8`*%!d7plC$vnSeUHNUY$}8Hdwqh+@OUu&_;mtt1_G z>oxwAiN|LSfdh5nK|qNXJkm_+F2GzX=R7;1Q0AN*AR(z7OsGfnwqaP}4Y1%sNv2}u z%TGsDG9W2T^=8H!Z77>zs+5M^hXMSlC0;Zm!At)I?54Dd9(|A{uKnuWl6M9Gp2fzrj3 znbZb&;Nl4kq``sV4Ys5pO)};IBf7(u5_g*5u#?uYzl1$Id#>r}r(50yFhhPy)worM zpc{A>Er60tT{sz7?HY%4n8h`GNW>I*B+Ldl-_B#bea^T^*0S?%%3F=*GZk=Wg7C!6 z3+b9hv$VGXm$-ChWWR3^y$j2k{BG>l^67V}2B1fbN5z?N{S_%OUDhE z_Jl9Fi3WVMboPqB*Z;&KEaUVQ0}TFTnP@)966NJ9ki%e~`c!-4+C7Ws!e1RolLAPyg&6^sdZn?H3{rq=#= zkm+|jGoc;xbT_bL*U;f=JS~-x2+&TGR|Y!SmElf&;=|Oj_2jb$F>q~-_z|y<#1Hjn z=>cwcyJ$Uy`o2>-2*$haRSvHW`7bxW=3{qY*FM}yunq0^n8`tX(-Co^hxK{?;B&? zM-V-D{a3teLF9TMkk$R#Z2Dk)@@X=(dw=_GUG-IAWZqEityunGlP8eq=pSedgl{%0 z#cIfyPE&I!T(Do{?fxU+qx|E7ueO=^&>h%C>4$*8r1MeR!5RFD!$CawL>uR+e7-M zKZi3XmQRW7i#cYNd+HA2(dYF4v!oi5IX#pooEPHalGdbWIONwMA( zK#gkkQkKlon}e=efe`zD!`A9u-|@ngzfc8&u`oaInwb;CUH0EA3~ks0rxW3Q-;{&& zd>C@{U#Ia%`a@Gs#%X+`zZ!DjuB)=^6Fo$=*ElQqLvRoTe-782UBwx;Yi(Ix61l6u zh-{yW5-=wFoeJx5^8i`s%nx(#b%;V+zr!P6@+od8Nh(v~qnm4f2IN~UBH!u^-OAJM znnL7n+JawtXzSALn%*>T99ju4nxPYnrdp~WzK5w>Rr^_EOz(v4nq4#uvn(Her`+>s z*v;Ww@#AW%a=Fk-ynIOs*fYhlR~F9k80)QivQ4PoIB z*1E6Jd-IiiinJ@ljq}O$Z3?WTCE1qlS44CQ(K2}-lmjj>0f?8FHN)m_h;assLWG6W zvwlZ3cH`!3jc6>j<+;_?^4X3^Ae&2$4ow;y?NztqV+=}JIO@EcX_*Z^VOx$`P14Yp zeKNCi8_u|feFD!;fFEYIs!1g@`zuJe#TSBMGt<#?NG(U?uhk&2jw0Ix0m{y7rbyFq z>eaB%Shm!Rw(88EX_pN?VOx$`P1N1Ohuw|()@zrfp5`~3!$^QRT19WMbV!2D6sgl+ zhV1#l0BIWQ$4S3+JRu(Jbf&*F&Zn0SE7`7&iiJN7xkL*;0R<}A)FDk5lJ^gf?qUJc z^no-S{u=QnAS>y)it*(JCH#HaAl*;MuDGAIfgCb*0SEu1 zAZyTICjv<`Y=G(LH;*ct)d11%87o={#YwJ|44OO&f6p$ot3+}O8+=~uJT3x2t!gSn zAio4zv*M+F`QHL;m2Uqt*fF-FB#ad3dRnsg4H2M90#yo1|Kzk-MpPa*AGF)9)D(*< zp)KtdL^IXU_=nP@r&dBc?3-^aKZqwm2E$)VQnk7vkxE_Dw(|Olz zP50iT^SMbY-`U>LCZxL{O9e^r`GCU+-*BMZw>f&uv7II)?6reQ?#%voRHz5 z+Kcwg#%6NLFzGolK}~qNEe^Y1thdg>()|%+me_kuKdiwwWQp$IP+ZCL1F&F_hj$sn zyiAfUW&3arbU$kJn{Ha0DHi{?!oo9v`n^dpHT$%eUNsfjpuOJqXKo6Yxq`hqA_?WC zde0+fca&|^0fqkqn!#B`}zo^3VexNh$DZ11-zr0 zwR`CRje{HaMmCbYD(|(N5JiIVl4XBlhlO4qcZU=*GGvMjg&~jeIr8ONJ_8o&_pYQj zz1l#088KvqOlZl{gfyy$uVqXar*|Vs``FBcR>zb1~YN)0=V-5n7EJA3cqo^K%JD8d`o)j#0)}~o`a|ybrg4< z@ppER1i&Rv8slUU4_?zqABQP$38MxfnZ>Z0e_7n)6cE=MxFtqbe$R2}8A^y^RbVy6 z8XEeLxt$qbh9wnuetM`!g>-57UBIcXE@G=CS&$vcgw8mgi8^LQdeQvDl2}Eq7GRE| zXjdQ$%xy3k1p;EELxWz-D{DMvah(sXt{y=AKD(#3Z!s;qfVRllxgfuZ7lC%{t`L{6 zYh!H!v_p*^7jRUHl1)~VTyGm(udq+vZrLATVzZp_E}rr5(Elgae(u6-T*v2AL)9m@ zIHNL7WD!Uk`5s^f-DHsL;mSam0_C9NjcR8>frbspyj^u8;u%%c@+GIvg`qL&g~t&9 zg2Q*_;&*(b;I9!dCL0po+e0~gdy~(dd$-SY4E)@rRW?d!P1orq9Dt&5K>W${O&ek& zltk%E#;?3Zffa}ejTr0PC02?pT!QUvOmnHuZy_z#i(?w){1wy}j3$s65wbGS{+A)T zgv*M){SIJ${=G`X;YsV;k)V9O8EUmP{=S}F3ufD4Xg)ah4uI~S7oM@uUhd7i?5fp$ zJmVEloG2Jb0}3&FTq;CIxo)cfqMbdhI&T)cYsH|6`6lI!os#NR6e?I6#WQl+v>=}^ zNYlo0T;IFrn_1!e33=Xw+&#AEIt!a6jL2qCn_IQ!hF5s1fZ*@I3+!#iN;q{SiZ7oC z0evL!ys||dDMlB=hyy#|Dr-r?4Zvjie}0P1(UF(6P(xtl3p zO9ZeR_&ec7+ zpdPv~U2WqYZj8)L|-y7YKKZSXhzfM8#y({Nq ztC9eq9iExHzw*bSI~nO7>0p0(P^47G*b%TZ!Iz-rqCNNh6^9?r`|c3Jd6P^8b<5Z- z(6VYIDMaE(9;70cN=vc-XXC>?+2}mw?edaMp!aX*uUxxUslNfLtN|OPO)c0{#6Dwo z3Q5YcWCMtvk#Mvv^T^f&bRFvp}djyKJ*?yzxAv4wRrL+336NO0O1WjlMOs ziRR?a1lxy@dWE6ha-d_6PT3!~qO0PgO9LBoU-(&_1Aw`uObfcBL1uQs zrCF|A$~zwg|E0u#pK#<@fZF*Qq&xKA(?*&ZW)R~@GDs}w%NE~{F~m(q9QQzA$W+!j z@3~b|5)9jmT+IER)7m&%$3wE@(o;WF!&YS;N=#h}!6YI|yc$BWg%=#aLy$CR!z$`` z;$;3=?+>zu_!nD~K7A?4BW7%#{E(}Sz5K%ziPxnu!_FI>!N2E%sKAo({A0^E%pD>4 zb9?#%S_$S}I!n!0;*f1;?3}VCK#DsE!i8M3$MDU(4>s$c3^&gbpS}cSw4t_x>&XSq zaHl>Qu{O}>&V8IHnD28TQ;Yl4MBiMmz$atLeF}WdSEfT2#>hs=W~`YA-Lc|=NhdcJ zL_?w^Y%wafaw!wQqsSL~HVkIRsRGB`R~S5PIZ)k~477m8gdfl=q;^Tlf3gPmlVKAt zYh}HOuk&GC>d7DE?*brq22@L*Bl@0GMU3sT_(3dmCo;fFOP>7;G#&r`0s{U0|Cz_p ze(^IYGJad?fWTi35OTacA7iu=j-{seQ;pkz$6sFkr*+Gq03bn9Q$b5!i{T*aoCJ|h zfh~!TVOi}Zd%Ws!Av_oONr7=0_6y+XkdXZ#qqUTlB*(DE-ws$@ z^C%aK#*4=h(2ZH0R#XPYs^i<L#9$O=2*3>>8L@_Wp)bJTYE*dg=|5Uv0;EAu<~dUw2FcDbAq1G_9NK6MO&~>= z>4U{Om>j>X#(+x#tohu+>kKO)i&r^^$T30CF6nG4s06LG0tmz{x^rtwpGpA^bz%QP zFvJUx443~+FZV;#a>mTlh)l(dU>GsL?DsGz2yJfokIx5HB zoZ%5p#%w7{x|Lp0uew|N3w~+uD-LmJH33}1dUBotg8*8(A?}tKmz2j$yMTdd7d%-I|4m-cP zbn3h-`vThhNqb9#vNY@Ae#5H3fw2$c~DkJD&ox$qT-H{BzpI zsNG+bTA`^*5efQ1^_Qw86OCFuO#GEnfuPU@Fx=ikx z31-!HS`?%krUoDhT`mAlIU_H3gpxA%n4J>wb3PVKX1YPF?);hIGr(DL<|MJKQqi{O znkc#S8?A`iHdjK%0{J?1J;@+Fb1adWn!Qc>hSJYlXpmdZEAOuzNM zk)H=B3)g!@=#Omj`qX2{K#(0W87iD;5Zan)Zy0H4|_yoAdZB2ju;iWy1x?09`<$ zzxXoV`OO%g90EQS9D%D%fw{Y)0uf_ld6mF*=qVCNj{o(O3aT!ccT52Ll3ki5;(uVm z?lL7(x8=cf8Y@4^0P}u?$Ypiun*7qAnbCvYMJ6M;M*&K8@JFi#>+Jv%nte5lrz71+{oA&<0(BMEqmk4?sd@RVR;@i zxn0hpIwc^A+WIg$%<@%!O%5sc-KXL!KlBA5hY#}l2xS|xpxc9**yc#pKnn}qlaVep z4Rge}zIdKvv|mwfdGawWE_sv(7PT@?u(1Hcj6a!WLT!Qwq(Ms}k3mO>EW)`pqYR)e zlQIT68I_v);y_E%)2e$w>r z0h743Uh8C4=_f|Wr`p;~&SM}Bl#vpoWm=Vfd0;v(a#kjL!PSXQ16BDYguqay0tv)R zmNe+eiX4-=3n0{aI56YakY}0+1X#3h&pE^wKRE>E*WL((S2DdW^iWvh#CJFK^~qG> zn=nxX-N`Ue9LR#7!3cat|2bv8u8b+pF2#nbxtJ=KN|~&TSo_XA2ubAb38f7} z+2=zor>%i>OwwD!)|&ed`*t?_KQM3UHoCsv9RVTQyM(`968r{E?_3q$zX19#z|$QU zVQJyyg1ES0B_X!Y%Qq;Y?w@d*j}D$D7~LSsy=TOZ?-Cod_wNKp(+%$a z0rBv%op(F?|H8X}k9)wtRd-3_^}FGPE|F8q21)55Oa`wyZXN2799*hRDeo+|+_pl} zpr8;C0{{R3Lo`4m003`RX)0OTrS7%^ z-vIb~+&3Lp3GVJGF2MrwH z(l`JJ3;@l{KvkUq?)%;Q_xH_vwafRmZEm}6&27B3mgQw>h_I4~W!qAWI5?KTDH6Lj z9bK<1C|Wj{w&ErZ5W-+=0Sp8D_XXyQ5E(!q(=QSm&GRh${IZ3|MKArB*q^-5nJL7a zXUS}`R%0~gb2&vy*~`tdW1Ng8waeT8j5@#e;k)Kg@hpIjcD;&bZ))Z0TqxVl8^u|Q zjFwZJbC$_`wPv<0Idju-^D;aP&dVlQ()7*L&FN;!q%{621KW&Ope~bw#6v}eG{i~H zoXShYt)vzkH_dky(o=FX>It}=4#S5nDWPn0biSuV7)+BGNeR-F;1vGWONqDJB5W;s zf&nxMQOBDb%rd=Oiuf}K4~&FKhdMn^EL~OkOx$FL31kN57^gH-+-%nuDrn~Uw}vY0 z5w2Bt4$=j=3ugSB%YC)l#x!b0K5d%OL1fez!eGErKj%CYhV4BU$nJ<9RI%9gqF>6+~rz2MWH$*fw2*&kUkM%i?KQ%-( zjlC8H6jBNLGxq&iUUt3VT-MGqSLL};1YP`=_dE2d&lY@Hc>_&m@+pymwrKq;i$JIg z|0uSQe^)EC|K&5W1{rH<+l+03Q%LP1RTtb(X3Y7vhu`DDyM5MnN_lTiz#)lz#FJx6PPVRw*t?k+S{Hb7w|XA{)2vJ zJU5$V;j7{;V!e#|yjy!Zq8M&l6%pE?L*u%QJzK~~iW(Nz!c_=Z*p>7RR6=4xB+(pR zBwJB>2R5$J1H+m>P#GxfmO~fNLtV)WlA2ObLQe&H7lfF`EJ^W(VxRTi5rqaZPkAJrdE)`_Y6Xo(YF&$E5uPXPQ90P z=wFBU1&AM^%X_!8qkjaIjqXStMH_$>Eo7AF&;vCTBmiRKk^!rLSG7r^UB)8;b{nw9 zIIoRwYMYPGN6eh0Bpy?F%YB{43pdi?gyD6ulqg)OoIjq^;NMZ4Kd}(LG*qBJ1@ipp z=&nRsSAOY`|FNuB9{)Z&_jy-p$Q6|Z)bcxkRSqe)GPG#RaGIw3&ux%U;mdRkA+M>r z&S?Lwhzo2a^NDj1HZ^ML`j$cmNE&p&;Kb1`*jC+s@Og7l*wx60j5A3HI)r(}1zX{D z$GV8SYNC)iqUx4ez3UVJD41o_Wy&X=bu5YJEyZqmEf@vt&{aE(V?9l@38Y2ZgJSxlUx z!c$LoTt^ck1jUAsPSI;8|ITG48>A2(%9Fm2*nGrra_i7T<5rh>IbfFi1ELdDGYAB! zC<*+dvYHU=O>^b8$|*);vIt|Ihrob-37O6sC>uyB0nSyXuBTa94qWboxB%gPE~9ge zGO01n4?(qCn$%0)G+-GWNK(d=Fx^uNUy00`TasKS4@s2Gs<-> zEK>UJdYVaY{Y_48L1hTR-jql_0Z#syRCpc*5FON}->^VRkm`{<0fy1R6dvunN1PK; zp|INvNU56CjFn|P`; zgjlf_K+4I}Ccy0$1^ij8zA_~QaHkWVm-ud!fri`NP>n>*XSjYBa5g=x8Y$bLbzs+j ztymcTH@I|kxrgcj<(FyE;7%ph_z|+(jj8Xq(AVHO!$S$cv;u%P-Iq0!R3Us72?O}v z$@S4M#RqLoIK)e|*&Nf^RGR9Y(Ey8sCNU!_b=uZ_sdozKYAYx&5YG0W|65Br!Xa%v z&b>=e{Qkq#(#jl$ykU4L}^a?K3&ei_+c>v%gsI<6+d7 z=Dg*{S9+;)o()XTp|9Y|TchjlDPxZd>Od`(}QsJ5MH+*?d2*& z4=#lU4cttU&>B|%GxwalgfxSM8aT(a-oCYKsyjGyn=@XDy!Evyr4(zW+}T4T)`$s| z>%h=wrUj?Cri#Z(*}n1CRyPZo^l`x%iE3NE2w@duF|qZPjneMp6~HRZb;g8TW87p- zM*vf%S{~-KByW1d(?E5c3#u=kG(czvMz|yb9prrz8`W~|Iqu-Iv_!@kqy!zp{Si`x z#hL~ygu-nnT>*$VRQfqp6gHh8V?4=j%@$3M*izt$77mm0TyVw-uhT!le#<}6P=?!E zh4acwtH;q(1?7{f8UwwZb2X^+ivt2ZeU)ztgtjO3fAllH0pf%f{thNo9F<IU5rZ=j(9TZa(*1){s zMLt3_v61}n1^~wig;kALQ-xI+%zU0Is={6T1GCo8whMug0gIEFJV5te9h>bETqmh? zyi)Oj?Tj>^vY6Q9k1NWx+uk^J-J^qvEfN#-s9~6$Tl6i6V&;AHQycf9mtV212zLmH^!y`;DX9d1@Gt!^fQmz2HCuc zde^;|hFfa_v|jda_<@QG@$&%iDBC+Ib}eMnrc1@^fnTTR%T$W)zb05d1n8N$6xK&C z;+22H$V)7GpSeXA*Gu%^@WazoEf-f-L1%g-bK)=F^<@Y0hPhm;eJeh2l7d2h4f44J z2NB5btF5S=UT1Z(hQjurI-wrKsv8T0(Bl+!PT`pG#c<6+{-}wQVh#I!oAPOCaa!w3Z-m+`_`Wa#CGSbEp1d-R(jL-aCac)* z!iU(IFG?L+icVZe-3``U(}SZ=Pghi7e)2Pf;?P;x3Qq1M9+JQHgENq;T@zebvNRj- zHynZ-kiT?Y|It>Rw98

    rctPsQ5PBdA`?#mVpL;b#4p(2E3@OW!D9~R^L4N^W3cQ zf0yWWd%dHfeJnl3Oz$I-HsM#G$y-2B%%3fpr`A%jL{Erw9b)W25NH_51aVN~5?(`l zxgvJ+Nn^a{%*(I9apk1}2z*XIY2lt(xh}NQ)iGB~FLjJFWdn_l$6JsKIGQ@DHP6b` zz#4`4K|CQ)Rm5oH11gQY8R8*aUJwP#mA$2mMJzDFCo#$(U5^Ifc9Js2=d0f^4`1L! z>4S}S$C;g1P(W0`LPr?at+wM2moVz_B43SGgapJz%rxss;SPhIchDwP+%Y1)3xWf~ zSQ5gGcqW(f0>dK0OrR2A!6p53P^a~Q3EA^DoE0`Z3)l)sPf|3`^DTbk#}1nbDtdiG z1+jqP7>RD<)keJh7#Nb-C)nhL@MKgBpAhTPKpyorrPV5v2T2A2Aay1s02a@oa~91E zmQ6ZaqcU-;D4?_ zqXybgfeMvTX!uu_r8Bj>Sn5Lff3k&Z1|hTXmBk%Vaz&2E>3DslJL>z|<01fcOLa+E zLhsF#D<0qu?iybS1csmR@6c@JZ1hkq-4y_NOWs1oB4)sf6$nfw0O1{}g*+>$>`%!l z1?8)Wj6)|Xbt5P8B>oc`XBop)1%_!{XYthX~q=2d%lOKF;ArDtTl5Ln-f(*le-U|HH}xqv*s$E=)UN)_70CMJ?K5i-HMR`nhIU&MN z=LcUH?$cxAScelSPVct+xfyq1g*hamxe)?}OWv`7f4Cbt01eb-GVC3aV0Wp=T_{+6DxfheM^qkg zp$$wpcmde18P@3$a69Mc$?xoir)DT9kH3l>`U*e}w(eJTU5d9zY!!o&2(|p&wUdS3 z%}LxpFOY;R>8Ev^{xomV(u>nBJ@n1{CKQn|88#Zz4%Iq^7Cn-VcJg7zWlN0yc-GHZ zqCi(i(W*T#^Vd<}w5w_}=`uS^HIcCm4JN{R4&Azmgg^RQ{%7sdg^jcXByF$KmC2_H ztrN$+^xI*T?eabnfY#*un4i}CwOD4f7DfZX<31CC_re2~?^B(>r z7ts@<6T>;?V>W$BQ&RTJB_?>$vIP3fNr`(iq~|Z4_X5QUF9MthLeWX{li{u>AU}5w z92*M?C*gdDjR6ik%lO+H2?QIl5+vvc@Z6bDzcDNrPMZOFG8lPf2oMjOfbZ<&zCx1) z7UA(AWaMz=8lP|xNRtr0UX$=Go|IAO2^Rjw;sf4#NkrTyHRkKD z=7|3@8q@4Aqo61hqp963`Hx`=Zv6N;xDnIZGlt;= z1Yed=L>49MFqH{in$SQf(U=y&R3<HU zGKuSsPk6$BoZNP*rt85<;3r80R&9ypTy4Y!S?C(tYfSliDwDtN_{5SgHu>yn#>^7K znV?bUQX5Lx!%N@v({N(1RBx8zahaz| zrifPzV!zzH}!Ns0*P{7I6W=!L<$Jmhxs{^ z-%(spc8?2AkzSR@(E@rT(DHm*&yNW(o!%44pX?r8g3vmDQ=PX-s$V~eT}yPb!Z2JAT$poX04yXGv!6wJzr;-fFwtLA9A|VOzOne)1L6IlhJ=YB~3DOkRLT zB^A_zM3woNaU@SV2*rt$5dd>?iXbNf3B~q`G&B@cCM?#NgtLsqk_Adw+)0y35TDYC zB&0a0fR#?Rp=F67m;cI%OSS~-RoT5KnMlb~CieallcW@lpplrIq@q30!(l4-O|mLD zFiC}Bm8T?29~k9g@BvM$ww}Z@82sb}Cv4Ev$xm*Pr$+yhG3jegN}_R-z6l|2p9Z+7 zuhU##EuAwP#7VBtIhnPYC*I4>VdiE(=a&;-&^#HK5B8ml)E@2lms-H>>`M0Pa^^h- zbTVcyPg>1xvGMKmu)jU7C(3E)yms5T-9NR_=dN`_Wicmqa|iEmSIhlN*=99wmSm`t zt?Xq3@md zIlcJ!a|O8Q0DNStPhIkh;$V8eW@n1OYGNISQq)#~%{6Yj+_HubmIskibRshZFeCuq zOddVHzg4l}D6`}2=W+QYx6LEs|KGc&4c&Swwe>D>p0Kv%~?Hbas(0F}#c zR50N_5&MB%mnijY$S2jpHbCIW=nte5?$0xkw`750WhLZ03LAY81+*}hCAvWta;AjB zZ5gc&RFI}XK!He;#;1Ew3OBrz5YiA7BkC@p+UCw0{OX)Y*C% zi=_fz(-c{_Y)*mVv5N-5l)Sy==s`0D?5-vRSct4yROOXZb6QiCmVc(jb}r?BKm}2U zj#oLTZVd%8^eTH^9jha^H=EO2wbgap^P*ne@c$R2_}erO;b@`@3yPEyT9GrnsSCOR zfeIoHkzb#-Jh9k2;>G6!%zFSYPeqNE<#QQSl1o(|XLa!?MG>UJBo@HrHe%gY|7ZQ1 zikK4!6c}}hiRfa^{8L3tFytpm^{AWKLgqn3fOi!(PxH9Feh||)z~GfO+`t>qL$WdM zs<}OpQjQ)1=T27erhJc5LSfoQO293~8X7vr;+z5io}^1yidm=4eKaW>bAWgt1!NH- zKd@-f7r1cj??NmjRXz-Y*8q5@trBmOqI;rsYVzUi=T3GM3J4v@bqE9{!<~wXm9xK- zj{wxr$g=`A?0oG5vae)1t%N9$N^gFlemR&KkSt8YVDG2_-X8$>VGg@O%*v~q8Wjpl zC#=ylxslGB!{$yt%0|@T8-VwiGdYgujy?Ne3qa(zQUw$A%+J5-wa@N*n0{w*;TIL{ z^sz$E4qoTGjq591Pj)Pkj2jBS>Z1M45?4fLcb;Ep&DGSEz4_v@YyKHTTUnch(HuDP zclc<9fuF?(J*Bky`j)2ByWvcD`|a0^?K&Ob_hudi;9AY2SK$+@KotZE8uE6|i%kvs zO~j1RKGJDxmO2UrmVPl0pU$k`Y%8{8zKHkRhK4gJt&!NHQr7z_)PM1Rdzpv17L&fV zxKiynss!~OGbrv+v)|m^z-obDhR^^K-^kd0{)L<(yn8T3@$d8$@o@hXX|W&3-v{cY1ahApU*u_5X^(*;94K!xy}xAbV7Z7`fW?tv-X&rL>bgU z7*5Q?eu=-JCetrpdsNG*X9s?tEYn3leaU^B?-=JA*p4r=j=K)sH`5=;A}tNYZ`NIb z;K&|nks!crjct#&q4nrsfHJW*Drr#e+}1^|X*gP6 z*ewYVS?hjYvEuI08})~!W9)X_WNk7_Z=?S+p-X;@QGnOlDHtf8C7^K4Yy}O3^e8=8 zj)-Q#{DSzX;V|igOf6?Eo&xP_@-1WmK#O}1>B|`j*}~a`Z^#g5m1kQ?Sl$iymSH!4 z@NcICY-|dupkp>I#r$tNvU&C7UM&!R?CUdd*j7nx$JNUuBS9z-!KkVTUw97rl6cGNi?o8-E_a1uFtMl8NkiFqKaASW_H}HtK>_x9h`rV8zMRC9`wa zs3q3a*eQrkcE+!!P;dtVM~gyELtER`pBkkuku|cg=_uo3&#YhbAB6zMNc(25C74$H zl}&?UtvISVPfCN#Y?^!oI9s{2(qWimFUH6@zXp-`kA)+Y#u{^K+g$(v5D)?Y2LLlf zKr;XUe`WlXz8{Fvn*^rOQnN?+jGO<;aHKg>Su!^oAwb^Jc9NaG-fqXW40rwa9RC0? zLj*-40Eh<$X0zf<+2*;vWH&xDcNvD^G5pEQGbG7&f~XLUD(~ehP7Ag`1*o}yKLPF1 za4)@5Q^*v(^w2GTj_By?w-f@=0G;&GFGK)Es^}>_GH9o%3QUt;4=|fap_u@H83Cf9 z0H`lB-aDQ5ob$HZ+uX~YTfTRfE;r>#T(U;S+B7m#icACpK|sMEeano@HjX5a64Xcl z3V&2SKhn(q-j9f;awrkhpe~tWS}1k6Fym<7p$>P3Lr5!55lBbfSE>uR;sn5yC z!=BbfMuBTpS&S2#3frhg%_NL@8Yi)=!W@wXShb=>r~{3I=vlCz77 zJ9JV}>A!into~8eZDbulpa(qFC#QF}R_P}uDJP<0(Z*0V9IH&W#!??U(PKAubnW!> zd%gN~Ay^#yyI}oTu=_MlfXgOxLpR=xuGf^6Yi7rOgLLM34Zt;v{JcmE*3JxViPN`> z4cK}vzPZ{t0z};>-+k;F0$3wQO0?doJvR8;vxQny?xSenSv~=4sQ1Q=>q5nD=W2F_- zg;r3*y`9|R85iGXyl@CYH(KN~(9ulT9hoUnr$waXuf386RPBqDeaj(7qA=Ww7s@xvtut=I4IZ z%&T9KaLm&G5a>LE+Z)85*yZC&Yl%M^29ja^C>gIc6m3MAB+<$!o3`Z=8?3p`{r&Z=p~$GL)`(^tH{M08RR@ z#iCZH#J3Z$(YT)qYgEwRD$iRTNgf`5LorTFoyUUUJWqr6Es37WGw5ih^0rfIL)8aV z!fGR<-5F<$V`P>;U315Dtx47U19H(Mz(KG?3!Z=4_CfDYJUTdLW?m(f-R}pq!q1@ftOH_RTpH*yqZUry+BU3iuR)V?kjDW_p_EhRD@kw zdpkxi*Rn2-l7_cRatJ&=tX!8uV_qaA?7rHshQ}3E#cGp%b5Wv=)(ID{)L$EdZLxyR zKGM@mCxM;o-Qlh(1TQlcrh=k&UN69uUH+Ha7QyuswDz>yZmm#q_jaykghv2a;y&O! znMGJ@butV>d83=m$t5ryVbjb(2`RA7X%%f*?qfvaU0)lreRY6xI*A4BrL`K#aAF?4 z?Y4wV%?!Y8!(X*0p8gjnl{wtRk|M};i0Cy&y6ryT<|w=T67Y|nhAp?IC6Td~ieQpU zMf!U$k+dm0-zWnOw5FWhh%}A>iq7mzOz6mJ@VkgJg)GjGnhWy&%b0FwWgDtn^DDD! zmTeuu8ou25v5+Z`C{Z$I^yzdh_AxX<~Ap*Or#bkig z5Y+mn5m&4}ZLMI4w_epErhMWGJ&HqVd?4}ztccVX*KZEbC17);b!bS! z@qZ?q*w82k@KPDLkD*4kZfS>Scrr*iC3)>4n*8n?Bvs+<1kk8AgEm{c5yg~4q4YY} z8AM`J1z&2Bk%C_Mp>b4vHDK`Pwmip(G+Z(8l504Z^ho3ns=Vlnl)<0Cy|nSE4>E!O z6WGuZipVfe2%3R=4pECPw0}z^=#V9cmJ9u@n0Yl;1B1bzU|iO5l&mgqX zqA0J}b=g$0UZyhNCx(}&-32)l`un8~5U;op@gw(H<~!l`b?Ez{9~K=cGb}x2?qTxC zY5T!&HSfXxe@L&NC8(r}Iwy4396!{<^tbGxw$?WX3*7US9uoA{Q4Ym^eutcRXu$Vg zg#Mb$ElIZH)zLfq?Y(w;IZ(0tnQ6?SB}+b)LGmg5bG8FxvWX{Id@VnI1`O$dl}?4> z5@SuOo=h2a%;?kj1?I6jbXR;!S-hhK6>Q3LPlGx^@B=-FXjs94&)M!#OqMa*k3_~S z_hD3V(;~0`iuS!SYq%*ExLp03Iv+G%{39?I`{tp#UyR&%BPYU1{h|*7(HRk3QLD!H z8axW@RAc-X{Pol$XI8h6+C2qf9*^-ic0AY&*|VSf+z$T5!Ic#2Fa9Bz5E$QWU^s zZzvL+g(tkMP@jOWHKO}7E1_IzD+AwrT>CT2{fbaGTfK_IsZ5v?)yuNX$_H?1=K1xR zVIR*sEIQT>T^E)YydOyWj^B>Jwirth;@8eJB#nsvO`^CXOFeTI>FSnXIMP%DsbIJu<+cc=${a7>=gSjCiTSTSW_-9QLxpNu$ zakzukdgo7hC&$yi%jHWaj=6*~hD*5{A71D%-^FJsCtfD2p#YB&$XvV`gkDTt&YaljT`&N8E6LO=1TJ> zZVKgmd*UTAPNvM*0?wBZ>sFR{)<@8-N^ z=tmG)=-qVCeQnHJhoA)({|eanj~rK|!LKBmZXRp)*w+y9i-voR7UH>U$EP?TnncvmsbY5^2K~KiR`nc~jgGP|tC!p-W_ll{j1Kgd*fskI z=>BX#m&d6v(S;6VqH#V6y!7cJSX|YmE?aKFQ^eaeGs@gYa57C3FE2eB; zBFztKGX91puhaLZ|BPlYWVlN4y2|91Xwy1i%<7bIYADOct3PQubk*uzDT*|kkf|M~ z3B#_ngkK82nxIV4v0I71Z&Tu;B(^!ui?yaI7Lm-Ydv11g%SvsZ_ge2~q>mN7``rAu zKQ%wzhHt*K;2{1X7XnZ4yC#9ccdB00cl~L!RO6@lM+ruUao$bJ$)E|f*e0?T=>iQw zPX8Y1#wpbs^BrOu5Z;Y6bnHUC&NnEx+8{!qt5=Kt&paG^VzzttT9^VEn;HfL{q#g! zq-*`DdAdzY6Cp}Xs*Om0Od7>615+Nu#0vJ2PVz_WiG>8v^=+ohU>E*xeaSbtetsg7 zYSJMEBS2Nd6SsvFjcC;YHZ<&EDj5mKqxbiGU`$tT z(G?|uWK-Ysd62&s(}9f$xLC*v^}EOxMIopaRIAjb>L;8(fDiSu;QY74@pm6sV>cll z34@8PY*#<^)yj&wxYVhii%|@5P0y@s{L@aoNjlB9kvzdW>!$ZK<^+~*FP7XInrME{ zd|tfEG!)M*6F~nUTk7{OnT#Zn-LxZGQpOcX(*+uu*K zz00+04$@wJr$hK0C{m5|D!WZq$4~njlPpYQnHHeI&mh{wKJ5o3Gv*SV!Cy{E@rP@b z-?MHdtIdJedd_~F!_elS5L?0?^-$NR_}tCOfi( zDYe&KUk*0&_W4u#1!5wp7@T>D00c!v^1;TPgt4Ct#VQVuGOP zHe5eHJdh(>IBzif2=2N?CkzEwyDong(_t(96_jpoK8Md5m3t+8P3cy#IBViPdjH?z z>Y6>pFC=)S?;8xAHyA|vB*9N~Aya%rhq5ruHQ6>h-kaStdzwC0?KgOT!USp@v?_kh zmGIv|F~T8m7JDUk{=J&b1Mj`4Lr{l^ZTukGzG7UebwGNbGY<)%UvFD|7w~4D(WSz_8}y`{61AxPpdoC52stiX+yjN@=>(<_ zmtHdq9D2#@(P+_=Gh?mCL|7@icPrw8jVgiZyXMsiBfH~Q)4v=s7KhW49-;DPs*R`q zDDqNbJ=l~9bXrg>4X`8*O!cN^VTdaRY19+A9#G76iU!y93*QHX&_(WVvcvM|2z*EG zVWQFVVkT4%Y-A4|ns~P8sby?5YI`?dh>JD32fIq1C5<8u_TPHH_DI!w#uxj+$p-!T zEF@ll0SCml1Qj$k+uQtqrwP$MUrJZ{jGy6B3D|jHFKsgGv439>-TR4n%p+_hUs<& zDpT;h?6czv!%|Cl!GV8+J(7Au}hHtiC*e3!%c}gn|Ud&P18?jSC?8%}v$8Jym z`~Vkkmctuy7NFbuvKOs8*F)=pCTUF3M^2GS3FMCa>xZ=yrh|u}T*}+)(bsoX-pb<+ z5fcvD7h^!I{y{#*L}lo&%=un&F9$|_|XWpwcJ4Uu>-f(Ez3j|!3H&d1k$IB1K$fM_jL*NW~! zdU9nfV%p|2<%2EU*x`-qypxG z1#p(H=P5|_U+-78tLGLxewLiXA8ZE_#_9HNedAa(_3sa1TBEmXoU1Yzode$h6xs%r zy^ZJ+F*78X?)?0c?({+6YAg-1L&l1%Z_607{y+U#AbJ4)vwfr!FT?B-Vgw9L7YL}& z-@#Bj0%6fN&&c>h8|)OT)5UiSKN6GDG*B*%!zwd^IgA|}u;ped_c0ce> zJC8m*<9wsup61ngE)|d)-qZX0Rb2P*STWpCV?Tu!!zt155u}16lif`goqiE0V2uVB zWsael2PvrZeORGS1)#bs?Ts(li&%ih@DjSV zg1^eo{9;{@En@}tnupuVl3`Ze8QI0-*?p{7-o8l=jz=gv*PD78m3bRgtM|+qylYIiv1mAfCeJAdvWvhHLnSoo#e53HA9kehGmE}t;A#&Su3U~n0o;8S@7MYCG*;UqQm5_CU4gwO{fMbJQOq!hmg2Ww65|nFbNUw} zK!mf2mWBG37e@_DZJk4jFa3`FQq@)S)l78auPm8Iydj1eZyzZhf`$k^5{>aa@X{Cg zwRVITW#heygzO33yz$9i^4C26+OM0eCWvGuSi3G8^^tCz%O=+{#Yva(kGaopWsy}V zD_V{ROr`MADv80Z+eE2^w5EboyE5WB+%t6?-K%e&k1=>0FC#%r;c$01&sMxD%o7$F z)NrcEkdAPOL%M7&mi4L1M9V})+RDyi=!m(fRXN!)jMP$;RHb$z{c2+QnBxI5>XLS+0iP-#>%zDH)7kGqmfg0A(YUB=EXK4_#1gjz%{r!sFmri zl$>#G$N*xBC!!INax+Vr>>Z9mZH>WyIH}uZdR3=Lkb8`bNI-@?zQ?~32Wr^1Cg#JZA<*{xO7qrEBAnu*|wClN? z3zu05J9A(n0;jjnAmsrD2pGK%Av-P65PVg70QSEKxBF0>LwvrsgG5q{UMXa}gZ3f7 z*pnHg)?58PUi;|-Z&`8dD&leR^7nYRLX_~cJGQGp0o3S~VpXYKuoH{^_BEw1@Be$U z;y80Xbs;1rx=slZ?!hl2Bx|xE$hV#^umjoGVGaUtyDVyes&>0CHyc9@0wyyhfYcY@g(a1OcS9(6T+vU5h9 z)+~pBG0?FmqNr|0aT5lG+{sOIJ4jNZM%#<-twEv6?l0nUNk#3R%bLsT&PP*>&uM0~u? z625$f4$#?GXTfo%Zc1YFJ466YnI&ey*jH%%t&*@1qh3};I#o6o7Ul!mr70}4E0Eq! z)kQdyst6%z&Mg-$dk!h3hvmkwW;j?&J-4)urhu8X=hJrtH)>8U8I!<#?dcRBbV+0V ziQxXv0wV&28Wi;;a4NCm!9uK<>d;ceLY~r9{iz^381`(H`(PkUpFrZ=r1P8JrwOkd zn{&YK_lgQ6D379k9^1`$B>=&p$znGJNOYcZ`LVa_MX;ySQc%yDg#luG{-gU5G-(Q2pnq1mZA$NxfUQrm6? z|Mz78J2`ZA3dULEGnf*)Sha3lLY!*GJdnwYd=E0;&zJ)6(mE7`7j$^Szdn#T!qrWU3XB`IAg0PI;X8JnX5rk;24pC()y*9fuW%R5+nNR0N`* zQ&_6NKxelyO?;FIVbr^sr5=O77O^&s;U&Vy^Wmw_FNpU7Gwykw(tP{-cL}calW?@= zC8N0%=dbpuB(D}Q5~hWr{F@h(t`jfa6J>m zxU^DxDMFwAJ*-<{6u;5+J^>C+KQqQ7GqVA>{ZmcG@M?I)h8hKc<|MROQ+bs+;WN)v zznbs2H1JCpiK=`SXDUn;s`0aD+7<$F=qi>NW?FX^#P%jaf6o1i=;?P_b3(N}VxVU_ zY>gBJ_~v4M3Z{|=hS4e#GdRYNT*+Cu9-!Ic>l~#9-)CE5I{^XB>6gu{es_8J?|&YJ zon{39t2ytDcORJk;y}*z($Cis0TMbf2&J6=So)VjtPUNx-Q~47<#e(2V((cK>u!^Ei zriV}KB+Z#6sKqQ*=)3XRCOZ|LYCRcZi2;{ed>x9g82W7`iZlI@6=CS52?_WoCzXXV zl7*IwNj^hkrUZ1R5HUv=YtlqwXor0T7IjsQrF8V}#faRtNNi?`3AS@?ReU*ZluL@x zYW*BB424rCFiHH=<4R4LIPx+mo-xKqLUpRDLt;2n9H}ZRCn};Ia9+3H&4I4~;Iw$O zgnf!tJ`B@%T4H>haVk^xYMDy)J>e!s5}e}bJ@_av-1|O`iP{vt&MP`h0}r}|4Ck{` z=AsT&WKlYCsQj+vToDlIO(?x$a{j(q+p^m|djE&6ca@Xc%`)ywCHq-3PM`o!K(N2m z^{O-unT{(+{^L52{)W9UY4J}tde?2Nf8o!d1jG75Tq3R#H)ukHaZdd(5n_*Sno|uG zyj(5n%1>_uXnq|Qv1c}MxbMsshECh>LhXbt$6y%~6CBE;g2WB)C<_Q_-vx+pLa7eC ztANQ{VNI(PrZMswG+P@}(&2!G8F5`be=OOPvuPx7ux$C8Zj}K9+t!!0%GBfk`h93B zA6vARmR_rHDg|zCSu4n%Ns=Leo2=`q-xJObL89y9w~e2(}lHTJ<1d?4RC)BvCv*k zVi~XQa{0kWyR84=kcorR53sWDTjdvehvasL{T3LElUPkLO?)>L7}ZzOv`7nF63#db zh>s>&mWZ&}odg$FmQ@Qxc?i|872nRr!AoK>A)$C9q66t3E~&VD!(LN({!~G{NF>lurxp)=nbyC}s1p>bHvUM$|UYEonbQG~L07D%jR zLcau@jbKk%T9qx;>{XG3+x?f@f`tr$H2Rj3B{RvryLnB4tIf;;uW}M$c8)tk%DE1Z z!-eA3$@JvC1U!fIJJ2k209Q6l!1A_hh%uhyoe7{6=u?> ztws{3rbdz}ghlh>CR+pCxun(ma{Xv;{{8uD2Sl5LZxkkQXX^t!x!q7H+!J9nuc{-x)RSmVe%O}_&1=Ks#SFG6)p&G+jg$;C-er(s^&I0t|Ki@}ec zY=6Zwt214paEohOCqKvGI;l}A|Xp8420@C zgl`m$h73MEvRuM5Xm{tl+vY<}wK-0SrTcQki#jmp^_kAmZyR9Z~2p?gmonBH;$$1yvy8VYeMFdUYya^DnRGM$}Y%_I@~ zvUZdmETkL%ueBKM-voX~M-2X}V4c70^rPXU{xW;Qk&Sr2e~S(`*7B0DFBvjiLP;zs z9S9Z6#CWUPvbi$^!r6Eip#Tl<{_e=K@LfU7-OCmtxekTz*!VQJoc{XnW8d7XY{j#@ z0|?ObFy&joR&CS(D||1aK+-Mt4ToL_xcadt?Ew4#=P={aosUMg-uWlao&0 zUu>-MYN&UeF!qJCUnivCNU1QOX5+y>X)AXE_WqgP(9kuSXk#&#$+$1}OC#zyuFWe{ zZi5cKd?~dF_9mboLZwgW6SEQ$W88mWN_PRX%L2|LL8ncVIJ#VQA&WD+40wSf8K+J6 za9H8x?xML3dz=#Hts)npdkUavD>KEGR1;ZQ1*An-yJqpE;%r%f2>NT4Ytz^co_M+O zMbN|KsPzB#Z&u#ZR&nzKiR0dEAgyp8LoC_K8p(O_wH%$B-Pi!|%LsrO4ZUmTVnsMgA~mjQaezU%+YS?y;0K;RTL_>jLpedF(y=Yzu;Ptjt_}cVfkPj}(|Adx1IMjheOz(9_;+kWbJ(zoknz!$? zGgLLfY;f(CRBKXabTuv!>)wJoZJYqE?yc^@f%KWU2jl`KJ%&G3gix@?=_w!Fl%%x9 zK8pNKI$P*5DPIsWQdde+&)rAlw89tEh6mC8AK-NWT=m>6hrkB!kbOZ!>O9mq{nVlv zLjTpZqdoGhEj8Y<PAYfF%j7~WgY~2Sy0UZd349XQbh=}nj=?lykpMq@{qEel8Xqr`+WLa? zYe~Vtf&)n~Z*e#(y$}!r00savL_jkD01svO)c-ypN;frAqgzd2hFC0)jN(Xff|AFU z#^7hIGbFus?VI)2dfy!1e}nP>05U{aBmjVGaI%?ZYR%@8?P+rOnfPJ&p-H1glAGC} zky0qU(*wV>&BLSC@*kk0%Ax;#OBBk9@6^o3<&_u3_uYX0NuNH?{~lLZoS>4Z#LU)*=(EJmj5jyBW@esNT3)K zESO2a@JYhn1`H%(#E?KfgFZso|D#c7vL2JJ6_7<_?IdBcTH<3?lSsul0O3CqD#GEI2dB@)C@3qPxp zMo8747Kh;b#{7qw3zV?4@(exCGmgvki-@MUJXnb6eCP=5s7GvSl!wCks6u<1BtelP zmjTi7fe~>U)uCgYWlXF(Mm8ck7B@0k#2F2aj?0KN=4LA!v_)+x{_0{!E_HH$<1Bm5 z#b=7v9-tClmMkFJcz-si2*}dk#n6qzYKfEIP>JlcBK5LT`9Z3ZRy|;*Nqs&J03TUL zP+q$FM16fb)p_xCQD{FYojuL98Z`Do_R0yw%G1tPh4Rc>hz}xaN2S?XTU%NoQ5*Rr zOEyuPOFhwxI@u#Ww8IdP8WY1*E@R&sjxdRf6$x%kFjV36yyc+6F_ex@miKut6q6Oq z8Mf&9Yv|^Z97oI@oBNTF_-5jX9AeU;G(yiE;(oY2oPm-#rYus)GAEqIG2nP?U=w@U6w%9#1Cj2Wf3urq9lLSM{!c8n7QBfoNR;xo@*Y zjU5GS5(4!BkRPI3*>P?Xbf1f6kRp)__K3`^`BoEC>%n}*mpECi3J!F(Og ziufb$(UgcSK~kBGHMetH#B>&NE)+MTtvtTtWw+9sRc%_$ec6Tp3~4`Yy=ewNU9OlM zdlk(dPT+0^xF^GJMp6HxCjupM2T_xleJzjn#dE zGz1B3@Jk{qAi@Xy* zJ{>!#V{^^4uuz!KXy)SW?CxU@XxtG+_xh~!9=wI49`?`H$@7RQ3(2Nwg|6HcQ9Ra3 z_E5}x2Jf<3kV2998H@ikrLk9+9XA#Z)z3!(*92?DVl89Uvr&Mb>8|DfT%l>L4v-I` z-8!%P1-XI;kEqvmzQzm_rlR9ZzNKzDS(=8J`BapV`burUV_hZoDayUBI%=BIIyg`g z=c~PZ)u3ZT1}`9)WNcr*VUOx_pp8XZl;ua?I03jBC8rFa&D!XvsTV2X zd$pxbr^Z!Y%ZM5>GUt@i?3stDdp?R1QA-PdWZz_cDA+N3zaD86WL5h*@*v z)UqQc%X#Hv)`{cK;%6N3uCIK7kK=tJ1(qHS?ujOYzgx0wM&SAQrG0|_<+Fc>Cwj4c z(EZ`v+U|dr2?b|ptuz$hgJ{OfAja+6$u^Q5W8_fqragUb>25vd~ra{0P z&*QrQ72Vpj(*Yh#m_X#T!g>R!4NOLj2w~vmUSxOJb-_X=+#EML(!`$e{%A&e7~cQD#54-1dwE~wt}b9)eVwxq3@q}tn+U6Ouh)#bh#n33II(odCQZ7p=fw6&!2EBoX%&iX(HTW(bL`0|IRSdg;PGA_j#9{q=X|2dnC&Hv;HU{8rn_^Ai~>Glmrq5 zl>0@19e_(u%w{P z^*XDA6mOss5T)To`y7(I5)42b2yWa-?!LZLtrrWN?s5TKHgv**xLU0vZoq)?Rn_hd z7tbtqjO@Jd50NGy#B*W|So#bk=q762cT$Wa#_2km^i_-u9cDiN0`HqZsBBuIHp)#m zXD6x^Ayg0UOs#N0M)QCwNj-u?rMYdD=9>6uK>IHpxCkb2|96OM*#cw+Rx`qzsYLJX zhTEgc@M9Q#2S9SjO3A7y59;MiwryX*h4VPtKNrA1vHFsP62^OqU46bqh%Spv(I^a@o|J!PL4Rw_ zBmCBFFOs!JbnHy~wGU)%;cX4V)Ddq-f}l@*D3sCu73#mcdbHM z>5ucMmsni^-Fz5lcw;|pUq}$rbSTzLjA7U6OLy74LVedXjv>PqA4A_P%+I$!shsGZKjlzHAz{gUrQpm#jnMLeN{WajY~>k z=gS&$r6|2OEdX37*&DESp2|HGOUyN<)aHZE>QEANhEbqHJ0?{ya@g3bRi9p-idbCH z+hLrOG&cb!kWVDQYSHh;HDQ`rbD=?`ej7FFRBcP_r7e2`0~*L`Ws;C#UJUEPnky) z`r-J?c|dwhMG&1JY4aU;(NrJT(;TH)F?%eCf5(Ol{*JZQ+;(Q1C zBw4%HY{8K`2$Sz{6XEYB7L~&imy-Q7i#m_I`B6u|azQVI4yQPvPc2GLHZy>6YrBlT z1(h_@fL>4PC5iT^2#R+F)7W<=#g6a*Ct!-dU6x9wQUKD9RZBJdEU)3K8v|6Ou=1*M z{~9F2ASZ@e(72|kdIIM90QTS52vXgj;)wVzp=wah22OK|HPP30LU1l7T~qS2@|43y zvSVA`fb7!_#Kq|sLZY~PR7IMe*)m(Up<^mp^WaPjs}sMMZ^#yHvz63q;+OFKYK}UD zc~9M{^NzoFE}2g&=&}V^;1{?|jB?ta>KT~d@zd}KWC|91C}dPpPOTl8jPUuc;~{M& z3ldhvydyt~1-yQ5`<~*dysNZ@ab0kCvD0~vB}8UH1|pMTP%TErb5rN$Wht#0IY)9x zsD>}Kh%V4%pZb?jJTc@9<=i%uLK@Hj3-<;rt?5z0o$XQ-Y4>T%4%tHN0o>sp#zW2n zI(FEr-(p+&eA7T;j%7`MXyA7iI}dayy>jpF6!6hYYYGhuUsOPZzViYtMlc{#*1^vQ z515|9k&9?~S;#nEC{ddo*p2B%fJD)m-B%)3_Mo@h?~ITsyHQRr34vzuvtDi0t-*{; zgGJ4lr8F4Fd!`Oe7Ss{|itZ?4DBSgvG`xR064>o(KH%b(fh+tD>id&0u54Oo8jiYqOH!s#3a|*TTvA4>7V? zv%D-a1cJ$74svh|7n#KnN1AE=Bo2-R<+u?>34D8Sw`W5~nvQb0#=Io26YZe;@!v%8 z^?t|*7D5F9*)b6uo@$5GF$w8`Kq&4*VF6A@=7VF=3+eCz>~5Kg;55(npkYjnv+c0@ z@9SD`L)G+*Z}h9)s>N|iAiE`yo}4GBUza#=eJwZ|un$8w&EfhODT?r&4 znvT}(9p@}Zs8a7s!kp-~-K^Bzrgj>af=Xkp#Z^i5N>y zyPiLJa5senl1gvFDAbiFQ(B;lu53(oWU+D1VxCO`NzIh)#)tLaUfgBZA}C|fl9+N^ zfuh&~v@-#&iT#|xVk5A*N7Ih5Oq7Ah9dXu&Wv)8!-!ZiS9jryM!8&-&_P#NlfklRX z=1P8jz<-=DK{(yx_b0G;@UlYHL3a1E8Z~sUh{RX_r4EmW`8F7sW7T=&9C@H|H4i%} zAc^0O;8uKJBz}9f)ATN{dly>>xP0X~ijNr1Hj&khj){th ziO7v(#y7Gae(NBFT}1TN$}1DB^aFsV2Xjs#>LPo2(h0=vj#c2I@m+J61`if$=@ngM zvus@lOCJEVSb*kk2vHKe4dY&@^YWHUSlXqVu$~1a_v*-)L#JLjlQRUxgDbP=vxRzh ziDML<1ZJW+7pnf+L+=dVfKi=zHYrA(t{ztc(M8O*`&Q(<-zOY&{MSxxsXp8@BoU3P zlnn>k0D?ebAOx1m%$#wS(=@Ic-*7c(X@pym2?8cQh*j#)|MssrmLq;2CdsrzDg zgbj(}$#7-kY**7o&5OZt>(_r4rS#YG<(S3xzTZlw_Z5M!QYdiW3wjqM_KR_A4-I`@ zt1U01wbeRyR-Wxwh!60G0zMWQLQcyR43V(o;VoE+qcDlh)l)B0{Jby}m{N7Ch}WM5->mT+Sqk35oN5rIR(XYe_lCCDLyoaARjG2Q<-6O)wbcv{_sB^!Zji) z+Z&~v>i(R{zR6^V)C+bhL} z4N%|1ns7a0-!}yi^Gg~EZtG{dYx-^N>by}DRc?o0`efd@NifA_aY`a=0d0VSXpNCs zX3G_6&f3z?Ub_w4mfs-<4A)>IEcJ)dUJF=6rr@AvOo}oH1!}A01%Oyol{8`6Bh{h= zU>@_+07QA~8qL>2ybf1JB2M5Qyb=%Ie9b`2lPHsx?Ny#u=1W-JI;^lB7*`2vHj^%e z-|pG_jN7*Uq$wlY$y3Oiyct6FrNG&Bg3pbLAS-Z4GGaQySW4techLi+z z-g>vZpuJv_5dGtyuuh~^t1)6U<8>(hC~dhU&&NO7-Jvb{o=9HVCZ>S7nn^$f9NBXz z4!F7TElD%mO2584)%g9T0bPvxnVUKA*IJ8MQam$0wh|>XsljF5pt|PHfYWgJ!d;7o z((@p>_HpkjZt@&haP z4a%$4E02--$aI#z4Ezq!k87nJ42+5Y5@tiecZ96NRy6Py%La8MkYzi%pD8ZZvWC7z z)FN0L7@mcBQ-qOY&ZNZ#j%3qd8s}TtgK*7RiWl~l&v%&XHL~f`x3KW}zbu^s%+^$u zf`g44OdBy!AS-(p2z^So?adG&-Fe6SNEUv$??8SF6!jDc6Y#9xwM-RZ zk^ney@Ro%|seRQDt#^#S_)C!IvAN~!-oUsZ1cqX1EP^dY zoEZiq+d7M5u5mNS80omh){-pPm>rPD!v9`u@$^y={Hy(cf;@7hMA%q#=DH5PYh+7N z#oOI3A|k;4RYwgHwIRFyJI8w*xphe*Fj zlkD1Sp$+I~!Xlz0${2nclG#|Mz?DMU&^@l1&jjBZcnD7QNNQG>tUI(&af(|KcGh4P zjUzETNFo2fTKPP+&-pg=S<-YR6z~{~c;^XoowY#GSjz8!4bD^om2}q~?)?xYUyS!W z%P}7^3@-x3H#25-46%3-^gGz_bjB2dChuba-|=bR=u*4b6ncbl>OhrKCR@|p z--BFX<;WVeK=UZRSsQW}c=BE~&AJa>)zM!XWOFzEhH3PM!(v4XxU{+WwsfURud5ZK zC=3=0(vnHNYd%P|i6CE4s$B*3RaP?L{A>OzSJz06Q-yawZ6rON{udyz7=9E}dWQBd z07L--2x(QUQdwg4&3lx&@T8Uc6F#q{3daBHUzB2b%w(S1uowjN7_U4q;U@+-b|j|& z?XeV4Ddbo*dGah`6m+O|OzKzEKx$#k7_-B4&;$z>%0~rBf{a26MpfJVR;F#UD*$5S z%YH8Nde+UI7l&UltqVBBbdu+q8FWhyqrT5{D>HEP8thB7>TIFw3+@J9AIi;~w>OA8ce8@f z+ziTLF%7|Yg4aOOgn^J(zC00L{0KN$^9eRy6d!2k8BRCY~?`W*oL$VF-?!@Jn~)iMEwW}Tw-5^?NDiP5-dh5ym} z&MIrFts=z%4{K1YPm>#=R^512Yx81x`)Wt<9s8Oy>*2=U-;$QZ)!YM|0FWTmBX`&g z%aDsn-oYI+g;gnRE5klWsi|VK&Pj*aKFvb z+=MwMOHl~Hg+6FO1E}VO2m-e}4-3)4N}z+zh+q&y3)iAK?h&%Y0Rjv7(GqKBEGwDF zbI_|SlOUK6M*TsHfFX@Xb4NeB=Jy`^h&ISnz{P+o z1ONu+^P_m|<#$`#PDQK7vsg^OtiEFX1SuAIN^KZgv45GgR~Q2Qq}}D&!dN_O@Mg<5Nzt0E(1``M?NCWb9omL;Hs<&sgnMtuok` zQ#l687TKcoS_Ld94P$UeT-YLB#W@KOU@oPz$kVSD*mjZvK+A<}02eHsL}{o$SmBJ1 zs#oOue#D}rcWAjBTxPP+!-e&c)1lM|EA~r7$!|vi7fp@m$=RE1nhHB|QZSb51$Kl8dnEP|F#tld5h6&XA*4zQsFm|s+!SltONB6nyO3wmOQ*Y2 z?YF*ilKe>eog)a`l@zMo{0w$6I5X5hq#v;ne!YxGiH}=dJ5({7Rm{(@)U87Qyph%u zYsCg4fdH@qj-(K`Fv2xpMq7%M3&I`X+TQ!xkkX8PKpy^aL5_u$E!m1QT2Sn!wo)I4 z_X{MfFgaDNP0$3ua3-)Fai22dDs#o9L%c&tT$9)l1(mIYmhS`Vd&QyHPwsx@!9eNE z7@dGjewd!MD2>yg&d{e!>`DTaEpe`_Lx=m)P`5!ZE+7F)u`Z&96~SybUQEH-s7-c* zwa9r|97YtQScssbKPlC={BmucL#9v&x+9g|HlziRL$W2Bu|()y;JCf6ttVB<42OV# z#s4-=2naV8DP1`&i`GxJ+ud+2R#ZYpWZ>5p=X(i_#{=Kf|KM zqP4Pg7Cz{V4-fv)LP}}SS@4V-OdzKZIt1wOcR~xeKL{mmnvE<*g%Z)MJU&9_ytuV| zWwNWV6SRyrp09}y|LyP%TEU0aWx4jDB6Jq{!M@Qrj4kKP2WndgAfP?>+t+PH0o(7V zmo#ml07ZDKXm8c>2hNV(r_2rXPF}p!ysQLIu@&F@3X^*TH~^|3UjX_cLCKi}N|wUv zO|Sq+W~COEXw&+l$ucmBtWK`72%*!?S3#ImXDXpSxBwCZIvGk%O~u^~TEAd!nkZto z2p=&P2=;pCp+F54oCo)Fg>2_u`GX3bFq1bD``w~COs z?ITT6x(UEwCa_qrKM=LEU_@dd>6ukTF>e}ShQe)6OhYstc%b%h!f>1q-$71Hl&A!P z!xwxZJp^Sjo+_Tt_kM|+kfw$)SxhDsF0Ytg?TV``Xp#U0Mv9$>_Pk(A40$NK0j^v0a|KArc+Oj zI)7VlSf00Ab<)o6v9&6Zvf|w(>R%PTO@VrBJw`=Jnn{~~SivJk?0ZAi!jF98BM=<7 zk0qnuUm3{HSwwRcc6nRZhL}Vwnl;-5D$$tLui3`YVt&VOT9GtUa~y0XZ4yo<$t`va zc7FWvUPAP_3VA_H++NY)#CBR4UnBxNny5J@$bx#UGx?D0@yp3F07JU)JTfr3+7UxP zx?x>ZKb?Oq-~OcUqe3@XD{`5`8&$tS_UyNQ$3(eRJO!|1@R`bQ{2R|CE*Nr6@o7+Ud+;L?_$>bHje_a*in_;q4-e z)IO$+xH5BFR6B@PgPX+BTxDZ`6{W*AlYcajHB|}uM6DWMF}KGX&(-knec(vY?Lpy_ z1weT!1nn(1w_*k*3!MnPRA32~*O14$q7;WiuvysC`Y2$@%NruP2Es z^4u5mCCsx3CZGh5TTg4j_!hIW$px*2tb6CNXx7nI0Z#t<^{FuFRv{?yon>nv-4L9$ zXtm&U`4^m@fJy+o?+_3J00aO-L_i||0B>bdmG)IzuCr=TLyf_;w_bRaw}C$ZE0QIx z4ZN##QJ|9_cFCjz(%(1y_h6)|07QlWiVOgI4fD>WIZn=O^U2P9hVoKLPUj38!LpOL zak(=J)Dje+;M5eG0s*QL?X{;K{LIjIw^K?AR5Wk&1g20>%`J9pxQ|AFqEIm+c4F6k zttk{#uq{1VDO*2&vM}cWfY1QZ%m5hQ75l!s@3*_RySt_JvTmE*-AT3`k6&^v=}C%n za7!G+F>fPG6K!IVJ&wGIESQ);0t5&U0%$LWya;|ozX(9QK=A@06%*lCe`}QGGn_<> z&l>?1C72hD@tI7VID!-jA%r>M5)p{fupLWjI#fE5)67I6SW==RoWiIpQ7Q)-p&Kte zGv%uoLI_dav(E6l|yJi2#FK`KSCuP0sv(wp^*~{KmgnVYU4+m&!TNT z^|$w~&P;sKc88FllFXUD{u+-OS3h!^){U?+is}(3u`{0X_r!59g6A?1>Q| zilxuvMHVp@AVM@45QTl7RtoPH1?QA5)fc~QBX-Dkz8KkCOOpyEzE>_ zL+Io_K>`sD^Nk3k^m0<09_AQPa#nDI(d*rZ>iOZJYqY^rsyVQ8uVzmxu0r1ul?Dn+ zsJK4=p1B82I2WT?-N9-ulZS9?!TG)JeOt8?r{% z2Gg7qv?|6M&w3e~Hu%q{RafOwO5bW#^9syqYUiN?bX#%{iMMmc}T#uIzu3oDvhn;TZG{8V`RokU4*$F8x>a&JSvP|bhp8z|E z^+WgN_P=R<_+p>JR2*1NHe{o;-e=$??sJYX@?iEoKU8yhQqiYzvM3-k)fGh9k`$E+|F2rhQM?y1B^GwppcNIf`SrEM5mB3d}UE0$2v#K>GL`G_W=0^&Y*!t zA7KLJDyyIbKY9wrn9}6AfjEXm@K;4*=?(TNo-W})q)b@d==cHm1*MdxyKjK0LT@K} zWCe7m)8hAs>WNB78hMOp?D%3+@+zn2@`&SS^8yCI2HRUZ7)lMza-d4B%)tbG%?)<5lt)<7fG6lWD;gpZ$b6LlTvNSsUzv1 z;Ppnxas{wjnxh;c=9loU2ZjnTh=~BM+o4@4#N6k#1|yo^Z7qFDX05^tP-y{9=irzS z&x=At91v@fRzr4Q{6Iy)X){j~$sz@@4uIn4EdE%*)sX}oVyDl@F)35n2zh0cDAcD? z)tGw`*~`Wb4tm&_J{j${b|#^2jTX85}jsbG$Uhkqsj=*Q2Q>|G5Wgx{?T; zaOMUA-2|R9PULA23%1F6@q%ulNEhjtETM*Bvf!~2rVqd{QGpdcN6$!kXTmELa*lK` zgbh{n=|6j~fzZn<39W3l?W?l|rS6vAEqwJBAmv9ZW z6+GF~>ME$=^(6EAj;jysZIrdJDpbw1Hzy=aL^}eGHA%Wp27C1itbTHC57ynGySmPE z?G%S6BJ!NhByHy|>@}(TFumo}8BLaPKt?`RAo_P-ii}iqy=Px1qeO zYLYQxX4^;gL%_p$=k%76qoV2j*UM-fhGke6h>C?RIlRzLoV2Ykjk#Vs7lKE*5!CwE4y<9d*)~kmscxV%j4rWS zmOQQ(j8uunlUT=@#_as0MJ%bVzgC4)Q5Nc>z9HUvgH8x(e$@3fK^gv+8dS zN{-024WR1ob{FYC;<5LSEp3)5IMA!3^IvUATn5`;HvXL~wV6c+=QO(V^krk!Hg$lp ziO$PrVoAxygC5-B#QOYnFWyQ;24+uwe+Q#L?ErCk{oR6f6g=D+AX!gm7o+`gD#W>J z$+F!0;n|4cu?}F5xRq(W&xi4`&aqdODB5za_HUJnP=)Lfwk26&<*UStAU|;FYl2`o zrYlNXde9Kc5Eo?1q)jh`4La(nYXvZ7NDJin0wuc3W+zm+-YNU)xYTJ6w<()mf$>o- z8Q&%ToDbtlGuslDsNhR0KAnVhX0?L7;Y_~MsGdfa=7f^W4&p}tRDr?^yB0kumGDnU zp$laiG@Q1(s0t4mVAP${OH;6P`%)xvn|s=Dmyu`H(7d2dqjfoPd|EV?;(w3_;Vx>at3j2jp0TW)vcF3>w5Q17LovQY!nW1`fqCDM zuB0<>?bh|b(sUd_jOd6d$uk*DM@7h;$Qts!`^yY1liG*q`^=KJSE-go0AOeMqEVKn z6lP6WE&dH~#xP4A*3^i{v&protLr$WNY>{l&dbM@DlOA~PlnG1!;RnGhFD zKNH(8|5y6s*V(8{U!>OhB)Y925e2BfWBt*->aUFmo>2Xwe~fjWoQSm+1wpdZ$xkCU zHWpBY9EMd@6;;SuSITOK3#$4Qq`dT&W{VT%ZA0k8YJTLoT}?G$F?D!82&mRdmHdi7 zHo`Mkp(~IyH*#eQfW9RKFLz3Ehb0P}Be6aU=oD*FRwUd@*`8f}`~i&ba!mX7!%X<} z^aNU(r#7XZ;X3ya`>L=gzu#7H%9xLc6D{j zp|5V54Y#FMQ6qiX;WqKiPoxbw`CUO1jvT0VYmkMpNKeREAgU>C6hel(s#TPfv$0iG zlqz>;tE(z1W28@{tv^xLGUSts`Bl*<>diWAJ54c(nV0v={%44s3_6gV?%orBVLpK< zWBF9gx6nR&R;lKQ)SwI-OXh?KPzUzjldErjGLX~zRQ^3(klh)!F9gYBD00{mhd9dB zLV-p@VPqoQ_Bnrcc*iu2Yhj2_T>XvPzhUDo=`8f)-SVT3zS({eCV}j#%6a}@RVuTH ztM-o>FC`CdCXO_3u+L>u9r6`oGVL}q#FCVidEfegV+%9wscIc2E?5vMSI@Mb~8cA+Sz zeX?QzS3%smMz1&;0HVx{KUkPDCq*nP@t3#5vnWR@+EgL#`?MZ-<5@cO>8c+Xhm$ zuPU-bO5Rghs+ptSfg`M$v6x0?kSY?VqIpQMJgA_8rgb^&7k!FEPPIlM*8Lk(%o4tA z?ywiwrhR#P=gm+_%;3$|he4<&#PnNZ*a!a=Ou6Opnx7-Aw;|Yq)03b!jDi*P^XS62 z$d@XOT{cR4yQ3Hw6iO%QZ_rX`_v=yZwG7?~Qf0n(ob;%QVk$RlX{{LRY%4zbXI2W5 z_X6VpM`>eI$P%vBo=6M6OsxQwm`PulT5jpx<&})^xP?JnDMa)%hUFk$B~m$ft;1%* zK$T@s{8o&CO)Hp5Yit@p_&vHZiU`{8%4ec&87E=#OhsyfI9Xe;n<*T~j~=P8#3uHZ z>#!|&Xu4_`K5~tSBN}4AW&cZ-T9k^dOiiri24Ri}n^CZehMZ*fKH|Bo?t`3h$SSPu z<#=2BDm2n(qFDJsQW0{I*K9!E!A*Xu)sZnx2YOS}k&zQQ!lmGMZ(B2fs1pk*$h*v03zf7aK4BO zV-ogj!met#GMYue>zSz6$88y_Lumj@WLxuhfT>crFhnrC|tpjbpd*xoy$Xw855$JDhsTiROEgg-%I?t_CRUm=s!rV;%yr{=cnC zrtRZgbP$XY>8&VQ6~2S|QfEeF=maKo1ASz@*c!nhhcZ&~JUAS=q1Z1pdScb%%2;Oa z>pShSw@2JFy(SMRau(SQ!bv95c`7DS%zPiKdanT^_>d2fW0)=(W+$K(627n0HGx(i zI5Eh5ViP{qj!mi#XdzFz!`b#n$+_7b{0gj{Ff%y4Er!EeRTW-Q0J|bH#M!^CawGep zaUAI5ExY&;v*N~xycS4Dyx7rrdE9)fUEG-5xz4R@>vL6yOAK6)tzEB!xt>ZTXQPN9 zK}0PO#=foJ(VY*#^JL+*j3=T8Io7c653HQK+3Ar#uGTtPle zb%in11=FnVB4&7H=CgvLh6dJCo1uN6PcLO*feW9WEOMFMb-bIk0)iqQTwC5TSC1_R z<_Bjc3T9z9tQGbBD0Be7mKuJb)dW$9Ifq z?$Yi3?P?pE1Zt zLtRtzbB;L4%Rc)ld3=8CR+&r_@L3CEygx;8O9-So z8-$37K-?3D@k2kXSf;Cq8&u#~b@n zn%&m(*aOEH(~wdplmN;6lrba6OH;68JtHZU0&$N9kHx#}x6K-4d5gc_;Q)#uB=NRj zyzVcl_>zIaefF;w@W6Mcg4j^SkTt`JLbEv5ypPY4BOygLX8CPuFKiAo<1OeI&-v7S z@T5V5mJ3SLQwvuG#({0+C;6lmmdO9%9`Hu$sk%WC~weIi>?*WD?952 z>O5K4QnhvVh>htBBv^MB?1vuv2l7NKJc3uJiJ46p`e&_En{uM4*>jWKAh~Z_!``Yp zVoxMT1FOPrPI-&W48ql$YGEst&6gnu988h#9)cDuO&(mWc9A%_VH)Q~r4ph<0dnw-1h~7Y zo*q{O$+N6fq**PBX@@Q$ap_lbt^G2T3)0xGI10+qnZuIdj!TV}XTI%t2yGA`@N1U- z4Na7IY$7yWXGmK>`~TVg#Hx0T1!TgYoTtv8Xhw>UlaQh9Z%$rn4J^wx3KdRr09I{IkGpV7)NR}B`T$@L`Lxm>3!^F%+wkKk1L1H zNdjYk6)SY%(pO>tyLqKyb)WQw)q2^E*WxN7sBP~i<~@1nLXk{_0uJeVf;HC=b*{tc zt)zlBSG-q|oWzyRdHoi8V4T%EgubWWcev-k=GWHHK3Dd=;Dy97(Y~O7J$F)XNE0R`$dLmpdBPsl7DP5 zdBe}dx)_4F3-j8cJwKB8zwn(U+=+n`NtkRFioUXrhL^Zy37Gpe z7;mqQJib2%4EiO4_FfeU!RBi7`MRW(xu0mQWoXn#2j=8vLDB*AuXb{oRtg79B(fwe zQ9vkGYN}27?tD9bJj)h~dc*W-rJjic9E2H2p0iqbPrZ>i60ApSLxFW!6?2$HvYJ>I zC$)FJw#gN821+2O&8GQm)ykW-#TvYQPcB*ntS?oe!HO-9#F;qQfY_C%d+%q$&AC_M zE4_D>hhHQ-mdKA~N+UFy00!xRN@jNbcaSb^@k3p9?O-y+=&wHps6QE4iCEATNfvrJCL`G6tX`z^*^H5 zOvg2w)?R*a{Q(yv;g|C^G`9ZQd!&jYBaN2d-sRx>K*6%Hb0u!Nz7=ws{zM=nA8>#r zyX0(Izu9|rnr&&1^1xsSgr-lpiZZZf(xvV&ui*Qf^;khGEJpr61=Iy>KwYvXs!Mrw zK%ZFMytpSjZj&UfC3a?m3}l$!9_iue+@W%fUZt+1E; zo#HpXY??k)g2o*hgMo^B*Z=tj`!4v9#MKy|2qjL}5?rdC&r99N0JpvpktEX!T<$?` zc+x)gZmGv#qW!;DS$w%YAeL_GC|wVKEMUOpmm80z;yc>*S0JhyGa)un@{g|X=&9eb zS>p=I^j>q#2t)=87}r%}f;3sNKXZfiv7I;zQ%D$sPnD`!+`4p9cm96>nWW_WGI2O8 z@wm#Qm`Y@X)2Q;%U)kVECVuX7t*13=Tq*@w`#OpTArWpWmXAT}y=SXsIz*8JNpOYK za_-OF-heSEjO3B0+RAO^So}9=`CwWE4CB^=3BblXiB@p9R#7(C z$D;Ujq^!s7D0%0&tP!h6=gtuuHcf&SnskKwXY`!s+5;YTe#=>Tl&gr}B-CmBBo9W` z{U1^B4hPTtDp<(Sb{XM$04Tx=QM`3U7)uO!`miluqCZ^~P_M;ugT(rA_y@>A9Px8( zZk8^tCmr)pvarnj=`xlEWC1C7lmV|N8G#}+LWYhuPeuF4+D&5aGLczdcM5q6_Y2(5 zB}`xJ3|JK83(Q=G2hpzIJ|~}?8mas~AUm65f>tbz4oq2_f7b24>OhHLLG6eg6zhBH zib+M)!B)UNDc(UWEG>owRED1~8`PL)fIzWWC1A%AFGZM-yt}`rpr|(>bJide=ljz< z?ci{%C2d{0SP<7j`#E#8N5eYI$KIi9l7x$qHZ!$ii%^D5mIxL0Qeo25SSH?!fl#EV zXq4~AdgS$*GsQj)FhT~|_*Swn zN)>|h!r-(r$bu510lHCGeZeOz-zmpsTc&QzO{a*s2VO*^SlogNUP4|VihI2$2!&=e ze)fdzV?2SV2{cJ*g;tbq=1-}k-y;Ptj)d?x22BD7p%NU{;|`uCyVV^kuu7=fjt16U ztV!@)_)%`+;eEUFOe`!};c6bOMksVol4`te*~p@pqj7{2D96mF7hisGlEuG+4&mQE z*#VCSR?mMbR}Al${S61dEZ<@ruw!YiRdR9^i1(6X&4E}3mnmedz;~IxeM!q7vZ)KR zd5*Po?7QwB`eLT-qkSV?8c<~iUYP=Y?|_>O8M%i2rpuC*!S1Kj-(vZHe|I@gDEN1i_#_Zu}G1FYkF^mHp4z%*0=KGh4 zBc%j&0QOXdQO)t1-m0(1jHf=y-LR@Ru+f6E<>RFi_bUg(-yemJTQ(2Mc&S)AjeKM4 zkA=L5Ot;Ki+=Poxp!JaB7DFB=i@WMy-n|ePd*_rPlq~N)1zJ8oq?p^8HTw}2nonX2 zjO+pbICfG7=Ir5(2Z=e;F|MC`M7KEB7)kl^ej5*;x#f5ruB9NO+W~NhHj29E;?K7( z%!_dR&`Wa?9sdoEVJCv50LF}QO7`NnYz^G$ns6^ojkc`_$2moNFsH!xk`kAAohxy$~qrf$2&_~>6z zsNUZ#E`+$PPG09CPTMiD#rE+yDDqFE(LO}f5M+RcQcV5l_ZRuI91B*WKFCr%e-G)Z zh5zeXA^sBFz@+5h+b+N_uZQg9@CC*#d*Rf!r-;}AhPyak(n0fl9khFZBwp_>K?av} z(9yv*NiXPTdA5H%%ji61)p_Rg{AQf^&1YdY2_m;3A6oB!RC82i(T2l5sdO#JF!1{? z2r}b3>2|;T|AQ$8Xf~#XmqYNb;h321 z8E&i_%JGy^f=96=@g12|Od}|A`FPPM?$6Yh8E{@t<0N~SQ5cJOF!H@ywG~RCZc#6% zBks7t`-1Ikd%60^kINr6kHXLW*>&EL>>d1s8w{Bzd*!O@c)k-NvV*WY7M?fV_w3nt zHyR|dFSMRRr0>4UDpb#WW-{mR=#kXoLkqSrD1)Qjr+InYJNiD?=F6)A5;ibjo*BgZ z!8q{(Rkkx|>(l5tQN99}0)ethvU3)CG7P3iijSc5y}&QB35>|DQCHa9xTeRk_F<+y zpi=Hb`vkpMqF&3mv+tX_IXUz|g7D07m1KbFdIE z{SjfN`O>7i%*Q#%8p|NL=|R0kppq1kLReDxfIwTiME};2)(gcIWTBo524S zy)k)JPXXf6cyNpx8hgK~igWwAN_dEl%}+KgR2yv{m!@4fTP}>?K}UDsOT8ck8<6B^=9>U?`3dU%FwQk zYP**Zw{S2YpwGnLesFKPM|%Z2EJz3$7spmVxl}ypZ>F#&&pCH0S4U4AaHz#-HJ${+ z!}l1TbJKT9Tq|l`sDx8IR>A8*j~7IN#xdo>_P+!unKV%5=uzM-oNItiBS?Pb<{cg~ zM(y&q2M?bxZow9i-J!FA~ zla7D6rPm*AJYiI&@zh3Y1Ro4hZKWTBN2#lkXROAgDV5!*glS&Gs&$}&7U z;v5dto<|%^|31E2cO=nXhRmDbQ|lzT%R&AG99F!6H1_`c!BD6Bc!%@}v)M{Uy$*jW z>H}qtlmT%c1`!29z2Xq=4CKBSqbCSiZUXxEd^Yoz!Mhm1v1V>ur_KpN?pnB@8#nu> z&ZfVelK0)yQqSmnl%&B^E2OcP#HRPsec8&1p$G%8&VMU+5<^pRmv{J);ELpCwyd^Q zL`FbG0_*kwnICV3eq|X(*6N=xoI;O>y@93r6ogW>FHn0hd_;w{UG`)@5MZ!AU0`p= zy_SbwV&a^9#8q1LwpGi&y;4YB!l|es`e$I4&6>GWvgJF^TXLG`kec6x{aWm=9(?Q) z>|Rfb0h~UHi|M_=GoL$G`uV^V`J5jDA&4X0cZLQ6Hv;F1)^idGw606Sk1*SwP?~=N z9Ugk(U_Tp;QSJeE*Pp~GoF)Kf{0d!%2!e$dh`2+4d7|5{Bjn%L!pr}Cgy{*7u#`ix zUbHIT4%|Zbveg9-+V(j_D+>2ti66&eecm?o_vS$gM6Z9~a$3DBP4w;S)jn@8+0*Ar zoH7-yJocBEHEWXwwe;Hk}zLOA}_qY=z#y6M=C z5t1X>bW{vE?6Q|VZ)epJlojEAP^#%{2z{+X53;=dq3ITr>Hfr*mk6;b{^Q57SZzZc6V%P8~qNbM(u_#KF<4VHoVz^oa`Zno&U)HoiWl)Q} z%Z2FZtnG$OVRWRz-2sw`pXI;wycQhT6)wkR+8rpk5p?a+~O`XR6R zArFu%OrCLdonE<5-!QJgToWXj!u|lk6ohI*6Tl_HY(QIg?{C8QB@WC|E0cZ& z(Ny~W7O3L*N#zY4{sSTc{-33?CfWA4G?{8LN&f@g2!%=Xw7=!i|7KU}S=r#f#aE?XFt1O#BWN{pIxctMy zvnau5vsJ3sQI-^m1*1&`x|)|Rrd>xCTm&Sh+jtiqCK$>ORM3mKuPUm@#;@>{Yq&>` z*>@g z_?Bihzb>Gzu2g~Y$2=b#CqieJ$|-$DsI-4a5V_UQbQ7_gWv(~FFm*vw{RhQSHky9?vew`Mh11}k7mXU|;iaQoe z3*=6yAg|MD&{we~tN=`UhubxOtJaHa!A)6_Ym2Sq5OGw*AGA12f$N^U^8 zBw;SZuV1u^b`>au;8v1;j-k~FeUwRNi!#sYcS*rF7))@BBtn#Z_v#JWC|9%kQl=C?Lf-ec( zk@K+(suU7`A<2nL7G5%>^@W-iy*DxjF1|@YsUrPxm0ukHrg-DHZ&TxhK00^*)h)22 zrlR*x!*V%RPDNcShkqo$4*IpZSp+@swfdeZ{(I$~f419y_LfiLW%FvIqR|hEUHt^Z zub>Z0zHZxpo|RAHW%JfdA0NB=R%k>;$-c|sg%hXdZI*HS>pXvi{+XU^>s8;pii61i zgusQ^AV}GS9ZJBnQC0<>>;;zr_5dXNAYLR0|HJS;$!=FTaAi~s_H}YHaOLS%pC2S% z+HMs33_ictioDU$`R*bV?*RyTzmnI@eE$~?t96I<^o5CzDf)bu*bUL+XA9>iMNXYZ z@qZLZONAOJm{Za6Js**vK0C;0Jhu9q^oDqIkp_ z^JiW|>>vr0sfpOTX^Q19*Oz<&UyblNyb0_JK)H{)GPgHC zGS~M-Bdh;k!yCU%yy5vX1K#-|P2TAwcUG_YFeJPF|G_T*D~14+tV^@0<{98~jqm?| zeFu$wvbt3<{$vPpME+Zq7NRvrjaHb)7qC6@Z{{EvzRB_CPiQgF0s_&&02B}q0{{d7 zLt{WP000kVV%7dx9;16KRwG*y*JNa__Sw=FC&&hE*#$MR7xL5r@4O5Lmf-JM{`)Xe zRRAJGa76|Hvj^v$izi#&%iW!m{KEWF?@$OnocAQ>Wp0U+D05mMDC)O6H~0fo7RuDV zehRcuO5KzPHZUhB1)?f8VpH9gfr_B$9~;=<8z5;F(6Rud>@v5&g{+bRduPCu007L) z6wwg?eVcplcXxL;{x@4@<#J_~SdwYnEXl~Sh~kq5JBVa@RRsK@u1p+b1@4Af6o2CqTX;VFJa>h!~v*SDdLf2qvw;OKO>bEvMlh>!I3Y? zIEH1Edbt%b`bki<*UPVrbPD0&I7KD2E5YO(ui#}63xNta5LyLHLSM+~h&dw0>c)(X z#K%$N$}YNw25K`tG7pn|9U1BWH!c+!XpPkEO4XupqrHt8(e>`e&99b zGU`3mp{#DHoM1`~xTfE8sdevn<7CtZB%$FSCIjK2!1n1dQ^t)gbp2LVY%9`Z`^RWA z`Si@_1ke(wAIH_kkSQvnGdHeRMiJ}J&P`#q=TV;0AUR!n|MEBnf&6Fmp_2GVMGlam ze@e{M%;V7)f>}z5X_lMiK+(T&ujr{SJ4n}iP@Ui30l*yzkSayxh*SPkc8a-Z|C{LI zR=9=@x4rX!pPMub)fg?nN#`k6gd?LeZonp0#a@|^MV zj2atNc4mEESE%6^in9KN|9V?K-^9LS_MbAA30sfOz|x8}dpGz5(V```c8-pM#+N-b+=_+QQl z%I(oiYFEo!rD*c_Am^Q>&U{VMOVf53KAWn6E~-HDv_x?>i}MFpeh>0I1|)_6aZBNR zS;S+bqMXWF2q{j!QD>}jA^euya#C?h+tq6Tre({ZXExJ@Ny^QFDBtVtbs71R1$#8h z&4y=3Mdk^nEYsHiYF8O7;y%IoEZn`NU&0Y2U$9?LsEk7H>1kFIDHDkOBkIuFlXSEw-E3G z%B09+^s?s>gV;LK5v9yu^>0M8aS3EPb;SvexssEJkRtCNhH03*_2^x%pI}X@ii}*K z!HNtN;HCcri}h?73%9VgUO7q?3W_A!PS46H3MKc*X$1FIddJc-$jFNz7(^BN;9=9PnOwGIy3^ktbZ_qeN~`QsC|X)Bm1a0qtN7fsgG7&SV3ekGR-j(&C#t#N)o@NYVgCM2ixbyt=f~J_Iq8; z#Z5l9AKa81_7K<9Sp!a3np&`_y6IOt5#H~UD!K$Eg|#-{Ff`QV6|{05wt8BN#P(}N z@psy+S)-(gywH?RoAs?0uSij2)WmD#+Lbg6nV+V9Gt+N6x$hsiZVlJ;c@^}AsPLrE zdQ9L!9a%Y&nCjw>3@xjeNtDQ+l2M`lOkB=fZIUF~QD{aVBA3Hcq|14V`R24%n*Sn! zo>KXv8!@ODH;=Rm2$GCS15(fwQD;3lEy5U;_o5~D(>Sbnii(y%@;u5wgCm z!rVK;(*@raXTUEqsgA;3PrBT_<4&kH{?r$g7Ez-WG}kpc1p<>xM@nn*t7?_NC5a

    ^#l`E*A>k^q_T0wDk}E3KI5?}`*v9b0BHNn_Kh>m(UO;*(_YU=0_} z7GzZZk#;Or3_n$o>HId%pqX8(z#?l$yr#t+--fb>lHrsB5^OKjb5Js{j{56Z<|{40 zk?N?VOA@QwmKDfOCF=}MgEh=0n5>Ut#|>EeTP+blzHUz4%hfI>+Ho|f%cdu2bE}3` z4`u%Fd9n3V)~NJsk%XTx`7H7F-N`PLHXeyYh^74fg46?LDRHAzm#H*dS8#QKDm;3u z!J8{ZKC4)4Cd|1wmoQNdH-2TB4wjTP;zJH!w2qsHM8(GWUms)9;>ZH1i(R@~yz7>N|=@*1iOjx+z`SBXIhVRNYhL}ODF?aSuC zUdMjwGB6E4lFr7lJgo@fq9A#vs`0IZ=b-8)Xns{3%-cu~|@GBCU z%&?zs@%txFwZTI=?M}nC8o^2lFOejbypa(%zW_((HZ;DFHOxh$VYbZ4G-w_ypi-ZI zKd>)Sl#m?L($gckT<@BzT;9h+05Cw^)vbRq^0#q~Db zsnY2r$h3NFy)5a)Sjb6(O_2V$XTDN%lf>Lc0Aq3vbGTpPjNo%@KQU%K-iQ7eHThIm zraD}0uETmmv-#q%Fo28ZkH0gy$B|zCWKI+EH0jifSfGTpWD|K}h3pBnx$0*ACc|{A zR>MOc=a^f?<`|;Pmhs!QqEyN+Bem#*v~TFR@$)2z&10SH*S-0gn9<(=Xx!UQ%kFt~ zA(%R$OPYOrWqHrKV}#<4TmFEl(-5vEG{T&u=E1m`Z=@*$YcsxpM{#}MBl3x#-h=R) zPORTL(fMw_+#toTTLz|tyQ*mS&qCJTR2G3+n zFf@*u?pq#PKzgtn)gYpR{z#@{+QO>-;dmSe~ae$ zxnzABV-vTj<$#;PBqz`64MiWV8Xp9SQd%usJoE=@Ni1{181l;Y#wD`NlXl0CAxAxm z0v-J-A}VqIPd{WW-S1R*PA!FSaO&5cs4}n?S&}>amJYKUw=H0S!AgisJv#YB_~@_@ z7ik090R5UJ#}-h$DSr1Q(qEJtFFy>Dg$(2=Pu(1E`j))c8TV>mCfWiTy76} z00IbUV0tX@_iT;MqpxS`R<9dcEn9!N+a~hbDJ4&2joaGUAn9nwOtt?b=zZFzJwFN8Bvq##u1p(v=Q4zZzP9wDs1(d=Q2}1D#`1FK+PxIcCW!I$ zoYQ-Qa0fl^B zjcZ;|sC2+mL-TG$Lc!Zcsnz{t=2k~s;@e?zL<<$5>5MP1{(OPhR03nFyrtqK7QeT0 z8Tg+r$u7gML~(Fh-T6-wvbwJG5iOt0Q-3h|EEfRccSj#9KNHtF<7H77hxAZAyao5~ z`cX6EWL@OWia_loPSc_kB0Yj^2npb`{_#BuHwW2eZ#zYX#$_FqDowfI)SI&em^a)O z-Qe2C`H}n*bY%Q+Q;*S+7%bJ~#aS+`OE?rVL-2cY4UOM6hpYOYz8J|xFVs`gVoEvL z<;hsw4#FaFC==sZNo2;t6J+v){{++>!ItPjNszo!NgX5pnOV3M9SI*<(VEXNfI zC!Z&g2-WF54=GNdJcp2eJ{$BL3yOFjyHRG*vAfB}wBjlt)mcS`@jGglIp}Wgz6i06 zsc9T<*s8mzeNPpGdb94Z8txLu25rx-9z6c+#eaCuW!!+4n{~J@{2%RioR5(#4``P! zmJ*D&*tisF4|m^_G@~G;1>^)qi0jRrIo=Xo6{1&Ko zvgwNTnf8QandTzZ_%?;M!{xent}H}w>&yt*h1vyQ*5?H>R7@ zXDh)e(ytEo-hO9DS1kC}E|Rl7jFYj!JE#)=o$9wAcu%&FG3ZLxZFEasm5RJBSv&d8 ztx&<(vZ4=wuBdL_pDOvU>_NO0Xq$iNMBKGpD9@!0%!2+MlM)+quF?|C9^qh zA)%qGxn|{}<%ELhdfU7d8Q8JQTQc-o`tX3UWQkgsAI{(&Zb+X5DKWM#^4^hLI-DJ{ zNW>^;y*pdePF!wjTV?A|i~26a0TET0dWsd)A+O2khs6S9@^g&j)<@&frTM`v&amMO zXOXp{(DY=!`}0TEi{7?+XA^oFW`fcgH7vBAt1xoii9ZgMm6)-v;1&RX_PG@(*+eVW zfN)tbo@)C(Ey&!#0ds&9WQ+6xt|kpi`cn+%Vb>~M5mao2D!!A*zZO#_HYHukr%;Qv z_x$_jA9UvEv4Lz58mCq!oPzfa6)$KQ9B6muIJ5YA9HjKUpr=ycT(1mj4%pKk!beeYXQCcN{K6_1_=^ zV4Js7V@p*f&c>s}U@PD;?o{xuo5r!h&hEVxs9XW%vnQuQ3_8TNTLJ;1{hERaasC|u z%MEF*%9Bv9$E>>J!9)qE5MG3(m^*N-L<`;Ki)#s^C0pQ6#)|_1~eL5S-cKJJZTH_=6%*#^+e$1@aLS{ET zk>-^^n!8nZ8I`nLjcnUb(aSLb#+k;m|Le++decn?k|;f(Fx<0St*5|lip^vI{+bGX z2o#>0L@|BMB|suA^G_cH8VLQ2Lzc3tm8_%Z1K zPC{a0yqVa|8i-oOGK+S820K=7tfVqXsVZi;dJ5~=fPvY~Lb_?Afhs2f7R1sMOZZR;Z}3>%_Dn3% zM0e4^*6^OaHq^E^3V3f%H$cIju4V5|J_|t%0D@N)WJ*1(U}b%b%-@zG;jbdv4Dd34 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

    HLWcE) zZ5DrAzF=@KKSf2BDx?zqm1QVM3W5wgySL+QlAXm4>AJ``XIe?4tyqqLgMKk5=N7n? zS_7TjUvEWSy&-O?B4y*Oh`zWD(ccx0#C%n$1p>a6NZ{z!<@9{Y4s9eE^C zlGo@ot{1+z_P%QddNYEGU0{d;R$=3i2 zyd1pUScE!gFrvi>f+scL$kAp68%5%`awl-dtOD6In=p^16HVB&!W%_KQWdnWxJOGM2Wf^X?KS#P^~RUO&? zUgf_415^bhGGI_(0ND#p&R(X?%$&W1$>ZlI35H}be(<->g`M+T;vj;)+Xq$B%0$;u zz&&jvs%7x1DV~!|mt?i?vdHad@**6bp@4RC7 z-@E_&Qc%$KQiu@jloCPx(M4{Plp+uR|4|hyq~HD%z0BrbQ~;^Yi-U^(gthNkBKyA# z*QZ=k?YZuS8yWuGmAv#9poOuW!CZ1&gjXlQr~hkOj^CR_-amxVhIwx4o(dl8CzyUcjPIo~8@DrtpVe>`V`3 z5NeF{ubtldXryC;D!mcY{{?0t0qS^K2*%m}C@^Wko|~|G`J}-mXu8lNsDD?mPAGME znHPlr`V^^GZGeIqWFo5|8^~&AF-ykMU#qSm+jKBZXw_0aI-F$aLi69RuqLjBBGl3w zHlELb5Mb?i1HY z5+gqXBV(fu0jkj`8HMRmYy`CHMO1T=Ojt(d2Qv%=&?h4v5d>_ISYtvB79waxq1i9C zq{dNNu168Sll}GKN_v`QCNyr&l5iU~&|XOf+Q_sa3th^h?2zH&+X`ukIG>~j?UMH5 z#G=$|U0A?B%MX5O@M$#SAfuVy{~{Iw21yqI4d(-gBe#RlDVvo9Qx(XGGStgCv!^`% zQy{k^20uYiRmv} zx`^yrBE`6hl^2mWFJ)RaTP$K{TX$1zal!gCOx04b)WT%m#EnIyUX!TJXu77TcIoBJ z(MVpwu~ttC{Ym^zh+CXf2QE1E{-V?6yb`7DY<|KzMft4O1F@&0vat+{mwlC~7n}MQ ziw-f2dva^#_uUS1jW3CRp;t>Lvuxa-nF9g?oO;_uGkS*ko3{(2P)D`!nqN{rLRcy86 zdfGoD3@)#BW}{Q?%e0J^ikx}xR=+tFhj&e~KlYrS9T({wl^$G@q%z$;4&&fcX`G~6 zVqdGL=N_@YwCnji+Y*sxE=OgZO3_uRDWjKn)XVwj3e^g-j>D`e>(}o=4Rd$_Z@xl&6=_`84a-+dx3t?5csIAimB{ zYquRU6+=0z>FfGnEP8?J?x@uP8)u0My4Y4%5p4~sV!0sWRcOpkeHW+Bnm?}PV;51U znq#G2#b3ob^zL0btrkt)GNe^wV6INK@&IV$10*?~?O}$l&Sjm??EwTWipD!A`oM_5 zVNlDzR0wYgDOy%(h?b#-=^g22Mhcq5s^%3r61eWZWLJVZ490B~Dt>BdH$^2213Awv2da{9&vySRH}Mi5SUei00pB_+Y8ZR zNUARp&B;EAzN8?o%vnOf{D@#o)0Gg{=6MNQ`23JC!qY}=U5LWON3!rF;jW7&>f%$1 zCMo?@=^_uZsk#It;Fxw=Nd{6wwU{7@VbvsZZ4@+`Z4wRviSa*h$-SaVl!a-`AP%y8dikPMq3`oZv9go#A?FsiDh~`Up2R#ml0;BK8^)n`#+gxl@e& z4@u4`+FL9XNn+o4E1QrFPei+td-`iJu*UJm(fc!bM@F_vIWqFtw*;^PN81CK@a>$J!eU()@B4J{PIW2+-Qwh{T z93~iPg)t`JBNK?BCSyr}gvxOAk)T26V>*ro^_I zP7sA_dSKF#Ya~g(30$&*sV-ibX3x+8lD))$(oYfTuyU^#`PB?H{X8npWaSS93@A{* zs`h}Y8OJFi26f6&q4HG%um%}e3>2%y^qz<+c4S$=lqd0l3(lPs&hS_z1Y;P2+`M%l z_{d&RdqjlSzO`P8aMv?JrO@uwz_(sF8aa!EA%sTCWTw>tWFO`?rH>`{(}D(A&izlr zu-)%KW7fP@*R?swLYAUzp7Kh~sN4)UbM<9f)uL@~@AY63x_p-4By%A7L2MSzl2~_O zBGAuyU0eEw=|hxTjiau$wT4JO1v3!)7hYN)5oKG*Z$IR=`)jn&V|o*F+IT2&=hw_d zQ@oc{;gTzDEr?)9)uj*3`5if3jaM}^N1=3yX$A}Sv@5XKz0u87X4OUWUUL!GE~x4Y zNJ#|Yh~d%WWZ%WHhuE7DCXH323A=+rH%;)ER0U?_{2zK3!C40NU)4i)pe;Hgdx?9K zwcSRx2zG0;X}-8Zx=F;OB;R4bKBkpMGety6LFyMhj5V9FVNYo_)vO&wIkae$C4_Zj zzlf(-y#Wp2_h8}lA=*eJ9B+WtU_?hj^HXWDlBho!U03a=k9qs%kCIZH#Tk*zRc2BPIecS7@?%7~toBp)^Lz zbei_*lPD?ZylA*#T}1zbpn`x1l5w=KaHDvY&dNXs@7ievm%{_aK_2gbhjf!D`gk~~ zIJyXbr4(s83*cfo^#Dz6xz`-hB~!n9<1{St|Eg1D`kfB_Yv-&M?fyUOo4Pb&)>m3L zU;lxP>UOFgOA*PZ{oOifz;+)%(W6BFe|QgfAH31-tuLPWT0#wRwcX;>nhltWKI@3h z2uRF{RN)G!)%qM4K@mXD5@_FrB4Po9Ol*StLiF&YCfwtRaYA%Kohqn{aZ%wa*Cksg zM4?T3a8uzgG=3P$+ug=#)&kJNyOX1z;*<3Ts_dvhW%>4{2Gv?k=Dd7VVGP(XVo0}U zC$gLe>r-s0dSKj^^I@!Bmm`|pH|d27YD4Q6qB|PRDR-!yxUo}*|Nl|UI}D`(yy6lpdF z$m1oi;c9}|8kUUydVm`cYL}}Bf+2cA?>ASR<3&2bNU*%G%R%2*1qbF>ByX8M?_#rm zF$o#WzHWf92y}1gNz%Y|K_+uwUX;ikRuP%U)byV#OR`HHi}>NFRccoJdNv2=j6WB` z$&F8v4LJQ>6Kbx z<^S&&CjEIMS7=Tr+1XY_ukPM2`tkPxFcODY4m#!kgar`tzD8y$zuihGd>K2!ics75 zYlhi&uUq}W0qjYfK`^hqHB^=a7k;;$TWvWRIP01LrA)ywNfg&4NHYZ`UzPFkk^!_fUri*`!8?^dQZ^2u{mE9%jWpJeE@Ha!mKb3EFee_cn)Q<0+fO82`IBFDAY;NA1Dh>ayu~Qf@2|3(MMfc8BbmW1U zkiSS38i-RlF*s^LQ94(y4ZS?QQS4I`MmsKh(;%YTw~|?dnvu-4)M?N8`W)+6bp=A} z5cgSgu(QwgExH}%)*+6f1;-%gKW^Rh+sE){{a_c%eMqUgp?BF6Qe3>t zx{BM+!dc&K9eWdOr1m-O6%ZZnaLZq20udhpc35t2{vy%rE%>$WiG(i>jA zqd$+xrCw`2$FbKTV}5_92d9Q6a%9;ftIcp~zBHLiK(@&*15MdOq*d%Hj8~)j^K<2f zYBYtEY|A&4__12*{`}Up`EA2u3b5KUs$@YsGN6sLwKEZ| zA!(ix+w6T{gAcKs{1Odj;5_HftA^t^n?y5lv@tDD`V?&w@9DF%j3XzFWd`Hg=C~8C zB@y;{NA_xg$9U-LY3i+DoZ3q>y%C2XdQ)2FCxTrDTotc4s}{RPmKIk4tok-N^VDif zkhsIt;yHf18<;Alai@89NN*eS7#rq$S<5-NA$Dx-Hd;*#w|F#bdd-)Lz3(Gt*d@xw z&R#t**+*!Y_y9Cx^_6*c7XZ8No zb@ok>d)#}Df8WDPgImK%5hxm}SXp3_i)@#$xYJer-AZR-y^KBLmU%9uady^%NcM>8 z*tR|GQc4nD6E*Saz}D7ew;sf@vNbKkNFqs(ve{4>Yy-LR*2=uT?)jeFP$o>&W1)ov zA}V5i9z1R{c274-F&5=+5Ht$Ef{3sYq5H1WqfiHefi0RGEw9CF^tsm(TC3FO+)T+u zs0n~qaMawIv_BqK4!@jIU3fto8dqEOB|NLQ(#?`xJyYm|r*^x-_h zQ>GK@wkZ@ca~a(~liTt=(~J$fNoelq?R?10093K~iy+E*DtG2qGkH$E1_N-&h9p3- z{v~i4d|4Km@t`Uz-XgK2JmYEvwEK6^cWwyboXtwYi#!_xZ}DytVuD7g-L#Lb*Ep4p zw_^9An(XhtXR;JI{W$QsUxq)bPVr^+pA1>)@eR&+#I)sYgLW91bERljm0@iWkTWH8 zbNky(zO}6~z>qYT!9gg=_Lv$&8Lo?!Gn^VNWUocM1J|2Z4VcCY7EoBMRjT;ag4--@ zclRBQm9K^nXo@V=)(be<$6$2jT1Lm9*XzRbRAJ`rv2^7!XJ{lQf{976t+x|6#XUl3 z4`ae9zg;|1^})inzKg8F|7@XD;q7tjBg9ygb(1eFwYN=)v{gGRiT)~&*Q zUQMsbHZKv+UyaAWs^4}XZ}SN;Ga@sGZ{?cfbIMFaAXG{}f zSFL^Py-uoryprgD!ThJ?EE<$^Ri<{D!yl-KtNo$kH+u$B7A|MEEjfMpw~<};Osfvo za#cQ}wGT=J?qhGaPA+gdupu4cTvrD+Su}lW#$Lq+96+_!s|d$)N|0REcdAWTmQ1!3 zZMxzO?9Gb+L?zW+(^56;f|EyPvpNdMgDLd1aFrQg%K#J%59oYX7XJQq z();vqyn&Kc{0a=*nAF}IqIrK8VB~|Bq=4}*zLph=EdluP-6Hzl% zm71!kBms~;=&2SETLo5^8g$W~og0viPY)6`w@GjpO!hEvQE^Lp zsq9Cj2@l*6Hv;5A`1zi@2L>*;CMNDN6DjazxH(STsolI!YsaGJB^wD7Bk0{z${3Eq zjTONtti_oFoXf~~zn_x=AO82#E--VZzwImSRFpHKo1u36o){>@_PP_qGE?lq>;jH(HyZlD}kTS2;bTkkeT?v z%9U>jv;a1^*kq|zF9Bftf!Ds&KNl@_agO|GmRe_SV_vmF*t13pKgmXv9GM)$QSDB= zeT5#<2cn(`KjV5bO1!*q5<$jh+ouOr@*`yP{5=p36W3dDH(cX_M%vHH&DwOq6kj=; zQ$lPPoJjIwWv#0=T%wmSEVCOL`S30zNg>}vMM>7*nAMmPTDs%eV#dD7mIx^RykpI{ zH}di~hc%MUa7&m2{DiaPl-M-r#qZWMvurlf@jT{iO3aINT}0d6YUDR0`3 z`B1SH($o(X9j!R+DCTK4?)K!%UT1Z-E)CP%9_3X8D+1u_KG!;q+uk``a`hxBPUiJX zqw%@kUaOacP%<-4aOt3a=|mYg&j=a9M%^~J`&qzl-Oezw^`~GUtyab_N6TOv-D3^sX zGtOpVtm^5$%H^cVV&F&E?Ag5p1RZNH?EsN<@#?9ZX_qt(QIpP@=1wQ zW9;>$*FUFVLWY&dicp+aIklIe$0Jk+-WE43{g8O+J;~_`NVdlg_bkQd-*GRDSq1YB#?4#a=Y1#({koRc zf$CE)7QTGze_JmeOS&OqdPs6W1Y5 z67#eqv)2wx;suO*K3&BYLS@6KQZmKK4nXx@o?a;)`jC@pjX}>Y4G6#t&h~htOvzt; z1i$v>1Ce_9A8Kc|3_q#a!Y~M+uUh>3AamIx=0n>&Bwl;X5VI!RStRgJTJYFMTwg9J zB>?;Bc)$h_!zG{zuHZ!5e+Fl_u@O8n`2cGU?Li1g6uV*(vkb_us4@(u8(J1fvEi*+Ki&PA^2 zVD_xdB33#A9an=??C>EvJLIjc8(4^l!qj6kdfd_0F~AyvHAELFlA}G6Z8?hfi5R0RI{$G3sx06?&~PV$e9nHGn>mIAlLO_oYPf_8QO%K92X7 znf)53_DTS@*^PQ3F;^@ZN+yu@$=b5uw#|q$?Qp!0UdUQKAxFC`*(%OL{jQ0>vVHkn zf(6-cEIS7HQQ4*=37s6ENrVuQ!v$l^sH@rh0p!u@$?|T2=R&vG#|3f1HU@`}q8EKv zNr!N(VUJEoJv#l$Al^Fe=<*Jd!ulMPY~E;04hRcAbkX!yi2mD|oaLFSV9n(e^W#fq zt6Gmj$qn|Nxz?^0Cv5?02CYki+NpTZ0DamNpzo?z6E*P~XmzDA8s_FEsNZ4G$!KAkYnO!jUj677M)yL?;4Ssa)5Yh)^n+#E~zbJX#Ul z;sKGxZV23Pl~H{fwfib6^>sv*J>%5%EG_092o{`46YMa*K!+YrWs4amg(@1}f2bBC z57~3+$Jvnx0stvevIGpD4Qhv>u4KjdT8M-C9W}~0C-? zhF%8K%SH1=>Wm!5+038GK*55q=z>)<0z-TMoZjJ+m_!gUr*sinv|8IH(Q+4Yzq}urV8b>vQDF0vlg@68VQXK#Hr! z21JWqR>RC%R|=^&Tss%Qj0^2sOw zyoHBmcEXXL+jjS|K_fUWY3YvxD2vP#0rLL2CrFPt5kHunpukr&Q`u+xZq#Z3`xBY@ zlEP)_V6+ucy(saMGxex~HDL;QG6$F_EyTU~Jd(q?K+|>DafRFs%9Vr{VU-2U>wqK; ziIuk`2~7)xBg|J3g4q^c%7Pp_nAOnhn)JYREv)ujIig9EA!7!T{hRdEwh=Suu z7Z3##e~9P~HclzQ^Mg!|2|7S>X+5^~U)b_|{4s83N0#*^{_fp3Hik{?oBS!?@C@nW z|FB>=r*+ERMEn9aT{nG4iCpHX#Zv+}oA?R|y2JbsU|Nu-psW_`>l3?s3JiB?j%@Qy zDx=f9sIR+SjMz2=;8al5X-r$Eql67p`pq(k zUy38*YW8`)ZnzR`c3EsSGocq-5U(rD(3F+wS`TVGTfKUJ7nitahMePH76#5+S1znc zlIf7!FA&?l`4tqV82_y%9)L9kJUUA3Eo2ObhKc6q4=mzUcb6L&eWQVUA>S&lpz@-O zM|PN7O;)cL*j5Sp=Qg4vp`y)*{{eR7cDKmARv*{M$v7gVy@kWcK5@H|-7v_WQh3D_ ze2cd{;f-bRCHlouh{_c3rYXUGMhxqhT2Nv|bT^blZ_myyux7Ved^KKa+*JiU?Qp1U zeE{6#&4gw^-6&ImV^bIO2DA40KP(3Gvr&9aAbGQ3QPI*6RCG547`7n@q>$ZY2c9u* zR)K+0bN^y}M1l*i<9oid110Ip4f9Z`_5d6Ld;p1w1QPJ}mpk_5-5`2zR3+Yo?x-$uwC}==8Lta3N7sQLNKj$|L5ivwOu-Q43 z08nN?7}LMI=*u2(6Ji+28|Ekl4Z<|k9z1JDgp-f+XWCyVDwjdaMv zVHM*kX!U@(EygPqMawMvVzJB7uHZtL3fh4r#&QYXb9u9{joU80tp}7W0!W$O=6Jn` zXB04HPPf^LR&L+oFMKBazdPW)r62C}#-ruE<(>LRi?*P2e&+f}(_Ph|3kV zoe&6pyLT^Uj7QjC-Djv!y~+T(cFZT(kP(-dM7i#0ELh=CdK=?a)aH`F#hD+2mt5*~ z8Ce!QXQSsFj9}>ssZ_hZgE-TuV#U~1g%V6eB zOiULXQCr2GbS|foCQU-&4S_v)9+lT$MZAJyHS@+Dk8mHDvJqb#~Ke)58lQ|J>V6r)^`_r_h{vY7Dn+i2zX%O zkn|Dp;b;awzEhzhHK0Uv7C17cXT4(Lopvt+20xo~(o(c+ZV3ei8C8->CO|P zi=0U!k`@Q!B==$3!*kE4_*fw4A>ytxJiuqq&F*uDE)r&FrEStU&D7&w+y&@ZY#_Z7 z;KK2@3;8<3DW5`^%z*tvD+XgjDz+QVd`a}vhvpmn-&dXqPO?W-GtGIaCw7qL8ZH}S zgiO%YJ9J&1VFu%QU8tx>BT-OA$-wD2e5%@nQ6jZ855^sI*mF6yYNcXx-O+CGr#>cG z9&8;f$+&XBW&b(BDt9@T6jMA=pWz^wN76|smv%~0k-+s$(t|3@dl1v#+0y+dd762Pd}OtBARm!pJ4N*G~$>24Mou+o%EB2p{`a}39gSYF4+4WmFySoef{M; zuFo=PIay;64UM-;t^7Q4{EwLFkBua|7VQTxA8%!Y~J zER(-}*#U1~E1Ldw@l+^i&UaD6}9x+fN6fTv>BE-w>_VtBos@b73liu_?|;^` zq<(*3_6#+(>_c_uhdHTy)DerXaeqUg0v1#9q{*?)-wW{Gfvm8fF9eiS@yOyNAPg}6 zNUa@sYj>u0+I`Wm3XE-yh6E_Q_%23f5IDy*+r zKFkW;HtCW2f~nAf5P={`ZbNDfA|I0m^fHA$BlB+LLa92#dk@B*EM3nbe1V-wS>#@6 zS-z$TAw1~pE#~3s)6yAzHEW;rM=rXgm>gxL@A0+dP;1a1C;jK>iGjz59Uz z4J|^0i40cMJuM{p&?+j7(Ez{@X9D`1O$vMC1l_ZLcT0T#r%UJa=2Tlg2|nQ@^Oj9u z(i?6MhCQFTVmo2b_vX}2cQFuIFzKE-Y40)`Bnil^`sRpgS8K65oGtKI>or5YGC9W3 z`W)W@y4O46!drhib}f3DR7d;5Ax4GF!_#46N9QXY3Hy8XIhv8@>;!_S+aF_btkCq6 zAgn&d`m4of??ll$@yNM$-$VFFJ##Xm`(7P?%0C39IBj>?HzzEHgfKKT6N$*>9xuZ} z>?WM2l;0$*b&JSg9((dNp#e+a%@LvOmPP_ zlWtQ=*gla!1K$g+DyV&w;}R{vE~wPrOdl?~p9+z!gU}1CE3Y|!pI~jqMEzPgIket2 zu8wzVm87@ji3~4Jxxx?Yhyg}vir{V)v4u8NZ7Mv{{inf3`_^{15#YMScX{qHD69QZ z1~Tj9MWuQh#br_zBM7y;M1DH(hSg8I1VyBjwg=m-6=mlUJv#K2`HUZEI)>Bm^h_lA z&4IwKpN^@*{5kZ1>dM>){nD76N5}B^tjwL25IaqnB?e`L539c8+p=_HzUN*^PRUhd z0c`Xc5!(v#)=daprWw@-Vub|&z}zaYdqi#`5^--c=YVSkJ zpwzA-O*eKf0E4T|dwN7Q`y{4svfue8kiV&~%DKx%7aS}D#3d_$tHkrE{9_7eSeS>p zMup_LoKpP50X9#rNc?$R@zKCOQ@vzu}FMIPxZ^IAnp1n z50HSTA95B=Np9Z^0}xW z2S^2T)?TndyO$mP1@g_!r5*{Vr~zM33R?Nd1u0ggV(g3cM&*&H)+ea=@JEM4a|0hq zPdf^iQ^HUo{~iBh^4(@4xcAPeU6Tzl;3OT3(u|oUpx*QLNMXE{+()^b+-rV=N%jIb zsYDYJzek6MM(1iIu~F&PIrDmytmt(!h+1saH458^r)v3^jbjuUi6p{h zN2C?Zq-2eq*j=(%YsQ*1sj-B&3^n}gjxLyNHec}EbNaq8p#jE!-L&%m-&3uC#d6bq zcf&%W)de$^$#&v7EwxdC8=X;iH`q8GH*9csy86wl5rx{Thxvd~I zec*c~_^LjgZF2<6Dv*_H)P(8*rU#_*DT9QQ)XFPML7eFF^Vd5b82wLJg7gkZF*lPZ zebgFT#j^~f=z4hJE1MaM#Hj0>$FO3C$y~|N@#*zB<|nP=x0$&6v#ch$+1?|eV!@XG z?+ZCvUci$(>Z-vKPI=zvGsSHoeo7*5NKGsk@8GaACv~_>dEJe-*JFh-MT$^AuEyST z*}$FDG9Vdsj1-J6uz>?of$MlGFkIaQG3oUzu{|YOUtLs>=S-WFBR5{8r+(?2{1ncm z+;rE`P$*Cnt&=)yWu6XzboEpMVcZWQ{Ug745klnrL2M{e@T>h1kd@c;vW^OX z@1Cmv_y|@g>%�nChNdlZ>-rn&!x)08?8hSACmyPy?-v63M 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

    {e$1(^M3BE{=Z^R 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 o2O!kv7CRTuW`DR2Jyd{fl)(UEsDr`xM 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

    1wWA4HIk&pg3 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

    <^&GAx&~(^Tg3vzo49zhTf_L-DXxG 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%0AR}63eXBw3e`zs8lU~}7PHW=LBUXtSCI>Vx=jqz zf}9R^iP?4nmD{?pPd8d8+LcHRxHm5_bvUY-rNWZ3N7bC=iL7U0pB+Aq>Z%hst%t`zL)u5x}AM`R=Dh z&N+&a3gq&oUFYJ|(p>KXXRxe+tGc`Zl@=sh_5~XPmJI2ru^F{f%y%aUg1b4-<4zScd?e;#O8M9hY~8HA^Z2R(xk* zabLJW-}fSC2((INYr|38_+i!CJ;KCFFSnZ>H*um(0gA_@55F$xaE_bzS0NOrut#(d z7gCE3NHYOi@LtfT1_iC;h7|&TITs6@Nm0K5=PV{I&dVcAToiiw?2^d}#*8vz_k0Bp zE=;YX1bF|ku*Y2$qABYxD|pF@1p(z+`1wLiFslU)=pfMC>{#pRDs*l4^IBJ)t~i0C zfX&n!5=1xe(-H+gxa92_5GbG&QZo;`09oC{8pf>-P_P^zCox3_2zJd5D?*n;YCoLp zZtIhL_S?dEzG@Xn&T`s~9khOlK?}ncTd(dxy(v9NMP{tv7%i%^01%?%`}33zN;p># zaDvwgNP_5)`PC!Sh^aEhh$81v15WiRDF?(7(z)wMZ#qL~^ZX^pWm_;<3KY2t9Ve!C zG9?i&W3A8YsP3^$bE*KR7QfWdM_rM@)m&2!e;8^8y2_yK%_T}mM15lz=i1dJeDVdk zH+T<9O=g@3)lWF()pIe@A%%|too;$`Zl`Zow`i*sEq2KHipYM(c8AlwA=BH3 zx`4CNi+WcGvjxvp+_Qt4C2R@*G}Me(blZxU-h_4II~}!%QDhlY%wOo3m9ux+SyPn0 zfK$@QcfW>w2UJ9pRrERsYMz|@jx6KYWzDh`aTkeh8Xj?Rb;BrsmSf} zl_aAiTPa(?(t0XAq>~3+foWE6?v(?Z1=*Sg-cs-re0dM-H&*MAW3JW|;Ccuba2gEc zuWR3r$GlunN+Eat-)b-eI3q)d1Z(3fuwv^<8pf6Wy$05xS%3pLGm3{9TQWebLK>lh zw2|n;T{w})aEjP4E)|*{fg2)x*t^6e z(znmb&l((3{J_fhmu*4wzrt=$MK1>pEZ708M}fm9qbO93#I+i>68OFFSa=8>SWy@4 ziUL=ddkuMt(|8cC>5E*V9*bCoLAC$&{(I&WaJJY3yR- zz2VzFinr!#*V>+`nRHpMTL(N#-z{RuEnqe(ym&T`IAFR$ zsaT}8r>Wr@8bmHHbFOWBW&#mz+N!p6cxztw)dm-LSF-}U&VB3gF2_JwYxXHUApID{ zRH%nn$QrlQGg3hhV$Sl+k_*|b>8pTxM5&Z@tBtcvbZD@LI2Brq;A4~!-iH#jV)l2D z%BU=N77VkAh6HCa5Bbv4En|S!EopnMODw3bG2CR7Mh5LWJ`i8HH8e$<f@&~L^QAIAzwzw(d%N= z5cizCQb=yQ-B4(d)JE0|-nVd<4m8Cuqe_%Hl9Cf->^d}gDk}#X+`SAHDpiCk&`mtw zybHpcUlbkn2GBTL|H{um-+;E zcfBR+xg<%e>F59{y+6K>=;``!@33HnhA_!_zJvCmNZvTDF+8k!3TF2Hr{$07695)g zoTEPgo@iVC8$;^sqR}+pwk{Xwng9`sPqXzHFOq{rH!<0}@S=z-xIjZ{89scPvdi)ithtcLR zOUjUpj^Gso6X%&%L`j1j8{u%^PdMehROn^^+ivSP7qbSO{;M~<;m@iyYNooiE_Rp` z`RGT*OU~x3N?5Jv9ko<1kpVR^-U-c|^B%A@ICT~5Tkt4VroNlMsJX}d#~0AodmGAd zVF06Y651Ff&sJ+#zamZUl({adLhCJee0$hiCG_;n}cAp z#HTpxzdkc(tyYWI6-uQ4GO&c06(4+%5!h>rprDep2nYgKDBArggWybpe+Xj^-3T@U z<+$!uhO*<;Seip4K{u_AgmKJVjRRU@=O#Ao=w)&;(+f0As_80%owp3D6#1Bn`{m3)#BYV5R7woI$f?LjYB9 z`-+@DirWL#c6y5b*0(DgWc)!_rW+dD6wM2XEg`a6W~i9Dm!gQrO~=C|_Q4hDi2j_} zdo||3%7BmQhkA-IUoaU757%laNNwnZZ9$kX)n>#nVu|Mi+n&PA^U(8{kTvGprVTE8 zOP8;g=Tht7Z7efZ>{a#a5;&IZDuM%K=Zh+%Tprii>IJ3G6h2iGN7_;%=7OjEEPz)% zFoN5U+2=W2Hlb0F2>7`r=vzo8Ygr1VADVctXED2J$`oN!a6&vWg#Us}h?U8jb6CZ= zNYw6f4GrjR5`0KEYxzSDglm&-E8CPtxi+yLe7<6-TShWzHRR41>)>#sFWBZYu7ZHM-e=r1#Nj7Ru5%>L#oaOfaBP0NPxPDe6lIl!q|u`#Z5iJ1MsB}GdZ+7wwX}6{hajc1`ZM&8_|7Li z_I?6h``<%VpoJCRLz1a>{X+Vjky?zt)L}7>Q)WZ}-TUuzNxBLFN~fe)InU8d(r3N` zKH(&p=V+i}ucToUqg866M`vl8KtN5IHpvy_VB3+wDhW)48)A6ABb({IK2V~XM z8~+pOlm7#41pJG>^zkgQqR3j@U%lW}BR@tV=f{2aNtb{i>93?D!{dv`NlJ3vz}1%k ziAOTro?s^g7v{*-i6+YRy}PRk687?O(PQhU@HVN)bOsHjj1a$pX2I-SF&Nn^c{tju zc)vbMUBk_{oxI$B1)tldk?4-x@Ppchh~;O~-e=#{XV)a~IZ=*~rWOB@26~q4nTBOr zg!|Z17;e94l=c{zi2Txp9~h8&g|w1iehYw`E_q(;i`{t=a$M2snZ$u0I$GG~kPed) z?n}J6)PT^RI0eMpNc6D@@UyvCYGg7a(|%vY)6f4#uCL_@#a|an_bx%w4!WVY`igWkq1p-;TH1vZ{T4&szR74F@zNBz*g% zXCsl?4z}6K>h2$N7XeZFYP($cYDrnQA*L6cyPYW!Cg2it>r^n;O=7k4bVc+}zt{!z zH+@Np<3>8rgopE?`u`th~5clPJ{x^XumABq*n{~ zP-keQz;BY65|bQeB~wy$Qaa3#o&NdW$(nc7_?F<`u09rMv?B=#$q6w6A9RPRFI6QQ zCeeI@{bt97XiVO}R*b!;$*E6sX6n}~1|Kc<7ry^AuX6kSP$b2pElu9m6a3-!Z!lu} zGY!3yWloAT0$KuGn2)(Kq6=`YXe5w`U9SJ8?I-xqB_U>jr6Jd}LE%7wB@ zccJs;DSKHg(ePyl(wSiIUM5t9cR)U|B4~u#!hGdpLfO!t*iO2gP1s95QBWsH!v0JfZ`NhVFTL=P zXm0+QdB*=SXW||?CD}4LY~2juKN(Byf&?uSMF`~B$)qwA-G3_y(kUsPf+H;tqeh&f zXN%wa@Pd+pAMy4&%XI#0Clum0fW+Y6B*VMtv{}lbvz>sIZJ?|R(FS_+y6SW)_kVl3l54-_=hP1IwPy{mGZi29^LV^IRO|=f zm3bM|iO{Pc1ZPS*{iUT4jRuZLNO32Ym+#{RsgAMOf2jQD-*U^ zsgvJ0%lRAGf|S2#jpw1XwX_HO6PNeSXux*48waFSz2pk~%NY3VBR}_nE@}4Podo{l zKh)l*r{vaUAIS6|vz7M|j#U2*6R{R)PZ}Wk(tkx_Zhx~+lD@XvKUP0{szTbw@{L7g zNwZQ){md89IhX-IDZwdhq` zR2$h$d0wC=Ya;uEM)lcTQ0U>u@=T^+U&>Olw05-(04|vPFbBACn1wOYkH8zsp7uEf zV^NKGq7H&xu`0U7emQvY(i{i0$#@=k{1CRW>Npefy_Z`j9*jV3lWRg#xT0<&=Uf&df-44y2cU`Di-Zh*h(%K%#&RHLu^ z&0;9pV^uA7wGk$$WDoV_&+9E)S?wT^IWBI0ZxE55C@Yw@-skrtfY;Y+Wa~FTvYHyu33L(`7DvoIAj|*& z0suxd1xEiczPsJsn3+^0Q6vDt!jrTp)Z&N?I*}`L=b*E-bjL8y++# zc1qStdZQXnhQkNiwJ&UJ>7!fqnqsiXEh7lCcyy_aNX6rTB`$G%E(Q;>y7CUQF4gu1 zGqWelouoU2X#sSL6|9oL!1ne26&7$%_C`|q1l}qJpsajyvp096xP(2c+wUHBb}0(L z-noDZg!5p9+K>nKtm1D8=PYU{k)nZ~Gx$z>?|}fBY4f6NM0V!&!I;E!`rDO`Lx14R z^;Sd5IZyQ#ZoQaZJ6D)GkMOx{0=G{!zeD73xzUwFlTL}7DVZQvZ6 z9m6(e|Bg}EX6oDe$yTSLU;}-W7iK_quBm!?0pwGrZz29rU@rNhi?@j$^>hn*00;DA z@7k|nzk8nW>@;`@d*;Yz!b@$N1le3=WjvysX?U6Pk7fSeTu_BH*b>c&mrfKP~urC zz@(2aD}-E_$vDzjq2)5I1^GbChzF5T5{u48zCla?&QYXl1lnE5lLEKYzeO}W>UtrpM?(01! z+OZ%(?|NP+1LCAULf6b6 zx!!aLy!~0cXgk^kYUG@mbO$15K2nMOR@{RD8p)Zo*MZ>m(ij3-s!^;V`DIZE3yfO( zMo`&rm3HRY|G|!PFovYaVE#*!oB?65V@0&mUWf8P)$6V&<`W{N8U>tq_Bk&$~ra97z z`SG3mqz|>|Q5Cu{wx|)I{c&iCkV^LMzd^)kbA5ei+9QvbD5Rz11s<55-B6{fq1fBd z2cJ>Rg$(ieTm=FPWAm(>?;p`FL8^g^GTZ>M#+dkY0aiV^3K_IXeD7^5He-29iM1!S>ChiQ`eo=^ZN^$y`PsN{zU8QlGx#zAyc8>iO>8 zOm|4H*Ef$Ex!AJ5)Q=5>q`3<8>)XLo20N&Ni+*{&FMRL%#vQ^E@_h`o?(E)NcQ6p^8*6gifBf#Zt`c&*;&8*h;Tgs$7gaQ5J zF)3uC4SmtNW^78h{AqZK!qjWFpkyQ`Je!d`wcOjbjV__Lj@mu5~Zb z$#wB0HqG{ib!*zT?R9_UsV(4ABGoNLu_e#8Y-Vj}Lzg7UD+SZk3J2B9wr04qUT^Rs zQa&lk&20^>8~l=v>pQqzr~9+I+BeSZ?JN;!kJ-X!&kU5lQ*lfFZ9C7xXl_7g^k9^| zl8Wv?o)w!V4|lNe-%6|Yl!pT{U(BHd8l#NuAn3{|X@$=4mKrasE0*tG#N9V%Y2WeS z7s%Q+9{w(W)047yCAAqmO~tZsYRtzE(_U;WxP2?$rBgs|@nmUUu7;!djHG@*h2oZ1 z2w=&!I9g0%Z^eB3^pp>8(t~_iTc9vLM~_hBS8|5u{B-Ym+&kpohLTl&+B2COyN=uq zk(Dxs$nt;k`Vb~f$P znV#^w{H>xaCdta9hBocq^KJgcZFave=t$P~&(?k<`fuR%_MeP|BFPm&WfqM{BNA2* zXWPoOxd!wUh2gDiZ4FVJwt z-ewFnpV}))=T!fQ$0}>}H>M+PNI`lSH9O6#mDrM4vPsgQB7%|)^6!SG_a=DCKQS1% z_@_j=*#78rI2|=gBzgO3TZ0onGksEmnv&s;tDJ39fwOT#!X)lSkVj9LUzxIAIzXK7Yc5SkGXBGGL zd_y09y(Oxd;ZjnhhEd$1-Q3&6V)?c;BSU~Bt`#oe;ZwUGLqYJc6y1bx&zZ*s+amK1 zJ8vDH8M@OH@yOhU&t>CN993Iun>Fg>(sq2PW7Qlt$SaTpw!d(*hwMy}Zb}H6@v{4C z;?#irp`yPte50Qf@uU|0f!m#5`I?4-F~6R;QZ{!I2ArLaoX#;L+>I81P)_1M$REuo z)D%=DV)zbktTB9&X#AP)vmL+lJEK{P@uvY~-Ym!Q*=j-~GaAmo^JdZ`q9p8FD9F1_ zy?AR9reAkx*OLAjj#MI^;LZ3vqXmxkMWojXn#AFVl)p5*MN16*XYFcRu9!t)>MYM& zFwwL~6ltN9X1pd|Bwv)#$-ll)#PyF#k&O1}vH5Q^#)@y->Wr17V*ngy@I`4#ptf#F zvuwkB$`FFrC@Ga}ZDxHy(5{9pomS6i#DcHfF5zc3B8}Cdkni3Ybl!fppg}3!B%Fqm z7E0IOeEmq+p&0mG9of%^5GCo zl&iSN6dA#!wvDj4qg{>j@P;Y%sTjZYVjq&E_(o>oY4~wbul4NJH26LvsK|{a;qe*A z1ASsLe{_TpVf_5nyfv?4ApGl2^0Z30e4f4@s3*{G9f`;*&Craj8S#)8S@H~}hG)UE z_=o1>{~29Za}>cRD=CqXwl&Fq>j2CrR-Pq;`R{~?KN+aU`fl$C4#rbN>EPpe+xsh} z(PS|Xq}=R$g|qaVBil-=BjS^g|CC6o^U3yTB7_C}QyWf^e>{&7$vk57-WC=p9e?RH zgAutA`VfXKNlyot&L5wp$AStUA7rr`)D|MiiZzl^^30Q7fd!xV5wJ;PdSQe$)5%++N;)^Wrfi&L4K9UHla>2C2WIM*W`A z;d@6ux81GUdJ{kVp6JIL{GnFx@Gqu2ezt2c>MxlbXJfj-2|Hy2xKfQ<~*G;IF_*uf3t@`b8%dwd>w>9UMt> zc=20e``V_dpS?tpe=0Ohl2qDU&@bAKt2p2|K67#U=GO4;_Q${I;4zDcch3VVd|b`L zEp4SA;)f}t^c-@E#W!ikJ?E1oxA$|ONz!|N9fF?wTBI)iDss1bK2QAi=g&KRuPHE$?{K=cDLV_$k0@BenG*5B?K3EGY zkc5l7q?tGDzP3wC(7N{SQ!2i>`o-&0-g%P8;L5N%eKXcWY;oDv6oYHZQZrh2Hd6e$ zbH&fOW2kkM=-NsB!jbA+9vy>d2j**K*TLM(aU$xtK=}sgEU%fF=yd-KF82hPbo1ut zld0ZCa!E}{cO?A`qPMW(T$qCd22geCaW@qzfyagYcM!U^R^iA-Vs<&MX^DJq^mo@u z1WlqZXh9?A#8*7D9ko%0hSqO&My|o9%n%-hy0gU(GtT!4?;vfzCNDK6xRPJ;$aZPV zlkjxWk&Eq`bs<~^OV7(5HM%>Cu7Jogp{3av1ZcAZHAIU=l zR{uKs2q4AiW4mlVa1P$x~Nj84Y#fc|2l0U}e%KSkrdwYVqDG>B{vK4A3+lKT3 z6mfnu;B$Fy8Q$}|O0x12Cd!u@3#%%VVkqSJzvLo7-tn1>2!zO6+kV6{TrC&pHlule z01$w#M#zgRIau$ygKpS%Gr7Im0WFt~bvE!OL^3Tn*|dyvD>hxX$PDPz*gvwye(e;DY6{ zP=7!$25A=}7cw1!3`sc=Uz|1wA`o6d6HsV_v7T*SQVDdA6{g!nv0|Olecv(STLx z+k$sfBKE|-n(@|{*A5n5px(IzQbeonSaH8Ze3uj9|ChP7%7 zVjpkcnF@V3u*D;MZ6`ge(LSf$rwkd?M5$gE?7_q`*|hT~btcfX+4V$1M>C1P^V6(O zbHu!Wfj@k%bPF8nFdY0<+fD{58K1Wm^3Iiydr7pw!6!8`rzvqE*%Jo z$L`t^euXlC@EKzi>q&6XoAytez0916+;b9_n(?MV5~t=4JhY0_(Hb5o;zrT#uG%Bm zf;AX1Ci@EJZsPj5&QLm9MFhYU?(LWR)o;7Spkj5z6t&fiA$DOe24@t526hAQkEBAc zBO!Yg?GXS@bs{*=Dus+AQ~ZaMc<&v9Q$`;6*tVN3}}Q123|e zCxP6Tfo(FcKBzBP@rQ=Wo}!Hg+VlG1D9RiyaxU)+YaZT#n?ltj)Ryi7PXwN{W5g7IIsHLdIEe}4ESN5m53togTX1$vE1sI3n+T4 zidro3#?5i_j(o*SYe!?ukhbQob@ZrL!t-@uo4}YG3s0dxjB~-SLxlWr(W#bzUBJbJ z;)Cw(wxoR&Z2yjesTM7+g1Q(VHkEj1%e*r-lT;&lsLyu?YmX#FDkj>GvxRxg(uRt2 zHmXZ-p{qd#qr-?!RUbwzud+Pr8&y^9>dms?hM1upI!5>KaJMx7On6L~_9g^H*2*bo zYCOON*+-~0sT0RCJhhnk0oHgR%?ry=<5a4~k?NpFLhBNIScM2XU~IXLxn;M<3(REG zJ*E~6$Zq>BpMS@_CQ+3VTYESlzT3iz5qx3MUG8CzsF+7S-_*8*;Ama{9~F+1-=htL zTeJDU42|f)Q7lB{9BCDP^5fW>d1wu=qhgv1iK~v)RhZPShP-`d5vc>~EUj)sMOe^O zLwpG;3q2E2!n^dW^#jb+;i0)}%oq@hHU?Yl$%>k7P~gHPximGYl;fd-hPzIGyJ3Sj zx;K}m(%1`jTcLK@PCK8qopp=68B1+=>hgX$0e&=_(C~#tsCQo?=5YU8#zEt%4>*nXRqJ zMa7mVLp3dkKshgU_EAbL*dHl0;Nr4Ln6!sgUMBWn0J%G%{)4xIx7Vmk3QwW&kr+sSeB2+!4 ze*TIOG~QQ4%}{f0V&-V*^iBCty|892kLxe4rgd7WI`kn}INv7^ZpEFL-*#|rFtnR# zGy4lV>bDIP-3&t?WsR{BvTFcA&YxJlTj_Lw(E3@UfwM0h6dK> znjA8SGufkQqfbj76JVH*`U+mGyf7a`C|yXX*CQxOYXTNgeFPUy<939S+{@W@3;>Ph zm#VK37fUp9hK%MG-y7?$@VUTwpg-T0!utGQ^B+#&wxXcK_wQf4sXq-uut3fqRF7%a zeBt%9kl^dATk%}0YStQHq5NP)RvM#sm})80x?m$@@aj(yBP}B1Ca)%{&6ZzPPcZ_N zx0p)nYT;@rC;`p<>qWooAhJ=QAH!m}D@|+3e zWWxvUzVk3=GDTQeb>w|R8WVtBO9PnY;LHa^Yf!kF)~u%j=)v!mN!L#GI0O&#USf9d zzI$zPH&b;zgDIH)(;H^js;|0ySM%Zgy`9#Xmr;$;Z7fIAD5gPeIktzs%BYL<{~;ZR z0e*dS!0?=yi1|s~737WEEObB?QzNMhz$lbtEPI)ec<^?-oYvk-he+vmEJ$$S+k}Y) zgS4it51^z?R&CnAvmtmFHVy_Wo^NU`4nSXkop3Liq#Au= z$%r*#hhUqt5oKL#vO=BpAGP0Xk530knXdIxgxGOah6at!Hd59Ko)XoFayOm7AgSs7cI(`$k&WUkCw4yNkw+uiJ zcI;N4H)f3gvkq0FY?KOUnmQn@xN0aj5;- zTd1&&Zh2og23ioJWC9LNk(3D9n(L_c!8qoN`mnd~8#x6C5A!thy;Ay2QnmhSEd6TD z4E5Y52@BSOIbD#F>t(p$1Yo^v@vX7Sv-x!8bSoY)PjlHqZP{M}S1oGq2)Y%|ez8%5 zsEZq(9vN-wW=;FA=G|sIimo(_V^UB8UwAYsmr6AgHKw|6&H%w{(^ z>wM%8&9IC-8lqkHDC-!#(I0d)OlC|)7nk!Wwk`GP?qQOkjH(;vhFvEQMk2+%xXKC1 zlgHhGS_)POJlcXuy;r9+){=@5HZjfl43O(GvVZA0_Cj3}Qx^q!7Wm`!Ox z4TbS&e+ILh`4KM2id;M1&CS6_0PVZwDLU4>%j5M4cMA-Zk@8qzky-23HHke~cYuXr zSXR|D4b5ocE%Z&3@7;3Ed_b|k8s0}m{;_XfnS$IzX_5K7%IkhE?y2|r+06Wz+xvpj z-2xPt1UAi}37er#re(XU`VYvmqd=eR+%Ej|td^K;m|=zufg{9{`Q%Y^DlFjLLq*MK zd!$P+227-(`$Y*jd~tr^*Eh@*L>~4pI?pX}pb;W$7q%%8y}wXpHq)h$(2y^~9bTH3 z;G%hC2~Zi0k3NY(&PooxGmPmuBUkox_lEK}x+akghUx;2X5D*Cp-#3nGB1`2tR^8Y zVBwN^UPEV`$S86jGkChuh47!6@bcAH?riMY9@QvrljRo0*dM-EE+tGQAVV`WdXS#0 z6S#s|n?Nx+UnGP(qa2fzw;Cpu~ zpe}(saQHr`_B-kxQ2)}h1Tl&qJiy!cS=*meY$waz zhf9^83Lhk&;eXy$66E{aU%ngL>sgfta$CHhyHZqAS&P3Qe(t$d#f<(HX+q~I^WjTG z@qWLli{HH&%mt9R0(=)RAZ?f*GVgo$Xs{A^143L8f3{bguir+Ql=)fm{~Q^+Az(Lq z9KyAnna*KugC``;PbpTkH@l{T+5jz$q8n^owHU)N6#*I*W(#uq>*#>Q0g6__N4+mL z5|&am0ZUaceaEy^5EiQlRs@3qvFwJ}qwT&6SlP$AbF@S@ouGFj{~Ltl({5%pd|OiG z+8A0O zoe0U$y&JlKQdkWXzM!SdJ#_h&4bVD@T7HJzESiMOy{oC8-r8`Xk0gtuY6`FgGlP*} zO*!cfs-|StNUtok_hX?9L{E$R7~iLB&&8eEbsZ;|-q%dbj>L?!Wi+Ar=oSn&&?2;5 z*MZli+^+-$ar|&7WHG?NRqT&T`oQ)-!0ebkJxt6UEq4g^`^CEpP#0qKA35T&Qgab@?b3o+cI1w;AD2U;SY(_8H zer2ZfEoN9M8ddgK>1BLJt#%h#W7mC{#evCK5iV^}W^|0sYmC~?^sfeplF~-T z3m{Q|LNj|^P&*xy0VuF@m$i7;USpju9wvz4YKnrxc6}b>RpM}9aSPBsp?_^lD#l!H)MbP9)|nB-2t8G{)p(^+2Yh8TgaaG>jKx(Bd$b3z z(tLxMZ6Hco<6@2dkmwpfR2S52q7T<;mU+^i+;{wELLr&$`wuq2`N>m{*oj z;ws0DaG^SF0-{Rivpd5}S=ZNHN1C+}aro;MLP===6(4GAj=+9$J_|AG+&$1LVs%M3 zrM8QHolyRD((fv9peN{8#rB*!8ZAL>%F_JEJHTb`gIMu#=Wj5`7o7bbe73{X%V1Y& z1dq{?HUrvMF)zQHR#bvLws35Tf8)jwznWe`w93qw zxIPN#P9=s)9GBkFbK(-vDTtbUIRb-}I%c*q#TuHr+1gV^c&hNW#-{Ghw50ntGswnl z0=H397JFL5{tK;JQbx}z!qCR(;PwT2x!6o{Ply8U44)kS!M?5S zYU!JwuGyki>gH}Tcy8NlXqRoIKM~l!Dk#;PzWP!cMF(fLLp5!tm zDAK>Zn!45W&!^lYDXTk;k2Zu!eMB_u=uiK(8*ffu+pe6-G4#)`^Hwa^e+CIYU&#|s z-y-zz7J2p}>Ix?s+GpB-I$4l?n%OIN)(0u^@A^^SAVwsmBDc~Xd6UKY5yx!&?vsm2 zk$D_3pAt9R=#0eo_>zJZ46b_>0DU^ddT|Ogl$TKe&P#s4LI; zY!Xca-PSK~k3njx(K^?bPGqk=G1Qw@ied#%$~ToBQvqId`Yy$(zCNne7`8Gyh|tX^es<) zGg~X~Y{NxA?}tfx^CUTOS+_bQDOq%l)u){mDpmH#TUjJ5ePxrJ_qgS@b?Vp30zX?a z$DBxhph;P!(l{wnafhw$MXy)3lq+G}84gMQ$?JavjQjStR-9mr;K_ zAd0YQ%nTenjZJdbqW|S&=|4?ulugATO*Mmf7J&P?x`7mysMTq4DDH$qaZU%NjnkiN zut(FosNVkC>4QArp!s+NqV(%us>T^S7>(BSqYc%BJ3F1rM?&<558>|hqkVP^(~*sg zo{&bC7;(~IFeToCWO@=BpI%m*tyH?6sf;3{mQt!AG>nLO*7k=f5`HIT+oKg5xjnl8 zcY9h!bTEEZBDu4krM**Jo$ip^B)L7F1PW99G#PQAn2J-ilapx58AMOBd&N<66rjv# z5tnSMZjXY-Q%nJqeYw_dL$Qg5lMScB<(@q=Y~RGP#A!1$-&5Wr9!bVS%BPVda!Awr z`OjaCkWKScj0u&6l4QcBHcPn`YeiluIV%L|EZTQw|GkigE25)idXu!3PefGwAN|{& z1TKxK97S_$W-|58pS7(Id2;e^NA+uIB3-UrdBuz4s{vvDwhR}@z7Wrvh2yK?O)o!1 zQHvS%YtbPp0$Og%P9CE6I9x6CT7}!=qyhI%w!GT@+G?4Zk=(qoT2CkOMPw;{weO>Z zE=5b!t3OxfPBQI8rMB@j`=QxX%AO_P^ z(REUP%e1vlO1aDX9|J)uH+2*a{>~#G+(MHybg!zcdr=wuwX~o;DtXWOgILM&o!7CF ztBrmc5!VuD@+eWycA`ye(e3PoO{{FC+&xPwXNj9V+tp0RKAj)A-%Mdnl5?G)PuXd2 zdGdj(M9-G2@p}I`{R{3h7#_~avcdDrr~&+JJfo3xaT;5{MI>7iQ4vvgFxJm#r?=ur zw)XEVzD!iJU9I(jcv-wizI>(!VL0i@hoQ84>4KXzYUh^^h&HL>6RcnSwi^F8Gqn-6 zo&R^ePFI#BC^RGMOOrqPuIKpQD2B6cMB4DyW}feG+W&1!G6Tp>t|_v;V*))m{RxG5)H+aZK(&a@@(vvYQm1t?U^iqGgoq4prg8Z7!BfZ$H zB)N?3+1Jf}2HiV}x0wRc>|tlW`QDTn^_x;R$Tbi1YjyconJF$sC54(Xf%>QNsv{Cx^ipVYriGCcKM;Pr`Ns^$@j%UptYkAyHu1`(mN7ia_ z+5F+-&*9fGY}~`_f#y;4abE>jAKh-DAI0$n$Y{S9J>cmN(r2?O{sj-?yn0YNsSyDq zIWg$xjBoGx<%p+i#_4ZJ#`bU1QV{2@j#sKrrsmNz#quEYiLHs>)(0K`qm(Z7l|O{w zq#%Si+%Ef4GUheVRq2q`~f@N%|~ux_<={XAN}>=bf$z5E1iq@0Y( zM|hy2l5l8Q+eTjE{gSf&-_<Dz)%5HQ{ zrp}*7)KdO2ruD<)@}dRFKH1h~+0xYvjJD@7-U-V*+NdloNQBMcRk5L<)R$~S1d9f*B@5j5u z!LlBmmYsBt3kZPz*(naJYS2Nk-NkbmORlAFPzMmAw~!YB_P=-=p$JDl(lM@_<$9Ee zGEVJYws>lMvnJZLY{mCG8q$K%Dj>WwNTdhC&AC_xQ9l`(K^+JmXS`mw@shp`5K z53cR|fNSgFcr3!$L%Imk@Aw!EkZRSOHSf|NT6Lo6Dc&$S;I2JS>wDAJ%=L}8JH;x> z*t-qbo2e$D&@@i;=$*$@jt3M+3NV_Jf+oK7J@c}xvE2Th2oxJ(T^J5FP*Z2ek>x`d zN?Tw?H|VlCspS)b*Va)0yj`&FQV_#M3>qdzD|X@wCSk@fO@M%k6_#ctm^3YfzidOE zNI#5D^+&lZY-T1p$&~li^uGB2hY`p*HPAq#VM3Lwr>Js-QQ1Tng$uH5>ZUc58%#Y_ zu2yH=)F|VA4DuZh8`ZO)8B2>9-BdFY*@lA*0_OB1pR*XJlLxayr)xC>X$bzv2|@!K z&0gRjS{nN?f_8lcQ0!9Z<#GT5m??0Il(2R^3FluPR;8#oHgtn(Ega^(tyJA^I3=`I z24_VXoerEMaF{iECs8Q->Cl2u*=6zW%bKg3fio5j2m)JUQbx|aCD50TIJ}S4o(eW< zYaIEGM{QcE33){gJ}T}6vTIV$?wL&>TT(rejEYjl8kJ;wW+PrLKw=pYDbl8Arv2}( zf*oqEfcmLQ`w8pe=T&Pw_wUW#QA1u2(a_OaL7!D!eNi^341iO2LhKMDM)j-Hjdo9Ca%daPE zl2T%;Vxt=v=~W7D>881CEy~y>7XUUDY_>2pH7l}r;IEb+FRl`@RdfM*iON$(exNpl=p+|ZR=X^#c)pQ6~$d+yW2r1IsDEwI9kO-{ga+*O- z)p3+-*-rdDFgUhb-wsaHG658jaA+V7clISI3f=F;?qeT{4G0y8)4O=9W&vUlQ2VWE163rA~E$o z#L`Uz_N0U**AWXu9 zfq^)qE;u0INSGLdEi?bx6>TLTfhFojui)=^R0KM^p@$?6hqAMO~-iLHANFXuj_UOeT+_}Q_0xR911Ogh`Ov2-U`>+_AvNuu6 zLgJE@+$zXB<7&$j`;2k z5GZJ<;EWd6)oAm%2RUtxpmts;p~2KbH3iyQ5d$&43(zMqfo9b1>=oo(Bii!;C-u<* z6Z30ewl6gZ?rtd)FPvk#Nh+RYb{mS(+p*)%d99HBW|0`u5^bhU%@v)bDY&WgEv7-S zg(+XHI*P^_zru1VM`A{Q7F>6nkpqeyWXN*tAXU{nLi*EQFf{@b(==jnN}J>>pjA#N z$_NH2XZgI6=H9m>cwr4#MuMh{{wy!)YNCm^l)VG-YWJB>xmU8GszN)MzoN*5mI7NM zJG$@bcwL{75Q8C5jSQ%jG6`4}!i4a}ZDmvJa=8?Kjo3>JdyO@>`Wgb8i^eJx7FxFa z52lxdADNIgZ#FytV+Rmqo(ZLbPuljOi!AvC%xrf?x;5~+*yIE}p8zfYw|*r1JW=eA zeR<#P2m5~Qq?$d~YR@515^BRm{>J18C`bI(Lo*iG&ZKp~bz~{fU#3kkAoS#bYQ&p{ zhzP~nKPRzFluRiU!S@)^>Os-XNOx*Vgm-djO<*< zNdf(KE~PiO(Jzl*paXq!+P4u>982=`OawrUMM03D@9!T_^+VNGhq*lp>fdig=z4SR z``YMOF`DX(0&QVCaY>uA*p*hYVQRer`KB! zFjUyc0JOTx6-jHKe-SJmwJkJoa=OT`x#x!psiF&(9XXq>R&U^{-Tdmf*k2(qBo8{W zqKXUL*)vqI6!4>n=A!UfEm_73DaLk^e8xKJlbwP@aVj=Mpuc;xgu-H8Ufa8bcX!TM zhtdIyH`<>>O6-J$RETo32DD^(V((Ldvk2arCt==`oFcf>xL0|c`0G!7-eUFV4&Is?hB6ggD&Y*Cou3#Ht zPCx?Eca>eJB`?}xl8;FZ>U2mwwl0b8@Z;~5caOc%-@L^`_Q5zA~pxL3hMNmuQeVv85tiktN z7?SzrDX@)u(VR*n^y05G@#9>0kU5}Of%#n?k!!W^Vdw>9RvG%%6Z71BM5#vT&P$H7 z&COKh3s|hzUNPtJCk?0FjobbH_%Bj z#D=<0$D>i0us+tuKT$)BvlzK|U^YfqqUxdAD-QF_1=J8uf-C^@)2Uvat{;whS(z~v z-H1`p?8*ZEy9WQQ!2DgKu*6n}TjW+S0$c5ih!`b4m_cZkk*`%rGYGfCZb2^G+-+;mb9`!Nj;MxTzr#9qZZi}qk* z*~I4v#=X8k);4L4c>r!`J*yBXpv*yL(*hMUcA`9@o!qYFOxnc=jw4vXEa6Ndryc}M zgsg+CdhP~S*=>}dRKY92npCj7novpz3XQGR0Hh*(;oA%dkl_nagfNHs|Dli`I{SKm zPwfbSDLO}lU7pZ?-`}UOE3Ya}r|T{tiQ}KiQ_^j-gw*<}_7lo`yhgY6ou=45>pGaalU7P&Lb zD;COYa?zxNSirE2N2K<>I^DI_36)yr#0=RFVUx>s=4-JCVcV#kXTVA4MO+6&S<9}I zRk}HVcePco_@oQ{^1ni(agMU7^dN!wOM}bRE9i7)Jm2XV?Z2Evk z%yuF)>RpB=FBsC93S`hQgS!dod(22y(?*{ZpgwOQVx(k8M$t#FMTcxJkl)=Wzzw0Y zhldOaYEbxi00-Of95z07w}}#%X=A>mF=$&rB#e4fE<}6~F&RT*hf52lD|gOpD@W$u zsl7AJ6}fmFWjw}|AYE@1sLXs|Mqco^(jT*K7@qzyM>etxa1HD9&$0Ylt%*C{pHIIU z(_e7|W%Iub682CH(56@mqB3afdvj(jE5+cP%)5fRcuLgK41LTg*x~}t=5#yb-U~xG zozvUtd|%s-McRa;0Am}LaRr7P&%0z4_+4bh0l%wci1!>Lde?~viNb+M!NV{;-X6wd zF9_bqD^wrQgVb|;n|O#_ z7mXCaPwD}(u~Let)>-KTeQB_KM`GOAfwNIAWJub6S#0e}dV1+{0Wdq$m@f+ev%5#h z&O(tMI0{O0Qc_n}Zx*25lq25&)K$8wNwe~yK#{8i(gm!K7f_GBB?TtuT~vhYQur=G z$_8}~T0e=CSE!#SD$BsL)ORC<4o2&^yj`gCop5s$pxUtQz4K8_X|^dt#o%K3oFU!o zfQruwnLX`FJy!8vHwLP9y&qQC7X`1;xVMF7+BC`$)pi0Ir_X+}WatyTdTI{Lg+Dnk zMy+$G+nx=dU+G>U-QtUe@AoHy*y@@ugOp;QA3$skbYVPB)SosB?;+ubbH06W8<>**%UVC_F}HK($DI}iEAvA9P9OXjE)-nCRkjOy7Zu< zeJ&i(H*p|Dc#|X`9E<^!$`5C^a6O9y-BgXc5j6g+(VAg$*?U0vO{cK)Xb5OVmjl2V zL+jc_-UfMFQ8vy(-IL_B0dzSve)M^h$(J%AQ^1HZPS|D~-N3hZ<}_d1o8n+R9Fm@XWwpvNiLL+Hurq zy^|?qE%>)z{v_{!JPUF%PRIaSFhQXfA>YC4gp-dEJA2}%X|$TpJ?z`-qCrk_bPpD$ z6of^qkiug;@VcOm^L)X^mH@9s;y8uU+bW#ME+^x0N>IiQZCx$KJzWUIv7zgs&zUrD zF5zK0cjOM-ae-I_WtJ2E@>VP!^StNpEw~#P76>1lUC-sqqCa}_YG?wB7CU2^g}<#; z)U@Hh+cVhf6i!<9YEv2XP{5Np*El)bVBu_dfajCM5yIgCYX25eD$!9hXDBZ^hXlVX zeKP>=4?61W%LfJDC3MtZi=5ImRA0#A<>p7OC z+2U;BKg{_h(8xtQVi9M*J9mG4`^osoUW=gHCqrP6u+vf8sG zX_4t}`YruueM@glJxr3z{!Hr3oXN{yAEfMGQ()yUn2PT&F(M=I`!|**f!k)#@S>i) z^&C&sjD*$>_jxILAsmtPlOM2Zg|O27e6tzU=+^e_kBqUAT_&FTqcef6>Fjh~N;$s# z^bl0#B*_D_HuU~?5(OPd>e+d{|K1zH*EZ;ref*_!gJQFMK?oJl|y_$OMoXmykjGxb;NEIfSOmq-1PheUam9w+KqF$d5zv%&j2 zxwm}BVc!NsC1Us!Psz1U?xNJCqNMS=4I7-hzg~pmoWUq?(=nERvWZ+qK0I;LTnyKW z4`ru$I^Y?O)@TKMozLdPf_@K@QR@7%mt$<=@AT8&pMKR2U0Ctc`QG`@`)5%r+)31FAZPBY%>1#JXf*T9`;g4{$=sar zj5#CQ{KC5;pL{<3Hwk+Jv76S%cU2U1@G~7n?3Zdt!Jet9-bVhG^3NF*dnt}*>xwK& zO4PL6nX_NZ9e`KP)}9UgBagPTnsXbB@5=l4hL$ACjRq=ji|ytGBg`XC3=#0g`|d_( z-5})_FNx>>+%tzGvcAglPMvmFx{LU4IJMBO2pcDGKl^9>EfRr$9_vN@e^t>~350yw zQx_p;@@;2UG9#tiqg5r78jvGIMD9!8<-~uXhvZ~rWYb1Y=Juvk%Aln6_wCkR_Al{1 zQBE7Nl~-PFmL_{S8#w7B|yuS4ZxnqV##}tL%)X8h6xg*hXS8dXy7TZbg0!2C$p#4fwmvc9ZhtVJQjO8llF1<77<7)R}TJ`&&f9 z_sfGGMI-%k+y(jlEHkZZKcFP%`nP6R@K7ml~(ZuZ>1 zCr4wqBfnctO2+-lN&*^1eBSo3ReE?Yd_U89*(65(BN3;WnwVB^fR>&%w9$UB$6fIA z2ypY#2L4Mjs7}sR(siO*?HD~vOp?Cyg5s%)pEAo_qV;dfn#yMxRJ<9 zpP_|s#(ds#AG3V;M`+jeA>}^vC+p_=QLR5ckMoibP$cG=>iy(LGFq zZ}2+{J`;je2vjKf4l!mr2C;dzKtrAP-yUIiTko<_AXhey0;np$9BUOd~7yni4l}Z zlGdo!;~#L2?>naH1AP6B?xymuz{x2RXmYqBN3(iCeU#uCbjTt5mYyxGZJ25-nrezD z2zeF{`3%S2?NhFrKR1NQaGdu!b$iwn2}REH=Z!Pfe_P|d8;Dv$aMw7EA2Mda>vu>| z{ghu4FNQ<7H!a$EWi49p)k0zqD(`lPto+!D4DTq1EEL(DzeTZk&D87NZm1008-t9E z@r*nE8?1-9k?zhw)bjtT~5bSq60tQDUC-~V%?eYU-q5oyrK$MM{?*s+4nZYNi ze9P1OO}A*4|APf3_y0WlqjJ%%C#C#+B}<#hFPfE=dGpgW$X`lj&mS3^B1t{b|1XKE z!7k?2g``LesP*_sW+f@ny0vIdjJe=X;?EBspy+$@?do6G^wYjhx$H&DOsi1Vrm%FYYVsicNR0yCtd#3WPUJ+L>W9?ZI170nfQ$vnIeqEq!^g3m7REhT z42kon&P5P!qK@(S|2^={N0#@@$;w?@V7I5~SN48}p&+gqXlwCZbc*4qtL zmemvuAlGK(HfRYeDDUfcP|DgU_*gN8Zy9P#b7-_gEmFA=M?Kv>OdTa<4C3}C z(&Y{<2f1iO@Y=~{ub-h9HwduAWEpl>8N|=i08z?h6TtG{MwQ{phR!{I1h z4E{j7m%5Q62`_O5j`SjcJNm#Y>IA#NKuKP9#_4!82ad+nHwmm-U1{9Ki6vMX=12n_ zPSTeQ4~y|w=oTrP5Zf8gq)xB z#|h^^3+*^Kd?~Jt1H-psi=3!cU4 zE`NEJ79Vqq)POhuwmm@O z)Q17_dInWDFM_;#!Hd$X3mhE5#g1M(YF?~I3~(kOCHy#25ab0SFC4b~cEiu{Zd$rY zVctx)ao`7mL7H()ExDy+oV@BY30>h=?29v3UE&GgfbdJFu8R{O0Yf?~2!+fXN`SZI z!-6kwy}BUby$l(zP%&p;{lLLtF`azxu{-5l!l_+t$IB4{xSYk%ZEyspkOYS&D+3&$ zfH&9$zznTUi7@GIQhQ=32>T!q#;&tN4DO|2G~yi9BS2?^XnasTBj5=Zau6@VqgnGB z(Lax&HIQ99sXSqOoBxVFcqU5O?|xX5{q76+GBdVVi-1$?izg18Jr-gi%ZE`odo9X& zn}!8V-ZN-1Z*Ta3dOCAGRYwkgXdG+gJ1(rqDzT?_c6d2c0CTb%?|g2A6Un7kfWwEo z-2i9#`?#ogMFGFF7SCQ9h`){yJG8sU>mQPucu&7Yt>N32xVk$&SlI&eA;`c;H7f+h zc{tn)M==U?ez(F;aI6w(G4|_p5B%6I*?!^0Bp~R4-Y%~j1j!}slRqXg#F$yC@%-BCz>k=(FtxJ!eIwSu$w4VNYl)p2_bcv&Y#%~# z5?rzZ@1#d9EbG_3pj3y?TIj6>D7WB@1GAW-kB;19ErB=Di%uN)#R3^g zFTo&;4?*72i-Mf*#sW2Ox%e@Kkrs3+*^KkT0%rP$9Q6?!DN?Nr_DH#V2sG z76B&&7dvrrBwmO@st=twk}t~MS1t(TxbD<>7weBoztdbqU+_6A9#_l-fWrlL9Qes< zst^~qad0NRsK#NxPG{V45f*3jx(k6gjr*LK`LLQR%_#P!q&ejPU-NF9D2}ysem4F0 z9ge)|^51|}_rIUYg0pz{zr_VPT*{9OctBdLz#RvtvOY1KB6UUEI5?H;`GT&Tyvt-C zZ>mLsh86`V2}It>G__z0mLA-8KXi2D&ESFORPycwO(bUF7rfv1Rh}6^@CSB`JM-4q z9~6AcxTEfgxU$m=C!32M_b=Oa=kMZ@a(o-{*oeoFfNfv+%U}%gTujEi$B}6Vbh8#4 z5(R)9(F{%i4lEpk6gc#^WD9{sem|p4F++>ODe@7TiMbR)-!I4pK>`mrkzH8Kskwin ziOa4##eT4A@FV=f?9mj^#z@PHEgaemWC=O_qj*W=AZ76w^7$*rc8N*w&JBzcfS#sm<261=*Ispl%!cs`!;YbPT zaZG!ckRWT4vH%JV8Ghd2e?AuS06moLhxd>UK>ddY1_YtD|F1py7=aYo)@8x^ZLg`u zDx&|s``pP3lyK{76sgn>pX5hxfdBS79!pm6lx^*~){#R@lJ`yfg@l0MA&-H`8eU=D{V8i8h}8 zC%T8-*^O}XNtN^I=%QbhTr>DV(W`26vLezyQey6<-}D~5lIi&ne`n`XD)WEnMf;`y zlUpNnzeCj`cruEC+C&_qoHgmR^tZ0I{f%e=>vAndcsfHwyqTCOmAl47U1B%!CQ^w=ydeH!OyUOzb@nOeIb~-zpl3n{>INb zdal{Y-@a$JkJI|e*WJ^IY@gvw;DU*P@k%`6`v0&{%<2rL{Er8R^?11O-%Fo-OyQ8a z|M-l%sSFMtO5E1P+wcu&`?NpTCfg6n#J}5RaW8tbW90Auwe4BqK6uvHh$G4P4~!&m z+!RS3uRiTPAvW~(=0xAyL(7WHpo)YEVKxutRBHOa4+KlVAyI}Cs_STeYb2a@h zEwW~CAAciT7@KxDkw7)Cb%^FIKF{qkvcE$aO$ja}o?`z=(Mgi=9h$eq{2y#ajcojT zPhaJa*-T7a{TeSXwzSER&su^txG_Dqy`by!ulqBWxGh{s@;{?0ap?a&vLnwpBIkem z1QHMZu;k<6hA6oHV396-y`P>xFkh*lcb}2^i&5>*x{zY#KSr?Nn31%=|4AC2yH-kl z&CC3Ma*YJz9`S3f1`5FsBmYBdb2ZBnBXC)E@Le;>CwgNU>HdJ1_(#rnw0z>~GY|c&#hAR`hh*g0-wm|C>HZvs zYW&|Ppncy5Z&GnTNo`v(yh+PvAb{qg8%^-vH~gd4JL7iw{XEi&Jmi4yhNz`W0Lezq z^7a51-_Sc&*~rN!s3ZL8j>V%A@^GIt`f_ihNqiMr`Qrc7=(Jz4Pi~b;3IA0AJD)46 zk`lk4{i4|Tsw<6>B-Nh##G*LXrXT&!2LDr6T5bEiZlAh&+XI%0`51B}nLBmheD4%a zb~#DqKmTN!ZMOrGQFhWY>iY#Ab#LE2B;7yuhj|DJ#7uK_=UD%tOnZ6ruO{r#;4*1yN8 zse1n7$9O)w$>jF+ex%=sk%InxPZ_y~3`cGbw;V~#XUf$aE%b=r!KLD7-3f!eBTM=u zYbQMe>3^mZ;WFIeH#iQVUs?yOKj-Ka+28Tl2e#qYx9n_GS-*)$b;7Y@Mvv|zi z2&`O~Ajp^6Kq`;E(I#6j&<(z)B&J&DTe-54Kzik!l$>lwMg8tmtie%7!?w5OTEYex zNu+1xL0k-SibPs>>g{-J`x)c-lxLbxSvu&fXKS6Lj9Q8Ya^IimLA(-k^-WLY-*%_LS~JO_XOBu1qFqa_;JHrvW_xYBO2@*H2? zV~;{4;Q6NaQ=F6lfJu-#|EZD1o+lk8|EU&9!9NL;{d*qLf_T3?;#pOYWc@oIi2k*v zP0@bxF>dvMU;l-{%YM8hU54`4Ll?2@z~HFz`NmJQE&nrlcK3!!V#WW+uK(_zL+rAd zQFouNMC;=Nqu_zKzsWc7M71OF{`CK*j@Z+Y{r_E7ote=QSuMkd^04-C#A(?wSszq6 zrr!yWrAmm$`DceVlss=m;b#1GmW-Uoqc0`Kg50G_J~t;$kVF+E<8lDv3!JHd zS|Bg92#FK0*%&0|g()QYP*Sp@3@7umAjn_^SRA6}$4JT+6mg0++k+IOP&UrX<`qa_ z6(-|3Y!L_NXtNgNWflT)kT^Sq1XbJ)sUK=eINU*KUKZpTaQF+ev{s*YT7_jCrp|Ua z1!&IKt`oaS(TQPu6(I8z=HP?bw5S^o64Rn?DlBYTA{r)2KwNsCWWh}Kyvll=muA-KhnKuZo&};cIph~u9s@Z$X`!cqmA&h$8k?a zt&y{~r0KNjd-fqUrs@$kME?#!PV8WvLAIM(3L8&Q0w)R*drR#busiC)0pVVA4QT-j zBcE_v1HVIj88u}*(3^-E1%S^O(w{Q41-jmJ`(a+A%7Z^~jKGcUxN7u`y5zQULRxWoERD0VC`h>pJA` z;*DeLDq%n`U+ZPt4F+Rcktn6Wz&9#3>u%izWL8Tz*JZkKRIJUDs{(&mic*1c8!?I? z8%tCb>o#NMkQWGEDuAQAGyxED=-Q*2Yy9(KM`84+8Vc@y6Bv#e^FE~u2&3gu=r#EM z7i^IWmA|T=n|A4Tk-tvMsjg-Yx|M_ke`l~UuQCHhTxhv{w$)6+O?QLGpt@JZ*xHnM zIU6!Et-_`9KFDTeudt(T^@p37b*jD#k#iOB0NdH55)W3}o3QgDBup}8G4_CjoT%)n z&cqep`AdnvUY{}dNJ$T=tQs^+1-449y=-)YJ3@DM;a32cYA4(t{OhSqOlu)*8&i5PVU-+P6mSXTF%M+QEs-KoTz(3wrg}# z82cgFk42{<7Jo3HmJd_5}fgn=r+XftFB4k z(%^@sb*au`)4N`Fz~^B-fl9_470%O)&&obroq9J0r+{uyz;43bBrY3hs?^5VD7C91 zex~k^WokyT*yyk(FLT&Q7f^nd#)>j+?xYz#!O^-Ndk{VzG%;MT8dj)VRAQFj^5#P9 zH97>7YiuS4mdH8~rinKd6Eo7SA8XW_jsWc{Tp0QPiC#oYHvpvNJOWrW1<;x* z96F?8l|YUZsM&$C1zXJ105wKLFP<+mpWoAOsdPEzivqR0Yg}R(L{kV^?2ympW;A)c z1~CM;Q$<$4jQ~jv5#5qH+Nh=5d292*AyjmewCuTH!}I905dX2pBbM!dHSF+pLRuI4 zBHP&%Hd|IfP~k<~)P7yI)1O0r3TlHIa20WbtuozOqPtd05{Da83Z+?OJ7CTxfv#X? zTZU2RDZ$-ND8QJynJCOqRG1cdS=Ev5G5mj9NXb%v;Gje9OGroQ79VL*VG>-hh&dZ{ zBd}#Bgc1xgc+*BY>ViIG!J4)ssGM^Z#=Z2>3fH1lu-jlYs1Oq1G?UBi{#NZ1bM-P$ ze~J#1N?VuA_Y#BeuR{A*4~{SZPC&80Fw`)=+7=X6Xd~du>KmIXw*V=@a=j3=bJM!+ z)N^OtJxEm7CGHNgeK#@I@8D=j!Dj-9ZH|u89QoKhCpArAo>FejW?m`_#an8IP?0ew zuKh$X34K)2;p*Z=puw;OV%yapo)|c`dGnzxsDFm-MGdva!9(9|E)ydk$_+pr4Svj9h+nVlx#j!q3_t zn5p7C_46x^)2Cv*$8xmh7`HEAdjBhXOEMr+I8#7?6B}L%q=se;32DWB)+DFCm_4h$ zjxR0Sx`7;r*l4tI_`K#3p>+ZfSO-&}OYp912I|u{0F*OLEjt`vbxaIe27>JFOCa1B z{{c-IfYT|@j1L*L7oT5Xo`@Q=p13|c>LjldgyAQlgKfxkwPldtu!{YDzK;0v)g#1+ z9(>xQOYL6-QAN^n%@9L?fow#th>3z)!YOrQAqq3PZQLJB@mKp356XxjpEqjE4WD@z zLxjyZ|6}9OL|_NH$F04ZxxU#)fPl|Hej}bB<|4t~SFsZE9>XC_-xzZ!wk@2_+ckC< zq7!URzY;sO#_J|ykPctkO1v=MmDzd8Nmq*yLR-!N7sOETD ze(JoyP{`5DDW2>x$wAOz#tVW{c{Kxt$!=1z`wJ)a#ixWzBILfbRCZZL1VN#*#fzkc zx-9{$TVCh7mLT@x_v3(9^xx|7F%x=M(1`d<>9fTsFqWEgw&0dnx^ouA_TIEuH5Y)( zN+9VLjN#t4uZ{|g3oWaL^s#_84p3ghixF{P06GDvoAcq~C``X)4W;Dftrj5j-de^;EqqCZ2=p~t2r%n6jmbbv z!(?m^xUIO+y0F$n7)uOFXwEK<$0biCxDN3fIePU0l>N#cRJH5E0kSbd_TjKJ!wDRL z2B$>^g2Zd*?98yj5xPui$cj_$v8uB);5Bw_J$kM(Nx!_PG;Uy|ZK%vTO}wKA8@_BV zjboyYP1ypfHc$2f-Nm-2z5-$AY(WP~UOE=40k%9nYa_6<8*MXT!-^i*7;@E@`S3B46Vw{exT;@!iWW`ktCgMv)3nN06 zlKw}<3-G42-s5S5elBII)Jgyp;E5m|08QtaSIiNBEHSDr7RAq6TI#GqMmHrm5XRT# z7jks>$?-0m2xo5YhMGClP4r}_BRSLPaA1>*pD&xas9Y0`N2Oq?dbQ9fF*R@WJj&7w zFp%r-?B+GK#kl*;QwheY(x-h2R$lS6Eu&g+&JvypV5t^@IQk-}G9$`n1aji=yLV9C zN6!i^e+%_b@4(tr2ZELWP!&JrbZoQhdVJ7*s78-8_n9AEA;4k^NkPQl+e7Kv1uh7? zKGu9f=vcF(QRr}?IwK6qw>t6CpZ!2pnb5|>7zG&h1o4v?vi|5{@DOsrSIjQ6T_=v} zIk|w_bcANwH^9h$9)*nSsWu2whNEt|PB{-I4F2%Mpg5Rkj-rdi*-OBO(=e0;n2Tc5 zeq=U+%1~vzbj#dG8dghZ&HxN(%oH)O@k%)O(bq{WgWG}Q2mc7FI_GV!TPqVd>OpAG z*owvQ4K-E+(*z29F@R->Rz&Zkt>h7KR4{sDxjYOPanP)`Q)H>bYG`bVs%Dn&JABL? z(xnRQ!$;m}0xV83MUL$paqW65m0Ql%4H2KoMDTzt5wQz0A&YW*%A#E+TGu6>%k?QM zXjz{lV~0Qi_apLnse!2E%Ug zYwT`dmooZwjP_yQU)bK?0H~pxS;4;yxJRnIo`!T4Wt7m6kOOu;0ed^jU2ii8i%Sd9 zAY@nq_1dG~bs`^l^dA_SqG028kHBilR#(Hs70(0_hD5oVGS}z&I$3z2Ty^JYNQD-k zOsnGqC>kgtfc2Q{4JO(2u2BA3Lc4x-!WTntdv*Wj9=@Tfc8S5%4%1PY!M0nmdI=xv zV4cdGOhQ?#9!BkQbu?6T?P_jsF$t?5vqjTZ6J;~viC{tgCEN*R2?!~ zOQfw?eUv^XK`AB5PnAMv8K|Upx*7{+47hVp^#Z1!coh4A_Lq5jq7ls;`&>==yV7t; z2l?e)@$5(yhGKP@8o_7Q$k2Anc!9P1Hq^sD#vX~qgA(7M`Za8Z^s=B?Ry{CU zavSQYHRd*Er&@t$84sB$>G9K>=;aTKakm)8;!Rb3aX4s{pw=g&vhxI5V|7?y7EJc4 z5FmwI_fi83$`&g^a2d=qz+`ss44irL5{w+Um65Rh@VUpiU% ze*+t;gF?2~rp$J0zS|}48?=V~#e@bx3A%-(!1&a*A%y6}<2DB4s5&(mWCCTRR;#Re zMZcPK*f}CA(4Is2Q}6U0Wcu*nX|M!&;4D6oxPqjxuYoayrwU<^XeIo&LEMd1z&KO#OYUj-nq#jX=^s}SHHEC| z+xcvD$~wl*8Qg}t2uSJ1dAAx30@?W{1-ry5Ph-1eqXdI|+0M9o0Jd7j5WDXqPdTId#=s70oN;EM6*pyD2{QnlirvC@1eyX+_Tk?GIuY2mmim>8)Ps6d(VH&0Z|K6Spa#2~FjUJnzlVQ&W>49N=4<@){_p(WSb ziGlyLRO0v2Gn)KLyP)cj%-F=@@8+xKI(5qwXp3cs8w_RF(ATM}e;0J*C$v%0o%Wbu z;B1$UIKqgo1(g@S7}~#yADwS%J_Y+*5nr00@p)i5NjJszrH0c$R7h7@MbKL?Q@sED zqkA6ms{y!jF{TUkdd6`eXYl(>(@V4gi>IzFk~`f{D1m;;KE$dXI7Z9Y38q#EZ65H7 zPnkPECzPHh=wMNq@j8W@J$84_Zo)2lNzjx^9`9C@z~|TYTB_X`m>FjNB8=B+pDUH` zyJQ6l+*cZU!YP~^td>ok^m)kruV6Ek=a%&W>ot?SLTvu3w(5e_(f zZPrF;z&0svgo!oZMEu55Blu_AOLd>+ z!1Yi&P_27565a{7RNG-c<1+j2LIDz@RbDtCC)-$HheW7s4^BBcDB4PK2$z$N)H(KS z|Lmr@nNRdjso!2 zeF6+IJE^%OaZ`}FWe7sZAs393nYD)P<6nAgn~8DYbcRqGFtux;JL%>()?E`j>0feV z_sZt2Ft-I%ob29io#)Y`$Solrt*}6rb!P=Nqd#f_^vD#@S!NH+h-tXgUk};G1t)Yv zxNZUk093L2%6jp!8nAK0<;!5r#%qy>_r_R!>?hiLSk!bj$>Z!hj$b6qVild!GD6kx zSQ#7QpgffjC@o3zT;@Mb)S2Q($t`E_C9LB46}PyV^JN%xYn5imZ2Qi=JHJr2tZ`|g zv9>tHF~Ql8xMipv7*R67{RLM8k6mfhofQ=0H_yd%lfB(5x3HaPfgNKCKsevuyWh<` zz7$4tJLs`j#|Wk-_umjehkg>v#D)rSacrbJOx%QC1tko#vzJr)`|#9?2QdI8kX*dx zp}Q#w-!uCIRe0%_@LOL#8`STkn9Cnhqv;?HHs|6*PWP%c3Lb8 z5Eu;lOJ)*n!vBd2IxEqf%x^BDRqpDl`^E9#BUkq;=hjtTuhm(iR_ zywz>R%-tBH=y4J6%SruoU`0B(mOP|H)G~5H;#L8!ih4_IM6(twBnC-7(@_5wHdoFw zbTHQ?iH2;}2Ig9&6MRGqLxD%bTUf!rY@2RFK{w)}*dSg@%b6Eu=E(`JRL8O3B5(0t z=4)!)NI164OeA1U^ws8^SybOcP82N604$aU5*TF_MwX19Llb#vGMg7pU0jULJcJls_ARpX!dyt+ zrwE9AF{)OqULxo|&2l7M!n@xR z@bjsC`)p|AykTc$nO#3#urgL~anQ}U}fdq7kIAfj3 zASF;{4pwI^7eN4Y>AdX3N$J7?NU}pMLg(}XHABU!?x|F3w`b&;+p^HnBdbksb{7aQ)_ippc z8G6$spN#wUVb5pmj)+?}Ju_ggt!&aZbiYoNj`$c-XV0(Y+W)mto|R|OG`E8NP7+7M zP`fApmp-M~f7U=-znb%{C(x8 z%8Py=KT;=Xkmw0M45Re#j1*h)BL8wnSCf(=)i=Zy*P!-`chxyE?s9sz6d8_Gm=#(4 zZye{mZUJt5MGecG2~#Q`<0q#PDQn|^Y1t)bPdY^M!ZV%b!rH1-Aig_7y}RB?8K3T!&{1a-AG7!XdDys8LwfST zBZ4YZyi>!`Qg-)riFo5101=}8p`soMoE-Wsw*~FU>5y zqMZACw{?Y$m4K58?Yg`5KQ$^3y_o!9mAMy z%XCzw;`2s$m5MtAq?E|6!Q%bvHa^Ow+>u{LX~sU)BUL{jG{!hSqB4l=zkX#|b3>_; zP&N+Q=^|33x;~nVQnj?Bj@|n7bAghxkxWe;G?mj68h=PH@0C&npC^E)EbNbRrtGBZ zC(RLPc0DFOby7J8%cIEh9(Ab87yU8c<7oS+UI+;FcdwOo(S!X)5>S$p-oMw#YSl(0 z@+Iq@_#JAxSt-Zf@V3jEdCR>4eus{e>zDR}_RByPLpQYFYlM}Jo2~oJm8wr;;gfCO zG$i$5skriXjH29z{l0FaYx+m__q6gYQkKaH8T3W+)w540O{`3>_yy#5wcPIXCI8gFQ~32A^hRge&FyiY zslm$LX4l02+32w(sNUPd={tGG|KQ=)sT(yoA0?&jm1pC$FQsMK*+`t^3qAV2WKd_f z^YA>BP;xW)9nTXYn(<>e++SKV9yJhF50|P7C~|P;HqZQ4LGy#OJLAW$)ZhID z=4SB}#;dd5!yeCe^5DK1AAW6lu>5}<;m$_FHf&Re}){b|w z11T($TC=`w3vsSC(@Qz~INZ(OwlXz;#&bt9%D7L3MQ2IB#P{M!z77s~_RD@5Uokng zM?Ci(+a{Gv$wFD(QSNoN6DD(EpKiP;1lboXbmiVB5fLDP+`>ceDPy0WyvZm)plq_T#!s=2Y zE+S1r{YQ|I*~fo8@SOvVPbZc9wGz!;8zDuEDe&7J85}$>DNS*5Bhj1L<`BuAqx8tkDsuoc!OsB5fKmSZtr0*pnL%k?hNnAe@nm8}lf` z|0T;|e^$rpk$L6m@Bbd<6mdNn&L>6^lVj+o-pH$-JXuE?y*;;~Q`MT4B~_FCwrKtr zVF=`Ww{2I(#&sD)@^XG6%RN4_0GF$N_4tV=HCmhk+CfrT`=>fMOTrC7Dg_bO6G}pAL{}6)$cWZq41kU{R$ic zyzUt_vc)HlAtvdAG{jW;CGw@&oWu#Aj-A)Z9r;6%uM6dvafx zG55o5M)cTaGA_%KAnG>;%=zDfy!s8GHa`&&?^ zrM}i?7UcP{_|TL9MZCagMwgCr(%JX>PZ3%HF<5uxJ~0=S_tZOC>6koiRc%$Ax2!9b znFT#%dC;dCWTJ#Z7oAPMx2WIO-W72Gg= z9TJDd>A94J${zQ}SMYIv7l9nu-N!M`Wee>%ICw3}P_7V|i9LhJrg|O^a=@ zbBE82YML#p>yz$@WqGB0J=ew&jF#9_<&^5LE!jwIPy3t7k^Kj8^7x$`Vu8{WIYQ1| zQJTd8hM{6nmg1a^ciksN*Sh9O|a??!RT-)Jj;FwlQ-K zWq`0SS0R)7?NfW7TCe2r^cF5`58LSh;xFxGu`FHHQzW*z#w-GDG~$+dnN$`wl2zjx zFbwj?lGlt_*Y5507>ufAMBkh3V1k{4L9&T0y@k1`vX==#R@32VPq6gK-TKh_VcezD zgO~R3U0wxu*t>OsHOuc^;G#Xds!v`M3YCsT#FWz{7bMpJ(yEb=6YjAAXYOH zVc|ha&dZbML2d@<(%7k7NuBL%tdTkr6i}-NBNPXzy0x^sRI0c6ex+Z&*=|ef=8oQc zk_LbRj1yES2mnIewpl4uQ$Y2(jg_PD3O)n8=9S1|?kAn#d0;BMKg^W~lX z833=-Sr2HO$yAH+bhl+be zFL`QBV-JY|UaSvX&_8{LPqYmXJF7s^*MT@6g&ngvm|d|dfh>!MapvRZsdaUj1|_5a z1lUNyVok|XsxqDfj^+;gthh!!U9t@Va7o}F^BVe>6|f59UBIH4<0lGK=qu@+R3*w1 zI_V~jJOEX*xHhW`6<7lM-J=cNdxa8crRFQtpsUcDust&z6j1txQ{%8NiVi?q?w|-q zu@WdOW#!Gfl0vDrBbSrCv{%g(>^Z1duPS>kcL&2# zEIl>zREFy{=%tlSG%9Tp@WyHN0+%oI_QV%-s(Utz4TUccv)6mn1bx?_S3rcx4oALt z>6wdC3$fnt_1!1u$Q2MEtxn6|WU>0Uv=Z)JUlzcxsdr~lcR3|&U!Ah_3A!PavxEnh zvJN?f!D6p@OFp%2gMz#~-dUVlq`>p4&AgK-dl)EE?aDJUq%6-G za{*GvJxaztAXd=8sTnWlDm$=O(ddsa3BzlyFmXKy3racr-F%^+>u5UbTb*&;-%i_} zU%xUHK%p>|^ zCS+7uISIfKZwH(WU^Q6bS|CFV;q?YIhF!3;XwEWS`}I%6(KNrE!&p9_@oRLBZQ!ZE zzD3EAfq|o9z(2Pj$!S{RBam9XnQWlVHw@28QWf6UJLx4;UC`COY&2@1jKi)t=F?&f>WQ; zrseChyNfZZ>2qxK)}s7c%c$ee6C4@cbZ1Iu1{5v4A5}+5u`a@r&yt&71+8?ljrw8Q z4Js17nC_(eNEXB@gXdS*EF&-BK;N|3_;Xk)dl0N}Fg7l4o$d>WYO5DeECXRMYPu$X zqMyKXNc2Gk!`13=R(8VJRXr2aqGIu0>mWg&Fmjvwz|Z008}v0b{YvS5KxaSE%vZGR zo4UpdOrO7I+SnB}jpk<6H}=t4D|X}8lrEjZwH0JLw8$6aoiQlpBK=QiwAf!uvUF5U_|t#kEOv`5pa)lBhSS>5-9crKi3oPB3b zPZ$C|a?X6|Q+$##36h{bT8FqoxyLV6Rnv{S|Ch-`8t!r%g7E>(QBhu_MrpNr2new_ z`}%MLE?ERI>Hr@#PKs$ zq>cb?aFI#@o8ab*`n(^qe#k&WsG}T!NqnmO6=fs)l(+4nsx-JhFr^^@bNwKtgBDFO zsLhoaqJSLiE798qt}%0~R0~ZP4Aa*I89nJ$+|x_@8Wro-r>*lr?4%vlgaQl+_DThy zol8-}p>e1yi0+naklen87l98iwZGn zKw2UgTqcvX166<8oQcStYv1zL$Q*hR1xa|AL=oF)Y=HS{^+;f7`77e^ksVTZH;w>H zEd*#t9$QlG^B{0?c zB(6Rsn}6P%8QV=3S7ZZEpcaFBN+8h-=*038q6kR4;Zc13VLtk)1x_y- za!x!8;Yc>>Vj00wOdO9rBNAAY%K?5&6L?&Z9WRsKmbi{aXFG6;P%3nfuuEo_@($-V zkb>b%a6U9wjKkuYw9^U0oSQJI64)Tz6-~F8di8tOl*zbwX&_4A>=b$N@CmBEsEGN{ zIPg3HtX_y3>i#|pK}uXexG((pGWbpeEAj?JF5BCco?r?qN6gKdSrW$yQf{4G=db*foh!L?rd39vH=LYoHC zWFY@F+;oBxN7l3lSY%7tY0Y4_!?(){b5L~-I%CJKiEf6gWDfG`@fSyOv>hY`xiBBU zY1B~%j$f{NnV-?N1M`-7C`-Bxz-+!CD z@Qq3+^pdE%j4ef%0Idyw-^y_bg@v8l$j!Sed}xZ~?{?lh-3C$!0t}AlXfjAk zMN}Nn&{`meh!1hcWIBoS6518=1U?mcKvF)O4v6d_jI*k+n(ukpbAR`X3kFC;M^)0u z*2Z-zDWUyt_Bs5Vt1Pq&lj1YG4fxTIEO~IT_$v$>VX31ozqzfzezcr$HcF1+Dm_RNPyF`UkMoaIe?yD+GZD{dgc4(;0#)h(#(bWH@1Is%sH& zo|QFZaW2N?60GRD;2R|cCe2bx)hp}*!qHq`J_0y^9j_fnp-A56rj#^3M<;i!_%;!5 zewj=ocLEKYby5L}XFQ7KO}ss1FVmAv(j9K5>v5qvj?W=#zZ24AeZW8@%yiWq!1?H& zwtsUPW`H*HzS@p)9M0kpgxnC~^`jiU9hTB1cZK7x7iqfYDfHHDyfoM%^aaI_P#)1{ zwIpK^sy$Zt7zEU5Q>OsjzQqdHig-I;Dpeo3ufagqbH@5Rajobbj(E;8UW&cJ(Ymk! zOf;y)Jv9=EF`2I;+y~ho3*$=c*TnQ+^r;H?nz3BUK>A228DLfY5lyh1H2) zCrq)^!{3;urW4!<`T3soDAZh9tA zMw5^l#KWqY1Q*zb!^V;@Z4~qIwn;||#2S-)gBr?rwlS6(!IF)nJ1u%>zuUF(vhm%U zUyMUxW7-q;4ax|#lHBc<7<{$CxGIf~S@efua6!EdXjG8VfD|6%lc>)F+O5{+i1~&t zy5;PmQ8#-5rGCp7nBtVbmqACQsXm(2zCXg`6u`(NadV@pxwQ8x8 zK!{p~i%$d4#MFcmP0nMD_LkV#@pp>0E&_qB+-y;@yo)x z7eaOY0@EBEvB_zs619cP-rwMw0c|W;p<$c39X+|^01Yupx;xWyRBOs*BNVSw1crn@ zS#YSnl?u+NF_yo^J_@*>blIVoX6l2v=X}gbSd>=Upow72Y$^#=7k|4N+D%N|MDoo( zf%vl=6!=or8Ose|^x4fcn(xF=Rry!x9i4QX>t&RA+u4Bt=xn;u|!8gn2;oD*i!qKs3Pem0ks&;G*oPAl3cWrILSd3$@&{KkefJuqsi_q zn3h>y5_G^CfQ7X<<)aEgab(`sQ*2uqCOxT4;?drHmi z+4FCxAzu3{OYebajA0w1G0jQluKtH)FLB@h^?lb7`4qH6V-m`lhl_yY235AzxkUDJwRZ`xru~msyoLI&ofz zkIY;o_UQIom+(BMUmXLkX>sZU+mA~vEvcmw8_@#s4ao`{>Q{tnle^q{w!L$9we?+YmoH`&2~&blT{GdG`7EAI=rg-;2y`jq z1jRqTjg%{Y3sv0LnkmLK;b00hRGl0Id3`SaOR{fP0(6w1k-jg>cBq8DhGzZ`I%%*W zhSkVrJJ%Jd|nLg*efcax(vGbnahDqM(??x9h#7?bnfkYF!3+F1rSLUlv-fsDPTGpu1^S(kPjez@BU~ zo_GUroxbgDUo4PK=*)ULG`#msSJ;95kuN$O+v@6^Z1zFIsDdslnM)=lZv-rCex{Fs zh*U=mV%)OKD^e4BR1Kvn8(cu^a7YXdU;oIRJ@mrKMkFE5S3e(^8_NFOJfpYMzde+! z27pSj`l-h-{U779kz*yEv!W?|*D6KIt>)R!B>4@x$hRY>wIY4nEhv?Bk3Ma7W-FX- z+Xc_Nqz1Ple_O0~a64pLkmWbF{WUCc2TLTGR-|wHgz)NuId~QwYu((n6ekbPhk{O` zo)|Y1=34bp5Z{G~zW%>i|8wFZlzZ}t-A9hmY+tjs+4z2%kl_2V6q(kcLVFVd^*_;v zaM*ZqxbGB<+v6*t?W1%T~%PcI~oXDQs*< z{+G#6uX_FjwY|4DvXz4J=(9fCHX>B-KYp~z+~78NIiT0GaT%HIx4i4+r_!U7Y&~Wa z-0NtPTkD8lSuS!7n#bRJnWS~&t+Aq^^Hxa`zQg&th`-*r()p((zrzo?vFGGd&WJCD zT&%ONdH0al9-Ni_V>?ptJ$V)Qr+fdH?N|TxT7wdF~oCow1P&t~Ss zH&{vr>#Em30i+UoLm+y-*c9rR@ztG z%;GPY^mkdF*=rJha35Ib@4x;WXe1Nuw>OCW-+xp7(LO1j?+tEO4L$pml+j8?zotl+brXz9!{gTD9{;lx@ zxfOy6g0`T(B04)$HS*UN&3Byw7%HQNkbbADlXBhm=uGKne&uN(*~#yN*Y}W>N6aDw zxS|0cPV$E4^$a1(ldTid8j%VbP}$<;wd}Y3!?DbF*=Y?O%$rww7Td_rS^MWB%kpX5 zG>?9AE&zDBT8#aM|)INTu83 zg?Njh1o2rR;W^3){)B^4(<9~NpDFz`UZQ(f-jwH9Ml(Bo#oyLLZj1(%UZ-<*UN+N;f-^p)c@bV=2oR&*__+N|~{>!Icb$#+m ztc-_dkb{_OcBWl_`qamt$$x6rH$13v?RQ3~wDFMrNz{}SKktB)rKjio8{8i;Qeg>W zU4PJ<{*2vDKB)!G^1)Q(z3+iz{L)JpvqqcQUyy0=n-?6BRfW}~I8-^-K2xKfaDOn~ zyN`~gAxZ2XC@4v3KUYRfPX4|Ym)X3Va$+jr;OpC`9VYOU`IosASL&bFl@+-Hma50| zRB?Ra9y!mHiNXp;I@r`yhG2L!I10TLMB^%Bq+tu-BBK!}Ls4IeJ-}U2++wUiXr>JHV+Xf~nKl>ga zJLWL;{gNU4xE3DQAFZ-K|DTfqYH$6vX{o1-1pfQ#iFmcOwzJr7YUS}Xq!~Ervwp&T zR$2kSc^)VulB`TfIm{dS<#?r8)PHF+kwp(fEPz_G65NiMW!*#lTs~U^;rmWL`bMug zDdbB;e7BFr{YFoeh{w2V=lRcD5`P>%@lNF4FON<9|FAij>G6_$pGyq?hc+uwbN43y z7r(dLB&q+Y;Gb>$|J9IZ;feaSq8I;R&9md*?i6zIQ$ud~`Shmn{!F@9-l(~|NKceT z0>61lNYA6A6{E+S)^L%6N=oxaSu;|8-e}^}N*nS>{ZgA6AxZ1U_-&?ZzS|uPbnBnq z*~=6avu8_4_V}g~D&HsQ{mersvZ#ormySp5a53>zz8xBABW}$347EIwg$KVD73SpN zf3&@o^JShZ+zv!CXKF{i;HChCoUQ*jz~bIezo%RYGqnA(l(gmI?RH`+RlQ}<96y!+ z&cG4-R>@`S*{VPL%Z{S)-Zz8|G&zoVe}rY3Zn`W%<-EXMn$P$w|NMUz8c1qz-*Eo} z#^U#Z|EBZ(o}c@d#tWp-qi2(+?`swYal0|UD^;qIByx=hhW+rG!@_qY!M`3QwNgqp zwDj9l>@;~$Z%7H}a%Jrohr2!g|4|NUQ*yu2y~_J0H#H^d@va>)Z=N+R;d>sQVo2RL zlTs%sB%>W9rw19G3w}2o68JOdD>Y9O%ZG0p?ta)A&&X#I@aHW1*1i>apGD;HZ@a%4 zq{0(H2JzbZ7%`2KU-?Hq!}H=Fyf##+q!A}m!}597v1gK4M@DG>Fc5hoBTb2a|0cZ~ zwP^Z&pAI%7{{LqM9Feno^7EozA=>Pfqwwbsh~SCjR~}Cs?v^uh+Q~eYxGb|aF8fxVrK8Kvk}s9tQRj`@zZQ{-MSv~juUy+H{f@{wX5VNb zT#+srF<)me#PNmhTphE2%OAP(jhrUld?N?Y*^p2A3+k3_a6GbNiA=oockq;gBze97 zrGKLmtl)jgwL40xvyuHXY$>8L^m&3Q$u*HVZz#X=a0|JzUnDs^W@gXjGxnOsG=hWI zXKQ)guaNL};Mlj$vc~sRkng|DatCDGf_|q@ouNJADjfwy`7cophyR!8(SRf(ed-qg@Z22DZ;I&IuAa(No&l;% z-g>0xj~+JuAD{edke@vi+Xvr>*V!XtUplzWrt%CQ|C&$bMt+0O%w2@bJ!LumMqDYKR*QV;WrR+>{yOj_Ll=t=89nX^ z+OjDeEa3m2WbBTeo1~mt6AA)}f1dPcQIyu?<;j*;uEb_1cesc#d$zLTlG|gVx6@W) zpx`zqpXok;V|ov=dKWB)qwWZJfM|q4-0@ zbOdn}^UD;_o(rdP071|G7ecjK?%lW-i3lfqw^iM zTI1yF@*@dhDr>ucrt7?GX9(SH9OUzZ6^$lMBFt%dIm3bFZhFZJum4#&RpO$a6_PS* z%3W_I_1+QF@D*BzE+Pjy&y%C{pZs{9uXx9tJV?OsS_n9PQHP#JkJsA-_llOO*cZhP z;_zha7DIoraHn^R;+BoZX&58$OhW3r#a@$hFhqm!dE&rK-g;ZizjGrpgT@G6?h!ff zO;Fxp(v8OOu+!G&ja7?d3STjLlYdR(JuVj|?f#i{hb`lgU7`EK?2Js|4CFb?;2#ynhQFj|?WOJeKJY>gQDG+Q7a5w-}&;Kv9CKq1*EkEsx3a zzPBQ5d1E-Jz-(K`SM$KZ?f(d%#HWU%-=nv_4xfz>W+LQN`Y?W~m&A4m)8a+h4&YZE zi+3IblegeaCqT}LghJ!!*QpbQGJ6kSSgI#miF#tTpLDo)#aY!t3s&v|!miB~j@}Ef z`T!9_$cxl4;c8@hn(B#%`>JDWE|%s_KVPp|qTZF@7^14fq=&_P!sorvmun9K6HjN& zQ&>{W`)|^B8(3EKl#C@!%WMJBN9wdhsM3TYpetc-?Gp>Wo8-rd))~(uns4Np=Aca%hKAc&Vj1| zf!0)P!C)WZ&6l#gLBbg)$Xl8_n$(71B&{J5sM5O4p$P<0nTwjbcu1m+%;M=?Ex2%S zLJ!9c?kym69Gc4eJ%2gsBKwE9-m+HXOu)^^&W)+DTg)Bql(k`;9a3(XnMPQGUWyjY zReF0R@#u6>S{G#%QAZfj-X?BO{7Y7yd)*w(12Lq{5{~$QG}jOg|E)7uBA37VoUH)+ zsg2{&V&4c#n(sGpd}$Dzk_aD_gfUA5@mW>5uPuBlFD?3PFL4ui#cIHfKEFc=OT4XZG3s>s7_MLdWybCB{0Ie)>WMJj5!W+v| zpmQ1Iy>A?@skWswzI0EI6fXS&wc9aGumf(m;Z2Q`ZnlFjWbdTQYDu6mdS3@D*}91(5B)$`MgUb?->^L(J2)?XgvJ zobJxf*W}Y_RP`k`i2N@^9wu8lL%W#1toA`Lj_cyB0|=%Sek~(NXbox(D)adcTEiKQ zaDZd6_TU$RDCjUP3nn1kL7dll!_uoJ)u-^_9QmYET0cG!e6Q3O92*N0IN`jw9Ko-y z7dMs}mD?|&vRj*urzlws@N+dRq5=%AHe(26b(qaqepDrpFt~MpeAcY@P^&f|ZMV_H_LOf&-cG;!R z#j5b5I*=XcPJCD@%QA!~76P_u+#pkmawh6gN!GhVfdyE)&H1&C4)8G5D>acuQH7Iu zpjCDyLXJo1;iXZ78s{`BZg@hW2J#r^FH#mj5Z_s<4^^ah=<*gTh%<&-!FY^Ttaa(B zdw_pWU{yHftohlswER6!0ZY*O{~7}{AgS|+HfYG`YxMYvbu|HdJLJ8({cO7X_pne^ z=^l5VaY+=V)*uc)NvxbO3aCU@rwVv|bdC55W8x=OD~w(2LJ<%) z<>JY@EeZyZy1OUb+GCDm?cjrKj@XR)Rmbj9it17oL!fwbL(QeShY7Dx6BrVbbonOg z)79*J8@o{WfQ!#8@|H|a1*-X+r;r*y43b!6IzWza67V%Q)U#sy4P~T^z-zWEd3URr z`>>L1_PGZl^xazTxbDgf2HYre(G|t&U`VeQToJha^9+%dvVfSPfa~fyv7V}mY8KY8 zc>ucnWIpbZU@BMd4M~M`S)7YhEB&FlV1q+yk#H3Nn1Bn}(ukqPpz=!D>kT31L)g+1&J&ZQkD_RQc>(vJu0@a1r?#hD$b5%vNL zGL~i{hdqBb=sE;k@s?oy^j+){n|aOvQ2`6aio&w2nU#HGaErNnb-#{9wDMf|vm zjRWz36`q^(X5wp<0Sqt}>zB|Y-(n8UP3lKX?_gE-+RDL^E zAG!eu=7p4!Lq6I_)ZpW)!MtfEk_V^FW@2Gn0t)MrWABjYtf_mJ0a>(g#oN0)Z8>`P z8eMcr?#6fuD}{=^n5x3RAI7d79J_BYjxOvWVSv6K%XE1VuU3Yb5 z_@UvpfO~osuCq01K-~v5_Qm|c7&U;L>w7whfYVG_TWY$&2twR5!2n#$j_9Ro zS03w1ytFI%?1de(58ga4&ZCE{u01KTTw_#%shH01kwIo4-m5oPb)90q&MsV9ahyFUqu>C)V|Ax zsH9cRz(Cb|AWp`; zR>MoMbB45ifWUa8)xB@*%Xj~l#k6A80NmY6`d6?A z5dy^GRP&bB_E`XVC!dJFgb!j}i=qTf?cj3I*C#})_VwXh)Lq@H z*UbsKR3yHE4BBo>`M5--1Kyuq$Xc8FT4(s zUvKpCMJ_Q%__E96=5|3kKJquA(Cjvjr9HLeCrJIHbhnD?D z@njtG(xI+U#vCKkS}yOjJBfo*+86RtF%@L=VMxGYbeyHrf{+qf2+ZM_ehV3?pdH7> zv>YU!#ciAg({>?#7L##WOzuJeE!N^Wn8*tbq-iI}i;6lSqlZL*?A-vdFQ37vC!85h z2x*q~ALjnwsff2~C>*ZjLsb~+i*tEwF^0e!^>=yg>_@mis+s|cRAd7Lx>!muFzjnb z!PBuPx>|gRxcKlhzz5W5Go9EdrfbaIE?tv5h+~r?7B$%kAY7_U zVAR{8u-|2yug5h#%i#vob(A%afSa}z9@^-Rwb?R{pGVSiR-0s{6fDFp@!ZfLRy^5( z#t-yDX<0zFtyn!zLNDLjn`BGsqWhFMFl~RlIB@arA~?ebnfJaU0)9G@D3%j!7b>nB z`1lL%&__1D9+Y8}|XiO*RZyCw9g8N`X4V06d3qxJ#pW~ANAxGuSWD-zi-}tzA{`(02Wt&mOW>Fhr z%>4p8|GlfAiStt+tKP38ceJ?h9{OW(kAklU^ST{GfmZ0D^xYxjT-$UdD;AW@<5j>- znTuoO{s_j&SBVR6Z-BlWEOCQ$FP+b0?OhK-k{C;@86cE|ULIPF%C@+gIEqXgnis;E z5(bJqJuSeuH#H>R;dFxYKb3C7-K522T(nNdDBLOQJd546)!ckLxRbI}oq*6kjK z<|7~R>3P#anI>R5(SgSo$p?k8c~uv`mQ2I5j@EeE=XZq8rwIwnsbPQWMi*K8*pp($ zYOsCK3xvhInI$Q%82piKmOg(h24u@%y#j0+b*Kl9%+@4aALa%eA7m7DTvU&Gct(90 z&m4>GYB3KT_cbgH(8p%0-Y^);mIJMnXK4olldxPhal4`$t&$dE7M>#S;v!{08~TO8 ziwmTkBZUAz@_-JU79zp*Y{~kOz9n!d=EmwMWJ;Qbxu5KoZGq9cU-9ho)ilIHu%sYe ztnhWdgrFkllx)~b#f(9lSqdn+6b#s&$#LZew$Pb+-V6Zm>4^VU?2X+u}TP-b3 zqdZ0IEnw*&Zqtv{p%kbNR$^P(mR!o?AIX+M=*o`Ot!qlR@Vu4Lv#>F>4v)gS?!5V_ zqAfw8ov8cG_+xGaoJ)k9>YX?+S6%eERA>#s`oNx!#-si=p%M5t0~-<q&kBz)p_ot|cK2~&qistdvV4(1oS4hwScY7+m)pOG}TNzh_A$XcBjg z>4Rf?e_z!)b+EcN5#O0N++tG!U3^f~3;$$NYLUO#hPt^cwW{i1EGhQrBkW6>_7B|) zpV2jQrNcpKGVnQ2FiEk@xo=KM9*0p%5}ZFQ?6)`SY!cLrp`H02K>W~L4Ixp>AA#=D zkI!EtJP@{BBO8T}lcX}_j8?aI0Q*xZ%Y3xlx}0T(uOShi8N%vP_sv*!e3MLIz70Wf z_gNy-M06(}mF&u8C)`Rumzkh<#l_V2DgCe+n9trtD}DhPIKE&NWImb=N0#xk>rIoGWn*`j0?A-VvV zQdk8S!H`howzzXONP5>JVc6lpYRMindldtU*XD^ExcZ`UfI!Kvt^S6Zp@!tp(oThf%5`DiVg-Wf08oxlTfQvmf5g5D&5Bj}?@|8&Ze3PiLqX~f(LeOM`STl6 zlgb2y4^Y`_DhTLcwO&E@9lUHFXc>6jNzhe17!SX91?Dpk@XL0eEh?WV?pm7v5;zlWeQEpw%fD^Rpgvkf~hG+!M)eC6muOd;-m zS4W@{&iI$PC1v*9HQMq)9S`ZdyOfv}F1+qNEH?2zb*g5{p#Da+6dq~0bvKk{6u$0f zKH}CEgh5vUt6K(C|4Z6ISB6r4v5F46cC-^-3amkFV>*d>8DgiCbS5cu^9VqBD|=N?xcL{c zOj~u(vGw`1JE+A$^UI(LT?kxGa(#`8KW)|K#adXX%h;o3G0PeLDmoDKuBu%Wz;C$l z^!(^R+%{@BAVHR*Jp0D9Q7nN;&%TS{D}REOmSCV1OeC>DU&aYyH&ue|Ls|TjA3p}OJ;Zwq^MC8n*f~mdDONujIUJsxs$BGqkD9S2I z8T>^rDy4ebIgT`|K^cr*-j)NYB#?w4V1GFUK>tC%pVi?%=s3|rl5q2r_*VBXuay6l zUmiZ6N%H%^tLYEaU#`{K!3-ysn|4E(q6HJ;R-?q?Q(yC1@^!McnQed%9`)}s{P@1{ zV&jQZ<&S{)g^h>j9#-CYoHfKpxGUs1fJhmCRh53b_T!_42kD*sU-fJUW)b23{FOz{ zVptuj2P$X)`uEzL>n$7mUd9V1ElnL4Sa=OKp*nw!`^B+9iuP$PyznVmjK}xYdk~d*!N4sC>})3erD^s>UR+E1 z^-fmYwu1`lDa5Uxsh<>#P9RM{!0K{?+S0rNDJ@pq?wneREht&$%rI((32NXtU|O~Y zDpJ=I#M0;ufq==1t1zZYs89tC-(R|6%@Oi4#js}TsZyR%KB3>`_1yFKraWlF7e>EN zgzWee|MXAPa)SvYglX_T#kP2at~{)N@qd{5$$uz^i8cKhP|jtV3*#4jdIfyfe00cC z^r1?l%WF7Z@mP5k0>V{>@>+_hS&pN&Am4u?ElUiR$y)Y%skx)A`F8*oxbyNr6XTl- zU*+%ccIXtu*Qq0ygnod5sedt{It^U~QjiCT-01id`Mc}cIbDI|JLU}Y1_3CDn`4rj zR8_QWPYvj9c}9}bSaRI00P7vZyV8w_htn*Uf;|vU~>Yo2{wZe50FmrB~E_M!Xl4X$h^xp z7UZHtGSkM;!>B8jx#O2;siuQmOyS;eR_~BOtG;(Obd`eC;_dlOT>#Va$`SOb@^H6j zrcKVbtfj)81W|$6S{#9-sjRKj@T|Y#uOI9m1#)YJ9k7>>@DO<9YhPv;>3ky9a^YSH zkeO5LOYBt6sh+%5#Ijf_gC@oS4R=MWAjAVD5e&SEKEYeOf#mmwY1s0ikc6(OgaHmEL9^?`Rc~TYf7)K1@v)K;9q5QhC zsd0*8OC98j>pnUqgjh*on7w_mBXMOG@k-#-jwFNPu8RF9cUeaul5*Z6b^#e$}! zYEagqPVSQK)}l5Hhw26O&Im29_FkS!ooWG~ zCq$S>4$;g4V_rEi`CD_62WXUGA9PR&L7HNm8Y%UgPpYESGAi^&mQ^Mt7cg|2-mVLx zf(^3jd?CtC+HdWDE^5MPm7_Tg)>7%%&x>;)7~3g=b&u}-)o3uGGDG}92Fw5(1@|DE zK-d(db2V0V53P&d<>8QVZ=5D|L1;|^s#3iJj0!Sq_e}V>Bw=XQ9UXSOOXoqJvLssS z*Hg$Kpq|}=tBI%ie;SHPV2IqINri4(*8MO#LAOzYdeSVKso7@MSwJaoWHoOdK;^Bv6hg}js>S#@?8qAh9x?L&u&wB zU^ym{Qdd4cP|;Ko$Kg#+iHao*Q!X}9f0rPh4x zA^L)Th7|irjjFVUdRgYim#btzmFirKU zj;F1dcR-JQtE`j|&+`GjNEi+rf=y$2+DDkMBr>y ztmzQ&t(wURJi2fow^M%OrSsG!iQ%U8*TqVS#De6*SSY^1)BNsRd4U>XT8?!pcnK9+ zt2%9G<=R{5s0y|6H#wiNG@3oPSKbuAxbec~DJrRI%=TT3u0@e5KrzBW4L}B~PHO0?r4KaC=zN4K}^6Whthp zc76w)7zg2fG7Kqyb$2QvQ_?(Ep5&WR)DL;NfGNOspWK2qp!~vYV^v!5y*@zFME6L8 z9>_Tq{UK=>@<5JXOPqhFlmf1ZXOlgG9@~XY5vqpj1Qp__Kk>Wr_?y~?o6riwS_)6< zW!D1$;wn1-e5R|1q$+@Kfo&@KIM%Y?mu_L7|wj-01~T5qmdMuax0z){(l9n^owGZEfWFHW`m}%;M5rq1>pi zwd=IXBgsXY-QP07TGI<`R8XtPcAnZ5+MvHPR7cR)!Az*D6p@vm9i=rWvN5~%F*hrh zK!7G&)TqL+X|z{e>?Mel9F*kh4+Y>+8wCZ?JtSA~Gay4^wiPQ`4)UYuI> zl;LB3gSFPcTGLat#0pw(6YiUw4rE$ymavPf3`P)MK?lvJNp^G`%o#k~LJuP+{Ys=d);U1J(iX0(z6LIuqh5U}vi$T^ z$h#PK+nZSuE@YpvZi8h)u>3W z6h(t<4xY%MUv*BPGdAscmH4#|3o4HMd`cUYqV74tqFaRPPYt^dn~W#J(AuD5FpsR) zgp1Yb&25mrXdYXG&<6A>HB$NNSaBu{jH7ER!@|a-@{z9ceLlIi9KIT!-lf;sv{h?&m+0~HHwj|co2#8k3*06{Olz`BzPzV6p){;=4SOn_;0001_002rK zXr`FTl@=hz0U>+-?nm+W5c&Jr2^%bvEq)KUfJeDpfy_rg08zlja4RXVD@s{lDm+R^ z%99jdna5~a)neQ_3_M(<4MgKsJ`qz}Ywo=%bwb-x#Hq?rR_pN;1TSPz5h$Q5$t2<# zLIkc-VVx>k>B^j)NW7(Ye%uM)G#pzopcRU(hEg4J<^fndt= z+MV-F&Mt>$=u>ygY~;O_tz`UMI{GWWl2u=|+?h+GzWZ8EIfmFbUGQE*O?AR#@2)^d z+#2>y+uIrRaKJM;7%xxWD>FGR?k-zpxll75ojbaE{QR1^YJ6u4KB!!is92>yylXP5 zvU{gbR|S8oO2%^lG<&6At~P_-Cs2G64i1yX1HZ!<{+O5FmONzQe;h5$W4b9z=0Z8mT}uY1+WWk z1TrsyKlUh%uy@gH0zY#OM&bEtVkuQYS>UQh8>>aMsn1iBd-V7^rI(0dH(e#V?m0LT-j__Y+`sMiN zMxta2PHu~gxmA_*+Sq!d*;C>lC+^9*tZ^&so}r36CS^3@(VfV~+$0Pj`$9GzZ>rgc zkRj_7q;sdfVK3Zmy-wvB zYh)eSjT5|6Qz7xn@}1I2<5f^r25z(t%T8+{5t{QVykVBIr;~oCD0OzUWH^c2df2u4 zA#Gs&tu}Y5vi>E3uWBo{mHX5R;*4osIeT?kH0{J87SQ=r&Uha<{OWLBkPidO2`$)MWgTvf9Ubcr6jKHP2mp7nWg84} zZF5qX)!rBH3U7nI&00-NMrdTnG9%@$p*w-nQZNG|-Yi>lPt&ZB*nJRL%Q{os z$mFK_fSO~}Y#0#VMd5k;gQF=PnH5fmZF1IkT_r>ui}v_?MspbY@IKOiY)ttI-+mHa z?1V{3!!;h$b_O>9z#!SICCX`d^V5Tv)_YR1mfYlzPEa>DFrQdyVcW{amsq1uCT@y z-B>eJP#W4>a0ZF&w>l(NjWxi!M_Y=uw1nk%Db-k$ol3E`?QpH-xXr35K)S&-ELG|* z6^-43SZ#`7gI&9|DQ?@rA%2{XfRl^lK2i|ti>sxj!lmutM{6Z+!0}hgL%%xk50D=u z*txm^qSA&UKXN=U<{M*lz!2GF9pVycE7xB(T9~vobKFqgLZYN~xHyzin#wZ!|#q%QA9> zJLV>~Dbm+|_)phocaMZ;&?g_HE2UI@YXZ)j_+F{uHDH8}Wz7`VLYrD<9LvhTk0oyz zfjJ_=M0+6ymtMQWV%)B}Z=k5n2Y*6NpRr~*PL$tp$Q-mKE!Pw1q!)0$-K>+tNpsoY z#YD}!Sd9>tbtkU;enfz{eFJHAOFA$kLiiVZ9J{_#vD6w{Xu%7lr(m%K$~1#@`IX(p zfj)h>Y~bFgJSHrGSr?*%6Cvcw-JGq4p>8TyrpEAbdu!%)krpWz3%Umahk3hI%~E!( z^1N9^S=}@No9Hy4>9G?AguD)2_tVYsssR)TJn{arNY)AI9x2>xHA$J4EC`~-$glAr zdeCty|G-Q1B&|KWkFzqn*0)Q=r%>))BXgA|N_Y_oh-j<5TmAyy?$DekK(0Kc+SYH4 zmBz!u$T8F!rhU1VNq^u?g>sa%Tgm?_Zp(e+2>K%+#L8DAU>}{3a`#Ub0#$%YpUK4J zPN(7Flm`=#JgqVttQnh2+>)s6@Z7Jvks8k`$k znlBp-O~5Y027V|OnOPVFAar*~GFO3WmWfDg26RZ7Q}V|GR9;1|nKUgdM?h>&VN@VA z^U^XZA|xUxhZKu+=q*nEjc$c7`FZBYO(#(+M#(g8WpZ)#q#iXW8ZCjnor5*erIUm- z#$q1Ivqzlz84cYIR=Fkc-1KX}IL^UqJvOt5_#up&l-^C;?sL*M(Z%Kv3f#`(-b~Zg zO-~x5tF<#;vowjD-kaP35N2ofauOfSYsl%&$PI2-)KcPskYB3lRZb%56`!R^==3(6 z06~xQTTWdeq8^`P8xcoUPwl619L%E9CQp5CQ8#pSRFrMb{Jq`a!2G&r zggsuMf)q`F;O~bdTJK(x=#-d9Z<{`^*@D|oO_=uK(sO= z75$$ul#|-QXl|-ayaja`RpP|cH2yDF^YV>&66R6W#DqUQ9?kJQckH%!+S+vfgQqyy z_NoeSl5=lFC&sF&>L5roH_ac5s$1S08XTM8X?)gH*^#F2Gto8u8i4?Z4LbKS>j0h0 zi#Rn!uBY{|gYbDpFo^1ZIq;GS?!;#Mi^OQrwy~5RNiawHYww?tq~**^<+0cvbUtuZ zQ2zyz=6wlO^EzCpXE-iM+OMQ@`4uz`G3n%?MV-C#&Oqq20$hLTvyL3CZP%|b=oE+K z3Tx;nnya6JnhGMshH{86=50jM=EM=SI^5khP@U&%(EzP9p}FD`a*av{C-g@W)XonF z!)NAHi*f$B1B^ZlHKr!79lW1T<)giX`5ycbQ3xHhmU94N^c=7^S1yW&)(lc|ie^&S z%|a@TxqUbuytSR*!R*Psb%Fru=*|Ei6>nXkDbQwjdq^@-OxNeqiX4XXtP}~mR-WT+s#tuc5 zPMg{fD!jLLmM#u|cl_A_-5KZnxFSMlEs5s>kurofwDU7~2Y#)|<$Qv3rk=~{09l## z|IP@%VMIi%eZo*wFqJ&0Qky3Wxkz7hclirMy%unofBYog{P>6b>S2NV#N-JcdOoMi z>hVlTo(kWZ^{4}+QT32_E^pOo=PDvlE~j?)3tXxz+iTv866_q3(0u+a`$`=p=eGvP zP&nx39ALl6s)*?RsU3SqMf+=ZA%i_~V{RLR=k>eJe<|deyU)F@>l%#7ePaW1`?)Je zv2XYQJFgLA^r@?-33)X3=DX`WHy6&@_u~=rlGL*-VV*FWW{|I)9rLt5`(Ll~A2gt} znJiS=TLe1e29>J5{SSs1(E3b8peBZ=bo=TAr+-%{ou4x$35*)(by?yaP`!6rA==)y zb??ebtez_Ah4r`<^-gy|P577brhW;%lCn3pxw%gw&~u9DC(WB*1wib5;*<6h=~+XT z4X>s%U{~Gre@}r%Y=<(2t4|d%U;kZ0Uhs`-Xh5oBpXe(%sg#|yK zKJVA(izt%Yn@^j|6_res0Le?+_)=+qZddvl!>XYqNFFvFCA}IR!vGmpx}jPsl2C%C zx)$FFhHx(qFXq3Vq*-}$*e#;tl|y3txTHTyM)LQ%k~cH=9Y&ANk?;4UjmW5=q%O_< zjNbsF|azuX_}G%S1=y?WkxZ1bjNI@k*df5xs9{yy)h0JL00$csU3r zQa)tP+VbA@Ptfo33R;?{1mbHhq&ZK|8{N zPTiH)pHDtS<@8XYQJcZ!qFPif|2wx=i35^1qW|+h)~xG^=UxHiyHVp%5&y|CM>!Ju zYuDM=TO&XEV;S0fs?;_y+VA(-G(|%HphwRCh__Maby~%joO;~@dY#c{(}Lgmq?}r3 zqaE5rP@PJk$Di_b+&gA?s_FziDgC9GCL=c2nW3khe})@_hfxuYe?YJFc~_JL zHtpxymOofZsp;9T48zW43wPrWRs_HHi$>2LckPi(|x z46UJ&hqUNET$!uze2WwpOl~IjYf6q4M{qs?`eo1Aw#docqNrI*j}51zdcQEKlc-7SJM9-!x zQhMztrbcmUQf@-b?7r<&+?wnCKIkU?a({V-`X>y$q58$qCDTx$@Ck-uLiX?IkNJEj z4%FEEMOf^gcDmS{KDgR`WJG+wt&G}12bk;Ed=S>id(##227zC@8T+|!uW;b(akyVE ziUdU7)L+ZPK*c1(>N=@d`u}1=-I^#bHUZ$r&7J1}H5_rx=od>G@I7~RytfUU4wot1 z`ct-nia$$#+DrXRgu}hYdo-23Z!XB9>IFGSOe zNc)GEXuK;|_-hXFT;L5NA`6|DgERAaMj_zO84258wFROi zd)*|HZv$!g^TKP-do$0zBrlkI22!<`xJ%m$+2lBr&>9G3uS}Qc!I;R(wlV@|?AC$2 z1$%8@z>%Ufz#jIeWTOAkN=pniyz7gr;W}Me2MRBY0U;bLra3|?tipuC(b&#Nl@V(` zhmI;?Ggq_Zfhj!a88RD}eP(!}*WyLxBMhT7;CLMl#;{u%kx-Le7vs?SS}mDW+hFl{i*xeM6L&Ta0ZA3^#rf)eRcl47;v%#5uUG@sOJ2tUpb7JZWXPm80xVM;hB9?)5I`z?Z=gyu*0f zDpP`u5U;a^s3~KDt-_U95DUG>Pm3A=3sUm11ZStvQw=w(hFy03dhbYDA|8 z;5LD-;)KK3kQ6DzLq)C$%vgG&FfvnFP6h1ba!e^d%cf1s3HYWa*XLs^G*U8*?8q(N zj7pFG2#5WwBYlg(vd1fNo~^ont=2jLJd#*j5fs287Xp+BLT)VwpR9CU1R%5?CydNe z2Y}oF^hYND=aTx(sqOP3j?WJTsds+?<^Kk!uW)n zEZyw(fnrGtGAo?x3seEz!Ix7d%fMt}+Yq)AS1+~=C6gI8h5Mcf6&+e(<*`AUkoxJ~ zD!?MwY5=IpyMpW~&|ai~V#d{) zXB;TQxkh!gpW|@`jy^mF3EnRFn6JmT9ZW1v;mlYBzH9WMFmMX3JLtf`?Sm`fOvf{> z^sBcf@eJEI-MU%Kl))k1!94<6HavN!p#hvk?j2P$r06{_>5>Vrd)6}dbV-TFTTJaS z%f-T?c8%LR14J#KXA2)lVZ#_szK~V4?7(ThF`I=#wq%c`Xv#DR*_J$emrF&h&09+y znFeRB`eT-7O)RFh9FEx$pBKM0ZEf`nc0iDt3Zb==c0AM(K0P^fWCc16IH_{?*NLwT zg3Sr2` zK}?e+0-%6V+@%4%&L(EiS)v#KmR#0NvXBl_w_H?S(`%@PM~$Zd*uWgM+B+ ziM0IB1O)n!H}aV>d4nmWqHWI<4kL|(&sCO)Fc{o%BR6DYc}DV&???1aOD=+CWP>ar zr3fGsz=Debtz99**6F}ifb9u;T{u>tBBX18faiS_f`YRsN#y)}a|N*Fb5$+TLA`nC z>O$*k(#X})2yL70hUyRx$ckT+f-5_hAKa?xO3$i6u4+uJLfIW$SJB3zC{p4u!w>^? zO*bhvF1|iS1o((Y30W~RE4mga45wB)*k)tveY0&ZDdyoFP=F#BSEarOBYzXZN*R;Y zV$;DUGe>~4Fy++M6_%E)*0AHL1?0SJSHAxS&@115`4h^n9EQURJTD7-I4T&x`4Ba7 zR=gCnxEOWb?8)9L+k3#--6R5*upU^IM#mp=9xwxp%~${&%AA|_bL1A6M-VcAF%z|d z8|wk{u+X{|1pd_%G6!2#bk{x$P~|MdID5|?>E(23!7G_HMYc-plt(%Fy)airt`u!^ zm=95P4Gb~VcXS-si$sN94%1bZSbE4q6b1X1FG5FNp*`-tFKzAG~MQqEugh)RQi!e?Qk`b=QwPM>)=Rbqaa7NF6NZ&RO=&jXG(cL(BrlKhbs}H6(Twt zK#pLVpr0tIHPhO&>&+}H(yl)xvOV67zm9AaderB zhGByV`<2r!K_4m&OTv_@pQu)G#l)vps;!e2fC1sB!s5+jtcY4j(^lmwy&CJ~Fod#T zU?j=sK*`Qzas+BYm&!E011m3kW^4sftX6y$Bp8yk0CttjM^Qp-Cs=7P*+ed-HK2<5 z(tz2xumYz80@lOAR(*inic11Z5XK6)mDFQKLy$}k=EA;gMIPoGl+!{O`~^dHwv!{Z zxa8w7~R9;=!&zb22OrE&Y5a4@({k5>>($zSTPLYa@HQEDD`EH z)EuT42z|x#KQ#?j1YhTbC>b_dJ1jpueu5TKMu&N#bsvQZv2#j_eZQXWy$9ys411s; ztGTgQZUIqBLqlHysQX5adB~kU0y_m+JYk6?v@OKM3KL`Qqqob^GtqZ30E71LqcUQraa1xLJNo3rimb^&ACE&qRZ2!HD7aM+E);KDRA!5M*;B? z8$JanQgv*LkqPYM`BN?+?MvJ1jMpz$kQb+Cu%9oWb;d5cmIt{In#KI>2Hfjp(M>-A zj4EG0Szs-uN{%WsT~u$SQ8)B2so`2|w5lboGu?qd4iFRC&1+UM3Y4NyAY(tgz=6go zfaPOdi4W{%U~7dlRFKXZ6llgB&kZ_-oFB+gPAjoNUnR3SH!MgFIW;;j@U&n!niy_G ztr9K4!=$n6Xt&R0O*G9lp8$lF_iVB%Dk}?Zq}LJQOX>k(`atsZpj~|IRrv&Mp>VziVgYPj@a$i%uwgfYw?^(cMd(L`K+TO&~sC|`m>5tAFo8%VA z1s1Y?=*Q{13q-N)T)R4bC$1a@WaSo_=awSff%~;Cx?94(61SFkD0~G29gnJzU4Y1d zJ&oh|d=k=jn?YN)R1!ej!^TbYbK4_1dUazn2r zm-`+k4O79Ebsu(o6jj_ybIRB(u@<$c+MxiJiv!2Y+C%ux^=}L%(uq2wc(Z(rVDw^} zhuOHcSN@e-4=CZbl7VXkAI3912Ap3i&+U(;ra-NZxsJ0Htt^WGQy0ZBt~NWkTIvpE zx;$GY266Q$bk!msuu!}>c&1Pf_x+L?S&68O+^bQR9Zzn=!VYF;oW@~EdizG4T9JF& zzp}thMxWr0>`c77|^!jr+e8e;Ow{*KpEI z)qVEALC(R*=it4F2c-AyOo^;~ofSGr)fThsrBkRDkqeUzib-<{HRc%7M67v^6jw)T zvfYM(XZYMvQo!rNN$5?1;wxwuIfB8QO8X9l!J8-p4K9qY^3S_ngi`xRezVemSnhpN zhsVQe)4O6UO@c|9vLF$e#d;WFT^R;Q$mZEg1D?3=xGrMzU_5s~?f2ZW*ebuAoT` z#BV=Ky5wqLbqmgKL!<|7)QDyZPn(N|oRFSsJXmMRIKVtGCJ9?$ZRgqWsETI+$UG=$ z!L2BqMEOaRtA;U;Q6HyFT*V{yPNwhhabd`4y6}3kHZGt)YZG`=mh$W-I$+jTW_X|a z`%wS8-=B(7yNEt(c_LfQFbT0j%vAlDgL5`Ch+bc7c~E-hdAn6IYOHrK_C8OGO$O}C#0qi*v=>1U;+qyKZbfPhsER~8 z8+7m|yBkzwR)8#6N#4MLW_*>C9Z(Cyf#y-MijUp5U}4N@aR%>z6tX)1$7$|pJpha( zOs#n6;%x=4BMd~>IHMkSq3>*!x4k9+Z{z_q2D%pyzF``8+vW@ejP35Vhzh^k4z7>y zF4b4D^zJ7v(gE&g-d;ff>%oC{C#pEwYe5P@-ewD`xM}_BTlWMNOp?6PU(Z*pA#LrC zK(5CE$sqkYMF~2ZG;sHvltH3rIm3&7d5K3q5sRgaPFRa^$!s*;36}q9T#+jb1pur0 z;fZnK1B4eJ5Ke?jdrMq}STQW+kX#Egu>eM6qdTm1b+oope1r-vNq6ZiV9Q__1s*db zGdZjdaK@llwz&elpfkXf7cKA66mG=5$LdIT385*oV@vJYPgX#8HIgT(I}lwwRsyE(838OQkDc$*TIGEd=-T#< z!a6Ui&cmjy8zgdE$KURi6jm?|?Vq}Ra#-~x7554>Y}Sa!@SQ0F)_75qlIz z_iAnXeQ+cit34ITj)|^nE7VhOX*ojV4YI(Xkvyn=*mvqJMq+Uxkw-GJwnTOa+pyY? zjKbSwi>=29F4uP~!G~d9UNtYPe2DT`{D#a_bfvaaV+Gk-uae$jN*Gl=+yjHfg}8ur zk+0sp7VV$~V)dzOS?=4#*lE2+{T#DS3QL!@gl_h8&bNV=g@s?=BJ!At^X zh!$fKlv@vwA_-beN3hpX6lWu%UkW=g{-BKk{L2jVw5@^7u0)Kr9&y<#epO@`c=wZu z4PRPPcElJExG)whx2QPi?PDjW1@9tajmOC#HGy_$_RPkZ2&nuC&rFB13Jw^S&d@%5 zB`bKF+QFEl2{G1RMJKVVJPD}HvF4gHWO4R8;D!Fn$d*%zV~Pau-4 z&W~AiA^F+dNhB+bQv|pnpL=)gvv~`O{stXC!m}HB9+`E}zE0BD#7gISafyUZD{=#JUS=pE8|`ZfBtI_3x)}vfD%FyU&8Bk?*bv)rwRTCD zno&W<(co*y?Y_o4#1(#>!p?vC0qYc3aS%X(ZeDg`y$GO$r6@`T8En95lSqPU$-wTK z+H0^qi-s&OkV|QiA$_?PezLsS5}xI6)|1Rkugx~VK$qiBcIM%TTcK}PfJ%IbL*Q%d?I|!nfaNY$ z7o{ykE9Oghv%%kcE#$RUx1>RCbXX~jodI@?_wun4J#hI=JUs*4(q6=X>+au1C(B2M zU#h9~SZRCxc#;hOs#VFG5jtd}X30lTlQo&S2Twyaw_A%?#P?=3D3CM5eowr^6sPDl zkZmtyE1L0EW7GjmzwuenQ!kH!dOzyX=^n$Za%rdU&^ke&9p*gKSfT&XYES`|&u zTndFLUj(Ppz+}Y`yt8NIJD(0>MqJGS5@tZTZ@RXX4vou`nyCvaKo`Yk2g;<-6@Ej= z5AVE0Qrp4ye?-B=kSZmP&VJ5l3F-LIhbW^(2Qs7pq@?kgO*ifl zi$=@RDqW!XJ1hV{K)}CKF!r)1=h1paRGwkX)t5@7sIJP%`(9=H()#fN^=@#v{iz9f z(@6|%XI!jfVg-ORQ3Mo#tR*kci4Nw`9E5{?BQW3eX8hM{#U{@5OsDtpBo|EUdd)V$ zI`Zvx%P4&HH3MYGLIwQa%e`tU+`hg9x*`{X<%iX^t*KSb=se zsq?19lvda~{o5$aDJ`UwF))`C{O^wq^sFfO_G)p=PMZgZPROKCKTYJ-8VG)QsPRCI zToZEzJy`imZL1)8Gw?ngc|oKH#+(nr)P7VM+z0Pmh7T;E-y-*m+mqGp(-8nJYP7$z z(;?W}TBFyR_04!h6Hxf$P_|CJ-hi^oY8VkL#eq_YOnI%boDw43{Q_T(lDYWYYfOA#%f`)H@R%BGS%VH6h<>6{ z7k`(8oqU7O$-FCWD~l6p%apS1Vn9nr_{wde=U?kEyA%42+cCGfAJGlA>HT+PoZ%d8 zRJXXS*cnIDixDAVG!9isz z8EmGc3@~s*fDn^`%H_;+?Zn6jQpX0P zZ*B||(qv1|N~M=D1Rh`Q-=#LEECW>Esx%SU>zK=awze#;?XD{CuT0GP{5{}2!|1>v zv>81Ccl)jGU*wHzXalf}ZV0YC0gQr2>Rl;!KDzwBRYeHQDwZ~B6f|+tx?2ox{P1Eh zXgXkQ=!t|)UbYw{x!4@oT2S>}ByN$)V}~m?UN@OT zN-p)ai!Pjj1_lU8U8W^C1ograI7{O@q)u5oHM?nlNwJHt&AMbtO68M`|0(e^BY2fs zgNnoox~E!TEsgj{j%PH*%!^(Gx$Axd=s|tYR-urlW__ZZY2@(&pBalm<@MP&mHsol zG`|{`#ZYf{VH8kD#MH0+s2S7f2#I1=E-yW=(!gPw+HchY2pP9UUOm z16Mt=m_dnb4fpq6CWJlvQ{UwXWUC?~p1_cRtvI2#=(t5swWpe^S70!va{*U`Urm#) z2rQ{mN%tq^1a7tGHSS5vd6Hxb(<(?Qk-ceXX?+VbS@3)E_`EI%7&@7Sxhv+-83)#_ z4vu7A^mA6ac$V&0kfJ1M2ZG5s=lVtov{35iWX+xiLs`pMAZXdmrsQfVEqesOr^<+J z$hX`StXZyf#H2JGb>W&)xz8KlcITuF0smC){EQB#LQ4di-}p_<0I1ld9igf2!j7A#mC6Mu*Odo2Zf`@8fge=qU z6$LRDc5cm-Jp+HA=`LtyPh(IE6n_*TB?KG|1rI6ku8lo~ZQqp;m%bX%8Si!&Zz$+M zXSx-zya`?LiCXh|GInSOlM4TpVY7Zk3MBOAar|r`o*@Lb<>Nb}X+mFmUIe;^A{^7b z(*3u^q-Eur2S0%^>FTJxN4557#4#B0G^~so$Bhwn>@ayVybS}qU=@^nCAK6^;%mK& zYM0Eqhse7Jz%P4LNc@_1RPQ<`3)=%c*zeMai*aV{wd6e|7~-$&Pok$JXxrb4;nCZ$ zyy=qpeF~(io*O(cgN}kQ*-~7D{hCMlDe*V3`a-dG(3>rWsVQ>pb-UG)yxr;!a+@B8 zxZ*}8%f(!kj+L5R1B2o7#)J$p>|ujd?pQn0;O3LhT;YEU1o+MTe5HpmU8J1rCSS$&1~Er1y6`3x04uU&ZNC*V&1om7Or zC-dQk1z%_W^N;v&6b_Fc)66>?{DLyi@fPsq@w9j<28rg}ag!cSRNo8abvMI^`hz1D zhHr%nm!`zt9`ImG*=Axpqn6iKEoy(DAxdUZJ7*E$$msx(1oH|fgASoN0)GQsFui%5kM)|hJ1e;9P-U)hC+2~s?w+xw@>AzT{t^*p z?Gm46W*+&~_7O*M+lQqWQQxSplFdVlDo*b3K-0(hI32^YIPEh(gPM_^>+3^Qd_8c{ z5~sXO!H~?F=RGC;3fsgQJE&oJ$&Oy;6K3_y_*o(BfCCrv;Lz;O5KG>kMR{NU4}QC6 z{2ccGxE)K)8p*fGV^N_l%wRO%Mmj_-5c9Ykz*Y4$^P3H~wGafz@h2h^6zzglj})aK z;}oWzd-zgeB)l@4h~3aH;ZmvNkUY@iiOHrEvtwcztk7{0F&J7b-cX% z9@$!8rl2D#E5iLDYmrG8xthEKnLNS|7>O0Bm-65YH*`%f+cw4YUJur0wadyl9kbI= zSS5&_z?!ngI0cL&G4&u@$9f;H*afeCPqKL5Yjz)?kvzYjN{00^?V(3_9f$Eg#KTTa zkaPl=x5Eg&@F+N9VSq>g-~;D-pf2&{6eWg84wu@Y zWrr!F3LgipqisJGIEgz1no*Fi2`eZ==6i{B^#>t@xy^{08$uislRF<@o60T}(~|NO z-VK%c;`yC$oLLSU9F|kvx8N-ea||4VN&3}a&6^4$@Dm96;f~>_z(xS>pHyXN;&3B9 zhlbIiDt%8oTIel)XO3}l_-bYy^e;oBg^QjBGJrlIt350>V^FrpdO2)ySvi<1;tzii zu6_{zaVw4-Xs1aD@96KpV|6t&7}4EDy}k0b%guIh zzcx9Hy99f=9`Z)hAw=;#VP0&*s-W7QoS~cO&=2wBT1TE6NNphu=%8qxvTE%QOf7BB zO2`hJ-R!?YnmU-958BXKLS9yks1Dcm19#NLMoKAp=RBQs4UPC;Rb5*U>Sr?L6#huR zHf%>6gPBd$qNMnW4=BLWOYR>O;NVaiP_OeM-bwy$?fRS8;XdChULHW8&h-$W!tkx^ zl%HG|#*X#th88=|@jfW~Z1{-NLEn~4T*?>Z1S&i;4DW63NEn8{unVjlGAwNeXbt)* z+yQ|6=*?{nK17XCQ*HSF+g>*lXwPSI+@JmvZ(nx1l}|W-a*R;q4y z1>^*(-BagXdD_MfMQjmKY612o<4e~mUWQQfl(g9wYq@7d-iSMq7`g~jkUvB>(LlPIhbVR$ln3?Y*uV#28Ns2N zgqZ#ZVJ~>x$7p&@K4(Kx#gD(!SG%l4@#EiDFH#~-p+cm!e=0k2k9$t^oHkqjGrRA9 zP8Ryf>_;A*tqt3soi{|jx>?kMqZg|uSc@rEA*ny-dE@%d1( zgLcoArt_~~Y(am%Nk%U9A%DQeax8IDYX>_CK=1<=+RmJ4Ab>rSv8#8z8f(xZx?Fwk|b)kVBXq9kuiT_YU zuDO={C;|SyA2Y&*Z2rGkWRA7{j>3dhJ&Qii8%;(FPFCJ0pk18lR--2_4AZfh(E_-C zz=rF_^sx<4UoL(J@|xhkH)Q}}^6=^b*`XDB_ZA8? znR@vR4_n+PnSE-~en*~lMbX%!hu`wf{FzDp=weB6R~~q=?PWjCEw()BCD27E^4w0{ zJ(N6O^7m*8XMOae^`}H(zqUglLqF)P@MeS9dFj97&o^jOPWDI6^GW6WI07H1g=IJD zkwpe@p~dJBN_>|%Q$f=Z&G`49eSj!e3Zr=@cDI(6WzOD}Oik4gH_-$1zfAZB;}ic` zELG};)rd%1n@V2JgW2S2TGW%P+g}~>l8?sG{4zitKY&Z8Cr?lc{y;d5RM7jz{``5| z$A2D4&i{?_Z%7xXN!<_m5o_Yf(Z)ANeG>rnKcPmG4f^1(@z2-Xn8yFG3gd+4Cf^Nd z-_y@JF>(FYqQV1e>(J@;|CWZZ-P{)-4es}0lH4PZp7^!Z*{O2SUf3UgOZk=gf~xMP zjg7aLi!;#c3v>BpDm8zw2W&+rsh!T8_uKh$@R}uU6&d3T65ji3I~|+66-rmmuRbdO ztWSb-{PUhL?|kxhP;BL|$esPX4aWE1q8iO+qoP3y{0p(IbQFr^KB80I{~6M4qnq|m zf{U*YDET8|Tz=d89 zHvNuzH?yjJcb6`Ir)=OL^oix_*vchsK_pcopBWEj2XWdDnsOd8$Za=Sdb@4- zUXOLr@fZJ!6Cq8YZxlP8KGMv;u4uNu57bM&)4c*)|MlhuqvuY3epZR23rNGA<-I-z zZAYhRj(bY;Tt&Z2i}vW({~&UZ<&&cRhy%Fjcmz6B4_e<%HQK{>s-q4F-umx5$lxSb zf6gFz^j96-r=K=rlm|Ej{WHCgpr=L^9}zX*-$_DCzJr;8aCLjqzH z65z~Luz}2?l5j2X2!SY@=!tCxjfkBU0bo(xV3DRO#R2gJk6G71^+T`pI^6C70dxS& zTnbmf;0t}s3@pM%7KXwUB<~C#_8FmN91~j_Fo@3m!wQ7~20>-Lg9}>7<=M58iobtN zdT$G%aQ2=0&jau6G=KjZXaGuJ000I63INtY9-34+=FI(m;Qs|5yKrstcMAGK02mR6 z|5b-^Xfc}}TTmZZ=C_BE@cMP`^{!d10DWuqX3G(*@S_%!X?LZ|1s^M@wJ{58p-Zl) zOjJr#N%}O^SiltasCagGzq z7U!_IOzs)LuI2$bO@zUENAZ zC{xbKb$VNGA#P#^_8D3gs`*N+nWc3_VK>*-FO3Q3^g@c2oQB5#(G(P8VS^X6GYdW$tP7)a4FW65vZ^!otjCE2Q)`KVAQ zFz(nP+7iPqH#M?Mr$7f4{>w5jxY+mhW8`_;* z8A#z9_xiq_HQxT3Qz3{NgNgB%EZbHiZ+FP4dab(EYX&~wmzSyDP^!)K1ZIG6hIYRzGR#`xeKxI^esZ6AVRPVTEo%|ls)Y#p0y-2#su?TU0TEfeT^bJ=CAn+uD%YVCxwX+LVLNLYJRDSjndfGovilBYQu z#Z$qDE~hcA8+gM;JX{J~4QNo1>{o>62L)MUG>BQ|CRdhY+f`r*b!82tgvjzeEuqYD z$mK;l*4PwhWK$L+UdM<(yAf@O@Fw8FQBoH+c-Q%TdN7H|e^ia|c5ki-1?ykQqax zf9EXaB7=o_WAK5+`nUoU_(91r#4O;_?#-MMqWVC1L_1BDq$t)|g=3`Z6MFtglqVNh z+mN3@Z+~1o;1`hlpk|Q@c_w9=e|5X3XUlt2r2a2j z-{(6l$wNv4i)*yQ7l)8A{ANhER`x6;B7-}775o}b1iGXbh4ENChYnS-KIVGJU|z)J=d+6ZgrwZ-j1nkaQ@}3DZl-^^uj#EzII>_) zcS`x{%y`HsvYdDM#^kNJh-@799!|=nm}jgl1gJD?TVr(foUUrIUWqMO-wT!G7%lfh z5pb&E9b9Tb&qy9W@qztGx@A_dOiI&iJ|Q1K&dq*!os z0pdQ0B2jo+IaQMQX^lW~C+YlhAwu4)m18zTh8+VEMDP3<_g;ERM@j?X8pX~*CJO8q~!UX0(KqXNx%?4XwPC`q^*rs6D zG@9-B$x@KK!F`g-BJbWIj6D8BO;C|LrFZ1dxbS;3EAH#=B#}En7AQFdr{4b{`eF!G zM5AS7%(C+1Ztvg1UPiE)itD)9Z1Myra(JUscKsUct+h&`K9L))`Q1DC+)Ioumr-w+&nK}y)OEO@NsOi|W5m9_U2I%2xO@LkQ0Pm20DV|X@_KT)DkeCcuJJYYs zGH+Rh0tf%X%S<+IU#LxYyrJ{cre|!LGe4cz5%E~7xRc#-@*ZO z0(o!&!Hcz@M6WF`=K>3z*vJquV#a`2ILKTYdd9O3DC-Rn7E*sWMjzM!5TH>Tm&MIP zV-M=Oju);k2>pqR2CG=&VCPyV5=uOoG#bS^E+pCLNoO!hV{F%08@)U@%T7!v*x-!G zD-PeExU0d%^JSiNQXsg|rRQgma0BTS$2rg6={;Ud3n0b~{MFw-xeNsDU@^RB;6jA; z5ElD-8sKK=mSg%EyN=d$%8s|{Ry*b(6O7K4d;GbU-(evhXq+vObQ<{&L33aMHQ&#y zl|%_{W!io@HNXH%1()@BGZP`h`<2vJ8p7*eV=hU39+@Xspt2nbHsd3&FJf%4$2-lg zPEGk)E8g-#>GVHRbE`|XanpFtu6x5fY81Dqyt84u!-=r9Tv@6v6rSS>HplX3 zeATOTMLR%2u(UO++4e0!1SUhE`>wB`;%Gs{9o1f;h+A42ikz-h>DOuO7867W>y8>R zQ>*6{XPI}FBJ3W|w5&e3(hldBj%;LrZNqOYw4z25k)yoU=1e4&Rdngx|@P0hV@Nl=l zJwa#@APR@T0o>Gl9B$vcZFdE~3O+k=zFEI;2&L{c^1%446_Z?F{YF~Tl)`=&a57x0UwK4<*&m{l;CdG8vDZs^0UV zvN?Q^IHFOPr4YMq%BFtUCa30y?qsSEl;nmz$$O^o zHcS}?JY@<7KN#**`P`r?a)$rr3;kjIMf(Px@tBY#jcz$f&Wb$4b3ST-63mEy@qgv% zynhJ|b|#8P6sf@V|9N8Lak}wO9AqN1_1RQE$0+G(d}r?8JZ^eVPn+7@NqMWd`4U-} z=2&x3Ir|$;zRz5$lK3nCIH$dS)|CDefqcDX-N~9fP6|^f-L>d`C&_goW5Yt*D6IDT z+HdcfF+HiK*l+jcEknd_njrQcl&c(YFIPS4s5au0L}JFc)m5_lPlf+c#I3XY67}~_ zeX#fp)kkkW!>BRxNJSAj`z>75NM&(qIbHBSYrxV+f~wzqVKwl${yXKKq)Iv$EjWob z|6oIZeA|QAQqcZ4*1xJ)shR@7KI;_axxM9XFfa+lBBK4_{+LqZeCbHgEUVQ>Cd03&Hq3oZMV;eH zCDUHpecZ1(;O&p1a?Wkvs)+N~9<(0StQV31T+=lv${lVl9;(Ah?iZnVZmTt(3BUR3 z3#j^C_49)te5WF)p8MhG%BPlATo0O0TWwCH_)#e^LpFr!zl-Y8Z&QEGR^HD4vURB` z$|&!Q&+)t%ZAV3gv4kH3RpOubfpW64+As#DbbrULg}z5rcY1u=5vdsV4YY`V`cvlM z6z_)7EA`!b{7=SKCWanOLJP}ZY(87~72{C0{d5+xOd(b7=je37|L}#Ja@U6;g~0;+ z{KiLq!Ug*f)89U`0M#FornbBKPNt4e+>hfgCbv6HAI}VZI8|#1-0(^n%aQhHs?ZN3 z*OXs~jrlgdZ+-X2DIVdZLI0AnXrGdM<4wP1n`$sVzSPJUT%G7X^U479IK?9vavILB zxsLW@lL@aKh;+=$defhMQA3_lO9iKWJK8^KiIkC)ZvSwtrOAVTxclsAS!V8VM3Him zuo0gGKA+PT_fsJ4-G3g6WUGI$p|TgkRg)+_O=wRz{%tnrM@@eu8l(7|p)d#Y9L;>1 zrSG+szWoXc4bxyNO@6B;DB*V8J$0Tmw)|%wtEu7=9@7s<3;)ACq3?fVz>sq7iEg}Q zRh8ucWzT0oQHMq|hkhqNu<@XmW-rdflIw^Nj(_*QR28jMZkG9*7+k3Ikos~arRi8Z zSESwWf2jVoUs|Y=M^&SP1DBulhxfcx8rbWPX<^AatoT2fOu0NwCiTrIHVmE3$HrzA z@MRX5a1cD24i`Ir_Z(ykV&Lo)fP#J!S+&8B)3YaY~d!3 zvosGQv;1egwsFy9g-A!8eHKv+{MK>1!fk4QZ;|x;Qv`$le0jqsI;iY<+02!}woZ+q zSis zkwHu-S2YAvLMKx*TCY2@hI?*e-yfQif*RvfqJ_xRmd;Cng%)-3Zl8hTG2~A{MDg4q z_{h@vNxGBm9%uss?1@bGWklf)oO#PWu^Nn0X-&wd^4(sZs!;A*{iNG_7@s)-(Ya`S zAY}>dEFKcVam)D*@12K!Lap>~^cVR5^^D&-YKP z@g5N25fF!=(SWrAO$C`do}J_UBF0~K1{w3Ty~Zeb^3(6C!9WciU%Z}q%yVrf+Kio? z-j8ueVatb!XOf>Ez^^?-NtNByWGnVnys(^Ngvm~p#4L6?$cO`2GfoqX{6;;vpzfm( z=d5+7y$0^kdn<*kdr<*-K>?;+8fy__NK;EJ3NUdjXK4=HDhOBi4&f|@oc*zFa(;G= zFPxNiU#|VY{m^QT`<7X)>wi)Dm@PiBD)n1ZmN>(A@w09ZIl3k%IC+R9}AIx z@t*P~x3U6bJ<6-{EVpP;IpBAC2`kq~g{;jMhuhe-xK2t)mEgiv8EK$KEmm*h*hS+= z-cX?tAK#QVog<0tnM%+JOB%F)(H#4tS#?+iU_4E-NnmzKgQa5Wr9#lpWfL-^D_O$l zrJdyv#F|?ocj$q<(TZWWCZHqSoL)Xea)f|`Vmr}88xGk0s`x)9R#ncW<@B!0+@Aby z-uQGeS+l@Ou(ow}SUWV&A8H#RB{JCGEk(QD<%tMJW4YIly;5|p?om+Pk#&W-;p>)h zFry@9f3Bp*8!Q^UU#M43@51-aGvBeVx8P2`dvxn{`^A&U?@i>_;~BnQp~?{jC(eUvdIu zRaLlt--{Tax)(ZE4erbkS&y z;Q`N%z>y`nZ0379;0;0VvHE|t|Gl|QY73gvR6ZYK-9EcJ0t`l4sNO8i+>8-r-E=R9 zfS%2vVaRAfn>_L0xjt8LSD|JB!#+b>X$Cc|bOXr)S7M^8`c7mda9kpFr#pv>Pq2XB_qKk-DCh8`u zN||DJW`vn{?o%W^Jowo8h7d=i_*k^KRCBqQ80D)1hV9nZa_Wd~2|0v(>YJ#i{lW)l z$nqwM)h1`b?X>hJuD;`Og6KF!fuA54g(Prar{iL(USbZoTut>M?qZ5$FA$AZ_w`?j zYywhHQ%^F@lSHN5k17RkeT#MEgP@qC}OzhuMH(&8%$~=jMP`Afc$_44P;p|5A~WNr~z za9o|-Qmk06RV{*Evj`%U`OA_TE|S_}$>g9sU>C$CMms<3!o;8&MhfDy=5$l=OFrl} zKpDAfm6v#n)zu}l@_XH{g^k6sfk^=rA`6WQCj|omod+&S1(zE zSRat_$XnvN6}3AuqX}rz=vrK_3ltp5hv4p*a`7tF$#xUH$wS4B1(-pRHGXcd;T{eP zxDG3UWfvNd57F4nTTW$oY)1jy)w6$sL1SmEW}4ki)@Y1x@3gY7)z{+^ncuz0GgX7~ zXO-3&iw08NQf_W){4cd*!x_7N+HGBeY&95xNGSX zLJhv7HHX+&&=&TF@sf>UsJU9sxq(VxFmo9TNacha6iHkhR5tbAS@;Wj`GCl@Wai+x zf2WG4iR4al9C`xBhv`b~Z;@5gOXB)ErWz^_2# zPitWs-9awV5-3@?j|tr9zAZeup}Wb0=MJ8 z;1x%`Xz?byJ$WEs!ajC52n&s^!o^A4GjJjA@J`A-$f`sRdKiT#)-4Y7gQM#>ZRB~` zG0*|AnX8^dP7h`C^v&)@4}rH;^orV(rYn3ecsFM1)5uQ4sV!g0pZnW2ywN&mT|`*6KlF}M;;TfSbAZrKb3z#Jm~X91>rn;> zI`Z;H(<*wNFu`Vh=J@VdAZE+-l$3s24X#YJJ1RK|RX0{m9b&}wyXC2dAK(BCBJV~L zXJw|MkHt0fFVGfPhuTeR%D)tB7ZRRS;mk?mH;~UB4;h()>QvC`XKevs0mt(7bC4T3 zb!f`tB~KUc8~=MFp8>VcK5`-GtxK?;N@p+1X`WsJs6qmy%o+em00000000rd*v~91 z)m7~!dUYy=Fsfc;9RRf{LK{o~3=j+jVG$Z*Faj86F>6L2*hC*c^L~LrVVgunP*n#2 zQ-%qERuoT>sqa@`d95z~cWbh{fvK%pJ>Ww?LQFBQSOtR6fl4JkN#)`daeGvNj3kke z;=G6?WkgpJ61{tRz9RNpkt8KlN;K80-En(Yzs|J~d*5-s?|qwj`ChEO06+i$%m4uy zL5+|5>X%ZuQsBabrRlW^y%YE3g#85A95}b}F#n@-F!xiC8Z1!IK+{JUPiTKhwSfPZ zkCp;uAy56R@}er%#XtS$9+&H)6!xF0kJkiU5{`$G2BR7OTu=3N;vFSLNBDmIsUB;I z43W71$_2|73P)7-&xXqOEms4s3Wki}4Nhd9$k;E{D^$KZL(;w!Q2C)(klLE2vVUJ_ zW3aF+RQ=aqh~C=IQN=*}PR9PV3ZN?%+0I^lB*?vjWV0E65I^hYQudE8?zKV;vX{(* zE;Kl%1#kW*xF_Q$!L>X=a%{_*%0hIw%K^i3Y-^bkgF-&|C4yX^Q`I-r zfi=VN8CA0C=Ler_MSpMl3Dkus8h>GZ_xSd$Zzh0ZQ_W~C{o6Pll>8o<@6QgE&gyO5 zeol!V<{PuSus^Pk^|9woD(nvhFf~9E&=uG3GeyqJ5ut59&HwA7kiy8ijDIzU2QjJ? zyDOuSw4LI=^F*I_p;HlSJ9#y+4rC}w2yb*-2xtN2Xy3_)UG~(ZVN`OQ`)#of^1f1h z3a7b(Bp?Yz?)pIiQP&MNC!yYb`edQ#V_!+VPy70?5ft;W6TWJP2uh_!9~FUJNRvOOmR>$!lUKe?Z_F7Xnmvak|6!%h^RPdEk#qy0R^K5bVtZ3}g7P-W*x{L_DW z4n=O_&$Mv<0=PBcDhr=VLylVIc=YvAScp! zwm&**RI0cdI#mCC6`&&to(Q%n(Z=BQpGbK$JM*YXxW^FQ+k4HVNwKRYN<^}kj?b}n zAH#)sgIg<2rsuJWDxja*HKXMSK6*nrrPb_vP&RmmQdad6AO29iut?)N{-Iw z3RWl#$}Gt}gH(3so+KeF+ZwwokW244%{ zpth9~Um?Ltll;AeB5hhULnU~@>LViR(Q4m=DeREt%VhXQX!)>zzJ3%L2>k#6iVRvc zop&4!3nnV+rONv3wvgz3*^evWItW{$yb)?oJBAP!XDe&ryzm{p)E<0i{wOn-KYJA> zfxP{vEL7b`@aVmCX;0_@M8JXyTxAy?0rdtwU(+aY2TSYzsqoG^G=0g`Gbh4`0tD+Z zG|hi5T?W$oF=8uUpAmjEWmDs6;+cQOA%dy3Aqqn0?^mYj=E3yPU!Tc4Q`CC*+moQ@ z|D>v8Uoqi47Zba`(B&}|d?P%KIP5bR0`U%c=dWkV)b~#MH(!tA=M$r~Dnq43qy- z5^jOskf|OOT4mq9`LMj)g7VmOlbqXg9?JPjw5A@@zSRRzw>`{}Ix*CS9p$p*{}V+{ zwkxbYSd%Zuy{QNO5$gR=9ztIv1&{!#+KhPTs!)NzpeA;kHT2`ZJOQ~?)N+e&2#Lv$ zyCMk$4_Pxv`?R3;!DyE#M&k$*NPbr!(w1TFA99oEq7{ii3@HZm_<--L!|o#aP*p1* zLG)fY-Y{80=*IcAOh5^aUww&y?B8euB>LePK2?7s)-uTw4)b1$61YDYpY5H-sf>mS zz#l~t&{uDDyUw6icu%S$LfN%#3~A0Z^U+*?D0J>FrqJ%;N%3ELwyN`cz>W_!;jopI)imy^GyXwEFQB@C>d4JFDzPt?}{Icr6yiS zhd*i|BibU00QLdBXf-CR`$?U_2s$vJp?3)i$o4dL-FH+=f9ti%{zFF+7hsj{>eZ}~ zOUMM$XhhG-T-}`~4~huh)GD1T;-xem57|%P1Lt5!L1S|3NL$1mD-_7XFh@&m!~|x^)JdcQ|v*y!@}3 zCjY+U-C_O(cMOrYrA^pR|G(pErUv~tuYEYzdE1its&aR73U3yP>on5HLr3aaW`5{%yc7Z7r2CLN@Guyph@piF{3J-w`Oo!-0o;S}&40Un{{gE)LH_V| zXai|$*!cX1WX6~K6v3gQR{!=XIzDqhTfScS7yT?SOdhlBs!CaIT77+vqqB*0pBMSS z#<&s6b<4ZMZ&CoWr)0o_PQ2@Tx4dyR5t9-J$q;;-5+{Cq)DKR4!v zzxm3Ba0YpNz<+}-pP&2!QKUlu0#@+S$_aa|$B(hmqxqOB;29Z9E;ur;@mt<20bnf3 zzlmB}w&OEzjs=^dN}quGN{*0Xv}-Gl$=0JYgw}wh>=l~Bx1Am=2D^CYk#Huc`37Vd zH*aH5XX)t3dusV`7i8!ToOaLN;2;gcgKB0hLyucpJ|L7I-wj}bG+MgMRMHJRjJRf- zOX`6BS|6DkK6%4@dz1tL={3<1Jk2*9WPwG&pK_L2H<8;m+1A9G(-Dz3l#pyxi|Nae zjCe0_@=;Oxq7i1{Y*-*U+gcQvE|r@wR$s#1($1L+`kCE^iRI^<?iN4BbohLt zz)#a?2rxIG0t-`(60}@gW5Nu!2y$2gIZMGW~X>cWf~G4<(Sc- z0q*I*pc3o|BdzWOhZVwdnql z9oyx1*Ow=hG(y`sfne<%2_((vBrdeJ50`mF5aV79Tb#Eeo>|Q}pSha_JBrly4~vQn z``+$y4tS^$mCSlM@We}WPD60@bGWxrgmOtO-HkY$E#39Rf3DOIBiv!B`d|aU=p4E9 zpT_|Y8V?{eJ?ZP8u>AYtsU9c@WB@qL_>4wueS!5SP1G0L|$ei{~d0hKXit7t!Qy zc&FWnov1f}OX4e@9I2ssd0SXHcVb2GX;d*oYS|781?_@FOC5mfQP|dCM0~ML$YFw1 zL-;{Gjh1=^8RYxKz|m2yCe}c|m9T92T-r~f7(J^_7Z`g5{`w#gBkn+ZL=v3wU0m!{?W$p1&`@_5~=T(=R=3@uL<_gkgM6kPCq2c>tu-?oSx>@Xk@=jF1k*%pRh zb$%I{5((LOw!Q&S_{wSdr<O$jP!;~3l3dH@uCYZpgBWx{@PYO{zo z-w@qpG0Hpb8iqO=I71ay4J9}VkxkZzimg*>E{g#dE*9G0DyCIO=v z&DeTA1~hZzrx)8d;)LUJHyb21e9BK#@M%Sy)P+GotiyM`k?=gF6UY*gQ<$$~IeIGH&$&dS}8Q`;Z3V zD1?`gA_u;q!K{r6J8A7vRhs}My+6GIxETtyauw4K{K)k=zJeGLk1}#svKfIP*KxXo< z37wCN&-hs!_TuZ`>jzAE4VB*XCGW8?I&LqAmQw^`v%~={n4gfA9gMwpDa815eDEMgzQKwEsq&5423z z)H};a=GWz=K;4siFf?}~(RcX^+i27#eft|W_QqOC9<=EqJq_$_h~S{oQn>%1P>gtX z@#ekz68=LCWYOM8UFq*%U~7vZNS>-czFtTHLF1GQ4VSFJmuZF}x?jtSWiF@s68L6A z+iUB~Vf2GueZ!H~YqJoGydH2@0(xZHS7MNwTr>t|GYcp|AP!tDTfKYG$!BW(deKAR zkPRL;-rN2iwSBKHE{Gnd^$N_xTF8|4)@fuw-T*iB!p9XakTwk27W0TIEgBHhmk_S= z9a#knehFD?hE8CB)dseHlTVyQ??vySZg*TgCkfw?G0s(>WyYP$<&e4cUg@YPm}YzV~MznmYw|oz0>-?EfU6ih4RF% z`*7NJjxOIFOy~9mt-8aX9`3jnxMU6C^}zVDZz1?NlE}TcT=2|YLuos2w1l@!!}Xdv zs*E;e>bts9BuyKWx12jF2W(eJF&QgonwPUF_(FU`nGvXpU@49_$LW*{}Dvi&Us#wQ)>U+JQ3|$Rt33AKs)Q& z#xBUlZtJ98WFWEkM?J4PC8g!gyf$~rk10ZvV4BCi=;Ioq7n8@-MxewVM*1h%PAV=< zo#9Pv-kgAb>{+cg-~*@JvmRj6VBy#NqK!NMC>pleWuRisoH>{_mY@yJJ(IzT)T2*Z9gSjA_U> zoWQiYh5~m~_UShl^u=#nz_DXQ-f6N`znQU*ODF`TSHz=wPcCv&(Nguuj7{kl^Gte8 zI_dS{@4v{dZ(|CO)PFWCaEE%lq;jI^I#VZuk@*k&Zpjo0!6Vx)6rmC@tYZ*;1OlFB zIQKB5BKDz$r68nZ>ONGt{8OhvP;y^b&vUK_Tu=-5;!S*@R_FXCRDi%ykLnXSv17DE zJ!g(Rk@4>uS=*A65NU}~h(pJy)3#488}GVMCH5Kjk|4jFs_GdPCrJx#y%%vP)C(!o z+KV3Iy>kky{}Aeof(hyq58URI7UNM8NiI4r0F6sJ;R;29ujF@tJD$8!jSK06R) zg7D~ayxX!N$IvHV5>#k}wKxiJhK-&aejlO6k^kccVNiA3x7Wo0Bt&wtqpx!^$-j7D z0skO;j<(|dgLpZTpOZioJ*Svh-_9HZ&?N?iYFQ-eafuzl7elrnjsz4x(x2`>_kU)C zeaTfiAP<%GPWjUblt4h-y+f74V?_lU3Rs^_^q%FpxzE0t!uaX&9#-Lfu&NtnZLw?W)6Q|9wKOq}r1R{(Z!%p)1QxJ^d9@Iqa`$ zd|Q?7_;lkCJcBp7OJ1lUOhQJvfCuU+s((jMJ<+Q9`q|?fCu8l+RkO%EPB5`QVG$e(q?H zXw4_}I#DNPY9*~0wZ7GVDZZkwzc=#c4-3{hJfj*!_eThVR{bQ-N8VKKp>qo=_(k$g zBwdlz2naV|TUWjg<720#Pc3#oBz0=W9KFR)HhNA^@*}DIkGAY(pA>@(zr>mkI~YD9Q$7CF`>2DVsA2>UJA$1>-pT}kl7aIS14ln@Rp_yl#h5EQ*DZ9+WkhW$58F1X`lUWW7zTIP>%su<331@594KnYQl|8-DUTY zW1~LxR6JES;*~u3kM0K4pjC!D>p!>VnfGv-8moy6$kmTD-7^|OW2YN6^0;l0#TxW+ zKj$BkLe#^1@q*8?aImUiuScjY`SxXbYBI>;HX=W8Aj%!PYO z$H)bXf9m!)g;u~}KiRIKZ5taJRN5ge;Tcu|P;%E7!DLaL;7_s93}bI61D91{05o#NH48Ih-6%{$%f&esYIfL8zwm`3tRt zbx>xR{CPv=AOGkk<875xe*RD~-UCxc^Q7w@S7&|m(-aW`)GSDycdF(PXhG$c zK6vfuX~P)CR`$}O`_koVAa8Oop!*~d?`Pxq*h8tMFOEI5Uq^YXynW(O&oZDEQQe11 zFoEz8iP=lfISXltid+w_pE2L3=pVH~#8~;(U2wl(wDO!M0sMr41=oS`^e|CJF?uTa zU2t`3DkFhi{6j`V`V{f%1441k^$vyAQwld^p-@W{@@q4Y;)m+~sMJ_ewJI6NpxgV8>+3_XCMN$>1LAji zn1hfeihs<|d2>GT$4*4p)}f-kx;AR#9mBnLcYk(rnOJt{_{B=hXSVs0m4IvU^f&yK zQIBN`q)@jqtEuV(YV#*X%nNl@iXRqnvX>g55mBpXM~m{ACqQpEi0DPWkT3Iup`}n= zpEDAU>RtLNjrIxX7UZ{nIA=K1@82Fkv@^L?Iyf?S-ARYvK0H6i%FoHye+8Ai5ABKL z=Q2_8K5ANR<1Gsx{xqty^mz9I>FG*EKMJmu5I2IMjA20q5lpcr!Q(i|NU2hid=T%nA9(eLZGvsl29`Ks)8Pu zxkiJbRsq?c-FQ^%ZmJaU&lvybV&nZq{XS$L2|Qqpfu@tir?|`KA`1VMH~z9wNv<{g zcUkVg9R1v(njknJKu_7YWZliq=XqjmQzJ5PHH_WH^Jldl! zJ==$LjoJW&*VilZY?$T0-0Ahm9gFVV-R$beWvW`CVC256ZARywsn%n`k`Cos^z&Tc zY0ZOjjpGdwJmKO&$4I!CsnYH!lFk%bhf(@tYDrQ40rJc;c-&cTUA6E4O&55{tG|Krz9z`MiCu?xN> zG*GhkHWa%}wd)74=znrCTkVyDE(JW&9J{%G4O~{~*gDX`&&GD>j5I+G zb^3LeO%DW_Cg?z#M;srMqaHsMZ~Y?7_XIce`-FjecKZ`53m_dO^|SFma~$91?a4;A zosLqc;tgfLi^Ugu9j3%V*My$nM)!%y+7X;&O`67_YC+B|hCxq@cpoe@G}Ry}ADMxi z(pThG4LZ2pj^!e?-B|jH1TI5{hAeEy$Tncdrt}|FFU;(dfWVw@1Y@cevPaYYFG$5a zx#2rDaC~Q5J*}W+{$K*PdpZdD7>5Pqe}v%G>QmQ<)F2veY^cX3&^veKTYGPDj+N@c z!zJj)IcqAJIFR@Hfp#If&UMW}ygg-s`fgD*bV*ctUJ)NFD3;R*S4@s0Qxx{f4@!yqkw)=1^edp z8@|{xHv$;$GQdJLlmtr4X?#0%=`GuogD}u%9cfmyN??-~d!r7cqeucUW;UMf*9q1d zLGdqY@k=v6FYczB@@GCBgV|-Ia$quT z@cgQIbjz%qO7H7t54L;d4UP-Bv@X5`o>MpX)@{ah&0Cq((O5K`!bq}Cu>F3JJoXGH zqB~%BgEfx%P7V$?zPAz&>FK_ZJt7NP;xIbrE?sFwjinC}_ZrlYIxj$>dCNw3i&OJK zz|PBG+3X6p9u(YY4rq1*d&O)+(ee&BHoGaY|PgWU` zL)JX*%BpPAw@EK*i!S%74qe1@WG$C0k5w9Ie&`8AvD9B1tOw;QTjluRk62y$!wFG} z|Dijt>gNYMP`Xe>>)1j1>#s_Iv<;;^yHjD`X=XsuL|zHr;2d}wpit7oHigff%NCgH zN>O{vWOw10eLr+Obl$x3W{D4B;vTzo=MJOa9UG!Jbn&tSeM(wl2Xz}}z><)AyYIee zAP#oWHd~@2jQ)q+w1`hL7#E$R&mSloBd@k}QmuC?X(S(QdN899cyakby{ySG=Nxr= zZliu5A_d3hgWSefj<|H2!jjs%Vcu;{!N|5iX?!`|buqSrS?0-rw zg*OxdP;(j=sdb7%$<9&GD0%C0w4>PL)@;PK!-wxoIvPP|8MV8_4*(%j?1c#syX;VJ z|9I`E^-nZtZ0|wP+!~MFB`#?>8@B72ilDl85ZD9A9j#}o5qjcb>h3gBD&yUaZ#_>bh1|A|%ySN) z(a!1?*cbiOd2t67)}g4m?XP_~9FhwpiF z`guqnU?H&+E+ImFUzVz%P$-`8GQeGPrYp)!V-JGYUknjAa=|E@TYFiu0F3a zHA~M|N3^9?#Q9!~IM<@B?Isntn_0$1}e>SZSbrM%gDs1T8pl)x@f z>*FC$e2mTe;Cjw2GjX#M`YUId?H%0NoR=Q74(9D0q0r1AIW_|TNNwm2GXEkpMCI3t zhe(HPibo^HK_j``2_I}fXKSMjAu)S5%gYRV^x1qkDWJe_tm;L3Z1`ouWWCxQyXVYp zN(hz&IXLmY(nz@AN_9h;kSH1k|EY8JqYa-nZawjsFGHNZ9)H!L$B&6qbCU#A2etu# zC&9TTCmKp~vFnnTdjv)_w!Foo_ZUhm=i*s2IC_-G`itDg@gOuE+u;mr-qj`LOLXSh zr0Zz8hAhX<^;%F5P*x&g+~nTF_32m1!t!i^3JY7#baHZ5y6$Fq4%==6 zfr%?chb&Ojx^eHttsdowyN)ey=GJPAU~Pj!l42bri8QZq#1A=H{}{SzxV;2GgoDe zJaek6u2OZ=(@_qn?5x1fVxu;mco_9E z$y__%&7igPv@UtCJYA#O?8qCr8Cu{rS|?Y}ygJsCVGvhlyjuUu35@V0ApIMr%=XP| zSr07>XE6Q5+*$(rDF=xbrf@9Y6U~t6b;=K@Dqnhkc$>{AWc`_m5fvm7NEjy9I&+i8 ze`|dGP48Q-wWYa;0($|3^(-dN)_ih&N7yWwYdF)h95dgRWeYTNm>dwdjZaK}+~$;Z z6o9Xsqm+&J^yh)kDBKddnJakXb}XI1`h`t!92+)w8}x2(RS^o#3JNaXLft-q)9BF@ zaeXeKWS7ATf5VnBDGnZ!mrxpSzrgQlF+0Pl=TH(ZCbaGQTkmWpt^i0bNwD`_b(^ff zjVqyTsLUWlZ!G1x%@BswXA7!F3C3B z4rNVSs#dEOYhn$e?sSb;+u7g^Bi=Bcxg)gQx*iSgM$;9f5j+xhs%}Yd*Z35u!9&AE zFW3R64oE+M>}R?hTjOxJ=z_@d)1v9^r9-#FZw}ixjVWON9JxEzY-ih|M%7!X?X+|C zhek3f*1RjgM%A}XHQjQl5_mVd>5@fOmuC&OrXoY>AZxkvh)g26CCuEphf-y9(~gP& zGWl=?jxiQ@Lt0j_L*9M?Zo|88Mh%`h`cT~S_CGl(iF-SSG6612rKB{gCPOjT?S!Id zuy@<_Ys<~Ej$gtZ(?f%eyPr4TBW{82hXbF!!Y%NbP*bHW!mC~(>LUy9zGn&X{`NS8 z-KDyFe}vtB{?_R}=WkG_h+%Z;>Z6S%))N!MDM zK}d61_8Vv0n7iA{-@xFkhNok-qIlIlcjcADv{5NA_ zS@s^4_Lk=Fh^D(I0yotvSg5qY z5In4f0j*%re_rH%Ol8X$r3N3M07-TO~^mVjJvY75xv*LWZVnG`# zjR|OVMW(KHsyCygj;h_mfsQ_ae-$fNf=)M^`b|3|A7cn|j_Anja(L#IGr~(a@lRwM zNukJ4!E3lv;Vp*Q*r{6e%D81$pO-Z0oJ1{Po3n9oQmZH?Wtm5E0SSg_8j(ow|E7@S zxGo>e1P8kT3`@0QTUUMI7E|H=pn9!@;Ptq)hiFW*bd(z=VA73%z*p6sBMPJ?;-5_S zOTpRkoTL!2`f31tNu7ba#pW0>?~800$Z;aV(~2xS^$M z5%dGhFK@*7mzCEyqWQ; zvG4T-ezr~FmUT_Kc`0V9<^Wpiba0({87jD|%d6|UO9rBJUB@87jlAlvJFy&+1}9b8 zNBKYSw2P6jux$HdZnANG3Yt5wH=(N+} z1Wjv!oFo?Lv|?-%4tQ_jD<8oX39Qba+!ya;I*9u=lqDdV2h+YDs&#OBTI%)n_t^aB zrNgfVjAfX__9oA&gA)yET+;McsDd^NEcH@-IRdREA5`Pi&$)e@8n5-TFEa6lT6MH) zFh2@+ak}ow9^5@WCo!zPaAxo9^|VZP3uQp~A?5Wp|ItGf@ku}kwCIT0?xHyeDV4tDYjZq|25RS{ zzUC0(;mM%$14Sdvs7{KAt9x%0E9W;(Av}CAu7YPoJQ5m#u!YGF{%QfJW{?z`M0ZE8 zr_qP&$+&nKRapUL_o>kzJ~I-!(tBPBW%^z!SAf<>5K0PgK22dP`w5d5P1oAoZ!wo$ z&y|$_hMOuua(>ueAiM}j?3-k2<^LkZ4)O|$IH1G>D;ZS1eMbQl-+T}~l5UEl>o&tw z=)X-=AG1sYjB5`Me!9Q+54K8C5=9Sv$+!aim!V`?=gg_jC&RxleJUOZ3L>U2KlupG5K7vSIN(x4yTLv@`ffrJC?aoIPRG^)yh17Y&?uHIDDVL&F?tHW_ zW{>dSqb2HXJTrSA{pyQ32v1C+siYoZ&EE6?cGReienU=tOsZH;rNpPaS&rYen5Z8$ zwm-7GR7$aZI*N&N_K8-~X$ZtuQf*#ZFE>EmfGMB9PIs_0z(Ox7_{PGgf0?tSK!ctN z-T7ux9j^0!^&}ml>G-8LIUv+{f4ed{gy&29p*hxl*OGD(jNV%BQ!regrHPDHu`K?nA)RQ0LQ92 zpF40ECGIDJw4aH`LELsT5_j`mrgiwZR>^{+1{!fI9KPl$g2$z&;RYc~B|F+Huetpo zS$W6X^K9=BmGCM;YO%QcRh_xY7Kw$ykupBag!Z4cFuit>mb~@g9fK}``|(!v3&Q^M zdVM}9yTyHP*e6?cOJu8chY9bZ2Dc*PPt_ZHr;ee@@jDt0*qM8Yhkr`5DU*mR8wnK^ z#0Q~!JpGY;^eKj(zx!NB#v5Wg2h&pB(~H*V3mPv#olevAt35jd_J60Zk=& zr=4OzYD5K**V(Sq`Gc=eQHu4E0`2YP72pQ330sL{Fo_QxPh8*{e4B3P)brOz;t_E` zganvL0q;XQNPtz@`-vFj(pL~9@=~w|Vvl9>cM#W9X2u#NSs008DV|yBICui1SsJwkNK5|0E=p`BZ(?T)k=0n zyZ&cVA$grN*ZY>Mn7G#U-bQ6W^ufKM`zRS<-?Di%Zi*`M5Igxz#8afC#GdbeG@lgF ztBokp7-H@>C*jwSg-Qu`lE@J%neg6yzYeleEE#{mAuvl1C@ex_T#ctb-pLCtl#`?g z?=UEaUb9yC#lfQvdgq&`)F1q03jYy^Y(Ew8i&Yj7Ad<3cLVH_CI!Ipnj3TqWU{(T* za00vs^`VmYT`JDl8<`kFn}6a$Ab~~S2#m##Vwi0TG)6ES!9Zc z_u+K+tOAc)TzRZs*!fGiHnB5w|ERrKC_#EYZSOl|lf`@;4pb0YW*#UB1) zDM$f-0+SeUDALmhjuSx>@cDo1FZUgu};>Oqcdyd_t7D7vNqMN{bl_uxs7Rd%nX_NXD z8IS)HFRV%8eHE~0IgAk)2A3Mc1O!cRjT)g8Fd#-?VdYL^1($&}lvE{&a$0Ze+RU=; zORmr?k4C%oC@7)(ZC-|V>lIc#rui(raIx_Fh8a*0=G#`Rm=tVf#b?z60#Aq~tusgx z5MH;rSc5pnI|y7L4~9@L1P$iD>svsT>qwe1d}XmTv>R3zEihKrO0?jlVux7ZWmXXH zfntj)NJXuPKEy&=vk~kWaAum?ftVJRM`(zGxvAP8dVciOVs3cKA)+yd{_@an`xA)bpEi`uHOpa$l z(nHP>0f;&wkqCx}fnTUnlDtBX!B_#hE$H0^iAm&XU$dpc)OLnWf)tKt*H{9N1dyzj z1YRl;OE0S#ByLfVB9F_SC0kNOM{d7$i3z)dD=?yj?v)WU-?DjO44 z0+*M*4K3h+yXHzr;h|ceP#7BPbGga-roQ4eS;2?t!1Op=)c7zBe9&qmm-*EPyiC3> zZK8z%yxzIAx^@-xcBw-bp@8nFObwJ_loBGp{w z=uTb7I!(&~%af1fIGl^nwp6ok$ihnu-oCMcIWAjs;OUqdi-C7_r?PbL<&VoPfu`7j zT!68w${m=OG|eadPc`<5tVsvon}kdK%tyDj$?<0)Y?w^Hh=O76ah*XX#m9TZELR~k zK$_J~ky+#!Rye>|=Un{*U*$vWKvBtEEx+vODEn1W8!JRjIg~XG6JEe&-WmbIWoe;S zfV~2d#P!ivp@IlN zg^kG1C!RCVWoODRdVu>G$g&O|-6twcrApc(oB!7@_TpNI70+z3?fl*Wz*#z>v=2xT z({+rjOVgh1Nn+hM$&A_5F$2uL7;nx1-<`8!YjmV&zU2U%$|dUn*o|1A@;3BOZbW$k z0Yj{vm18Kq(6Q!CpS=v{fpbr~2pQ8BUs3~Un4gV~eT_<5pFsR`m2GcZ{ zBG3%14`$^^1%T8F{rIqylWIf~z>1-tHXm`PY&BwkM%s(LQ24aj1A7pX1B7Ki)F9iu_l?9f*=bGZz0}o)k zFq1K+h10XnGsb`xbSqj$qOpBPr#Rc}5O?W$3-vYB+%@hp^-5mD1wjdcmd@O8`gm{# zteFA=Rb%;!yu|m7d9ti2wPrQ9kf2Lzj`Wz7g4Ne+W>8W^XNuJ^s|V7ETg|Lgtdr99 zD@v4|%8D2r)3A@`okgj;IH3y-bf#*25216gHjcp`fv^D@+Zwy>VXW-jF*O z1R7W;Nf3i0QL2BxClB!|C5BuTDZkan3^CvprD`=%C4uLua;r3+9XBtqE92nI<#o_?fzyh#MKc9jpa~6gSb^nXA<2~W z<@;TYb@eBZNg6X+8sp1hVrJ`{r*Y-G{a!$ zQJ2de;Bp{|Wq6%Ytcn({FEjY072>PK0#ydXxGxt9SnPL*MG9gdL)?9W zShU-VOd0aTP*|?jfqJ`m_~Hc)*urBrGRZw-tw~*gx1!2VZ{ zmIk;uV!5;&Th<8hw#;ljJT0n6vFwcI+%G4B@c1FLaM_SB${=PB>^{YWs!Z>tWTAi~ z)P)FS=GC)`k}Rb)vAeA#pzysCKa6qRE%0^0op6Qsr0J%wM%I{n5@g(XZ1Oc=%VO#J zi8v%#l^9ww`>y6GC4EeoH88K^;^!!$MYDr9T6E}V#m}FZW3X+e+3|;hDf>s~^OVO? zh*(#5ZW4_`!);PW;T?=e-JPDUP&-$(uwulpH7Qns zudHtEZAmI4J^IB&E_KSygfjoC$WIEa*>E6dEeZm4vBe7sqSFliCNB^)g|OvXQGg@v z+WomQUnayzimVtYp^(v$>T48bq~C??t~r=^1)3%)T$CX1Os{?5`@3 zCdfd95e1!(x`?W-H33vtjDx(HP2htFcMxj@cLciNEA5VTn#sA}-{?HyhNyO1Rp4yB zTo4^em2&0b@4QUQydvLwx2uTH38g=c6UB^+>bc+ogIHdKlGkdHTxw&fYL!WZ7B{cm zZCV6b@QPl5*ttxj2#v3|b4G5gJQda$*B$tnm_gb$Vn~ooJGbY|MXpk1?w@GsFnL2n zo%-kH)wW2r1EGvHD~&RtMkLJ?wClAr_SI9?uzNMb8r7NTZoOc0hj*h}xOe9--Wx+J zc)yLENkJCG!@cTn3_LwDiU6L3I!b1)zTIEi%m5*{AWN}CRp@qCWD@DiO5DO#C9Wg(#_Lp44NL^`4USC#5 zno*;Y84ca8vP;9F%uh$F)6ub-U!X9`Tue+z*9qHbrn|J4cDu?qGCUT)+R8Pmf`L_L znJm3aY=@zXq%!5D=H8&1E#V6(GdAy#myy1=$|$jYthq)MXd z<(m}>j+D^gvRzqlF@cP{X0fkrkfTPVBD1?-%9r#5jJ~y#mtw~At@WIsk84T(P=?*N zVlB^B*x71`8(|ZTYOA&8g!|^RUn^u|_gQT_i>@41ZRyT$>K9psz6Xmy*^J+N5)xw1 zYLf#2?ldt`JlN3TRxF3kDv2U2m<)So!; z`?#=f>vsZFS5MPB8s8Z^Ms6wxR{p}ObETeVDfnG5i!5wZNpb-0d%hhIusu8oKjFv@ z64WMVSk_cQj4tmMm0Qe#XT5S39%pGgaNs~t!$mhv30b9#0 zj=}Mo8>V0Wz^PA9=_l>{JzUZj5pE!o3FHxmLABEOJ^jg?%0E*lJWR*RrZ!VMDGN|b zGib(28S~{FsSH+iKc` zn0!k5Pu1Azpf;|a>Asl)=<=BAMF27Js$YJ?^rjf1I9F+D5s?il;B4UY?)@l^A(I#( z4(>vw9|&H8qFE~EO3Rk5xli*h>I|4R_}mqq)23-mgU-fMu9vAg994;z8-NECCl#=2ly<`GQtVZTo^uo8%SJ8@hs$ASf@K+O?64J>X-!bNIw6?8GapmQ z`Qv46rZYL!q&NEyT?|0k%@(NQ2xAw5n`5`U!P3+S?JTjh3mosMNAj6YZP{5U-f4#) zW^{aQb2;bywizC|fk|hU$83Lan&3GsUs2`%eQ6{U@OPEtj3c27J^iP;cvfu(9CCfS z$gCVbG$3I4XzS9=vxR7}4;%E3{mHj_ZX05PIQ1wl2Nd%|V9Al$c01vk@OSX;m` z(H)yYH#(iBTq}+se-L)*gnE+XmA;kt?qsuvo14MeE zC$Zlj+&m+1t!2D!b+#8x99AlUJeEUq87~j^6Iye$RnerZ$IM<^#M$NFZ6u?k_nHFo zkVS~n$g#0QfhS!1P*fAM%PP~*9=mEG-vNkvtiLQ}Uly@l$%IAmZe!`wbyBdI5qW$! z_c;|SIYj!u(;J5&0v1|*F(>pCcrCa(`ioi>PTk1*0tMH_LZF*-(iv+rmRL1ShqrIH zf(MEI6t9&-SYJHe`*e1%?4x~x(ZFDZfgHNfAf3Z7OKaAX5;&X~=zx0?H z&ZS$Zo94xTKsv0v7m^`&*}*$z6@i>_a1D3tE&3-qFcEF$H=exk7Us?>=$7L*jMP^dSSgH|1p%GypXQ0hx!F78ZWFEMLFM!Fafr)K zEO={}a=^DGh&yT9&anyeSb9!4Y8zRFl`41DjZE;GKL8t)=c;xK=5A-B;DxcbZ?^&q zh9XpaCY!a6LQuT4RGh(u^J+-qkF(P^^`%$&OY<2l4pp*Er1Vd~vDyyB+$BUKX0eu+ z8;15w4D-01XaJ*MhFO6yFd3}MQb^S6O5L{wjVUXMPRps}`?J)*XC z&&xZYbrx0J%fOdqyh;&`U&l4K66>Ue6-#=KlcOU8o=coN4`F>RR%D`pPS0S@6KG#9 zc!Q22mvHWKSx6XTsN=#N>7^3B+Wbz@S)_x)Vq26H#iU?qFjfrm$TH<87l_H#Pi{b9 zl^b|4V1hZssx9m?u#?uAO-z8;%t7eF7m{YR-FMml(ko0w;s_@=bBVb_x;Qh?bO7|Y z&fFij0#Qfnfpzg2`rNyzq+FtZt>~Kz^du)V&g=R`05xT-N6xHM)0XF;`_+i8iN&UE zr!-m8@#kfQ%6b+$K7_mC%2>dueDlpoMW%L(ZCx)WTb@4{(_vdIU!mjI=rla0M>ocB3%?R^{Z%H7+-C;~avj;(=e2#Y>t99IDJYm_6s@ zL%&HJ;8P$?+7`^x%+0vEY%S3^Eu!b_%l2=?W{$bHDCHH)!Q{`z*QuF|8>{dh6OWfN zX%Mh456z_%5{sCLXYczZ}G9?&$UluL~QQ71KK||kn*(Ayb^f~!%xznV6u0kcmQHZ~yOLM22ebrCliY}*4fS~OS zu(W>zyl%hU1_)k*6;=!wy_f`Z6reYPd0dn*E0+x*?0^{qKx!Bn)1l zt6qT3c-nP_F39^`PDhB#Oeetwb7BaXK$Vx#*Xn7Cmn@){>b2WMA03QY7k@bBz;lXn zZSB$Z_LfxuyOH?cw?7LS*5+_hN?ONsdlqUDyk}tLumwE6qp$MlZM^2nW^B>jLod!? zl^O{1o4qyj5o_!@W;3HeJX0?+FkcRJPAq`)khn@5Q&^ExEHR7J}R?9gCK8FU=Z(9*j(*pqg z+ z?JQpLWz2M^nITf;QeYh~sIuDF;H5~5GOnsJ?rHdCd83r8!(YWFtltdhp0W~GD9@}k zcrRGyiABJEHv%~AH0$DkuSXTg24m|4BWep*sbJPhRaF>|pu0A~fTf$D_73D*a{JiR ziYf?t^fDC|oFmnCOdz=BG_I}2SRO7+;*!X&pjyE+X8~q9uyH9YNVky51q|5iJ#mO4 zP6NEia*QhxC04Rw7_kLL;1Rkcoq1v>5uC{y^YpI(EEiL+kOd+pL>wB`FaoJ8y@Gf`qBc|HW1#~}2N3W`H1Ls!k*>Ys z2NMApI6Jwr_>stw4B!e=uq$A*-;s3J?D4gLar{5KXzr{at4ubxkvl=u^7Yw@hA|b0 z6pj9|8Qmo#vBG=z?ho=nwr3sSLnmzim$=GG8Ykg2UW;z_BtPm2%^D&}#Hyq%>2xX2 zNX^8?R-3$dYud*+LCLvV7559>`R?_ivZ`hqgE)?#3Xt-$$40m<$^v4*2SRL;!vWwM z>Sp=|oeu=p1mWf!-hig&o1^kC0Ct0Rc{hxxf*iW$W@8)VzRE!m8Zm|X6`hsmQj|Cdv+yi9&wamB@_i7HzeB44BYk^BF*Hn3SuycmmSv(A8tK>fMt(QO6N95Qk7m#$LIRiWR3q6%1SlA#24~mPFQuGxpT7VL#N_mcZI#^ z0x4@uJ@P&I?3~Ur8}um!HP5Vb;#8#$>#G z=;a%m9TQD%f_h?YGI&blTEP@1tbIx@UbDQQgym4E z-^Oy9@h@%uQaAERt>KKbEv6WWlg8c0Aw&dL&1=@RpEFIHpc|oClr*T@{>GD(^jEAt zV@{elX0IvCC0!}>*WjGpiczX^$^>1X@8wf2-|X~KzO}kj$-D^RGS!??O^Q->nmH9S z@giV$wlS5WF9e`-(*p)vIX=El_4!i?^}bDdli9|S%aZNA$rolQlRKmz)9~nER#R;_ zy=oY30vjQ%o^4`der_syQ)Ef9mZ6NCG}#@r>tQ75ktb=M`UW)93`~XE%D~$+M7PcJ z`lPw@-fS#j8L?RWKfvr0BxZq5ogHFbF7EPw8y+jEtrQ11!aL#(j>67m(yZ~d`^wxPmVX4z*4d4)K*YabWU!NAjc`K=CY8;M=ji6YC8f^DbR&KM-jR6oNSsgm0djwt9UU$?7$*}e z)AwvPKWK}uH+HqHryMRcY8f1&Cg#)99D+H)-`cVsArZ9B3(S|L#cgh(aY|qmvKT+@ znC`to+ZGocPG^nBoz<*s801vdBWiy+;lh&;5H({8NC~Un$g~wF&61#VK{YW_x}0ST za5fPI!3;uoHq7-)PER8?fzq40_NWZjzB{LsX!uvS1BrtL!b~9c>Wf>57@TJU8!b-# z5dEt9Mdp`ZS8iCUO3nI4pWjEqY}(ckde$Ywq`6Vt+)e0Uu#WHR8+m=13uy|9Xw zg@3)0OfGn*b?zMTaaGFtlkxd0Gx(sdMZ>q#m~3z-F{d{PhF$p$$1>q?&(dTxJHif$ zdYY4y7u$r29;aoSZ9k#n;r6uCr)otdbJ4k$f|ISH+x{nSieEFL)ybwz9NN=as4`$^ zRyin_?oc;0OmkT^h;r@tP*b=>c57|Q$fHpQhSsP2k$JY+ zp#X-)t&>0*p;=E%Ql90Iw8sfsE z#&ep^Mvd-s&6?IW{nrl2!<$0IL*sFaZ-@ofDUIiGheV#!E_mof?Xa#V$;BF-s2zFp z!*wC5C-n=Oovt4odQ@GK?1VdzkuIiBCHU-o9ud9rc+k~#zm?#q`UgQ zx%?Q{ICOQ?7+ue_1fM)ubD)my1XumuU3n`>f-bhqXFge#1uLfSWAp@lP|DIzHD|!r zj$(_f^LF>Df@es_3&ZA#fcLA8*N14H--@z!U>}lt0rF7UXKv4?&Lj_$JhAeq>`*(j z(y>=sppyJ^ui$cbps{LuWxi$rPzv5F$1&}SWEoNb%6JKwsQExyuTY4=8ojmxS2UdB za+0>H47N_<&23^mvKQ>|w_YX@g9MxWR%(P{_|yco)#`^o9;E`2P|hS&jGzobv=BCs zR-{Sfh#!@Ij^$-f_+pC9X8x&$=}NcwFk#CEJ=o?x`VR(C;ci86tJ7T6R*E z#IcK}K8!IGpPoIf=7;@N_H94*`2S1X?1aUj^oWVhvpYhE_!HQ6wJWLphzVZY)SJKI zr7`=H?IzRUX288eEyRn;;!d7hdEUozg`X-S8L2{>Dax`_XX=T1aY%W6K#kd;r^5k! zC>5(h#RvQe)v>AxBOr{@QsQ&fNn=%d(W-JEqqiy4LwaQIY4-^r~c0N2^JOf5&%3^`3vuP|taS ze;pT6`_8qDj(RJ#pkpPLr;ASA~oLi zpVUBPdC~%@-?%{wVkOx#7=+K|JU?$nYY{R&;1O|xopN7Edso(a+xGpta}jH?{(y=n zQmt#@cM>UvJ^A^TKKh%h6F?GL%+$S+EVv&N{3^h1=o11coropmBT5fa8jkQceBm)g zR0K5l5!i)O;-p_Seu`y>ducWQ%^$pwhnIiU44+?ZVyl+;a)S%hsrj&OZR2yg#jj7i z-X}!<>r*Nb?xbpdjV}*QuMpBl6WZcitbIc0?;q0l(>W}R08Ldp8vsZaIn7&&H3aI5a`d}^v-U(4Ds(o<(_sI5r@IBihM-?$tQbEqnl`R#0crVaP?Q&j8ErIo@$os zc_R+wG*mERHEOR4mW`v`W7Pi@Zn6xTe`2%XLHY>oOd3@shWFp{AqWX`Jr2lvyi4Eb8&GyApVvU1Do<9sp_$QHC0mz*=j+dxTY9Zs#)dBpH zV$pNAQ@gqfz&snq?8I5KRDSsFL@Hkdg9bO2D6U z*F!$4Bq0XqzTVq|k+BFA5rVb)-naxRK{?ew{SkXQU9!&jji!)-v%Ca#K1EX&BM|o7 zuR@Irvfgwkv=Ak(dn5a1A# z@vuE3A>Up=`TZ8w41gsVo2Aph@4K|;;ixU_@a^4 zYH9n~e@dHkp2+a~KUKpldda^|q;E5qA+&!v#l_x=`EPD|0!7_XE%9N}x@>TA_MX4G zC*BDCI2lAi9g248a+*2(6dV7~#9~xN8C%BZe}Yu@`S}#}GMX)>LX`WLH0oTb9a`7!bSFL zWfLCpP_HW|k@SS)>iVJz_n5%Dl?nlg zC7PG`Yz(qnB0xPwC$49&s^lpGoarM}EKJw%d=O%KUf!K^cjF|>4uUv|9Lu5ZX&yk{ zMyUafB&Dv#fy#TQALeDLTKA!`3ZN51G`&K*p*&^u@uoHDz90f!pd!qiPs#79mHVAo zAghtGb;6OQG!1uE@$Fq!R&Wtf;QrmWl;LDaO&Sp-V{LOZj-YeC1JQHrhC>;Ea+p>20 zHA%{cU&&h5J(${rL@l}YB>yI>sUr4GYw1HiE$-IqLZhP^=B73DAs#y7$PwWLTogE3ob zv7>OUfhRrx_4jLkUhCHDM3Raeilq6jKYe%ewH9iwA@N53IB}q+@lXH&0uZ1_001#{ za3lZ#Zvc1q-Ce5o-6haS24y8yhej%Vs|}+Dx;CzTUDdkY-jdtihyT3hy)ti)Gdvqx zn=uVvY_q}53WEAl+%`O8)z~RY-*o`U$RHKX0KlLDcR#Loe?7};P>YX0k>EhcpP8ru zIzS{%uRYniy4AWv*S3+`*|R5W+FET-hi=un-A_}S=GxiB9jX&lU}chZssT|T4fv^; z&uWB(p#K0M00000U|?a0!Pc@T@9*D){@=Jfn_C>;hArG%OkWqi0C|FKp0H{F#-lEn z^kE6WWcF?;If~8g?eXZr!^`7?%bSy#4lZD>cn*E>L=|Re-dwKjTy8OHNAoF$CRKAT zRa^EBOnKvjZF$gz!?Psf7@E`*s9}S|+qqtx5)v9&h`zIWNL;*W)~iK}EaJ-h3pYLK8rF@`ITm@u^*Z!=cfiDT#Pwb?LJqo8uqc9bfH> zN7cULIFx#qy+_J~PYb3z?ML%4_h_cFDTDRoPf;fLdBB52g`*m^B8#=%kJ%s*TkMZ* z!E;Qw{lSvk&|c>v5Qt+G+k>);@COTz!|=0v#+&HJZjpI>V@OQuhwiC}JU;;aFF}>3 zz6KV(AJ_^Dx4^tFg-c2CBQm{bJoS?!7(>PrI5^ac=maIyJUy{}cLK(p?5jR*?paT9 zXO4ySzH0`aCeZRVaj4aZV4P35D;(*d3Z=@Id}k8nfe%LQgZ;cx%%*8<>o4hLx`TA^SNx`66gnc-v!Ms*k@i5SmkJ(H*P2+SYMBw}C=z)BH$<_l*8CJ$UA zl|b^KFoFogJWz_T0?|WPm4+83EfEi2BrriVy72uQp)3YF$I7KtfiS3Hyt>!q2Qhl! z<7Fzi*xP|9IG|{mjYv((#X%x?AO;dkTq!h+loHf9ybwh~PMT2UE)0y2-T^0?y#!t< zg=2f1YapPpYo6SR$lFqRC2V;$7*^?(VPiGw#}QZV8`011%>Md@iwsp?HHi66$%)Iic#4%u=B_ zJ^?JLnyuavT78RFnit{{z#7?*E}_vughUC=9RNre&>S$A2+1^G)FrVs^BP@Zql3eU z5}P^*ia@d1&^f92BwB7>@LDJxY)G8gbnqd;VlzWt#Ny3?dWn1u`9d$T(}8Qm3C<3E zBcgB)Fi64pvlVoLutBWK=S8n2@!>4|268qC3sD5;hrtq8 zU3O6S93KuNOmuZ16_LHO81~#cysCCy5LT99JY zC75&;Ve{y5Q^FL=%F7;ensNSQ-9bMjL^c^L5}jB!(oP6EgxVG8sbIKKsU);qO61TT z4ff%PM1Rw(kbcQ4s@@y@Op}yf1F@qik%9uO`gYRSF!P+UR_M2qq*H+U)0bIH>IYG7 z8lfAxC_ST?7c{d{0uGekGHPV3Xr+ZNE`Si{3 zbjSD@C^H3c`t~FIhB^j^U3Np{EHeW5*9TX0}X^b3^jcbefV|Ahl2VzxA`0kTyiy(?qCy@WGO5eSdkzi7~&JDRPFN%g;NPv}hY4#g%wv#1Ai66FjCO0)<}zHxWf0 zjwGmo2pM+Hcy+a0iq+9-DDYf6%010djzH-lp4hUXOYu!Krl>Z3KAqS&?ly~I#TOnDb8slB)^|YP>8k-vl^LIgVQ&f?0im3bU zfL=z;vWt_&RTdX(##EkG;G=%o7E3(;N-VlfHp|8;ymG8};0tz&i$Jm#puWS97$cap z9NZLyJ0UkffcgMF{&sQM{MSxR4ydr-2Xb*)0zVdYWoMMv87Wu+ROH9Pl1KXv;EG& z6!DI-%p_307LjIFi-a#biPQ!#Ov=EPdsFy=0QJfhQ}Gufia)ifW+Fy5+{iR3BE>bT zE_D?MjhWC|Bo|^G?N?pNo@`wG9fGx$P2yA=h zHi>I7H&?sC7z_D!x{5{yO23c=kFI|i0X0|KvmkJ!>V$ZJ&d@lok-bL~m23q$`(3Di zIS9LD<(lwPRk<9zMj)9DtS*}jj`qo-ok-=~gm*OMu!DGkgQKpZHLyoav15O^n^0$i zify+8)5i5rs#pQVL}PiTGtu}ls_;M=_;QnwaQf_GGc>N1DOnm>FxWbJ6x>_JY7X}6 z-PYVw-QhHK!sE@^8*~({ZrtqLfHo4p>7@ZH3Wk zbe$xKiJgvH)x-tOzkY2s5;l)cO_pJuMi!#6hYn&WuRV!RMBLo5Beysc!T~&0^iNdA zqYcj6mNHp@Af($i9uBLN-~?kD0n$;lY?7gK>X;y!p+GU%ex!BHoC}gtw8kRG4DQc< zm%xBW79D3v$vUvi?55edVDT_%XrPI(A^C z{s5FS!kAW)T1%%rW|AkAkQj?D&y%KuZ>@OiS-8@`+yjDjA&&u5vT5g1$T1o{syQXu z=DNP>GEYx&P*NuC397KiO_XJEbR?8XVYsXG<3N>}{c(Oi#&<{Ry(;#@sF3YH<7cru ziv`})5_HooaoYFnMsr$_73|ua%Fa8ufus}W2cQ=-UE}RCtO3$9v~Zf*kY_d7F73wn zN9Asg2+-0Mtsr&Im5L`adt7Kp-1KlY^EEt>M|bS=CLh=g-oy!06tQ89*zMO2;hH|X zY+|RYR!7$KTuGs0*V};eUdz?};5RK*b3uCcN%@pGB+3BlJG&WgwDDxjJLFUylmO&? zSL>l^=hFaaytLU#gXXS*NeuhDD)6*jztI+uzJ8I+c^v}8!Ylf=(B z$q$@Ewryd@W<`?GUUaFDNx@rDxR$*ZC4C|e#DI!VWFI>BqmBimNmmNsS!QI}>6CK0?V@?vWKqjhUFEX_3%%>0%t;-pZ5=`g$ul{OobIX41%)vPk8U|I223g5Z< zbISEtKI)5N8{C*BeF1)*;W(fup<`e!7DmNQoSblv=9@H?cm_qxRI4BhwmsTf!wn-5 zG;?R`oy#T4p33yXYjhBfGv5k#I+KK6m6n@{T(FU8Y3Ljoo{76Ez=8qLjW+I(n^5N_j?T{NE>Lo; zw&&U%V@B%a4cie_jaoG@+8^N#)5c?QPaeS5#$g%**aNEf_U9y8ecvD(W(0^>&9tzEu z0y)f)pj1bVX5tJTjTC~f>il4&>w}ALr)CSRav?X2+%Xet>jIHvoVJ_}0@W_XB}c=y z%~7$EK-ehqV$L&G9|ovRI4RO=8!$0rp@>tB_+f2C@m3~ti4uB*shE@ZRKXyHXN3T(Y>#v_|p{*tH+`!0`9#riopOU&YM>*N{ zqXoSB?@``Sl!s7$c^n<(uWI@qspS@TsrTHpyFwE)OvU?=18VM2@`w24@tEbCM-7K3 z1~5xB7?CA0+-c5+98Xs%gtyEBcz8F*w6~y!(oLr0-SJu!)a6T2?APwASD(8h$;YOW z=sAr0OzyQ#hx08uDE<$kE>FiT^hfauMK3!ZF^SJzJm3{_^xFmYh2QpGf0nu`=+2RE zPFW%G1E%Hd71VLYy)pH%SMVo0>He2C8PZin8|`34_=7+?1K6#Z*#Lq$KyhqQd^~-g8Sac z$uCTgPVqmyDbJ2R*{Zv`D&Cc8Tf8?M*9DC{^;8Sj?LTY1lG+{%zwtic+m^;hEj-+RTxq|p4uZA)YD(AhVkZ5N8Qq1U z4D|c0)z)VK*kFx%mMhBs9;#Y@9>!an4_2*L4P=o&neL)PS?i^PYHP6JQJ(x(Mt8`w zi0*9s919@K_N}x*3i-jOmO*n&>s~6|Zx&MD6L0)J1-0KNvw82gTzv;UpO5mcZjHLW zi+?@3usGcbxCA5eh%M`px_;4}hwCE_^uNGPK=_+qp7+0>99YLO%EYoQz{rd6va^Qde-WdY zb37KIl@=pT^ky1W)G;evn`*K==C}j?*LOifLam)s8=;GDNGaH&nS=2^$mI?sy@C5y zvENUP$lFAW`nrEk&w3;o3WY%-$<2)v|FeA1kF?nPD@|FdP( zGUVW2M&#A|(LZw780ssm8LCH31jjwOJa4s&-_yyPQ_NL70@Q7lu$*@83{sF22>d+T>)pGVsZAe z6G;%9@}#%}2OZ8*i(4;wc34C4_rK|Mf4=)J8NTK*^D|GM;rg8a=25A(X)O0B7!r~R z{g;QrD*ihV-@E(_o^4!23_Rze-#-Z2nJ1ujaxgg#B@44RoPgV)6#C-bzI`ePOQFVt z*!$lTtl0V;ikj1N%7ZX3##rO>ZW~1F>P%K-`ucCX>a!V@sLeq7cSQFI_jw@{vc!;-f>cTTgHuncduQS9#QS-PYvIJ zb5?R_2uyhU?sQ~wA`jVRdoOoInLLxJ_66jJy;^UG;JfXcU8=ek5&pO_OApE&aD%V* zqEzlG{_)0P??I-qq4r4#@^+u_1XaiV^%0w=|i@N4N)?i7R( z`0=`2Ff@R2XV;hnRelBzj%IBko^Ypk1erJnpnJBD!qoiQjrfP);!l#$3^Xq^hwSu^ ztsz3TRsHr1NQd?1sLOrd9@M1Oj;nqw%2R8W(78$?g~B3H885sCUO z1w&WvVb5O|zY;$<3+{^iwE?RgB3S}`7q&RJ?KhORhzpSwWe6iKW*kbe%k$@xr-TmQky!+kE@0*!BbA{%-d0ETMys)dh02TlMGX+3UKxO;< zxV?z&nU)s|kjhU|X$lAtH7A41CX{afm7bxNInQ3MByDc$XnrNy+rQ5wp{IQc46891 zyssUg4HqHd!^YSfeQeL6T!>WM`aV50A}q!vG5|96G5BwbW~C<~EP5KI>~_Ui!tJ?D z!r&g15y~OlBa8E|QI;gTTDEyWMe(GvGUGfK5k>-5(ipV!5LBfZaNa5@;H`qwV@1?I zy5cmK=dMaUN6IMV;QFMVLk)k!Z8-_yVU|k39{Lc=YmJRFuiu<9)5#RhhdO? zdbh0vZu{5__T+$`8}mD;aj4D0cIydYKGmBJV=Abth8MLUm-X7L2U&u3x_zQZAxuzc z@LdW>ZeY;#+;!vYkn-sn+x4f4sDEVq^ebQRudF8QNLRla6qu_Ckml*60JM6?p9YIp zneZ{x(f2|RW@tl!pJnWXf%cuZJ{?|2wBy1rG$SLM+^3~>eAbO7#1odK$1V%s42`)= zhH`u87haOtz3yi6#m~Vo`z}f0Qc;(oHimC22IFaJHWy!x2iN2o7I}zC5J)&<=1Sy{ z{-9~z_c2Mp;um$V50c1vpQxLQPn%&SlbI7|xHs^15~DGErXZP@O44skZiUXg2C~Ev zZq7S517j%s-#BzGg?YlAvI8_1iZyfSBnOCJ;F8Mx_dvv_n>s+%2np#UOudsIZs_~y zi#sv%#t9%V=Gj0b$FD#f3%TCk{&)i|wpi2UI7=M#@A5=Sz8DmIsd@Zzpe|rWn?Y!S z{TZabiAG3}dNVGe$TIg8gvCm^HPPz+1fuV1`}0_xFP)5kN8E$G^)NM}ILod35{fPB zm2e5zmUqgoiN%(A_g2}}(}{#k$-O#pT6xAEG*+ih(7z+@hwGiwjC-&pJ_@{a{b0ph z_nqbtd&|RTp_tYivu?duTcD3tv}iGiZ*Aw>;$eX9TezTPvv#&|-BteUqdvCdREkv! ze*O8q?L%&a4w;#I>6@6P zxy|AS+tREN#OvgwHR5eH!7=2aNNq$bZ`iPuX&we7tgot#$pW8UyUlaI-NVC(nv6ez zPbJ3fz$ncO5d*RUBVt!>7nblRElYW_JK7 z#1l9n!HKO+dTyLZU{(hwnEgm{W+`EUQCeiAG*7OZYXd7zSa-7+kf|dZkA=5*UXa-i zo;$&M4M}hBX$EPVO(jhO39@E$>0dboP=oK6y^B5rG60k#XR-nt0Z8&MD73w@81f02 zKxj|r23?|I)`>n#@fI9KX-D{L031vxwG{TqVe77K*JqrEi~~`XD&x|+PcQVXTd_xB z0iaPp=WP@2nq}!W*Iv^W@Vi@^I4k1JK{j*P7+{ zFWS)!n1a(##FmaGDOEz$6v&@;A$c+Ugi>Ye@VNnaPB2=!Oq>keEKCcv`r%G2Rla32 zMk}xr^zWNN6HS(}e8-bM#Ki7*k(*+o`+K990%}rr0oKQ+jESd~H;WNTTJFS#fNbfQ zy;K94!E_Qbq|m92kqO6^o2(O5EGN3?kZhct&$X!GC#>IT7}%`M+6hz34cWxgOUwRH z3m#=6Qsr#6>gHx5_0k(NNPiJ#4oe+P=gL7Rsxf8IK8$*e& zOWpKS?B;g@)N(LC7{lb9t*BR=k{n!5<{CMWVxhegg_b8STXE=L+khr$mIl7gfVfTe z`4AdqmxB?EM$cWdA(_u}@VGtA9Xl2k+KC6x9V_C!xNAvQx|(XW3`?|+TgrYsNcB*r zKBL@$nWXez&p>Ab1(4*7=^SSOK+@K(xTc`m6B5GEU`tR(%K>Q+#+E8{a%DWx)YmoRjC> zt=Vx)1kS&#P!{=;m{FI3rPpFERs-aLSzX@wt6;kgdGC_h)7^n);a!+@H3zZdXI8tN z>h0~B@!k$zr*4PYdyRLl-FvNnPc}}Js9m0g8%TG{*>%5VX_Q+V#o_xm(7V~-A?uDe z0S0nLdn$O2Y~!4B3CP|mvh-e^D3)OIZYcbwXW;2MHb5fvNxTbcqpAI7Xo(&!jFulN z)(`DP!}WT*MSD@$8LBFIWK?%{3NOaea!PAt)Ku009dbb8EF*(_debc93Y~(Otvh1N z>%Q~?h+ZZtp>ZJUZXaUK`{rqJ3r*>6qz#%hKtmK_V-L{KlGd`OE-K0XHiK>Ofaca+ z%oI{l&Dh~Ux!`I9!Ua~&p>^PW_o2XjjndB^nz{As^^^m;y-Ag+nk}a|9Sc4%Ph8?; zmz0xvq0(}s%7IifC8`Z2=$B6|7TLHT2S9EadAdLQrO$$h0>9{ze8>r{Gx#aX zUl%kaZGTddzmZ_ku3PeRgZoZ}=ZfWTj+wDhl$n$ysBgDdZciEYB6>wj@3h}meW1_( zRd2pp=nrm_hAnwn7a`O27}6|L5a%KN;d(N^bZA~=EfPO1dg-(uKiI&7pQLYn^CYno zqnH1o7vH%5d<;7ANkUBUOwF^bv=2jMU=QS1B#_V4c}UVfbceaGOl@~Lp@TbE&D_rX8X#EpB~Bifl1El8iux4gQL z2QR14!S+AjM(!_>M?{|Hm)~^CRP%2ADiz&X3|{PoXQ)@8TT{d}7Q9quXa>7 zB;RU9Tjf>z%+ofR$uzliDg8{%UyHuw=~-%j@fjRF%Eh|f@T)yy^AC{t^Q#dl6eUjN z_CpP4+=l@w20tsFlXBn4=(p45IMQ)*TynnnUu~yArdpT7F5(D3j#M!^zuE7p2tQa} zxBtHK7vBc|l2ExlY5#&i72$%)JSBXhPjutS&d#qEvfs*! zCI3`8Yu@;4tt#9u9EYv?a;F9&n{9$Wh9#1qg@CgRL6DWa2zDY^^$+zpcMZRnpz z@V3$w7+FVBA0IUFcZGhsA-ye|d-o#u*@pOTp*~&pQu;4C5i8Pim(wH#&mxJYf|pH~ z{X!F)bnnB@%OBV$KV4I4Q+T@6Ct82O5A@HNg2oVSo)Zc_%*yAH^HE2N(|Uk=68c@I z1MiZ{k?H$;NTFxtla_F_tjPW~uF&&lSXMGBGvyRIAplS{YHe!l=|m~k$m<-h|V)9X7>d61iVwsOht9%$tGO-Wm<>< zka@)n*pl5cY2#^^8Q&^{KpP+Ts+ytV1JuGK1V$XVtP7C)&q~mM1G?cp7fV!=#La7O8L~O-*KRQ%f6$f*G}B_V-Ebg(kg#0dAlC1D`O6~JX{IA zvmsLRf9;wr;`@FS8E$^v2T=GiNv`8)@|hRs1;+7&N&?7Dy!6wRy2EsdW<*7(1Et`!5=T`Hz<5Ag`D0VV?c%^C7N8FaBRBi<~`K4sBX{ z|IurFx-24R*)-MtXPXj;gptMZtHOee!P{iilaJ&%?Fw#pe;ro^%3sJ8a+wqTr8jfE zo~Us%VRP)i-{>ge{=B=GW68bb7zw}Ry1(W1%7z>Mm44sD`zOtnIe6oAUAufrzoljx zZ^P-Uk;tBin1vcp$;ylk2r3L135oVK1Fjq?Ca_~1Qass>(j1a^t zx%d)#t}XG~KkK1ed_%?d&nNsI>}C1o*$4OH!!TRB`Oj=jPq%!1x5S+3vyc;f%H-1I zA0!_H(U#!!G}Q85e5p^$W@!Jl9gut5JdM1Czx9?wuj$D$6A3YG)O~O2wLjYa)266^ z@{p;^!yNeKN#L)8yi&vDH<K+vh?&ygY4i&1GRx6Vy+TnS-)JP% z8Zf8;OS42_I`+VtU(+j%r{lZ8#sgjP5_v+yaLpeBScDa~Y+m+PT@@>L+E%1YLwh{Z z*%@Hg9%l~PW%`ZrOq>RG0c>S=HX$9o8(slk9EyR(s_u#6P49|1-Djuy^;iu|_IBh1 zxuvj}2+?RsoLGCXxjYa9pfOQLf*Z|?F1>=?_AYJ-r)luf1Wv=07f;5m(csbfLRR~? zA&mEiewfPc&0L-j#doh!~@G-YhiiK_0mm^77(`b%6Sk}CCc>TQ%(1r~6X$Q}0 zs9287RIeVbui8A6Dh(3+e`qss%v6xKiv9etk#?K+5>QV!i%6lQVvSVrbHutyOb{{| z7s$9OGLI+busQEOv9W7!KJKHfMb__LM;wLC24;LBIcyK9WFUHdDZ8g}G!mQR$H4&T zqmW_A=gc!9Nue(E4-#Z@Xr!~w@~S%7CVSolZYrDHw09mAw`0ev-;I(G*tF64vgAH* z2FbDq{OGDNmfUV27#tXB*)bTn;)N~_z^MVJZM)@hP&KYM@0?(l_-lhcg1dSEuYI9N zU}x9biG!pqPby9hy7V!`x8Te|r0*b*XT%dr#Q^7e)||uzsttuy0;*b})^#@YVo zKv7rCJPs9okrB2+x|*JSw)m^FG+Gu44Trw7zn#!&7nA)MyS?qE(pa*!v$ijm;pv^L`y4%53G1EHr2(j0(UVht6@AjFO9 zR^`>_@+vM!qa_qCCAfH)phX^|_rm+k9JH<)o(w3viv)b$!UYopWGdzcn!t22X~HtW zg>N`84{-t)s7foi?dPIEaXgA$D(h4rt-|4!3Lx64`=Qb#J<_Aw*VqNO%OHK|s1Cx; z2NQ9U4uC_+dSXIWP%2z7$ThW3I|dCYcH;-rD2>tP5IEw2WeH$I#U>OKVQNl2^mL3k zZynItAv?j?} zv(QZN7RxAlI%CeYKf0A@Dw5Q$>jSK7X(V6=a=@?^Jy}}$^wA<5T97RwrfiK4rm1fM zrVc6_mBVojR8fdKDdK3sg$vftAs#k_Brnz zd`!0U7rY3)$PEk%#IX{pbOF#k(z5^U!)x7R-i0-({S{GjDgSwe&kqnbeZLVDhhLyMN!db7e zde=xzoooJ3^`2(fkG41A%bBwyX&2a6-&iA>`gZPsuKg59w$PD%5t;%MeciMuz16RO zdyIn_X1w4R>Z9WqTpW`0N?nWDegTN4|IEgCMh2ZR&3xG@=1HSLo^P|)*pd2$gPzh( zGgh8Z+L%$rJ}YGxBoap2w9=4mWKE5(-GEJ?u5^e&q}_Z?0d7Fb=wjm^uaAkuQF?Z!8ty;<^ zDG6aK4e12kD>Wuiux*LfRtjv1b~g|aHrm|M@NP6Bjjr94MCe?JIfK}{GKmYgzJWxb zR=Ja=31O8&+_1LIM2V=CHWVe^Ru*)LeK(F07j4*Rz-{S79bMblgNSk^gBN0Ml@4CO zx{ad<)haf7CF)ip)Wg6VN{OhI<^^{n6qs7MK_I~!O^Jy%>a;e1BJi%9s*m0XLJ+w! z&<4B>tB8Or2yGbNc}1pH4d4=$E1hm(j|&au@Gw;3Y9;;+Ufkz|XeIuQaqCn@QdCdEc>9e&D|A)`Gr^~@Y)3RfToa9fV5Tsa+l77yNO1XrtAa0{ZA7=IaVl}&T-IcV?vqo=nyXB$ivMw^H+xIR3 z=9Fn9BVUs<}*VuQy?=p2KieI2y)| zvg5v`P~0h)s9Mqn>x9Nlh~-Qht`n-2Zh|I;+!R=5v6*#ZwepQngwYM`%a`YSi6-vY zp=wW?5EE%{ES6|&nV9fZs14Z(*&7PLJT_!Z_^NcX9+B+L2B09DIwpKox`CNsaRUT! zsg02dUzIjlCaB&_0mj*MJ0Vp$yz}iEy)8z#F)8PyqDq$$80Z<0!x?-vt+ASx7_~!Z zAysgCmOZRMx$iUPi%A79_-Fm(jg={Vo5mNS9KW!Fp`C=i7X#IgJAu4k*w@p|%fxnh z86f35GLftD&E!PXo6LZUHfJWZRcfJpv9)G1(Dj2CqH85*!dFx`JQG`Q-~fDW{7n0* zx~ZDDdJ_l8V1uHGUzKhuCbHg)1FmisC$uVU`o4f|+)kg~pGPCWM#6ykgcuF(uf%SK zC%SHO10s-B~aqVGd zFf$smPng7+nROL37;I<_&Nb)nxFCuSm>hHl+#~=RMIRuc*LOIgq8V*MslH-05dg39S3yS+&v%vcyog_3aJ1&K*qn@H1L!4yHbxd&kl8&rjDosQ_DJ5BGOSQIOo^( z=Vn90qzvp4j#Ks$Q$7@FUe(A@T5?bmimhmLg+9~tNKGfIh!}+qmJidRB_cpWv;SFl z{c=nv2Y{r9dMrWXJVOw^S!1s8JS06=>wjG$?C zUNvYeIX=WHN0x`yfY*`oEb4id1|%SoZVd=nQR__A*s(H%i3>K#5nW)@m~!8-V)O)2 zu%SzWcdf}g7L^@T_kJ11f&p{AK@cap#v1Q;C+T|_C<+p4s6@Ioxt+V#lpvi^9{65lCVcH}P@7zQ*H_{*v)3~Vk2!`{6njf+lg`k z4}wa)NtwmQ>_S=_(l{3Gs>WWdV2c4$q1H*fnsYR0=gY`scz2U^bk04SEvx}es=m^Jtm&bd zLDsImEV}i~{z3)Vv1S1=RE!e2j;2yJ6VV6f0R^24riJ8}0FuckPs^^a1EV}ODfz*0 z*wvz!oJ(8L7upqvy_=voT4G@P79sU-Kv$aboO}Nc zoxn1JDp_PI%>ihTsrCM^0_bR#(#9jJY~Ts-ZJ-!7jP67fp9x}9&A1qhkSgKrpn+?s zNCwPa4bb(7kOEuFfcoT7Vjzxk>=9v72CSLw3AV>4R00V@o`7qQV=7qmSz#w(xnQd< zw`I!CA?LLxrGNuvsltg1hY=9?duJQ@M?f7BbWiSlR&nB&T^2a{G!K$oEE=SbsfM|G>TO!)l`psyvq&yW>ws9~Pi-w+Q^R8k*I*t(v%XNd_n+ zX=_y4?KWf8*xfg`0l;jNVKY-f2biz3^!c9VgX)9+iA;vp(O;xy%{k!PM)NSpu&o+` zUmvaQU}JIUk)(BK1~b7rZH)gqaH9Sg)dtcRZ0`R31qc3)mf{PcuJ&q zFfy<9eEEnjJf7OL&s)`zx=4W5<|9n^E*Sx?*pZdq(izLv)4?4%|0nk~U&4Rsfyb+L zvX?YIp$kUBzEnOo!YZM&o`>4dL=%0Y3()}jYex}b{WiEtxu>FfB1#k8XbKvAHkAUm zZZ6yNv->Iq?u8mM%z{}i;|?htfCQ+Ov)u%x92(Kq_gMxh9qAXPpm;)~_qs*+wdQ4x zUQmWlqXF&2UoU5&`u3G1-4#;bvKBf*uj4r7JrEKm+S=xL*?E|I54aQ3@)qLQPmoc* ztuK`RG}_54^a()&_<+UIv zvl3PPY#R~ZfIShrbzL-`~}$ zxw3_zOT{m1EjE~Ri6k^32MAi@0ct5psb8gx@o5S@IGpncQZE}+_8R| zTDZ&2-t^@=mg*WNK8wMSEIEjoF9uJQYH>RzsyhckRvZW2U>{F`%c zt04!di=yvopA%C1r=dk<97WL;a}yo@t-H&^ovham;@oDtPpON>P3=cOJ?8vsJ^x9V z{u*k8JY{I;(T0D2ni%Z9>-9bJpV~Eb`8TG8`tmcHSD}{9q55_^p&(23eX4PF&7Ww@ zdH=J-KN2X^epN4{;E>~(alL%GwrJ~|sQz4tb4&aDRQe!krTDE?l*|h=-x)fjbXiXQ z!bjimwIXtzCu(2l-)EEJ@LT)4r_ysfOunbaBwY#t(TsH3pr z3gZa;)aRQv65{$ZT$C<7mHmB@mXk5%9SVg2{)&A64hsvVr}o&nqu}x{$^XC4NT~jn zW#9b(e@Y*%*P=$PTE^CcY4>7xapY&dF{?;UbckO2iEG8LoV}z!w-kF1r1#o)dtL(3 z<-Sr&H3W~PBU>DtPk0#r+#hX=j&?s=?^mot_V+w9$NYXnH7%YJa10bOvg;%{nhyrh zy}8lY2YE-SX=2QS>EaEPRM2Lo0T>Z9xbIie1#@`(WF=PCcfQZ&yXUXh_jRIZ{f&+>=X5;%;7MXfyj|b#^U>f=(e~+i`F&}+1TQ+_otyUcxs8JU>hby+&HntR z5z=LR1?F=au6T*jKl)Lwehu6_nLkPup89Gmn5T#V;+B4$`qw76bohRe1wJZAB*gUP zIam#$;NM*0)ZjN-M78|#7xWSPd)(GPH+O5O_q9qAeB~SO=Ojn?YxR6Dli}78zTfDp z9kk=V?oDZXxJZ|sp^*3UwI74ee)JnhME^NmGwiIL8{;R|gmF^tJKyw1<=>08-g8Gq z=11WR@%5wBvYAgz6_r~~0dW663ekvgg$YUTb4&jGx2sX{PTnN7H8c9nzWHHMBU#hLS*>* zi+Q?zCVR)6y5}`znLcIlr@!D1D7pJa&zZhxD1Vrx z5&EK+CG%?LXF@(PU6L37SBdE$G}0wJ68Tr0Vc-ANzjwfC8dP+ThPOHK6C^H|OB9!S zD(aP@9fMP@4^!cHI5aOQ^X3EcIRUS0zaOL&^>y{ zRea7&wfg6=pv|1RTqio$9um{ZE?MI691GKH=DQJ4pNMpRQvN2@mpw2J7*@K7vh$N_ zD*Miy+%H=Y`iiM6!-$FmDHSl=tHu4|2wu+I@BMloq7$TA6c*OKR*CPxROfHF`8h~- zRGAkORk`pFi?&XOOe6$;L^VKRE2`fjBT;>!7wd~f<)I^I{wQLV*_}r5^n0!{w~`UW z5zo7M1hg>R!y%*{{hLSmMMQKMPx(+}*&4dkBr^a1K>+miuix_8zJ}Q@$B>Tb*BZ8t zMGj?5NDK9Hs3})4mSIw*@-7=AryDVa$>fJtleF34qDH+VvwhrR6{bSI;V6}=?!kEf|I3RyFZr>yB|9MVLp#toP-aU~6R6qN{|eEZrH z=&wnrD$-ERa^=AxKy$0i3W598nj+9OEA`*+7@??nhBsa+Nwgb)or~7xyVwi}csF1e z+vJ`8s@wfRb(NYjQn-{6M?onyh*NxIRf7 z9c$N137QYN%}=q7w-xC=1I&faff>J9AHo|#OS&V>Ba5S^!~!w9Wtu`UeEzyWG04JKt;H|BTJWO{Pa79s9)85r9x)V~&`4+G#16-<~A z#-gltXuCp?H4?NoBsSZUJuK)V#l^DLwQvi^dUo(Q`eA_f3>pBcXQ1UB&8isSk|Yyg}kY-=BMyB^07Z2@!l(A8y*YNlDsB$-|AQoz0!lR38y#p%vxSz zqP%QaF#v6_-JwnAzS=U~KuEY*$qB4cwv8i%>1`%Woae3)aDcmWo4|cdg^9GeBL>{& zZkZ$~y^Vzulyg&VSls|a(ECQqd;@WYZBU_irJDe5yA2UH>CFTL-rPn4?s_*M5p3U6 zA+dLN5`a7P%_Rbco3Rjtux_CZYa8GaZEuJ`M}3fZ^I4S8UGFAQqQcEgh=AMPiFCWS z5e5;_8#@VIBRqG;$3NPEHO-JCIrD$!-96jommBm_<_BGzJZ2 zplb8WgWrWtT3|Pr2BEBwZJAeX4qR3mu+9K7lsq;nh&}OWPb~6#ajaI1ns<-wx4|-y z4lZW%E|t&7$&A5_$8U@TBa9kkmmiu^?B?tq;*B@GS-5F?qj3XYVgz(J4U%o~f*IOVwB~3V#WzZ0MRBn8^s_A5ino{FhT9#+>N4;71)bk*^U6HdaRIvZt4^W8D@ zW&U8fesDs->?=|lh<-(#`MA*WYI!aprU2c*ZeB05!#O5^W-9NHn&mCbb5Y$lQaS8r zW(IcMF*aBhY*SckVHqnc<9c&;$?E_JV>=vyJxED;E9y1tsaH$%VkZGNf&vcj*L?7p zIxASbwT>Bs^XWUYQK(|J>OU>%*=y_t%bd4YzY9af;eVa6!j-1}WuDTNs(BAW9#-s0 zb<^c#!W~)ONz3pxi&Vnv3Kw_36m|!T4140)t(j$DFeeOl$wZ(hEbpx0V9dZ^LownlLj^336HSKhY^^}3hI~&tA6Lp;%dj~T|IKW)gO3_LYVj9&D&Hi+0QLZZ zY{N1=+Gv)API6AdkLf#TNSv@Np0=)`W$lZD9rcQ6E>erIDE1Yaq!ik45tE27+HMe+z>CM27&Ar22yPk7F0Qk| z!VAxw(B1u0v%m->clJ@m%;AiW)mm`X&AU4tEJlXwn4MYzlsW=9!iIp3HZsjaFqIvT zwWhkVuCt4Ww;^{cQ{iKu|JJ-!Ud<*4X$puvyOi81J_g%fFk?TZ)aJU15u@p7z(2lo zT5Q#V4p1RjbIWYH1JR{NgMwjiVRwa`95GjCinHy)MD26fPj2neNw~7{3FT*G4BQz0GOsglQ2~?+ zSEIV_S~I;8-?|v>Iak$dIXgaWux42FwuJ$0$9DjVU)UJNGMKoFtGF)E++N<&)90@P z?d&UvBt4#vy@|a6SUpD!wA=pGFiXOW*pJs0K&b513YB$-_xz(#!-MLac;@p5m&Ks4 z&#LK1_E*+n)-dCQ3QHbzGCh=wTh>syb~f|Oy}AQYMkb0^KRG!%Pt7O z9pQfLqOHiQvP&M;xKo`pImWsgjrYQfduktXO37XX!wI%>8)o-J=6LPhVF8H@+QnK9 zdja(E7N~&w;8KJkDvYGN0v8-4-2*qq@E?(zh4b z=;ZS$;(`aqRS&~5?g$HL9H4CyAYC=wQN!RWVkR@&K4Z^RU72su*A((l`&7*CFlpT% zMiCOf$q!r_Oy&a#cQ!wRcxyT;Zo2y5Ck$X_K?( zQ7A=|`a`-h4isdswy zW&q5c@@BW6Pt0o2JYns;tJ`eL6Y);@RoT^N(70-D+rBuMAu13B+dT_XMLHz<^;N7K zS3l=~fUD2b5SmWE26TlAvlgu`U>!5#W@@M%9&g}%4!GOU%shRXg>8$&j?0v0I{TK| zEUC_e1Gk+BPfczv8lS%kep~GFItOuFNIU_8GeXO_gyrgdgTL`kJZbL~VK&U#t7OSu z%6i$DJ1f#MRph61^=|r7v0qI~r{mU83=zr(>!ESi?E2Hy>^}QKXK@l(HK}^_T#gZZ z^S~rK`cDR{jvIbP#gWaJBk#MD8BekULC#^e25Nb_c%GvLY&cj9(xBP1S7dN6V2N={ zckSpa5nMI`WF_>i)F-_7ye&$g^<*y>=@Is9^X>jtI|!6u&Om>!+Zqcu8{by4-N6oc z9WF5EeJ4FeO5e$Ov)-16!m+hqv*hpt+rmNOss!R-5nl&9#k`iY7uH~oij}#^Jjg3u z80aKHGY(;uB52e<}oc|hFR zOM_CapgDn<19Vq)UpQb@M3J><-D4L+&TMFjxPJO+y`(E%Asz0*K1q{S6L@`X; zWT${OMhkbX9m4)!k3JsHu~j>n*Nk&}*3|VZEG_*ia9}5hlu(O_3b>8m3 z96J?sERgg~Ockbfx z(Ah0Lnlfk~=;oaj49VgXrz)$3tLB6bY4ZZ#)#XmaAZ5KWDz8I=T&|jLbBCs|zMs zVuVog?$b}1WYD#5gJdhwCx%j=H%Yn;fSQ_7X~4BB)FSPI)0M{B?Mv-7DjnPDZ2Whi zlHRowxN5az9{ta0#Ik^0!^pU{yIRHhQI^~mEVCZGKsxbXSd6Ys{gnx)6Yz`%AT#>9oh zDXcLHS%3y7D5H^x_i)AeG*a08tQCl1Fs5M7$1_d@w643>gEf64f$|rnuLJBxb{i~} zO&fw)7jjd=)@@^lOTxTb$1{`7SF#==#fSez?A2hQ;uP_Os>D#)fOC^wdu~0X`Ovod z`EkEa&y&JSs`S-7bZH0bb^0yVo7JkynUHjD6}_7??M^sG+vKV`+ITQBYD_C2z-j}6 z?scS>2~MeWkims{)ZdPasw3!}NjtaduUaVXJgWv`3t#9Jv^DlQ?e|fRqzU&xbUrUv z9Zo=Y-1uC5PHApP1V^9^-S1OCI1*{Bmos|8#*hM=VqM;fI{uoZWA~(5i!%JLO#%S} zTU=a|3cJxSXH5EGRSIuA;?5ES(KF;KLHC+=a9FHM}<{a%YK(QMq0@X8Sf=2F2Q)%*{P7AXZ$BEY0S(7eWF#?Ia zMkViap-fz%FisevM;Lx6v%Dy~-^gV`M{C2uU)qGX1;wExYKcQBUm62vPkEy$kd`CK z%8DyE4wbYvx7l-}K(^Xw00e8oDp8E#wMcRvo49~7M!oa{aO40hsd%r8F*8Szr{7{c zd3qr<91(SNFd&;2+>Jq;~%o z7^?TJ55?Fu6{vR(Utxh7-LFh10d0j9TpsNmh0^%^b#md;7*0$i?v*NPv2!2SGuXg6 zjSJ{MZdLhxuy?%xNbuY0RcNJHcJ5eN%v-9&!X!(~W$FtQTLf0yn);|1Dht!#aAQbR zUzf?rcPJ)BSzai>(5+CjIi4@|mcD0};N>|w3-vgR422?qp&+ylK?}lAZ{Y?^W@R`u z-LQ)bxi}rREMNqIDt5^1=JK!=kv5Ep`kPz&lnUHn6sE- zx2hRMX&}~U8oaI3ESMGQ9C4OOUKMTc%yo*jGKbk>n?mf^s>9@2nDEqFS}oY?AQ*aw z0}HXIcYBI8S;tijp!fsV=IU5dt((_|Xs(PIg9@-SD;3q%)rUY7VY9x5(S;O`WfJGD zW}6yU-54vBq5m$Vvagc&^bMxxH|bzf+?6`^4uK>Xr=F5n751piJ~_7Qny(|09@I}H zy&78mYGuB8i<2pu{Z-g$5nMeeLN_51%%@jGn z}8}e`aY?$n*`I37V&5h7;TA08>rbQVu%%_)~@Yc>jV{|pgS+~t$PjN_i zHPeO~kWSJ79?O`~^Z=(BW$#$2u()29e(Kb=D=K9=-$kg!y~dl>$6rTrEEP=qQ-T5yW$(ol(#og&yd`s-S-z zlTic-H*cABm5~yP;q%3TbCeQ8Z@!tkN=u2&++A-HgKwI;LC^Im0(b75TZACzO$GP7 zO{<8v>zhFc!)~rZ49dn%iPiP!i|__i;^z%Fvj)*nRAEz?nOnY+PAM=ueWH|&d@qzo6x zHkbm$DdNT#Ja1QA6}zsmI;y|1w+`B3{8AhGo_MVrcvco#8xdP)*~&&4S??=)riC`iI!bycZ{7*K7HtqOw5`u=G%)+A3H0 z_Z#V(J&WL{(uTkuZ&W1^++Cj0SKcbD7=Lw(C@qaiJ*}@Zlg+8Z+mSL0Qvzuyvq9Hx zB1Cdz>WCBmaQ7ihAV0u10p(?mE=}CKnEIDH54;|oeLWr z1&x9(b5}_fXOSsv>MZ@pf%bo?G6Vyne!o~pItrB`t2K)?L&OAY@=Hd8TxnxIb-p}) zMG%VB1x~|V-yba+uI_4j_-iN2X@DBL%|XaP)I~zHG_9t@ z@!hm3fus#kkxUI8DXb$DEZmzvnex(8-ZKN{Tz%PA={sv(NW{2Zt=>ZL9Lg6pF^#Xp zf3$55I|Ev0aF|!%RACA({(BBigVQeO(Ttj^<`z`dj4*S*cz|yNiHjkdyOFeJ|1($s z3Q&7UObkKh#3vID5daM>OcX?>(2WjuAq;GAB^@)jE|@v})i-+py3&N!%4Z%rf0Nwn ztezYm5;Vp{ngCUx#?-ti&&(Zm#qt74TdFr{W1|!+q^!;bA&xdZVz@ z>kXl_v?z3C3V}$-t-VO%K&j)D{5e_~>|lskd|ev^nXKUBqC%X28L*TgPN5ZsjPY2o z!*L7&*>!Sk?#JuUXmjMJZ(T_tL2S<3v>gCTqIXC(Wcai@siWMPJ9etD1Her0gDDrbL75r(YCtsa+VYKKRLV3 z^@TRzfK;TaPZ#8nX*QXNK6W6(9`)+)Z6kj}iV*&z6K3SZU_C_q#NYYI=)TAdsI-t1 zT!QKk`M*hM(sYPF4HrPaob(|ZVaK~9%l)DXG+gnN8gh%xwJpon(l>IKwW6UG{h#>0 z@p5K!jiqYDl@ zhC(JKS*Q`Hr|E>zi}K0@?~&)rwIMrq9O&$gGTRm}k4GA0`!thGN{e<+TRHCvrSMbh zw}u$-e>VEM4gGxp?>$|SQcNU+l$-gVEoxymv}DRDM`_Es8qT~34i z`Bh+hut${3+~3&IWzxRE*+^;Z->GNrDIZ-{_|);sJ{zNRmzRB(M?S)%%glP;U$w73 z%B0JJo45b2egBhv4_mNP@OJIbe_;FL$NZ73^tz0&Jip)i9p|Q1%M|^QwTJ$!uu%Vc zqd(S;TIh+Y=^X^hB%no;*EQFBU1sZ9Mh+G6^V!xRxCjlp_)de#{tF?XL%x?>WpOio z7<3)vq=luPqv@LmYNn$&zMknrBzU5vQc$`!ubA&VcdZPbF7k~n3{8Kbc9!^PMj=oe_`mb0re*52QP!xJWB5nlnTO0_^@XIE7o7ZU zC~7{Z2b~ak(L$X-l+V$s?lV)lGA*P$_lf$)?-w9X@+KxPLRr=rBFX`M zqDppQ15@RE8$Rr|DyXx2UYXlO=GgrjDnqbd5u zzri7NRF78L^(`r>IVWnY_?jXmWzms9z7(&xPh_M;&ybH(?;|C^nO$gWR{Zd})wL2a-n^m#vo#D$MOnpp-ZJ?S1b{>A+1%%j-38_RpJ@OZ~9f$1N) zrTLh2DQ}c0;Dzpd+D;Yl1DUfkfDF{Ow;~B}dgHG8fwqtTg5Sd364SFDf8Kv04eEu! zPdxoy1F2HfCJYA=> z;;e`Kq0$daOh*i$q3F#mrv@GoRU0Xv)99xYjdJE}GB);g+a>0ipY%slO`~9oEJ#Ay z^!Rr)DN<=W+&n(%$CS#)y(J?mdXl7MO7xEnhqV@`zlR1P@pxD&DRzeak5D@k?HoB; z;6Z*kNn{xxnjMuA%ODxG)R&tp78MfDU3o*aFcwqJ&M?0?x^T2pYM441Bs{Z!uN4_NO?~*gbHuV z!*U~ySF-2h^$}7?f0>c}fdRNs{R`Im+(#Rm7~kDOg(AzMp@)c;q~l05_(^+v-J6J) zn{v%lHAE#o-~UEzZF8C!4xq<71ZCM)6T7D-ATlr zXdICFalSbIrYxtDh&6xFw_D7Mpftx3+oBL)b(+{ndFm=y_PLB_VLpG-{uUvYFvHh;P+;yA6+4<}Zt8)z0O|+omjx`$I{Z=CaM%^7ZDKk`c4y3NHc$IU)AuS*KNI zR%%CqgziB;T3w?_qTbA#OMS=kYoz=o=Uk90`9V|@oaVS^Yq<+T?aiG1Mn7jjl2Y(L z8dQb1`Bu-BT1{o#|3pnI zu046@#&UgNRT4Bnw2wWi@ui0bycfF@opdA_EA6Iej_@e~h*WNAA1T^kN&!o7BW(v4 zM6Cs312v1NSVea-qeAhBa$5Nd?vFHLhv3GmI5{4!}bb%mN*1?oNVr;!K4ynA_jME_*04}btql>I8uWaU0pmZeL+f7=|t9dRkB9+_~VpUpwF5Jo0W)wwgFw*xa;O*>u&f;O=g# zE}DcQ4u$p5z&j`>3F*7EE?Xrw*|ki`0E^bY4IPv=)@O{qz=f$`)2=##+GtDe1Qq@x zOn3iz%8XUjdPCdZZWHAO=k9-yDU-JdBE`n{Id|_)QeQ1=r10CEP%7vKp__JTGPV&$ zd?{#~%J+IgV>bY>n>`Bnot|z=0RUpHH+P`${5@`Lc8F8Y zPIm|$a7^@EW7XJg9hc>Uklkoq+sSN?ikh>K71tTe?lud@GCpp_J^1vZvuXKc>lqhZ z&q_AKY`|g@@VgC!cmaoCmYX|+nh858;*a;?%-2t9BByiADgz5>>!(=a+RTkFD^3GE zm5}*3j_>$D9&-3H>jR+zTdHwAXCDR)UkQDNU)7vEIZ3I`+Nbu>@I*ed>-c5a>az)g z-)(lcv)M79g*$vc1C^!8UyHKgQ*sp83x`4&rlXo)eCh@U1_K&E965cFop4mQV;Xf3 zmK)ip9aI~`jGvy^hV>`IZdU3SN)>|+-XuqDUAETL6`~_@dy|;|X`?||6y38{DU8zb zB$?}LD)+`|Bh+(Tl_Pa>i2#F;IN_~J=R1HkCTv?p`unjwwJqicbAM)t86Uz!)&NmS zf;8DD&!01U>6T^C8VbT!FNT2j00>HyV3DK!38;m zdD3?(c(ID?R$?Ax(=5$;j2>0>3Y_r_cXKgadBoJ}cn~Gz5Tv7YP6RbTn6nd?whe;( zat8K>2QxDX7s`Uq51b7HbfNbf5JB(|x?fx}RAwna3~ITRae+i zqQGZ|*0R(5uB2C^aINYB+RN~|5#nALnoMx0$k`n1t7pvF!W>Y-v@X7=Vr>@8et+3u zf}))jE@#|)g4S?OVT;a(i4NcLENm^qB~I-ERab}{_THF$x~-Cci^A8S5ousmx!cmN zfZRf6K#akL>rE!My9$7F|FH{@#I~S$Tx$`Iuwl0Kd7JIQnLn?my1JjgRf%1lT*w-* z<~EtALG|J)7$~p{7@HF1Gh{R!GmXtmdq=V3XZXr|Mm}`pq1PN~(7vwXIZ3R37df17p(> zb2fJt8*>@$q4}%mZZj)a?S!=nhyH}ZZf=ppOeE|zIfuZe1K_hx7ckhX@b@P@ zpZi?Q?UXla_@w0lhaQaLs=fMQ*jfj!1DST+A?jjNjs&$~bJt;qK+QU@J}?Nq3D0QH z*PhjfHDktb?a$2x6uxTaMJmkT?mRo0Tx$AVh1Z?i9MhZX!!GO)vXg!LXghp#Hhj(jDrYKC(0)NQ7mE`LtGUypW7{1aB*&UNQ?cOjl}wDP)xey?V$aXy zHWUPftiPwvbL`f0tJkY!q;KmN zk-?5zwL%F2)<{YuuJK_0n8C`_sPJBc*ixWrsBRUm&YQ48+dE=*D4NPRr7ihkL$v{l zV#6#c8BP?!rs%jx_2<2=%XTAW$`YweIa{ZMOO1@1I1`+EfkK-UWHS@4b*sN08wc5C z-7A*u+@6tikygxmTF2B)dRtp4*U^p-b}KpJ-}sO$cXn!3yE=$U=&Rf^qXpYMy^ zablH41K579m0M!_RVWt@5cf9n3@u99d8_)r*|8C7(u1P(w!J~pt~zy$+Qxm|610`| zDGHdb{h`rb1^fcV8hNo`w1v?$kUxyBZqxF>*V*DWm#j&*I*9NnzHHd0IGSbldJng} zU$egnmk!Ha-X$p1LZ$lJ{=LY95^>Q8-TNzxW!-aEJJyzC>|Niz2)U}lXI`g0c7;AO z(#%ExocPR^7LCM2cD4#S8uJCoWr(jU} z^9Y!-Ak5IThBsMq{<4?648jcc)%rOD`%j*sH%QW!>2D*ox=FmP=o~nU!t|vq`O2~j zn8;$erey_WJM{pm4V&Qlue&h2b{=B^cDFci-HRuz{pG)-7Ta2FP#I_LF4Sb=J{51`^R`PWEQH%m^VKuU#VS*Pi~E*7E%fRm10x*c_fnEL1EHjbXC0H^(&V?BV~ z6^rQSpr}IDI3K^cf9zh3atwg$>N%Y_V&Js8SDbK6O6PW6HTN5*;Qp{<@)w9E$nVn& zFWI6tF9zBjD~HnQPwG{BuH8EqDpWDgg{M4R^5hz^$9ezzVIQnRf-Cx&0>VEJb;Z|TN1q+T9e8Il&$OS})ky{5v_m@)Jq}5yzpIe@^wbh;rhD>BKZ}v;$=z!Q z&akjv#kckg`9*J4+m@(g97bLTLE}PU*Huw^+cAcY?R@rB=+}!5NxktsXhv<`TM``cpYe20@+PeH(3P(E)3R>|T8&81rUtveSu%{Mqto>_Y6 zRL@S5qiKO#CjwK;G0~C%Cj#L6sje_^c;XQoD%A*?Ju$pwQZn~bp81x}7^*EV3$5zwoFM3^&Tql)VU;xd z=k86s(o(%1?apjPI9*k=L#!5_F4~AA1>0rDz-IJ-QD#`@kV|A;pr@zp*N)WdeX6n? zMb$$0RdKY%k2`E|00qg}@^3riWRe96RD_db>-p?~b!YYpSp+QYD}^elXj4XZp=|iX z+aPV#b^Cuq>C>7AXkLkRDe+DK_#-e ze9*Ii3)${tNbnN+@B~Q&y)8}c%8;cs%&XDT!1f~bBsw~(j!%`M)?G3+upTN{zBGEt{`OT* zzdF@oB5%}&oQ|3;hVP_(_c{*J$&Yl0H696vjF2Ra{htW>vAAowuEv^O+b+%aX%;?gjv4q2aY`7a?Z|WNFs8Fbz|+>H=3)Z;7Pnm?$sldK;jaggp{XG0?7NlvqJv z#@Dou8K)@$*Ze4)Tv|n8@I|I!!=ww+44c(SVG0?V9XK5D%4<7q3ILixa3N-`ADj{vm;vAJ51C4r8iq7LAX<0jn$4bb$Cx@8GS|f$Z zp|+VwtMT@%i)PH{DT6z_rGhsw$rDf85_YK|Cdro(Hs z8Q)FJZO4wlFjiUG%&`ZvW&LbPwgS|Hya^M`nrpdkn*;v5Hfp*kQET}(l?BZ4(7dk`R0|7|sQv#z=FjbRgU>c^^_gYEPE@pWS*6H~5G!KiQ>g>_(bvP@H7*)EsnO?K!P5 zs0}6qX9~wrp$Od-3Vk;M-5ie){+X~Oe#WSra%7sMqO9Qyu#?`#3rEnIS-}qHRY#Mj zQ4MgnYzm%0Q_U~iJ=b>UU#h%|Mc#9qPty9O63OBdsyER~1E>O8yLDjv^WfbGCY)i` zBfKa(@z;W34d_F0Sh{x(6gX+&fjpdx3)8C(kp4{hegp>woONN~vI0XDefLQ^xrJo$ z#;8=bo-L%=TeXgm+6u2V@Lx|iUF7Sku4eF!Gb^M&I<#auEmO#K#fd_|RGn5dl-C0m zKnr$`X9Z5q`nLuWBEjMq+*As8$YM0HWp=KyGGOm9F?s_gtt(Zzd$IJheL2ZW1r`%} zpjd|#{jFOTzv|8jR}>L;e)!A6k~jbw(k9I@vG-bq*o~w!D$c5d#>Tuqx*w6C34Kp5 z)+Yzfah!oBOk$zWgaajk6#oIBf@7NRyjA-Zw5-#6 zuFM*X5v(570{)k(^R0Z*mvfT8kA(*S(Z|456RROag|-Jjy7&2b-)#=%boQH`7fWnE z9+(AD7-m=9&(^G_ndgrC8pdADp!Kq4EwV{qu|RtI$x}J+IkNkOhAv^%1kMR-chN{-T;bLBIp97^pHkAO zB5DR|vlNc1qq^;ciIi9?a#UJdP=&U_ zXsb;AF2&QYYRJTH95x!@(pcTviyj^dF0)7KfIRnsH!}O80w|PbOoqU^raUmh+k#i@=02px5*LJIG(_N$_xw!5 zloU00Hhxhr6E*Miz8ap?Zf&^WGQ<R#F{phzMi)uv%LCRL?HBG_yoLzlVRES3zq<}{ychr=pfLD}UiSm8g*bC7C` z2g|IXsAB%-?Y0@++#ZOR+(LJfA}&g>Sb zzrG4bp)v`6gUHY$=SeT;cEg4J1_cTfuk(Y#!F*oxMG>*OAe{=RTLj=o&9>`qXg0?w z17F6JZgN&}XB@UsRMv|V(Gi2488$W?^%1>SVTMmy(kEe5+UmhR5FT=d;IJ0nBo^KP z?=*TF5#UiTRu4oz1nK5So6^G91bi}PPlJ)c1JY|yis)}2XRat|$r6>xsx(Jp93z-CN zk&20Sx4c9=PoUSe1BXwkgjs9Q>B!C^Hgyd9$F{B8Ls@!3sW~l6K!jLNH6O4s0kQAh zIkD&?*sAruLS}jyoB2NqKpvK2YNve!q(C#Jr%xJ@5JtQUdl(ncd2KBROn@NT+U%YX zh4l%BqaCsp#emo9>C1q13ofkB+LPe(5S>jp-Bz5?(@X+jY75vE7`}Fi!+hRdtvJcASIx+|PKH;gl`=%VU6^$(ob zi+g0gfG|1Vb2chjr#^CZR4sS9<$&w=_1adnz};@ z#_(A9Bamzg$@WP=KvPBAFqN+L;R0e>!IAc*K#pHK165*fV^7yJgshStF;S7<+Pmb_ z3kFP*gQ|Y5oj;tUXbc+zV+Lvl*VqFv2m|bmA&xn4nu}rz850?p1`3Wf2R-*FLS2%i+T? z{RFfN!4BuDdN%%?hGCnq!eXrJ<_n#OFg(i@Rpx0HH5~$mwDsE0>YEDorA@UU2Zm~? z*6A9oSyL63w$87hvw$ZeaOIp8wG)+SH%Uq#7;a`z0gyWE0r;=Mz4sMDV+<&5dS!eu zc5U18k3AqDNYo zbr1-di2Kz#WYD9Z7T@hhR;eB3RhyA!BY5h6#ww90XoQbyinI&kw>H93N32E~J=}(w zuPUT)45)rH)4YwSqfFJdih`avsPhOz!**w*D`l;Bz7dL%B4e6ZfaAv=oA>!b8^EEn zSV}jFe?*To@nx6WeZWY zse7?Sj-3X&ZX2ZgnhWceyt_)BD-giGm#JqQ!0u9(*+o3X6uG%ORfOX9n z3kvvv^$mSPuQCIY0B2<=KKjz7vxP(LRM{?PGdRSejFwlTG~}``)ReU0eFi13tD*&9 zpnkvuVK*oY*{{+-dF%11q8pzo1IZ67MZlIWkSQ09t5{pmxP^N)*l~@8F>RnhUqc z((;Q518+)NUV+s!uy<^oAdUwK^D&-YOYinT8{DONl%g-Qw|NXXNjdE<)5KXrHrW3G zL6S3HJ41BfP(j$-ETv2%j;_)l{Eq^lcs3ztTMpuU%k3Cs4ooB6(yU|6-5PB?GfWgD zq}()+R@+|{r9S}j5SXd`5L1zl^TKWN0V~P&GHcv6*KSWou#Amx#eKqYQ8G`;l zv^LWsaMsl}(BQ&3bxOen+}i5JfY;O8u*&e*o}^jdWG_(+fwr({#~q<-j$Odf{COJ= z;d+gLX25QNCXBUZ)l91iTT&zS*wvq=X%;Q+AgCQLA?n!Ir;M{sI%R8Z1?t)MIi~Sc z9D3`anvYp~N|TUv3$Nzpd$OF;Wz@W(kSDS~m~f>kn{>tr=4pLANfX4>?Ma6pc zCLhr#XC%K4kG0UHy%ERWog|LF;8-*90)?99sTR@)LF`4>nz@8iJOS_QH71*f+jbE{ zgVsQ`*uUus=J62oaa*G z@q##$*u2sfq^^c!52REoOO#K_GogVc_6Ors6+jGYEoo>Ca=DSO}?=8k(Zf? zdR{d&ZLg570lsDIC-te|ETjW@Hr|0G1u2xIna-QVvoZ*jLeeH!F0JC&o_F-+&c#$f zH55?W^hk3@ZqG9E_X|&&^+dq^1@8Qh3dicbUd{ZTBbEZ=x#P+^ z3~6`S#@!>&&I@14eP6K$gr*v=%|^}P^ETdUEbvM%UB_P_xk&jb;$B$VdmSr!+qjSa z*Euv7As&GYo1T6%$06ss81kNtB}1XI&YHqDpC<{M4VG_*DG4?iyJm-807^QT@NSP* zIjdR~oPH!`jNqnZ#}Z)ihh;WjBzCDokf4AmtkdXPt$yf>t^kBkVaM^0=2`I)*0{@_ zk8dR<&u^5t$BoIp0a^}P61H4}{Q9;~ah1*{$9yfHH)(!-^I?WvUT@RaJ8d z2vmx2@cAQ*g;1*)5^u+rbd6jktFew=XR=`l>3+=L?9>W5%=kO-2YeP-9RyxwYSKf^ zGlR@ldo2OTm-W`|Ko5j$dI+FQjS4?_trtT1TNI zX*h5tKTId`2fI3Z$xU9yxIzI-5JM1t_n4sbTPL-&ZdSVR+QuN5YagMtY8nC@L;87 zd1khirxVh#FXxy7Px5|*L!##^x|+z|aO&>b(8%Gs1=pCmlIO>YytU?y!S!XFT3x~- zO|}h(nH2;ibDOS)6rv=OFQZWCn=4Rrr{!6=PY|rWF|3ZB5T!m8wPH-?f@scjx%742 zZSJY_(t=PKWM6|ZbuL3oXh}l&s%AXep}*QTt$vCX42PQSb_g)9%~B{BU}jj1$-Qi+ zZV7lxcYiu8bH*ZfhM#lQc8(s@op*q{q$&G9sD?Iz7LM=!wBvkz^69!AjmfNQplf+? zXRG@wyuC*|=|6v+7+qQ{kCM2lO~VByoSv^4iCTq6kTS^!NDGMxtd)yjumPkZHd+Sa zs=87P`TLHpSe|^#TL7AIK$WATk^RfmQb z#1a!Eokcuo`KfNF!&gX}alh!848^tcXpDz)C2R~gTkY-{X9=U=Rr>2pDDOk_N*aT% z^#oocp4IKmEja#EgIS#`WYbfEW(TybykDzE8;A1ED@p0o7>BM+w8-y;vr49aTP9P( z>j|i-S;*8Om_?L%)?=K)+!c?6l0}G;s4lhZq3F9C?!$W|F-@jDD_*lGAs=;@ZeF>? zrfWdkj1oRCbj~)T{1#EgzGc6{T^ZCVxVF+cw#85%D@@uxRKv))a&)j`Qt*}nstn$} zusb$a|Abh@rQA|fdyrz$x}I64AxPl1E~d6xjKa9zRjqyB!j@^M%w<#~gRJp+(~UE? z=cj}MlYkbJLY}Hlmf^|9*YiQy7jlq+9f83#%#>!<-w~r7_SP~s{2sg+$2091{p1vM zK+#pvl?=}{A029K{!7BXVmpo*M$z+e05=>LMuu5GueOovM~nFwO(P0|u_7&zVI2!{Wk8hA$hOH= zf1bA+{pKcS%sD6%nAw7O(mKzq5zU2ND2z%e>`&oPrB=5fn3c`IQ#T_IrhuXMzZoAX zT8X^go{119n)<9ok8TX0HFjv#7ZpGpHwrTc(Ah>*nGXp&s-P!Bt`&h^gdI;=Zz)Ix z@*KA)NwMAHaGRqq!c{MuD!9V+mAAny;cdr#C`hC+Hhs{nM@h>t)5d~8AdgtIJ(gEx zm_Ep<5+A6bm7v)2IfggUFL46mniyWa(w(99Cq+9@*8iSAzf91Nm|};aV#6PrXq1Gu zwc{P-B5-}(Z~Z_uxKkZaRjJm!xV4h94)HYX)aMixc#y%~H+uTcEx_+Q)S}3}6Q>^E zjnWS!G`l$P%~%4TR1JCqsRqF|9uCnIA(&?zs*R+|h!xGU4zGt#pF&=WP)cEPXnTOK zP^yR}cTu{~$~1{xY~4gMT>_6dVuZz^_#^~YafR%RxSKl08%-6lv01Wk_)^**#}qyJ zjQelo#7}6H3bpxI9nr&+q6+ZAr8~;ZW%`djV#eThnpg4zp*(L)DjtakfZ_w3JQy7H zOiR0LQ^1XBoFHl)=yHi)WM zK^35z->2O-4vIWPhz)x3E3mHhNZ$i6TARS~C-_a}fc)t6iic)el7e}rvaKvFR^n+L zf$753_*1PD;*jA~egHA4r^6Ys4*62?M9nG z%kMWB1Z?x>H8Cm$EI{gQro?uFvfwCz>u->VgBzQayl|i}_CYF;mzGecwIWJ33JUzC zq_GvhUGw9=ZUJX8;U{SmJz~1=E1&5hgi0GGE+nvh zGDxP}c3U6dKP7XRzx~zq9w0$(obW>Pp|k5uEf}_djlKzv;a1<`1*8w3bRX-d3o3RI zdpcx^FemDMa%y7#pC~aHj6eB>9-@;&Isa7(Ar(A+ewgM;38%5BWNV1kC_wgZEKcde zIF>W$+Lt68LfWbTx`zNT^X9*$p>Id!fnG~d@lOc4lmkf^gFYFBo)72cN|Jd&yO@8o zRCT`ZA1MR^(5a*c5a?5H`o%BeDO?x$Yw$_&UU+3@u?{c<{#OcdWn3+P+MLc?wK|)vFm1scT@=CmVkLY-9cVs7 zs2peA2*yVCR5i@0^N+r0-xOwaPNRl;gw7SJPA9!oXs4q zlONxD|Bxs+!aYKlejs<2!plSA-;cfVF$z2!@Z<5LOWjI2123O0e|+-t1u>agMLJqY z1?5en?^+y;#BOi_cvPAr22}9fKh}4D{Qiu|3buXanqEaU(Iu-_qbA!faL`LTr4ksBz=deXH6 zAQ%(YB6@t61)lu_6iy`Bs1a05iXv|xOIDy46kD$MiFQ0HemttId{9gIDj~c zJHi~tb_aInHw!f!^NTvEHLa|;(*_uTgR*BBHq z{VD&xUG{PCBeR|UhLD%wvH#*=WP~I;RMh_X5wqJ@b?`mwE_aFF_M90ZbvGOc>0b9e z+{bz2TLfogIr1yJM`X#3zy%1N-$?%4?*PCz8F)i<{_^d$r*6*ZqYqYVMm~_Y^3|rG zHcsI0YMhE@8jpU$t2z%w%kp@~KBhXh)J1)LN$SRr!!mqT`RmmbCk5QIfj?2hEmMALM6OXPL0)cOLJ1 za6h5rPj7hW!Iwl9oBw0*f#DFnY!Y}t6^QPsOjV@+I;!Mo#v=k^nEv~)s@PcZ6FZ-+ z^24Q)-IKdd`mHUEt}I=>I6Kw)+=*1{a>pyYtrsnP#5mrm(^?7WYk4Hc#fLfh45(-P z;VGu-;PeqDDeQx%^Hgo}a`d;q9qhF3!Il zGyf$o-L=Q}@-$^fK8B)UfT%Rt2^rvX9&&aJviVTK-h65AdL}OqS|?yM03)9}7R>+D zw<5g9WaF`Z`DuOtC29{_cjVqo88RhaM;EYF)V+(X3$yw?zL`)-dvn$4Sx~miD#Mm> zJl)m|hO+VAFv zRYSVYZCo)uK}VC&X&Lh+nqLW_qWlsAkk4tQtJc)lYf_NEl8hp^H9Im$PAcMnhtGNQ zV*IME`7YxvScz`ISfIC)^c+;xiS!p8){q6t2gWw@RTJ>1yY7(YkY3W^ zKpgqS&wZKG2!t!Tr{0Qh32WQJqB3}SN-YebAAgV z42Z#M-91IrLz=V&dw$E!l^#uj_)d72jdkjt_$pjDO=;ulBv(C!uef2AQ<_YxJebxq z)c8?;VG31}VhVb1TYK}nEq$_fk1wqd?*cEzA3JE8({K~r9Onhj5R2#p?ws*~H$K4M zu^Zv>ylxlG15)dl1JGv@9Q*qp= z&mHqY{~ii-OEu9N9W++Q!$47xSg}smMf~QZUzHuhIE0-bDe|##{4sPFt6- zNd`sD@C`qACFg1%r(r$vpL}X4^7b~Q$*a_KFkDvQtmo@1*S-F1MWfk_(_o$gfXjm7W_~vcgxg_aY5Jen9_!s>a$Jvq94G z%qo!In=S+Lx7In`ZH@J3c9%dUvX}n>d|OdwWbY=8QhUvHC)F*sV9wdK7aV_i#ppPo z*>(B7MP9oe=o0h0k~E$+{z_*y5-1+f^A#%Ye(t9kw_VSIjJ)cc{EuitD)1-v;8cUh zDcmeiI2NP(V(6Q;%YjiGaz3i7Jr_$fmgd^j7~fU|LNcjxr^_Lv0usfc7!^OYSWQ#> zwj4S7sB$ndPI{7XKZOCj3iNYwQK1|4X=GZ4_MQgzR_QG159O_#xzU+P;5bZ z*hW3>yD0%^+S%5od!NJkE@@Co(4&z&{I95)5h{XKrX;vN-uN&z)5VLl4?L0RSO4Sw zo+@<8uys_FYAwj8e61f&ccG>EZ`uAPG?kXAQ5|Oh(9Cs*MOdTm-o;B8E(((^yJ1#( zb{wHlP=wmr3l#+M%3&x@X8prB1F+QjU`ndN#pzYTn{ENb?un_&LbGhW^eBtv>!;{~LwTN%uVM6+TC~S=1a%h_Mw1_}R7H}Z30@ciU;HHsRp_7^0Mz5>d6~HX^d9^i z(|{#!I`Q`QROoT1mhpB+Dn)d*I^H?Y7KFyXM6LQv88c=nvqe~&3JeY>-LhMevf@ci=&lsj>9gi_TwO_V2d1S*f5Sre#9;<56Se$apQ`a2`T)w|Xq(3W_}1CkL4 z;%&BVUo8~}+C6!d0?t?&x{znBF$U&;Hr~!ae+2Dx$^hR1#g?y*(*(_^p!2kkAe>tF z_i=mP#;t#qFdiaNha?jz!riB<){o)Ys7YMjfamel=csE)q(4Db4V zf}`ajADvFF#1zFn7qyOxi|Afyi2!R2<3?0U%( zM<{=1s~{h6)#hlY+CK{KK4Rei;0yeyl)hU-HIib_StxU*HbEz7mE3cDLzAWE#eA2@nllm&C6mT`yfm1 zzZ9&f4ULsxUu5I=8PexROI>0P{s-uK=ZsQ%GT1M1->K=C=L>DE&K<@9bwo;4%kxCu zj7xvQd7F&|z9`SHM!nQnuxni0Y3f+KkbD4*Ij{;u#nUm{(){j04?VPG);bLe>lri< zG?W{}_nk8zP@h90lE87&j$84pe!$Of80|euzYyP#6g>ckh2_mo#zhCj$`co{5u}1` zTGV(2KCXAV>g@}22K)Oy|J!`d&WEDX{#VqXeI2oyn-p1!hOLsSCLO`@?dHFq$XF{` z*cB2iiLSe%S!7(-t5}&fed}E?G_?ZnRjWhXD$aP9kge*;>rOwg0qrb4O8PSE4ff!z zv^slgEY*|v+_oVJ@7_+@d!?}sv0WvnjPnK^@+|!=WCB#%h7%^=5;Sqf`dUPEJRb#I3q?d& z>lsKgvQ?72k73Hv(Nk2C!zn!dz_g4UXhC_J^*Taz6m0KY3be{sGi|*LSyo=sSnRTW zl$mnfsv5tJfHMtL^+uNBJM2sX6JVl%iRAC+NmIst{O)i@2=Z<;HQtV{J+m+19t1 zl>`BOIN3t=L=YgdJZ|do9b=XMClN=q$0M5I#K)89yV>k2iqI4sx9VVtm~x z`RujXu^1i6amSG+JsTz%;jREnB4dJ$S*D-4UcURFilLW7^n2R%Y z7LGM=RaO&S?7+v{ela$BQ%yQ2w<#%!o=1kMJ*ic;^IA&ePC`{Ua%AQiz`4n6t+UV_ zT^!9Vm0h09SNe;u>htV~;Z(8Ho=OF2jv`n$SiW#|LLU0gvx0WMI`;HVai zqjDYqoldB{(A1?NUd?n$xbX+paQ6^Q9$$oIpFj}2mPNPgKe1k%Yf?GARGAVg({v-gt?|yR12{#O#Yq6o{#V7 z{#A4{)#|xW%~#ETjw(rig06y~p5635*m0+f(QT|~Vfw1s{OGh@V`$6yAKk0ZEvdaf znuyLqR&`gwm~w3l%JjQ1j5WjRmmSYuRj^%hpc`Hdco2+qJ3mW3BBf6;C=T1Vom*wK z)OpJxSD`|3yM})OY{v_!=2>CP*({6u5eMo{1BFmZYk22ItXMV~uJ;bY!c*htk?&Qx7f_Pei#0PJd{Y0`VIk*wYVb5u(h z>}25CvPb8>bCl`4QaWx!?L^_E;&plOe0~?1)k3cG$8Da}6z%290#I!BUWc_*ltb+< zyOwkqHs(ys5kH~8V%YBrQyU`h<8r`yh6vvUj?HIxAgzB?vpNpJ6}*HN@>H_b)}!LE zH0hxuBKEA$*0$G={H>o+K=n1HR{wjNjybOXN+GM~9$bf$?eJK1bJ)(l9^B}FM@SEW zNubjLK3z7^&way@3-1uP3Wrt=MxiiO_enOHWNOwaw>JJ(mK6D#55Tnh#vxUK>l!Ol zPrEkT2FIEsII&3u-^hxQj84;8LphYLY>RE@Xg==@QiwlebnI(U+z&rw5j=(Mbt?%= z)xfv zOH^o7CwS_h_3A2USYI9!4U0=l&#WHT!;;CL>U1{h&MalHZ?T3GuvRIjRN={p^-+07 zr_VR;qyO`_{Bo49#L9TRZRhu$!K+tGLLfeRv ztt&(AP8cUggObL@0BE=7aHHoTl4I<+QnFibdwMCWh)Bc>7nCk+gfd-2lZ%qLO_Gb! zYtVuKmD`ZQ<(doZF|RPW3I?j=Bqc31?2`wI1z>~TqT}f5fOx#X0o?*q1kd;82%MIS zf4$un1EC&4Ow-McYgE*$9}Y2TozNNXeW@< zTWz|{#tk)sjq&Y4qtjq~|M6>_o$fm%Fuh(Iq@3s%*XMzdti6iww*G7364#Gd&J~o_ z1tWlR8sH9i^O+tWAEfa}U8m<+*lmq1oR5D9eQj*93Q*YBDDxouPxI%TRgRd2{e$E- zuNN*LtaTwUHrD{!HFU#HGNy5nZgwB&CbjaEDI2{C(qi-KNsLm8dm-+UnskT`(h*L5 z{fn{rA4zo0{4>Lpp^tJEjKEFhL=*aPNOSg>oJexH1o$C6V{)V$B6{Q-gKR{x#`5`e zj4+9Vl^tp-lkFgSU*?0P_x*EhT4ki}vS|srb*I2`Z>R27@$O6QM!Gx!_P*A&+0$Un zwjMzEpCFRJvQq)2sX!n)VGPiV=0e~F2G-l+#vwB>?PrlfT}17X4&n>D*)#@p=94?| z{B}S?=dF!*i8*1^x~X%rl!$8Tj<;ndGIKE;GpkaN8Fx_(#%eM+r7>Rou_1DtS<|d^ zPNV6Vajq~mIL%~Qe!DK{m-^m9^*XgJu`B8f9gvRPdZpJ&9*uTc-toZO^sflnwR-XE z3nBj`3PFoi@)1}sjS%oy@DaKOH`(Wt%c6^2ti2SliWvQOOnA9B;k}*PsuP`d$k

  • EdpZp&0h~6u$z_8Lrm_{1q@m7OyVGq4;-B> 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

    f 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

    JVdSs>fWNB<$!DqT1aF>f7mm{K^Pn-%h+B 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

  • *=dcZh!(PnxC2#S*%&^@Wx1=zha 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⪼|8s7|?a5CpZEAq0 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�mcjGQq4j{P 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 CPython differences +onWin32 = False # assume the worst +if api.onIronPython: + from clr import Reference + from System import ( + Activator, + Array, + Byte, + DateTime, + DBNull, + Decimal as SystemDecimal, + Type, + ) + + def Dispatch(dispatch): + type = Type.GetTypeFromProgID(dispatch) + return Activator.CreateInstance(type) + + def getIndexedValue(obj, index): + return obj.Item[index] + +else: # try pywin32 + try: + import pythoncom + import pywintypes + import win32com.client + + onWin32 = True + + def Dispatch(dispatch): + return win32com.client.Dispatch(dispatch) + + except ImportError: + import warnings + + warnings.warn( + "pywin32 package (or IronPython) required for adodbapi.", ImportWarning + ) + + def getIndexedValue(obj, index): + return obj(index) + + +from collections.abc import Mapping + +# --- define objects to smooth out Python3000 <-> Python 2.x differences +unicodeType = str +longType = int +StringTypes = str +maxint = sys.maxsize + + +# ----------------- The .connect method ----------------- +def make_COM_connecter(): + try: + if onWin32: + pythoncom.CoInitialize() # v2.1 Paj + c = Dispatch("ADODB.Connection") # connect _after_ CoIninialize v2.1.1 adamvan + except: + raise api.InterfaceError( + "Windows COM Error: Dispatch('ADODB.Connection') failed." + ) + return c + + +def connect(*args, **kwargs): # --> a db-api connection object + """Connect to a database. + + call using: + :connection_string -- An ADODB formatted connection string, see: + * http://www.connectionstrings.com + * http://www.asp101.com/articles/john/connstring/default.asp + :timeout -- A command timeout value, in seconds (default 30 seconds) + """ + co = Connection() # make an empty connection object + + kwargs = process_connect_string.process(args, kwargs, True) + + try: # connect to the database, using the connection information in kwargs + co.connect(kwargs) + return co + except Exception as e: + message = 'Error opening connection to "%s"' % co.connection_string + raise api.OperationalError(e, message) + + +# so you could use something like: +# myConnection.paramstyle = 'named' +# The programmer may also change the default. +# For example, if I were using django, I would say: +# import adodbapi as Database +# Database.adodbapi.paramstyle = 'format' + +# ------- other module level defaults -------- +defaultIsolationLevel = adc.adXactReadCommitted +# Set defaultIsolationLevel on module level before creating the connection. +# For example: +# import adodbapi, ado_consts +# adodbapi.adodbapi.defaultIsolationLevel=ado_consts.adXactBrowse" +# +# Set defaultCursorLocation on module level before creating the connection. +# It may be one of the "adUse..." consts. +defaultCursorLocation = adc.adUseClient # changed from adUseServer as of v 2.3.0 + +dateconverter = api.pythonDateTimeConverter() # default + + +def format_parameters(ADOparameters, show_value=False): + """Format a collection of ADO Command Parameters. + + Used by error reporting in _execute_command. + """ + try: + if show_value: + desc = [ + 'Name: %s, Dir.: %s, Type: %s, Size: %s, Value: "%s", Precision: %s, NumericScale: %s' + % ( + p.Name, + adc.directions[p.Direction], + adc.adTypeNames.get(p.Type, str(p.Type) + " (unknown type)"), + p.Size, + p.Value, + p.Precision, + p.NumericScale, + ) + for p in ADOparameters + ] + else: + desc = [ + "Name: %s, Dir.: %s, Type: %s, Size: %s, Precision: %s, NumericScale: %s" + % ( + p.Name, + adc.directions[p.Direction], + adc.adTypeNames.get(p.Type, str(p.Type) + " (unknown type)"), + p.Size, + p.Precision, + p.NumericScale, + ) + for p in ADOparameters + ] + return "[" + "\n".join(desc) + "]" + except: + return "[]" + + +def _configure_parameter(p, value, adotype, settings_known): + """Configure the given ADO Parameter 'p' with the Python 'value'.""" + + if adotype in api.adoBinaryTypes: + p.Size = len(value) + p.AppendChunk(value) + + elif isinstance(value, StringTypes): # v2.1 Jevon + L = len(value) + if adotype in api.adoStringTypes: # v2.2.1 Cole + if settings_known: + L = min(L, p.Size) # v2.1 Cole limit data to defined size + p.Value = value[:L] # v2.1 Jevon & v2.1 Cole + else: + p.Value = value # dont limit if db column is numeric + if L > 0: # v2.1 Cole something does not like p.Size as Zero + p.Size = L # v2.1 Jevon + + elif isinstance(value, decimal.Decimal): + if api.onIronPython: + s = str(value) + p.Value = s + p.Size = len(s) + else: + p.Value = value + exponent = value.as_tuple()[2] + digit_count = len(value.as_tuple()[1]) + p.Precision = digit_count + if exponent == 0: + p.NumericScale = 0 + elif exponent < 0: + p.NumericScale = -exponent + if p.Precision < p.NumericScale: + p.Precision = p.NumericScale + else: # exponent > 0: + p.NumericScale = 0 + p.Precision = digit_count + exponent + + elif type(value) in dateconverter.types: + if settings_known and adotype in api.adoDateTimeTypes: + p.Value = dateconverter.COMDate(value) + else: # probably a string + # provide the date as a string in the format 'YYYY-MM-dd' + s = dateconverter.DateObjectToIsoFormatString(value) + p.Value = s + p.Size = len(s) + + elif api.onIronPython and isinstance(value, longType): # Iron Python Long + s = str(value) # feature workaround for IPy 2.0 + p.Value = s + + elif adotype == adc.adEmpty: # ADO will not let you specify a null column + p.Type = ( + adc.adInteger + ) # so we will fake it to be an integer (just to have something) + p.Value = None # and pass in a Null *value* + + # For any other type, set the value and let pythoncom do the right thing. + else: + p.Value = value + + +# # # # # ----- the Class that defines a connection ----- # # # # # +class Connection(object): + # include connection attributes as class attributes required by api definition. + Warning = api.Warning + Error = api.Error + InterfaceError = api.InterfaceError + DataError = api.DataError + DatabaseError = api.DatabaseError + OperationalError = api.OperationalError + IntegrityError = api.IntegrityError + InternalError = api.InternalError + NotSupportedError = api.NotSupportedError + ProgrammingError = api.ProgrammingError + FetchFailedError = api.FetchFailedError # (special for django) + # ...class attributes... (can be overridden by instance attributes) + verbose = api.verbose + + @property + def dbapi(self): # a proposed db-api version 3 extension. + "Return a reference to the DBAPI module for this Connection." + return api + + def __init__(self): # now define the instance attributes + self.connector = None + self.paramstyle = api.paramstyle + self.supportsTransactions = False + self.connection_string = "" + self.cursors = weakref.WeakValueDictionary() + self.dbms_name = "" + self.dbms_version = "" + self.errorhandler = None # use the standard error handler for this instance + self.transaction_level = 0 # 0 == Not in a transaction, at the top level + self._autocommit = False + + def connect(self, kwargs, connection_maker=make_COM_connecter): + if verbose > 9: + print("kwargs=", repr(kwargs)) + try: + self.connection_string = ( + kwargs["connection_string"] % kwargs + ) # insert keyword arguments + except Exception as e: + self._raiseConnectionError( + KeyError, "Python string format error in connection string->" + ) + self.timeout = kwargs.get("timeout", 30) + self.mode = kwargs.get("mode", adc.adModeUnknown) + self.kwargs = kwargs + if verbose: + print('%s attempting: "%s"' % (version, self.connection_string)) + self.connector = connection_maker() + self.connector.ConnectionTimeout = self.timeout + self.connector.ConnectionString = self.connection_string + self.connector.Mode = self.mode + + try: + self.connector.Open() # Open the ADO connection + except api.Error: + self._raiseConnectionError( + api.DatabaseError, + "ADO error trying to Open=%s" % self.connection_string, + ) + + try: # Stefan Fuchs; support WINCCOLEDBProvider + if getIndexedValue(self.connector.Properties, "Transaction DDL").Value != 0: + self.supportsTransactions = True + except pywintypes.com_error: + pass # Stefan Fuchs + self.dbms_name = getIndexedValue(self.connector.Properties, "DBMS Name").Value + try: # Stefan Fuchs + self.dbms_version = getIndexedValue( + self.connector.Properties, "DBMS Version" + ).Value + except pywintypes.com_error: + pass # Stefan Fuchs + self.connector.CursorLocation = defaultCursorLocation # v2.1 Rose + if self.supportsTransactions: + self.connector.IsolationLevel = defaultIsolationLevel + self._autocommit = bool(kwargs.get("autocommit", False)) + if not self._autocommit: + self.transaction_level = ( + self.connector.BeginTrans() + ) # Disables autocommit & inits transaction_level + else: + self._autocommit = True + if "paramstyle" in kwargs: + self.paramstyle = kwargs["paramstyle"] # let setattr do the error checking + self.messages = [] + if verbose: + print("adodbapi New connection at %X" % id(self)) + + def _raiseConnectionError(self, errorclass, errorvalue): + eh = self.errorhandler + if eh is None: + eh = api.standardErrorHandler + eh(self, None, errorclass, errorvalue) + + def _closeAdoConnection(self): # all v2.1 Rose + """close the underlying ADO Connection object, + rolling it back first if it supports transactions.""" + if self.connector is None: + return + if not self._autocommit: + if self.transaction_level: + try: + self.connector.RollbackTrans() + except: + pass + self.connector.Close() + if verbose: + print("adodbapi Closed connection at %X" % id(self)) + + def close(self): + """Close the connection now (rather than whenever __del__ is called). + + The connection will be unusable from this point forward; + an Error (or subclass) exception will be raised if any operation is attempted with the connection. + The same applies to all cursor objects trying to use the connection. + """ + for crsr in list(self.cursors.values())[ + : + ]: # copy the list, then close each one + crsr.close(dont_tell_me=True) # close without back-link clearing + self.messages = [] + try: + self._closeAdoConnection() # v2.1 Rose + except Exception as e: + self._raiseConnectionError(sys.exc_info()[0], sys.exc_info()[1]) + + self.connector = None # v2.4.2.2 fix subtle timeout bug + # per M.Hammond: "I expect the benefits of uninitializing are probably fairly small, + # so never uninitializing will probably not cause any problems." + + def commit(self): + """Commit any pending transaction to the database. + + Note that if the database supports an auto-commit feature, + this must be initially off. An interface method may be provided to turn it back on. + Database modules that do not support transactions should implement this method with void functionality. + """ + self.messages = [] + if not self.supportsTransactions: + return + + try: + self.transaction_level = self.connector.CommitTrans() + if verbose > 1: + print("commit done on connection at %X" % id(self)) + if not ( + self._autocommit + or (self.connector.Attributes & adc.adXactAbortRetaining) + ): + # If attributes has adXactCommitRetaining it performs retaining commits that is, + # calling CommitTrans automatically starts a new transaction. Not all providers support this. + # If not, we will have to start a new transaction by this command: + self.transaction_level = self.connector.BeginTrans() + except Exception as e: + self._raiseConnectionError(api.ProgrammingError, e) + + def _rollback(self): + """In case a database does provide transactions this method causes the the database to roll back to + the start of any pending transaction. Closing a connection without committing the changes first will + cause an implicit rollback to be performed. + + If the database does not support the functionality required by the method, the interface should + throw an exception in case the method is used. + The preferred approach is to not implement the method and thus have Python generate + an AttributeError in case the method is requested. This allows the programmer to check for database + capabilities using the standard hasattr() function. + + For some dynamically configured interfaces it may not be appropriate to require dynamically making + the method available. These interfaces should then raise a NotSupportedError to indicate the + non-ability to perform the roll back when the method is invoked. + """ + self.messages = [] + if ( + self.transaction_level + ): # trying to roll back with no open transaction causes an error + try: + self.transaction_level = self.connector.RollbackTrans() + if verbose > 1: + print("rollback done on connection at %X" % id(self)) + if not self._autocommit and not ( + self.connector.Attributes & adc.adXactAbortRetaining + ): + # If attributes has adXactAbortRetaining it performs retaining aborts that is, + # calling RollbackTrans automatically starts a new transaction. Not all providers support this. + # If not, we will have to start a new transaction by this command: + if ( + not self.transaction_level + ): # if self.transaction_level == 0 or self.transaction_level is None: + self.transaction_level = self.connector.BeginTrans() + except Exception as e: + self._raiseConnectionError(api.ProgrammingError, e) + + def __setattr__(self, name, value): + if name == "autocommit": # extension: allow user to turn autocommit on or off + if self.supportsTransactions: + object.__setattr__(self, "_autocommit", bool(value)) + try: + self._rollback() # must clear any outstanding transactions + except: + pass + return + elif name == "paramstyle": + if value not in api.accepted_paramstyles: + self._raiseConnectionError( + api.NotSupportedError, + 'paramstyle="%s" not in:%s' + % (value, repr(api.accepted_paramstyles)), + ) + elif name == "variantConversions": + value = copy.copy( + value + ) # make a new copy -- no changes in the default, please + object.__setattr__(self, name, value) + + def __getattr__(self, item): + if ( + item == "rollback" + ): # the rollback method only appears if the database supports transactions + if self.supportsTransactions: + return ( + self._rollback + ) # return the rollback method so the caller can execute it. + else: + raise AttributeError("this data provider does not support Rollback") + elif item == "autocommit": + return self._autocommit + else: + raise AttributeError( + 'no such attribute in ADO connection object as="%s"' % item + ) + + def cursor(self): + "Return a new Cursor Object using the connection." + self.messages = [] + c = Cursor(self) + return c + + def _i_am_here(self, crsr): + "message from a new cursor proclaiming its existence" + oid = id(crsr) + self.cursors[oid] = crsr + + def _i_am_closing(self, crsr): + "message from a cursor giving connection a chance to clean up" + try: + del self.cursors[id(crsr)] + except: + pass + + def printADOerrors(self): + j = self.connector.Errors.Count + if j: + print("ADO Errors:(%i)" % j) + for e in self.connector.Errors: + print("Description: %s" % e.Description) + print("Error: %s %s " % (e.Number, adc.adoErrors.get(e.Number, "unknown"))) + if e.Number == adc.ado_error_TIMEOUT: + print( + "Timeout Error: Try using adodbpi.connect(constr,timeout=Nseconds)" + ) + print("Source: %s" % e.Source) + print("NativeError: %s" % e.NativeError) + print("SQL State: %s" % e.SQLState) + + def _suggest_error_class(self): + """Introspect the current ADO Errors and determine an appropriate error class. + + Error.SQLState is a SQL-defined error condition, per the SQL specification: + http://www.contrib.andrew.cmu.edu/~shadow/sql/sql1992.txt + + The 23000 class of errors are integrity errors. + Error 40002 is a transactional integrity error. + """ + if self.connector is not None: + for e in self.connector.Errors: + state = str(e.SQLState) + if state.startswith("23") or state == "40002": + return api.IntegrityError + return api.DatabaseError + + def __del__(self): + try: + self._closeAdoConnection() # v2.1 Rose + except: + pass + self.connector = None + + def __enter__(self): # Connections are context managers + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + if exc_type: + self._rollback() # automatic rollback on errors + else: + self.commit() + + def get_table_names(self): + schema = self.connector.OpenSchema(20) # constant = adSchemaTables + + tables = [] + while not schema.EOF: + name = getIndexedValue(schema.Fields, "TABLE_NAME").Value + tables.append(name) + schema.MoveNext() + del schema + return tables + + +# # # # # ----- the Class that defines a cursor ----- # # # # # +class Cursor(object): + ## ** api required attributes: + ## description... + ## This read-only attribute is a sequence of 7-item sequences. + ## Each of these sequences contains information describing one result column: + ## (name, type_code, display_size, internal_size, precision, scale, null_ok). + ## This attribute will be None for operations that do not return rows or if the + ## cursor has not had an operation invoked via the executeXXX() method yet. + ## The type_code can be interpreted by comparing it to the Type Objects specified in the section below. + ## rowcount... + ## This read-only attribute specifies the number of rows that the last executeXXX() produced + ## (for DQL statements like select) or affected (for DML statements like update or insert). + ## The attribute is -1 in case no executeXXX() has been performed on the cursor or + ## the rowcount of the last operation is not determinable by the interface.[7] + ## arraysize... + ## This read/write attribute specifies the number of rows to fetch at a time with fetchmany(). + ## It defaults to 1 meaning to fetch a single row at a time. + ## Implementations must observe this value with respect to the fetchmany() method, + ## but are free to interact with the database a single row at a time. + ## It may also be used in the implementation of executemany(). + ## ** extension attributes: + ## paramstyle... + ## allows the programmer to override the connection's default paramstyle + ## errorhandler... + ## allows the programmer to override the connection's default error handler + + def __init__(self, connection): + self.command = None + self._ado_prepared = False + self.messages = [] + self.connection = connection + self.paramstyle = connection.paramstyle # used for overriding the paramstyle + self._parameter_names = [] + self.recordset_is_remote = False + self.rs = None # the ADO recordset for this cursor + self.converters = [] # conversion function for each column + self.columnNames = {} # names of columns {lowercase name : number,...} + self.numberOfColumns = 0 + self._description = None + self.rowcount = -1 + self.errorhandler = connection.errorhandler + self.arraysize = 1 + connection._i_am_here(self) + if verbose: + print( + "%s New cursor at %X on conn %X" + % (version, id(self), id(self.connection)) + ) + + def __iter__(self): # [2.1 Zamarev] + return iter(self.fetchone, None) # [2.1 Zamarev] + + def prepare(self, operation): + self.command = operation + self._description = None + self._ado_prepared = "setup" + + def __next__(self): + r = self.fetchone() + if r: + return r + raise StopIteration + + def __enter__(self): + "Allow database cursors to be used with context managers." + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + "Allow database cursors to be used with context managers." + self.close() + + def _raiseCursorError(self, errorclass, errorvalue): + eh = self.errorhandler + if eh is None: + eh = api.standardErrorHandler + eh(self.connection, self, errorclass, errorvalue) + + def build_column_info(self, recordset): + self.converters = [] # convertion function for each column + self.columnNames = {} # names of columns {lowercase name : number,...} + self._description = None + + # if EOF and BOF are true at the same time, there are no records in the recordset + if (recordset is None) or (recordset.State == adc.adStateClosed): + self.rs = None + self.numberOfColumns = 0 + return + self.rs = recordset # v2.1.1 bkline + self.recordset_format = api.RS_ARRAY if api.onIronPython else api.RS_WIN_32 + self.numberOfColumns = recordset.Fields.Count + try: + varCon = self.connection.variantConversions + except AttributeError: + varCon = api.variantConversions + for i in range(self.numberOfColumns): + f = getIndexedValue(self.rs.Fields, i) + try: + self.converters.append( + varCon[f.Type] + ) # conversion function for this column + except KeyError: + self._raiseCursorError( + api.InternalError, "Data column of Unknown ADO type=%s" % f.Type + ) + self.columnNames[f.Name.lower()] = i # columnNames lookup + + def _makeDescriptionFromRS(self): + # Abort if closed or no recordset. + if self.rs is None: + self._description = None + return + desc = [] + for i in range(self.numberOfColumns): + f = getIndexedValue(self.rs.Fields, i) + if self.rs.EOF or self.rs.BOF: + display_size = None + else: + display_size = ( + f.ActualSize + ) # TODO: Is this the correct defintion according to the DB API 2 Spec ? + null_ok = bool(f.Attributes & adc.adFldMayBeNull) # v2.1 Cole + desc.append( + ( + f.Name, + f.Type, + display_size, + f.DefinedSize, + f.Precision, + f.NumericScale, + null_ok, + ) + ) + self._description = desc + + def get_description(self): + if not self._description: + self._makeDescriptionFromRS() + return self._description + + def __getattr__(self, item): + if item == "description": + return self.get_description() + object.__getattribute__( + self, item + ) # may get here on Remote attribute calls for existing attributes + + def format_description(self, d): + """Format db_api description tuple for printing.""" + if self.description is None: + self._makeDescriptionFromRS() + if isinstance(d, int): + d = self.description[d] + desc = ( + "Name= %s, Type= %s, DispSize= %s, IntSize= %s, Precision= %s, Scale= %s NullOK=%s" + % ( + d[0], + adc.adTypeNames.get(d[1], str(d[1]) + " (unknown type)"), + d[2], + d[3], + d[4], + d[5], + d[6], + ) + ) + return desc + + def close(self, dont_tell_me=False): + """Close the cursor now (rather than whenever __del__ is called). + The cursor will be unusable from this point forward; an Error (or subclass) + exception will be raised if any operation is attempted with the cursor. + """ + if self.connection is None: + return + self.messages = [] + if ( + self.rs and self.rs.State != adc.adStateClosed + ): # rs exists and is open #v2.1 Rose + self.rs.Close() # v2.1 Rose + self.rs = None # let go of the recordset so ADO will let it be disposed #v2.1 Rose + if not dont_tell_me: + self.connection._i_am_closing( + self + ) # take me off the connection's cursors list + self.connection = ( + None # this will make all future method calls on me throw an exception + ) + if verbose: + print("adodbapi Closed cursor at %X" % id(self)) + + def __del__(self): + try: + self.close() + except: + pass + + def _new_command(self, command_type=adc.adCmdText): + self.cmd = None + self.messages = [] + + if self.connection is None: + self._raiseCursorError(api.InterfaceError, None) + return + try: + self.cmd = Dispatch("ADODB.Command") + self.cmd.ActiveConnection = self.connection.connector + self.cmd.CommandTimeout = self.connection.timeout + self.cmd.CommandType = command_type + self.cmd.CommandText = self.commandText + self.cmd.Prepared = bool(self._ado_prepared) + except: + self._raiseCursorError( + api.DatabaseError, + 'Error creating new ADODB.Command object for "%s"' + % repr(self.commandText), + ) + + def _execute_command(self): + # Stored procedures may have an integer return value + self.return_value = None + recordset = None + count = -1 # default value + if verbose: + print('Executing command="%s"' % self.commandText) + try: + # ----- the actual SQL is executed here --- + if api.onIronPython: + ra = Reference[int]() + recordset = self.cmd.Execute(ra) + count = ra.Value + else: # pywin32 + recordset, count = self.cmd.Execute() + # ----- ------------------------------- --- + except Exception as e: + _message = "" + if hasattr(e, "args"): + _message += str(e.args) + "\n" + _message += "Command:\n%s\nParameters:\n%s" % ( + self.commandText, + format_parameters(self.cmd.Parameters, True), + ) + klass = self.connection._suggest_error_class() + self._raiseCursorError(klass, _message) + try: + self.rowcount = recordset.RecordCount + except: + self.rowcount = count + self.build_column_info(recordset) + + # The ADO documentation hints that obtaining the recordcount may be timeconsuming + # "If the Recordset object does not support approximate positioning, this property + # may be a significant drain on resources # [ekelund] + # Therefore, COM will not return rowcount for server-side cursors. [Cole] + # Client-side cursors (the default since v2.8) will force a static + # cursor, and rowcount will then be set accurately [Cole] + + def get_rowcount(self): + return self.rowcount + + def get_returned_parameters(self): + """with some providers, returned parameters and the .return_value are not available until + after the last recordset has been read. In that case, you must coll nextset() until it + returns None, then call this method to get your returned information.""" + + retLst = ( + [] + ) # store procedures may return altered parameters, including an added "return value" item + for p in tuple(self.cmd.Parameters): + if verbose > 2: + print( + 'Returned=Name: %s, Dir.: %s, Type: %s, Size: %s, Value: "%s",' + " Precision: %s, NumericScale: %s" + % ( + p.Name, + adc.directions[p.Direction], + adc.adTypeNames.get(p.Type, str(p.Type) + " (unknown type)"), + p.Size, + p.Value, + p.Precision, + p.NumericScale, + ) + ) + pyObject = api.convert_to_python(p.Value, api.variantConversions[p.Type]) + if p.Direction == adc.adParamReturnValue: + self.returnValue = ( + pyObject # also load the undocumented attribute (Vernon's Error!) + ) + self.return_value = pyObject + else: + retLst.append(pyObject) + return retLst # return the parameter list to the caller + + def callproc(self, procname, parameters=None): + """Call a stored database procedure with the given name. + The sequence of parameters must contain one entry for each + argument that the sproc expects. The result of the + call is returned as modified copy of the input + sequence. Input parameters are left untouched, output and + input/output parameters replaced with possibly new values. + + The sproc may also provide a result set as output, + which is available through the standard .fetch*() methods. + Extension: A "return_value" property may be set on the + cursor if the sproc defines an integer return value. + """ + self._parameter_names = [] + self.commandText = procname + self._new_command(command_type=adc.adCmdStoredProc) + self._buildADOparameterList(parameters, sproc=True) + if verbose > 2: + print( + "Calling Stored Proc with Params=", + format_parameters(self.cmd.Parameters, True), + ) + self._execute_command() + return self.get_returned_parameters() + + def _reformat_operation(self, operation, parameters): + if self.paramstyle in ("format", "pyformat"): # convert %s to ? + operation, self._parameter_names = api.changeFormatToQmark(operation) + elif self.paramstyle == "named" or ( + self.paramstyle == "dynamic" and isinstance(parameters, Mapping) + ): + operation, self._parameter_names = api.changeNamedToQmark( + operation + ) # convert :name to ? + return operation + + def _buildADOparameterList(self, parameters, sproc=False): + self.parameters = parameters + if parameters is None: + parameters = [] + + # Note: ADO does not preserve the parameter list, even if "Prepared" is True, so we must build every time. + parameters_known = False + if sproc: # needed only if we are calling a stored procedure + try: # attempt to use ADO's parameter list + self.cmd.Parameters.Refresh() + if verbose > 2: + print( + "ADO detected Params=", + format_parameters(self.cmd.Parameters, True), + ) + print("Program Parameters=", repr(parameters)) + parameters_known = True + except api.Error: + if verbose: + print("ADO Parameter Refresh failed") + pass + else: + if len(parameters) != self.cmd.Parameters.Count - 1: + raise api.ProgrammingError( + "You must supply %d parameters for this stored procedure" + % (self.cmd.Parameters.Count - 1) + ) + if sproc or parameters != []: + i = 0 + if parameters_known: # use ado parameter list + if self._parameter_names: # named parameters + for i, pm_name in enumerate(self._parameter_names): + p = getIndexedValue(self.cmd.Parameters, i) + try: + _configure_parameter( + p, parameters[pm_name], p.Type, parameters_known + ) + except Exception as e: + _message = ( + "Error Converting Parameter %s: %s, %s <- %s\n" + % ( + p.Name, + adc.ado_type_name(p.Type), + p.Value, + repr(parameters[pm_name]), + ) + ) + self._raiseCursorError( + api.DataError, _message + "->" + repr(e.args) + ) + else: # regular sequence of parameters + for value in parameters: + p = getIndexedValue(self.cmd.Parameters, i) + if ( + p.Direction == adc.adParamReturnValue + ): # this is an extra parameter added by ADO + i += 1 # skip the extra + p = getIndexedValue(self.cmd.Parameters, i) + try: + _configure_parameter(p, value, p.Type, parameters_known) + except Exception as e: + _message = ( + "Error Converting Parameter %s: %s, %s <- %s\n" + % ( + p.Name, + adc.ado_type_name(p.Type), + p.Value, + repr(value), + ) + ) + self._raiseCursorError( + api.DataError, _message + "->" + repr(e.args) + ) + i += 1 + else: # -- build own parameter list + if ( + self._parameter_names + ): # we expect a dictionary of parameters, this is the list of expected names + for parm_name in self._parameter_names: + elem = parameters[parm_name] + adotype = api.pyTypeToADOType(elem) + p = self.cmd.CreateParameter( + parm_name, adotype, adc.adParamInput + ) + _configure_parameter(p, elem, adotype, parameters_known) + try: + self.cmd.Parameters.Append(p) + except Exception as e: + _message = "Error Building Parameter %s: %s, %s <- %s\n" % ( + p.Name, + adc.ado_type_name(p.Type), + p.Value, + repr(elem), + ) + self._raiseCursorError( + api.DataError, _message + "->" + repr(e.args) + ) + else: # expecting the usual sequence of parameters + if sproc: + p = self.cmd.CreateParameter( + "@RETURN_VALUE", adc.adInteger, adc.adParamReturnValue + ) + self.cmd.Parameters.Append(p) + + for elem in parameters: + name = "p%i" % i + adotype = api.pyTypeToADOType(elem) + p = self.cmd.CreateParameter( + name, adotype, adc.adParamInput + ) # Name, Type, Direction, Size, Value + _configure_parameter(p, elem, adotype, parameters_known) + try: + self.cmd.Parameters.Append(p) + except Exception as e: + _message = "Error Building Parameter %s: %s, %s <- %s\n" % ( + p.Name, + adc.ado_type_name(p.Type), + p.Value, + repr(elem), + ) + self._raiseCursorError( + api.DataError, _message + "->" + repr(e.args) + ) + i += 1 + if self._ado_prepared == "setup": + self._ado_prepared = ( + True # parameters will be "known" by ADO next loop + ) + + def execute(self, operation, parameters=None): + """Prepare and execute a database operation (query or command). + + Parameters may be provided as sequence or mapping and will be bound to variables in the operation. + Variables are specified in a database-specific notation + (see the module's paramstyle attribute for details). [5] + A reference to the operation will be retained by the cursor. + If the same operation object is passed in again, then the cursor + can optimize its behavior. This is most effective for algorithms + where the same operation is used, but different parameters are bound to it (many times). + + For maximum efficiency when reusing an operation, it is best to use + the setinputsizes() method to specify the parameter types and sizes ahead of time. + It is legal for a parameter to not match the predefined information; + the implementation should compensate, possibly with a loss of efficiency. + + The parameters may also be specified as list of tuples to e.g. insert multiple rows in + a single operation, but this kind of usage is depreciated: executemany() should be used instead. + + Return value is not defined. + + [5] The module will use the __getitem__ method of the parameters object to map either positions + (integers) or names (strings) to parameter values. This allows for both sequences and mappings + to be used as input. + The term "bound" refers to the process of binding an input value to a database execution buffer. + In practical terms, this means that the input value is directly used as a value in the operation. + The client should not be required to "escape" the value so that it can be used -- the value + should be equal to the actual database value.""" + if ( + self.command is not operation + or self._ado_prepared == "setup" + or not hasattr(self, "commandText") + ): + if self.command is not operation: + self._ado_prepared = False + self.command = operation + self._parameter_names = [] + self.commandText = ( + operation + if (self.paramstyle == "qmark" or not parameters) + else self._reformat_operation(operation, parameters) + ) + self._new_command() + self._buildADOparameterList(parameters) + if verbose > 3: + print("Params=", format_parameters(self.cmd.Parameters, True)) + self._execute_command() + + def executemany(self, operation, seq_of_parameters): + """Prepare a database operation (query or command) + and then execute it against all parameter sequences or mappings found in the sequence seq_of_parameters. + + Return values are not defined. + """ + self.messages = list() + total_recordcount = 0 + + self.prepare(operation) + for params in seq_of_parameters: + self.execute(self.command, params) + if self.rowcount == -1: + total_recordcount = -1 + if total_recordcount != -1: + total_recordcount += self.rowcount + self.rowcount = total_recordcount + + def _fetch(self, limit=None): + """Fetch rows from the current recordset. + + limit -- Number of rows to fetch, or None (default) to fetch all rows. + """ + if self.connection is None or self.rs is None: + self._raiseCursorError( + api.FetchFailedError, "fetch() on closed connection or empty query set" + ) + return + + if self.rs.State == adc.adStateClosed or self.rs.BOF or self.rs.EOF: + return list() + if limit: # limit number of rows retrieved + ado_results = self.rs.GetRows(limit) + else: # get all rows + ado_results = self.rs.GetRows() + if ( + self.recordset_format == api.RS_ARRAY + ): # result of GetRows is a two-dimension array + length = ( + len(ado_results) // self.numberOfColumns + ) # length of first dimension + else: # pywin32 + length = len(ado_results[0]) # result of GetRows is tuples in a tuple + fetchObject = api.SQLrows( + ado_results, length, self + ) # new object to hold the results of the fetch + return fetchObject + + def fetchone(self): + """Fetch the next row of a query result set, returning a single sequence, + or None when no more data is available. + + An Error (or subclass) exception is raised if the previous call to executeXXX() + did not produce any result set or no call was issued yet. + """ + self.messages = [] + result = self._fetch(1) + if result: # return record (not list of records) + return result[0] + return None + + def fetchmany(self, size=None): + """Fetch the next set of rows of a query result, returning a list of tuples. An empty sequence is returned when no more rows are available. + + The number of rows to fetch per call is specified by the parameter. + If it is not given, the cursor's arraysize determines the number of rows to be fetched. + The method should try to fetch as many rows as indicated by the size parameter. + If this is not possible due to the specified number of rows not being available, + fewer rows may be returned. + + An Error (or subclass) exception is raised if the previous call to executeXXX() + did not produce any result set or no call was issued yet. + + Note there are performance considerations involved with the size parameter. + For optimal performance, it is usually best to use the arraysize attribute. + If the size parameter is used, then it is best for it to retain the same value from + one fetchmany() call to the next. + """ + self.messages = [] + if size is None: + size = self.arraysize + return self._fetch(size) + + def fetchall(self): + """Fetch all (remaining) rows of a query result, returning them as a sequence of sequences (e.g. a list of tuples). + + Note that the cursor's arraysize attribute + can affect the performance of this operation. + An Error (or subclass) exception is raised if the previous call to executeXXX() + did not produce any result set or no call was issued yet. + """ + self.messages = [] + return self._fetch() + + def nextset(self): + """Skip to the next available recordset, discarding any remaining rows from the current recordset. + + If there are no more sets, the method returns None. Otherwise, it returns a true + value and subsequent calls to the fetch methods will return rows from the next result set. + + An Error (or subclass) exception is raised if the previous call to executeXXX() + did not produce any result set or no call was issued yet. + """ + self.messages = [] + if self.connection is None or self.rs is None: + self._raiseCursorError( + api.OperationalError, + ("nextset() on closed connection or empty query set"), + ) + return None + + if api.onIronPython: + try: + recordset = self.rs.NextRecordset() + except TypeError: + recordset = None + except api.Error as exc: + self._raiseCursorError(api.NotSupportedError, exc.args) + else: # pywin32 + try: # [begin 2.1 ekelund] + rsTuple = self.rs.NextRecordset() # + except pywintypes.com_error as exc: # return appropriate error + self._raiseCursorError( + api.NotSupportedError, exc.args + ) # [end 2.1 ekelund] + recordset = rsTuple[0] + if recordset is None: + return None + self.build_column_info(recordset) + return True + + def setinputsizes(self, sizes): + pass + + def setoutputsize(self, size, column=None): + pass + + def _last_query(self): # let the programmer see what query we actually used + try: + if self.parameters == None: + ret = self.commandText + else: + ret = "%s,parameters=%s" % (self.commandText, repr(self.parameters)) + except: + ret = None + return ret + + query = property(_last_query, None, None, "returns the last query executed") + + +if __name__ == "__main__": + raise api.ProgrammingError(version + " cannot be run as a main program.") diff --git a/lib/adodbapi/apibase.py b/lib/adodbapi/apibase.py new file mode 100644 index 00000000..a56cd4b6 --- /dev/null +++ b/lib/adodbapi/apibase.py @@ -0,0 +1,794 @@ +"""adodbapi.apibase - A python DB API 2.0 (PEP 249) interface to Microsoft ADO + +Copyright (C) 2002 Henrik Ekelund, version 2.1 by Vernon Cole +* http://sourceforge.net/projects/pywin32 +* http://sourceforge.net/projects/adodbapi +""" + +import datetime +import decimal +import numbers +import sys +import time + +# noinspection PyUnresolvedReferences +from . import ado_consts as adc + +verbose = False # debugging flag + +onIronPython = sys.platform == "cli" +if onIronPython: # we need type definitions for odd data we may need to convert + # noinspection PyUnresolvedReferences + from System import DateTime, DBNull + + NullTypes = (type(None), DBNull) +else: + DateTime = type(NotImplemented) # should never be seen on win32 + NullTypes = type(None) + +# --- define objects to smooth out Python3 <-> Python 2.x differences +unicodeType = str +longType = int +StringTypes = str +makeByteBuffer = bytes +memoryViewType = memoryview +_BaseException = Exception + +try: # jdhardy -- handle bytes under IronPython & Py3 + bytes +except NameError: + bytes = str # define it for old Pythons + + +# ------- Error handlers ------ +def standardErrorHandler(connection, cursor, errorclass, errorvalue): + err = (errorclass, errorvalue) + try: + connection.messages.append(err) + except: + pass + if cursor is not None: + try: + cursor.messages.append(err) + except: + pass + raise errorclass(errorvalue) + + +# Note: _BaseException is defined differently between Python 2.x and 3.x +class Error(_BaseException): + pass # Exception that is the base class of all other error + # exceptions. You can use this to catch all errors with one + # single 'except' statement. Warnings are not considered + # errors and thus should not use this class as base. It must + # be a subclass of the Python StandardError (defined in the + # module exceptions). + + +class Warning(_BaseException): + pass + + +class InterfaceError(Error): + pass + + +class DatabaseError(Error): + pass + + +class InternalError(DatabaseError): + pass + + +class OperationalError(DatabaseError): + pass + + +class ProgrammingError(DatabaseError): + pass + + +class IntegrityError(DatabaseError): + pass + + +class DataError(DatabaseError): + pass + + +class NotSupportedError(DatabaseError): + pass + + +class FetchFailedError(OperationalError): + """ + Error is used by RawStoredProcedureQuerySet to determine when a fetch + failed due to a connection being closed or there is no record set + returned. (Non-standard, added especially for django) + """ + + pass + + +# # # # # ----- Type Objects and Constructors ----- # # # # # +# Many databases need to have the input in a particular format for binding to an operation's input parameters. +# For example, if an input is destined for a DATE column, then it must be bound to the database in a particular +# string format. Similar problems exist for "Row ID" columns or large binary items (e.g. blobs or RAW columns). +# This presents problems for Python since the parameters to the executeXXX() method are untyped. +# When the database module sees a Python string object, it doesn't know if it should be bound as a simple CHAR +# column, as a raw BINARY item, or as a DATE. +# +# To overcome this problem, a module must provide the constructors defined below to create objects that can +# hold special values. When passed to the cursor methods, the module can then detect the proper type of +# the input parameter and bind it accordingly. + +# A Cursor Object's description attribute returns information about each of the result columns of a query. +# The type_code must compare equal to one of Type Objects defined below. Type Objects may be equal to more than +# one type code (e.g. DATETIME could be equal to the type codes for date, time and timestamp columns; +# see the Implementation Hints below for details). + +# SQL NULL values are represented by the Python None singleton on input and output. + +# Note: Usage of Unix ticks for database interfacing can cause troubles because of the limited date range they cover. + + +# def Date(year,month,day): +# "This function constructs an object holding a date value. " +# return dateconverter.date(year,month,day) #dateconverter.Date(year,month,day) +# +# def Time(hour,minute,second): +# "This function constructs an object holding a time value. " +# return dateconverter.time(hour, minute, second) # dateconverter.Time(hour,minute,second) +# +# def Timestamp(year,month,day,hour,minute,second): +# "This function constructs an object holding a time stamp value. " +# return dateconverter.datetime(year,month,day,hour,minute,second) +# +# def DateFromTicks(ticks): +# """This function constructs an object holding a date value from the given ticks value +# (number of seconds since the epoch; see the documentation of the standard Python time module for details). """ +# return Date(*time.gmtime(ticks)[:3]) +# +# def TimeFromTicks(ticks): +# """This function constructs an object holding a time value from the given ticks value +# (number of seconds since the epoch; see the documentation of the standard Python time module for details). """ +# return Time(*time.gmtime(ticks)[3:6]) +# +# def TimestampFromTicks(ticks): +# """This function constructs an object holding a time stamp value from the given +# ticks value (number of seconds since the epoch; +# see the documentation of the standard Python time module for details). """ +# return Timestamp(*time.gmtime(ticks)[:6]) +# +# def Binary(aString): +# """This function constructs an object capable of holding a binary (long) string value. """ +# b = makeByteBuffer(aString) +# return b +# ----- Time converters ---------------------------------------------- +class TimeConverter(object): # this is a generic time converter skeleton + def __init__(self): # the details will be filled in by instances + self._ordinal_1899_12_31 = datetime.date(1899, 12, 31).toordinal() - 1 + # Use cls.types to compare if an input parameter is a datetime + self.types = { + type(self.Date(2000, 1, 1)), + type(self.Time(12, 1, 1)), + type(self.Timestamp(2000, 1, 1, 12, 1, 1)), + datetime.datetime, + datetime.time, + datetime.date, + } + + def COMDate(self, obj): + """Returns a ComDate from a date-time""" + try: # most likely a datetime + tt = obj.timetuple() + + try: + ms = obj.microsecond + except: + ms = 0 + return self.ComDateFromTuple(tt, ms) + except: # might be a tuple + try: + return self.ComDateFromTuple(obj) + except: # try an mxdate + try: + return obj.COMDate() + except: + raise ValueError('Cannot convert "%s" to COMdate.' % repr(obj)) + + def ComDateFromTuple(self, t, microseconds=0): + d = datetime.date(t[0], t[1], t[2]) + integerPart = d.toordinal() - self._ordinal_1899_12_31 + ms = (t[3] * 3600 + t[4] * 60 + t[5]) * 1000000 + microseconds + fractPart = float(ms) / 86400000000.0 + return integerPart + fractPart + + def DateObjectFromCOMDate(self, comDate): + "Returns an object of the wanted type from a ComDate" + raise NotImplementedError # "Abstract class" + + def Date(self, year, month, day): + "This function constructs an object holding a date value." + raise NotImplementedError # "Abstract class" + + def Time(self, hour, minute, second): + "This function constructs an object holding a time value." + raise NotImplementedError # "Abstract class" + + def Timestamp(self, year, month, day, hour, minute, second): + "This function constructs an object holding a time stamp value." + raise NotImplementedError # "Abstract class" + # all purpose date to ISO format converter + + def DateObjectToIsoFormatString(self, obj): + "This function should return a string in the format 'YYYY-MM-dd HH:MM:SS:ms' (ms optional)" + try: # most likely, a datetime.datetime + s = obj.isoformat(" ") + except (TypeError, AttributeError): + if isinstance(obj, datetime.date): + s = obj.isoformat() + " 00:00:00" # return exact midnight + else: + try: # maybe it has a strftime method, like mx + s = obj.strftime("%Y-%m-%d %H:%M:%S") + except AttributeError: + try: # but may be time.struct_time + s = time.strftime("%Y-%m-%d %H:%M:%S", obj) + except: + raise ValueError('Cannot convert "%s" to isoformat' % repr(obj)) + return s + + +# -- Optional: if mx extensions are installed you may use mxDateTime ---- +try: + import mx.DateTime + + mxDateTime = True +except: + mxDateTime = False +if mxDateTime: + + class mxDateTimeConverter(TimeConverter): # used optionally if installed + def __init__(self): + TimeConverter.__init__(self) + self.types.add(type(mx.DateTime)) + + def DateObjectFromCOMDate(self, comDate): + return mx.DateTime.DateTimeFromCOMDate(comDate) + + def Date(self, year, month, day): + return mx.DateTime.Date(year, month, day) + + def Time(self, hour, minute, second): + return mx.DateTime.Time(hour, minute, second) + + def Timestamp(self, year, month, day, hour, minute, second): + return mx.DateTime.Timestamp(year, month, day, hour, minute, second) + +else: + + class mxDateTimeConverter(TimeConverter): + pass # if no mx is installed + + +class pythonDateTimeConverter(TimeConverter): # standard since Python 2.3 + def __init__(self): + TimeConverter.__init__(self) + + def DateObjectFromCOMDate(self, comDate): + if isinstance(comDate, datetime.datetime): + odn = comDate.toordinal() + tim = comDate.time() + new = datetime.datetime.combine(datetime.datetime.fromordinal(odn), tim) + return new + # return comDate.replace(tzinfo=None) # make non aware + elif isinstance(comDate, DateTime): + fComDate = comDate.ToOADate() # ironPython clr Date/Time + else: + fComDate = float(comDate) # ComDate is number of days since 1899-12-31 + integerPart = int(fComDate) + floatpart = fComDate - integerPart + ##if floatpart == 0.0: + ## return datetime.date.fromordinal(integerPart + self._ordinal_1899_12_31) + dte = datetime.datetime.fromordinal( + integerPart + self._ordinal_1899_12_31 + ) + datetime.timedelta(milliseconds=floatpart * 86400000) + # millisecondsperday=86400000 # 24*60*60*1000 + return dte + + def Date(self, year, month, day): + return datetime.date(year, month, day) + + def Time(self, hour, minute, second): + return datetime.time(hour, minute, second) + + def Timestamp(self, year, month, day, hour, minute, second): + return datetime.datetime(year, month, day, hour, minute, second) + + +class pythonTimeConverter(TimeConverter): # the old, ?nix type date and time + def __init__(self): # caution: this Class gets confised by timezones and DST + TimeConverter.__init__(self) + self.types.add(time.struct_time) + + def DateObjectFromCOMDate(self, comDate): + "Returns ticks since 1970" + if isinstance(comDate, datetime.datetime): + return comDate.timetuple() + elif isinstance(comDate, DateTime): # ironPython clr date/time + fcomDate = comDate.ToOADate() + else: + fcomDate = float(comDate) + secondsperday = 86400 # 24*60*60 + # ComDate is number of days since 1899-12-31, gmtime epoch is 1970-1-1 = 25569 days + t = time.gmtime(secondsperday * (fcomDate - 25569.0)) + return t # year,month,day,hour,minute,second,weekday,julianday,daylightsaving=t + + def Date(self, year, month, day): + return self.Timestamp(year, month, day, 0, 0, 0) + + def Time(self, hour, minute, second): + return time.gmtime((hour * 60 + minute) * 60 + second) + + def Timestamp(self, year, month, day, hour, minute, second): + return time.localtime( + time.mktime((year, month, day, hour, minute, second, 0, 0, -1)) + ) + + +base_dateconverter = pythonDateTimeConverter() + +# ------ DB API required module attributes --------------------- +threadsafety = 1 # TODO -- find out whether this module is actually BETTER than 1. + +apilevel = "2.0" # String constant stating the supported DB API level. + +paramstyle = "qmark" # the default parameter style + +# ------ control for an extension which may become part of DB API 3.0 --- +accepted_paramstyles = ("qmark", "named", "format", "pyformat", "dynamic") + +# ------------------------------------------------------------------------------------------ +# define similar types for generic conversion routines +adoIntegerTypes = ( + adc.adInteger, + adc.adSmallInt, + adc.adTinyInt, + adc.adUnsignedInt, + adc.adUnsignedSmallInt, + adc.adUnsignedTinyInt, + adc.adBoolean, + adc.adError, +) # max 32 bits +adoRowIdTypes = (adc.adChapter,) # v2.1 Rose +adoLongTypes = (adc.adBigInt, adc.adFileTime, adc.adUnsignedBigInt) +adoExactNumericTypes = ( + adc.adDecimal, + adc.adNumeric, + adc.adVarNumeric, + adc.adCurrency, +) # v2.3 Cole +adoApproximateNumericTypes = (adc.adDouble, adc.adSingle) # v2.1 Cole +adoStringTypes = ( + adc.adBSTR, + adc.adChar, + adc.adLongVarChar, + adc.adLongVarWChar, + adc.adVarChar, + adc.adVarWChar, + adc.adWChar, +) +adoBinaryTypes = (adc.adBinary, adc.adLongVarBinary, adc.adVarBinary) +adoDateTimeTypes = (adc.adDBTime, adc.adDBTimeStamp, adc.adDate, adc.adDBDate) +adoRemainingTypes = ( + adc.adEmpty, + adc.adIDispatch, + adc.adIUnknown, + adc.adPropVariant, + adc.adArray, + adc.adUserDefined, + adc.adVariant, + adc.adGUID, +) + + +# this class is a trick to determine whether a type is a member of a related group of types. see PEP notes +class DBAPITypeObject(object): + def __init__(self, valuesTuple): + self.values = frozenset(valuesTuple) + + def __eq__(self, other): + return other in self.values + + def __ne__(self, other): + return other not in self.values + + +"""This type object is used to describe columns in a database that are string-based (e.g. CHAR). """ +STRING = DBAPITypeObject(adoStringTypes) + +"""This type object is used to describe (long) binary columns in a database (e.g. LONG, RAW, BLOBs). """ +BINARY = DBAPITypeObject(adoBinaryTypes) + +"""This type object is used to describe numeric columns in a database. """ +NUMBER = DBAPITypeObject( + adoIntegerTypes + adoLongTypes + adoExactNumericTypes + adoApproximateNumericTypes +) + +"""This type object is used to describe date/time columns in a database. """ + +DATETIME = DBAPITypeObject(adoDateTimeTypes) +"""This type object is used to describe the "Row ID" column in a database. """ +ROWID = DBAPITypeObject(adoRowIdTypes) + +OTHER = DBAPITypeObject(adoRemainingTypes) + +# ------- utilities for translating python data types to ADO data types --------------------------------- +typeMap = { + memoryViewType: adc.adVarBinary, + float: adc.adDouble, + type(None): adc.adEmpty, + str: adc.adBSTR, + bool: adc.adBoolean, # v2.1 Cole + decimal.Decimal: adc.adDecimal, + int: adc.adBigInt, + bytes: adc.adVarBinary, +} + + +def pyTypeToADOType(d): + tp = type(d) + try: + return typeMap[tp] + except KeyError: # The type was not defined in the pre-computed Type table + from . import dateconverter + + if ( + tp in dateconverter.types + ): # maybe it is one of our supported Date/Time types + return adc.adDate + # otherwise, attempt to discern the type by probing the data object itself -- to handle duck typing + if isinstance(d, StringTypes): + return adc.adBSTR + if isinstance(d, numbers.Integral): + return adc.adBigInt + if isinstance(d, numbers.Real): + return adc.adDouble + raise DataError('cannot convert "%s" (type=%s) to ADO' % (repr(d), tp)) + + +# # # # # # # # # # # # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +# functions to convert database values to Python objects +# ------------------------------------------------------------------------ +# variant type : function converting variant to Python value +def variantConvertDate(v): + from . import dateconverter # this function only called when adodbapi is running + + return dateconverter.DateObjectFromCOMDate(v) + + +def cvtString(variant): # use to get old action of adodbapi v1 if desired + if onIronPython: + try: + return variant.ToString() + except: + pass + return str(variant) + + +def cvtDecimal(variant): # better name + return _convertNumberWithCulture(variant, decimal.Decimal) + + +def cvtNumeric(variant): # older name - don't break old code + return cvtDecimal(variant) + + +def cvtFloat(variant): + return _convertNumberWithCulture(variant, float) + + +def _convertNumberWithCulture(variant, f): + try: + return f(variant) + except (ValueError, TypeError, decimal.InvalidOperation): + try: + europeVsUS = str(variant).replace(",", ".") + return f(europeVsUS) + except (ValueError, TypeError, decimal.InvalidOperation): + pass + + +def cvtInt(variant): + return int(variant) + + +def cvtLong(variant): # only important in old versions where long and int differ + return int(variant) + + +def cvtBuffer(variant): + return bytes(variant) + + +def cvtUnicode(variant): + return str(variant) + + +def identity(x): + return x + + +def cvtUnusual(variant): + if verbose > 1: + sys.stderr.write("Conversion called for Unusual data=%s\n" % repr(variant)) + if isinstance(variant, DateTime): # COMdate or System.Date + from .adodbapi import ( # this will only be called when adodbapi is in use, and very rarely + dateconverter, + ) + + return dateconverter.DateObjectFromCOMDate(variant) + return variant # cannot find conversion function -- just give the data to the user + + +def convert_to_python(variant, func): # convert DB value into Python value + if isinstance(variant, NullTypes): # IronPython Null or None + return None + return func(variant) # call the appropriate conversion function + + +class MultiMap(dict): # builds a dictionary from {(sequence,of,keys) : function} + """A dictionary of ado.type : function -- but you can set multiple items by passing a sequence of keys""" + + # useful for defining conversion functions for groups of similar data types. + def __init__(self, aDict): + for k, v in list(aDict.items()): + self[k] = v # we must call __setitem__ + + def __setitem__(self, adoType, cvtFn): + "set a single item, or a whole sequence of items" + try: # user passed us a sequence, set them individually + for type in adoType: + dict.__setitem__(self, type, cvtFn) + except TypeError: # a single value fails attempt to iterate + dict.__setitem__(self, adoType, cvtFn) + + +# initialize variantConversions dictionary used to convert SQL to Python +# this is the dictionary of default conversion functions, built by the class above. +# this becomes a class attribute for the Connection, and that attribute is used +# to build the list of column conversion functions for the Cursor +variantConversions = MultiMap( + { + adoDateTimeTypes: variantConvertDate, + adoApproximateNumericTypes: cvtFloat, + adoExactNumericTypes: cvtDecimal, # use to force decimal rather than unicode + adoLongTypes: cvtLong, + adoIntegerTypes: cvtInt, + adoRowIdTypes: cvtInt, + adoStringTypes: identity, + adoBinaryTypes: cvtBuffer, + adoRemainingTypes: cvtUnusual, + } +) + +# # # # # classes to emulate the result of cursor.fetchxxx() as a sequence of sequences # # # # # +# "an ENUM of how my low level records are laid out" +RS_WIN_32, RS_ARRAY, RS_REMOTE = list(range(1, 4)) + + +class SQLrow(object): # a single database row + # class to emulate a sequence, so that a column may be retrieved by either number or name + def __init__(self, rows, index): # "rows" is an _SQLrows object, index is which row + self.rows = rows # parent 'fetch' container object + self.index = index # my row number within parent + + def __getattr__(self, name): # used for row.columnName type of value access + try: + return self._getValue(self.rows.columnNames[name.lower()]) + except KeyError: + raise AttributeError('Unknown column name "{}"'.format(name)) + + def _getValue(self, key): # key must be an integer + if ( + self.rows.recordset_format == RS_ARRAY + ): # retrieve from two-dimensional array + v = self.rows.ado_results[key, self.index] + elif self.rows.recordset_format == RS_REMOTE: + v = self.rows.ado_results[self.index][key] + else: # pywin32 - retrieve from tuple of tuples + v = self.rows.ado_results[key][self.index] + if self.rows.converters is NotImplemented: + return v + return convert_to_python(v, self.rows.converters[key]) + + def __len__(self): + return self.rows.numberOfColumns + + def __getitem__(self, key): # used for row[key] type of value access + if isinstance(key, int): # normal row[1] designation + try: + return self._getValue(key) + except IndexError: + raise + if isinstance(key, slice): + indices = key.indices(self.rows.numberOfColumns) + vl = [self._getValue(i) for i in range(*indices)] + return tuple(vl) + try: + return self._getValue( + self.rows.columnNames[key.lower()] + ) # extension row[columnName] designation + except (KeyError, TypeError): + er, st, tr = sys.exc_info() + raise er( + 'No such key as "%s" in %s' % (repr(key), self.__repr__()) + ).with_traceback(tr) + + def __iter__(self): + return iter(self.__next__()) + + def __next__(self): + for n in range(self.rows.numberOfColumns): + yield self._getValue(n) + + def __repr__(self): # create a human readable representation + taglist = sorted(list(self.rows.columnNames.items()), key=lambda x: x[1]) + s = "" + + def __str__(self): # create a pretty human readable representation + return str( + tuple(str(self._getValue(i)) for i in range(self.rows.numberOfColumns)) + ) + + # TO-DO implement pickling an SQLrow directly + # def __getstate__(self): return self.__dict__ + # def __setstate__(self, d): self.__dict__.update(d) + # which basically tell pickle to treat your class just like a normal one, + # taking self.__dict__ as representing the whole of the instance state, + # despite the existence of the __getattr__. + # # # # + + +class SQLrows(object): + # class to emulate a sequence for multiple rows using a container object + def __init__(self, ado_results, numberOfRows, cursor): + self.ado_results = ado_results # raw result of SQL get + try: + self.recordset_format = cursor.recordset_format + self.numberOfColumns = cursor.numberOfColumns + self.converters = cursor.converters + self.columnNames = cursor.columnNames + except AttributeError: + self.recordset_format = RS_ARRAY + self.numberOfColumns = 0 + self.converters = [] + self.columnNames = {} + self.numberOfRows = numberOfRows + + def __len__(self): + return self.numberOfRows + + def __getitem__(self, item): # used for row or row,column access + if not self.ado_results: + return [] + if isinstance(item, slice): # will return a list of row objects + indices = item.indices(self.numberOfRows) + return [SQLrow(self, k) for k in range(*indices)] + elif isinstance(item, tuple) and len(item) == 2: + # d = some_rowsObject[i,j] will return a datum from a two-dimension address + i, j = item + if not isinstance(j, int): + try: + j = self.columnNames[j.lower()] # convert named column to numeric + except KeyError: + raise KeyError('adodbapi: no such column name as "%s"' % repr(j)) + if self.recordset_format == RS_ARRAY: # retrieve from two-dimensional array + v = self.ado_results[j, i] + elif self.recordset_format == RS_REMOTE: + v = self.ado_results[i][j] + else: # pywin32 - retrieve from tuple of tuples + v = self.ado_results[j][i] + if self.converters is NotImplemented: + return v + return convert_to_python(v, self.converters[j]) + else: + row = SQLrow(self, item) # new row descriptor + return row + + def __iter__(self): + return iter(self.__next__()) + + def __next__(self): + for n in range(self.numberOfRows): + row = SQLrow(self, n) + yield row + # # # # # + + # # # # # functions to re-format SQL requests to other paramstyle requirements # # # # # # # # # # + + +def changeNamedToQmark( + op, +): # convert from 'named' paramstyle to ADO required '?'mark parameters + outOp = "" + outparms = [] + chunks = op.split( + "'" + ) # quote all literals -- odd numbered list results are literals. + inQuotes = False + for chunk in chunks: + if inQuotes: # this is inside a quote + if chunk == "": # double apostrophe to quote one apostrophe + outOp = outOp[:-1] # so take one away + else: + outOp += "'" + chunk + "'" # else pass the quoted string as is. + else: # is SQL code -- look for a :namedParameter + while chunk: # some SQL string remains + sp = chunk.split(":", 1) + outOp += sp[0] # concat the part up to the : + s = "" + try: + chunk = sp[1] + except IndexError: + chunk = None + if chunk: # there was a parameter - parse it out + i = 0 + c = chunk[0] + while c.isalnum() or c == "_": + i += 1 + try: + c = chunk[i] + except IndexError: + break + s = chunk[:i] + chunk = chunk[i:] + if s: + outparms.append(s) # list the parameters in order + outOp += "?" # put in the Qmark + inQuotes = not inQuotes + return outOp, outparms + + +def changeFormatToQmark( + op, +): # convert from 'format' paramstyle to ADO required '?'mark parameters + outOp = "" + outparams = [] + chunks = op.split( + "'" + ) # quote all literals -- odd numbered list results are literals. + inQuotes = False + for chunk in chunks: + if inQuotes: + if ( + outOp != "" and chunk == "" + ): # he used a double apostrophe to quote one apostrophe + outOp = outOp[:-1] # so take one away + else: + outOp += "'" + chunk + "'" # else pass the quoted string as is. + else: # is SQL code -- look for a %s parameter + if "%(" in chunk: # ugh! pyformat! + while chunk: # some SQL string remains + sp = chunk.split("%(", 1) + outOp += sp[0] # concat the part up to the % + if len(sp) > 1: + try: + s, chunk = sp[1].split(")s", 1) # find the ')s' + except ValueError: + raise ProgrammingError( + 'Pyformat SQL has incorrect format near "%s"' % chunk + ) + outparams.append(s) + outOp += "?" # put in the Qmark + else: + chunk = None + else: # proper '%s' format + sp = chunk.split("%s") # make each %s + outOp += "?".join(sp) # into ? + inQuotes = not inQuotes # every other chunk is a quoted string + return outOp, outparams diff --git a/lib/adodbapi/examples/db_print.py b/lib/adodbapi/examples/db_print.py new file mode 100644 index 00000000..3f5f9d5b --- /dev/null +++ b/lib/adodbapi/examples/db_print.py @@ -0,0 +1,72 @@ +""" db_print.py -- a simple demo for ADO database reads.""" + +import sys + +import adodbapi.ado_consts as adc + +cmd_args = ("filename", "table_name") +if "help" in sys.argv: + print("possible settings keywords are:", cmd_args) + sys.exit() + +kw_args = {} # pick up filename and proxy address from command line (optionally) +for arg in sys.argv: + s = arg.split("=") + if len(s) > 1: + if s[0] in cmd_args: + kw_args[s[0]] = s[1] + +kw_args.setdefault( + "filename", "test.mdb" +) # assumes server is running from examples folder +kw_args.setdefault("table_name", "Products") # the name of the demo table + +# the server needs to select the provider based on his Python installation +provider_switch = ["provider", "Microsoft.ACE.OLEDB.12.0", "Microsoft.Jet.OLEDB.4.0"] + +# ------------------------ START HERE ------------------------------------- +# create the connection +constr = "Provider=%(provider)s;Data Source=%(filename)s" +import adodbapi as db + +con = db.connect(constr, kw_args, macro_is64bit=provider_switch) + +if kw_args["table_name"] == "?": + print("The tables in your database are:") + for name in con.get_table_names(): + print(name) +else: + # make a cursor on the connection + with con.cursor() as c: + # run an SQL statement on the cursor + sql = "select * from %s" % kw_args["table_name"] + print('performing query="%s"' % sql) + c.execute(sql) + + # check the results + print( + 'result rowcount shows as= %d. (Note: -1 means "not known")' % (c.rowcount,) + ) + print("") + print("result data description is:") + print(" NAME Type DispSize IntrnlSz Prec Scale Null?") + for d in c.description: + print( + ("%16s %-12s %8s %8d %4d %5d %s") + % (d[0], adc.adTypeNames[d[1]], d[2], d[3], d[4], d[5], bool(d[6])) + ) + print("") + print("str() of first five records are...") + + # get the results + db = c.fetchmany(5) + + # print them + for rec in db: + print(rec) + + print("") + print("repr() of next row is...") + print(repr(c.fetchone())) + print("") +con.close() diff --git a/lib/adodbapi/examples/db_table_names.py b/lib/adodbapi/examples/db_table_names.py new file mode 100644 index 00000000..eb512a33 --- /dev/null +++ b/lib/adodbapi/examples/db_table_names.py @@ -0,0 +1,20 @@ +""" db_table_names.py -- a simple demo for ADO database table listing.""" +import sys + +import adodbapi + +try: + databasename = sys.argv[1] +except IndexError: + databasename = "test.mdb" + +provider = ["prv", "Microsoft.ACE.OLEDB.12.0", "Microsoft.Jet.OLEDB.4.0"] +constr = "Provider=%(prv)s;Data Source=%(db)s" + +# create the connection +con = adodbapi.connect(constr, db=databasename, macro_is64bit=provider) + +print("Table names in= %s" % databasename) + +for table in con.get_table_names(): + print(table) diff --git a/lib/adodbapi/examples/xls_read.py b/lib/adodbapi/examples/xls_read.py new file mode 100644 index 00000000..45e0d277 --- /dev/null +++ b/lib/adodbapi/examples/xls_read.py @@ -0,0 +1,41 @@ +import sys + +import adodbapi + +try: + import adodbapi.is64bit as is64bit + + is64 = is64bit.Python() +except ImportError: + is64 = False + +if is64: + driver = "Microsoft.ACE.OLEDB.12.0" +else: + driver = "Microsoft.Jet.OLEDB.4.0" +extended = 'Extended Properties="Excel 8.0;HDR=Yes;IMEX=1;"' + +try: # first command line argument will be xls file name -- default to the one written by xls_write.py + filename = sys.argv[1] +except IndexError: + filename = "xx.xls" + +constr = "Provider=%s;Data Source=%s;%s" % (driver, filename, extended) + +conn = adodbapi.connect(constr) + +try: # second command line argument will be worksheet name -- default to first worksheet + sheet = sys.argv[2] +except IndexError: + # use ADO feature to get the name of the first worksheet + sheet = conn.get_table_names()[0] + +print("Shreadsheet=%s Worksheet=%s" % (filename, sheet)) +print("------------------------------------------------------------") +crsr = conn.cursor() +sql = "SELECT * from [%s]" % sheet +crsr.execute(sql) +for row in crsr.fetchmany(10): + print(repr(row)) +crsr.close() +conn.close() diff --git a/lib/adodbapi/examples/xls_write.py b/lib/adodbapi/examples/xls_write.py new file mode 100644 index 00000000..9d1d3114 --- /dev/null +++ b/lib/adodbapi/examples/xls_write.py @@ -0,0 +1,41 @@ +import datetime + +import adodbapi + +try: + import adodbapi.is64bit as is64bit + + is64 = is64bit.Python() +except ImportError: + is64 = False # in case the user has an old version of adodbapi +if is64: + driver = "Microsoft.ACE.OLEDB.12.0" +else: + driver = "Microsoft.Jet.OLEDB.4.0" +filename = "xx.xls" # file will be created if it does not exist +extended = 'Extended Properties="Excel 8.0;Readonly=False;"' + +constr = "Provider=%s;Data Source=%s;%s" % (driver, filename, extended) + +conn = adodbapi.connect(constr) +with conn: # will auto commit if no errors + with conn.cursor() as crsr: + try: + crsr.execute("drop table SheetOne") + except: + pass # just is case there is one already there + + # create the sheet and the header row and set the types for the columns + crsr.execute( + "create table SheetOne (Name varchar, Rank varchar, SrvcNum integer, Weight float, Birth date)" + ) + + sql = "INSERT INTO SheetOne (name, rank , srvcnum, weight, birth) values (?,?,?,?,?)" + + data = ("Mike Murphy", "SSG", 123456789, 167.8, datetime.date(1922, 12, 27)) + crsr.execute(sql, data) # write the first row of data + crsr.execute( + sql, ["John Jones", "Pvt", 987654321, 140.0, datetime.date(1921, 7, 4)] + ) # another row of data +conn.close() +print("Created spreadsheet=%s worksheet=%s" % (filename, "SheetOne")) diff --git a/lib/adodbapi/is64bit.py b/lib/adodbapi/is64bit.py new file mode 100644 index 00000000..bba12b43 --- /dev/null +++ b/lib/adodbapi/is64bit.py @@ -0,0 +1,41 @@ +"""is64bit.Python() --> boolean value of detected Python word size. is64bit.os() --> os build version""" +import sys + + +def Python(): + if sys.platform == "cli": # IronPython + import System + + return System.IntPtr.Size == 8 + else: + try: + return sys.maxsize > 2147483647 + except AttributeError: + return sys.maxint > 2147483647 + + +def os(): + import platform + + pm = platform.machine() + if pm != ".." and pm.endswith("64"): # recent Python (not Iron) + return True + else: + import os + + if "PROCESSOR_ARCHITEW6432" in os.environ: + return True # 32 bit program running on 64 bit Windows + try: + return os.environ["PROCESSOR_ARCHITECTURE"].endswith( + "64" + ) # 64 bit Windows 64 bit program + except (IndexError, KeyError): + pass # not Windows + try: + return "64" in platform.architecture()[0] # this often works in Linux + except: + return False # is an older version of Python, assume also an older os (best we can guess) + + +if __name__ == "__main__": + print("is64bit.Python() =", Python(), "is64bit.os() =", os()) diff --git a/lib/adodbapi/license.txt b/lib/adodbapi/license.txt new file mode 100644 index 00000000..c255f4aa --- /dev/null +++ b/lib/adodbapi/license.txt @@ -0,0 +1,506 @@ + GNU LESSER GENERAL PUBLIC LICENSE + Version 2.1, February 1999 + + Copyright (C) 1991, 1999 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + +[This is the first released version of the Lesser GPL. It also counts + as the successor of the GNU Library Public License, version 2, hence + the version number 2.1.] + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +Licenses are intended to guarantee your freedom to share and change +free software--to make sure the software is free for all its users. + + This license, the Lesser General Public License, applies to some +specially designated software packages--typically libraries--of the +Free Software Foundation and other authors who decide to use it. You +can use it too, but we suggest you first think carefully about whether +this license or the ordinary General Public License is the better +strategy to use in any particular case, based on the explanations below. + + When we speak of free software, we are referring to freedom of use, +not price. Our General Public Licenses are designed to make sure that +you have the freedom to distribute copies of free software (and charge +for this service if you wish); that you receive source code or can get +it if you want it; that you can change the software and use pieces of +it in new free programs; and that you are informed that you can do +these things. + + To protect your rights, we need to make restrictions that forbid +distributors to deny you these rights or to ask you to surrender these +rights. These restrictions translate to certain responsibilities for +you if you distribute copies of the library or if you modify it. + + For example, if you distribute copies of the library, whether gratis +or for a fee, you must give the recipients all the rights that we gave +you. You must make sure that they, too, receive or can get the source +code. If you link other code with the library, you must provide +complete object files to the recipients, so that they can relink them +with the library after making changes to the library and recompiling +it. And you must show them these terms so they know their rights. + + We protect your rights with a two-step method: (1) we copyright the +library, and (2) we offer you this license, which gives you legal +permission to copy, distribute and/or modify the library. + + To protect each distributor, we want to make it very clear that +there is no warranty for the free library. Also, if the library is +modified by someone else and passed on, the recipients should know +that what they have is not the original version, so that the original +author's reputation will not be affected by problems that might be +introduced by others. + + + + Finally, software patents pose a constant threat to the existence of +any free program. We wish to make sure that a company cannot +effectively restrict the users of a free program by obtaining a +restrictive license from a patent holder. Therefore, we insist that +any patent license obtained for a version of the library must be +consistent with the full freedom of use specified in this license. + + Most GNU software, including some libraries, is covered by the +ordinary GNU General Public License. This license, the GNU Lesser +General Public License, applies to certain designated libraries, and +is quite different from the ordinary General Public License. We use +this license for certain libraries in order to permit linking those +libraries into non-free programs. + + When a program is linked with a library, whether statically or using +a shared library, the combination of the two is legally speaking a +combined work, a derivative of the original library. The ordinary +General Public License therefore permits such linking only if the +entire combination fits its criteria of freedom. The Lesser General +Public License permits more lax criteria for linking other code with +the library. + + We call this license the "Lesser" General Public License because it +does Less to protect the user's freedom than the ordinary General +Public License. It also provides other free software developers Less +of an advantage over competing non-free programs. These disadvantages +are the reason we use the ordinary General Public License for many +libraries. However, the Lesser license provides advantages in certain +special circumstances. + + For example, on rare occasions, there may be a special need to +encourage the widest possible use of a certain library, so that it becomes +a de-facto standard. To achieve this, non-free programs must be +allowed to use the library. A more frequent case is that a free +library does the same job as widely used non-free libraries. In this +case, there is little to gain by limiting the free library to free +software only, so we use the Lesser General Public License. + + In other cases, permission to use a particular library in non-free +programs enables a greater number of people to use a large body of +free software. For example, permission to use the GNU C Library in +non-free programs enables many more people to use the whole GNU +operating system, as well as its variant, the GNU/Linux operating +system. + + Although the Lesser General Public License is Less protective of the +users' freedom, it does ensure that the user of a program that is +linked with the Library has the freedom and the wherewithal to run +that program using a modified version of the Library. + + The precise terms and conditions for copying, distribution and +modification follow. Pay close attention to the difference between a +"work based on the library" and a "work that uses the library". The +former contains code derived from the library, whereas the latter must +be combined with the library in order to run. + + + + GNU LESSER GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License Agreement applies to any software library or other +program which contains a notice placed by the copyright holder or +other authorized party saying it may be distributed under the terms of +this Lesser General Public License (also called "this License"). +Each licensee is addressed as "you". + + A "library" means a collection of software functions and/or data +prepared so as to be conveniently linked with application programs +(which use some of those functions and data) to form executables. + + The "Library", below, refers to any such software library or work +which has been distributed under these terms. A "work based on the +Library" means either the Library or any derivative work under +copyright law: that is to say, a work containing the Library or a +portion of it, either verbatim or with modifications and/or translated +straightforwardly into another language. (Hereinafter, translation is +included without limitation in the term "modification".) + + "Source code" for a work means the preferred form of the work for +making modifications to it. For a library, complete source code means +all the source code for all modules it contains, plus any associated +interface definition files, plus the scripts used to control compilation +and installation of the library. + + Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running a program using the Library is not restricted, and output from +such a program is covered only if its contents constitute a work based +on the Library (independent of the use of the Library in a tool for +writing it). Whether that is true depends on what the Library does +and what the program that uses the Library does. + + 1. You may copy and distribute verbatim copies of the Library's +complete source code as you receive it, in any medium, provided that +you conspicuously and appropriately publish on each copy an +appropriate copyright notice and disclaimer of warranty; keep intact +all the notices that refer to this License and to the absence of any +warranty; and distribute a copy of this License along with the +Library. + You may charge a fee for the physical act of transferring a copy, +and you may at your option offer warranty protection in exchange for a +fee. + + 2. You may modify your copy or copies of the Library or any portion +of it, thus forming a work based on the Library, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) The modified work must itself be a software library. + + b) You must cause the files modified to carry prominent notices + stating that you changed the files and the date of any change. + + c) You must cause the whole of the work to be licensed at no + charge to all third parties under the terms of this License. + + d) If a facility in the modified Library refers to a function or a + table of data to be supplied by an application program that uses + the facility, other than as an argument passed when the facility + is invoked, then you must make a good faith effort to ensure that, + in the event an application does not supply such function or + table, the facility still operates, and performs whatever part of + its purpose remains meaningful. + + (For example, a function in a library to compute square roots has + a purpose that is entirely well-defined independent of the + application. Therefore, Subsection 2d requires that any + application-supplied function or table used by this function must + be optional: if the application does not supply it, the square + root function must still compute square roots.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Library, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Library, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote +it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Library. + +In addition, mere aggregation of another work not based on the Library +with the Library (or with a work based on the Library) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may opt to apply the terms of the ordinary GNU General Public +License instead of this License to a given copy of the Library. To do +this, you must alter all the notices that refer to this License, so +that they refer to the ordinary GNU General Public License, version 2, +instead of to this License. (If a newer version than version 2 of the +ordinary GNU General Public License has appeared, then you can specify +that version instead if you wish.) Do not make any other change in +these notices. + + Once this change is made in a given copy, it is irreversible for +that copy, so the ordinary GNU General Public License applies to all +subsequent copies and derivative works made from that copy. + + This option is useful when you wish to copy part of the code of +the Library into a program that is not a library. + + 4. You may copy and distribute the Library (or a portion or +derivative of it, under Section 2) in object code or executable form +under the terms of Sections 1 and 2 above provided that you accompany +it with the complete corresponding machine-readable source code, which +must be distributed under the terms of Sections 1 and 2 above on a +medium customarily used for software interchange. + + If distribution of object code is made by offering access to copy +from a designated place, then offering equivalent access to copy the +source code from the same place satisfies the requirement to +distribute the source code, even though third parties are not +compelled to copy the source along with the object code. + + 5. A program that contains no derivative of any portion of the +Library, but is designed to work with the Library by being compiled or +linked with it, is called a "work that uses the Library". Such a +work, in isolation, is not a derivative work of the Library, and +therefore falls outside the scope of this License. + + However, linking a "work that uses the Library" with the Library +creates an executable that is a derivative of the Library (because it +contains portions of the Library), rather than a "work that uses the +library". The executable is therefore covered by this License. +Section 6 states terms for distribution of such executables. + + When a "work that uses the Library" uses material from a header file +that is part of the Library, the object code for the work may be a +derivative work of the Library even though the source code is not. +Whether this is true is especially significant if the work can be +linked without the Library, or if the work is itself a library. The +threshold for this to be true is not precisely defined by law. + + If such an object file uses only numerical parameters, data +structure layouts and accessors, and small macros and small inline +functions (ten lines or less in length), then the use of the object +file is unrestricted, regardless of whether it is legally a derivative +work. (Executables containing this object code plus portions of the +Library will still fall under Section 6.) + + Otherwise, if the work is a derivative of the Library, you may +distribute the object code for the work under the terms of Section 6. +Any executables containing that work also fall under Section 6, +whether or not they are linked directly with the Library itself. + + 6. As an exception to the Sections above, you may also combine or +link a "work that uses the Library" with the Library to produce a +work containing portions of the Library, and distribute that work +under terms of your choice, provided that the terms permit +modification of the work for the customer's own use and reverse +engineering for debugging such modifications. + + You must give prominent notice with each copy of the work that the +Library is used in it and that the Library and its use are covered by +this License. You must supply a copy of this License. If the work +during execution displays copyright notices, you must include the +copyright notice for the Library among them, as well as a reference +directing the user to the copy of this License. Also, you must do one +of these things: + + a) Accompany the work with the complete corresponding + machine-readable source code for the Library including whatever + changes were used in the work (which must be distributed under + Sections 1 and 2 above); and, if the work is an executable linked + with the Library, with the complete machine-readable "work that + uses the Library", as object code and/or source code, so that the + user can modify the Library and then relink to produce a modified + executable containing the modified Library. (It is understood + that the user who changes the contents of definitions files in the + Library will not necessarily be able to recompile the application + to use the modified definitions.) + + b) Use a suitable shared library mechanism for linking with the + Library. A suitable mechanism is one that (1) uses at run time a + copy of the library already present on the user's computer system, + rather than copying library functions into the executable, and (2) + will operate properly with a modified version of the library, if + the user installs one, as long as the modified version is + interface-compatible with the version that the work was made with. + + c) Accompany the work with a written offer, valid for at + least three years, to give the same user the materials + specified in Subsection 6a, above, for a charge no more + than the cost of performing this distribution. + + d) If distribution of the work is made by offering access to copy + from a designated place, offer equivalent access to copy the above + specified materials from the same place. + + e) Verify that the user has already received a copy of these + materials or that you have already sent this user a copy. + + For an executable, the required form of the "work that uses the +Library" must include any data and utility programs needed for +reproducing the executable from it. However, as a special exception, +the materials to be distributed need not include anything that is +normally distributed (in either source or binary form) with the major +components (compiler, kernel, and so on) of the operating system on +which the executable runs, unless that component itself accompanies +the executable. + + It may happen that this requirement contradicts the license +restrictions of other proprietary libraries that do not normally +accompany the operating system. Such a contradiction means you cannot +use both them and the Library together in an executable that you +distribute. + + 7. You may place library facilities that are a work based on the +Library side-by-side in a single library together with other library +facilities not covered by this License, and distribute such a combined +library, provided that the separate distribution of the work based on +the Library and of the other library facilities is otherwise +permitted, and provided that you do these two things: + + a) Accompany the combined library with a copy of the same work + based on the Library, uncombined with any other library + facilities. This must be distributed under the terms of the + Sections above. + + b) Give prominent notice with the combined library of the fact + that part of it is a work based on the Library, and explaining + where to find the accompanying uncombined form of the same work. + + 8. You may not copy, modify, sublicense, link with, or distribute +the Library except as expressly provided under this License. Any +attempt otherwise to copy, modify, sublicense, link with, or +distribute the Library is void, and will automatically terminate your +rights under this License. However, parties who have received copies, +or rights, from you under this License will not have their licenses +terminated so long as such parties remain in full compliance. + + 9. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Library or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Library (or any work based on the +Library), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Library or works based on it. + + 10. Each time you redistribute the Library (or any work based on the +Library), the recipient automatically receives a license from the +original licensor to copy, distribute, link with or modify the Library +subject to these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties with +this License. + + 11. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Library at all. For example, if a patent +license would not permit royalty-free redistribution of the Library by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Library. + +If any portion of this section is held invalid or unenforceable under any +particular circumstance, the balance of the section is intended to apply, +and the section as a whole is intended to apply in other circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 12. If the distribution and/or use of the Library is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Library under this License may add +an explicit geographical distribution limitation excluding those countries, +so that distribution is permitted only in or among countries not thus +excluded. In such case, this License incorporates the limitation as if +written in the body of this License. + + 13. The Free Software Foundation may publish revised and/or new +versions of the Lesser General Public License from time to time. +Such new versions will be similar in spirit to the present version, +but may differ in detail to address new problems or concerns. + +Each version is given a distinguishing version number. If the Library +specifies a version number of this License which applies to it and +"any later version", you have the option of following the terms and +conditions either of that version or of any later version published by +the Free Software Foundation. If the Library does not specify a +license version number, you may choose any version ever published by +the Free Software Foundation. + + 14. If you wish to incorporate parts of the Library into other free +programs whose distribution conditions are incompatible with these, +write to the author to ask for permission. For software which is +copyrighted by the Free Software Foundation, write to the Free +Software Foundation; we sometimes make exceptions for this. Our +decision will be guided by the two goals of preserving the free status +of all derivatives of our free software and of promoting the sharing +and reuse of software generally. + + NO WARRANTY + + 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO +WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. +EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR +OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY +KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE +LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME +THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN +WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY +AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU +FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR +CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE +LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING +RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A +FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF +SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH +DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Libraries + + If you develop a new library, and you want it to be of the greatest +possible use to the public, we recommend making it free software that +everyone can redistribute and change. You can do so by permitting +redistribution under these terms (or, alternatively, under the terms of the +ordinary General Public License). + + To apply these terms, attach the following notices to the library. It is +safest to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least the +"copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this library; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + +Also add information on how to contact you by electronic and paper mail. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the library, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the + library `Frob' (a library for tweaking knobs) written by James Random Hacker. + + , 1 April 1990 + Ty Coon, President of Vice + +That's all there is to it! + diff --git a/lib/adodbapi/process_connect_string.py b/lib/adodbapi/process_connect_string.py new file mode 100644 index 00000000..fa34d23a --- /dev/null +++ b/lib/adodbapi/process_connect_string.py @@ -0,0 +1,144 @@ +""" a clumsy attempt at a macro language to let the programmer execute code on the server (ex: determine 64bit)""" +from . import is64bit as is64bit + + +def macro_call(macro_name, args, kwargs): + """allow the programmer to perform limited processing on the server by passing macro names and args + + :new_key - the key name the macro will create + :args[0] - macro name + :args[1:] - any arguments + :code - the value of the keyword item + :kwargs - the connection keyword dictionary. ??key has been removed + --> the value to put in for kwargs['name'] = value + """ + if isinstance(args, (str, str)): + args = [ + args + ] # the user forgot to pass a sequence, so make a string into args[0] + new_key = args[0] + try: + if macro_name == "is64bit": + if is64bit.Python(): # if on 64 bit Python + return new_key, args[1] # return first argument + else: + try: + return new_key, args[2] # else return second argument (if defined) + except IndexError: + return new_key, "" # else return blank + + elif ( + macro_name == "getuser" + ): # get the name of the user the server is logged in under + if not new_key in kwargs: + import getpass + + return new_key, getpass.getuser() + + elif macro_name == "getnode": # get the name of the computer running the server + import platform + + try: + return new_key, args[1] % platform.node() + except IndexError: + return new_key, platform.node() + + elif macro_name == "getenv": # expand the server's environment variable args[1] + try: + dflt = args[2] # if not found, default from args[2] + except IndexError: # or blank + dflt = "" + return new_key, os.environ.get(args[1], dflt) + + elif macro_name == "auto_security": + if ( + not "user" in kwargs or not kwargs["user"] + ): # missing, blank, or Null username + return new_key, "Integrated Security=SSPI" + return new_key, "User ID=%(user)s; Password=%(password)s" % kwargs + + elif ( + macro_name == "find_temp_test_path" + ): # helper function for testing ado operation -- undocumented + import os + import tempfile + + return new_key, os.path.join( + tempfile.gettempdir(), "adodbapi_test", args[1] + ) + + raise ValueError("Unknown connect string macro=%s" % macro_name) + except: + raise ValueError("Error in macro processing %s %s" % (macro_name, repr(args))) + + +def process( + args, kwargs, expand_macros=False +): # --> connection string with keyword arguments processed. + """attempts to inject arguments into a connection string using Python "%" operator for strings + + co: adodbapi connection object + args: positional parameters from the .connect() call + kvargs: keyword arguments from the .connect() call + """ + try: + dsn = args[0] + except IndexError: + dsn = None + if isinstance( + dsn, dict + ): # as a convenience the first argument may be django settings + kwargs.update(dsn) + elif ( + dsn + ): # the connection string is passed to the connection as part of the keyword dictionary + kwargs["connection_string"] = dsn + try: + a1 = args[1] + except IndexError: + a1 = None + # historically, the second positional argument might be a timeout value + if isinstance(a1, int): + kwargs["timeout"] = a1 + # if the second positional argument is a string, then it is user + elif isinstance(a1, str): + kwargs["user"] = a1 + # if the second positional argument is a dictionary, use it as keyword arguments, too + elif isinstance(a1, dict): + kwargs.update(a1) + try: + kwargs["password"] = args[2] # the third positional argument is password + kwargs["host"] = args[3] # the fourth positional argument is host name + kwargs["database"] = args[4] # the fifth positional argument is database name + except IndexError: + pass + + # make sure connection string is defined somehow + if not "connection_string" in kwargs: + try: # perhaps 'dsn' was defined + kwargs["connection_string"] = kwargs["dsn"] + except KeyError: + try: # as a last effort, use the "host" keyword + kwargs["connection_string"] = kwargs["host"] + except KeyError: + raise TypeError("Must define 'connection_string' for ado connections") + if expand_macros: + for kwarg in list(kwargs.keys()): + if kwarg.startswith("macro_"): # If a key defines a macro + macro_name = kwarg[6:] # name without the "macro_" + macro_code = kwargs.pop( + kwarg + ) # we remove the macro_key and get the code to execute + new_key, rslt = macro_call( + macro_name, macro_code, kwargs + ) # run the code in the local context + kwargs[new_key] = rslt # put the result back in the keywords dict + # special processing for PyRO IPv6 host address + try: + s = kwargs["proxy_host"] + if ":" in s: # it is an IPv6 address + if s[0] != "[": # is not surrounded by brackets + kwargs["proxy_host"] = s.join(("[", "]")) # put it in brackets + except KeyError: + pass + return kwargs diff --git a/lib/adodbapi/readme.txt b/lib/adodbapi/readme.txt new file mode 100644 index 00000000..cf591905 --- /dev/null +++ b/lib/adodbapi/readme.txt @@ -0,0 +1,92 @@ +Project +------- +adodbapi + +A Python DB-API 2.0 (PEP-249) module that makes it easy to use Microsoft ADO +for connecting with databases and other data sources +using either CPython or IronPython. + +Home page: + +Features: +* 100% DB-API 2.0 (PEP-249) compliant (including most extensions and recommendations). +* Includes pyunit testcases that describe how to use the module. +* Fully implemented in Python. -- runs in Python 2.5+ Python 3.0+ and IronPython 2.6+ +* Licensed under the LGPL license, which means that it can be used freely even in commercial programs subject to certain restrictions. +* The user can choose between paramstyles: 'qmark' 'named' 'format' 'pyformat' 'dynamic' +* Supports data retrieval by column name e.g.: + for row in myCurser.execute("select name,age from students"): + print("Student", row.name, "is", row.age, "years old.") +* Supports user-definable system-to-Python data conversion functions (selected by ADO data type, or by column) + +Prerequisites: +* C Python 2.7 or 3.5 or higher + and pywin32 (Mark Hammond's python for windows extensions.) +or + Iron Python 2.7 or higher. (works in IPy2.0 for all data types except BUFFER) + +Installation: +* (C-Python on Windows): Install pywin32 ("pip install pywin32") which includes adodbapi. +* (IronPython on Windows): Download adodbapi from http://sf.net/projects/adodbapi. Unpack the zip. + Open a command window as an administrator. CD to the folder containing the unzipped files. + Run "setup.py install" using the IronPython of your choice. + +NOTE: ........... +If you do not like the new default operation of returning Numeric columns as decimal.Decimal, +you can select other options by the user defined conversion feature. +Try: + adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = adodbapi.apibase.cvtString +or: + adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = adodbapi.apibase.cvtFloat +or: + adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = write_your_own_convertion_function + ............ +notes for 2.6.2: + The definitive source has been moved to https://github.com/mhammond/pywin32/tree/master/adodbapi. + Remote has proven too hard to configure and test with Pyro4. I am moving it to unsupported status + until I can change to a different connection method. +whats new in version 2.6 + A cursor.prepare() method and support for prepared SQL statements. + Lots of refactoring, especially of the Remote and Server modules (still to be treated as Beta code). + The quick start document 'quick_reference.odt' will export as a nice-looking pdf. + Added paramstyles 'pyformat' and 'dynamic'. If your 'paramstyle' is 'named' you _must_ pass a dictionary of + parameters to your .execute() method. If your 'paramstyle' is 'format' 'pyformat' or 'dynamic', you _may_ + pass a dictionary of parameters -- provided your SQL operation string is formatted correctly. + +whats new in version 2.5 + Remote module: (works on Linux!) allows a Windows computer to serve ADO databases via PyRO + Server module: PyRO server for ADO. Run using a command like= C:>python -m adodbapi.server + (server has simple connection string macros: is64bit, getuser, sql_provider, auto_security) + Brief documentation included. See adodbapi/examples folder adodbapi.rtf + New connection method conn.get_table_names() --> list of names of tables in database + + Vastly refactored. Data conversion things have been moved to the new adodbapi.apibase module. + Many former module-level attributes are now class attributes. (Should be more thread-safe) + Connection objects are now context managers for transactions and will commit or rollback. + Cursor objects are context managers and will automatically close themselves. + Autocommit can be switched on and off. + Keyword and positional arguments on the connect() method work as documented in PEP 249. + Keyword arguments from the connect call can be formatted into the connection string. + New keyword arguments defined, such as: autocommit, paramstyle, remote_proxy, remote_port. + *** Breaking change: variantConversion lookups are simplified: the following will raise KeyError: + oldconverter=adodbapi.variantConversions[adodbapi.adoStringTypes] + Refactor as: oldconverter=adodbapi.variantConversions[adodbapi.adoStringTypes[0]] + +License +------- +LGPL, see http://www.opensource.org/licenses/lgpl-license.php + +Documentation +------------- + +Look at adodbapi/quick_reference.md +http://www.python.org/topics/database/DatabaseAPI-2.0.html +read the examples in adodbapi/examples +and look at the test cases in adodbapi/test directory. + +Mailing lists +------------- +The adodbapi mailing lists have been deactivated. Submit comments to the +pywin32 or IronPython mailing lists. + -- the bug tracker on sourceforge.net/projects/adodbapi may be checked, (infrequently). + -- please use: https://github.com/mhammond/pywin32/issues diff --git a/lib/adodbapi/remote.py b/lib/adodbapi/remote.py new file mode 100644 index 00000000..ae22b5a7 --- /dev/null +++ b/lib/adodbapi/remote.py @@ -0,0 +1,634 @@ +"""adodbapi.remote - A python DB API 2.0 (PEP 249) interface to Microsoft ADO + +Copyright (C) 2002 Henrik Ekelund, version 2.1 by Vernon Cole +* http://sourceforge.net/projects/pywin32 +* http://sourceforge.net/projects/adodbapi + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this library; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + django adaptations and refactoring thanks to Adam Vandenberg + +DB-API 2.0 specification: http://www.python.org/dev/peps/pep-0249/ + +This module source should run correctly in CPython versions 2.5 and later, +or IronPython version 2.7 and later, +or, after running through 2to3.py, CPython 3.0 or later. +""" + +__version__ = "2.6.0.4" +version = "adodbapi.remote v" + __version__ + +import array +import datetime +import os +import sys +import time + +# Pyro4 is required for server and remote operation --> https://pypi.python.org/pypi/Pyro4/ +try: + import Pyro4 +except ImportError: + print('* * * Sorry, server operation requires Pyro4. Please "pip import" it.') + exit(11) + +import adodbapi +import adodbapi.apibase as api +import adodbapi.process_connect_string +from adodbapi.apibase import ProgrammingError + +_BaseException = api._BaseException + +sys.excepthook = Pyro4.util.excepthook +Pyro4.config.PREFER_IP_VERSION = 0 # allow system to prefer IPv6 +Pyro4.config.COMMTIMEOUT = 40.0 # a bit longer than the default SQL server Gtimeout +Pyro4.config.SERIALIZER = "pickle" + +try: + verbose = int(os.environ["ADODBAPI_VERBOSE"]) +except: + verbose = False +if verbose: + print(version) + +# --- define objects to smooth out Python3 <-> Python 2.x differences +unicodeType = str # this line will be altered by 2to3.py to '= str' +longType = int # this line will be altered by 2to3.py to '= int' +StringTypes = str +makeByteBuffer = bytes +memoryViewType = memoryview + +# ----------------------------------------------------------- +# conversion functions mandated by PEP 249 +Binary = makeByteBuffer # override the function from apibase.py + + +def Date(year, month, day): + return datetime.date(year, month, day) # dateconverter.Date(year,month,day) + + +def Time(hour, minute, second): + return datetime.time(hour, minute, second) # dateconverter.Time(hour,minute,second) + + +def Timestamp(year, month, day, hour, minute, second): + return datetime.datetime(year, month, day, hour, minute, second) + + +def DateFromTicks(ticks): + return Date(*time.gmtime(ticks)[:3]) + + +def TimeFromTicks(ticks): + return Time(*time.gmtime(ticks)[3:6]) + + +def TimestampFromTicks(ticks): + return Timestamp(*time.gmtime(ticks)[:6]) + + +def connect(*args, **kwargs): # --> a remote db-api connection object + """Create and open a remote db-api database connection object""" + # process the argument list the programmer gave us + kwargs = adodbapi.process_connect_string.process(args, kwargs) + # the "proxy_xxx" keys tell us where to find the PyRO proxy server + kwargs.setdefault( + "pyro_connection", "PYRO:ado.connection@%(proxy_host)s:%(proxy_port)s" + ) + if not "proxy_port" in kwargs: + try: + pport = os.environ["PROXY_PORT"] + except KeyError: + pport = 9099 + kwargs["proxy_port"] = pport + if not "proxy_host" in kwargs or not kwargs["proxy_host"]: + try: + phost = os.environ["PROXY_HOST"] + except KeyError: + phost = "[::1]" # '127.0.0.1' + kwargs["proxy_host"] = phost + ado_uri = kwargs["pyro_connection"] % kwargs + # ask PyRO make us a remote connection object + auto_retry = 3 + while auto_retry: + try: + dispatcher = Pyro4.Proxy(ado_uri) + if "comm_timeout" in kwargs: + dispatcher._pyroTimeout = float(kwargs["comm_timeout"]) + uri = dispatcher.make_connection() + break + except Pyro4.core.errors.PyroError: + auto_retry -= 1 + if auto_retry: + time.sleep(1) + else: + raise api.DatabaseError("Cannot create connection to=%s" % ado_uri) + + conn_uri = fix_uri(uri, kwargs) # get a host connection from the proxy server + while auto_retry: + try: + host_conn = Pyro4.Proxy( + conn_uri + ) # bring up an exclusive Pyro connection for my ADO connection + break + except Pyro4.core.errors.PyroError: + auto_retry -= 1 + if auto_retry: + time.sleep(1) + else: + raise api.DatabaseError( + "Cannot create ADO connection object using=%s" % conn_uri + ) + if "comm_timeout" in kwargs: + host_conn._pyroTimeout = float(kwargs["comm_timeout"]) + # make a local clone + myConn = Connection() + while auto_retry: + try: + myConn.connect( + kwargs, host_conn + ) # call my connect method -- hand him the host connection + break + except Pyro4.core.errors.PyroError: + auto_retry -= 1 + if auto_retry: + time.sleep(1) + else: + raise api.DatabaseError( + "Pyro error creating connection to/thru=%s" % repr(kwargs) + ) + except _BaseException as e: + raise api.DatabaseError( + "Error creating remote connection to=%s, e=%s, %s" + % (repr(kwargs), repr(e), sys.exc_info()[2]) + ) + return myConn + + +def fix_uri(uri, kwargs): + """convert a generic pyro uri with '0.0.0.0' into the address we actually called""" + u = uri.asString() + s = u.split("[::0]") # IPv6 generic address + if len(s) == 1: # did not find one + s = u.split("0.0.0.0") # IPv4 generic address + if len(s) > 1: # found a generic + return kwargs["proxy_host"].join(s) # fill in our address for the host + return uri + + +# # # # # ----- the Class that defines a connection ----- # # # # # +class Connection(object): + # include connection attributes required by api definition. + Warning = api.Warning + Error = api.Error + InterfaceError = api.InterfaceError + DataError = api.DataError + DatabaseError = api.DatabaseError + OperationalError = api.OperationalError + IntegrityError = api.IntegrityError + InternalError = api.InternalError + NotSupportedError = api.NotSupportedError + ProgrammingError = api.ProgrammingError + # set up some class attributes + paramstyle = api.paramstyle + + @property + def dbapi(self): # a proposed db-api version 3 extension. + "Return a reference to the DBAPI module for this Connection." + return api + + def __init__(self): + self.proxy = None + self.kwargs = {} + self.errorhandler = None + self.supportsTransactions = False + self.paramstyle = api.paramstyle + self.timeout = 30 + self.cursors = {} + + def connect(self, kwargs, connection_maker): + self.kwargs = kwargs + if verbose: + print('%s attempting: "%s"' % (version, repr(kwargs))) + self.proxy = connection_maker + ##try: + ret = self.proxy.connect(kwargs) # ask the server to hook us up + ##except ImportError, e: # Pyro is trying to import pywinTypes.comerrer + ## self._raiseConnectionError(api.DatabaseError, 'Proxy cannot connect using=%s' % repr(kwargs)) + if ret is not True: + self._raiseConnectionError( + api.OperationalError, "Proxy returns error message=%s" % repr(ret) + ) + + self.supportsTransactions = self.getIndexedValue("supportsTransactions") + self.paramstyle = self.getIndexedValue("paramstyle") + self.timeout = self.getIndexedValue("timeout") + if verbose: + print("adodbapi.remote New connection at %X" % id(self)) + + def _raiseConnectionError(self, errorclass, errorvalue): + eh = self.errorhandler + if eh is None: + eh = api.standardErrorHandler + eh(self, None, errorclass, errorvalue) + + def close(self): + """Close the connection now (rather than whenever __del__ is called). + + The connection will be unusable from this point forward; + an Error (or subclass) exception will be raised if any operation is attempted with the connection. + The same applies to all cursor objects trying to use the connection. + """ + for crsr in list(self.cursors.values())[ + : + ]: # copy the list, then close each one + crsr.close() + try: + """close the underlying remote Connection object""" + self.proxy.close() + if verbose: + print("adodbapi.remote Closed connection at %X" % id(self)) + object.__delattr__( + self, "proxy" + ) # future attempts to use closed cursor will be caught by __getattr__ + except Exception: + pass + + def __del__(self): + try: + self.proxy.close() + except: + pass + + def commit(self): + """Commit any pending transaction to the database. + + Note that if the database supports an auto-commit feature, + this must be initially off. An interface method may be provided to turn it back on. + Database modules that do not support transactions should implement this method with void functionality. + """ + if not self.supportsTransactions: + return + result = self.proxy.commit() + if result: + self._raiseConnectionError( + api.OperationalError, "Error during commit: %s" % result + ) + + def _rollback(self): + """In case a database does provide transactions this method causes the the database to roll back to + the start of any pending transaction. Closing a connection without committing the changes first will + cause an implicit rollback to be performed. + """ + result = self.proxy.rollback() + if result: + self._raiseConnectionError( + api.OperationalError, "Error during rollback: %s" % result + ) + + def __setattr__(self, name, value): + if name in ("paramstyle", "timeout", "autocommit"): + if self.proxy: + self.proxy.send_attribute_to_host(name, value) + object.__setattr__(self, name, value) # store attribute locally (too) + + def __getattr__(self, item): + if ( + item == "rollback" + ): # the rollback method only appears if the database supports transactions + if self.supportsTransactions: + return ( + self._rollback + ) # return the rollback method so the caller can execute it. + else: + raise self.ProgrammingError( + "this data provider does not support Rollback" + ) + elif item in ( + "dbms_name", + "dbms_version", + "connection_string", + "autocommit", + ): # 'messages' ): + return self.getIndexedValue(item) + elif item == "proxy": + raise self.ProgrammingError("Attempting to use closed connection") + else: + raise self.ProgrammingError('No remote access for attribute="%s"' % item) + + def getIndexedValue(self, index): + r = self.proxy.get_attribute_for_remote(index) + return r + + def cursor(self): + "Return a new Cursor Object using the connection." + myCursor = Cursor(self) + return myCursor + + def _i_am_here(self, crsr): + "message from a new cursor proclaiming its existence" + self.cursors[crsr.id] = crsr + + def _i_am_closing(self, crsr): + "message from a cursor giving connection a chance to clean up" + try: + del self.cursors[crsr.id] + except: + pass + + def __enter__(self): # Connections are context managers + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + if exc_type: + self._rollback() # automatic rollback on errors + else: + self.commit() + + def get_table_names(self): + return self.proxy.get_table_names() + + +def fixpickle(x): + """pickle barfs on buffer(x) so we pass as array.array(x) then restore to original form for .execute()""" + if x is None: + return None + if isinstance(x, dict): + # for 'named' paramstyle user will pass a mapping + newargs = {} + for arg, val in list(x.items()): + if isinstance(val, memoryViewType): + newval = array.array("B") + newval.fromstring(val) + newargs[arg] = newval + else: + newargs[arg] = val + return newargs + # if not a mapping, then a sequence + newargs = [] + for arg in x: + if isinstance(arg, memoryViewType): + newarg = array.array("B") + newarg.fromstring(arg) + newargs.append(newarg) + else: + newargs.append(arg) + return newargs + + +class Cursor(object): + def __init__(self, connection): + self.command = None + self.errorhandler = None ## was: connection.errorhandler + self.connection = connection + self.proxy = self.connection.proxy + self.rs = None # the fetchable data for this cursor + self.converters = NotImplemented + self.id = connection.proxy.build_cursor() + connection._i_am_here(self) + self.recordset_format = api.RS_REMOTE + if verbose: + print( + "%s New cursor at %X on conn %X" + % (version, id(self), id(self.connection)) + ) + + def prepare(self, operation): + self.command = operation + try: + del self.description + except AttributeError: + pass + self.proxy.crsr_prepare(self.id, operation) + + def __iter__(self): # [2.1 Zamarev] + return iter(self.fetchone, None) # [2.1 Zamarev] + + def __next__(self): + r = self.fetchone() + if r: + return r + raise StopIteration + + def __enter__(self): + "Allow database cursors to be used with context managers." + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + "Allow database cursors to be used with context managers." + self.close() + + def __getattr__(self, key): + if key == "numberOfColumns": + try: + return len(self.rs[0]) + except: + return 0 + if key == "description": + try: + self.description = self.proxy.crsr_get_description(self.id)[:] + return self.description + except TypeError: + return None + if key == "columnNames": + try: + r = dict( + self.proxy.crsr_get_columnNames(self.id) + ) # copy the remote columns + + except TypeError: + r = {} + self.columnNames = r + return r + + if key == "remote_cursor": + raise api.OperationalError + try: + return self.proxy.crsr_get_attribute_for_remote(self.id, key) + except AttributeError: + raise api.InternalError( + 'Failure getting attribute "%s" from proxy cursor.' % key + ) + + def __setattr__(self, key, value): + if key == "arraysize": + self.proxy.crsr_set_arraysize(self.id, value) + if key == "paramstyle": + if value in api.accepted_paramstyles: + self.proxy.crsr_set_paramstyle(self.id, value) + else: + self._raiseCursorError( + api.ProgrammingError, 'invalid paramstyle ="%s"' % value + ) + object.__setattr__(self, key, value) + + def _raiseCursorError(self, errorclass, errorvalue): + eh = self.errorhandler + if eh is None: + eh = api.standardErrorHandler + eh(self.connection, self, errorclass, errorvalue) + + def execute(self, operation, parameters=None): + if self.connection is None: + self._raiseCursorError( + ProgrammingError, "Attempted operation on closed cursor" + ) + self.command = operation + try: + del self.description + except AttributeError: + pass + try: + del self.columnNames + except AttributeError: + pass + fp = fixpickle(parameters) + if verbose > 2: + print( + ( + '%s executing "%s" with params=%s' + % (version, operation, repr(parameters)) + ) + ) + result = self.proxy.crsr_execute(self.id, operation, fp) + if result: # an exception was triggered + self._raiseCursorError(result[0], result[1]) + + def executemany(self, operation, seq_of_parameters): + if self.connection is None: + self._raiseCursorError( + ProgrammingError, "Attempted operation on closed cursor" + ) + self.command = operation + try: + del self.description + except AttributeError: + pass + try: + del self.columnNames + except AttributeError: + pass + sq = [fixpickle(x) for x in seq_of_parameters] + if verbose > 2: + print( + ( + '%s executemany "%s" with params=%s' + % (version, operation, repr(seq_of_parameters)) + ) + ) + self.proxy.crsr_executemany(self.id, operation, sq) + + def nextset(self): + try: + del self.description + except AttributeError: + pass + try: + del self.columnNames + except AttributeError: + pass + if verbose > 2: + print(("%s nextset" % version)) + return self.proxy.crsr_nextset(self.id) + + def callproc(self, procname, parameters=None): + if self.connection is None: + self._raiseCursorError( + ProgrammingError, "Attempted operation on closed cursor" + ) + self.command = procname + try: + del self.description + except AttributeError: + pass + try: + del self.columnNames + except AttributeError: + pass + fp = fixpickle(parameters) + if verbose > 2: + print( + ( + '%s callproc "%s" with params=%s' + % (version, procname, repr(parameters)) + ) + ) + return self.proxy.crsr_callproc(self.id, procname, fp) + + def fetchone(self): + try: + f1 = self.proxy.crsr_fetchone(self.id) + except _BaseException as e: + self._raiseCursorError(api.DatabaseError, e) + else: + if f1 is None: + return None + self.rs = [f1] + return api.SQLrows(self.rs, 1, self)[ + 0 + ] # new object to hold the results of the fetch + + def fetchmany(self, size=None): + try: + self.rs = self.proxy.crsr_fetchmany(self.id, size) + if not self.rs: + return [] + r = api.SQLrows(self.rs, len(self.rs), self) + return r + except Exception as e: + self._raiseCursorError(api.DatabaseError, e) + + def fetchall(self): + try: + self.rs = self.proxy.crsr_fetchall(self.id) + if not self.rs: + return [] + return api.SQLrows(self.rs, len(self.rs), self) + except Exception as e: + self._raiseCursorError(api.DatabaseError, e) + + def close(self): + if self.connection is None: + return + self.connection._i_am_closing(self) # take me off the connection's cursors list + try: + self.proxy.crsr_close(self.id) + except: + pass + try: + del self.description + except: + pass + try: + del self.rs # let go of the recordset + except: + pass + self.connection = ( + None # this will make all future method calls on me throw an exception + ) + self.proxy = None + if verbose: + print("adodbapi.remote Closed cursor at %X" % id(self)) + + def __del__(self): + try: + self.close() + except: + pass + + def setinputsizes(self, sizes): + pass + + def setoutputsize(self, size, column=None): + pass diff --git a/lib/adodbapi/schema_table.py b/lib/adodbapi/schema_table.py new file mode 100644 index 00000000..8621830e --- /dev/null +++ b/lib/adodbapi/schema_table.py @@ -0,0 +1,15 @@ +"""call using an open ADO connection --> list of table names""" +from . import adodbapi + + +def names(connection_object): + ado = connection_object.adoConn + schema = ado.OpenSchema(20) # constant = adSchemaTables + + tables = [] + while not schema.EOF: + name = adodbapi.getIndexedValue(schema.Fields, "TABLE_NAME").Value + tables.append(name) + schema.MoveNext() + del schema + return tables diff --git a/lib/adodbapi/setup.py b/lib/adodbapi/setup.py new file mode 100644 index 00000000..d25869ad --- /dev/null +++ b/lib/adodbapi/setup.py @@ -0,0 +1,70 @@ +"""adodbapi -- a pure Python PEP 249 DB-API package using Microsoft ADO + +Adodbapi can be run on CPython 3.5 and later. +or IronPython version 2.6 and later (in theory, possibly no longer in practice!) +""" +CLASSIFIERS = """\ +Development Status :: 5 - Production/Stable +Intended Audience :: Developers +License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL) +Operating System :: Microsoft :: Windows +Operating System :: POSIX :: Linux +Programming Language :: Python +Programming Language :: Python :: 3 +Programming Language :: SQL +Topic :: Software Development +Topic :: Software Development :: Libraries :: Python Modules +Topic :: Database +""" + +NAME = "adodbapi" +MAINTAINER = "Vernon Cole" +MAINTAINER_EMAIL = "vernondcole@gmail.com" +DESCRIPTION = ( + """A pure Python package implementing PEP 249 DB-API using Microsoft ADO.""" +) +URL = "http://sourceforge.net/projects/adodbapi" +LICENSE = "LGPL" +CLASSIFIERS = filter(None, CLASSIFIERS.split("\n")) +AUTHOR = "Henrik Ekelund, Vernon Cole, et.al." +AUTHOR_EMAIL = "vernondcole@gmail.com" +PLATFORMS = ["Windows", "Linux"] + +VERSION = None # in case searching for version fails +a = open("adodbapi.py") # find the version string in the source code +for line in a: + if "__version__" in line: + VERSION = line.split("'")[1] + print('adodbapi version="%s"' % VERSION) + break +a.close() + + +def setup_package(): + from distutils.command.build_py import build_py + from distutils.core import setup + + setup( + cmdclass={"build_py": build_py}, + name=NAME, + maintainer=MAINTAINER, + maintainer_email=MAINTAINER_EMAIL, + description=DESCRIPTION, + url=URL, + keywords="database ado odbc dbapi db-api Microsoft SQL", + ## download_url=DOWNLOAD_URL, + long_description=open("README.txt").read(), + license=LICENSE, + classifiers=CLASSIFIERS, + author=AUTHOR, + author_email=AUTHOR_EMAIL, + platforms=PLATFORMS, + version=VERSION, + package_dir={"adodbapi": ""}, + packages=["adodbapi"], + ) + return + + +if __name__ == "__main__": + setup_package() diff --git a/lib/adodbapi/test/adodbapitest.py b/lib/adodbapi/test/adodbapitest.py new file mode 100644 index 00000000..e5b3dc19 --- /dev/null +++ b/lib/adodbapi/test/adodbapitest.py @@ -0,0 +1,1692 @@ +""" Unit tests version 2.6.1.0 for adodbapi""" +""" + adodbapi - A python DB API 2.0 interface to Microsoft ADO + + Copyright (C) 2002 Henrik Ekelund + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this library; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + Updates by Vernon Cole +""" + +import copy +import datetime +import decimal +import random +import string +import sys +import unittest + +try: + import win32com.client + + win32 = True +except ImportError: + win32 = False + +# run the configuration module. +import adodbapitestconfig as config # will set sys.path to find correct version of adodbapi + +# in our code below, all our switches are from config.whatever +import tryconnection + +import adodbapi +import adodbapi.apibase as api + +try: + import adodbapi.ado_consts as ado_consts +except ImportError: # we are doing a shortcut import as a module -- so + try: + import ado_consts + except ImportError: + from adodbapi import ado_consts + + +def str2bytes(sval): + return sval.encode("latin1") + + +long = int + + +def randomstring(length): + return "".join([random.choice(string.ascii_letters) for n in range(32)]) + + +class CommonDBTests(unittest.TestCase): + "Self contained super-simple tests in easy syntax, should work on everything between mySQL and Oracle" + + def setUp(self): + self.engine = "unknown" + + def getEngine(self): + return self.engine + + def getConnection(self): + raise NotImplementedError # "This method must be overriden by a subclass" + + def getCursor(self): + return self.getConnection().cursor() + + def testConnection(self): + crsr = self.getCursor() + assert crsr.__class__.__name__ == "Cursor" + + def testErrorHandlerInherits(self): + if not self.remote: + conn = self.getConnection() + mycallable = lambda connection, cursor, errorclass, errorvalue: 1 + conn.errorhandler = mycallable + crsr = conn.cursor() + assert ( + crsr.errorhandler == mycallable + ), "Error handler on crsr should be same as on connection" + + def testDefaultErrorHandlerConnection(self): + if not self.remote: + conn = self.getConnection() + del conn.messages[:] + try: + conn.close() + conn.commit() # Should not be able to use connection after it is closed + except: + assert len(conn.messages) == 1 + assert len(conn.messages[0]) == 2 + assert conn.messages[0][0] == api.ProgrammingError + + def testOwnErrorHandlerConnection(self): + if self.remote: # ToDo: use "skip" + return + mycallable = ( + lambda connection, cursor, errorclass, errorvalue: 1 + ) # does not raise anything + conn = self.getConnection() + conn.errorhandler = mycallable + conn.close() + conn.commit() # Should not be able to use connection after it is closed + assert len(conn.messages) == 0 + + conn.errorhandler = None # This should bring back the standard error handler + try: + conn.close() + conn.commit() # Should not be able to use connection after it is closed + except: + pass + # The Standard errorhandler appends error to messages attribute + assert ( + len(conn.messages) > 0 + ), "Setting errorhandler to none should bring back the standard error handler" + + def testDefaultErrorHandlerCursor(self): + crsr = self.getConnection().cursor() + if not self.remote: + del crsr.messages[:] + try: + crsr.execute("SELECT abbtytddrf FROM dasdasd") + except: + assert len(crsr.messages) == 1 + assert len(crsr.messages[0]) == 2 + assert crsr.messages[0][0] == api.DatabaseError + + def testOwnErrorHandlerCursor(self): + if self.remote: # ToDo: should be a "skip" + return + mycallable = ( + lambda connection, cursor, errorclass, errorvalue: 1 + ) # does not raise anything + crsr = self.getConnection().cursor() + crsr.errorhandler = mycallable + crsr.execute("SELECT abbtytddrf FROM dasdasd") + assert len(crsr.messages) == 0 + + crsr.errorhandler = None # This should bring back the standard error handler + try: + crsr.execute("SELECT abbtytddrf FROM dasdasd") + except: + pass + # The Standard errorhandler appends error to messages attribute + assert ( + len(crsr.messages) > 0 + ), "Setting errorhandler to none should bring back the standard error handler" + + def testUserDefinedConversions(self): + if self.remote: ## Todo: should be a "skip" + return + try: + duplicatingConverter = lambda aStringField: aStringField * 2 + assert duplicatingConverter("gabba") == "gabbagabba" + + self.helpForceDropOnTblTemp() + conn = self.getConnection() + # the variantConversions attribute should not exist on a normal connection object + self.assertRaises(AttributeError, lambda x: conn.variantConversions[x], [2]) + if not self.remote: + # create a variantConversions attribute on the connection + conn.variantConversions = copy.copy(api.variantConversions) + crsr = conn.cursor() + tabdef = ( + "CREATE TABLE xx_%s (fldData VARCHAR(100) NOT NULL, fld2 VARCHAR(20))" + % config.tmp + ) + crsr.execute(tabdef) + crsr.execute( + "INSERT INTO xx_%s(fldData,fld2) VALUES('gabba','booga')" + % config.tmp + ) + crsr.execute( + "INSERT INTO xx_%s(fldData,fld2) VALUES('hey','yo')" % config.tmp + ) + # change converter for ALL adoStringTypes columns + conn.variantConversions[api.adoStringTypes] = duplicatingConverter + crsr.execute( + "SELECT fldData,fld2 FROM xx_%s ORDER BY fldData" % config.tmp + ) + + rows = crsr.fetchall() + row = rows[0] + self.assertEqual(row[0], "gabbagabba") + row = rows[1] + self.assertEqual(row[0], "heyhey") + self.assertEqual(row[1], "yoyo") + + upcaseConverter = lambda aStringField: aStringField.upper() + assert upcaseConverter("upThis") == "UPTHIS" + + # now use a single column converter + rows.converters[1] = upcaseConverter # convert second column + self.assertEqual(row[0], "heyhey") # first will be unchanged + self.assertEqual(row[1], "YO") # second will convert to upper case + + finally: + try: + del conn.variantConversions # Restore the default + except: + pass + self.helpRollbackTblTemp() + + def testUserDefinedConversionForExactNumericTypes(self): + # variantConversions is a dictionary of conversion functions + # held internally in adodbapi.apibase + # + # !!! this test intentionally alters the value of what should be constant in the module + # !!! no new code should use this example, to is only a test to see that the + # !!! deprecated way of doing this still works. (use connection.variantConversions) + # + if not self.remote and sys.version_info < (3, 0): ### Py3 need different test + oldconverter = adodbapi.variantConversions[ + ado_consts.adNumeric + ] # keep old function to restore later + # By default decimal and "numbers" are returned as decimals. + # Instead, make numbers return as floats + try: + adodbapi.variantConversions[ado_consts.adNumeric] = adodbapi.cvtFloat + self.helpTestDataType( + "decimal(18,2)", "NUMBER", 3.45, compareAlmostEqual=1 + ) + self.helpTestDataType( + "numeric(18,2)", "NUMBER", 3.45, compareAlmostEqual=1 + ) + # now return strings + adodbapi.variantConversions[ado_consts.adNumeric] = adodbapi.cvtString + self.helpTestDataType("numeric(18,2)", "NUMBER", "3.45") + # now a completly weird user defined convertion + adodbapi.variantConversions[ado_consts.adNumeric] = ( + lambda x: "!!This function returns a funny unicode string %s!!" % x + ) + self.helpTestDataType( + "numeric(18,2)", + "NUMBER", + "3.45", + allowedReturnValues=[ + "!!This function returns a funny unicode string 3.45!!" + ], + ) + finally: + # now reset the converter to its original function + adodbapi.variantConversions[ + ado_consts.adNumeric + ] = oldconverter # Restore the original convertion function + + def helpTestDataType( + self, + sqlDataTypeString, + DBAPIDataTypeString, + pyData, + pyDataInputAlternatives=None, + compareAlmostEqual=None, + allowedReturnValues=None, + ): + self.helpForceDropOnTblTemp() + conn = self.getConnection() + crsr = conn.cursor() + tabdef = ( + """ + CREATE TABLE xx_%s ( + fldId integer NOT NULL, + fldData """ + % config.tmp + + sqlDataTypeString + + ")\n" + ) + + crsr.execute(tabdef) + + # Test Null values mapped to None + crsr.execute("INSERT INTO xx_%s (fldId) VALUES (1)" % config.tmp) + + crsr.execute("SELECT fldId,fldData FROM xx_%s" % config.tmp) + rs = crsr.fetchone() + self.assertEqual(rs[1], None) # Null should be mapped to None + assert rs[0] == 1 + + # Test description related + descTuple = crsr.description[1] + assert descTuple[0] in ["fldData", "flddata"], 'was "%s" expected "%s"' % ( + descTuple[0], + "fldData", + ) + + if DBAPIDataTypeString == "STRING": + assert descTuple[1] == api.STRING, 'was "%s" expected "%s"' % ( + descTuple[1], + api.STRING.values, + ) + elif DBAPIDataTypeString == "NUMBER": + assert descTuple[1] == api.NUMBER, 'was "%s" expected "%s"' % ( + descTuple[1], + api.NUMBER.values, + ) + elif DBAPIDataTypeString == "BINARY": + assert descTuple[1] == api.BINARY, 'was "%s" expected "%s"' % ( + descTuple[1], + api.BINARY.values, + ) + elif DBAPIDataTypeString == "DATETIME": + assert descTuple[1] == api.DATETIME, 'was "%s" expected "%s"' % ( + descTuple[1], + api.DATETIME.values, + ) + elif DBAPIDataTypeString == "ROWID": + assert descTuple[1] == api.ROWID, 'was "%s" expected "%s"' % ( + descTuple[1], + api.ROWID.values, + ) + elif DBAPIDataTypeString == "UUID": + assert descTuple[1] == api.OTHER, 'was "%s" expected "%s"' % ( + descTuple[1], + api.OTHER.values, + ) + else: + raise NotImplementedError # "DBAPIDataTypeString not provided" + + # Test data binding + inputs = [pyData] + if pyDataInputAlternatives: + inputs.extend(pyDataInputAlternatives) + inputs = set(inputs) # removes redundant string==unicode tests + fldId = 1 + for inParam in inputs: + fldId += 1 + try: + crsr.execute( + "INSERT INTO xx_%s (fldId,fldData) VALUES (?,?)" % config.tmp, + (fldId, inParam), + ) + except: + if self.remote: + for message in crsr.messages: + print(message) + else: + conn.printADOerrors() + raise + crsr.execute( + "SELECT fldData FROM xx_%s WHERE ?=fldID" % config.tmp, [fldId] + ) + rs = crsr.fetchone() + if allowedReturnValues: + allowedTypes = tuple([type(aRV) for aRV in allowedReturnValues]) + assert isinstance( + rs[0], allowedTypes + ), 'result type "%s" must be one of %s' % (type(rs[0]), allowedTypes) + else: + assert isinstance( + rs[0], type(pyData) + ), 'result type "%s" must be instance of %s' % ( + type(rs[0]), + type(pyData), + ) + + if compareAlmostEqual and DBAPIDataTypeString == "DATETIME": + iso1 = adodbapi.dateconverter.DateObjectToIsoFormatString(rs[0]) + iso2 = adodbapi.dateconverter.DateObjectToIsoFormatString(pyData) + self.assertEqual(iso1, iso2) + elif compareAlmostEqual: + s = float(pyData) + v = float(rs[0]) + assert ( + abs(v - s) / s < 0.00001 + ), "Values not almost equal recvd=%s, expected=%f" % (rs[0], s) + else: + if allowedReturnValues: + ok = False + self.assertTrue( + rs[0] in allowedReturnValues, + 'Value "%s" not in %s' % (repr(rs[0]), allowedReturnValues), + ) + else: + self.assertEqual( + rs[0], + pyData, + 'Values are not equal recvd="%s", expected="%s"' + % (rs[0], pyData), + ) + + def testDataTypeFloat(self): + self.helpTestDataType("real", "NUMBER", 3.45, compareAlmostEqual=True) + self.helpTestDataType("float", "NUMBER", 1.79e37, compareAlmostEqual=True) + + def testDataTypeDecmal(self): + self.helpTestDataType( + "decimal(18,2)", + "NUMBER", + 3.45, + allowedReturnValues=["3.45", "3,45", decimal.Decimal("3.45")], + ) + self.helpTestDataType( + "numeric(18,2)", + "NUMBER", + 3.45, + allowedReturnValues=["3.45", "3,45", decimal.Decimal("3.45")], + ) + self.helpTestDataType( + "decimal(20,2)", + "NUMBER", + 444444444444444444, + allowedReturnValues=[ + "444444444444444444.00", + "444444444444444444,00", + decimal.Decimal("444444444444444444"), + ], + ) + if self.getEngine() == "MSSQL": + self.helpTestDataType( + "uniqueidentifier", + "UUID", + "{71A4F49E-39F3-42B1-A41E-48FF154996E6}", + allowedReturnValues=["{71A4F49E-39F3-42B1-A41E-48FF154996E6}"], + ) + + def testDataTypeMoney(self): # v2.1 Cole -- use decimal for money + if self.getEngine() == "MySQL": + self.helpTestDataType( + "DECIMAL(20,4)", "NUMBER", decimal.Decimal("-922337203685477.5808") + ) + elif self.getEngine() == "PostgreSQL": + self.helpTestDataType( + "money", + "NUMBER", + decimal.Decimal("-922337203685477.5808"), + compareAlmostEqual=True, + allowedReturnValues=[ + -922337203685477.5808, + decimal.Decimal("-922337203685477.5808"), + ], + ) + else: + self.helpTestDataType("smallmoney", "NUMBER", decimal.Decimal("214748.02")) + self.helpTestDataType( + "money", "NUMBER", decimal.Decimal("-922337203685477.5808") + ) + + def testDataTypeInt(self): + if self.getEngine() != "PostgreSQL": + self.helpTestDataType("tinyint", "NUMBER", 115) + self.helpTestDataType("smallint", "NUMBER", -32768) + if self.getEngine() not in ["ACCESS", "PostgreSQL"]: + self.helpTestDataType( + "bit", "NUMBER", 1 + ) # Does not work correctly with access + if self.getEngine() in ["MSSQL", "PostgreSQL"]: + self.helpTestDataType( + "bigint", + "NUMBER", + 3000000000, + allowedReturnValues=[3000000000, int(3000000000)], + ) + self.helpTestDataType("int", "NUMBER", 2147483647) + + def testDataTypeChar(self): + for sqlDataType in ("char(6)", "nchar(6)"): + self.helpTestDataType( + sqlDataType, + "STRING", + "spam ", + allowedReturnValues=["spam", "spam", "spam ", "spam "], + ) + + def testDataTypeVarChar(self): + if self.getEngine() == "MySQL": + stringKinds = ["varchar(10)", "text"] + elif self.getEngine() == "PostgreSQL": + stringKinds = ["varchar(10)", "text", "character varying"] + else: + stringKinds = [ + "varchar(10)", + "nvarchar(10)", + "text", + "ntext", + ] # ,"varchar(max)"] + + for sqlDataType in stringKinds: + self.helpTestDataType(sqlDataType, "STRING", "spam", ["spam"]) + + def testDataTypeDate(self): + if self.getEngine() == "PostgreSQL": + dt = "timestamp" + else: + dt = "datetime" + self.helpTestDataType( + dt, "DATETIME", adodbapi.Date(2002, 10, 28), compareAlmostEqual=True + ) + if self.getEngine() not in ["MySQL", "PostgreSQL"]: + self.helpTestDataType( + "smalldatetime", + "DATETIME", + adodbapi.Date(2002, 10, 28), + compareAlmostEqual=True, + ) + if tag != "pythontime" and self.getEngine() not in [ + "MySQL", + "PostgreSQL", + ]: # fails when using pythonTime + self.helpTestDataType( + dt, + "DATETIME", + adodbapi.Timestamp(2002, 10, 28, 12, 15, 1), + compareAlmostEqual=True, + ) + + def testDataTypeBinary(self): + binfld = str2bytes("\x07\x00\xE2\x40*") + arv = [binfld, adodbapi.Binary(binfld), bytes(binfld)] + if self.getEngine() == "PostgreSQL": + self.helpTestDataType( + "bytea", "BINARY", adodbapi.Binary(binfld), allowedReturnValues=arv + ) + else: + self.helpTestDataType( + "binary(5)", "BINARY", adodbapi.Binary(binfld), allowedReturnValues=arv + ) + self.helpTestDataType( + "varbinary(100)", + "BINARY", + adodbapi.Binary(binfld), + allowedReturnValues=arv, + ) + if self.getEngine() != "MySQL": + self.helpTestDataType( + "image", "BINARY", adodbapi.Binary(binfld), allowedReturnValues=arv + ) + + def helpRollbackTblTemp(self): + self.helpForceDropOnTblTemp() + + def helpForceDropOnTblTemp(self): + conn = self.getConnection() + with conn.cursor() as crsr: + try: + crsr.execute("DROP TABLE xx_%s" % config.tmp) + if not conn.autocommit: + conn.commit() + except: + pass + + def helpCreateAndPopulateTableTemp(self, crsr): + tabdef = ( + """ + CREATE TABLE xx_%s ( + fldData INTEGER + ) + """ + % config.tmp + ) + try: # EAFP + crsr.execute(tabdef) + except api.DatabaseError: # was not dropped before + self.helpForceDropOnTblTemp() # so drop it now + crsr.execute(tabdef) + for i in range(9): # note: this poor SQL code, but a valid test + crsr.execute("INSERT INTO xx_%s (fldData) VALUES (%i)" % (config.tmp, i)) + # NOTE: building the test table without using parameter substitution + + def testFetchAll(self): + crsr = self.getCursor() + self.helpCreateAndPopulateTableTemp(crsr) + crsr.execute("SELECT fldData FROM xx_%s" % config.tmp) + rs = crsr.fetchall() + assert len(rs) == 9 + # test slice of rows + i = 3 + for row in rs[3:-2]: # should have rowid 3..6 + assert row[0] == i + i += 1 + self.helpRollbackTblTemp() + + def testPreparedStatement(self): + crsr = self.getCursor() + self.helpCreateAndPopulateTableTemp(crsr) + crsr.prepare("SELECT fldData FROM xx_%s" % config.tmp) + crsr.execute(crsr.command) # remember the one that was prepared + rs = crsr.fetchall() + assert len(rs) == 9 + assert rs[2][0] == 2 + self.helpRollbackTblTemp() + + def testWrongPreparedStatement(self): + crsr = self.getCursor() + self.helpCreateAndPopulateTableTemp(crsr) + crsr.prepare("SELECT * FROM nowhere") + crsr.execute( + "SELECT fldData FROM xx_%s" % config.tmp + ) # should execute this one, not the prepared one + rs = crsr.fetchall() + assert len(rs) == 9 + assert rs[2][0] == 2 + self.helpRollbackTblTemp() + + def testIterator(self): + crsr = self.getCursor() + self.helpCreateAndPopulateTableTemp(crsr) + crsr.execute("SELECT fldData FROM xx_%s" % config.tmp) + for i, row in enumerate( + crsr + ): # using cursor as an iterator, rather than fetchxxx + assert row[0] == i + self.helpRollbackTblTemp() + + def testExecuteMany(self): + crsr = self.getCursor() + self.helpCreateAndPopulateTableTemp(crsr) + seq_of_values = [(111,), (222,)] + crsr.executemany( + "INSERT INTO xx_%s (fldData) VALUES (?)" % config.tmp, seq_of_values + ) + if crsr.rowcount == -1: + print( + self.getEngine() + + " Provider does not support rowcount (on .executemany())" + ) + else: + self.assertEqual(crsr.rowcount, 2) + crsr.execute("SELECT fldData FROM xx_%s" % config.tmp) + rs = crsr.fetchall() + assert len(rs) == 11 + self.helpRollbackTblTemp() + + def testRowCount(self): + crsr = self.getCursor() + self.helpCreateAndPopulateTableTemp(crsr) + crsr.execute("SELECT fldData FROM xx_%s" % config.tmp) + if crsr.rowcount == -1: + # print("provider does not support rowcount on select") + pass + else: + self.assertEqual(crsr.rowcount, 9) + self.helpRollbackTblTemp() + + def testRowCountNoRecordset(self): + crsr = self.getCursor() + self.helpCreateAndPopulateTableTemp(crsr) + crsr.execute("DELETE FROM xx_%s WHERE fldData >= 5" % config.tmp) + if crsr.rowcount == -1: + print(self.getEngine() + " Provider does not support rowcount (on DELETE)") + else: + self.assertEqual(crsr.rowcount, 4) + self.helpRollbackTblTemp() + + def testFetchMany(self): + crsr = self.getCursor() + self.helpCreateAndPopulateTableTemp(crsr) + crsr.execute("SELECT fldData FROM xx_%s" % config.tmp) + rs = crsr.fetchmany(3) + assert len(rs) == 3 + rs = crsr.fetchmany(5) + assert len(rs) == 5 + rs = crsr.fetchmany(5) + assert len(rs) == 1 # Asked for five, but there is only one left + self.helpRollbackTblTemp() + + def testFetchManyWithArraySize(self): + crsr = self.getCursor() + self.helpCreateAndPopulateTableTemp(crsr) + crsr.execute("SELECT fldData FROM xx_%s" % config.tmp) + rs = crsr.fetchmany() + assert len(rs) == 1 # arraysize Defaults to one + crsr.arraysize = 4 + rs = crsr.fetchmany() + assert len(rs) == 4 + rs = crsr.fetchmany() + assert len(rs) == 4 + rs = crsr.fetchmany() + assert len(rs) == 0 + self.helpRollbackTblTemp() + + def testErrorConnect(self): + conn = self.getConnection() + kw = {} + if "proxy_host" in conn.kwargs: + kw["proxy_host"] = conn.kwargs["proxy_host"] + conn.close() + self.assertRaises(api.DatabaseError, self.db, "not a valid connect string", kw) + + def testRowIterator(self): + self.helpForceDropOnTblTemp() + conn = self.getConnection() + crsr = conn.cursor() + tabdef = ( + """ + CREATE TABLE xx_%s ( + fldId integer NOT NULL, + fldTwo integer, + fldThree integer, + fldFour integer) + """ + % config.tmp + ) + crsr.execute(tabdef) + + inputs = [(2, 3, 4), (102, 103, 104)] + fldId = 1 + for inParam in inputs: + fldId += 1 + try: + crsr.execute( + "INSERT INTO xx_%s (fldId,fldTwo,fldThree,fldFour) VALUES (?,?,?,?)" + % config.tmp, + (fldId, inParam[0], inParam[1], inParam[2]), + ) + except: + if self.remote: + for message in crsr.messages: + print(message) + else: + conn.printADOerrors() + raise + crsr.execute( + "SELECT fldTwo,fldThree,fldFour FROM xx_%s WHERE ?=fldID" % config.tmp, + [fldId], + ) + rec = crsr.fetchone() + # check that stepping through an emulated row works + for j in range(len(inParam)): + assert ( + rec[j] == inParam[j] + ), 'returned value:"%s" != test value:"%s"' % (rec[j], inParam[j]) + # check that we can get a complete tuple from a row + assert tuple(rec) == inParam, 'returned value:"%s" != test value:"%s"' % ( + repr(rec), + repr(inParam), + ) + # test that slices of rows work + slice1 = tuple(rec[:-1]) + slice2 = tuple(inParam[0:2]) + assert slice1 == slice2, 'returned value:"%s" != test value:"%s"' % ( + repr(slice1), + repr(slice2), + ) + # now test named column retrieval + assert rec["fldTwo"] == inParam[0] + assert rec.fldThree == inParam[1] + assert rec.fldFour == inParam[2] + # test array operation + # note that the fields vv vv vv are out of order + crsr.execute("select fldThree,fldFour,fldTwo from xx_%s" % config.tmp) + recs = crsr.fetchall() + assert recs[1][0] == 103 + assert recs[0][1] == 4 + assert recs[1]["fldFour"] == 104 + assert recs[0, 0] == 3 + assert recs[0, "fldTwo"] == 2 + assert recs[1, 2] == 102 + for i in range(1): + for j in range(2): + assert recs[i][j] == recs[i, j] + + def testFormatParamstyle(self): + self.helpForceDropOnTblTemp() + conn = self.getConnection() + conn.paramstyle = "format" # test nonstandard use of paramstyle + crsr = conn.cursor() + tabdef = ( + """ + CREATE TABLE xx_%s ( + fldId integer NOT NULL, + fldData varchar(10), + fldConst varchar(30)) + """ + % config.tmp + ) + crsr.execute(tabdef) + + inputs = ["one", "two", "three"] + fldId = 2 + for inParam in inputs: + fldId += 1 + sql = ( + "INSERT INTO xx_" + + config.tmp + + " (fldId,fldConst,fldData) VALUES (%s,'thi%s :may cause? trouble', %s)" + ) + try: + crsr.execute(sql, (fldId, inParam)) + except: + if self.remote: + for message in crsr.messages: + print(message) + else: + conn.printADOerrors() + raise + crsr.execute( + "SELECT fldData, fldConst FROM xx_" + config.tmp + " WHERE %s=fldID", + [fldId], + ) + rec = crsr.fetchone() + self.assertEqual( + rec[0], + inParam, + 'returned value:"%s" != test value:"%s"' % (rec[0], inParam), + ) + self.assertEqual(rec[1], "thi%s :may cause? trouble") + + # now try an operation with a "%s" as part of a literal + sel = ( + "insert into xx_" + config.tmp + " (fldId,fldData) VALUES (%s,'four%sfive')" + ) + params = (20,) + crsr.execute(sel, params) + + # test the .query implementation + assert "(?," in crsr.query, 'expected:"%s" in "%s"' % ("(?,", crsr.query) + # test the .command attribute + assert crsr.command == sel, 'expected:"%s" but found "%s"' % (sel, crsr.command) + + # test the .parameters attribute + if not self.remote: # parameter list will be altered in transit + self.assertEqual(crsr.parameters, params) + # now make sure the data made it + crsr.execute("SELECT fldData FROM xx_%s WHERE fldID=20" % config.tmp) + rec = crsr.fetchone() + self.assertEqual(rec[0], "four%sfive") + + def testNamedParamstyle(self): + self.helpForceDropOnTblTemp() + conn = self.getConnection() + crsr = conn.cursor() + crsr.paramstyle = "named" # test nonstandard use of paramstyle + tabdef = ( + """ + CREATE TABLE xx_%s ( + fldId integer NOT NULL, + fldData varchar(10)) + """ + % config.tmp + ) + crsr.execute(tabdef) + + inputs = ["four", "five", "six"] + fldId = 10 + for inParam in inputs: + fldId += 1 + try: + crsr.execute( + "INSERT INTO xx_%s (fldId,fldData) VALUES (:Id,:f_Val)" + % config.tmp, + {"f_Val": inParam, "Id": fldId}, + ) + except: + if self.remote: + for message in crsr.messages: + print(message) + else: + conn.printADOerrors() + raise + crsr.execute( + "SELECT fldData FROM xx_%s WHERE fldID=:Id" % config.tmp, {"Id": fldId} + ) + rec = crsr.fetchone() + self.assertEqual( + rec[0], + inParam, + 'returned value:"%s" != test value:"%s"' % (rec[0], inParam), + ) + # now a test with a ":" as part of a literal + crsr.execute( + "insert into xx_%s (fldId,fldData) VALUES (:xyz,'six:five')" % config.tmp, + {"xyz": 30}, + ) + crsr.execute("SELECT fldData FROM xx_%s WHERE fldID=30" % config.tmp) + rec = crsr.fetchone() + self.assertEqual(rec[0], "six:five") + + def testPyformatParamstyle(self): + self.helpForceDropOnTblTemp() + conn = self.getConnection() + crsr = conn.cursor() + crsr.paramstyle = "pyformat" # test nonstandard use of paramstyle + tabdef = ( + """ + CREATE TABLE xx_%s ( + fldId integer NOT NULL, + fldData varchar(10)) + """ + % config.tmp + ) + crsr.execute(tabdef) + + inputs = ["four", "five", "six"] + fldId = 10 + for inParam in inputs: + fldId += 1 + try: + crsr.execute( + "INSERT INTO xx_%s (fldId,fldData) VALUES (%%(Id)s,%%(f_Val)s)" + % config.tmp, + {"f_Val": inParam, "Id": fldId}, + ) + except: + if self.remote: + for message in crsr.messages: + print(message) + else: + conn.printADOerrors() + raise + crsr.execute( + "SELECT fldData FROM xx_%s WHERE fldID=%%(Id)s" % config.tmp, + {"Id": fldId}, + ) + rec = crsr.fetchone() + self.assertEqual( + rec[0], + inParam, + 'returned value:"%s" != test value:"%s"' % (rec[0], inParam), + ) + # now a test with a "%" as part of a literal + crsr.execute( + "insert into xx_%s (fldId,fldData) VALUES (%%(xyz)s,'six%%five')" + % config.tmp, + {"xyz": 30}, + ) + crsr.execute("SELECT fldData FROM xx_%s WHERE fldID=30" % config.tmp) + rec = crsr.fetchone() + self.assertEqual(rec[0], "six%five") + + def testAutomaticParamstyle(self): + self.helpForceDropOnTblTemp() + conn = self.getConnection() + conn.paramstyle = "dynamic" # test nonstandard use of paramstyle + crsr = conn.cursor() + tabdef = ( + """ + CREATE TABLE xx_%s ( + fldId integer NOT NULL, + fldData varchar(10), + fldConst varchar(30)) + """ + % config.tmp + ) + crsr.execute(tabdef) + inputs = ["one", "two", "three"] + fldId = 2 + for inParam in inputs: + fldId += 1 + try: + crsr.execute( + "INSERT INTO xx_" + + config.tmp + + " (fldId,fldConst,fldData) VALUES (?,'thi%s :may cause? troub:1e', ?)", + (fldId, inParam), + ) + except: + if self.remote: + for message in crsr.messages: + print(message) + else: + conn.printADOerrors() + raise + trouble = "thi%s :may cause? troub:1e" + crsr.execute( + "SELECT fldData, fldConst FROM xx_" + config.tmp + " WHERE ?=fldID", + [fldId], + ) + rec = crsr.fetchone() + self.assertEqual( + rec[0], + inParam, + 'returned value:"%s" != test value:"%s"' % (rec[0], inParam), + ) + self.assertEqual(rec[1], trouble) + # inputs = [u'four',u'five',u'six'] + fldId = 10 + for inParam in inputs: + fldId += 1 + try: + crsr.execute( + "INSERT INTO xx_%s (fldId,fldData) VALUES (:Id,:f_Val)" + % config.tmp, + {"f_Val": inParam, "Id": fldId}, + ) + except: + if self.remote: + for message in crsr.messages: + print(message) + else: + conn.printADOerrors() + raise + crsr.execute( + "SELECT fldData FROM xx_%s WHERE :Id=fldID" % config.tmp, {"Id": fldId} + ) + rec = crsr.fetchone() + self.assertEqual( + rec[0], + inParam, + 'returned value:"%s" != test value:"%s"' % (rec[0], inParam), + ) + # now a test with a ":" as part of a literal -- and use a prepared query + ppdcmd = ( + "insert into xx_%s (fldId,fldData) VALUES (:xyz,'six:five')" % config.tmp + ) + crsr.prepare(ppdcmd) + crsr.execute(ppdcmd, {"xyz": 30}) + crsr.execute("SELECT fldData FROM xx_%s WHERE fldID=30" % config.tmp) + rec = crsr.fetchone() + self.assertEqual(rec[0], "six:five") + + def testRollBack(self): + conn = self.getConnection() + crsr = conn.cursor() + assert not crsr.connection.autocommit, "Unexpected beginning condition" + self.helpCreateAndPopulateTableTemp(crsr) + crsr.connection.commit() # commit the first bunch + + crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp) + + selectSql = "SELECT fldData FROM xx_%s WHERE fldData=100" % config.tmp + crsr.execute(selectSql) + rs = crsr.fetchall() + assert len(rs) == 1 + self.conn.rollback() + crsr.execute(selectSql) + assert ( + crsr.fetchone() == None + ), "cursor.fetchone should return None if a query retrieves no rows" + crsr.execute("SELECT fldData from xx_%s" % config.tmp) + rs = crsr.fetchall() + assert len(rs) == 9, "the original records should still be present" + self.helpRollbackTblTemp() + + def testCommit(self): + try: + con2 = self.getAnotherConnection() + except NotImplementedError: + return # should be "SKIP" for ACCESS + assert not con2.autocommit, "default should be manual commit" + crsr = con2.cursor() + self.helpCreateAndPopulateTableTemp(crsr) + + crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp) + con2.commit() + + selectSql = "SELECT fldData FROM xx_%s WHERE fldData=100" % config.tmp + crsr.execute(selectSql) + rs = crsr.fetchall() + assert len(rs) == 1 + crsr.close() + con2.close() + conn = self.getConnection() + crsr = self.getCursor() + with conn.cursor() as crsr: + crsr.execute(selectSql) + rs = crsr.fetchall() + assert len(rs) == 1 + assert rs[0][0] == 100 + self.helpRollbackTblTemp() + + def testAutoRollback(self): + try: + con2 = self.getAnotherConnection() + except NotImplementedError: + return # should be "SKIP" for ACCESS + assert not con2.autocommit, "unexpected beginning condition" + crsr = con2.cursor() + self.helpCreateAndPopulateTableTemp(crsr) + crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp) + selectSql = "SELECT fldData FROM xx_%s WHERE fldData=100" % config.tmp + crsr.execute(selectSql) + rs = crsr.fetchall() + assert len(rs) == 1 + crsr.close() + con2.close() + crsr = self.getCursor() + try: + crsr.execute( + selectSql + ) # closing the connection should have forced rollback + row = crsr.fetchone() + except api.DatabaseError: + row = None # if the entire table disappeared the rollback was perfect and the test passed + assert row == None, ( + "cursor.fetchone should return None if a query retrieves no rows. Got %s" + % repr(row) + ) + self.helpRollbackTblTemp() + + def testAutoCommit(self): + try: + ac_conn = self.getAnotherConnection({"autocommit": True}) + except NotImplementedError: + return # should be "SKIP" for ACCESS + crsr = ac_conn.cursor() + self.helpCreateAndPopulateTableTemp(crsr) + crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp) + crsr.close() + with self.getCursor() as crsr: + selectSql = "SELECT fldData from xx_%s" % config.tmp + crsr.execute( + selectSql + ) # closing the connection should _not_ have forced rollback + rs = crsr.fetchall() + assert len(rs) == 10, "all records should still be present" + ac_conn.close() + self.helpRollbackTblTemp() + + def testSwitchedAutoCommit(self): + try: + ac_conn = self.getAnotherConnection() + except NotImplementedError: + return # should be "SKIP" for ACCESS + ac_conn.autocommit = True + crsr = ac_conn.cursor() + self.helpCreateAndPopulateTableTemp(crsr) + crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp) + crsr.close() + conn = self.getConnection() + ac_conn.close() + with self.getCursor() as crsr: + selectSql = "SELECT fldData from xx_%s" % config.tmp + crsr.execute( + selectSql + ) # closing the connection should _not_ have forced rollback + rs = crsr.fetchall() + assert len(rs) == 10, "all records should still be present" + self.helpRollbackTblTemp() + + def testExtendedTypeHandling(self): + class XtendString(str): + pass + + class XtendInt(int): + pass + + class XtendFloat(float): + pass + + xs = XtendString(randomstring(30)) + xi = XtendInt(random.randint(-100, 500)) + xf = XtendFloat(random.random()) + self.helpForceDropOnTblTemp() + conn = self.getConnection() + crsr = conn.cursor() + tabdef = ( + """ + CREATE TABLE xx_%s ( + s VARCHAR(40) NOT NULL, + i INTEGER NOT NULL, + f REAL NOT NULL)""" + % config.tmp + ) + crsr.execute(tabdef) + crsr.execute( + "INSERT INTO xx_%s (s, i, f) VALUES (?, ?, ?)" % config.tmp, (xs, xi, xf) + ) + crsr.close() + conn = self.getConnection() + with self.getCursor() as crsr: + selectSql = "SELECT s, i, f from xx_%s" % config.tmp + crsr.execute( + selectSql + ) # closing the connection should _not_ have forced rollback + row = crsr.fetchone() + self.assertEqual(row.s, xs) + self.assertEqual(row.i, xi) + self.assertAlmostEqual(row.f, xf) + self.helpRollbackTblTemp() + + +class TestADOwithSQLServer(CommonDBTests): + def setUp(self): + self.conn = config.dbSqlServerconnect( + *config.connStrSQLServer[0], **config.connStrSQLServer[1] + ) + self.conn.timeout = 30 # turn timeout back up + self.engine = "MSSQL" + self.db = config.dbSqlServerconnect + self.remote = config.connStrSQLServer[2] + + def tearDown(self): + try: + self.conn.rollback() + except: + pass + try: + self.conn.close() + except: + pass + self.conn = None + + def getConnection(self): + return self.conn + + def getAnotherConnection(self, addkeys=None): + keys = dict(config.connStrSQLServer[1]) + if addkeys: + keys.update(addkeys) + return config.dbSqlServerconnect(*config.connStrSQLServer[0], **keys) + + def testVariableReturningStoredProcedure(self): + crsr = self.conn.cursor() + spdef = """ + CREATE PROCEDURE sp_DeleteMeOnlyForTesting + @theInput varchar(50), + @theOtherInput varchar(50), + @theOutput varchar(100) OUTPUT + AS + SET @theOutput=@theInput+@theOtherInput + """ + try: + crsr.execute("DROP PROCEDURE sp_DeleteMeOnlyForTesting") + self.conn.commit() + except: # Make sure it is empty + pass + crsr.execute(spdef) + + retvalues = crsr.callproc( + "sp_DeleteMeOnlyForTesting", ("Dodsworth", "Anne", " ") + ) + assert retvalues[0] == "Dodsworth", '%s is not "Dodsworth"' % repr(retvalues[0]) + assert retvalues[1] == "Anne", '%s is not "Anne"' % repr(retvalues[1]) + assert retvalues[2] == "DodsworthAnne", '%s is not "DodsworthAnne"' % repr( + retvalues[2] + ) + self.conn.rollback() + + def testMultipleSetReturn(self): + crsr = self.getCursor() + self.helpCreateAndPopulateTableTemp(crsr) + + spdef = """ + CREATE PROCEDURE sp_DeleteMe_OnlyForTesting + AS + SELECT fldData FROM xx_%s ORDER BY fldData ASC + SELECT fldData From xx_%s where fldData = -9999 + SELECT fldData FROM xx_%s ORDER BY fldData DESC + """ % ( + config.tmp, + config.tmp, + config.tmp, + ) + try: + crsr.execute("DROP PROCEDURE sp_DeleteMe_OnlyForTesting") + self.conn.commit() + except: # Make sure it is empty + pass + crsr.execute(spdef) + + retvalues = crsr.callproc("sp_DeleteMe_OnlyForTesting") + row = crsr.fetchone() + self.assertEqual(row[0], 0) + assert crsr.nextset() == True, "Operation should succeed" + assert not crsr.fetchall(), "Should be an empty second set" + assert crsr.nextset() == True, "third set should be present" + rowdesc = crsr.fetchall() + self.assertEqual(rowdesc[0][0], 8) + assert crsr.nextset() == None, "No more return sets, should return None" + + self.helpRollbackTblTemp() + + def testDatetimeProcedureParameter(self): + crsr = self.conn.cursor() + spdef = """ + CREATE PROCEDURE sp_DeleteMeOnlyForTesting + @theInput DATETIME, + @theOtherInput varchar(50), + @theOutput varchar(100) OUTPUT + AS + SET @theOutput = CONVERT(CHARACTER(20), @theInput, 0) + @theOtherInput + """ + try: + crsr.execute("DROP PROCEDURE sp_DeleteMeOnlyForTesting") + self.conn.commit() + except: # Make sure it is empty + pass + crsr.execute(spdef) + + result = crsr.callproc( + "sp_DeleteMeOnlyForTesting", + [adodbapi.Timestamp(2014, 12, 25, 0, 1, 0), "Beep", " " * 30], + ) + + assert result[2] == "Dec 25 2014 12:01AM Beep", 'value was="%s"' % result[2] + self.conn.rollback() + + def testIncorrectStoredProcedureParameter(self): + crsr = self.conn.cursor() + spdef = """ + CREATE PROCEDURE sp_DeleteMeOnlyForTesting + @theInput DATETIME, + @theOtherInput varchar(50), + @theOutput varchar(100) OUTPUT + AS + SET @theOutput = CONVERT(CHARACTER(20), @theInput) + @theOtherInput + """ + try: + crsr.execute("DROP PROCEDURE sp_DeleteMeOnlyForTesting") + self.conn.commit() + except: # Make sure it is empty + pass + crsr.execute(spdef) + + # calling the sproc with a string for the first parameter where a DateTime is expected + result = tryconnection.try_operation_with_expected_exception( + (api.DataError, api.DatabaseError), + crsr.callproc, + ["sp_DeleteMeOnlyForTesting"], + {"parameters": ["this is wrong", "Anne", "not Alice"]}, + ) + if result[0]: # the expected exception was raised + assert "@theInput" in str(result[1]) or "DatabaseError" in str( + result + ), "Identifies the wrong erroneous parameter" + else: + assert result[0], result[1] # incorrect or no exception + self.conn.rollback() + + +class TestADOwithAccessDB(CommonDBTests): + def setUp(self): + self.conn = config.dbAccessconnect( + *config.connStrAccess[0], **config.connStrAccess[1] + ) + self.conn.timeout = 30 # turn timeout back up + self.engine = "ACCESS" + self.db = config.dbAccessconnect + self.remote = config.connStrAccess[2] + + def tearDown(self): + try: + self.conn.rollback() + except: + pass + try: + self.conn.close() + except: + pass + self.conn = None + + def getConnection(self): + return self.conn + + def getAnotherConnection(self, addkeys=None): + raise NotImplementedError("Jet cannot use a second connection to the database") + + def testOkConnect(self): + c = self.db(*config.connStrAccess[0], **config.connStrAccess[1]) + assert c != None + c.close() + + +class TestADOwithMySql(CommonDBTests): + def setUp(self): + self.conn = config.dbMySqlconnect( + *config.connStrMySql[0], **config.connStrMySql[1] + ) + self.conn.timeout = 30 # turn timeout back up + self.engine = "MySQL" + self.db = config.dbMySqlconnect + self.remote = config.connStrMySql[2] + + def tearDown(self): + try: + self.conn.rollback() + except: + pass + try: + self.conn.close() + except: + pass + self.conn = None + + def getConnection(self): + return self.conn + + def getAnotherConnection(self, addkeys=None): + keys = dict(config.connStrMySql[1]) + if addkeys: + keys.update(addkeys) + return config.dbMySqlconnect(*config.connStrMySql[0], **keys) + + def testOkConnect(self): + c = self.db(*config.connStrMySql[0], **config.connStrMySql[1]) + assert c != None + + # def testStoredProcedure(self): + # crsr=self.conn.cursor() + # try: + # crsr.execute("DROP PROCEDURE DeleteMeOnlyForTesting") + # self.conn.commit() + # except: #Make sure it is empty + # pass + # spdef= """ + # DELIMITER $$ + # CREATE PROCEDURE DeleteMeOnlyForTesting (onein CHAR(10), twoin CHAR(10), OUT theout CHAR(20)) + # DETERMINISTIC + # BEGIN + # SET theout = onein //|| twoin; + # /* (SELECT 'a small string' as result; */ + # END $$ + # """ + # + # crsr.execute(spdef) + # + # retvalues=crsr.callproc('DeleteMeOnlyForTesting',('Dodsworth','Anne',' ')) + # print 'return value (mysql)=',repr(crsr.returnValue) ### + # assert retvalues[0]=='Dodsworth', '%s is not "Dodsworth"'%repr(retvalues[0]) + # assert retvalues[1]=='Anne','%s is not "Anne"'%repr(retvalues[1]) + # assert retvalues[2]=='DodsworthAnne','%s is not "DodsworthAnne"'%repr(retvalues[2]) + # + # try: + # crsr.execute("DROP PROCEDURE, DeleteMeOnlyForTesting") + # self.conn.commit() + # except: #Make sure it is empty + # pass + + +class TestADOwithPostgres(CommonDBTests): + def setUp(self): + self.conn = config.dbPostgresConnect( + *config.connStrPostgres[0], **config.connStrPostgres[1] + ) + self.conn.timeout = 30 # turn timeout back up + self.engine = "PostgreSQL" + self.db = config.dbPostgresConnect + self.remote = config.connStrPostgres[2] + + def tearDown(self): + try: + self.conn.rollback() + except: + pass + try: + self.conn.close() + except: + pass + self.conn = None + + def getConnection(self): + return self.conn + + def getAnotherConnection(self, addkeys=None): + keys = dict(config.connStrPostgres[1]) + if addkeys: + keys.update(addkeys) + return config.dbPostgresConnect(*config.connStrPostgres[0], **keys) + + def testOkConnect(self): + c = self.db(*config.connStrPostgres[0], **config.connStrPostgres[1]) + assert c != None + + # def testStoredProcedure(self): + # crsr=self.conn.cursor() + # spdef= """ + # CREATE OR REPLACE FUNCTION DeleteMeOnlyForTesting (text, text) + # RETURNS text AS $funk$ + # BEGIN + # RETURN $1 || $2; + # END; + # $funk$ + # LANGUAGE SQL; + # """ + # + # crsr.execute(spdef) + # retvalues = crsr.callproc('DeleteMeOnlyForTesting',('Dodsworth','Anne',' ')) + # ### print 'return value (pg)=',repr(crsr.returnValue) ### + # assert retvalues[0]=='Dodsworth', '%s is not "Dodsworth"'%repr(retvalues[0]) + # assert retvalues[1]=='Anne','%s is not "Anne"'%repr(retvalues[1]) + # assert retvalues[2]=='Dodsworth Anne','%s is not "Dodsworth Anne"'%repr(retvalues[2]) + # self.conn.rollback() + # try: + # crsr.execute("DROP PROCEDURE, DeleteMeOnlyForTesting") + # self.conn.commit() + # except: #Make sure it is empty + # pass + + +class TimeConverterInterfaceTest(unittest.TestCase): + def testIDate(self): + assert self.tc.Date(1990, 2, 2) + + def testITime(self): + assert self.tc.Time(13, 2, 2) + + def testITimestamp(self): + assert self.tc.Timestamp(1990, 2, 2, 13, 2, 1) + + def testIDateObjectFromCOMDate(self): + assert self.tc.DateObjectFromCOMDate(37435.7604282) + + def testICOMDate(self): + assert hasattr(self.tc, "COMDate") + + def testExactDate(self): + d = self.tc.Date(1994, 11, 15) + comDate = self.tc.COMDate(d) + correct = 34653.0 + assert comDate == correct, comDate + + def testExactTimestamp(self): + d = self.tc.Timestamp(1994, 11, 15, 12, 0, 0) + comDate = self.tc.COMDate(d) + correct = 34653.5 + self.assertEqual(comDate, correct) + + d = self.tc.Timestamp(2003, 5, 6, 14, 15, 17) + comDate = self.tc.COMDate(d) + correct = 37747.593946759262 + self.assertEqual(comDate, correct) + + def testIsoFormat(self): + d = self.tc.Timestamp(1994, 11, 15, 12, 3, 10) + iso = self.tc.DateObjectToIsoFormatString(d) + self.assertEqual(str(iso[:19]), "1994-11-15 12:03:10") + + dt = self.tc.Date(2003, 5, 2) + iso = self.tc.DateObjectToIsoFormatString(dt) + self.assertEqual(str(iso[:10]), "2003-05-02") + + +if config.doMxDateTimeTest: + import mx.DateTime + + +class TestMXDateTimeConverter(TimeConverterInterfaceTest): + def setUp(self): + self.tc = api.mxDateTimeConverter() + + def testCOMDate(self): + t = mx.DateTime.DateTime(2002, 6, 28, 18, 15, 2) + cmd = self.tc.COMDate(t) + assert cmd == t.COMDate() + + def testDateObjectFromCOMDate(self): + cmd = self.tc.DateObjectFromCOMDate(37435.7604282) + t = mx.DateTime.DateTime(2002, 6, 28, 18, 15, 0) + t2 = mx.DateTime.DateTime(2002, 6, 28, 18, 15, 2) + assert t2 > cmd > t + + def testDate(self): + assert mx.DateTime.Date(1980, 11, 4) == self.tc.Date(1980, 11, 4) + + def testTime(self): + assert mx.DateTime.Time(13, 11, 4) == self.tc.Time(13, 11, 4) + + def testTimestamp(self): + t = mx.DateTime.DateTime(2002, 6, 28, 18, 15, 1) + obj = self.tc.Timestamp(2002, 6, 28, 18, 15, 1) + assert t == obj + + +import time + + +class TestPythonTimeConverter(TimeConverterInterfaceTest): + def setUp(self): + self.tc = api.pythonTimeConverter() + + def testCOMDate(self): + mk = time.mktime((2002, 6, 28, 18, 15, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, -1)) + t = time.localtime(mk) + # Fri, 28 Jun 2002 18:15:01 +0000 + cmd = self.tc.COMDate(t) + assert abs(cmd - 37435.7604282) < 1.0 / 24, "%f more than an hour wrong" % cmd + + def testDateObjectFromCOMDate(self): + cmd = self.tc.DateObjectFromCOMDate(37435.7604282) + t1 = time.gmtime( + time.mktime((2002, 6, 28, 0, 14, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, -1)) + ) + # there are errors in the implementation of gmtime which we ignore + t2 = time.gmtime( + time.mktime((2002, 6, 29, 12, 14, 2, 4, 31 + 28 + 31 + 30 + 31 + 28, -1)) + ) + assert t1 < cmd < t2, '"%s" should be about 2002-6-28 12:15:01' % repr(cmd) + + def testDate(self): + t1 = time.mktime((2002, 6, 28, 18, 15, 1, 4, 31 + 28 + 31 + 30 + 31 + 30, 0)) + t2 = time.mktime((2002, 6, 30, 18, 15, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, 0)) + obj = self.tc.Date(2002, 6, 29) + assert t1 < time.mktime(obj) < t2, obj + + def testTime(self): + self.assertEqual( + self.tc.Time(18, 15, 2), time.gmtime(18 * 60 * 60 + 15 * 60 + 2) + ) + + def testTimestamp(self): + t1 = time.localtime( + time.mktime((2002, 6, 28, 18, 14, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, -1)) + ) + t2 = time.localtime( + time.mktime((2002, 6, 28, 18, 16, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, -1)) + ) + obj = self.tc.Timestamp(2002, 6, 28, 18, 15, 2) + assert t1 < obj < t2, obj + + +class TestPythonDateTimeConverter(TimeConverterInterfaceTest): + def setUp(self): + self.tc = api.pythonDateTimeConverter() + + def testCOMDate(self): + t = datetime.datetime(2002, 6, 28, 18, 15, 1) + # Fri, 28 Jun 2002 18:15:01 +0000 + cmd = self.tc.COMDate(t) + assert abs(cmd - 37435.7604282) < 1.0 / 24, "more than an hour wrong" + + def testDateObjectFromCOMDate(self): + cmd = self.tc.DateObjectFromCOMDate(37435.7604282) + t1 = datetime.datetime(2002, 6, 28, 18, 14, 1) + t2 = datetime.datetime(2002, 6, 28, 18, 16, 1) + assert t1 < cmd < t2, cmd + + tx = datetime.datetime( + 2002, 6, 28, 18, 14, 1, 900000 + ) # testing that microseconds don't become milliseconds + c1 = self.tc.DateObjectFromCOMDate(self.tc.COMDate(tx)) + assert t1 < c1 < t2, c1 + + def testDate(self): + t1 = datetime.date(2002, 6, 28) + t2 = datetime.date(2002, 6, 30) + obj = self.tc.Date(2002, 6, 29) + assert t1 < obj < t2, obj + + def testTime(self): + self.assertEqual(self.tc.Time(18, 15, 2).isoformat()[:8], "18:15:02") + + def testTimestamp(self): + t1 = datetime.datetime(2002, 6, 28, 18, 14, 1) + t2 = datetime.datetime(2002, 6, 28, 18, 16, 1) + obj = self.tc.Timestamp(2002, 6, 28, 18, 15, 2) + assert t1 < obj < t2, obj + + +suites = [] +suites.append(unittest.makeSuite(TestPythonDateTimeConverter, "test")) +if config.doMxDateTimeTest: + suites.append(unittest.makeSuite(TestMXDateTimeConverter, "test")) +if config.doTimeTest: + suites.append(unittest.makeSuite(TestPythonTimeConverter, "test")) + +if config.doAccessTest: + suites.append(unittest.makeSuite(TestADOwithAccessDB, "test")) +if config.doSqlServerTest: + suites.append(unittest.makeSuite(TestADOwithSQLServer, "test")) +if config.doMySqlTest: + suites.append(unittest.makeSuite(TestADOwithMySql, "test")) +if config.doPostgresTest: + suites.append(unittest.makeSuite(TestADOwithPostgres, "test")) + + +class cleanup_manager(object): + def __enter__(self): + pass + + def __exit__(self, exc_type, exc_val, exc_tb): + config.cleanup(config.testfolder, config.mdb_name) + + +suite = unittest.TestSuite(suites) +if __name__ == "__main__": + mysuite = copy.deepcopy(suite) + with cleanup_manager(): + defaultDateConverter = adodbapi.dateconverter + print(__doc__) + print("Default Date Converter is %s" % (defaultDateConverter,)) + dateconverter = defaultDateConverter + tag = "datetime" + unittest.TextTestRunner().run(mysuite) + + if config.iterateOverTimeTests: + for test, dateconverter, tag in ( + (config.doTimeTest, api.pythonTimeConverter, "pythontime"), + (config.doMxDateTimeTest, api.mxDateTimeConverter, "mx"), + ): + if test: + mysuite = copy.deepcopy( + suite + ) # work around a side effect of unittest.TextTestRunner + adodbapi.adodbapi.dateconverter = dateconverter() + print("Changed dateconverter to ") + print(adodbapi.adodbapi.dateconverter) + unittest.TextTestRunner().run(mysuite) diff --git a/lib/adodbapi/test/adodbapitestconfig.py b/lib/adodbapi/test/adodbapitestconfig.py new file mode 100644 index 00000000..98f25444 --- /dev/null +++ b/lib/adodbapi/test/adodbapitestconfig.py @@ -0,0 +1,221 @@ +# Configure this to _YOUR_ environment in order to run the testcases. +"testADOdbapiConfig.py v 2.6.2.B00" + +# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # +# # +# # TESTERS: +# # +# # You will need to make numerous modifications to this file +# # to adapt it to your own testing environment. +# # +# # Skip down to the next "# #" line -- +# # -- the things you need to change are below it. +# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # +import platform +import random +import sys + +import is64bit +import setuptestframework +import tryconnection + +print("\nPython", sys.version) +node = platform.node() +try: + print( + "node=%s, is64bit.os()= %s, is64bit.Python()= %s" + % (node, is64bit.os(), is64bit.Python()) + ) +except: + pass + +if "--help" in sys.argv: + print( + """Valid command-line switches are: + --package - create a temporary test package, run 2to3 if needed. + --all - run all possible tests + --time - loop over time format tests (including mxdatetime if present) + --nojet - do not test against an ACCESS database file + --mssql - test against Microsoft SQL server + --pg - test against PostgreSQL + --mysql - test against MariaDB + --remote= - test unsing remote server at= (experimental) + """ + ) + exit() +try: + onWindows = bool(sys.getwindowsversion()) # seems to work on all versions of Python +except: + onWindows = False + +# create a random name for temporary table names +_alphabet = ( + "PYFGCRLAOEUIDHTNSQJKXBMWVZ" # why, yes, I do happen to use a dvorak keyboard +) +tmp = "".join([random.choice(_alphabet) for x in range(9)]) +mdb_name = "xx_" + tmp + ".mdb" # generate a non-colliding name for the temporary .mdb +testfolder = setuptestframework.maketemp() + +if "--package" in sys.argv: + # create a new adodbapi module -- running 2to3 if needed. + pth = setuptestframework.makeadopackage(testfolder) +else: + # use the adodbapi module in which this file appears + pth = setuptestframework.find_ado_path() +if pth not in sys.path: + # look here _first_ to find modules + sys.path.insert(1, pth) + +proxy_host = None +for arg in sys.argv: + if arg.startswith("--remote="): + proxy_host = arg.split("=")[1] + import adodbapi.remote as remote + + break + + +# function to clean up the temporary folder -- calling program must run this function before exit. +cleanup = setuptestframework.getcleanupfunction() +try: + import adodbapi # will (hopefully) be imported using the "pth" discovered above +except SyntaxError: + print( + '\n* * * Are you trying to run Python2 code using Python3? Re-run this test using the "--package" switch.' + ) + sys.exit(11) +try: + print(adodbapi.version) # show version +except: + print('"adodbapi.version" not present or not working.') +print(__doc__) + +verbose = False +for a in sys.argv: + if a.startswith("--verbose"): + arg = True + try: + arg = int(a.split("=")[1]) + except IndexError: + pass + adodbapi.adodbapi.verbose = arg + verbose = arg + +doAllTests = "--all" in sys.argv +doAccessTest = not ("--nojet" in sys.argv) +doSqlServerTest = "--mssql" in sys.argv or doAllTests +doMySqlTest = "--mysql" in sys.argv or doAllTests +doPostgresTest = "--pg" in sys.argv or doAllTests +iterateOverTimeTests = ("--time" in sys.argv or doAllTests) and onWindows + +# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # +# # start your environment setup here v v v +SQL_HOST_NODE = "testsql.2txt.us,1430" + +try: # If mx extensions are installed, use mxDateTime + import mx.DateTime + + doMxDateTimeTest = True +except: + doMxDateTimeTest = False # Requires eGenixMXExtensions + +doTimeTest = True # obsolete python time format + +if doAccessTest: + if proxy_host: # determine the (probably remote) database file folder + c = {"macro_find_temp_test_path": ["mdb", mdb_name], "proxy_host": proxy_host} + else: + c = {"mdb": setuptestframework.makemdb(testfolder, mdb_name)} + + # macro definition for keyword "provider" using macro "is64bit" -- see documentation + # is64bit will return true for 64 bit versions of Python, so the macro will select the ACE provider + # (If running a remote ADO service, this will test the 64-bitedness of the ADO server.) + c["macro_is64bit"] = [ + "provider", + "Microsoft.ACE.OLEDB.12.0", # 64 bit provider + "Microsoft.Jet.OLEDB.4.0", + ] # 32 bit provider + connStrAccess = "Provider=%(provider)s;Data Source=%(mdb)s" # ;Mode=ReadWrite;Persist Security Info=False;Jet OLEDB:Bypass UserInfo Validation=True" + print( + " ...Testing ACCESS connection to {} file...".format( + c.get("mdb", "remote .mdb") + ) + ) + doAccessTest, connStrAccess, dbAccessconnect = tryconnection.try_connection( + verbose, connStrAccess, 10, **c + ) + +if doSqlServerTest: + c = { + "host": SQL_HOST_NODE, # name of computer with SQL Server + "database": "adotest", + "user": "adotestuser", # None implies Windows security + "password": "Sq1234567", + # macro definition for keyword "security" using macro "auto_security" + "macro_auto_security": "security", + "provider": "MSOLEDBSQL; MARS Connection=True", + } + if proxy_host: + c["proxy_host"] = proxy_host + connStr = "Provider=%(provider)s; Initial Catalog=%(database)s; Data Source=%(host)s; %(security)s;" + print(" ...Testing MS-SQL login to {}...".format(c["host"])) + ( + doSqlServerTest, + connStrSQLServer, + dbSqlServerconnect, + ) = tryconnection.try_connection(verbose, connStr, 30, **c) + +if doMySqlTest: + c = { + "host": "testmysql.2txt.us", + "database": "adodbapitest", + "user": "adotest", + "password": "12345678", + "port": "3330", # note the nonstandard port for obfuscation + "driver": "MySQL ODBC 5.1 Driver", + } # or _driver="MySQL ODBC 3.51 Driver + if proxy_host: + c["proxy_host"] = proxy_host + c["macro_is64bit"] = [ + "provider", + "Provider=MSDASQL;", + ] # turn on the 64 bit ODBC adapter only if needed + cs = ( + "%(provider)sDriver={%(driver)s};Server=%(host)s;Port=3330;" + + "Database=%(database)s;user=%(user)s;password=%(password)s;Option=3;" + ) + print(" ...Testing MySql login to {}...".format(c["host"])) + doMySqlTest, connStrMySql, dbMySqlconnect = tryconnection.try_connection( + verbose, cs, 5, **c + ) + + +if doPostgresTest: + _computername = "testpg.2txt.us" + _databasename = "adotest" + _username = "adotestuser" + _password = "12345678" + kws = {"timeout": 4} + kws["macro_is64bit"] = [ + "prov_drv", + "Provider=MSDASQL;Driver={PostgreSQL Unicode(x64)}", + "Driver=PostgreSQL Unicode", + ] + # get driver from http://www.postgresql.org/ftp/odbc/versions/ + # test using positional and keyword arguments (bad example for real code) + if proxy_host: + kws["proxy_host"] = proxy_host + print(" ...Testing PostgreSQL login to {}...".format(_computername)) + doPostgresTest, connStrPostgres, dbPostgresConnect = tryconnection.try_connection( + verbose, + "%(prov_drv)s;Server=%(host)s;Database=%(database)s;uid=%(user)s;pwd=%(password)s;port=5430;", # note nonstandard port + _username, + _password, + _computername, + _databasename, + **kws + ) + +assert ( + doAccessTest or doSqlServerTest or doMySqlTest or doPostgresTest +), "No database engine found for testing" diff --git a/lib/adodbapi/test/dbapi20.py b/lib/adodbapi/test/dbapi20.py new file mode 100644 index 00000000..e378b194 --- /dev/null +++ b/lib/adodbapi/test/dbapi20.py @@ -0,0 +1,939 @@ +#!/usr/bin/env python +""" Python DB API 2.0 driver compliance unit test suite. + + This software is Public Domain and may be used without restrictions. + + "Now we have booze and barflies entering the discussion, plus rumours of + DBAs on drugs... and I won't tell you what flashes through my mind each + time I read the subject line with 'Anal Compliance' in it. All around + this is turning out to be a thoroughly unwholesome unit test." + + -- Ian Bicking +""" + +__version__ = "$Revision: 1.15.0 $"[11:-2] +__author__ = "Stuart Bishop " + +import sys +import time +import unittest + +if sys.version[0] >= "3": # python 3.x + _BaseException = Exception + + def _failUnless(self, expr, msg=None): + self.assertTrue(expr, msg) + +else: # python 2.x + from exceptions import Exception as _BaseException + + def _failUnless(self, expr, msg=None): + self.failUnless(expr, msg) ## deprecated since Python 2.6 + + +# set this to "True" to follow API 2.0 to the letter +TEST_FOR_NON_IDEMPOTENT_CLOSE = False + +# Revision 1.15 2019/11/22 00:50:00 kf7xm +# Make Turn off IDEMPOTENT_CLOSE a proper skipTest + +# Revision 1.14 2013/05/20 11:02:05 kf7xm +# Add a literal string to the format insertion test to catch trivial re-format algorithms + +# Revision 1.13 2013/05/08 14:31:50 kf7xm +# Quick switch to Turn off IDEMPOTENT_CLOSE test. Also: Silence teardown failure + + +# Revision 1.12 2009/02/06 03:35:11 kf7xm +# Tested okay with Python 3.0, includes last minute patches from Mark H. +# +# Revision 1.1.1.1.2.1 2008/09/20 19:54:59 rupole +# Include latest changes from main branch +# Updates for py3k +# +# Revision 1.11 2005/01/02 02:41:01 zenzen +# Update author email address +# +# Revision 1.10 2003/10/09 03:14:14 zenzen +# Add test for DB API 2.0 optional extension, where database exceptions +# are exposed as attributes on the Connection object. +# +# Revision 1.9 2003/08/13 01:16:36 zenzen +# Minor tweak from Stefan Fleiter +# +# Revision 1.8 2003/04/10 00:13:25 zenzen +# Changes, as per suggestions by M.-A. Lemburg +# - Add a table prefix, to ensure namespace collisions can always be avoided +# +# Revision 1.7 2003/02/26 23:33:37 zenzen +# Break out DDL into helper functions, as per request by David Rushby +# +# Revision 1.6 2003/02/21 03:04:33 zenzen +# Stuff from Henrik Ekelund: +# added test_None +# added test_nextset & hooks +# +# Revision 1.5 2003/02/17 22:08:43 zenzen +# Implement suggestions and code from Henrik Eklund - test that cursor.arraysize +# defaults to 1 & generic cursor.callproc test added +# +# Revision 1.4 2003/02/15 00:16:33 zenzen +# Changes, as per suggestions and bug reports by M.-A. Lemburg, +# Matthew T. Kromer, Federico Di Gregorio and Daniel Dittmar +# - Class renamed +# - Now a subclass of TestCase, to avoid requiring the driver stub +# to use multiple inheritance +# - Reversed the polarity of buggy test in test_description +# - Test exception heirarchy correctly +# - self.populate is now self._populate(), so if a driver stub +# overrides self.ddl1 this change propogates +# - VARCHAR columns now have a width, which will hopefully make the +# DDL even more portible (this will be reversed if it causes more problems) +# - cursor.rowcount being checked after various execute and fetchXXX methods +# - Check for fetchall and fetchmany returning empty lists after results +# are exhausted (already checking for empty lists if select retrieved +# nothing +# - Fix bugs in test_setoutputsize_basic and test_setinputsizes +# +def str2bytes(sval): + if sys.version_info < (3, 0) and isinstance(sval, str): + sval = sval.decode("latin1") + return sval.encode("latin1") # python 3 make unicode into bytes + + +class DatabaseAPI20Test(unittest.TestCase): + """Test a database self.driver for DB API 2.0 compatibility. + This implementation tests Gadfly, but the TestCase + is structured so that other self.drivers can subclass this + test case to ensure compiliance with the DB-API. It is + expected that this TestCase may be expanded in the future + if ambiguities or edge conditions are discovered. + + The 'Optional Extensions' are not yet being tested. + + self.drivers should subclass this test, overriding setUp, tearDown, + self.driver, connect_args and connect_kw_args. Class specification + should be as follows: + + import dbapi20 + class mytest(dbapi20.DatabaseAPI20Test): + [...] + + Don't 'import DatabaseAPI20Test from dbapi20', or you will + confuse the unit tester - just 'import dbapi20'. + """ + + # The self.driver module. This should be the module where the 'connect' + # method is to be found + driver = None + connect_args = () # List of arguments to pass to connect + connect_kw_args = {} # Keyword arguments for connect + table_prefix = "dbapi20test_" # If you need to specify a prefix for tables + + ddl1 = "create table %sbooze (name varchar(20))" % table_prefix + ddl2 = "create table %sbarflys (name varchar(20), drink varchar(30))" % table_prefix + xddl1 = "drop table %sbooze" % table_prefix + xddl2 = "drop table %sbarflys" % table_prefix + + lowerfunc = "lower" # Name of stored procedure to convert string->lowercase + + # Some drivers may need to override these helpers, for example adding + # a 'commit' after the execute. + def executeDDL1(self, cursor): + cursor.execute(self.ddl1) + + def executeDDL2(self, cursor): + cursor.execute(self.ddl2) + + def setUp(self): + """self.drivers should override this method to perform required setup + if any is necessary, such as creating the database. + """ + pass + + def tearDown(self): + """self.drivers should override this method to perform required cleanup + if any is necessary, such as deleting the test database. + The default drops the tables that may be created. + """ + try: + con = self._connect() + try: + cur = con.cursor() + for ddl in (self.xddl1, self.xddl2): + try: + cur.execute(ddl) + con.commit() + except self.driver.Error: + # Assume table didn't exist. Other tests will check if + # execute is busted. + pass + finally: + con.close() + except _BaseException: + pass + + def _connect(self): + try: + r = self.driver.connect(*self.connect_args, **self.connect_kw_args) + except AttributeError: + self.fail("No connect method found in self.driver module") + return r + + def test_connect(self): + con = self._connect() + con.close() + + def test_apilevel(self): + try: + # Must exist + apilevel = self.driver.apilevel + # Must equal 2.0 + self.assertEqual(apilevel, "2.0") + except AttributeError: + self.fail("Driver doesn't define apilevel") + + def test_threadsafety(self): + try: + # Must exist + threadsafety = self.driver.threadsafety + # Must be a valid value + _failUnless(self, threadsafety in (0, 1, 2, 3)) + except AttributeError: + self.fail("Driver doesn't define threadsafety") + + def test_paramstyle(self): + try: + # Must exist + paramstyle = self.driver.paramstyle + # Must be a valid value + _failUnless( + self, paramstyle in ("qmark", "numeric", "named", "format", "pyformat") + ) + except AttributeError: + self.fail("Driver doesn't define paramstyle") + + def test_Exceptions(self): + # Make sure required exceptions exist, and are in the + # defined heirarchy. + if sys.version[0] == "3": # under Python 3 StardardError no longer exists + self.assertTrue(issubclass(self.driver.Warning, Exception)) + self.assertTrue(issubclass(self.driver.Error, Exception)) + else: + self.failUnless(issubclass(self.driver.Warning, Exception)) + self.failUnless(issubclass(self.driver.Error, Exception)) + + _failUnless(self, issubclass(self.driver.InterfaceError, self.driver.Error)) + _failUnless(self, issubclass(self.driver.DatabaseError, self.driver.Error)) + _failUnless(self, issubclass(self.driver.OperationalError, self.driver.Error)) + _failUnless(self, issubclass(self.driver.IntegrityError, self.driver.Error)) + _failUnless(self, issubclass(self.driver.InternalError, self.driver.Error)) + _failUnless(self, issubclass(self.driver.ProgrammingError, self.driver.Error)) + _failUnless(self, issubclass(self.driver.NotSupportedError, self.driver.Error)) + + def test_ExceptionsAsConnectionAttributes(self): + # OPTIONAL EXTENSION + # Test for the optional DB API 2.0 extension, where the exceptions + # are exposed as attributes on the Connection object + # I figure this optional extension will be implemented by any + # driver author who is using this test suite, so it is enabled + # by default. + con = self._connect() + drv = self.driver + _failUnless(self, con.Warning is drv.Warning) + _failUnless(self, con.Error is drv.Error) + _failUnless(self, con.InterfaceError is drv.InterfaceError) + _failUnless(self, con.DatabaseError is drv.DatabaseError) + _failUnless(self, con.OperationalError is drv.OperationalError) + _failUnless(self, con.IntegrityError is drv.IntegrityError) + _failUnless(self, con.InternalError is drv.InternalError) + _failUnless(self, con.ProgrammingError is drv.ProgrammingError) + _failUnless(self, con.NotSupportedError is drv.NotSupportedError) + + def test_commit(self): + con = self._connect() + try: + # Commit must work, even if it doesn't do anything + con.commit() + finally: + con.close() + + def test_rollback(self): + con = self._connect() + # If rollback is defined, it should either work or throw + # the documented exception + if hasattr(con, "rollback"): + try: + con.rollback() + except self.driver.NotSupportedError: + pass + + def test_cursor(self): + con = self._connect() + try: + cur = con.cursor() + finally: + con.close() + + def test_cursor_isolation(self): + con = self._connect() + try: + # Make sure cursors created from the same connection have + # the documented transaction isolation level + cur1 = con.cursor() + cur2 = con.cursor() + self.executeDDL1(cur1) + cur1.execute( + "insert into %sbooze values ('Victoria Bitter')" % (self.table_prefix) + ) + cur2.execute("select name from %sbooze" % self.table_prefix) + booze = cur2.fetchall() + self.assertEqual(len(booze), 1) + self.assertEqual(len(booze[0]), 1) + self.assertEqual(booze[0][0], "Victoria Bitter") + finally: + con.close() + + def test_description(self): + con = self._connect() + try: + cur = con.cursor() + self.executeDDL1(cur) + self.assertEqual( + cur.description, + None, + "cursor.description should be none after executing a " + "statement that can return no rows (such as DDL)", + ) + cur.execute("select name from %sbooze" % self.table_prefix) + self.assertEqual( + len(cur.description), 1, "cursor.description describes too many columns" + ) + self.assertEqual( + len(cur.description[0]), + 7, + "cursor.description[x] tuples must have 7 elements", + ) + self.assertEqual( + cur.description[0][0].lower(), + "name", + "cursor.description[x][0] must return column name", + ) + self.assertEqual( + cur.description[0][1], + self.driver.STRING, + "cursor.description[x][1] must return column type. Got %r" + % cur.description[0][1], + ) + + # Make sure self.description gets reset + self.executeDDL2(cur) + self.assertEqual( + cur.description, + None, + "cursor.description not being set to None when executing " + "no-result statements (eg. DDL)", + ) + finally: + con.close() + + def test_rowcount(self): + con = self._connect() + try: + cur = con.cursor() + self.executeDDL1(cur) + _failUnless( + self, + cur.rowcount in (-1, 0), # Bug #543885 + "cursor.rowcount should be -1 or 0 after executing no-result " + "statements", + ) + cur.execute( + "insert into %sbooze values ('Victoria Bitter')" % (self.table_prefix) + ) + _failUnless( + self, + cur.rowcount in (-1, 1), + "cursor.rowcount should == number or rows inserted, or " + "set to -1 after executing an insert statement", + ) + cur.execute("select name from %sbooze" % self.table_prefix) + _failUnless( + self, + cur.rowcount in (-1, 1), + "cursor.rowcount should == number of rows returned, or " + "set to -1 after executing a select statement", + ) + self.executeDDL2(cur) + self.assertEqual( + cur.rowcount, + -1, + "cursor.rowcount not being reset to -1 after executing " + "no-result statements", + ) + finally: + con.close() + + lower_func = "lower" + + def test_callproc(self): + con = self._connect() + try: + cur = con.cursor() + if self.lower_func and hasattr(cur, "callproc"): + r = cur.callproc(self.lower_func, ("FOO",)) + self.assertEqual(len(r), 1) + self.assertEqual(r[0], "FOO") + r = cur.fetchall() + self.assertEqual(len(r), 1, "callproc produced no result set") + self.assertEqual(len(r[0]), 1, "callproc produced invalid result set") + self.assertEqual(r[0][0], "foo", "callproc produced invalid results") + finally: + con.close() + + def test_close(self): + con = self._connect() + try: + cur = con.cursor() + finally: + con.close() + + # cursor.execute should raise an Error if called after connection + # closed + self.assertRaises(self.driver.Error, self.executeDDL1, cur) + + # connection.commit should raise an Error if called after connection' + # closed.' + self.assertRaises(self.driver.Error, con.commit) + + # connection.close should raise an Error if called more than once + #!!! reasonable persons differ about the usefulness of this test and this feature !!! + if TEST_FOR_NON_IDEMPOTENT_CLOSE: + self.assertRaises(self.driver.Error, con.close) + else: + self.skipTest( + "Non-idempotent close is considered a bad thing by some people." + ) + + def test_execute(self): + con = self._connect() + try: + cur = con.cursor() + self._paraminsert(cur) + finally: + con.close() + + def _paraminsert(self, cur): + self.executeDDL2(cur) + cur.execute( + "insert into %sbarflys values ('Victoria Bitter', 'thi%%s :may ca%%(u)se? troub:1e')" + % (self.table_prefix) + ) + _failUnless(self, cur.rowcount in (-1, 1)) + + if self.driver.paramstyle == "qmark": + cur.execute( + "insert into %sbarflys values (?, 'thi%%s :may ca%%(u)se? troub:1e')" + % self.table_prefix, + ("Cooper's",), + ) + elif self.driver.paramstyle == "numeric": + cur.execute( + "insert into %sbarflys values (:1, 'thi%%s :may ca%%(u)se? troub:1e')" + % self.table_prefix, + ("Cooper's",), + ) + elif self.driver.paramstyle == "named": + cur.execute( + "insert into %sbarflys values (:beer, 'thi%%s :may ca%%(u)se? troub:1e')" + % self.table_prefix, + {"beer": "Cooper's"}, + ) + elif self.driver.paramstyle == "format": + cur.execute( + "insert into %sbarflys values (%%s, 'thi%%s :may ca%%(u)se? troub:1e')" + % self.table_prefix, + ("Cooper's",), + ) + elif self.driver.paramstyle == "pyformat": + cur.execute( + "insert into %sbarflys values (%%(beer)s, 'thi%%s :may ca%%(u)se? troub:1e')" + % self.table_prefix, + {"beer": "Cooper's"}, + ) + else: + self.fail("Invalid paramstyle") + _failUnless(self, cur.rowcount in (-1, 1)) + + cur.execute("select name, drink from %sbarflys" % self.table_prefix) + res = cur.fetchall() + self.assertEqual(len(res), 2, "cursor.fetchall returned too few rows") + beers = [res[0][0], res[1][0]] + beers.sort() + self.assertEqual( + beers[0], + "Cooper's", + "cursor.fetchall retrieved incorrect data, or data inserted " "incorrectly", + ) + self.assertEqual( + beers[1], + "Victoria Bitter", + "cursor.fetchall retrieved incorrect data, or data inserted " "incorrectly", + ) + trouble = "thi%s :may ca%(u)se? troub:1e" + self.assertEqual( + res[0][1], + trouble, + "cursor.fetchall retrieved incorrect data, or data inserted " + "incorrectly. Got=%s, Expected=%s" % (repr(res[0][1]), repr(trouble)), + ) + self.assertEqual( + res[1][1], + trouble, + "cursor.fetchall retrieved incorrect data, or data inserted " + "incorrectly. Got=%s, Expected=%s" % (repr(res[1][1]), repr(trouble)), + ) + + def test_executemany(self): + con = self._connect() + try: + cur = con.cursor() + self.executeDDL1(cur) + largs = [("Cooper's",), ("Boag's",)] + margs = [{"beer": "Cooper's"}, {"beer": "Boag's"}] + if self.driver.paramstyle == "qmark": + cur.executemany( + "insert into %sbooze values (?)" % self.table_prefix, largs + ) + elif self.driver.paramstyle == "numeric": + cur.executemany( + "insert into %sbooze values (:1)" % self.table_prefix, largs + ) + elif self.driver.paramstyle == "named": + cur.executemany( + "insert into %sbooze values (:beer)" % self.table_prefix, margs + ) + elif self.driver.paramstyle == "format": + cur.executemany( + "insert into %sbooze values (%%s)" % self.table_prefix, largs + ) + elif self.driver.paramstyle == "pyformat": + cur.executemany( + "insert into %sbooze values (%%(beer)s)" % (self.table_prefix), + margs, + ) + else: + self.fail("Unknown paramstyle") + _failUnless( + self, + cur.rowcount in (-1, 2), + "insert using cursor.executemany set cursor.rowcount to " + "incorrect value %r" % cur.rowcount, + ) + cur.execute("select name from %sbooze" % self.table_prefix) + res = cur.fetchall() + self.assertEqual( + len(res), 2, "cursor.fetchall retrieved incorrect number of rows" + ) + beers = [res[0][0], res[1][0]] + beers.sort() + self.assertEqual( + beers[0], "Boag's", 'incorrect data "%s" retrieved' % beers[0] + ) + self.assertEqual(beers[1], "Cooper's", "incorrect data retrieved") + finally: + con.close() + + def test_fetchone(self): + con = self._connect() + try: + cur = con.cursor() + + # cursor.fetchone should raise an Error if called before + # executing a select-type query + self.assertRaises(self.driver.Error, cur.fetchone) + + # cursor.fetchone should raise an Error if called after + # executing a query that cannnot return rows + self.executeDDL1(cur) + self.assertRaises(self.driver.Error, cur.fetchone) + + cur.execute("select name from %sbooze" % self.table_prefix) + self.assertEqual( + cur.fetchone(), + None, + "cursor.fetchone should return None if a query retrieves " "no rows", + ) + _failUnless(self, cur.rowcount in (-1, 0)) + + # cursor.fetchone should raise an Error if called after + # executing a query that cannnot return rows + cur.execute( + "insert into %sbooze values ('Victoria Bitter')" % (self.table_prefix) + ) + self.assertRaises(self.driver.Error, cur.fetchone) + + cur.execute("select name from %sbooze" % self.table_prefix) + r = cur.fetchone() + self.assertEqual( + len(r), 1, "cursor.fetchone should have retrieved a single row" + ) + self.assertEqual( + r[0], "Victoria Bitter", "cursor.fetchone retrieved incorrect data" + ) + self.assertEqual( + cur.fetchone(), + None, + "cursor.fetchone should return None if no more rows available", + ) + _failUnless(self, cur.rowcount in (-1, 1)) + finally: + con.close() + + samples = [ + "Carlton Cold", + "Carlton Draft", + "Mountain Goat", + "Redback", + "Victoria Bitter", + "XXXX", + ] + + def _populate(self): + """Return a list of sql commands to setup the DB for the fetch + tests. + """ + populate = [ + "insert into %sbooze values ('%s')" % (self.table_prefix, s) + for s in self.samples + ] + return populate + + def test_fetchmany(self): + con = self._connect() + try: + cur = con.cursor() + + # cursor.fetchmany should raise an Error if called without + # issuing a query + self.assertRaises(self.driver.Error, cur.fetchmany, 4) + + self.executeDDL1(cur) + for sql in self._populate(): + cur.execute(sql) + + cur.execute("select name from %sbooze" % self.table_prefix) + r = cur.fetchmany() + self.assertEqual( + len(r), + 1, + "cursor.fetchmany retrieved incorrect number of rows, " + "default of arraysize is one.", + ) + cur.arraysize = 10 + r = cur.fetchmany(3) # Should get 3 rows + self.assertEqual( + len(r), 3, "cursor.fetchmany retrieved incorrect number of rows" + ) + r = cur.fetchmany(4) # Should get 2 more + self.assertEqual( + len(r), 2, "cursor.fetchmany retrieved incorrect number of rows" + ) + r = cur.fetchmany(4) # Should be an empty sequence + self.assertEqual( + len(r), + 0, + "cursor.fetchmany should return an empty sequence after " + "results are exhausted", + ) + _failUnless(self, cur.rowcount in (-1, 6)) + + # Same as above, using cursor.arraysize + cur.arraysize = 4 + cur.execute("select name from %sbooze" % self.table_prefix) + r = cur.fetchmany() # Should get 4 rows + self.assertEqual( + len(r), 4, "cursor.arraysize not being honoured by fetchmany" + ) + r = cur.fetchmany() # Should get 2 more + self.assertEqual(len(r), 2) + r = cur.fetchmany() # Should be an empty sequence + self.assertEqual(len(r), 0) + _failUnless(self, cur.rowcount in (-1, 6)) + + cur.arraysize = 6 + cur.execute("select name from %sbooze" % self.table_prefix) + rows = cur.fetchmany() # Should get all rows + _failUnless(self, cur.rowcount in (-1, 6)) + self.assertEqual(len(rows), 6) + self.assertEqual(len(rows), 6) + rows = [r[0] for r in rows] + rows.sort() + + # Make sure we get the right data back out + for i in range(0, 6): + self.assertEqual( + rows[i], + self.samples[i], + "incorrect data retrieved by cursor.fetchmany", + ) + + rows = cur.fetchmany() # Should return an empty list + self.assertEqual( + len(rows), + 0, + "cursor.fetchmany should return an empty sequence if " + "called after the whole result set has been fetched", + ) + _failUnless(self, cur.rowcount in (-1, 6)) + + self.executeDDL2(cur) + cur.execute("select name from %sbarflys" % self.table_prefix) + r = cur.fetchmany() # Should get empty sequence + self.assertEqual( + len(r), + 0, + "cursor.fetchmany should return an empty sequence if " + "query retrieved no rows", + ) + _failUnless(self, cur.rowcount in (-1, 0)) + + finally: + con.close() + + def test_fetchall(self): + con = self._connect() + try: + cur = con.cursor() + # cursor.fetchall should raise an Error if called + # without executing a query that may return rows (such + # as a select) + self.assertRaises(self.driver.Error, cur.fetchall) + + self.executeDDL1(cur) + for sql in self._populate(): + cur.execute(sql) + + # cursor.fetchall should raise an Error if called + # after executing a a statement that cannot return rows + self.assertRaises(self.driver.Error, cur.fetchall) + + cur.execute("select name from %sbooze" % self.table_prefix) + rows = cur.fetchall() + _failUnless(self, cur.rowcount in (-1, len(self.samples))) + self.assertEqual( + len(rows), + len(self.samples), + "cursor.fetchall did not retrieve all rows", + ) + rows = [r[0] for r in rows] + rows.sort() + for i in range(0, len(self.samples)): + self.assertEqual( + rows[i], self.samples[i], "cursor.fetchall retrieved incorrect rows" + ) + rows = cur.fetchall() + self.assertEqual( + len(rows), + 0, + "cursor.fetchall should return an empty list if called " + "after the whole result set has been fetched", + ) + _failUnless(self, cur.rowcount in (-1, len(self.samples))) + + self.executeDDL2(cur) + cur.execute("select name from %sbarflys" % self.table_prefix) + rows = cur.fetchall() + _failUnless(self, cur.rowcount in (-1, 0)) + self.assertEqual( + len(rows), + 0, + "cursor.fetchall should return an empty list if " + "a select query returns no rows", + ) + + finally: + con.close() + + def test_mixedfetch(self): + con = self._connect() + try: + cur = con.cursor() + self.executeDDL1(cur) + for sql in self._populate(): + cur.execute(sql) + + cur.execute("select name from %sbooze" % self.table_prefix) + rows1 = cur.fetchone() + rows23 = cur.fetchmany(2) + rows4 = cur.fetchone() + rows56 = cur.fetchall() + _failUnless(self, cur.rowcount in (-1, 6)) + self.assertEqual( + len(rows23), 2, "fetchmany returned incorrect number of rows" + ) + self.assertEqual( + len(rows56), 2, "fetchall returned incorrect number of rows" + ) + + rows = [rows1[0]] + rows.extend([rows23[0][0], rows23[1][0]]) + rows.append(rows4[0]) + rows.extend([rows56[0][0], rows56[1][0]]) + rows.sort() + for i in range(0, len(self.samples)): + self.assertEqual( + rows[i], self.samples[i], "incorrect data retrieved or inserted" + ) + finally: + con.close() + + def help_nextset_setUp(self, cur): + """Should create a procedure called deleteme + that returns two result sets, first the + number of rows in booze then "name from booze" + """ + raise NotImplementedError("Helper not implemented") + # sql=""" + # create procedure deleteme as + # begin + # select count(*) from booze + # select name from booze + # end + # """ + # cur.execute(sql) + + def help_nextset_tearDown(self, cur): + "If cleaning up is needed after nextSetTest" + raise NotImplementedError("Helper not implemented") + # cur.execute("drop procedure deleteme") + + def test_nextset(self): + con = self._connect() + try: + cur = con.cursor() + if not hasattr(cur, "nextset"): + return + + try: + self.executeDDL1(cur) + sql = self._populate() + for sql in self._populate(): + cur.execute(sql) + + self.help_nextset_setUp(cur) + + cur.callproc("deleteme") + numberofrows = cur.fetchone() + assert numberofrows[0] == len(self.samples) + assert cur.nextset() + names = cur.fetchall() + assert len(names) == len(self.samples) + s = cur.nextset() + assert s == None, "No more return sets, should return None" + finally: + self.help_nextset_tearDown(cur) + + finally: + con.close() + + def test_nextset(self): + raise NotImplementedError("Drivers need to override this test") + + def test_arraysize(self): + # Not much here - rest of the tests for this are in test_fetchmany + con = self._connect() + try: + cur = con.cursor() + _failUnless( + self, hasattr(cur, "arraysize"), "cursor.arraysize must be defined" + ) + finally: + con.close() + + def test_setinputsizes(self): + con = self._connect() + try: + cur = con.cursor() + cur.setinputsizes((25,)) + self._paraminsert(cur) # Make sure cursor still works + finally: + con.close() + + def test_setoutputsize_basic(self): + # Basic test is to make sure setoutputsize doesn't blow up + con = self._connect() + try: + cur = con.cursor() + cur.setoutputsize(1000) + cur.setoutputsize(2000, 0) + self._paraminsert(cur) # Make sure the cursor still works + finally: + con.close() + + def test_setoutputsize(self): + # Real test for setoutputsize is driver dependant + raise NotImplementedError("Driver needed to override this test") + + def test_None(self): + con = self._connect() + try: + cur = con.cursor() + self.executeDDL1(cur) + cur.execute("insert into %sbooze values (NULL)" % self.table_prefix) + cur.execute("select name from %sbooze" % self.table_prefix) + r = cur.fetchall() + self.assertEqual(len(r), 1) + self.assertEqual(len(r[0]), 1) + self.assertEqual(r[0][0], None, "NULL value not returned as None") + finally: + con.close() + + def test_Date(self): + d1 = self.driver.Date(2002, 12, 25) + d2 = self.driver.DateFromTicks(time.mktime((2002, 12, 25, 0, 0, 0, 0, 0, 0))) + # Can we assume this? API doesn't specify, but it seems implied + # self.assertEqual(str(d1),str(d2)) + + def test_Time(self): + t1 = self.driver.Time(13, 45, 30) + t2 = self.driver.TimeFromTicks(time.mktime((2001, 1, 1, 13, 45, 30, 0, 0, 0))) + # Can we assume this? API doesn't specify, but it seems implied + # self.assertEqual(str(t1),str(t2)) + + def test_Timestamp(self): + t1 = self.driver.Timestamp(2002, 12, 25, 13, 45, 30) + t2 = self.driver.TimestampFromTicks( + time.mktime((2002, 12, 25, 13, 45, 30, 0, 0, 0)) + ) + # Can we assume this? API doesn't specify, but it seems implied + # self.assertEqual(str(t1),str(t2)) + + def test_Binary(self): + b = self.driver.Binary(str2bytes("Something")) + b = self.driver.Binary(str2bytes("")) + + def test_STRING(self): + _failUnless( + self, hasattr(self.driver, "STRING"), "module.STRING must be defined" + ) + + def test_BINARY(self): + _failUnless( + self, hasattr(self.driver, "BINARY"), "module.BINARY must be defined." + ) + + def test_NUMBER(self): + _failUnless( + self, hasattr(self.driver, "NUMBER"), "module.NUMBER must be defined." + ) + + def test_DATETIME(self): + _failUnless( + self, hasattr(self.driver, "DATETIME"), "module.DATETIME must be defined." + ) + + def test_ROWID(self): + _failUnless( + self, hasattr(self.driver, "ROWID"), "module.ROWID must be defined." + ) diff --git a/lib/adodbapi/test/is64bit.py b/lib/adodbapi/test/is64bit.py new file mode 100644 index 00000000..39834540 --- /dev/null +++ b/lib/adodbapi/test/is64bit.py @@ -0,0 +1,41 @@ +"""is64bit.Python() --> boolean value of detected Python word size. is64bit.os() --> os build version""" +import sys + + +def Python(): + if sys.platform == "cli": # IronPython + import System + + return System.IntPtr.Size == 8 + else: + try: + return sys.maxsize > 2147483647 + except AttributeError: + return sys.maxint > 2147483647 + + +def os(): + import platform + + pm = platform.machine() + if pm != ".." and pm.endswith("64"): # recent Python (not Iron) + return True + else: + import os + + if "PROCESSOR_ARCHITEW6432" in os.environ: + return True # 32 bit program running on 64 bit Windows + try: + return os.environ["PROCESSOR_ARCHITECTURE"].endswith( + "64" + ) # 64 bit Windows 64 bit program + except IndexError: + pass # not Windows + try: + return "64" in platform.architecture()[0] # this often works in Linux + except: + return False # is an older version of Python, assume also an older os (best we can guess) + + +if __name__ == "__main__": + print("is64bit.Python() =", Python(), "is64bit.os() =", os()) diff --git a/lib/adodbapi/test/setuptestframework.py b/lib/adodbapi/test/setuptestframework.py new file mode 100644 index 00000000..fcaaf1ae --- /dev/null +++ b/lib/adodbapi/test/setuptestframework.py @@ -0,0 +1,134 @@ +#!/usr/bin/python2 +# Configure this in order to run the testcases. +"setuptestframework.py v 2.6.0.8" +import os +import shutil +import sys +import tempfile + +try: + OSErrors = (WindowsError, OSError) +except NameError: # not running on Windows + OSErrors = OSError + + +def maketemp(): + temphome = tempfile.gettempdir() + tempdir = os.path.join(temphome, "adodbapi_test") + try: + os.mkdir(tempdir) + except: + pass + return tempdir + + +def _cleanup_function(testfolder, mdb_name): + try: + os.unlink(os.path.join(testfolder, mdb_name)) + except: + pass # mdb database not present + try: + shutil.rmtree(testfolder) + print(" cleaned up folder", testfolder) + except: + pass # test package not present + + +def getcleanupfunction(): + return _cleanup_function + + +def find_ado_path(): + adoName = os.path.normpath(os.getcwd() + "/../../adodbapi.py") + adoPackage = os.path.dirname(adoName) + return adoPackage + + +# make a new package directory for the test copy of ado +def makeadopackage(testfolder): + adoName = os.path.normpath(os.getcwd() + "/../adodbapi.py") + adoPath = os.path.dirname(adoName) + if os.path.exists(adoName): + newpackage = os.path.join(testfolder, "adodbapi") + try: + os.mkdir(newpackage) + except OSErrors: + print( + "*Note: temporary adodbapi package already exists: may be two versions running?" + ) + for f in os.listdir(adoPath): + if f.endswith(".py"): + shutil.copy(os.path.join(adoPath, f), newpackage) + if sys.version_info >= (3, 0): # only when running Py3.n + save = sys.stdout + sys.stdout = None + from lib2to3.main import main # use 2to3 to make test package + + main("lib2to3.fixes", args=["-n", "-w", newpackage]) + sys.stdout = save + return testfolder + else: + raise EnvironmentError("Connot find source of adodbapi to test.") + + +def makemdb(testfolder, mdb_name): + # following setup code borrowed from pywin32 odbc test suite + # kindly contributed by Frank Millman. + import os + + _accessdatasource = os.path.join(testfolder, mdb_name) + if os.path.isfile(_accessdatasource): + print("using JET database=", _accessdatasource) + else: + try: + from win32com.client import constants + from win32com.client.gencache import EnsureDispatch + + win32 = True + except ImportError: # perhaps we are running IronPython + win32 = False # iron Python + try: + from System import Activator, Type + except: + pass + + # Create a brand-new database - what is the story with these? + dbe = None + for suffix in (".36", ".35", ".30"): + try: + if win32: + dbe = EnsureDispatch("DAO.DBEngine" + suffix) + else: + type = Type.GetTypeFromProgID("DAO.DBEngine" + suffix) + dbe = Activator.CreateInstance(type) + break + except: + pass + if dbe: + print(" ...Creating ACCESS db at " + _accessdatasource) + if win32: + workspace = dbe.Workspaces(0) + newdb = workspace.CreateDatabase( + _accessdatasource, constants.dbLangGeneral, constants.dbVersion40 + ) + else: + newdb = dbe.CreateDatabase( + _accessdatasource, ";LANGID=0x0409;CP=1252;COUNTRY=0" + ) + newdb.Close() + else: + print(" ...copying test ACCESS db to " + _accessdatasource) + mdbName = os.path.abspath( + os.path.join(os.path.dirname(__file__), "..", "examples", "test.mdb") + ) + import shutil + + shutil.copy(mdbName, _accessdatasource) + + return _accessdatasource + + +if __name__ == "__main__": + print("Setting up a Jet database for server to use for remote testing...") + temp = maketemp() + makemdb(temp, "server_test.mdb") diff --git a/lib/adodbapi/test/test_adodbapi_dbapi20.py b/lib/adodbapi/test/test_adodbapi_dbapi20.py new file mode 100644 index 00000000..f8986484 --- /dev/null +++ b/lib/adodbapi/test/test_adodbapi_dbapi20.py @@ -0,0 +1,200 @@ +print("This module depends on the dbapi20 compliance tests created by Stuart Bishop") +print("(see db-sig mailing list history for info)") +import platform +import sys +import unittest + +import dbapi20 +import setuptestframework + +testfolder = setuptestframework.maketemp() +if "--package" in sys.argv: + pth = setuptestframework.makeadopackage(testfolder) + sys.argv.remove("--package") +else: + pth = setuptestframework.find_ado_path() +if pth not in sys.path: + sys.path.insert(1, pth) +# function to clean up the temporary folder -- calling program must run this function before exit. +cleanup = setuptestframework.getcleanupfunction() + +import adodbapi +import adodbapi.is64bit as is64bit + +db = adodbapi + +if "--verbose" in sys.argv: + db.adodbapi.verbose = 3 + +print(adodbapi.version) +print("Tested with dbapi20 %s" % dbapi20.__version__) + +try: + onWindows = bool(sys.getwindowsversion()) # seems to work on all versions of Python +except: + onWindows = False + +node = platform.node() + +conn_kws = {} +host = "testsql.2txt.us,1430" # if None, will use macro to fill in node name +instance = r"%s\SQLEXPRESS" +conn_kws["name"] = "adotest" + +conn_kws["user"] = "adotestuser" # None implies Windows security +conn_kws["password"] = "Sq1234567" +# macro definition for keyword "security" using macro "auto_security" +conn_kws["macro_auto_security"] = "security" + +if host is None: + conn_kws["macro_getnode"] = ["host", instance] +else: + conn_kws["host"] = host + +conn_kws[ + "provider" +] = "Provider=MSOLEDBSQL;DataTypeCompatibility=80;MARS Connection=True;" +connStr = "%(provider)s; %(security)s; Initial Catalog=%(name)s;Data Source=%(host)s" + +if onWindows and node != "z-PC": + pass # default should make a local SQL Server connection +elif node == "xxx": # try Postgres database + _computername = "25.223.161.222" + _databasename = "adotest" + _username = "adotestuser" + _password = "12345678" + _driver = "PostgreSQL Unicode" + _provider = "" + connStr = "%sDriver={%s};Server=%s;Database=%s;uid=%s;pwd=%s;" % ( + _provider, + _driver, + _computername, + _databasename, + _username, + _password, + ) +elif node == "yyy": # ACCESS data base is known to fail some tests. + if is64bit.Python(): + driver = "Microsoft.ACE.OLEDB.12.0" + else: + driver = "Microsoft.Jet.OLEDB.4.0" + testmdb = setuptestframework.makemdb(testfolder) + connStr = r"Provider=%s;Data Source=%s" % (driver, testmdb) +else: # try a remote connection to an SQL server + conn_kws["proxy_host"] = "25.44.77.176" + import adodbapi.remote + + db = adodbapi.remote + +print("Using Connection String like=%s" % connStr) +print("Keywords=%s" % repr(conn_kws)) + + +class test_adodbapi(dbapi20.DatabaseAPI20Test): + driver = db + connect_args = (connStr,) + connect_kw_args = conn_kws + + def __init__(self, arg): + dbapi20.DatabaseAPI20Test.__init__(self, arg) + + def getTestMethodName(self): + return self.id().split(".")[-1] + + def setUp(self): + # Call superclass setUp In case this does something in the + # future + dbapi20.DatabaseAPI20Test.setUp(self) + if self.getTestMethodName() == "test_callproc": + con = self._connect() + engine = con.dbms_name + ## print('Using database Engine=%s' % engine) ## + if engine != "MS Jet": + sql = """ + create procedure templower + @theData varchar(50) + as + select lower(@theData) + """ + else: # Jet + sql = """ + create procedure templower + (theData varchar(50)) + as + select lower(theData); + """ + cur = con.cursor() + try: + cur.execute(sql) + con.commit() + except: + pass + cur.close() + con.close() + self.lower_func = "templower" + + def tearDown(self): + if self.getTestMethodName() == "test_callproc": + con = self._connect() + cur = con.cursor() + try: + cur.execute("drop procedure templower") + except: + pass + con.commit() + dbapi20.DatabaseAPI20Test.tearDown(self) + + def help_nextset_setUp(self, cur): + "Should create a procedure called deleteme" + 'that returns two result sets, first the number of rows in booze then "name from booze"' + sql = """ + create procedure deleteme as + begin + select count(*) from %sbooze + select name from %sbooze + end + """ % ( + self.table_prefix, + self.table_prefix, + ) + cur.execute(sql) + + def help_nextset_tearDown(self, cur): + "If cleaning up is needed after nextSetTest" + try: + cur.execute("drop procedure deleteme") + except: + pass + + def test_nextset(self): + con = self._connect() + try: + cur = con.cursor() + + stmts = [self.ddl1] + self._populate() + for sql in stmts: + cur.execute(sql) + + self.help_nextset_setUp(cur) + + cur.callproc("deleteme") + numberofrows = cur.fetchone() + assert numberofrows[0] == 6 + assert cur.nextset() + names = cur.fetchall() + assert len(names) == len(self.samples) + s = cur.nextset() + assert s == None, "No more return sets, should return None" + finally: + try: + self.help_nextset_tearDown(cur) + finally: + con.close() + + def test_setoutputsize(self): + pass + + +if __name__ == "__main__": + unittest.main() + cleanup(testfolder, None) diff --git a/lib/adodbapi/test/tryconnection.py b/lib/adodbapi/test/tryconnection.py new file mode 100644 index 00000000..9d3901a8 --- /dev/null +++ b/lib/adodbapi/test/tryconnection.py @@ -0,0 +1,33 @@ +remote = False # automatic testing of remote access has been removed here + + +def try_connection(verbose, *args, **kwargs): + import adodbapi + + dbconnect = adodbapi.connect + try: + s = dbconnect(*args, **kwargs) # connect to server + if verbose: + print("Connected to:", s.connection_string) + print("which has tables:", s.get_table_names()) + s.close() # thanks, it worked, goodbye + except adodbapi.DatabaseError as inst: + print(inst.args[0]) # should be the error message + print("***Failed getting connection using=", repr(args), repr(kwargs)) + return False, (args, kwargs), None + + print(" (successful)") + + return True, (args, kwargs, remote), dbconnect + + +def try_operation_with_expected_exception( + expected_exception_list, some_function, *args, **kwargs +): + try: + some_function(*args, **kwargs) + except expected_exception_list as e: + return True, e + except: + raise # an exception other than the expected occurred + return False, "The expected exception did not occur" diff --git a/lib/annotated_types/__init__.py b/lib/annotated_types/__init__.py new file mode 100644 index 00000000..2f989504 --- /dev/null +++ b/lib/annotated_types/__init__.py @@ -0,0 +1,396 @@ +import math +import sys +from dataclasses import dataclass +from datetime import timezone +from typing import TYPE_CHECKING, Any, Callable, Iterator, Optional, SupportsFloat, SupportsIndex, TypeVar, Union + +if sys.version_info < (3, 8): + from typing_extensions import Protocol, runtime_checkable +else: + from typing import Protocol, runtime_checkable + +if sys.version_info < (3, 9): + from typing_extensions import Annotated, Literal +else: + from typing import Annotated, Literal + +if sys.version_info < (3, 10): + EllipsisType = type(Ellipsis) + KW_ONLY = {} + SLOTS = {} +else: + from types import EllipsisType + + KW_ONLY = {"kw_only": True} + SLOTS = {"slots": True} + + +__all__ = ( + 'BaseMetadata', + 'GroupedMetadata', + 'Gt', + 'Ge', + 'Lt', + 'Le', + 'Interval', + 'MultipleOf', + 'MinLen', + 'MaxLen', + 'Len', + 'Timezone', + 'Predicate', + 'LowerCase', + 'UpperCase', + 'IsDigits', + 'IsFinite', + 'IsNotFinite', + 'IsNan', + 'IsNotNan', + 'IsInfinite', + 'IsNotInfinite', + 'doc', + 'DocInfo', + '__version__', +) + +__version__ = '0.6.0' + + +T = TypeVar('T') + + +# arguments that start with __ are considered +# positional only +# see https://peps.python.org/pep-0484/#positional-only-arguments + + +class SupportsGt(Protocol): + def __gt__(self: T, __other: T) -> bool: + ... + + +class SupportsGe(Protocol): + def __ge__(self: T, __other: T) -> bool: + ... + + +class SupportsLt(Protocol): + def __lt__(self: T, __other: T) -> bool: + ... + + +class SupportsLe(Protocol): + def __le__(self: T, __other: T) -> bool: + ... + + +class SupportsMod(Protocol): + def __mod__(self: T, __other: T) -> T: + ... + + +class SupportsDiv(Protocol): + def __div__(self: T, __other: T) -> T: + ... + + +class BaseMetadata: + """Base class for all metadata. + + This exists mainly so that implementers + can do `isinstance(..., BaseMetadata)` while traversing field annotations. + """ + + __slots__ = () + + +@dataclass(frozen=True, **SLOTS) +class Gt(BaseMetadata): + """Gt(gt=x) implies that the value must be greater than x. + + It can be used with any type that supports the ``>`` operator, + including numbers, dates and times, strings, sets, and so on. + """ + + gt: SupportsGt + + +@dataclass(frozen=True, **SLOTS) +class Ge(BaseMetadata): + """Ge(ge=x) implies that the value must be greater than or equal to x. + + It can be used with any type that supports the ``>=`` operator, + including numbers, dates and times, strings, sets, and so on. + """ + + ge: SupportsGe + + +@dataclass(frozen=True, **SLOTS) +class Lt(BaseMetadata): + """Lt(lt=x) implies that the value must be less than x. + + It can be used with any type that supports the ``<`` operator, + including numbers, dates and times, strings, sets, and so on. + """ + + lt: SupportsLt + + +@dataclass(frozen=True, **SLOTS) +class Le(BaseMetadata): + """Le(le=x) implies that the value must be less than or equal to x. + + It can be used with any type that supports the ``<=`` operator, + including numbers, dates and times, strings, sets, and so on. + """ + + le: SupportsLe + + +@runtime_checkable +class GroupedMetadata(Protocol): + """A grouping of multiple BaseMetadata objects. + + `GroupedMetadata` on its own is not metadata and has no meaning. + All it the the constraint and metadata should be fully expressable + in terms of the `BaseMetadata`'s returned by `GroupedMetadata.__iter__()`. + + Concrete implementations should override `GroupedMetadata.__iter__()` + to add their own metadata. + For example: + + >>> @dataclass + >>> class Field(GroupedMetadata): + >>> gt: float | None = None + >>> description: str | None = None + ... + >>> def __iter__(self) -> Iterable[BaseMetadata]: + >>> if self.gt is not None: + >>> yield Gt(self.gt) + >>> if self.description is not None: + >>> yield Description(self.gt) + + Also see the implementation of `Interval` below for an example. + + Parsers should recognize this and unpack it so that it can be used + both with and without unpacking: + + - `Annotated[int, Field(...)]` (parser must unpack Field) + - `Annotated[int, *Field(...)]` (PEP-646) + """ # noqa: trailing-whitespace + + @property + def __is_annotated_types_grouped_metadata__(self) -> Literal[True]: + return True + + def __iter__(self) -> Iterator[BaseMetadata]: + ... + + if not TYPE_CHECKING: + __slots__ = () # allow subclasses to use slots + + def __init_subclass__(cls, *args: Any, **kwargs: Any) -> None: + # Basic ABC like functionality without the complexity of an ABC + super().__init_subclass__(*args, **kwargs) + if cls.__iter__ is GroupedMetadata.__iter__: + raise TypeError("Can't subclass GroupedMetadata without implementing __iter__") + + def __iter__(self) -> Iterator[BaseMetadata]: # noqa: F811 + raise NotImplementedError # more helpful than "None has no attribute..." type errors + + +@dataclass(frozen=True, **KW_ONLY, **SLOTS) +class Interval(GroupedMetadata): + """Interval can express inclusive or exclusive bounds with a single object. + + It accepts keyword arguments ``gt``, ``ge``, ``lt``, and/or ``le``, which + are interpreted the same way as the single-bound constraints. + """ + + gt: Union[SupportsGt, None] = None + ge: Union[SupportsGe, None] = None + lt: Union[SupportsLt, None] = None + le: Union[SupportsLe, None] = None + + def __iter__(self) -> Iterator[BaseMetadata]: + """Unpack an Interval into zero or more single-bounds.""" + if self.gt is not None: + yield Gt(self.gt) + if self.ge is not None: + yield Ge(self.ge) + if self.lt is not None: + yield Lt(self.lt) + if self.le is not None: + yield Le(self.le) + + +@dataclass(frozen=True, **SLOTS) +class MultipleOf(BaseMetadata): + """MultipleOf(multiple_of=x) might be interpreted in two ways: + + 1. Python semantics, implying ``value % multiple_of == 0``, or + 2. JSONschema semantics, where ``int(value / multiple_of) == value / multiple_of`` + + We encourage users to be aware of these two common interpretations, + and libraries to carefully document which they implement. + """ + + multiple_of: Union[SupportsDiv, SupportsMod] + + +@dataclass(frozen=True, **SLOTS) +class MinLen(BaseMetadata): + """ + MinLen() implies minimum inclusive length, + e.g. ``len(value) >= min_length``. + """ + + min_length: Annotated[int, Ge(0)] + + +@dataclass(frozen=True, **SLOTS) +class MaxLen(BaseMetadata): + """ + MaxLen() implies maximum inclusive length, + e.g. ``len(value) <= max_length``. + """ + + max_length: Annotated[int, Ge(0)] + + +@dataclass(frozen=True, **SLOTS) +class Len(GroupedMetadata): + """ + Len() implies that ``min_length <= len(value) <= max_length``. + + Upper bound may be omitted or ``None`` to indicate no upper length bound. + """ + + min_length: Annotated[int, Ge(0)] = 0 + max_length: Optional[Annotated[int, Ge(0)]] = None + + def __iter__(self) -> Iterator[BaseMetadata]: + """Unpack a Len into zone or more single-bounds.""" + if self.min_length > 0: + yield MinLen(self.min_length) + if self.max_length is not None: + yield MaxLen(self.max_length) + + +@dataclass(frozen=True, **SLOTS) +class Timezone(BaseMetadata): + """Timezone(tz=...) requires a datetime to be aware (or ``tz=None``, naive). + + ``Annotated[datetime, Timezone(None)]`` must be a naive datetime. + ``Timezone[...]`` (the ellipsis literal) expresses that the datetime must be + tz-aware but any timezone is allowed. + + You may also pass a specific timezone string or timezone object such as + ``Timezone(timezone.utc)`` or ``Timezone("Africa/Abidjan")`` to express that + you only allow a specific timezone, though we note that this is often + a symptom of poor design. + """ + + tz: Union[str, timezone, EllipsisType, None] + + +@dataclass(frozen=True, **SLOTS) +class Predicate(BaseMetadata): + """``Predicate(func: Callable)`` implies `func(value)` is truthy for valid values. + + Users should prefer statically inspectable metadata, but if you need the full + power and flexibility of arbitrary runtime predicates... here it is. + + We provide a few predefined predicates for common string constraints: + ``IsLower = Predicate(str.islower)``, ``IsUpper = Predicate(str.isupper)``, and + ``IsDigit = Predicate(str.isdigit)``. Users are encouraged to use methods which + can be given special handling, and avoid indirection like ``lambda s: s.lower()``. + + Some libraries might have special logic to handle certain predicates, e.g. by + checking for `str.isdigit` and using its presence to both call custom logic to + enforce digit-only strings, and customise some generated external schema. + + We do not specify what behaviour should be expected for predicates that raise + an exception. For example `Annotated[int, Predicate(str.isdigit)]` might silently + skip invalid constraints, or statically raise an error; or it might try calling it + and then propogate or discard the resulting exception. + """ + + func: Callable[[Any], bool] + + +@dataclass +class Not: + func: Callable[[Any], bool] + + def __call__(self, __v: Any) -> bool: + return not self.func(__v) + + +_StrType = TypeVar("_StrType", bound=str) + +LowerCase = Annotated[_StrType, Predicate(str.islower)] +""" +Return True if the string is a lowercase string, False otherwise. + +A string is lowercase if all cased characters in the string are lowercase and there is at least one cased character in the string. +""" # noqa: E501 +UpperCase = Annotated[_StrType, Predicate(str.isupper)] +""" +Return True if the string is an uppercase string, False otherwise. + +A string is uppercase if all cased characters in the string are uppercase and there is at least one cased character in the string. +""" # noqa: E501 +IsDigits = Annotated[_StrType, Predicate(str.isdigit)] +""" +Return True if the string is a digit string, False otherwise. + +A string is a digit string if all characters in the string are digits and there is at least one character in the string. +""" # noqa: E501 +IsAscii = Annotated[_StrType, Predicate(str.isascii)] +""" +Return True if all characters in the string are ASCII, False otherwise. + +ASCII characters have code points in the range U+0000-U+007F. Empty string is ASCII too. +""" + +_NumericType = TypeVar('_NumericType', bound=Union[SupportsFloat, SupportsIndex]) +IsFinite = Annotated[_NumericType, Predicate(math.isfinite)] +"""Return True if x is neither an infinity nor a NaN, and False otherwise.""" +IsNotFinite = Annotated[_NumericType, Predicate(Not(math.isfinite))] +"""Return True if x is one of infinity or NaN, and False otherwise""" +IsNan = Annotated[_NumericType, Predicate(math.isnan)] +"""Return True if x is a NaN (not a number), and False otherwise.""" +IsNotNan = Annotated[_NumericType, Predicate(Not(math.isnan))] +"""Return True if x is anything but NaN (not a number), and False otherwise.""" +IsInfinite = Annotated[_NumericType, Predicate(math.isinf)] +"""Return True if x is a positive or negative infinity, and False otherwise.""" +IsNotInfinite = Annotated[_NumericType, Predicate(Not(math.isinf))] +"""Return True if x is neither a positive or negative infinity, and False otherwise.""" + +try: + from typing_extensions import DocInfo, doc # type: ignore [attr-defined] +except ImportError: + + @dataclass(frozen=True, **SLOTS) + class DocInfo: # type: ignore [no-redef] + """ " + The return value of doc(), mainly to be used by tools that want to extract the + Annotated documentation at runtime. + """ + + documentation: str + """The documentation string passed to doc().""" + + def doc( + documentation: str, + ) -> DocInfo: + """ + Add documentation to a type annotation inside of Annotated. + + For example: + + >>> def hi(name: Annotated[int, doc("The name of the user")]) -> None: ... + """ + return DocInfo(documentation) diff --git a/lib/jaraco/classes/__init__.py b/lib/annotated_types/py.typed similarity index 100% rename from lib/jaraco/classes/__init__.py rename to lib/annotated_types/py.typed diff --git a/lib/annotated_types/test_cases.py b/lib/annotated_types/test_cases.py new file mode 100644 index 00000000..f54df700 --- /dev/null +++ b/lib/annotated_types/test_cases.py @@ -0,0 +1,147 @@ +import math +import sys +from datetime import date, datetime, timedelta, timezone +from decimal import Decimal +from typing import Any, Dict, Iterable, Iterator, List, NamedTuple, Set, Tuple + +if sys.version_info < (3, 9): + from typing_extensions import Annotated +else: + from typing import Annotated + +import annotated_types as at + + +class Case(NamedTuple): + """ + A test case for `annotated_types`. + """ + + annotation: Any + valid_cases: Iterable[Any] + invalid_cases: Iterable[Any] + + +def cases() -> Iterable[Case]: + # Gt, Ge, Lt, Le + yield Case(Annotated[int, at.Gt(4)], (5, 6, 1000), (4, 0, -1)) + yield Case(Annotated[float, at.Gt(0.5)], (0.6, 0.7, 0.8, 0.9), (0.5, 0.0, -0.1)) + yield Case( + Annotated[datetime, at.Gt(datetime(2000, 1, 1))], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + [datetime(2000, 1, 1), datetime(1999, 12, 31)], + ) + yield Case( + Annotated[datetime, at.Gt(date(2000, 1, 1))], + [date(2000, 1, 2), date(2000, 1, 3)], + [date(2000, 1, 1), date(1999, 12, 31)], + ) + yield Case( + Annotated[datetime, at.Gt(Decimal('1.123'))], + [Decimal('1.1231'), Decimal('123')], + [Decimal('1.123'), Decimal('0')], + ) + + yield Case(Annotated[int, at.Ge(4)], (4, 5, 6, 1000, 4), (0, -1)) + yield Case(Annotated[float, at.Ge(0.5)], (0.5, 0.6, 0.7, 0.8, 0.9), (0.4, 0.0, -0.1)) + yield Case( + Annotated[datetime, at.Ge(datetime(2000, 1, 1))], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + [datetime(1998, 1, 1), datetime(1999, 12, 31)], + ) + + yield Case(Annotated[int, at.Lt(4)], (0, -1), (4, 5, 6, 1000, 4)) + yield Case(Annotated[float, at.Lt(0.5)], (0.4, 0.0, -0.1), (0.5, 0.6, 0.7, 0.8, 0.9)) + yield Case( + Annotated[datetime, at.Lt(datetime(2000, 1, 1))], + [datetime(1999, 12, 31), datetime(1999, 12, 31)], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + ) + + yield Case(Annotated[int, at.Le(4)], (4, 0, -1), (5, 6, 1000)) + yield Case(Annotated[float, at.Le(0.5)], (0.5, 0.0, -0.1), (0.6, 0.7, 0.8, 0.9)) + yield Case( + Annotated[datetime, at.Le(datetime(2000, 1, 1))], + [datetime(2000, 1, 1), datetime(1999, 12, 31)], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + ) + + # Interval + yield Case(Annotated[int, at.Interval(gt=4)], (5, 6, 1000), (4, 0, -1)) + yield Case(Annotated[int, at.Interval(gt=4, lt=10)], (5, 6), (4, 10, 1000, 0, -1)) + yield Case(Annotated[float, at.Interval(ge=0.5, le=1)], (0.5, 0.9, 1), (0.49, 1.1)) + yield Case( + Annotated[datetime, at.Interval(gt=datetime(2000, 1, 1), le=datetime(2000, 1, 3))], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + [datetime(2000, 1, 1), datetime(2000, 1, 4)], + ) + + yield Case(Annotated[int, at.MultipleOf(multiple_of=3)], (0, 3, 9), (1, 2, 4)) + yield Case(Annotated[float, at.MultipleOf(multiple_of=0.5)], (0, 0.5, 1, 1.5), (0.4, 1.1)) + + # lengths + + yield Case(Annotated[str, at.MinLen(3)], ('123', '1234', 'x' * 10), ('', '1', '12')) + yield Case(Annotated[str, at.Len(3)], ('123', '1234', 'x' * 10), ('', '1', '12')) + yield Case(Annotated[List[int], at.MinLen(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2])) + yield Case(Annotated[List[int], at.Len(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2])) + + yield Case(Annotated[str, at.MaxLen(4)], ('', '1234'), ('12345', 'x' * 10)) + yield Case(Annotated[str, at.Len(0, 4)], ('', '1234'), ('12345', 'x' * 10)) + yield Case(Annotated[List[str], at.MaxLen(4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10)) + yield Case(Annotated[List[str], at.Len(0, 4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10)) + + yield Case(Annotated[str, at.Len(3, 5)], ('123', '12345'), ('', '1', '12', '123456', 'x' * 10)) + yield Case(Annotated[str, at.Len(3, 3)], ('123',), ('12', '1234')) + + yield Case(Annotated[Dict[int, int], at.Len(2, 3)], [{1: 1, 2: 2}], [{}, {1: 1}, {1: 1, 2: 2, 3: 3, 4: 4}]) + yield Case(Annotated[Set[int], at.Len(2, 3)], ({1, 2}, {1, 2, 3}), (set(), {1}, {1, 2, 3, 4})) + yield Case(Annotated[Tuple[int, ...], at.Len(2, 3)], ((1, 2), (1, 2, 3)), ((), (1,), (1, 2, 3, 4))) + + # Timezone + + yield Case( + Annotated[datetime, at.Timezone(None)], [datetime(2000, 1, 1)], [datetime(2000, 1, 1, tzinfo=timezone.utc)] + ) + yield Case( + Annotated[datetime, at.Timezone(...)], [datetime(2000, 1, 1, tzinfo=timezone.utc)], [datetime(2000, 1, 1)] + ) + yield Case( + Annotated[datetime, at.Timezone(timezone.utc)], + [datetime(2000, 1, 1, tzinfo=timezone.utc)], + [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))], + ) + yield Case( + Annotated[datetime, at.Timezone('Europe/London')], + [datetime(2000, 1, 1, tzinfo=timezone(timedelta(0), name='Europe/London'))], + [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))], + ) + + # predicate types + + yield Case(at.LowerCase[str], ['abc', 'foobar'], ['', 'A', 'Boom']) + yield Case(at.UpperCase[str], ['ABC', 'DEFO'], ['', 'a', 'abc', 'AbC']) + yield Case(at.IsDigits[str], ['123'], ['', 'ab', 'a1b2']) + yield Case(at.IsAscii[str], ['123', 'foo bar'], ['£100', '😊', 'whatever 👀']) + + yield Case(Annotated[int, at.Predicate(lambda x: x % 2 == 0)], [0, 2, 4], [1, 3, 5]) + + yield Case(at.IsFinite[float], [1.23], [math.nan, math.inf, -math.inf]) + yield Case(at.IsNotFinite[float], [math.nan, math.inf], [1.23]) + yield Case(at.IsNan[float], [math.nan], [1.23, math.inf]) + yield Case(at.IsNotNan[float], [1.23, math.inf], [math.nan]) + yield Case(at.IsInfinite[float], [math.inf], [math.nan, 1.23]) + yield Case(at.IsNotInfinite[float], [math.nan, 1.23], [math.inf]) + + # check stacked predicates + yield Case(at.IsInfinite[Annotated[float, at.Predicate(lambda x: x > 0)]], [math.inf], [-math.inf, 1.23, math.nan]) + + # doc + yield Case(Annotated[int, at.doc("A number")], [1, 2], []) + + # custom GroupedMetadata + class MyCustomGroupedMetadata(at.GroupedMetadata): + def __iter__(self) -> Iterator[at.Predicate]: + yield at.Predicate(lambda x: float(x).is_integer()) + + yield Case(Annotated[float, MyCustomGroupedMetadata()], [0, 2.0], [0.01, 1.5]) diff --git a/lib/autocommand/autoasync.py b/lib/autocommand/autoasync.py index 3c8ebdcf..688f7e05 100644 --- a/lib/autocommand/autoasync.py +++ b/lib/autocommand/autoasync.py @@ -20,7 +20,7 @@ from functools import wraps from inspect import signature -def _launch_forever_coro(coro, args, kwargs, loop): +async def _run_forever_coro(coro, args, kwargs, loop): ''' This helper function launches an async main function that was tagged with forever=True. There are two possibilities: @@ -48,7 +48,7 @@ def _launch_forever_coro(coro, args, kwargs, loop): # forever=True feature from autoasync at some point in the future. thing = coro(*args, **kwargs) if iscoroutine(thing): - loop.create_task(thing) + await thing def autoasync(coro=None, *, loop=None, forever=False, pass_loop=False): @@ -127,7 +127,9 @@ def autoasync(coro=None, *, loop=None, forever=False, pass_loop=False): args, kwargs = bound_args.args, bound_args.kwargs if forever: - _launch_forever_coro(coro, args, kwargs, local_loop) + local_loop.create_task(_run_forever_coro( + coro, args, kwargs, local_loop + )) local_loop.run_forever() else: return local_loop.run_until_complete(coro(*args, **kwargs)) diff --git a/lib/cherrypy/_cplogging.py b/lib/cherrypy/_cplogging.py index 151d3b40..bce1c87b 100644 --- a/lib/cherrypy/_cplogging.py +++ b/lib/cherrypy/_cplogging.py @@ -452,6 +452,6 @@ class WSGIErrorHandler(logging.Handler): class LazyRfc3339UtcTime(object): def __str__(self): - """Return now() in RFC3339 UTC Format.""" - now = datetime.datetime.now() - return now.isoformat('T') + 'Z' + """Return utcnow() in RFC3339 UTC Format.""" + iso_formatted_now = datetime.datetime.utcnow().isoformat('T') + return f'{iso_formatted_now!s}Z' diff --git a/lib/cherrypy/lib/cptools.py b/lib/cherrypy/lib/cptools.py index 613a8995..13b4c567 100644 --- a/lib/cherrypy/lib/cptools.py +++ b/lib/cherrypy/lib/cptools.py @@ -622,13 +622,15 @@ def autovary(ignore=None, debug=False): def convert_params(exception=ValueError, error=400): - """Convert request params based on function annotations, with error handling. + """Convert request params based on function annotations. - exception - Exception class to catch. + This function also processes errors that are subclasses of ``exception``. - status - The HTTP error code to return to the client on failure. + :param BaseException exception: Exception class to catch. + :type exception: BaseException + + :param error: The HTTP status code to return to the client on failure. + :type error: int """ request = cherrypy.serving.request types = request.handler.callable.__annotations__ diff --git a/lib/cherrypy/lib/profiler.py b/lib/cherrypy/lib/profiler.py index fccf2eb8..7182278a 100644 --- a/lib/cherrypy/lib/profiler.py +++ b/lib/cherrypy/lib/profiler.py @@ -47,7 +47,9 @@ try: import pstats def new_func_strip_path(func_name): - """Make profiler output more readable by adding `__init__` modules' parents + """Add ``__init__`` modules' parents. + + This makes the profiler output more readable. """ filename, line, name = func_name if filename.endswith('__init__.py'): diff --git a/lib/cherrypy/lib/reprconf.py b/lib/cherrypy/lib/reprconf.py index 76381d7b..536b9417 100644 --- a/lib/cherrypy/lib/reprconf.py +++ b/lib/cherrypy/lib/reprconf.py @@ -188,7 +188,7 @@ class Parser(configparser.ConfigParser): def dict_from_file(self, file): if hasattr(file, 'read'): - self.readfp(file) + self.read_file(file) else: self.read(file) return self.as_dict() diff --git a/lib/cherrypy/lib/static.py b/lib/cherrypy/lib/static.py index 66a5a947..c1ad95f3 100644 --- a/lib/cherrypy/lib/static.py +++ b/lib/cherrypy/lib/static.py @@ -1,19 +1,18 @@ """Module with helpers for serving static files.""" +import mimetypes import os import platform import re import stat -import mimetypes -import urllib.parse import unicodedata - +import urllib.parse from email.generator import _make_boundary as make_boundary from io import UnsupportedOperation import cherrypy from cherrypy._cpcompat import ntob -from cherrypy.lib import cptools, httputil, file_generator_limited +from cherrypy.lib import cptools, file_generator_limited, httputil def _setup_mimetypes(): @@ -185,7 +184,10 @@ def serve_fileobj(fileobj, content_type=None, disposition=None, name=None, def _serve_fileobj(fileobj, content_type, content_length, debug=False): - """Internal. Set response.body to the given file object, perhaps ranged.""" + """Set ``response.body`` to the given file object, perhaps ranged. + + Internal helper. + """ response = cherrypy.serving.response # HTTP/1.0 didn't have Range/Accept-Ranges headers, or the 206 code diff --git a/lib/cherrypy/process/wspbus.py b/lib/cherrypy/process/wspbus.py index 1d2789b1..a60cd51e 100644 --- a/lib/cherrypy/process/wspbus.py +++ b/lib/cherrypy/process/wspbus.py @@ -494,7 +494,7 @@ class Bus(object): "Cannot reconstruct command from '-c'. " 'Ref: https://github.com/cherrypy/cherrypy/issues/1545') except AttributeError: - """It looks Py_GetArgcArgv is completely absent in some environments + """It looks Py_GetArgcArgv's completely absent in some environments It is known, that there's no Py_GetArgcArgv in MS Windows and ``ctypes`` module is completely absent in Google AppEngine diff --git a/lib/cherrypy/test/test_http.py b/lib/cherrypy/test/test_http.py index a955be43..9a7e9331 100644 --- a/lib/cherrypy/test/test_http.py +++ b/lib/cherrypy/test/test_http.py @@ -136,6 +136,9 @@ class HTTPTests(helper.CPWebCase): self.assertStatus(200) self.assertBody(b'Hello world!') + response.close() + c.close() + # Now send a message that has no Content-Length, but does send a body. # Verify that CP times out the socket and responds # with 411 Length Required. @@ -159,6 +162,9 @@ class HTTPTests(helper.CPWebCase): self.status = str(response.status) self.assertStatus(411) + response.close() + c.close() + def test_post_multipart(self): alphabet = 'abcdefghijklmnopqrstuvwxyz' # generate file contents for a large post @@ -184,6 +190,9 @@ class HTTPTests(helper.CPWebCase): parts = ['%s * 65536' % ch for ch in alphabet] self.assertBody(', '.join(parts)) + response.close() + c.close() + def test_post_filename_with_special_characters(self): """Testing that we can handle filenames with special characters. @@ -217,6 +226,9 @@ class HTTPTests(helper.CPWebCase): self.assertStatus(200) self.assertBody(fname) + response.close() + c.close() + def test_malformed_request_line(self): if getattr(cherrypy.server, 'using_apache', False): return self.skip('skipped due to known Apache differences...') @@ -264,6 +276,9 @@ class HTTPTests(helper.CPWebCase): self.body = response.fp.read(20) self.assertBody('Illegal header line.') + response.close() + c.close() + def test_http_over_https(self): if self.scheme != 'https': return self.skip('skipped (not running HTTPS)... ') diff --git a/lib/cherrypy/test/test_iterator.py b/lib/cherrypy/test/test_iterator.py index 6600a78d..5bad59be 100644 --- a/lib/cherrypy/test/test_iterator.py +++ b/lib/cherrypy/test/test_iterator.py @@ -150,6 +150,8 @@ class IteratorTest(helper.CPWebCase): self.assertStatus(200) self.assertBody('0') + itr_conn.close() + # Now we do the same check with streaming - some classes will # be automatically closed, while others cannot. stream_counts = {} diff --git a/lib/cherrypy/test/test_logging.py b/lib/cherrypy/test/test_logging.py index 2d4aa56f..49d41d0a 100644 --- a/lib/cherrypy/test/test_logging.py +++ b/lib/cherrypy/test/test_logging.py @@ -1,5 +1,6 @@ """Basic tests for the CherryPy core: request handling.""" +import datetime import logging from cheroot.test import webtest @@ -197,6 +198,33 @@ def test_custom_log_format(log_tracker, monkeypatch, server): ) +def test_utc_in_timez(monkeypatch): + """Test that ``LazyRfc3339UtcTime`` is rendered as ``str`` using UTC timestamp.""" + utcoffset8_local_time_in_naive_utc = ( + datetime.datetime( + year=2020, + month=1, + day=1, + hour=1, + minute=23, + second=45, + tzinfo=datetime.timezone(datetime.timedelta(hours=8)), + ) + .astimezone(datetime.timezone.utc) + .replace(tzinfo=None) + ) + + class mock_datetime: + @classmethod + def utcnow(cls): + return utcoffset8_local_time_in_naive_utc + + monkeypatch.setattr('datetime.datetime', mock_datetime) + rfc3339_utc_time = str(cherrypy._cplogging.LazyRfc3339UtcTime()) + expected_time = '2019-12-31T17:23:45Z' + assert rfc3339_utc_time == expected_time + + def test_timez_log_format(log_tracker, monkeypatch, server): """Test a customized access_log_format string, which is a feature of _cplogging.LogManager.access().""" diff --git a/lib/inflect/__init__.py b/lib/inflect/__init__.py index 78d2e33c..b638c6b8 100644 --- a/lib/inflect/__init__.py +++ b/lib/inflect/__init__.py @@ -3,8 +3,6 @@ inflect: english language inflection - correctly generate plurals, ordinals, indefinite articles - convert numbers to words -Copyright (C) 2010 Paul Dyson - Based upon the Perl module `Lingua::EN::Inflect `_. @@ -70,11 +68,16 @@ from typing import ( cast, Any, ) +from typing_extensions import Literal from numbers import Number -from pydantic import Field, validate_arguments -from pydantic.typing import Annotated +from pydantic import Field +from typing_extensions import Annotated + + +from .compat.pydantic1 import validate_call +from .compat.pydantic import same_method class UnknownClassicalModeError(Exception): @@ -105,14 +108,6 @@ class BadGenderError(Exception): pass -STDOUT_ON = False - - -def print3(txt: str) -> None: - if STDOUT_ON: - print(txt) - - def enclose(s: str) -> str: return f"(?:{s})" @@ -1727,66 +1722,44 @@ plverb_irregular_pres = { "is": "are", "was": "were", "were": "were", - "was": "were", - "have": "have", "have": "have", "has": "have", "do": "do", - "do": "do", "does": "do", } plverb_ambiguous_pres = { - "act": "act", "act": "act", "acts": "act", "blame": "blame", - "blame": "blame", "blames": "blame", "can": "can", - "can": "can", - "can": "can", "must": "must", - "must": "must", - "must": "must", - "fly": "fly", "fly": "fly", "flies": "fly", "copy": "copy", - "copy": "copy", "copies": "copy", "drink": "drink", - "drink": "drink", "drinks": "drink", "fight": "fight", - "fight": "fight", "fights": "fight", "fire": "fire", - "fire": "fire", "fires": "fire", "like": "like", - "like": "like", "likes": "like", "look": "look", - "look": "look", "looks": "look", "make": "make", - "make": "make", "makes": "make", "reach": "reach", - "reach": "reach", "reaches": "reach", "run": "run", - "run": "run", "runs": "run", "sink": "sink", - "sink": "sink", "sinks": "sink", "sleep": "sleep", - "sleep": "sleep", "sleeps": "sleep", "view": "view", - "view": "view", "views": "view", } @@ -1854,7 +1827,7 @@ pl_adj_poss_keys = re.compile(fr"^({enclose('|'.join(pl_adj_poss))})$", re.IGNOR A_abbrev = re.compile( r""" -(?! FJO | [HLMNS]Y. | RY[EO] | SQU +^(?! FJO | [HLMNS]Y. | RY[EO] | SQU | ( F[LR]? | [HL] | MN? | N | RH? | S[CHKLMNPTVW]? | X(YL)?) [AEIOU]) [FHLMNRSX][A-Z] """, @@ -2053,15 +2026,14 @@ Falsish = Any # ideally, falsish would only validate on bool(value) is False class engine: def __init__(self) -> None: - self.classical_dict = def_classical.copy() self.persistent_count: Optional[int] = None self.mill_count = 0 - self.pl_sb_user_defined: List[str] = [] - self.pl_v_user_defined: List[str] = [] - self.pl_adj_user_defined: List[str] = [] - self.si_sb_user_defined: List[str] = [] - self.A_a_user_defined: List[str] = [] + self.pl_sb_user_defined: List[Optional[Word]] = [] + self.pl_v_user_defined: List[Optional[Word]] = [] + self.pl_adj_user_defined: List[Optional[Word]] = [] + self.si_sb_user_defined: List[Optional[Word]] = [] + self.A_a_user_defined: List[Optional[Word]] = [] self.thegender = "neuter" self.__number_args: Optional[Dict[str, str]] = None @@ -2073,28 +2045,8 @@ class engine: def _number_args(self, val): self.__number_args = val - deprecated_methods = dict( - pl="plural", - plnoun="plural_noun", - plverb="plural_verb", - pladj="plural_adj", - sinoun="single_noun", - prespart="present_participle", - numwords="number_to_words", - plequal="compare", - plnounequal="compare_nouns", - plverbequal="compare_verbs", - pladjequal="compare_adjs", - wordlist="join", - ) - - def __getattr__(self, meth): - if meth in self.deprecated_methods: - print3(f"{meth}() deprecated, use {self.deprecated_methods[meth]}()") - raise DeprecationWarning - raise AttributeError - - def defnoun(self, singular: str, plural: str) -> int: + @validate_call + def defnoun(self, singular: Optional[Word], plural: Optional[Word]) -> int: """ Set the noun plural of singular to plural. @@ -2105,7 +2057,16 @@ class engine: self.si_sb_user_defined.extend((plural, singular)) return 1 - def defverb(self, s1: str, p1: str, s2: str, p2: str, s3: str, p3: str) -> int: + @validate_call + def defverb( + self, + s1: Optional[Word], + p1: Optional[Word], + s2: Optional[Word], + p2: Optional[Word], + s3: Optional[Word], + p3: Optional[Word], + ) -> int: """ Set the verb plurals for s1, s2 and s3 to p1, p2 and p3 respectively. @@ -2121,7 +2082,8 @@ class engine: self.pl_v_user_defined.extend((s1, p1, s2, p2, s3, p3)) return 1 - def defadj(self, singular: str, plural: str) -> int: + @validate_call + def defadj(self, singular: Optional[Word], plural: Optional[Word]) -> int: """ Set the adjective plural of singular to plural. @@ -2131,7 +2093,8 @@ class engine: self.pl_adj_user_defined.extend((singular, plural)) return 1 - def defa(self, pattern: str) -> int: + @validate_call + def defa(self, pattern: Optional[Word]) -> int: """ Define the indefinite article as 'a' for words matching pattern. @@ -2140,7 +2103,8 @@ class engine: self.A_a_user_defined.extend((pattern, "a")) return 1 - def defan(self, pattern: str) -> int: + @validate_call + def defan(self, pattern: Optional[Word]) -> int: """ Define the indefinite article as 'an' for words matching pattern. @@ -2149,7 +2113,7 @@ class engine: self.A_a_user_defined.extend((pattern, "an")) return 1 - def checkpat(self, pattern: Optional[str]) -> None: + def checkpat(self, pattern: Optional[Word]) -> None: """ check for errors in a regex pattern """ @@ -2158,16 +2122,15 @@ class engine: try: re.match(pattern, "") except re.error: - print3(f"\nBad user-defined singular pattern:\n\t{pattern}\n") - raise BadUserDefinedPatternError + raise BadUserDefinedPatternError(pattern) - def checkpatplural(self, pattern: str) -> None: + def checkpatplural(self, pattern: Optional[Word]) -> None: """ check for errors in a regex replace pattern """ return - @validate_arguments + @validate_call def ud_match(self, word: Word, wordlist: Sequence[Optional[Word]]) -> Optional[str]: for i in range(len(wordlist) - 2, -2, -2): # backwards through even elements mo = re.search(fr"^{wordlist[i]}$", word, re.IGNORECASE) @@ -2307,7 +2270,7 @@ class engine: # 0. PERFORM GENERAL INFLECTIONS IN A STRING - @validate_arguments + @validate_call def inflect(self, text: Word) -> str: """ Perform inflections in a string. @@ -2384,7 +2347,7 @@ class engine: else: return "", "", "" - @validate_arguments + @validate_call def plural(self, text: Word, count: Optional[Union[str, int, Any]] = None) -> str: """ Return the plural of text. @@ -2408,7 +2371,7 @@ class engine: ) return f"{pre}{plural}{post}" - @validate_arguments + @validate_call def plural_noun( self, text: Word, count: Optional[Union[str, int, Any]] = None ) -> str: @@ -2429,7 +2392,7 @@ class engine: plural = self.postprocess(word, self._plnoun(word, count)) return f"{pre}{plural}{post}" - @validate_arguments + @validate_call def plural_verb( self, text: Word, count: Optional[Union[str, int, Any]] = None ) -> str: @@ -2453,7 +2416,7 @@ class engine: ) return f"{pre}{plural}{post}" - @validate_arguments + @validate_call def plural_adj( self, text: Word, count: Optional[Union[str, int, Any]] = None ) -> str: @@ -2474,7 +2437,7 @@ class engine: plural = self.postprocess(word, self._pl_special_adjective(word, count) or word) return f"{pre}{plural}{post}" - @validate_arguments + @validate_call def compare(self, word1: Word, word2: Word) -> Union[str, bool]: """ compare word1 and word2 for equality regardless of plurality @@ -2497,15 +2460,15 @@ class engine: >>> compare('egg', '') Traceback (most recent call last): ... - pydantic.error_wrappers.ValidationError: 1 validation error for Compare - word2 - ensure this value has at least 1 characters... + pydantic...ValidationError: ... + ... + ...at least 1 characters... """ norms = self.plural_noun, self.plural_verb, self.plural_adj results = (self._plequal(word1, word2, norm) for norm in norms) return next(filter(None, results), False) - @validate_arguments + @validate_call def compare_nouns(self, word1: Word, word2: Word) -> Union[str, bool]: """ compare word1 and word2 for equality regardless of plurality @@ -2521,7 +2484,7 @@ class engine: """ return self._plequal(word1, word2, self.plural_noun) - @validate_arguments + @validate_call def compare_verbs(self, word1: Word, word2: Word) -> Union[str, bool]: """ compare word1 and word2 for equality regardless of plurality @@ -2537,7 +2500,7 @@ class engine: """ return self._plequal(word1, word2, self.plural_verb) - @validate_arguments + @validate_call def compare_adjs(self, word1: Word, word2: Word) -> Union[str, bool]: """ compare word1 and word2 for equality regardless of plurality @@ -2553,13 +2516,13 @@ class engine: """ return self._plequal(word1, word2, self.plural_adj) - @validate_arguments + @validate_call def singular_noun( self, text: Word, count: Optional[Union[int, str, Any]] = None, gender: Optional[str] = None, - ) -> Union[str, bool]: + ) -> Union[str, Literal[False]]: """ Return the singular of text, where text is a plural noun. @@ -2611,12 +2574,12 @@ class engine: return "s:p" self.classical_dict = classval.copy() - if pl == self.plural or pl == self.plural_noun: + if same_method(pl, self.plural) or same_method(pl, self.plural_noun): if self._pl_check_plurals_N(word1, word2): return "p:p" if self._pl_check_plurals_N(word2, word1): return "p:p" - if pl == self.plural or pl == self.plural_adj: + if same_method(pl, self.plural) or same_method(pl, self.plural_adj): if self._pl_check_plurals_adj(word1, word2): return "p:p" return False @@ -3266,11 +3229,11 @@ class engine: if words.last in si_sb_irregular_caps: llen = len(words.last) - return "{}{}".format(word[:-llen], si_sb_irregular_caps[words.last]) + return f"{word[:-llen]}{si_sb_irregular_caps[words.last]}" if words.last.lower() in si_sb_irregular: llen = len(words.last.lower()) - return "{}{}".format(word[:-llen], si_sb_irregular[words.last.lower()]) + return f"{word[:-llen]}{si_sb_irregular[words.last.lower()]}" dash_split = words.lowered.split("-") if (" ".join(dash_split[-2:])).lower() in si_sb_irregular_compound: @@ -3341,7 +3304,6 @@ class engine: # HANDLE INCOMPLETELY ASSIMILATED IMPORTS if self.classical_dict["ancient"]: - if words.lowered[-6:] == "trices": return word[:-3] + "x" if words.lowered[-4:] in ("eaux", "ieux"): @@ -3459,7 +3421,6 @@ class engine: # HANDLE ...o if words.lowered[-2:] == "os": - if words.last.lower() in si_sb_U_o_os_complete: return word[:-1] @@ -3489,7 +3450,7 @@ class engine: # ADJECTIVES - @validate_arguments + @validate_call def a(self, text: Word, count: Optional[Union[int, str, Any]] = 1) -> str: """ Return the appropriate indefinite article followed by text. @@ -3570,7 +3531,7 @@ class engine: # 2. TRANSLATE ZERO-QUANTIFIED $word TO "no plural($word)" - @validate_arguments + @validate_call def no(self, text: Word, count: Optional[Union[int, str]] = None) -> str: """ If count is 0, no, zero or nil, return 'no' followed by the plural @@ -3608,7 +3569,7 @@ class engine: # PARTICIPLES - @validate_arguments + @validate_call def present_participle(self, word: Word) -> str: """ Return the present participle for word. @@ -3627,31 +3588,31 @@ class engine: # NUMERICAL INFLECTIONS - @validate_arguments - def ordinal(self, num: Union[int, Word]) -> str: # noqa: C901 + @validate_call(config=dict(arbitrary_types_allowed=True)) + def ordinal(self, num: Union[Number, Word]) -> str: """ Return the ordinal of num. - num can be an integer or text - - e.g. ordinal(1) returns '1st' - ordinal('one') returns 'first' - + >>> ordinal = engine().ordinal + >>> ordinal(1) + '1st' + >>> ordinal('one') + 'first' """ if DIGIT.match(str(num)): - if isinstance(num, (int, float)): + if isinstance(num, (float, int)) and int(num) == num: n = int(num) else: if "." in str(num): try: # numbers after decimal, # so only need last one for ordinal - n = int(num[-1]) + n = int(str(num)[-1]) except ValueError: # ends with '.', so need to use whole string - n = int(num[:-1]) + n = int(str(num)[:-1]) else: - n = int(num) + n = int(num) # type: ignore try: post = nth[n % 100] except KeyError: @@ -3660,7 +3621,7 @@ class engine: else: # Mad props to Damian Conway (?) whose ordinal() # algorithm is type-bendy enough to foil MyPy - str_num: str = num # type: ignore[assignment] + str_num: str = num # type: ignore[assignment] mo = ordinal_suff.search(str_num) if mo: post = ordinal[mo.group(1)] @@ -3671,7 +3632,6 @@ class engine: def millfn(self, ind: int = 0) -> str: if ind > len(mill) - 1: - print3("number out of range") raise NumOutOfRangeError return mill[ind] @@ -3787,7 +3747,7 @@ class engine: num = ONE_DIGIT_WORD.sub(self.unitsub, num, 1) return num - @validate_arguments(config=dict(arbitrary_types_allowed=True)) # noqa: C901 + @validate_call(config=dict(arbitrary_types_allowed=True)) # noqa: C901 def number_to_words( # noqa: C901 self, num: Union[Number, Word], @@ -3939,7 +3899,7 @@ class engine: # Join words with commas and a trailing 'and' (when appropriate)... - @validate_arguments + @validate_call def join( self, words: Optional[Sequence[Word]], diff --git a/lib/inflect/compat/__init__.py b/lib/inflect/compat/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/inflect/compat/pydantic.py b/lib/inflect/compat/pydantic.py new file mode 100644 index 00000000..d777564a --- /dev/null +++ b/lib/inflect/compat/pydantic.py @@ -0,0 +1,19 @@ +class ValidateCallWrapperWrapper: + def __init__(self, wrapped): + self.orig = wrapped + + def __eq__(self, other): + return self.raw_function == other.raw_function + + @property + def raw_function(self): + return getattr(self.orig, 'raw_function') or self.orig + + +def same_method(m1, m2) -> bool: + """ + Return whether m1 and m2 are the same method. + + Workaround for pydantic/pydantic#6390. + """ + return ValidateCallWrapperWrapper(m1) == ValidateCallWrapperWrapper(m2) diff --git a/lib/inflect/compat/pydantic1.py b/lib/inflect/compat/pydantic1.py new file mode 100644 index 00000000..8262fdcf --- /dev/null +++ b/lib/inflect/compat/pydantic1.py @@ -0,0 +1,8 @@ +try: + from pydantic import validate_call # type: ignore +except ImportError: + # Pydantic 1 + from pydantic import validate_arguments as validate_call # type: ignore + + +__all__ = ['validate_call'] diff --git a/lib/isapi/README.txt b/lib/isapi/README.txt new file mode 100644 index 00000000..dc528624 --- /dev/null +++ b/lib/isapi/README.txt @@ -0,0 +1,7 @@ +A Python ISAPI extension. Contributed by Phillip Frantz, and is +Copyright 2002-2003 by Blackdog Software Pty Ltd. + +See the 'samples' directory, and particularly samples\README.txt + +You can find documentation in the PyWin32.chm file that comes with pywin32 - +you can open this from Pythonwin->Help, or from the start menu. \ No newline at end of file diff --git a/lib/isapi/__init__.py b/lib/isapi/__init__.py new file mode 100644 index 00000000..71823616 --- /dev/null +++ b/lib/isapi/__init__.py @@ -0,0 +1,39 @@ +# The Python ISAPI package. + + +# Exceptions thrown by the DLL framework. +class ISAPIError(Exception): + def __init__(self, errno, strerror=None, funcname=None): + # named attributes match IOError etc. + self.errno = errno + self.strerror = strerror + self.funcname = funcname + Exception.__init__(self, errno, strerror, funcname) + + def __str__(self): + if self.strerror is None: + try: + import win32api + + self.strerror = win32api.FormatMessage(self.errno).strip() + except: + self.strerror = "no error message is available" + # str() looks like a win32api error. + return str((self.errno, self.strerror, self.funcname)) + + +class FilterError(ISAPIError): + pass + + +class ExtensionError(ISAPIError): + pass + + +# A little development aid - a filter or extension callback function can +# raise one of these exceptions, and the handler module will be reloaded. +# This means you can change your code without restarting IIS. +# After a reload, your filter/extension will have the GetFilterVersion/ +# GetExtensionVersion function called, but with None as the first arg. +class InternalReloadException(Exception): + pass diff --git a/lib/isapi/doc/isapi.html b/lib/isapi/doc/isapi.html new file mode 100644 index 00000000..03001a1b --- /dev/null +++ b/lib/isapi/doc/isapi.html @@ -0,0 +1,92 @@ + + + +Introduction to Python ISAPI support + +

    Introduction to Python ISAPI support

    + +

    See also

    +     +

    Note: if you are viewing this documentation directly from disk, +most links in this document will fail - you can also find this document in the +CHM file that comes with pywin32, where the links will work + +

    Introduction

    +This documents Python support for hosting ISAPI exensions and filters inside +Microsoft Internet Information Server (IIS). It assumes a basic understanding +of the ISAPI filter and extension mechanism. +

    +In summary, to implement a filter or extension, you provide a Python module +which defines a Filter and/or Extension class. Once your class has been +loaded, IIS/ISAPI will, via an extension DLL, call methods on your class. +

    +A filter and a class instance need only provide 3 methods - for filters they +are called GetFilterVersion, HttpFilterProc and +TerminateFilter. For extensions they +are named GetExtensionVersion, HttpExtensionProc and +TerminateExtension. If you are familiar with writing ISAPI +extensions in C/C++, these names and their purpose will be familiar. +

    +Most of the work is done in the HttpFilterProc and +HttpExtensionProc methods. These both take a single +parameter - an HTTP_FILTER_CONTEXT and +EXTENSION_CONTROL_BLOCK +object respectively. +

    +In addition to these components, there is an 'isapi' package, containing +support facilities (base-classes, exceptions, etc) which can be leveraged +by the extension. + +

    Base classes

    +There are a number of base classes provided to make writing extensions a little +simpler. Of particular note is isapi.threaded_extension.ThreadPoolExtension. +This implements a thread-pool and informs IIS that the request is progressing +in the background. Your sub-class need only provide a Dispatch +method, which is called on one of the worker threads rather than the thread +that the request came in on. +

    +There is base-class for a filter in isapi.simple, but there is no +equivilent threaded filter - filters work under a different model, where +background processing is not possible. +

    Samples

    +Please see the isapi/samples directory for some sample filters +and extensions. + +

    Implementation

    +A Python ISAPI filter extension consists of 2 main components: +
      +
    • A DLL used by ISAPI to interface with Python.
      • +
    • A Python script used by that DLL to implement the filter or extension +functionality
      • +
    + +

    Extension DLL

    +The DLL is usually managed automatically by the isapi.install module. As the +Python script for the extension is installed, a generic DLL provided with +the isapi package is installed next to the script, and IIS configured to +use this DLL. +

    +The name of the DLL always has the same base name as the Python script, but +with a leading underscore (_), and an extension of .dll. For example, the +sample "redirector.py" will, when installed, have "_redirector.dll" created +in the same directory. +

    +The Python script may provide 2 entry points - methods named __FilterFactory__ +and __ExtensionFactory__, both taking no arguments and returning a filter or +extension object. + +

    Using py2exe and the isapi package

    +You can instruct py2exe to create a 'frozen' Python ISAPI filter/extension. +In this case, py2exe will create a package with everything you need in one +directory, and the Python source file embedded in the .zip file. +

    +In general, you will want to build a seperate installation executable along +with the ISAPI extension. This executable will be built from the same script. +See the ISAPI sample in the py2exe distribution. diff --git a/lib/isapi/install.py b/lib/isapi/install.py new file mode 100644 index 00000000..154f82af --- /dev/null +++ b/lib/isapi/install.py @@ -0,0 +1,815 @@ +"""Installation utilities for Python ISAPI filters and extensions.""" + +# this code adapted from "Tomcat JK2 ISAPI redirector", part of Apache +# Created July 2004, Mark Hammond. +import imp +import os +import shutil +import stat +import sys +import traceback + +import pythoncom +import win32api +import winerror +from win32com.client import Dispatch, GetObject +from win32com.client.gencache import EnsureDispatch, EnsureModule + +_APP_INPROC = 0 +_APP_OUTPROC = 1 +_APP_POOLED = 2 +_IIS_OBJECT = "IIS://LocalHost/W3SVC" +_IIS_SERVER = "IIsWebServer" +_IIS_WEBDIR = "IIsWebDirectory" +_IIS_WEBVIRTUALDIR = "IIsWebVirtualDir" +_IIS_FILTERS = "IIsFilters" +_IIS_FILTER = "IIsFilter" + +_DEFAULT_SERVER_NAME = "Default Web Site" +_DEFAULT_HEADERS = "X-Powered-By: Python" +_DEFAULT_PROTECTION = _APP_POOLED + +# Default is for 'execute' only access - ie, only the extension +# can be used. This can be overridden via your install script. +_DEFAULT_ACCESS_EXECUTE = True +_DEFAULT_ACCESS_READ = False +_DEFAULT_ACCESS_WRITE = False +_DEFAULT_ACCESS_SCRIPT = False +_DEFAULT_CONTENT_INDEXED = False +_DEFAULT_ENABLE_DIR_BROWSING = False +_DEFAULT_ENABLE_DEFAULT_DOC = False + +_extensions = [ext for ext, _, _ in imp.get_suffixes()] +is_debug_build = "_d.pyd" in _extensions + +this_dir = os.path.abspath(os.path.dirname(__file__)) + + +class FilterParameters: + Name = None + Description = None + Path = None + Server = None + # Params that control if/how AddExtensionFile is called. + AddExtensionFile = True + AddExtensionFile_Enabled = True + AddExtensionFile_GroupID = None # defaults to Name + AddExtensionFile_CanDelete = True + AddExtensionFile_Description = None # defaults to Description. + + def __init__(self, **kw): + self.__dict__.update(kw) + + +class VirtualDirParameters: + Name = None # Must be provided. + Description = None # defaults to Name + AppProtection = _DEFAULT_PROTECTION + Headers = _DEFAULT_HEADERS + Path = None # defaults to WWW root. + Type = _IIS_WEBVIRTUALDIR + AccessExecute = _DEFAULT_ACCESS_EXECUTE + AccessRead = _DEFAULT_ACCESS_READ + AccessWrite = _DEFAULT_ACCESS_WRITE + AccessScript = _DEFAULT_ACCESS_SCRIPT + ContentIndexed = _DEFAULT_CONTENT_INDEXED + EnableDirBrowsing = _DEFAULT_ENABLE_DIR_BROWSING + EnableDefaultDoc = _DEFAULT_ENABLE_DEFAULT_DOC + DefaultDoc = None # Only set in IIS if not None + ScriptMaps = [] + ScriptMapUpdate = "end" # can be 'start', 'end', 'replace' + Server = None + + def __init__(self, **kw): + self.__dict__.update(kw) + + def is_root(self): + "This virtual directory is a root directory if parent and name are blank" + parent, name = self.split_path() + return not parent and not name + + def split_path(self): + return split_path(self.Name) + + +class ScriptMapParams: + Extension = None + Module = None + Flags = 5 + Verbs = "" + # Params that control if/how AddExtensionFile is called. + AddExtensionFile = True + AddExtensionFile_Enabled = True + AddExtensionFile_GroupID = None # defaults to Name + AddExtensionFile_CanDelete = True + AddExtensionFile_Description = None # defaults to Description. + + def __init__(self, **kw): + self.__dict__.update(kw) + + def __str__(self): + "Format this parameter suitable for IIS" + items = [self.Extension, self.Module, self.Flags] + # IIS gets upset if there is a trailing verb comma, but no verbs + if self.Verbs: + items.append(self.Verbs) + items = [str(item) for item in items] + return ",".join(items) + + +class ISAPIParameters: + ServerName = _DEFAULT_SERVER_NAME + # Description = None + Filters = [] + VirtualDirs = [] + + def __init__(self, **kw): + self.__dict__.update(kw) + + +verbose = 1 # The level - 0 is quiet. + + +def log(level, what): + if verbose >= level: + print(what) + + +# Convert an ADSI COM exception to the Win32 error code embedded in it. +def _GetWin32ErrorCode(com_exc): + hr = com_exc.hresult + # If we have more details in the 'excepinfo' struct, use it. + if com_exc.excepinfo: + hr = com_exc.excepinfo[-1] + if winerror.HRESULT_FACILITY(hr) != winerror.FACILITY_WIN32: + raise + return winerror.SCODE_CODE(hr) + + +class InstallationError(Exception): + pass + + +class ItemNotFound(InstallationError): + pass + + +class ConfigurationError(InstallationError): + pass + + +def FindPath(options, server, name): + if name.lower().startswith("iis://"): + return name + else: + if name and name[0] != "/": + name = "/" + name + return FindWebServer(options, server) + "/ROOT" + name + + +def LocateWebServerPath(description): + """ + Find an IIS web server whose name or comment matches the provided + description (case-insensitive). + + >>> LocateWebServerPath('Default Web Site') # doctest: +SKIP + + or + + >>> LocateWebServerPath('1') #doctest: +SKIP + """ + assert len(description) >= 1, "Server name or comment is required" + iis = GetObject(_IIS_OBJECT) + description = description.lower().strip() + for site in iis: + # Name is generally a number, but no need to assume that. + site_attributes = [ + getattr(site, attr, "").lower().strip() + for attr in ("Name", "ServerComment") + ] + if description in site_attributes: + return site.AdsPath + msg = "No web sites match the description '%s'" % description + raise ItemNotFound(msg) + + +def GetWebServer(description=None): + """ + Load the web server instance (COM object) for a given instance + or description. + If None is specified, the default website is retrieved (indicated + by the identifier 1. + """ + description = description or "1" + path = LocateWebServerPath(description) + server = LoadWebServer(path) + return server + + +def LoadWebServer(path): + try: + server = GetObject(path) + except pythoncom.com_error as details: + msg = details.strerror + if exc.excepinfo and exc.excepinfo[2]: + msg = exc.excepinfo[2] + msg = "WebServer %s: %s" % (path, msg) + raise ItemNotFound(msg) + return server + + +def FindWebServer(options, server_desc): + """ + Legacy function to allow options to define a .server property + to override the other parameter. Use GetWebServer instead. + """ + # options takes precedence + server_desc = options.server or server_desc + # make sure server_desc is unicode (could be mbcs if passed in + # sys.argv). + if server_desc and not isinstance(server_desc, str): + server_desc = server_desc.decode("mbcs") + + # get the server (if server_desc is None, the default site is acquired) + server = GetWebServer(server_desc) + return server.adsPath + + +def split_path(path): + """ + Get the parent path and basename. + + >>> split_path('/') + ['', ''] + + >>> split_path('') + ['', ''] + + >>> split_path('foo') + ['', 'foo'] + + >>> split_path('/foo') + ['', 'foo'] + + >>> split_path('/foo/bar') + ['/foo', 'bar'] + + >>> split_path('foo/bar') + ['/foo', 'bar'] + """ + + if not path.startswith("/"): + path = "/" + path + return path.rsplit("/", 1) + + +def _CreateDirectory(iis_dir, name, params): + # We used to go to lengths to keep an existing virtual directory + # in place. However, in some cases the existing directories got + # into a bad state, and an update failed to get them working. + # So we nuke it first. If this is a problem, we could consider adding + # a --keep-existing option. + try: + # Also seen the Class change to a generic IISObject - so nuke + # *any* existing object, regardless of Class + assert name.strip("/"), "mustn't delete the root!" + iis_dir.Delete("", name) + log(2, "Deleted old directory '%s'" % (name,)) + except pythoncom.com_error: + pass + + newDir = iis_dir.Create(params.Type, name) + log(2, "Creating new directory '%s' in %s..." % (name, iis_dir.Name)) + + friendly = params.Description or params.Name + newDir.AppFriendlyName = friendly + + # Note that the new directory won't be visible in the IIS UI + # unless the directory exists on the filesystem. + try: + path = params.Path or iis_dir.Path + newDir.Path = path + except AttributeError: + # If params.Type is IIS_WEBDIRECTORY, an exception is thrown + pass + newDir.AppCreate2(params.AppProtection) + # XXX - note that these Headers only work in IIS6 and earlier. IIS7 + # only supports them on the w3svc node - not even on individial sites, + # let alone individual extensions in the site! + if params.Headers: + newDir.HttpCustomHeaders = params.Headers + + log(2, "Setting directory options...") + newDir.AccessExecute = params.AccessExecute + newDir.AccessRead = params.AccessRead + newDir.AccessWrite = params.AccessWrite + newDir.AccessScript = params.AccessScript + newDir.ContentIndexed = params.ContentIndexed + newDir.EnableDirBrowsing = params.EnableDirBrowsing + newDir.EnableDefaultDoc = params.EnableDefaultDoc + if params.DefaultDoc is not None: + newDir.DefaultDoc = params.DefaultDoc + newDir.SetInfo() + return newDir + + +def CreateDirectory(params, options): + _CallHook(params, "PreInstall", options) + if not params.Name: + raise ConfigurationError("No Name param") + parent, name = params.split_path() + target_dir = GetObject(FindPath(options, params.Server, parent)) + + if not params.is_root(): + target_dir = _CreateDirectory(target_dir, name, params) + + AssignScriptMaps(params.ScriptMaps, target_dir, params.ScriptMapUpdate) + + _CallHook(params, "PostInstall", options, target_dir) + log(1, "Configured Virtual Directory: %s" % (params.Name,)) + return target_dir + + +def AssignScriptMaps(script_maps, target, update="replace"): + """Updates IIS with the supplied script map information. + + script_maps is a list of ScriptMapParameter objects + + target is an IIS Virtual Directory to assign the script maps to + + update is a string indicating how to update the maps, one of ('start', + 'end', or 'replace') + """ + # determine which function to use to assign script maps + script_map_func = "_AssignScriptMaps" + update.capitalize() + try: + script_map_func = eval(script_map_func) + except NameError: + msg = "Unknown ScriptMapUpdate option '%s'" % update + raise ConfigurationError(msg) + # use the str method to format the script maps for IIS + script_maps = [str(s) for s in script_maps] + # call the correct function + script_map_func(target, script_maps) + target.SetInfo() + + +def get_unique_items(sequence, reference): + "Return items in sequence that can't be found in reference." + return tuple([item for item in sequence if item not in reference]) + + +def _AssignScriptMapsReplace(target, script_maps): + target.ScriptMaps = script_maps + + +def _AssignScriptMapsEnd(target, script_maps): + unique_new_maps = get_unique_items(script_maps, target.ScriptMaps) + target.ScriptMaps = target.ScriptMaps + unique_new_maps + + +def _AssignScriptMapsStart(target, script_maps): + unique_new_maps = get_unique_items(script_maps, target.ScriptMaps) + target.ScriptMaps = unique_new_maps + target.ScriptMaps + + +def CreateISAPIFilter(filterParams, options): + server = FindWebServer(options, filterParams.Server) + _CallHook(filterParams, "PreInstall", options) + try: + filters = GetObject(server + "/Filters") + except pythoncom.com_error as exc: + # Brand new sites don't have the '/Filters' collection - create it. + # Any errors other than 'not found' we shouldn't ignore. + if ( + winerror.HRESULT_FACILITY(exc.hresult) != winerror.FACILITY_WIN32 + or winerror.HRESULT_CODE(exc.hresult) != winerror.ERROR_PATH_NOT_FOUND + ): + raise + server_ob = GetObject(server) + filters = server_ob.Create(_IIS_FILTERS, "Filters") + filters.FilterLoadOrder = "" + filters.SetInfo() + + # As for VirtualDir, delete an existing one. + assert filterParams.Name.strip("/"), "mustn't delete the root!" + try: + filters.Delete(_IIS_FILTER, filterParams.Name) + log(2, "Deleted old filter '%s'" % (filterParams.Name,)) + except pythoncom.com_error: + pass + newFilter = filters.Create(_IIS_FILTER, filterParams.Name) + log(2, "Created new ISAPI filter...") + assert os.path.isfile(filterParams.Path) + newFilter.FilterPath = filterParams.Path + newFilter.FilterDescription = filterParams.Description + newFilter.SetInfo() + load_order = [b.strip() for b in filters.FilterLoadOrder.split(",") if b] + if filterParams.Name not in load_order: + load_order.append(filterParams.Name) + filters.FilterLoadOrder = ",".join(load_order) + filters.SetInfo() + _CallHook(filterParams, "PostInstall", options, newFilter) + log(1, "Configured Filter: %s" % (filterParams.Name,)) + return newFilter + + +def DeleteISAPIFilter(filterParams, options): + _CallHook(filterParams, "PreRemove", options) + server = FindWebServer(options, filterParams.Server) + ob_path = server + "/Filters" + try: + filters = GetObject(ob_path) + except pythoncom.com_error as details: + # failure to open the filters just means a totally clean IIS install + # (IIS5 at least has no 'Filters' key when freshly installed). + log(2, "ISAPI filter path '%s' did not exist." % (ob_path,)) + return + try: + assert filterParams.Name.strip("/"), "mustn't delete the root!" + filters.Delete(_IIS_FILTER, filterParams.Name) + log(2, "Deleted ISAPI filter '%s'" % (filterParams.Name,)) + except pythoncom.com_error as details: + rc = _GetWin32ErrorCode(details) + if rc != winerror.ERROR_PATH_NOT_FOUND: + raise + log(2, "ISAPI filter '%s' did not exist." % (filterParams.Name,)) + # Remove from the load order + load_order = [b.strip() for b in filters.FilterLoadOrder.split(",") if b] + if filterParams.Name in load_order: + load_order.remove(filterParams.Name) + filters.FilterLoadOrder = ",".join(load_order) + filters.SetInfo() + _CallHook(filterParams, "PostRemove", options) + log(1, "Deleted Filter: %s" % (filterParams.Name,)) + + +def _AddExtensionFile(module, def_groupid, def_desc, params, options): + group_id = params.AddExtensionFile_GroupID or def_groupid + desc = params.AddExtensionFile_Description or def_desc + try: + ob = GetObject(_IIS_OBJECT) + ob.AddExtensionFile( + module, + params.AddExtensionFile_Enabled, + group_id, + params.AddExtensionFile_CanDelete, + desc, + ) + log(2, "Added extension file '%s' (%s)" % (module, desc)) + except (pythoncom.com_error, AttributeError) as details: + # IIS5 always fails. Probably should upgrade this to + # complain more loudly if IIS6 fails. + log(2, "Failed to add extension file '%s': %s" % (module, details)) + + +def AddExtensionFiles(params, options): + """Register the modules used by the filters/extensions as a trusted + 'extension module' - required by the default IIS6 security settings.""" + # Add each module only once. + added = {} + for vd in params.VirtualDirs: + for smp in vd.ScriptMaps: + if smp.Module not in added and smp.AddExtensionFile: + _AddExtensionFile(smp.Module, vd.Name, vd.Description, smp, options) + added[smp.Module] = True + + for fd in params.Filters: + if fd.Path not in added and fd.AddExtensionFile: + _AddExtensionFile(fd.Path, fd.Name, fd.Description, fd, options) + added[fd.Path] = True + + +def _DeleteExtensionFileRecord(module, options): + try: + ob = GetObject(_IIS_OBJECT) + ob.DeleteExtensionFileRecord(module) + log(2, "Deleted extension file record for '%s'" % module) + except (pythoncom.com_error, AttributeError) as details: + log(2, "Failed to remove extension file '%s': %s" % (module, details)) + + +def DeleteExtensionFileRecords(params, options): + deleted = {} # only remove each .dll once. + for vd in params.VirtualDirs: + for smp in vd.ScriptMaps: + if smp.Module not in deleted and smp.AddExtensionFile: + _DeleteExtensionFileRecord(smp.Module, options) + deleted[smp.Module] = True + + for filter_def in params.Filters: + if filter_def.Path not in deleted and filter_def.AddExtensionFile: + _DeleteExtensionFileRecord(filter_def.Path, options) + deleted[filter_def.Path] = True + + +def CheckLoaderModule(dll_name): + suffix = "" + if is_debug_build: + suffix = "_d" + template = os.path.join(this_dir, "PyISAPI_loader" + suffix + ".dll") + if not os.path.isfile(template): + raise ConfigurationError("Template loader '%s' does not exist" % (template,)) + # We can't do a simple "is newer" check, as the DLL is specific to the + # Python version. So we check the date-time and size are identical, + # and skip the copy in that case. + src_stat = os.stat(template) + try: + dest_stat = os.stat(dll_name) + except os.error: + same = 0 + else: + same = ( + src_stat[stat.ST_SIZE] == dest_stat[stat.ST_SIZE] + and src_stat[stat.ST_MTIME] == dest_stat[stat.ST_MTIME] + ) + if not same: + log(2, "Updating %s->%s" % (template, dll_name)) + shutil.copyfile(template, dll_name) + shutil.copystat(template, dll_name) + else: + log(2, "%s is up to date." % (dll_name,)) + + +def _CallHook(ob, hook_name, options, *extra_args): + func = getattr(ob, hook_name, None) + if func is not None: + args = (ob, options) + extra_args + func(*args) + + +def Install(params, options): + _CallHook(params, "PreInstall", options) + for vd in params.VirtualDirs: + CreateDirectory(vd, options) + + for filter_def in params.Filters: + CreateISAPIFilter(filter_def, options) + + AddExtensionFiles(params, options) + + _CallHook(params, "PostInstall", options) + + +def RemoveDirectory(params, options): + if params.is_root(): + return + try: + directory = GetObject(FindPath(options, params.Server, params.Name)) + except pythoncom.com_error as details: + rc = _GetWin32ErrorCode(details) + if rc != winerror.ERROR_PATH_NOT_FOUND: + raise + log(2, "VirtualDirectory '%s' did not exist" % params.Name) + directory = None + if directory is not None: + # Be robust should IIS get upset about unloading. + try: + directory.AppUnLoad() + except: + exc_val = sys.exc_info()[1] + log(2, "AppUnLoad() for %s failed: %s" % (params.Name, exc_val)) + # Continue trying to delete it. + try: + parent = GetObject(directory.Parent) + parent.Delete(directory.Class, directory.Name) + log(1, "Deleted Virtual Directory: %s" % (params.Name,)) + except: + exc_val = sys.exc_info()[1] + log(1, "Failed to remove directory %s: %s" % (params.Name, exc_val)) + + +def RemoveScriptMaps(vd_params, options): + "Remove script maps from the already installed virtual directory" + parent, name = vd_params.split_path() + target_dir = GetObject(FindPath(options, vd_params.Server, parent)) + installed_maps = list(target_dir.ScriptMaps) + for _map in map(str, vd_params.ScriptMaps): + if _map in installed_maps: + installed_maps.remove(_map) + target_dir.ScriptMaps = installed_maps + target_dir.SetInfo() + + +def Uninstall(params, options): + _CallHook(params, "PreRemove", options) + + DeleteExtensionFileRecords(params, options) + + for vd in params.VirtualDirs: + _CallHook(vd, "PreRemove", options) + + RemoveDirectory(vd, options) + if vd.is_root(): + # if this is installed to the root virtual directory, we can't delete it + # so remove the script maps. + RemoveScriptMaps(vd, options) + + _CallHook(vd, "PostRemove", options) + + for filter_def in params.Filters: + DeleteISAPIFilter(filter_def, options) + _CallHook(params, "PostRemove", options) + + +# Patch up any missing module names in the params, replacing them with +# the DLL name that hosts this extension/filter. +def _PatchParamsModule(params, dll_name, file_must_exist=True): + if file_must_exist: + if not os.path.isfile(dll_name): + raise ConfigurationError("%s does not exist" % (dll_name,)) + + # Patch up all references to the DLL. + for f in params.Filters: + if f.Path is None: + f.Path = dll_name + for d in params.VirtualDirs: + for sm in d.ScriptMaps: + if sm.Module is None: + sm.Module = dll_name + + +def GetLoaderModuleName(mod_name, check_module=None): + # find the name of the DLL hosting us. + # By default, this is "_{module_base_name}.dll" + if hasattr(sys, "frozen"): + # What to do? The .dll knows its name, but this is likely to be + # executed via a .exe, which does not know. + base, ext = os.path.splitext(mod_name) + path, base = os.path.split(base) + # handle the common case of 'foo.exe'/'foow.exe' + if base.endswith("w"): + base = base[:-1] + # For py2exe, we have '_foo.dll' as the standard pyisapi loader - but + # 'foo.dll' is what we use (it just delegates). + # So no leading '_' on the installed name. + dll_name = os.path.abspath(os.path.join(path, base + ".dll")) + else: + base, ext = os.path.splitext(mod_name) + path, base = os.path.split(base) + dll_name = os.path.abspath(os.path.join(path, "_" + base + ".dll")) + # Check we actually have it. + if check_module is None: + check_module = not hasattr(sys, "frozen") + if check_module: + CheckLoaderModule(dll_name) + return dll_name + + +# Note the 'log' params to these 'builtin' args - old versions of pywin32 +# didn't log at all in this function (by intent; anyone calling this was +# responsible). So existing code that calls this function with the old +# signature (ie, without a 'log' param) still gets the same behaviour as +# before... + + +def InstallModule(conf_module_name, params, options, log=lambda *args: None): + "Install the extension" + if not hasattr(sys, "frozen"): + conf_module_name = os.path.abspath(conf_module_name) + if not os.path.isfile(conf_module_name): + raise ConfigurationError("%s does not exist" % (conf_module_name,)) + + loader_dll = GetLoaderModuleName(conf_module_name) + _PatchParamsModule(params, loader_dll) + Install(params, options) + log(1, "Installation complete.") + + +def UninstallModule(conf_module_name, params, options, log=lambda *args: None): + "Remove the extension" + loader_dll = GetLoaderModuleName(conf_module_name, False) + _PatchParamsModule(params, loader_dll, False) + Uninstall(params, options) + log(1, "Uninstallation complete.") + + +standard_arguments = { + "install": InstallModule, + "remove": UninstallModule, +} + + +def build_usage(handler_map): + docstrings = [handler.__doc__ for handler in handler_map.values()] + all_args = dict(zip(iter(handler_map.keys()), docstrings)) + arg_names = "|".join(iter(all_args.keys())) + usage_string = "%prog [options] [" + arg_names + "]\n" + usage_string += "commands:\n" + for arg, desc in all_args.items(): + usage_string += " %-10s: %s" % (arg, desc) + "\n" + return usage_string[:-1] + + +def MergeStandardOptions(options, params): + """ + Take an options object generated by the command line and merge + the values into the IISParameters object. + """ + pass + + +# We support 2 ways of extending our command-line/install support. +# * Many of the installation items allow you to specify "PreInstall", +# "PostInstall", "PreRemove" and "PostRemove" hooks +# All hooks are called with the 'params' object being operated on, and +# the 'optparser' options for this session (ie, the command-line options) +# PostInstall for VirtualDirectories and Filters both have an additional +# param - the ADSI object just created. +# * You can pass your own option parser for us to use, and/or define a map +# with your own custom arg handlers. It is a map of 'arg'->function. +# The function is called with (options, log_fn, arg). The function's +# docstring is used in the usage output. +def HandleCommandLine( + params, + argv=None, + conf_module_name=None, + default_arg="install", + opt_parser=None, + custom_arg_handlers={}, +): + """Perform installation or removal of an ISAPI filter or extension. + + This module handles standard command-line options and configuration + information, and installs, removes or updates the configuration of an + ISAPI filter or extension. + + You must pass your configuration information in params - all other + arguments are optional, and allow you to configure the installation + process. + """ + global verbose + from optparse import OptionParser + + argv = argv or sys.argv + if not conf_module_name: + conf_module_name = sys.argv[0] + # convert to a long name so that if we were somehow registered with + # the "short" version but unregistered with the "long" version we + # still work (that will depend on exactly how the installer was + # started) + try: + conf_module_name = win32api.GetLongPathName(conf_module_name) + except win32api.error as exc: + log( + 2, + "Couldn't determine the long name for %r: %s" % (conf_module_name, exc), + ) + + if opt_parser is None: + # Build our own parser. + parser = OptionParser(usage="") + else: + # The caller is providing their own filter, presumably with their + # own options all setup. + parser = opt_parser + + # build a usage string if we don't have one. + if not parser.get_usage(): + all_handlers = standard_arguments.copy() + all_handlers.update(custom_arg_handlers) + parser.set_usage(build_usage(all_handlers)) + + # allow the user to use uninstall as a synonym for remove if it wasn't + # defined by the custom arg handlers. + all_handlers.setdefault("uninstall", all_handlers["remove"]) + + parser.add_option( + "-q", + "--quiet", + action="store_false", + dest="verbose", + default=True, + help="don't print status messages to stdout", + ) + parser.add_option( + "-v", + "--verbosity", + action="count", + dest="verbose", + default=1, + help="increase the verbosity of status messages", + ) + parser.add_option( + "", + "--server", + action="store", + help="Specifies the IIS server to install/uninstall on." + " Default is '%s/1'" % (_IIS_OBJECT,), + ) + + (options, args) = parser.parse_args(argv[1:]) + MergeStandardOptions(options, params) + verbose = options.verbose + if not args: + args = [default_arg] + try: + for arg in args: + handler = all_handlers[arg] + handler(conf_module_name, params, options, log) + except (ItemNotFound, InstallationError) as details: + if options.verbose > 1: + traceback.print_exc() + print("%s: %s" % (details.__class__.__name__, details)) + except KeyError: + parser.error("Invalid arg '%s'" % arg) diff --git a/lib/isapi/isapicon.py b/lib/isapi/isapicon.py new file mode 100644 index 00000000..20de1a44 --- /dev/null +++ b/lib/isapi/isapicon.py @@ -0,0 +1,120 @@ +"""Constants needed by ISAPI filters and extensions.""" +# ====================================================================== +# Copyright 2002-2003 by Blackdog Software Pty Ltd. +# +# All Rights Reserved +# +# Permission to use, copy, modify, and distribute this software and +# its documentation for any purpose and without fee is hereby +# granted, provided that the above copyright notice appear in all +# copies and that both that copyright notice and this permission +# notice appear in supporting documentation, and that the name of +# Blackdog Software not be used in advertising or publicity pertaining to +# distribution of the software without specific, written prior +# permission. +# +# BLACKDOG SOFTWARE DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, +# INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN +# NO EVENT SHALL BLACKDOG SOFTWARE BE LIABLE FOR ANY SPECIAL, INDIRECT OR +# CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS +# OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, +# NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN +# CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +# ====================================================================== + +# HTTP reply codes + +HTTP_CONTINUE = 100 +HTTP_SWITCHING_PROTOCOLS = 101 +HTTP_PROCESSING = 102 +HTTP_OK = 200 +HTTP_CREATED = 201 +HTTP_ACCEPTED = 202 +HTTP_NON_AUTHORITATIVE = 203 +HTTP_NO_CONTENT = 204 +HTTP_RESET_CONTENT = 205 +HTTP_PARTIAL_CONTENT = 206 +HTTP_MULTI_STATUS = 207 +HTTP_MULTIPLE_CHOICES = 300 +HTTP_MOVED_PERMANENTLY = 301 +HTTP_MOVED_TEMPORARILY = 302 +HTTP_SEE_OTHER = 303 +HTTP_NOT_MODIFIED = 304 +HTTP_USE_PROXY = 305 +HTTP_TEMPORARY_REDIRECT = 307 +HTTP_BAD_REQUEST = 400 +HTTP_UNAUTHORIZED = 401 +HTTP_PAYMENT_REQUIRED = 402 +HTTP_FORBIDDEN = 403 +HTTP_NOT_FOUND = 404 +HTTP_METHOD_NOT_ALLOWED = 405 +HTTP_NOT_ACCEPTABLE = 406 +HTTP_PROXY_AUTHENTICATION_REQUIRED = 407 +HTTP_REQUEST_TIME_OUT = 408 +HTTP_CONFLICT = 409 +HTTP_GONE = 410 +HTTP_LENGTH_REQUIRED = 411 +HTTP_PRECONDITION_FAILED = 412 +HTTP_REQUEST_ENTITY_TOO_LARGE = 413 +HTTP_REQUEST_URI_TOO_LARGE = 414 +HTTP_UNSUPPORTED_MEDIA_TYPE = 415 +HTTP_RANGE_NOT_SATISFIABLE = 416 +HTTP_EXPECTATION_FAILED = 417 +HTTP_UNPROCESSABLE_ENTITY = 422 +HTTP_INTERNAL_SERVER_ERROR = 500 +HTTP_NOT_IMPLEMENTED = 501 +HTTP_BAD_GATEWAY = 502 +HTTP_SERVICE_UNAVAILABLE = 503 +HTTP_GATEWAY_TIME_OUT = 504 +HTTP_VERSION_NOT_SUPPORTED = 505 +HTTP_VARIANT_ALSO_VARIES = 506 + +HSE_STATUS_SUCCESS = 1 +HSE_STATUS_SUCCESS_AND_KEEP_CONN = 2 +HSE_STATUS_PENDING = 3 +HSE_STATUS_ERROR = 4 + +SF_NOTIFY_SECURE_PORT = 0x00000001 +SF_NOTIFY_NONSECURE_PORT = 0x00000002 +SF_NOTIFY_READ_RAW_DATA = 0x00008000 +SF_NOTIFY_PREPROC_HEADERS = 0x00004000 +SF_NOTIFY_AUTHENTICATION = 0x00002000 +SF_NOTIFY_URL_MAP = 0x00001000 +SF_NOTIFY_ACCESS_DENIED = 0x00000800 +SF_NOTIFY_SEND_RESPONSE = 0x00000040 +SF_NOTIFY_SEND_RAW_DATA = 0x00000400 +SF_NOTIFY_LOG = 0x00000200 +SF_NOTIFY_END_OF_REQUEST = 0x00000080 +SF_NOTIFY_END_OF_NET_SESSION = 0x00000100 + +SF_NOTIFY_ORDER_HIGH = 0x00080000 +SF_NOTIFY_ORDER_MEDIUM = 0x00040000 +SF_NOTIFY_ORDER_LOW = 0x00020000 +SF_NOTIFY_ORDER_DEFAULT = SF_NOTIFY_ORDER_LOW + +SF_NOTIFY_ORDER_MASK = ( + SF_NOTIFY_ORDER_HIGH | SF_NOTIFY_ORDER_MEDIUM | SF_NOTIFY_ORDER_LOW +) + +SF_STATUS_REQ_FINISHED = 134217728 # 0x8000000 +SF_STATUS_REQ_FINISHED_KEEP_CONN = 134217728 + 1 +SF_STATUS_REQ_NEXT_NOTIFICATION = 134217728 + 2 +SF_STATUS_REQ_HANDLED_NOTIFICATION = 134217728 + 3 +SF_STATUS_REQ_ERROR = 134217728 + 4 +SF_STATUS_REQ_READ_NEXT = 134217728 + 5 + +HSE_IO_SYNC = 0x00000001 # for WriteClient +HSE_IO_ASYNC = 0x00000002 # for WriteClient/TF/EU +HSE_IO_DISCONNECT_AFTER_SEND = 0x00000004 # for TF +HSE_IO_SEND_HEADERS = 0x00000008 # for TF +HSE_IO_NODELAY = 0x00001000 # turn off nagling +# These two are only used by VectorSend +HSE_IO_FINAL_SEND = 0x00000010 +HSE_IO_CACHE_RESPONSE = 0x00000020 + +HSE_EXEC_URL_NO_HEADERS = 0x02 +HSE_EXEC_URL_IGNORE_CURRENT_INTERCEPTOR = 0x04 +HSE_EXEC_URL_IGNORE_VALIDATION_AND_RANGE = 0x10 +HSE_EXEC_URL_DISABLE_CUSTOM_ERROR = 0x20 +HSE_EXEC_URL_SSI_CMD = 0x40 +HSE_EXEC_URL_HTTP_CACHE_ELIGIBLE = 0x80 diff --git a/lib/isapi/samples/README.txt b/lib/isapi/samples/README.txt new file mode 100644 index 00000000..cff87587 --- /dev/null +++ b/lib/isapi/samples/README.txt @@ -0,0 +1,20 @@ +In this directory you will find examples of ISAPI filters and extensions. + +The filter loading mechanism works like this: +* IIS loads the special Python "loader" DLL. This DLL will generally have a + leading underscore as part of its name. +* This loader DLL looks for a Python module, by removing the first letter of + the DLL base name. + +This means that an ISAPI extension module consists of 2 key files - the loader +DLL (eg, "_MyIISModule.dll", and a Python module (which for this example +would be "MyIISModule.py") + +When you install an ISAPI extension, the installation code checks to see if +there is a loader DLL for your implementation file - if one does not exist, +or the standard loader is different, it is copied and renamed accordingly. + +We use this mechanism to provide the maximum separation between different +Python extensions installed on the same server - otherwise filter order and +other tricky IIS semantics would need to be replicated. Also, each filter +gets its own thread-pool, etc. diff --git a/lib/isapi/samples/advanced.py b/lib/isapi/samples/advanced.py new file mode 100644 index 00000000..c10d0c80 --- /dev/null +++ b/lib/isapi/samples/advanced.py @@ -0,0 +1,218 @@ +# This extension demonstrates some advanced features of the Python ISAPI +# framework. +# We demonstrate: +# * Reloading your Python module without shutting down IIS (eg, when your +# .py implementation file changes.) +# * Custom command-line handling - both additional options and commands. +# * Using a query string - any part of the URL after a '?' is assumed to +# be "variable names" separated by '&' - we will print the values of +# these server variables. +# * If the tail portion of the URL is "ReportUnhealthy", IIS will be +# notified we are unhealthy via a HSE_REQ_REPORT_UNHEALTHY request. +# Whether this is acted upon depends on if the IIS health-checking +# tools are installed, but you should always see the reason written +# to the Windows event log - see the IIS documentation for more. + +import os +import stat +import sys + +from isapi import isapicon +from isapi.simple import SimpleExtension + +if hasattr(sys, "isapidllhandle"): + import win32traceutil + +# Notes on reloading +# If your HttpFilterProc or HttpExtensionProc functions raises +# 'isapi.InternalReloadException', the framework will not treat it +# as an error but instead will terminate your extension, reload your +# extension module, re-initialize the instance, and re-issue the request. +# The Initialize functions are called with None as their param. The +# return code from the terminate function is ignored. +# +# This is all the framework does to help you. It is up to your code +# when you raise this exception. This sample uses a Win32 "find +# notification". Whenever windows tells us one of the files in the +# directory has changed, we check if the time of our source-file has +# changed, and set a flag. Next imcoming request, we check the flag and +# raise the special exception if set. +# +# The end result is that the module is automatically reloaded whenever +# the source-file changes - you need take no further action to see your +# changes reflected in the running server. + +# The framework only reloads your module - if you have libraries you +# depend on and also want reloaded, you must arrange for this yourself. +# One way of doing this would be to special case the import of these +# modules. Eg: +# -- +# try: +# my_module = reload(my_module) # module already imported - reload it +# except NameError: +# import my_module # first time around - import it. +# -- +# When your module is imported for the first time, the NameError will +# be raised, and the module imported. When the ISAPI framework reloads +# your module, the existing module will avoid the NameError, and allow +# you to reload that module. + +import threading + +import win32con +import win32event +import win32file +import winerror + +from isapi import InternalReloadException + +try: + reload_counter += 1 +except NameError: + reload_counter = 0 + + +# A watcher thread that checks for __file__ changing. +# When it detects it, it simply sets "change_detected" to true. +class ReloadWatcherThread(threading.Thread): + def __init__(self): + self.change_detected = False + self.filename = __file__ + if self.filename.endswith("c") or self.filename.endswith("o"): + self.filename = self.filename[:-1] + self.handle = win32file.FindFirstChangeNotification( + os.path.dirname(self.filename), + False, # watch tree? + win32con.FILE_NOTIFY_CHANGE_LAST_WRITE, + ) + threading.Thread.__init__(self) + + def run(self): + last_time = os.stat(self.filename)[stat.ST_MTIME] + while 1: + try: + rc = win32event.WaitForSingleObject(self.handle, win32event.INFINITE) + win32file.FindNextChangeNotification(self.handle) + except win32event.error as details: + # handle closed - thread should terminate. + if details.winerror != winerror.ERROR_INVALID_HANDLE: + raise + break + this_time = os.stat(self.filename)[stat.ST_MTIME] + if this_time != last_time: + print("Detected file change - flagging for reload.") + self.change_detected = True + last_time = this_time + + def stop(self): + win32file.FindCloseChangeNotification(self.handle) + + +# The ISAPI extension - handles requests in our virtual dir, and sends the +# response to the client. +class Extension(SimpleExtension): + "Python advanced sample Extension" + + def __init__(self): + self.reload_watcher = ReloadWatcherThread() + self.reload_watcher.start() + + def HttpExtensionProc(self, ecb): + # NOTE: If you use a ThreadPoolExtension, you must still perform + # this check in HttpExtensionProc - raising the exception from + # The "Dispatch" method will just cause the exception to be + # rendered to the browser. + if self.reload_watcher.change_detected: + print("Doing reload") + raise InternalReloadException + + url = ecb.GetServerVariable("UNICODE_URL") + if url.endswith("ReportUnhealthy"): + ecb.ReportUnhealthy("I'm a little sick") + + ecb.SendResponseHeaders("200 OK", "Content-Type: text/html\r\n\r\n", 0) + print("", file=ecb) + + qs = ecb.GetServerVariable("QUERY_STRING") + if qs: + queries = qs.split("&") + print("

    ", file=ecb)
+            for q in queries:
+                val = ecb.GetServerVariable(q, "<no such variable>")
+                print("%s=%r" % (q, val), file=ecb)
+            print("

    ", file=ecb) + + print("This module has been imported", file=ecb) + print("%d times" % (reload_counter,), file=ecb) + print("", file=ecb) + ecb.close() + return isapicon.HSE_STATUS_SUCCESS + + def TerminateExtension(self, status): + self.reload_watcher.stop() + + +# The entry points for the ISAPI extension. +def __ExtensionFactory__(): + return Extension() + + +# Our special command line customization. +# Pre-install hook for our virtual directory. +def PreInstallDirectory(params, options): + # If the user used our special '--description' option, + # then we override our default. + if options.description: + params.Description = options.description + + +# Post install hook for our entire script +def PostInstall(params, options): + print() + print("The sample has been installed.") + print("Point your browser to /AdvancedPythonSample") + print("If you modify the source file and reload the page,") + print("you should see the reload counter increment") + + +# Handler for our custom 'status' argument. +def status_handler(options, log, arg): + "Query the status of something" + print("Everything seems to be fine!") + + +custom_arg_handlers = {"status": status_handler} + +if __name__ == "__main__": + # If run from the command-line, install ourselves. + from isapi.install import * + + params = ISAPIParameters(PostInstall=PostInstall) + # Setup the virtual directories - this is a list of directories our + # extension uses - in this case only 1. + # Each extension has a "script map" - this is the mapping of ISAPI + # extensions. + sm = [ScriptMapParams(Extension="*", Flags=0)] + vd = VirtualDirParameters( + Name="AdvancedPythonSample", + Description=Extension.__doc__, + ScriptMaps=sm, + ScriptMapUpdate="replace", + # specify the pre-install hook. + PreInstall=PreInstallDirectory, + ) + params.VirtualDirs = [vd] + # Setup our custom option parser. + from optparse import OptionParser + + parser = OptionParser("") # blank usage, so isapi sets it. + parser.add_option( + "", + "--description", + action="store", + help="custom description to use for the virtual directory", + ) + + HandleCommandLine( + params, opt_parser=parser, custom_arg_handlers=custom_arg_handlers + ) diff --git a/lib/isapi/samples/redirector.py b/lib/isapi/samples/redirector.py new file mode 100644 index 00000000..40698bb2 --- /dev/null +++ b/lib/isapi/samples/redirector.py @@ -0,0 +1,125 @@ +# This is a sample ISAPI extension written in Python. +# +# Please see README.txt in this directory, and specifically the +# information about the "loader" DLL - installing this sample will create +# "_redirector.dll" in the current directory. The readme explains this. + +# Executing this script (or any server config script) will install the extension +# into your web server. As the server executes, the PyISAPI framework will load +# this module and create your Extension and Filter objects. + +# This is the simplest possible redirector (or proxy) we can write. The +# extension installs with a mask of '*' in the root of the site. +# As an added bonus though, we optionally show how, on IIS6 and later, we +# can use HSE_ERQ_EXEC_URL to ignore certain requests - in IIS5 and earlier +# we can only do this with an ISAPI filter - see redirector_with_filter for +# an example. If this sample is run on IIS5 or earlier it simply ignores +# any excludes. + +import sys + +from isapi import isapicon, threaded_extension + +try: + from urllib.request import urlopen +except ImportError: + # py3k spelling... + from urllib.request import urlopen + +import win32api + +# sys.isapidllhandle will exist when we are loaded by the IIS framework. +# In this case we redirect our output to the win32traceutil collector. +if hasattr(sys, "isapidllhandle"): + import win32traceutil + +# The site we are proxying. +proxy = "http://www.python.org" + +# Urls we exclude (ie, allow IIS to handle itself) - all are lowered, +# and these entries exist by default on Vista... +excludes = ["/iisstart.htm", "/welcome.png"] + + +# An "io completion" function, called when ecb.ExecURL completes... +def io_callback(ecb, url, cbIO, errcode): + # Get the status of our ExecURL + httpstatus, substatus, win32 = ecb.GetExecURLStatus() + print( + "ExecURL of %r finished with http status %d.%d, win32 status %d (%s)" + % (url, httpstatus, substatus, win32, win32api.FormatMessage(win32).strip()) + ) + # nothing more to do! + ecb.DoneWithSession() + + +# The ISAPI extension - handles all requests in the site. +class Extension(threaded_extension.ThreadPoolExtension): + "Python sample Extension" + + def Dispatch(self, ecb): + # Note that our ThreadPoolExtension base class will catch exceptions + # in our Dispatch method, and write the traceback to the client. + # That is perfect for this sample, so we don't catch our own. + # print 'IIS dispatching "%s"' % (ecb.GetServerVariable("URL"),) + url = ecb.GetServerVariable("URL").decode("ascii") + for exclude in excludes: + if url.lower().startswith(exclude): + print("excluding %s" % url) + if ecb.Version < 0x60000: + print("(but this is IIS5 or earlier - can't do 'excludes')") + else: + ecb.IOCompletion(io_callback, url) + ecb.ExecURL( + None, + None, + None, + None, + None, + isapicon.HSE_EXEC_URL_IGNORE_CURRENT_INTERCEPTOR, + ) + return isapicon.HSE_STATUS_PENDING + + new_url = proxy + url + print("Opening %s" % new_url) + fp = urlopen(new_url) + headers = fp.info() + # subtle py3k breakage: in py3k, str(headers) has normalized \r\n + # back to \n and also stuck an extra \n term. py2k leaves the + # \r\n from the server in tact and finishes with a single term. + if sys.version_info < (3, 0): + header_text = str(headers) + "\r\n" + else: + # take *all* trailing \n off, replace remaining with + # \r\n, then add the 2 trailing \r\n. + header_text = str(headers).rstrip("\n").replace("\n", "\r\n") + "\r\n\r\n" + ecb.SendResponseHeaders("200 OK", header_text, False) + ecb.WriteClient(fp.read()) + ecb.DoneWithSession() + print("Returned data from '%s'" % (new_url,)) + return isapicon.HSE_STATUS_SUCCESS + + +# The entry points for the ISAPI extension. +def __ExtensionFactory__(): + return Extension() + + +if __name__ == "__main__": + # If run from the command-line, install ourselves. + from isapi.install import * + + params = ISAPIParameters() + # Setup the virtual directories - this is a list of directories our + # extension uses - in this case only 1. + # Each extension has a "script map" - this is the mapping of ISAPI + # extensions. + sm = [ScriptMapParams(Extension="*", Flags=0)] + vd = VirtualDirParameters( + Name="/", + Description=Extension.__doc__, + ScriptMaps=sm, + ScriptMapUpdate="replace", + ) + params.VirtualDirs = [vd] + HandleCommandLine(params) diff --git a/lib/isapi/samples/redirector_asynch.py b/lib/isapi/samples/redirector_asynch.py new file mode 100644 index 00000000..3c4b5e4f --- /dev/null +++ b/lib/isapi/samples/redirector_asynch.py @@ -0,0 +1,85 @@ +# This is a sample ISAPI extension written in Python. + +# This is like the other 'redirector' samples, but uses asnch IO when writing +# back to the client (it does *not* use asynch io talking to the remote +# server!) + +import sys +import urllib.error +import urllib.parse +import urllib.request + +from isapi import isapicon, threaded_extension + +# sys.isapidllhandle will exist when we are loaded by the IIS framework. +# In this case we redirect our output to the win32traceutil collector. +if hasattr(sys, "isapidllhandle"): + import win32traceutil + +# The site we are proxying. +proxy = "http://www.python.org" + +# We synchronously read chunks of this size then asynchronously write them. +CHUNK_SIZE = 8192 + + +# The callback made when IIS completes the asynch write. +def io_callback(ecb, fp, cbIO, errcode): + print("IO callback", ecb, fp, cbIO, errcode) + chunk = fp.read(CHUNK_SIZE) + if chunk: + ecb.WriteClient(chunk, isapicon.HSE_IO_ASYNC) + # and wait for the next callback to say this chunk is done. + else: + # eof - say we are complete. + fp.close() + ecb.DoneWithSession() + + +# The ISAPI extension - handles all requests in the site. +class Extension(threaded_extension.ThreadPoolExtension): + "Python sample proxy server - asynch version." + + def Dispatch(self, ecb): + print('IIS dispatching "%s"' % (ecb.GetServerVariable("URL"),)) + url = ecb.GetServerVariable("URL") + + new_url = proxy + url + print("Opening %s" % new_url) + fp = urllib.request.urlopen(new_url) + headers = fp.info() + ecb.SendResponseHeaders("200 OK", str(headers) + "\r\n", False) + # now send the first chunk asynchronously + ecb.ReqIOCompletion(io_callback, fp) + chunk = fp.read(CHUNK_SIZE) + if chunk: + ecb.WriteClient(chunk, isapicon.HSE_IO_ASYNC) + return isapicon.HSE_STATUS_PENDING + # no data - just close things now. + ecb.DoneWithSession() + return isapicon.HSE_STATUS_SUCCESS + + +# The entry points for the ISAPI extension. +def __ExtensionFactory__(): + return Extension() + + +if __name__ == "__main__": + # If run from the command-line, install ourselves. + from isapi.install import * + + params = ISAPIParameters() + # Setup the virtual directories - this is a list of directories our + # extension uses - in this case only 1. + # Each extension has a "script map" - this is the mapping of ISAPI + # extensions. + sm = [ScriptMapParams(Extension="*", Flags=0)] + vd = VirtualDirParameters( + Name="/", + Description=Extension.__doc__, + ScriptMaps=sm, + ScriptMapUpdate="replace", + ) + params.VirtualDirs = [vd] + HandleCommandLine(params) diff --git a/lib/isapi/samples/redirector_with_filter.py b/lib/isapi/samples/redirector_with_filter.py new file mode 100644 index 00000000..a63b1db1 --- /dev/null +++ b/lib/isapi/samples/redirector_with_filter.py @@ -0,0 +1,161 @@ +# This is a sample configuration file for an ISAPI filter and extension +# written in Python. +# +# Please see README.txt in this directory, and specifically the +# information about the "loader" DLL - installing this sample will create +# "_redirector_with_filter.dll" in the current directory. The readme explains +# this. + +# Executing this script (or any server config script) will install the extension +# into your web server. As the server executes, the PyISAPI framework will load +# this module and create your Extension and Filter objects. + +# This sample provides sample redirector: +# It is implemented by a filter and an extension, so that some requests can +# be ignored. Compare with 'redirector_simple' which avoids the filter, but +# is unable to selectively ignore certain requests. +# The process is sample uses is: +# * The filter is installed globally, as all filters are. +# * A Virtual Directory named "python" is setup. This dir has our ISAPI +# extension as the only application, mapped to file-extension '*'. Thus, our +# extension handles *all* requests in this directory. +# The basic process is that the filter does URL rewriting, redirecting every +# URL to our Virtual Directory. Our extension then handles this request, +# forwarding the data from the proxied site. +# For example: +# * URL of "index.html" comes in. +# * Filter rewrites this to "/python/index.html" +# * Our extension sees the full "/python/index.html", removes the leading +# portion, and opens and forwards the remote URL. + + +# This sample is very small - it avoid most error handling, etc. It is for +# demonstration purposes only. + +import sys +import urllib.error +import urllib.parse +import urllib.request + +from isapi import isapicon, threaded_extension +from isapi.simple import SimpleFilter + +# sys.isapidllhandle will exist when we are loaded by the IIS framework. +# In this case we redirect our output to the win32traceutil collector. +if hasattr(sys, "isapidllhandle"): + import win32traceutil + +# The site we are proxying. +proxy = "http://www.python.org" +# The name of the virtual directory we install in, and redirect from. +virtualdir = "/python" + +# The key feature of this redirector over the simple redirector is that it +# can choose to ignore certain responses by having the filter not rewrite them +# to our virtual dir. For this sample, we just exclude the IIS help directory. + + +# The ISAPI extension - handles requests in our virtual dir, and sends the +# response to the client. +class Extension(threaded_extension.ThreadPoolExtension): + "Python sample Extension" + + def Dispatch(self, ecb): + # Note that our ThreadPoolExtension base class will catch exceptions + # in our Dispatch method, and write the traceback to the client. + # That is perfect for this sample, so we don't catch our own. + # print 'IIS dispatching "%s"' % (ecb.GetServerVariable("URL"),) + url = ecb.GetServerVariable("URL") + if url.startswith(virtualdir): + new_url = proxy + url[len(virtualdir) :] + print("Opening", new_url) + fp = urllib.request.urlopen(new_url) + headers = fp.info() + ecb.SendResponseHeaders("200 OK", str(headers) + "\r\n", False) + ecb.WriteClient(fp.read()) + ecb.DoneWithSession() + print("Returned data from '%s'!" % (new_url,)) + else: + # this should never happen - we should only see requests that + # start with our virtual directory name. + print("Not proxying '%s'" % (url,)) + + +# The ISAPI filter. +class Filter(SimpleFilter): + "Sample Python Redirector" + filter_flags = isapicon.SF_NOTIFY_PREPROC_HEADERS | isapicon.SF_NOTIFY_ORDER_DEFAULT + + def HttpFilterProc(self, fc): + # print "Filter Dispatch" + nt = fc.NotificationType + if nt != isapicon.SF_NOTIFY_PREPROC_HEADERS: + return isapicon.SF_STATUS_REQ_NEXT_NOTIFICATION + + pp = fc.GetData() + url = pp.GetHeader("url") + # print "URL is '%s'" % (url,) + prefix = virtualdir + if not url.startswith(prefix): + new_url = prefix + url + print("New proxied URL is '%s'" % (new_url,)) + pp.SetHeader("url", new_url) + # For the sake of demonstration, show how the FilterContext + # attribute is used. It always starts out life as None, and + # any assignments made are automatically decref'd by the + # framework during a SF_NOTIFY_END_OF_NET_SESSION notification. + if fc.FilterContext is None: + fc.FilterContext = 0 + fc.FilterContext += 1 + print("This is request number %d on this connection" % fc.FilterContext) + return isapicon.SF_STATUS_REQ_HANDLED_NOTIFICATION + else: + print("Filter ignoring URL '%s'" % (url,)) + + # Some older code that handled SF_NOTIFY_URL_MAP. + # ~ print "Have URL_MAP notify" + # ~ urlmap = fc.GetData() + # ~ print "URI is", urlmap.URL + # ~ print "Path is", urlmap.PhysicalPath + # ~ if urlmap.URL.startswith("/UC/"): + # ~ # Find the /UC/ in the physical path, and nuke it (except + # ~ # as the path is physical, it is \) + # ~ p = urlmap.PhysicalPath + # ~ pos = p.index("\\UC\\") + # ~ p = p[:pos] + p[pos+3:] + # ~ p = r"E:\src\pyisapi\webroot\PyTest\formTest.htm" + # ~ print "New path is", p + # ~ urlmap.PhysicalPath = p + + +# The entry points for the ISAPI extension. +def __FilterFactory__(): + return Filter() + + +def __ExtensionFactory__(): + return Extension() + + +if __name__ == "__main__": + # If run from the command-line, install ourselves. + from isapi.install import * + + params = ISAPIParameters() + # Setup all filters - these are global to the site. + params.Filters = [ + FilterParameters(Name="PythonRedirector", Description=Filter.__doc__), + ] + # Setup the virtual directories - this is a list of directories our + # extension uses - in this case only 1. + # Each extension has a "script map" - this is the mapping of ISAPI + # extensions. + sm = [ScriptMapParams(Extension="*", Flags=0)] + vd = VirtualDirParameters( + Name=virtualdir[1:], + Description=Extension.__doc__, + ScriptMaps=sm, + ScriptMapUpdate="replace", + ) + params.VirtualDirs = [vd] + HandleCommandLine(params) diff --git a/lib/isapi/samples/test.py b/lib/isapi/samples/test.py new file mode 100644 index 00000000..5e4d899b --- /dev/null +++ b/lib/isapi/samples/test.py @@ -0,0 +1,195 @@ +# This extension is used mainly for testing purposes - it is not +# designed to be a simple sample, but instead is a hotch-potch of things +# that attempts to exercise the framework. + +import os +import stat +import sys + +from isapi import isapicon +from isapi.simple import SimpleExtension + +if hasattr(sys, "isapidllhandle"): + import win32traceutil + +# We use the same reload support as 'advanced.py' demonstrates. +import threading + +import win32con +import win32event +import win32file +import winerror + +from isapi import InternalReloadException + + +# A watcher thread that checks for __file__ changing. +# When it detects it, it simply sets "change_detected" to true. +class ReloadWatcherThread(threading.Thread): + def __init__(self): + self.change_detected = False + self.filename = __file__ + if self.filename.endswith("c") or self.filename.endswith("o"): + self.filename = self.filename[:-1] + self.handle = win32file.FindFirstChangeNotification( + os.path.dirname(self.filename), + False, # watch tree? + win32con.FILE_NOTIFY_CHANGE_LAST_WRITE, + ) + threading.Thread.__init__(self) + + def run(self): + last_time = os.stat(self.filename)[stat.ST_MTIME] + while 1: + try: + rc = win32event.WaitForSingleObject(self.handle, win32event.INFINITE) + win32file.FindNextChangeNotification(self.handle) + except win32event.error as details: + # handle closed - thread should terminate. + if details.winerror != winerror.ERROR_INVALID_HANDLE: + raise + break + this_time = os.stat(self.filename)[stat.ST_MTIME] + if this_time != last_time: + print("Detected file change - flagging for reload.") + self.change_detected = True + last_time = this_time + + def stop(self): + win32file.FindCloseChangeNotification(self.handle) + + +def TransmitFileCallback(ecb, hFile, cbIO, errCode): + print("Transmit complete!") + ecb.close() + + +# The ISAPI extension - handles requests in our virtual dir, and sends the +# response to the client. +class Extension(SimpleExtension): + "Python test Extension" + + def __init__(self): + self.reload_watcher = ReloadWatcherThread() + self.reload_watcher.start() + + def HttpExtensionProc(self, ecb): + # NOTE: If you use a ThreadPoolExtension, you must still perform + # this check in HttpExtensionProc - raising the exception from + # The "Dispatch" method will just cause the exception to be + # rendered to the browser. + if self.reload_watcher.change_detected: + print("Doing reload") + raise InternalReloadException + + if ecb.GetServerVariable("UNICODE_URL").endswith("test.py"): + file_flags = ( + win32con.FILE_FLAG_SEQUENTIAL_SCAN | win32con.FILE_FLAG_OVERLAPPED + ) + hfile = win32file.CreateFile( + __file__, + win32con.GENERIC_READ, + 0, + None, + win32con.OPEN_EXISTING, + file_flags, + None, + ) + flags = ( + isapicon.HSE_IO_ASYNC + | isapicon.HSE_IO_DISCONNECT_AFTER_SEND + | isapicon.HSE_IO_SEND_HEADERS + ) + # We pass hFile to the callback simply as a way of keeping it alive + # for the duration of the transmission + try: + ecb.TransmitFile( + TransmitFileCallback, + hfile, + int(hfile), + "200 OK", + 0, + 0, + None, + None, + flags, + ) + except: + # Errors keep this source file open! + hfile.Close() + raise + else: + # default response + ecb.SendResponseHeaders("200 OK", "Content-Type: text/html\r\n\r\n", 0) + print("", file=ecb) + print("The root of this site is at", ecb.MapURLToPath("/"), file=ecb) + print("", file=ecb) + ecb.close() + return isapicon.HSE_STATUS_SUCCESS + + def TerminateExtension(self, status): + self.reload_watcher.stop() + + +# The entry points for the ISAPI extension. +def __ExtensionFactory__(): + return Extension() + + +# Our special command line customization. +# Pre-install hook for our virtual directory. +def PreInstallDirectory(params, options): + # If the user used our special '--description' option, + # then we override our default. + if options.description: + params.Description = options.description + + +# Post install hook for our entire script +def PostInstall(params, options): + print() + print("The sample has been installed.") + print("Point your browser to /PyISAPITest") + + +# Handler for our custom 'status' argument. +def status_handler(options, log, arg): + "Query the status of something" + print("Everything seems to be fine!") + + +custom_arg_handlers = {"status": status_handler} + +if __name__ == "__main__": + # If run from the command-line, install ourselves. + from isapi.install import * + + params = ISAPIParameters(PostInstall=PostInstall) + # Setup the virtual directories - this is a list of directories our + # extension uses - in this case only 1. + # Each extension has a "script map" - this is the mapping of ISAPI + # extensions. + sm = [ScriptMapParams(Extension="*", Flags=0)] + vd = VirtualDirParameters( + Name="PyISAPITest", + Description=Extension.__doc__, + ScriptMaps=sm, + ScriptMapUpdate="replace", + # specify the pre-install hook. + PreInstall=PreInstallDirectory, + ) + params.VirtualDirs = [vd] + # Setup our custom option parser. + from optparse import OptionParser + + parser = OptionParser("") # blank usage, so isapi sets it. + parser.add_option( + "", + "--description", + action="store", + help="custom description to use for the virtual directory", + ) + + HandleCommandLine( + params, opt_parser=parser, custom_arg_handlers=custom_arg_handlers + ) diff --git a/lib/isapi/simple.py b/lib/isapi/simple.py new file mode 100644 index 00000000..b453bbae --- /dev/null +++ b/lib/isapi/simple.py @@ -0,0 +1,70 @@ +"""Simple base-classes for extensions and filters. + +None of the filter and extension functions are considered 'optional' by the +framework. These base-classes provide simple implementations for the +Initialize and Terminate functions, allowing you to omit them, + +It is not necessary to use these base-classes - but if you don't, you +must ensure each of the required methods are implemented. +""" + + +class SimpleExtension: + "Base class for a simple ISAPI extension" + + def __init__(self): + pass + + def GetExtensionVersion(self, vi): + """Called by the ISAPI framework to get the extension version + + The default implementation uses the classes docstring to + set the extension description.""" + # nod to our reload capability - vi is None when we are reloaded. + if vi is not None: + vi.ExtensionDesc = self.__doc__ + + def HttpExtensionProc(self, control_block): + """Called by the ISAPI framework for each extension request. + + sub-classes must provide an implementation for this method. + """ + raise NotImplementedError("sub-classes should override HttpExtensionProc") + + def TerminateExtension(self, status): + """Called by the ISAPI framework as the extension terminates.""" + pass + + +class SimpleFilter: + "Base class for a a simple ISAPI filter" + filter_flags = None + + def __init__(self): + pass + + def GetFilterVersion(self, fv): + """Called by the ISAPI framework to get the extension version + + The default implementation uses the classes docstring to + set the extension description, and uses the classes + filter_flags attribute to set the ISAPI filter flags - you + must specify filter_flags in your class. + """ + if self.filter_flags is None: + raise RuntimeError("You must specify the filter flags") + # nod to our reload capability - fv is None when we are reloaded. + if fv is not None: + fv.Flags = self.filter_flags + fv.FilterDesc = self.__doc__ + + def HttpFilterProc(self, fc): + """Called by the ISAPI framework for each filter request. + + sub-classes must provide an implementation for this method. + """ + raise NotImplementedError("sub-classes should override HttpExtensionProc") + + def TerminateFilter(self, status): + """Called by the ISAPI framework as the filter terminates.""" + pass diff --git a/lib/isapi/test/README.txt b/lib/isapi/test/README.txt new file mode 100644 index 00000000..18643dd7 --- /dev/null +++ b/lib/isapi/test/README.txt @@ -0,0 +1,3 @@ +This is a directory for tests of the PyISAPI framework. + +For demos, please see the pyisapi 'samples' directory. \ No newline at end of file diff --git a/lib/isapi/test/extension_simple.py b/lib/isapi/test/extension_simple.py new file mode 100644 index 00000000..64bd71fd --- /dev/null +++ b/lib/isapi/test/extension_simple.py @@ -0,0 +1,119 @@ +# This is an ISAPI extension purely for testing purposes. It is NOT +# a 'demo' (even though it may be useful!) +# +# Install this extension, then point your browser to: +# "http://localhost/pyisapi_test/test1" +# This will execute the method 'test1' below. See below for the list of +# test methods that are acceptable. + +import urllib.error +import urllib.parse +import urllib.request + +# If we have no console (eg, am running from inside IIS), redirect output +# somewhere useful - in this case, the standard win32 trace collector. +import win32api +import winerror + +from isapi import ExtensionError, isapicon, threaded_extension +from isapi.simple import SimpleFilter + +try: + win32api.GetConsoleTitle() +except win32api.error: + # No console - redirect + import win32traceutil + + +# The ISAPI extension - handles requests in our virtual dir, and sends the +# response to the client. +class Extension(threaded_extension.ThreadPoolExtension): + "Python ISAPI Tester" + + def Dispatch(self, ecb): + print('Tester dispatching "%s"' % (ecb.GetServerVariable("URL"),)) + url = ecb.GetServerVariable("URL") + test_name = url.split("/")[-1] + meth = getattr(self, test_name, None) + if meth is None: + raise AttributeError("No test named '%s'" % (test_name,)) + result = meth(ecb) + if result is None: + # This means the test finalized everything + return + ecb.SendResponseHeaders("200 OK", "Content-type: text/html\r\n\r\n", False) + print("Finished running test ", test_name, "", file=ecb) + print("

    ", file=ecb)
+        print(result, file=ecb)
+        print("
    ", file=ecb) + print("", file=ecb) + ecb.DoneWithSession() + + def test1(self, ecb): + try: + ecb.GetServerVariable("foo bar") + raise RuntimeError("should have failed!") + except ExtensionError as err: + assert err.errno == winerror.ERROR_INVALID_INDEX, err + return "worked!" + + def test_long_vars(self, ecb): + qs = ecb.GetServerVariable("QUERY_STRING") + # Our implementation has a default buffer size of 8k - so we test + # the code that handles an overflow by ensuring there are more + # than 8k worth of chars in the URL. + expected_query = "x" * 8500 + if len(qs) == 0: + # Just the URL with no query part - redirect to myself, but with + # a huge query portion. + me = ecb.GetServerVariable("URL") + headers = "Location: " + me + "?" + expected_query + "\r\n\r\n" + ecb.SendResponseHeaders("301 Moved", headers) + ecb.DoneWithSession() + return None + if qs == expected_query: + return "Total length of variable is %d - test worked!" % (len(qs),) + else: + return "Unexpected query portion! Got %d chars, expected %d" % ( + len(qs), + len(expected_query), + ) + + def test_unicode_vars(self, ecb): + # We need to check that we are running IIS6! This seems the only + # effective way from an extension. + ver = float(ecb.GetServerVariable("SERVER_SOFTWARE").split("/")[1]) + if ver < 6.0: + return "This is IIS version %g - unicode only works in IIS6 and later" % ver + + us = ecb.GetServerVariable("UNICODE_SERVER_NAME") + if not isinstance(us, str): + raise RuntimeError("unexpected type!") + if us != str(ecb.GetServerVariable("SERVER_NAME")): + raise RuntimeError("Unicode and non-unicode values were not the same") + return "worked!" + + +# The entry points for the ISAPI extension. +def __ExtensionFactory__(): + return Extension() + + +if __name__ == "__main__": + # If run from the command-line, install ourselves. + from isapi.install import * + + params = ISAPIParameters() + # Setup the virtual directories - this is a list of directories our + # extension uses - in this case only 1. + # Each extension has a "script map" - this is the mapping of ISAPI + # extensions. + sm = [ScriptMapParams(Extension="*", Flags=0)] + vd = VirtualDirParameters( + Name="pyisapi_test", + Description=Extension.__doc__, + ScriptMaps=sm, + ScriptMapUpdate="replace", + ) + params.VirtualDirs = [vd] + HandleCommandLine(params) diff --git a/lib/isapi/threaded_extension.py b/lib/isapi/threaded_extension.py new file mode 100644 index 00000000..b31c8c9e --- /dev/null +++ b/lib/isapi/threaded_extension.py @@ -0,0 +1,189 @@ +"""An ISAPI extension base class implemented using a thread-pool.""" +# $Id$ + +import sys +import threading +import time +import traceback + +from pywintypes import OVERLAPPED +from win32event import INFINITE +from win32file import ( + CloseHandle, + CreateIoCompletionPort, + GetQueuedCompletionStatus, + PostQueuedCompletionStatus, +) +from win32security import SetThreadToken + +import isapi.simple +from isapi import ExtensionError, isapicon + +ISAPI_REQUEST = 1 +ISAPI_SHUTDOWN = 2 + + +class WorkerThread(threading.Thread): + def __init__(self, extension, io_req_port): + self.running = False + self.io_req_port = io_req_port + self.extension = extension + threading.Thread.__init__(self) + # We wait 15 seconds for a thread to terminate, but if it fails to, + # we don't want the process to hang at exit waiting for it... + self.setDaemon(True) + + def run(self): + self.running = True + while self.running: + errCode, bytes, key, overlapped = GetQueuedCompletionStatus( + self.io_req_port, INFINITE + ) + if key == ISAPI_SHUTDOWN and overlapped is None: + break + + # Let the parent extension handle the command. + dispatcher = self.extension.dispatch_map.get(key) + if dispatcher is None: + raise RuntimeError("Bad request '%s'" % (key,)) + + dispatcher(errCode, bytes, key, overlapped) + + def call_handler(self, cblock): + self.extension.Dispatch(cblock) + + +# A generic thread-pool based extension, using IO Completion Ports. +# Sub-classes can override one method to implement a simple extension, or +# may leverage the CompletionPort to queue their own requests, and implement a +# fully asynch extension. +class ThreadPoolExtension(isapi.simple.SimpleExtension): + "Base class for an ISAPI extension based around a thread-pool" + max_workers = 20 + worker_shutdown_wait = 15000 # 15 seconds for workers to quit... + + def __init__(self): + self.workers = [] + # extensible dispatch map, for sub-classes that need to post their + # own requests to the completion port. + # Each of these functions is called with the result of + # GetQueuedCompletionStatus for our port. + self.dispatch_map = { + ISAPI_REQUEST: self.DispatchConnection, + } + + def GetExtensionVersion(self, vi): + isapi.simple.SimpleExtension.GetExtensionVersion(self, vi) + # As per Q192800, the CompletionPort should be created with the number + # of processors, even if the number of worker threads is much larger. + # Passing 0 means the system picks the number. + self.io_req_port = CreateIoCompletionPort(-1, None, 0, 0) + # start up the workers + self.workers = [] + for i in range(self.max_workers): + worker = WorkerThread(self, self.io_req_port) + worker.start() + self.workers.append(worker) + + def HttpExtensionProc(self, control_block): + overlapped = OVERLAPPED() + overlapped.object = control_block + PostQueuedCompletionStatus(self.io_req_port, 0, ISAPI_REQUEST, overlapped) + return isapicon.HSE_STATUS_PENDING + + def TerminateExtension(self, status): + for worker in self.workers: + worker.running = False + for worker in self.workers: + PostQueuedCompletionStatus(self.io_req_port, 0, ISAPI_SHUTDOWN, None) + # wait for them to terminate - pity we aren't using 'native' threads + # as then we could do a smart wait - but now we need to poll.... + end_time = time.time() + self.worker_shutdown_wait / 1000 + alive = self.workers + while alive: + if time.time() > end_time: + # xxx - might be nice to log something here. + break + time.sleep(0.2) + alive = [w for w in alive if w.is_alive()] + self.dispatch_map = {} # break circles + CloseHandle(self.io_req_port) + + # This is the one operation the base class supports - a simple + # Connection request. We setup the thread-token, and dispatch to the + # sub-class's 'Dispatch' method. + def DispatchConnection(self, errCode, bytes, key, overlapped): + control_block = overlapped.object + # setup the correct user for this request + hRequestToken = control_block.GetImpersonationToken() + SetThreadToken(None, hRequestToken) + try: + try: + self.Dispatch(control_block) + except: + self.HandleDispatchError(control_block) + finally: + # reset the security context + SetThreadToken(None, None) + + def Dispatch(self, ecb): + """Overridden by the sub-class to handle connection requests. + + This class creates a thread-pool using a Windows completion port, + and dispatches requests via this port. Sub-classes can generally + implement each connection request using blocking reads and writes, and + the thread-pool will still provide decent response to the end user. + + The sub-class can set a max_workers attribute (default is 20). Note + that this generally does *not* mean 20 threads will all be concurrently + running, via the magic of Windows completion ports. + + There is no default implementation - sub-classes must implement this. + """ + raise NotImplementedError("sub-classes should override Dispatch") + + def HandleDispatchError(self, ecb): + """Handles errors in the Dispatch method. + + When a Dispatch method call fails, this method is called to handle + the exception. The default implementation formats the traceback + in the browser. + """ + ecb.HttpStatusCode = isapicon.HSE_STATUS_ERROR + # control_block.LogData = "we failed!" + exc_typ, exc_val, exc_tb = sys.exc_info() + limit = None + try: + try: + import cgi + + ecb.SendResponseHeaders( + "200 OK", "Content-type: text/html\r\n\r\n", False + ) + print(file=ecb) + print("

    Traceback (most recent call last):

    ", file=ecb) + list = traceback.format_tb( + exc_tb, limit + ) + traceback.format_exception_only(exc_typ, exc_val) + print( + "
    %s%s
    " + % ( + cgi.escape("".join(list[:-1])), + cgi.escape(list[-1]), + ), + file=ecb, + ) + except ExtensionError: + # The client disconnected without reading the error body - + # its probably not a real browser at the other end, ignore it. + pass + except: + print("FAILED to render the error message!") + traceback.print_exc() + print("ORIGINAL extension error:") + traceback.print_exception(exc_typ, exc_val, exc_tb) + finally: + # holding tracebacks in a local of a frame that may itself be + # part of a traceback used to be evil and cause leaks! + exc_tb = None + ecb.DoneWithSession() diff --git a/lib/jaraco/collections.py b/lib/jaraco/collections/__init__.py similarity index 88% rename from lib/jaraco/collections.py rename to lib/jaraco/collections/__init__.py index db89b122..abedf002 100644 --- a/lib/jaraco/collections.py +++ b/lib/jaraco/collections/__init__.py @@ -5,23 +5,49 @@ import itertools import copy import functools import random +from collections.abc import Container, Iterable, Mapping +from typing import Callable, Union -from jaraco.classes.properties import NonDataProperty import jaraco.text +_Matchable = Union[Callable, Container, Iterable, re.Pattern] + + +def _dispatch(obj: _Matchable) -> Callable: + # can't rely on singledispatch for Union[Container, Iterable] + # due to ambiguity + # (https://peps.python.org/pep-0443/#abstract-base-classes). + if isinstance(obj, re.Pattern): + return obj.fullmatch + if not isinstance(obj, Callable): # type: ignore + if not isinstance(obj, Container): + obj = set(obj) # type: ignore + obj = obj.__contains__ + return obj # type: ignore + + class Projection(collections.abc.Mapping): """ Project a set of keys over a mapping >>> sample = {'a': 1, 'b': 2, 'c': 3} >>> prj = Projection(['a', 'c', 'd'], sample) - >>> prj == {'a': 1, 'c': 3} + >>> dict(prj) + {'a': 1, 'c': 3} + + Projection also accepts an iterable or callable or pattern. + + >>> iter_prj = Projection(iter('acd'), sample) + >>> call_prj = Projection(lambda k: ord(k) in (97, 99, 100), sample) + >>> pat_prj = Projection(re.compile(r'[acd]'), sample) + >>> prj == iter_prj == call_prj == pat_prj True Keys should only appear if they were specified and exist in the space. + Order is retained. - >>> sorted(list(prj.keys())) + >>> list(prj) ['a', 'c'] Attempting to access a key not in the projection @@ -36,119 +62,58 @@ class Projection(collections.abc.Mapping): >>> target = {'a': 2, 'b': 2} >>> target.update(prj) - >>> target == {'a': 1, 'b': 2, 'c': 3} - True + >>> target + {'a': 1, 'b': 2, 'c': 3} - Also note that Projection keeps a reference to the original dict, so - if you modify the original dict, that could modify the Projection. + Projection keeps a reference to the original dict, so + modifying the original dict may modify the Projection. >>> del sample['a'] >>> dict(prj) {'c': 3} """ - def __init__(self, keys, space): - self._keys = tuple(keys) + def __init__(self, keys: _Matchable, space: Mapping): + self._match = _dispatch(keys) self._space = space def __getitem__(self, key): - if key not in self._keys: + if not self._match(key): raise KeyError(key) return self._space[key] + def _keys_resolved(self): + return filter(self._match, self._space) + def __iter__(self): - return iter(set(self._keys).intersection(self._space)) + return self._keys_resolved() def __len__(self): - return len(tuple(iter(self))) + return len(tuple(self._keys_resolved())) -class DictFilter(collections.abc.Mapping): +class Mask(Projection): """ - Takes a dict, and simulates a sub-dict based on the keys. + The inverse of a :class:`Projection`, masking out keys. >>> sample = {'a': 1, 'b': 2, 'c': 3} - >>> filtered = DictFilter(sample, ['a', 'c']) - >>> filtered == {'a': 1, 'c': 3} - True - >>> set(filtered.values()) == {1, 3} - True - >>> set(filtered.items()) == {('a', 1), ('c', 3)} - True - - One can also filter by a regular expression pattern - - >>> sample['d'] = 4 - >>> sample['ef'] = 5 - - Here we filter for only single-character keys - - >>> filtered = DictFilter(sample, include_pattern='.$') - >>> filtered == {'a': 1, 'b': 2, 'c': 3, 'd': 4} - True - - >>> filtered['e'] - Traceback (most recent call last): - ... - KeyError: 'e' - - >>> 'e' in filtered - False - - Pattern is useful for excluding keys with a prefix. - - >>> filtered = DictFilter(sample, include_pattern=r'(?![ace])') - >>> dict(filtered) - {'b': 2, 'd': 4} - - Also note that DictFilter keeps a reference to the original dict, so - if you modify the original dict, that could modify the filtered dict. - - >>> del sample['d'] - >>> dict(filtered) + >>> msk = Mask(['a', 'c', 'd'], sample) + >>> dict(msk) {'b': 2} """ - def __init__(self, dict, include_keys=[], include_pattern=None): - self.dict = dict - self.specified_keys = set(include_keys) - if include_pattern is not None: - self.include_pattern = re.compile(include_pattern) - else: - # for performance, replace the pattern_keys property - self.pattern_keys = set() - - def get_pattern_keys(self): - keys = filter(self.include_pattern.match, self.dict.keys()) - return set(keys) - - pattern_keys = NonDataProperty(get_pattern_keys) - - @property - def include_keys(self): - return self.specified_keys | self.pattern_keys - - def __getitem__(self, i): - if i not in self.include_keys: - raise KeyError(i) - return self.dict[i] - - def __iter__(self): - return filter(self.include_keys.__contains__, self.dict.keys()) - - def __len__(self): - return len(list(self)) + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + # self._match = compose(operator.not_, self._match) + self._match = lambda key, orig=self._match: not orig(key) def dict_map(function, dictionary): """ - dict_map is much like the built-in function map. It takes a dictionary - and applys a function to the values of that dictionary, returning a - new dictionary with the mapped values in the original keys. + Return a new dict with function applied to values of dictionary. - >>> d = dict_map(lambda x:x+1, dict(a=1, b=2)) - >>> d == dict(a=2,b=3) - True + >>> dict_map(lambda x: x+1, dict(a=1, b=2)) + {'a': 2, 'b': 3} """ return dict((key, function(value)) for key, value in dictionary.items()) @@ -164,7 +129,7 @@ class RangeMap(dict): One may supply keyword parameters to be passed to the sort function used to sort keys (i.e. key, reverse) as sort_params. - Let's create a map that maps 1-3 -> 'a', 4-6 -> 'b' + Create a map that maps 1-3 -> 'a', 4-6 -> 'b' >>> r = RangeMap({3: 'a', 6: 'b'}) # boy, that was easy >>> r[1], r[2], r[3], r[4], r[5], r[6] @@ -176,7 +141,7 @@ class RangeMap(dict): >>> r[4.5] 'b' - But you'll notice that the way rangemap is defined, it must be open-ended + Notice that the way rangemap is defined, it must be open-ended on one side. >>> r[0] @@ -279,7 +244,7 @@ class RangeMap(dict): return (sorted_keys[RangeMap.first_item], sorted_keys[RangeMap.last_item]) # some special values for the RangeMap - undefined_value = type(str('RangeValueUndefined'), (), {})() + undefined_value = type('RangeValueUndefined', (), {})() class Item(int): "RangeMap Item" @@ -294,7 +259,7 @@ def __identity(x): def sorted_items(d, key=__identity, reverse=False): """ - Return the items of the dictionary sorted by the keys + Return the items of the dictionary sorted by the keys. >>> sample = dict(foo=20, bar=42, baz=10) >>> tuple(sorted_items(sample)) @@ -307,6 +272,7 @@ def sorted_items(d, key=__identity, reverse=False): >>> tuple(sorted_items(sample, reverse=True)) (('foo', 20), ('baz', 10), ('bar', 42)) """ + # wrap the key func so it operates on the first element of each item def pairkey_key(item): return key(item[0]) @@ -475,7 +441,7 @@ class ItemsAsAttributes: Mix-in class to enable a mapping object to provide items as attributes. - >>> C = type(str('C'), (dict, ItemsAsAttributes), dict()) + >>> C = type('C', (dict, ItemsAsAttributes), dict()) >>> i = C() >>> i['foo'] = 'bar' >>> i.foo @@ -504,7 +470,7 @@ class ItemsAsAttributes: >>> missing_func = lambda self, key: 'missing item' >>> C = type( - ... str('C'), + ... 'C', ... (dict, ItemsAsAttributes), ... dict(__missing__ = missing_func), ... ) diff --git a/lib/jaraco/collections/py.typed b/lib/jaraco/collections/py.typed new file mode 100644 index 00000000..e69de29b diff --git a/lib/jaraco/context.py b/lib/jaraco/context.py index 87a4e3dc..b0d1ef37 100644 --- a/lib/jaraco/context.py +++ b/lib/jaraco/context.py @@ -5,10 +5,18 @@ import functools import tempfile import shutil import operator +import warnings @contextlib.contextmanager def pushd(dir): + """ + >>> tmp_path = getfixture('tmp_path') + >>> with pushd(tmp_path): + ... assert os.getcwd() == os.fspath(tmp_path) + >>> assert os.getcwd() != os.fspath(tmp_path) + """ + orig = os.getcwd() os.chdir(dir) try: @@ -29,6 +37,8 @@ def tarball_context(url, target_dir=None, runner=None, pushd=pushd): target_dir = os.path.basename(url).replace('.tar.gz', '').replace('.tgz', '') if runner is None: runner = functools.partial(subprocess.check_call, shell=True) + else: + warnings.warn("runner parameter is deprecated", DeprecationWarning) # In the tar command, use --strip-components=1 to strip the first path and # then # use -C to cause the files to be extracted to {target_dir}. This ensures @@ -48,6 +58,15 @@ def tarball_context(url, target_dir=None, runner=None, pushd=pushd): def infer_compression(url): """ Given a URL or filename, infer the compression code for tar. + + >>> infer_compression('http://foo/bar.tar.gz') + 'z' + >>> infer_compression('http://foo/bar.tgz') + 'z' + >>> infer_compression('file.bz') + 'j' + >>> infer_compression('file.xz') + 'J' """ # cheat and just assume it's the last two characters compression_indicator = url[-2:] @@ -61,6 +80,12 @@ def temp_dir(remover=shutil.rmtree): """ Create a temporary directory context. Pass a custom remover to override the removal behavior. + + >>> import pathlib + >>> with temp_dir() as the_dir: + ... assert os.path.isdir(the_dir) + ... _ = pathlib.Path(the_dir).joinpath('somefile').write_text('contents') + >>> assert not os.path.exists(the_dir) """ temp_dir = tempfile.mkdtemp() try: @@ -90,6 +115,12 @@ def repo_context(url, branch=None, quiet=True, dest_ctx=temp_dir): @contextlib.contextmanager def null(): + """ + A null context suitable to stand in for a meaningful context. + + >>> with null() as value: + ... assert value is None + """ yield @@ -112,6 +143,10 @@ class ExceptionTrap: ... raise ValueError("1 + 1 is not 3") >>> bool(trap) True + >>> trap.value + ValueError('1 + 1 is not 3') + >>> trap.tb + >>> with ExceptionTrap(ValueError) as trap: ... raise Exception() @@ -211,3 +246,43 @@ class suppress(contextlib.suppress, contextlib.ContextDecorator): ... {}[''] >>> key_error() """ + + +class on_interrupt(contextlib.ContextDecorator): + """ + Replace a KeyboardInterrupt with SystemExit(1) + + >>> def do_interrupt(): + ... raise KeyboardInterrupt() + >>> on_interrupt('error')(do_interrupt)() + Traceback (most recent call last): + ... + SystemExit: 1 + >>> on_interrupt('error', code=255)(do_interrupt)() + Traceback (most recent call last): + ... + SystemExit: 255 + >>> on_interrupt('suppress')(do_interrupt)() + >>> with __import__('pytest').raises(KeyboardInterrupt): + ... on_interrupt('ignore')(do_interrupt)() + """ + + def __init__( + self, + action='error', + # py3.7 compat + # /, + code=1, + ): + self.action = action + self.code = code + + def __enter__(self): + return self + + def __exit__(self, exctype, excinst, exctb): + if exctype is not KeyboardInterrupt or self.action == 'ignore': + return + elif self.action == 'error': + raise SystemExit(self.code) from excinst + return self.action == 'suppress' diff --git a/lib/jaraco/functools.py b/lib/jaraco/functools/__init__.py similarity index 84% rename from lib/jaraco/functools.py rename to lib/jaraco/functools/__init__.py index 43c009f9..ca6c22fa 100644 --- a/lib/jaraco/functools.py +++ b/lib/jaraco/functools/__init__.py @@ -1,4 +1,4 @@ -import collections +import collections.abc import functools import inspect import itertools @@ -9,11 +9,6 @@ import warnings import more_itertools -from typing import Callable, TypeVar - - -CallableT = TypeVar("CallableT", bound=Callable[..., object]) - def compose(*funcs): """ @@ -39,24 +34,6 @@ def compose(*funcs): return functools.reduce(compose_two, funcs) -def method_caller(method_name, *args, **kwargs): - """ - Return a function that will call a named method on the - target object with optional positional and keyword - arguments. - - >>> lower = method_caller('lower') - >>> lower('MyString') - 'mystring' - """ - - def call_method(target): - func = getattr(target, method_name) - return func(*args, **kwargs) - - return call_method - - def once(func): """ Decorate func so it's only ever called the first time. @@ -99,12 +76,7 @@ def once(func): return wrapper -def method_cache( - method: CallableT, - cache_wrapper: Callable[ - [CallableT], CallableT - ] = functools.lru_cache(), # type: ignore[assignment] -) -> CallableT: +def method_cache(method, cache_wrapper=functools.lru_cache()): """ Wrap lru_cache to support storing the cache data in the object instances. @@ -172,22 +144,17 @@ def method_cache( for another implementation and additional justification. """ - def wrapper(self: object, *args: object, **kwargs: object) -> object: + def wrapper(self, *args, **kwargs): # it's the first call, replace the method with a cached, bound method - bound_method: CallableT = types.MethodType( # type: ignore[assignment] - method, self - ) + bound_method = types.MethodType(method, self) cached_method = cache_wrapper(bound_method) setattr(self, method.__name__, cached_method) return cached_method(*args, **kwargs) # Support cache clear even before cache has been created. - wrapper.cache_clear = lambda: None # type: ignore[attr-defined] + wrapper.cache_clear = lambda: None - return ( - _special_method_cache(method, cache_wrapper) # type: ignore[return-value] - or wrapper - ) + return _special_method_cache(method, cache_wrapper) or wrapper def _special_method_cache(method, cache_wrapper): @@ -203,12 +170,13 @@ def _special_method_cache(method, cache_wrapper): """ name = method.__name__ special_names = '__getattr__', '__getitem__' + if name not in special_names: - return + return None wrapper_name = '__cached' + name - def proxy(self, *args, **kwargs): + def proxy(self, /, *args, **kwargs): if wrapper_name not in vars(self): bound = types.MethodType(method, self) cache = cache_wrapper(bound) @@ -245,7 +213,7 @@ def result_invoke(action): r""" Decorate a function with an action function that is invoked on the results returned from the decorated - function (for its side-effect), then return the original + function (for its side effect), then return the original result. >>> @result_invoke(print) @@ -269,7 +237,7 @@ def result_invoke(action): return wrap -def invoke(f, *args, **kwargs): +def invoke(f, /, *args, **kwargs): """ Call a function for its side effect after initialization. @@ -304,25 +272,15 @@ def invoke(f, *args, **kwargs): Use functools.partial to pass parameters to the initial call >>> @functools.partial(invoke, name='bingo') - ... def func(name): print("called with", name) + ... def func(name): print('called with', name) called with bingo """ f(*args, **kwargs) return f -def call_aside(*args, **kwargs): - """ - Deprecated name for invoke. - """ - warnings.warn("call_aside is deprecated, use invoke", DeprecationWarning) - return invoke(*args, **kwargs) - - class Throttler: - """ - Rate-limit a function (or other callable) - """ + """Rate-limit a function (or other callable).""" def __init__(self, func, max_rate=float('Inf')): if isinstance(func, Throttler): @@ -339,20 +297,20 @@ class Throttler: return self.func(*args, **kwargs) def _wait(self): - "ensure at least 1/max_rate seconds from last call" + """Ensure at least 1/max_rate seconds from last call.""" elapsed = time.time() - self.last_called must_wait = 1 / self.max_rate - elapsed time.sleep(max(0, must_wait)) self.last_called = time.time() - def __get__(self, obj, type=None): + def __get__(self, obj, owner=None): return first_invoke(self._wait, functools.partial(self.func, obj)) def first_invoke(func1, func2): """ Return a function that when invoked will invoke func1 without - any parameters (for its side-effect) and then invoke func2 + any parameters (for its side effect) and then invoke func2 with whatever parameters were passed, returning its result. """ @@ -363,6 +321,17 @@ def first_invoke(func1, func2): return wrapper +method_caller = first_invoke( + lambda: warnings.warn( + '`jaraco.functools.method_caller` is deprecated, ' + 'use `operator.methodcaller` instead', + DeprecationWarning, + stacklevel=3, + ), + operator.methodcaller, +) + + def retry_call(func, cleanup=lambda: None, retries=0, trap=()): """ Given a callable func, trap the indicated exceptions @@ -371,7 +340,7 @@ def retry_call(func, cleanup=lambda: None, retries=0, trap=()): to propagate. """ attempts = itertools.count() if retries == float('inf') else range(retries) - for attempt in attempts: + for _ in attempts: try: return func() except trap: @@ -408,7 +377,7 @@ def retry(*r_args, **r_kwargs): def print_yielded(func): """ - Convert a generator into a function that prints all yielded elements + Convert a generator into a function that prints all yielded elements. >>> @print_yielded ... def x(): @@ -424,7 +393,7 @@ def print_yielded(func): def pass_none(func): """ - Wrap func so it's not called if its first param is None + Wrap func so it's not called if its first param is None. >>> print_text = pass_none(print) >>> print_text('text') @@ -433,9 +402,10 @@ def pass_none(func): """ @functools.wraps(func) - def wrapper(param, *args, **kwargs): + def wrapper(param, /, *args, **kwargs): if param is not None: return func(param, *args, **kwargs) + return None return wrapper @@ -509,7 +479,7 @@ def save_method_args(method): args_and_kwargs = collections.namedtuple('args_and_kwargs', 'args kwargs') @functools.wraps(method) - def wrapper(self, *args, **kwargs): + def wrapper(self, /, *args, **kwargs): attr_name = '_saved_' + method.__name__ attr = args_and_kwargs(args, kwargs) setattr(self, attr_name, attr) @@ -559,6 +529,13 @@ def except_(*exceptions, replace=None, use=None): def identity(x): + """ + Return the argument. + + >>> o = object() + >>> identity(o) is o + True + """ return x @@ -580,7 +557,7 @@ def bypass_when(check, *, _op=identity): def decorate(func): @functools.wraps(func) - def wrapper(param): + def wrapper(param, /): return param if _op(check) else func(param) return wrapper @@ -604,3 +581,53 @@ def bypass_unless(check): 2 """ return bypass_when(check, _op=operator.not_) + + +@functools.singledispatch +def _splat_inner(args, func): + """Splat args to func.""" + return func(*args) + + +@_splat_inner.register +def _(args: collections.abc.Mapping, func): + """Splat kargs to func as kwargs.""" + return func(**args) + + +def splat(func): + """ + Wrap func to expect its parameters to be passed positionally in a tuple. + + Has a similar effect to that of ``itertools.starmap`` over + simple ``map``. + + >>> pairs = [(-1, 1), (0, 2)] + >>> more_itertools.consume(itertools.starmap(print, pairs)) + -1 1 + 0 2 + >>> more_itertools.consume(map(splat(print), pairs)) + -1 1 + 0 2 + + The approach generalizes to other iterators that don't have a "star" + equivalent, such as a "starfilter". + + >>> list(filter(splat(operator.add), pairs)) + [(0, 2)] + + Splat also accepts a mapping argument. + + >>> def is_nice(msg, code): + ... return "smile" in msg or code == 0 + >>> msgs = [ + ... dict(msg='smile!', code=20), + ... dict(msg='error :(', code=1), + ... dict(msg='unknown', code=0), + ... ] + >>> for msg in filter(splat(is_nice), msgs): + ... print(msg) + {'msg': 'smile!', 'code': 20} + {'msg': 'unknown', 'code': 0} + """ + return functools.wraps(func)(functools.partial(_splat_inner, func=func)) diff --git a/lib/jaraco/functools/__init__.pyi b/lib/jaraco/functools/__init__.pyi new file mode 100644 index 00000000..c2b9ab17 --- /dev/null +++ b/lib/jaraco/functools/__init__.pyi @@ -0,0 +1,128 @@ +from collections.abc import Callable, Hashable, Iterator +from functools import partial +from operator import methodcaller +import sys +from typing import ( + Any, + Generic, + Protocol, + TypeVar, + overload, +) + +if sys.version_info >= (3, 10): + from typing import Concatenate, ParamSpec +else: + from typing_extensions import Concatenate, ParamSpec + +_P = ParamSpec('_P') +_R = TypeVar('_R') +_T = TypeVar('_T') +_R1 = TypeVar('_R1') +_R2 = TypeVar('_R2') +_V = TypeVar('_V') +_S = TypeVar('_S') +_R_co = TypeVar('_R_co', covariant=True) + +class _OnceCallable(Protocol[_P, _R]): + saved_result: _R + reset: Callable[[], None] + def __call__(self, *args: _P.args, **kwargs: _P.kwargs) -> _R: ... + +class _ProxyMethodCacheWrapper(Protocol[_R_co]): + cache_clear: Callable[[], None] + def __call__(self, *args: Hashable, **kwargs: Hashable) -> _R_co: ... + +class _MethodCacheWrapper(Protocol[_R_co]): + def cache_clear(self) -> None: ... + def __call__(self, *args: Hashable, **kwargs: Hashable) -> _R_co: ... + +# `compose()` overloads below will cover most use cases. + +@overload +def compose( + __func1: Callable[[_R], _T], + __func2: Callable[_P, _R], + /, +) -> Callable[_P, _T]: ... +@overload +def compose( + __func1: Callable[[_R], _T], + __func2: Callable[[_R1], _R], + __func3: Callable[_P, _R1], + /, +) -> Callable[_P, _T]: ... +@overload +def compose( + __func1: Callable[[_R], _T], + __func2: Callable[[_R2], _R], + __func3: Callable[[_R1], _R2], + __func4: Callable[_P, _R1], + /, +) -> Callable[_P, _T]: ... +def once(func: Callable[_P, _R]) -> _OnceCallable[_P, _R]: ... +def method_cache( + method: Callable[..., _R], + cache_wrapper: Callable[[Callable[..., _R]], _MethodCacheWrapper[_R]] = ..., +) -> _MethodCacheWrapper[_R] | _ProxyMethodCacheWrapper[_R]: ... +def apply( + transform: Callable[[_R], _T] +) -> Callable[[Callable[_P, _R]], Callable[_P, _T]]: ... +def result_invoke( + action: Callable[[_R], Any] +) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ... +def invoke( + f: Callable[_P, _R], /, *args: _P.args, **kwargs: _P.kwargs +) -> Callable[_P, _R]: ... +def call_aside( + f: Callable[_P, _R], *args: _P.args, **kwargs: _P.kwargs +) -> Callable[_P, _R]: ... + +class Throttler(Generic[_R]): + last_called: float + func: Callable[..., _R] + max_rate: float + def __init__( + self, func: Callable[..., _R] | Throttler[_R], max_rate: float = ... + ) -> None: ... + def reset(self) -> None: ... + def __call__(self, *args: Any, **kwargs: Any) -> _R: ... + def __get__(self, obj: Any, owner: type[Any] | None = ...) -> Callable[..., _R]: ... + +def first_invoke( + func1: Callable[..., Any], func2: Callable[_P, _R] +) -> Callable[_P, _R]: ... + +method_caller: Callable[..., methodcaller] + +def retry_call( + func: Callable[..., _R], + cleanup: Callable[..., None] = ..., + retries: int | float = ..., + trap: type[BaseException] | tuple[type[BaseException], ...] = ..., +) -> _R: ... +def retry( + cleanup: Callable[..., None] = ..., + retries: int | float = ..., + trap: type[BaseException] | tuple[type[BaseException], ...] = ..., +) -> Callable[[Callable[..., _R]], Callable[..., _R]]: ... +def print_yielded(func: Callable[_P, Iterator[Any]]) -> Callable[_P, None]: ... +def pass_none( + func: Callable[Concatenate[_T, _P], _R] +) -> Callable[Concatenate[_T, _P], _R]: ... +def assign_params( + func: Callable[..., _R], namespace: dict[str, Any] +) -> partial[_R]: ... +def save_method_args( + method: Callable[Concatenate[_S, _P], _R] +) -> Callable[Concatenate[_S, _P], _R]: ... +def except_( + *exceptions: type[BaseException], replace: Any = ..., use: Any = ... +) -> Callable[[Callable[_P, Any]], Callable[_P, Any]]: ... +def identity(x: _T) -> _T: ... +def bypass_when( + check: _V, *, _op: Callable[[_V], Any] = ... +) -> Callable[[Callable[[_T], _R]], Callable[[_T], _T | _R]]: ... +def bypass_unless( + check: Any, +) -> Callable[[Callable[[_T], _R]], Callable[[_T], _T | _R]]: ... diff --git a/lib/jaraco/functools/py.typed b/lib/jaraco/functools/py.typed new file mode 100644 index 00000000..e69de29b diff --git a/lib/jaraco/text/__init__.py b/lib/jaraco/text/__init__.py index e51101c2..0fabd0c3 100644 --- a/lib/jaraco/text/__init__.py +++ b/lib/jaraco/text/__init__.py @@ -227,10 +227,12 @@ def unwrap(s): return '\n'.join(cleaned) -lorem_ipsum: str = files(__name__).joinpath('Lorem ipsum.txt').read_text() +lorem_ipsum: str = ( + files(__name__).joinpath('Lorem ipsum.txt').read_text(encoding='utf-8') +) -class Splitter(object): +class Splitter: """object that will split a string with the given arguments for each call >>> s = Splitter(',') @@ -367,7 +369,7 @@ class WordSet(tuple): return self.trim_left(item).trim_right(item) def __getitem__(self, item): - result = super(WordSet, self).__getitem__(item) + result = super().__getitem__(item) if isinstance(item, slice): result = WordSet(result) return result @@ -582,7 +584,7 @@ def join_continuation(lines): ['foobarbaz'] Not sure why, but... - The character preceeding the backslash is also elided. + The character preceding the backslash is also elided. >>> list(join_continuation(['goo\\', 'dly'])) ['godly'] @@ -607,16 +609,16 @@ def read_newlines(filename, limit=1024): r""" >>> tmp_path = getfixture('tmp_path') >>> filename = tmp_path / 'out.txt' - >>> _ = filename.write_text('foo\n', newline='') + >>> _ = filename.write_text('foo\n', newline='', encoding='utf-8') >>> read_newlines(filename) '\n' - >>> _ = filename.write_text('foo\r\n', newline='') + >>> _ = filename.write_text('foo\r\n', newline='', encoding='utf-8') >>> read_newlines(filename) '\r\n' - >>> _ = filename.write_text('foo\r\nbar\nbing\r', newline='') + >>> _ = filename.write_text('foo\r\nbar\nbing\r', newline='', encoding='utf-8') >>> read_newlines(filename) ('\r', '\n', '\r\n') """ - with open(filename) as fp: + with open(filename, encoding='utf-8') as fp: fp.read(limit) return fp.newlines diff --git a/lib/jaraco/text/show-newlines.py b/lib/jaraco/text/show-newlines.py index 2ba32062..e11d1ba4 100644 --- a/lib/jaraco/text/show-newlines.py +++ b/lib/jaraco/text/show-newlines.py @@ -12,11 +12,11 @@ def report_newlines(filename): >>> tmp_path = getfixture('tmp_path') >>> filename = tmp_path / 'out.txt' - >>> _ = filename.write_text('foo\nbar\n', newline='') + >>> _ = filename.write_text('foo\nbar\n', newline='', encoding='utf-8') >>> report_newlines(filename) newline is '\n' >>> filename = tmp_path / 'out.txt' - >>> _ = filename.write_text('foo\nbar\r\n', newline='') + >>> _ = filename.write_text('foo\nbar\r\n', newline='', encoding='utf-8') >>> report_newlines(filename) newlines are ('\n', '\r\n') """ diff --git a/lib/jaraco/text/strip-prefix.py b/lib/jaraco/text/strip-prefix.py new file mode 100644 index 00000000..761717a9 --- /dev/null +++ b/lib/jaraco/text/strip-prefix.py @@ -0,0 +1,21 @@ +import sys + +import autocommand + +from jaraco.text import Stripper + + +def strip_prefix(): + r""" + Strip any common prefix from stdin. + + >>> import io, pytest + >>> getfixture('monkeypatch').setattr('sys.stdin', io.StringIO('abcdef\nabc123')) + >>> strip_prefix() + def + 123 + """ + sys.stdout.writelines(Stripper.strip_prefix(sys.stdin).lines) + + +autocommand.autocommand(__name__)(strip_prefix) diff --git a/lib/more_itertools/__init__.py b/lib/more_itertools/__init__.py index 28ffadcf..aff94a9a 100644 --- a/lib/more_itertools/__init__.py +++ b/lib/more_itertools/__init__.py @@ -3,4 +3,4 @@ from .more import * # noqa from .recipes import * # noqa -__version__ = '10.1.0' +__version__ = '10.2.0' diff --git a/lib/more_itertools/more.py b/lib/more_itertools/more.py index 59c2f1a4..dd711a47 100755 --- a/lib/more_itertools/more.py +++ b/lib/more_itertools/more.py @@ -19,7 +19,7 @@ from itertools import ( zip_longest, product, ) -from math import exp, factorial, floor, log +from math import exp, factorial, floor, log, perm, comb from queue import Empty, Queue from random import random, randrange, uniform from operator import itemgetter, mul, sub, gt, lt, ge, le @@ -68,8 +68,10 @@ __all__ = [ 'divide', 'duplicates_everseen', 'duplicates_justseen', + 'classify_unique', 'exactly_n', 'filter_except', + 'filter_map', 'first', 'gray_product', 'groupby_transform', @@ -83,6 +85,7 @@ __all__ = [ 'is_sorted', 'islice_extended', 'iterate', + 'iter_suppress', 'last', 'locate', 'longest_common_prefix', @@ -198,15 +201,14 @@ def first(iterable, default=_marker): ``next(iter(iterable), default)``. """ - try: - return next(iter(iterable)) - except StopIteration as e: - if default is _marker: - raise ValueError( - 'first() was called on an empty iterable, and no ' - 'default value was provided.' - ) from e - return default + for item in iterable: + return item + if default is _marker: + raise ValueError( + 'first() was called on an empty iterable, and no ' + 'default value was provided.' + ) + return default def last(iterable, default=_marker): @@ -582,6 +584,9 @@ def strictly_n(iterable, n, too_short=None, too_long=None): >>> list(strictly_n(iterable, n)) ['a', 'b', 'c', 'd'] + Note that the returned iterable must be consumed in order for the check to + be made. + By default, *too_short* and *too_long* are functions that raise ``ValueError``. @@ -919,7 +924,7 @@ def substrings_indexes(seq, reverse=False): class bucket: - """Wrap *iterable* and return an object that buckets it iterable into + """Wrap *iterable* and return an object that buckets the iterable into child iterables based on a *key* function. >>> iterable = ['a1', 'b1', 'c1', 'a2', 'b2', 'c2', 'b3'] @@ -3222,6 +3227,8 @@ class time_limited: stops if the time elapsed is greater than *limit_seconds*. If your time limit is 1 second, but it takes 2 seconds to generate the first item from the iterable, the function will run for 2 seconds and not yield anything. + As a special case, when *limit_seconds* is zero, the iterator never + returns anything. """ @@ -3237,6 +3244,9 @@ class time_limited: return self def __next__(self): + if self.limit_seconds == 0: + self.timed_out = True + raise StopIteration item = next(self._iterable) if monotonic() - self._start_time > self.limit_seconds: self.timed_out = True @@ -3356,7 +3366,7 @@ def iequals(*iterables): >>> iequals("abc", "acb") False - Not to be confused with :func:`all_equals`, which checks whether all + Not to be confused with :func:`all_equal`, which checks whether all elements of iterable are equal to each other. """ @@ -3853,7 +3863,7 @@ def nth_permutation(iterable, r, index): elif not 0 <= r < n: raise ValueError else: - c = factorial(n) // factorial(n - r) + c = perm(n, r) if index < 0: index += c @@ -3898,7 +3908,7 @@ def nth_combination_with_replacement(iterable, r, index): if (r < 0) or (r > n): raise ValueError - c = factorial(n + r - 1) // (factorial(r) * factorial(n - 1)) + c = comb(n + r - 1, r) if index < 0: index += c @@ -3911,9 +3921,7 @@ def nth_combination_with_replacement(iterable, r, index): while r: r -= 1 while n >= 0: - num_combs = factorial(n + r - 1) // ( - factorial(r) * factorial(n - 1) - ) + num_combs = comb(n + r - 1, r) if index < num_combs: break n -= 1 @@ -4015,9 +4023,9 @@ def combination_index(element, iterable): for i, j in enumerate(reversed(indexes), start=1): j = n - j if i <= j: - index += factorial(j) // (factorial(i) * factorial(j - i)) + index += comb(j, i) - return factorial(n + 1) // (factorial(k + 1) * factorial(n - k)) - index + return comb(n + 1, k + 1) - index def combination_with_replacement_index(element, iterable): @@ -4057,7 +4065,7 @@ def combination_with_replacement_index(element, iterable): break else: raise ValueError( - 'element is not a combination with replacment of iterable' + 'element is not a combination with replacement of iterable' ) n = len(pool) @@ -4066,11 +4074,13 @@ def combination_with_replacement_index(element, iterable): occupations[p] += 1 index = 0 + cumulative_sum = 0 for k in range(1, n): - j = l + n - 1 - k - sum(occupations[:k]) + cumulative_sum += occupations[k - 1] + j = l + n - 1 - k - cumulative_sum i = n - k if i <= j: - index += factorial(j) // (factorial(i) * factorial(j - i)) + index += comb(j, i) return index @@ -4296,7 +4306,7 @@ def duplicates_everseen(iterable, key=None): >>> list(duplicates_everseen('AaaBbbCccAaa', str.lower)) ['a', 'a', 'b', 'b', 'c', 'c', 'A', 'a', 'a'] - This function is analagous to :func:`unique_everseen` and is subject to + This function is analogous to :func:`unique_everseen` and is subject to the same performance considerations. """ @@ -4326,12 +4336,54 @@ def duplicates_justseen(iterable, key=None): >>> list(duplicates_justseen('AaaBbbCccAaa', str.lower)) ['a', 'a', 'b', 'b', 'c', 'c', 'a', 'a'] - This function is analagous to :func:`unique_justseen`. + This function is analogous to :func:`unique_justseen`. """ return flatten(g for _, g in groupby(iterable, key) for _ in g) +def classify_unique(iterable, key=None): + """Classify each element in terms of its uniqueness. + + For each element in the input iterable, return a 3-tuple consisting of: + + 1. The element itself + 2. ``False`` if the element is equal to the one preceding it in the input, + ``True`` otherwise (i.e. the equivalent of :func:`unique_justseen`) + 3. ``False`` if this element has been seen anywhere in the input before, + ``True`` otherwise (i.e. the equivalent of :func:`unique_everseen`) + + >>> list(classify_unique('otto')) # doctest: +NORMALIZE_WHITESPACE + [('o', True, True), + ('t', True, True), + ('t', False, False), + ('o', True, False)] + + This function is analogous to :func:`unique_everseen` and is subject to + the same performance considerations. + + """ + seen_set = set() + seen_list = [] + use_key = key is not None + previous = None + + for i, element in enumerate(iterable): + k = key(element) if use_key else element + is_unique_justseen = not i or previous != k + previous = k + is_unique_everseen = False + try: + if k not in seen_set: + seen_set.add(k) + is_unique_everseen = True + except TypeError: + if k not in seen_list: + seen_list.append(k) + is_unique_everseen = True + yield element, is_unique_justseen, is_unique_everseen + + def minmax(iterable_or_value, *others, key=None, default=_marker): """Returns both the smallest and largest items in an iterable or the largest of two or more arguments. @@ -4529,10 +4581,8 @@ def takewhile_inclusive(predicate, iterable): :func:`takewhile` would return ``[1, 4]``. """ for x in iterable: - if predicate(x): - yield x - else: - yield x + yield x + if not predicate(x): break @@ -4567,3 +4617,40 @@ def outer_product(func, xs, ys, *args, **kwargs): starmap(lambda x, y: func(x, y, *args, **kwargs), product(xs, ys)), n=len(ys), ) + + +def iter_suppress(iterable, *exceptions): + """Yield each of the items from *iterable*. If the iteration raises one of + the specified *exceptions*, that exception will be suppressed and iteration + will stop. + + >>> from itertools import chain + >>> def breaks_at_five(x): + ... while True: + ... if x >= 5: + ... raise RuntimeError + ... yield x + ... x += 1 + >>> it_1 = iter_suppress(breaks_at_five(1), RuntimeError) + >>> it_2 = iter_suppress(breaks_at_five(2), RuntimeError) + >>> list(chain(it_1, it_2)) + [1, 2, 3, 4, 2, 3, 4] + """ + try: + yield from iterable + except exceptions: + return + + +def filter_map(func, iterable): + """Apply *func* to every element of *iterable*, yielding only those which + are not ``None``. + + >>> elems = ['1', 'a', '2', 'b', '3'] + >>> list(filter_map(lambda s: int(s) if s.isnumeric() else None, elems)) + [1, 2, 3] + """ + for x in iterable: + y = func(x) + if y is not None: + yield y diff --git a/lib/more_itertools/more.pyi b/lib/more_itertools/more.pyi index 07bfc155..9a5fc911 100644 --- a/lib/more_itertools/more.pyi +++ b/lib/more_itertools/more.pyi @@ -29,7 +29,7 @@ _U = TypeVar('_U') _V = TypeVar('_V') _W = TypeVar('_W') _T_co = TypeVar('_T_co', covariant=True) -_GenFn = TypeVar('_GenFn', bound=Callable[..., Iterator[object]]) +_GenFn = TypeVar('_GenFn', bound=Callable[..., Iterator[Any]]) _Raisable = BaseException | Type[BaseException] @type_check_only @@ -74,7 +74,7 @@ class peekable(Generic[_T], Iterator[_T]): def __getitem__(self, index: slice) -> list[_T]: ... def consumer(func: _GenFn) -> _GenFn: ... -def ilen(iterable: Iterable[object]) -> int: ... +def ilen(iterable: Iterable[_T]) -> int: ... def iterate(func: Callable[[_T], _T], start: _T) -> Iterator[_T]: ... def with_iter( context_manager: ContextManager[Iterable[_T]], @@ -116,7 +116,7 @@ class bucket(Generic[_T, _U], Container[_U]): self, iterable: Iterable[_T], key: Callable[[_T], _U], - validator: Callable[[object], object] | None = ..., + validator: Callable[[_U], object] | None = ..., ) -> None: ... def __contains__(self, value: object) -> bool: ... def __iter__(self) -> Iterator[_U]: ... @@ -383,7 +383,7 @@ def mark_ends( iterable: Iterable[_T], ) -> Iterable[tuple[bool, bool, _T]]: ... def locate( - iterable: Iterable[object], + iterable: Iterable[_T], pred: Callable[..., Any] = ..., window_size: int | None = ..., ) -> Iterator[int]: ... @@ -618,6 +618,9 @@ def duplicates_everseen( def duplicates_justseen( iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... ) -> Iterator[_T]: ... +def classify_unique( + iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... +) -> Iterator[tuple[_T, bool, bool]]: ... class _SupportsLessThan(Protocol): def __lt__(self, __other: Any) -> bool: ... @@ -662,9 +665,9 @@ def minmax( def longest_common_prefix( iterables: Iterable[Iterable[_T]], ) -> Iterator[_T]: ... -def iequals(*iterables: Iterable[object]) -> bool: ... +def iequals(*iterables: Iterable[Any]) -> bool: ... def constrained_batches( - iterable: Iterable[object], + iterable: Iterable[_T], max_size: int, max_count: int | None = ..., get_len: Callable[[_T], object] = ..., @@ -682,3 +685,11 @@ def outer_product( *args: Any, **kwargs: Any, ) -> Iterator[tuple[_V, ...]]: ... +def iter_suppress( + iterable: Iterable[_T], + *exceptions: Type[BaseException], +) -> Iterator[_T]: ... +def filter_map( + func: Callable[[_T], _V | None], + iterable: Iterable[_T], +) -> Iterator[_V]: ... diff --git a/lib/more_itertools/recipes.py b/lib/more_itertools/recipes.py index a0bdbece..145e3cb5 100644 --- a/lib/more_itertools/recipes.py +++ b/lib/more_itertools/recipes.py @@ -28,6 +28,7 @@ from itertools import ( zip_longest, ) from random import randrange, sample, choice +from sys import hexversion __all__ = [ 'all_equal', @@ -56,6 +57,7 @@ __all__ = [ 'powerset', 'prepend', 'quantify', + 'reshape', 'random_combination_with_replacement', 'random_combination', 'random_permutation', @@ -69,6 +71,7 @@ __all__ = [ 'tabulate', 'tail', 'take', + 'totient', 'transpose', 'triplewise', 'unique_everseen', @@ -492,7 +495,7 @@ def unique_everseen(iterable, key=None): >>> list(unique_everseen(iterable, key=tuple)) # Faster [[1, 2], [2, 3]] - Similary, you may want to convert unhashable ``set`` objects with + Similarly, you may want to convert unhashable ``set`` objects with ``key=frozenset``. For ``dict`` objects, ``key=lambda x: frozenset(x.items())`` can be used. @@ -524,6 +527,9 @@ def unique_justseen(iterable, key=None): ['A', 'B', 'C', 'A', 'D'] """ + if key is None: + return map(operator.itemgetter(0), groupby(iterable)) + return map(next, map(operator.itemgetter(1), groupby(iterable, key))) @@ -817,35 +823,34 @@ def polynomial_from_roots(roots): return list(reduce(convolve, factors, [1])) -def iter_index(iterable, value, start=0): +def iter_index(iterable, value, start=0, stop=None): """Yield the index of each place in *iterable* that *value* occurs, - beginning with index *start*. + beginning with index *start* and ending before index *stop*. See :func:`locate` for a more general means of finding the indexes associated with particular values. >>> list(iter_index('AABCADEAF', 'A')) [0, 1, 4, 7] + >>> list(iter_index('AABCADEAF', 'A', 1)) # start index is inclusive + [1, 4, 7] + >>> list(iter_index('AABCADEAF', 'A', 1, 7)) # stop index is not inclusive + [1, 4] """ - try: - seq_index = iterable.index - except AttributeError: + seq_index = getattr(iterable, 'index', None) + if seq_index is None: # Slow path for general iterables - it = islice(iterable, start, None) - i = start - 1 - try: - while True: - i = i + operator.indexOf(it, value) + 1 + it = islice(iterable, start, stop) + for i, element in enumerate(it, start): + if element is value or element == value: yield i - except ValueError: - pass else: # Fast path for sequences + stop = len(iterable) if stop is None else stop i = start - 1 try: while True: - i = seq_index(value, i + 1) - yield i + yield (i := seq_index(value, i + 1, stop)) except ValueError: pass @@ -856,47 +861,52 @@ def sieve(n): >>> list(sieve(30)) [2, 3, 5, 7, 11, 13, 17, 19, 23, 29] """ + if n > 2: + yield 2 + start = 3 data = bytearray((0, 1)) * (n // 2) - data[:3] = 0, 0, 0 limit = math.isqrt(n) + 1 - for p in compress(range(limit), data): + for p in iter_index(data, 1, start, limit): + yield from iter_index(data, 1, start, p * p) data[p * p : n : p + p] = bytes(len(range(p * p, n, p + p))) - data[2] = 1 - return iter_index(data, 1) if n > 2 else iter([]) + start = p * p + yield from iter_index(data, 1, start) -def _batched(iterable, n): - """Batch data into lists of length *n*. The last batch may be shorter. +def _batched(iterable, n, *, strict=False): + """Batch data into tuples of length *n*. If the number of items in + *iterable* is not divisible by *n*: + * The last batch will be shorter if *strict* is ``False``. + * :exc:`ValueError` will be raised if *strict* is ``True``. >>> list(batched('ABCDEFG', 3)) [('A', 'B', 'C'), ('D', 'E', 'F'), ('G',)] - On Python 3.12 and above, this is an alias for :func:`itertools.batched`. + On Python 3.13 and above, this is an alias for :func:`itertools.batched`. """ if n < 1: raise ValueError('n must be at least one') it = iter(iterable) - while True: - batch = tuple(islice(it, n)) - if not batch: - break + while batch := tuple(islice(it, n)): + if strict and len(batch) != n: + raise ValueError('batched(): incomplete batch') yield batch -try: +if hexversion >= 0x30D00A2: from itertools import batched as itertools_batched -except ImportError: - batched = _batched -else: - def batched(iterable, n): - return itertools_batched(iterable, n) + def batched(iterable, n, *, strict=False): + return itertools_batched(iterable, n, strict=strict) + +else: + batched = _batched batched.__doc__ = _batched.__doc__ def transpose(it): - """Swap the rows and columns of the input. + """Swap the rows and columns of the input matrix. >>> list(transpose([(1, 2, 3), (11, 22, 33)])) [(1, 11), (2, 22), (3, 33)] @@ -907,8 +917,20 @@ def transpose(it): return _zip_strict(*it) +def reshape(matrix, cols): + """Reshape the 2-D input *matrix* to have a column count given by *cols*. + + >>> matrix = [(0, 1), (2, 3), (4, 5)] + >>> cols = 3 + >>> list(reshape(matrix, cols)) + [(0, 1, 2), (3, 4, 5)] + """ + return batched(chain.from_iterable(matrix), cols) + + def matmul(m1, m2): """Multiply two matrices. + >>> list(matmul([(7, 5), (3, 5)], [(2, 5), (7, 9)])) [(49, 80), (41, 60)] @@ -921,13 +943,12 @@ def matmul(m1, m2): def factor(n): """Yield the prime factors of n. + >>> list(factor(360)) [2, 2, 2, 3, 3, 5] """ for prime in sieve(math.isqrt(n) + 1): - while True: - if n % prime: - break + while not n % prime: yield prime n //= prime if n == 1: @@ -975,3 +996,17 @@ def polynomial_derivative(coefficients): n = len(coefficients) powers = reversed(range(1, n)) return list(map(operator.mul, coefficients, powers)) + + +def totient(n): + """Return the count of natural numbers up to *n* that are coprime with *n*. + + >>> totient(9) + 6 + >>> totient(12) + 4 + """ + for p in unique_justseen(factor(n)): + n = n // p * (p - 1) + + return n diff --git a/lib/more_itertools/recipes.pyi b/lib/more_itertools/recipes.pyi index ef883864..ed4c19db 100644 --- a/lib/more_itertools/recipes.pyi +++ b/lib/more_itertools/recipes.pyi @@ -14,6 +14,8 @@ from typing import ( # Type and type variable definitions _T = TypeVar('_T') +_T1 = TypeVar('_T1') +_T2 = TypeVar('_T2') _U = TypeVar('_U') def take(n: int, iterable: Iterable[_T]) -> list[_T]: ... @@ -26,14 +28,14 @@ def consume(iterator: Iterable[_T], n: int | None = ...) -> None: ... def nth(iterable: Iterable[_T], n: int) -> _T | None: ... @overload def nth(iterable: Iterable[_T], n: int, default: _U) -> _T | _U: ... -def all_equal(iterable: Iterable[object]) -> bool: ... +def all_equal(iterable: Iterable[_T]) -> bool: ... def quantify( iterable: Iterable[_T], pred: Callable[[_T], bool] = ... ) -> int: ... def pad_none(iterable: Iterable[_T]) -> Iterator[_T | None]: ... def padnone(iterable: Iterable[_T]) -> Iterator[_T | None]: ... def ncycles(iterable: Iterable[_T], n: int) -> Iterator[_T]: ... -def dotproduct(vec1: Iterable[object], vec2: Iterable[object]) -> object: ... +def dotproduct(vec1: Iterable[_T1], vec2: Iterable[_T2]) -> Any: ... def flatten(listOfLists: Iterable[Iterable[_T]]) -> Iterator[_T]: ... def repeatfunc( func: Callable[..., _U], times: int | None = ..., *args: Any @@ -103,20 +105,24 @@ def sliding_window( def subslices(iterable: Iterable[_T]) -> Iterator[list[_T]]: ... def polynomial_from_roots(roots: Sequence[_T]) -> list[_T]: ... def iter_index( - iterable: Iterable[object], + iterable: Iterable[_T], value: Any, start: int | None = ..., + stop: int | None = ..., ) -> Iterator[int]: ... def sieve(n: int) -> Iterator[int]: ... def batched( - iterable: Iterable[_T], - n: int, + iterable: Iterable[_T], n: int, *, strict: bool = False ) -> Iterator[tuple[_T]]: ... def transpose( it: Iterable[Iterable[_T]], ) -> Iterator[tuple[_T, ...]]: ... +def reshape( + matrix: Iterable[Iterable[_T]], cols: int +) -> Iterator[tuple[_T, ...]]: ... def matmul(m1: Sequence[_T], m2: Sequence[_T]) -> Iterator[tuple[_T]]: ... def factor(n: int) -> Iterator[int]: ... def polynomial_eval(coefficients: Sequence[_T], x: _U) -> _U: ... def sum_of_squares(it: Iterable[_T]) -> _T: ... def polynomial_derivative(coefficients: Sequence[_T]) -> list[_T]: ... +def totient(n: int) -> int: ... diff --git a/lib/pydantic/__init__.py b/lib/pydantic/__init__.py index 3bf1418f..85a8c18b 100644 --- a/lib/pydantic/__init__.py +++ b/lib/pydantic/__init__.py @@ -1,56 +1,114 @@ -# flake8: noqa -from . import dataclasses -from .annotated_types import create_model_from_namedtuple, create_model_from_typeddict -from .class_validators import root_validator, validator -from .config import BaseConfig, ConfigDict, Extra -from .decorator import validate_arguments -from .env_settings import BaseSettings -from .error_wrappers import ValidationError -from .errors import * -from .fields import Field, PrivateAttr, Required -from .main import * -from .networks import * -from .parse import Protocol -from .tools import * -from .types import * -from .version import VERSION, compiled +import typing + +from ._migration import getattr_migration +from .version import VERSION + +if typing.TYPE_CHECKING: + # import of virtually everything is supported via `__getattr__` below, + # but we need them here for type checking and IDE support + import pydantic_core + from pydantic_core.core_schema import ( + FieldSerializationInfo, + SerializationInfo, + SerializerFunctionWrapHandler, + ValidationInfo, + ValidatorFunctionWrapHandler, + ) + + from . import dataclasses + from ._internal._generate_schema import GenerateSchema as GenerateSchema + from .aliases import AliasChoices, AliasGenerator, AliasPath + from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler + from .config import ConfigDict + from .errors import * + from .fields import Field, PrivateAttr, computed_field + from .functional_serializers import ( + PlainSerializer, + SerializeAsAny, + WrapSerializer, + field_serializer, + model_serializer, + ) + from .functional_validators import ( + AfterValidator, + BeforeValidator, + InstanceOf, + PlainValidator, + SkipValidation, + WrapValidator, + field_validator, + model_validator, + ) + from .json_schema import WithJsonSchema + from .main import * + from .networks import * + from .type_adapter import TypeAdapter + from .types import * + from .validate_call_decorator import validate_call + from .warnings import PydanticDeprecatedSince20, PydanticDeprecatedSince26, PydanticDeprecationWarning + + # this encourages pycharm to import `ValidationError` from here, not pydantic_core + ValidationError = pydantic_core.ValidationError + from .deprecated.class_validators import root_validator, validator + from .deprecated.config import BaseConfig, Extra + from .deprecated.tools import * + from .root_model import RootModel __version__ = VERSION - -# WARNING __all__ from .errors is not included here, it will be removed as an export here in v2 -# please use "from pydantic.errors import ..." instead -__all__ = [ - # annotated types utils - 'create_model_from_namedtuple', - 'create_model_from_typeddict', +__all__ = ( # dataclasses 'dataclasses', - # class_validators + # functional validators + 'field_validator', + 'model_validator', + 'AfterValidator', + 'BeforeValidator', + 'PlainValidator', + 'WrapValidator', + 'SkipValidation', + 'InstanceOf', + # JSON Schema + 'WithJsonSchema', + # deprecated V1 functional validators, these are imported via `__getattr__` below 'root_validator', 'validator', + # functional serializers + 'field_serializer', + 'model_serializer', + 'PlainSerializer', + 'SerializeAsAny', + 'WrapSerializer', # config - 'BaseConfig', 'ConfigDict', + # deprecated V1 config, these are imported via `__getattr__` below + 'BaseConfig', 'Extra', - # decorator - 'validate_arguments', - # env_settings - 'BaseSettings', - # error_wrappers - 'ValidationError', + # validate_call + 'validate_call', + # errors + 'PydanticErrorCodes', + 'PydanticUserError', + 'PydanticSchemaGenerationError', + 'PydanticImportError', + 'PydanticUndefinedAnnotation', + 'PydanticInvalidForJsonSchema', # fields 'Field', - 'Required', + 'computed_field', + 'PrivateAttr', + # alias + 'AliasChoices', + 'AliasGenerator', + 'AliasPath', # main 'BaseModel', 'create_model', - 'validate_model', # network 'AnyUrl', 'AnyHttpUrl', 'FileUrl', 'HttpUrl', - 'stricturl', + 'UrlConstraints', 'EmailStr', 'NameEmail', 'IPvAnyAddress', @@ -62,48 +120,38 @@ __all__ = [ 'RedisDsn', 'MongoDsn', 'KafkaDsn', + 'NatsDsn', + 'MySQLDsn', + 'MariaDBDsn', 'validate_email', - # parse - 'Protocol', - # tools - 'parse_file_as', + # root_model + 'RootModel', + # deprecated tools, these are imported via `__getattr__` below 'parse_obj_as', - 'parse_raw_as', 'schema_of', 'schema_json_of', # types - 'NoneStr', - 'NoneBytes', - 'StrBytes', - 'NoneStrBytes', + 'Strict', 'StrictStr', - 'ConstrainedBytes', 'conbytes', - 'ConstrainedList', 'conlist', - 'ConstrainedSet', 'conset', - 'ConstrainedFrozenSet', 'confrozenset', - 'ConstrainedStr', 'constr', - 'PyObject', - 'ConstrainedInt', + 'StringConstraints', + 'ImportString', 'conint', 'PositiveInt', 'NegativeInt', 'NonNegativeInt', 'NonPositiveInt', - 'ConstrainedFloat', 'confloat', 'PositiveFloat', 'NegativeFloat', 'NonNegativeFloat', 'NonPositiveFloat', 'FiniteFloat', - 'ConstrainedDecimal', 'condecimal', - 'ConstrainedDate', 'condate', 'UUID1', 'UUID3', @@ -111,9 +159,8 @@ __all__ = [ 'UUID5', 'FilePath', 'DirectoryPath', + 'NewPath', 'Json', - 'JsonWrapper', - 'SecretField', 'SecretStr', 'SecretBytes', 'StrictBool', @@ -121,11 +168,221 @@ __all__ = [ 'StrictInt', 'StrictFloat', 'PaymentCardNumber', - 'PrivateAttr', 'ByteSize', 'PastDate', 'FutureDate', + 'PastDatetime', + 'FutureDatetime', + 'AwareDatetime', + 'NaiveDatetime', + 'AllowInfNan', + 'EncoderProtocol', + 'EncodedBytes', + 'EncodedStr', + 'Base64Encoder', + 'Base64Bytes', + 'Base64Str', + 'Base64UrlBytes', + 'Base64UrlStr', + 'GetPydanticSchema', + 'Tag', + 'Discriminator', + 'JsonValue', + # type_adapter + 'TypeAdapter', # version - 'compiled', + '__version__', 'VERSION', -] + # warnings + 'PydanticDeprecatedSince20', + 'PydanticDeprecatedSince26', + 'PydanticDeprecationWarning', + # annotated handlers + 'GetCoreSchemaHandler', + 'GetJsonSchemaHandler', + # generate schema from ._internal + 'GenerateSchema', + # pydantic_core + 'ValidationError', + 'ValidationInfo', + 'SerializationInfo', + 'ValidatorFunctionWrapHandler', + 'FieldSerializationInfo', + 'SerializerFunctionWrapHandler', + 'OnErrorOmit', +) + +# A mapping of {: (package, )} defining dynamic imports +_dynamic_imports: 'dict[str, tuple[str, str]]' = { + 'dataclasses': (__package__, '__module__'), + # functional validators + 'field_validator': (__package__, '.functional_validators'), + 'model_validator': (__package__, '.functional_validators'), + 'AfterValidator': (__package__, '.functional_validators'), + 'BeforeValidator': (__package__, '.functional_validators'), + 'PlainValidator': (__package__, '.functional_validators'), + 'WrapValidator': (__package__, '.functional_validators'), + 'SkipValidation': (__package__, '.functional_validators'), + 'InstanceOf': (__package__, '.functional_validators'), + # JSON Schema + 'WithJsonSchema': (__package__, '.json_schema'), + # functional serializers + 'field_serializer': (__package__, '.functional_serializers'), + 'model_serializer': (__package__, '.functional_serializers'), + 'PlainSerializer': (__package__, '.functional_serializers'), + 'SerializeAsAny': (__package__, '.functional_serializers'), + 'WrapSerializer': (__package__, '.functional_serializers'), + # config + 'ConfigDict': (__package__, '.config'), + # validate call + 'validate_call': (__package__, '.validate_call_decorator'), + # errors + 'PydanticErrorCodes': (__package__, '.errors'), + 'PydanticUserError': (__package__, '.errors'), + 'PydanticSchemaGenerationError': (__package__, '.errors'), + 'PydanticImportError': (__package__, '.errors'), + 'PydanticUndefinedAnnotation': (__package__, '.errors'), + 'PydanticInvalidForJsonSchema': (__package__, '.errors'), + # fields + 'Field': (__package__, '.fields'), + 'computed_field': (__package__, '.fields'), + 'PrivateAttr': (__package__, '.fields'), + # alias + 'AliasChoices': (__package__, '.aliases'), + 'AliasGenerator': (__package__, '.aliases'), + 'AliasPath': (__package__, '.aliases'), + # main + 'BaseModel': (__package__, '.main'), + 'create_model': (__package__, '.main'), + # network + 'AnyUrl': (__package__, '.networks'), + 'AnyHttpUrl': (__package__, '.networks'), + 'FileUrl': (__package__, '.networks'), + 'HttpUrl': (__package__, '.networks'), + 'UrlConstraints': (__package__, '.networks'), + 'EmailStr': (__package__, '.networks'), + 'NameEmail': (__package__, '.networks'), + 'IPvAnyAddress': (__package__, '.networks'), + 'IPvAnyInterface': (__package__, '.networks'), + 'IPvAnyNetwork': (__package__, '.networks'), + 'PostgresDsn': (__package__, '.networks'), + 'CockroachDsn': (__package__, '.networks'), + 'AmqpDsn': (__package__, '.networks'), + 'RedisDsn': (__package__, '.networks'), + 'MongoDsn': (__package__, '.networks'), + 'KafkaDsn': (__package__, '.networks'), + 'NatsDsn': (__package__, '.networks'), + 'MySQLDsn': (__package__, '.networks'), + 'MariaDBDsn': (__package__, '.networks'), + 'validate_email': (__package__, '.networks'), + # root_model + 'RootModel': (__package__, '.root_model'), + # types + 'Strict': (__package__, '.types'), + 'StrictStr': (__package__, '.types'), + 'conbytes': (__package__, '.types'), + 'conlist': (__package__, '.types'), + 'conset': (__package__, '.types'), + 'confrozenset': (__package__, '.types'), + 'constr': (__package__, '.types'), + 'StringConstraints': (__package__, '.types'), + 'ImportString': (__package__, '.types'), + 'conint': (__package__, '.types'), + 'PositiveInt': (__package__, '.types'), + 'NegativeInt': (__package__, '.types'), + 'NonNegativeInt': (__package__, '.types'), + 'NonPositiveInt': (__package__, '.types'), + 'confloat': (__package__, '.types'), + 'PositiveFloat': (__package__, '.types'), + 'NegativeFloat': (__package__, '.types'), + 'NonNegativeFloat': (__package__, '.types'), + 'NonPositiveFloat': (__package__, '.types'), + 'FiniteFloat': (__package__, '.types'), + 'condecimal': (__package__, '.types'), + 'condate': (__package__, '.types'), + 'UUID1': (__package__, '.types'), + 'UUID3': (__package__, '.types'), + 'UUID4': (__package__, '.types'), + 'UUID5': (__package__, '.types'), + 'FilePath': (__package__, '.types'), + 'DirectoryPath': (__package__, '.types'), + 'NewPath': (__package__, '.types'), + 'Json': (__package__, '.types'), + 'SecretStr': (__package__, '.types'), + 'SecretBytes': (__package__, '.types'), + 'StrictBool': (__package__, '.types'), + 'StrictBytes': (__package__, '.types'), + 'StrictInt': (__package__, '.types'), + 'StrictFloat': (__package__, '.types'), + 'PaymentCardNumber': (__package__, '.types'), + 'ByteSize': (__package__, '.types'), + 'PastDate': (__package__, '.types'), + 'FutureDate': (__package__, '.types'), + 'PastDatetime': (__package__, '.types'), + 'FutureDatetime': (__package__, '.types'), + 'AwareDatetime': (__package__, '.types'), + 'NaiveDatetime': (__package__, '.types'), + 'AllowInfNan': (__package__, '.types'), + 'EncoderProtocol': (__package__, '.types'), + 'EncodedBytes': (__package__, '.types'), + 'EncodedStr': (__package__, '.types'), + 'Base64Encoder': (__package__, '.types'), + 'Base64Bytes': (__package__, '.types'), + 'Base64Str': (__package__, '.types'), + 'Base64UrlBytes': (__package__, '.types'), + 'Base64UrlStr': (__package__, '.types'), + 'GetPydanticSchema': (__package__, '.types'), + 'Tag': (__package__, '.types'), + 'Discriminator': (__package__, '.types'), + 'JsonValue': (__package__, '.types'), + 'OnErrorOmit': (__package__, '.types'), + # type_adapter + 'TypeAdapter': (__package__, '.type_adapter'), + # warnings + 'PydanticDeprecatedSince20': (__package__, '.warnings'), + 'PydanticDeprecatedSince26': (__package__, '.warnings'), + 'PydanticDeprecationWarning': (__package__, '.warnings'), + # annotated handlers + 'GetCoreSchemaHandler': (__package__, '.annotated_handlers'), + 'GetJsonSchemaHandler': (__package__, '.annotated_handlers'), + # generate schema from ._internal + 'GenerateSchema': (__package__, '._internal._generate_schema'), + # pydantic_core stuff + 'ValidationError': ('pydantic_core', '.'), + 'ValidationInfo': ('pydantic_core', '.core_schema'), + 'SerializationInfo': ('pydantic_core', '.core_schema'), + 'ValidatorFunctionWrapHandler': ('pydantic_core', '.core_schema'), + 'FieldSerializationInfo': ('pydantic_core', '.core_schema'), + 'SerializerFunctionWrapHandler': ('pydantic_core', '.core_schema'), + # deprecated, mostly not included in __all__ + 'root_validator': (__package__, '.deprecated.class_validators'), + 'validator': (__package__, '.deprecated.class_validators'), + 'BaseConfig': (__package__, '.deprecated.config'), + 'Extra': (__package__, '.deprecated.config'), + 'parse_obj_as': (__package__, '.deprecated.tools'), + 'schema_of': (__package__, '.deprecated.tools'), + 'schema_json_of': (__package__, '.deprecated.tools'), + 'FieldValidationInfo': ('pydantic_core', '.core_schema'), +} + +_getattr_migration = getattr_migration(__name__) + + +def __getattr__(attr_name: str) -> object: + dynamic_attr = _dynamic_imports.get(attr_name) + if dynamic_attr is None: + return _getattr_migration(attr_name) + + package, module_name = dynamic_attr + + from importlib import import_module + + if module_name == '__module__': + return import_module(f'.{attr_name}', package=package) + else: + module = import_module(module_name, package=package) + return getattr(module, attr_name) + + +def __dir__() -> 'list[str]': + return list(__all__) diff --git a/lib/pydantic/_internal/__init__.py b/lib/pydantic/_internal/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/pydantic/_internal/_config.py b/lib/pydantic/_internal/_config.py new file mode 100644 index 00000000..52c4cc42 --- /dev/null +++ b/lib/pydantic/_internal/_config.py @@ -0,0 +1,322 @@ +from __future__ import annotations as _annotations + +import warnings +from contextlib import contextmanager +from typing import ( + TYPE_CHECKING, + Any, + Callable, + cast, +) + +from pydantic_core import core_schema +from typing_extensions import ( + Literal, + Self, +) + +from ..aliases import AliasGenerator +from ..config import ConfigDict, ExtraValues, JsonDict, JsonEncoder, JsonSchemaExtraCallable +from ..errors import PydanticUserError +from ..warnings import PydanticDeprecatedSince20 + +if not TYPE_CHECKING: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + +if TYPE_CHECKING: + from .._internal._schema_generation_shared import GenerateSchema + +DEPRECATION_MESSAGE = 'Support for class-based `config` is deprecated, use ConfigDict instead.' + + +class ConfigWrapper: + """Internal wrapper for Config which exposes ConfigDict items as attributes.""" + + __slots__ = ('config_dict',) + + config_dict: ConfigDict + + # all annotations are copied directly from ConfigDict, and should be kept up to date, a test will fail if they + # stop matching + title: str | None + str_to_lower: bool + str_to_upper: bool + str_strip_whitespace: bool + str_min_length: int + str_max_length: int | None + extra: ExtraValues | None + frozen: bool + populate_by_name: bool + use_enum_values: bool + validate_assignment: bool + arbitrary_types_allowed: bool + from_attributes: bool + # whether to use the actual key provided in the data (e.g. alias or first alias for "field required" errors) instead of field_names + # to construct error `loc`s, default `True` + loc_by_alias: bool + alias_generator: Callable[[str], str] | AliasGenerator | None + ignored_types: tuple[type, ...] + allow_inf_nan: bool + json_schema_extra: JsonDict | JsonSchemaExtraCallable | None + json_encoders: dict[type[object], JsonEncoder] | None + + # new in V2 + strict: bool + # whether instances of models and dataclasses (including subclass instances) should re-validate, default 'never' + revalidate_instances: Literal['always', 'never', 'subclass-instances'] + ser_json_timedelta: Literal['iso8601', 'float'] + ser_json_bytes: Literal['utf8', 'base64'] + ser_json_inf_nan: Literal['null', 'constants'] + # whether to validate default values during validation, default False + validate_default: bool + validate_return: bool + protected_namespaces: tuple[str, ...] + hide_input_in_errors: bool + defer_build: bool + plugin_settings: dict[str, object] | None + schema_generator: type[GenerateSchema] | None + json_schema_serialization_defaults_required: bool + json_schema_mode_override: Literal['validation', 'serialization', None] + coerce_numbers_to_str: bool + regex_engine: Literal['rust-regex', 'python-re'] + validation_error_cause: bool + + def __init__(self, config: ConfigDict | dict[str, Any] | type[Any] | None, *, check: bool = True): + if check: + self.config_dict = prepare_config(config) + else: + self.config_dict = cast(ConfigDict, config) + + @classmethod + def for_model(cls, bases: tuple[type[Any], ...], namespace: dict[str, Any], kwargs: dict[str, Any]) -> Self: + """Build a new `ConfigWrapper` instance for a `BaseModel`. + + The config wrapper built based on (in descending order of priority): + - options from `kwargs` + - options from the `namespace` + - options from the base classes (`bases`) + + Args: + bases: A tuple of base classes. + namespace: The namespace of the class being created. + kwargs: The kwargs passed to the class being created. + + Returns: + A `ConfigWrapper` instance for `BaseModel`. + """ + config_new = ConfigDict() + for base in bases: + config = getattr(base, 'model_config', None) + if config: + config_new.update(config.copy()) + + config_class_from_namespace = namespace.get('Config') + config_dict_from_namespace = namespace.get('model_config') + + if config_class_from_namespace and config_dict_from_namespace: + raise PydanticUserError('"Config" and "model_config" cannot be used together', code='config-both') + + config_from_namespace = config_dict_from_namespace or prepare_config(config_class_from_namespace) + + config_new.update(config_from_namespace) + + for k in list(kwargs.keys()): + if k in config_keys: + config_new[k] = kwargs.pop(k) + + return cls(config_new) + + # we don't show `__getattr__` to type checkers so missing attributes cause errors + if not TYPE_CHECKING: # pragma: no branch + + def __getattr__(self, name: str) -> Any: + try: + return self.config_dict[name] + except KeyError: + try: + return config_defaults[name] + except KeyError: + raise AttributeError(f'Config has no attribute {name!r}') from None + + def core_config(self, obj: Any) -> core_schema.CoreConfig: + """Create a pydantic-core config, `obj` is just used to populate `title` if not set in config. + + Pass `obj=None` if you do not want to attempt to infer the `title`. + + We don't use getattr here since we don't want to populate with defaults. + + Args: + obj: An object used to populate `title` if not set in config. + + Returns: + A `CoreConfig` object created from config. + """ + + def dict_not_none(**kwargs: Any) -> Any: + return {k: v for k, v in kwargs.items() if v is not None} + + core_config = core_schema.CoreConfig( + **dict_not_none( + title=self.config_dict.get('title') or (obj and obj.__name__), + extra_fields_behavior=self.config_dict.get('extra'), + allow_inf_nan=self.config_dict.get('allow_inf_nan'), + populate_by_name=self.config_dict.get('populate_by_name'), + str_strip_whitespace=self.config_dict.get('str_strip_whitespace'), + str_to_lower=self.config_dict.get('str_to_lower'), + str_to_upper=self.config_dict.get('str_to_upper'), + strict=self.config_dict.get('strict'), + ser_json_timedelta=self.config_dict.get('ser_json_timedelta'), + ser_json_bytes=self.config_dict.get('ser_json_bytes'), + ser_json_inf_nan=self.config_dict.get('ser_json_inf_nan'), + from_attributes=self.config_dict.get('from_attributes'), + loc_by_alias=self.config_dict.get('loc_by_alias'), + revalidate_instances=self.config_dict.get('revalidate_instances'), + validate_default=self.config_dict.get('validate_default'), + str_max_length=self.config_dict.get('str_max_length'), + str_min_length=self.config_dict.get('str_min_length'), + hide_input_in_errors=self.config_dict.get('hide_input_in_errors'), + coerce_numbers_to_str=self.config_dict.get('coerce_numbers_to_str'), + regex_engine=self.config_dict.get('regex_engine'), + validation_error_cause=self.config_dict.get('validation_error_cause'), + ) + ) + return core_config + + def __repr__(self): + c = ', '.join(f'{k}={v!r}' for k, v in self.config_dict.items()) + return f'ConfigWrapper({c})' + + +class ConfigWrapperStack: + """A stack of `ConfigWrapper` instances.""" + + def __init__(self, config_wrapper: ConfigWrapper): + self._config_wrapper_stack: list[ConfigWrapper] = [config_wrapper] + + @property + def tail(self) -> ConfigWrapper: + return self._config_wrapper_stack[-1] + + @contextmanager + def push(self, config_wrapper: ConfigWrapper | ConfigDict | None): + if config_wrapper is None: + yield + return + + if not isinstance(config_wrapper, ConfigWrapper): + config_wrapper = ConfigWrapper(config_wrapper, check=False) + + self._config_wrapper_stack.append(config_wrapper) + try: + yield + finally: + self._config_wrapper_stack.pop() + + +config_defaults = ConfigDict( + title=None, + str_to_lower=False, + str_to_upper=False, + str_strip_whitespace=False, + str_min_length=0, + str_max_length=None, + # let the model / dataclass decide how to handle it + extra=None, + frozen=False, + populate_by_name=False, + use_enum_values=False, + validate_assignment=False, + arbitrary_types_allowed=False, + from_attributes=False, + loc_by_alias=True, + alias_generator=None, + ignored_types=(), + allow_inf_nan=True, + json_schema_extra=None, + strict=False, + revalidate_instances='never', + ser_json_timedelta='iso8601', + ser_json_bytes='utf8', + ser_json_inf_nan='null', + validate_default=False, + validate_return=False, + protected_namespaces=('model_',), + hide_input_in_errors=False, + json_encoders=None, + defer_build=False, + plugin_settings=None, + schema_generator=None, + json_schema_serialization_defaults_required=False, + json_schema_mode_override=None, + coerce_numbers_to_str=False, + regex_engine='rust-regex', + validation_error_cause=False, +) + + +def prepare_config(config: ConfigDict | dict[str, Any] | type[Any] | None) -> ConfigDict: + """Create a `ConfigDict` instance from an existing dict, a class (e.g. old class-based config) or None. + + Args: + config: The input config. + + Returns: + A ConfigDict object created from config. + """ + if config is None: + return ConfigDict() + + if not isinstance(config, dict): + warnings.warn(DEPRECATION_MESSAGE, DeprecationWarning) + config = {k: getattr(config, k) for k in dir(config) if not k.startswith('__')} + + config_dict = cast(ConfigDict, config) + check_deprecated(config_dict) + return config_dict + + +config_keys = set(ConfigDict.__annotations__.keys()) + + +V2_REMOVED_KEYS = { + 'allow_mutation', + 'error_msg_templates', + 'fields', + 'getter_dict', + 'smart_union', + 'underscore_attrs_are_private', + 'json_loads', + 'json_dumps', + 'copy_on_model_validation', + 'post_init_call', +} +V2_RENAMED_KEYS = { + 'allow_population_by_field_name': 'populate_by_name', + 'anystr_lower': 'str_to_lower', + 'anystr_strip_whitespace': 'str_strip_whitespace', + 'anystr_upper': 'str_to_upper', + 'keep_untouched': 'ignored_types', + 'max_anystr_length': 'str_max_length', + 'min_anystr_length': 'str_min_length', + 'orm_mode': 'from_attributes', + 'schema_extra': 'json_schema_extra', + 'validate_all': 'validate_default', +} + + +def check_deprecated(config_dict: ConfigDict) -> None: + """Check for deprecated config keys and warn the user. + + Args: + config_dict: The input config. + """ + deprecated_removed_keys = V2_REMOVED_KEYS & config_dict.keys() + deprecated_renamed_keys = V2_RENAMED_KEYS.keys() & config_dict.keys() + if deprecated_removed_keys or deprecated_renamed_keys: + renamings = {k: V2_RENAMED_KEYS[k] for k in sorted(deprecated_renamed_keys)} + renamed_bullets = [f'* {k!r} has been renamed to {v!r}' for k, v in renamings.items()] + removed_bullets = [f'* {k!r} has been removed' for k in sorted(deprecated_removed_keys)] + message = '\n'.join(['Valid config keys have changed in V2:'] + renamed_bullets + removed_bullets) + warnings.warn(message, UserWarning) diff --git a/lib/pydantic/_internal/_core_metadata.py b/lib/pydantic/_internal/_core_metadata.py new file mode 100644 index 00000000..296d49f5 --- /dev/null +++ b/lib/pydantic/_internal/_core_metadata.py @@ -0,0 +1,92 @@ +from __future__ import annotations as _annotations + +import typing +from typing import Any + +import typing_extensions + +if typing.TYPE_CHECKING: + from ._schema_generation_shared import ( + CoreSchemaOrField as CoreSchemaOrField, + ) + from ._schema_generation_shared import ( + GetJsonSchemaFunction, + ) + + +class CoreMetadata(typing_extensions.TypedDict, total=False): + """A `TypedDict` for holding the metadata dict of the schema. + + Attributes: + pydantic_js_functions: List of JSON schema functions. + pydantic_js_prefer_positional_arguments: Whether JSON schema generator will + prefer positional over keyword arguments for an 'arguments' schema. + """ + + pydantic_js_functions: list[GetJsonSchemaFunction] + pydantic_js_annotation_functions: list[GetJsonSchemaFunction] + + # If `pydantic_js_prefer_positional_arguments` is True, the JSON schema generator will + # prefer positional over keyword arguments for an 'arguments' schema. + pydantic_js_prefer_positional_arguments: bool | None + + pydantic_typed_dict_cls: type[Any] | None # TODO: Consider moving this into the pydantic-core TypedDictSchema + + +class CoreMetadataHandler: + """Because the metadata field in pydantic_core is of type `Any`, we can't assume much about its contents. + + This class is used to interact with the metadata field on a CoreSchema object in a consistent + way throughout pydantic. + """ + + __slots__ = ('_schema',) + + def __init__(self, schema: CoreSchemaOrField): + self._schema = schema + + metadata = schema.get('metadata') + if metadata is None: + schema['metadata'] = CoreMetadata() + elif not isinstance(metadata, dict): + raise TypeError(f'CoreSchema metadata should be a dict; got {metadata!r}.') + + @property + def metadata(self) -> CoreMetadata: + """Retrieves the metadata dict from the schema, initializing it to a dict if it is None + and raises an error if it is not a dict. + """ + metadata = self._schema.get('metadata') + if metadata is None: + self._schema['metadata'] = metadata = CoreMetadata() + if not isinstance(metadata, dict): + raise TypeError(f'CoreSchema metadata should be a dict; got {metadata!r}.') + return metadata + + +def build_metadata_dict( + *, # force keyword arguments to make it easier to modify this signature in a backwards-compatible way + js_functions: list[GetJsonSchemaFunction] | None = None, + js_annotation_functions: list[GetJsonSchemaFunction] | None = None, + js_prefer_positional_arguments: bool | None = None, + typed_dict_cls: type[Any] | None = None, + initial_metadata: Any | None = None, +) -> Any: + """Builds a dict to use as the metadata field of a CoreSchema object in a manner that is consistent + with the CoreMetadataHandler class. + """ + if initial_metadata is not None and not isinstance(initial_metadata, dict): + raise TypeError(f'CoreSchema metadata should be a dict; got {initial_metadata!r}.') + + metadata = CoreMetadata( + pydantic_js_functions=js_functions or [], + pydantic_js_annotation_functions=js_annotation_functions or [], + pydantic_js_prefer_positional_arguments=js_prefer_positional_arguments, + pydantic_typed_dict_cls=typed_dict_cls, + ) + metadata = {k: v for k, v in metadata.items() if v is not None} + + if initial_metadata is not None: + metadata = {**initial_metadata, **metadata} + + return metadata diff --git a/lib/pydantic/_internal/_core_utils.py b/lib/pydantic/_internal/_core_utils.py new file mode 100644 index 00000000..e74c74ac --- /dev/null +++ b/lib/pydantic/_internal/_core_utils.py @@ -0,0 +1,570 @@ +from __future__ import annotations + +import os +from collections import defaultdict +from typing import ( + Any, + Callable, + Hashable, + TypeVar, + Union, +) + +from pydantic_core import CoreSchema, core_schema +from pydantic_core import validate_core_schema as _validate_core_schema +from typing_extensions import TypeAliasType, TypeGuard, get_args, get_origin + +from . import _repr +from ._typing_extra import is_generic_alias + +AnyFunctionSchema = Union[ + core_schema.AfterValidatorFunctionSchema, + core_schema.BeforeValidatorFunctionSchema, + core_schema.WrapValidatorFunctionSchema, + core_schema.PlainValidatorFunctionSchema, +] + + +FunctionSchemaWithInnerSchema = Union[ + core_schema.AfterValidatorFunctionSchema, + core_schema.BeforeValidatorFunctionSchema, + core_schema.WrapValidatorFunctionSchema, +] + +CoreSchemaField = Union[ + core_schema.ModelField, core_schema.DataclassField, core_schema.TypedDictField, core_schema.ComputedField +] +CoreSchemaOrField = Union[core_schema.CoreSchema, CoreSchemaField] + +_CORE_SCHEMA_FIELD_TYPES = {'typed-dict-field', 'dataclass-field', 'model-field', 'computed-field'} +_FUNCTION_WITH_INNER_SCHEMA_TYPES = {'function-before', 'function-after', 'function-wrap'} +_LIST_LIKE_SCHEMA_WITH_ITEMS_TYPES = {'list', 'set', 'frozenset'} + +_DEFINITIONS_CACHE_METADATA_KEY = 'pydantic.definitions_cache' + +TAGGED_UNION_TAG_KEY = 'pydantic.internal.tagged_union_tag' +""" +Used in a `Tag` schema to specify the tag used for a discriminated union. +""" +HAS_INVALID_SCHEMAS_METADATA_KEY = 'pydantic.internal.invalid' +"""Used to mark a schema that is invalid because it refers to a definition that was not yet defined when the +schema was first encountered. +""" + + +def is_core_schema( + schema: CoreSchemaOrField, +) -> TypeGuard[CoreSchema]: + return schema['type'] not in _CORE_SCHEMA_FIELD_TYPES + + +def is_core_schema_field( + schema: CoreSchemaOrField, +) -> TypeGuard[CoreSchemaField]: + return schema['type'] in _CORE_SCHEMA_FIELD_TYPES + + +def is_function_with_inner_schema( + schema: CoreSchemaOrField, +) -> TypeGuard[FunctionSchemaWithInnerSchema]: + return schema['type'] in _FUNCTION_WITH_INNER_SCHEMA_TYPES + + +def is_list_like_schema_with_items_schema( + schema: CoreSchema, +) -> TypeGuard[core_schema.ListSchema | core_schema.SetSchema | core_schema.FrozenSetSchema]: + return schema['type'] in _LIST_LIKE_SCHEMA_WITH_ITEMS_TYPES + + +def get_type_ref(type_: type[Any], args_override: tuple[type[Any], ...] | None = None) -> str: + """Produces the ref to be used for this type by pydantic_core's core schemas. + + This `args_override` argument was added for the purpose of creating valid recursive references + when creating generic models without needing to create a concrete class. + """ + origin = get_origin(type_) or type_ + + args = get_args(type_) if is_generic_alias(type_) else (args_override or ()) + generic_metadata = getattr(type_, '__pydantic_generic_metadata__', None) + if generic_metadata: + origin = generic_metadata['origin'] or origin + args = generic_metadata['args'] or args + + module_name = getattr(origin, '__module__', '') + if isinstance(origin, TypeAliasType): + type_ref = f'{module_name}.{origin.__name__}:{id(origin)}' + else: + try: + qualname = getattr(origin, '__qualname__', f'') + except Exception: + qualname = getattr(origin, '__qualname__', '') + type_ref = f'{module_name}.{qualname}:{id(origin)}' + + arg_refs: list[str] = [] + for arg in args: + if isinstance(arg, str): + # Handle string literals as a special case; we may be able to remove this special handling if we + # wrap them in a ForwardRef at some point. + arg_ref = f'{arg}:str-{id(arg)}' + else: + arg_ref = f'{_repr.display_as_type(arg)}:{id(arg)}' + arg_refs.append(arg_ref) + if arg_refs: + type_ref = f'{type_ref}[{",".join(arg_refs)}]' + return type_ref + + +def get_ref(s: core_schema.CoreSchema) -> None | str: + """Get the ref from the schema if it has one. + This exists just for type checking to work correctly. + """ + return s.get('ref', None) + + +def collect_definitions(schema: core_schema.CoreSchema) -> dict[str, core_schema.CoreSchema]: + defs: dict[str, CoreSchema] = {} + + def _record_valid_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema: + ref = get_ref(s) + if ref: + defs[ref] = s + return recurse(s, _record_valid_refs) + + walk_core_schema(schema, _record_valid_refs) + + return defs + + +def define_expected_missing_refs( + schema: core_schema.CoreSchema, allowed_missing_refs: set[str] +) -> core_schema.CoreSchema | None: + if not allowed_missing_refs: + # in this case, there are no missing refs to potentially substitute, so there's no need to walk the schema + # this is a common case (will be hit for all non-generic models), so it's worth optimizing for + return None + + refs = collect_definitions(schema).keys() + + expected_missing_refs = allowed_missing_refs.difference(refs) + if expected_missing_refs: + definitions: list[core_schema.CoreSchema] = [ + # TODO: Replace this with a (new) CoreSchema that, if present at any level, makes validation fail + # Issue: https://github.com/pydantic/pydantic-core/issues/619 + core_schema.none_schema(ref=ref, metadata={HAS_INVALID_SCHEMAS_METADATA_KEY: True}) + for ref in expected_missing_refs + ] + return core_schema.definitions_schema(schema, definitions) + return None + + +def collect_invalid_schemas(schema: core_schema.CoreSchema) -> bool: + invalid = False + + def _is_schema_valid(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema: + nonlocal invalid + if 'metadata' in s: + metadata = s['metadata'] + if HAS_INVALID_SCHEMAS_METADATA_KEY in metadata: + invalid = metadata[HAS_INVALID_SCHEMAS_METADATA_KEY] + return s + return recurse(s, _is_schema_valid) + + walk_core_schema(schema, _is_schema_valid) + return invalid + + +T = TypeVar('T') + + +Recurse = Callable[[core_schema.CoreSchema, 'Walk'], core_schema.CoreSchema] +Walk = Callable[[core_schema.CoreSchema, Recurse], core_schema.CoreSchema] + +# TODO: Should we move _WalkCoreSchema into pydantic_core proper? +# Issue: https://github.com/pydantic/pydantic-core/issues/615 + + +class _WalkCoreSchema: + def __init__(self): + self._schema_type_to_method = self._build_schema_type_to_method() + + def _build_schema_type_to_method(self) -> dict[core_schema.CoreSchemaType, Recurse]: + mapping: dict[core_schema.CoreSchemaType, Recurse] = {} + key: core_schema.CoreSchemaType + for key in get_args(core_schema.CoreSchemaType): + method_name = f"handle_{key.replace('-', '_')}_schema" + mapping[key] = getattr(self, method_name, self._handle_other_schemas) + return mapping + + def walk(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema: + return f(schema, self._walk) + + def _walk(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema: + schema = self._schema_type_to_method[schema['type']](schema.copy(), f) + ser_schema: core_schema.SerSchema | None = schema.get('serialization') # type: ignore + if ser_schema: + schema['serialization'] = self._handle_ser_schemas(ser_schema, f) + return schema + + def _handle_other_schemas(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema: + sub_schema = schema.get('schema', None) + if sub_schema is not None: + schema['schema'] = self.walk(sub_schema, f) # type: ignore + return schema + + def _handle_ser_schemas(self, ser_schema: core_schema.SerSchema, f: Walk) -> core_schema.SerSchema: + schema: core_schema.CoreSchema | None = ser_schema.get('schema', None) + if schema is not None: + ser_schema['schema'] = self.walk(schema, f) # type: ignore + return_schema: core_schema.CoreSchema | None = ser_schema.get('return_schema', None) + if return_schema is not None: + ser_schema['return_schema'] = self.walk(return_schema, f) # type: ignore + return ser_schema + + def handle_definitions_schema(self, schema: core_schema.DefinitionsSchema, f: Walk) -> core_schema.CoreSchema: + new_definitions: list[core_schema.CoreSchema] = [] + for definition in schema['definitions']: + if 'schema_ref' in definition and 'ref' in definition: + # This indicates a purposely indirect reference + # We want to keep such references around for implications related to JSON schema, etc.: + new_definitions.append(definition) + # However, we still need to walk the referenced definition: + self.walk(definition, f) + continue + + updated_definition = self.walk(definition, f) + if 'ref' in updated_definition: + # If the updated definition schema doesn't have a 'ref', it shouldn't go in the definitions + # This is most likely to happen due to replacing something with a definition reference, in + # which case it should certainly not go in the definitions list + new_definitions.append(updated_definition) + new_inner_schema = self.walk(schema['schema'], f) + + if not new_definitions and len(schema) == 3: + # This means we'd be returning a "trivial" definitions schema that just wrapped the inner schema + return new_inner_schema + + new_schema = schema.copy() + new_schema['schema'] = new_inner_schema + new_schema['definitions'] = new_definitions + return new_schema + + def handle_list_schema(self, schema: core_schema.ListSchema, f: Walk) -> core_schema.CoreSchema: + items_schema = schema.get('items_schema') + if items_schema is not None: + schema['items_schema'] = self.walk(items_schema, f) + return schema + + def handle_set_schema(self, schema: core_schema.SetSchema, f: Walk) -> core_schema.CoreSchema: + items_schema = schema.get('items_schema') + if items_schema is not None: + schema['items_schema'] = self.walk(items_schema, f) + return schema + + def handle_frozenset_schema(self, schema: core_schema.FrozenSetSchema, f: Walk) -> core_schema.CoreSchema: + items_schema = schema.get('items_schema') + if items_schema is not None: + schema['items_schema'] = self.walk(items_schema, f) + return schema + + def handle_generator_schema(self, schema: core_schema.GeneratorSchema, f: Walk) -> core_schema.CoreSchema: + items_schema = schema.get('items_schema') + if items_schema is not None: + schema['items_schema'] = self.walk(items_schema, f) + return schema + + def handle_tuple_schema(self, schema: core_schema.TupleSchema, f: Walk) -> core_schema.CoreSchema: + schema['items_schema'] = [self.walk(v, f) for v in schema['items_schema']] + return schema + + def handle_dict_schema(self, schema: core_schema.DictSchema, f: Walk) -> core_schema.CoreSchema: + keys_schema = schema.get('keys_schema') + if keys_schema is not None: + schema['keys_schema'] = self.walk(keys_schema, f) + values_schema = schema.get('values_schema') + if values_schema: + schema['values_schema'] = self.walk(values_schema, f) + return schema + + def handle_function_schema(self, schema: AnyFunctionSchema, f: Walk) -> core_schema.CoreSchema: + if not is_function_with_inner_schema(schema): + return schema + schema['schema'] = self.walk(schema['schema'], f) + return schema + + def handle_union_schema(self, schema: core_schema.UnionSchema, f: Walk) -> core_schema.CoreSchema: + new_choices: list[CoreSchema | tuple[CoreSchema, str]] = [] + for v in schema['choices']: + if isinstance(v, tuple): + new_choices.append((self.walk(v[0], f), v[1])) + else: + new_choices.append(self.walk(v, f)) + schema['choices'] = new_choices + return schema + + def handle_tagged_union_schema(self, schema: core_schema.TaggedUnionSchema, f: Walk) -> core_schema.CoreSchema: + new_choices: dict[Hashable, core_schema.CoreSchema] = {} + for k, v in schema['choices'].items(): + new_choices[k] = v if isinstance(v, (str, int)) else self.walk(v, f) + schema['choices'] = new_choices + return schema + + def handle_chain_schema(self, schema: core_schema.ChainSchema, f: Walk) -> core_schema.CoreSchema: + schema['steps'] = [self.walk(v, f) for v in schema['steps']] + return schema + + def handle_lax_or_strict_schema(self, schema: core_schema.LaxOrStrictSchema, f: Walk) -> core_schema.CoreSchema: + schema['lax_schema'] = self.walk(schema['lax_schema'], f) + schema['strict_schema'] = self.walk(schema['strict_schema'], f) + return schema + + def handle_json_or_python_schema(self, schema: core_schema.JsonOrPythonSchema, f: Walk) -> core_schema.CoreSchema: + schema['json_schema'] = self.walk(schema['json_schema'], f) + schema['python_schema'] = self.walk(schema['python_schema'], f) + return schema + + def handle_model_fields_schema(self, schema: core_schema.ModelFieldsSchema, f: Walk) -> core_schema.CoreSchema: + extras_schema = schema.get('extras_schema') + if extras_schema is not None: + schema['extras_schema'] = self.walk(extras_schema, f) + replaced_fields: dict[str, core_schema.ModelField] = {} + replaced_computed_fields: list[core_schema.ComputedField] = [] + for computed_field in schema.get('computed_fields', ()): + replaced_field = computed_field.copy() + replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f) + replaced_computed_fields.append(replaced_field) + if replaced_computed_fields: + schema['computed_fields'] = replaced_computed_fields + for k, v in schema['fields'].items(): + replaced_field = v.copy() + replaced_field['schema'] = self.walk(v['schema'], f) + replaced_fields[k] = replaced_field + schema['fields'] = replaced_fields + return schema + + def handle_typed_dict_schema(self, schema: core_schema.TypedDictSchema, f: Walk) -> core_schema.CoreSchema: + extras_schema = schema.get('extras_schema') + if extras_schema is not None: + schema['extras_schema'] = self.walk(extras_schema, f) + replaced_computed_fields: list[core_schema.ComputedField] = [] + for computed_field in schema.get('computed_fields', ()): + replaced_field = computed_field.copy() + replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f) + replaced_computed_fields.append(replaced_field) + if replaced_computed_fields: + schema['computed_fields'] = replaced_computed_fields + replaced_fields: dict[str, core_schema.TypedDictField] = {} + for k, v in schema['fields'].items(): + replaced_field = v.copy() + replaced_field['schema'] = self.walk(v['schema'], f) + replaced_fields[k] = replaced_field + schema['fields'] = replaced_fields + return schema + + def handle_dataclass_args_schema(self, schema: core_schema.DataclassArgsSchema, f: Walk) -> core_schema.CoreSchema: + replaced_fields: list[core_schema.DataclassField] = [] + replaced_computed_fields: list[core_schema.ComputedField] = [] + for computed_field in schema.get('computed_fields', ()): + replaced_field = computed_field.copy() + replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f) + replaced_computed_fields.append(replaced_field) + if replaced_computed_fields: + schema['computed_fields'] = replaced_computed_fields + for field in schema['fields']: + replaced_field = field.copy() + replaced_field['schema'] = self.walk(field['schema'], f) + replaced_fields.append(replaced_field) + schema['fields'] = replaced_fields + return schema + + def handle_arguments_schema(self, schema: core_schema.ArgumentsSchema, f: Walk) -> core_schema.CoreSchema: + replaced_arguments_schema: list[core_schema.ArgumentsParameter] = [] + for param in schema['arguments_schema']: + replaced_param = param.copy() + replaced_param['schema'] = self.walk(param['schema'], f) + replaced_arguments_schema.append(replaced_param) + schema['arguments_schema'] = replaced_arguments_schema + if 'var_args_schema' in schema: + schema['var_args_schema'] = self.walk(schema['var_args_schema'], f) + if 'var_kwargs_schema' in schema: + schema['var_kwargs_schema'] = self.walk(schema['var_kwargs_schema'], f) + return schema + + def handle_call_schema(self, schema: core_schema.CallSchema, f: Walk) -> core_schema.CoreSchema: + schema['arguments_schema'] = self.walk(schema['arguments_schema'], f) + if 'return_schema' in schema: + schema['return_schema'] = self.walk(schema['return_schema'], f) + return schema + + +_dispatch = _WalkCoreSchema().walk + + +def walk_core_schema(schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema: + """Recursively traverse a CoreSchema. + + Args: + schema (core_schema.CoreSchema): The CoreSchema to process, it will not be modified. + f (Walk): A function to apply. This function takes two arguments: + 1. The current CoreSchema that is being processed + (not the same one you passed into this function, one level down). + 2. The "next" `f` to call. This lets you for example use `f=functools.partial(some_method, some_context)` + to pass data down the recursive calls without using globals or other mutable state. + + Returns: + core_schema.CoreSchema: A processed CoreSchema. + """ + return f(schema.copy(), _dispatch) + + +def simplify_schema_references(schema: core_schema.CoreSchema) -> core_schema.CoreSchema: # noqa: C901 + definitions: dict[str, core_schema.CoreSchema] = {} + ref_counts: dict[str, int] = defaultdict(int) + involved_in_recursion: dict[str, bool] = {} + current_recursion_ref_count: dict[str, int] = defaultdict(int) + + def collect_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema: + if s['type'] == 'definitions': + for definition in s['definitions']: + ref = get_ref(definition) + assert ref is not None + if ref not in definitions: + definitions[ref] = definition + recurse(definition, collect_refs) + return recurse(s['schema'], collect_refs) + else: + ref = get_ref(s) + if ref is not None: + new = recurse(s, collect_refs) + new_ref = get_ref(new) + if new_ref: + definitions[new_ref] = new + return core_schema.definition_reference_schema(schema_ref=ref) + else: + return recurse(s, collect_refs) + + schema = walk_core_schema(schema, collect_refs) + + def count_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema: + if s['type'] != 'definition-ref': + return recurse(s, count_refs) + ref = s['schema_ref'] + ref_counts[ref] += 1 + + if ref_counts[ref] >= 2: + # If this model is involved in a recursion this should be detected + # on its second encounter, we can safely stop the walk here. + if current_recursion_ref_count[ref] != 0: + involved_in_recursion[ref] = True + return s + + current_recursion_ref_count[ref] += 1 + recurse(definitions[ref], count_refs) + current_recursion_ref_count[ref] -= 1 + return s + + schema = walk_core_schema(schema, count_refs) + + assert all(c == 0 for c in current_recursion_ref_count.values()), 'this is a bug! please report it' + + def can_be_inlined(s: core_schema.DefinitionReferenceSchema, ref: str) -> bool: + if ref_counts[ref] > 1: + return False + if involved_in_recursion.get(ref, False): + return False + if 'serialization' in s: + return False + if 'metadata' in s: + metadata = s['metadata'] + for k in ( + 'pydantic_js_functions', + 'pydantic_js_annotation_functions', + 'pydantic.internal.union_discriminator', + ): + if k in metadata: + # we need to keep this as a ref + return False + return True + + def inline_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema: + if s['type'] == 'definition-ref': + ref = s['schema_ref'] + # Check if the reference is only used once, not involved in recursion and does not have + # any extra keys (like 'serialization') + if can_be_inlined(s, ref): + # Inline the reference by replacing the reference with the actual schema + new = definitions.pop(ref) + ref_counts[ref] -= 1 # because we just replaced it! + # put all other keys that were on the def-ref schema into the inlined version + # in particular this is needed for `serialization` + if 'serialization' in s: + new['serialization'] = s['serialization'] + s = recurse(new, inline_refs) + return s + else: + return recurse(s, inline_refs) + else: + return recurse(s, inline_refs) + + schema = walk_core_schema(schema, inline_refs) + + def_values = [v for v in definitions.values() if ref_counts[v['ref']] > 0] # type: ignore + + if def_values: + schema = core_schema.definitions_schema(schema=schema, definitions=def_values) + return schema + + +def _strip_metadata(schema: CoreSchema) -> CoreSchema: + def strip_metadata(s: CoreSchema, recurse: Recurse) -> CoreSchema: + s = s.copy() + s.pop('metadata', None) + if s['type'] == 'model-fields': + s = s.copy() + s['fields'] = {k: v.copy() for k, v in s['fields'].items()} + for field_name, field_schema in s['fields'].items(): + field_schema.pop('metadata', None) + s['fields'][field_name] = field_schema + computed_fields = s.get('computed_fields', None) + if computed_fields: + s['computed_fields'] = [cf.copy() for cf in computed_fields] + for cf in computed_fields: + cf.pop('metadata', None) + else: + s.pop('computed_fields', None) + elif s['type'] == 'model': + # remove some defaults + if s.get('custom_init', True) is False: + s.pop('custom_init') + if s.get('root_model', True) is False: + s.pop('root_model') + if {'title'}.issuperset(s.get('config', {}).keys()): + s.pop('config', None) + + return recurse(s, strip_metadata) + + return walk_core_schema(schema, strip_metadata) + + +def pretty_print_core_schema( + schema: CoreSchema, + include_metadata: bool = False, +) -> None: + """Pretty print a CoreSchema using rich. + This is intended for debugging purposes. + + Args: + schema: The CoreSchema to print. + include_metadata: Whether to include metadata in the output. Defaults to `False`. + """ + from rich import print # type: ignore # install it manually in your dev env + + if not include_metadata: + schema = _strip_metadata(schema) + + return print(schema) + + +def validate_core_schema(schema: CoreSchema) -> CoreSchema: + if 'PYDANTIC_SKIP_VALIDATING_CORE_SCHEMAS' in os.environ: + return schema + return _validate_core_schema(schema) diff --git a/lib/pydantic/_internal/_dataclasses.py b/lib/pydantic/_internal/_dataclasses.py new file mode 100644 index 00000000..1ec23044 --- /dev/null +++ b/lib/pydantic/_internal/_dataclasses.py @@ -0,0 +1,225 @@ +"""Private logic for creating pydantic dataclasses.""" +from __future__ import annotations as _annotations + +import dataclasses +import typing +import warnings +from functools import partial, wraps +from typing import Any, Callable, ClassVar + +from pydantic_core import ( + ArgsKwargs, + SchemaSerializer, + SchemaValidator, + core_schema, +) +from typing_extensions import TypeGuard + +from ..errors import PydanticUndefinedAnnotation +from ..fields import FieldInfo +from ..plugin._schema_validator import create_schema_validator +from ..warnings import PydanticDeprecatedSince20 +from . import _config, _decorators, _typing_extra +from ._fields import collect_dataclass_fields +from ._generate_schema import GenerateSchema +from ._generics import get_standard_typevars_map +from ._mock_val_ser import set_dataclass_mocks +from ._schema_generation_shared import CallbackGetCoreSchemaHandler +from ._signature import generate_pydantic_signature + +if typing.TYPE_CHECKING: + from ..config import ConfigDict + + class StandardDataclass(typing.Protocol): + __dataclass_fields__: ClassVar[dict[str, Any]] + __dataclass_params__: ClassVar[Any] # in reality `dataclasses._DataclassParams` + __post_init__: ClassVar[Callable[..., None]] + + def __init__(self, *args: object, **kwargs: object) -> None: + pass + + class PydanticDataclass(StandardDataclass, typing.Protocol): + """A protocol containing attributes only available once a class has been decorated as a Pydantic dataclass. + + Attributes: + __pydantic_config__: Pydantic-specific configuration settings for the dataclass. + __pydantic_complete__: Whether dataclass building is completed, or if there are still undefined fields. + __pydantic_core_schema__: The pydantic-core schema used to build the SchemaValidator and SchemaSerializer. + __pydantic_decorators__: Metadata containing the decorators defined on the dataclass. + __pydantic_fields__: Metadata about the fields defined on the dataclass. + __pydantic_serializer__: The pydantic-core SchemaSerializer used to dump instances of the dataclass. + __pydantic_validator__: The pydantic-core SchemaValidator used to validate instances of the dataclass. + """ + + __pydantic_config__: ClassVar[ConfigDict] + __pydantic_complete__: ClassVar[bool] + __pydantic_core_schema__: ClassVar[core_schema.CoreSchema] + __pydantic_decorators__: ClassVar[_decorators.DecoratorInfos] + __pydantic_fields__: ClassVar[dict[str, FieldInfo]] + __pydantic_serializer__: ClassVar[SchemaSerializer] + __pydantic_validator__: ClassVar[SchemaValidator] + +else: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + + +def set_dataclass_fields(cls: type[StandardDataclass], types_namespace: dict[str, Any] | None = None) -> None: + """Collect and set `cls.__pydantic_fields__`. + + Args: + cls: The class. + types_namespace: The types namespace, defaults to `None`. + """ + typevars_map = get_standard_typevars_map(cls) + fields = collect_dataclass_fields(cls, types_namespace, typevars_map=typevars_map) + + cls.__pydantic_fields__ = fields # type: ignore + + +def complete_dataclass( + cls: type[Any], + config_wrapper: _config.ConfigWrapper, + *, + raise_errors: bool = True, + types_namespace: dict[str, Any] | None, +) -> bool: + """Finish building a pydantic dataclass. + + This logic is called on a class which has already been wrapped in `dataclasses.dataclass()`. + + This is somewhat analogous to `pydantic._internal._model_construction.complete_model_class`. + + Args: + cls: The class. + config_wrapper: The config wrapper instance. + raise_errors: Whether to raise errors, defaults to `True`. + types_namespace: The types namespace. + + Returns: + `True` if building a pydantic dataclass is successfully completed, `False` otherwise. + + Raises: + PydanticUndefinedAnnotation: If `raise_error` is `True` and there is an undefined annotations. + """ + if hasattr(cls, '__post_init_post_parse__'): + warnings.warn( + 'Support for `__post_init_post_parse__` has been dropped, the method will not be called', DeprecationWarning + ) + + if types_namespace is None: + types_namespace = _typing_extra.get_cls_types_namespace(cls) + + set_dataclass_fields(cls, types_namespace) + + typevars_map = get_standard_typevars_map(cls) + gen_schema = GenerateSchema( + config_wrapper, + types_namespace, + typevars_map, + ) + + # This needs to be called before we change the __init__ + sig = generate_pydantic_signature( + init=cls.__init__, + fields=cls.__pydantic_fields__, # type: ignore + config_wrapper=config_wrapper, + is_dataclass=True, + ) + + # dataclass.__init__ must be defined here so its `__qualname__` can be changed since functions can't be copied. + def __init__(__dataclass_self__: PydanticDataclass, *args: Any, **kwargs: Any) -> None: + __tracebackhide__ = True + s = __dataclass_self__ + s.__pydantic_validator__.validate_python(ArgsKwargs(args, kwargs), self_instance=s) + + __init__.__qualname__ = f'{cls.__qualname__}.__init__' + + cls.__init__ = __init__ # type: ignore + cls.__pydantic_config__ = config_wrapper.config_dict # type: ignore + cls.__signature__ = sig # type: ignore + get_core_schema = getattr(cls, '__get_pydantic_core_schema__', None) + try: + if get_core_schema: + schema = get_core_schema( + cls, + CallbackGetCoreSchemaHandler( + partial(gen_schema.generate_schema, from_dunder_get_core_schema=False), + gen_schema, + ref_mode='unpack', + ), + ) + else: + schema = gen_schema.generate_schema(cls, from_dunder_get_core_schema=False) + except PydanticUndefinedAnnotation as e: + if raise_errors: + raise + set_dataclass_mocks(cls, cls.__name__, f'`{e.name}`') + return False + + core_config = config_wrapper.core_config(cls) + + try: + schema = gen_schema.clean_schema(schema) + except gen_schema.CollectedInvalid: + set_dataclass_mocks(cls, cls.__name__, 'all referenced types') + return False + + # We are about to set all the remaining required properties expected for this cast; + # __pydantic_decorators__ and __pydantic_fields__ should already be set + cls = typing.cast('type[PydanticDataclass]', cls) + # debug(schema) + + cls.__pydantic_core_schema__ = schema + cls.__pydantic_validator__ = validator = create_schema_validator( + schema, cls, cls.__module__, cls.__qualname__, 'dataclass', core_config, config_wrapper.plugin_settings + ) + cls.__pydantic_serializer__ = SchemaSerializer(schema, core_config) + + if config_wrapper.validate_assignment: + + @wraps(cls.__setattr__) + def validated_setattr(instance: Any, __field: str, __value: str) -> None: + validator.validate_assignment(instance, __field, __value) + + cls.__setattr__ = validated_setattr.__get__(None, cls) # type: ignore + + return True + + +def is_builtin_dataclass(_cls: type[Any]) -> TypeGuard[type[StandardDataclass]]: + """Returns True if a class is a stdlib dataclass and *not* a pydantic dataclass. + + We check that + - `_cls` is a dataclass + - `_cls` does not inherit from a processed pydantic dataclass (and thus have a `__pydantic_validator__`) + - `_cls` does not have any annotations that are not dataclass fields + e.g. + ```py + import dataclasses + + import pydantic.dataclasses + + @dataclasses.dataclass + class A: + x: int + + @pydantic.dataclasses.dataclass + class B(A): + y: int + ``` + In this case, when we first check `B`, we make an extra check and look at the annotations ('y'), + which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x') + + Args: + cls: The class. + + Returns: + `True` if the class is a stdlib dataclass, `False` otherwise. + """ + return ( + dataclasses.is_dataclass(_cls) + and not hasattr(_cls, '__pydantic_validator__') + and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {}))) + ) diff --git a/lib/pydantic/_internal/_decorators.py b/lib/pydantic/_internal/_decorators.py new file mode 100644 index 00000000..5672464c --- /dev/null +++ b/lib/pydantic/_internal/_decorators.py @@ -0,0 +1,791 @@ +"""Logic related to validators applied to models etc. via the `@field_validator` and `@model_validator` decorators.""" +from __future__ import annotations as _annotations + +from collections import deque +from dataclasses import dataclass, field +from functools import cached_property, partial, partialmethod +from inspect import Parameter, Signature, isdatadescriptor, ismethoddescriptor, signature +from itertools import islice +from typing import TYPE_CHECKING, Any, Callable, ClassVar, Generic, Iterable, TypeVar, Union + +from pydantic_core import PydanticUndefined, core_schema +from typing_extensions import Literal, TypeAlias, is_typeddict + +from ..errors import PydanticUserError +from ._core_utils import get_type_ref +from ._internal_dataclass import slots_true +from ._typing_extra import get_function_type_hints + +if TYPE_CHECKING: + from ..fields import ComputedFieldInfo + from ..functional_validators import FieldValidatorModes + + +@dataclass(**slots_true) +class ValidatorDecoratorInfo: + """A container for data from `@validator` so that we can access it + while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@validator'. + fields: A tuple of field names the validator should be called on. + mode: The proposed validator mode. + each_item: For complex objects (sets, lists etc.) whether to validate individual + elements rather than the whole object. + always: Whether this method and other validators should be called even if the value is missing. + check_fields: Whether to check that the fields actually exist on the model. + """ + + decorator_repr: ClassVar[str] = '@validator' + + fields: tuple[str, ...] + mode: Literal['before', 'after'] + each_item: bool + always: bool + check_fields: bool | None + + +@dataclass(**slots_true) +class FieldValidatorDecoratorInfo: + """A container for data from `@field_validator` so that we can access it + while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@field_validator'. + fields: A tuple of field names the validator should be called on. + mode: The proposed validator mode. + check_fields: Whether to check that the fields actually exist on the model. + """ + + decorator_repr: ClassVar[str] = '@field_validator' + + fields: tuple[str, ...] + mode: FieldValidatorModes + check_fields: bool | None + + +@dataclass(**slots_true) +class RootValidatorDecoratorInfo: + """A container for data from `@root_validator` so that we can access it + while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@root_validator'. + mode: The proposed validator mode. + """ + + decorator_repr: ClassVar[str] = '@root_validator' + mode: Literal['before', 'after'] + + +@dataclass(**slots_true) +class FieldSerializerDecoratorInfo: + """A container for data from `@field_serializer` so that we can access it + while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@field_serializer'. + fields: A tuple of field names the serializer should be called on. + mode: The proposed serializer mode. + return_type: The type of the serializer's return value. + when_used: The serialization condition. Accepts a string with values `'always'`, `'unless-none'`, `'json'`, + and `'json-unless-none'`. + check_fields: Whether to check that the fields actually exist on the model. + """ + + decorator_repr: ClassVar[str] = '@field_serializer' + fields: tuple[str, ...] + mode: Literal['plain', 'wrap'] + return_type: Any + when_used: core_schema.WhenUsed + check_fields: bool | None + + +@dataclass(**slots_true) +class ModelSerializerDecoratorInfo: + """A container for data from `@model_serializer` so that we can access it + while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@model_serializer'. + mode: The proposed serializer mode. + return_type: The type of the serializer's return value. + when_used: The serialization condition. Accepts a string with values `'always'`, `'unless-none'`, `'json'`, + and `'json-unless-none'`. + """ + + decorator_repr: ClassVar[str] = '@model_serializer' + mode: Literal['plain', 'wrap'] + return_type: Any + when_used: core_schema.WhenUsed + + +@dataclass(**slots_true) +class ModelValidatorDecoratorInfo: + """A container for data from `@model_validator` so that we can access it + while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@model_serializer'. + mode: The proposed serializer mode. + """ + + decorator_repr: ClassVar[str] = '@model_validator' + mode: Literal['wrap', 'before', 'after'] + + +DecoratorInfo: TypeAlias = """Union[ + ValidatorDecoratorInfo, + FieldValidatorDecoratorInfo, + RootValidatorDecoratorInfo, + FieldSerializerDecoratorInfo, + ModelSerializerDecoratorInfo, + ModelValidatorDecoratorInfo, + ComputedFieldInfo, +]""" + +ReturnType = TypeVar('ReturnType') +DecoratedType: TypeAlias = ( + 'Union[classmethod[Any, Any, ReturnType], staticmethod[Any, ReturnType], Callable[..., ReturnType], property]' +) + + +@dataclass # can't use slots here since we set attributes on `__post_init__` +class PydanticDescriptorProxy(Generic[ReturnType]): + """Wrap a classmethod, staticmethod, property or unbound function + and act as a descriptor that allows us to detect decorated items + from the class' attributes. + + This class' __get__ returns the wrapped item's __get__ result, + which makes it transparent for classmethods and staticmethods. + + Attributes: + wrapped: The decorator that has to be wrapped. + decorator_info: The decorator info. + shim: A wrapper function to wrap V1 style function. + """ + + wrapped: DecoratedType[ReturnType] + decorator_info: DecoratorInfo + shim: Callable[[Callable[..., Any]], Callable[..., Any]] | None = None + + def __post_init__(self): + for attr in 'setter', 'deleter': + if hasattr(self.wrapped, attr): + f = partial(self._call_wrapped_attr, name=attr) + setattr(self, attr, f) + + def _call_wrapped_attr(self, func: Callable[[Any], None], *, name: str) -> PydanticDescriptorProxy[ReturnType]: + self.wrapped = getattr(self.wrapped, name)(func) + return self + + def __get__(self, obj: object | None, obj_type: type[object] | None = None) -> PydanticDescriptorProxy[ReturnType]: + try: + return self.wrapped.__get__(obj, obj_type) + except AttributeError: + # not a descriptor, e.g. a partial object + return self.wrapped # type: ignore[return-value] + + def __set_name__(self, instance: Any, name: str) -> None: + if hasattr(self.wrapped, '__set_name__'): + self.wrapped.__set_name__(instance, name) # pyright: ignore[reportFunctionMemberAccess] + + def __getattr__(self, __name: str) -> Any: + """Forward checks for __isabstractmethod__ and such.""" + return getattr(self.wrapped, __name) + + +DecoratorInfoType = TypeVar('DecoratorInfoType', bound=DecoratorInfo) + + +@dataclass(**slots_true) +class Decorator(Generic[DecoratorInfoType]): + """A generic container class to join together the decorator metadata + (metadata from decorator itself, which we have when the + decorator is called but not when we are building the core-schema) + and the bound function (which we have after the class itself is created). + + Attributes: + cls_ref: The class ref. + cls_var_name: The decorated function name. + func: The decorated function. + shim: A wrapper function to wrap V1 style function. + info: The decorator info. + """ + + cls_ref: str + cls_var_name: str + func: Callable[..., Any] + shim: Callable[[Any], Any] | None + info: DecoratorInfoType + + @staticmethod + def build( + cls_: Any, + *, + cls_var_name: str, + shim: Callable[[Any], Any] | None, + info: DecoratorInfoType, + ) -> Decorator[DecoratorInfoType]: + """Build a new decorator. + + Args: + cls_: The class. + cls_var_name: The decorated function name. + shim: A wrapper function to wrap V1 style function. + info: The decorator info. + + Returns: + The new decorator instance. + """ + func = get_attribute_from_bases(cls_, cls_var_name) + if shim is not None: + func = shim(func) + func = unwrap_wrapped_function(func, unwrap_partial=False) + if not callable(func): + # This branch will get hit for classmethod properties + attribute = get_attribute_from_base_dicts(cls_, cls_var_name) # prevents the binding call to `__get__` + if isinstance(attribute, PydanticDescriptorProxy): + func = unwrap_wrapped_function(attribute.wrapped) + return Decorator( + cls_ref=get_type_ref(cls_), + cls_var_name=cls_var_name, + func=func, + shim=shim, + info=info, + ) + + def bind_to_cls(self, cls: Any) -> Decorator[DecoratorInfoType]: + """Bind the decorator to a class. + + Args: + cls: the class. + + Returns: + The new decorator instance. + """ + return self.build( + cls, + cls_var_name=self.cls_var_name, + shim=self.shim, + info=self.info, + ) + + +def get_bases(tp: type[Any]) -> tuple[type[Any], ...]: + """Get the base classes of a class or typeddict. + + Args: + tp: The type or class to get the bases. + + Returns: + The base classes. + """ + if is_typeddict(tp): + return tp.__orig_bases__ # type: ignore + try: + return tp.__bases__ + except AttributeError: + return () + + +def mro(tp: type[Any]) -> tuple[type[Any], ...]: + """Calculate the Method Resolution Order of bases using the C3 algorithm. + + See https://www.python.org/download/releases/2.3/mro/ + """ + # try to use the existing mro, for performance mainly + # but also because it helps verify the implementation below + if not is_typeddict(tp): + try: + return tp.__mro__ + except AttributeError: + # GenericAlias and some other cases + pass + + bases = get_bases(tp) + return (tp,) + mro_for_bases(bases) + + +def mro_for_bases(bases: tuple[type[Any], ...]) -> tuple[type[Any], ...]: + def merge_seqs(seqs: list[deque[type[Any]]]) -> Iterable[type[Any]]: + while True: + non_empty = [seq for seq in seqs if seq] + if not non_empty: + # Nothing left to process, we're done. + return + candidate: type[Any] | None = None + for seq in non_empty: # Find merge candidates among seq heads. + candidate = seq[0] + not_head = [s for s in non_empty if candidate in islice(s, 1, None)] + if not_head: + # Reject the candidate. + candidate = None + else: + break + if not candidate: + raise TypeError('Inconsistent hierarchy, no C3 MRO is possible') + yield candidate + for seq in non_empty: + # Remove candidate. + if seq[0] == candidate: + seq.popleft() + + seqs = [deque(mro(base)) for base in bases] + [deque(bases)] + return tuple(merge_seqs(seqs)) + + +_sentinel = object() + + +def get_attribute_from_bases(tp: type[Any] | tuple[type[Any], ...], name: str) -> Any: + """Get the attribute from the next class in the MRO that has it, + aiming to simulate calling the method on the actual class. + + The reason for iterating over the mro instead of just getting + the attribute (which would do that for us) is to support TypedDict, + which lacks a real __mro__, but can have a virtual one constructed + from its bases (as done here). + + Args: + tp: The type or class to search for the attribute. If a tuple, this is treated as a set of base classes. + name: The name of the attribute to retrieve. + + Returns: + Any: The attribute value, if found. + + Raises: + AttributeError: If the attribute is not found in any class in the MRO. + """ + if isinstance(tp, tuple): + for base in mro_for_bases(tp): + attribute = base.__dict__.get(name, _sentinel) + if attribute is not _sentinel: + attribute_get = getattr(attribute, '__get__', None) + if attribute_get is not None: + return attribute_get(None, tp) + return attribute + raise AttributeError(f'{name} not found in {tp}') + else: + try: + return getattr(tp, name) + except AttributeError: + return get_attribute_from_bases(mro(tp), name) + + +def get_attribute_from_base_dicts(tp: type[Any], name: str) -> Any: + """Get an attribute out of the `__dict__` following the MRO. + This prevents the call to `__get__` on the descriptor, and allows + us to get the original function for classmethod properties. + + Args: + tp: The type or class to search for the attribute. + name: The name of the attribute to retrieve. + + Returns: + Any: The attribute value, if found. + + Raises: + KeyError: If the attribute is not found in any class's `__dict__` in the MRO. + """ + for base in reversed(mro(tp)): + if name in base.__dict__: + return base.__dict__[name] + return tp.__dict__[name] # raise the error + + +@dataclass(**slots_true) +class DecoratorInfos: + """Mapping of name in the class namespace to decorator info. + + note that the name in the class namespace is the function or attribute name + not the field name! + """ + + validators: dict[str, Decorator[ValidatorDecoratorInfo]] = field(default_factory=dict) + field_validators: dict[str, Decorator[FieldValidatorDecoratorInfo]] = field(default_factory=dict) + root_validators: dict[str, Decorator[RootValidatorDecoratorInfo]] = field(default_factory=dict) + field_serializers: dict[str, Decorator[FieldSerializerDecoratorInfo]] = field(default_factory=dict) + model_serializers: dict[str, Decorator[ModelSerializerDecoratorInfo]] = field(default_factory=dict) + model_validators: dict[str, Decorator[ModelValidatorDecoratorInfo]] = field(default_factory=dict) + computed_fields: dict[str, Decorator[ComputedFieldInfo]] = field(default_factory=dict) + + @staticmethod + def build(model_dc: type[Any]) -> DecoratorInfos: # noqa: C901 (ignore complexity) + """We want to collect all DecFunc instances that exist as + attributes in the namespace of the class (a BaseModel or dataclass) + that called us + But we want to collect these in the order of the bases + So instead of getting them all from the leaf class (the class that called us), + we traverse the bases from root (the oldest ancestor class) to leaf + and collect all of the instances as we go, taking care to replace + any duplicate ones with the last one we see to mimic how function overriding + works with inheritance. + If we do replace any functions we put the replacement into the position + the replaced function was in; that is, we maintain the order. + """ + # reminder: dicts are ordered and replacement does not alter the order + res = DecoratorInfos() + for base in reversed(mro(model_dc)[1:]): + existing: DecoratorInfos | None = base.__dict__.get('__pydantic_decorators__') + if existing is None: + existing = DecoratorInfos.build(base) + res.validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.validators.items()}) + res.field_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.field_validators.items()}) + res.root_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.root_validators.items()}) + res.field_serializers.update({k: v.bind_to_cls(model_dc) for k, v in existing.field_serializers.items()}) + res.model_serializers.update({k: v.bind_to_cls(model_dc) for k, v in existing.model_serializers.items()}) + res.model_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.model_validators.items()}) + res.computed_fields.update({k: v.bind_to_cls(model_dc) for k, v in existing.computed_fields.items()}) + + to_replace: list[tuple[str, Any]] = [] + + for var_name, var_value in vars(model_dc).items(): + if isinstance(var_value, PydanticDescriptorProxy): + info = var_value.decorator_info + if isinstance(info, ValidatorDecoratorInfo): + res.validators[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=var_value.shim, info=info + ) + elif isinstance(info, FieldValidatorDecoratorInfo): + res.field_validators[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=var_value.shim, info=info + ) + elif isinstance(info, RootValidatorDecoratorInfo): + res.root_validators[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=var_value.shim, info=info + ) + elif isinstance(info, FieldSerializerDecoratorInfo): + # check whether a serializer function is already registered for fields + for field_serializer_decorator in res.field_serializers.values(): + # check that each field has at most one serializer function. + # serializer functions for the same field in subclasses are allowed, + # and are treated as overrides + if field_serializer_decorator.cls_var_name == var_name: + continue + for f in info.fields: + if f in field_serializer_decorator.info.fields: + raise PydanticUserError( + 'Multiple field serializer functions were defined ' + f'for field {f!r}, this is not allowed.', + code='multiple-field-serializers', + ) + res.field_serializers[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=var_value.shim, info=info + ) + elif isinstance(info, ModelValidatorDecoratorInfo): + res.model_validators[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=var_value.shim, info=info + ) + elif isinstance(info, ModelSerializerDecoratorInfo): + res.model_serializers[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=var_value.shim, info=info + ) + else: + from ..fields import ComputedFieldInfo + + isinstance(var_value, ComputedFieldInfo) + res.computed_fields[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=None, info=info + ) + to_replace.append((var_name, var_value.wrapped)) + if to_replace: + # If we can save `__pydantic_decorators__` on the class we'll be able to check for it above + # so then we don't need to re-process the type, which means we can discard our descriptor wrappers + # and replace them with the thing they are wrapping (see the other setattr call below) + # which allows validator class methods to also function as regular class methods + setattr(model_dc, '__pydantic_decorators__', res) + for name, value in to_replace: + setattr(model_dc, name, value) + return res + + +def inspect_validator(validator: Callable[..., Any], mode: FieldValidatorModes) -> bool: + """Look at a field or model validator function and determine whether it takes an info argument. + + An error is raised if the function has an invalid signature. + + Args: + validator: The validator function to inspect. + mode: The proposed validator mode. + + Returns: + Whether the validator takes an info argument. + """ + try: + sig = signature(validator) + except ValueError: + # builtins and some C extensions don't have signatures + # assume that they don't take an info argument and only take a single argument + # e.g. `str.strip` or `datetime.datetime` + return False + n_positional = count_positional_params(sig) + if mode == 'wrap': + if n_positional == 3: + return True + elif n_positional == 2: + return False + else: + assert mode in {'before', 'after', 'plain'}, f"invalid mode: {mode!r}, expected 'before', 'after' or 'plain" + if n_positional == 2: + return True + elif n_positional == 1: + return False + + raise PydanticUserError( + f'Unrecognized field_validator function signature for {validator} with `mode={mode}`:{sig}', + code='validator-signature', + ) + + +def inspect_field_serializer( + serializer: Callable[..., Any], mode: Literal['plain', 'wrap'], computed_field: bool = False +) -> tuple[bool, bool]: + """Look at a field serializer function and determine if it is a field serializer, + and whether it takes an info argument. + + An error is raised if the function has an invalid signature. + + Args: + serializer: The serializer function to inspect. + mode: The serializer mode, either 'plain' or 'wrap'. + computed_field: When serializer is applied on computed_field. It doesn't require + info signature. + + Returns: + Tuple of (is_field_serializer, info_arg). + """ + sig = signature(serializer) + + first = next(iter(sig.parameters.values()), None) + is_field_serializer = first is not None and first.name == 'self' + + n_positional = count_positional_params(sig) + if is_field_serializer: + # -1 to correct for self parameter + info_arg = _serializer_info_arg(mode, n_positional - 1) + else: + info_arg = _serializer_info_arg(mode, n_positional) + + if info_arg is None: + raise PydanticUserError( + f'Unrecognized field_serializer function signature for {serializer} with `mode={mode}`:{sig}', + code='field-serializer-signature', + ) + if info_arg and computed_field: + raise PydanticUserError( + 'field_serializer on computed_field does not use info signature', code='field-serializer-signature' + ) + + else: + return is_field_serializer, info_arg + + +def inspect_annotated_serializer(serializer: Callable[..., Any], mode: Literal['plain', 'wrap']) -> bool: + """Look at a serializer function used via `Annotated` and determine whether it takes an info argument. + + An error is raised if the function has an invalid signature. + + Args: + serializer: The serializer function to check. + mode: The serializer mode, either 'plain' or 'wrap'. + + Returns: + info_arg + """ + sig = signature(serializer) + info_arg = _serializer_info_arg(mode, count_positional_params(sig)) + if info_arg is None: + raise PydanticUserError( + f'Unrecognized field_serializer function signature for {serializer} with `mode={mode}`:{sig}', + code='field-serializer-signature', + ) + else: + return info_arg + + +def inspect_model_serializer(serializer: Callable[..., Any], mode: Literal['plain', 'wrap']) -> bool: + """Look at a model serializer function and determine whether it takes an info argument. + + An error is raised if the function has an invalid signature. + + Args: + serializer: The serializer function to check. + mode: The serializer mode, either 'plain' or 'wrap'. + + Returns: + `info_arg` - whether the function expects an info argument. + """ + if isinstance(serializer, (staticmethod, classmethod)) or not is_instance_method_from_sig(serializer): + raise PydanticUserError( + '`@model_serializer` must be applied to instance methods', code='model-serializer-instance-method' + ) + + sig = signature(serializer) + info_arg = _serializer_info_arg(mode, count_positional_params(sig)) + if info_arg is None: + raise PydanticUserError( + f'Unrecognized model_serializer function signature for {serializer} with `mode={mode}`:{sig}', + code='model-serializer-signature', + ) + else: + return info_arg + + +def _serializer_info_arg(mode: Literal['plain', 'wrap'], n_positional: int) -> bool | None: + if mode == 'plain': + if n_positional == 1: + # (__input_value: Any) -> Any + return False + elif n_positional == 2: + # (__model: Any, __input_value: Any) -> Any + return True + else: + assert mode == 'wrap', f"invalid mode: {mode!r}, expected 'plain' or 'wrap'" + if n_positional == 2: + # (__input_value: Any, __serializer: SerializerFunctionWrapHandler) -> Any + return False + elif n_positional == 3: + # (__input_value: Any, __serializer: SerializerFunctionWrapHandler, __info: SerializationInfo) -> Any + return True + + return None + + +AnyDecoratorCallable: TypeAlias = ( + 'Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any], Callable[..., Any]]' +) + + +def is_instance_method_from_sig(function: AnyDecoratorCallable) -> bool: + """Whether the function is an instance method. + + It will consider a function as instance method if the first parameter of + function is `self`. + + Args: + function: The function to check. + + Returns: + `True` if the function is an instance method, `False` otherwise. + """ + sig = signature(unwrap_wrapped_function(function)) + first = next(iter(sig.parameters.values()), None) + if first and first.name == 'self': + return True + return False + + +def ensure_classmethod_based_on_signature(function: AnyDecoratorCallable) -> Any: + """Apply the `@classmethod` decorator on the function. + + Args: + function: The function to apply the decorator on. + + Return: + The `@classmethod` decorator applied function. + """ + if not isinstance( + unwrap_wrapped_function(function, unwrap_class_static_method=False), classmethod + ) and _is_classmethod_from_sig(function): + return classmethod(function) # type: ignore[arg-type] + return function + + +def _is_classmethod_from_sig(function: AnyDecoratorCallable) -> bool: + sig = signature(unwrap_wrapped_function(function)) + first = next(iter(sig.parameters.values()), None) + if first and first.name == 'cls': + return True + return False + + +def unwrap_wrapped_function( + func: Any, + *, + unwrap_partial: bool = True, + unwrap_class_static_method: bool = True, +) -> Any: + """Recursively unwraps a wrapped function until the underlying function is reached. + This handles property, functools.partial, functools.partialmethod, staticmethod and classmethod. + + Args: + func: The function to unwrap. + unwrap_partial: If True (default), unwrap partial and partialmethod decorators, otherwise don't. + decorators. + unwrap_class_static_method: If True (default), also unwrap classmethod and staticmethod + decorators. If False, only unwrap partial and partialmethod decorators. + + Returns: + The underlying function of the wrapped function. + """ + all: set[Any] = {property, cached_property} + + if unwrap_partial: + all.update({partial, partialmethod}) + + if unwrap_class_static_method: + all.update({staticmethod, classmethod}) + + while isinstance(func, tuple(all)): + if unwrap_class_static_method and isinstance(func, (classmethod, staticmethod)): + func = func.__func__ + elif isinstance(func, (partial, partialmethod)): + func = func.func + elif isinstance(func, property): + func = func.fget # arbitrary choice, convenient for computed fields + else: + # Make coverage happy as it can only get here in the last possible case + assert isinstance(func, cached_property) + func = func.func # type: ignore + + return func + + +def get_function_return_type( + func: Any, explicit_return_type: Any, types_namespace: dict[str, Any] | None = None +) -> Any: + """Get the function return type. + + It gets the return type from the type annotation if `explicit_return_type` is `None`. + Otherwise, it returns `explicit_return_type`. + + Args: + func: The function to get its return type. + explicit_return_type: The explicit return type. + types_namespace: The types namespace, defaults to `None`. + + Returns: + The function return type. + """ + if explicit_return_type is PydanticUndefined: + # try to get it from the type annotation + hints = get_function_type_hints( + unwrap_wrapped_function(func), include_keys={'return'}, types_namespace=types_namespace + ) + return hints.get('return', PydanticUndefined) + else: + return explicit_return_type + + +def count_positional_params(sig: Signature) -> int: + return sum(1 for param in sig.parameters.values() if can_be_positional(param)) + + +def can_be_positional(param: Parameter) -> bool: + return param.kind in (Parameter.POSITIONAL_ONLY, Parameter.POSITIONAL_OR_KEYWORD) + + +def ensure_property(f: Any) -> Any: + """Ensure that a function is a `property` or `cached_property`, or is a valid descriptor. + + Args: + f: The function to check. + + Returns: + The function, or a `property` or `cached_property` instance wrapping the function. + """ + if ismethoddescriptor(f) or isdatadescriptor(f): + return f + else: + return property(f) diff --git a/lib/pydantic/_internal/_decorators_v1.py b/lib/pydantic/_internal/_decorators_v1.py new file mode 100644 index 00000000..4f81e6d4 --- /dev/null +++ b/lib/pydantic/_internal/_decorators_v1.py @@ -0,0 +1,181 @@ +"""Logic for V1 validators, e.g. `@validator` and `@root_validator`.""" +from __future__ import annotations as _annotations + +from inspect import Parameter, signature +from typing import Any, Dict, Tuple, Union, cast + +from pydantic_core import core_schema +from typing_extensions import Protocol + +from ..errors import PydanticUserError +from ._decorators import can_be_positional + + +class V1OnlyValueValidator(Protocol): + """A simple validator, supported for V1 validators and V2 validators.""" + + def __call__(self, __value: Any) -> Any: + ... + + +class V1ValidatorWithValues(Protocol): + """A validator with `values` argument, supported for V1 validators and V2 validators.""" + + def __call__(self, __value: Any, values: dict[str, Any]) -> Any: + ... + + +class V1ValidatorWithValuesKwOnly(Protocol): + """A validator with keyword only `values` argument, supported for V1 validators and V2 validators.""" + + def __call__(self, __value: Any, *, values: dict[str, Any]) -> Any: + ... + + +class V1ValidatorWithKwargs(Protocol): + """A validator with `kwargs` argument, supported for V1 validators and V2 validators.""" + + def __call__(self, __value: Any, **kwargs: Any) -> Any: + ... + + +class V1ValidatorWithValuesAndKwargs(Protocol): + """A validator with `values` and `kwargs` arguments, supported for V1 validators and V2 validators.""" + + def __call__(self, __value: Any, values: dict[str, Any], **kwargs: Any) -> Any: + ... + + +V1Validator = Union[ + V1ValidatorWithValues, V1ValidatorWithValuesKwOnly, V1ValidatorWithKwargs, V1ValidatorWithValuesAndKwargs +] + + +def can_be_keyword(param: Parameter) -> bool: + return param.kind in (Parameter.POSITIONAL_OR_KEYWORD, Parameter.KEYWORD_ONLY) + + +def make_generic_v1_field_validator(validator: V1Validator) -> core_schema.WithInfoValidatorFunction: + """Wrap a V1 style field validator for V2 compatibility. + + Args: + validator: The V1 style field validator. + + Returns: + A wrapped V2 style field validator. + + Raises: + PydanticUserError: If the signature is not supported or the parameters are + not available in Pydantic V2. + """ + sig = signature(validator) + + needs_values_kw = False + + for param_num, (param_name, parameter) in enumerate(sig.parameters.items()): + if can_be_keyword(parameter) and param_name in ('field', 'config'): + raise PydanticUserError( + 'The `field` and `config` parameters are not available in Pydantic V2, ' + 'please use the `info` parameter instead.', + code='validator-field-config-info', + ) + if parameter.kind is Parameter.VAR_KEYWORD: + needs_values_kw = True + elif can_be_keyword(parameter) and param_name == 'values': + needs_values_kw = True + elif can_be_positional(parameter) and param_num == 0: + # value + continue + elif parameter.default is Parameter.empty: # ignore params with defaults e.g. bound by functools.partial + raise PydanticUserError( + f'Unsupported signature for V1 style validator {validator}: {sig} is not supported.', + code='validator-v1-signature', + ) + + if needs_values_kw: + # (v, **kwargs), (v, values, **kwargs), (v, *, values, **kwargs) or (v, *, values) + val1 = cast(V1ValidatorWithValues, validator) + + def wrapper1(value: Any, info: core_schema.ValidationInfo) -> Any: + return val1(value, values=info.data) + + return wrapper1 + else: + val2 = cast(V1OnlyValueValidator, validator) + + def wrapper2(value: Any, _: core_schema.ValidationInfo) -> Any: + return val2(value) + + return wrapper2 + + +RootValidatorValues = Dict[str, Any] +# technically tuple[model_dict, model_extra, fields_set] | tuple[dataclass_dict, init_vars] +RootValidatorFieldsTuple = Tuple[Any, ...] + + +class V1RootValidatorFunction(Protocol): + """A simple root validator, supported for V1 validators and V2 validators.""" + + def __call__(self, __values: RootValidatorValues) -> RootValidatorValues: + ... + + +class V2CoreBeforeRootValidator(Protocol): + """V2 validator with mode='before'.""" + + def __call__(self, __values: RootValidatorValues, __info: core_schema.ValidationInfo) -> RootValidatorValues: + ... + + +class V2CoreAfterRootValidator(Protocol): + """V2 validator with mode='after'.""" + + def __call__( + self, __fields_tuple: RootValidatorFieldsTuple, __info: core_schema.ValidationInfo + ) -> RootValidatorFieldsTuple: + ... + + +def make_v1_generic_root_validator( + validator: V1RootValidatorFunction, pre: bool +) -> V2CoreBeforeRootValidator | V2CoreAfterRootValidator: + """Wrap a V1 style root validator for V2 compatibility. + + Args: + validator: The V1 style field validator. + pre: Whether the validator is a pre validator. + + Returns: + A wrapped V2 style validator. + """ + if pre is True: + # mode='before' for pydantic-core + def _wrapper1(values: RootValidatorValues, _: core_schema.ValidationInfo) -> RootValidatorValues: + return validator(values) + + return _wrapper1 + + # mode='after' for pydantic-core + def _wrapper2(fields_tuple: RootValidatorFieldsTuple, _: core_schema.ValidationInfo) -> RootValidatorFieldsTuple: + if len(fields_tuple) == 2: + # dataclass, this is easy + values, init_vars = fields_tuple + values = validator(values) + return values, init_vars + else: + # ugly hack: to match v1 behaviour, we merge values and model_extra, then split them up based on fields + # afterwards + model_dict, model_extra, fields_set = fields_tuple + if model_extra: + fields = set(model_dict.keys()) + model_dict.update(model_extra) + model_dict_new = validator(model_dict) + for k in list(model_dict_new.keys()): + if k not in fields: + model_extra[k] = model_dict_new.pop(k) + else: + model_dict_new = validator(model_dict) + return model_dict_new, model_extra, fields_set + + return _wrapper2 diff --git a/lib/pydantic/_internal/_discriminated_union.py b/lib/pydantic/_internal/_discriminated_union.py new file mode 100644 index 00000000..c40117d3 --- /dev/null +++ b/lib/pydantic/_internal/_discriminated_union.py @@ -0,0 +1,506 @@ +from __future__ import annotations as _annotations + +from typing import TYPE_CHECKING, Any, Hashable, Sequence + +from pydantic_core import CoreSchema, core_schema + +from ..errors import PydanticUserError +from . import _core_utils +from ._core_utils import ( + CoreSchemaField, + collect_definitions, + simplify_schema_references, +) + +if TYPE_CHECKING: + from ..types import Discriminator + +CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY = 'pydantic.internal.union_discriminator' + + +class MissingDefinitionForUnionRef(Exception): + """Raised when applying a discriminated union discriminator to a schema + requires a definition that is not yet defined + """ + + def __init__(self, ref: str) -> None: + self.ref = ref + super().__init__(f'Missing definition for ref {self.ref!r}') + + +def set_discriminator_in_metadata(schema: CoreSchema, discriminator: Any) -> None: + schema.setdefault('metadata', {}) + metadata = schema.get('metadata') + assert metadata is not None + metadata[CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY] = discriminator + + +def apply_discriminators(schema: core_schema.CoreSchema) -> core_schema.CoreSchema: + definitions: dict[str, CoreSchema] | None = None + + def inner(s: core_schema.CoreSchema, recurse: _core_utils.Recurse) -> core_schema.CoreSchema: + nonlocal definitions + + s = recurse(s, inner) + if s['type'] == 'tagged-union': + return s + + metadata = s.get('metadata', {}) + discriminator = metadata.pop(CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY, None) + if discriminator is not None: + if definitions is None: + definitions = collect_definitions(schema) + s = apply_discriminator(s, discriminator, definitions) + return s + + return simplify_schema_references(_core_utils.walk_core_schema(schema, inner)) + + +def apply_discriminator( + schema: core_schema.CoreSchema, + discriminator: str | Discriminator, + definitions: dict[str, core_schema.CoreSchema] | None = None, +) -> core_schema.CoreSchema: + """Applies the discriminator and returns a new core schema. + + Args: + schema: The input schema. + discriminator: The name of the field which will serve as the discriminator. + definitions: A mapping of schema ref to schema. + + Returns: + The new core schema. + + Raises: + TypeError: + - If `discriminator` is used with invalid union variant. + - If `discriminator` is used with `Union` type with one variant. + - If `discriminator` value mapped to multiple choices. + MissingDefinitionForUnionRef: + If the definition for ref is missing. + PydanticUserError: + - If a model in union doesn't have a discriminator field. + - If discriminator field has a non-string alias. + - If discriminator fields have different aliases. + - If discriminator field not of type `Literal`. + """ + from ..types import Discriminator + + if isinstance(discriminator, Discriminator): + if isinstance(discriminator.discriminator, str): + discriminator = discriminator.discriminator + else: + return discriminator._convert_schema(schema) + + return _ApplyInferredDiscriminator(discriminator, definitions or {}).apply(schema) + + +class _ApplyInferredDiscriminator: + """This class is used to convert an input schema containing a union schema into one where that union is + replaced with a tagged-union, with all the associated debugging and performance benefits. + + This is done by: + * Validating that the input schema is compatible with the provided discriminator + * Introspecting the schema to determine which discriminator values should map to which union choices + * Handling various edge cases such as 'definitions', 'default', 'nullable' schemas, and more + + I have chosen to implement the conversion algorithm in this class, rather than a function, + to make it easier to maintain state while recursively walking the provided CoreSchema. + """ + + def __init__(self, discriminator: str, definitions: dict[str, core_schema.CoreSchema]): + # `discriminator` should be the name of the field which will serve as the discriminator. + # It must be the python name of the field, and *not* the field's alias. Note that as of now, + # all members of a discriminated union _must_ use a field with the same name as the discriminator. + # This may change if/when we expose a way to manually specify the TaggedUnionSchema's choices. + self.discriminator = discriminator + + # `definitions` should contain a mapping of schema ref to schema for all schemas which might + # be referenced by some choice + self.definitions = definitions + + # `_discriminator_alias` will hold the value, if present, of the alias for the discriminator + # + # Note: following the v1 implementation, we currently disallow the use of different aliases + # for different choices. This is not a limitation of pydantic_core, but if we try to handle + # this, the inference logic gets complicated very quickly, and could result in confusing + # debugging challenges for users making subtle mistakes. + # + # Rather than trying to do the most powerful inference possible, I think we should eventually + # expose a way to more-manually control the way the TaggedUnionSchema is constructed through + # the use of a new type which would be placed as an Annotation on the Union type. This would + # provide the full flexibility/power of pydantic_core's TaggedUnionSchema where necessary for + # more complex cases, without over-complicating the inference logic for the common cases. + self._discriminator_alias: str | None = None + + # `_should_be_nullable` indicates whether the converted union has `None` as an allowed value. + # If `None` is an acceptable value of the (possibly-wrapped) union, we ignore it while + # constructing the TaggedUnionSchema, but set the `_should_be_nullable` attribute to True. + # Once we have constructed the TaggedUnionSchema, if `_should_be_nullable` is True, we ensure + # that the final schema gets wrapped as a NullableSchema. This has the same semantics on the + # python side, but resolves the issue that `None` cannot correspond to any discriminator values. + self._should_be_nullable = False + + # `_is_nullable` is used to track if the final produced schema will definitely be nullable; + # we set it to True if the input schema is wrapped in a nullable schema that we know will be preserved + # as an indication that, even if None is discovered as one of the union choices, we will not need to wrap + # the final value in another nullable schema. + # + # This is more complicated than just checking for the final outermost schema having type 'nullable' thanks + # to the possible presence of other wrapper schemas such as DefinitionsSchema, WithDefaultSchema, etc. + self._is_nullable = False + + # `_choices_to_handle` serves as a stack of choices to add to the tagged union. Initially, choices + # from the union in the wrapped schema will be appended to this list, and the recursive choice-handling + # algorithm may add more choices to this stack as (nested) unions are encountered. + self._choices_to_handle: list[core_schema.CoreSchema] = [] + + # `_tagged_union_choices` is built during the call to `apply`, and will hold the choices to be included + # in the output TaggedUnionSchema that will replace the union from the input schema + self._tagged_union_choices: dict[Hashable, core_schema.CoreSchema] = {} + + # `_used` is changed to True after applying the discriminator to prevent accidental re-use + self._used = False + + def apply(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema: + """Return a new CoreSchema based on `schema` that uses a tagged-union with the discriminator provided + to this class. + + Args: + schema: The input schema. + + Returns: + The new core schema. + + Raises: + TypeError: + - If `discriminator` is used with invalid union variant. + - If `discriminator` is used with `Union` type with one variant. + - If `discriminator` value mapped to multiple choices. + ValueError: + If the definition for ref is missing. + PydanticUserError: + - If a model in union doesn't have a discriminator field. + - If discriminator field has a non-string alias. + - If discriminator fields have different aliases. + - If discriminator field not of type `Literal`. + """ + self.definitions.update(collect_definitions(schema)) + assert not self._used + schema = self._apply_to_root(schema) + if self._should_be_nullable and not self._is_nullable: + schema = core_schema.nullable_schema(schema) + self._used = True + new_defs = collect_definitions(schema) + missing_defs = self.definitions.keys() - new_defs.keys() + if missing_defs: + schema = core_schema.definitions_schema(schema, [self.definitions[ref] for ref in missing_defs]) + return schema + + def _apply_to_root(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema: + """This method handles the outer-most stage of recursion over the input schema: + unwrapping nullable or definitions schemas, and calling the `_handle_choice` + method iteratively on the choices extracted (recursively) from the possibly-wrapped union. + """ + if schema['type'] == 'nullable': + self._is_nullable = True + wrapped = self._apply_to_root(schema['schema']) + nullable_wrapper = schema.copy() + nullable_wrapper['schema'] = wrapped + return nullable_wrapper + + if schema['type'] == 'definitions': + wrapped = self._apply_to_root(schema['schema']) + definitions_wrapper = schema.copy() + definitions_wrapper['schema'] = wrapped + return definitions_wrapper + + if schema['type'] != 'union': + # If the schema is not a union, it probably means it just had a single member and + # was flattened by pydantic_core. + # However, it still may make sense to apply the discriminator to this schema, + # as a way to get discriminated-union-style error messages, so we allow this here. + schema = core_schema.union_schema([schema]) + + # Reverse the choices list before extending the stack so that they get handled in the order they occur + choices_schemas = [v[0] if isinstance(v, tuple) else v for v in schema['choices'][::-1]] + self._choices_to_handle.extend(choices_schemas) + while self._choices_to_handle: + choice = self._choices_to_handle.pop() + self._handle_choice(choice) + + if self._discriminator_alias is not None and self._discriminator_alias != self.discriminator: + # * We need to annotate `discriminator` as a union here to handle both branches of this conditional + # * We need to annotate `discriminator` as list[list[str | int]] and not list[list[str]] due to the + # invariance of list, and because list[list[str | int]] is the type of the discriminator argument + # to tagged_union_schema below + # * See the docstring of pydantic_core.core_schema.tagged_union_schema for more details about how to + # interpret the value of the discriminator argument to tagged_union_schema. (The list[list[str]] here + # is the appropriate way to provide a list of fallback attributes to check for a discriminator value.) + discriminator: str | list[list[str | int]] = [[self.discriminator], [self._discriminator_alias]] + else: + discriminator = self.discriminator + return core_schema.tagged_union_schema( + choices=self._tagged_union_choices, + discriminator=discriminator, + custom_error_type=schema.get('custom_error_type'), + custom_error_message=schema.get('custom_error_message'), + custom_error_context=schema.get('custom_error_context'), + strict=False, + from_attributes=True, + ref=schema.get('ref'), + metadata=schema.get('metadata'), + serialization=schema.get('serialization'), + ) + + def _handle_choice(self, choice: core_schema.CoreSchema) -> None: + """This method handles the "middle" stage of recursion over the input schema. + Specifically, it is responsible for handling each choice of the outermost union + (and any "coalesced" choices obtained from inner unions). + + Here, "handling" entails: + * Coalescing nested unions and compatible tagged-unions + * Tracking the presence of 'none' and 'nullable' schemas occurring as choices + * Validating that each allowed discriminator value maps to a unique choice + * Updating the _tagged_union_choices mapping that will ultimately be used to build the TaggedUnionSchema. + """ + if choice['type'] == 'definition-ref': + if choice['schema_ref'] not in self.definitions: + raise MissingDefinitionForUnionRef(choice['schema_ref']) + + if choice['type'] == 'none': + self._should_be_nullable = True + elif choice['type'] == 'definitions': + self._handle_choice(choice['schema']) + elif choice['type'] == 'nullable': + self._should_be_nullable = True + self._handle_choice(choice['schema']) # unwrap the nullable schema + elif choice['type'] == 'union': + # Reverse the choices list before extending the stack so that they get handled in the order they occur + choices_schemas = [v[0] if isinstance(v, tuple) else v for v in choice['choices'][::-1]] + self._choices_to_handle.extend(choices_schemas) + elif choice['type'] not in { + 'model', + 'typed-dict', + 'tagged-union', + 'lax-or-strict', + 'dataclass', + 'dataclass-args', + 'definition-ref', + } and not _core_utils.is_function_with_inner_schema(choice): + # We should eventually handle 'definition-ref' as well + raise TypeError( + f'{choice["type"]!r} is not a valid discriminated union variant;' + ' should be a `BaseModel` or `dataclass`' + ) + else: + if choice['type'] == 'tagged-union' and self._is_discriminator_shared(choice): + # In this case, this inner tagged-union is compatible with the outer tagged-union, + # and its choices can be coalesced into the outer TaggedUnionSchema. + subchoices = [x for x in choice['choices'].values() if not isinstance(x, (str, int))] + # Reverse the choices list before extending the stack so that they get handled in the order they occur + self._choices_to_handle.extend(subchoices[::-1]) + return + + inferred_discriminator_values = self._infer_discriminator_values_for_choice(choice, source_name=None) + self._set_unique_choice_for_values(choice, inferred_discriminator_values) + + def _is_discriminator_shared(self, choice: core_schema.TaggedUnionSchema) -> bool: + """This method returns a boolean indicating whether the discriminator for the `choice` + is the same as that being used for the outermost tagged union. This is used to + determine whether this TaggedUnionSchema choice should be "coalesced" into the top level, + or whether it should be treated as a separate (nested) choice. + """ + inner_discriminator = choice['discriminator'] + return inner_discriminator == self.discriminator or ( + isinstance(inner_discriminator, list) + and (self.discriminator in inner_discriminator or [self.discriminator] in inner_discriminator) + ) + + def _infer_discriminator_values_for_choice( # noqa C901 + self, choice: core_schema.CoreSchema, source_name: str | None + ) -> list[str | int]: + """This function recurses over `choice`, extracting all discriminator values that should map to this choice. + + `model_name` is accepted for the purpose of producing useful error messages. + """ + if choice['type'] == 'definitions': + return self._infer_discriminator_values_for_choice(choice['schema'], source_name=source_name) + elif choice['type'] == 'function-plain': + raise TypeError( + f'{choice["type"]!r} is not a valid discriminated union variant;' + ' should be a `BaseModel` or `dataclass`' + ) + elif _core_utils.is_function_with_inner_schema(choice): + return self._infer_discriminator_values_for_choice(choice['schema'], source_name=source_name) + elif choice['type'] == 'lax-or-strict': + return sorted( + set( + self._infer_discriminator_values_for_choice(choice['lax_schema'], source_name=None) + + self._infer_discriminator_values_for_choice(choice['strict_schema'], source_name=None) + ) + ) + + elif choice['type'] == 'tagged-union': + values: list[str | int] = [] + # Ignore str/int "choices" since these are just references to other choices + subchoices = [x for x in choice['choices'].values() if not isinstance(x, (str, int))] + for subchoice in subchoices: + subchoice_values = self._infer_discriminator_values_for_choice(subchoice, source_name=None) + values.extend(subchoice_values) + return values + + elif choice['type'] == 'union': + values = [] + for subchoice in choice['choices']: + subchoice_schema = subchoice[0] if isinstance(subchoice, tuple) else subchoice + subchoice_values = self._infer_discriminator_values_for_choice(subchoice_schema, source_name=None) + values.extend(subchoice_values) + return values + + elif choice['type'] == 'nullable': + self._should_be_nullable = True + return self._infer_discriminator_values_for_choice(choice['schema'], source_name=None) + + elif choice['type'] == 'model': + return self._infer_discriminator_values_for_choice(choice['schema'], source_name=choice['cls'].__name__) + + elif choice['type'] == 'dataclass': + return self._infer_discriminator_values_for_choice(choice['schema'], source_name=choice['cls'].__name__) + + elif choice['type'] == 'model-fields': + return self._infer_discriminator_values_for_model_choice(choice, source_name=source_name) + + elif choice['type'] == 'dataclass-args': + return self._infer_discriminator_values_for_dataclass_choice(choice, source_name=source_name) + + elif choice['type'] == 'typed-dict': + return self._infer_discriminator_values_for_typed_dict_choice(choice, source_name=source_name) + + elif choice['type'] == 'definition-ref': + schema_ref = choice['schema_ref'] + if schema_ref not in self.definitions: + raise MissingDefinitionForUnionRef(schema_ref) + return self._infer_discriminator_values_for_choice(self.definitions[schema_ref], source_name=source_name) + else: + raise TypeError( + f'{choice["type"]!r} is not a valid discriminated union variant;' + ' should be a `BaseModel` or `dataclass`' + ) + + def _infer_discriminator_values_for_typed_dict_choice( + self, choice: core_schema.TypedDictSchema, source_name: str | None = None + ) -> list[str | int]: + """This method just extracts the _infer_discriminator_values_for_choice logic specific to TypedDictSchema + for the sake of readability. + """ + source = 'TypedDict' if source_name is None else f'TypedDict {source_name!r}' + field = choice['fields'].get(self.discriminator) + if field is None: + raise PydanticUserError( + f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field' + ) + return self._infer_discriminator_values_for_field(field, source) + + def _infer_discriminator_values_for_model_choice( + self, choice: core_schema.ModelFieldsSchema, source_name: str | None = None + ) -> list[str | int]: + source = 'ModelFields' if source_name is None else f'Model {source_name!r}' + field = choice['fields'].get(self.discriminator) + if field is None: + raise PydanticUserError( + f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field' + ) + return self._infer_discriminator_values_for_field(field, source) + + def _infer_discriminator_values_for_dataclass_choice( + self, choice: core_schema.DataclassArgsSchema, source_name: str | None = None + ) -> list[str | int]: + source = 'DataclassArgs' if source_name is None else f'Dataclass {source_name!r}' + for field in choice['fields']: + if field['name'] == self.discriminator: + break + else: + raise PydanticUserError( + f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field' + ) + return self._infer_discriminator_values_for_field(field, source) + + def _infer_discriminator_values_for_field(self, field: CoreSchemaField, source: str) -> list[str | int]: + if field['type'] == 'computed-field': + # This should never occur as a discriminator, as it is only relevant to serialization + return [] + alias = field.get('validation_alias', self.discriminator) + if not isinstance(alias, str): + raise PydanticUserError( + f'Alias {alias!r} is not supported in a discriminated union', code='discriminator-alias-type' + ) + if self._discriminator_alias is None: + self._discriminator_alias = alias + elif self._discriminator_alias != alias: + raise PydanticUserError( + f'Aliases for discriminator {self.discriminator!r} must be the same ' + f'(got {alias}, {self._discriminator_alias})', + code='discriminator-alias', + ) + return self._infer_discriminator_values_for_inner_schema(field['schema'], source) + + def _infer_discriminator_values_for_inner_schema( + self, schema: core_schema.CoreSchema, source: str + ) -> list[str | int]: + """When inferring discriminator values for a field, we typically extract the expected values from a literal + schema. This function does that, but also handles nested unions and defaults. + """ + if schema['type'] == 'literal': + return schema['expected'] + + elif schema['type'] == 'union': + # Generally when multiple values are allowed they should be placed in a single `Literal`, but + # we add this case to handle the situation where a field is annotated as a `Union` of `Literal`s. + # For example, this lets us handle `Union[Literal['key'], Union[Literal['Key'], Literal['KEY']]]` + values: list[Any] = [] + for choice in schema['choices']: + choice_schema = choice[0] if isinstance(choice, tuple) else choice + choice_values = self._infer_discriminator_values_for_inner_schema(choice_schema, source) + values.extend(choice_values) + return values + + elif schema['type'] == 'default': + # This will happen if the field has a default value; we ignore it while extracting the discriminator values + return self._infer_discriminator_values_for_inner_schema(schema['schema'], source) + + elif schema['type'] == 'function-after': + # After validators don't affect the discriminator values + return self._infer_discriminator_values_for_inner_schema(schema['schema'], source) + + elif schema['type'] in {'function-before', 'function-wrap', 'function-plain'}: + validator_type = repr(schema['type'].split('-')[1]) + raise PydanticUserError( + f'Cannot use a mode={validator_type} validator in the' + f' discriminator field {self.discriminator!r} of {source}', + code='discriminator-validator', + ) + + else: + raise PydanticUserError( + f'{source} needs field {self.discriminator!r} to be of type `Literal`', + code='discriminator-needs-literal', + ) + + def _set_unique_choice_for_values(self, choice: core_schema.CoreSchema, values: Sequence[str | int]) -> None: + """This method updates `self.tagged_union_choices` so that all provided (discriminator) `values` map to the + provided `choice`, validating that none of these values already map to another (different) choice. + """ + for discriminator_value in values: + if discriminator_value in self._tagged_union_choices: + # It is okay if `value` is already in tagged_union_choices as long as it maps to the same value. + # Because tagged_union_choices may map values to other values, we need to walk the choices dict + # until we get to a "real" choice, and confirm that is equal to the one assigned. + existing_choice = self._tagged_union_choices[discriminator_value] + if existing_choice != choice: + raise TypeError( + f'Value {discriminator_value!r} for discriminator ' + f'{self.discriminator!r} mapped to multiple choices' + ) + else: + self._tagged_union_choices[discriminator_value] = choice diff --git a/lib/pydantic/_internal/_fields.py b/lib/pydantic/_internal/_fields.py new file mode 100644 index 00000000..94de3062 --- /dev/null +++ b/lib/pydantic/_internal/_fields.py @@ -0,0 +1,319 @@ +"""Private logic related to fields (the `Field()` function and `FieldInfo` class), and arguments to `Annotated`.""" +from __future__ import annotations as _annotations + +import dataclasses +import sys +import warnings +from copy import copy +from functools import lru_cache +from typing import TYPE_CHECKING, Any + +from pydantic_core import PydanticUndefined + +from pydantic.errors import PydanticUserError + +from . import _typing_extra +from ._config import ConfigWrapper +from ._repr import Representation +from ._typing_extra import get_cls_type_hints_lenient, get_type_hints, is_classvar, is_finalvar + +if TYPE_CHECKING: + from annotated_types import BaseMetadata + + from ..fields import FieldInfo + from ..main import BaseModel + from ._dataclasses import StandardDataclass + from ._decorators import DecoratorInfos + + +def get_type_hints_infer_globalns( + obj: Any, + localns: dict[str, Any] | None = None, + include_extras: bool = False, +) -> dict[str, Any]: + """Gets type hints for an object by inferring the global namespace. + + It uses the `typing.get_type_hints`, The only thing that we do here is fetching + global namespace from `obj.__module__` if it is not `None`. + + Args: + obj: The object to get its type hints. + localns: The local namespaces. + include_extras: Whether to recursively include annotation metadata. + + Returns: + The object type hints. + """ + module_name = getattr(obj, '__module__', None) + globalns: dict[str, Any] | None = None + if module_name: + try: + globalns = sys.modules[module_name].__dict__ + except KeyError: + # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363 + pass + return get_type_hints(obj, globalns=globalns, localns=localns, include_extras=include_extras) + + +class PydanticMetadata(Representation): + """Base class for annotation markers like `Strict`.""" + + __slots__ = () + + +def pydantic_general_metadata(**metadata: Any) -> BaseMetadata: + """Create a new `_PydanticGeneralMetadata` class with the given metadata. + + Args: + **metadata: The metadata to add. + + Returns: + The new `_PydanticGeneralMetadata` class. + """ + return _general_metadata_cls()(metadata) # type: ignore + + +@lru_cache(maxsize=None) +def _general_metadata_cls() -> type[BaseMetadata]: + """Do it this way to avoid importing `annotated_types` at import time.""" + from annotated_types import BaseMetadata + + class _PydanticGeneralMetadata(PydanticMetadata, BaseMetadata): + """Pydantic general metadata like `max_digits`.""" + + def __init__(self, metadata: Any): + self.__dict__ = metadata + + return _PydanticGeneralMetadata # type: ignore + + +def collect_model_fields( # noqa: C901 + cls: type[BaseModel], + bases: tuple[type[Any], ...], + config_wrapper: ConfigWrapper, + types_namespace: dict[str, Any] | None, + *, + typevars_map: dict[Any, Any] | None = None, +) -> tuple[dict[str, FieldInfo], set[str]]: + """Collect the fields of a nascent pydantic model. + + Also collect the names of any ClassVars present in the type hints. + + The returned value is a tuple of two items: the fields dict, and the set of ClassVar names. + + Args: + cls: BaseModel or dataclass. + bases: Parents of the class, generally `cls.__bases__`. + config_wrapper: The config wrapper instance. + types_namespace: Optional extra namespace to look for types in. + typevars_map: A dictionary mapping type variables to their concrete types. + + Returns: + A tuple contains fields and class variables. + + Raises: + NameError: + - If there is a conflict between a field name and protected namespaces. + - If there is a field other than `root` in `RootModel`. + - If a field shadows an attribute in the parent model. + """ + from ..fields import FieldInfo + + type_hints = get_cls_type_hints_lenient(cls, types_namespace) + + # https://docs.python.org/3/howto/annotations.html#accessing-the-annotations-dict-of-an-object-in-python-3-9-and-older + # annotations is only used for finding fields in parent classes + annotations = cls.__dict__.get('__annotations__', {}) + fields: dict[str, FieldInfo] = {} + + class_vars: set[str] = set() + for ann_name, ann_type in type_hints.items(): + if ann_name == 'model_config': + # We never want to treat `model_config` as a field + # Note: we may need to change this logic if/when we introduce a `BareModel` class with no + # protected namespaces (where `model_config` might be allowed as a field name) + continue + for protected_namespace in config_wrapper.protected_namespaces: + if ann_name.startswith(protected_namespace): + for b in bases: + if hasattr(b, ann_name): + from ..main import BaseModel + + if not (issubclass(b, BaseModel) and ann_name in b.model_fields): + raise NameError( + f'Field "{ann_name}" conflicts with member {getattr(b, ann_name)}' + f' of protected namespace "{protected_namespace}".' + ) + else: + valid_namespaces = tuple( + x for x in config_wrapper.protected_namespaces if not ann_name.startswith(x) + ) + warnings.warn( + f'Field "{ann_name}" has conflict with protected namespace "{protected_namespace}".' + '\n\nYou may be able to resolve this warning by setting' + f" `model_config['protected_namespaces'] = {valid_namespaces}`.", + UserWarning, + ) + if is_classvar(ann_type): + class_vars.add(ann_name) + continue + if _is_finalvar_with_default_val(ann_type, getattr(cls, ann_name, PydanticUndefined)): + class_vars.add(ann_name) + continue + if not is_valid_field_name(ann_name): + continue + if cls.__pydantic_root_model__ and ann_name != 'root': + raise NameError( + f"Unexpected field with name {ann_name!r}; only 'root' is allowed as a field of a `RootModel`" + ) + + # when building a generic model with `MyModel[int]`, the generic_origin check makes sure we don't get + # "... shadows an attribute" errors + generic_origin = getattr(cls, '__pydantic_generic_metadata__', {}).get('origin') + for base in bases: + dataclass_fields = { + field.name for field in (dataclasses.fields(base) if dataclasses.is_dataclass(base) else ()) + } + if hasattr(base, ann_name): + if base is generic_origin: + # Don't error when "shadowing" of attributes in parametrized generics + continue + + if ann_name in dataclass_fields: + # Don't error when inheriting stdlib dataclasses whose fields are "shadowed" by defaults being set + # on the class instance. + continue + warnings.warn( + f'Field name "{ann_name}" shadows an attribute in parent "{base.__qualname__}"; ', + UserWarning, + ) + + try: + default = getattr(cls, ann_name, PydanticUndefined) + if default is PydanticUndefined: + raise AttributeError + except AttributeError: + if ann_name in annotations: + field_info = FieldInfo.from_annotation(ann_type) + else: + # if field has no default value and is not in __annotations__ this means that it is + # defined in a base class and we can take it from there + model_fields_lookup: dict[str, FieldInfo] = {} + for x in cls.__bases__[::-1]: + model_fields_lookup.update(getattr(x, 'model_fields', {})) + if ann_name in model_fields_lookup: + # The field was present on one of the (possibly multiple) base classes + # copy the field to make sure typevar substitutions don't cause issues with the base classes + field_info = copy(model_fields_lookup[ann_name]) + else: + # The field was not found on any base classes; this seems to be caused by fields not getting + # generated thanks to models not being fully defined while initializing recursive models. + # Nothing stops us from just creating a new FieldInfo for this type hint, so we do this. + field_info = FieldInfo.from_annotation(ann_type) + else: + field_info = FieldInfo.from_annotated_attribute(ann_type, default) + # attributes which are fields are removed from the class namespace: + # 1. To match the behaviour of annotation-only fields + # 2. To avoid false positives in the NameError check above + try: + delattr(cls, ann_name) + except AttributeError: + pass # indicates the attribute was on a parent class + + # Use cls.__dict__['__pydantic_decorators__'] instead of cls.__pydantic_decorators__ + # to make sure the decorators have already been built for this exact class + decorators: DecoratorInfos = cls.__dict__['__pydantic_decorators__'] + if ann_name in decorators.computed_fields: + raise ValueError("you can't override a field with a computed field") + fields[ann_name] = field_info + + if typevars_map: + for field in fields.values(): + field.apply_typevars_map(typevars_map, types_namespace) + + return fields, class_vars + + +def _is_finalvar_with_default_val(type_: type[Any], val: Any) -> bool: + from ..fields import FieldInfo + + if not is_finalvar(type_): + return False + elif val is PydanticUndefined: + return False + elif isinstance(val, FieldInfo) and (val.default is PydanticUndefined and val.default_factory is None): + return False + else: + return True + + +def collect_dataclass_fields( + cls: type[StandardDataclass], types_namespace: dict[str, Any] | None, *, typevars_map: dict[Any, Any] | None = None +) -> dict[str, FieldInfo]: + """Collect the fields of a dataclass. + + Args: + cls: dataclass. + types_namespace: Optional extra namespace to look for types in. + typevars_map: A dictionary mapping type variables to their concrete types. + + Returns: + The dataclass fields. + """ + from ..fields import FieldInfo + + fields: dict[str, FieldInfo] = {} + dataclass_fields: dict[str, dataclasses.Field] = cls.__dataclass_fields__ + cls_localns = dict(vars(cls)) # this matches get_cls_type_hints_lenient, but all tests pass with `= None` instead + + source_module = sys.modules.get(cls.__module__) + if source_module is not None: + types_namespace = {**source_module.__dict__, **(types_namespace or {})} + + for ann_name, dataclass_field in dataclass_fields.items(): + ann_type = _typing_extra.eval_type_lenient(dataclass_field.type, types_namespace, cls_localns) + if is_classvar(ann_type): + continue + + if ( + not dataclass_field.init + and dataclass_field.default == dataclasses.MISSING + and dataclass_field.default_factory == dataclasses.MISSING + ): + # TODO: We should probably do something with this so that validate_assignment behaves properly + # Issue: https://github.com/pydantic/pydantic/issues/5470 + continue + + if isinstance(dataclass_field.default, FieldInfo): + if dataclass_field.default.init_var: + if dataclass_field.default.init is False: + raise PydanticUserError( + f'Dataclass field {ann_name} has init=False and init_var=True, but these are mutually exclusive.', + code='clashing-init-and-init-var', + ) + + # TODO: same note as above re validate_assignment + continue + field_info = FieldInfo.from_annotated_attribute(ann_type, dataclass_field.default) + else: + field_info = FieldInfo.from_annotated_attribute(ann_type, dataclass_field) + + fields[ann_name] = field_info + + if field_info.default is not PydanticUndefined and isinstance(getattr(cls, ann_name, field_info), FieldInfo): + # We need this to fix the default when the "default" from __dataclass_fields__ is a pydantic.FieldInfo + setattr(cls, ann_name, field_info.default) + + if typevars_map: + for field in fields.values(): + field.apply_typevars_map(typevars_map, types_namespace) + + return fields + + +def is_valid_field_name(name: str) -> bool: + return not name.startswith('_') + + +def is_valid_privateattr_name(name: str) -> bool: + return name.startswith('_') and not name.startswith('__') diff --git a/lib/pydantic/_internal/_forward_ref.py b/lib/pydantic/_internal/_forward_ref.py new file mode 100644 index 00000000..231f81d1 --- /dev/null +++ b/lib/pydantic/_internal/_forward_ref.py @@ -0,0 +1,23 @@ +from __future__ import annotations as _annotations + +from dataclasses import dataclass +from typing import Union + + +@dataclass +class PydanticRecursiveRef: + type_ref: str + + __name__ = 'PydanticRecursiveRef' + __hash__ = object.__hash__ + + def __call__(self) -> None: + """Defining __call__ is necessary for the `typing` module to let you use an instance of + this class as the result of resolving a standard ForwardRef. + """ + + def __or__(self, other): + return Union[self, other] # type: ignore + + def __ror__(self, other): + return Union[other, self] # type: ignore diff --git a/lib/pydantic/_internal/_generate_schema.py b/lib/pydantic/_internal/_generate_schema.py new file mode 100644 index 00000000..6ab7ec19 --- /dev/null +++ b/lib/pydantic/_internal/_generate_schema.py @@ -0,0 +1,2231 @@ +"""Convert python types to pydantic-core schema.""" +from __future__ import annotations as _annotations + +import collections.abc +import dataclasses +import inspect +import re +import sys +import typing +import warnings +from contextlib import contextmanager +from copy import copy, deepcopy +from enum import Enum +from functools import partial +from inspect import Parameter, _ParameterKind, signature +from itertools import chain +from operator import attrgetter +from types import FunctionType, LambdaType, MethodType +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + Final, + ForwardRef, + Iterable, + Iterator, + Mapping, + Type, + TypeVar, + Union, + cast, + overload, +) +from warnings import warn + +from pydantic_core import CoreSchema, PydanticUndefined, core_schema, to_jsonable_python +from typing_extensions import Annotated, Literal, TypeAliasType, TypedDict, get_args, get_origin, is_typeddict + +from ..aliases import AliasGenerator +from ..annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler +from ..config import ConfigDict, JsonDict, JsonEncoder +from ..errors import PydanticSchemaGenerationError, PydanticUndefinedAnnotation, PydanticUserError +from ..json_schema import JsonSchemaValue +from ..version import version_short +from ..warnings import PydanticDeprecatedSince20 +from . import _core_utils, _decorators, _discriminated_union, _known_annotated_metadata, _typing_extra +from ._config import ConfigWrapper, ConfigWrapperStack +from ._core_metadata import CoreMetadataHandler, build_metadata_dict +from ._core_utils import ( + CoreSchemaOrField, + collect_invalid_schemas, + define_expected_missing_refs, + get_ref, + get_type_ref, + is_function_with_inner_schema, + is_list_like_schema_with_items_schema, + simplify_schema_references, + validate_core_schema, +) +from ._decorators import ( + Decorator, + DecoratorInfos, + FieldSerializerDecoratorInfo, + FieldValidatorDecoratorInfo, + ModelSerializerDecoratorInfo, + ModelValidatorDecoratorInfo, + RootValidatorDecoratorInfo, + ValidatorDecoratorInfo, + get_attribute_from_bases, + inspect_field_serializer, + inspect_model_serializer, + inspect_validator, +) +from ._fields import collect_dataclass_fields, get_type_hints_infer_globalns +from ._forward_ref import PydanticRecursiveRef +from ._generics import get_standard_typevars_map, has_instance_in_type, recursively_defined_type_refs, replace_types +from ._schema_generation_shared import ( + CallbackGetCoreSchemaHandler, +) +from ._typing_extra import is_finalvar +from ._utils import lenient_issubclass + +if TYPE_CHECKING: + from ..fields import ComputedFieldInfo, FieldInfo + from ..main import BaseModel + from ..types import Discriminator + from ..validators import FieldValidatorModes + from ._dataclasses import StandardDataclass + from ._schema_generation_shared import GetJsonSchemaFunction + +_SUPPORTS_TYPEDDICT = sys.version_info >= (3, 12) +_AnnotatedType = type(Annotated[int, 123]) + +FieldDecoratorInfo = Union[ValidatorDecoratorInfo, FieldValidatorDecoratorInfo, FieldSerializerDecoratorInfo] +FieldDecoratorInfoType = TypeVar('FieldDecoratorInfoType', bound=FieldDecoratorInfo) +AnyFieldDecorator = Union[ + Decorator[ValidatorDecoratorInfo], + Decorator[FieldValidatorDecoratorInfo], + Decorator[FieldSerializerDecoratorInfo], +] + +ModifyCoreSchemaWrapHandler = GetCoreSchemaHandler +GetCoreSchemaFunction = Callable[[Any, ModifyCoreSchemaWrapHandler], core_schema.CoreSchema] + + +TUPLE_TYPES: list[type] = [tuple, typing.Tuple] +LIST_TYPES: list[type] = [list, typing.List, collections.abc.MutableSequence] +SET_TYPES: list[type] = [set, typing.Set, collections.abc.MutableSet] +FROZEN_SET_TYPES: list[type] = [frozenset, typing.FrozenSet, collections.abc.Set] +DICT_TYPES: list[type] = [dict, typing.Dict, collections.abc.MutableMapping, collections.abc.Mapping] + + +def check_validator_fields_against_field_name( + info: FieldDecoratorInfo, + field: str, +) -> bool: + """Check if field name is in validator fields. + + Args: + info: The field info. + field: The field name to check. + + Returns: + `True` if field name is in validator fields, `False` otherwise. + """ + if isinstance(info, (ValidatorDecoratorInfo, FieldValidatorDecoratorInfo)): + if '*' in info.fields: + return True + for v_field_name in info.fields: + if v_field_name == field: + return True + return False + + +def check_decorator_fields_exist(decorators: Iterable[AnyFieldDecorator], fields: Iterable[str]) -> None: + """Check if the defined fields in decorators exist in `fields` param. + + It ignores the check for a decorator if the decorator has `*` as field or `check_fields=False`. + + Args: + decorators: An iterable of decorators. + fields: An iterable of fields name. + + Raises: + PydanticUserError: If one of the field names does not exist in `fields` param. + """ + fields = set(fields) + for dec in decorators: + if isinstance(dec.info, (ValidatorDecoratorInfo, FieldValidatorDecoratorInfo)) and '*' in dec.info.fields: + continue + if dec.info.check_fields is False: + continue + for field in dec.info.fields: + if field not in fields: + raise PydanticUserError( + f'Decorators defined with incorrect fields: {dec.cls_ref}.{dec.cls_var_name}' + " (use check_fields=False if you're inheriting from the model and intended this)", + code='decorator-missing-field', + ) + + +def filter_field_decorator_info_by_field( + validator_functions: Iterable[Decorator[FieldDecoratorInfoType]], field: str +) -> list[Decorator[FieldDecoratorInfoType]]: + return [dec for dec in validator_functions if check_validator_fields_against_field_name(dec.info, field)] + + +def apply_each_item_validators( + schema: core_schema.CoreSchema, + each_item_validators: list[Decorator[ValidatorDecoratorInfo]], + field_name: str | None, +) -> core_schema.CoreSchema: + # This V1 compatibility shim should eventually be removed + + # push down any `each_item=True` validators + # note that this won't work for any Annotated types that get wrapped by a function validator + # but that's okay because that didn't exist in V1 + if schema['type'] == 'nullable': + schema['schema'] = apply_each_item_validators(schema['schema'], each_item_validators, field_name) + return schema + elif schema['type'] == 'tuple': + if (variadic_item_index := schema.get('variadic_item_index')) is not None: + schema['items_schema'][variadic_item_index] = apply_validators( + schema['items_schema'][variadic_item_index], each_item_validators, field_name + ) + elif is_list_like_schema_with_items_schema(schema): + inner_schema = schema.get('items_schema', None) + if inner_schema is None: + inner_schema = core_schema.any_schema() + schema['items_schema'] = apply_validators(inner_schema, each_item_validators, field_name) + elif schema['type'] == 'dict': + # push down any `each_item=True` validators onto dict _values_ + # this is super arbitrary but it's the V1 behavior + inner_schema = schema.get('values_schema', None) + if inner_schema is None: + inner_schema = core_schema.any_schema() + schema['values_schema'] = apply_validators(inner_schema, each_item_validators, field_name) + elif each_item_validators: + raise TypeError( + f"`@validator(..., each_item=True)` cannot be applied to fields with a schema of {schema['type']}" + ) + return schema + + +def modify_model_json_schema( + schema_or_field: CoreSchemaOrField, handler: GetJsonSchemaHandler, *, cls: Any +) -> JsonSchemaValue: + """Add title and description for model-like classes' JSON schema. + + Args: + schema_or_field: The schema data to generate a JSON schema from. + handler: The `GetCoreSchemaHandler` instance. + cls: The model-like class. + + Returns: + JsonSchemaValue: The updated JSON schema. + """ + from ..main import BaseModel + + json_schema = handler(schema_or_field) + original_schema = handler.resolve_ref_schema(json_schema) + # Preserve the fact that definitions schemas should never have sibling keys: + if '$ref' in original_schema: + ref = original_schema['$ref'] + original_schema.clear() + original_schema['allOf'] = [{'$ref': ref}] + if 'title' not in original_schema: + original_schema['title'] = cls.__name__ + # BaseModel; don't use cls.__doc__ as it will contain the verbose class signature by default + docstring = None if cls is BaseModel else cls.__doc__ + if docstring and 'description' not in original_schema: + original_schema['description'] = inspect.cleandoc(docstring) + return json_schema + + +JsonEncoders = Dict[Type[Any], JsonEncoder] + + +def _add_custom_serialization_from_json_encoders( + json_encoders: JsonEncoders | None, tp: Any, schema: CoreSchema +) -> CoreSchema: + """Iterate over the json_encoders and add the first matching encoder to the schema. + + Args: + json_encoders: A dictionary of types and their encoder functions. + tp: The type to check for a matching encoder. + schema: The schema to add the encoder to. + """ + if not json_encoders: + return schema + if 'serialization' in schema: + return schema + # Check the class type and its superclasses for a matching encoder + # Decimal.__class__.__mro__ (and probably other cases) doesn't include Decimal itself + # if the type is a GenericAlias (e.g. from list[int]) we need to use __class__ instead of .__mro__ + for base in (tp, *getattr(tp, '__mro__', tp.__class__.__mro__)[:-1]): + encoder = json_encoders.get(base) + if encoder is None: + continue + + warnings.warn( + f'`json_encoders` is deprecated. See https://docs.pydantic.dev/{version_short()}/concepts/serialization/#custom-serializers for alternatives', + PydanticDeprecatedSince20, + ) + + # TODO: in theory we should check that the schema accepts a serialization key + schema['serialization'] = core_schema.plain_serializer_function_ser_schema(encoder, when_used='json') + return schema + + return schema + + +TypesNamespace = Union[Dict[str, Any], None] + + +class TypesNamespaceStack: + """A stack of types namespaces.""" + + def __init__(self, types_namespace: TypesNamespace): + self._types_namespace_stack: list[TypesNamespace] = [types_namespace] + + @property + def tail(self) -> TypesNamespace: + return self._types_namespace_stack[-1] + + @contextmanager + def push(self, for_type: type[Any]): + types_namespace = {**_typing_extra.get_cls_types_namespace(for_type), **(self.tail or {})} + self._types_namespace_stack.append(types_namespace) + try: + yield + finally: + self._types_namespace_stack.pop() + + +class GenerateSchema: + """Generate core schema for a Pydantic model, dataclass and types like `str`, `datetime`, ... .""" + + __slots__ = ( + '_config_wrapper_stack', + '_types_namespace_stack', + '_typevars_map', + '_has_invalid_schema', + 'field_name_stack', + 'defs', + ) + + def __init__( + self, + config_wrapper: ConfigWrapper, + types_namespace: dict[str, Any] | None, + typevars_map: dict[Any, Any] | None = None, + ) -> None: + # we need a stack for recursing into child models + self._config_wrapper_stack = ConfigWrapperStack(config_wrapper) + self._types_namespace_stack = TypesNamespaceStack(types_namespace) + self._typevars_map = typevars_map + self._has_invalid_schema = False + self.field_name_stack = _FieldNameStack() + self.defs = _Definitions() + + @classmethod + def __from_parent( + cls, + config_wrapper_stack: ConfigWrapperStack, + types_namespace_stack: TypesNamespaceStack, + typevars_map: dict[Any, Any] | None, + defs: _Definitions, + ) -> GenerateSchema: + obj = cls.__new__(cls) + obj._config_wrapper_stack = config_wrapper_stack + obj._types_namespace_stack = types_namespace_stack + obj._typevars_map = typevars_map + obj._has_invalid_schema = False + obj.field_name_stack = _FieldNameStack() + obj.defs = defs + return obj + + @property + def _config_wrapper(self) -> ConfigWrapper: + return self._config_wrapper_stack.tail + + @property + def _types_namespace(self) -> dict[str, Any] | None: + return self._types_namespace_stack.tail + + @property + def _current_generate_schema(self) -> GenerateSchema: + cls = self._config_wrapper.schema_generator or GenerateSchema + return cls.__from_parent( + self._config_wrapper_stack, + self._types_namespace_stack, + self._typevars_map, + self.defs, + ) + + @property + def _arbitrary_types(self) -> bool: + return self._config_wrapper.arbitrary_types_allowed + + def str_schema(self) -> CoreSchema: + """Generate a CoreSchema for `str`""" + return core_schema.str_schema() + + # the following methods can be overridden but should be considered + # unstable / private APIs + def _list_schema(self, tp: Any, items_type: Any) -> CoreSchema: + return core_schema.list_schema(self.generate_schema(items_type)) + + def _dict_schema(self, tp: Any, keys_type: Any, values_type: Any) -> CoreSchema: + return core_schema.dict_schema(self.generate_schema(keys_type), self.generate_schema(values_type)) + + def _set_schema(self, tp: Any, items_type: Any) -> CoreSchema: + return core_schema.set_schema(self.generate_schema(items_type)) + + def _frozenset_schema(self, tp: Any, items_type: Any) -> CoreSchema: + return core_schema.frozenset_schema(self.generate_schema(items_type)) + + def _arbitrary_type_schema(self, tp: Any) -> CoreSchema: + if not isinstance(tp, type): + warn( + f'{tp!r} is not a Python type (it may be an instance of an object),' + ' Pydantic will allow any object with no validation since we cannot even' + ' enforce that the input is an instance of the given type.' + ' To get rid of this error wrap the type with `pydantic.SkipValidation`.', + UserWarning, + ) + return core_schema.any_schema() + return core_schema.is_instance_schema(tp) + + def _unknown_type_schema(self, obj: Any) -> CoreSchema: + raise PydanticSchemaGenerationError( + f'Unable to generate pydantic-core schema for {obj!r}. ' + 'Set `arbitrary_types_allowed=True` in the model_config to ignore this error' + ' or implement `__get_pydantic_core_schema__` on your type to fully support it.' + '\n\nIf you got this error by calling handler() within' + ' `__get_pydantic_core_schema__` then you likely need to call' + ' `handler.generate_schema()` since we do not call' + ' `__get_pydantic_core_schema__` on `` otherwise to avoid infinite recursion.' + ) + + def _apply_discriminator_to_union( + self, schema: CoreSchema, discriminator: str | Discriminator | None + ) -> CoreSchema: + if discriminator is None: + return schema + try: + return _discriminated_union.apply_discriminator( + schema, + discriminator, + ) + except _discriminated_union.MissingDefinitionForUnionRef: + # defer until defs are resolved + _discriminated_union.set_discriminator_in_metadata( + schema, + discriminator, + ) + return schema + + class CollectedInvalid(Exception): + pass + + def clean_schema(self, schema: CoreSchema) -> CoreSchema: + schema = self.collect_definitions(schema) + schema = simplify_schema_references(schema) + schema = _discriminated_union.apply_discriminators(schema) + if collect_invalid_schemas(schema): + raise self.CollectedInvalid() + schema = validate_core_schema(schema) + return schema + + def collect_definitions(self, schema: CoreSchema) -> CoreSchema: + ref = cast('str | None', schema.get('ref', None)) + if ref: + self.defs.definitions[ref] = schema + if 'ref' in schema: + schema = core_schema.definition_reference_schema(schema['ref']) + return core_schema.definitions_schema( + schema, + list(self.defs.definitions.values()), + ) + + def _add_js_function(self, metadata_schema: CoreSchema, js_function: Callable[..., Any]) -> None: + metadata = CoreMetadataHandler(metadata_schema).metadata + pydantic_js_functions = metadata.setdefault('pydantic_js_functions', []) + # because of how we generate core schemas for nested generic models + # we can end up adding `BaseModel.__get_pydantic_json_schema__` multiple times + # this check may fail to catch duplicates if the function is a `functools.partial` + # or something like that + # but if it does it'll fail by inserting the duplicate + if js_function not in pydantic_js_functions: + pydantic_js_functions.append(js_function) + + def generate_schema( + self, + obj: Any, + from_dunder_get_core_schema: bool = True, + ) -> core_schema.CoreSchema: + """Generate core schema. + + Args: + obj: The object to generate core schema for. + from_dunder_get_core_schema: Whether to generate schema from either the + `__get_pydantic_core_schema__` function or `__pydantic_core_schema__` property. + + Returns: + The generated core schema. + + Raises: + PydanticUndefinedAnnotation: + If it is not possible to evaluate forward reference. + PydanticSchemaGenerationError: + If it is not possible to generate pydantic-core schema. + TypeError: + - If `alias_generator` returns a disallowed type (must be str, AliasPath or AliasChoices). + - If V1 style validator with `each_item=True` applied on a wrong field. + PydanticUserError: + - If `typing.TypedDict` is used instead of `typing_extensions.TypedDict` on Python < 3.12. + - If `__modify_schema__` method is used instead of `__get_pydantic_json_schema__`. + """ + schema: CoreSchema | None = None + + if from_dunder_get_core_schema: + from_property = self._generate_schema_from_property(obj, obj) + if from_property is not None: + schema = from_property + + if schema is None: + schema = self._generate_schema(obj) + + metadata_js_function = _extract_get_pydantic_json_schema(obj, schema) + if metadata_js_function is not None: + metadata_schema = resolve_original_schema(schema, self.defs.definitions) + if metadata_schema: + self._add_js_function(metadata_schema, metadata_js_function) + + schema = _add_custom_serialization_from_json_encoders(self._config_wrapper.json_encoders, obj, schema) + + schema = self._post_process_generated_schema(schema) + + return schema + + def _model_schema(self, cls: type[BaseModel]) -> core_schema.CoreSchema: + """Generate schema for a Pydantic model.""" + with self.defs.get_schema_or_ref(cls) as (model_ref, maybe_schema): + if maybe_schema is not None: + return maybe_schema + + fields = cls.model_fields + decorators = cls.__pydantic_decorators__ + computed_fields = decorators.computed_fields + check_decorator_fields_exist( + chain( + decorators.field_validators.values(), + decorators.field_serializers.values(), + decorators.validators.values(), + ), + {*fields.keys(), *computed_fields.keys()}, + ) + config_wrapper = ConfigWrapper(cls.model_config, check=False) + core_config = config_wrapper.core_config(cls) + metadata = build_metadata_dict(js_functions=[partial(modify_model_json_schema, cls=cls)]) + + model_validators = decorators.model_validators.values() + + extras_schema = None + if core_config.get('extra_fields_behavior') == 'allow': + for tp in (cls, *cls.__mro__): + extras_annotation = cls.__annotations__.get('__pydantic_extra__', None) + if extras_annotation is not None: + tp = get_origin(extras_annotation) + if tp not in (Dict, dict): + raise PydanticSchemaGenerationError( + 'The type annotation for `__pydantic_extra__` must be `Dict[str, ...]`' + ) + extra_items_type = self._get_args_resolving_forward_refs( + cls.__annotations__['__pydantic_extra__'], + required=True, + )[1] + if extra_items_type is not Any: + extras_schema = self.generate_schema(extra_items_type) + break + + with self._config_wrapper_stack.push(config_wrapper), self._types_namespace_stack.push(cls): + self = self._current_generate_schema + if cls.__pydantic_root_model__: + root_field = self._common_field_schema('root', fields['root'], decorators) + inner_schema = root_field['schema'] + inner_schema = apply_model_validators(inner_schema, model_validators, 'inner') + model_schema = core_schema.model_schema( + cls, + inner_schema, + custom_init=getattr(cls, '__pydantic_custom_init__', None), + root_model=True, + post_init=getattr(cls, '__pydantic_post_init__', None), + config=core_config, + ref=model_ref, + metadata=metadata, + ) + else: + fields_schema: core_schema.CoreSchema = core_schema.model_fields_schema( + {k: self._generate_md_field_schema(k, v, decorators) for k, v in fields.items()}, + computed_fields=[ + self._computed_field_schema(d, decorators.field_serializers) + for d in computed_fields.values() + ], + extras_schema=extras_schema, + model_name=cls.__name__, + ) + inner_schema = apply_validators(fields_schema, decorators.root_validators.values(), None) + new_inner_schema = define_expected_missing_refs(inner_schema, recursively_defined_type_refs()) + if new_inner_schema is not None: + inner_schema = new_inner_schema + inner_schema = apply_model_validators(inner_schema, model_validators, 'inner') + + model_schema = core_schema.model_schema( + cls, + inner_schema, + custom_init=getattr(cls, '__pydantic_custom_init__', None), + root_model=False, + post_init=getattr(cls, '__pydantic_post_init__', None), + config=core_config, + ref=model_ref, + metadata=metadata, + ) + + schema = self._apply_model_serializers(model_schema, decorators.model_serializers.values()) + schema = apply_model_validators(schema, model_validators, 'outer') + self.defs.definitions[model_ref] = self._post_process_generated_schema(schema) + return core_schema.definition_reference_schema(model_ref) + + def _unpack_refs_defs(self, schema: CoreSchema) -> CoreSchema: + """Unpack all 'definitions' schemas into `GenerateSchema.defs.definitions` + and return the inner schema. + """ + + def get_ref(s: CoreSchema) -> str: + return s['ref'] # type: ignore + + if schema['type'] == 'definitions': + self.defs.definitions.update({get_ref(s): s for s in schema['definitions']}) + schema = schema['schema'] + return schema + + def _generate_schema_from_property(self, obj: Any, source: Any) -> core_schema.CoreSchema | None: + """Try to generate schema from either the `__get_pydantic_core_schema__` function or + `__pydantic_core_schema__` property. + + Note: `__get_pydantic_core_schema__` takes priority so it can + decide whether to use a `__pydantic_core_schema__` attribute, or generate a fresh schema. + """ + # avoid calling `__get_pydantic_core_schema__` if we've already visited this object + with self.defs.get_schema_or_ref(obj) as (_, maybe_schema): + if maybe_schema is not None: + return maybe_schema + if obj is source: + ref_mode = 'unpack' + else: + ref_mode = 'to-def' + + schema: CoreSchema + get_schema = getattr(obj, '__get_pydantic_core_schema__', None) + if get_schema is None: + validators = getattr(obj, '__get_validators__', None) + if validators is None: + return None + warn( + '`__get_validators__` is deprecated and will be removed, use `__get_pydantic_core_schema__` instead.', + PydanticDeprecatedSince20, + ) + schema = core_schema.chain_schema([core_schema.with_info_plain_validator_function(v) for v in validators()]) + else: + if len(inspect.signature(get_schema).parameters) == 1: + # (source) -> CoreSchema + schema = get_schema(source) + else: + schema = get_schema( + source, CallbackGetCoreSchemaHandler(self._generate_schema, self, ref_mode=ref_mode) + ) + + schema = self._unpack_refs_defs(schema) + + if is_function_with_inner_schema(schema): + ref = schema['schema'].pop('ref', None) # pyright: ignore[reportGeneralTypeIssues] + if ref: + schema['ref'] = ref + else: + ref = get_ref(schema) + + if ref: + self.defs.definitions[ref] = self._post_process_generated_schema(schema) + return core_schema.definition_reference_schema(ref) + + schema = self._post_process_generated_schema(schema) + + return schema + + def _resolve_forward_ref(self, obj: Any) -> Any: + # we assume that types_namespace has the target of forward references in its scope, + # but this could fail, for example, if calling Validator on an imported type which contains + # forward references to other types only defined in the module from which it was imported + # `Validator(SomeImportedTypeAliasWithAForwardReference)` + # or the equivalent for BaseModel + # class Model(BaseModel): + # x: SomeImportedTypeAliasWithAForwardReference + try: + obj = _typing_extra.eval_type_backport(obj, globalns=self._types_namespace) + except NameError as e: + raise PydanticUndefinedAnnotation.from_name_error(e) from e + + # if obj is still a ForwardRef, it means we can't evaluate it, raise PydanticUndefinedAnnotation + if isinstance(obj, ForwardRef): + raise PydanticUndefinedAnnotation(obj.__forward_arg__, f'Unable to evaluate forward reference {obj}') + + if self._typevars_map: + obj = replace_types(obj, self._typevars_map) + + return obj + + @overload + def _get_args_resolving_forward_refs(self, obj: Any, required: Literal[True]) -> tuple[Any, ...]: + ... + + @overload + def _get_args_resolving_forward_refs(self, obj: Any) -> tuple[Any, ...] | None: + ... + + def _get_args_resolving_forward_refs(self, obj: Any, required: bool = False) -> tuple[Any, ...] | None: + args = get_args(obj) + if args: + args = tuple([self._resolve_forward_ref(a) if isinstance(a, ForwardRef) else a for a in args]) + elif required: # pragma: no cover + raise TypeError(f'Expected {obj} to have generic parameters but it had none') + return args + + def _get_first_arg_or_any(self, obj: Any) -> Any: + args = self._get_args_resolving_forward_refs(obj) + if not args: + return Any + return args[0] + + def _get_first_two_args_or_any(self, obj: Any) -> tuple[Any, Any]: + args = self._get_args_resolving_forward_refs(obj) + if not args: + return (Any, Any) + if len(args) < 2: + origin = get_origin(obj) + raise TypeError(f'Expected two type arguments for {origin}, got 1') + return args[0], args[1] + + def _post_process_generated_schema(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema: + if 'metadata' not in schema: + schema['metadata'] = {} + return schema + + def _generate_schema(self, obj: Any) -> core_schema.CoreSchema: + """Recursively generate a pydantic-core schema for any supported python type.""" + has_invalid_schema = self._has_invalid_schema + self._has_invalid_schema = False + schema = self._generate_schema_inner(obj) + self._has_invalid_schema = self._has_invalid_schema or has_invalid_schema + return schema + + def _generate_schema_inner(self, obj: Any) -> core_schema.CoreSchema: + if isinstance(obj, _AnnotatedType): + return self._annotated_schema(obj) + + if isinstance(obj, dict): + # we assume this is already a valid schema + return obj # type: ignore[return-value] + + if isinstance(obj, str): + obj = ForwardRef(obj) + + if isinstance(obj, ForwardRef): + return self.generate_schema(self._resolve_forward_ref(obj)) + + from ..main import BaseModel + + if lenient_issubclass(obj, BaseModel): + return self._model_schema(obj) + + if isinstance(obj, PydanticRecursiveRef): + return core_schema.definition_reference_schema(schema_ref=obj.type_ref) + + return self.match_type(obj) + + def match_type(self, obj: Any) -> core_schema.CoreSchema: # noqa: C901 + """Main mapping of types to schemas. + + The general structure is a series of if statements starting with the simple cases + (non-generic primitive types) and then handling generics and other more complex cases. + + Each case either generates a schema directly, calls into a public user-overridable method + (like `GenerateSchema.tuple_variable_schema`) or calls into a private method that handles some + boilerplate before calling into the user-facing method (e.g. `GenerateSchema._tuple_schema`). + + The idea is that we'll evolve this into adding more and more user facing methods over time + as they get requested and we figure out what the right API for them is. + """ + if obj is str: + return self.str_schema() + elif obj is bytes: + return core_schema.bytes_schema() + elif obj is int: + return core_schema.int_schema() + elif obj is float: + return core_schema.float_schema() + elif obj is bool: + return core_schema.bool_schema() + elif obj is Any or obj is object: + return core_schema.any_schema() + elif obj is None or obj is _typing_extra.NoneType: + return core_schema.none_schema() + elif obj in TUPLE_TYPES: + return self._tuple_schema(obj) + elif obj in LIST_TYPES: + return self._list_schema(obj, self._get_first_arg_or_any(obj)) + elif obj in SET_TYPES: + return self._set_schema(obj, self._get_first_arg_or_any(obj)) + elif obj in FROZEN_SET_TYPES: + return self._frozenset_schema(obj, self._get_first_arg_or_any(obj)) + elif obj in DICT_TYPES: + return self._dict_schema(obj, *self._get_first_two_args_or_any(obj)) + elif isinstance(obj, TypeAliasType): + return self._type_alias_type_schema(obj) + elif obj == type: + return self._type_schema() + elif _typing_extra.is_callable_type(obj): + return core_schema.callable_schema() + elif _typing_extra.is_literal_type(obj): + return self._literal_schema(obj) + elif is_typeddict(obj): + return self._typed_dict_schema(obj, None) + elif _typing_extra.is_namedtuple(obj): + return self._namedtuple_schema(obj, None) + elif _typing_extra.is_new_type(obj): + # NewType, can't use isinstance because it fails <3.10 + return self.generate_schema(obj.__supertype__) + elif obj == re.Pattern: + return self._pattern_schema(obj) + elif obj is collections.abc.Hashable or obj is typing.Hashable: + return self._hashable_schema() + elif isinstance(obj, typing.TypeVar): + return self._unsubstituted_typevar_schema(obj) + elif is_finalvar(obj): + if obj is Final: + return core_schema.any_schema() + return self.generate_schema( + self._get_first_arg_or_any(obj), + ) + elif isinstance(obj, (FunctionType, LambdaType, MethodType, partial)): + return self._callable_schema(obj) + elif inspect.isclass(obj) and issubclass(obj, Enum): + from ._std_types_schema import get_enum_core_schema + + return get_enum_core_schema(obj, self._config_wrapper.config_dict) + + if _typing_extra.is_dataclass(obj): + return self._dataclass_schema(obj, None) + + res = self._get_prepare_pydantic_annotations_for_known_type(obj, ()) + if res is not None: + source_type, annotations = res + return self._apply_annotations(source_type, annotations) + + origin = get_origin(obj) + if origin is not None: + return self._match_generic_type(obj, origin) + + if self._arbitrary_types: + return self._arbitrary_type_schema(obj) + return self._unknown_type_schema(obj) + + def _match_generic_type(self, obj: Any, origin: Any) -> CoreSchema: # noqa: C901 + if isinstance(origin, TypeAliasType): + return self._type_alias_type_schema(obj) + + # Need to handle generic dataclasses before looking for the schema properties because attribute accesses + # on _GenericAlias delegate to the origin type, so lose the information about the concrete parametrization + # As a result, currently, there is no way to cache the schema for generic dataclasses. This may be possible + # to resolve by modifying the value returned by `Generic.__class_getitem__`, but that is a dangerous game. + if _typing_extra.is_dataclass(origin): + return self._dataclass_schema(obj, origin) + if _typing_extra.is_namedtuple(origin): + return self._namedtuple_schema(obj, origin) + + from_property = self._generate_schema_from_property(origin, obj) + if from_property is not None: + return from_property + + if _typing_extra.origin_is_union(origin): + return self._union_schema(obj) + elif origin in TUPLE_TYPES: + return self._tuple_schema(obj) + elif origin in LIST_TYPES: + return self._list_schema(obj, self._get_first_arg_or_any(obj)) + elif origin in SET_TYPES: + return self._set_schema(obj, self._get_first_arg_or_any(obj)) + elif origin in FROZEN_SET_TYPES: + return self._frozenset_schema(obj, self._get_first_arg_or_any(obj)) + elif origin in DICT_TYPES: + return self._dict_schema(obj, *self._get_first_two_args_or_any(obj)) + elif is_typeddict(origin): + return self._typed_dict_schema(obj, origin) + elif origin in (typing.Type, type): + return self._subclass_schema(obj) + elif origin in {typing.Sequence, collections.abc.Sequence}: + return self._sequence_schema(obj) + elif origin in {typing.Iterable, collections.abc.Iterable, typing.Generator, collections.abc.Generator}: + return self._iterable_schema(obj) + elif origin in (re.Pattern, typing.Pattern): + return self._pattern_schema(obj) + + if self._arbitrary_types: + return self._arbitrary_type_schema(origin) + return self._unknown_type_schema(obj) + + def _generate_td_field_schema( + self, + name: str, + field_info: FieldInfo, + decorators: DecoratorInfos, + *, + required: bool = True, + ) -> core_schema.TypedDictField: + """Prepare a TypedDictField to represent a model or typeddict field.""" + common_field = self._common_field_schema(name, field_info, decorators) + return core_schema.typed_dict_field( + common_field['schema'], + required=False if not field_info.is_required() else required, + serialization_exclude=common_field['serialization_exclude'], + validation_alias=common_field['validation_alias'], + serialization_alias=common_field['serialization_alias'], + metadata=common_field['metadata'], + ) + + def _generate_md_field_schema( + self, + name: str, + field_info: FieldInfo, + decorators: DecoratorInfos, + ) -> core_schema.ModelField: + """Prepare a ModelField to represent a model field.""" + common_field = self._common_field_schema(name, field_info, decorators) + return core_schema.model_field( + common_field['schema'], + serialization_exclude=common_field['serialization_exclude'], + validation_alias=common_field['validation_alias'], + serialization_alias=common_field['serialization_alias'], + frozen=common_field['frozen'], + metadata=common_field['metadata'], + ) + + def _generate_dc_field_schema( + self, + name: str, + field_info: FieldInfo, + decorators: DecoratorInfos, + ) -> core_schema.DataclassField: + """Prepare a DataclassField to represent the parameter/field, of a dataclass.""" + common_field = self._common_field_schema(name, field_info, decorators) + return core_schema.dataclass_field( + name, + common_field['schema'], + init=field_info.init, + init_only=field_info.init_var or None, + kw_only=None if field_info.kw_only else False, + serialization_exclude=common_field['serialization_exclude'], + validation_alias=common_field['validation_alias'], + serialization_alias=common_field['serialization_alias'], + frozen=common_field['frozen'], + metadata=common_field['metadata'], + ) + + @staticmethod + def _apply_alias_generator_to_field_info( + alias_generator: Callable[[str], str] | AliasGenerator, field_info: FieldInfo, field_name: str + ) -> None: + """Apply an alias_generator to aliases on a FieldInfo instance if appropriate. + + Args: + alias_generator: A callable that takes a string and returns a string, or an AliasGenerator instance. + field_info: The FieldInfo instance to which the alias_generator is (maybe) applied. + field_name: The name of the field from which to generate the alias. + """ + # Apply an alias_generator if + # 1. An alias is not specified + # 2. An alias is specified, but the priority is <= 1 + if ( + field_info.alias_priority is None + or field_info.alias_priority <= 1 + or field_info.alias is None + or field_info.validation_alias is None + or field_info.serialization_alias is None + ): + alias, validation_alias, serialization_alias = None, None, None + + if isinstance(alias_generator, AliasGenerator): + alias, validation_alias, serialization_alias = alias_generator.generate_aliases(field_name) + elif isinstance(alias_generator, Callable): + alias = alias_generator(field_name) + if not isinstance(alias, str): + raise TypeError(f'alias_generator {alias_generator} must return str, not {alias.__class__}') + + # if priority is not set, we set to 1 + # which supports the case where the alias_generator from a child class is used + # to generate an alias for a field in a parent class + if field_info.alias_priority is None or field_info.alias_priority <= 1: + field_info.alias_priority = 1 + + # if the priority is 1, then we set the aliases to the generated alias + if field_info.alias_priority == 1: + field_info.serialization_alias = serialization_alias or alias + field_info.validation_alias = validation_alias or alias + field_info.alias = alias + + # if any of the aliases are not set, then we set them to the corresponding generated alias + if field_info.alias is None: + field_info.alias = alias + if field_info.serialization_alias is None: + field_info.serialization_alias = serialization_alias or alias + if field_info.validation_alias is None: + field_info.validation_alias = validation_alias or alias + + @staticmethod + def _apply_alias_generator_to_computed_field_info( + alias_generator: Callable[[str], str] | AliasGenerator, + computed_field_info: ComputedFieldInfo, + computed_field_name: str, + ): + """Apply an alias_generator to alias on a ComputedFieldInfo instance if appropriate. + + Args: + alias_generator: A callable that takes a string and returns a string, or an AliasGenerator instance. + computed_field_info: The ComputedFieldInfo instance to which the alias_generator is (maybe) applied. + computed_field_name: The name of the computed field from which to generate the alias. + """ + # Apply an alias_generator if + # 1. An alias is not specified + # 2. An alias is specified, but the priority is <= 1 + + if ( + computed_field_info.alias_priority is None + or computed_field_info.alias_priority <= 1 + or computed_field_info.alias is None + ): + alias, validation_alias, serialization_alias = None, None, None + + if isinstance(alias_generator, AliasGenerator): + alias, validation_alias, serialization_alias = alias_generator.generate_aliases(computed_field_name) + elif isinstance(alias_generator, Callable): + alias = alias_generator(computed_field_name) + if not isinstance(alias, str): + raise TypeError(f'alias_generator {alias_generator} must return str, not {alias.__class__}') + + # if priority is not set, we set to 1 + # which supports the case where the alias_generator from a child class is used + # to generate an alias for a field in a parent class + if computed_field_info.alias_priority is None or computed_field_info.alias_priority <= 1: + computed_field_info.alias_priority = 1 + + # if the priority is 1, then we set the aliases to the generated alias + # note that we use the serialization_alias with priority over alias, as computed_field + # aliases are used for serialization only (not validation) + if computed_field_info.alias_priority == 1: + computed_field_info.alias = serialization_alias or alias + + def _common_field_schema( # C901 + self, name: str, field_info: FieldInfo, decorators: DecoratorInfos + ) -> _CommonField: + # Update FieldInfo annotation if appropriate: + from .. import AliasChoices, AliasPath + from ..fields import FieldInfo + + if has_instance_in_type(field_info.annotation, (ForwardRef, str)): + types_namespace = self._types_namespace + if self._typevars_map: + types_namespace = (types_namespace or {}).copy() + # Ensure that typevars get mapped to their concrete types: + types_namespace.update({k.__name__: v for k, v in self._typevars_map.items()}) + + evaluated = _typing_extra.eval_type_lenient(field_info.annotation, types_namespace) + if evaluated is not field_info.annotation and not has_instance_in_type(evaluated, PydanticRecursiveRef): + new_field_info = FieldInfo.from_annotation(evaluated) + field_info.annotation = new_field_info.annotation + + # Handle any field info attributes that may have been obtained from now-resolved annotations + for k, v in new_field_info._attributes_set.items(): + # If an attribute is already set, it means it was set by assigning to a call to Field (or just a + # default value), and that should take the highest priority. So don't overwrite existing attributes. + # We skip over "attributes" that are present in the metadata_lookup dict because these won't + # actually end up as attributes of the `FieldInfo` instance. + if k not in field_info._attributes_set and k not in field_info.metadata_lookup: + setattr(field_info, k, v) + + # Finally, ensure the field info also reflects all the `_attributes_set` that are actually metadata. + field_info.metadata = [*new_field_info.metadata, *field_info.metadata] + + source_type, annotations = field_info.annotation, field_info.metadata + + def set_discriminator(schema: CoreSchema) -> CoreSchema: + schema = self._apply_discriminator_to_union(schema, field_info.discriminator) + return schema + + with self.field_name_stack.push(name): + if field_info.discriminator is not None: + schema = self._apply_annotations(source_type, annotations, transform_inner_schema=set_discriminator) + else: + schema = self._apply_annotations( + source_type, + annotations, + ) + + # This V1 compatibility shim should eventually be removed + # push down any `each_item=True` validators + # note that this won't work for any Annotated types that get wrapped by a function validator + # but that's okay because that didn't exist in V1 + this_field_validators = filter_field_decorator_info_by_field(decorators.validators.values(), name) + if _validators_require_validate_default(this_field_validators): + field_info.validate_default = True + each_item_validators = [v for v in this_field_validators if v.info.each_item is True] + this_field_validators = [v for v in this_field_validators if v not in each_item_validators] + schema = apply_each_item_validators(schema, each_item_validators, name) + + schema = apply_validators(schema, filter_field_decorator_info_by_field(this_field_validators, name), name) + schema = apply_validators( + schema, filter_field_decorator_info_by_field(decorators.field_validators.values(), name), name + ) + + # the default validator needs to go outside of any other validators + # so that it is the topmost validator for the field validator + # which uses it to check if the field has a default value or not + if not field_info.is_required(): + schema = wrap_default(field_info, schema) + + schema = self._apply_field_serializers( + schema, filter_field_decorator_info_by_field(decorators.field_serializers.values(), name) + ) + json_schema_updates = { + 'title': field_info.title, + 'description': field_info.description, + 'examples': to_jsonable_python(field_info.examples), + } + json_schema_updates = {k: v for k, v in json_schema_updates.items() if v is not None} + + json_schema_extra = field_info.json_schema_extra + + metadata = build_metadata_dict( + js_annotation_functions=[get_json_schema_update_func(json_schema_updates, json_schema_extra)] + ) + + alias_generator = self._config_wrapper.alias_generator + if alias_generator is not None: + self._apply_alias_generator_to_field_info(alias_generator, field_info, name) + + if isinstance(field_info.validation_alias, (AliasChoices, AliasPath)): + validation_alias = field_info.validation_alias.convert_to_aliases() + else: + validation_alias = field_info.validation_alias + + return _common_field( + schema, + serialization_exclude=True if field_info.exclude else None, + validation_alias=validation_alias, + serialization_alias=field_info.serialization_alias, + frozen=field_info.frozen, + metadata=metadata, + ) + + def _union_schema(self, union_type: Any) -> core_schema.CoreSchema: + """Generate schema for a Union.""" + args = self._get_args_resolving_forward_refs(union_type, required=True) + choices: list[CoreSchema] = [] + nullable = False + for arg in args: + if arg is None or arg is _typing_extra.NoneType: + nullable = True + else: + choices.append(self.generate_schema(arg)) + + if len(choices) == 1: + s = choices[0] + else: + choices_with_tags: list[CoreSchema | tuple[CoreSchema, str]] = [] + for choice in choices: + metadata = choice.get('metadata') + if isinstance(metadata, dict): + tag = metadata.get(_core_utils.TAGGED_UNION_TAG_KEY) + if tag is not None: + choices_with_tags.append((choice, tag)) + else: + choices_with_tags.append(choice) + s = core_schema.union_schema(choices_with_tags) + + if nullable: + s = core_schema.nullable_schema(s) + return s + + def _type_alias_type_schema( + self, + obj: Any, # TypeAliasType + ) -> CoreSchema: + with self.defs.get_schema_or_ref(obj) as (ref, maybe_schema): + if maybe_schema is not None: + return maybe_schema + + origin = get_origin(obj) or obj + + annotation = origin.__value__ + typevars_map = get_standard_typevars_map(obj) + + with self._types_namespace_stack.push(origin): + annotation = _typing_extra.eval_type_lenient(annotation, self._types_namespace) + annotation = replace_types(annotation, typevars_map) + schema = self.generate_schema(annotation) + assert schema['type'] != 'definitions' + schema['ref'] = ref # type: ignore + self.defs.definitions[ref] = schema + return core_schema.definition_reference_schema(ref) + + def _literal_schema(self, literal_type: Any) -> CoreSchema: + """Generate schema for a Literal.""" + expected = _typing_extra.all_literal_values(literal_type) + assert expected, f'literal "expected" cannot be empty, obj={literal_type}' + return core_schema.literal_schema(expected) + + def _typed_dict_schema(self, typed_dict_cls: Any, origin: Any) -> core_schema.CoreSchema: + """Generate schema for a TypedDict. + + It is not possible to track required/optional keys in TypedDict without __required_keys__ + since TypedDict.__new__ erases the base classes (it replaces them with just `dict`) + and thus we can track usage of total=True/False + __required_keys__ was added in Python 3.9 + (https://github.com/miss-islington/cpython/blob/1e9939657dd1f8eb9f596f77c1084d2d351172fc/Doc/library/typing.rst?plain=1#L1546-L1548) + however it is buggy + (https://github.com/python/typing_extensions/blob/ac52ac5f2cb0e00e7988bae1e2a1b8257ac88d6d/src/typing_extensions.py#L657-L666). + + On 3.11 but < 3.12 TypedDict does not preserve inheritance information. + + Hence to avoid creating validators that do not do what users expect we only + support typing.TypedDict on Python >= 3.12 or typing_extension.TypedDict on all versions + """ + from ..fields import FieldInfo + + with self.defs.get_schema_or_ref(typed_dict_cls) as (typed_dict_ref, maybe_schema): + if maybe_schema is not None: + return maybe_schema + + typevars_map = get_standard_typevars_map(typed_dict_cls) + if origin is not None: + typed_dict_cls = origin + + if not _SUPPORTS_TYPEDDICT and type(typed_dict_cls).__module__ == 'typing': + raise PydanticUserError( + 'Please use `typing_extensions.TypedDict` instead of `typing.TypedDict` on Python < 3.12.', + code='typed-dict-version', + ) + + try: + config: ConfigDict | None = get_attribute_from_bases(typed_dict_cls, '__pydantic_config__') + except AttributeError: + config = None + + with self._config_wrapper_stack.push(config), self._types_namespace_stack.push(typed_dict_cls): + core_config = self._config_wrapper.core_config(typed_dict_cls) + + self = self._current_generate_schema + + required_keys: frozenset[str] = typed_dict_cls.__required_keys__ + + fields: dict[str, core_schema.TypedDictField] = {} + + decorators = DecoratorInfos.build(typed_dict_cls) + + for field_name, annotation in get_type_hints_infer_globalns( + typed_dict_cls, localns=self._types_namespace, include_extras=True + ).items(): + annotation = replace_types(annotation, typevars_map) + required = field_name in required_keys + + if get_origin(annotation) == _typing_extra.Required: + required = True + annotation = self._get_args_resolving_forward_refs( + annotation, + required=True, + )[0] + elif get_origin(annotation) == _typing_extra.NotRequired: + required = False + annotation = self._get_args_resolving_forward_refs( + annotation, + required=True, + )[0] + + field_info = FieldInfo.from_annotation(annotation) + fields[field_name] = self._generate_td_field_schema( + field_name, field_info, decorators, required=required + ) + + metadata = build_metadata_dict( + js_functions=[partial(modify_model_json_schema, cls=typed_dict_cls)], typed_dict_cls=typed_dict_cls + ) + + td_schema = core_schema.typed_dict_schema( + fields, + computed_fields=[ + self._computed_field_schema(d, decorators.field_serializers) + for d in decorators.computed_fields.values() + ], + ref=typed_dict_ref, + metadata=metadata, + config=core_config, + ) + + schema = self._apply_model_serializers(td_schema, decorators.model_serializers.values()) + schema = apply_model_validators(schema, decorators.model_validators.values(), 'all') + self.defs.definitions[typed_dict_ref] = self._post_process_generated_schema(schema) + return core_schema.definition_reference_schema(typed_dict_ref) + + def _namedtuple_schema(self, namedtuple_cls: Any, origin: Any) -> core_schema.CoreSchema: + """Generate schema for a NamedTuple.""" + with self.defs.get_schema_or_ref(namedtuple_cls) as (namedtuple_ref, maybe_schema): + if maybe_schema is not None: + return maybe_schema + typevars_map = get_standard_typevars_map(namedtuple_cls) + if origin is not None: + namedtuple_cls = origin + + annotations: dict[str, Any] = get_type_hints_infer_globalns( + namedtuple_cls, include_extras=True, localns=self._types_namespace + ) + if not annotations: + # annotations is empty, happens if namedtuple_cls defined via collections.namedtuple(...) + annotations = {k: Any for k in namedtuple_cls._fields} + + if typevars_map: + annotations = { + field_name: replace_types(annotation, typevars_map) + for field_name, annotation in annotations.items() + } + + arguments_schema = core_schema.arguments_schema( + [ + self._generate_parameter_schema( + field_name, annotation, default=namedtuple_cls._field_defaults.get(field_name, Parameter.empty) + ) + for field_name, annotation in annotations.items() + ], + metadata=build_metadata_dict(js_prefer_positional_arguments=True), + ) + return core_schema.call_schema(arguments_schema, namedtuple_cls, ref=namedtuple_ref) + + def _generate_parameter_schema( + self, + name: str, + annotation: type[Any], + default: Any = Parameter.empty, + mode: Literal['positional_only', 'positional_or_keyword', 'keyword_only'] | None = None, + ) -> core_schema.ArgumentsParameter: + """Prepare a ArgumentsParameter to represent a field in a namedtuple or function signature.""" + from ..fields import FieldInfo + + if default is Parameter.empty: + field = FieldInfo.from_annotation(annotation) + else: + field = FieldInfo.from_annotated_attribute(annotation, default) + assert field.annotation is not None, 'field.annotation should not be None when generating a schema' + source_type, annotations = field.annotation, field.metadata + with self.field_name_stack.push(name): + schema = self._apply_annotations(source_type, annotations) + + if not field.is_required(): + schema = wrap_default(field, schema) + + parameter_schema = core_schema.arguments_parameter(name, schema) + if mode is not None: + parameter_schema['mode'] = mode + if field.alias is not None: + parameter_schema['alias'] = field.alias + else: + alias_generator = self._config_wrapper.alias_generator + if isinstance(alias_generator, AliasGenerator) and alias_generator.alias is not None: + parameter_schema['alias'] = alias_generator.alias(name) + elif isinstance(alias_generator, Callable): + parameter_schema['alias'] = alias_generator(name) + return parameter_schema + + def _tuple_schema(self, tuple_type: Any) -> core_schema.CoreSchema: + """Generate schema for a Tuple, e.g. `tuple[int, str]` or `tuple[int, ...]`.""" + # TODO: do we really need to resolve type vars here? + typevars_map = get_standard_typevars_map(tuple_type) + params = self._get_args_resolving_forward_refs(tuple_type) + + if typevars_map and params: + params = tuple(replace_types(param, typevars_map) for param in params) + + # NOTE: subtle difference: `tuple[()]` gives `params=()`, whereas `typing.Tuple[()]` gives `params=((),)` + # This is only true for <3.11, on Python 3.11+ `typing.Tuple[()]` gives `params=()` + if not params: + if tuple_type in TUPLE_TYPES: + return core_schema.tuple_schema([core_schema.any_schema()], variadic_item_index=0) + else: + # special case for `tuple[()]` which means `tuple[]` - an empty tuple + return core_schema.tuple_schema([]) + elif params[-1] is Ellipsis: + if len(params) == 2: + return core_schema.tuple_schema([self.generate_schema(params[0])], variadic_item_index=0) + else: + # TODO: something like https://github.com/pydantic/pydantic/issues/5952 + raise ValueError('Variable tuples can only have one type') + elif len(params) == 1 and params[0] == (): + # special case for `Tuple[()]` which means `Tuple[]` - an empty tuple + # NOTE: This conditional can be removed when we drop support for Python 3.10. + return core_schema.tuple_schema([]) + else: + return core_schema.tuple_schema([self.generate_schema(param) for param in params]) + + def _type_schema(self) -> core_schema.CoreSchema: + return core_schema.custom_error_schema( + core_schema.is_instance_schema(type), + custom_error_type='is_type', + custom_error_message='Input should be a type', + ) + + def _union_is_subclass_schema(self, union_type: Any) -> core_schema.CoreSchema: + """Generate schema for `Type[Union[X, ...]]`.""" + args = self._get_args_resolving_forward_refs(union_type, required=True) + return core_schema.union_schema([self.generate_schema(typing.Type[args]) for args in args]) + + def _subclass_schema(self, type_: Any) -> core_schema.CoreSchema: + """Generate schema for a Type, e.g. `Type[int]`.""" + type_param = self._get_first_arg_or_any(type_) + if type_param == Any: + return self._type_schema() + elif isinstance(type_param, typing.TypeVar): + if type_param.__bound__: + if _typing_extra.origin_is_union(get_origin(type_param.__bound__)): + return self._union_is_subclass_schema(type_param.__bound__) + return core_schema.is_subclass_schema(type_param.__bound__) + elif type_param.__constraints__: + return core_schema.union_schema( + [self.generate_schema(typing.Type[c]) for c in type_param.__constraints__] + ) + else: + return self._type_schema() + elif _typing_extra.origin_is_union(get_origin(type_param)): + return self._union_is_subclass_schema(type_param) + else: + return core_schema.is_subclass_schema(type_param) + + def _sequence_schema(self, sequence_type: Any) -> core_schema.CoreSchema: + """Generate schema for a Sequence, e.g. `Sequence[int]`.""" + item_type = self._get_first_arg_or_any(sequence_type) + + list_schema = core_schema.list_schema(self.generate_schema(item_type)) + python_schema = core_schema.is_instance_schema(typing.Sequence, cls_repr='Sequence') + if item_type != Any: + from ._validators import sequence_validator + + python_schema = core_schema.chain_schema( + [python_schema, core_schema.no_info_wrap_validator_function(sequence_validator, list_schema)], + ) + return core_schema.json_or_python_schema(json_schema=list_schema, python_schema=python_schema) + + def _iterable_schema(self, type_: Any) -> core_schema.GeneratorSchema: + """Generate a schema for an `Iterable`.""" + item_type = self._get_first_arg_or_any(type_) + + return core_schema.generator_schema(self.generate_schema(item_type)) + + def _pattern_schema(self, pattern_type: Any) -> core_schema.CoreSchema: + from . import _validators + + metadata = build_metadata_dict(js_functions=[lambda _1, _2: {'type': 'string', 'format': 'regex'}]) + ser = core_schema.plain_serializer_function_ser_schema( + attrgetter('pattern'), when_used='json', return_schema=core_schema.str_schema() + ) + if pattern_type == typing.Pattern or pattern_type == re.Pattern: + # bare type + return core_schema.no_info_plain_validator_function( + _validators.pattern_either_validator, serialization=ser, metadata=metadata + ) + + param = self._get_args_resolving_forward_refs( + pattern_type, + required=True, + )[0] + if param == str: + return core_schema.no_info_plain_validator_function( + _validators.pattern_str_validator, serialization=ser, metadata=metadata + ) + elif param == bytes: + return core_schema.no_info_plain_validator_function( + _validators.pattern_bytes_validator, serialization=ser, metadata=metadata + ) + else: + raise PydanticSchemaGenerationError(f'Unable to generate pydantic-core schema for {pattern_type!r}.') + + def _hashable_schema(self) -> core_schema.CoreSchema: + return core_schema.custom_error_schema( + core_schema.is_instance_schema(collections.abc.Hashable), + custom_error_type='is_hashable', + custom_error_message='Input should be hashable', + ) + + def _dataclass_schema( + self, dataclass: type[StandardDataclass], origin: type[StandardDataclass] | None + ) -> core_schema.CoreSchema: + """Generate schema for a dataclass.""" + with self.defs.get_schema_or_ref(dataclass) as (dataclass_ref, maybe_schema): + if maybe_schema is not None: + return maybe_schema + + typevars_map = get_standard_typevars_map(dataclass) + if origin is not None: + dataclass = origin + + config = getattr(dataclass, '__pydantic_config__', None) + with self._config_wrapper_stack.push(config), self._types_namespace_stack.push(dataclass): + core_config = self._config_wrapper.core_config(dataclass) + + self = self._current_generate_schema + + from ..dataclasses import is_pydantic_dataclass + + if is_pydantic_dataclass(dataclass): + fields = deepcopy(dataclass.__pydantic_fields__) + if typevars_map: + for field in fields.values(): + field.apply_typevars_map(typevars_map, self._types_namespace) + else: + fields = collect_dataclass_fields( + dataclass, + self._types_namespace, + typevars_map=typevars_map, + ) + + # disallow combination of init=False on a dataclass field and extra='allow' on a dataclass + if config and config.get('extra') == 'allow': + # disallow combination of init=False on a dataclass field and extra='allow' on a dataclass + for field_name, field in fields.items(): + if field.init is False: + raise PydanticUserError( + f'Field {field_name} has `init=False` and dataclass has config setting `extra="allow"`. ' + f'This combination is not allowed.', + code='dataclass-init-false-extra-allow', + ) + + decorators = dataclass.__dict__.get('__pydantic_decorators__') or DecoratorInfos.build(dataclass) + # Move kw_only=False args to the start of the list, as this is how vanilla dataclasses work. + # Note that when kw_only is missing or None, it is treated as equivalent to kw_only=True + args = sorted( + (self._generate_dc_field_schema(k, v, decorators) for k, v in fields.items()), + key=lambda a: a.get('kw_only') is not False, + ) + has_post_init = hasattr(dataclass, '__post_init__') + has_slots = hasattr(dataclass, '__slots__') + + args_schema = core_schema.dataclass_args_schema( + dataclass.__name__, + args, + computed_fields=[ + self._computed_field_schema(d, decorators.field_serializers) + for d in decorators.computed_fields.values() + ], + collect_init_only=has_post_init, + ) + + inner_schema = apply_validators(args_schema, decorators.root_validators.values(), None) + + model_validators = decorators.model_validators.values() + inner_schema = apply_model_validators(inner_schema, model_validators, 'inner') + + dc_schema = core_schema.dataclass_schema( + dataclass, + inner_schema, + post_init=has_post_init, + ref=dataclass_ref, + fields=[field.name for field in dataclasses.fields(dataclass)], + slots=has_slots, + config=core_config, + ) + schema = self._apply_model_serializers(dc_schema, decorators.model_serializers.values()) + schema = apply_model_validators(schema, model_validators, 'outer') + self.defs.definitions[dataclass_ref] = self._post_process_generated_schema(schema) + return core_schema.definition_reference_schema(dataclass_ref) + + def _callable_schema(self, function: Callable[..., Any]) -> core_schema.CallSchema: + """Generate schema for a Callable. + + TODO support functional validators once we support them in Config + """ + sig = signature(function) + + type_hints = _typing_extra.get_function_type_hints(function) + + mode_lookup: dict[_ParameterKind, Literal['positional_only', 'positional_or_keyword', 'keyword_only']] = { + Parameter.POSITIONAL_ONLY: 'positional_only', + Parameter.POSITIONAL_OR_KEYWORD: 'positional_or_keyword', + Parameter.KEYWORD_ONLY: 'keyword_only', + } + + arguments_list: list[core_schema.ArgumentsParameter] = [] + var_args_schema: core_schema.CoreSchema | None = None + var_kwargs_schema: core_schema.CoreSchema | None = None + + for name, p in sig.parameters.items(): + if p.annotation is sig.empty: + annotation = Any + else: + annotation = type_hints[name] + + parameter_mode = mode_lookup.get(p.kind) + if parameter_mode is not None: + arg_schema = self._generate_parameter_schema(name, annotation, p.default, parameter_mode) + arguments_list.append(arg_schema) + elif p.kind == Parameter.VAR_POSITIONAL: + var_args_schema = self.generate_schema(annotation) + else: + assert p.kind == Parameter.VAR_KEYWORD, p.kind + var_kwargs_schema = self.generate_schema(annotation) + + return_schema: core_schema.CoreSchema | None = None + config_wrapper = self._config_wrapper + if config_wrapper.validate_return: + return_hint = type_hints.get('return') + if return_hint is not None: + return_schema = self.generate_schema(return_hint) + + return core_schema.call_schema( + core_schema.arguments_schema( + arguments_list, + var_args_schema=var_args_schema, + var_kwargs_schema=var_kwargs_schema, + populate_by_name=config_wrapper.populate_by_name, + ), + function, + return_schema=return_schema, + ) + + def _unsubstituted_typevar_schema(self, typevar: typing.TypeVar) -> core_schema.CoreSchema: + assert isinstance(typevar, typing.TypeVar) + + bound = typevar.__bound__ + constraints = typevar.__constraints__ + default = getattr(typevar, '__default__', None) + + if (bound is not None) + (len(constraints) != 0) + (default is not None) > 1: + raise NotImplementedError( + 'Pydantic does not support mixing more than one of TypeVar bounds, constraints and defaults' + ) + + if default is not None: + return self.generate_schema(default) + elif constraints: + return self._union_schema(typing.Union[constraints]) # type: ignore + elif bound: + schema = self.generate_schema(bound) + schema['serialization'] = core_schema.wrap_serializer_function_ser_schema( + lambda x, h: h(x), schema=core_schema.any_schema() + ) + return schema + else: + return core_schema.any_schema() + + def _computed_field_schema( + self, + d: Decorator[ComputedFieldInfo], + field_serializers: dict[str, Decorator[FieldSerializerDecoratorInfo]], + ) -> core_schema.ComputedField: + try: + return_type = _decorators.get_function_return_type(d.func, d.info.return_type, self._types_namespace) + except NameError as e: + raise PydanticUndefinedAnnotation.from_name_error(e) from e + if return_type is PydanticUndefined: + raise PydanticUserError( + 'Computed field is missing return type annotation or specifying `return_type`' + ' to the `@computed_field` decorator (e.g. `@computed_field(return_type=int|str)`)', + code='model-field-missing-annotation', + ) + + return_type = replace_types(return_type, self._typevars_map) + # Create a new ComputedFieldInfo so that different type parametrizations of the same + # generic model's computed field can have different return types. + d.info = dataclasses.replace(d.info, return_type=return_type) + return_type_schema = self.generate_schema(return_type) + # Apply serializers to computed field if there exist + return_type_schema = self._apply_field_serializers( + return_type_schema, + filter_field_decorator_info_by_field(field_serializers.values(), d.cls_var_name), + computed_field=True, + ) + + alias_generator = self._config_wrapper.alias_generator + if alias_generator is not None: + self._apply_alias_generator_to_computed_field_info( + alias_generator=alias_generator, computed_field_info=d.info, computed_field_name=d.cls_var_name + ) + + def set_computed_field_metadata(schema: CoreSchemaOrField, handler: GetJsonSchemaHandler) -> JsonSchemaValue: + json_schema = handler(schema) + + json_schema['readOnly'] = True + + title = d.info.title + if title is not None: + json_schema['title'] = title + + description = d.info.description + if description is not None: + json_schema['description'] = description + + examples = d.info.examples + if examples is not None: + json_schema['examples'] = to_jsonable_python(examples) + + json_schema_extra = d.info.json_schema_extra + if json_schema_extra is not None: + add_json_schema_extra(json_schema, json_schema_extra) + + return json_schema + + metadata = build_metadata_dict(js_annotation_functions=[set_computed_field_metadata]) + return core_schema.computed_field( + d.cls_var_name, return_schema=return_type_schema, alias=d.info.alias, metadata=metadata + ) + + def _annotated_schema(self, annotated_type: Any) -> core_schema.CoreSchema: + """Generate schema for an Annotated type, e.g. `Annotated[int, Field(...)]` or `Annotated[int, Gt(0)]`.""" + from ..fields import FieldInfo + + source_type, *annotations = self._get_args_resolving_forward_refs( + annotated_type, + required=True, + ) + schema = self._apply_annotations(source_type, annotations) + # put the default validator last so that TypeAdapter.get_default_value() works + # even if there are function validators involved + for annotation in annotations: + if isinstance(annotation, FieldInfo): + schema = wrap_default(annotation, schema) + return schema + + def _get_prepare_pydantic_annotations_for_known_type( + self, obj: Any, annotations: tuple[Any, ...] + ) -> tuple[Any, list[Any]] | None: + from ._std_types_schema import PREPARE_METHODS + + # Check for hashability + try: + hash(obj) + except TypeError: + # obj is definitely not a known type if this fails + return None + + for gen in PREPARE_METHODS: + res = gen(obj, annotations, self._config_wrapper.config_dict) + if res is not None: + return res + + return None + + def _apply_annotations( + self, + source_type: Any, + annotations: list[Any], + transform_inner_schema: Callable[[CoreSchema], CoreSchema] = lambda x: x, + ) -> CoreSchema: + """Apply arguments from `Annotated` or from `FieldInfo` to a schema. + + This gets called by `GenerateSchema._annotated_schema` but differs from it in that it does + not expect `source_type` to be an `Annotated` object, it expects it to be the first argument of that + (in other words, `GenerateSchema._annotated_schema` just unpacks `Annotated`, this process it). + """ + annotations = list(_known_annotated_metadata.expand_grouped_metadata(annotations)) + res = self._get_prepare_pydantic_annotations_for_known_type(source_type, tuple(annotations)) + if res is not None: + source_type, annotations = res + + pydantic_js_annotation_functions: list[GetJsonSchemaFunction] = [] + + def inner_handler(obj: Any) -> CoreSchema: + from_property = self._generate_schema_from_property(obj, obj) + if from_property is None: + schema = self._generate_schema(obj) + else: + schema = from_property + metadata_js_function = _extract_get_pydantic_json_schema(obj, schema) + if metadata_js_function is not None: + metadata_schema = resolve_original_schema(schema, self.defs.definitions) + if metadata_schema is not None: + self._add_js_function(metadata_schema, metadata_js_function) + return transform_inner_schema(schema) + + get_inner_schema = CallbackGetCoreSchemaHandler(inner_handler, self) + + for annotation in annotations: + if annotation is None: + continue + get_inner_schema = self._get_wrapped_inner_schema( + get_inner_schema, annotation, pydantic_js_annotation_functions + ) + + schema = get_inner_schema(source_type) + if pydantic_js_annotation_functions: + metadata = CoreMetadataHandler(schema).metadata + metadata.setdefault('pydantic_js_annotation_functions', []).extend(pydantic_js_annotation_functions) + return _add_custom_serialization_from_json_encoders(self._config_wrapper.json_encoders, source_type, schema) + + def _apply_single_annotation(self, schema: core_schema.CoreSchema, metadata: Any) -> core_schema.CoreSchema: + from ..fields import FieldInfo + + if isinstance(metadata, FieldInfo): + for field_metadata in metadata.metadata: + schema = self._apply_single_annotation(schema, field_metadata) + + if metadata.discriminator is not None: + schema = self._apply_discriminator_to_union(schema, metadata.discriminator) + return schema + + if schema['type'] == 'nullable': + # for nullable schemas, metadata is automatically applied to the inner schema + inner = schema.get('schema', core_schema.any_schema()) + inner = self._apply_single_annotation(inner, metadata) + if inner: + schema['schema'] = inner + return schema + + original_schema = schema + ref = schema.get('ref', None) + if ref is not None: + schema = schema.copy() + new_ref = ref + f'_{repr(metadata)}' + if new_ref in self.defs.definitions: + return self.defs.definitions[new_ref] + schema['ref'] = new_ref # type: ignore + elif schema['type'] == 'definition-ref': + ref = schema['schema_ref'] + if ref in self.defs.definitions: + schema = self.defs.definitions[ref].copy() + new_ref = ref + f'_{repr(metadata)}' + if new_ref in self.defs.definitions: + return self.defs.definitions[new_ref] + schema['ref'] = new_ref # type: ignore + + maybe_updated_schema = _known_annotated_metadata.apply_known_metadata(metadata, schema.copy()) + + if maybe_updated_schema is not None: + return maybe_updated_schema + return original_schema + + def _apply_single_annotation_json_schema( + self, schema: core_schema.CoreSchema, metadata: Any + ) -> core_schema.CoreSchema: + from ..fields import FieldInfo + + if isinstance(metadata, FieldInfo): + for field_metadata in metadata.metadata: + schema = self._apply_single_annotation_json_schema(schema, field_metadata) + json_schema_update: JsonSchemaValue = {} + if metadata.title: + json_schema_update['title'] = metadata.title + if metadata.description: + json_schema_update['description'] = metadata.description + if metadata.examples: + json_schema_update['examples'] = to_jsonable_python(metadata.examples) + + json_schema_extra = metadata.json_schema_extra + if json_schema_update or json_schema_extra: + CoreMetadataHandler(schema).metadata.setdefault('pydantic_js_annotation_functions', []).append( + get_json_schema_update_func(json_schema_update, json_schema_extra) + ) + return schema + + def _get_wrapped_inner_schema( + self, + get_inner_schema: GetCoreSchemaHandler, + annotation: Any, + pydantic_js_annotation_functions: list[GetJsonSchemaFunction], + ) -> CallbackGetCoreSchemaHandler: + metadata_get_schema: GetCoreSchemaFunction = getattr(annotation, '__get_pydantic_core_schema__', None) or ( + lambda source, handler: handler(source) + ) + + def new_handler(source: Any) -> core_schema.CoreSchema: + schema = metadata_get_schema(source, get_inner_schema) + schema = self._apply_single_annotation(schema, annotation) + schema = self._apply_single_annotation_json_schema(schema, annotation) + + metadata_js_function = _extract_get_pydantic_json_schema(annotation, schema) + if metadata_js_function is not None: + pydantic_js_annotation_functions.append(metadata_js_function) + return schema + + return CallbackGetCoreSchemaHandler(new_handler, self) + + def _apply_field_serializers( + self, + schema: core_schema.CoreSchema, + serializers: list[Decorator[FieldSerializerDecoratorInfo]], + computed_field: bool = False, + ) -> core_schema.CoreSchema: + """Apply field serializers to a schema.""" + if serializers: + schema = copy(schema) + if schema['type'] == 'definitions': + inner_schema = schema['schema'] + schema['schema'] = self._apply_field_serializers(inner_schema, serializers) + return schema + else: + ref = typing.cast('str|None', schema.get('ref', None)) + if ref is not None: + schema = core_schema.definition_reference_schema(ref) + + # use the last serializer to make it easy to override a serializer set on a parent model + serializer = serializers[-1] + is_field_serializer, info_arg = inspect_field_serializer( + serializer.func, serializer.info.mode, computed_field=computed_field + ) + + try: + return_type = _decorators.get_function_return_type( + serializer.func, serializer.info.return_type, self._types_namespace + ) + except NameError as e: + raise PydanticUndefinedAnnotation.from_name_error(e) from e + + if return_type is PydanticUndefined: + return_schema = None + else: + return_schema = self.generate_schema(return_type) + + if serializer.info.mode == 'wrap': + schema['serialization'] = core_schema.wrap_serializer_function_ser_schema( + serializer.func, + is_field_serializer=is_field_serializer, + info_arg=info_arg, + return_schema=return_schema, + when_used=serializer.info.when_used, + ) + else: + assert serializer.info.mode == 'plain' + schema['serialization'] = core_schema.plain_serializer_function_ser_schema( + serializer.func, + is_field_serializer=is_field_serializer, + info_arg=info_arg, + return_schema=return_schema, + when_used=serializer.info.when_used, + ) + return schema + + def _apply_model_serializers( + self, schema: core_schema.CoreSchema, serializers: Iterable[Decorator[ModelSerializerDecoratorInfo]] + ) -> core_schema.CoreSchema: + """Apply model serializers to a schema.""" + ref: str | None = schema.pop('ref', None) # type: ignore + if serializers: + serializer = list(serializers)[-1] + info_arg = inspect_model_serializer(serializer.func, serializer.info.mode) + + try: + return_type = _decorators.get_function_return_type( + serializer.func, serializer.info.return_type, self._types_namespace + ) + except NameError as e: + raise PydanticUndefinedAnnotation.from_name_error(e) from e + if return_type is PydanticUndefined: + return_schema = None + else: + return_schema = self.generate_schema(return_type) + + if serializer.info.mode == 'wrap': + ser_schema: core_schema.SerSchema = core_schema.wrap_serializer_function_ser_schema( + serializer.func, + info_arg=info_arg, + return_schema=return_schema, + when_used=serializer.info.when_used, + ) + else: + # plain + ser_schema = core_schema.plain_serializer_function_ser_schema( + serializer.func, + info_arg=info_arg, + return_schema=return_schema, + when_used=serializer.info.when_used, + ) + schema['serialization'] = ser_schema + if ref: + schema['ref'] = ref # type: ignore + return schema + + +_VALIDATOR_F_MATCH: Mapping[ + tuple[FieldValidatorModes, Literal['no-info', 'with-info']], + Callable[[Callable[..., Any], core_schema.CoreSchema, str | None], core_schema.CoreSchema], +] = { + ('before', 'no-info'): lambda f, schema, _: core_schema.no_info_before_validator_function(f, schema), + ('after', 'no-info'): lambda f, schema, _: core_schema.no_info_after_validator_function(f, schema), + ('plain', 'no-info'): lambda f, _1, _2: core_schema.no_info_plain_validator_function(f), + ('wrap', 'no-info'): lambda f, schema, _: core_schema.no_info_wrap_validator_function(f, schema), + ('before', 'with-info'): lambda f, schema, field_name: core_schema.with_info_before_validator_function( + f, schema, field_name=field_name + ), + ('after', 'with-info'): lambda f, schema, field_name: core_schema.with_info_after_validator_function( + f, schema, field_name=field_name + ), + ('plain', 'with-info'): lambda f, _, field_name: core_schema.with_info_plain_validator_function( + f, field_name=field_name + ), + ('wrap', 'with-info'): lambda f, schema, field_name: core_schema.with_info_wrap_validator_function( + f, schema, field_name=field_name + ), +} + + +def apply_validators( + schema: core_schema.CoreSchema, + validators: Iterable[Decorator[RootValidatorDecoratorInfo]] + | Iterable[Decorator[ValidatorDecoratorInfo]] + | Iterable[Decorator[FieldValidatorDecoratorInfo]], + field_name: str | None, +) -> core_schema.CoreSchema: + """Apply validators to a schema. + + Args: + schema: The schema to apply validators on. + validators: An iterable of validators. + field_name: The name of the field if validators are being applied to a model field. + + Returns: + The updated schema. + """ + for validator in validators: + info_arg = inspect_validator(validator.func, validator.info.mode) + val_type = 'with-info' if info_arg else 'no-info' + + schema = _VALIDATOR_F_MATCH[(validator.info.mode, val_type)](validator.func, schema, field_name) + return schema + + +def _validators_require_validate_default(validators: Iterable[Decorator[ValidatorDecoratorInfo]]) -> bool: + """In v1, if any of the validators for a field had `always=True`, the default value would be validated. + + This serves as an auxiliary function for re-implementing that logic, by looping over a provided + collection of (v1-style) ValidatorDecoratorInfo's and checking if any of them have `always=True`. + + We should be able to drop this function and the associated logic calling it once we drop support + for v1-style validator decorators. (Or we can extend it and keep it if we add something equivalent + to the v1-validator `always` kwarg to `field_validator`.) + """ + for validator in validators: + if validator.info.always: + return True + return False + + +def apply_model_validators( + schema: core_schema.CoreSchema, + validators: Iterable[Decorator[ModelValidatorDecoratorInfo]], + mode: Literal['inner', 'outer', 'all'], +) -> core_schema.CoreSchema: + """Apply model validators to a schema. + + If mode == 'inner', only "before" validators are applied + If mode == 'outer', validators other than "before" are applied + If mode == 'all', all validators are applied + + Args: + schema: The schema to apply validators on. + validators: An iterable of validators. + mode: The validator mode. + + Returns: + The updated schema. + """ + ref: str | None = schema.pop('ref', None) # type: ignore + for validator in validators: + if mode == 'inner' and validator.info.mode != 'before': + continue + if mode == 'outer' and validator.info.mode == 'before': + continue + info_arg = inspect_validator(validator.func, validator.info.mode) + if validator.info.mode == 'wrap': + if info_arg: + schema = core_schema.with_info_wrap_validator_function(function=validator.func, schema=schema) + else: + schema = core_schema.no_info_wrap_validator_function(function=validator.func, schema=schema) + elif validator.info.mode == 'before': + if info_arg: + schema = core_schema.with_info_before_validator_function(function=validator.func, schema=schema) + else: + schema = core_schema.no_info_before_validator_function(function=validator.func, schema=schema) + else: + assert validator.info.mode == 'after' + if info_arg: + schema = core_schema.with_info_after_validator_function(function=validator.func, schema=schema) + else: + schema = core_schema.no_info_after_validator_function(function=validator.func, schema=schema) + if ref: + schema['ref'] = ref # type: ignore + return schema + + +def wrap_default(field_info: FieldInfo, schema: core_schema.CoreSchema) -> core_schema.CoreSchema: + """Wrap schema with default schema if default value or `default_factory` are available. + + Args: + field_info: The field info object. + schema: The schema to apply default on. + + Returns: + Updated schema by default value or `default_factory`. + """ + if field_info.default_factory: + return core_schema.with_default_schema( + schema, default_factory=field_info.default_factory, validate_default=field_info.validate_default + ) + elif field_info.default is not PydanticUndefined: + return core_schema.with_default_schema( + schema, default=field_info.default, validate_default=field_info.validate_default + ) + else: + return schema + + +def _extract_get_pydantic_json_schema(tp: Any, schema: CoreSchema) -> GetJsonSchemaFunction | None: + """Extract `__get_pydantic_json_schema__` from a type, handling the deprecated `__modify_schema__`.""" + js_modify_function = getattr(tp, '__get_pydantic_json_schema__', None) + + if hasattr(tp, '__modify_schema__'): + from pydantic import BaseModel # circular reference + + has_custom_v2_modify_js_func = ( + js_modify_function is not None + and BaseModel.__get_pydantic_json_schema__.__func__ # type: ignore + not in (js_modify_function, getattr(js_modify_function, '__func__', None)) + ) + + if not has_custom_v2_modify_js_func: + raise PydanticUserError( + 'The `__modify_schema__` method is not supported in Pydantic v2. ' + 'Use `__get_pydantic_json_schema__` instead.', + code='custom-json-schema', + ) + + # handle GenericAlias' but ignore Annotated which "lies" about its origin (in this case it would be `int`) + if hasattr(tp, '__origin__') and not isinstance(tp, type(Annotated[int, 'placeholder'])): + return _extract_get_pydantic_json_schema(tp.__origin__, schema) + + if js_modify_function is None: + return None + + return js_modify_function + + +def get_json_schema_update_func( + json_schema_update: JsonSchemaValue, json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None +) -> GetJsonSchemaFunction: + def json_schema_update_func( + core_schema_or_field: CoreSchemaOrField, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + json_schema = {**handler(core_schema_or_field), **json_schema_update} + add_json_schema_extra(json_schema, json_schema_extra) + return json_schema + + return json_schema_update_func + + +def add_json_schema_extra( + json_schema: JsonSchemaValue, json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None +): + if isinstance(json_schema_extra, dict): + json_schema.update(to_jsonable_python(json_schema_extra)) + elif callable(json_schema_extra): + json_schema_extra(json_schema) + + +class _CommonField(TypedDict): + schema: core_schema.CoreSchema + validation_alias: str | list[str | int] | list[list[str | int]] | None + serialization_alias: str | None + serialization_exclude: bool | None + frozen: bool | None + metadata: dict[str, Any] + + +def _common_field( + schema: core_schema.CoreSchema, + *, + validation_alias: str | list[str | int] | list[list[str | int]] | None = None, + serialization_alias: str | None = None, + serialization_exclude: bool | None = None, + frozen: bool | None = None, + metadata: Any = None, +) -> _CommonField: + return { + 'schema': schema, + 'validation_alias': validation_alias, + 'serialization_alias': serialization_alias, + 'serialization_exclude': serialization_exclude, + 'frozen': frozen, + 'metadata': metadata, + } + + +class _Definitions: + """Keeps track of references and definitions.""" + + def __init__(self) -> None: + self.seen: set[str] = set() + self.definitions: dict[str, core_schema.CoreSchema] = {} + + @contextmanager + def get_schema_or_ref(self, tp: Any) -> Iterator[tuple[str, None] | tuple[str, CoreSchema]]: + """Get a definition for `tp` if one exists. + + If a definition exists, a tuple of `(ref_string, CoreSchema)` is returned. + If no definition exists yet, a tuple of `(ref_string, None)` is returned. + + Note that the returned `CoreSchema` will always be a `DefinitionReferenceSchema`, + not the actual definition itself. + + This should be called for any type that can be identified by reference. + This includes any recursive types. + + At present the following types can be named/recursive: + + - BaseModel + - Dataclasses + - TypedDict + - TypeAliasType + """ + ref = get_type_ref(tp) + # return the reference if we're either (1) in a cycle or (2) it was already defined + if ref in self.seen or ref in self.definitions: + yield (ref, core_schema.definition_reference_schema(ref)) + else: + self.seen.add(ref) + try: + yield (ref, None) + finally: + self.seen.discard(ref) + + +def resolve_original_schema(schema: CoreSchema, definitions: dict[str, CoreSchema]) -> CoreSchema | None: + if schema['type'] == 'definition-ref': + return definitions.get(schema['schema_ref'], None) + elif schema['type'] == 'definitions': + return schema['schema'] + else: + return schema + + +class _FieldNameStack: + __slots__ = ('_stack',) + + def __init__(self) -> None: + self._stack: list[str] = [] + + @contextmanager + def push(self, field_name: str) -> Iterator[None]: + self._stack.append(field_name) + yield + self._stack.pop() + + def get(self) -> str | None: + if self._stack: + return self._stack[-1] + else: + return None diff --git a/lib/pydantic/_internal/_generics.py b/lib/pydantic/_internal/_generics.py new file mode 100644 index 00000000..5a66eaa9 --- /dev/null +++ b/lib/pydantic/_internal/_generics.py @@ -0,0 +1,517 @@ +from __future__ import annotations + +import sys +import types +import typing +from collections import ChainMap +from contextlib import contextmanager +from contextvars import ContextVar +from types import prepare_class +from typing import TYPE_CHECKING, Any, Iterator, List, Mapping, MutableMapping, Tuple, TypeVar +from weakref import WeakValueDictionary + +import typing_extensions + +from ._core_utils import get_type_ref +from ._forward_ref import PydanticRecursiveRef +from ._typing_extra import TypeVarType, typing_base +from ._utils import all_identical, is_model_class + +if sys.version_info >= (3, 10): + from typing import _UnionGenericAlias # type: ignore[attr-defined] + +if TYPE_CHECKING: + from ..main import BaseModel + +GenericTypesCacheKey = Tuple[Any, Any, Tuple[Any, ...]] + +# Note: We want to remove LimitedDict, but to do this, we'd need to improve the handling of generics caching. +# Right now, to handle recursive generics, we some types must remain cached for brief periods without references. +# By chaining the WeakValuesDict with a LimitedDict, we have a way to retain caching for all types with references, +# while also retaining a limited number of types even without references. This is generally enough to build +# specific recursive generic models without losing required items out of the cache. + +KT = TypeVar('KT') +VT = TypeVar('VT') +_LIMITED_DICT_SIZE = 100 +if TYPE_CHECKING: + + class LimitedDict(dict, MutableMapping[KT, VT]): + def __init__(self, size_limit: int = _LIMITED_DICT_SIZE): + ... + +else: + + class LimitedDict(dict): + """Limit the size/length of a dict used for caching to avoid unlimited increase in memory usage. + + Since the dict is ordered, and we always remove elements from the beginning, this is effectively a FIFO cache. + """ + + def __init__(self, size_limit: int = _LIMITED_DICT_SIZE): + self.size_limit = size_limit + super().__init__() + + def __setitem__(self, __key: Any, __value: Any) -> None: + super().__setitem__(__key, __value) + if len(self) > self.size_limit: + excess = len(self) - self.size_limit + self.size_limit // 10 + to_remove = list(self.keys())[:excess] + for key in to_remove: + del self[key] + + +# weak dictionaries allow the dynamically created parametrized versions of generic models to get collected +# once they are no longer referenced by the caller. +if sys.version_info >= (3, 9): # Typing for weak dictionaries available at 3.9 + GenericTypesCache = WeakValueDictionary[GenericTypesCacheKey, 'type[BaseModel]'] +else: + GenericTypesCache = WeakValueDictionary + +if TYPE_CHECKING: + + class DeepChainMap(ChainMap[KT, VT]): # type: ignore + ... + +else: + + class DeepChainMap(ChainMap): + """Variant of ChainMap that allows direct updates to inner scopes. + + Taken from https://docs.python.org/3/library/collections.html#collections.ChainMap, + with some light modifications for this use case. + """ + + def clear(self) -> None: + for mapping in self.maps: + mapping.clear() + + def __setitem__(self, key: KT, value: VT) -> None: + for mapping in self.maps: + mapping[key] = value + + def __delitem__(self, key: KT) -> None: + hit = False + for mapping in self.maps: + if key in mapping: + del mapping[key] + hit = True + if not hit: + raise KeyError(key) + + +# Despite the fact that LimitedDict _seems_ no longer necessary, I'm very nervous to actually remove it +# and discover later on that we need to re-add all this infrastructure... +# _GENERIC_TYPES_CACHE = DeepChainMap(GenericTypesCache(), LimitedDict()) + +_GENERIC_TYPES_CACHE = GenericTypesCache() + + +class PydanticGenericMetadata(typing_extensions.TypedDict): + origin: type[BaseModel] | None # analogous to typing._GenericAlias.__origin__ + args: tuple[Any, ...] # analogous to typing._GenericAlias.__args__ + parameters: tuple[type[Any], ...] # analogous to typing.Generic.__parameters__ + + +def create_generic_submodel( + model_name: str, origin: type[BaseModel], args: tuple[Any, ...], params: tuple[Any, ...] +) -> type[BaseModel]: + """Dynamically create a submodel of a provided (generic) BaseModel. + + This is used when producing concrete parametrizations of generic models. This function + only *creates* the new subclass; the schema/validators/serialization must be updated to + reflect a concrete parametrization elsewhere. + + Args: + model_name: The name of the newly created model. + origin: The base class for the new model to inherit from. + args: A tuple of generic metadata arguments. + params: A tuple of generic metadata parameters. + + Returns: + The created submodel. + """ + namespace: dict[str, Any] = {'__module__': origin.__module__} + bases = (origin,) + meta, ns, kwds = prepare_class(model_name, bases) + namespace.update(ns) + created_model = meta( + model_name, + bases, + namespace, + __pydantic_generic_metadata__={ + 'origin': origin, + 'args': args, + 'parameters': params, + }, + __pydantic_reset_parent_namespace__=False, + **kwds, + ) + + model_module, called_globally = _get_caller_frame_info(depth=3) + if called_globally: # create global reference and therefore allow pickling + object_by_reference = None + reference_name = model_name + reference_module_globals = sys.modules[created_model.__module__].__dict__ + while object_by_reference is not created_model: + object_by_reference = reference_module_globals.setdefault(reference_name, created_model) + reference_name += '_' + + return created_model + + +def _get_caller_frame_info(depth: int = 2) -> tuple[str | None, bool]: + """Used inside a function to check whether it was called globally. + + Args: + depth: The depth to get the frame. + + Returns: + A tuple contains `module_name` and `called_globally`. + + Raises: + RuntimeError: If the function is not called inside a function. + """ + try: + previous_caller_frame = sys._getframe(depth) + except ValueError as e: + raise RuntimeError('This function must be used inside another function') from e + except AttributeError: # sys module does not have _getframe function, so there's nothing we can do about it + return None, False + frame_globals = previous_caller_frame.f_globals + return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals + + +DictValues: type[Any] = {}.values().__class__ + + +def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]: + """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found. + + This is inspired as an alternative to directly accessing the `__parameters__` attribute of a GenericAlias, + since __parameters__ of (nested) generic BaseModel subclasses won't show up in that list. + """ + if isinstance(v, TypeVar): + yield v + elif is_model_class(v): + yield from v.__pydantic_generic_metadata__['parameters'] + elif isinstance(v, (DictValues, list)): + for var in v: + yield from iter_contained_typevars(var) + else: + args = get_args(v) + for arg in args: + yield from iter_contained_typevars(arg) + + +def get_args(v: Any) -> Any: + pydantic_generic_metadata: PydanticGenericMetadata | None = getattr(v, '__pydantic_generic_metadata__', None) + if pydantic_generic_metadata: + return pydantic_generic_metadata.get('args') + return typing_extensions.get_args(v) + + +def get_origin(v: Any) -> Any: + pydantic_generic_metadata: PydanticGenericMetadata | None = getattr(v, '__pydantic_generic_metadata__', None) + if pydantic_generic_metadata: + return pydantic_generic_metadata.get('origin') + return typing_extensions.get_origin(v) + + +def get_standard_typevars_map(cls: type[Any]) -> dict[TypeVarType, Any] | None: + """Package a generic type's typevars and parametrization (if present) into a dictionary compatible with the + `replace_types` function. Specifically, this works with standard typing generics and typing._GenericAlias. + """ + origin = get_origin(cls) + if origin is None: + return None + if not hasattr(origin, '__parameters__'): + return None + + # In this case, we know that cls is a _GenericAlias, and origin is the generic type + # So it is safe to access cls.__args__ and origin.__parameters__ + args: tuple[Any, ...] = cls.__args__ # type: ignore + parameters: tuple[TypeVarType, ...] = origin.__parameters__ + return dict(zip(parameters, args)) + + +def get_model_typevars_map(cls: type[BaseModel]) -> dict[TypeVarType, Any] | None: + """Package a generic BaseModel's typevars and concrete parametrization (if present) into a dictionary compatible + with the `replace_types` function. + + Since BaseModel.__class_getitem__ does not produce a typing._GenericAlias, and the BaseModel generic info is + stored in the __pydantic_generic_metadata__ attribute, we need special handling here. + """ + # TODO: This could be unified with `get_standard_typevars_map` if we stored the generic metadata + # in the __origin__, __args__, and __parameters__ attributes of the model. + generic_metadata = cls.__pydantic_generic_metadata__ + origin = generic_metadata['origin'] + args = generic_metadata['args'] + return dict(zip(iter_contained_typevars(origin), args)) + + +def replace_types(type_: Any, type_map: Mapping[Any, Any] | None) -> Any: + """Return type with all occurrences of `type_map` keys recursively replaced with their values. + + Args: + type_: The class or generic alias. + type_map: Mapping from `TypeVar` instance to concrete types. + + Returns: + A new type representing the basic structure of `type_` with all + `typevar_map` keys recursively replaced. + + Example: + ```py + from typing import List, Tuple, Union + + from pydantic._internal._generics import replace_types + + replace_types(Tuple[str, Union[List[str], float]], {str: int}) + #> Tuple[int, Union[List[int], float]] + ``` + """ + if not type_map: + return type_ + + type_args = get_args(type_) + origin_type = get_origin(type_) + + if origin_type is typing_extensions.Annotated: + annotated_type, *annotations = type_args + annotated = replace_types(annotated_type, type_map) + for annotation in annotations: + annotated = typing_extensions.Annotated[annotated, annotation] + return annotated + + # Having type args is a good indicator that this is a typing module + # class instantiation or a generic alias of some sort. + if type_args: + resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args) + if all_identical(type_args, resolved_type_args): + # If all arguments are the same, there is no need to modify the + # type or create a new object at all + return type_ + if ( + origin_type is not None + and isinstance(type_, typing_base) + and not isinstance(origin_type, typing_base) + and getattr(type_, '_name', None) is not None + ): + # In python < 3.9 generic aliases don't exist so any of these like `list`, + # `type` or `collections.abc.Callable` need to be translated. + # See: https://www.python.org/dev/peps/pep-0585 + origin_type = getattr(typing, type_._name) + assert origin_type is not None + # PEP-604 syntax (Ex.: list | str) is represented with a types.UnionType object that does not have __getitem__. + # We also cannot use isinstance() since we have to compare types. + if sys.version_info >= (3, 10) and origin_type is types.UnionType: + return _UnionGenericAlias(origin_type, resolved_type_args) + # NotRequired[T] and Required[T] don't support tuple type resolved_type_args, hence the condition below + return origin_type[resolved_type_args[0] if len(resolved_type_args) == 1 else resolved_type_args] + + # We handle pydantic generic models separately as they don't have the same + # semantics as "typing" classes or generic aliases + + if not origin_type and is_model_class(type_): + parameters = type_.__pydantic_generic_metadata__['parameters'] + if not parameters: + return type_ + resolved_type_args = tuple(replace_types(t, type_map) for t in parameters) + if all_identical(parameters, resolved_type_args): + return type_ + return type_[resolved_type_args] + + # Handle special case for typehints that can have lists as arguments. + # `typing.Callable[[int, str], int]` is an example for this. + if isinstance(type_, (List, list)): + resolved_list = list(replace_types(element, type_map) for element in type_) + if all_identical(type_, resolved_list): + return type_ + return resolved_list + + # If all else fails, we try to resolve the type directly and otherwise just + # return the input with no modifications. + return type_map.get(type_, type_) + + +def has_instance_in_type(type_: Any, isinstance_target: Any) -> bool: + """Checks if the type, or any of its arbitrary nested args, satisfy + `isinstance(, isinstance_target)`. + """ + if isinstance(type_, isinstance_target): + return True + + type_args = get_args(type_) + origin_type = get_origin(type_) + + if origin_type is typing_extensions.Annotated: + annotated_type, *annotations = type_args + return has_instance_in_type(annotated_type, isinstance_target) + + # Having type args is a good indicator that this is a typing module + # class instantiation or a generic alias of some sort. + if any(has_instance_in_type(a, isinstance_target) for a in type_args): + return True + + # Handle special case for typehints that can have lists as arguments. + # `typing.Callable[[int, str], int]` is an example for this. + if isinstance(type_, (List, list)) and not isinstance(type_, typing_extensions.ParamSpec): + if any(has_instance_in_type(element, isinstance_target) for element in type_): + return True + + return False + + +def check_parameters_count(cls: type[BaseModel], parameters: tuple[Any, ...]) -> None: + """Check the generic model parameters count is equal. + + Args: + cls: The generic model. + parameters: A tuple of passed parameters to the generic model. + + Raises: + TypeError: If the passed parameters count is not equal to generic model parameters count. + """ + actual = len(parameters) + expected = len(cls.__pydantic_generic_metadata__['parameters']) + if actual != expected: + description = 'many' if actual > expected else 'few' + raise TypeError(f'Too {description} parameters for {cls}; actual {actual}, expected {expected}') + + +_generic_recursion_cache: ContextVar[set[str] | None] = ContextVar('_generic_recursion_cache', default=None) + + +@contextmanager +def generic_recursion_self_type( + origin: type[BaseModel], args: tuple[Any, ...] +) -> Iterator[PydanticRecursiveRef | None]: + """This contextmanager should be placed around the recursive calls used to build a generic type, + and accept as arguments the generic origin type and the type arguments being passed to it. + + If the same origin and arguments are observed twice, it implies that a self-reference placeholder + can be used while building the core schema, and will produce a schema_ref that will be valid in the + final parent schema. + """ + previously_seen_type_refs = _generic_recursion_cache.get() + if previously_seen_type_refs is None: + previously_seen_type_refs = set() + token = _generic_recursion_cache.set(previously_seen_type_refs) + else: + token = None + + try: + type_ref = get_type_ref(origin, args_override=args) + if type_ref in previously_seen_type_refs: + self_type = PydanticRecursiveRef(type_ref=type_ref) + yield self_type + else: + previously_seen_type_refs.add(type_ref) + yield None + finally: + if token: + _generic_recursion_cache.reset(token) + + +def recursively_defined_type_refs() -> set[str]: + visited = _generic_recursion_cache.get() + if not visited: + return set() # not in a generic recursion, so there are no types + + return visited.copy() # don't allow modifications + + +def get_cached_generic_type_early(parent: type[BaseModel], typevar_values: Any) -> type[BaseModel] | None: + """The use of a two-stage cache lookup approach was necessary to have the highest performance possible for + repeated calls to `__class_getitem__` on generic types (which may happen in tighter loops during runtime), + while still ensuring that certain alternative parametrizations ultimately resolve to the same type. + + As a concrete example, this approach was necessary to make Model[List[T]][int] equal to Model[List[int]]. + The approach could be modified to not use two different cache keys at different points, but the + _early_cache_key is optimized to be as quick to compute as possible (for repeated-access speed), and the + _late_cache_key is optimized to be as "correct" as possible, so that two types that will ultimately be the + same after resolving the type arguments will always produce cache hits. + + If we wanted to move to only using a single cache key per type, we would either need to always use the + slower/more computationally intensive logic associated with _late_cache_key, or would need to accept + that Model[List[T]][int] is a different type than Model[List[T]][int]. Because we rely on subclass relationships + during validation, I think it is worthwhile to ensure that types that are functionally equivalent are actually + equal. + """ + return _GENERIC_TYPES_CACHE.get(_early_cache_key(parent, typevar_values)) + + +def get_cached_generic_type_late( + parent: type[BaseModel], typevar_values: Any, origin: type[BaseModel], args: tuple[Any, ...] +) -> type[BaseModel] | None: + """See the docstring of `get_cached_generic_type_early` for more information about the two-stage cache lookup.""" + cached = _GENERIC_TYPES_CACHE.get(_late_cache_key(origin, args, typevar_values)) + if cached is not None: + set_cached_generic_type(parent, typevar_values, cached, origin, args) + return cached + + +def set_cached_generic_type( + parent: type[BaseModel], + typevar_values: tuple[Any, ...], + type_: type[BaseModel], + origin: type[BaseModel] | None = None, + args: tuple[Any, ...] | None = None, +) -> None: + """See the docstring of `get_cached_generic_type_early` for more information about why items are cached with + two different keys. + """ + _GENERIC_TYPES_CACHE[_early_cache_key(parent, typevar_values)] = type_ + if len(typevar_values) == 1: + _GENERIC_TYPES_CACHE[_early_cache_key(parent, typevar_values[0])] = type_ + if origin and args: + _GENERIC_TYPES_CACHE[_late_cache_key(origin, args, typevar_values)] = type_ + + +def _union_orderings_key(typevar_values: Any) -> Any: + """This is intended to help differentiate between Union types with the same arguments in different order. + + Thanks to caching internal to the `typing` module, it is not possible to distinguish between + List[Union[int, float]] and List[Union[float, int]] (and similarly for other "parent" origins besides List) + because `typing` considers Union[int, float] to be equal to Union[float, int]. + + However, you _can_ distinguish between (top-level) Union[int, float] vs. Union[float, int]. + Because we parse items as the first Union type that is successful, we get slightly more consistent behavior + if we make an effort to distinguish the ordering of items in a union. It would be best if we could _always_ + get the exact-correct order of items in the union, but that would require a change to the `typing` module itself. + (See https://github.com/python/cpython/issues/86483 for reference.) + """ + if isinstance(typevar_values, tuple): + args_data = [] + for value in typevar_values: + args_data.append(_union_orderings_key(value)) + return tuple(args_data) + elif typing_extensions.get_origin(typevar_values) is typing.Union: + return get_args(typevar_values) + else: + return () + + +def _early_cache_key(cls: type[BaseModel], typevar_values: Any) -> GenericTypesCacheKey: + """This is intended for minimal computational overhead during lookups of cached types. + + Note that this is overly simplistic, and it's possible that two different cls/typevar_values + inputs would ultimately result in the same type being created in BaseModel.__class_getitem__. + To handle this, we have a fallback _late_cache_key that is checked later if the _early_cache_key + lookup fails, and should result in a cache hit _precisely_ when the inputs to __class_getitem__ + would result in the same type. + """ + return cls, typevar_values, _union_orderings_key(typevar_values) + + +def _late_cache_key(origin: type[BaseModel], args: tuple[Any, ...], typevar_values: Any) -> GenericTypesCacheKey: + """This is intended for use later in the process of creating a new type, when we have more information + about the exact args that will be passed. If it turns out that a different set of inputs to + __class_getitem__ resulted in the same inputs to the generic type creation process, we can still + return the cached type, and update the cache with the _early_cache_key as well. + """ + # The _union_orderings_key is placed at the start here to ensure there cannot be a collision with an + # _early_cache_key, as that function will always produce a BaseModel subclass as the first item in the key, + # whereas this function will always produce a tuple as the first item in the key. + return _union_orderings_key(typevar_values), origin, args diff --git a/lib/pydantic/_internal/_git.py b/lib/pydantic/_internal/_git.py new file mode 100644 index 00000000..9de7aaf9 --- /dev/null +++ b/lib/pydantic/_internal/_git.py @@ -0,0 +1,26 @@ +"""Git utilities, adopted from mypy's git utilities (https://github.com/python/mypy/blob/master/mypy/git.py).""" +from __future__ import annotations + +import os +import subprocess + + +def is_git_repo(dir: str) -> bool: + """Is the given directory version-controlled with git?""" + return os.path.exists(os.path.join(dir, '.git')) + + +def have_git() -> bool: + """Can we run the git executable?""" + try: + subprocess.check_output(['git', '--help']) + return True + except subprocess.CalledProcessError: + return False + except OSError: + return False + + +def git_revision(dir: str) -> str: + """Get the SHA-1 of the HEAD of a git repository.""" + return subprocess.check_output(['git', 'rev-parse', '--short', 'HEAD'], cwd=dir).decode('utf-8').strip() diff --git a/lib/pydantic/_internal/_internal_dataclass.py b/lib/pydantic/_internal/_internal_dataclass.py new file mode 100644 index 00000000..317a3d9c --- /dev/null +++ b/lib/pydantic/_internal/_internal_dataclass.py @@ -0,0 +1,10 @@ +import sys +from typing import Any, Dict + +dataclass_kwargs: Dict[str, Any] + +# `slots` is available on Python >= 3.10 +if sys.version_info >= (3, 10): + slots_true = {'slots': True} +else: + slots_true = {} diff --git a/lib/pydantic/_internal/_known_annotated_metadata.py b/lib/pydantic/_internal/_known_annotated_metadata.py new file mode 100644 index 00000000..77caf705 --- /dev/null +++ b/lib/pydantic/_internal/_known_annotated_metadata.py @@ -0,0 +1,410 @@ +from __future__ import annotations + +from collections import defaultdict +from copy import copy +from functools import partial +from typing import TYPE_CHECKING, Any, Callable, Iterable + +from pydantic_core import CoreSchema, PydanticCustomError, to_jsonable_python +from pydantic_core import core_schema as cs + +from ._fields import PydanticMetadata + +if TYPE_CHECKING: + from ..annotated_handlers import GetJsonSchemaHandler + + +STRICT = {'strict'} +SEQUENCE_CONSTRAINTS = {'min_length', 'max_length'} +INEQUALITY = {'le', 'ge', 'lt', 'gt'} +NUMERIC_CONSTRAINTS = {'multiple_of', 'allow_inf_nan', *INEQUALITY} + +STR_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT, 'strip_whitespace', 'to_lower', 'to_upper', 'pattern'} +BYTES_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT} + +LIST_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT} +TUPLE_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT} +SET_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT} +DICT_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT} +GENERATOR_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT} + +FLOAT_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT} +INT_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT} +BOOL_CONSTRAINTS = STRICT +UUID_CONSTRAINTS = STRICT + +DATE_TIME_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT} +TIMEDELTA_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT} +TIME_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT} +LAX_OR_STRICT_CONSTRAINTS = STRICT + +UNION_CONSTRAINTS = {'union_mode'} +URL_CONSTRAINTS = { + 'max_length', + 'allowed_schemes', + 'host_required', + 'default_host', + 'default_port', + 'default_path', +} + +TEXT_SCHEMA_TYPES = ('str', 'bytes', 'url', 'multi-host-url') +SEQUENCE_SCHEMA_TYPES = ('list', 'tuple', 'set', 'frozenset', 'generator', *TEXT_SCHEMA_TYPES) +NUMERIC_SCHEMA_TYPES = ('float', 'int', 'date', 'time', 'timedelta', 'datetime') + +CONSTRAINTS_TO_ALLOWED_SCHEMAS: dict[str, set[str]] = defaultdict(set) +for constraint in STR_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(TEXT_SCHEMA_TYPES) +for constraint in BYTES_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('bytes',)) +for constraint in LIST_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('list',)) +for constraint in TUPLE_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('tuple',)) +for constraint in SET_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('set', 'frozenset')) +for constraint in DICT_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('dict',)) +for constraint in GENERATOR_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('generator',)) +for constraint in FLOAT_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('float',)) +for constraint in INT_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('int',)) +for constraint in DATE_TIME_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('date', 'time', 'datetime')) +for constraint in TIMEDELTA_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('timedelta',)) +for constraint in TIME_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('time',)) +for schema_type in (*TEXT_SCHEMA_TYPES, *SEQUENCE_SCHEMA_TYPES, *NUMERIC_SCHEMA_TYPES, 'typed-dict', 'model'): + CONSTRAINTS_TO_ALLOWED_SCHEMAS['strict'].add(schema_type) +for constraint in UNION_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('union',)) +for constraint in URL_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('url', 'multi-host-url')) +for constraint in BOOL_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('bool',)) +for constraint in UUID_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('uuid',)) +for constraint in LAX_OR_STRICT_CONSTRAINTS: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('lax-or-strict',)) + + +def add_js_update_schema(s: cs.CoreSchema, f: Callable[[], dict[str, Any]]) -> None: + def update_js_schema(s: cs.CoreSchema, handler: GetJsonSchemaHandler) -> dict[str, Any]: + js_schema = handler(s) + js_schema.update(f()) + return js_schema + + if 'metadata' in s: + metadata = s['metadata'] + if 'pydantic_js_functions' in s: + metadata['pydantic_js_functions'].append(update_js_schema) + else: + metadata['pydantic_js_functions'] = [update_js_schema] + else: + s['metadata'] = {'pydantic_js_functions': [update_js_schema]} + + +def as_jsonable_value(v: Any) -> Any: + if type(v) not in (int, str, float, bytes, bool, type(None)): + return to_jsonable_python(v) + return v + + +def expand_grouped_metadata(annotations: Iterable[Any]) -> Iterable[Any]: + """Expand the annotations. + + Args: + annotations: An iterable of annotations. + + Returns: + An iterable of expanded annotations. + + Example: + ```py + from annotated_types import Ge, Len + + from pydantic._internal._known_annotated_metadata import expand_grouped_metadata + + print(list(expand_grouped_metadata([Ge(4), Len(5)]))) + #> [Ge(ge=4), MinLen(min_length=5)] + ``` + """ + import annotated_types as at + + from pydantic.fields import FieldInfo # circular import + + for annotation in annotations: + if isinstance(annotation, at.GroupedMetadata): + yield from annotation + elif isinstance(annotation, FieldInfo): + yield from annotation.metadata + # this is a bit problematic in that it results in duplicate metadata + # all of our "consumers" can handle it, but it is not ideal + # we probably should split up FieldInfo into: + # - annotated types metadata + # - individual metadata known only to Pydantic + annotation = copy(annotation) + annotation.metadata = [] + yield annotation + else: + yield annotation + + +def apply_known_metadata(annotation: Any, schema: CoreSchema) -> CoreSchema | None: # noqa: C901 + """Apply `annotation` to `schema` if it is an annotation we know about (Gt, Le, etc.). + Otherwise return `None`. + + This does not handle all known annotations. If / when it does, it can always + return a CoreSchema and return the unmodified schema if the annotation should be ignored. + + Assumes that GroupedMetadata has already been expanded via `expand_grouped_metadata`. + + Args: + annotation: The annotation. + schema: The schema. + + Returns: + An updated schema with annotation if it is an annotation we know about, `None` otherwise. + + Raises: + PydanticCustomError: If `Predicate` fails. + """ + import annotated_types as at + + from . import _validators + + schema = schema.copy() + schema_update, other_metadata = collect_known_metadata([annotation]) + schema_type = schema['type'] + for constraint, value in schema_update.items(): + if constraint not in CONSTRAINTS_TO_ALLOWED_SCHEMAS: + raise ValueError(f'Unknown constraint {constraint}') + allowed_schemas = CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint] + + if schema_type in allowed_schemas: + if constraint == 'union_mode' and schema_type == 'union': + schema['mode'] = value # type: ignore # schema is UnionSchema + else: + schema[constraint] = value + continue + + if constraint == 'allow_inf_nan' and value is False: + return cs.no_info_after_validator_function( + _validators.forbid_inf_nan_check, + schema, + ) + elif constraint == 'pattern': + # insert a str schema to make sure the regex engine matches + return cs.chain_schema( + [ + schema, + cs.str_schema(pattern=value), + ] + ) + elif constraint == 'gt': + s = cs.no_info_after_validator_function( + partial(_validators.greater_than_validator, gt=value), + schema, + ) + add_js_update_schema(s, lambda: {'gt': as_jsonable_value(value)}) + return s + elif constraint == 'ge': + return cs.no_info_after_validator_function( + partial(_validators.greater_than_or_equal_validator, ge=value), + schema, + ) + elif constraint == 'lt': + return cs.no_info_after_validator_function( + partial(_validators.less_than_validator, lt=value), + schema, + ) + elif constraint == 'le': + return cs.no_info_after_validator_function( + partial(_validators.less_than_or_equal_validator, le=value), + schema, + ) + elif constraint == 'multiple_of': + return cs.no_info_after_validator_function( + partial(_validators.multiple_of_validator, multiple_of=value), + schema, + ) + elif constraint == 'min_length': + s = cs.no_info_after_validator_function( + partial(_validators.min_length_validator, min_length=value), + schema, + ) + add_js_update_schema(s, lambda: {'minLength': (as_jsonable_value(value))}) + return s + elif constraint == 'max_length': + s = cs.no_info_after_validator_function( + partial(_validators.max_length_validator, max_length=value), + schema, + ) + add_js_update_schema(s, lambda: {'maxLength': (as_jsonable_value(value))}) + return s + elif constraint == 'strip_whitespace': + return cs.chain_schema( + [ + schema, + cs.str_schema(strip_whitespace=True), + ] + ) + elif constraint == 'to_lower': + return cs.chain_schema( + [ + schema, + cs.str_schema(to_lower=True), + ] + ) + elif constraint == 'to_upper': + return cs.chain_schema( + [ + schema, + cs.str_schema(to_upper=True), + ] + ) + elif constraint == 'min_length': + return cs.no_info_after_validator_function( + partial(_validators.min_length_validator, min_length=annotation.min_length), + schema, + ) + elif constraint == 'max_length': + return cs.no_info_after_validator_function( + partial(_validators.max_length_validator, max_length=annotation.max_length), + schema, + ) + else: + raise RuntimeError(f'Unable to apply constraint {constraint} to schema {schema_type}') + + for annotation in other_metadata: + if isinstance(annotation, at.Gt): + return cs.no_info_after_validator_function( + partial(_validators.greater_than_validator, gt=annotation.gt), + schema, + ) + elif isinstance(annotation, at.Ge): + return cs.no_info_after_validator_function( + partial(_validators.greater_than_or_equal_validator, ge=annotation.ge), + schema, + ) + elif isinstance(annotation, at.Lt): + return cs.no_info_after_validator_function( + partial(_validators.less_than_validator, lt=annotation.lt), + schema, + ) + elif isinstance(annotation, at.Le): + return cs.no_info_after_validator_function( + partial(_validators.less_than_or_equal_validator, le=annotation.le), + schema, + ) + elif isinstance(annotation, at.MultipleOf): + return cs.no_info_after_validator_function( + partial(_validators.multiple_of_validator, multiple_of=annotation.multiple_of), + schema, + ) + elif isinstance(annotation, at.MinLen): + return cs.no_info_after_validator_function( + partial(_validators.min_length_validator, min_length=annotation.min_length), + schema, + ) + elif isinstance(annotation, at.MaxLen): + return cs.no_info_after_validator_function( + partial(_validators.max_length_validator, max_length=annotation.max_length), + schema, + ) + elif isinstance(annotation, at.Predicate): + predicate_name = f'{annotation.func.__qualname__} ' if hasattr(annotation.func, '__qualname__') else '' + + def val_func(v: Any) -> Any: + # annotation.func may also raise an exception, let it pass through + if not annotation.func(v): + raise PydanticCustomError( + 'predicate_failed', + f'Predicate {predicate_name}failed', # type: ignore + ) + return v + + return cs.no_info_after_validator_function(val_func, schema) + # ignore any other unknown metadata + return None + + return schema + + +def collect_known_metadata(annotations: Iterable[Any]) -> tuple[dict[str, Any], list[Any]]: + """Split `annotations` into known metadata and unknown annotations. + + Args: + annotations: An iterable of annotations. + + Returns: + A tuple contains a dict of known metadata and a list of unknown annotations. + + Example: + ```py + from annotated_types import Gt, Len + + from pydantic._internal._known_annotated_metadata import collect_known_metadata + + print(collect_known_metadata([Gt(1), Len(42), ...])) + #> ({'gt': 1, 'min_length': 42}, [Ellipsis]) + ``` + """ + import annotated_types as at + + annotations = expand_grouped_metadata(annotations) + + res: dict[str, Any] = {} + remaining: list[Any] = [] + for annotation in annotations: + # isinstance(annotation, PydanticMetadata) also covers ._fields:_PydanticGeneralMetadata + if isinstance(annotation, PydanticMetadata): + res.update(annotation.__dict__) + # we don't use dataclasses.asdict because that recursively calls asdict on the field values + elif isinstance(annotation, at.MinLen): + res.update({'min_length': annotation.min_length}) + elif isinstance(annotation, at.MaxLen): + res.update({'max_length': annotation.max_length}) + elif isinstance(annotation, at.Gt): + res.update({'gt': annotation.gt}) + elif isinstance(annotation, at.Ge): + res.update({'ge': annotation.ge}) + elif isinstance(annotation, at.Lt): + res.update({'lt': annotation.lt}) + elif isinstance(annotation, at.Le): + res.update({'le': annotation.le}) + elif isinstance(annotation, at.MultipleOf): + res.update({'multiple_of': annotation.multiple_of}) + elif isinstance(annotation, type) and issubclass(annotation, PydanticMetadata): + # also support PydanticMetadata classes being used without initialisation, + # e.g. `Annotated[int, Strict]` as well as `Annotated[int, Strict()]` + res.update({k: v for k, v in vars(annotation).items() if not k.startswith('_')}) + else: + remaining.append(annotation) + # Nones can sneak in but pydantic-core will reject them + # it'd be nice to clean things up so we don't put in None (we probably don't _need_ to, it was just easier) + # but this is simple enough to kick that can down the road + res = {k: v for k, v in res.items() if v is not None} + return res, remaining + + +def check_metadata(metadata: dict[str, Any], allowed: Iterable[str], source_type: Any) -> None: + """A small utility function to validate that the given metadata can be applied to the target. + More than saving lines of code, this gives us a consistent error message for all of our internal implementations. + + Args: + metadata: A dict of metadata. + allowed: An iterable of allowed metadata. + source_type: The source type. + + Raises: + TypeError: If there is metadatas that can't be applied on source type. + """ + unknown = metadata.keys() - set(allowed) + if unknown: + raise TypeError( + f'The following constraints cannot be applied to {source_type!r}: {", ".join([f"{k!r}" for k in unknown])}' + ) diff --git a/lib/pydantic/_internal/_mock_val_ser.py b/lib/pydantic/_internal/_mock_val_ser.py new file mode 100644 index 00000000..b303fed2 --- /dev/null +++ b/lib/pydantic/_internal/_mock_val_ser.py @@ -0,0 +1,140 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Callable, Generic, TypeVar + +from pydantic_core import SchemaSerializer, SchemaValidator +from typing_extensions import Literal + +from ..errors import PydanticErrorCodes, PydanticUserError + +if TYPE_CHECKING: + from ..dataclasses import PydanticDataclass + from ..main import BaseModel + + +ValSer = TypeVar('ValSer', SchemaValidator, SchemaSerializer) + + +class MockValSer(Generic[ValSer]): + """Mocker for `pydantic_core.SchemaValidator` or `pydantic_core.SchemaSerializer` which optionally attempts to + rebuild the thing it's mocking when one of its methods is accessed and raises an error if that fails. + """ + + __slots__ = '_error_message', '_code', '_val_or_ser', '_attempt_rebuild' + + def __init__( + self, + error_message: str, + *, + code: PydanticErrorCodes, + val_or_ser: Literal['validator', 'serializer'], + attempt_rebuild: Callable[[], ValSer | None] | None = None, + ) -> None: + self._error_message = error_message + self._val_or_ser = SchemaValidator if val_or_ser == 'validator' else SchemaSerializer + self._code: PydanticErrorCodes = code + self._attempt_rebuild = attempt_rebuild + + def __getattr__(self, item: str) -> None: + __tracebackhide__ = True + if self._attempt_rebuild: + val_ser = self._attempt_rebuild() + if val_ser is not None: + return getattr(val_ser, item) + + # raise an AttributeError if `item` doesn't exist + getattr(self._val_or_ser, item) + raise PydanticUserError(self._error_message, code=self._code) + + def rebuild(self) -> ValSer | None: + if self._attempt_rebuild: + val_ser = self._attempt_rebuild() + if val_ser is not None: + return val_ser + else: + raise PydanticUserError(self._error_message, code=self._code) + return None + + +def set_model_mocks(cls: type[BaseModel], cls_name: str, undefined_name: str = 'all referenced types') -> None: + """Set `__pydantic_validator__` and `__pydantic_serializer__` to `MockValSer`s on a model. + + Args: + cls: The model class to set the mocks on + cls_name: Name of the model class, used in error messages + undefined_name: Name of the undefined thing, used in error messages + """ + undefined_type_error_message = ( + f'`{cls_name}` is not fully defined; you should define {undefined_name},' + f' then call `{cls_name}.model_rebuild()`.' + ) + + def attempt_rebuild_validator() -> SchemaValidator | None: + if cls.model_rebuild(raise_errors=False, _parent_namespace_depth=5) is not False: + return cls.__pydantic_validator__ + else: + return None + + cls.__pydantic_validator__ = MockValSer( # type: ignore[assignment] + undefined_type_error_message, + code='class-not-fully-defined', + val_or_ser='validator', + attempt_rebuild=attempt_rebuild_validator, + ) + + def attempt_rebuild_serializer() -> SchemaSerializer | None: + if cls.model_rebuild(raise_errors=False, _parent_namespace_depth=5) is not False: + return cls.__pydantic_serializer__ + else: + return None + + cls.__pydantic_serializer__ = MockValSer( # type: ignore[assignment] + undefined_type_error_message, + code='class-not-fully-defined', + val_or_ser='serializer', + attempt_rebuild=attempt_rebuild_serializer, + ) + + +def set_dataclass_mocks( + cls: type[PydanticDataclass], cls_name: str, undefined_name: str = 'all referenced types' +) -> None: + """Set `__pydantic_validator__` and `__pydantic_serializer__` to `MockValSer`s on a dataclass. + + Args: + cls: The model class to set the mocks on + cls_name: Name of the model class, used in error messages + undefined_name: Name of the undefined thing, used in error messages + """ + from ..dataclasses import rebuild_dataclass + + undefined_type_error_message = ( + f'`{cls_name}` is not fully defined; you should define {undefined_name},' + f' then call `pydantic.dataclasses.rebuild_dataclass({cls_name})`.' + ) + + def attempt_rebuild_validator() -> SchemaValidator | None: + if rebuild_dataclass(cls, raise_errors=False, _parent_namespace_depth=5) is not False: + return cls.__pydantic_validator__ + else: + return None + + cls.__pydantic_validator__ = MockValSer( # type: ignore[assignment] + undefined_type_error_message, + code='class-not-fully-defined', + val_or_ser='validator', + attempt_rebuild=attempt_rebuild_validator, + ) + + def attempt_rebuild_serializer() -> SchemaSerializer | None: + if rebuild_dataclass(cls, raise_errors=False, _parent_namespace_depth=5) is not False: + return cls.__pydantic_serializer__ + else: + return None + + cls.__pydantic_serializer__ = MockValSer( # type: ignore[assignment] + undefined_type_error_message, + code='class-not-fully-defined', + val_or_ser='validator', + attempt_rebuild=attempt_rebuild_serializer, + ) diff --git a/lib/pydantic/_internal/_model_construction.py b/lib/pydantic/_internal/_model_construction.py new file mode 100644 index 00000000..543f73e9 --- /dev/null +++ b/lib/pydantic/_internal/_model_construction.py @@ -0,0 +1,637 @@ +"""Private logic for creating models.""" +from __future__ import annotations as _annotations + +import operator +import typing +import warnings +import weakref +from abc import ABCMeta +from functools import partial +from types import FunctionType +from typing import Any, Callable, Generic + +import typing_extensions +from pydantic_core import PydanticUndefined, SchemaSerializer +from typing_extensions import dataclass_transform, deprecated + +from ..errors import PydanticUndefinedAnnotation, PydanticUserError +from ..plugin._schema_validator import create_schema_validator +from ..warnings import GenericBeforeBaseModelWarning, PydanticDeprecatedSince20 +from ._config import ConfigWrapper +from ._decorators import DecoratorInfos, PydanticDescriptorProxy, get_attribute_from_bases +from ._fields import collect_model_fields, is_valid_field_name, is_valid_privateattr_name +from ._generate_schema import GenerateSchema +from ._generics import PydanticGenericMetadata, get_model_typevars_map +from ._mock_val_ser import MockValSer, set_model_mocks +from ._schema_generation_shared import CallbackGetCoreSchemaHandler +from ._signature import generate_pydantic_signature +from ._typing_extra import get_cls_types_namespace, is_annotated, is_classvar, parent_frame_namespace +from ._utils import ClassAttribute, SafeGetItemProxy +from ._validate_call import ValidateCallWrapper + +if typing.TYPE_CHECKING: + from ..fields import Field as PydanticModelField + from ..fields import FieldInfo, ModelPrivateAttr + from ..main import BaseModel +else: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + PydanticModelField = object() + +object_setattr = object.__setattr__ + + +class _ModelNamespaceDict(dict): + """A dictionary subclass that intercepts attribute setting on model classes and + warns about overriding of decorators. + """ + + def __setitem__(self, k: str, v: object) -> None: + existing: Any = self.get(k, None) + if existing and v is not existing and isinstance(existing, PydanticDescriptorProxy): + warnings.warn(f'`{k}` overrides an existing Pydantic `{existing.decorator_info.decorator_repr}` decorator') + + return super().__setitem__(k, v) + + +@dataclass_transform(kw_only_default=True, field_specifiers=(PydanticModelField,)) +class ModelMetaclass(ABCMeta): + def __new__( + mcs, + cls_name: str, + bases: tuple[type[Any], ...], + namespace: dict[str, Any], + __pydantic_generic_metadata__: PydanticGenericMetadata | None = None, + __pydantic_reset_parent_namespace__: bool = True, + _create_model_module: str | None = None, + **kwargs: Any, + ) -> type: + """Metaclass for creating Pydantic models. + + Args: + cls_name: The name of the class to be created. + bases: The base classes of the class to be created. + namespace: The attribute dictionary of the class to be created. + __pydantic_generic_metadata__: Metadata for generic models. + __pydantic_reset_parent_namespace__: Reset parent namespace. + _create_model_module: The module of the class to be created, if created by `create_model`. + **kwargs: Catch-all for any other keyword arguments. + + Returns: + The new class created by the metaclass. + """ + # Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we rely on the fact + # that `BaseModel` itself won't have any bases, but any subclass of it will, to determine whether the `__new__` + # call we're in the middle of is for the `BaseModel` class. + if bases: + base_field_names, class_vars, base_private_attributes = mcs._collect_bases_data(bases) + + config_wrapper = ConfigWrapper.for_model(bases, namespace, kwargs) + namespace['model_config'] = config_wrapper.config_dict + private_attributes = inspect_namespace( + namespace, config_wrapper.ignored_types, class_vars, base_field_names + ) + if private_attributes: + original_model_post_init = get_model_post_init(namespace, bases) + if original_model_post_init is not None: + # if there are private_attributes and a model_post_init function, we handle both + + def wrapped_model_post_init(self: BaseModel, __context: Any) -> None: + """We need to both initialize private attributes and call the user-defined model_post_init + method. + """ + init_private_attributes(self, __context) + original_model_post_init(self, __context) + + namespace['model_post_init'] = wrapped_model_post_init + else: + namespace['model_post_init'] = init_private_attributes + + namespace['__class_vars__'] = class_vars + namespace['__private_attributes__'] = {**base_private_attributes, **private_attributes} + + cls: type[BaseModel] = super().__new__(mcs, cls_name, bases, namespace, **kwargs) # type: ignore + + from ..main import BaseModel + + mro = cls.__mro__ + if Generic in mro and mro.index(Generic) < mro.index(BaseModel): + warnings.warn( + GenericBeforeBaseModelWarning( + 'Classes should inherit from `BaseModel` before generic classes (e.g. `typing.Generic[T]`) ' + 'for pydantic generics to work properly.' + ), + stacklevel=2, + ) + + cls.__pydantic_custom_init__ = not getattr(cls.__init__, '__pydantic_base_init__', False) + cls.__pydantic_post_init__ = None if cls.model_post_init is BaseModel.model_post_init else 'model_post_init' + + cls.__pydantic_decorators__ = DecoratorInfos.build(cls) + + # Use the getattr below to grab the __parameters__ from the `typing.Generic` parent class + if __pydantic_generic_metadata__: + cls.__pydantic_generic_metadata__ = __pydantic_generic_metadata__ + else: + parent_parameters = getattr(cls, '__pydantic_generic_metadata__', {}).get('parameters', ()) + parameters = getattr(cls, '__parameters__', None) or parent_parameters + if parameters and parent_parameters and not all(x in parameters for x in parent_parameters): + combined_parameters = parent_parameters + tuple(x for x in parameters if x not in parent_parameters) + parameters_str = ', '.join([str(x) for x in combined_parameters]) + generic_type_label = f'typing.Generic[{parameters_str}]' + error_message = ( + f'All parameters must be present on typing.Generic;' + f' you should inherit from {generic_type_label}.' + ) + if Generic not in bases: # pragma: no cover + # We raise an error here not because it is desirable, but because some cases are mishandled. + # It would be nice to remove this error and still have things behave as expected, it's just + # challenging because we are using a custom `__class_getitem__` to parametrize generic models, + # and not returning a typing._GenericAlias from it. + bases_str = ', '.join([x.__name__ for x in bases] + [generic_type_label]) + error_message += ( + f' Note: `typing.Generic` must go last: `class {cls.__name__}({bases_str}): ...`)' + ) + raise TypeError(error_message) + + cls.__pydantic_generic_metadata__ = { + 'origin': None, + 'args': (), + 'parameters': parameters, + } + + cls.__pydantic_complete__ = False # Ensure this specific class gets completed + + # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487 + # for attributes not in `new_namespace` (e.g. private attributes) + for name, obj in private_attributes.items(): + obj.__set_name__(cls, name) + + if __pydantic_reset_parent_namespace__: + cls.__pydantic_parent_namespace__ = build_lenient_weakvaluedict(parent_frame_namespace()) + parent_namespace = getattr(cls, '__pydantic_parent_namespace__', None) + if isinstance(parent_namespace, dict): + parent_namespace = unpack_lenient_weakvaluedict(parent_namespace) + + types_namespace = get_cls_types_namespace(cls, parent_namespace) + set_model_fields(cls, bases, config_wrapper, types_namespace) + + if config_wrapper.frozen and '__hash__' not in namespace: + set_default_hash_func(cls, bases) + + complete_model_class( + cls, + cls_name, + config_wrapper, + raise_errors=False, + types_namespace=types_namespace, + create_model_module=_create_model_module, + ) + + # If this is placed before the complete_model_class call above, + # the generic computed fields return type is set to PydanticUndefined + cls.model_computed_fields = {k: v.info for k, v in cls.__pydantic_decorators__.computed_fields.items()} + + # using super(cls, cls) on the next line ensures we only call the parent class's __pydantic_init_subclass__ + # I believe the `type: ignore` is only necessary because mypy doesn't realize that this code branch is + # only hit for _proper_ subclasses of BaseModel + super(cls, cls).__pydantic_init_subclass__(**kwargs) # type: ignore[misc] + return cls + else: + # this is the BaseModel class itself being created, no logic required + return super().__new__(mcs, cls_name, bases, namespace, **kwargs) + + if not typing.TYPE_CHECKING: # pragma: no branch + # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access + + def __getattr__(self, item: str) -> Any: + """This is necessary to keep attribute access working for class attribute access.""" + private_attributes = self.__dict__.get('__private_attributes__') + if private_attributes and item in private_attributes: + return private_attributes[item] + if item == '__pydantic_core_schema__': + # This means the class didn't get a schema generated for it, likely because there was an undefined reference + maybe_mock_validator = getattr(self, '__pydantic_validator__', None) + if isinstance(maybe_mock_validator, MockValSer): + rebuilt_validator = maybe_mock_validator.rebuild() + if rebuilt_validator is not None: + # In this case, a validator was built, and so `__pydantic_core_schema__` should now be set + return getattr(self, '__pydantic_core_schema__') + raise AttributeError(item) + + @classmethod + def __prepare__(cls, *args: Any, **kwargs: Any) -> dict[str, object]: + return _ModelNamespaceDict() + + def __instancecheck__(self, instance: Any) -> bool: + """Avoid calling ABC _abc_subclasscheck unless we're pretty sure. + + See #3829 and python/cpython#92810 + """ + return hasattr(instance, '__pydantic_validator__') and super().__instancecheck__(instance) + + @staticmethod + def _collect_bases_data(bases: tuple[type[Any], ...]) -> tuple[set[str], set[str], dict[str, ModelPrivateAttr]]: + from ..main import BaseModel + + field_names: set[str] = set() + class_vars: set[str] = set() + private_attributes: dict[str, ModelPrivateAttr] = {} + for base in bases: + if issubclass(base, BaseModel) and base is not BaseModel: + # model_fields might not be defined yet in the case of generics, so we use getattr here: + field_names.update(getattr(base, 'model_fields', {}).keys()) + class_vars.update(base.__class_vars__) + private_attributes.update(base.__private_attributes__) + return field_names, class_vars, private_attributes + + @property + @deprecated('The `__fields__` attribute is deprecated, use `model_fields` instead.', category=None) + def __fields__(self) -> dict[str, FieldInfo]: + warnings.warn( + 'The `__fields__` attribute is deprecated, use `model_fields` instead.', PydanticDeprecatedSince20 + ) + return self.model_fields # type: ignore + + def __dir__(self) -> list[str]: + attributes = list(super().__dir__()) + if '__fields__' in attributes: + attributes.remove('__fields__') + return attributes + + +def init_private_attributes(self: BaseModel, __context: Any) -> None: + """This function is meant to behave like a BaseModel method to initialise private attributes. + + It takes context as an argument since that's what pydantic-core passes when calling it. + + Args: + self: The BaseModel instance. + __context: The context. + """ + if getattr(self, '__pydantic_private__', None) is None: + pydantic_private = {} + for name, private_attr in self.__private_attributes__.items(): + default = private_attr.get_default() + if default is not PydanticUndefined: + pydantic_private[name] = default + object_setattr(self, '__pydantic_private__', pydantic_private) + + +def get_model_post_init(namespace: dict[str, Any], bases: tuple[type[Any], ...]) -> Callable[..., Any] | None: + """Get the `model_post_init` method from the namespace or the class bases, or `None` if not defined.""" + if 'model_post_init' in namespace: + return namespace['model_post_init'] + + from ..main import BaseModel + + model_post_init = get_attribute_from_bases(bases, 'model_post_init') + if model_post_init is not BaseModel.model_post_init: + return model_post_init + + +def inspect_namespace( # noqa C901 + namespace: dict[str, Any], + ignored_types: tuple[type[Any], ...], + base_class_vars: set[str], + base_class_fields: set[str], +) -> dict[str, ModelPrivateAttr]: + """Iterate over the namespace and: + * gather private attributes + * check for items which look like fields but are not (e.g. have no annotation) and warn. + + Args: + namespace: The attribute dictionary of the class to be created. + ignored_types: A tuple of ignore types. + base_class_vars: A set of base class class variables. + base_class_fields: A set of base class fields. + + Returns: + A dict contains private attributes info. + + Raises: + TypeError: If there is a `__root__` field in model. + NameError: If private attribute name is invalid. + PydanticUserError: + - If a field does not have a type annotation. + - If a field on base class was overridden by a non-annotated attribute. + """ + from ..fields import FieldInfo, ModelPrivateAttr, PrivateAttr + + all_ignored_types = ignored_types + default_ignored_types() + + private_attributes: dict[str, ModelPrivateAttr] = {} + raw_annotations = namespace.get('__annotations__', {}) + + if '__root__' in raw_annotations or '__root__' in namespace: + raise TypeError("To define root models, use `pydantic.RootModel` rather than a field called '__root__'") + + ignored_names: set[str] = set() + for var_name, value in list(namespace.items()): + if var_name == 'model_config': + continue + elif ( + isinstance(value, type) + and value.__module__ == namespace['__module__'] + and value.__qualname__.startswith(namespace['__qualname__']) + ): + # `value` is a nested type defined in this namespace; don't error + continue + elif isinstance(value, all_ignored_types) or value.__class__.__module__ == 'functools': + ignored_names.add(var_name) + continue + elif isinstance(value, ModelPrivateAttr): + if var_name.startswith('__'): + raise NameError( + 'Private attributes must not use dunder names;' + f' use a single underscore prefix instead of {var_name!r}.' + ) + elif is_valid_field_name(var_name): + raise NameError( + 'Private attributes must not use valid field names;' + f' use sunder names, e.g. {"_" + var_name!r} instead of {var_name!r}.' + ) + private_attributes[var_name] = value + del namespace[var_name] + elif isinstance(value, FieldInfo) and not is_valid_field_name(var_name): + suggested_name = var_name.lstrip('_') or 'my_field' # don't suggest '' for all-underscore name + raise NameError( + f'Fields must not use names with leading underscores;' + f' e.g., use {suggested_name!r} instead of {var_name!r}.' + ) + + elif var_name.startswith('__'): + continue + elif is_valid_privateattr_name(var_name): + if var_name not in raw_annotations or not is_classvar(raw_annotations[var_name]): + private_attributes[var_name] = PrivateAttr(default=value) + del namespace[var_name] + elif var_name in base_class_vars: + continue + elif var_name not in raw_annotations: + if var_name in base_class_fields: + raise PydanticUserError( + f'Field {var_name!r} defined on a base class was overridden by a non-annotated attribute. ' + f'All field definitions, including overrides, require a type annotation.', + code='model-field-overridden', + ) + elif isinstance(value, FieldInfo): + raise PydanticUserError( + f'Field {var_name!r} requires a type annotation', code='model-field-missing-annotation' + ) + else: + raise PydanticUserError( + f'A non-annotated attribute was detected: `{var_name} = {value!r}`. All model fields require a ' + f'type annotation; if `{var_name}` is not meant to be a field, you may be able to resolve this ' + f"error by annotating it as a `ClassVar` or updating `model_config['ignored_types']`.", + code='model-field-missing-annotation', + ) + + for ann_name, ann_type in raw_annotations.items(): + if ( + is_valid_privateattr_name(ann_name) + and ann_name not in private_attributes + and ann_name not in ignored_names + and not is_classvar(ann_type) + and ann_type not in all_ignored_types + and getattr(ann_type, '__module__', None) != 'functools' + ): + if is_annotated(ann_type): + _, *metadata = typing_extensions.get_args(ann_type) + private_attr = next((v for v in metadata if isinstance(v, ModelPrivateAttr)), None) + if private_attr is not None: + private_attributes[ann_name] = private_attr + continue + private_attributes[ann_name] = PrivateAttr() + + return private_attributes + + +def set_default_hash_func(cls: type[BaseModel], bases: tuple[type[Any], ...]) -> None: + base_hash_func = get_attribute_from_bases(bases, '__hash__') + new_hash_func = make_hash_func(cls) + if base_hash_func in {None, object.__hash__} or getattr(base_hash_func, '__code__', None) == new_hash_func.__code__: + # If `__hash__` is some default, we generate a hash function. + # It will be `None` if not overridden from BaseModel. + # It may be `object.__hash__` if there is another + # parent class earlier in the bases which doesn't override `__hash__` (e.g. `typing.Generic`). + # It may be a value set by `set_default_hash_func` if `cls` is a subclass of another frozen model. + # In the last case we still need a new hash function to account for new `model_fields`. + cls.__hash__ = new_hash_func + + +def make_hash_func(cls: type[BaseModel]) -> Any: + getter = operator.itemgetter(*cls.model_fields.keys()) if cls.model_fields else lambda _: 0 + + def hash_func(self: Any) -> int: + try: + return hash(getter(self.__dict__)) + except KeyError: + # In rare cases (such as when using the deprecated copy method), the __dict__ may not contain + # all model fields, which is how we can get here. + # getter(self.__dict__) is much faster than any 'safe' method that accounts for missing keys, + # and wrapping it in a `try` doesn't slow things down much in the common case. + return hash(getter(SafeGetItemProxy(self.__dict__))) + + return hash_func + + +def set_model_fields( + cls: type[BaseModel], bases: tuple[type[Any], ...], config_wrapper: ConfigWrapper, types_namespace: dict[str, Any] +) -> None: + """Collect and set `cls.model_fields` and `cls.__class_vars__`. + + Args: + cls: BaseModel or dataclass. + bases: Parents of the class, generally `cls.__bases__`. + config_wrapper: The config wrapper instance. + types_namespace: Optional extra namespace to look for types in. + """ + typevars_map = get_model_typevars_map(cls) + fields, class_vars = collect_model_fields(cls, bases, config_wrapper, types_namespace, typevars_map=typevars_map) + + cls.model_fields = fields + cls.__class_vars__.update(class_vars) + + for k in class_vars: + # Class vars should not be private attributes + # We remove them _here_ and not earlier because we rely on inspecting the class to determine its classvars, + # but private attributes are determined by inspecting the namespace _prior_ to class creation. + # In the case that a classvar with a leading-'_' is defined via a ForwardRef (e.g., when using + # `__future__.annotations`), we want to remove the private attribute which was detected _before_ we knew it + # evaluated to a classvar + + value = cls.__private_attributes__.pop(k, None) + if value is not None and value.default is not PydanticUndefined: + setattr(cls, k, value.default) + + +def complete_model_class( + cls: type[BaseModel], + cls_name: str, + config_wrapper: ConfigWrapper, + *, + raise_errors: bool = True, + types_namespace: dict[str, Any] | None, + create_model_module: str | None = None, +) -> bool: + """Finish building a model class. + + This logic must be called after class has been created since validation functions must be bound + and `get_type_hints` requires a class object. + + Args: + cls: BaseModel or dataclass. + cls_name: The model or dataclass name. + config_wrapper: The config wrapper instance. + raise_errors: Whether to raise errors. + types_namespace: Optional extra namespace to look for types in. + create_model_module: The module of the class to be created, if created by `create_model`. + + Returns: + `True` if the model is successfully completed, else `False`. + + Raises: + PydanticUndefinedAnnotation: If `PydanticUndefinedAnnotation` occurs in`__get_pydantic_core_schema__` + and `raise_errors=True`. + """ + typevars_map = get_model_typevars_map(cls) + gen_schema = GenerateSchema( + config_wrapper, + types_namespace, + typevars_map, + ) + + handler = CallbackGetCoreSchemaHandler( + partial(gen_schema.generate_schema, from_dunder_get_core_schema=False), + gen_schema, + ref_mode='unpack', + ) + + if config_wrapper.defer_build: + set_model_mocks(cls, cls_name) + return False + + try: + schema = cls.__get_pydantic_core_schema__(cls, handler) + except PydanticUndefinedAnnotation as e: + if raise_errors: + raise + set_model_mocks(cls, cls_name, f'`{e.name}`') + return False + + core_config = config_wrapper.core_config(cls) + + try: + schema = gen_schema.clean_schema(schema) + except gen_schema.CollectedInvalid: + set_model_mocks(cls, cls_name) + return False + + # debug(schema) + cls.__pydantic_core_schema__ = schema + + cls.__pydantic_validator__ = create_schema_validator( + schema, + cls, + create_model_module or cls.__module__, + cls.__qualname__, + 'create_model' if create_model_module else 'BaseModel', + core_config, + config_wrapper.plugin_settings, + ) + cls.__pydantic_serializer__ = SchemaSerializer(schema, core_config) + cls.__pydantic_complete__ = True + + # set __signature__ attr only for model class, but not for its instances + cls.__signature__ = ClassAttribute( + '__signature__', + generate_pydantic_signature(init=cls.__init__, fields=cls.model_fields, config_wrapper=config_wrapper), + ) + return True + + +class _PydanticWeakRef: + """Wrapper for `weakref.ref` that enables `pickle` serialization. + + Cloudpickle fails to serialize `weakref.ref` objects due to an arcane error related + to abstract base classes (`abc.ABC`). This class works around the issue by wrapping + `weakref.ref` instead of subclassing it. + + See https://github.com/pydantic/pydantic/issues/6763 for context. + + Semantics: + - If not pickled, behaves the same as a `weakref.ref`. + - If pickled along with the referenced object, the same `weakref.ref` behavior + will be maintained between them after unpickling. + - If pickled without the referenced object, after unpickling the underlying + reference will be cleared (`__call__` will always return `None`). + """ + + def __init__(self, obj: Any): + if obj is None: + # The object will be `None` upon deserialization if the serialized weakref + # had lost its underlying object. + self._wr = None + else: + self._wr = weakref.ref(obj) + + def __call__(self) -> Any: + if self._wr is None: + return None + else: + return self._wr() + + def __reduce__(self) -> tuple[Callable, tuple[weakref.ReferenceType | None]]: + return _PydanticWeakRef, (self(),) + + +def build_lenient_weakvaluedict(d: dict[str, Any] | None) -> dict[str, Any] | None: + """Takes an input dictionary, and produces a new value that (invertibly) replaces the values with weakrefs. + + We can't just use a WeakValueDictionary because many types (including int, str, etc.) can't be stored as values + in a WeakValueDictionary. + + The `unpack_lenient_weakvaluedict` function can be used to reverse this operation. + """ + if d is None: + return None + result = {} + for k, v in d.items(): + try: + proxy = _PydanticWeakRef(v) + except TypeError: + proxy = v + result[k] = proxy + return result + + +def unpack_lenient_weakvaluedict(d: dict[str, Any] | None) -> dict[str, Any] | None: + """Inverts the transform performed by `build_lenient_weakvaluedict`.""" + if d is None: + return None + + result = {} + for k, v in d.items(): + if isinstance(v, _PydanticWeakRef): + v = v() + if v is not None: + result[k] = v + else: + result[k] = v + return result + + +def default_ignored_types() -> tuple[type[Any], ...]: + from ..fields import ComputedFieldInfo + + return ( + FunctionType, + property, + classmethod, + staticmethod, + PydanticDescriptorProxy, + ComputedFieldInfo, + ValidateCallWrapper, + ) diff --git a/lib/pydantic/_internal/_repr.py b/lib/pydantic/_internal/_repr.py new file mode 100644 index 00000000..479b4479 --- /dev/null +++ b/lib/pydantic/_internal/_repr.py @@ -0,0 +1,117 @@ +"""Tools to provide pretty/human-readable display of objects.""" +from __future__ import annotations as _annotations + +import types +import typing +from typing import Any + +import typing_extensions + +from . import _typing_extra + +if typing.TYPE_CHECKING: + ReprArgs: typing_extensions.TypeAlias = 'typing.Iterable[tuple[str | None, Any]]' + RichReprResult: typing_extensions.TypeAlias = ( + 'typing.Iterable[Any | tuple[Any] | tuple[str, Any] | tuple[str, Any, Any]]' + ) + + +class PlainRepr(str): + """String class where repr doesn't include quotes. Useful with Representation when you want to return a string + representation of something that is valid (or pseudo-valid) python. + """ + + def __repr__(self) -> str: + return str(self) + + +class Representation: + # Mixin to provide `__str__`, `__repr__`, and `__pretty__` and `__rich_repr__` methods. + # `__pretty__` is used by [devtools](https://python-devtools.helpmanual.io/). + # `__rich_repr__` is used by [rich](https://rich.readthedocs.io/en/stable/pretty.html). + # (this is not a docstring to avoid adding a docstring to classes which inherit from Representation) + + # we don't want to use a type annotation here as it can break get_type_hints + __slots__ = tuple() # type: typing.Collection[str] + + def __repr_args__(self) -> ReprArgs: + """Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden. + + Can either return: + * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]` + * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]` + """ + attrs_names = self.__slots__ + if not attrs_names and hasattr(self, '__dict__'): + attrs_names = self.__dict__.keys() + attrs = ((s, getattr(self, s)) for s in attrs_names) + return [(a, v) for a, v in attrs if v is not None] + + def __repr_name__(self) -> str: + """Name of the instance's class, used in __repr__.""" + return self.__class__.__name__ + + def __repr_str__(self, join_str: str) -> str: + return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__()) + + def __pretty__(self, fmt: typing.Callable[[Any], Any], **kwargs: Any) -> typing.Generator[Any, None, None]: + """Used by devtools (https://python-devtools.helpmanual.io/) to pretty print objects.""" + yield self.__repr_name__() + '(' + yield 1 + for name, value in self.__repr_args__(): + if name is not None: + yield name + '=' + yield fmt(value) + yield ',' + yield 0 + yield -1 + yield ')' + + def __rich_repr__(self) -> RichReprResult: + """Used by Rich (https://rich.readthedocs.io/en/stable/pretty.html) to pretty print objects.""" + for name, field_repr in self.__repr_args__(): + if name is None: + yield field_repr + else: + yield name, field_repr + + def __str__(self) -> str: + return self.__repr_str__(' ') + + def __repr__(self) -> str: + return f'{self.__repr_name__()}({self.__repr_str__(", ")})' + + +def display_as_type(obj: Any) -> str: + """Pretty representation of a type, should be as close as possible to the original type definition string. + + Takes some logic from `typing._type_repr`. + """ + if isinstance(obj, types.FunctionType): + return obj.__name__ + elif obj is ...: + return '...' + elif isinstance(obj, Representation): + return repr(obj) + elif isinstance(obj, typing_extensions.TypeAliasType): + return str(obj) + + if not isinstance(obj, (_typing_extra.typing_base, _typing_extra.WithArgsTypes, type)): + obj = obj.__class__ + + if _typing_extra.origin_is_union(typing_extensions.get_origin(obj)): + args = ', '.join(map(display_as_type, typing_extensions.get_args(obj))) + return f'Union[{args}]' + elif isinstance(obj, _typing_extra.WithArgsTypes): + if typing_extensions.get_origin(obj) == typing_extensions.Literal: + args = ', '.join(map(repr, typing_extensions.get_args(obj))) + else: + args = ', '.join(map(display_as_type, typing_extensions.get_args(obj))) + try: + return f'{obj.__qualname__}[{args}]' + except AttributeError: + return str(obj) # handles TypeAliasType in 3.12 + elif isinstance(obj, type): + return obj.__qualname__ + else: + return repr(obj).replace('typing.', '').replace('typing_extensions.', '') diff --git a/lib/pydantic/_internal/_schema_generation_shared.py b/lib/pydantic/_internal/_schema_generation_shared.py new file mode 100644 index 00000000..1a9aa852 --- /dev/null +++ b/lib/pydantic/_internal/_schema_generation_shared.py @@ -0,0 +1,124 @@ +"""Types and utility functions used by various other internal tools.""" +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Callable + +from pydantic_core import core_schema +from typing_extensions import Literal + +from ..annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler + +if TYPE_CHECKING: + from ..json_schema import GenerateJsonSchema, JsonSchemaValue + from ._core_utils import CoreSchemaOrField + from ._generate_schema import GenerateSchema + + GetJsonSchemaFunction = Callable[[CoreSchemaOrField, GetJsonSchemaHandler], JsonSchemaValue] + HandlerOverride = Callable[[CoreSchemaOrField], JsonSchemaValue] + + +class GenerateJsonSchemaHandler(GetJsonSchemaHandler): + """JsonSchemaHandler implementation that doesn't do ref unwrapping by default. + + This is used for any Annotated metadata so that we don't end up with conflicting + modifications to the definition schema. + + Used internally by Pydantic, please do not rely on this implementation. + See `GetJsonSchemaHandler` for the handler API. + """ + + def __init__(self, generate_json_schema: GenerateJsonSchema, handler_override: HandlerOverride | None) -> None: + self.generate_json_schema = generate_json_schema + self.handler = handler_override or generate_json_schema.generate_inner + self.mode = generate_json_schema.mode + + def __call__(self, __core_schema: CoreSchemaOrField) -> JsonSchemaValue: + return self.handler(__core_schema) + + def resolve_ref_schema(self, maybe_ref_json_schema: JsonSchemaValue) -> JsonSchemaValue: + """Resolves `$ref` in the json schema. + + This returns the input json schema if there is no `$ref` in json schema. + + Args: + maybe_ref_json_schema: The input json schema that may contains `$ref`. + + Returns: + Resolved json schema. + + Raises: + LookupError: If it can't find the definition for `$ref`. + """ + if '$ref' not in maybe_ref_json_schema: + return maybe_ref_json_schema + ref = maybe_ref_json_schema['$ref'] + json_schema = self.generate_json_schema.get_schema_from_definitions(ref) + if json_schema is None: + raise LookupError( + f'Could not find a ref for {ref}.' + ' Maybe you tried to call resolve_ref_schema from within a recursive model?' + ) + return json_schema + + +class CallbackGetCoreSchemaHandler(GetCoreSchemaHandler): + """Wrapper to use an arbitrary function as a `GetCoreSchemaHandler`. + + Used internally by Pydantic, please do not rely on this implementation. + See `GetCoreSchemaHandler` for the handler API. + """ + + def __init__( + self, + handler: Callable[[Any], core_schema.CoreSchema], + generate_schema: GenerateSchema, + ref_mode: Literal['to-def', 'unpack'] = 'to-def', + ) -> None: + self._handler = handler + self._generate_schema = generate_schema + self._ref_mode = ref_mode + + def __call__(self, __source_type: Any) -> core_schema.CoreSchema: + schema = self._handler(__source_type) + ref = schema.get('ref') + if self._ref_mode == 'to-def': + if ref is not None: + self._generate_schema.defs.definitions[ref] = schema + return core_schema.definition_reference_schema(ref) + return schema + else: # ref_mode = 'unpack + return self.resolve_ref_schema(schema) + + def _get_types_namespace(self) -> dict[str, Any] | None: + return self._generate_schema._types_namespace + + def generate_schema(self, __source_type: Any) -> core_schema.CoreSchema: + return self._generate_schema.generate_schema(__source_type) + + @property + def field_name(self) -> str | None: + return self._generate_schema.field_name_stack.get() + + def resolve_ref_schema(self, maybe_ref_schema: core_schema.CoreSchema) -> core_schema.CoreSchema: + """Resolves reference in the core schema. + + Args: + maybe_ref_schema: The input core schema that may contains reference. + + Returns: + Resolved core schema. + + Raises: + LookupError: If it can't find the definition for reference. + """ + if maybe_ref_schema['type'] == 'definition-ref': + ref = maybe_ref_schema['schema_ref'] + if ref not in self._generate_schema.defs.definitions: + raise LookupError( + f'Could not find a ref for {ref}.' + ' Maybe you tried to call resolve_ref_schema from within a recursive model?' + ) + return self._generate_schema.defs.definitions[ref] + elif maybe_ref_schema['type'] == 'definitions': + return self.resolve_ref_schema(maybe_ref_schema['schema']) + return maybe_ref_schema diff --git a/lib/pydantic/_internal/_signature.py b/lib/pydantic/_internal/_signature.py new file mode 100644 index 00000000..816a1651 --- /dev/null +++ b/lib/pydantic/_internal/_signature.py @@ -0,0 +1,164 @@ +from __future__ import annotations + +import dataclasses +from inspect import Parameter, Signature, signature +from typing import TYPE_CHECKING, Any, Callable + +from pydantic_core import PydanticUndefined + +from ._config import ConfigWrapper +from ._utils import is_valid_identifier + +if TYPE_CHECKING: + from ..fields import FieldInfo + + +def _field_name_for_signature(field_name: str, field_info: FieldInfo) -> str: + """Extract the correct name to use for the field when generating a signature. + + Assuming the field has a valid alias, this will return the alias. Otherwise, it will return the field name. + First priority is given to the validation_alias, then the alias, then the field name. + + Args: + field_name: The name of the field + field_info: The corresponding FieldInfo object. + + Returns: + The correct name to use when generating a signature. + """ + + def _alias_if_valid(x: Any) -> str | None: + """Return the alias if it is a valid alias and identifier, else None.""" + return x if isinstance(x, str) and is_valid_identifier(x) else None + + return _alias_if_valid(field_info.alias) or _alias_if_valid(field_info.validation_alias) or field_name + + +def _process_param_defaults(param: Parameter) -> Parameter: + """Modify the signature for a parameter in a dataclass where the default value is a FieldInfo instance. + + Args: + param (Parameter): The parameter + + Returns: + Parameter: The custom processed parameter + """ + from ..fields import FieldInfo + + param_default = param.default + if isinstance(param_default, FieldInfo): + annotation = param.annotation + # Replace the annotation if appropriate + # inspect does "clever" things to show annotations as strings because we have + # `from __future__ import annotations` in main, we don't want that + if annotation == 'Any': + annotation = Any + + # Replace the field default + default = param_default.default + if default is PydanticUndefined: + if param_default.default_factory is PydanticUndefined: + default = Signature.empty + else: + # this is used by dataclasses to indicate a factory exists: + default = dataclasses._HAS_DEFAULT_FACTORY # type: ignore + return param.replace( + annotation=annotation, name=_field_name_for_signature(param.name, param_default), default=default + ) + return param + + +def _generate_signature_parameters( # noqa: C901 (ignore complexity, could use a refactor) + init: Callable[..., None], + fields: dict[str, FieldInfo], + config_wrapper: ConfigWrapper, +) -> dict[str, Parameter]: + """Generate a mapping of parameter names to Parameter objects for a pydantic BaseModel or dataclass.""" + from itertools import islice + + present_params = signature(init).parameters.values() + merged_params: dict[str, Parameter] = {} + var_kw = None + use_var_kw = False + + for param in islice(present_params, 1, None): # skip self arg + # inspect does "clever" things to show annotations as strings because we have + # `from __future__ import annotations` in main, we don't want that + if fields.get(param.name): + # exclude params with init=False + if getattr(fields[param.name], 'init', True) is False: + continue + param = param.replace(name=_field_name_for_signature(param.name, fields[param.name])) + if param.annotation == 'Any': + param = param.replace(annotation=Any) + if param.kind is param.VAR_KEYWORD: + var_kw = param + continue + merged_params[param.name] = param + + if var_kw: # if custom init has no var_kw, fields which are not declared in it cannot be passed through + allow_names = config_wrapper.populate_by_name + for field_name, field in fields.items(): + # when alias is a str it should be used for signature generation + param_name = _field_name_for_signature(field_name, field) + + if field_name in merged_params or param_name in merged_params: + continue + + if not is_valid_identifier(param_name): + if allow_names: + param_name = field_name + else: + use_var_kw = True + continue + + kwargs = {} if field.is_required() else {'default': field.get_default(call_default_factory=False)} + merged_params[param_name] = Parameter( + param_name, Parameter.KEYWORD_ONLY, annotation=field.rebuild_annotation(), **kwargs + ) + + if config_wrapper.extra == 'allow': + use_var_kw = True + + if var_kw and use_var_kw: + # Make sure the parameter for extra kwargs + # does not have the same name as a field + default_model_signature = [ + ('self', Parameter.POSITIONAL_ONLY), + ('data', Parameter.VAR_KEYWORD), + ] + if [(p.name, p.kind) for p in present_params] == default_model_signature: + # if this is the standard model signature, use extra_data as the extra args name + var_kw_name = 'extra_data' + else: + # else start from var_kw + var_kw_name = var_kw.name + + # generate a name that's definitely unique + while var_kw_name in fields: + var_kw_name += '_' + merged_params[var_kw_name] = var_kw.replace(name=var_kw_name) + + return merged_params + + +def generate_pydantic_signature( + init: Callable[..., None], fields: dict[str, FieldInfo], config_wrapper: ConfigWrapper, is_dataclass: bool = False +) -> Signature: + """Generate signature for a pydantic BaseModel or dataclass. + + Args: + init: The class init. + fields: The model fields. + config_wrapper: The config wrapper instance. + is_dataclass: Whether the model is a dataclass. + + Returns: + The dataclass/BaseModel subclass signature. + """ + merged_params = _generate_signature_parameters(init, fields, config_wrapper) + + if is_dataclass: + merged_params = {k: _process_param_defaults(v) for k, v in merged_params.items()} + + return Signature(parameters=list(merged_params.values()), return_annotation=None) diff --git a/lib/pydantic/_internal/_std_types_schema.py b/lib/pydantic/_internal/_std_types_schema.py new file mode 100644 index 00000000..c8523bf4 --- /dev/null +++ b/lib/pydantic/_internal/_std_types_schema.py @@ -0,0 +1,714 @@ +"""Logic for generating pydantic-core schemas for standard library types. + +Import of this module is deferred since it contains imports of many standard library modules. +""" +from __future__ import annotations as _annotations + +import collections +import collections.abc +import dataclasses +import decimal +import inspect +import os +import typing +from enum import Enum +from functools import partial +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from typing import Any, Callable, Iterable, TypeVar + +import typing_extensions +from pydantic_core import ( + CoreSchema, + MultiHostUrl, + PydanticCustomError, + PydanticOmit, + Url, + core_schema, +) +from typing_extensions import get_args, get_origin + +from pydantic.errors import PydanticSchemaGenerationError +from pydantic.fields import FieldInfo +from pydantic.types import Strict + +from ..config import ConfigDict +from ..json_schema import JsonSchemaValue, update_json_schema +from . import _known_annotated_metadata, _typing_extra, _validators +from ._core_utils import get_type_ref +from ._internal_dataclass import slots_true +from ._schema_generation_shared import GetCoreSchemaHandler, GetJsonSchemaHandler + +if typing.TYPE_CHECKING: + from ._generate_schema import GenerateSchema + + StdSchemaFunction = Callable[[GenerateSchema, type[Any]], core_schema.CoreSchema] + + +@dataclasses.dataclass(**slots_true) +class SchemaTransformer: + get_core_schema: Callable[[Any, GetCoreSchemaHandler], CoreSchema] + get_json_schema: Callable[[CoreSchema, GetJsonSchemaHandler], JsonSchemaValue] + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + return self.get_core_schema(source_type, handler) + + def __get_pydantic_json_schema__(self, schema: CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue: + return self.get_json_schema(schema, handler) + + +def get_enum_core_schema(enum_type: type[Enum], config: ConfigDict) -> CoreSchema: + cases: list[Any] = list(enum_type.__members__.values()) + + enum_ref = get_type_ref(enum_type) + description = None if not enum_type.__doc__ else inspect.cleandoc(enum_type.__doc__) + if description == 'An enumeration.': # This is the default value provided by enum.EnumMeta.__new__; don't use it + description = None + updates = {'title': enum_type.__name__, 'description': description} + updates = {k: v for k, v in updates.items() if v is not None} + + def get_json_schema(_, handler: GetJsonSchemaHandler) -> JsonSchemaValue: + json_schema = handler(core_schema.literal_schema([x.value for x in cases], ref=enum_ref)) + original_schema = handler.resolve_ref_schema(json_schema) + update_json_schema(original_schema, updates) + return json_schema + + if not cases: + # Use an isinstance check for enums with no cases. + # The most important use case for this is creating TypeVar bounds for generics that should + # be restricted to enums. This is more consistent than it might seem at first, since you can only + # subclass enum.Enum (or subclasses of enum.Enum) if all parent classes have no cases. + # We use the get_json_schema function when an Enum subclass has been declared with no cases + # so that we can still generate a valid json schema. + return core_schema.is_instance_schema(enum_type, metadata={'pydantic_js_functions': [get_json_schema]}) + + use_enum_values = config.get('use_enum_values', False) + + if len(cases) == 1: + expected = repr(cases[0].value) + else: + expected = ', '.join([repr(case.value) for case in cases[:-1]]) + f' or {cases[-1].value!r}' + + def to_enum(__input_value: Any) -> Enum: + try: + enum_field = enum_type(__input_value) + if use_enum_values: + return enum_field.value + return enum_field + except ValueError: + # The type: ignore on the next line is to ignore the requirement of LiteralString + raise PydanticCustomError('enum', f'Input should be {expected}', {'expected': expected}) # type: ignore + + strict_python_schema = core_schema.is_instance_schema(enum_type) + if use_enum_values: + strict_python_schema = core_schema.chain_schema( + [strict_python_schema, core_schema.no_info_plain_validator_function(lambda x: x.value)] + ) + + to_enum_validator = core_schema.no_info_plain_validator_function(to_enum) + if issubclass(enum_type, int): + # this handles `IntEnum`, and also `Foobar(int, Enum)` + updates['type'] = 'integer' + lax = core_schema.chain_schema([core_schema.int_schema(), to_enum_validator]) + # Disallow float from JSON due to strict mode + strict = core_schema.json_or_python_schema( + json_schema=core_schema.no_info_after_validator_function(to_enum, core_schema.int_schema()), + python_schema=strict_python_schema, + ) + elif issubclass(enum_type, str): + # this handles `StrEnum` (3.11 only), and also `Foobar(str, Enum)` + updates['type'] = 'string' + lax = core_schema.chain_schema([core_schema.str_schema(), to_enum_validator]) + strict = core_schema.json_or_python_schema( + json_schema=core_schema.no_info_after_validator_function(to_enum, core_schema.str_schema()), + python_schema=strict_python_schema, + ) + elif issubclass(enum_type, float): + updates['type'] = 'numeric' + lax = core_schema.chain_schema([core_schema.float_schema(), to_enum_validator]) + strict = core_schema.json_or_python_schema( + json_schema=core_schema.no_info_after_validator_function(to_enum, core_schema.float_schema()), + python_schema=strict_python_schema, + ) + else: + lax = to_enum_validator + strict = core_schema.json_or_python_schema(json_schema=to_enum_validator, python_schema=strict_python_schema) + return core_schema.lax_or_strict_schema( + lax_schema=lax, strict_schema=strict, ref=enum_ref, metadata={'pydantic_js_functions': [get_json_schema]} + ) + + +@dataclasses.dataclass(**slots_true) +class InnerSchemaValidator: + """Use a fixed CoreSchema, avoiding interference from outward annotations.""" + + core_schema: CoreSchema + js_schema: JsonSchemaValue | None = None + js_core_schema: CoreSchema | None = None + js_schema_update: JsonSchemaValue | None = None + + def __get_pydantic_json_schema__(self, _schema: CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue: + if self.js_schema is not None: + return self.js_schema + js_schema = handler(self.js_core_schema or self.core_schema) + if self.js_schema_update is not None: + js_schema.update(self.js_schema_update) + return js_schema + + def __get_pydantic_core_schema__(self, _source_type: Any, _handler: GetCoreSchemaHandler) -> CoreSchema: + return self.core_schema + + +def decimal_prepare_pydantic_annotations( + source: Any, annotations: Iterable[Any], config: ConfigDict +) -> tuple[Any, list[Any]] | None: + if source is not decimal.Decimal: + return None + + metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations) + + config_allow_inf_nan = config.get('allow_inf_nan') + if config_allow_inf_nan is not None: + metadata.setdefault('allow_inf_nan', config_allow_inf_nan) + + _known_annotated_metadata.check_metadata( + metadata, {*_known_annotated_metadata.FLOAT_CONSTRAINTS, 'max_digits', 'decimal_places'}, decimal.Decimal + ) + return source, [InnerSchemaValidator(core_schema.decimal_schema(**metadata)), *remaining_annotations] + + +def datetime_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + import datetime + + metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations) + if source_type is datetime.date: + sv = InnerSchemaValidator(core_schema.date_schema(**metadata)) + elif source_type is datetime.datetime: + sv = InnerSchemaValidator(core_schema.datetime_schema(**metadata)) + elif source_type is datetime.time: + sv = InnerSchemaValidator(core_schema.time_schema(**metadata)) + elif source_type is datetime.timedelta: + sv = InnerSchemaValidator(core_schema.timedelta_schema(**metadata)) + else: + return None + # check now that we know the source type is correct + _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.DATE_TIME_CONSTRAINTS, source_type) + return (source_type, [sv, *remaining_annotations]) + + +def uuid_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + # UUIDs have no constraints - they are fixed length, constructing a UUID instance checks the length + + from uuid import UUID + + if source_type is not UUID: + return None + + return (source_type, [InnerSchemaValidator(core_schema.uuid_schema()), *annotations]) + + +def path_schema_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + import pathlib + + if source_type not in { + os.PathLike, + pathlib.Path, + pathlib.PurePath, + pathlib.PosixPath, + pathlib.PurePosixPath, + pathlib.PureWindowsPath, + }: + return None + + metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations) + _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.STR_CONSTRAINTS, source_type) + + construct_path = pathlib.PurePath if source_type is os.PathLike else source_type + + def path_validator(input_value: str) -> os.PathLike[Any]: + try: + return construct_path(input_value) + except TypeError as e: + raise PydanticCustomError('path_type', 'Input is not a valid path') from e + + constrained_str_schema = core_schema.str_schema(**metadata) + + instance_schema = core_schema.json_or_python_schema( + json_schema=core_schema.no_info_after_validator_function(path_validator, constrained_str_schema), + python_schema=core_schema.is_instance_schema(source_type), + ) + + strict: bool | None = None + for annotation in annotations: + if isinstance(annotation, Strict): + strict = annotation.strict + + schema = core_schema.lax_or_strict_schema( + lax_schema=core_schema.union_schema( + [ + instance_schema, + core_schema.no_info_after_validator_function(path_validator, constrained_str_schema), + ], + custom_error_type='path_type', + custom_error_message='Input is not a valid path', + strict=True, + ), + strict_schema=instance_schema, + serialization=core_schema.to_string_ser_schema(), + strict=strict, + ) + + return ( + source_type, + [ + InnerSchemaValidator(schema, js_core_schema=constrained_str_schema, js_schema_update={'format': 'path'}), + *remaining_annotations, + ], + ) + + +def dequeue_validator( + input_value: Any, handler: core_schema.ValidatorFunctionWrapHandler, maxlen: None | int +) -> collections.deque[Any]: + if isinstance(input_value, collections.deque): + maxlens = [v for v in (input_value.maxlen, maxlen) if v is not None] + if maxlens: + maxlen = min(maxlens) + return collections.deque(handler(input_value), maxlen=maxlen) + else: + return collections.deque(handler(input_value), maxlen=maxlen) + + +@dataclasses.dataclass(**slots_true) +class SequenceValidator: + mapped_origin: type[Any] + item_source_type: type[Any] + min_length: int | None = None + max_length: int | None = None + strict: bool = False + + def serialize_sequence_via_list( + self, v: Any, handler: core_schema.SerializerFunctionWrapHandler, info: core_schema.SerializationInfo + ) -> Any: + items: list[Any] = [] + for index, item in enumerate(v): + try: + v = handler(item, index) + except PydanticOmit: + pass + else: + items.append(v) + + if info.mode_is_json(): + return items + else: + return self.mapped_origin(items) + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + if self.item_source_type is Any: + items_schema = None + else: + items_schema = handler.generate_schema(self.item_source_type) + + metadata = {'min_length': self.min_length, 'max_length': self.max_length, 'strict': self.strict} + + if self.mapped_origin in (list, set, frozenset): + if self.mapped_origin is list: + constrained_schema = core_schema.list_schema(items_schema, **metadata) + elif self.mapped_origin is set: + constrained_schema = core_schema.set_schema(items_schema, **metadata) + else: + assert self.mapped_origin is frozenset # safety check in case we forget to add a case + constrained_schema = core_schema.frozenset_schema(items_schema, **metadata) + + schema = constrained_schema + else: + # safety check in case we forget to add a case + assert self.mapped_origin in (collections.deque, collections.Counter) + + if self.mapped_origin is collections.deque: + # if we have a MaxLen annotation might as well set that as the default maxlen on the deque + # this lets us re-use existing metadata annotations to let users set the maxlen on a dequeue + # that e.g. comes from JSON + coerce_instance_wrap = partial( + core_schema.no_info_wrap_validator_function, + partial(dequeue_validator, maxlen=metadata.get('max_length', None)), + ) + else: + coerce_instance_wrap = partial(core_schema.no_info_after_validator_function, self.mapped_origin) + + constrained_schema = core_schema.list_schema(items_schema, **metadata) + + check_instance = core_schema.json_or_python_schema( + json_schema=core_schema.list_schema(), + python_schema=core_schema.is_instance_schema(self.mapped_origin), + ) + + serialization = core_schema.wrap_serializer_function_ser_schema( + self.serialize_sequence_via_list, schema=items_schema or core_schema.any_schema(), info_arg=True + ) + + strict = core_schema.chain_schema([check_instance, coerce_instance_wrap(constrained_schema)]) + + if metadata.get('strict', False): + schema = strict + else: + lax = coerce_instance_wrap(constrained_schema) + schema = core_schema.lax_or_strict_schema(lax_schema=lax, strict_schema=strict) + schema['serialization'] = serialization + + return schema + + +SEQUENCE_ORIGIN_MAP: dict[Any, Any] = { + typing.Deque: collections.deque, + collections.deque: collections.deque, + list: list, + typing.List: list, + set: set, + typing.AbstractSet: set, + typing.Set: set, + frozenset: frozenset, + typing.FrozenSet: frozenset, + typing.Sequence: list, + typing.MutableSequence: list, + typing.MutableSet: set, + # this doesn't handle subclasses of these + # parametrized typing.Set creates one of these + collections.abc.MutableSet: set, + collections.abc.Set: frozenset, +} + + +def identity(s: CoreSchema) -> CoreSchema: + return s + + +def sequence_like_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + origin: Any = get_origin(source_type) + + mapped_origin = SEQUENCE_ORIGIN_MAP.get(origin, None) if origin else SEQUENCE_ORIGIN_MAP.get(source_type, None) + if mapped_origin is None: + return None + + args = get_args(source_type) + + if not args: + args = (Any,) + elif len(args) != 1: + raise ValueError('Expected sequence to have exactly 1 generic parameter') + + item_source_type = args[0] + + metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations) + _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.SEQUENCE_CONSTRAINTS, source_type) + + return (source_type, [SequenceValidator(mapped_origin, item_source_type, **metadata), *remaining_annotations]) + + +MAPPING_ORIGIN_MAP: dict[Any, Any] = { + typing.DefaultDict: collections.defaultdict, + collections.defaultdict: collections.defaultdict, + collections.OrderedDict: collections.OrderedDict, + typing_extensions.OrderedDict: collections.OrderedDict, + dict: dict, + typing.Dict: dict, + collections.Counter: collections.Counter, + typing.Counter: collections.Counter, + # this doesn't handle subclasses of these + typing.Mapping: dict, + typing.MutableMapping: dict, + # parametrized typing.{Mutable}Mapping creates one of these + collections.abc.MutableMapping: dict, + collections.abc.Mapping: dict, +} + + +def defaultdict_validator( + input_value: Any, handler: core_schema.ValidatorFunctionWrapHandler, default_default_factory: Callable[[], Any] +) -> collections.defaultdict[Any, Any]: + if isinstance(input_value, collections.defaultdict): + default_factory = input_value.default_factory + return collections.defaultdict(default_factory, handler(input_value)) + else: + return collections.defaultdict(default_default_factory, handler(input_value)) + + +def get_defaultdict_default_default_factory(values_source_type: Any) -> Callable[[], Any]: + def infer_default() -> Callable[[], Any]: + allowed_default_types: dict[Any, Any] = { + typing.Tuple: tuple, + tuple: tuple, + collections.abc.Sequence: tuple, + collections.abc.MutableSequence: list, + typing.List: list, + list: list, + typing.Sequence: list, + typing.Set: set, + set: set, + typing.MutableSet: set, + collections.abc.MutableSet: set, + collections.abc.Set: frozenset, + typing.MutableMapping: dict, + typing.Mapping: dict, + collections.abc.Mapping: dict, + collections.abc.MutableMapping: dict, + float: float, + int: int, + str: str, + bool: bool, + } + values_type_origin = get_origin(values_source_type) or values_source_type + instructions = 'set using `DefaultDict[..., Annotated[..., Field(default_factory=...)]]`' + if isinstance(values_type_origin, TypeVar): + + def type_var_default_factory() -> None: + raise RuntimeError( + 'Generic defaultdict cannot be used without a concrete value type or an' + ' explicit default factory, ' + instructions + ) + + return type_var_default_factory + elif values_type_origin not in allowed_default_types: + # a somewhat subjective set of types that have reasonable default values + allowed_msg = ', '.join([t.__name__ for t in set(allowed_default_types.values())]) + raise PydanticSchemaGenerationError( + f'Unable to infer a default factory for keys of type {values_source_type}.' + f' Only {allowed_msg} are supported, other types require an explicit default factory' + ' ' + instructions + ) + return allowed_default_types[values_type_origin] + + # Assume Annotated[..., Field(...)] + if _typing_extra.is_annotated(values_source_type): + field_info = next((v for v in get_args(values_source_type) if isinstance(v, FieldInfo)), None) + else: + field_info = None + if field_info and field_info.default_factory: + default_default_factory = field_info.default_factory + else: + default_default_factory = infer_default() + return default_default_factory + + +@dataclasses.dataclass(**slots_true) +class MappingValidator: + mapped_origin: type[Any] + keys_source_type: type[Any] + values_source_type: type[Any] + min_length: int | None = None + max_length: int | None = None + strict: bool = False + + def serialize_mapping_via_dict(self, v: Any, handler: core_schema.SerializerFunctionWrapHandler) -> Any: + return handler(v) + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + if self.keys_source_type is Any: + keys_schema = None + else: + keys_schema = handler.generate_schema(self.keys_source_type) + if self.values_source_type is Any: + values_schema = None + else: + values_schema = handler.generate_schema(self.values_source_type) + + metadata = {'min_length': self.min_length, 'max_length': self.max_length, 'strict': self.strict} + + if self.mapped_origin is dict: + schema = core_schema.dict_schema(keys_schema, values_schema, **metadata) + else: + constrained_schema = core_schema.dict_schema(keys_schema, values_schema, **metadata) + check_instance = core_schema.json_or_python_schema( + json_schema=core_schema.dict_schema(), + python_schema=core_schema.is_instance_schema(self.mapped_origin), + ) + + if self.mapped_origin is collections.defaultdict: + default_default_factory = get_defaultdict_default_default_factory(self.values_source_type) + coerce_instance_wrap = partial( + core_schema.no_info_wrap_validator_function, + partial(defaultdict_validator, default_default_factory=default_default_factory), + ) + else: + coerce_instance_wrap = partial(core_schema.no_info_after_validator_function, self.mapped_origin) + + serialization = core_schema.wrap_serializer_function_ser_schema( + self.serialize_mapping_via_dict, + schema=core_schema.dict_schema( + keys_schema or core_schema.any_schema(), values_schema or core_schema.any_schema() + ), + info_arg=False, + ) + + strict = core_schema.chain_schema([check_instance, coerce_instance_wrap(constrained_schema)]) + + if metadata.get('strict', False): + schema = strict + else: + lax = coerce_instance_wrap(constrained_schema) + schema = core_schema.lax_or_strict_schema(lax_schema=lax, strict_schema=strict) + schema['serialization'] = serialization + + return schema + + +def mapping_like_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + origin: Any = get_origin(source_type) + + mapped_origin = MAPPING_ORIGIN_MAP.get(origin, None) if origin else MAPPING_ORIGIN_MAP.get(source_type, None) + if mapped_origin is None: + return None + + args = get_args(source_type) + + if not args: + args = (Any, Any) + elif mapped_origin is collections.Counter: + # a single generic + if len(args) != 1: + raise ValueError('Expected Counter to have exactly 1 generic parameter') + args = (args[0], int) # keys are always an int + elif len(args) != 2: + raise ValueError('Expected mapping to have exactly 2 generic parameters') + + keys_source_type, values_source_type = args + + metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations) + _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.SEQUENCE_CONSTRAINTS, source_type) + + return ( + source_type, + [ + MappingValidator(mapped_origin, keys_source_type, values_source_type, **metadata), + *remaining_annotations, + ], + ) + + +def ip_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + def make_strict_ip_schema(tp: type[Any]) -> CoreSchema: + return core_schema.json_or_python_schema( + json_schema=core_schema.no_info_after_validator_function(tp, core_schema.str_schema()), + python_schema=core_schema.is_instance_schema(tp), + ) + + if source_type is IPv4Address: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.lax_or_strict_schema( + lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_address_validator), + strict_schema=make_strict_ip_schema(IPv4Address), + serialization=core_schema.to_string_ser_schema(), + ), + lambda _1, _2: {'type': 'string', 'format': 'ipv4'}, + ), + *annotations, + ] + if source_type is IPv4Network: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.lax_or_strict_schema( + lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_network_validator), + strict_schema=make_strict_ip_schema(IPv4Network), + serialization=core_schema.to_string_ser_schema(), + ), + lambda _1, _2: {'type': 'string', 'format': 'ipv4network'}, + ), + *annotations, + ] + if source_type is IPv4Interface: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.lax_or_strict_schema( + lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_interface_validator), + strict_schema=make_strict_ip_schema(IPv4Interface), + serialization=core_schema.to_string_ser_schema(), + ), + lambda _1, _2: {'type': 'string', 'format': 'ipv4interface'}, + ), + *annotations, + ] + + if source_type is IPv6Address: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.lax_or_strict_schema( + lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_address_validator), + strict_schema=make_strict_ip_schema(IPv6Address), + serialization=core_schema.to_string_ser_schema(), + ), + lambda _1, _2: {'type': 'string', 'format': 'ipv6'}, + ), + *annotations, + ] + if source_type is IPv6Network: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.lax_or_strict_schema( + lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_network_validator), + strict_schema=make_strict_ip_schema(IPv6Network), + serialization=core_schema.to_string_ser_schema(), + ), + lambda _1, _2: {'type': 'string', 'format': 'ipv6network'}, + ), + *annotations, + ] + if source_type is IPv6Interface: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.lax_or_strict_schema( + lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_interface_validator), + strict_schema=make_strict_ip_schema(IPv6Interface), + serialization=core_schema.to_string_ser_schema(), + ), + lambda _1, _2: {'type': 'string', 'format': 'ipv6interface'}, + ), + *annotations, + ] + + return None + + +def url_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + if source_type is Url: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.url_schema(), + lambda cs, handler: handler(cs), + ), + *annotations, + ] + if source_type is MultiHostUrl: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.multi_host_url_schema(), + lambda cs, handler: handler(cs), + ), + *annotations, + ] + + +PREPARE_METHODS: tuple[Callable[[Any, Iterable[Any], ConfigDict], tuple[Any, list[Any]] | None], ...] = ( + decimal_prepare_pydantic_annotations, + sequence_like_prepare_pydantic_annotations, + datetime_prepare_pydantic_annotations, + uuid_prepare_pydantic_annotations, + path_schema_prepare_pydantic_annotations, + mapping_like_prepare_pydantic_annotations, + ip_prepare_pydantic_annotations, + url_prepare_pydantic_annotations, +) diff --git a/lib/pydantic/_internal/_typing_extra.py b/lib/pydantic/_internal/_typing_extra.py new file mode 100644 index 00000000..1d5d3b3f --- /dev/null +++ b/lib/pydantic/_internal/_typing_extra.py @@ -0,0 +1,469 @@ +"""Logic for interacting with type annotations, mostly extensions, shims and hacks to wrap python's typing module.""" +from __future__ import annotations as _annotations + +import dataclasses +import sys +import types +import typing +from collections.abc import Callable +from functools import partial +from types import GetSetDescriptorType +from typing import TYPE_CHECKING, Any, Final + +from typing_extensions import Annotated, Literal, TypeAliasType, TypeGuard, get_args, get_origin + +if TYPE_CHECKING: + from ._dataclasses import StandardDataclass + +try: + from typing import _TypingBase # type: ignore[attr-defined] +except ImportError: + from typing import _Final as _TypingBase # type: ignore[attr-defined] + +typing_base = _TypingBase + + +if sys.version_info < (3, 9): + # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on) + TypingGenericAlias = () +else: + from typing import GenericAlias as TypingGenericAlias # type: ignore + + +if sys.version_info < (3, 11): + from typing_extensions import NotRequired, Required +else: + from typing import NotRequired, Required # noqa: F401 + + +if sys.version_info < (3, 10): + + def origin_is_union(tp: type[Any] | None) -> bool: + return tp is typing.Union + + WithArgsTypes = (TypingGenericAlias,) + +else: + + def origin_is_union(tp: type[Any] | None) -> bool: + return tp is typing.Union or tp is types.UnionType + + WithArgsTypes = typing._GenericAlias, types.GenericAlias, types.UnionType # type: ignore[attr-defined] + + +if sys.version_info < (3, 10): + NoneType = type(None) + EllipsisType = type(Ellipsis) +else: + from types import NoneType as NoneType + + +LITERAL_TYPES: set[Any] = {Literal} +if hasattr(typing, 'Literal'): + LITERAL_TYPES.add(typing.Literal) # type: ignore + +NONE_TYPES: tuple[Any, ...] = (None, NoneType, *(tp[None] for tp in LITERAL_TYPES)) + + +TypeVarType = Any # since mypy doesn't allow the use of TypeVar as a type + + +def is_none_type(type_: Any) -> bool: + return type_ in NONE_TYPES + + +def is_callable_type(type_: type[Any]) -> bool: + return type_ is Callable or get_origin(type_) is Callable + + +def is_literal_type(type_: type[Any]) -> bool: + return Literal is not None and get_origin(type_) in LITERAL_TYPES + + +def literal_values(type_: type[Any]) -> tuple[Any, ...]: + return get_args(type_) + + +def all_literal_values(type_: type[Any]) -> list[Any]: + """This method is used to retrieve all Literal values as + Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586) + e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]`. + """ + if not is_literal_type(type_): + return [type_] + + values = literal_values(type_) + return list(x for value in values for x in all_literal_values(value)) + + +def is_annotated(ann_type: Any) -> bool: + from ._utils import lenient_issubclass + + origin = get_origin(ann_type) + return origin is not None and lenient_issubclass(origin, Annotated) + + +def is_namedtuple(type_: type[Any]) -> bool: + """Check if a given class is a named tuple. + It can be either a `typing.NamedTuple` or `collections.namedtuple`. + """ + from ._utils import lenient_issubclass + + return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields') + + +test_new_type = typing.NewType('test_new_type', str) + + +def is_new_type(type_: type[Any]) -> bool: + """Check whether type_ was created using typing.NewType. + + Can't use isinstance because it fails <3.10. + """ + return isinstance(type_, test_new_type.__class__) and hasattr(type_, '__supertype__') # type: ignore[arg-type] + + +def _check_classvar(v: type[Any] | None) -> bool: + if v is None: + return False + + return v.__class__ == typing.ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar' + + +def is_classvar(ann_type: type[Any]) -> bool: + if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)): + return True + + # this is an ugly workaround for class vars that contain forward references and are therefore themselves + # forward references, see #3679 + if ann_type.__class__ == typing.ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['): # type: ignore + return True + + return False + + +def _check_finalvar(v: type[Any] | None) -> bool: + """Check if a given type is a `typing.Final` type.""" + if v is None: + return False + + return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final') + + +def is_finalvar(ann_type: Any) -> bool: + return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type)) + + +def parent_frame_namespace(*, parent_depth: int = 2) -> dict[str, Any] | None: + """We allow use of items in parent namespace to get around the issue with `get_type_hints` only looking in the + global module namespace. See https://github.com/pydantic/pydantic/issues/2678#issuecomment-1008139014 -> Scope + and suggestion at the end of the next comment by @gvanrossum. + + WARNING 1: it matters exactly where this is called. By default, this function will build a namespace from the + parent of where it is called. + + WARNING 2: this only looks in the parent namespace, not other parents since (AFAIK) there's no way to collect a + dict of exactly what's in scope. Using `f_back` would work sometimes but would be very wrong and confusing in many + other cases. See https://discuss.python.org/t/is-there-a-way-to-access-parent-nested-namespaces/20659. + """ + frame = sys._getframe(parent_depth) + # if f_back is None, it's the global module namespace and we don't need to include it here + if frame.f_back is None: + return None + else: + return frame.f_locals + + +def add_module_globals(obj: Any, globalns: dict[str, Any] | None = None) -> dict[str, Any]: + module_name = getattr(obj, '__module__', None) + if module_name: + try: + module_globalns = sys.modules[module_name].__dict__ + except KeyError: + # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363 + pass + else: + if globalns: + return {**module_globalns, **globalns} + else: + # copy module globals to make sure it can't be updated later + return module_globalns.copy() + + return globalns or {} + + +def get_cls_types_namespace(cls: type[Any], parent_namespace: dict[str, Any] | None = None) -> dict[str, Any]: + ns = add_module_globals(cls, parent_namespace) + ns[cls.__name__] = cls + return ns + + +def get_cls_type_hints_lenient(obj: Any, globalns: dict[str, Any] | None = None) -> dict[str, Any]: + """Collect annotations from a class, including those from parent classes. + + Unlike `typing.get_type_hints`, this function will not error if a forward reference is not resolvable. + """ + hints = {} + for base in reversed(obj.__mro__): + ann = base.__dict__.get('__annotations__') + localns = dict(vars(base)) + if ann is not None and ann is not GetSetDescriptorType: + for name, value in ann.items(): + hints[name] = eval_type_lenient(value, globalns, localns) + return hints + + +def eval_type_lenient(value: Any, globalns: dict[str, Any] | None = None, localns: dict[str, Any] | None = None) -> Any: + """Behaves like typing._eval_type, except it won't raise an error if a forward reference can't be resolved.""" + if value is None: + value = NoneType + elif isinstance(value, str): + value = _make_forward_ref(value, is_argument=False, is_class=True) + + try: + return eval_type_backport(value, globalns, localns) + except NameError: + # the point of this function is to be tolerant to this case + return value + + +def eval_type_backport( + value: Any, globalns: dict[str, Any] | None = None, localns: dict[str, Any] | None = None +) -> Any: + """Like `typing._eval_type`, but falls back to the `eval_type_backport` package if it's + installed to let older Python versions use newer typing features. + Specifically, this transforms `X | Y` into `typing.Union[X, Y]` + and `list[X]` into `typing.List[X]` etc. (for all the types made generic in PEP 585) + if the original syntax is not supported in the current Python version. + """ + try: + return typing._eval_type( # type: ignore + value, globalns, localns + ) + except TypeError as e: + if not (isinstance(value, typing.ForwardRef) and is_backport_fixable_error(e)): + raise + try: + from eval_type_backport import eval_type_backport + except ImportError: + raise TypeError( + f'You have a type annotation {value.__forward_arg__!r} ' + f'which makes use of newer typing features than are supported in your version of Python. ' + f'To handle this error, you should either remove the use of new syntax ' + f'or install the `eval_type_backport` package.' + ) from e + + return eval_type_backport(value, globalns, localns, try_default=False) + + +def is_backport_fixable_error(e: TypeError) -> bool: + msg = str(e) + return msg.startswith('unsupported operand type(s) for |: ') or "' object is not subscriptable" in msg + + +def get_function_type_hints( + function: Callable[..., Any], *, include_keys: set[str] | None = None, types_namespace: dict[str, Any] | None = None +) -> dict[str, Any]: + """Like `typing.get_type_hints`, but doesn't convert `X` to `Optional[X]` if the default value is `None`, also + copes with `partial`. + """ + if isinstance(function, partial): + annotations = function.func.__annotations__ + else: + annotations = function.__annotations__ + + globalns = add_module_globals(function) + type_hints = {} + for name, value in annotations.items(): + if include_keys is not None and name not in include_keys: + continue + if value is None: + value = NoneType + elif isinstance(value, str): + value = _make_forward_ref(value) + + type_hints[name] = eval_type_backport(value, globalns, types_namespace) + + return type_hints + + +if sys.version_info < (3, 9, 8) or (3, 10) <= sys.version_info < (3, 10, 1): + + def _make_forward_ref( + arg: Any, + is_argument: bool = True, + *, + is_class: bool = False, + ) -> typing.ForwardRef: + """Wrapper for ForwardRef that accounts for the `is_class` argument missing in older versions. + The `module` argument is omitted as it breaks <3.9.8, =3.10.0 and isn't used in the calls below. + + See https://github.com/python/cpython/pull/28560 for some background. + The backport happened on 3.9.8, see: + https://github.com/pydantic/pydantic/discussions/6244#discussioncomment-6275458, + and on 3.10.1 for the 3.10 branch, see: + https://github.com/pydantic/pydantic/issues/6912 + + Implemented as EAFP with memory. + """ + return typing.ForwardRef(arg, is_argument) + +else: + _make_forward_ref = typing.ForwardRef + + +if sys.version_info >= (3, 10): + get_type_hints = typing.get_type_hints + +else: + """ + For older versions of python, we have a custom implementation of `get_type_hints` which is a close as possible to + the implementation in CPython 3.10.8. + """ + + @typing.no_type_check + def get_type_hints( # noqa: C901 + obj: Any, + globalns: dict[str, Any] | None = None, + localns: dict[str, Any] | None = None, + include_extras: bool = False, + ) -> dict[str, Any]: # pragma: no cover + """Taken verbatim from python 3.10.8 unchanged, except: + * type annotations of the function definition above. + * prefixing `typing.` where appropriate + * Use `_make_forward_ref` instead of `typing.ForwardRef` to handle the `is_class` argument. + + https://github.com/python/cpython/blob/aaaf5174241496afca7ce4d4584570190ff972fe/Lib/typing.py#L1773-L1875 + + DO NOT CHANGE THIS METHOD UNLESS ABSOLUTELY NECESSARY. + ====================================================== + + Return type hints for an object. + + This is often the same as obj.__annotations__, but it handles + forward references encoded as string literals, adds Optional[t] if a + default value equal to None is set and recursively replaces all + 'Annotated[T, ...]' with 'T' (unless 'include_extras=True'). + + The argument may be a module, class, method, or function. The annotations + are returned as a dictionary. For classes, annotations include also + inherited members. + + TypeError is raised if the argument is not of a type that can contain + annotations, and an empty dictionary is returned if no annotations are + present. + + BEWARE -- the behavior of globalns and localns is counterintuitive + (unless you are familiar with how eval() and exec() work). The + search order is locals first, then globals. + + - If no dict arguments are passed, an attempt is made to use the + globals from obj (or the respective module's globals for classes), + and these are also used as the locals. If the object does not appear + to have globals, an empty dictionary is used. For classes, the search + order is globals first then locals. + + - If one dict argument is passed, it is used for both globals and + locals. + + - If two dict arguments are passed, they specify globals and + locals, respectively. + """ + if getattr(obj, '__no_type_check__', None): + return {} + # Classes require a special treatment. + if isinstance(obj, type): + hints = {} + for base in reversed(obj.__mro__): + if globalns is None: + base_globals = getattr(sys.modules.get(base.__module__, None), '__dict__', {}) + else: + base_globals = globalns + ann = base.__dict__.get('__annotations__', {}) + if isinstance(ann, types.GetSetDescriptorType): + ann = {} + base_locals = dict(vars(base)) if localns is None else localns + if localns is None and globalns is None: + # This is surprising, but required. Before Python 3.10, + # get_type_hints only evaluated the globalns of + # a class. To maintain backwards compatibility, we reverse + # the globalns and localns order so that eval() looks into + # *base_globals* first rather than *base_locals*. + # This only affects ForwardRefs. + base_globals, base_locals = base_locals, base_globals + for name, value in ann.items(): + if value is None: + value = type(None) + if isinstance(value, str): + value = _make_forward_ref(value, is_argument=False, is_class=True) + + value = eval_type_backport(value, base_globals, base_locals) + hints[name] = value + if not include_extras and hasattr(typing, '_strip_annotations'): + return { + k: typing._strip_annotations(t) # type: ignore + for k, t in hints.items() + } + else: + return hints + + if globalns is None: + if isinstance(obj, types.ModuleType): + globalns = obj.__dict__ + else: + nsobj = obj + # Find globalns for the unwrapped object. + while hasattr(nsobj, '__wrapped__'): + nsobj = nsobj.__wrapped__ + globalns = getattr(nsobj, '__globals__', {}) + if localns is None: + localns = globalns + elif localns is None: + localns = globalns + hints = getattr(obj, '__annotations__', None) + if hints is None: + # Return empty annotations for something that _could_ have them. + if isinstance(obj, typing._allowed_types): # type: ignore + return {} + else: + raise TypeError(f'{obj!r} is not a module, class, method, ' 'or function.') + defaults = typing._get_defaults(obj) # type: ignore + hints = dict(hints) + for name, value in hints.items(): + if value is None: + value = type(None) + if isinstance(value, str): + # class-level forward refs were handled above, this must be either + # a module-level annotation or a function argument annotation + + value = _make_forward_ref( + value, + is_argument=not isinstance(obj, types.ModuleType), + is_class=False, + ) + value = eval_type_backport(value, globalns, localns) + if name in defaults and defaults[name] is None: + value = typing.Optional[value] + hints[name] = value + return hints if include_extras else {k: typing._strip_annotations(t) for k, t in hints.items()} # type: ignore + + +def is_dataclass(_cls: type[Any]) -> TypeGuard[type[StandardDataclass]]: + # The dataclasses.is_dataclass function doesn't seem to provide TypeGuard functionality, + # so I created this convenience function + return dataclasses.is_dataclass(_cls) + + +def origin_is_type_alias_type(origin: Any) -> TypeGuard[TypeAliasType]: + return isinstance(origin, TypeAliasType) + + +if sys.version_info >= (3, 10): + + def is_generic_alias(type_: type[Any]) -> bool: + return isinstance(type_, (types.GenericAlias, typing._GenericAlias)) # type: ignore[attr-defined] + +else: + + def is_generic_alias(type_: type[Any]) -> bool: + return isinstance(type_, typing._GenericAlias) # type: ignore diff --git a/lib/pydantic/_internal/_utils.py b/lib/pydantic/_internal/_utils.py new file mode 100644 index 00000000..31f5b2c5 --- /dev/null +++ b/lib/pydantic/_internal/_utils.py @@ -0,0 +1,362 @@ +"""Bucket of reusable internal utilities. + +This should be reduced as much as possible with functions only used in one place, moved to that place. +""" +from __future__ import annotations as _annotations + +import dataclasses +import keyword +import typing +import weakref +from collections import OrderedDict, defaultdict, deque +from copy import deepcopy +from itertools import zip_longest +from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType +from typing import Any, Mapping, TypeVar + +from typing_extensions import TypeAlias, TypeGuard + +from . import _repr, _typing_extra + +if typing.TYPE_CHECKING: + MappingIntStrAny: TypeAlias = 'typing.Mapping[int, Any] | typing.Mapping[str, Any]' + AbstractSetIntStr: TypeAlias = 'typing.AbstractSet[int] | typing.AbstractSet[str]' + from ..main import BaseModel + + +# these are types that are returned unchanged by deepcopy +IMMUTABLE_NON_COLLECTIONS_TYPES: set[type[Any]] = { + int, + float, + complex, + str, + bool, + bytes, + type, + _typing_extra.NoneType, + FunctionType, + BuiltinFunctionType, + LambdaType, + weakref.ref, + CodeType, + # note: including ModuleType will differ from behaviour of deepcopy by not producing error. + # It might be not a good idea in general, but considering that this function used only internally + # against default values of fields, this will allow to actually have a field with module as default value + ModuleType, + NotImplemented.__class__, + Ellipsis.__class__, +} + +# these are types that if empty, might be copied with simple copy() instead of deepcopy() +BUILTIN_COLLECTIONS: set[type[Any]] = { + list, + set, + tuple, + frozenset, + dict, + OrderedDict, + defaultdict, + deque, +} + + +def sequence_like(v: Any) -> bool: + return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque)) + + +def lenient_isinstance(o: Any, class_or_tuple: type[Any] | tuple[type[Any], ...] | None) -> bool: # pragma: no cover + try: + return isinstance(o, class_or_tuple) # type: ignore[arg-type] + except TypeError: + return False + + +def lenient_issubclass(cls: Any, class_or_tuple: Any) -> bool: # pragma: no cover + try: + return isinstance(cls, type) and issubclass(cls, class_or_tuple) + except TypeError: + if isinstance(cls, _typing_extra.WithArgsTypes): + return False + raise # pragma: no cover + + +def is_model_class(cls: Any) -> TypeGuard[type[BaseModel]]: + """Returns true if cls is a _proper_ subclass of BaseModel, and provides proper type-checking, + unlike raw calls to lenient_issubclass. + """ + from ..main import BaseModel + + return lenient_issubclass(cls, BaseModel) and cls is not BaseModel + + +def is_valid_identifier(identifier: str) -> bool: + """Checks that a string is a valid identifier and not a Python keyword. + :param identifier: The identifier to test. + :return: True if the identifier is valid. + """ + return identifier.isidentifier() and not keyword.iskeyword(identifier) + + +KeyType = TypeVar('KeyType') + + +def deep_update(mapping: dict[KeyType, Any], *updating_mappings: dict[KeyType, Any]) -> dict[KeyType, Any]: + updated_mapping = mapping.copy() + for updating_mapping in updating_mappings: + for k, v in updating_mapping.items(): + if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict): + updated_mapping[k] = deep_update(updated_mapping[k], v) + else: + updated_mapping[k] = v + return updated_mapping + + +def update_not_none(mapping: dict[Any, Any], **update: Any) -> None: + mapping.update({k: v for k, v in update.items() if v is not None}) + + +T = TypeVar('T') + + +def unique_list( + input_list: list[T] | tuple[T, ...], + *, + name_factory: typing.Callable[[T], str] = str, +) -> list[T]: + """Make a list unique while maintaining order. + We update the list if another one with the same name is set + (e.g. model validator overridden in subclass). + """ + result: list[T] = [] + result_names: list[str] = [] + for v in input_list: + v_name = name_factory(v) + if v_name not in result_names: + result_names.append(v_name) + result.append(v) + else: + result[result_names.index(v_name)] = v + + return result + + +class ValueItems(_repr.Representation): + """Class for more convenient calculation of excluded or included fields on values.""" + + __slots__ = ('_items', '_type') + + def __init__(self, value: Any, items: AbstractSetIntStr | MappingIntStrAny) -> None: + items = self._coerce_items(items) + + if isinstance(value, (list, tuple)): + items = self._normalize_indexes(items, len(value)) # type: ignore + + self._items: MappingIntStrAny = items # type: ignore + + def is_excluded(self, item: Any) -> bool: + """Check if item is fully excluded. + + :param item: key or index of a value + """ + return self.is_true(self._items.get(item)) + + def is_included(self, item: Any) -> bool: + """Check if value is contained in self._items. + + :param item: key or index of value + """ + return item in self._items + + def for_element(self, e: int | str) -> AbstractSetIntStr | MappingIntStrAny | None: + """:param e: key or index of element on value + :return: raw values for element if self._items is dict and contain needed element + """ + item = self._items.get(e) # type: ignore + return item if not self.is_true(item) else None + + def _normalize_indexes(self, items: MappingIntStrAny, v_length: int) -> dict[int | str, Any]: + """:param items: dict or set of indexes which will be normalized + :param v_length: length of sequence indexes of which will be + + >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4) + {0: True, 2: True, 3: True} + >>> self._normalize_indexes({'__all__': True}, 4) + {0: True, 1: True, 2: True, 3: True} + """ + normalized_items: dict[int | str, Any] = {} + all_items = None + for i, v in items.items(): + if not (isinstance(v, typing.Mapping) or isinstance(v, typing.AbstractSet) or self.is_true(v)): + raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}') + if i == '__all__': + all_items = self._coerce_value(v) + continue + if not isinstance(i, int): + raise TypeError( + 'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: ' + 'expected integer keys or keyword "__all__"' + ) + normalized_i = v_length + i if i < 0 else i + normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i)) + + if not all_items: + return normalized_items + if self.is_true(all_items): + for i in range(v_length): + normalized_items.setdefault(i, ...) + return normalized_items + for i in range(v_length): + normalized_item = normalized_items.setdefault(i, {}) + if not self.is_true(normalized_item): + normalized_items[i] = self.merge(all_items, normalized_item) + return normalized_items + + @classmethod + def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any: + """Merge a `base` item with an `override` item. + + Both `base` and `override` are converted to dictionaries if possible. + Sets are converted to dictionaries with the sets entries as keys and + Ellipsis as values. + + Each key-value pair existing in `base` is merged with `override`, + while the rest of the key-value pairs are updated recursively with this function. + + Merging takes place based on the "union" of keys if `intersect` is + set to `False` (default) and on the intersection of keys if + `intersect` is set to `True`. + """ + override = cls._coerce_value(override) + base = cls._coerce_value(base) + if override is None: + return base + if cls.is_true(base) or base is None: + return override + if cls.is_true(override): + return base if intersect else override + + # intersection or union of keys while preserving ordering: + if intersect: + merge_keys = [k for k in base if k in override] + [k for k in override if k in base] + else: + merge_keys = list(base) + [k for k in override if k not in base] + + merged: dict[int | str, Any] = {} + for k in merge_keys: + merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect) + if merged_item is not None: + merged[k] = merged_item + + return merged + + @staticmethod + def _coerce_items(items: AbstractSetIntStr | MappingIntStrAny) -> MappingIntStrAny: + if isinstance(items, typing.Mapping): + pass + elif isinstance(items, typing.AbstractSet): + items = dict.fromkeys(items, ...) # type: ignore + else: + class_name = getattr(items, '__class__', '???') + raise TypeError(f'Unexpected type of exclude value {class_name}') + return items # type: ignore + + @classmethod + def _coerce_value(cls, value: Any) -> Any: + if value is None or cls.is_true(value): + return value + return cls._coerce_items(value) + + @staticmethod + def is_true(v: Any) -> bool: + return v is True or v is ... + + def __repr_args__(self) -> _repr.ReprArgs: + return [(None, self._items)] + + +if typing.TYPE_CHECKING: + + def ClassAttribute(name: str, value: T) -> T: + ... + +else: + + class ClassAttribute: + """Hide class attribute from its instances.""" + + __slots__ = 'name', 'value' + + def __init__(self, name: str, value: Any) -> None: + self.name = name + self.value = value + + def __get__(self, instance: Any, owner: type[Any]) -> None: + if instance is None: + return self.value + raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only') + + +Obj = TypeVar('Obj') + + +def smart_deepcopy(obj: Obj) -> Obj: + """Return type as is for immutable built-in types + Use obj.copy() for built-in empty collections + Use copy.deepcopy() for non-empty collections and unknown objects. + """ + obj_type = obj.__class__ + if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES: + return obj # fastest case: obj is immutable and not collection therefore will not be copied anyway + try: + if not obj and obj_type in BUILTIN_COLLECTIONS: + # faster way for empty collections, no need to copy its members + return obj if obj_type is tuple else obj.copy() # tuple doesn't have copy method # type: ignore + except (TypeError, ValueError, RuntimeError): + # do we really dare to catch ALL errors? Seems a bit risky + pass + + return deepcopy(obj) # slowest way when we actually might need a deepcopy + + +_SENTINEL = object() + + +def all_identical(left: typing.Iterable[Any], right: typing.Iterable[Any]) -> bool: + """Check that the items of `left` are the same objects as those in `right`. + + >>> a, b = object(), object() + >>> all_identical([a, b, a], [a, b, a]) + True + >>> all_identical([a, b, [a]], [a, b, [a]]) # new list object, while "equal" is not "identical" + False + """ + for left_item, right_item in zip_longest(left, right, fillvalue=_SENTINEL): + if left_item is not right_item: + return False + return True + + +@dataclasses.dataclass(frozen=True) +class SafeGetItemProxy: + """Wrapper redirecting `__getitem__` to `get` with a sentinel value as default + + This makes is safe to use in `operator.itemgetter` when some keys may be missing + """ + + # Define __slots__manually for performances + # @dataclasses.dataclass() only support slots=True in python>=3.10 + __slots__ = ('wrapped',) + + wrapped: Mapping[str, Any] + + def __getitem__(self, __key: str) -> Any: + return self.wrapped.get(__key, _SENTINEL) + + # required to pass the object to operator.itemgetter() instances due to a quirk of typeshed + # https://github.com/python/mypy/issues/13713 + # https://github.com/python/typeshed/pull/8785 + # Since this is typing-only, hide it in a typing.TYPE_CHECKING block + if typing.TYPE_CHECKING: + + def __contains__(self, __key: str) -> bool: + return self.wrapped.__contains__(__key) diff --git a/lib/pydantic/_internal/_validate_call.py b/lib/pydantic/_internal/_validate_call.py new file mode 100644 index 00000000..664c0630 --- /dev/null +++ b/lib/pydantic/_internal/_validate_call.py @@ -0,0 +1,84 @@ +from __future__ import annotations as _annotations + +import inspect +from functools import partial +from typing import Any, Awaitable, Callable + +import pydantic_core + +from ..config import ConfigDict +from ..plugin._schema_validator import create_schema_validator +from . import _generate_schema, _typing_extra +from ._config import ConfigWrapper + + +class ValidateCallWrapper: + """This is a wrapper around a function that validates the arguments passed to it, and optionally the return value.""" + + __slots__ = ( + '__pydantic_validator__', + '__name__', + '__qualname__', + '__annotations__', + '__dict__', # required for __module__ + ) + + def __init__(self, function: Callable[..., Any], config: ConfigDict | None, validate_return: bool): + if isinstance(function, partial): + func = function.func + schema_type = func + self.__name__ = f'partial({func.__name__})' + self.__qualname__ = f'partial({func.__qualname__})' + self.__module__ = func.__module__ + else: + schema_type = function + self.__name__ = function.__name__ + self.__qualname__ = function.__qualname__ + self.__module__ = function.__module__ + + namespace = _typing_extra.add_module_globals(function, None) + config_wrapper = ConfigWrapper(config) + gen_schema = _generate_schema.GenerateSchema(config_wrapper, namespace) + schema = gen_schema.clean_schema(gen_schema.generate_schema(function)) + core_config = config_wrapper.core_config(self) + + self.__pydantic_validator__ = create_schema_validator( + schema, + schema_type, + self.__module__, + self.__qualname__, + 'validate_call', + core_config, + config_wrapper.plugin_settings, + ) + + if validate_return: + signature = inspect.signature(function) + return_type = signature.return_annotation if signature.return_annotation is not signature.empty else Any + gen_schema = _generate_schema.GenerateSchema(config_wrapper, namespace) + schema = gen_schema.clean_schema(gen_schema.generate_schema(return_type)) + validator = create_schema_validator( + schema, + schema_type, + self.__module__, + self.__qualname__, + 'validate_call', + core_config, + config_wrapper.plugin_settings, + ) + if inspect.iscoroutinefunction(function): + + async def return_val_wrapper(aw: Awaitable[Any]) -> None: + return validator.validate_python(await aw) + + self.__return_pydantic_validator__ = return_val_wrapper + else: + self.__return_pydantic_validator__ = validator.validate_python + else: + self.__return_pydantic_validator__ = None + + def __call__(self, *args: Any, **kwargs: Any) -> Any: + res = self.__pydantic_validator__.validate_python(pydantic_core.ArgsKwargs(args, kwargs)) + if self.__return_pydantic_validator__: + return self.__return_pydantic_validator__(res) + return res diff --git a/lib/pydantic/_internal/_validators.py b/lib/pydantic/_internal/_validators.py new file mode 100644 index 00000000..7193fe5c --- /dev/null +++ b/lib/pydantic/_internal/_validators.py @@ -0,0 +1,278 @@ +"""Validator functions for standard library types. + +Import of this module is deferred since it contains imports of many standard library modules. +""" + +from __future__ import annotations as _annotations + +import math +import re +import typing +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from typing import Any + +from pydantic_core import PydanticCustomError, core_schema +from pydantic_core._pydantic_core import PydanticKnownError + + +def sequence_validator( + __input_value: typing.Sequence[Any], + validator: core_schema.ValidatorFunctionWrapHandler, +) -> typing.Sequence[Any]: + """Validator for `Sequence` types, isinstance(v, Sequence) has already been called.""" + value_type = type(__input_value) + + # We don't accept any plain string as a sequence + # Relevant issue: https://github.com/pydantic/pydantic/issues/5595 + if issubclass(value_type, (str, bytes)): + raise PydanticCustomError( + 'sequence_str', + "'{type_name}' instances are not allowed as a Sequence value", + {'type_name': value_type.__name__}, + ) + + v_list = validator(__input_value) + + # the rest of the logic is just re-creating the original type from `v_list` + if value_type == list: + return v_list + elif issubclass(value_type, range): + # return the list as we probably can't re-create the range + return v_list + else: + # best guess at how to re-create the original type, more custom construction logic might be required + return value_type(v_list) # type: ignore[call-arg] + + +def import_string(value: Any) -> Any: + if isinstance(value, str): + try: + return _import_string_logic(value) + except ImportError as e: + raise PydanticCustomError('import_error', 'Invalid python path: {error}', {'error': str(e)}) from e + else: + # otherwise we just return the value and let the next validator do the rest of the work + return value + + +def _import_string_logic(dotted_path: str) -> Any: + """Inspired by uvicorn — dotted paths should include a colon before the final item if that item is not a module. + (This is necessary to distinguish between a submodule and an attribute when there is a conflict.). + + If the dotted path does not include a colon and the final item is not a valid module, importing as an attribute + rather than a submodule will be attempted automatically. + + So, for example, the following values of `dotted_path` result in the following returned values: + * 'collections': + * 'collections.abc': + * 'collections.abc:Mapping': + * `collections.abc.Mapping`: (though this is a bit slower than the previous line) + + An error will be raised under any of the following scenarios: + * `dotted_path` contains more than one colon (e.g., 'collections:abc:Mapping') + * the substring of `dotted_path` before the colon is not a valid module in the environment (e.g., '123:Mapping') + * the substring of `dotted_path` after the colon is not an attribute of the module (e.g., 'collections:abc123') + """ + from importlib import import_module + + components = dotted_path.strip().split(':') + if len(components) > 2: + raise ImportError(f"Import strings should have at most one ':'; received {dotted_path!r}") + + module_path = components[0] + if not module_path: + raise ImportError(f'Import strings should have a nonempty module name; received {dotted_path!r}') + + try: + module = import_module(module_path) + except ModuleNotFoundError as e: + if '.' in module_path: + # Check if it would be valid if the final item was separated from its module with a `:` + maybe_module_path, maybe_attribute = dotted_path.strip().rsplit('.', 1) + try: + return _import_string_logic(f'{maybe_module_path}:{maybe_attribute}') + except ImportError: + pass + raise ImportError(f'No module named {module_path!r}') from e + raise e + + if len(components) > 1: + attribute = components[1] + try: + return getattr(module, attribute) + except AttributeError as e: + raise ImportError(f'cannot import name {attribute!r} from {module_path!r}') from e + else: + return module + + +def pattern_either_validator(__input_value: Any) -> typing.Pattern[Any]: + if isinstance(__input_value, typing.Pattern): + return __input_value + elif isinstance(__input_value, (str, bytes)): + # todo strict mode + return compile_pattern(__input_value) # type: ignore + else: + raise PydanticCustomError('pattern_type', 'Input should be a valid pattern') + + +def pattern_str_validator(__input_value: Any) -> typing.Pattern[str]: + if isinstance(__input_value, typing.Pattern): + if isinstance(__input_value.pattern, str): + return __input_value + else: + raise PydanticCustomError('pattern_str_type', 'Input should be a string pattern') + elif isinstance(__input_value, str): + return compile_pattern(__input_value) + elif isinstance(__input_value, bytes): + raise PydanticCustomError('pattern_str_type', 'Input should be a string pattern') + else: + raise PydanticCustomError('pattern_type', 'Input should be a valid pattern') + + +def pattern_bytes_validator(__input_value: Any) -> typing.Pattern[bytes]: + if isinstance(__input_value, typing.Pattern): + if isinstance(__input_value.pattern, bytes): + return __input_value + else: + raise PydanticCustomError('pattern_bytes_type', 'Input should be a bytes pattern') + elif isinstance(__input_value, bytes): + return compile_pattern(__input_value) + elif isinstance(__input_value, str): + raise PydanticCustomError('pattern_bytes_type', 'Input should be a bytes pattern') + else: + raise PydanticCustomError('pattern_type', 'Input should be a valid pattern') + + +PatternType = typing.TypeVar('PatternType', str, bytes) + + +def compile_pattern(pattern: PatternType) -> typing.Pattern[PatternType]: + try: + return re.compile(pattern) + except re.error: + raise PydanticCustomError('pattern_regex', 'Input should be a valid regular expression') + + +def ip_v4_address_validator(__input_value: Any) -> IPv4Address: + if isinstance(__input_value, IPv4Address): + return __input_value + + try: + return IPv4Address(__input_value) + except ValueError: + raise PydanticCustomError('ip_v4_address', 'Input is not a valid IPv4 address') + + +def ip_v6_address_validator(__input_value: Any) -> IPv6Address: + if isinstance(__input_value, IPv6Address): + return __input_value + + try: + return IPv6Address(__input_value) + except ValueError: + raise PydanticCustomError('ip_v6_address', 'Input is not a valid IPv6 address') + + +def ip_v4_network_validator(__input_value: Any) -> IPv4Network: + """Assume IPv4Network initialised with a default `strict` argument. + + See more: + https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network + """ + if isinstance(__input_value, IPv4Network): + return __input_value + + try: + return IPv4Network(__input_value) + except ValueError: + raise PydanticCustomError('ip_v4_network', 'Input is not a valid IPv4 network') + + +def ip_v6_network_validator(__input_value: Any) -> IPv6Network: + """Assume IPv6Network initialised with a default `strict` argument. + + See more: + https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network + """ + if isinstance(__input_value, IPv6Network): + return __input_value + + try: + return IPv6Network(__input_value) + except ValueError: + raise PydanticCustomError('ip_v6_network', 'Input is not a valid IPv6 network') + + +def ip_v4_interface_validator(__input_value: Any) -> IPv4Interface: + if isinstance(__input_value, IPv4Interface): + return __input_value + + try: + return IPv4Interface(__input_value) + except ValueError: + raise PydanticCustomError('ip_v4_interface', 'Input is not a valid IPv4 interface') + + +def ip_v6_interface_validator(__input_value: Any) -> IPv6Interface: + if isinstance(__input_value, IPv6Interface): + return __input_value + + try: + return IPv6Interface(__input_value) + except ValueError: + raise PydanticCustomError('ip_v6_interface', 'Input is not a valid IPv6 interface') + + +def greater_than_validator(x: Any, gt: Any) -> Any: + if not (x > gt): + raise PydanticKnownError('greater_than', {'gt': gt}) + return x + + +def greater_than_or_equal_validator(x: Any, ge: Any) -> Any: + if not (x >= ge): + raise PydanticKnownError('greater_than_equal', {'ge': ge}) + return x + + +def less_than_validator(x: Any, lt: Any) -> Any: + if not (x < lt): + raise PydanticKnownError('less_than', {'lt': lt}) + return x + + +def less_than_or_equal_validator(x: Any, le: Any) -> Any: + if not (x <= le): + raise PydanticKnownError('less_than_equal', {'le': le}) + return x + + +def multiple_of_validator(x: Any, multiple_of: Any) -> Any: + if not (x % multiple_of == 0): + raise PydanticKnownError('multiple_of', {'multiple_of': multiple_of}) + return x + + +def min_length_validator(x: Any, min_length: Any) -> Any: + if not (len(x) >= min_length): + raise PydanticKnownError( + 'too_short', + {'field_type': 'Value', 'min_length': min_length, 'actual_length': len(x)}, + ) + return x + + +def max_length_validator(x: Any, max_length: Any) -> Any: + if len(x) > max_length: + raise PydanticKnownError( + 'too_long', + {'field_type': 'Value', 'max_length': max_length, 'actual_length': len(x)}, + ) + return x + + +def forbid_inf_nan_check(x: Any) -> Any: + if not math.isfinite(x): + raise PydanticKnownError('finite_number') + return x diff --git a/lib/pydantic/_migration.py b/lib/pydantic/_migration.py new file mode 100644 index 00000000..c8478a62 --- /dev/null +++ b/lib/pydantic/_migration.py @@ -0,0 +1,308 @@ +import sys +from typing import Any, Callable, Dict + +from .version import version_short + +MOVED_IN_V2 = { + 'pydantic.utils:version_info': 'pydantic.version:version_info', + 'pydantic.error_wrappers:ValidationError': 'pydantic:ValidationError', + 'pydantic.utils:to_camel': 'pydantic.alias_generators:to_pascal', + 'pydantic.utils:to_lower_camel': 'pydantic.alias_generators:to_camel', + 'pydantic:PyObject': 'pydantic.types:ImportString', + 'pydantic.types:PyObject': 'pydantic.types:ImportString', + 'pydantic.generics:GenericModel': 'pydantic.BaseModel', +} + +DEPRECATED_MOVED_IN_V2 = { + 'pydantic.tools:schema_of': 'pydantic.deprecated.tools:schema_of', + 'pydantic.tools:parse_obj_as': 'pydantic.deprecated.tools:parse_obj_as', + 'pydantic.tools:schema_json_of': 'pydantic.deprecated.tools:schema_json_of', + 'pydantic.json:pydantic_encoder': 'pydantic.deprecated.json:pydantic_encoder', + 'pydantic:validate_arguments': 'pydantic.deprecated.decorator:validate_arguments', + 'pydantic.json:custom_pydantic_encoder': 'pydantic.deprecated.json:custom_pydantic_encoder', + 'pydantic.json:timedelta_isoformat': 'pydantic.deprecated.json:timedelta_isoformat', + 'pydantic.decorator:validate_arguments': 'pydantic.deprecated.decorator:validate_arguments', + 'pydantic.class_validators:validator': 'pydantic.deprecated.class_validators:validator', + 'pydantic.class_validators:root_validator': 'pydantic.deprecated.class_validators:root_validator', + 'pydantic.config:BaseConfig': 'pydantic.deprecated.config:BaseConfig', + 'pydantic.config:Extra': 'pydantic.deprecated.config:Extra', +} + +REDIRECT_TO_V1 = { + f'pydantic.utils:{obj}': f'pydantic.v1.utils:{obj}' + for obj in ( + 'deep_update', + 'GetterDict', + 'lenient_issubclass', + 'lenient_isinstance', + 'is_valid_field', + 'update_not_none', + 'import_string', + 'Representation', + 'ROOT_KEY', + 'smart_deepcopy', + 'sequence_like', + ) +} + + +REMOVED_IN_V2 = { + 'pydantic:ConstrainedBytes', + 'pydantic:ConstrainedDate', + 'pydantic:ConstrainedDecimal', + 'pydantic:ConstrainedFloat', + 'pydantic:ConstrainedFrozenSet', + 'pydantic:ConstrainedInt', + 'pydantic:ConstrainedList', + 'pydantic:ConstrainedSet', + 'pydantic:ConstrainedStr', + 'pydantic:JsonWrapper', + 'pydantic:NoneBytes', + 'pydantic:NoneStr', + 'pydantic:NoneStrBytes', + 'pydantic:Protocol', + 'pydantic:Required', + 'pydantic:StrBytes', + 'pydantic:compiled', + 'pydantic.config:get_config', + 'pydantic.config:inherit_config', + 'pydantic.config:prepare_config', + 'pydantic:create_model_from_namedtuple', + 'pydantic:create_model_from_typeddict', + 'pydantic.dataclasses:create_pydantic_model_from_dataclass', + 'pydantic.dataclasses:make_dataclass_validator', + 'pydantic.dataclasses:set_validation', + 'pydantic.datetime_parse:parse_date', + 'pydantic.datetime_parse:parse_time', + 'pydantic.datetime_parse:parse_datetime', + 'pydantic.datetime_parse:parse_duration', + 'pydantic.error_wrappers:ErrorWrapper', + 'pydantic.errors:AnyStrMaxLengthError', + 'pydantic.errors:AnyStrMinLengthError', + 'pydantic.errors:ArbitraryTypeError', + 'pydantic.errors:BoolError', + 'pydantic.errors:BytesError', + 'pydantic.errors:CallableError', + 'pydantic.errors:ClassError', + 'pydantic.errors:ColorError', + 'pydantic.errors:ConfigError', + 'pydantic.errors:DataclassTypeError', + 'pydantic.errors:DateError', + 'pydantic.errors:DateNotInTheFutureError', + 'pydantic.errors:DateNotInThePastError', + 'pydantic.errors:DateTimeError', + 'pydantic.errors:DecimalError', + 'pydantic.errors:DecimalIsNotFiniteError', + 'pydantic.errors:DecimalMaxDigitsError', + 'pydantic.errors:DecimalMaxPlacesError', + 'pydantic.errors:DecimalWholeDigitsError', + 'pydantic.errors:DictError', + 'pydantic.errors:DurationError', + 'pydantic.errors:EmailError', + 'pydantic.errors:EnumError', + 'pydantic.errors:EnumMemberError', + 'pydantic.errors:ExtraError', + 'pydantic.errors:FloatError', + 'pydantic.errors:FrozenSetError', + 'pydantic.errors:FrozenSetMaxLengthError', + 'pydantic.errors:FrozenSetMinLengthError', + 'pydantic.errors:HashableError', + 'pydantic.errors:IPv4AddressError', + 'pydantic.errors:IPv4InterfaceError', + 'pydantic.errors:IPv4NetworkError', + 'pydantic.errors:IPv6AddressError', + 'pydantic.errors:IPv6InterfaceError', + 'pydantic.errors:IPv6NetworkError', + 'pydantic.errors:IPvAnyAddressError', + 'pydantic.errors:IPvAnyInterfaceError', + 'pydantic.errors:IPvAnyNetworkError', + 'pydantic.errors:IntEnumError', + 'pydantic.errors:IntegerError', + 'pydantic.errors:InvalidByteSize', + 'pydantic.errors:InvalidByteSizeUnit', + 'pydantic.errors:InvalidDiscriminator', + 'pydantic.errors:InvalidLengthForBrand', + 'pydantic.errors:JsonError', + 'pydantic.errors:JsonTypeError', + 'pydantic.errors:ListError', + 'pydantic.errors:ListMaxLengthError', + 'pydantic.errors:ListMinLengthError', + 'pydantic.errors:ListUniqueItemsError', + 'pydantic.errors:LuhnValidationError', + 'pydantic.errors:MissingDiscriminator', + 'pydantic.errors:MissingError', + 'pydantic.errors:NoneIsAllowedError', + 'pydantic.errors:NoneIsNotAllowedError', + 'pydantic.errors:NotDigitError', + 'pydantic.errors:NotNoneError', + 'pydantic.errors:NumberNotGeError', + 'pydantic.errors:NumberNotGtError', + 'pydantic.errors:NumberNotLeError', + 'pydantic.errors:NumberNotLtError', + 'pydantic.errors:NumberNotMultipleError', + 'pydantic.errors:PathError', + 'pydantic.errors:PathNotADirectoryError', + 'pydantic.errors:PathNotAFileError', + 'pydantic.errors:PathNotExistsError', + 'pydantic.errors:PatternError', + 'pydantic.errors:PyObjectError', + 'pydantic.errors:PydanticTypeError', + 'pydantic.errors:PydanticValueError', + 'pydantic.errors:SequenceError', + 'pydantic.errors:SetError', + 'pydantic.errors:SetMaxLengthError', + 'pydantic.errors:SetMinLengthError', + 'pydantic.errors:StrError', + 'pydantic.errors:StrRegexError', + 'pydantic.errors:StrictBoolError', + 'pydantic.errors:SubclassError', + 'pydantic.errors:TimeError', + 'pydantic.errors:TupleError', + 'pydantic.errors:TupleLengthError', + 'pydantic.errors:UUIDError', + 'pydantic.errors:UUIDVersionError', + 'pydantic.errors:UrlError', + 'pydantic.errors:UrlExtraError', + 'pydantic.errors:UrlHostError', + 'pydantic.errors:UrlHostTldError', + 'pydantic.errors:UrlPortError', + 'pydantic.errors:UrlSchemeError', + 'pydantic.errors:UrlSchemePermittedError', + 'pydantic.errors:UrlUserInfoError', + 'pydantic.errors:WrongConstantError', + 'pydantic.main:validate_model', + 'pydantic.networks:stricturl', + 'pydantic:parse_file_as', + 'pydantic:parse_raw_as', + 'pydantic:stricturl', + 'pydantic.tools:parse_file_as', + 'pydantic.tools:parse_raw_as', + 'pydantic.types:ConstrainedBytes', + 'pydantic.types:ConstrainedDate', + 'pydantic.types:ConstrainedDecimal', + 'pydantic.types:ConstrainedFloat', + 'pydantic.types:ConstrainedFrozenSet', + 'pydantic.types:ConstrainedInt', + 'pydantic.types:ConstrainedList', + 'pydantic.types:ConstrainedSet', + 'pydantic.types:ConstrainedStr', + 'pydantic.types:JsonWrapper', + 'pydantic.types:NoneBytes', + 'pydantic.types:NoneStr', + 'pydantic.types:NoneStrBytes', + 'pydantic.types:StrBytes', + 'pydantic.typing:evaluate_forwardref', + 'pydantic.typing:AbstractSetIntStr', + 'pydantic.typing:AnyCallable', + 'pydantic.typing:AnyClassMethod', + 'pydantic.typing:CallableGenerator', + 'pydantic.typing:DictAny', + 'pydantic.typing:DictIntStrAny', + 'pydantic.typing:DictStrAny', + 'pydantic.typing:IntStr', + 'pydantic.typing:ListStr', + 'pydantic.typing:MappingIntStrAny', + 'pydantic.typing:NoArgAnyCallable', + 'pydantic.typing:NoneType', + 'pydantic.typing:ReprArgs', + 'pydantic.typing:SetStr', + 'pydantic.typing:StrPath', + 'pydantic.typing:TupleGenerator', + 'pydantic.typing:WithArgsTypes', + 'pydantic.typing:all_literal_values', + 'pydantic.typing:display_as_type', + 'pydantic.typing:get_all_type_hints', + 'pydantic.typing:get_args', + 'pydantic.typing:get_origin', + 'pydantic.typing:get_sub_types', + 'pydantic.typing:is_callable_type', + 'pydantic.typing:is_classvar', + 'pydantic.typing:is_finalvar', + 'pydantic.typing:is_literal_type', + 'pydantic.typing:is_namedtuple', + 'pydantic.typing:is_new_type', + 'pydantic.typing:is_none_type', + 'pydantic.typing:is_typeddict', + 'pydantic.typing:is_typeddict_special', + 'pydantic.typing:is_union', + 'pydantic.typing:new_type_supertype', + 'pydantic.typing:resolve_annotations', + 'pydantic.typing:typing_base', + 'pydantic.typing:update_field_forward_refs', + 'pydantic.typing:update_model_forward_refs', + 'pydantic.utils:ClassAttribute', + 'pydantic.utils:DUNDER_ATTRIBUTES', + 'pydantic.utils:PyObjectStr', + 'pydantic.utils:ValueItems', + 'pydantic.utils:almost_equal_floats', + 'pydantic.utils:get_discriminator_alias_and_values', + 'pydantic.utils:get_model', + 'pydantic.utils:get_unique_discriminator_alias', + 'pydantic.utils:in_ipython', + 'pydantic.utils:is_valid_identifier', + 'pydantic.utils:path_type', + 'pydantic.utils:validate_field_name', + 'pydantic:validate_model', +} + + +def getattr_migration(module: str) -> Callable[[str], Any]: + """Implement PEP 562 for objects that were either moved or removed on the migration + to V2. + + Args: + module: The module name. + + Returns: + A callable that will raise an error if the object is not found. + """ + # This avoids circular import with errors.py. + from .errors import PydanticImportError + + def wrapper(name: str) -> object: + """Raise an error if the object is not found, or warn if it was moved. + + In case it was moved, it still returns the object. + + Args: + name: The object name. + + Returns: + The object. + """ + if name == '__path__': + raise AttributeError(f'module {module!r} has no attribute {name!r}') + + import warnings + + from ._internal._validators import import_string + + import_path = f'{module}:{name}' + if import_path in MOVED_IN_V2.keys(): + new_location = MOVED_IN_V2[import_path] + warnings.warn(f'`{import_path}` has been moved to `{new_location}`.') + return import_string(MOVED_IN_V2[import_path]) + if import_path in DEPRECATED_MOVED_IN_V2: + # skip the warning here because a deprecation warning will be raised elsewhere + return import_string(DEPRECATED_MOVED_IN_V2[import_path]) + if import_path in REDIRECT_TO_V1: + new_location = REDIRECT_TO_V1[import_path] + warnings.warn( + f'`{import_path}` has been removed. We are importing from `{new_location}` instead.' + 'See the migration guide for more details: https://docs.pydantic.dev/latest/migration/' + ) + return import_string(REDIRECT_TO_V1[import_path]) + if import_path == 'pydantic:BaseSettings': + raise PydanticImportError( + '`BaseSettings` has been moved to the `pydantic-settings` package. ' + f'See https://docs.pydantic.dev/{version_short()}/migration/#basesettings-has-moved-to-pydantic-settings ' + 'for more details.' + ) + if import_path in REMOVED_IN_V2: + raise PydanticImportError(f'`{import_path}` has been removed in V2.') + globals: Dict[str, Any] = sys.modules[module].__dict__ + if name in globals: + return globals[name] + raise AttributeError(f'module {module!r} has no attribute {name!r}') + + return wrapper diff --git a/lib/pydantic/alias_generators.py b/lib/pydantic/alias_generators.py new file mode 100644 index 00000000..155e66e0 --- /dev/null +++ b/lib/pydantic/alias_generators.py @@ -0,0 +1,50 @@ +"""Alias generators for converting between different capitalization conventions.""" +import re + +__all__ = ('to_pascal', 'to_camel', 'to_snake') + + +def to_pascal(snake: str) -> str: + """Convert a snake_case string to PascalCase. + + Args: + snake: The string to convert. + + Returns: + The PascalCase string. + """ + camel = snake.title() + return re.sub('([0-9A-Za-z])_(?=[0-9A-Z])', lambda m: m.group(1), camel) + + +def to_camel(snake: str) -> str: + """Convert a snake_case string to camelCase. + + Args: + snake: The string to convert. + + Returns: + The converted camelCase string. + """ + camel = to_pascal(snake) + return re.sub('(^_*[A-Z])', lambda m: m.group(1).lower(), camel) + + +def to_snake(camel: str) -> str: + """Convert a PascalCase or camelCase string to snake_case. + + Args: + camel: The string to convert. + + Returns: + The converted string in snake_case. + """ + # Handle the sequence of uppercase letters followed by a lowercase letter + snake = re.sub(r'([A-Z]+)([A-Z][a-z])', lambda m: f'{m.group(1)}_{m.group(2)}', camel) + # Insert an underscore between a lowercase letter and an uppercase letter + snake = re.sub(r'([a-z])([A-Z])', lambda m: f'{m.group(1)}_{m.group(2)}', snake) + # Insert an underscore between a digit and an uppercase letter + snake = re.sub(r'([0-9])([A-Z])', lambda m: f'{m.group(1)}_{m.group(2)}', snake) + # Insert an underscore between a lowercase letter and a digit + snake = re.sub(r'([a-z])([0-9])', lambda m: f'{m.group(1)}_{m.group(2)}', snake) + return snake.lower() diff --git a/lib/pydantic/aliases.py b/lib/pydantic/aliases.py new file mode 100644 index 00000000..b53557b1 --- /dev/null +++ b/lib/pydantic/aliases.py @@ -0,0 +1,112 @@ +"""Support for alias configurations.""" +from __future__ import annotations + +import dataclasses +from typing import Callable, Literal + +from ._internal import _internal_dataclass + +__all__ = ('AliasGenerator', 'AliasPath', 'AliasChoices') + + +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class AliasPath: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/alias#aliaspath-and-aliaschoices + + A data class used by `validation_alias` as a convenience to create aliases. + + Attributes: + path: A list of string or integer aliases. + """ + + path: list[int | str] + + def __init__(self, first_arg: str, *args: str | int) -> None: + self.path = [first_arg] + list(args) + + def convert_to_aliases(self) -> list[str | int]: + """Converts arguments to a list of string or integer aliases. + + Returns: + The list of aliases. + """ + return self.path + + +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class AliasChoices: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/alias#aliaspath-and-aliaschoices + + A data class used by `validation_alias` as a convenience to create aliases. + + Attributes: + choices: A list containing a string or `AliasPath`. + """ + + choices: list[str | AliasPath] + + def __init__(self, first_choice: str | AliasPath, *choices: str | AliasPath) -> None: + self.choices = [first_choice] + list(choices) + + def convert_to_aliases(self) -> list[list[str | int]]: + """Converts arguments to a list of lists containing string or integer aliases. + + Returns: + The list of aliases. + """ + aliases: list[list[str | int]] = [] + for c in self.choices: + if isinstance(c, AliasPath): + aliases.append(c.convert_to_aliases()) + else: + aliases.append([c]) + return aliases + + +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class AliasGenerator: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/alias#using-an-aliasgenerator + + A data class used by `alias_generator` as a convenience to create various aliases. + + Attributes: + alias: A callable that takes a field name and returns an alias for it. + validation_alias: A callable that takes a field name and returns a validation alias for it. + serialization_alias: A callable that takes a field name and returns a serialization alias for it. + """ + + alias: Callable[[str], str] | None = None + validation_alias: Callable[[str], str | AliasPath | AliasChoices] | None = None + serialization_alias: Callable[[str], str] | None = None + + def _generate_alias( + self, + alias_kind: Literal['alias', 'validation_alias', 'serialization_alias'], + allowed_types: tuple[type[str] | type[AliasPath] | type[AliasChoices], ...], + field_name: str, + ) -> str | AliasPath | AliasChoices | None: + """Generate an alias of the specified kind. Returns None if the alias generator is None. + + Raises: + TypeError: If the alias generator produces an invalid type. + """ + alias = None + if alias_generator := getattr(self, alias_kind): + alias = alias_generator(field_name) + if alias and not isinstance(alias, allowed_types): + raise TypeError( + f'Invalid `{alias_kind}` type. `{alias_kind}` generator must produce one of `{allowed_types}`' + ) + return alias + + def generate_aliases(self, field_name: str) -> tuple[str | None, str | AliasPath | AliasChoices | None, str | None]: + """Generate `alias`, `validation_alias`, and `serialization_alias` for a field. + + Returns: + A tuple of three aliases - validation, alias, and serialization. + """ + alias = self._generate_alias('alias', (str,), field_name) + validation_alias = self._generate_alias('validation_alias', (str, AliasChoices, AliasPath), field_name) + serialization_alias = self._generate_alias('serialization_alias', (str,), field_name) + + return alias, validation_alias, serialization_alias # type: ignore diff --git a/lib/pydantic/annotated_handlers.py b/lib/pydantic/annotated_handlers.py new file mode 100644 index 00000000..081949a8 --- /dev/null +++ b/lib/pydantic/annotated_handlers.py @@ -0,0 +1,120 @@ +"""Type annotations to use with `__get_pydantic_core_schema__` and `__get_pydantic_json_schema__`.""" +from __future__ import annotations as _annotations + +from typing import TYPE_CHECKING, Any, Union + +from pydantic_core import core_schema + +if TYPE_CHECKING: + from .json_schema import JsonSchemaMode, JsonSchemaValue + + CoreSchemaOrField = Union[ + core_schema.CoreSchema, + core_schema.ModelField, + core_schema.DataclassField, + core_schema.TypedDictField, + core_schema.ComputedField, + ] + +__all__ = 'GetJsonSchemaHandler', 'GetCoreSchemaHandler' + + +class GetJsonSchemaHandler: + """Handler to call into the next JSON schema generation function. + + Attributes: + mode: Json schema mode, can be `validation` or `serialization`. + """ + + mode: JsonSchemaMode + + def __call__(self, __core_schema: CoreSchemaOrField) -> JsonSchemaValue: + """Call the inner handler and get the JsonSchemaValue it returns. + This will call the next JSON schema modifying function up until it calls + into `pydantic.json_schema.GenerateJsonSchema`, which will raise a + `pydantic.errors.PydanticInvalidForJsonSchema` error if it cannot generate + a JSON schema. + + Args: + __core_schema: A `pydantic_core.core_schema.CoreSchema`. + + Returns: + JsonSchemaValue: The JSON schema generated by the inner JSON schema modify + functions. + """ + raise NotImplementedError + + def resolve_ref_schema(self, __maybe_ref_json_schema: JsonSchemaValue) -> JsonSchemaValue: + """Get the real schema for a `{"$ref": ...}` schema. + If the schema given is not a `$ref` schema, it will be returned as is. + This means you don't have to check before calling this function. + + Args: + __maybe_ref_json_schema: A JsonSchemaValue which may be a `$ref` schema. + + Raises: + LookupError: If the ref is not found. + + Returns: + JsonSchemaValue: A JsonSchemaValue that has no `$ref`. + """ + raise NotImplementedError + + +class GetCoreSchemaHandler: + """Handler to call into the next CoreSchema schema generation function.""" + + def __call__(self, __source_type: Any) -> core_schema.CoreSchema: + """Call the inner handler and get the CoreSchema it returns. + This will call the next CoreSchema modifying function up until it calls + into Pydantic's internal schema generation machinery, which will raise a + `pydantic.errors.PydanticSchemaGenerationError` error if it cannot generate + a CoreSchema for the given source type. + + Args: + __source_type: The input type. + + Returns: + CoreSchema: The `pydantic-core` CoreSchema generated. + """ + raise NotImplementedError + + def generate_schema(self, __source_type: Any) -> core_schema.CoreSchema: + """Generate a schema unrelated to the current context. + Use this function if e.g. you are handling schema generation for a sequence + and want to generate a schema for its items. + Otherwise, you may end up doing something like applying a `min_length` constraint + that was intended for the sequence itself to its items! + + Args: + __source_type: The input type. + + Returns: + CoreSchema: The `pydantic-core` CoreSchema generated. + """ + raise NotImplementedError + + def resolve_ref_schema(self, __maybe_ref_schema: core_schema.CoreSchema) -> core_schema.CoreSchema: + """Get the real schema for a `definition-ref` schema. + If the schema given is not a `definition-ref` schema, it will be returned as is. + This means you don't have to check before calling this function. + + Args: + __maybe_ref_schema: A `CoreSchema`, `ref`-based or not. + + Raises: + LookupError: If the `ref` is not found. + + Returns: + A concrete `CoreSchema`. + """ + raise NotImplementedError + + @property + def field_name(self) -> str | None: + """Get the name of the closest field to this validator.""" + raise NotImplementedError + + def _get_types_namespace(self) -> dict[str, Any] | None: + """Internal method used during type resolution for serializer annotations.""" + raise NotImplementedError diff --git a/lib/pydantic/class_validators.py b/lib/pydantic/class_validators.py index 87190610..2ff72ae5 100644 --- a/lib/pydantic/class_validators.py +++ b/lib/pydantic/class_validators.py @@ -1,342 +1,4 @@ -import warnings -from collections import ChainMap -from functools import wraps -from itertools import chain -from types import FunctionType -from typing import TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Optional, Set, Tuple, Type, Union, overload +"""`class_validators` module is a backport module from V1.""" +from ._migration import getattr_migration -from .errors import ConfigError -from .typing import AnyCallable -from .utils import ROOT_KEY, in_ipython - -if TYPE_CHECKING: - from .typing import AnyClassMethod - - -class Validator: - __slots__ = 'func', 'pre', 'each_item', 'always', 'check_fields', 'skip_on_failure' - - def __init__( - self, - func: AnyCallable, - pre: bool = False, - each_item: bool = False, - always: bool = False, - check_fields: bool = False, - skip_on_failure: bool = False, - ): - self.func = func - self.pre = pre - self.each_item = each_item - self.always = always - self.check_fields = check_fields - self.skip_on_failure = skip_on_failure - - -if TYPE_CHECKING: - from inspect import Signature - - from .config import BaseConfig - from .fields import ModelField - from .types import ModelOrDc - - ValidatorCallable = Callable[[Optional[ModelOrDc], Any, Dict[str, Any], ModelField, Type[BaseConfig]], Any] - ValidatorsList = List[ValidatorCallable] - ValidatorListDict = Dict[str, List[Validator]] - -_FUNCS: Set[str] = set() -VALIDATOR_CONFIG_KEY = '__validator_config__' -ROOT_VALIDATOR_CONFIG_KEY = '__root_validator_config__' - - -def validator( - *fields: str, - pre: bool = False, - each_item: bool = False, - always: bool = False, - check_fields: bool = True, - whole: bool = None, - allow_reuse: bool = False, -) -> Callable[[AnyCallable], 'AnyClassMethod']: - """ - Decorate methods on the class indicating that they should be used to validate fields - :param fields: which field(s) the method should be called on - :param pre: whether or not this validator should be called before the standard validators (else after) - :param each_item: for complex objects (sets, lists etc.) whether to validate individual elements rather than the - whole object - :param always: whether this method and other validators should be called even if the value is missing - :param check_fields: whether to check that the fields actually exist on the model - :param allow_reuse: whether to track and raise an error if another validator refers to the decorated function - """ - if not fields: - raise ConfigError('validator with no fields specified') - elif isinstance(fields[0], FunctionType): - raise ConfigError( - "validators should be used with fields and keyword arguments, not bare. " # noqa: Q000 - "E.g. usage should be `@validator('', ...)`" - ) - elif not all(isinstance(field, str) for field in fields): - raise ConfigError( - "validator fields should be passed as separate string args. " # noqa: Q000 - "E.g. usage should be `@validator('', '', ...)`" - ) - - if whole is not None: - warnings.warn( - 'The "whole" keyword argument is deprecated, use "each_item" (inverse meaning, default False) instead', - DeprecationWarning, - ) - assert each_item is False, '"each_item" and "whole" conflict, remove "whole"' - each_item = not whole - - def dec(f: AnyCallable) -> 'AnyClassMethod': - f_cls = _prepare_validator(f, allow_reuse) - setattr( - f_cls, - VALIDATOR_CONFIG_KEY, - ( - fields, - Validator(func=f_cls.__func__, pre=pre, each_item=each_item, always=always, check_fields=check_fields), - ), - ) - return f_cls - - return dec - - -@overload -def root_validator(_func: AnyCallable) -> 'AnyClassMethod': - ... - - -@overload -def root_validator( - *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False -) -> Callable[[AnyCallable], 'AnyClassMethod']: - ... - - -def root_validator( - _func: Optional[AnyCallable] = None, *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False -) -> Union['AnyClassMethod', Callable[[AnyCallable], 'AnyClassMethod']]: - """ - Decorate methods on a model indicating that they should be used to validate (and perhaps modify) data either - before or after standard model parsing/validation is performed. - """ - if _func: - f_cls = _prepare_validator(_func, allow_reuse) - setattr( - f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure) - ) - return f_cls - - def dec(f: AnyCallable) -> 'AnyClassMethod': - f_cls = _prepare_validator(f, allow_reuse) - setattr( - f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure) - ) - return f_cls - - return dec - - -def _prepare_validator(function: AnyCallable, allow_reuse: bool) -> 'AnyClassMethod': - """ - Avoid validators with duplicated names since without this, validators can be overwritten silently - which generally isn't the intended behaviour, don't run in ipython (see #312) or if allow_reuse is False. - """ - f_cls = function if isinstance(function, classmethod) else classmethod(function) - if not in_ipython() and not allow_reuse: - ref = f_cls.__func__.__module__ + '.' + f_cls.__func__.__qualname__ - if ref in _FUNCS: - raise ConfigError(f'duplicate validator function "{ref}"; if this is intended, set `allow_reuse=True`') - _FUNCS.add(ref) - return f_cls - - -class ValidatorGroup: - def __init__(self, validators: 'ValidatorListDict') -> None: - self.validators = validators - self.used_validators = {'*'} - - def get_validators(self, name: str) -> Optional[Dict[str, Validator]]: - self.used_validators.add(name) - validators = self.validators.get(name, []) - if name != ROOT_KEY: - validators += self.validators.get('*', []) - if validators: - return {v.func.__name__: v for v in validators} - else: - return None - - def check_for_unused(self) -> None: - unused_validators = set( - chain.from_iterable( - (v.func.__name__ for v in self.validators[f] if v.check_fields) - for f in (self.validators.keys() - self.used_validators) - ) - ) - if unused_validators: - fn = ', '.join(unused_validators) - raise ConfigError( - f"Validators defined with incorrect fields: {fn} " # noqa: Q000 - f"(use check_fields=False if you're inheriting from the model and intended this)" - ) - - -def extract_validators(namespace: Dict[str, Any]) -> Dict[str, List[Validator]]: - validators: Dict[str, List[Validator]] = {} - for var_name, value in namespace.items(): - validator_config = getattr(value, VALIDATOR_CONFIG_KEY, None) - if validator_config: - fields, v = validator_config - for field in fields: - if field in validators: - validators[field].append(v) - else: - validators[field] = [v] - return validators - - -def extract_root_validators(namespace: Dict[str, Any]) -> Tuple[List[AnyCallable], List[Tuple[bool, AnyCallable]]]: - from inspect import signature - - pre_validators: List[AnyCallable] = [] - post_validators: List[Tuple[bool, AnyCallable]] = [] - for name, value in namespace.items(): - validator_config: Optional[Validator] = getattr(value, ROOT_VALIDATOR_CONFIG_KEY, None) - if validator_config: - sig = signature(validator_config.func) - args = list(sig.parameters.keys()) - if args[0] == 'self': - raise ConfigError( - f'Invalid signature for root validator {name}: {sig}, "self" not permitted as first argument, ' - f'should be: (cls, values).' - ) - if len(args) != 2: - raise ConfigError(f'Invalid signature for root validator {name}: {sig}, should be: (cls, values).') - # check function signature - if validator_config.pre: - pre_validators.append(validator_config.func) - else: - post_validators.append((validator_config.skip_on_failure, validator_config.func)) - return pre_validators, post_validators - - -def inherit_validators(base_validators: 'ValidatorListDict', validators: 'ValidatorListDict') -> 'ValidatorListDict': - for field, field_validators in base_validators.items(): - if field not in validators: - validators[field] = [] - validators[field] += field_validators - return validators - - -def make_generic_validator(validator: AnyCallable) -> 'ValidatorCallable': - """ - Make a generic function which calls a validator with the right arguments. - - Unfortunately other approaches (eg. return a partial of a function that builds the arguments) is slow, - hence this laborious way of doing things. - - It's done like this so validators don't all need **kwargs in their signature, eg. any combination of - the arguments "values", "fields" and/or "config" are permitted. - """ - from inspect import signature - - sig = signature(validator) - args = list(sig.parameters.keys()) - first_arg = args.pop(0) - if first_arg == 'self': - raise ConfigError( - f'Invalid signature for validator {validator}: {sig}, "self" not permitted as first argument, ' - f'should be: (cls, value, values, config, field), "values", "config" and "field" are all optional.' - ) - elif first_arg == 'cls': - # assume the second argument is value - return wraps(validator)(_generic_validator_cls(validator, sig, set(args[1:]))) - else: - # assume the first argument was value which has already been removed - return wraps(validator)(_generic_validator_basic(validator, sig, set(args))) - - -def prep_validators(v_funcs: Iterable[AnyCallable]) -> 'ValidatorsList': - return [make_generic_validator(f) for f in v_funcs if f] - - -all_kwargs = {'values', 'field', 'config'} - - -def _generic_validator_cls(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable': - # assume the first argument is value - has_kwargs = False - if 'kwargs' in args: - has_kwargs = True - args -= {'kwargs'} - - if not args.issubset(all_kwargs): - raise ConfigError( - f'Invalid signature for validator {validator}: {sig}, should be: ' - f'(cls, value, values, config, field), "values", "config" and "field" are all optional.' - ) - - if has_kwargs: - return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config) - elif args == set(): - return lambda cls, v, values, field, config: validator(cls, v) - elif args == {'values'}: - return lambda cls, v, values, field, config: validator(cls, v, values=values) - elif args == {'field'}: - return lambda cls, v, values, field, config: validator(cls, v, field=field) - elif args == {'config'}: - return lambda cls, v, values, field, config: validator(cls, v, config=config) - elif args == {'values', 'field'}: - return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field) - elif args == {'values', 'config'}: - return lambda cls, v, values, field, config: validator(cls, v, values=values, config=config) - elif args == {'field', 'config'}: - return lambda cls, v, values, field, config: validator(cls, v, field=field, config=config) - else: - # args == {'values', 'field', 'config'} - return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config) - - -def _generic_validator_basic(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable': - has_kwargs = False - if 'kwargs' in args: - has_kwargs = True - args -= {'kwargs'} - - if not args.issubset(all_kwargs): - raise ConfigError( - f'Invalid signature for validator {validator}: {sig}, should be: ' - f'(value, values, config, field), "values", "config" and "field" are all optional.' - ) - - if has_kwargs: - return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config) - elif args == set(): - return lambda cls, v, values, field, config: validator(v) - elif args == {'values'}: - return lambda cls, v, values, field, config: validator(v, values=values) - elif args == {'field'}: - return lambda cls, v, values, field, config: validator(v, field=field) - elif args == {'config'}: - return lambda cls, v, values, field, config: validator(v, config=config) - elif args == {'values', 'field'}: - return lambda cls, v, values, field, config: validator(v, values=values, field=field) - elif args == {'values', 'config'}: - return lambda cls, v, values, field, config: validator(v, values=values, config=config) - elif args == {'field', 'config'}: - return lambda cls, v, values, field, config: validator(v, field=field, config=config) - else: - # args == {'values', 'field', 'config'} - return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config) - - -def gather_all_validators(type_: 'ModelOrDc') -> Dict[str, 'AnyClassMethod']: - all_attributes = ChainMap(*[cls.__dict__ for cls in type_.__mro__]) # type: ignore[arg-type,var-annotated] - return { - k: v - for k, v in all_attributes.items() - if hasattr(v, VALIDATOR_CONFIG_KEY) or hasattr(v, ROOT_VALIDATOR_CONFIG_KEY) - } +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/color.py b/lib/pydantic/color.py index 6fdc9fb1..108bb8fa 100644 --- a/lib/pydantic/color.py +++ b/lib/pydantic/color.py @@ -1,22 +1,28 @@ -""" -Color definitions are used as per CSS3 specification: -http://www.w3.org/TR/css3-color/#svg-color +"""Color definitions are used as per the CSS3 +[CSS Color Module Level 3](http://www.w3.org/TR/css3-color/#svg-color) specification. A few colors have multiple names referring to the sames colors, eg. `grey` and `gray` or `aqua` and `cyan`. -In these cases the LAST color when sorted alphabetically takes preferences, -eg. Color((0, 255, 255)).as_named() == 'cyan' because "cyan" comes after "aqua". +In these cases the _last_ color when sorted alphabetically takes preferences, +eg. `Color((0, 255, 255)).as_named() == 'cyan'` because "cyan" comes after "aqua". + +Warning: Deprecated + The `Color` class is deprecated, use `pydantic_extra_types` instead. + See [`pydantic-extra-types.Color`](../usage/types/extra_types/color_types.md) + for more information. """ import math import re from colorsys import hls_to_rgb, rgb_to_hls -from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union, cast +from typing import Any, Callable, Optional, Tuple, Type, Union, cast -from .errors import ColorError -from .utils import Representation, almost_equal_floats +from pydantic_core import CoreSchema, PydanticCustomError, core_schema +from typing_extensions import deprecated -if TYPE_CHECKING: - from .typing import CallableGenerator, ReprArgs +from ._internal import _repr +from ._internal._schema_generation_shared import GetJsonSchemaHandler as _GetJsonSchemaHandler +from .json_schema import JsonSchemaValue +from .warnings import PydanticDeprecatedSince20 ColorTuple = Union[Tuple[int, int, int], Tuple[int, int, int, float]] ColorType = Union[ColorTuple, str] @@ -24,9 +30,7 @@ HslColorTuple = Union[Tuple[float, float, float], Tuple[float, float, float, flo class RGBA: - """ - Internal use only as a representation of a color. - """ + """Internal use only as a representation of a color.""" __slots__ = 'r', 'g', 'b', 'alpha', '_tuple' @@ -43,24 +47,35 @@ class RGBA: # these are not compiled here to avoid import slowdown, they'll be compiled the first time they're used, then cached -r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*' -r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*' _r_255 = r'(\d{1,3}(?:\.\d+)?)' _r_comma = r'\s*,\s*' -r_rgb = fr'\s*rgb\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}\)\s*' _r_alpha = r'(\d(?:\.\d+)?|\.\d+|\d{1,2}%)' -r_rgba = fr'\s*rgba\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_alpha}\s*\)\s*' _r_h = r'(-?\d+(?:\.\d+)?|-?\.\d+)(deg|rad|turn)?' _r_sl = r'(\d{1,3}(?:\.\d+)?)%' -r_hsl = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}\s*\)\s*' -r_hsla = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}{_r_comma}{_r_alpha}\s*\)\s*' +r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*' +r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*' +# CSS3 RGB examples: rgb(0, 0, 0), rgba(0, 0, 0, 0.5), rgba(0, 0, 0, 50%) +r_rgb = rf'\s*rgba?\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}(?:{_r_comma}{_r_alpha})?\s*\)\s*' +# CSS3 HSL examples: hsl(270, 60%, 50%), hsla(270, 60%, 50%, 0.5), hsla(270, 60%, 50%, 50%) +r_hsl = rf'\s*hsla?\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}(?:{_r_comma}{_r_alpha})?\s*\)\s*' +# CSS4 RGB examples: rgb(0 0 0), rgb(0 0 0 / 0.5), rgb(0 0 0 / 50%), rgba(0 0 0 / 50%) +r_rgb_v4_style = rf'\s*rgba?\(\s*{_r_255}\s+{_r_255}\s+{_r_255}(?:\s*/\s*{_r_alpha})?\s*\)\s*' +# CSS4 HSL examples: hsl(270 60% 50%), hsl(270 60% 50% / 0.5), hsl(270 60% 50% / 50%), hsla(270 60% 50% / 50%) +r_hsl_v4_style = rf'\s*hsla?\(\s*{_r_h}\s+{_r_sl}\s+{_r_sl}(?:\s*/\s*{_r_alpha})?\s*\)\s*' # colors where the two hex characters are the same, if all colors match this the short version of hex colors can be used repeat_colors = {int(c * 2, 16) for c in '0123456789abcdef'} rads = 2 * math.pi -class Color(Representation): +@deprecated( + 'The `Color` class is deprecated, use `pydantic_extra_types` instead. ' + 'See https://docs.pydantic.dev/latest/api/pydantic_extra_types_color/.', + category=PydanticDeprecatedSince20, +) +class Color(_repr.Representation): + """Represents a color.""" + __slots__ = '_original', '_rgba' def __init__(self, value: ColorType) -> None: @@ -74,22 +89,39 @@ class Color(Representation): self._rgba = value._rgba value = value._original else: - raise ColorError(reason='value must be a tuple, list or string') + raise PydanticCustomError( + 'color_error', 'value is not a valid color: value must be a tuple, list or string' + ) # if we've got here value must be a valid color self._original = value @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + def __get_pydantic_json_schema__( + cls, core_schema: core_schema.CoreSchema, handler: _GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = {} field_schema.update(type='string', format='color') + return field_schema def original(self) -> ColorType: - """ - Original value passed to Color - """ + """Original value passed to `Color`.""" return self._original def as_named(self, *, fallback: bool = False) -> str: + """Returns the name of the color if it can be found in `COLORS_BY_VALUE` dictionary, + otherwise returns the hexadecimal representation of the color or raises `ValueError`. + + Args: + fallback: If True, falls back to returning the hexadecimal representation of + the color instead of raising a ValueError when no named color is found. + + Returns: + The name of the color, or the hexadecimal representation of the color. + + Raises: + ValueError: When no named color is found and fallback is `False`. + """ if self._rgba.alpha is None: rgb = cast(Tuple[int, int, int], self.as_rgb_tuple()) try: @@ -103,9 +135,13 @@ class Color(Representation): return self.as_hex() def as_hex(self) -> str: - """ - Hex string representing the color can be 3, 4, 6 or 8 characters depending on whether the string + """Returns the hexadecimal representation of the color. + + Hex string representing the color can be 3, 4, 6, or 8 characters depending on whether the string a "short" representation of the color is possible and whether there's an alpha channel. + + Returns: + The hexadecimal representation of the color. """ values = [float_to_255(c) for c in self._rgba[:3]] if self._rgba.alpha is not None: @@ -117,9 +153,7 @@ class Color(Representation): return '#' + as_hex def as_rgb(self) -> str: - """ - Color as an rgb(, , ) or rgba(, , , ) string. - """ + """Color as an `rgb(, , )` or `rgba(, , , )` string.""" if self._rgba.alpha is None: return f'rgb({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)})' else: @@ -129,14 +163,18 @@ class Color(Representation): ) def as_rgb_tuple(self, *, alpha: Optional[bool] = None) -> ColorTuple: - """ - Color as an RGB or RGBA tuple; red, green and blue are in the range 0 to 255, alpha if included is - in the range 0 to 1. + """Returns the color as an RGB or RGBA tuple. - :param alpha: whether to include the alpha channel, options are - None - (default) include alpha only if it's set (e.g. not None) - True - always include alpha, - False - always omit alpha, + Args: + alpha: Whether to include the alpha channel. There are three options for this input: + + - `None` (default): Include alpha only if it's set. (e.g. not `None`) + - `True`: Always include alpha. + - `False`: Always omit alpha. + + Returns: + A tuple that contains the values of the red, green, and blue channels in the range 0 to 255. + If alpha is included, it is in the range 0 to 1. """ r, g, b = (float_to_255(c) for c in self._rgba[:3]) if alpha is None: @@ -151,9 +189,7 @@ class Color(Representation): return r, g, b def as_hsl(self) -> str: - """ - Color as an hsl(, , ) or hsl(, , , ) string. - """ + """Color as an `hsl(, , )` or `hsl(, , , )` string.""" if self._rgba.alpha is None: h, s, li = self.as_hsl_tuple(alpha=False) # type: ignore return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%})' @@ -162,18 +198,23 @@ class Color(Representation): return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%}, {round(a, 2)})' def as_hsl_tuple(self, *, alpha: Optional[bool] = None) -> HslColorTuple: - """ - Color as an HSL or HSLA tuple, e.g. hue, saturation, lightness and optionally alpha; all elements are in - the range 0 to 1. + """Returns the color as an HSL or HSLA tuple. - NOTE: this is HSL as used in HTML and most other places, not HLS as used in python's colorsys. + Args: + alpha: Whether to include the alpha channel. - :param alpha: whether to include the alpha channel, options are - None - (default) include alpha only if it's set (e.g. not None) - True - always include alpha, - False - always omit alpha, + - `None` (default): Include the alpha channel only if it's set (e.g. not `None`). + - `True`: Always include alpha. + - `False`: Always omit alpha. + + Returns: + The color as a tuple of hue, saturation, lightness, and alpha (if included). + All elements are in the range 0 to 1. + + Note: + This is HSL as used in HTML and most other places, not HLS as used in Python's `colorsys`. """ - h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b) + h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b) # noqa: E741 if alpha is None: if self._rgba.alpha is None: return h, s, l @@ -189,14 +230,22 @@ class Color(Representation): return 1 if self._rgba.alpha is None else self._rgba.alpha @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls + def __get_pydantic_core_schema__( + cls, source: Type[Any], handler: Callable[[Any], CoreSchema] + ) -> core_schema.CoreSchema: + return core_schema.with_info_plain_validator_function( + cls._validate, serialization=core_schema.to_string_ser_schema() + ) + + @classmethod + def _validate(cls, __input_value: Any, _: Any) -> 'Color': + return cls(__input_value) def __str__(self) -> str: return self.as_named(fallback=True) - def __repr_args__(self) -> 'ReprArgs': - return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())] # type: ignore + def __repr_args__(self) -> '_repr.ReprArgs': + return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())] def __eq__(self, other: Any) -> bool: return isinstance(other, Color) and self.as_rgb_tuple() == other.as_rgb_tuple() @@ -206,8 +255,16 @@ class Color(Representation): def parse_tuple(value: Tuple[Any, ...]) -> RGBA: - """ - Parse a tuple or list as a color. + """Parse a tuple or list to get RGBA values. + + Args: + value: A tuple or list. + + Returns: + An `RGBA` tuple parsed from the input tuple. + + Raises: + PydanticCustomError: If tuple is not valid. """ if len(value) == 3: r, g, b = (parse_color_value(v) for v in value) @@ -216,17 +273,28 @@ def parse_tuple(value: Tuple[Any, ...]) -> RGBA: r, g, b = (parse_color_value(v) for v in value[:3]) return RGBA(r, g, b, parse_float_alpha(value[3])) else: - raise ColorError(reason='tuples must have length 3 or 4') + raise PydanticCustomError('color_error', 'value is not a valid color: tuples must have length 3 or 4') def parse_str(value: str) -> RGBA: - """ - Parse a string to an RGBA tuple, trying the following formats (in this order): - * named color, see COLORS_BY_NAME below + """Parse a string representing a color to an RGBA tuple. + + Possible formats for the input string include: + + * named color, see `COLORS_BY_NAME` * hex short eg. `fff` (prefix can be `#`, `0x` or nothing) * hex long eg. `ffffff` (prefix can be `#`, `0x` or nothing) - * `rgb(, , ) ` + * `rgb(, , )` * `rgba(, , , )` + + Args: + value: A string representing a color. + + Returns: + An `RGBA` tuple parsed from the input string. + + Raises: + ValueError: If the input string cannot be parsed to an RGBA tuple. """ value_lower = value.lower() try: @@ -256,49 +324,70 @@ def parse_str(value: str) -> RGBA: alpha = None return ints_to_rgba(r, g, b, alpha) - m = re.fullmatch(r_rgb, value_lower) - if m: - return ints_to_rgba(*m.groups(), None) # type: ignore - - m = re.fullmatch(r_rgba, value_lower) + m = re.fullmatch(r_rgb, value_lower) or re.fullmatch(r_rgb_v4_style, value_lower) if m: return ints_to_rgba(*m.groups()) # type: ignore - m = re.fullmatch(r_hsl, value_lower) + m = re.fullmatch(r_hsl, value_lower) or re.fullmatch(r_hsl_v4_style, value_lower) if m: - h, h_units, s, l_ = m.groups() - return parse_hsl(h, h_units, s, l_) + return parse_hsl(*m.groups()) # type: ignore - m = re.fullmatch(r_hsla, value_lower) - if m: - h, h_units, s, l_, a = m.groups() - return parse_hsl(h, h_units, s, l_, parse_float_alpha(a)) - - raise ColorError(reason='string not recognised as a valid color') + raise PydanticCustomError('color_error', 'value is not a valid color: string not recognised as a valid color') -def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float]) -> RGBA: +def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float] = None) -> RGBA: + """Converts integer or string values for RGB color and an optional alpha value to an `RGBA` object. + + Args: + r: An integer or string representing the red color value. + g: An integer or string representing the green color value. + b: An integer or string representing the blue color value. + alpha: A float representing the alpha value. Defaults to None. + + Returns: + An instance of the `RGBA` class with the corresponding color and alpha values. + """ return RGBA(parse_color_value(r), parse_color_value(g), parse_color_value(b), parse_float_alpha(alpha)) def parse_color_value(value: Union[int, str], max_val: int = 255) -> float: - """ - Parse a value checking it's a valid int in the range 0 to max_val and divide by max_val to give a number - in the range 0 to 1 + """Parse the color value provided and return a number between 0 and 1. + + Args: + value: An integer or string color value. + max_val: Maximum range value. Defaults to 255. + + Raises: + PydanticCustomError: If the value is not a valid color. + + Returns: + A number between 0 and 1. """ try: color = float(value) except ValueError: - raise ColorError(reason='color values must be a valid number') + raise PydanticCustomError('color_error', 'value is not a valid color: color values must be a valid number') if 0 <= color <= max_val: return color / max_val else: - raise ColorError(reason=f'color values must be in the range 0 to {max_val}') + raise PydanticCustomError( + 'color_error', + 'value is not a valid color: color values must be in the range 0 to {max_val}', + {'max_val': max_val}, + ) def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]: - """ - Parse a value checking it's a valid float in the range 0 to 1 + """Parse an alpha value checking it's a valid float in the range 0 to 1. + + Args: + value: The input value to parse. + + Returns: + The parsed value as a float, or `None` if the value was None or equal 1. + + Raises: + PydanticCustomError: If the input value cannot be successfully parsed as a float in the expected range. """ if value is None: return None @@ -308,19 +397,28 @@ def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]: else: alpha = float(value) except ValueError: - raise ColorError(reason='alpha values must be a valid float') + raise PydanticCustomError('color_error', 'value is not a valid color: alpha values must be a valid float') - if almost_equal_floats(alpha, 1): + if math.isclose(alpha, 1): return None elif 0 <= alpha <= 1: return alpha else: - raise ColorError(reason='alpha values must be in the range 0 to 1') + raise PydanticCustomError('color_error', 'value is not a valid color: alpha values must be in the range 0 to 1') def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float] = None) -> RGBA: - """ - Parse raw hue, saturation, lightness and alpha values and convert to RGBA. + """Parse raw hue, saturation, lightness, and alpha values and convert to RGBA. + + Args: + h: The hue value. + h_units: The unit for hue value. + sat: The saturation value. + light: The lightness value. + alpha: Alpha value. + + Returns: + An instance of `RGBA`. """ s_value, l_value = parse_color_value(sat, 100), parse_color_value(light, 100) @@ -334,10 +432,21 @@ def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float] h_value = h_value % 1 r, g, b = hls_to_rgb(h_value, l_value, s_value) - return RGBA(r, g, b, alpha) + return RGBA(r, g, b, parse_float_alpha(alpha)) def float_to_255(c: float) -> int: + """Converts a float value between 0 and 1 (inclusive) to an integer between 0 and 255 (inclusive). + + Args: + c: The float value to be converted. Must be between 0 and 1 (inclusive). + + Returns: + The integer equivalent of the given float value rounded to the nearest whole number. + + Raises: + ValueError: If the given float value is outside the acceptable range of 0 to 1 (inclusive). + """ return int(round(c * 255)) diff --git a/lib/pydantic/config.py b/lib/pydantic/config.py index 74687ca0..6b22586b 100644 --- a/lib/pydantic/config.py +++ b/lib/pydantic/config.py @@ -1,192 +1,912 @@ -import json -from enum import Enum -from typing import TYPE_CHECKING, Any, Callable, Dict, ForwardRef, Optional, Tuple, Type, Union +"""Configuration for Pydantic models.""" +from __future__ import annotations as _annotations -from typing_extensions import Literal, Protocol +from typing import TYPE_CHECKING, Any, Callable, Dict, List, Type, Union -from .typing import AnyArgTCallable, AnyCallable -from .utils import GetterDict -from .version import compiled +from typing_extensions import Literal, TypeAlias, TypedDict + +from ._migration import getattr_migration +from .aliases import AliasGenerator if TYPE_CHECKING: - from typing import overload + from ._internal._generate_schema import GenerateSchema as _GenerateSchema - from .fields import ModelField - from .main import BaseModel - - ConfigType = Type['BaseConfig'] - - class SchemaExtraCallable(Protocol): - @overload - def __call__(self, schema: Dict[str, Any]) -> None: - pass - - @overload - def __call__(self, schema: Dict[str, Any], model_class: Type[BaseModel]) -> None: - pass - -else: - SchemaExtraCallable = Callable[..., None] - -__all__ = 'BaseConfig', 'ConfigDict', 'get_config', 'Extra', 'inherit_config', 'prepare_config' +__all__ = ('ConfigDict',) -class Extra(str, Enum): - allow = 'allow' - ignore = 'ignore' - forbid = 'forbid' +JsonValue: TypeAlias = Union[int, float, str, bool, None, List['JsonValue'], 'JsonDict'] +JsonDict: TypeAlias = Dict[str, JsonValue] + +JsonEncoder = Callable[[Any], Any] + +JsonSchemaExtraCallable: TypeAlias = Union[ + Callable[[JsonDict], None], + Callable[[JsonDict, Type[Any]], None], +] + +ExtraValues = Literal['allow', 'ignore', 'forbid'] -# https://github.com/cython/cython/issues/4003 -# Will be fixed with Cython 3 but still in alpha right now -if not compiled: - from typing_extensions import TypedDict +class ConfigDict(TypedDict, total=False): + """A TypedDict for configuring Pydantic behaviour.""" - class ConfigDict(TypedDict, total=False): - title: Optional[str] - anystr_lower: bool - anystr_strip_whitespace: bool - min_anystr_length: int - max_anystr_length: Optional[int] - validate_all: bool - extra: Extra - allow_mutation: bool - frozen: bool - allow_population_by_field_name: bool - use_enum_values: bool - fields: Dict[str, Union[str, Dict[str, str]]] - validate_assignment: bool - error_msg_templates: Dict[str, str] - arbitrary_types_allowed: bool - orm_mode: bool - getter_dict: Type[GetterDict] - alias_generator: Optional[Callable[[str], str]] - keep_untouched: Tuple[type, ...] - schema_extra: Union[Dict[str, object], 'SchemaExtraCallable'] - json_loads: Callable[[str], object] - json_dumps: AnyArgTCallable[str] - json_encoders: Dict[Type[object], AnyCallable] - underscore_attrs_are_private: bool - allow_inf_nan: bool + title: str | None + """The title for the generated JSON schema, defaults to the model's name""" - # whether or not inherited models as fields should be reconstructed as base model - copy_on_model_validation: bool - # whether dataclass `__post_init__` should be run after validation - post_init_call: Literal['before_validation', 'after_validation'] + str_to_lower: bool + """Whether to convert all characters to lowercase for str types. Defaults to `False`.""" -else: - ConfigDict = dict # type: ignore + str_to_upper: bool + """Whether to convert all characters to uppercase for str types. Defaults to `False`.""" + str_strip_whitespace: bool + """Whether to strip leading and trailing whitespace for str types.""" + + str_min_length: int + """The minimum length for str types. Defaults to `None`.""" + + str_max_length: int | None + """The maximum length for str types. Defaults to `None`.""" + + extra: ExtraValues | None + """ + Whether to ignore, allow, or forbid extra attributes during model initialization. Defaults to `'ignore'`. + + You can configure how pydantic handles the attributes that are not defined in the model: + + * `allow` - Allow any extra attributes. + * `forbid` - Forbid any extra attributes. + * `ignore` - Ignore any extra attributes. + + ```py + from pydantic import BaseModel, ConfigDict -class BaseConfig: - title: Optional[str] = None - anystr_lower: bool = False - anystr_upper: bool = False - anystr_strip_whitespace: bool = False - min_anystr_length: int = 0 - max_anystr_length: Optional[int] = None - validate_all: bool = False - extra: Extra = Extra.ignore - allow_mutation: bool = True - frozen: bool = False - allow_population_by_field_name: bool = False - use_enum_values: bool = False - fields: Dict[str, Union[str, Dict[str, str]]] = {} - validate_assignment: bool = False - error_msg_templates: Dict[str, str] = {} - arbitrary_types_allowed: bool = False - orm_mode: bool = False - getter_dict: Type[GetterDict] = GetterDict - alias_generator: Optional[Callable[[str], str]] = None - keep_untouched: Tuple[type, ...] = () - schema_extra: Union[Dict[str, Any], 'SchemaExtraCallable'] = {} - json_loads: Callable[[str], Any] = json.loads - json_dumps: Callable[..., str] = json.dumps - json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable] = {} - underscore_attrs_are_private: bool = False - allow_inf_nan: bool = True + class User(BaseModel): + model_config = ConfigDict(extra='ignore') # (1)! - # whether inherited models as fields should be reconstructed as base model, - # and whether such a copy should be shallow or deep - copy_on_model_validation: Literal['none', 'deep', 'shallow'] = 'shallow' - - # whether `Union` should check all allowed types before even trying to coerce - smart_union: bool = False - # whether dataclass `__post_init__` should be run before or after validation - post_init_call: Literal['before_validation', 'after_validation'] = 'before_validation' - - @classmethod - def get_field_info(cls, name: str) -> Dict[str, Any]: - """ - Get properties of FieldInfo from the `fields` property of the config class. - """ - - fields_value = cls.fields.get(name) - - if isinstance(fields_value, str): - field_info: Dict[str, Any] = {'alias': fields_value} - elif isinstance(fields_value, dict): - field_info = fields_value - else: - field_info = {} - - if 'alias' in field_info: - field_info.setdefault('alias_priority', 2) - - if field_info.get('alias_priority', 0) <= 1 and cls.alias_generator: - alias = cls.alias_generator(name) - if not isinstance(alias, str): - raise TypeError(f'Config.alias_generator must return str, not {alias.__class__}') - field_info.update(alias=alias, alias_priority=1) - return field_info - - @classmethod - def prepare_field(cls, field: 'ModelField') -> None: - """ - Optional hook to check or modify fields during model creation. - """ - pass + name: str -def get_config(config: Union[ConfigDict, Type[object], None]) -> Type[BaseConfig]: - if config is None: - return BaseConfig + user = User(name='John Doe', age=20) # (2)! + print(user) + #> name='John Doe' + ``` - else: - config_dict = ( - config - if isinstance(config, dict) - else {k: getattr(config, k) for k in dir(config) if not k.startswith('__')} + 1. This is the default behaviour. + 2. The `age` argument is ignored. + + Instead, with `extra='allow'`, the `age` argument is included: + + ```py + from pydantic import BaseModel, ConfigDict + + + class User(BaseModel): + model_config = ConfigDict(extra='allow') + + name: str + + + user = User(name='John Doe', age=20) # (1)! + print(user) + #> name='John Doe' age=20 + ``` + + 1. The `age` argument is included. + + With `extra='forbid'`, an error is raised: + + ```py + from pydantic import BaseModel, ConfigDict, ValidationError + + + class User(BaseModel): + model_config = ConfigDict(extra='forbid') + + name: str + + + try: + User(name='John Doe', age=20) + except ValidationError as e: + print(e) + ''' + 1 validation error for User + age + Extra inputs are not permitted [type=extra_forbidden, input_value=20, input_type=int] + ''' + ``` + """ + + frozen: bool + """ + Whether models are faux-immutable, i.e. whether `__setattr__` is allowed, and also generates + a `__hash__()` method for the model. This makes instances of the model potentially hashable if all the + attributes are hashable. Defaults to `False`. + + Note: + On V1, the inverse of this setting was called `allow_mutation`, and was `True` by default. + """ + + populate_by_name: bool + """ + Whether an aliased field may be populated by its name as given by the model + attribute, as well as the alias. Defaults to `False`. + + Note: + The name of this configuration setting was changed in **v2.0** from + `allow_population_by_field_name` to `populate_by_name`. + + ```py + from pydantic import BaseModel, ConfigDict, Field + + + class User(BaseModel): + model_config = ConfigDict(populate_by_name=True) + + name: str = Field(alias='full_name') # (1)! + age: int + + + user = User(full_name='John Doe', age=20) # (2)! + print(user) + #> name='John Doe' age=20 + user = User(name='John Doe', age=20) # (3)! + print(user) + #> name='John Doe' age=20 + ``` + + 1. The field `'name'` has an alias `'full_name'`. + 2. The model is populated by the alias `'full_name'`. + 3. The model is populated by the field name `'name'`. + """ + + use_enum_values: bool + """ + Whether to populate models with the `value` property of enums, rather than the raw enum. + This may be useful if you want to serialize `model.model_dump()` later. Defaults to `False`. + + !!! note + If you have an `Optional[Enum]` value that you set a default for, you need to use `validate_default=True` + for said Field to ensure that the `use_enum_values` flag takes effect on the default, as extracting an + enum's value occurs during validation, not serialization. + + ```py + from enum import Enum + from typing import Optional + + from pydantic import BaseModel, ConfigDict, Field + + + class SomeEnum(Enum): + FOO = 'foo' + BAR = 'bar' + BAZ = 'baz' + + + class SomeModel(BaseModel): + model_config = ConfigDict(use_enum_values=True) + + some_enum: SomeEnum + another_enum: Optional[SomeEnum] = Field(default=SomeEnum.FOO, validate_default=True) + + + model1 = SomeModel(some_enum=SomeEnum.BAR) + print(model1.model_dump()) + # {'some_enum': 'bar', 'another_enum': 'foo'} + + model2 = SomeModel(some_enum=SomeEnum.BAR, another_enum=SomeEnum.BAZ) + print(model2.model_dump()) + #> {'some_enum': 'bar', 'another_enum': 'baz'} + ``` + """ + + validate_assignment: bool + """ + Whether to validate the data when the model is changed. Defaults to `False`. + + The default behavior of Pydantic is to validate the data when the model is created. + + In case the user changes the data after the model is created, the model is _not_ revalidated. + + ```py + from pydantic import BaseModel + + class User(BaseModel): + name: str + + user = User(name='John Doe') # (1)! + print(user) + #> name='John Doe' + user.name = 123 # (1)! + print(user) + #> name=123 + ``` + + 1. The validation happens only when the model is created. + 2. The validation does not happen when the data is changed. + + In case you want to revalidate the model when the data is changed, you can use `validate_assignment=True`: + + ```py + from pydantic import BaseModel, ValidationError + + class User(BaseModel, validate_assignment=True): # (1)! + name: str + + user = User(name='John Doe') # (2)! + print(user) + #> name='John Doe' + try: + user.name = 123 # (3)! + except ValidationError as e: + print(e) + ''' + 1 validation error for User + name + Input should be a valid string [type=string_type, input_value=123, input_type=int] + ''' + ``` + + 1. You can either use class keyword arguments, or `model_config` to set `validate_assignment=True`. + 2. The validation happens when the model is created. + 3. The validation _also_ happens when the data is changed. + """ + + arbitrary_types_allowed: bool + """ + Whether arbitrary types are allowed for field types. Defaults to `False`. + + ```py + from pydantic import BaseModel, ConfigDict, ValidationError + + # This is not a pydantic model, it's an arbitrary class + class Pet: + def __init__(self, name: str): + self.name = name + + class Model(BaseModel): + model_config = ConfigDict(arbitrary_types_allowed=True) + + pet: Pet + owner: str + + pet = Pet(name='Hedwig') + # A simple check of instance type is used to validate the data + model = Model(owner='Harry', pet=pet) + print(model) + #> pet=<__main__.Pet object at 0x0123456789ab> owner='Harry' + print(model.pet) + #> <__main__.Pet object at 0x0123456789ab> + print(model.pet.name) + #> Hedwig + print(type(model.pet)) + #> + try: + # If the value is not an instance of the type, it's invalid + Model(owner='Harry', pet='Hedwig') + except ValidationError as e: + print(e) + ''' + 1 validation error for Model + pet + Input should be an instance of Pet [type=is_instance_of, input_value='Hedwig', input_type=str] + ''' + + # Nothing in the instance of the arbitrary type is checked + # Here name probably should have been a str, but it's not validated + pet2 = Pet(name=42) + model2 = Model(owner='Harry', pet=pet2) + print(model2) + #> pet=<__main__.Pet object at 0x0123456789ab> owner='Harry' + print(model2.pet) + #> <__main__.Pet object at 0x0123456789ab> + print(model2.pet.name) + #> 42 + print(type(model2.pet)) + #> + ``` + """ + + from_attributes: bool + """ + Whether to build models and look up discriminators of tagged unions using python object attributes. + """ + + loc_by_alias: bool + """Whether to use the actual key provided in the data (e.g. alias) for error `loc`s rather than the field's name. Defaults to `True`.""" + + alias_generator: Callable[[str], str] | AliasGenerator | None + """ + A callable that takes a field name and returns an alias for it + or an instance of [`AliasGenerator`][pydantic.aliases.AliasGenerator]. Defaults to `None`. + + When using a callable, the alias generator is used for both validation and serialization. + If you want to use different alias generators for validation and serialization, you can use + [`AliasGenerator`][pydantic.aliases.AliasGenerator] instead. + + If data source field names do not match your code style (e. g. CamelCase fields), + you can automatically generate aliases using `alias_generator`. Here's an example with + a basic callable: + + ```py + from pydantic import BaseModel, ConfigDict + from pydantic.alias_generators import to_pascal + + class Voice(BaseModel): + model_config = ConfigDict(alias_generator=to_pascal) + + name: str + language_code: str + + voice = Voice(Name='Filiz', LanguageCode='tr-TR') + print(voice.language_code) + #> tr-TR + print(voice.model_dump(by_alias=True)) + #> {'Name': 'Filiz', 'LanguageCode': 'tr-TR'} + ``` + + If you want to use different alias generators for validation and serialization, you can use + [`AliasGenerator`][pydantic.aliases.AliasGenerator]. + + ```py + from pydantic import AliasGenerator, BaseModel, ConfigDict + from pydantic.alias_generators import to_camel, to_pascal + + class Athlete(BaseModel): + first_name: str + last_name: str + sport: str + + model_config = ConfigDict( + alias_generator=AliasGenerator( + validation_alias=to_camel, + serialization_alias=to_pascal, + ) ) - class Config(BaseConfig): - ... + athlete = Athlete(firstName='John', lastName='Doe', sport='track') + print(athlete.model_dump(by_alias=True)) + #> {'FirstName': 'John', 'LastName': 'Doe', 'Sport': 'track'} + ``` - for k, v in config_dict.items(): - setattr(Config, k, v) - return Config + Note: + Pydantic offers three built-in alias generators: [`to_pascal`][pydantic.alias_generators.to_pascal], + [`to_camel`][pydantic.alias_generators.to_camel], and [`to_snake`][pydantic.alias_generators.to_snake]. + """ + ignored_types: tuple[type, ...] + """A tuple of types that may occur as values of class attributes without annotations. This is + typically used for custom descriptors (classes that behave like `property`). If an attribute is set on a + class without an annotation and has a type that is not in this tuple (or otherwise recognized by + _pydantic_), an error will be raised. Defaults to `()`. + """ -def inherit_config(self_config: 'ConfigType', parent_config: 'ConfigType', **namespace: Any) -> 'ConfigType': - if not self_config: - base_classes: Tuple['ConfigType', ...] = (parent_config,) - elif self_config == parent_config: - base_classes = (self_config,) - else: - base_classes = self_config, parent_config + allow_inf_nan: bool + """Whether to allow infinity (`+inf` an `-inf`) and NaN values to float fields. Defaults to `True`.""" - namespace['json_encoders'] = { - **getattr(parent_config, 'json_encoders', {}), - **getattr(self_config, 'json_encoders', {}), - **namespace.get('json_encoders', {}), + json_schema_extra: JsonDict | JsonSchemaExtraCallable | None + """A dict or callable to provide extra JSON schema properties. Defaults to `None`.""" + + json_encoders: dict[type[object], JsonEncoder] | None + """ + A `dict` of custom JSON encoders for specific types. Defaults to `None`. + + !!! warning "Deprecated" + This config option is a carryover from v1. + We originally planned to remove it in v2 but didn't have a 1:1 replacement so we are keeping it for now. + It is still deprecated and will likely be removed in the future. + """ + + # new in V2 + strict: bool + """ + _(new in V2)_ If `True`, strict validation is applied to all fields on the model. + + By default, Pydantic attempts to coerce values to the correct type, when possible. + + There are situations in which you may want to disable this behavior, and instead raise an error if a value's type + does not match the field's type annotation. + + To configure strict mode for all fields on a model, you can set `strict=True` on the model. + + ```py + from pydantic import BaseModel, ConfigDict + + class Model(BaseModel): + model_config = ConfigDict(strict=True) + + name: str + age: int + ``` + + See [Strict Mode](../concepts/strict_mode.md) for more details. + + See the [Conversion Table](../concepts/conversion_table.md) for more details on how Pydantic converts data in both + strict and lax modes. + """ + # whether instances of models and dataclasses (including subclass instances) should re-validate, default 'never' + revalidate_instances: Literal['always', 'never', 'subclass-instances'] + """ + When and how to revalidate models and dataclasses during validation. Accepts the string + values of `'never'`, `'always'` and `'subclass-instances'`. Defaults to `'never'`. + + - `'never'` will not revalidate models and dataclasses during validation + - `'always'` will revalidate models and dataclasses during validation + - `'subclass-instances'` will revalidate models and dataclasses during validation if the instance is a + subclass of the model or dataclass + + By default, model and dataclass instances are not revalidated during validation. + + ```py + from typing import List + + from pydantic import BaseModel + + class User(BaseModel, revalidate_instances='never'): # (1)! + hobbies: List[str] + + class SubUser(User): + sins: List[str] + + class Transaction(BaseModel): + user: User + + my_user = User(hobbies=['reading']) + t = Transaction(user=my_user) + print(t) + #> user=User(hobbies=['reading']) + + my_user.hobbies = [1] # (2)! + t = Transaction(user=my_user) # (3)! + print(t) + #> user=User(hobbies=[1]) + + my_sub_user = SubUser(hobbies=['scuba diving'], sins=['lying']) + t = Transaction(user=my_sub_user) + print(t) + #> user=SubUser(hobbies=['scuba diving'], sins=['lying']) + ``` + + 1. `revalidate_instances` is set to `'never'` by **default. + 2. The assignment is not validated, unless you set `validate_assignment` to `True` in the model's config. + 3. Since `revalidate_instances` is set to `never`, this is not revalidated. + + If you want to revalidate instances during validation, you can set `revalidate_instances` to `'always'` + in the model's config. + + ```py + from typing import List + + from pydantic import BaseModel, ValidationError + + class User(BaseModel, revalidate_instances='always'): # (1)! + hobbies: List[str] + + class SubUser(User): + sins: List[str] + + class Transaction(BaseModel): + user: User + + my_user = User(hobbies=['reading']) + t = Transaction(user=my_user) + print(t) + #> user=User(hobbies=['reading']) + + my_user.hobbies = [1] + try: + t = Transaction(user=my_user) # (2)! + except ValidationError as e: + print(e) + ''' + 1 validation error for Transaction + user.hobbies.0 + Input should be a valid string [type=string_type, input_value=1, input_type=int] + ''' + + my_sub_user = SubUser(hobbies=['scuba diving'], sins=['lying']) + t = Transaction(user=my_sub_user) + print(t) # (3)! + #> user=User(hobbies=['scuba diving']) + ``` + + 1. `revalidate_instances` is set to `'always'`. + 2. The model is revalidated, since `revalidate_instances` is set to `'always'`. + 3. Using `'never'` we would have gotten `user=SubUser(hobbies=['scuba diving'], sins=['lying'])`. + + It's also possible to set `revalidate_instances` to `'subclass-instances'` to only revalidate instances + of subclasses of the model. + + ```py + from typing import List + + from pydantic import BaseModel + + class User(BaseModel, revalidate_instances='subclass-instances'): # (1)! + hobbies: List[str] + + class SubUser(User): + sins: List[str] + + class Transaction(BaseModel): + user: User + + my_user = User(hobbies=['reading']) + t = Transaction(user=my_user) + print(t) + #> user=User(hobbies=['reading']) + + my_user.hobbies = [1] + t = Transaction(user=my_user) # (2)! + print(t) + #> user=User(hobbies=[1]) + + my_sub_user = SubUser(hobbies=['scuba diving'], sins=['lying']) + t = Transaction(user=my_sub_user) + print(t) # (3)! + #> user=User(hobbies=['scuba diving']) + ``` + + 1. `revalidate_instances` is set to `'subclass-instances'`. + 2. This is not revalidated, since `my_user` is not a subclass of `User`. + 3. Using `'never'` we would have gotten `user=SubUser(hobbies=['scuba diving'], sins=['lying'])`. + """ + + ser_json_timedelta: Literal['iso8601', 'float'] + """ + The format of JSON serialized timedeltas. Accepts the string values of `'iso8601'` and + `'float'`. Defaults to `'iso8601'`. + + - `'iso8601'` will serialize timedeltas to ISO 8601 durations. + - `'float'` will serialize timedeltas to the total number of seconds. + """ + + ser_json_bytes: Literal['utf8', 'base64'] + """ + The encoding of JSON serialized bytes. Accepts the string values of `'utf8'` and `'base64'`. + Defaults to `'utf8'`. + + - `'utf8'` will serialize bytes to UTF-8 strings. + - `'base64'` will serialize bytes to URL safe base64 strings. + """ + + ser_json_inf_nan: Literal['null', 'constants'] + """ + The encoding of JSON serialized infinity and NaN float values. Accepts the string values of `'null'` and `'constants'`. + Defaults to `'null'`. + + - `'null'` will serialize infinity and NaN values as `null`. + - `'constants'` will serialize infinity and NaN values as `Infinity` and `NaN`. + """ + + # whether to validate default values during validation, default False + validate_default: bool + """Whether to validate default values during validation. Defaults to `False`.""" + + validate_return: bool + """whether to validate the return value from call validators. Defaults to `False`.""" + + protected_namespaces: tuple[str, ...] + """ + A `tuple` of strings that prevent model to have field which conflict with them. + Defaults to `('model_', )`). + + Pydantic prevents collisions between model attributes and `BaseModel`'s own methods by + namespacing them with the prefix `model_`. + + ```py + import warnings + + from pydantic import BaseModel + + warnings.filterwarnings('error') # Raise warnings as errors + + try: + + class Model(BaseModel): + model_prefixed_field: str + + except UserWarning as e: + print(e) + ''' + Field "model_prefixed_field" has conflict with protected namespace "model_". + + You may be able to resolve this warning by setting `model_config['protected_namespaces'] = ()`. + ''' + ``` + + You can customize this behavior using the `protected_namespaces` setting: + + ```py + import warnings + + from pydantic import BaseModel, ConfigDict + + warnings.filterwarnings('error') # Raise warnings as errors + + try: + + class Model(BaseModel): + model_prefixed_field: str + also_protect_field: str + + model_config = ConfigDict( + protected_namespaces=('protect_me_', 'also_protect_') + ) + + except UserWarning as e: + print(e) + ''' + Field "also_protect_field" has conflict with protected namespace "also_protect_". + + You may be able to resolve this warning by setting `model_config['protected_namespaces'] = ('protect_me_',)`. + ''' + ``` + + While Pydantic will only emit a warning when an item is in a protected namespace but does not actually have a collision, + an error _is_ raised if there is an actual collision with an existing attribute: + + ```py + from pydantic import BaseModel + + try: + + class Model(BaseModel): + model_validate: str + + except NameError as e: + print(e) + ''' + Field "model_validate" conflicts with member > of protected namespace "model_". + ''' + ``` + """ + + hide_input_in_errors: bool + """ + Whether to hide inputs when printing errors. Defaults to `False`. + + Pydantic shows the input value and type when it raises `ValidationError` during the validation. + + ```py + from pydantic import BaseModel, ValidationError + + class Model(BaseModel): + a: str + + try: + Model(a=123) + except ValidationError as e: + print(e) + ''' + 1 validation error for Model + a + Input should be a valid string [type=string_type, input_value=123, input_type=int] + ''' + ``` + + You can hide the input value and type by setting the `hide_input_in_errors` config to `True`. + + ```py + from pydantic import BaseModel, ConfigDict, ValidationError + + class Model(BaseModel): + a: str + model_config = ConfigDict(hide_input_in_errors=True) + + try: + Model(a=123) + except ValidationError as e: + print(e) + ''' + 1 validation error for Model + a + Input should be a valid string [type=string_type] + ''' + ``` + """ + + defer_build: bool + """ + Whether to defer model validator and serializer construction until the first model validation. + + This can be useful to avoid the overhead of building models which are only + used nested within other models, or when you want to manually define type namespace via + [`Model.model_rebuild(_types_namespace=...)`][pydantic.BaseModel.model_rebuild]. Defaults to False. + """ + + plugin_settings: dict[str, object] | None + """A `dict` of settings for plugins. Defaults to `None`. + + See [Pydantic Plugins](../concepts/plugins.md) for details. + """ + + schema_generator: type[_GenerateSchema] | None + """ + A custom core schema generator class to use when generating JSON schemas. + Useful if you want to change the way types are validated across an entire model/schema. Defaults to `None`. + + The `GenerateSchema` interface is subject to change, currently only the `string_schema` method is public. + + See [#6737](https://github.com/pydantic/pydantic/pull/6737) for details. + """ + + json_schema_serialization_defaults_required: bool + """ + Whether fields with default values should be marked as required in the serialization schema. Defaults to `False`. + + This ensures that the serialization schema will reflect the fact a field with a default will always be present + when serializing the model, even though it is not required for validation. + + However, there are scenarios where this may be undesirable — in particular, if you want to share the schema + between validation and serialization, and don't mind fields with defaults being marked as not required during + serialization. See [#7209](https://github.com/pydantic/pydantic/issues/7209) for more details. + + ```py + from pydantic import BaseModel, ConfigDict + + class Model(BaseModel): + a: str = 'a' + + model_config = ConfigDict(json_schema_serialization_defaults_required=True) + + print(Model.model_json_schema(mode='validation')) + ''' + { + 'properties': {'a': {'default': 'a', 'title': 'A', 'type': 'string'}}, + 'title': 'Model', + 'type': 'object', } + ''' + print(Model.model_json_schema(mode='serialization')) + ''' + { + 'properties': {'a': {'default': 'a', 'title': 'A', 'type': 'string'}}, + 'required': ['a'], + 'title': 'Model', + 'type': 'object', + } + ''' + ``` + """ - return type('Config', base_classes, namespace) + json_schema_mode_override: Literal['validation', 'serialization', None] + """ + If not `None`, the specified mode will be used to generate the JSON schema regardless of what `mode` was passed to + the function call. Defaults to `None`. + + This provides a way to force the JSON schema generation to reflect a specific mode, e.g., to always use the + validation schema. + + It can be useful when using frameworks (such as FastAPI) that may generate different schemas for validation + and serialization that must both be referenced from the same schema; when this happens, we automatically append + `-Input` to the definition reference for the validation schema and `-Output` to the definition reference for the + serialization schema. By specifying a `json_schema_mode_override` though, this prevents the conflict between + the validation and serialization schemas (since both will use the specified schema), and so prevents the suffixes + from being added to the definition references. + + ```py + from pydantic import BaseModel, ConfigDict, Json + + class Model(BaseModel): + a: Json[int] # requires a string to validate, but will dump an int + + print(Model.model_json_schema(mode='serialization')) + ''' + { + 'properties': {'a': {'title': 'A', 'type': 'integer'}}, + 'required': ['a'], + 'title': 'Model', + 'type': 'object', + } + ''' + + class ForceInputModel(Model): + # the following ensures that even with mode='serialization', we + # will get the schema that would be generated for validation. + model_config = ConfigDict(json_schema_mode_override='validation') + + print(ForceInputModel.model_json_schema(mode='serialization')) + ''' + { + 'properties': { + 'a': { + 'contentMediaType': 'application/json', + 'contentSchema': {'type': 'integer'}, + 'title': 'A', + 'type': 'string', + } + }, + 'required': ['a'], + 'title': 'ForceInputModel', + 'type': 'object', + } + ''' + ``` + """ + + coerce_numbers_to_str: bool + """ + If `True`, enables automatic coercion of any `Number` type to `str` in "lax" (non-strict) mode. Defaults to `False`. + + Pydantic doesn't allow number types (`int`, `float`, `Decimal`) to be coerced as type `str` by default. + + ```py + from decimal import Decimal + + from pydantic import BaseModel, ConfigDict, ValidationError + + class Model(BaseModel): + value: str + + try: + print(Model(value=42)) + except ValidationError as e: + print(e) + ''' + 1 validation error for Model + value + Input should be a valid string [type=string_type, input_value=42, input_type=int] + ''' + + class Model(BaseModel): + model_config = ConfigDict(coerce_numbers_to_str=True) + + value: str + + repr(Model(value=42).value) + #> "42" + repr(Model(value=42.13).value) + #> "42.13" + repr(Model(value=Decimal('42.13')).value) + #> "42.13" + ``` + """ + + regex_engine: Literal['rust-regex', 'python-re'] + """ + The regex engine to used for pattern validation + Defaults to `'rust-regex'`. + + - `rust-regex` uses the [`regex`](https://docs.rs/regex) Rust crate, + which is non-backtracking and therefore more DDoS resistant, but does not support all regex features. + - `python-re` use the [`re`](https://docs.python.org/3/library/re.html) module, + which supports all regex features, but may be slower. + + ```py + from pydantic import BaseModel, ConfigDict, Field, ValidationError + + class Model(BaseModel): + model_config = ConfigDict(regex_engine='python-re') + + value: str = Field(pattern=r'^abc(?=def)') + + print(Model(value='abcdef').value) + #> abcdef + + try: + print(Model(value='abxyzcdef')) + except ValidationError as e: + print(e) + ''' + 1 validation error for Model + value + String should match pattern '^abc(?=def)' [type=string_pattern_mismatch, input_value='abxyzcdef', input_type=str] + ''' + ``` + """ + + validation_error_cause: bool + """ + If `True`, python exceptions that were part of a validation failure will be shown as an exception group as a cause. Can be useful for debugging. Defaults to `False`. + + Note: + Python 3.10 and older don't support exception groups natively. <=3.10, backport must be installed: `pip install exceptiongroup`. + + Note: + The structure of validation errors are likely to change in future pydantic versions. Pydantic offers no guarantees about the structure of validation errors. Should be used for visual traceback debugging only. + """ -def prepare_config(config: Type[BaseConfig], cls_name: str) -> None: - if not isinstance(config.extra, Extra): - try: - config.extra = Extra(config.extra) - except ValueError: - raise ValueError(f'"{cls_name}": {config.extra} is not a valid value for "extra"') +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/dataclasses.py b/lib/pydantic/dataclasses.py index 68331127..d9c9c903 100644 --- a/lib/pydantic/dataclasses.py +++ b/lib/pydantic/dataclasses.py @@ -1,479 +1,327 @@ -""" -The main purpose is to enhance stdlib dataclasses by adding validation -A pydantic dataclass can be generated from scratch or from a stdlib one. +"""Provide an enhanced dataclass that performs validation.""" +from __future__ import annotations as _annotations -Behind the scene, a pydantic dataclass is just like a regular one on which we attach -a `BaseModel` and magic methods to trigger the validation of the data. -`__init__` and `__post_init__` are hence overridden and have extra logic to be -able to validate input data. - -When a pydantic dataclass is generated from scratch, it's just a plain dataclass -with validation triggered at initialization - -The tricky part if for stdlib dataclasses that are converted after into pydantic ones e.g. - -```py -@dataclasses.dataclass -class M: - x: int - -ValidatedM = pydantic.dataclasses.dataclass(M) -``` - -We indeed still want to support equality, hashing, repr, ... as if it was the stdlib one! - -```py -assert isinstance(ValidatedM(x=1), M) -assert ValidatedM(x=1) == M(x=1) -``` - -This means we **don't want to create a new dataclass that inherits from it** -The trick is to create a wrapper around `M` that will act as a proxy to trigger -validation without altering default `M` behaviour. -""" +import dataclasses import sys -from contextlib import contextmanager -from functools import wraps -from typing import ( - TYPE_CHECKING, - Any, - Callable, - ClassVar, - Dict, - Generator, - Optional, - Set, - Type, - TypeVar, - Union, - overload, -) +import types +from typing import TYPE_CHECKING, Any, Callable, Generic, NoReturn, TypeVar, overload -from typing_extensions import dataclass_transform +from typing_extensions import Literal, TypeGuard, dataclass_transform -from .class_validators import gather_all_validators -from .config import BaseConfig, ConfigDict, Extra, get_config -from .error_wrappers import ValidationError -from .errors import DataclassTypeError -from .fields import Field, FieldInfo, Required, Undefined -from .main import create_model, validate_model -from .utils import ClassAttribute +from ._internal import _config, _decorators, _typing_extra +from ._internal import _dataclasses as _pydantic_dataclasses +from ._migration import getattr_migration +from .config import ConfigDict +from .fields import Field, FieldInfo if TYPE_CHECKING: - from .main import BaseModel - from .typing import CallableGenerator, NoArgAnyCallable + from ._internal._dataclasses import PydanticDataclass - DataclassT = TypeVar('DataclassT', bound='Dataclass') - - DataclassClassOrWrapper = Union[Type['Dataclass'], 'DataclassProxy'] - - class Dataclass: - # stdlib attributes - __dataclass_fields__: ClassVar[Dict[str, Any]] - __dataclass_params__: ClassVar[Any] # in reality `dataclasses._DataclassParams` - __post_init__: ClassVar[Callable[..., None]] - - # Added by pydantic - __pydantic_run_validation__: ClassVar[bool] - __post_init_post_parse__: ClassVar[Callable[..., None]] - __pydantic_initialised__: ClassVar[bool] - __pydantic_model__: ClassVar[Type[BaseModel]] - __pydantic_validate_values__: ClassVar[Callable[['Dataclass'], None]] - __pydantic_has_field_info_default__: ClassVar[bool] # whether a `pydantic.Field` is used as default value - - def __init__(self, *args: object, **kwargs: object) -> None: - pass - - @classmethod - def __get_validators__(cls: Type['Dataclass']) -> 'CallableGenerator': - pass - - @classmethod - def __validate__(cls: Type['DataclassT'], v: Any) -> 'DataclassT': - pass - - -__all__ = [ - 'dataclass', - 'set_validation', - 'create_pydantic_model_from_dataclass', - 'is_builtin_dataclass', - 'make_dataclass_validator', -] +__all__ = 'dataclass', 'rebuild_dataclass' _T = TypeVar('_T') if sys.version_info >= (3, 10): - @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo)) + @dataclass_transform(field_specifiers=(dataclasses.field, Field)) @overload def dataclass( *, - init: bool = True, + init: Literal[False] = False, repr: bool = True, eq: bool = True, order: bool = False, unsafe_hash: bool = False, frozen: bool = False, - config: Union[ConfigDict, Type[object], None] = None, - validate_on_init: Optional[bool] = None, + config: ConfigDict | type[object] | None = None, + validate_on_init: bool | None = None, kw_only: bool = ..., - ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']: + slots: bool = ..., + ) -> Callable[[type[_T]], type[PydanticDataclass]]: # type: ignore ... - @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo)) + @dataclass_transform(field_specifiers=(dataclasses.field, Field)) @overload def dataclass( - _cls: Type[_T], + _cls: type[_T], # type: ignore *, - init: bool = True, + init: Literal[False] = False, repr: bool = True, eq: bool = True, order: bool = False, unsafe_hash: bool = False, frozen: bool = False, - config: Union[ConfigDict, Type[object], None] = None, - validate_on_init: Optional[bool] = None, + config: ConfigDict | type[object] | None = None, + validate_on_init: bool | None = None, kw_only: bool = ..., - ) -> 'DataclassClassOrWrapper': + slots: bool = ..., + ) -> type[PydanticDataclass]: ... else: - @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo)) + @dataclass_transform(field_specifiers=(dataclasses.field, Field)) @overload def dataclass( *, - init: bool = True, + init: Literal[False] = False, repr: bool = True, eq: bool = True, order: bool = False, unsafe_hash: bool = False, frozen: bool = False, - config: Union[ConfigDict, Type[object], None] = None, - validate_on_init: Optional[bool] = None, - ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']: + config: ConfigDict | type[object] | None = None, + validate_on_init: bool | None = None, + ) -> Callable[[type[_T]], type[PydanticDataclass]]: # type: ignore ... - @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo)) + @dataclass_transform(field_specifiers=(dataclasses.field, Field)) @overload def dataclass( - _cls: Type[_T], + _cls: type[_T], # type: ignore *, - init: bool = True, + init: Literal[False] = False, repr: bool = True, eq: bool = True, order: bool = False, unsafe_hash: bool = False, frozen: bool = False, - config: Union[ConfigDict, Type[object], None] = None, - validate_on_init: Optional[bool] = None, - ) -> 'DataclassClassOrWrapper': + config: ConfigDict | type[object] | None = None, + validate_on_init: bool | None = None, + ) -> type[PydanticDataclass]: ... -@dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo)) -def dataclass( - _cls: Optional[Type[_T]] = None, +@dataclass_transform(field_specifiers=(dataclasses.field, Field)) +def dataclass( # noqa: C901 + _cls: type[_T] | None = None, *, - init: bool = True, + init: Literal[False] = False, repr: bool = True, eq: bool = True, order: bool = False, unsafe_hash: bool = False, frozen: bool = False, - config: Union[ConfigDict, Type[object], None] = None, - validate_on_init: Optional[bool] = None, + config: ConfigDict | type[object] | None = None, + validate_on_init: bool | None = None, kw_only: bool = False, -) -> Union[Callable[[Type[_T]], 'DataclassClassOrWrapper'], 'DataclassClassOrWrapper']: + slots: bool = False, +) -> Callable[[type[_T]], type[PydanticDataclass]] | type[PydanticDataclass]: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/dataclasses/ + + A decorator used to create a Pydantic-enhanced dataclass, similar to the standard Python `dataclass`, + but with added validation. + + This function should be used similarly to `dataclasses.dataclass`. + + Args: + _cls: The target `dataclass`. + init: Included for signature compatibility with `dataclasses.dataclass`, and is passed through to + `dataclasses.dataclass` when appropriate. If specified, must be set to `False`, as pydantic inserts its + own `__init__` function. + repr: A boolean indicating whether to include the field in the `__repr__` output. + eq: Determines if a `__eq__` method should be generated for the class. + order: Determines if comparison magic methods should be generated, such as `__lt__`, but not `__eq__`. + unsafe_hash: Determines if a `__hash__` method should be included in the class, as in `dataclasses.dataclass`. + frozen: Determines if the generated class should be a 'frozen' `dataclass`, which does not allow its + attributes to be modified after it has been initialized. + config: The Pydantic config to use for the `dataclass`. + validate_on_init: A deprecated parameter included for backwards compatibility; in V2, all Pydantic dataclasses + are validated on init. + kw_only: Determines if `__init__` method parameters must be specified by keyword only. Defaults to `False`. + slots: Determines if the generated class should be a 'slots' `dataclass`, which does not allow the addition of + new attributes after instantiation. + + Returns: + A decorator that accepts a class as its argument and returns a Pydantic `dataclass`. + + Raises: + AssertionError: Raised if `init` is not `False` or `validate_on_init` is `False`. """ - Like the python standard lib dataclasses but with type validation. - The result is either a pydantic dataclass that will validate input data - or a wrapper that will trigger validation around a stdlib dataclass - to avoid modifying it directly - """ - the_config = get_config(config) + assert init is False, 'pydantic.dataclasses.dataclass only supports init=False' + assert validate_on_init is not False, 'validate_on_init=False is no longer supported' - def wrap(cls: Type[Any]) -> 'DataclassClassOrWrapper': - import dataclasses + if sys.version_info >= (3, 10): + kwargs = dict(kw_only=kw_only, slots=slots) + else: + kwargs = {} - if is_builtin_dataclass(cls) and _extra_dc_args(_cls) == _extra_dc_args(_cls.__bases__[0]): # type: ignore - dc_cls_doc = '' - dc_cls = DataclassProxy(cls) - default_validate_on_init = False - else: - dc_cls_doc = cls.__doc__ or '' # needs to be done before generating dataclass - if sys.version_info >= (3, 10): - dc_cls = dataclasses.dataclass( - cls, - init=init, - repr=repr, - eq=eq, - order=order, - unsafe_hash=unsafe_hash, - frozen=frozen, - kw_only=kw_only, - ) - else: - dc_cls = dataclasses.dataclass( # type: ignore - cls, init=init, repr=repr, eq=eq, order=order, unsafe_hash=unsafe_hash, frozen=frozen - ) - default_validate_on_init = True + def make_pydantic_fields_compatible(cls: type[Any]) -> None: + """Make sure that stdlib `dataclasses` understands `Field` kwargs like `kw_only` + To do that, we simply change + `x: int = pydantic.Field(..., kw_only=True)` + into + `x: int = dataclasses.field(default=pydantic.Field(..., kw_only=True), kw_only=True)` + """ + for annotation_cls in cls.__mro__: + # In Python < 3.9, `__annotations__` might not be present if there are no fields. + # we therefore need to use `getattr` to avoid an `AttributeError`. + annotations = getattr(annotation_cls, '__annotations__', []) + for field_name in annotations: + field_value = getattr(cls, field_name, None) + # Process only if this is an instance of `FieldInfo`. + if not isinstance(field_value, FieldInfo): + continue - should_validate_on_init = default_validate_on_init if validate_on_init is None else validate_on_init - _add_pydantic_validation_attributes(cls, the_config, should_validate_on_init, dc_cls_doc) - dc_cls.__pydantic_model__.__try_update_forward_refs__(**{cls.__name__: cls}) - return dc_cls + # Initialize arguments for the standard `dataclasses.field`. + field_args: dict = {'default': field_value} + + # Handle `kw_only` for Python 3.10+ + if sys.version_info >= (3, 10) and field_value.kw_only: + field_args['kw_only'] = True + + # Set `repr` attribute if it's explicitly specified to be not `True`. + if field_value.repr is not True: + field_args['repr'] = field_value.repr + + setattr(cls, field_name, dataclasses.field(**field_args)) + # In Python 3.8, dataclasses checks cls.__dict__['__annotations__'] for annotations, + # so we must make sure it's initialized before we add to it. + if cls.__dict__.get('__annotations__') is None: + cls.__annotations__ = {} + cls.__annotations__[field_name] = annotations[field_name] + + def create_dataclass(cls: type[Any]) -> type[PydanticDataclass]: + """Create a Pydantic dataclass from a regular dataclass. + + Args: + cls: The class to create the Pydantic dataclass from. + + Returns: + A Pydantic dataclass. + """ + original_cls = cls + + config_dict = config + if config_dict is None: + # if not explicitly provided, read from the type + cls_config = getattr(cls, '__pydantic_config__', None) + if cls_config is not None: + config_dict = cls_config + config_wrapper = _config.ConfigWrapper(config_dict) + decorators = _decorators.DecoratorInfos.build(cls) + + # Keep track of the original __doc__ so that we can restore it after applying the dataclasses decorator + # Otherwise, classes with no __doc__ will have their signature added into the JSON schema description, + # since dataclasses.dataclass will set this as the __doc__ + original_doc = cls.__doc__ + + if _pydantic_dataclasses.is_builtin_dataclass(cls): + # Don't preserve the docstring for vanilla dataclasses, as it may include the signature + # This matches v1 behavior, and there was an explicit test for it + original_doc = None + + # We don't want to add validation to the existing std lib dataclass, so we will subclass it + # If the class is generic, we need to make sure the subclass also inherits from Generic + # with all the same parameters. + bases = (cls,) + if issubclass(cls, Generic): + generic_base = Generic[cls.__parameters__] # type: ignore + bases = bases + (generic_base,) + cls = types.new_class(cls.__name__, bases) + + make_pydantic_fields_compatible(cls) + + cls = dataclasses.dataclass( # type: ignore[call-overload] + cls, + # the value of init here doesn't affect anything except that it makes it easier to generate a signature + init=True, + repr=repr, + eq=eq, + order=order, + unsafe_hash=unsafe_hash, + frozen=frozen, + **kwargs, + ) + + cls.__pydantic_decorators__ = decorators # type: ignore + cls.__doc__ = original_doc + cls.__module__ = original_cls.__module__ + cls.__qualname__ = original_cls.__qualname__ + pydantic_complete = _pydantic_dataclasses.complete_dataclass( + cls, config_wrapper, raise_errors=False, types_namespace=None + ) + cls.__pydantic_complete__ = pydantic_complete # type: ignore + return cls if _cls is None: - return wrap + return create_dataclass - return wrap(_cls) + return create_dataclass(_cls) -@contextmanager -def set_validation(cls: Type['DataclassT'], value: bool) -> Generator[Type['DataclassT'], None, None]: - original_run_validation = cls.__pydantic_run_validation__ - try: - cls.__pydantic_run_validation__ = value - yield cls - finally: - cls.__pydantic_run_validation__ = original_run_validation +__getattr__ = getattr_migration(__name__) + +if (3, 8) <= sys.version_info < (3, 11): + # Monkeypatch dataclasses.InitVar so that typing doesn't error if it occurs as a type when evaluating type hints + # Starting in 3.11, typing.get_type_hints will not raise an error if the retrieved type hints are not callable. + + def _call_initvar(*args: Any, **kwargs: Any) -> NoReturn: + """This function does nothing but raise an error that is as similar as possible to what you'd get + if you were to try calling `InitVar[int]()` without this monkeypatch. The whole purpose is just + to ensure typing._type_check does not error if the type hint evaluates to `InitVar[]`. + """ + raise TypeError("'InitVar' object is not callable") + + dataclasses.InitVar.__call__ = _call_initvar -class DataclassProxy: - __slots__ = '__dataclass__' +def rebuild_dataclass( + cls: type[PydanticDataclass], + *, + force: bool = False, + raise_errors: bool = True, + _parent_namespace_depth: int = 2, + _types_namespace: dict[str, Any] | None = None, +) -> bool | None: + """Try to rebuild the pydantic-core schema for the dataclass. - def __init__(self, dc_cls: Type['Dataclass']) -> None: - object.__setattr__(self, '__dataclass__', dc_cls) + This may be necessary when one of the annotations is a ForwardRef which could not be resolved during + the initial attempt to build the schema, and automatic rebuilding fails. - def __call__(self, *args: Any, **kwargs: Any) -> Any: - with set_validation(self.__dataclass__, True): - return self.__dataclass__(*args, **kwargs) + This is analogous to `BaseModel.model_rebuild`. - def __getattr__(self, name: str) -> Any: - return getattr(self.__dataclass__, name) + Args: + cls: The class to rebuild the pydantic-core schema for. + force: Whether to force the rebuilding of the schema, defaults to `False`. + raise_errors: Whether to raise errors, defaults to `True`. + _parent_namespace_depth: The depth level of the parent namespace, defaults to 2. + _types_namespace: The types namespace, defaults to `None`. - def __instancecheck__(self, instance: Any) -> bool: - return isinstance(instance, self.__dataclass__) - - -def _add_pydantic_validation_attributes( # noqa: C901 (ignore complexity) - dc_cls: Type['Dataclass'], - config: Type[BaseConfig], - validate_on_init: bool, - dc_cls_doc: str, -) -> None: + Returns: + Returns `None` if the schema is already "complete" and rebuilding was not required. + If rebuilding _was_ required, returns `True` if rebuilding was successful, otherwise `False`. """ - We need to replace the right method. If no `__post_init__` has been set in the stdlib dataclass - it won't even exist (code is generated on the fly by `dataclasses`) - By default, we run validation after `__init__` or `__post_init__` if defined - """ - init = dc_cls.__init__ - - @wraps(init) - def handle_extra_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None: - if config.extra == Extra.ignore: - init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__}) - - elif config.extra == Extra.allow: - for k, v in kwargs.items(): - self.__dict__.setdefault(k, v) - init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__}) - - else: - init(self, *args, **kwargs) - - if hasattr(dc_cls, '__post_init__'): - post_init = dc_cls.__post_init__ - - @wraps(post_init) - def new_post_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None: - if config.post_init_call == 'before_validation': - post_init(self, *args, **kwargs) - - if self.__class__.__pydantic_run_validation__: - self.__pydantic_validate_values__() - if hasattr(self, '__post_init_post_parse__'): - self.__post_init_post_parse__(*args, **kwargs) - - if config.post_init_call == 'after_validation': - post_init(self, *args, **kwargs) - - setattr(dc_cls, '__init__', handle_extra_init) - setattr(dc_cls, '__post_init__', new_post_init) - + if not force and cls.__pydantic_complete__: + return None else: - - @wraps(init) - def new_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None: - handle_extra_init(self, *args, **kwargs) - - if self.__class__.__pydantic_run_validation__: - self.__pydantic_validate_values__() - - if hasattr(self, '__post_init_post_parse__'): - # We need to find again the initvars. To do that we use `__dataclass_fields__` instead of - # public method `dataclasses.fields` - import dataclasses - - # get all initvars and their default values - initvars_and_values: Dict[str, Any] = {} - for i, f in enumerate(self.__class__.__dataclass_fields__.values()): - if f._field_type is dataclasses._FIELD_INITVAR: # type: ignore[attr-defined] - try: - # set arg value by default - initvars_and_values[f.name] = args[i] - except IndexError: - initvars_and_values[f.name] = kwargs.get(f.name, f.default) - - self.__post_init_post_parse__(**initvars_and_values) - - setattr(dc_cls, '__init__', new_init) - - setattr(dc_cls, '__pydantic_run_validation__', ClassAttribute('__pydantic_run_validation__', validate_on_init)) - setattr(dc_cls, '__pydantic_initialised__', False) - setattr(dc_cls, '__pydantic_model__', create_pydantic_model_from_dataclass(dc_cls, config, dc_cls_doc)) - setattr(dc_cls, '__pydantic_validate_values__', _dataclass_validate_values) - setattr(dc_cls, '__validate__', classmethod(_validate_dataclass)) - setattr(dc_cls, '__get_validators__', classmethod(_get_validators)) - - if dc_cls.__pydantic_model__.__config__.validate_assignment and not dc_cls.__dataclass_params__.frozen: - setattr(dc_cls, '__setattr__', _dataclass_validate_assignment_setattr) - - -def _get_validators(cls: 'DataclassClassOrWrapper') -> 'CallableGenerator': - yield cls.__validate__ - - -def _validate_dataclass(cls: Type['DataclassT'], v: Any) -> 'DataclassT': - with set_validation(cls, True): - if isinstance(v, cls): - v.__pydantic_validate_values__() - return v - elif isinstance(v, (list, tuple)): - return cls(*v) - elif isinstance(v, dict): - return cls(**v) + if _types_namespace is not None: + types_namespace: dict[str, Any] | None = _types_namespace.copy() else: - raise DataclassTypeError(class_name=cls.__name__) + if _parent_namespace_depth > 0: + frame_parent_ns = _typing_extra.parent_frame_namespace(parent_depth=_parent_namespace_depth) or {} + # Note: we may need to add something similar to cls.__pydantic_parent_namespace__ from BaseModel + # here when implementing handling of recursive generics. See BaseModel.model_rebuild for reference. + types_namespace = frame_parent_ns + else: + types_namespace = {} + + types_namespace = _typing_extra.get_cls_types_namespace(cls, types_namespace) + return _pydantic_dataclasses.complete_dataclass( + cls, + _config.ConfigWrapper(cls.__pydantic_config__, check=False), + raise_errors=raise_errors, + types_namespace=types_namespace, + ) -def create_pydantic_model_from_dataclass( - dc_cls: Type['Dataclass'], - config: Type[Any] = BaseConfig, - dc_cls_doc: Optional[str] = None, -) -> Type['BaseModel']: - import dataclasses +def is_pydantic_dataclass(__cls: type[Any]) -> TypeGuard[type[PydanticDataclass]]: + """Whether a class is a pydantic dataclass. - field_definitions: Dict[str, Any] = {} - for field in dataclasses.fields(dc_cls): - default: Any = Undefined - default_factory: Optional['NoArgAnyCallable'] = None - field_info: FieldInfo + Args: + __cls: The class. - if field.default is not dataclasses.MISSING: - default = field.default - elif field.default_factory is not dataclasses.MISSING: - default_factory = field.default_factory - else: - default = Required - - if isinstance(default, FieldInfo): - field_info = default - dc_cls.__pydantic_has_field_info_default__ = True - else: - field_info = Field(default=default, default_factory=default_factory, **field.metadata) - - field_definitions[field.name] = (field.type, field_info) - - validators = gather_all_validators(dc_cls) - model: Type['BaseModel'] = create_model( - dc_cls.__name__, - __config__=config, - __module__=dc_cls.__module__, - __validators__=validators, - __cls_kwargs__={'__resolve_forward_refs__': False}, - **field_definitions, - ) - model.__doc__ = dc_cls_doc if dc_cls_doc is not None else dc_cls.__doc__ or '' - return model - - -def _dataclass_validate_values(self: 'Dataclass') -> None: - # validation errors can occur if this function is called twice on an already initialised dataclass. - # for example if Extra.forbid is enabled, it would consider __pydantic_initialised__ an invalid extra property - if getattr(self, '__pydantic_initialised__'): - return - if getattr(self, '__pydantic_has_field_info_default__', False): - # We need to remove `FieldInfo` values since they are not valid as input - # It's ok to do that because they are obviously the default values! - input_data = {k: v for k, v in self.__dict__.items() if not isinstance(v, FieldInfo)} - else: - input_data = self.__dict__ - d, _, validation_error = validate_model(self.__pydantic_model__, input_data, cls=self.__class__) - if validation_error: - raise validation_error - self.__dict__.update(d) - object.__setattr__(self, '__pydantic_initialised__', True) - - -def _dataclass_validate_assignment_setattr(self: 'Dataclass', name: str, value: Any) -> None: - if self.__pydantic_initialised__: - d = dict(self.__dict__) - d.pop(name, None) - known_field = self.__pydantic_model__.__fields__.get(name, None) - if known_field: - value, error_ = known_field.validate(value, d, loc=name, cls=self.__class__) - if error_: - raise ValidationError([error_], self.__class__) - - object.__setattr__(self, name, value) - - -def _extra_dc_args(cls: Type[Any]) -> Set[str]: - return { - x - for x in dir(cls) - if x not in getattr(cls, '__dataclass_fields__', {}) and not (x.startswith('__') and x.endswith('__')) - } - - -def is_builtin_dataclass(_cls: Type[Any]) -> bool: + Returns: + `True` if the class is a pydantic dataclass, `False` otherwise. """ - Whether a class is a stdlib dataclass - (useful to discriminated a pydantic dataclass that is actually a wrapper around a stdlib dataclass) - - we check that - - `_cls` is a dataclass - - `_cls` is not a processed pydantic dataclass (with a basemodel attached) - - `_cls` is not a pydantic dataclass inheriting directly from a stdlib dataclass - e.g. - ``` - @dataclasses.dataclass - class A: - x: int - - @pydantic.dataclasses.dataclass - class B(A): - y: int - ``` - In this case, when we first check `B`, we make an extra check and look at the annotations ('y'), - which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x') - """ - import dataclasses - - return ( - dataclasses.is_dataclass(_cls) - and not hasattr(_cls, '__pydantic_model__') - and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {}))) - ) - - -def make_dataclass_validator(dc_cls: Type['Dataclass'], config: Type[BaseConfig]) -> 'CallableGenerator': - """ - Create a pydantic.dataclass from a builtin dataclass to add type validation - and yield the validators - It retrieves the parameters of the dataclass and forwards them to the newly created dataclass - """ - yield from _get_validators(dataclass(dc_cls, config=config, validate_on_init=False)) + return dataclasses.is_dataclass(__cls) and '__pydantic_validator__' in __cls.__dict__ diff --git a/lib/pydantic/datetime_parse.py b/lib/pydantic/datetime_parse.py index cfd54593..902219df 100644 --- a/lib/pydantic/datetime_parse.py +++ b/lib/pydantic/datetime_parse.py @@ -1,248 +1,4 @@ -""" -Functions to parse datetime objects. +"""The `datetime_parse` module is a backport module from V1.""" +from ._migration import getattr_migration -We're using regular expressions rather than time.strptime because: -- They provide both validation and parsing. -- They're more flexible for datetimes. -- The date/datetime/time constructors produce friendlier error messages. - -Stolen from https://raw.githubusercontent.com/django/django/main/django/utils/dateparse.py at -9718fa2e8abe430c3526a9278dd976443d4ae3c6 - -Changed to: -* use standard python datetime types not django.utils.timezone -* raise ValueError when regex doesn't match rather than returning None -* support parsing unix timestamps for dates and datetimes -""" -import re -from datetime import date, datetime, time, timedelta, timezone -from typing import Dict, Optional, Type, Union - -from . import errors - -date_expr = r'(?P\d{4})-(?P\d{1,2})-(?P\d{1,2})' -time_expr = ( - r'(?P\d{1,2}):(?P\d{1,2})' - r'(?::(?P\d{1,2})(?:\.(?P\d{1,6})\d{0,6})?)?' - r'(?PZ|[+-]\d{2}(?::?\d{2})?)?$' -) - -date_re = re.compile(f'{date_expr}$') -time_re = re.compile(time_expr) -datetime_re = re.compile(f'{date_expr}[T ]{time_expr}') - -standard_duration_re = re.compile( - r'^' - r'(?:(?P-?\d+) (days?, )?)?' - r'((?:(?P-?\d+):)(?=\d+:\d+))?' - r'(?:(?P-?\d+):)?' - r'(?P-?\d+)' - r'(?:\.(?P\d{1,6})\d{0,6})?' - r'$' -) - -# Support the sections of ISO 8601 date representation that are accepted by timedelta -iso8601_duration_re = re.compile( - r'^(?P[-+]?)' - r'P' - r'(?:(?P\d+(.\d+)?)D)?' - r'(?:T' - r'(?:(?P\d+(.\d+)?)H)?' - r'(?:(?P\d+(.\d+)?)M)?' - r'(?:(?P\d+(.\d+)?)S)?' - r')?' - r'$' -) - -EPOCH = datetime(1970, 1, 1) -# if greater than this, the number is in ms, if less than or equal it's in seconds -# (in seconds this is 11th October 2603, in ms it's 20th August 1970) -MS_WATERSHED = int(2e10) -# slightly more than datetime.max in ns - (datetime.max - EPOCH).total_seconds() * 1e9 -MAX_NUMBER = int(3e20) -StrBytesIntFloat = Union[str, bytes, int, float] - - -def get_numeric(value: StrBytesIntFloat, native_expected_type: str) -> Union[None, int, float]: - if isinstance(value, (int, float)): - return value - try: - return float(value) - except ValueError: - return None - except TypeError: - raise TypeError(f'invalid type; expected {native_expected_type}, string, bytes, int or float') - - -def from_unix_seconds(seconds: Union[int, float]) -> datetime: - if seconds > MAX_NUMBER: - return datetime.max - elif seconds < -MAX_NUMBER: - return datetime.min - - while abs(seconds) > MS_WATERSHED: - seconds /= 1000 - dt = EPOCH + timedelta(seconds=seconds) - return dt.replace(tzinfo=timezone.utc) - - -def _parse_timezone(value: Optional[str], error: Type[Exception]) -> Union[None, int, timezone]: - if value == 'Z': - return timezone.utc - elif value is not None: - offset_mins = int(value[-2:]) if len(value) > 3 else 0 - offset = 60 * int(value[1:3]) + offset_mins - if value[0] == '-': - offset = -offset - try: - return timezone(timedelta(minutes=offset)) - except ValueError: - raise error() - else: - return None - - -def parse_date(value: Union[date, StrBytesIntFloat]) -> date: - """ - Parse a date/int/float/string and return a datetime.date. - - Raise ValueError if the input is well formatted but not a valid date. - Raise ValueError if the input isn't well formatted. - """ - if isinstance(value, date): - if isinstance(value, datetime): - return value.date() - else: - return value - - number = get_numeric(value, 'date') - if number is not None: - return from_unix_seconds(number).date() - - if isinstance(value, bytes): - value = value.decode() - - match = date_re.match(value) # type: ignore - if match is None: - raise errors.DateError() - - kw = {k: int(v) for k, v in match.groupdict().items()} - - try: - return date(**kw) - except ValueError: - raise errors.DateError() - - -def parse_time(value: Union[time, StrBytesIntFloat]) -> time: - """ - Parse a time/string and return a datetime.time. - - Raise ValueError if the input is well formatted but not a valid time. - Raise ValueError if the input isn't well formatted, in particular if it contains an offset. - """ - if isinstance(value, time): - return value - - number = get_numeric(value, 'time') - if number is not None: - if number >= 86400: - # doesn't make sense since the time time loop back around to 0 - raise errors.TimeError() - return (datetime.min + timedelta(seconds=number)).time() - - if isinstance(value, bytes): - value = value.decode() - - match = time_re.match(value) # type: ignore - if match is None: - raise errors.TimeError() - - kw = match.groupdict() - if kw['microsecond']: - kw['microsecond'] = kw['microsecond'].ljust(6, '0') - - tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.TimeError) - kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None} - kw_['tzinfo'] = tzinfo - - try: - return time(**kw_) # type: ignore - except ValueError: - raise errors.TimeError() - - -def parse_datetime(value: Union[datetime, StrBytesIntFloat]) -> datetime: - """ - Parse a datetime/int/float/string and return a datetime.datetime. - - This function supports time zone offsets. When the input contains one, - the output uses a timezone with a fixed offset from UTC. - - Raise ValueError if the input is well formatted but not a valid datetime. - Raise ValueError if the input isn't well formatted. - """ - if isinstance(value, datetime): - return value - - number = get_numeric(value, 'datetime') - if number is not None: - return from_unix_seconds(number) - - if isinstance(value, bytes): - value = value.decode() - - match = datetime_re.match(value) # type: ignore - if match is None: - raise errors.DateTimeError() - - kw = match.groupdict() - if kw['microsecond']: - kw['microsecond'] = kw['microsecond'].ljust(6, '0') - - tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.DateTimeError) - kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None} - kw_['tzinfo'] = tzinfo - - try: - return datetime(**kw_) # type: ignore - except ValueError: - raise errors.DateTimeError() - - -def parse_duration(value: StrBytesIntFloat) -> timedelta: - """ - Parse a duration int/float/string and return a datetime.timedelta. - - The preferred format for durations in Django is '%d %H:%M:%S.%f'. - - Also supports ISO 8601 representation. - """ - if isinstance(value, timedelta): - return value - - if isinstance(value, (int, float)): - # below code requires a string - value = f'{value:f}' - elif isinstance(value, bytes): - value = value.decode() - - try: - match = standard_duration_re.match(value) or iso8601_duration_re.match(value) - except TypeError: - raise TypeError('invalid type; expected timedelta, string, bytes, int or float') - - if not match: - raise errors.DurationError() - - kw = match.groupdict() - sign = -1 if kw.pop('sign', '+') == '-' else 1 - if kw.get('microseconds'): - kw['microseconds'] = kw['microseconds'].ljust(6, '0') - - if kw.get('seconds') and kw.get('microseconds') and kw['seconds'].startswith('-'): - kw['microseconds'] = '-' + kw['microseconds'] - - kw_ = {k: float(v) for k, v in kw.items() if v is not None} - - return sign * timedelta(**kw_) +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/decorator.py b/lib/pydantic/decorator.py index 089aab65..c3643468 100644 --- a/lib/pydantic/decorator.py +++ b/lib/pydantic/decorator.py @@ -1,264 +1,4 @@ -from functools import wraps -from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload +"""The `decorator` module is a backport module from V1.""" +from ._migration import getattr_migration -from . import validator -from .config import Extra -from .errors import ConfigError -from .main import BaseModel, create_model -from .typing import get_all_type_hints -from .utils import to_camel - -__all__ = ('validate_arguments',) - -if TYPE_CHECKING: - from .typing import AnyCallable - - AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable) - ConfigType = Union[None, Type[Any], Dict[str, Any]] - - -@overload -def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']: - ... - - -@overload -def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT': - ... - - -def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any: - """ - Decorator to validate the arguments passed to a function. - """ - - def validate(_func: 'AnyCallable') -> 'AnyCallable': - vd = ValidatedFunction(_func, config) - - @wraps(_func) - def wrapper_function(*args: Any, **kwargs: Any) -> Any: - return vd.call(*args, **kwargs) - - wrapper_function.vd = vd # type: ignore - wrapper_function.validate = vd.init_model_instance # type: ignore - wrapper_function.raw_function = vd.raw_function # type: ignore - wrapper_function.model = vd.model # type: ignore - return wrapper_function - - if func: - return validate(func) - else: - return validate - - -ALT_V_ARGS = 'v__args' -ALT_V_KWARGS = 'v__kwargs' -V_POSITIONAL_ONLY_NAME = 'v__positional_only' -V_DUPLICATE_KWARGS = 'v__duplicate_kwargs' - - -class ValidatedFunction: - def __init__(self, function: 'AnyCallableT', config: 'ConfigType'): # noqa C901 - from inspect import Parameter, signature - - parameters: Mapping[str, Parameter] = signature(function).parameters - - if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}: - raise ConfigError( - f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" ' - f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator' - ) - - self.raw_function = function - self.arg_mapping: Dict[int, str] = {} - self.positional_only_args = set() - self.v_args_name = 'args' - self.v_kwargs_name = 'kwargs' - - type_hints = get_all_type_hints(function) - takes_args = False - takes_kwargs = False - fields: Dict[str, Tuple[Any, Any]] = {} - for i, (name, p) in enumerate(parameters.items()): - if p.annotation is p.empty: - annotation = Any - else: - annotation = type_hints[name] - - default = ... if p.default is p.empty else p.default - if p.kind == Parameter.POSITIONAL_ONLY: - self.arg_mapping[i] = name - fields[name] = annotation, default - fields[V_POSITIONAL_ONLY_NAME] = List[str], None - self.positional_only_args.add(name) - elif p.kind == Parameter.POSITIONAL_OR_KEYWORD: - self.arg_mapping[i] = name - fields[name] = annotation, default - fields[V_DUPLICATE_KWARGS] = List[str], None - elif p.kind == Parameter.KEYWORD_ONLY: - fields[name] = annotation, default - elif p.kind == Parameter.VAR_POSITIONAL: - self.v_args_name = name - fields[name] = Tuple[annotation, ...], None - takes_args = True - else: - assert p.kind == Parameter.VAR_KEYWORD, p.kind - self.v_kwargs_name = name - fields[name] = Dict[str, annotation], None # type: ignore - takes_kwargs = True - - # these checks avoid a clash between "args" and a field with that name - if not takes_args and self.v_args_name in fields: - self.v_args_name = ALT_V_ARGS - - # same with "kwargs" - if not takes_kwargs and self.v_kwargs_name in fields: - self.v_kwargs_name = ALT_V_KWARGS - - if not takes_args: - # we add the field so validation below can raise the correct exception - fields[self.v_args_name] = List[Any], None - - if not takes_kwargs: - # same with kwargs - fields[self.v_kwargs_name] = Dict[Any, Any], None - - self.create_model(fields, takes_args, takes_kwargs, config) - - def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel: - values = self.build_values(args, kwargs) - return self.model(**values) - - def call(self, *args: Any, **kwargs: Any) -> Any: - m = self.init_model_instance(*args, **kwargs) - return self.execute(m) - - def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]: - values: Dict[str, Any] = {} - if args: - arg_iter = enumerate(args) - while True: - try: - i, a = next(arg_iter) - except StopIteration: - break - arg_name = self.arg_mapping.get(i) - if arg_name is not None: - values[arg_name] = a - else: - values[self.v_args_name] = [a] + [a for _, a in arg_iter] - break - - var_kwargs: Dict[str, Any] = {} - wrong_positional_args = [] - duplicate_kwargs = [] - fields_alias = [ - field.alias - for name, field in self.model.__fields__.items() - if name not in (self.v_args_name, self.v_kwargs_name) - ] - non_var_fields = set(self.model.__fields__) - {self.v_args_name, self.v_kwargs_name} - for k, v in kwargs.items(): - if k in non_var_fields or k in fields_alias: - if k in self.positional_only_args: - wrong_positional_args.append(k) - if k in values: - duplicate_kwargs.append(k) - values[k] = v - else: - var_kwargs[k] = v - - if var_kwargs: - values[self.v_kwargs_name] = var_kwargs - if wrong_positional_args: - values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args - if duplicate_kwargs: - values[V_DUPLICATE_KWARGS] = duplicate_kwargs - return values - - def execute(self, m: BaseModel) -> Any: - d = {k: v for k, v in m._iter() if k in m.__fields_set__ or m.__fields__[k].default_factory} - var_kwargs = d.pop(self.v_kwargs_name, {}) - - if self.v_args_name in d: - args_: List[Any] = [] - in_kwargs = False - kwargs = {} - for name, value in d.items(): - if in_kwargs: - kwargs[name] = value - elif name == self.v_args_name: - args_ += value - in_kwargs = True - else: - args_.append(value) - return self.raw_function(*args_, **kwargs, **var_kwargs) - elif self.positional_only_args: - args_ = [] - kwargs = {} - for name, value in d.items(): - if name in self.positional_only_args: - args_.append(value) - else: - kwargs[name] = value - return self.raw_function(*args_, **kwargs, **var_kwargs) - else: - return self.raw_function(**d, **var_kwargs) - - def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None: - pos_args = len(self.arg_mapping) - - class CustomConfig: - pass - - if not TYPE_CHECKING: # pragma: no branch - if isinstance(config, dict): - CustomConfig = type('Config', (), config) # noqa: F811 - elif config is not None: - CustomConfig = config # noqa: F811 - - if hasattr(CustomConfig, 'fields') or hasattr(CustomConfig, 'alias_generator'): - raise ConfigError( - 'Setting the "fields" and "alias_generator" property on custom Config for ' - '@validate_arguments is not yet supported, please remove.' - ) - - class DecoratorBaseModel(BaseModel): - @validator(self.v_args_name, check_fields=False, allow_reuse=True) - def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]: - if takes_args or v is None: - return v - - raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given') - - @validator(self.v_kwargs_name, check_fields=False, allow_reuse=True) - def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]: - if takes_kwargs or v is None: - return v - - plural = '' if len(v) == 1 else 's' - keys = ', '.join(map(repr, v.keys())) - raise TypeError(f'unexpected keyword argument{plural}: {keys}') - - @validator(V_POSITIONAL_ONLY_NAME, check_fields=False, allow_reuse=True) - def check_positional_only(cls, v: Optional[List[str]]) -> None: - if v is None: - return - - plural = '' if len(v) == 1 else 's' - keys = ', '.join(map(repr, v)) - raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}') - - @validator(V_DUPLICATE_KWARGS, check_fields=False, allow_reuse=True) - def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None: - if v is None: - return - - plural = '' if len(v) == 1 else 's' - keys = ', '.join(map(repr, v)) - raise TypeError(f'multiple values for argument{plural}: {keys}') - - class Config(CustomConfig): - extra = getattr(CustomConfig, 'extra', Extra.forbid) - - self.model = create_model(to_camel(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields) +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/deprecated/__init__.py b/lib/pydantic/deprecated/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/pydantic/deprecated/class_validators.py b/lib/pydantic/deprecated/class_validators.py new file mode 100644 index 00000000..7b48afd2 --- /dev/null +++ b/lib/pydantic/deprecated/class_validators.py @@ -0,0 +1,253 @@ +"""Old `@validator` and `@root_validator` function validators from V1.""" + +from __future__ import annotations as _annotations + +from functools import partial, partialmethod +from types import FunctionType +from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, overload +from warnings import warn + +from typing_extensions import Literal, Protocol, TypeAlias + +from .._internal import _decorators, _decorators_v1 +from ..errors import PydanticUserError +from ..warnings import PydanticDeprecatedSince20 + +_ALLOW_REUSE_WARNING_MESSAGE = '`allow_reuse` is deprecated and will be ignored; it should no longer be necessary' + + +if TYPE_CHECKING: + + class _OnlyValueValidatorClsMethod(Protocol): + def __call__(self, __cls: Any, __value: Any) -> Any: + ... + + class _V1ValidatorWithValuesClsMethod(Protocol): + def __call__(self, __cls: Any, __value: Any, values: dict[str, Any]) -> Any: + ... + + class _V1ValidatorWithValuesKwOnlyClsMethod(Protocol): + def __call__(self, __cls: Any, __value: Any, *, values: dict[str, Any]) -> Any: + ... + + class _V1ValidatorWithKwargsClsMethod(Protocol): + def __call__(self, __cls: Any, **kwargs: Any) -> Any: + ... + + class _V1ValidatorWithValuesAndKwargsClsMethod(Protocol): + def __call__(self, __cls: Any, values: dict[str, Any], **kwargs: Any) -> Any: + ... + + class _V1RootValidatorClsMethod(Protocol): + def __call__( + self, __cls: Any, __values: _decorators_v1.RootValidatorValues + ) -> _decorators_v1.RootValidatorValues: + ... + + V1Validator = Union[ + _OnlyValueValidatorClsMethod, + _V1ValidatorWithValuesClsMethod, + _V1ValidatorWithValuesKwOnlyClsMethod, + _V1ValidatorWithKwargsClsMethod, + _V1ValidatorWithValuesAndKwargsClsMethod, + _decorators_v1.V1ValidatorWithValues, + _decorators_v1.V1ValidatorWithValuesKwOnly, + _decorators_v1.V1ValidatorWithKwargs, + _decorators_v1.V1ValidatorWithValuesAndKwargs, + ] + + V1RootValidator = Union[ + _V1RootValidatorClsMethod, + _decorators_v1.V1RootValidatorFunction, + ] + + _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]] + + # Allow both a V1 (assumed pre=False) or V2 (assumed mode='after') validator + # We lie to type checkers and say we return the same thing we get + # but in reality we return a proxy object that _mostly_ behaves like the wrapped thing + _V1ValidatorType = TypeVar('_V1ValidatorType', V1Validator, _PartialClsOrStaticMethod) + _V1RootValidatorFunctionType = TypeVar( + '_V1RootValidatorFunctionType', + _decorators_v1.V1RootValidatorFunction, + _V1RootValidatorClsMethod, + _PartialClsOrStaticMethod, + ) +else: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + + +def validator( + __field: str, + *fields: str, + pre: bool = False, + each_item: bool = False, + always: bool = False, + check_fields: bool | None = None, + allow_reuse: bool = False, +) -> Callable[[_V1ValidatorType], _V1ValidatorType]: + """Decorate methods on the class indicating that they should be used to validate fields. + + Args: + __field (str): The first field the validator should be called on; this is separate + from `fields` to ensure an error is raised if you don't pass at least one. + *fields (str): Additional field(s) the validator should be called on. + pre (bool, optional): Whether this validator should be called before the standard + validators (else after). Defaults to False. + each_item (bool, optional): For complex objects (sets, lists etc.) whether to validate + individual elements rather than the whole object. Defaults to False. + always (bool, optional): Whether this method and other validators should be called even if + the value is missing. Defaults to False. + check_fields (bool | None, optional): Whether to check that the fields actually exist on the model. + Defaults to None. + allow_reuse (bool, optional): Whether to track and raise an error if another validator refers to + the decorated function. Defaults to False. + + Returns: + Callable: A decorator that can be used to decorate a + function to be used as a validator. + """ + if allow_reuse is True: # pragma: no cover + warn(_ALLOW_REUSE_WARNING_MESSAGE, DeprecationWarning) + fields = tuple((__field, *fields)) + if isinstance(fields[0], FunctionType): + raise PydanticUserError( + '`@validator` should be used with fields and keyword arguments, not bare. ' + "E.g. usage should be `@validator('', ...)`", + code='validator-no-fields', + ) + elif not all(isinstance(field, str) for field in fields): + raise PydanticUserError( + '`@validator` fields should be passed as separate string args. ' + "E.g. usage should be `@validator('', '', ...)`", + code='validator-invalid-fields', + ) + + warn( + 'Pydantic V1 style `@validator` validators are deprecated.' + ' You should migrate to Pydantic V2 style `@field_validator` validators,' + ' see the migration guide for more details', + DeprecationWarning, + stacklevel=2, + ) + + mode: Literal['before', 'after'] = 'before' if pre is True else 'after' + + def dec(f: Any) -> _decorators.PydanticDescriptorProxy[Any]: + if _decorators.is_instance_method_from_sig(f): + raise PydanticUserError( + '`@validator` cannot be applied to instance methods', code='validator-instance-method' + ) + # auto apply the @classmethod decorator + f = _decorators.ensure_classmethod_based_on_signature(f) + wrap = _decorators_v1.make_generic_v1_field_validator + validator_wrapper_info = _decorators.ValidatorDecoratorInfo( + fields=fields, + mode=mode, + each_item=each_item, + always=always, + check_fields=check_fields, + ) + return _decorators.PydanticDescriptorProxy(f, validator_wrapper_info, shim=wrap) + + return dec # type: ignore[return-value] + + +@overload +def root_validator( + *, + # if you don't specify `pre` the default is `pre=False` + # which means you need to specify `skip_on_failure=True` + skip_on_failure: Literal[True], + allow_reuse: bool = ..., +) -> Callable[ + [_V1RootValidatorFunctionType], + _V1RootValidatorFunctionType, +]: + ... + + +@overload +def root_validator( + *, + # if you specify `pre=True` then you don't need to specify + # `skip_on_failure`, in fact it is not allowed as an argument! + pre: Literal[True], + allow_reuse: bool = ..., +) -> Callable[ + [_V1RootValidatorFunctionType], + _V1RootValidatorFunctionType, +]: + ... + + +@overload +def root_validator( + *, + # if you explicitly specify `pre=False` then you + # MUST specify `skip_on_failure=True` + pre: Literal[False], + skip_on_failure: Literal[True], + allow_reuse: bool = ..., +) -> Callable[ + [_V1RootValidatorFunctionType], + _V1RootValidatorFunctionType, +]: + ... + + +def root_validator( + *__args, + pre: bool = False, + skip_on_failure: bool = False, + allow_reuse: bool = False, +) -> Any: + """Decorate methods on a model indicating that they should be used to validate (and perhaps + modify) data either before or after standard model parsing/validation is performed. + + Args: + pre (bool, optional): Whether this validator should be called before the standard + validators (else after). Defaults to False. + skip_on_failure (bool, optional): Whether to stop validation and return as soon as a + failure is encountered. Defaults to False. + allow_reuse (bool, optional): Whether to track and raise an error if another validator + refers to the decorated function. Defaults to False. + + Returns: + Any: A decorator that can be used to decorate a function to be used as a root_validator. + """ + warn( + 'Pydantic V1 style `@root_validator` validators are deprecated.' + ' You should migrate to Pydantic V2 style `@model_validator` validators,' + ' see the migration guide for more details', + DeprecationWarning, + stacklevel=2, + ) + + if __args: + # Ensure a nice error is raised if someone attempts to use the bare decorator + return root_validator()(*__args) # type: ignore + + if allow_reuse is True: # pragma: no cover + warn(_ALLOW_REUSE_WARNING_MESSAGE, DeprecationWarning) + mode: Literal['before', 'after'] = 'before' if pre is True else 'after' + if pre is False and skip_on_failure is not True: + raise PydanticUserError( + 'If you use `@root_validator` with pre=False (the default) you MUST specify `skip_on_failure=True`.' + ' Note that `@root_validator` is deprecated and should be replaced with `@model_validator`.', + code='root-validator-pre-skip', + ) + + wrap = partial(_decorators_v1.make_v1_generic_root_validator, pre=pre) + + def dec(f: Callable[..., Any] | classmethod[Any, Any, Any] | staticmethod[Any, Any]) -> Any: + if _decorators.is_instance_method_from_sig(f): + raise TypeError('`@root_validator` cannot be applied to instance methods') + # auto apply the @classmethod decorator + res = _decorators.ensure_classmethod_based_on_signature(f) + dec_info = _decorators.RootValidatorDecoratorInfo(mode=mode) + return _decorators.PydanticDescriptorProxy(res, dec_info, shim=wrap) + + return dec diff --git a/lib/pydantic/deprecated/config.py b/lib/pydantic/deprecated/config.py new file mode 100644 index 00000000..45400c65 --- /dev/null +++ b/lib/pydantic/deprecated/config.py @@ -0,0 +1,72 @@ +from __future__ import annotations as _annotations + +import warnings +from typing import TYPE_CHECKING, Any + +from typing_extensions import Literal, deprecated + +from .._internal import _config +from ..warnings import PydanticDeprecatedSince20 + +if not TYPE_CHECKING: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + +__all__ = 'BaseConfig', 'Extra' + + +class _ConfigMetaclass(type): + def __getattr__(self, item: str) -> Any: + try: + obj = _config.config_defaults[item] + warnings.warn(_config.DEPRECATION_MESSAGE, DeprecationWarning) + return obj + except KeyError as exc: + raise AttributeError(f"type object '{self.__name__}' has no attribute {exc}") from exc + + +@deprecated('BaseConfig is deprecated. Use the `pydantic.ConfigDict` instead.', category=PydanticDeprecatedSince20) +class BaseConfig(metaclass=_ConfigMetaclass): + """This class is only retained for backwards compatibility. + + !!! Warning "Deprecated" + BaseConfig is deprecated. Use the [`pydantic.ConfigDict`][pydantic.ConfigDict] instead. + """ + + def __getattr__(self, item: str) -> Any: + try: + obj = super().__getattribute__(item) + warnings.warn(_config.DEPRECATION_MESSAGE, DeprecationWarning) + return obj + except AttributeError as exc: + try: + return getattr(type(self), item) + except AttributeError: + # re-raising changes the displayed text to reflect that `self` is not a type + raise AttributeError(str(exc)) from exc + + def __init_subclass__(cls, **kwargs: Any) -> None: + warnings.warn(_config.DEPRECATION_MESSAGE, DeprecationWarning) + return super().__init_subclass__(**kwargs) + + +class _ExtraMeta(type): + def __getattribute__(self, __name: str) -> Any: + # The @deprecated decorator accesses other attributes, so we only emit a warning for the expected ones + if __name in {'allow', 'ignore', 'forbid'}: + warnings.warn( + "`pydantic.config.Extra` is deprecated, use literal values instead (e.g. `extra='allow'`)", + DeprecationWarning, + stacklevel=2, + ) + return super().__getattribute__(__name) + + +@deprecated( + "Extra is deprecated. Use literal values instead (e.g. `extra='allow'`)", category=PydanticDeprecatedSince20 +) +class Extra(metaclass=_ExtraMeta): + allow: Literal['allow'] = 'allow' + ignore: Literal['ignore'] = 'ignore' + forbid: Literal['forbid'] = 'forbid' diff --git a/lib/pydantic/deprecated/copy_internals.py b/lib/pydantic/deprecated/copy_internals.py new file mode 100644 index 00000000..efe5de28 --- /dev/null +++ b/lib/pydantic/deprecated/copy_internals.py @@ -0,0 +1,224 @@ +from __future__ import annotations as _annotations + +import typing +from copy import deepcopy +from enum import Enum +from typing import Any, Tuple + +import typing_extensions + +from .._internal import ( + _model_construction, + _typing_extra, + _utils, +) + +if typing.TYPE_CHECKING: + from .. import BaseModel + from .._internal._utils import AbstractSetIntStr, MappingIntStrAny + + AnyClassMethod = classmethod[Any, Any, Any] + TupleGenerator = typing.Generator[Tuple[str, Any], None, None] + Model = typing.TypeVar('Model', bound='BaseModel') + # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope + IncEx: typing_extensions.TypeAlias = 'set[int] | set[str] | dict[int, Any] | dict[str, Any] | None' + +_object_setattr = _model_construction.object_setattr + + +def _iter( + self: BaseModel, + to_dict: bool = False, + by_alias: bool = False, + include: AbstractSetIntStr | MappingIntStrAny | None = None, + exclude: AbstractSetIntStr | MappingIntStrAny | None = None, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, +) -> TupleGenerator: + # Merge field set excludes with explicit exclude parameter with explicit overriding field set options. + # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case. + if exclude is not None: + exclude = _utils.ValueItems.merge( + {k: v.exclude for k, v in self.model_fields.items() if v.exclude is not None}, exclude + ) + + if include is not None: + include = _utils.ValueItems.merge({k: True for k in self.model_fields}, include, intersect=True) + + allowed_keys = _calculate_keys(self, include=include, exclude=exclude, exclude_unset=exclude_unset) # type: ignore + if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none): + # huge boost for plain _iter() + yield from self.__dict__.items() + if self.__pydantic_extra__: + yield from self.__pydantic_extra__.items() + return + + value_exclude = _utils.ValueItems(self, exclude) if exclude is not None else None + value_include = _utils.ValueItems(self, include) if include is not None else None + + if self.__pydantic_extra__ is None: + items = self.__dict__.items() + else: + items = list(self.__dict__.items()) + list(self.__pydantic_extra__.items()) + + for field_key, v in items: + if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None): + continue + + if exclude_defaults: + try: + field = self.model_fields[field_key] + except KeyError: + pass + else: + if not field.is_required() and field.default == v: + continue + + if by_alias and field_key in self.model_fields: + dict_key = self.model_fields[field_key].alias or field_key + else: + dict_key = field_key + + if to_dict or value_include or value_exclude: + v = _get_value( + type(self), + v, + to_dict=to_dict, + by_alias=by_alias, + include=value_include and value_include.for_element(field_key), + exclude=value_exclude and value_exclude.for_element(field_key), + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + yield dict_key, v + + +def _copy_and_set_values( + self: Model, + values: dict[str, Any], + fields_set: set[str], + extra: dict[str, Any] | None = None, + private: dict[str, Any] | None = None, + *, + deep: bool, # UP006 +) -> Model: + if deep: + # chances of having empty dict here are quite low for using smart_deepcopy + values = deepcopy(values) + extra = deepcopy(extra) + private = deepcopy(private) + + cls = self.__class__ + m = cls.__new__(cls) + _object_setattr(m, '__dict__', values) + _object_setattr(m, '__pydantic_extra__', extra) + _object_setattr(m, '__pydantic_fields_set__', fields_set) + _object_setattr(m, '__pydantic_private__', private) + + return m + + +@typing.no_type_check +def _get_value( + cls: type[BaseModel], + v: Any, + to_dict: bool, + by_alias: bool, + include: AbstractSetIntStr | MappingIntStrAny | None, + exclude: AbstractSetIntStr | MappingIntStrAny | None, + exclude_unset: bool, + exclude_defaults: bool, + exclude_none: bool, +) -> Any: + from .. import BaseModel + + if isinstance(v, BaseModel): + if to_dict: + return v.model_dump( + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + include=include, # type: ignore + exclude=exclude, # type: ignore + exclude_none=exclude_none, + ) + else: + return v.copy(include=include, exclude=exclude) + + value_exclude = _utils.ValueItems(v, exclude) if exclude else None + value_include = _utils.ValueItems(v, include) if include else None + + if isinstance(v, dict): + return { + k_: _get_value( + cls, + v_, + to_dict=to_dict, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + include=value_include and value_include.for_element(k_), + exclude=value_exclude and value_exclude.for_element(k_), + exclude_none=exclude_none, + ) + for k_, v_ in v.items() + if (not value_exclude or not value_exclude.is_excluded(k_)) + and (not value_include or value_include.is_included(k_)) + } + + elif _utils.sequence_like(v): + seq_args = ( + _get_value( + cls, + v_, + to_dict=to_dict, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + include=value_include and value_include.for_element(i), + exclude=value_exclude and value_exclude.for_element(i), + exclude_none=exclude_none, + ) + for i, v_ in enumerate(v) + if (not value_exclude or not value_exclude.is_excluded(i)) + and (not value_include or value_include.is_included(i)) + ) + + return v.__class__(*seq_args) if _typing_extra.is_namedtuple(v.__class__) else v.__class__(seq_args) + + elif isinstance(v, Enum) and getattr(cls.model_config, 'use_enum_values', False): + return v.value + + else: + return v + + +def _calculate_keys( + self: BaseModel, + include: MappingIntStrAny | None, + exclude: MappingIntStrAny | None, + exclude_unset: bool, + update: typing.Dict[str, Any] | None = None, # noqa UP006 +) -> typing.AbstractSet[str] | None: + if include is None and exclude is None and exclude_unset is False: + return None + + keys: typing.AbstractSet[str] + if exclude_unset: + keys = self.__pydantic_fields_set__.copy() + else: + keys = set(self.__dict__.keys()) + keys = keys | (self.__pydantic_extra__ or {}).keys() + + if include is not None: + keys &= include.keys() + + if update: + keys -= update.keys() + + if exclude: + keys -= {k for k, v in exclude.items() if _utils.ValueItems.is_true(v)} + + return keys diff --git a/lib/pydantic/deprecated/decorator.py b/lib/pydantic/deprecated/decorator.py new file mode 100644 index 00000000..36bd0690 --- /dev/null +++ b/lib/pydantic/deprecated/decorator.py @@ -0,0 +1,279 @@ +import warnings +from functools import wraps +from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload + +from typing_extensions import deprecated + +from .._internal import _config, _typing_extra +from ..alias_generators import to_pascal +from ..errors import PydanticUserError +from ..functional_validators import field_validator +from ..main import BaseModel, create_model +from ..warnings import PydanticDeprecatedSince20 + +if not TYPE_CHECKING: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + +__all__ = ('validate_arguments',) + +if TYPE_CHECKING: + AnyCallable = Callable[..., Any] + + AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable) + ConfigType = Union[None, Type[Any], Dict[str, Any]] + + +@overload +def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']: + ... + + +@overload +def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT': + ... + + +@deprecated( + 'The `validate_arguments` method is deprecated; use `validate_call` instead.', + category=None, +) +def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any: + """Decorator to validate the arguments passed to a function.""" + warnings.warn( + 'The `validate_arguments` method is deprecated; use `validate_call` instead.', + PydanticDeprecatedSince20, + stacklevel=2, + ) + + def validate(_func: 'AnyCallable') -> 'AnyCallable': + vd = ValidatedFunction(_func, config) + + @wraps(_func) + def wrapper_function(*args: Any, **kwargs: Any) -> Any: + return vd.call(*args, **kwargs) + + wrapper_function.vd = vd # type: ignore + wrapper_function.validate = vd.init_model_instance # type: ignore + wrapper_function.raw_function = vd.raw_function # type: ignore + wrapper_function.model = vd.model # type: ignore + return wrapper_function + + if func: + return validate(func) + else: + return validate + + +ALT_V_ARGS = 'v__args' +ALT_V_KWARGS = 'v__kwargs' +V_POSITIONAL_ONLY_NAME = 'v__positional_only' +V_DUPLICATE_KWARGS = 'v__duplicate_kwargs' + + +class ValidatedFunction: + def __init__(self, function: 'AnyCallable', config: 'ConfigType'): + from inspect import Parameter, signature + + parameters: Mapping[str, Parameter] = signature(function).parameters + + if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}: + raise PydanticUserError( + f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" ' + f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator', + code=None, + ) + + self.raw_function = function + self.arg_mapping: Dict[int, str] = {} + self.positional_only_args: set[str] = set() + self.v_args_name = 'args' + self.v_kwargs_name = 'kwargs' + + type_hints = _typing_extra.get_type_hints(function, include_extras=True) + takes_args = False + takes_kwargs = False + fields: Dict[str, Tuple[Any, Any]] = {} + for i, (name, p) in enumerate(parameters.items()): + if p.annotation is p.empty: + annotation = Any + else: + annotation = type_hints[name] + + default = ... if p.default is p.empty else p.default + if p.kind == Parameter.POSITIONAL_ONLY: + self.arg_mapping[i] = name + fields[name] = annotation, default + fields[V_POSITIONAL_ONLY_NAME] = List[str], None + self.positional_only_args.add(name) + elif p.kind == Parameter.POSITIONAL_OR_KEYWORD: + self.arg_mapping[i] = name + fields[name] = annotation, default + fields[V_DUPLICATE_KWARGS] = List[str], None + elif p.kind == Parameter.KEYWORD_ONLY: + fields[name] = annotation, default + elif p.kind == Parameter.VAR_POSITIONAL: + self.v_args_name = name + fields[name] = Tuple[annotation, ...], None + takes_args = True + else: + assert p.kind == Parameter.VAR_KEYWORD, p.kind + self.v_kwargs_name = name + fields[name] = Dict[str, annotation], None + takes_kwargs = True + + # these checks avoid a clash between "args" and a field with that name + if not takes_args and self.v_args_name in fields: + self.v_args_name = ALT_V_ARGS + + # same with "kwargs" + if not takes_kwargs and self.v_kwargs_name in fields: + self.v_kwargs_name = ALT_V_KWARGS + + if not takes_args: + # we add the field so validation below can raise the correct exception + fields[self.v_args_name] = List[Any], None + + if not takes_kwargs: + # same with kwargs + fields[self.v_kwargs_name] = Dict[Any, Any], None + + self.create_model(fields, takes_args, takes_kwargs, config) + + def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel: + values = self.build_values(args, kwargs) + return self.model(**values) + + def call(self, *args: Any, **kwargs: Any) -> Any: + m = self.init_model_instance(*args, **kwargs) + return self.execute(m) + + def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]: + values: Dict[str, Any] = {} + if args: + arg_iter = enumerate(args) + while True: + try: + i, a = next(arg_iter) + except StopIteration: + break + arg_name = self.arg_mapping.get(i) + if arg_name is not None: + values[arg_name] = a + else: + values[self.v_args_name] = [a] + [a for _, a in arg_iter] + break + + var_kwargs: Dict[str, Any] = {} + wrong_positional_args = [] + duplicate_kwargs = [] + fields_alias = [ + field.alias + for name, field in self.model.model_fields.items() + if name not in (self.v_args_name, self.v_kwargs_name) + ] + non_var_fields = set(self.model.model_fields) - {self.v_args_name, self.v_kwargs_name} + for k, v in kwargs.items(): + if k in non_var_fields or k in fields_alias: + if k in self.positional_only_args: + wrong_positional_args.append(k) + if k in values: + duplicate_kwargs.append(k) + values[k] = v + else: + var_kwargs[k] = v + + if var_kwargs: + values[self.v_kwargs_name] = var_kwargs + if wrong_positional_args: + values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args + if duplicate_kwargs: + values[V_DUPLICATE_KWARGS] = duplicate_kwargs + return values + + def execute(self, m: BaseModel) -> Any: + d = {k: v for k, v in m.__dict__.items() if k in m.__pydantic_fields_set__ or m.model_fields[k].default_factory} + var_kwargs = d.pop(self.v_kwargs_name, {}) + + if self.v_args_name in d: + args_: List[Any] = [] + in_kwargs = False + kwargs = {} + for name, value in d.items(): + if in_kwargs: + kwargs[name] = value + elif name == self.v_args_name: + args_ += value + in_kwargs = True + else: + args_.append(value) + return self.raw_function(*args_, **kwargs, **var_kwargs) + elif self.positional_only_args: + args_ = [] + kwargs = {} + for name, value in d.items(): + if name in self.positional_only_args: + args_.append(value) + else: + kwargs[name] = value + return self.raw_function(*args_, **kwargs, **var_kwargs) + else: + return self.raw_function(**d, **var_kwargs) + + def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None: + pos_args = len(self.arg_mapping) + + config_wrapper = _config.ConfigWrapper(config) + + if config_wrapper.alias_generator: + raise PydanticUserError( + 'Setting the "alias_generator" property on custom Config for ' + '@validate_arguments is not yet supported, please remove.', + code=None, + ) + if config_wrapper.extra is None: + config_wrapper.config_dict['extra'] = 'forbid' + + class DecoratorBaseModel(BaseModel): + @field_validator(self.v_args_name, check_fields=False) + @classmethod + def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]: + if takes_args or v is None: + return v + + raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given') + + @field_validator(self.v_kwargs_name, check_fields=False) + @classmethod + def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]: + if takes_kwargs or v is None: + return v + + plural = '' if len(v) == 1 else 's' + keys = ', '.join(map(repr, v.keys())) + raise TypeError(f'unexpected keyword argument{plural}: {keys}') + + @field_validator(V_POSITIONAL_ONLY_NAME, check_fields=False) + @classmethod + def check_positional_only(cls, v: Optional[List[str]]) -> None: + if v is None: + return + + plural = '' if len(v) == 1 else 's' + keys = ', '.join(map(repr, v)) + raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}') + + @field_validator(V_DUPLICATE_KWARGS, check_fields=False) + @classmethod + def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None: + if v is None: + return + + plural = '' if len(v) == 1 else 's' + keys = ', '.join(map(repr, v)) + raise TypeError(f'multiple values for argument{plural}: {keys}') + + model_config = config_wrapper.config_dict + + self.model = create_model(to_pascal(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields) diff --git a/lib/pydantic/deprecated/json.py b/lib/pydantic/deprecated/json.py new file mode 100644 index 00000000..79e2f44a --- /dev/null +++ b/lib/pydantic/deprecated/json.py @@ -0,0 +1,140 @@ +import datetime +import warnings +from collections import deque +from decimal import Decimal +from enum import Enum +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from pathlib import Path +from re import Pattern +from types import GeneratorType +from typing import TYPE_CHECKING, Any, Callable, Dict, Type, Union +from uuid import UUID + +from typing_extensions import deprecated + +from ..color import Color +from ..networks import NameEmail +from ..types import SecretBytes, SecretStr +from ..warnings import PydanticDeprecatedSince20 + +if not TYPE_CHECKING: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + +__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat' + + +def isoformat(o: Union[datetime.date, datetime.time]) -> str: + return o.isoformat() + + +def decimal_encoder(dec_value: Decimal) -> Union[int, float]: + """Encodes a Decimal as int of there's no exponent, otherwise float. + + This is useful when we use ConstrainedDecimal to represent Numeric(x,0) + where a integer (but not int typed) is used. Encoding this as a float + results in failed round-tripping between encode and parse. + Our Id type is a prime example of this. + + >>> decimal_encoder(Decimal("1.0")) + 1.0 + + >>> decimal_encoder(Decimal("1")) + 1 + """ + exponent = dec_value.as_tuple().exponent + if isinstance(exponent, int) and exponent >= 0: + return int(dec_value) + else: + return float(dec_value) + + +ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = { + bytes: lambda o: o.decode(), + Color: str, + datetime.date: isoformat, + datetime.datetime: isoformat, + datetime.time: isoformat, + datetime.timedelta: lambda td: td.total_seconds(), + Decimal: decimal_encoder, + Enum: lambda o: o.value, + frozenset: list, + deque: list, + GeneratorType: list, + IPv4Address: str, + IPv4Interface: str, + IPv4Network: str, + IPv6Address: str, + IPv6Interface: str, + IPv6Network: str, + NameEmail: str, + Path: str, + Pattern: lambda o: o.pattern, + SecretBytes: str, + SecretStr: str, + set: list, + UUID: str, +} + + +@deprecated( + '`pydantic_encoder` is deprecated, use `pydantic_core.to_jsonable_python` instead.', + category=None, +) +def pydantic_encoder(obj: Any) -> Any: + warnings.warn( + '`pydantic_encoder` is deprecated, use `pydantic_core.to_jsonable_python` instead.', + category=PydanticDeprecatedSince20, + stacklevel=2, + ) + from dataclasses import asdict, is_dataclass + + from ..main import BaseModel + + if isinstance(obj, BaseModel): + return obj.model_dump() + elif is_dataclass(obj): + return asdict(obj) + + # Check the class type and its superclasses for a matching encoder + for base in obj.__class__.__mro__[:-1]: + try: + encoder = ENCODERS_BY_TYPE[base] + except KeyError: + continue + return encoder(obj) + else: # We have exited the for loop without finding a suitable encoder + raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable") + + +# TODO: Add a suggested migration path once there is a way to use custom encoders +@deprecated( + '`custom_pydantic_encoder` is deprecated, use `BaseModel.model_dump` instead.', + category=None, +) +def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any: + warnings.warn( + '`custom_pydantic_encoder` is deprecated, use `BaseModel.model_dump` instead.', + category=PydanticDeprecatedSince20, + stacklevel=2, + ) + # Check the class type and its superclasses for a matching encoder + for base in obj.__class__.__mro__[:-1]: + try: + encoder = type_encoders[base] + except KeyError: + continue + + return encoder(obj) + else: # We have exited the for loop without finding a suitable encoder + return pydantic_encoder(obj) + + +@deprecated('`timedelta_isoformat` is deprecated.', category=None) +def timedelta_isoformat(td: datetime.timedelta) -> str: + """ISO 8601 encoding for Python timedelta object.""" + warnings.warn('`timedelta_isoformat` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2) + minutes, seconds = divmod(td.seconds, 60) + hours, minutes = divmod(minutes, 60) + return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S' diff --git a/lib/pydantic/deprecated/parse.py b/lib/pydantic/deprecated/parse.py new file mode 100644 index 00000000..2a92e62b --- /dev/null +++ b/lib/pydantic/deprecated/parse.py @@ -0,0 +1,80 @@ +from __future__ import annotations + +import json +import pickle +import warnings +from enum import Enum +from pathlib import Path +from typing import TYPE_CHECKING, Any, Callable + +from typing_extensions import deprecated + +from ..warnings import PydanticDeprecatedSince20 + +if not TYPE_CHECKING: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + + +class Protocol(str, Enum): + json = 'json' + pickle = 'pickle' + + +@deprecated('`load_str_bytes` is deprecated.', category=None) +def load_str_bytes( + b: str | bytes, + *, + content_type: str | None = None, + encoding: str = 'utf8', + proto: Protocol | None = None, + allow_pickle: bool = False, + json_loads: Callable[[str], Any] = json.loads, +) -> Any: + warnings.warn('`load_str_bytes` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2) + if proto is None and content_type: + if content_type.endswith(('json', 'javascript')): + pass + elif allow_pickle and content_type.endswith('pickle'): + proto = Protocol.pickle + else: + raise TypeError(f'Unknown content-type: {content_type}') + + proto = proto or Protocol.json + + if proto == Protocol.json: + if isinstance(b, bytes): + b = b.decode(encoding) + return json_loads(b) # type: ignore + elif proto == Protocol.pickle: + if not allow_pickle: + raise RuntimeError('Trying to decode with pickle with allow_pickle=False') + bb = b if isinstance(b, bytes) else b.encode() # type: ignore + return pickle.loads(bb) + else: + raise TypeError(f'Unknown protocol: {proto}') + + +@deprecated('`load_file` is deprecated.', category=None) +def load_file( + path: str | Path, + *, + content_type: str | None = None, + encoding: str = 'utf8', + proto: Protocol | None = None, + allow_pickle: bool = False, + json_loads: Callable[[str], Any] = json.loads, +) -> Any: + warnings.warn('`load_file` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2) + path = Path(path) + b = path.read_bytes() + if content_type is None: + if path.suffix in ('.js', '.json'): + proto = Protocol.json + elif path.suffix == '.pkl': + proto = Protocol.pickle + + return load_str_bytes( + b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads + ) diff --git a/lib/pydantic/deprecated/tools.py b/lib/pydantic/deprecated/tools.py new file mode 100644 index 00000000..b04eae40 --- /dev/null +++ b/lib/pydantic/deprecated/tools.py @@ -0,0 +1,103 @@ +from __future__ import annotations + +import json +import warnings +from typing import TYPE_CHECKING, Any, Callable, Type, TypeVar, Union + +from typing_extensions import deprecated + +from ..json_schema import DEFAULT_REF_TEMPLATE, GenerateJsonSchema +from ..type_adapter import TypeAdapter +from ..warnings import PydanticDeprecatedSince20 + +if not TYPE_CHECKING: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + +__all__ = 'parse_obj_as', 'schema_of', 'schema_json_of' + +NameFactory = Union[str, Callable[[Type[Any]], str]] + + +T = TypeVar('T') + + +@deprecated( + '`parse_obj_as` is deprecated. Use `pydantic.TypeAdapter.validate_python` instead.', + category=None, +) +def parse_obj_as(type_: type[T], obj: Any, type_name: NameFactory | None = None) -> T: + warnings.warn( + '`parse_obj_as` is deprecated. Use `pydantic.TypeAdapter.validate_python` instead.', + category=PydanticDeprecatedSince20, + stacklevel=2, + ) + if type_name is not None: # pragma: no cover + warnings.warn( + 'The type_name parameter is deprecated. parse_obj_as no longer creates temporary models', + DeprecationWarning, + stacklevel=2, + ) + return TypeAdapter(type_).validate_python(obj) + + +@deprecated( + '`schema_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.', + category=None, +) +def schema_of( + type_: Any, + *, + title: NameFactory | None = None, + by_alias: bool = True, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, +) -> dict[str, Any]: + """Generate a JSON schema (as dict) for the passed model or dynamically generated one.""" + warnings.warn( + '`schema_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.', + category=PydanticDeprecatedSince20, + stacklevel=2, + ) + res = TypeAdapter(type_).json_schema( + by_alias=by_alias, + schema_generator=schema_generator, + ref_template=ref_template, + ) + if title is not None: + if isinstance(title, str): + res['title'] = title + else: + warnings.warn( + 'Passing a callable for the `title` parameter is deprecated and no longer supported', + DeprecationWarning, + stacklevel=2, + ) + res['title'] = title(type_) + return res + + +@deprecated( + '`schema_json_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.', + category=None, +) +def schema_json_of( + type_: Any, + *, + title: NameFactory | None = None, + by_alias: bool = True, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, + **dumps_kwargs: Any, +) -> str: + """Generate a JSON schema (as JSON) for the passed model or dynamically generated one.""" + warnings.warn( + '`schema_json_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.', + category=PydanticDeprecatedSince20, + stacklevel=2, + ) + return json.dumps( + schema_of(type_, title=title, by_alias=by_alias, ref_template=ref_template, schema_generator=schema_generator), + **dumps_kwargs, + ) diff --git a/lib/pydantic/env_settings.py b/lib/pydantic/env_settings.py index e9988c01..662f5900 100644 --- a/lib/pydantic/env_settings.py +++ b/lib/pydantic/env_settings.py @@ -1,346 +1,4 @@ -import os -import warnings -from pathlib import Path -from typing import AbstractSet, Any, Callable, ClassVar, Dict, List, Mapping, Optional, Tuple, Type, Union +"""The `env_settings` module is a backport module from V1.""" +from ._migration import getattr_migration -from .config import BaseConfig, Extra -from .fields import ModelField -from .main import BaseModel -from .typing import StrPath, display_as_type, get_origin, is_union -from .utils import deep_update, path_type, sequence_like - -env_file_sentinel = str(object()) - -SettingsSourceCallable = Callable[['BaseSettings'], Dict[str, Any]] -DotenvType = Union[StrPath, List[StrPath], Tuple[StrPath, ...]] - - -class SettingsError(ValueError): - pass - - -class BaseSettings(BaseModel): - """ - Base class for settings, allowing values to be overridden by environment variables. - - This is useful in production for secrets you do not wish to save in code, it plays nicely with docker(-compose), - Heroku and any 12 factor app design. - """ - - def __init__( - __pydantic_self__, - _env_file: Optional[DotenvType] = env_file_sentinel, - _env_file_encoding: Optional[str] = None, - _env_nested_delimiter: Optional[str] = None, - _secrets_dir: Optional[StrPath] = None, - **values: Any, - ) -> None: - # Uses something other than `self` the first arg to allow "self" as a settable attribute - super().__init__( - **__pydantic_self__._build_values( - values, - _env_file=_env_file, - _env_file_encoding=_env_file_encoding, - _env_nested_delimiter=_env_nested_delimiter, - _secrets_dir=_secrets_dir, - ) - ) - - def _build_values( - self, - init_kwargs: Dict[str, Any], - _env_file: Optional[DotenvType] = None, - _env_file_encoding: Optional[str] = None, - _env_nested_delimiter: Optional[str] = None, - _secrets_dir: Optional[StrPath] = None, - ) -> Dict[str, Any]: - # Configure built-in sources - init_settings = InitSettingsSource(init_kwargs=init_kwargs) - env_settings = EnvSettingsSource( - env_file=(_env_file if _env_file != env_file_sentinel else self.__config__.env_file), - env_file_encoding=( - _env_file_encoding if _env_file_encoding is not None else self.__config__.env_file_encoding - ), - env_nested_delimiter=( - _env_nested_delimiter if _env_nested_delimiter is not None else self.__config__.env_nested_delimiter - ), - env_prefix_len=len(self.__config__.env_prefix), - ) - file_secret_settings = SecretsSettingsSource(secrets_dir=_secrets_dir or self.__config__.secrets_dir) - # Provide a hook to set built-in sources priority and add / remove sources - sources = self.__config__.customise_sources( - init_settings=init_settings, env_settings=env_settings, file_secret_settings=file_secret_settings - ) - if sources: - return deep_update(*reversed([source(self) for source in sources])) - else: - # no one should mean to do this, but I think returning an empty dict is marginally preferable - # to an informative error and much better than a confusing error - return {} - - class Config(BaseConfig): - env_prefix: str = '' - env_file: Optional[DotenvType] = None - env_file_encoding: Optional[str] = None - env_nested_delimiter: Optional[str] = None - secrets_dir: Optional[StrPath] = None - validate_all: bool = True - extra: Extra = Extra.forbid - arbitrary_types_allowed: bool = True - case_sensitive: bool = False - - @classmethod - def prepare_field(cls, field: ModelField) -> None: - env_names: Union[List[str], AbstractSet[str]] - field_info_from_config = cls.get_field_info(field.name) - - env = field_info_from_config.get('env') or field.field_info.extra.get('env') - if env is None: - if field.has_alias: - warnings.warn( - 'aliases are no longer used by BaseSettings to define which environment variables to read. ' - 'Instead use the "env" field setting. ' - 'See https://pydantic-docs.helpmanual.io/usage/settings/#environment-variable-names', - FutureWarning, - ) - env_names = {cls.env_prefix + field.name} - elif isinstance(env, str): - env_names = {env} - elif isinstance(env, (set, frozenset)): - env_names = env - elif sequence_like(env): - env_names = list(env) - else: - raise TypeError(f'invalid field env: {env!r} ({display_as_type(env)}); should be string, list or set') - - if not cls.case_sensitive: - env_names = env_names.__class__(n.lower() for n in env_names) - field.field_info.extra['env_names'] = env_names - - @classmethod - def customise_sources( - cls, - init_settings: SettingsSourceCallable, - env_settings: SettingsSourceCallable, - file_secret_settings: SettingsSourceCallable, - ) -> Tuple[SettingsSourceCallable, ...]: - return init_settings, env_settings, file_secret_settings - - @classmethod - def parse_env_var(cls, field_name: str, raw_val: str) -> Any: - return cls.json_loads(raw_val) - - # populated by the metaclass using the Config class defined above, annotated here to help IDEs only - __config__: ClassVar[Type[Config]] - - -class InitSettingsSource: - __slots__ = ('init_kwargs',) - - def __init__(self, init_kwargs: Dict[str, Any]): - self.init_kwargs = init_kwargs - - def __call__(self, settings: BaseSettings) -> Dict[str, Any]: - return self.init_kwargs - - def __repr__(self) -> str: - return f'InitSettingsSource(init_kwargs={self.init_kwargs!r})' - - -class EnvSettingsSource: - __slots__ = ('env_file', 'env_file_encoding', 'env_nested_delimiter', 'env_prefix_len') - - def __init__( - self, - env_file: Optional[DotenvType], - env_file_encoding: Optional[str], - env_nested_delimiter: Optional[str] = None, - env_prefix_len: int = 0, - ): - self.env_file: Optional[DotenvType] = env_file - self.env_file_encoding: Optional[str] = env_file_encoding - self.env_nested_delimiter: Optional[str] = env_nested_delimiter - self.env_prefix_len: int = env_prefix_len - - def __call__(self, settings: BaseSettings) -> Dict[str, Any]: # noqa C901 - """ - Build environment variables suitable for passing to the Model. - """ - d: Dict[str, Any] = {} - - if settings.__config__.case_sensitive: - env_vars: Mapping[str, Optional[str]] = os.environ - else: - env_vars = {k.lower(): v for k, v in os.environ.items()} - - dotenv_vars = self._read_env_files(settings.__config__.case_sensitive) - if dotenv_vars: - env_vars = {**dotenv_vars, **env_vars} - - for field in settings.__fields__.values(): - env_val: Optional[str] = None - for env_name in field.field_info.extra['env_names']: - env_val = env_vars.get(env_name) - if env_val is not None: - break - - is_complex, allow_parse_failure = self.field_is_complex(field) - if is_complex: - if env_val is None: - # field is complex but no value found so far, try explode_env_vars - env_val_built = self.explode_env_vars(field, env_vars) - if env_val_built: - d[field.alias] = env_val_built - else: - # field is complex and there's a value, decode that as JSON, then add explode_env_vars - try: - env_val = settings.__config__.parse_env_var(field.name, env_val) - except ValueError as e: - if not allow_parse_failure: - raise SettingsError(f'error parsing env var "{env_name}"') from e - - if isinstance(env_val, dict): - d[field.alias] = deep_update(env_val, self.explode_env_vars(field, env_vars)) - else: - d[field.alias] = env_val - elif env_val is not None: - # simplest case, field is not complex, we only need to add the value if it was found - d[field.alias] = env_val - - return d - - def _read_env_files(self, case_sensitive: bool) -> Dict[str, Optional[str]]: - env_files = self.env_file - if env_files is None: - return {} - - if isinstance(env_files, (str, os.PathLike)): - env_files = [env_files] - - dotenv_vars = {} - for env_file in env_files: - env_path = Path(env_file).expanduser() - if env_path.is_file(): - dotenv_vars.update( - read_env_file(env_path, encoding=self.env_file_encoding, case_sensitive=case_sensitive) - ) - - return dotenv_vars - - def field_is_complex(self, field: ModelField) -> Tuple[bool, bool]: - """ - Find out if a field is complex, and if so whether JSON errors should be ignored - """ - if field.is_complex(): - allow_parse_failure = False - elif is_union(get_origin(field.type_)) and field.sub_fields and any(f.is_complex() for f in field.sub_fields): - allow_parse_failure = True - else: - return False, False - - return True, allow_parse_failure - - def explode_env_vars(self, field: ModelField, env_vars: Mapping[str, Optional[str]]) -> Dict[str, Any]: - """ - Process env_vars and extract the values of keys containing env_nested_delimiter into nested dictionaries. - - This is applied to a single field, hence filtering by env_var prefix. - """ - prefixes = [f'{env_name}{self.env_nested_delimiter}' for env_name in field.field_info.extra['env_names']] - result: Dict[str, Any] = {} - for env_name, env_val in env_vars.items(): - if not any(env_name.startswith(prefix) for prefix in prefixes): - continue - # we remove the prefix before splitting in case the prefix has characters in common with the delimiter - env_name_without_prefix = env_name[self.env_prefix_len :] - _, *keys, last_key = env_name_without_prefix.split(self.env_nested_delimiter) - env_var = result - for key in keys: - env_var = env_var.setdefault(key, {}) - env_var[last_key] = env_val - - return result - - def __repr__(self) -> str: - return ( - f'EnvSettingsSource(env_file={self.env_file!r}, env_file_encoding={self.env_file_encoding!r}, ' - f'env_nested_delimiter={self.env_nested_delimiter!r})' - ) - - -class SecretsSettingsSource: - __slots__ = ('secrets_dir',) - - def __init__(self, secrets_dir: Optional[StrPath]): - self.secrets_dir: Optional[StrPath] = secrets_dir - - def __call__(self, settings: BaseSettings) -> Dict[str, Any]: - """ - Build fields from "secrets" files. - """ - secrets: Dict[str, Optional[str]] = {} - - if self.secrets_dir is None: - return secrets - - secrets_path = Path(self.secrets_dir).expanduser() - - if not secrets_path.exists(): - warnings.warn(f'directory "{secrets_path}" does not exist') - return secrets - - if not secrets_path.is_dir(): - raise SettingsError(f'secrets_dir must reference a directory, not a {path_type(secrets_path)}') - - for field in settings.__fields__.values(): - for env_name in field.field_info.extra['env_names']: - path = find_case_path(secrets_path, env_name, settings.__config__.case_sensitive) - if not path: - # path does not exist, we curently don't return a warning for this - continue - - if path.is_file(): - secret_value = path.read_text().strip() - if field.is_complex(): - try: - secret_value = settings.__config__.parse_env_var(field.name, secret_value) - except ValueError as e: - raise SettingsError(f'error parsing env var "{env_name}"') from e - - secrets[field.alias] = secret_value - else: - warnings.warn( - f'attempted to load secret file "{path}" but found a {path_type(path)} instead.', - stacklevel=4, - ) - return secrets - - def __repr__(self) -> str: - return f'SecretsSettingsSource(secrets_dir={self.secrets_dir!r})' - - -def read_env_file( - file_path: StrPath, *, encoding: str = None, case_sensitive: bool = False -) -> Dict[str, Optional[str]]: - try: - from dotenv import dotenv_values - except ImportError as e: - raise ImportError('python-dotenv is not installed, run `pip install pydantic[dotenv]`') from e - - file_vars: Dict[str, Optional[str]] = dotenv_values(file_path, encoding=encoding or 'utf8') - if not case_sensitive: - return {k.lower(): v for k, v in file_vars.items()} - else: - return file_vars - - -def find_case_path(dir_path: Path, file_name: str, case_sensitive: bool) -> Optional[Path]: - """ - Find a file within path's directory matching filename, optionally ignoring case. - """ - for f in dir_path.iterdir(): - if f.name == file_name: - return f - elif not case_sensitive and f.name.lower() == file_name.lower(): - return f - return None +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/error_wrappers.py b/lib/pydantic/error_wrappers.py index 5d3204f4..5144eeee 100644 --- a/lib/pydantic/error_wrappers.py +++ b/lib/pydantic/error_wrappers.py @@ -1,162 +1,4 @@ -import json -from typing import TYPE_CHECKING, Any, Dict, Generator, List, Optional, Sequence, Tuple, Type, Union +"""The `error_wrappers` module is a backport module from V1.""" +from ._migration import getattr_migration -from .json import pydantic_encoder -from .utils import Representation - -if TYPE_CHECKING: - from typing_extensions import TypedDict - - from .config import BaseConfig - from .types import ModelOrDc - from .typing import ReprArgs - - Loc = Tuple[Union[int, str], ...] - - class _ErrorDictRequired(TypedDict): - loc: Loc - msg: str - type: str - - class ErrorDict(_ErrorDictRequired, total=False): - ctx: Dict[str, Any] - - -__all__ = 'ErrorWrapper', 'ValidationError' - - -class ErrorWrapper(Representation): - __slots__ = 'exc', '_loc' - - def __init__(self, exc: Exception, loc: Union[str, 'Loc']) -> None: - self.exc = exc - self._loc = loc - - def loc_tuple(self) -> 'Loc': - if isinstance(self._loc, tuple): - return self._loc - else: - return (self._loc,) - - def __repr_args__(self) -> 'ReprArgs': - return [('exc', self.exc), ('loc', self.loc_tuple())] - - -# ErrorList is something like Union[List[Union[List[ErrorWrapper], ErrorWrapper]], ErrorWrapper] -# but recursive, therefore just use: -ErrorList = Union[Sequence[Any], ErrorWrapper] - - -class ValidationError(Representation, ValueError): - __slots__ = 'raw_errors', 'model', '_error_cache' - - def __init__(self, errors: Sequence[ErrorList], model: 'ModelOrDc') -> None: - self.raw_errors = errors - self.model = model - self._error_cache: Optional[List['ErrorDict']] = None - - def errors(self) -> List['ErrorDict']: - if self._error_cache is None: - try: - config = self.model.__config__ # type: ignore - except AttributeError: - config = self.model.__pydantic_model__.__config__ # type: ignore - self._error_cache = list(flatten_errors(self.raw_errors, config)) - return self._error_cache - - def json(self, *, indent: Union[None, int, str] = 2) -> str: - return json.dumps(self.errors(), indent=indent, default=pydantic_encoder) - - def __str__(self) -> str: - errors = self.errors() - no_errors = len(errors) - return ( - f'{no_errors} validation error{"" if no_errors == 1 else "s"} for {self.model.__name__}\n' - f'{display_errors(errors)}' - ) - - def __repr_args__(self) -> 'ReprArgs': - return [('model', self.model.__name__), ('errors', self.errors())] - - -def display_errors(errors: List['ErrorDict']) -> str: - return '\n'.join(f'{_display_error_loc(e)}\n {e["msg"]} ({_display_error_type_and_ctx(e)})' for e in errors) - - -def _display_error_loc(error: 'ErrorDict') -> str: - return ' -> '.join(str(e) for e in error['loc']) - - -def _display_error_type_and_ctx(error: 'ErrorDict') -> str: - t = 'type=' + error['type'] - ctx = error.get('ctx') - if ctx: - return t + ''.join(f'; {k}={v}' for k, v in ctx.items()) - else: - return t - - -def flatten_errors( - errors: Sequence[Any], config: Type['BaseConfig'], loc: Optional['Loc'] = None -) -> Generator['ErrorDict', None, None]: - for error in errors: - if isinstance(error, ErrorWrapper): - - if loc: - error_loc = loc + error.loc_tuple() - else: - error_loc = error.loc_tuple() - - if isinstance(error.exc, ValidationError): - yield from flatten_errors(error.exc.raw_errors, config, error_loc) - else: - yield error_dict(error.exc, config, error_loc) - elif isinstance(error, list): - yield from flatten_errors(error, config, loc=loc) - else: - raise RuntimeError(f'Unknown error object: {error}') - - -def error_dict(exc: Exception, config: Type['BaseConfig'], loc: 'Loc') -> 'ErrorDict': - type_ = get_exc_type(exc.__class__) - msg_template = config.error_msg_templates.get(type_) or getattr(exc, 'msg_template', None) - ctx = exc.__dict__ - if msg_template: - msg = msg_template.format(**ctx) - else: - msg = str(exc) - - d: 'ErrorDict' = {'loc': loc, 'msg': msg, 'type': type_} - - if ctx: - d['ctx'] = ctx - - return d - - -_EXC_TYPE_CACHE: Dict[Type[Exception], str] = {} - - -def get_exc_type(cls: Type[Exception]) -> str: - # slightly more efficient than using lru_cache since we don't need to worry about the cache filling up - try: - return _EXC_TYPE_CACHE[cls] - except KeyError: - r = _get_exc_type(cls) - _EXC_TYPE_CACHE[cls] = r - return r - - -def _get_exc_type(cls: Type[Exception]) -> str: - if issubclass(cls, AssertionError): - return 'assertion_error' - - base_name = 'type_error' if issubclass(cls, TypeError) else 'value_error' - if cls in (TypeError, ValueError): - # just TypeError or ValueError, no extra code - return base_name - - # if it's not a TypeError or ValueError, we just take the lowercase of the exception name - # no chaining or snake case logic, use "code" for more complex error types. - code = getattr(cls, 'code', None) or cls.__name__.replace('Error', '').lower() - return base_name + '.' + code +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/errors.py b/lib/pydantic/errors.py index 7bdafdd1..c5fa9612 100644 --- a/lib/pydantic/errors.py +++ b/lib/pydantic/errors.py @@ -1,646 +1,152 @@ -from decimal import Decimal -from pathlib import Path -from typing import TYPE_CHECKING, Any, Callable, Sequence, Set, Tuple, Type, Union +"""Pydantic-specific errors.""" +from __future__ import annotations as _annotations -from .typing import display_as_type +import re -if TYPE_CHECKING: - from .typing import DictStrAny +from typing_extensions import Literal, Self + +from ._migration import getattr_migration +from .version import version_short -# explicitly state exports to avoid "from .errors import *" also importing Decimal, Path etc. __all__ = ( - 'PydanticTypeError', - 'PydanticValueError', - 'ConfigError', - 'MissingError', - 'ExtraError', - 'NoneIsNotAllowedError', - 'NoneIsAllowedError', - 'WrongConstantError', - 'NotNoneError', - 'BoolError', - 'BytesError', - 'DictError', - 'EmailError', - 'UrlError', - 'UrlSchemeError', - 'UrlSchemePermittedError', - 'UrlUserInfoError', - 'UrlHostError', - 'UrlHostTldError', - 'UrlPortError', - 'UrlExtraError', - 'EnumError', - 'IntEnumError', - 'EnumMemberError', - 'IntegerError', - 'FloatError', - 'PathError', - 'PathNotExistsError', - 'PathNotAFileError', - 'PathNotADirectoryError', - 'PyObjectError', - 'SequenceError', - 'ListError', - 'SetError', - 'FrozenSetError', - 'TupleError', - 'TupleLengthError', - 'ListMinLengthError', - 'ListMaxLengthError', - 'ListUniqueItemsError', - 'SetMinLengthError', - 'SetMaxLengthError', - 'FrozenSetMinLengthError', - 'FrozenSetMaxLengthError', - 'AnyStrMinLengthError', - 'AnyStrMaxLengthError', - 'StrError', - 'StrRegexError', - 'NumberNotGtError', - 'NumberNotGeError', - 'NumberNotLtError', - 'NumberNotLeError', - 'NumberNotMultipleError', - 'DecimalError', - 'DecimalIsNotFiniteError', - 'DecimalMaxDigitsError', - 'DecimalMaxPlacesError', - 'DecimalWholeDigitsError', - 'DateTimeError', - 'DateError', - 'DateNotInThePastError', - 'DateNotInTheFutureError', - 'TimeError', - 'DurationError', - 'HashableError', - 'UUIDError', - 'UUIDVersionError', - 'ArbitraryTypeError', - 'ClassError', - 'SubclassError', - 'JsonError', - 'JsonTypeError', - 'PatternError', - 'DataclassTypeError', - 'CallableError', - 'IPvAnyAddressError', - 'IPvAnyInterfaceError', - 'IPvAnyNetworkError', - 'IPv4AddressError', - 'IPv6AddressError', - 'IPv4NetworkError', - 'IPv6NetworkError', - 'IPv4InterfaceError', - 'IPv6InterfaceError', - 'ColorError', - 'StrictBoolError', - 'NotDigitError', - 'LuhnValidationError', - 'InvalidLengthForBrand', - 'InvalidByteSize', - 'InvalidByteSizeUnit', - 'MissingDiscriminator', - 'InvalidDiscriminator', + 'PydanticUserError', + 'PydanticUndefinedAnnotation', + 'PydanticImportError', + 'PydanticSchemaGenerationError', + 'PydanticInvalidForJsonSchema', + 'PydanticErrorCodes', ) - -def cls_kwargs(cls: Type['PydanticErrorMixin'], ctx: 'DictStrAny') -> 'PydanticErrorMixin': - """ - For built-in exceptions like ValueError or TypeError, we need to implement - __reduce__ to override the default behaviour (instead of __getstate__/__setstate__) - By default pickle protocol 2 calls `cls.__new__(cls, *args)`. - Since we only use kwargs, we need a little constructor to change that. - Note: the callable can't be a lambda as pickle looks in the namespace to find it - """ - return cls(**ctx) +# We use this URL to allow for future flexibility about how we host the docs, while allowing for Pydantic +# code in the while with "old" URLs to still work. +# 'u' refers to "user errors" - e.g. errors caused by developers using pydantic, as opposed to validation errors. +DEV_ERROR_DOCS_URL = f'https://errors.pydantic.dev/{version_short()}/u/' +PydanticErrorCodes = Literal[ + 'class-not-fully-defined', + 'custom-json-schema', + 'decorator-missing-field', + 'discriminator-no-field', + 'discriminator-alias-type', + 'discriminator-needs-literal', + 'discriminator-alias', + 'discriminator-validator', + 'callable-discriminator-no-tag', + 'typed-dict-version', + 'model-field-overridden', + 'model-field-missing-annotation', + 'config-both', + 'removed-kwargs', + 'invalid-for-json-schema', + 'json-schema-already-used', + 'base-model-instantiated', + 'undefined-annotation', + 'schema-for-unknown-type', + 'import-error', + 'create-model-field-definitions', + 'create-model-config-base', + 'validator-no-fields', + 'validator-invalid-fields', + 'validator-instance-method', + 'root-validator-pre-skip', + 'model-serializer-instance-method', + 'validator-field-config-info', + 'validator-v1-signature', + 'validator-signature', + 'field-serializer-signature', + 'model-serializer-signature', + 'multiple-field-serializers', + 'invalid_annotated_type', + 'type-adapter-config-unused', + 'root-model-extra', + 'unevaluable-type-annotation', + 'dataclass-init-false-extra-allow', + 'clashing-init-and-init-var', +] class PydanticErrorMixin: - code: str - msg_template: str + """A mixin class for common functionality shared by all Pydantic-specific errors. - def __init__(self, **ctx: Any) -> None: - self.__dict__ = ctx + Attributes: + message: A message describing the error. + code: An optional error code from PydanticErrorCodes enum. + """ + + def __init__(self, message: str, *, code: PydanticErrorCodes | None) -> None: + self.message = message + self.code = code def __str__(self) -> str: - return self.msg_template.format(**self.__dict__) + if self.code is None: + return self.message + else: + return f'{self.message}\n\nFor further information visit {DEV_ERROR_DOCS_URL}{self.code}' - def __reduce__(self) -> Tuple[Callable[..., 'PydanticErrorMixin'], Tuple[Type['PydanticErrorMixin'], 'DictStrAny']]: - return cls_kwargs, (self.__class__, self.__dict__) +class PydanticUserError(PydanticErrorMixin, TypeError): + """An error raised due to incorrect use of Pydantic.""" -class PydanticTypeError(PydanticErrorMixin, TypeError): - pass +class PydanticUndefinedAnnotation(PydanticErrorMixin, NameError): + """A subclass of `NameError` raised when handling undefined annotations during `CoreSchema` generation. -class PydanticValueError(PydanticErrorMixin, ValueError): - pass + Attributes: + name: Name of the error. + message: Description of the error. + """ + def __init__(self, name: str, message: str) -> None: + self.name = name + super().__init__(message=message, code='undefined-annotation') -class ConfigError(RuntimeError): - pass + @classmethod + def from_name_error(cls, name_error: NameError) -> Self: + """Convert a `NameError` to a `PydanticUndefinedAnnotation` error. + Args: + name_error: `NameError` to be converted. -class MissingError(PydanticValueError): - msg_template = 'field required' + Returns: + Converted `PydanticUndefinedAnnotation` error. + """ + try: + name = name_error.name # type: ignore # python > 3.10 + except AttributeError: + name = re.search(r".*'(.+?)'", str(name_error)).group(1) # type: ignore[union-attr] + return cls(name=name, message=str(name_error)) -class ExtraError(PydanticValueError): - msg_template = 'extra fields not permitted' +class PydanticImportError(PydanticErrorMixin, ImportError): + """An error raised when an import fails due to module changes between V1 and V2. + Attributes: + message: Description of the error. + """ -class NoneIsNotAllowedError(PydanticTypeError): - code = 'none.not_allowed' - msg_template = 'none is not an allowed value' + def __init__(self, message: str) -> None: + super().__init__(message, code='import-error') -class NoneIsAllowedError(PydanticTypeError): - code = 'none.allowed' - msg_template = 'value is not none' +class PydanticSchemaGenerationError(PydanticUserError): + """An error raised during failures to generate a `CoreSchema` for some type. + Attributes: + message: Description of the error. + """ -class WrongConstantError(PydanticValueError): - code = 'const' + def __init__(self, message: str) -> None: + super().__init__(message, code='schema-for-unknown-type') - def __str__(self) -> str: - permitted = ', '.join(repr(v) for v in self.permitted) # type: ignore - return f'unexpected value; permitted: {permitted}' +class PydanticInvalidForJsonSchema(PydanticUserError): + """An error raised during failures to generate a JSON schema for some `CoreSchema`. -class NotNoneError(PydanticTypeError): - code = 'not_none' - msg_template = 'value is not None' + Attributes: + message: Description of the error. + """ + def __init__(self, message: str) -> None: + super().__init__(message, code='invalid-for-json-schema') -class BoolError(PydanticTypeError): - msg_template = 'value could not be parsed to a boolean' - -class BytesError(PydanticTypeError): - msg_template = 'byte type expected' - - -class DictError(PydanticTypeError): - msg_template = 'value is not a valid dict' - - -class EmailError(PydanticValueError): - msg_template = 'value is not a valid email address' - - -class UrlError(PydanticValueError): - code = 'url' - - -class UrlSchemeError(UrlError): - code = 'url.scheme' - msg_template = 'invalid or missing URL scheme' - - -class UrlSchemePermittedError(UrlError): - code = 'url.scheme' - msg_template = 'URL scheme not permitted' - - def __init__(self, allowed_schemes: Set[str]): - super().__init__(allowed_schemes=allowed_schemes) - - -class UrlUserInfoError(UrlError): - code = 'url.userinfo' - msg_template = 'userinfo required in URL but missing' - - -class UrlHostError(UrlError): - code = 'url.host' - msg_template = 'URL host invalid' - - -class UrlHostTldError(UrlError): - code = 'url.host' - msg_template = 'URL host invalid, top level domain required' - - -class UrlPortError(UrlError): - code = 'url.port' - msg_template = 'URL port invalid, port cannot exceed 65535' - - -class UrlExtraError(UrlError): - code = 'url.extra' - msg_template = 'URL invalid, extra characters found after valid URL: {extra!r}' - - -class EnumMemberError(PydanticTypeError): - code = 'enum' - - def __str__(self) -> str: - permitted = ', '.join(repr(v.value) for v in self.enum_values) # type: ignore - return f'value is not a valid enumeration member; permitted: {permitted}' - - -class IntegerError(PydanticTypeError): - msg_template = 'value is not a valid integer' - - -class FloatError(PydanticTypeError): - msg_template = 'value is not a valid float' - - -class PathError(PydanticTypeError): - msg_template = 'value is not a valid path' - - -class _PathValueError(PydanticValueError): - def __init__(self, *, path: Path) -> None: - super().__init__(path=str(path)) - - -class PathNotExistsError(_PathValueError): - code = 'path.not_exists' - msg_template = 'file or directory at path "{path}" does not exist' - - -class PathNotAFileError(_PathValueError): - code = 'path.not_a_file' - msg_template = 'path "{path}" does not point to a file' - - -class PathNotADirectoryError(_PathValueError): - code = 'path.not_a_directory' - msg_template = 'path "{path}" does not point to a directory' - - -class PyObjectError(PydanticTypeError): - msg_template = 'ensure this value contains valid import path or valid callable: {error_message}' - - -class SequenceError(PydanticTypeError): - msg_template = 'value is not a valid sequence' - - -class IterableError(PydanticTypeError): - msg_template = 'value is not a valid iterable' - - -class ListError(PydanticTypeError): - msg_template = 'value is not a valid list' - - -class SetError(PydanticTypeError): - msg_template = 'value is not a valid set' - - -class FrozenSetError(PydanticTypeError): - msg_template = 'value is not a valid frozenset' - - -class DequeError(PydanticTypeError): - msg_template = 'value is not a valid deque' - - -class TupleError(PydanticTypeError): - msg_template = 'value is not a valid tuple' - - -class TupleLengthError(PydanticValueError): - code = 'tuple.length' - msg_template = 'wrong tuple length {actual_length}, expected {expected_length}' - - def __init__(self, *, actual_length: int, expected_length: int) -> None: - super().__init__(actual_length=actual_length, expected_length=expected_length) - - -class ListMinLengthError(PydanticValueError): - code = 'list.min_items' - msg_template = 'ensure this value has at least {limit_value} items' - - def __init__(self, *, limit_value: int) -> None: - super().__init__(limit_value=limit_value) - - -class ListMaxLengthError(PydanticValueError): - code = 'list.max_items' - msg_template = 'ensure this value has at most {limit_value} items' - - def __init__(self, *, limit_value: int) -> None: - super().__init__(limit_value=limit_value) - - -class ListUniqueItemsError(PydanticValueError): - code = 'list.unique_items' - msg_template = 'the list has duplicated items' - - -class SetMinLengthError(PydanticValueError): - code = 'set.min_items' - msg_template = 'ensure this value has at least {limit_value} items' - - def __init__(self, *, limit_value: int) -> None: - super().__init__(limit_value=limit_value) - - -class SetMaxLengthError(PydanticValueError): - code = 'set.max_items' - msg_template = 'ensure this value has at most {limit_value} items' - - def __init__(self, *, limit_value: int) -> None: - super().__init__(limit_value=limit_value) - - -class FrozenSetMinLengthError(PydanticValueError): - code = 'frozenset.min_items' - msg_template = 'ensure this value has at least {limit_value} items' - - def __init__(self, *, limit_value: int) -> None: - super().__init__(limit_value=limit_value) - - -class FrozenSetMaxLengthError(PydanticValueError): - code = 'frozenset.max_items' - msg_template = 'ensure this value has at most {limit_value} items' - - def __init__(self, *, limit_value: int) -> None: - super().__init__(limit_value=limit_value) - - -class AnyStrMinLengthError(PydanticValueError): - code = 'any_str.min_length' - msg_template = 'ensure this value has at least {limit_value} characters' - - def __init__(self, *, limit_value: int) -> None: - super().__init__(limit_value=limit_value) - - -class AnyStrMaxLengthError(PydanticValueError): - code = 'any_str.max_length' - msg_template = 'ensure this value has at most {limit_value} characters' - - def __init__(self, *, limit_value: int) -> None: - super().__init__(limit_value=limit_value) - - -class StrError(PydanticTypeError): - msg_template = 'str type expected' - - -class StrRegexError(PydanticValueError): - code = 'str.regex' - msg_template = 'string does not match regex "{pattern}"' - - def __init__(self, *, pattern: str) -> None: - super().__init__(pattern=pattern) - - -class _NumberBoundError(PydanticValueError): - def __init__(self, *, limit_value: Union[int, float, Decimal]) -> None: - super().__init__(limit_value=limit_value) - - -class NumberNotGtError(_NumberBoundError): - code = 'number.not_gt' - msg_template = 'ensure this value is greater than {limit_value}' - - -class NumberNotGeError(_NumberBoundError): - code = 'number.not_ge' - msg_template = 'ensure this value is greater than or equal to {limit_value}' - - -class NumberNotLtError(_NumberBoundError): - code = 'number.not_lt' - msg_template = 'ensure this value is less than {limit_value}' - - -class NumberNotLeError(_NumberBoundError): - code = 'number.not_le' - msg_template = 'ensure this value is less than or equal to {limit_value}' - - -class NumberNotFiniteError(PydanticValueError): - code = 'number.not_finite_number' - msg_template = 'ensure this value is a finite number' - - -class NumberNotMultipleError(PydanticValueError): - code = 'number.not_multiple' - msg_template = 'ensure this value is a multiple of {multiple_of}' - - def __init__(self, *, multiple_of: Union[int, float, Decimal]) -> None: - super().__init__(multiple_of=multiple_of) - - -class DecimalError(PydanticTypeError): - msg_template = 'value is not a valid decimal' - - -class DecimalIsNotFiniteError(PydanticValueError): - code = 'decimal.not_finite' - msg_template = 'value is not a valid decimal' - - -class DecimalMaxDigitsError(PydanticValueError): - code = 'decimal.max_digits' - msg_template = 'ensure that there are no more than {max_digits} digits in total' - - def __init__(self, *, max_digits: int) -> None: - super().__init__(max_digits=max_digits) - - -class DecimalMaxPlacesError(PydanticValueError): - code = 'decimal.max_places' - msg_template = 'ensure that there are no more than {decimal_places} decimal places' - - def __init__(self, *, decimal_places: int) -> None: - super().__init__(decimal_places=decimal_places) - - -class DecimalWholeDigitsError(PydanticValueError): - code = 'decimal.whole_digits' - msg_template = 'ensure that there are no more than {whole_digits} digits before the decimal point' - - def __init__(self, *, whole_digits: int) -> None: - super().__init__(whole_digits=whole_digits) - - -class DateTimeError(PydanticValueError): - msg_template = 'invalid datetime format' - - -class DateError(PydanticValueError): - msg_template = 'invalid date format' - - -class DateNotInThePastError(PydanticValueError): - code = 'date.not_in_the_past' - msg_template = 'date is not in the past' - - -class DateNotInTheFutureError(PydanticValueError): - code = 'date.not_in_the_future' - msg_template = 'date is not in the future' - - -class TimeError(PydanticValueError): - msg_template = 'invalid time format' - - -class DurationError(PydanticValueError): - msg_template = 'invalid duration format' - - -class HashableError(PydanticTypeError): - msg_template = 'value is not a valid hashable' - - -class UUIDError(PydanticTypeError): - msg_template = 'value is not a valid uuid' - - -class UUIDVersionError(PydanticValueError): - code = 'uuid.version' - msg_template = 'uuid version {required_version} expected' - - def __init__(self, *, required_version: int) -> None: - super().__init__(required_version=required_version) - - -class ArbitraryTypeError(PydanticTypeError): - code = 'arbitrary_type' - msg_template = 'instance of {expected_arbitrary_type} expected' - - def __init__(self, *, expected_arbitrary_type: Type[Any]) -> None: - super().__init__(expected_arbitrary_type=display_as_type(expected_arbitrary_type)) - - -class ClassError(PydanticTypeError): - code = 'class' - msg_template = 'a class is expected' - - -class SubclassError(PydanticTypeError): - code = 'subclass' - msg_template = 'subclass of {expected_class} expected' - - def __init__(self, *, expected_class: Type[Any]) -> None: - super().__init__(expected_class=display_as_type(expected_class)) - - -class JsonError(PydanticValueError): - msg_template = 'Invalid JSON' - - -class JsonTypeError(PydanticTypeError): - code = 'json' - msg_template = 'JSON object must be str, bytes or bytearray' - - -class PatternError(PydanticValueError): - code = 'regex_pattern' - msg_template = 'Invalid regular expression' - - -class DataclassTypeError(PydanticTypeError): - code = 'dataclass' - msg_template = 'instance of {class_name}, tuple or dict expected' - - -class CallableError(PydanticTypeError): - msg_template = '{value} is not callable' - - -class EnumError(PydanticTypeError): - code = 'enum_instance' - msg_template = '{value} is not a valid Enum instance' - - -class IntEnumError(PydanticTypeError): - code = 'int_enum_instance' - msg_template = '{value} is not a valid IntEnum instance' - - -class IPvAnyAddressError(PydanticValueError): - msg_template = 'value is not a valid IPv4 or IPv6 address' - - -class IPvAnyInterfaceError(PydanticValueError): - msg_template = 'value is not a valid IPv4 or IPv6 interface' - - -class IPvAnyNetworkError(PydanticValueError): - msg_template = 'value is not a valid IPv4 or IPv6 network' - - -class IPv4AddressError(PydanticValueError): - msg_template = 'value is not a valid IPv4 address' - - -class IPv6AddressError(PydanticValueError): - msg_template = 'value is not a valid IPv6 address' - - -class IPv4NetworkError(PydanticValueError): - msg_template = 'value is not a valid IPv4 network' - - -class IPv6NetworkError(PydanticValueError): - msg_template = 'value is not a valid IPv6 network' - - -class IPv4InterfaceError(PydanticValueError): - msg_template = 'value is not a valid IPv4 interface' - - -class IPv6InterfaceError(PydanticValueError): - msg_template = 'value is not a valid IPv6 interface' - - -class ColorError(PydanticValueError): - msg_template = 'value is not a valid color: {reason}' - - -class StrictBoolError(PydanticValueError): - msg_template = 'value is not a valid boolean' - - -class NotDigitError(PydanticValueError): - code = 'payment_card_number.digits' - msg_template = 'card number is not all digits' - - -class LuhnValidationError(PydanticValueError): - code = 'payment_card_number.luhn_check' - msg_template = 'card number is not luhn valid' - - -class InvalidLengthForBrand(PydanticValueError): - code = 'payment_card_number.invalid_length_for_brand' - msg_template = 'Length for a {brand} card must be {required_length}' - - -class InvalidByteSize(PydanticValueError): - msg_template = 'could not parse value and unit from byte string' - - -class InvalidByteSizeUnit(PydanticValueError): - msg_template = 'could not interpret byte unit: {unit}' - - -class MissingDiscriminator(PydanticValueError): - code = 'discriminated_union.missing_discriminator' - msg_template = 'Discriminator {discriminator_key!r} is missing in value' - - -class InvalidDiscriminator(PydanticValueError): - code = 'discriminated_union.invalid_discriminator' - msg_template = ( - 'No match for discriminator {discriminator_key!r} and value {discriminator_value!r} ' - '(allowed values: {allowed_values})' - ) - - def __init__(self, *, discriminator_key: str, discriminator_value: Any, allowed_values: Sequence[Any]) -> None: - super().__init__( - discriminator_key=discriminator_key, - discriminator_value=discriminator_value, - allowed_values=', '.join(map(repr, allowed_values)), - ) +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/fields.py b/lib/pydantic/fields.py index cecd3d20..b416bb7d 100644 --- a/lib/pydantic/fields.py +++ b/lib/pydantic/fields.py @@ -1,1209 +1,875 @@ -import copy -import re -from collections import Counter as CollectionCounter, defaultdict, deque -from collections.abc import Callable, Hashable as CollectionsHashable, Iterable as CollectionsIterable -from typing import ( - TYPE_CHECKING, - Any, - Counter, - DefaultDict, - Deque, - Dict, - ForwardRef, - FrozenSet, - Generator, - Iterable, - Iterator, - List, - Mapping, - Optional, - Pattern, - Sequence, - Set, - Tuple, - Type, - TypeVar, - Union, -) +"""Defining fields on models.""" +from __future__ import annotations as _annotations -from typing_extensions import Annotated, Final +import dataclasses +import inspect +import typing +from copy import copy +from dataclasses import Field as DataclassField +from functools import cached_property +from typing import Any, ClassVar +from warnings import warn -from . import errors as errors_ -from .class_validators import Validator, make_generic_validator, prep_validators -from .error_wrappers import ErrorWrapper -from .errors import ConfigError, InvalidDiscriminator, MissingDiscriminator, NoneIsNotAllowedError -from .types import Json, JsonWrapper -from .typing import ( - NoArgAnyCallable, - convert_generics, - display_as_type, - get_args, - get_origin, - is_finalvar, - is_literal_type, - is_new_type, - is_none_type, - is_typeddict, - is_typeddict_special, - is_union, - new_type_supertype, -) -from .utils import ( - PyObjectStr, - Representation, - ValueItems, - get_discriminator_alias_and_values, - get_unique_discriminator_alias, - lenient_isinstance, - lenient_issubclass, - sequence_like, - smart_deepcopy, -) -from .validators import constant_validator, dict_validator, find_validators, validate_json +import annotated_types +import typing_extensions +from pydantic_core import PydanticUndefined +from typing_extensions import Literal, Unpack -Required: Any = Ellipsis +from . import types +from ._internal import _decorators, _fields, _generics, _internal_dataclass, _repr, _typing_extra, _utils +from .aliases import AliasChoices, AliasPath +from .config import JsonDict +from .errors import PydanticUserError +from .warnings import PydanticDeprecatedSince20 -T = TypeVar('T') +if typing.TYPE_CHECKING: + from ._internal._repr import ReprArgs +else: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 -class UndefinedType: - def __repr__(self) -> str: - return 'PydanticUndefined' - - def __copy__(self: T) -> T: - return self - - def __reduce__(self) -> str: - return 'Undefined' - - def __deepcopy__(self: T, _: Any) -> T: - return self +_Unset: Any = PydanticUndefined -Undefined = UndefinedType() +class _FromFieldInfoInputs(typing_extensions.TypedDict, total=False): + """This class exists solely to add type checking for the `**kwargs` in `FieldInfo.from_field`.""" -if TYPE_CHECKING: - from .class_validators import ValidatorsList - from .config import BaseConfig - from .error_wrappers import ErrorList - from .types import ModelOrDc - from .typing import AbstractSetIntStr, MappingIntStrAny, ReprArgs - - ValidateReturn = Tuple[Optional[Any], Optional[ErrorList]] - LocStr = Union[Tuple[Union[int, str], ...], str] - BoolUndefined = Union[bool, UndefinedType] + annotation: type[Any] | None + default_factory: typing.Callable[[], Any] | None + alias: str | None + alias_priority: int | None + validation_alias: str | AliasPath | AliasChoices | None + serialization_alias: str | None + title: str | None + description: str | None + examples: list[Any] | None + exclude: bool | None + gt: float | None + ge: float | None + lt: float | None + le: float | None + multiple_of: float | None + strict: bool | None + min_length: int | None + max_length: int | None + pattern: str | None + allow_inf_nan: bool | None + max_digits: int | None + decimal_places: int | None + union_mode: Literal['smart', 'left_to_right'] | None + discriminator: str | types.Discriminator | None + json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None + frozen: bool | None + validate_default: bool | None + repr: bool + init: bool | None + init_var: bool | None + kw_only: bool | None -class FieldInfo(Representation): - """ - Captures extra information about a field. +class _FieldInfoInputs(_FromFieldInfoInputs, total=False): + """This class exists solely to add type checking for the `**kwargs` in `FieldInfo.__init__`.""" + + default: Any + + +class FieldInfo(_repr.Representation): + """This class holds information about a field. + + `FieldInfo` is used for any field definition regardless of whether the [`Field()`][pydantic.fields.Field] + function is explicitly used. + + !!! warning + You generally shouldn't be creating `FieldInfo` directly, you'll only need to use it when accessing + [`BaseModel`][pydantic.main.BaseModel] `.model_fields` internals. + + Attributes: + annotation: The type annotation of the field. + default: The default value of the field. + default_factory: The factory function used to construct the default for the field. + alias: The alias name of the field. + alias_priority: The priority of the field's alias. + validation_alias: The validation alias of the field. + serialization_alias: The serialization alias of the field. + title: The title of the field. + description: The description of the field. + examples: List of examples of the field. + exclude: Whether to exclude the field from the model serialization. + discriminator: Field name or Discriminator for discriminating the type in a tagged union. + json_schema_extra: A dict or callable to provide extra JSON schema properties. + frozen: Whether the field is frozen. + validate_default: Whether to validate the default value of the field. + repr: Whether to include the field in representation of the model. + init: Whether the field should be included in the constructor of the dataclass. + init_var: Whether the field should _only_ be included in the constructor of the dataclass, and not stored. + kw_only: Whether the field should be a keyword-only argument in the constructor of the dataclass. + metadata: List of metadata constraints. """ + annotation: type[Any] | None + default: Any + default_factory: typing.Callable[[], Any] | None + alias: str | None + alias_priority: int | None + validation_alias: str | AliasPath | AliasChoices | None + serialization_alias: str | None + title: str | None + description: str | None + examples: list[Any] | None + exclude: bool | None + discriminator: str | types.Discriminator | None + json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None + frozen: bool | None + validate_default: bool | None + repr: bool + init: bool | None + init_var: bool | None + kw_only: bool | None + metadata: list[Any] + __slots__ = ( + 'annotation', 'default', 'default_factory', 'alias', 'alias_priority', + 'validation_alias', + 'serialization_alias', 'title', 'description', + 'examples', 'exclude', - 'include', - 'const', - 'gt', - 'ge', - 'lt', - 'le', - 'multiple_of', - 'allow_inf_nan', - 'max_digits', - 'decimal_places', - 'min_items', - 'max_items', - 'unique_items', - 'min_length', - 'max_length', - 'allow_mutation', - 'repr', - 'regex', 'discriminator', - 'extra', + 'json_schema_extra', + 'frozen', + 'validate_default', + 'repr', + 'init', + 'init_var', + 'kw_only', + 'metadata', + '_attributes_set', ) - # field constraints with the default value, it's also used in update_from_config below - __field_constraints__ = { - 'min_length': None, - 'max_length': None, - 'regex': None, - 'gt': None, - 'lt': None, - 'ge': None, - 'le': None, - 'multiple_of': None, + # used to convert kwargs to metadata/constraints, + # None has a special meaning - these items are collected into a `PydanticGeneralMetadata` + metadata_lookup: ClassVar[dict[str, typing.Callable[[Any], Any] | None]] = { + 'strict': types.Strict, + 'gt': annotated_types.Gt, + 'ge': annotated_types.Ge, + 'lt': annotated_types.Lt, + 'le': annotated_types.Le, + 'multiple_of': annotated_types.MultipleOf, + 'min_length': annotated_types.MinLen, + 'max_length': annotated_types.MaxLen, + 'pattern': None, 'allow_inf_nan': None, 'max_digits': None, 'decimal_places': None, - 'min_items': None, - 'max_items': None, - 'unique_items': None, - 'allow_mutation': True, + 'union_mode': None, } - def __init__(self, default: Any = Undefined, **kwargs: Any) -> None: - self.default = default + def __init__(self, **kwargs: Unpack[_FieldInfoInputs]) -> None: + """This class should generally not be initialized directly; instead, use the `pydantic.fields.Field` function + or one of the constructor classmethods. + + See the signature of `pydantic.fields.Field` for more details about the expected arguments. + """ + self._attributes_set = {k: v for k, v in kwargs.items() if v is not _Unset} + kwargs = {k: _DefaultValues.get(k) if v is _Unset else v for k, v in kwargs.items()} # type: ignore + self.annotation, annotation_metadata = self._extract_metadata(kwargs.get('annotation')) + + default = kwargs.pop('default', PydanticUndefined) + if default is Ellipsis: + self.default = PydanticUndefined + else: + self.default = default + self.default_factory = kwargs.pop('default_factory', None) - self.alias = kwargs.pop('alias', None) - self.alias_priority = kwargs.pop('alias_priority', 2 if self.alias is not None else None) + + if self.default is not PydanticUndefined and self.default_factory is not None: + raise TypeError('cannot specify both default and default_factory') + self.title = kwargs.pop('title', None) + self.alias = kwargs.pop('alias', None) + self.validation_alias = kwargs.pop('validation_alias', None) + self.serialization_alias = kwargs.pop('serialization_alias', None) + alias_is_set = any(alias is not None for alias in (self.alias, self.validation_alias, self.serialization_alias)) + self.alias_priority = kwargs.pop('alias_priority', None) or 2 if alias_is_set else None self.description = kwargs.pop('description', None) + self.examples = kwargs.pop('examples', None) self.exclude = kwargs.pop('exclude', None) - self.include = kwargs.pop('include', None) - self.const = kwargs.pop('const', None) - self.gt = kwargs.pop('gt', None) - self.ge = kwargs.pop('ge', None) - self.lt = kwargs.pop('lt', None) - self.le = kwargs.pop('le', None) - self.multiple_of = kwargs.pop('multiple_of', None) - self.allow_inf_nan = kwargs.pop('allow_inf_nan', None) - self.max_digits = kwargs.pop('max_digits', None) - self.decimal_places = kwargs.pop('decimal_places', None) - self.min_items = kwargs.pop('min_items', None) - self.max_items = kwargs.pop('max_items', None) - self.unique_items = kwargs.pop('unique_items', None) - self.min_length = kwargs.pop('min_length', None) - self.max_length = kwargs.pop('max_length', None) - self.allow_mutation = kwargs.pop('allow_mutation', True) - self.regex = kwargs.pop('regex', None) self.discriminator = kwargs.pop('discriminator', None) self.repr = kwargs.pop('repr', True) - self.extra = kwargs + self.json_schema_extra = kwargs.pop('json_schema_extra', None) + self.validate_default = kwargs.pop('validate_default', None) + self.frozen = kwargs.pop('frozen', None) + # currently only used on dataclasses + self.init = kwargs.pop('init', None) + self.init_var = kwargs.pop('init_var', None) + self.kw_only = kwargs.pop('kw_only', None) - def __repr_args__(self) -> 'ReprArgs': + self.metadata = self._collect_metadata(kwargs) + annotation_metadata # type: ignore - field_defaults_to_hide: Dict[str, Any] = { - 'repr': True, - **self.__field_constraints__, - } + @staticmethod + def from_field(default: Any = PydanticUndefined, **kwargs: Unpack[_FromFieldInfoInputs]) -> FieldInfo: + """Create a new `FieldInfo` object with the `Field` function. - attrs = ((s, getattr(self, s)) for s in self.__slots__) - return [(a, v) for a, v in attrs if v != field_defaults_to_hide.get(a, None)] + Args: + default: The default value for the field. Defaults to Undefined. + **kwargs: Additional arguments dictionary. - def get_constraints(self) -> Set[str]: + Raises: + TypeError: If 'annotation' is passed as a keyword argument. + + Returns: + A new FieldInfo object with the given parameters. + + Example: + This is how you can create a field with default value like this: + + ```python + import pydantic + + class MyModel(pydantic.BaseModel): + foo: int = pydantic.Field(4) + ``` """ - Gets the constraints set on the field by comparing the constraint value with its default value + if 'annotation' in kwargs: + raise TypeError('"annotation" is not permitted as a Field keyword argument') + return FieldInfo(default=default, **kwargs) - :return: the constraints set on field_info - """ - return {attr for attr, default in self.__field_constraints__.items() if getattr(self, attr) != default} + @staticmethod + def from_annotation(annotation: type[Any]) -> FieldInfo: + """Creates a `FieldInfo` instance from a bare annotation. - def update_from_config(self, from_config: Dict[str, Any]) -> None: + This function is used internally to create a `FieldInfo` from a bare annotation like this: + + ```python + import pydantic + + class MyModel(pydantic.BaseModel): + foo: int # <-- like this + ``` + + We also account for the case where the annotation can be an instance of `Annotated` and where + one of the (not first) arguments in `Annotated` is an instance of `FieldInfo`, e.g.: + + ```python + import annotated_types + from typing_extensions import Annotated + + import pydantic + + class MyModel(pydantic.BaseModel): + foo: Annotated[int, annotated_types.Gt(42)] + bar: Annotated[int, pydantic.Field(gt=42)] + ``` + + Args: + annotation: An annotation object. + + Returns: + An instance of the field metadata. """ - Update this FieldInfo based on a dict from get_field_info, only fields which have not been set are dated. + final = False + if _typing_extra.is_finalvar(annotation): + final = True + if annotation is not typing_extensions.Final: + annotation = typing_extensions.get_args(annotation)[0] + + if _typing_extra.is_annotated(annotation): + first_arg, *extra_args = typing_extensions.get_args(annotation) + if _typing_extra.is_finalvar(first_arg): + final = True + field_info_annotations = [a for a in extra_args if isinstance(a, FieldInfo)] + field_info = FieldInfo.merge_field_infos(*field_info_annotations, annotation=first_arg) + if field_info: + new_field_info = copy(field_info) + new_field_info.annotation = first_arg + new_field_info.frozen = final or field_info.frozen + metadata: list[Any] = [] + for a in extra_args: + if not isinstance(a, FieldInfo): + metadata.append(a) + else: + metadata.extend(a.metadata) + new_field_info.metadata = metadata + return new_field_info + + return FieldInfo(annotation=annotation, frozen=final or None) + + @staticmethod + def from_annotated_attribute(annotation: type[Any], default: Any) -> FieldInfo: + """Create `FieldInfo` from an annotation with a default value. + + This is used in cases like the following: + + ```python + import annotated_types + from typing_extensions import Annotated + + import pydantic + + class MyModel(pydantic.BaseModel): + foo: int = 4 # <-- like this + bar: Annotated[int, annotated_types.Gt(4)] = 4 # <-- or this + spam: Annotated[int, pydantic.Field(gt=4)] = 4 # <-- or this + ``` + + Args: + annotation: The type annotation of the field. + default: The default value of the field. + + Returns: + A field object with the passed values. """ - for attr_name, value in from_config.items(): + if annotation is default: + raise PydanticUserError( + 'Error when building FieldInfo from annotated attribute. ' + "Make sure you don't have any field name clashing with a type annotation ", + code='unevaluable-type-annotation', + ) + + final = False + if _typing_extra.is_finalvar(annotation): + final = True + if annotation is not typing_extensions.Final: + annotation = typing_extensions.get_args(annotation)[0] + + if isinstance(default, FieldInfo): + default.annotation, annotation_metadata = FieldInfo._extract_metadata(annotation) + default.metadata += annotation_metadata + default = default.merge_field_infos( + *[x for x in annotation_metadata if isinstance(x, FieldInfo)], default, annotation=default.annotation + ) + default.frozen = final or default.frozen + return default + elif isinstance(default, dataclasses.Field): + init_var = False + if annotation is dataclasses.InitVar: + init_var = True + annotation = Any + elif isinstance(annotation, dataclasses.InitVar): + init_var = True + annotation = annotation.type + pydantic_field = FieldInfo._from_dataclass_field(default) + pydantic_field.annotation, annotation_metadata = FieldInfo._extract_metadata(annotation) + pydantic_field.metadata += annotation_metadata + pydantic_field = pydantic_field.merge_field_infos( + *[x for x in annotation_metadata if isinstance(x, FieldInfo)], + pydantic_field, + annotation=pydantic_field.annotation, + ) + pydantic_field.frozen = final or pydantic_field.frozen + pydantic_field.init_var = init_var + pydantic_field.init = getattr(default, 'init', None) + pydantic_field.kw_only = getattr(default, 'kw_only', None) + return pydantic_field + else: + if _typing_extra.is_annotated(annotation): + first_arg, *extra_args = typing_extensions.get_args(annotation) + field_infos = [a for a in extra_args if isinstance(a, FieldInfo)] + field_info = FieldInfo.merge_field_infos(*field_infos, annotation=first_arg, default=default) + metadata: list[Any] = [] + for a in extra_args: + if not isinstance(a, FieldInfo): + metadata.append(a) + else: + metadata.extend(a.metadata) + field_info.metadata = metadata + return field_info + + return FieldInfo(annotation=annotation, default=default, frozen=final or None) + + @staticmethod + def merge_field_infos(*field_infos: FieldInfo, **overrides: Any) -> FieldInfo: + """Merge `FieldInfo` instances keeping only explicitly set attributes. + + Later `FieldInfo` instances override earlier ones. + + Returns: + FieldInfo: A merged FieldInfo instance. + """ + flattened_field_infos: list[FieldInfo] = [] + for field_info in field_infos: + flattened_field_infos.extend(x for x in field_info.metadata if isinstance(x, FieldInfo)) + flattened_field_infos.append(field_info) + field_infos = tuple(flattened_field_infos) + if len(field_infos) == 1: + # No merging necessary, but we still need to make a copy and apply the overrides + field_info = copy(field_infos[0]) + field_info._attributes_set.update(overrides) + for k, v in overrides.items(): + setattr(field_info, k, v) + return field_info # type: ignore + + new_kwargs: dict[str, Any] = {} + metadata = {} + for field_info in field_infos: + new_kwargs.update(field_info._attributes_set) + for x in field_info.metadata: + if not isinstance(x, FieldInfo): + metadata[type(x)] = x + new_kwargs.update(overrides) + field_info = FieldInfo(**new_kwargs) + field_info.metadata = list(metadata.values()) + return field_info + + @staticmethod + def _from_dataclass_field(dc_field: DataclassField[Any]) -> FieldInfo: + """Return a new `FieldInfo` instance from a `dataclasses.Field` instance. + + Args: + dc_field: The `dataclasses.Field` instance to convert. + + Returns: + The corresponding `FieldInfo` instance. + + Raises: + TypeError: If any of the `FieldInfo` kwargs does not match the `dataclass.Field` kwargs. + """ + default = dc_field.default + if default is dataclasses.MISSING: + default = PydanticUndefined + + if dc_field.default_factory is dataclasses.MISSING: + default_factory: typing.Callable[[], Any] | None = None + else: + default_factory = dc_field.default_factory + + # use the `Field` function so in correct kwargs raise the correct `TypeError` + dc_field_metadata = {k: v for k, v in dc_field.metadata.items() if k in _FIELD_ARG_NAMES} + return Field(default=default, default_factory=default_factory, repr=dc_field.repr, **dc_field_metadata) + + @staticmethod + def _extract_metadata(annotation: type[Any] | None) -> tuple[type[Any] | None, list[Any]]: + """Tries to extract metadata/constraints from an annotation if it uses `Annotated`. + + Args: + annotation: The type hint annotation for which metadata has to be extracted. + + Returns: + A tuple containing the extracted metadata type and the list of extra arguments. + """ + if annotation is not None: + if _typing_extra.is_annotated(annotation): + first_arg, *extra_args = typing_extensions.get_args(annotation) + return first_arg, list(extra_args) + + return annotation, [] + + @staticmethod + def _collect_metadata(kwargs: dict[str, Any]) -> list[Any]: + """Collect annotations from kwargs. + + Args: + kwargs: Keyword arguments passed to the function. + + Returns: + A list of metadata objects - a combination of `annotated_types.BaseMetadata` and + `PydanticMetadata`. + """ + metadata: list[Any] = [] + general_metadata = {} + for key, value in list(kwargs.items()): try: - current_value = getattr(self, attr_name) - except AttributeError: - # attr_name is not an attribute of FieldInfo, it should therefore be added to extra - # (except if extra already has this value!) - self.extra.setdefault(attr_name, value) + marker = FieldInfo.metadata_lookup[key] + except KeyError: + continue + + del kwargs[key] + if value is not None: + if marker is None: + general_metadata[key] = value + else: + metadata.append(marker(value)) + if general_metadata: + metadata.append(_fields.pydantic_general_metadata(**general_metadata)) + return metadata + + def get_default(self, *, call_default_factory: bool = False) -> Any: + """Get the default value. + + We expose an option for whether to call the default_factory (if present), as calling it may + result in side effects that we want to avoid. However, there are times when it really should + be called (namely, when instantiating a model via `model_construct`). + + Args: + call_default_factory: Whether to call the default_factory or not. Defaults to `False`. + + Returns: + The default value, calling the default factory if requested or `None` if not set. + """ + if self.default_factory is None: + return _utils.smart_deepcopy(self.default) + elif call_default_factory: + return self.default_factory() + else: + return None + + def is_required(self) -> bool: + """Check if the field is required (i.e., does not have a default value or factory). + + Returns: + `True` if the field is required, `False` otherwise. + """ + return self.default is PydanticUndefined and self.default_factory is None + + def rebuild_annotation(self) -> Any: + """Attempts to rebuild the original annotation for use in function signatures. + + If metadata is present, it adds it to the original annotation using + `Annotated`. Otherwise, it returns the original annotation as-is. + + Note that because the metadata has been flattened, the original annotation + may not be reconstructed exactly as originally provided, e.g. if the original + type had unrecognized annotations, or was annotated with a call to `pydantic.Field`. + + Returns: + The rebuilt annotation. + """ + if not self.metadata: + return self.annotation + else: + # Annotated arguments must be a tuple + return typing_extensions.Annotated[(self.annotation, *self.metadata)] # type: ignore + + def apply_typevars_map(self, typevars_map: dict[Any, Any] | None, types_namespace: dict[str, Any] | None) -> None: + """Apply a `typevars_map` to the annotation. + + This method is used when analyzing parametrized generic types to replace typevars with their concrete types. + + This method applies the `typevars_map` to the annotation in place. + + Args: + typevars_map: A dictionary mapping type variables to their concrete types. + types_namespace (dict | None): A dictionary containing related types to the annotated type. + + See Also: + pydantic._internal._generics.replace_types is used for replacing the typevars with + their concrete types. + """ + annotation = _typing_extra.eval_type_lenient(self.annotation, types_namespace) + self.annotation = _generics.replace_types(annotation, typevars_map) + + def __repr_args__(self) -> ReprArgs: + yield 'annotation', _repr.PlainRepr(_repr.display_as_type(self.annotation)) + yield 'required', self.is_required() + + for s in self.__slots__: + if s == '_attributes_set': + continue + if s == 'annotation': + continue + elif s == 'metadata' and not self.metadata: + continue + elif s == 'repr' and self.repr is True: + continue + if s == 'frozen' and self.frozen is False: + continue + if s == 'validation_alias' and self.validation_alias == self.alias: + continue + if s == 'serialization_alias' and self.serialization_alias == self.alias: + continue + if s == 'default_factory' and self.default_factory is not None: + yield 'default_factory', _repr.PlainRepr(_repr.display_as_type(self.default_factory)) else: - if current_value is self.__field_constraints__.get(attr_name, None): - setattr(self, attr_name, value) - elif attr_name == 'exclude': - self.exclude = ValueItems.merge(value, current_value) - elif attr_name == 'include': - self.include = ValueItems.merge(value, current_value, intersect=True) - - def _validate(self) -> None: - if self.default is not Undefined and self.default_factory is not None: - raise ValueError('cannot specify both default and default_factory') + value = getattr(self, s) + if value is not None and value is not PydanticUndefined: + yield s, value -def Field( - default: Any = Undefined, +class _EmptyKwargs(typing_extensions.TypedDict): + """This class exists solely to ensure that type checking warns about passing `**extra` in `Field`.""" + + +_DefaultValues = dict( + default=..., + default_factory=None, + alias=None, + alias_priority=None, + validation_alias=None, + serialization_alias=None, + title=None, + description=None, + examples=None, + exclude=None, + discriminator=None, + json_schema_extra=None, + frozen=None, + validate_default=None, + repr=True, + init=None, + init_var=None, + kw_only=None, + pattern=None, + strict=None, + gt=None, + ge=None, + lt=None, + le=None, + multiple_of=None, + allow_inf_nan=None, + max_digits=None, + decimal_places=None, + min_length=None, + max_length=None, +) + + +def Field( # noqa: C901 + default: Any = PydanticUndefined, *, - default_factory: Optional[NoArgAnyCallable] = None, - alias: str = None, - title: str = None, - description: str = None, - exclude: Union['AbstractSetIntStr', 'MappingIntStrAny', Any] = None, - include: Union['AbstractSetIntStr', 'MappingIntStrAny', Any] = None, - const: bool = None, - gt: float = None, - ge: float = None, - lt: float = None, - le: float = None, - multiple_of: float = None, - allow_inf_nan: bool = None, - max_digits: int = None, - decimal_places: int = None, - min_items: int = None, - max_items: int = None, - unique_items: bool = None, - min_length: int = None, - max_length: int = None, - allow_mutation: bool = True, - regex: str = None, - discriminator: str = None, - repr: bool = True, - **extra: Any, + default_factory: typing.Callable[[], Any] | None = _Unset, + alias: str | None = _Unset, + alias_priority: int | None = _Unset, + validation_alias: str | AliasPath | AliasChoices | None = _Unset, + serialization_alias: str | None = _Unset, + title: str | None = _Unset, + description: str | None = _Unset, + examples: list[Any] | None = _Unset, + exclude: bool | None = _Unset, + discriminator: str | types.Discriminator | None = _Unset, + json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = _Unset, + frozen: bool | None = _Unset, + validate_default: bool | None = _Unset, + repr: bool = _Unset, + init: bool | None = _Unset, + init_var: bool | None = _Unset, + kw_only: bool | None = _Unset, + pattern: str | None = _Unset, + strict: bool | None = _Unset, + gt: float | None = _Unset, + ge: float | None = _Unset, + lt: float | None = _Unset, + le: float | None = _Unset, + multiple_of: float | None = _Unset, + allow_inf_nan: bool | None = _Unset, + max_digits: int | None = _Unset, + decimal_places: int | None = _Unset, + min_length: int | None = _Unset, + max_length: int | None = _Unset, + union_mode: Literal['smart', 'left_to_right'] = _Unset, + **extra: Unpack[_EmptyKwargs], ) -> Any: - """ - Used to provide extra information about a field, either for the model schema or complex validation. Some arguments - apply only to number fields (``int``, ``float``, ``Decimal``) and some apply only to ``str``. + """Usage docs: https://docs.pydantic.dev/2.6/concepts/fields - :param default: since this is replacing the field’s default, its first argument is used - to set the default, use ellipsis (``...``) to indicate the field is required - :param default_factory: callable that will be called when a default value is needed for this field - If both `default` and `default_factory` are set, an error is raised. - :param alias: the public name of the field - :param title: can be any string, used in the schema - :param description: can be any string, used in the schema - :param exclude: exclude this field while dumping. - Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method. - :param include: include this field while dumping. - Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method. - :param const: this field is required and *must* take it's default value - :param gt: only applies to numbers, requires the field to be "greater than". The schema - will have an ``exclusiveMinimum`` validation keyword - :param ge: only applies to numbers, requires the field to be "greater than or equal to". The - schema will have a ``minimum`` validation keyword - :param lt: only applies to numbers, requires the field to be "less than". The schema - will have an ``exclusiveMaximum`` validation keyword - :param le: only applies to numbers, requires the field to be "less than or equal to". The - schema will have a ``maximum`` validation keyword - :param multiple_of: only applies to numbers, requires the field to be "a multiple of". The - schema will have a ``multipleOf`` validation keyword - :param allow_inf_nan: only applies to numbers, allows the field to be NaN or infinity (+inf or -inf), - which is a valid Python float. Default True, set to False for compatibility with JSON. - :param max_digits: only applies to Decimals, requires the field to have a maximum number - of digits within the decimal. It does not include a zero before the decimal point or trailing decimal zeroes. - :param decimal_places: only applies to Decimals, requires the field to have at most a number of decimal places - allowed. It does not include trailing decimal zeroes. - :param min_items: only applies to lists, requires the field to have a minimum number of - elements. The schema will have a ``minItems`` validation keyword - :param max_items: only applies to lists, requires the field to have a maximum number of - elements. The schema will have a ``maxItems`` validation keyword - :param unique_items: only applies to lists, requires the field not to have duplicated - elements. The schema will have a ``uniqueItems`` validation keyword - :param min_length: only applies to strings, requires the field to have a minimum length. The - schema will have a ``maximum`` validation keyword - :param max_length: only applies to strings, requires the field to have a maximum length. The - schema will have a ``maxLength`` validation keyword - :param allow_mutation: a boolean which defaults to True. When False, the field raises a TypeError if the field is - assigned on an instance. The BaseModel Config must set validate_assignment to True - :param regex: only applies to strings, requires the field match against a regular expression - pattern string. The schema will have a ``pattern`` validation keyword - :param discriminator: only useful with a (discriminated a.k.a. tagged) `Union` of sub models with a common field. - The `discriminator` is the name of this common field to shorten validation and improve generated schema - :param repr: show this field in the representation - :param **extra: any additional keyword arguments will be added as is to the schema + Create a field for objects that can be configured. + + Used to provide extra information about a field, either for the model schema or complex validation. Some arguments + apply only to number fields (`int`, `float`, `Decimal`) and some apply only to `str`. + + Note: + - Any `_Unset` objects will be replaced by the corresponding value defined in the `_DefaultValues` dictionary. If a key for the `_Unset` object is not found in the `_DefaultValues` dictionary, it will default to `None` + + Args: + default: Default value if the field is not set. + default_factory: A callable to generate the default value, such as :func:`~datetime.utcnow`. + alias: The name to use for the attribute when validating or serializing by alias. + This is often used for things like converting between snake and camel case. + alias_priority: Priority of the alias. This affects whether an alias generator is used. + validation_alias: Like `alias`, but only affects validation, not serialization. + serialization_alias: Like `alias`, but only affects serialization, not validation. + title: Human-readable title. + description: Human-readable description. + examples: Example values for this field. + exclude: Whether to exclude the field from the model serialization. + discriminator: Field name or Discriminator for discriminating the type in a tagged union. + json_schema_extra: A dict or callable to provide extra JSON schema properties. + frozen: Whether the field is frozen. If true, attempts to change the value on an instance will raise an error. + validate_default: If `True`, apply validation to the default value every time you create an instance. + Otherwise, for performance reasons, the default value of the field is trusted and not validated. + repr: A boolean indicating whether to include the field in the `__repr__` output. + init: Whether the field should be included in the constructor of the dataclass. + (Only applies to dataclasses.) + init_var: Whether the field should _only_ be included in the constructor of the dataclass. + (Only applies to dataclasses.) + kw_only: Whether the field should be a keyword-only argument in the constructor of the dataclass. + (Only applies to dataclasses.) + strict: If `True`, strict validation is applied to the field. + See [Strict Mode](../concepts/strict_mode.md) for details. + gt: Greater than. If set, value must be greater than this. Only applicable to numbers. + ge: Greater than or equal. If set, value must be greater than or equal to this. Only applicable to numbers. + lt: Less than. If set, value must be less than this. Only applicable to numbers. + le: Less than or equal. If set, value must be less than or equal to this. Only applicable to numbers. + multiple_of: Value must be a multiple of this. Only applicable to numbers. + min_length: Minimum length for strings. + max_length: Maximum length for strings. + pattern: Pattern for strings (a regular expression). + allow_inf_nan: Allow `inf`, `-inf`, `nan`. Only applicable to numbers. + max_digits: Maximum number of allow digits for strings. + decimal_places: Maximum number of decimal places allowed for numbers. + union_mode: The strategy to apply when validating a union. Can be `smart` (the default), or `left_to_right`. + See [Union Mode](standard_library_types.md#union-mode) for details. + extra: (Deprecated) Extra fields that will be included in the JSON schema. + + !!! warning Deprecated + The `extra` kwargs is deprecated. Use `json_schema_extra` instead. + + Returns: + A new [`FieldInfo`][pydantic.fields.FieldInfo]. The return annotation is `Any` so `Field` can be used on + type-annotated fields without causing a type error. """ - field_info = FieldInfo( + # Check deprecated and removed params from V1. This logic should eventually be removed. + const = extra.pop('const', None) # type: ignore + if const is not None: + raise PydanticUserError('`const` is removed, use `Literal` instead', code='removed-kwargs') + + min_items = extra.pop('min_items', None) # type: ignore + if min_items is not None: + warn('`min_items` is deprecated and will be removed, use `min_length` instead', DeprecationWarning) + if min_length in (None, _Unset): + min_length = min_items # type: ignore + + max_items = extra.pop('max_items', None) # type: ignore + if max_items is not None: + warn('`max_items` is deprecated and will be removed, use `max_length` instead', DeprecationWarning) + if max_length in (None, _Unset): + max_length = max_items # type: ignore + + unique_items = extra.pop('unique_items', None) # type: ignore + if unique_items is not None: + raise PydanticUserError( + ( + '`unique_items` is removed, use `Set` instead' + '(this feature is discussed in https://github.com/pydantic/pydantic-core/issues/296)' + ), + code='removed-kwargs', + ) + + allow_mutation = extra.pop('allow_mutation', None) # type: ignore + if allow_mutation is not None: + warn('`allow_mutation` is deprecated and will be removed. use `frozen` instead', DeprecationWarning) + if allow_mutation is False: + frozen = True + + regex = extra.pop('regex', None) # type: ignore + if regex is not None: + raise PydanticUserError('`regex` is removed. use `pattern` instead', code='removed-kwargs') + + if extra: + warn( + 'Using extra keyword arguments on `Field` is deprecated and will be removed.' + ' Use `json_schema_extra` instead.' + f' (Extra keys: {", ".join(k.__repr__() for k in extra.keys())})', + DeprecationWarning, + ) + if not json_schema_extra or json_schema_extra is _Unset: + json_schema_extra = extra # type: ignore + + if ( + validation_alias + and validation_alias is not _Unset + and not isinstance(validation_alias, (str, AliasChoices, AliasPath)) + ): + raise TypeError('Invalid `validation_alias` type. it should be `str`, `AliasChoices`, or `AliasPath`') + + if serialization_alias in (_Unset, None) and isinstance(alias, str): + serialization_alias = alias + + if validation_alias in (_Unset, None): + validation_alias = alias + + include = extra.pop('include', None) # type: ignore + if include is not None: + warn('`include` is deprecated and does nothing. It will be removed, use `exclude` instead', DeprecationWarning) + + return FieldInfo.from_field( default, default_factory=default_factory, alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, title=title, description=description, + examples=examples, exclude=exclude, - include=include, - const=const, + discriminator=discriminator, + json_schema_extra=json_schema_extra, + frozen=frozen, + pattern=pattern, + validate_default=validate_default, + repr=repr, + init=init, + init_var=init_var, + kw_only=kw_only, + strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of, + min_length=min_length, + max_length=max_length, allow_inf_nan=allow_inf_nan, max_digits=max_digits, decimal_places=decimal_places, - min_items=min_items, - max_items=max_items, - unique_items=unique_items, - min_length=min_length, - max_length=max_length, - allow_mutation=allow_mutation, - regex=regex, - discriminator=discriminator, - repr=repr, - **extra, + union_mode=union_mode, ) - field_info._validate() - return field_info -# used to be an enum but changed to int's for small performance improvement as less access overhead -SHAPE_SINGLETON = 1 -SHAPE_LIST = 2 -SHAPE_SET = 3 -SHAPE_MAPPING = 4 -SHAPE_TUPLE = 5 -SHAPE_TUPLE_ELLIPSIS = 6 -SHAPE_SEQUENCE = 7 -SHAPE_FROZENSET = 8 -SHAPE_ITERABLE = 9 -SHAPE_GENERIC = 10 -SHAPE_DEQUE = 11 -SHAPE_DICT = 12 -SHAPE_DEFAULTDICT = 13 -SHAPE_COUNTER = 14 -SHAPE_NAME_LOOKUP = { - SHAPE_LIST: 'List[{}]', - SHAPE_SET: 'Set[{}]', - SHAPE_TUPLE_ELLIPSIS: 'Tuple[{}, ...]', - SHAPE_SEQUENCE: 'Sequence[{}]', - SHAPE_FROZENSET: 'FrozenSet[{}]', - SHAPE_ITERABLE: 'Iterable[{}]', - SHAPE_DEQUE: 'Deque[{}]', - SHAPE_DICT: 'Dict[{}]', - SHAPE_DEFAULTDICT: 'DefaultDict[{}]', - SHAPE_COUNTER: 'Counter[{}]', -} - -MAPPING_LIKE_SHAPES: Set[int] = {SHAPE_DEFAULTDICT, SHAPE_DICT, SHAPE_MAPPING, SHAPE_COUNTER} +_FIELD_ARG_NAMES = set(inspect.signature(Field).parameters) +_FIELD_ARG_NAMES.remove('extra') # do not include the varkwargs parameter -class ModelField(Representation): - __slots__ = ( - 'type_', - 'outer_type_', - 'annotation', - 'sub_fields', - 'sub_fields_mapping', - 'key_field', - 'validators', - 'pre_validators', - 'post_validators', - 'default', - 'default_factory', - 'required', - 'final', - 'model_config', - 'name', - 'alias', - 'has_alias', - 'field_info', - 'discriminator_key', - 'discriminator_alias', - 'validate_always', - 'allow_none', - 'shape', - 'class_validators', - 'parse_json', - ) +class ModelPrivateAttr(_repr.Representation): + """A descriptor for private attributes in class models. + + !!! warning + You generally shouldn't be creating `ModelPrivateAttr` instances directly, instead use + `pydantic.fields.PrivateAttr`. (This is similar to `FieldInfo` vs. `Field`.) + + Attributes: + default: The default value of the attribute if not provided. + default_factory: A callable function that generates the default value of the + attribute if not provided. + """ + + __slots__ = 'default', 'default_factory' def __init__( - self, - *, - name: str, - type_: Type[Any], - class_validators: Optional[Dict[str, Validator]], - model_config: Type['BaseConfig'], - default: Any = None, - default_factory: Optional[NoArgAnyCallable] = None, - required: 'BoolUndefined' = Undefined, - final: bool = False, - alias: str = None, - field_info: Optional[FieldInfo] = None, + self, default: Any = PydanticUndefined, *, default_factory: typing.Callable[[], Any] | None = None ) -> None: - - self.name: str = name - self.has_alias: bool = alias is not None - self.alias: str = alias if alias is not None else name - self.annotation = type_ - self.type_: Any = convert_generics(type_) - self.outer_type_: Any = type_ - self.class_validators = class_validators or {} - self.default: Any = default - self.default_factory: Optional[NoArgAnyCallable] = default_factory - self.required: 'BoolUndefined' = required - self.final: bool = final - self.model_config = model_config - self.field_info: FieldInfo = field_info or FieldInfo(default) - self.discriminator_key: Optional[str] = self.field_info.discriminator - self.discriminator_alias: Optional[str] = self.discriminator_key - - self.allow_none: bool = False - self.validate_always: bool = False - self.sub_fields: Optional[List[ModelField]] = None - self.sub_fields_mapping: Optional[Dict[str, 'ModelField']] = None # used for discriminated union - self.key_field: Optional[ModelField] = None - self.validators: 'ValidatorsList' = [] - self.pre_validators: Optional['ValidatorsList'] = None - self.post_validators: Optional['ValidatorsList'] = None - self.parse_json: bool = False - self.shape: int = SHAPE_SINGLETON - self.model_config.prepare_field(self) - self.prepare() - - def get_default(self) -> Any: - return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory() - - @staticmethod - def _get_field_info( - field_name: str, annotation: Any, value: Any, config: Type['BaseConfig'] - ) -> Tuple[FieldInfo, Any]: - """ - Get a FieldInfo from a root typing.Annotated annotation, value, or config default. - - The FieldInfo may be set in typing.Annotated or the value, but not both. If neither contain - a FieldInfo, a new one will be created using the config. - - :param field_name: name of the field for use in error messages - :param annotation: a type hint such as `str` or `Annotated[str, Field(..., min_length=5)]` - :param value: the field's assigned value - :param config: the model's config object - :return: the FieldInfo contained in the `annotation`, the value, or a new one from the config. - """ - field_info_from_config = config.get_field_info(field_name) - - field_info = None - if get_origin(annotation) is Annotated: - field_infos = [arg for arg in get_args(annotation)[1:] if isinstance(arg, FieldInfo)] - if len(field_infos) > 1: - raise ValueError(f'cannot specify multiple `Annotated` `Field`s for {field_name!r}') - field_info = next(iter(field_infos), None) - if field_info is not None: - field_info = copy.copy(field_info) - field_info.update_from_config(field_info_from_config) - if field_info.default not in (Undefined, Required): - raise ValueError(f'`Field` default cannot be set in `Annotated` for {field_name!r}') - if value is not Undefined and value is not Required: - # check also `Required` because of `validate_arguments` that sets `...` as default value - field_info.default = value - - if isinstance(value, FieldInfo): - if field_info is not None: - raise ValueError(f'cannot specify `Annotated` and value `Field`s together for {field_name!r}') - field_info = value - field_info.update_from_config(field_info_from_config) - elif field_info is None: - field_info = FieldInfo(value, **field_info_from_config) - value = None if field_info.default_factory is not None else field_info.default - field_info._validate() - return field_info, value - - @classmethod - def infer( - cls, - *, - name: str, - value: Any, - annotation: Any, - class_validators: Optional[Dict[str, Validator]], - config: Type['BaseConfig'], - ) -> 'ModelField': - from .schema import get_annotation_from_field_info - - field_info, value = cls._get_field_info(name, annotation, value, config) - required: 'BoolUndefined' = Undefined - if value is Required: - required = True - value = None - elif value is not Undefined: - required = False - annotation = get_annotation_from_field_info(annotation, field_info, name, config.validate_assignment) - - return cls( - name=name, - type_=annotation, - alias=field_info.alias, - class_validators=class_validators, - default=value, - default_factory=field_info.default_factory, - required=required, - model_config=config, - field_info=field_info, - ) - - def set_config(self, config: Type['BaseConfig']) -> None: - self.model_config = config - info_from_config = config.get_field_info(self.name) - config.prepare_field(self) - new_alias = info_from_config.get('alias') - new_alias_priority = info_from_config.get('alias_priority') or 0 - if new_alias and new_alias_priority >= (self.field_info.alias_priority or 0): - self.field_info.alias = new_alias - self.field_info.alias_priority = new_alias_priority - self.alias = new_alias - new_exclude = info_from_config.get('exclude') - if new_exclude is not None: - self.field_info.exclude = ValueItems.merge(self.field_info.exclude, new_exclude) - new_include = info_from_config.get('include') - if new_include is not None: - self.field_info.include = ValueItems.merge(self.field_info.include, new_include, intersect=True) - - @property - def alt_alias(self) -> bool: - return self.name != self.alias - - def prepare(self) -> None: - """ - Prepare the field but inspecting self.default, self.type_ etc. - - Note: this method is **not** idempotent (because _type_analysis is not idempotent), - e.g. calling it it multiple times may modify the field and configure it incorrectly. - """ - self._set_default_and_type() - if self.type_.__class__ is ForwardRef or self.type_.__class__ is DeferredType: - # self.type_ is currently a ForwardRef and there's nothing we can do now, - # user will need to call model.update_forward_refs() - return - - self._type_analysis() - if self.required is Undefined: - self.required = True - if self.default is Undefined and self.default_factory is None: - self.default = None - self.populate_validators() - - def _set_default_and_type(self) -> None: - """ - Set the default value, infer the type if needed and check if `None` value is valid. - """ - if self.default_factory is not None: - if self.type_ is Undefined: - raise errors_.ConfigError( - f'you need to set the type of field {self.name!r} when using `default_factory`' - ) - return - - default_value = self.get_default() - - if default_value is not None and self.type_ is Undefined: - self.type_ = default_value.__class__ - self.outer_type_ = self.type_ - self.annotation = self.type_ - - if self.type_ is Undefined: - raise errors_.ConfigError(f'unable to infer type for attribute "{self.name}"') - - if self.required is False and default_value is None: - self.allow_none = True - - def _type_analysis(self) -> None: # noqa: C901 (ignore complexity) - # typing interface is horrible, we have to do some ugly checks - if lenient_issubclass(self.type_, JsonWrapper): - self.type_ = self.type_.inner_type - self.parse_json = True - elif lenient_issubclass(self.type_, Json): - self.type_ = Any - self.parse_json = True - elif isinstance(self.type_, TypeVar): - if self.type_.__bound__: - self.type_ = self.type_.__bound__ - elif self.type_.__constraints__: - self.type_ = Union[self.type_.__constraints__] - else: - self.type_ = Any - elif is_new_type(self.type_): - self.type_ = new_type_supertype(self.type_) - - if self.type_ is Any or self.type_ is object: - if self.required is Undefined: - self.required = False - self.allow_none = True - return - elif self.type_ is Pattern or self.type_ is re.Pattern: - # python 3.7 only, Pattern is a typing object but without sub fields - return - elif is_literal_type(self.type_): - return - elif is_typeddict(self.type_): - return - - if is_finalvar(self.type_): - self.final = True - - if self.type_ is Final: - self.type_ = Any - else: - self.type_ = get_args(self.type_)[0] - - self._type_analysis() - return - - origin = get_origin(self.type_) - - if origin is Annotated or is_typeddict_special(origin): - self.type_ = get_args(self.type_)[0] - self._type_analysis() - return - - if self.discriminator_key is not None and not is_union(origin): - raise TypeError('`discriminator` can only be used with `Union` type with more than one variant') - - # add extra check for `collections.abc.Hashable` for python 3.10+ where origin is not `None` - if origin is None or origin is CollectionsHashable: - # field is not "typing" object eg. Union, Dict, List etc. - # allow None for virtual superclasses of NoneType, e.g. Hashable - if isinstance(self.type_, type) and isinstance(None, self.type_): - self.allow_none = True - return - elif origin is Callable: - return - elif is_union(origin): - types_ = [] - for type_ in get_args(self.type_): - if is_none_type(type_) or type_ is Any or type_ is object: - if self.required is Undefined: - self.required = False - self.allow_none = True - if is_none_type(type_): - continue - types_.append(type_) - - if len(types_) == 1: - # Optional[] - self.type_ = types_[0] - # this is the one case where the "outer type" isn't just the original type - self.outer_type_ = self.type_ - # re-run to correctly interpret the new self.type_ - self._type_analysis() - else: - self.sub_fields = [self._create_sub_type(t, f'{self.name}_{display_as_type(t)}') for t in types_] - - if self.discriminator_key is not None: - self.prepare_discriminated_union_sub_fields() - return - elif issubclass(origin, Tuple): # type: ignore - # origin == Tuple without item type - args = get_args(self.type_) - if not args: # plain tuple - self.type_ = Any - self.shape = SHAPE_TUPLE_ELLIPSIS - elif len(args) == 2 and args[1] is Ellipsis: # e.g. Tuple[int, ...] - self.type_ = args[0] - self.shape = SHAPE_TUPLE_ELLIPSIS - self.sub_fields = [self._create_sub_type(args[0], f'{self.name}_0')] - elif args == ((),): # Tuple[()] means empty tuple - self.shape = SHAPE_TUPLE - self.type_ = Any - self.sub_fields = [] - else: - self.shape = SHAPE_TUPLE - self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(args)] - return - elif issubclass(origin, List): - # Create self validators - get_validators = getattr(self.type_, '__get_validators__', None) - if get_validators: - self.class_validators.update( - {f'list_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())} - ) - - self.type_ = get_args(self.type_)[0] - self.shape = SHAPE_LIST - elif issubclass(origin, Set): - # Create self validators - get_validators = getattr(self.type_, '__get_validators__', None) - if get_validators: - self.class_validators.update( - {f'set_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())} - ) - - self.type_ = get_args(self.type_)[0] - self.shape = SHAPE_SET - elif issubclass(origin, FrozenSet): - # Create self validators - get_validators = getattr(self.type_, '__get_validators__', None) - if get_validators: - self.class_validators.update( - {f'frozenset_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())} - ) - - self.type_ = get_args(self.type_)[0] - self.shape = SHAPE_FROZENSET - elif issubclass(origin, Deque): - self.type_ = get_args(self.type_)[0] - self.shape = SHAPE_DEQUE - elif issubclass(origin, Sequence): - self.type_ = get_args(self.type_)[0] - self.shape = SHAPE_SEQUENCE - # priority to most common mapping: dict - elif origin is dict or origin is Dict: - self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True) - self.type_ = get_args(self.type_)[1] - self.shape = SHAPE_DICT - elif issubclass(origin, DefaultDict): - self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True) - self.type_ = get_args(self.type_)[1] - self.shape = SHAPE_DEFAULTDICT - elif issubclass(origin, Counter): - self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True) - self.type_ = int - self.shape = SHAPE_COUNTER - elif issubclass(origin, Mapping): - self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True) - self.type_ = get_args(self.type_)[1] - self.shape = SHAPE_MAPPING - # Equality check as almost everything inherits form Iterable, including str - # check for Iterable and CollectionsIterable, as it could receive one even when declared with the other - elif origin in {Iterable, CollectionsIterable}: - self.type_ = get_args(self.type_)[0] - self.shape = SHAPE_ITERABLE - self.sub_fields = [self._create_sub_type(self.type_, f'{self.name}_type')] - elif issubclass(origin, Type): # type: ignore - return - elif hasattr(origin, '__get_validators__') or self.model_config.arbitrary_types_allowed: - # Is a Pydantic-compatible generic that handles itself - # or we have arbitrary_types_allowed = True - self.shape = SHAPE_GENERIC - self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(get_args(self.type_))] - self.type_ = origin - return - else: - raise TypeError(f'Fields of type "{origin}" are not supported.') - - # type_ has been refined eg. as the type of a List and sub_fields needs to be populated - self.sub_fields = [self._create_sub_type(self.type_, '_' + self.name)] - - def prepare_discriminated_union_sub_fields(self) -> None: - """ - Prepare the mapping -> and update `sub_fields` - Note that this process can be aborted if a `ForwardRef` is encountered - """ - assert self.discriminator_key is not None - - if self.type_.__class__ is DeferredType: - return - - assert self.sub_fields is not None - sub_fields_mapping: Dict[str, 'ModelField'] = {} - all_aliases: Set[str] = set() - - for sub_field in self.sub_fields: - t = sub_field.type_ - if t.__class__ is ForwardRef: - # Stopping everything...will need to call `update_forward_refs` - return - - alias, discriminator_values = get_discriminator_alias_and_values(t, self.discriminator_key) - all_aliases.add(alias) - for discriminator_value in discriminator_values: - sub_fields_mapping[discriminator_value] = sub_field - - self.sub_fields_mapping = sub_fields_mapping - self.discriminator_alias = get_unique_discriminator_alias(all_aliases, self.discriminator_key) - - def _create_sub_type(self, type_: Type[Any], name: str, *, for_keys: bool = False) -> 'ModelField': - if for_keys: - class_validators = None - else: - # validators for sub items should not have `each_item` as we want to check only the first sublevel - class_validators = { - k: Validator( - func=v.func, - pre=v.pre, - each_item=False, - always=v.always, - check_fields=v.check_fields, - skip_on_failure=v.skip_on_failure, - ) - for k, v in self.class_validators.items() - if v.each_item - } - - field_info, _ = self._get_field_info(name, type_, None, self.model_config) - - return self.__class__( - type_=type_, - name=name, - class_validators=class_validators, - model_config=self.model_config, - field_info=field_info, - ) - - def populate_validators(self) -> None: - """ - Prepare self.pre_validators, self.validators, and self.post_validators based on self.type_'s __get_validators__ - and class validators. This method should be idempotent, e.g. it should be safe to call multiple times - without mis-configuring the field. - """ - self.validate_always = getattr(self.type_, 'validate_always', False) or any( - v.always for v in self.class_validators.values() - ) - - class_validators_ = self.class_validators.values() - if not self.sub_fields or self.shape == SHAPE_GENERIC: - get_validators = getattr(self.type_, '__get_validators__', None) - v_funcs = ( - *[v.func for v in class_validators_ if v.each_item and v.pre], - *(get_validators() if get_validators else list(find_validators(self.type_, self.model_config))), - *[v.func for v in class_validators_ if v.each_item and not v.pre], - ) - self.validators = prep_validators(v_funcs) - - self.pre_validators = [] - self.post_validators = [] - - if self.field_info and self.field_info.const: - self.post_validators.append(make_generic_validator(constant_validator)) - - if class_validators_: - self.pre_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and v.pre) - self.post_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and not v.pre) - - if self.parse_json: - self.pre_validators.append(make_generic_validator(validate_json)) - - self.pre_validators = self.pre_validators or None - self.post_validators = self.post_validators or None - - def validate( - self, v: Any, values: Dict[str, Any], *, loc: 'LocStr', cls: Optional['ModelOrDc'] = None - ) -> 'ValidateReturn': - - assert self.type_.__class__ is not DeferredType - - if self.type_.__class__ is ForwardRef: - assert cls is not None - raise ConfigError( - f'field "{self.name}" not yet prepared so type is still a ForwardRef, ' - f'you might need to call {cls.__name__}.update_forward_refs().' - ) - - errors: Optional['ErrorList'] - if self.pre_validators: - v, errors = self._apply_validators(v, values, loc, cls, self.pre_validators) - if errors: - return v, errors - - if v is None: - if is_none_type(self.type_): - # keep validating - pass - elif self.allow_none: - if self.post_validators: - return self._apply_validators(v, values, loc, cls, self.post_validators) - else: - return None, None - else: - return v, ErrorWrapper(NoneIsNotAllowedError(), loc) - - if self.shape == SHAPE_SINGLETON: - v, errors = self._validate_singleton(v, values, loc, cls) - elif self.shape in MAPPING_LIKE_SHAPES: - v, errors = self._validate_mapping_like(v, values, loc, cls) - elif self.shape == SHAPE_TUPLE: - v, errors = self._validate_tuple(v, values, loc, cls) - elif self.shape == SHAPE_ITERABLE: - v, errors = self._validate_iterable(v, values, loc, cls) - elif self.shape == SHAPE_GENERIC: - v, errors = self._apply_validators(v, values, loc, cls, self.validators) - else: - # sequence, list, set, generator, tuple with ellipsis, frozen set - v, errors = self._validate_sequence_like(v, values, loc, cls) - - if not errors and self.post_validators: - v, errors = self._apply_validators(v, values, loc, cls, self.post_validators) - return v, errors - - def _validate_sequence_like( # noqa: C901 (ignore complexity) - self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] - ) -> 'ValidateReturn': - """ - Validate sequence-like containers: lists, tuples, sets and generators - Note that large if-else blocks are necessary to enable Cython - optimization, which is why we disable the complexity check above. - """ - if not sequence_like(v): - e: errors_.PydanticTypeError - if self.shape == SHAPE_LIST: - e = errors_.ListError() - elif self.shape in (SHAPE_TUPLE, SHAPE_TUPLE_ELLIPSIS): - e = errors_.TupleError() - elif self.shape == SHAPE_SET: - e = errors_.SetError() - elif self.shape == SHAPE_FROZENSET: - e = errors_.FrozenSetError() - else: - e = errors_.SequenceError() - return v, ErrorWrapper(e, loc) - - loc = loc if isinstance(loc, tuple) else (loc,) - result = [] - errors: List[ErrorList] = [] - for i, v_ in enumerate(v): - v_loc = *loc, i - r, ee = self._validate_singleton(v_, values, v_loc, cls) - if ee: - errors.append(ee) - else: - result.append(r) - - if errors: - return v, errors - - converted: Union[List[Any], Set[Any], FrozenSet[Any], Tuple[Any, ...], Iterator[Any], Deque[Any]] = result - - if self.shape == SHAPE_SET: - converted = set(result) - elif self.shape == SHAPE_FROZENSET: - converted = frozenset(result) - elif self.shape == SHAPE_TUPLE_ELLIPSIS: - converted = tuple(result) - elif self.shape == SHAPE_DEQUE: - converted = deque(result) - elif self.shape == SHAPE_SEQUENCE: - if isinstance(v, tuple): - converted = tuple(result) - elif isinstance(v, set): - converted = set(result) - elif isinstance(v, Generator): - converted = iter(result) - elif isinstance(v, deque): - converted = deque(result) - return converted, None - - def _validate_iterable( - self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] - ) -> 'ValidateReturn': - """ - Validate Iterables. - - This intentionally doesn't validate values to allow infinite generators. - """ - - try: - iterable = iter(v) - except TypeError: - return v, ErrorWrapper(errors_.IterableError(), loc) - return iterable, None - - def _validate_tuple( - self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] - ) -> 'ValidateReturn': - e: Optional[Exception] = None - if not sequence_like(v): - e = errors_.TupleError() - else: - actual_length, expected_length = len(v), len(self.sub_fields) # type: ignore - if actual_length != expected_length: - e = errors_.TupleLengthError(actual_length=actual_length, expected_length=expected_length) - - if e: - return v, ErrorWrapper(e, loc) - - loc = loc if isinstance(loc, tuple) else (loc,) - result = [] - errors: List[ErrorList] = [] - for i, (v_, field) in enumerate(zip(v, self.sub_fields)): # type: ignore - v_loc = *loc, i - r, ee = field.validate(v_, values, loc=v_loc, cls=cls) - if ee: - errors.append(ee) - else: - result.append(r) - - if errors: - return v, errors - else: - return tuple(result), None - - def _validate_mapping_like( - self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] - ) -> 'ValidateReturn': - try: - v_iter = dict_validator(v) - except TypeError as exc: - return v, ErrorWrapper(exc, loc) - - loc = loc if isinstance(loc, tuple) else (loc,) - result, errors = {}, [] - for k, v_ in v_iter.items(): - v_loc = *loc, '__key__' - key_result, key_errors = self.key_field.validate(k, values, loc=v_loc, cls=cls) # type: ignore - if key_errors: - errors.append(key_errors) - continue - - v_loc = *loc, k - value_result, value_errors = self._validate_singleton(v_, values, v_loc, cls) - if value_errors: - errors.append(value_errors) - continue - - result[key_result] = value_result - if errors: - return v, errors - elif self.shape == SHAPE_DICT: - return result, None - elif self.shape == SHAPE_DEFAULTDICT: - return defaultdict(self.type_, result), None - elif self.shape == SHAPE_COUNTER: - return CollectionCounter(result), None - else: - return self._get_mapping_value(v, result), None - - def _get_mapping_value(self, original: T, converted: Dict[Any, Any]) -> Union[T, Dict[Any, Any]]: - """ - When type is `Mapping[KT, KV]` (or another unsupported mapping), we try to avoid - coercing to `dict` unwillingly. - """ - original_cls = original.__class__ - - if original_cls == dict or original_cls == Dict: - return converted - elif original_cls in {defaultdict, DefaultDict}: - return defaultdict(self.type_, converted) - else: - try: - # Counter, OrderedDict, UserDict, ... - return original_cls(converted) # type: ignore - except TypeError: - raise RuntimeError(f'Could not convert dictionary to {original_cls.__name__!r}') from None - - def _validate_singleton( - self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] - ) -> 'ValidateReturn': - if self.sub_fields: - if self.discriminator_key is not None: - return self._validate_discriminated_union(v, values, loc, cls) - - errors = [] - - if self.model_config.smart_union and is_union(get_origin(self.type_)): - # 1st pass: check if the value is an exact instance of one of the Union types - # (e.g. to avoid coercing a bool into an int) - for field in self.sub_fields: - if v.__class__ is field.outer_type_: - return v, None - - # 2nd pass: check if the value is an instance of any subclass of the Union types - for field in self.sub_fields: - # This whole logic will be improved later on to support more complex `isinstance` checks - # It will probably be done once a strict mode is added and be something like: - # ``` - # value, error = field.validate(v, values, strict=True) - # if error is None: - # return value, None - # ``` - try: - if isinstance(v, field.outer_type_): - return v, None - except TypeError: - # compound type - if lenient_isinstance(v, get_origin(field.outer_type_)): - value, error = field.validate(v, values, loc=loc, cls=cls) - if not error: - return value, None - - # 1st pass by default or 3rd pass with `smart_union` enabled: - # check if the value can be coerced into one of the Union types - for field in self.sub_fields: - value, error = field.validate(v, values, loc=loc, cls=cls) - if error: - errors.append(error) - else: - return value, None - return v, errors - else: - return self._apply_validators(v, values, loc, cls, self.validators) - - def _validate_discriminated_union( - self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] - ) -> 'ValidateReturn': - assert self.discriminator_key is not None - assert self.discriminator_alias is not None - - try: - discriminator_value = v[self.discriminator_alias] - except KeyError: - return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc) - except TypeError: - try: - # BaseModel or dataclass - discriminator_value = getattr(v, self.discriminator_key) - except (AttributeError, TypeError): - return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc) - - try: - sub_field = self.sub_fields_mapping[discriminator_value] # type: ignore[index] - except TypeError: - assert cls is not None - raise ConfigError( - f'field "{self.name}" not yet prepared so type is still a ForwardRef, ' - f'you might need to call {cls.__name__}.update_forward_refs().' - ) - except KeyError: - assert self.sub_fields_mapping is not None - return v, ErrorWrapper( - InvalidDiscriminator( - discriminator_key=self.discriminator_key, - discriminator_value=discriminator_value, - allowed_values=list(self.sub_fields_mapping), - ), - loc, - ) - else: - if not isinstance(loc, tuple): - loc = (loc,) - return sub_field.validate(v, values, loc=(*loc, display_as_type(sub_field.type_)), cls=cls) - - def _apply_validators( - self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'], validators: 'ValidatorsList' - ) -> 'ValidateReturn': - for validator in validators: - try: - v = validator(cls, v, values, self, self.model_config) - except (ValueError, TypeError, AssertionError) as exc: - return v, ErrorWrapper(exc, loc) - return v, None - - def is_complex(self) -> bool: - """ - Whether the field is "complex" eg. env variables should be parsed as JSON. - """ - from .main import BaseModel - - return ( - self.shape != SHAPE_SINGLETON - or hasattr(self.type_, '__pydantic_model__') - or lenient_issubclass(self.type_, (BaseModel, list, set, frozenset, dict)) - ) - - def _type_display(self) -> PyObjectStr: - t = display_as_type(self.type_) - - if self.shape in MAPPING_LIKE_SHAPES: - t = f'Mapping[{display_as_type(self.key_field.type_)}, {t}]' # type: ignore - elif self.shape == SHAPE_TUPLE: - t = 'Tuple[{}]'.format(', '.join(display_as_type(f.type_) for f in self.sub_fields)) # type: ignore - elif self.shape == SHAPE_GENERIC: - assert self.sub_fields - t = '{}[{}]'.format( - display_as_type(self.type_), ', '.join(display_as_type(f.type_) for f in self.sub_fields) - ) - elif self.shape != SHAPE_SINGLETON: - t = SHAPE_NAME_LOOKUP[self.shape].format(t) - - if self.allow_none and (self.shape != SHAPE_SINGLETON or not self.sub_fields): - t = f'Optional[{t}]' - return PyObjectStr(t) - - def __repr_args__(self) -> 'ReprArgs': - args = [('name', self.name), ('type', self._type_display()), ('required', self.required)] - - if not self.required: - if self.default_factory is not None: - args.append(('default_factory', f'')) - else: - args.append(('default', self.default)) - - if self.alt_alias: - args.append(('alias', self.alias)) - return args - - -class ModelPrivateAttr(Representation): - __slots__ = ('default', 'default_factory') - - def __init__(self, default: Any = Undefined, *, default_factory: Optional[NoArgAnyCallable] = None) -> None: self.default = default self.default_factory = default_factory + if not typing.TYPE_CHECKING: + # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access + + def __getattr__(self, item: str) -> Any: + """This function improves compatibility with custom descriptors by ensuring delegation happens + as expected when the default value of a private attribute is a descriptor. + """ + if item in {'__get__', '__set__', '__delete__'}: + if hasattr(self.default, item): + return getattr(self.default, item) + raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') + + def __set_name__(self, cls: type[Any], name: str) -> None: + """Preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487.""" + if self.default is PydanticUndefined: + return + if not hasattr(self.default, '__set_name__'): + return + set_name = self.default.__set_name__ + if callable(set_name): + set_name(cls, name) + def get_default(self) -> Any: - return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory() + """Retrieve the default value of the object. + + If `self.default_factory` is `None`, the method will return a deep copy of the `self.default` object. + + If `self.default_factory` is not `None`, it will call `self.default_factory` and return the value returned. + + Returns: + The default value of the object. + """ + return _utils.smart_deepcopy(self.default) if self.default_factory is None else self.default_factory() def __eq__(self, other: Any) -> bool: return isinstance(other, self.__class__) and (self.default, self.default_factory) == ( @@ -1213,23 +879,32 @@ class ModelPrivateAttr(Representation): def PrivateAttr( - default: Any = Undefined, + default: Any = PydanticUndefined, *, - default_factory: Optional[NoArgAnyCallable] = None, + default_factory: typing.Callable[[], Any] | None = None, ) -> Any: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/#private-model-attributes + + Indicates that an attribute is intended for private use and not handled during normal validation/serialization. + + Private attributes are not validated by Pydantic, so it's up to you to ensure they are used in a type-safe manner. + + Private attributes are stored in `__private_attributes__` on the model. + + Args: + default: The attribute's default value. Defaults to Undefined. + default_factory: Callable that will be + called when a default value is needed for this attribute. + If both `default` and `default_factory` are set, an error will be raised. + + Returns: + An instance of [`ModelPrivateAttr`][pydantic.fields.ModelPrivateAttr] class. + + Raises: + ValueError: If both `default` and `default_factory` are set. """ - Indicates that attribute is only used internally and never mixed with regular fields. - - Types or values of private attrs are not checked by pydantic and it's up to you to keep them relevant. - - Private attrs are stored in model __slots__. - - :param default: the attribute’s default value - :param default_factory: callable that will be called when a default value is needed for this attribute - If both `default` and `default_factory` are set, an error is raised. - """ - if default is not Undefined and default_factory is not None: - raise ValueError('cannot specify both default and default_factory') + if default is not PydanticUndefined and default_factory is not None: + raise TypeError('cannot specify both default and default_factory') return ModelPrivateAttr( default, @@ -1237,11 +912,243 @@ def PrivateAttr( ) -class DeferredType: - """ - Used to postpone field preparation, while creating recursive generic models. +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class ComputedFieldInfo: + """A container for data from `@computed_field` so that we can access it while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@computed_field'. + wrapped_property: The wrapped computed field property. + return_type: The type of the computed field property's return value. + alias: The alias of the property to be used during serialization. + alias_priority: The priority of the alias. This affects whether an alias generator is used. + title: Title of the computed field to include in the serialization JSON schema. + description: Description of the computed field to include in the serialization JSON schema. + examples: Example values of the computed field to include in the serialization JSON schema. + json_schema_extra: A dict or callable to provide extra JSON schema properties. + repr: A boolean indicating whether to include the field in the __repr__ output. """ + decorator_repr: ClassVar[str] = '@computed_field' + wrapped_property: property + return_type: Any + alias: str | None + alias_priority: int | None + title: str | None + description: str | None + examples: list[Any] | None + json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None + repr: bool -def is_finalvar_with_default_val(type_: Type[Any], val: Any) -> bool: - return is_finalvar(type_) and val is not Undefined and not isinstance(val, FieldInfo) + +def _wrapped_property_is_private(property_: cached_property | property) -> bool: # type: ignore + """Returns true if provided property is private, False otherwise.""" + wrapped_name: str = '' + + if isinstance(property_, property): + wrapped_name = getattr(property_.fget, '__name__', '') + elif isinstance(property_, cached_property): # type: ignore + wrapped_name = getattr(property_.func, '__name__', '') # type: ignore + + return wrapped_name.startswith('_') and not wrapped_name.startswith('__') + + +# this should really be `property[T], cached_property[T]` but property is not generic unlike cached_property +# See https://github.com/python/typing/issues/985 and linked issues +PropertyT = typing.TypeVar('PropertyT') + + +@typing.overload +def computed_field( + *, + alias: str | None = None, + alias_priority: int | None = None, + title: str | None = None, + description: str | None = None, + examples: list[Any] | None = None, + json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = None, + repr: bool = True, + return_type: Any = PydanticUndefined, +) -> typing.Callable[[PropertyT], PropertyT]: + ... + + +@typing.overload +def computed_field(__func: PropertyT) -> PropertyT: + ... + + +def computed_field( + __f: PropertyT | None = None, + *, + alias: str | None = None, + alias_priority: int | None = None, + title: str | None = None, + description: str | None = None, + examples: list[Any] | None = None, + json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = None, + repr: bool | None = None, + return_type: Any = PydanticUndefined, +) -> PropertyT | typing.Callable[[PropertyT], PropertyT]: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/fields#the-computed_field-decorator + + Decorator to include `property` and `cached_property` when serializing models or dataclasses. + + This is useful for fields that are computed from other fields, or for fields that are expensive to compute and should be cached. + + ```py + from pydantic import BaseModel, computed_field + + class Rectangle(BaseModel): + width: int + length: int + + @computed_field + @property + def area(self) -> int: + return self.width * self.length + + print(Rectangle(width=3, length=2).model_dump()) + #> {'width': 3, 'length': 2, 'area': 6} + ``` + + If applied to functions not yet decorated with `@property` or `@cached_property`, the function is + automatically wrapped with `property`. Although this is more concise, you will lose IntelliSense in your IDE, + and confuse static type checkers, thus explicit use of `@property` is recommended. + + !!! warning "Mypy Warning" + Even with the `@property` or `@cached_property` applied to your function before `@computed_field`, + mypy may throw a `Decorated property not supported` error. + See [mypy issue #1362](https://github.com/python/mypy/issues/1362), for more information. + To avoid this error message, add `# type: ignore[misc]` to the `@computed_field` line. + + [pyright](https://github.com/microsoft/pyright) supports `@computed_field` without error. + + ```py + import random + + from pydantic import BaseModel, computed_field + + class Square(BaseModel): + width: float + + @computed_field + def area(self) -> float: # converted to a `property` by `computed_field` + return round(self.width**2, 2) + + @area.setter + def area(self, new_area: float) -> None: + self.width = new_area**0.5 + + @computed_field(alias='the magic number', repr=False) + def random_number(self) -> int: + return random.randint(0, 1_000) + + square = Square(width=1.3) + + # `random_number` does not appear in representation + print(repr(square)) + #> Square(width=1.3, area=1.69) + + print(square.random_number) + #> 3 + + square.area = 4 + + print(square.model_dump_json(by_alias=True)) + #> {"width":2.0,"area":4.0,"the magic number":3} + ``` + + !!! warning "Overriding with `computed_field`" + You can't override a field from a parent class with a `computed_field` in the child class. + `mypy` complains about this behavior if allowed, and `dataclasses` doesn't allow this pattern either. + See the example below: + + ```py + from pydantic import BaseModel, computed_field + + class Parent(BaseModel): + a: str + + try: + + class Child(Parent): + @computed_field + @property + def a(self) -> str: + return 'new a' + + except ValueError as e: + print(repr(e)) + #> ValueError("you can't override a field with a computed field") + ``` + + Private properties decorated with `@computed_field` have `repr=False` by default. + + ```py + from functools import cached_property + + from pydantic import BaseModel, computed_field + + class Model(BaseModel): + foo: int + + @computed_field + @cached_property + def _private_cached_property(self) -> int: + return -self.foo + + @computed_field + @property + def _private_property(self) -> int: + return -self.foo + + m = Model(foo=1) + print(repr(m)) + #> M(foo=1) + ``` + + Args: + __f: the function to wrap. + alias: alias to use when serializing this computed field, only used when `by_alias=True` + alias_priority: priority of the alias. This affects whether an alias generator is used + title: Title to use when including this computed field in JSON Schema + description: Description to use when including this computed field in JSON Schema, defaults to the function's + docstring + examples: Example values to use when including this computed field in JSON Schema + json_schema_extra: A dict or callable to provide extra JSON schema properties. + repr: whether to include this computed field in model repr. + Default is `False` for private properties and `True` for public properties. + return_type: optional return for serialization logic to expect when serializing to JSON, if included + this must be correct, otherwise a `TypeError` is raised. + If you don't include a return type Any is used, which does runtime introspection to handle arbitrary + objects. + + Returns: + A proxy wrapper for the property. + """ + + def dec(f: Any) -> Any: + nonlocal description, return_type, alias_priority + unwrapped = _decorators.unwrap_wrapped_function(f) + if description is None and unwrapped.__doc__: + description = inspect.cleandoc(unwrapped.__doc__) + + # if the function isn't already decorated with `@property` (or another descriptor), then we wrap it now + f = _decorators.ensure_property(f) + alias_priority = (alias_priority or 2) if alias is not None else None + + if repr is None: + repr_: bool = False if _wrapped_property_is_private(property_=f) else True + else: + repr_ = repr + + dec_info = ComputedFieldInfo( + f, return_type, alias, alias_priority, title, description, examples, json_schema_extra, repr_ + ) + return _decorators.PydanticDescriptorProxy(f, dec_info) + + if __f is None: + return dec + else: + return dec(__f) diff --git a/lib/pydantic/functional_serializers.py b/lib/pydantic/functional_serializers.py new file mode 100644 index 00000000..6e31bf67 --- /dev/null +++ b/lib/pydantic/functional_serializers.py @@ -0,0 +1,395 @@ +"""This module contains related classes and functions for serialization.""" +from __future__ import annotations + +import dataclasses +from functools import partialmethod +from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, overload + +from pydantic_core import PydanticUndefined, core_schema +from pydantic_core import core_schema as _core_schema +from typing_extensions import Annotated, Literal, TypeAlias + +from . import PydanticUndefinedAnnotation +from ._internal import _decorators, _internal_dataclass +from .annotated_handlers import GetCoreSchemaHandler + + +@dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True) +class PlainSerializer: + """Plain serializers use a function to modify the output of serialization. + + This is particularly helpful when you want to customize the serialization for annotated types. + Consider an input of `list`, which will be serialized into a space-delimited string. + + ```python + from typing import List + + from typing_extensions import Annotated + + from pydantic import BaseModel, PlainSerializer + + CustomStr = Annotated[ + List, PlainSerializer(lambda x: ' '.join(x), return_type=str) + ] + + class StudentModel(BaseModel): + courses: CustomStr + + student = StudentModel(courses=['Math', 'Chemistry', 'English']) + print(student.model_dump()) + #> {'courses': 'Math Chemistry English'} + ``` + + Attributes: + func: The serializer function. + return_type: The return type for the function. If omitted it will be inferred from the type annotation. + when_used: Determines when this serializer should be used. Accepts a string with values `'always'`, + `'unless-none'`, `'json'`, and `'json-unless-none'`. Defaults to 'always'. + """ + + func: core_schema.SerializerFunction + return_type: Any = PydanticUndefined + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always' + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + """Gets the Pydantic core schema. + + Args: + source_type: The source type. + handler: The `GetCoreSchemaHandler` instance. + + Returns: + The Pydantic core schema. + """ + schema = handler(source_type) + try: + return_type = _decorators.get_function_return_type( + self.func, self.return_type, handler._get_types_namespace() + ) + except NameError as e: + raise PydanticUndefinedAnnotation.from_name_error(e) from e + return_schema = None if return_type is PydanticUndefined else handler.generate_schema(return_type) + schema['serialization'] = core_schema.plain_serializer_function_ser_schema( + function=self.func, + info_arg=_decorators.inspect_annotated_serializer(self.func, 'plain'), + return_schema=return_schema, + when_used=self.when_used, + ) + return schema + + +@dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True) +class WrapSerializer: + """Wrap serializers receive the raw inputs along with a handler function that applies the standard serialization + logic, and can modify the resulting value before returning it as the final output of serialization. + + For example, here's a scenario in which a wrap serializer transforms timezones to UTC **and** utilizes the existing `datetime` serialization logic. + + ```python + from datetime import datetime, timezone + from typing import Any, Dict + + from typing_extensions import Annotated + + from pydantic import BaseModel, WrapSerializer + + class EventDatetime(BaseModel): + start: datetime + end: datetime + + def convert_to_utc(value: Any, handler, info) -> Dict[str, datetime]: + # Note that `helper` can actually help serialize the `value` for further custom serialization in case it's a subclass. + partial_result = handler(value, info) + if info.mode == 'json': + return { + k: datetime.fromisoformat(v).astimezone(timezone.utc) + for k, v in partial_result.items() + } + return {k: v.astimezone(timezone.utc) for k, v in partial_result.items()} + + UTCEventDatetime = Annotated[EventDatetime, WrapSerializer(convert_to_utc)] + + class EventModel(BaseModel): + event_datetime: UTCEventDatetime + + dt = EventDatetime( + start='2024-01-01T07:00:00-08:00', end='2024-01-03T20:00:00+06:00' + ) + event = EventModel(event_datetime=dt) + print(event.model_dump()) + ''' + { + 'event_datetime': { + 'start': datetime.datetime( + 2024, 1, 1, 15, 0, tzinfo=datetime.timezone.utc + ), + 'end': datetime.datetime( + 2024, 1, 3, 14, 0, tzinfo=datetime.timezone.utc + ), + } + } + ''' + + print(event.model_dump_json()) + ''' + {"event_datetime":{"start":"2024-01-01T15:00:00Z","end":"2024-01-03T14:00:00Z"}} + ''' + ``` + + Attributes: + func: The serializer function to be wrapped. + return_type: The return type for the function. If omitted it will be inferred from the type annotation. + when_used: Determines when this serializer should be used. Accepts a string with values `'always'`, + `'unless-none'`, `'json'`, and `'json-unless-none'`. Defaults to 'always'. + """ + + func: core_schema.WrapSerializerFunction + return_type: Any = PydanticUndefined + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always' + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + """This method is used to get the Pydantic core schema of the class. + + Args: + source_type: Source type. + handler: Core schema handler. + + Returns: + The generated core schema of the class. + """ + schema = handler(source_type) + try: + return_type = _decorators.get_function_return_type( + self.func, self.return_type, handler._get_types_namespace() + ) + except NameError as e: + raise PydanticUndefinedAnnotation.from_name_error(e) from e + return_schema = None if return_type is PydanticUndefined else handler.generate_schema(return_type) + schema['serialization'] = core_schema.wrap_serializer_function_ser_schema( + function=self.func, + info_arg=_decorators.inspect_annotated_serializer(self.func, 'wrap'), + return_schema=return_schema, + when_used=self.when_used, + ) + return schema + + +if TYPE_CHECKING: + _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]] + _PlainSerializationFunction = Union[_core_schema.SerializerFunction, _PartialClsOrStaticMethod] + _WrapSerializationFunction = Union[_core_schema.WrapSerializerFunction, _PartialClsOrStaticMethod] + _PlainSerializeMethodType = TypeVar('_PlainSerializeMethodType', bound=_PlainSerializationFunction) + _WrapSerializeMethodType = TypeVar('_WrapSerializeMethodType', bound=_WrapSerializationFunction) + + +@overload +def field_serializer( + __field: str, + *fields: str, + return_type: Any = ..., + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ..., + check_fields: bool | None = ..., +) -> Callable[[_PlainSerializeMethodType], _PlainSerializeMethodType]: + ... + + +@overload +def field_serializer( + __field: str, + *fields: str, + mode: Literal['plain'], + return_type: Any = ..., + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ..., + check_fields: bool | None = ..., +) -> Callable[[_PlainSerializeMethodType], _PlainSerializeMethodType]: + ... + + +@overload +def field_serializer( + __field: str, + *fields: str, + mode: Literal['wrap'], + return_type: Any = ..., + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ..., + check_fields: bool | None = ..., +) -> Callable[[_WrapSerializeMethodType], _WrapSerializeMethodType]: + ... + + +def field_serializer( + *fields: str, + mode: Literal['plain', 'wrap'] = 'plain', + return_type: Any = PydanticUndefined, + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always', + check_fields: bool | None = None, +) -> Callable[[Any], Any]: + """Decorator that enables custom field serialization. + + In the below example, a field of type `set` is used to mitigate duplication. A `field_serializer` is used to serialize the data as a sorted list. + + ```python + from typing import Set + + from pydantic import BaseModel, field_serializer + + class StudentModel(BaseModel): + name: str = 'Jane' + courses: Set[str] + + @field_serializer('courses', when_used='json') + def serialize_courses_in_order(courses: Set[str]): + return sorted(courses) + + student = StudentModel(courses={'Math', 'Chemistry', 'English'}) + print(student.model_dump_json()) + #> {"name":"Jane","courses":["Chemistry","English","Math"]} + ``` + + See [Custom serializers](../concepts/serialization.md#custom-serializers) for more information. + + Four signatures are supported: + + - `(self, value: Any, info: FieldSerializationInfo)` + - `(self, value: Any, nxt: SerializerFunctionWrapHandler, info: FieldSerializationInfo)` + - `(value: Any, info: SerializationInfo)` + - `(value: Any, nxt: SerializerFunctionWrapHandler, info: SerializationInfo)` + + Args: + fields: Which field(s) the method should be called on. + mode: The serialization mode. + + - `plain` means the function will be called instead of the default serialization logic, + - `wrap` means the function will be called with an argument to optionally call the + default serialization logic. + return_type: Optional return type for the function, if omitted it will be inferred from the type annotation. + when_used: Determines the serializer will be used for serialization. + check_fields: Whether to check that the fields actually exist on the model. + + Returns: + The decorator function. + """ + + def dec( + f: Callable[..., Any] | staticmethod[Any, Any] | classmethod[Any, Any, Any], + ) -> _decorators.PydanticDescriptorProxy[Any]: + dec_info = _decorators.FieldSerializerDecoratorInfo( + fields=fields, + mode=mode, + return_type=return_type, + when_used=when_used, + check_fields=check_fields, + ) + return _decorators.PydanticDescriptorProxy(f, dec_info) + + return dec + + +FuncType = TypeVar('FuncType', bound=Callable[..., Any]) + + +@overload +def model_serializer(__f: FuncType) -> FuncType: + ... + + +@overload +def model_serializer( + *, + mode: Literal['plain', 'wrap'] = ..., + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always', + return_type: Any = ..., +) -> Callable[[FuncType], FuncType]: + ... + + +def model_serializer( + __f: Callable[..., Any] | None = None, + *, + mode: Literal['plain', 'wrap'] = 'plain', + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always', + return_type: Any = PydanticUndefined, +) -> Callable[[Any], Any]: + """Decorator that enables custom model serialization. + + This is useful when a model need to be serialized in a customized manner, allowing for flexibility beyond just specific fields. + + An example would be to serialize temperature to the same temperature scale, such as degrees Celsius. + + ```python + from typing import Literal + + from pydantic import BaseModel, model_serializer + + class TemperatureModel(BaseModel): + unit: Literal['C', 'F'] + value: int + + @model_serializer() + def serialize_model(self): + if self.unit == 'F': + return {'unit': 'C', 'value': int((self.value - 32) / 1.8)} + return {'unit': self.unit, 'value': self.value} + + temperature = TemperatureModel(unit='F', value=212) + print(temperature.model_dump()) + #> {'unit': 'C', 'value': 100} + ``` + + See [Custom serializers](../concepts/serialization.md#custom-serializers) for more information. + + Args: + __f: The function to be decorated. + mode: The serialization mode. + + - `'plain'` means the function will be called instead of the default serialization logic + - `'wrap'` means the function will be called with an argument to optionally call the default + serialization logic. + when_used: Determines when this serializer should be used. + return_type: The return type for the function. If omitted it will be inferred from the type annotation. + + Returns: + The decorator function. + """ + + def dec(f: Callable[..., Any]) -> _decorators.PydanticDescriptorProxy[Any]: + dec_info = _decorators.ModelSerializerDecoratorInfo(mode=mode, return_type=return_type, when_used=when_used) + return _decorators.PydanticDescriptorProxy(f, dec_info) + + if __f is None: + return dec + else: + return dec(__f) # type: ignore + + +AnyType = TypeVar('AnyType') + + +if TYPE_CHECKING: + SerializeAsAny = Annotated[AnyType, ...] # SerializeAsAny[list[str]] will be treated by type checkers as list[str] + """Force serialization to ignore whatever is defined in the schema and instead ask the object + itself how it should be serialized. + In particular, this means that when model subclasses are serialized, fields present in the subclass + but not in the original schema will be included. + """ +else: + + @dataclasses.dataclass(**_internal_dataclass.slots_true) + class SerializeAsAny: # noqa: D101 + def __class_getitem__(cls, item: Any) -> Any: + return Annotated[item, SerializeAsAny()] + + def __get_pydantic_core_schema__( + self, source_type: Any, handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + schema = handler(source_type) + schema_to_update = schema + while schema_to_update['type'] == 'definitions': + schema_to_update = schema_to_update.copy() + schema_to_update = schema_to_update['schema'] + schema_to_update['serialization'] = core_schema.wrap_serializer_function_ser_schema( + lambda x, h: h(x), schema=core_schema.any_schema() + ) + return schema + + __hash__ = object.__hash__ diff --git a/lib/pydantic/functional_validators.py b/lib/pydantic/functional_validators.py new file mode 100644 index 00000000..b547755b --- /dev/null +++ b/lib/pydantic/functional_validators.py @@ -0,0 +1,706 @@ +"""This module contains related classes and functions for validation.""" + +from __future__ import annotations as _annotations + +import dataclasses +import sys +from functools import partialmethod +from types import FunctionType +from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, cast, overload + +from pydantic_core import core_schema +from pydantic_core import core_schema as _core_schema +from typing_extensions import Annotated, Literal, TypeAlias + +from . import GetCoreSchemaHandler as _GetCoreSchemaHandler +from ._internal import _core_metadata, _decorators, _generics, _internal_dataclass +from .annotated_handlers import GetCoreSchemaHandler +from .errors import PydanticUserError + +if sys.version_info < (3, 11): + from typing_extensions import Protocol +else: + from typing import Protocol + +_inspect_validator = _decorators.inspect_validator + + +@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true) +class AfterValidator: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators + + A metadata class that indicates that a validation should be applied **after** the inner validation logic. + + Attributes: + func: The validator function. + + Example: + ```py + from typing_extensions import Annotated + + from pydantic import AfterValidator, BaseModel, ValidationError + + MyInt = Annotated[int, AfterValidator(lambda v: v + 1)] + + class Model(BaseModel): + a: MyInt + + print(Model(a=1).a) + #> 2 + + try: + Model(a='a') + except ValidationError as e: + print(e.json(indent=2)) + ''' + [ + { + "type": "int_parsing", + "loc": [ + "a" + ], + "msg": "Input should be a valid integer, unable to parse string as an integer", + "input": "a", + "url": "https://errors.pydantic.dev/2/v/int_parsing" + } + ] + ''' + ``` + """ + + func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction + + def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema: + schema = handler(source_type) + info_arg = _inspect_validator(self.func, 'after') + if info_arg: + func = cast(core_schema.WithInfoValidatorFunction, self.func) + return core_schema.with_info_after_validator_function(func, schema=schema, field_name=handler.field_name) + else: + func = cast(core_schema.NoInfoValidatorFunction, self.func) + return core_schema.no_info_after_validator_function(func, schema=schema) + + +@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true) +class BeforeValidator: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators + + A metadata class that indicates that a validation should be applied **before** the inner validation logic. + + Attributes: + func: The validator function. + + Example: + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, BeforeValidator + + MyInt = Annotated[int, BeforeValidator(lambda v: v + 1)] + + class Model(BaseModel): + a: MyInt + + print(Model(a=1).a) + #> 2 + + try: + Model(a='a') + except TypeError as e: + print(e) + #> can only concatenate str (not "int") to str + ``` + """ + + func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction + + def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema: + schema = handler(source_type) + info_arg = _inspect_validator(self.func, 'before') + if info_arg: + func = cast(core_schema.WithInfoValidatorFunction, self.func) + return core_schema.with_info_before_validator_function(func, schema=schema, field_name=handler.field_name) + else: + func = cast(core_schema.NoInfoValidatorFunction, self.func) + return core_schema.no_info_before_validator_function(func, schema=schema) + + +@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true) +class PlainValidator: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators + + A metadata class that indicates that a validation should be applied **instead** of the inner validation logic. + + Attributes: + func: The validator function. + + Example: + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, PlainValidator + + MyInt = Annotated[int, PlainValidator(lambda v: int(v) + 1)] + + class Model(BaseModel): + a: MyInt + + print(Model(a='1').a) + #> 2 + ``` + """ + + func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction + + def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema: + # Note that for some valid uses of PlainValidator, it is not possible to generate a core schema for the + # source_type, so calling `handler(source_type)` will error, which prevents us from generating a proper + # serialization schema. To work around this for use cases that will not involve serialization, we simply + # catch any PydanticSchemaGenerationError that may be raised while attempting to build the serialization schema + # and abort any attempts to handle special serialization. + from pydantic import PydanticSchemaGenerationError + + try: + schema = handler(source_type) + serialization = core_schema.wrap_serializer_function_ser_schema(function=lambda v, h: h(v), schema=schema) + except PydanticSchemaGenerationError: + serialization = None + + info_arg = _inspect_validator(self.func, 'plain') + if info_arg: + func = cast(core_schema.WithInfoValidatorFunction, self.func) + return core_schema.with_info_plain_validator_function( + func, field_name=handler.field_name, serialization=serialization + ) + else: + func = cast(core_schema.NoInfoValidatorFunction, self.func) + return core_schema.no_info_plain_validator_function(func, serialization=serialization) + + +@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true) +class WrapValidator: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators + + A metadata class that indicates that a validation should be applied **around** the inner validation logic. + + Attributes: + func: The validator function. + + ```py + from datetime import datetime + + from typing_extensions import Annotated + + from pydantic import BaseModel, ValidationError, WrapValidator + + def validate_timestamp(v, handler): + if v == 'now': + # we don't want to bother with further validation, just return the new value + return datetime.now() + try: + return handler(v) + except ValidationError: + # validation failed, in this case we want to return a default value + return datetime(2000, 1, 1) + + MyTimestamp = Annotated[datetime, WrapValidator(validate_timestamp)] + + class Model(BaseModel): + a: MyTimestamp + + print(Model(a='now').a) + #> 2032-01-02 03:04:05.000006 + print(Model(a='invalid').a) + #> 2000-01-01 00:00:00 + ``` + """ + + func: core_schema.NoInfoWrapValidatorFunction | core_schema.WithInfoWrapValidatorFunction + + def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema: + schema = handler(source_type) + info_arg = _inspect_validator(self.func, 'wrap') + if info_arg: + func = cast(core_schema.WithInfoWrapValidatorFunction, self.func) + return core_schema.with_info_wrap_validator_function(func, schema=schema, field_name=handler.field_name) + else: + func = cast(core_schema.NoInfoWrapValidatorFunction, self.func) + return core_schema.no_info_wrap_validator_function(func, schema=schema) + + +if TYPE_CHECKING: + + class _OnlyValueValidatorClsMethod(Protocol): + def __call__(self, cls: Any, value: Any, /) -> Any: + ... + + class _V2ValidatorClsMethod(Protocol): + def __call__(self, cls: Any, value: Any, info: _core_schema.ValidationInfo, /) -> Any: + ... + + class _V2WrapValidatorClsMethod(Protocol): + def __call__( + self, + cls: Any, + value: Any, + handler: _core_schema.ValidatorFunctionWrapHandler, + info: _core_schema.ValidationInfo, + /, + ) -> Any: + ... + + _V2Validator = Union[ + _V2ValidatorClsMethod, + _core_schema.WithInfoValidatorFunction, + _OnlyValueValidatorClsMethod, + _core_schema.NoInfoValidatorFunction, + ] + + _V2WrapValidator = Union[ + _V2WrapValidatorClsMethod, + _core_schema.WithInfoWrapValidatorFunction, + ] + + _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]] + + _V2BeforeAfterOrPlainValidatorType = TypeVar( + '_V2BeforeAfterOrPlainValidatorType', + _V2Validator, + _PartialClsOrStaticMethod, + ) + _V2WrapValidatorType = TypeVar('_V2WrapValidatorType', _V2WrapValidator, _PartialClsOrStaticMethod) + + +@overload +def field_validator( + __field: str, + *fields: str, + mode: Literal['before', 'after', 'plain'] = ..., + check_fields: bool | None = ..., +) -> Callable[[_V2BeforeAfterOrPlainValidatorType], _V2BeforeAfterOrPlainValidatorType]: + ... + + +@overload +def field_validator( + __field: str, + *fields: str, + mode: Literal['wrap'], + check_fields: bool | None = ..., +) -> Callable[[_V2WrapValidatorType], _V2WrapValidatorType]: + ... + + +FieldValidatorModes: TypeAlias = Literal['before', 'after', 'wrap', 'plain'] + + +def field_validator( + __field: str, + *fields: str, + mode: FieldValidatorModes = 'after', + check_fields: bool | None = None, +) -> Callable[[Any], Any]: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#field-validators + + Decorate methods on the class indicating that they should be used to validate fields. + + Example usage: + ```py + from typing import Any + + from pydantic import ( + BaseModel, + ValidationError, + field_validator, + ) + + class Model(BaseModel): + a: str + + @field_validator('a') + @classmethod + def ensure_foobar(cls, v: Any): + if 'foobar' not in v: + raise ValueError('"foobar" not found in a') + return v + + print(repr(Model(a='this is foobar good'))) + #> Model(a='this is foobar good') + + try: + Model(a='snap') + except ValidationError as exc_info: + print(exc_info) + ''' + 1 validation error for Model + a + Value error, "foobar" not found in a [type=value_error, input_value='snap', input_type=str] + ''' + ``` + + For more in depth examples, see [Field Validators](../concepts/validators.md#field-validators). + + Args: + __field: The first field the `field_validator` should be called on; this is separate + from `fields` to ensure an error is raised if you don't pass at least one. + *fields: Additional field(s) the `field_validator` should be called on. + mode: Specifies whether to validate the fields before or after validation. + check_fields: Whether to check that the fields actually exist on the model. + + Returns: + A decorator that can be used to decorate a function to be used as a field_validator. + + Raises: + PydanticUserError: + - If `@field_validator` is used bare (with no fields). + - If the args passed to `@field_validator` as fields are not strings. + - If `@field_validator` applied to instance methods. + """ + if isinstance(__field, FunctionType): + raise PydanticUserError( + '`@field_validator` should be used with fields and keyword arguments, not bare. ' + "E.g. usage should be `@validator('', ...)`", + code='validator-no-fields', + ) + fields = __field, *fields + if not all(isinstance(field, str) for field in fields): + raise PydanticUserError( + '`@field_validator` fields should be passed as separate string args. ' + "E.g. usage should be `@validator('', '', ...)`", + code='validator-invalid-fields', + ) + + def dec( + f: Callable[..., Any] | staticmethod[Any, Any] | classmethod[Any, Any, Any], + ) -> _decorators.PydanticDescriptorProxy[Any]: + if _decorators.is_instance_method_from_sig(f): + raise PydanticUserError( + '`@field_validator` cannot be applied to instance methods', code='validator-instance-method' + ) + + # auto apply the @classmethod decorator + f = _decorators.ensure_classmethod_based_on_signature(f) + + dec_info = _decorators.FieldValidatorDecoratorInfo(fields=fields, mode=mode, check_fields=check_fields) + return _decorators.PydanticDescriptorProxy(f, dec_info) + + return dec + + +_ModelType = TypeVar('_ModelType') +_ModelTypeCo = TypeVar('_ModelTypeCo', covariant=True) + + +class ModelWrapValidatorHandler(_core_schema.ValidatorFunctionWrapHandler, Protocol[_ModelTypeCo]): + """@model_validator decorated function handler argument type. This is used when `mode='wrap'`.""" + + def __call__( # noqa: D102 + self, + value: Any, + outer_location: str | int | None = None, + /, + ) -> _ModelTypeCo: # pragma: no cover + ... + + +class ModelWrapValidatorWithoutInfo(Protocol[_ModelType]): + """A @model_validator decorated function signature. + This is used when `mode='wrap'` and the function does not have info argument. + """ + + def __call__( # noqa: D102 + self, + cls: type[_ModelType], + # this can be a dict, a model instance + # or anything else that gets passed to validate_python + # thus validators _must_ handle all cases + value: Any, + handler: ModelWrapValidatorHandler[_ModelType], + /, + ) -> _ModelType: + ... + + +class ModelWrapValidator(Protocol[_ModelType]): + """A @model_validator decorated function signature. This is used when `mode='wrap'`.""" + + def __call__( # noqa: D102 + self, + cls: type[_ModelType], + # this can be a dict, a model instance + # or anything else that gets passed to validate_python + # thus validators _must_ handle all cases + value: Any, + handler: ModelWrapValidatorHandler[_ModelType], + info: _core_schema.ValidationInfo, + /, + ) -> _ModelType: + ... + + +class FreeModelBeforeValidatorWithoutInfo(Protocol): + """A @model_validator decorated function signature. + This is used when `mode='before'` and the function does not have info argument. + """ + + def __call__( # noqa: D102 + self, + # this can be a dict, a model instance + # or anything else that gets passed to validate_python + # thus validators _must_ handle all cases + value: Any, + /, + ) -> Any: + ... + + +class ModelBeforeValidatorWithoutInfo(Protocol): + """A @model_validator decorated function signature. + This is used when `mode='before'` and the function does not have info argument. + """ + + def __call__( # noqa: D102 + self, + cls: Any, + # this can be a dict, a model instance + # or anything else that gets passed to validate_python + # thus validators _must_ handle all cases + value: Any, + /, + ) -> Any: + ... + + +class FreeModelBeforeValidator(Protocol): + """A `@model_validator` decorated function signature. This is used when `mode='before'`.""" + + def __call__( # noqa: D102 + self, + # this can be a dict, a model instance + # or anything else that gets passed to validate_python + # thus validators _must_ handle all cases + value: Any, + info: _core_schema.ValidationInfo, + /, + ) -> Any: + ... + + +class ModelBeforeValidator(Protocol): + """A `@model_validator` decorated function signature. This is used when `mode='before'`.""" + + def __call__( # noqa: D102 + self, + cls: Any, + # this can be a dict, a model instance + # or anything else that gets passed to validate_python + # thus validators _must_ handle all cases + value: Any, + info: _core_schema.ValidationInfo, + /, + ) -> Any: + ... + + +ModelAfterValidatorWithoutInfo = Callable[[_ModelType], _ModelType] +"""A `@model_validator` decorated function signature. This is used when `mode='after'` and the function does not +have info argument. +""" + +ModelAfterValidator = Callable[[_ModelType, _core_schema.ValidationInfo], _ModelType] +"""A `@model_validator` decorated function signature. This is used when `mode='after'`.""" + +_AnyModelWrapValidator = Union[ModelWrapValidator[_ModelType], ModelWrapValidatorWithoutInfo[_ModelType]] +_AnyModeBeforeValidator = Union[ + FreeModelBeforeValidator, ModelBeforeValidator, FreeModelBeforeValidatorWithoutInfo, ModelBeforeValidatorWithoutInfo +] +_AnyModelAfterValidator = Union[ModelAfterValidator[_ModelType], ModelAfterValidatorWithoutInfo[_ModelType]] + + +@overload +def model_validator( + *, + mode: Literal['wrap'], +) -> Callable[ + [_AnyModelWrapValidator[_ModelType]], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo] +]: + ... + + +@overload +def model_validator( + *, + mode: Literal['before'], +) -> Callable[[_AnyModeBeforeValidator], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo]]: + ... + + +@overload +def model_validator( + *, + mode: Literal['after'], +) -> Callable[ + [_AnyModelAfterValidator[_ModelType]], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo] +]: + ... + + +def model_validator( + *, + mode: Literal['wrap', 'before', 'after'], +) -> Any: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#model-validators + + Decorate model methods for validation purposes. + + Example usage: + ```py + from typing_extensions import Self + + from pydantic import BaseModel, ValidationError, model_validator + + class Square(BaseModel): + width: float + height: float + + @model_validator(mode='after') + def verify_square(self) -> Self: + if self.width != self.height: + raise ValueError('width and height do not match') + return self + + s = Square(width=1, height=1) + print(repr(s)) + #> Square(width=1.0, height=1.0) + + try: + Square(width=1, height=2) + except ValidationError as e: + print(e) + ''' + 1 validation error for Square + Value error, width and height do not match [type=value_error, input_value={'width': 1, 'height': 2}, input_type=dict] + ''' + ``` + + For more in depth examples, see [Model Validators](../concepts/validators.md#model-validators). + + Args: + mode: A required string literal that specifies the validation mode. + It can be one of the following: 'wrap', 'before', or 'after'. + + Returns: + A decorator that can be used to decorate a function to be used as a model validator. + """ + + def dec(f: Any) -> _decorators.PydanticDescriptorProxy[Any]: + # auto apply the @classmethod decorator + f = _decorators.ensure_classmethod_based_on_signature(f) + dec_info = _decorators.ModelValidatorDecoratorInfo(mode=mode) + return _decorators.PydanticDescriptorProxy(f, dec_info) + + return dec + + +AnyType = TypeVar('AnyType') + + +if TYPE_CHECKING: + # If we add configurable attributes to IsInstance, we'd probably need to stop hiding it from type checkers like this + InstanceOf = Annotated[AnyType, ...] # `IsInstance[Sequence]` will be recognized by type checkers as `Sequence` + +else: + + @dataclasses.dataclass(**_internal_dataclass.slots_true) + class InstanceOf: + '''Generic type for annotating a type that is an instance of a given class. + + Example: + ```py + from pydantic import BaseModel, InstanceOf + + class Foo: + ... + + class Bar(BaseModel): + foo: InstanceOf[Foo] + + Bar(foo=Foo()) + try: + Bar(foo=42) + except ValidationError as e: + print(e) + """ + [ + │ { + │ │ 'type': 'is_instance_of', + │ │ 'loc': ('foo',), + │ │ 'msg': 'Input should be an instance of Foo', + │ │ 'input': 42, + │ │ 'ctx': {'class': 'Foo'}, + │ │ 'url': 'https://errors.pydantic.dev/0.38.0/v/is_instance_of' + │ } + ] + """ + ``` + ''' + + @classmethod + def __class_getitem__(cls, item: AnyType) -> AnyType: + return Annotated[item, cls()] + + @classmethod + def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + from pydantic import PydanticSchemaGenerationError + + # use the generic _origin_ as the second argument to isinstance when appropriate + instance_of_schema = core_schema.is_instance_schema(_generics.get_origin(source) or source) + + try: + # Try to generate the "standard" schema, which will be used when loading from JSON + original_schema = handler(source) + except PydanticSchemaGenerationError: + # If that fails, just produce a schema that can validate from python + return instance_of_schema + else: + # Use the "original" approach to serialization + instance_of_schema['serialization'] = core_schema.wrap_serializer_function_ser_schema( + function=lambda v, h: h(v), schema=original_schema + ) + return core_schema.json_or_python_schema(python_schema=instance_of_schema, json_schema=original_schema) + + __hash__ = object.__hash__ + + +if TYPE_CHECKING: + SkipValidation = Annotated[AnyType, ...] # SkipValidation[list[str]] will be treated by type checkers as list[str] +else: + + @dataclasses.dataclass(**_internal_dataclass.slots_true) + class SkipValidation: + """If this is applied as an annotation (e.g., via `x: Annotated[int, SkipValidation]`), validation will be + skipped. You can also use `SkipValidation[int]` as a shorthand for `Annotated[int, SkipValidation]`. + + This can be useful if you want to use a type annotation for documentation/IDE/type-checking purposes, + and know that it is safe to skip validation for one or more of the fields. + + Because this converts the validation schema to `any_schema`, subsequent annotation-applied transformations + may not have the expected effects. Therefore, when used, this annotation should generally be the final + annotation applied to a type. + """ + + def __class_getitem__(cls, item: Any) -> Any: + return Annotated[item, SkipValidation()] + + @classmethod + def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + original_schema = handler(source) + metadata = _core_metadata.build_metadata_dict(js_annotation_functions=[lambda _c, h: h(original_schema)]) + return core_schema.any_schema( + metadata=metadata, + serialization=core_schema.wrap_serializer_function_ser_schema( + function=lambda v, h: h(v), schema=original_schema + ), + ) + + __hash__ = object.__hash__ diff --git a/lib/pydantic/generics.py b/lib/pydantic/generics.py index a3f52bfe..5f6f7f7a 100644 --- a/lib/pydantic/generics.py +++ b/lib/pydantic/generics.py @@ -1,364 +1,4 @@ -import sys -import typing -from typing import ( - TYPE_CHECKING, - Any, - ClassVar, - Dict, - Generic, - Iterator, - List, - Mapping, - Optional, - Tuple, - Type, - TypeVar, - Union, - cast, -) +"""The `generics` module is a backport module from V1.""" +from ._migration import getattr_migration -from typing_extensions import Annotated - -from .class_validators import gather_all_validators -from .fields import DeferredType -from .main import BaseModel, create_model -from .types import JsonWrapper -from .typing import display_as_type, get_all_type_hints, get_args, get_origin, typing_base -from .utils import LimitedDict, all_identical, lenient_issubclass - -GenericModelT = TypeVar('GenericModelT', bound='GenericModel') -TypeVarType = Any # since mypy doesn't allow the use of TypeVar as a type - -Parametrization = Mapping[TypeVarType, Type[Any]] - -_generic_types_cache: LimitedDict[Tuple[Type[Any], Union[Any, Tuple[Any, ...]]], Type[BaseModel]] = LimitedDict() -# _assigned_parameters is a Mapping from parametrized version of generic models to assigned types of parametrizations -# as captured during construction of the class (not instances). -# E.g., for generic model `Model[A, B]`, when parametrized model `Model[int, str]` is created, -# `Model[int, str]`: {A: int, B: str}` will be stored in `_assigned_parameters`. -# (This information is only otherwise available after creation from the class name string). -_assigned_parameters: LimitedDict[Type[Any], Parametrization] = LimitedDict() - - -class GenericModel(BaseModel): - __slots__ = () - __concrete__: ClassVar[bool] = False - - if TYPE_CHECKING: - # Putting this in a TYPE_CHECKING block allows us to replace `if Generic not in cls.__bases__` with - # `not hasattr(cls, "__parameters__")`. This means we don't need to force non-concrete subclasses of - # `GenericModel` to also inherit from `Generic`, which would require changes to the use of `create_model` below. - __parameters__: ClassVar[Tuple[TypeVarType, ...]] - - # Setting the return type as Type[Any] instead of Type[BaseModel] prevents PyCharm warnings - def __class_getitem__(cls: Type[GenericModelT], params: Union[Type[Any], Tuple[Type[Any], ...]]) -> Type[Any]: - """Instantiates a new class from a generic class `cls` and type variables `params`. - - :param params: Tuple of types the class . Given a generic class - `Model` with 2 type variables and a concrete model `Model[str, int]`, - the value `(str, int)` would be passed to `params`. - :return: New model class inheriting from `cls` with instantiated - types described by `params`. If no parameters are given, `cls` is - returned as is. - - """ - - def _cache_key(_params: Any) -> Tuple[Type[GenericModelT], Any, Tuple[Any, ...]]: - return cls, _params, get_args(_params) - - cached = _generic_types_cache.get(_cache_key(params)) - if cached is not None: - return cached - if cls.__concrete__ and Generic not in cls.__bases__: - raise TypeError('Cannot parameterize a concrete instantiation of a generic model') - if not isinstance(params, tuple): - params = (params,) - if cls is GenericModel and any(isinstance(param, TypeVar) for param in params): - raise TypeError('Type parameters should be placed on typing.Generic, not GenericModel') - if not hasattr(cls, '__parameters__'): - raise TypeError(f'Type {cls.__name__} must inherit from typing.Generic before being parameterized') - - check_parameters_count(cls, params) - # Build map from generic typevars to passed params - typevars_map: Dict[TypeVarType, Type[Any]] = dict(zip(cls.__parameters__, params)) - if all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map: - return cls # if arguments are equal to parameters it's the same object - - # Create new model with original model as parent inserting fields with DeferredType. - model_name = cls.__concrete_name__(params) - validators = gather_all_validators(cls) - - type_hints = get_all_type_hints(cls).items() - instance_type_hints = {k: v for k, v in type_hints if get_origin(v) is not ClassVar} - - fields = {k: (DeferredType(), cls.__fields__[k].field_info) for k in instance_type_hints if k in cls.__fields__} - - model_module, called_globally = get_caller_frame_info() - created_model = cast( - Type[GenericModel], # casting ensures mypy is aware of the __concrete__ and __parameters__ attributes - create_model( - model_name, - __module__=model_module or cls.__module__, - __base__=(cls,) + tuple(cls.__parameterized_bases__(typevars_map)), - __config__=None, - __validators__=validators, - __cls_kwargs__=None, - **fields, - ), - ) - - _assigned_parameters[created_model] = typevars_map - - if called_globally: # create global reference and therefore allow pickling - object_by_reference = None - reference_name = model_name - reference_module_globals = sys.modules[created_model.__module__].__dict__ - while object_by_reference is not created_model: - object_by_reference = reference_module_globals.setdefault(reference_name, created_model) - reference_name += '_' - - created_model.Config = cls.Config - - # Find any typevars that are still present in the model. - # If none are left, the model is fully "concrete", otherwise the new - # class is a generic class as well taking the found typevars as - # parameters. - new_params = tuple( - {param: None for param in iter_contained_typevars(typevars_map.values())} - ) # use dict as ordered set - created_model.__concrete__ = not new_params - if new_params: - created_model.__parameters__ = new_params - - # Save created model in cache so we don't end up creating duplicate - # models that should be identical. - _generic_types_cache[_cache_key(params)] = created_model - if len(params) == 1: - _generic_types_cache[_cache_key(params[0])] = created_model - - # Recursively walk class type hints and replace generic typevars - # with concrete types that were passed. - _prepare_model_fields(created_model, fields, instance_type_hints, typevars_map) - - return created_model - - @classmethod - def __concrete_name__(cls: Type[Any], params: Tuple[Type[Any], ...]) -> str: - """Compute class name for child classes. - - :param params: Tuple of types the class . Given a generic class - `Model` with 2 type variables and a concrete model `Model[str, int]`, - the value `(str, int)` would be passed to `params`. - :return: String representing a the new class where `params` are - passed to `cls` as type variables. - - This method can be overridden to achieve a custom naming scheme for GenericModels. - """ - param_names = [display_as_type(param) for param in params] - params_component = ', '.join(param_names) - return f'{cls.__name__}[{params_component}]' - - @classmethod - def __parameterized_bases__(cls, typevars_map: Parametrization) -> Iterator[Type[Any]]: - """ - Returns unbound bases of cls parameterised to given type variables - - :param typevars_map: Dictionary of type applications for binding subclasses. - Given a generic class `Model` with 2 type variables [S, T] - and a concrete model `Model[str, int]`, - the value `{S: str, T: int}` would be passed to `typevars_map`. - :return: an iterator of generic sub classes, parameterised by `typevars_map` - and other assigned parameters of `cls` - - e.g.: - ``` - class A(GenericModel, Generic[T]): - ... - - class B(A[V], Generic[V]): - ... - - assert A[int] in B.__parameterized_bases__({V: int}) - ``` - """ - - def build_base_model( - base_model: Type[GenericModel], mapped_types: Parametrization - ) -> Iterator[Type[GenericModel]]: - base_parameters = tuple(mapped_types[param] for param in base_model.__parameters__) - parameterized_base = base_model.__class_getitem__(base_parameters) - if parameterized_base is base_model or parameterized_base is cls: - # Avoid duplication in MRO - return - yield parameterized_base - - for base_model in cls.__bases__: - if not issubclass(base_model, GenericModel): - # not a class that can be meaningfully parameterized - continue - elif not getattr(base_model, '__parameters__', None): - # base_model is "GenericModel" (and has no __parameters__) - # or - # base_model is already concrete, and will be included transitively via cls. - continue - elif cls in _assigned_parameters: - if base_model in _assigned_parameters: - # cls is partially parameterised but not from base_model - # e.g. cls = B[S], base_model = A[S] - # B[S][int] should subclass A[int], (and will be transitively via B[int]) - # but it's not viable to consistently subclass types with arbitrary construction - # So don't attempt to include A[S][int] - continue - else: # base_model not in _assigned_parameters: - # cls is partially parameterized, base_model is original generic - # e.g. cls = B[str, T], base_model = B[S, T] - # Need to determine the mapping for the base_model parameters - mapped_types: Parametrization = { - key: typevars_map.get(value, value) for key, value in _assigned_parameters[cls].items() - } - yield from build_base_model(base_model, mapped_types) - else: - # cls is base generic, so base_class has a distinct base - # can construct the Parameterised base model using typevars_map directly - yield from build_base_model(base_model, typevars_map) - - -def replace_types(type_: Any, type_map: Mapping[Any, Any]) -> Any: - """Return type with all occurrences of `type_map` keys recursively replaced with their values. - - :param type_: Any type, class or generic alias - :param type_map: Mapping from `TypeVar` instance to concrete types. - :return: New type representing the basic structure of `type_` with all - `typevar_map` keys recursively replaced. - - >>> replace_types(Tuple[str, Union[List[str], float]], {str: int}) - Tuple[int, Union[List[int], float]] - - """ - if not type_map: - return type_ - - type_args = get_args(type_) - origin_type = get_origin(type_) - - if origin_type is Annotated: - annotated_type, *annotations = type_args - return Annotated[replace_types(annotated_type, type_map), tuple(annotations)] - - # Having type args is a good indicator that this is a typing module - # class instantiation or a generic alias of some sort. - if type_args: - resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args) - if all_identical(type_args, resolved_type_args): - # If all arguments are the same, there is no need to modify the - # type or create a new object at all - return type_ - if ( - origin_type is not None - and isinstance(type_, typing_base) - and not isinstance(origin_type, typing_base) - and getattr(type_, '_name', None) is not None - ): - # In python < 3.9 generic aliases don't exist so any of these like `list`, - # `type` or `collections.abc.Callable` need to be translated. - # See: https://www.python.org/dev/peps/pep-0585 - origin_type = getattr(typing, type_._name) - assert origin_type is not None - return origin_type[resolved_type_args] - - # We handle pydantic generic models separately as they don't have the same - # semantics as "typing" classes or generic aliases - if not origin_type and lenient_issubclass(type_, GenericModel) and not type_.__concrete__: - type_args = type_.__parameters__ - resolved_type_args = tuple(replace_types(t, type_map) for t in type_args) - if all_identical(type_args, resolved_type_args): - return type_ - return type_[resolved_type_args] - - # Handle special case for typehints that can have lists as arguments. - # `typing.Callable[[int, str], int]` is an example for this. - if isinstance(type_, (List, list)): - resolved_list = list(replace_types(element, type_map) for element in type_) - if all_identical(type_, resolved_list): - return type_ - return resolved_list - - # For JsonWrapperValue, need to handle its inner type to allow correct parsing - # of generic Json arguments like Json[T] - if not origin_type and lenient_issubclass(type_, JsonWrapper): - type_.inner_type = replace_types(type_.inner_type, type_map) - return type_ - - # If all else fails, we try to resolve the type directly and otherwise just - # return the input with no modifications. - return type_map.get(type_, type_) - - -def check_parameters_count(cls: Type[GenericModel], parameters: Tuple[Any, ...]) -> None: - actual = len(parameters) - expected = len(cls.__parameters__) - if actual != expected: - description = 'many' if actual > expected else 'few' - raise TypeError(f'Too {description} parameters for {cls.__name__}; actual {actual}, expected {expected}') - - -DictValues: Type[Any] = {}.values().__class__ - - -def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]: - """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found.""" - if isinstance(v, TypeVar): - yield v - elif hasattr(v, '__parameters__') and not get_origin(v) and lenient_issubclass(v, GenericModel): - yield from v.__parameters__ - elif isinstance(v, (DictValues, list)): - for var in v: - yield from iter_contained_typevars(var) - else: - args = get_args(v) - for arg in args: - yield from iter_contained_typevars(arg) - - -def get_caller_frame_info() -> Tuple[Optional[str], bool]: - """ - Used inside a function to check whether it was called globally - - Will only work against non-compiled code, therefore used only in pydantic.generics - - :returns Tuple[module_name, called_globally] - """ - try: - previous_caller_frame = sys._getframe(2) - except ValueError as e: - raise RuntimeError('This function must be used inside another function') from e - except AttributeError: # sys module does not have _getframe function, so there's nothing we can do about it - return None, False - frame_globals = previous_caller_frame.f_globals - return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals - - -def _prepare_model_fields( - created_model: Type[GenericModel], - fields: Mapping[str, Any], - instance_type_hints: Mapping[str, type], - typevars_map: Mapping[Any, type], -) -> None: - """ - Replace DeferredType fields with concrete type hints and prepare them. - """ - - for key, field in created_model.__fields__.items(): - if key not in fields: - assert field.type_.__class__ is not DeferredType - # https://github.com/nedbat/coveragepy/issues/198 - continue # pragma: no cover - - assert field.type_.__class__ is DeferredType, field.type_.__class__ - - field_type_hint = instance_type_hints[key] - concrete_type = replace_types(field_type_hint, typevars_map) - field.type_ = concrete_type - field.outer_type_ = concrete_type - field.prepare() - created_model.__annotations__[key] = concrete_type +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/json.py b/lib/pydantic/json.py index b358b850..020fb6d2 100644 --- a/lib/pydantic/json.py +++ b/lib/pydantic/json.py @@ -1,112 +1,4 @@ -import datetime -from collections import deque -from decimal import Decimal -from enum import Enum -from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network -from pathlib import Path -from re import Pattern -from types import GeneratorType -from typing import Any, Callable, Dict, Type, Union -from uuid import UUID +"""The `json` module is a backport module from V1.""" +from ._migration import getattr_migration -from .color import Color -from .networks import NameEmail -from .types import SecretBytes, SecretStr - -__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat' - - -def isoformat(o: Union[datetime.date, datetime.time]) -> str: - return o.isoformat() - - -def decimal_encoder(dec_value: Decimal) -> Union[int, float]: - """ - Encodes a Decimal as int of there's no exponent, otherwise float - - This is useful when we use ConstrainedDecimal to represent Numeric(x,0) - where a integer (but not int typed) is used. Encoding this as a float - results in failed round-tripping between encode and parse. - Our Id type is a prime example of this. - - >>> decimal_encoder(Decimal("1.0")) - 1.0 - - >>> decimal_encoder(Decimal("1")) - 1 - """ - if dec_value.as_tuple().exponent >= 0: - return int(dec_value) - else: - return float(dec_value) - - -ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = { - bytes: lambda o: o.decode(), - Color: str, - datetime.date: isoformat, - datetime.datetime: isoformat, - datetime.time: isoformat, - datetime.timedelta: lambda td: td.total_seconds(), - Decimal: decimal_encoder, - Enum: lambda o: o.value, - frozenset: list, - deque: list, - GeneratorType: list, - IPv4Address: str, - IPv4Interface: str, - IPv4Network: str, - IPv6Address: str, - IPv6Interface: str, - IPv6Network: str, - NameEmail: str, - Path: str, - Pattern: lambda o: o.pattern, - SecretBytes: str, - SecretStr: str, - set: list, - UUID: str, -} - - -def pydantic_encoder(obj: Any) -> Any: - from dataclasses import asdict, is_dataclass - - from .main import BaseModel - - if isinstance(obj, BaseModel): - return obj.dict() - elif is_dataclass(obj): - return asdict(obj) - - # Check the class type and its superclasses for a matching encoder - for base in obj.__class__.__mro__[:-1]: - try: - encoder = ENCODERS_BY_TYPE[base] - except KeyError: - continue - return encoder(obj) - else: # We have exited the for loop without finding a suitable encoder - raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable") - - -def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any: - # Check the class type and its superclasses for a matching encoder - for base in obj.__class__.__mro__[:-1]: - try: - encoder = type_encoders[base] - except KeyError: - continue - - return encoder(obj) - else: # We have exited the for loop without finding a suitable encoder - return pydantic_encoder(obj) - - -def timedelta_isoformat(td: datetime.timedelta) -> str: - """ - ISO 8601 encoding for Python timedelta object. - """ - minutes, seconds = divmod(td.seconds, 60) - hours, minutes = divmod(minutes, 60) - return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S' +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/json_schema.py b/lib/pydantic/json_schema.py new file mode 100644 index 00000000..eee9e60e --- /dev/null +++ b/lib/pydantic/json_schema.py @@ -0,0 +1,2425 @@ +""" +Usage docs: https://docs.pydantic.dev/2.5/concepts/json_schema/ + +The `json_schema` module contains classes and functions to allow the way [JSON Schema](https://json-schema.org/) +is generated to be customized. + +In general you shouldn't need to use this module directly; instead, you can +[`BaseModel.model_json_schema`][pydantic.BaseModel.model_json_schema] and +[`TypeAdapter.json_schema`][pydantic.TypeAdapter.json_schema]. +""" +from __future__ import annotations as _annotations + +import dataclasses +import inspect +import math +import re +import warnings +from collections import defaultdict +from copy import deepcopy +from dataclasses import is_dataclass +from enum import Enum +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Counter, + Dict, + Hashable, + Iterable, + NewType, + Sequence, + Tuple, + TypeVar, + Union, + cast, +) + +import pydantic_core +from pydantic_core import CoreSchema, PydanticOmit, core_schema, to_jsonable_python +from pydantic_core.core_schema import ComputedField +from typing_extensions import Annotated, Literal, TypeAlias, assert_never, deprecated, final + +from pydantic.warnings import PydanticDeprecatedSince26 + +from ._internal import ( + _config, + _core_metadata, + _core_utils, + _decorators, + _internal_dataclass, + _mock_val_ser, + _schema_generation_shared, + _typing_extra, +) +from .annotated_handlers import GetJsonSchemaHandler +from .config import JsonDict, JsonSchemaExtraCallable, JsonValue +from .errors import PydanticInvalidForJsonSchema, PydanticUserError + +if TYPE_CHECKING: + from . import ConfigDict + from ._internal._core_utils import CoreSchemaField, CoreSchemaOrField + from ._internal._dataclasses import PydanticDataclass + from ._internal._schema_generation_shared import GetJsonSchemaFunction + from .main import BaseModel + + +CoreSchemaOrFieldType = Literal[core_schema.CoreSchemaType, core_schema.CoreSchemaFieldType] +""" +A type alias for defined schema types that represents a union of +`core_schema.CoreSchemaType` and +`core_schema.CoreSchemaFieldType`. +""" + +JsonSchemaValue = Dict[str, Any] +""" +A type alias for a JSON schema value. This is a dictionary of string keys to arbitrary JSON values. +""" + +JsonSchemaMode = Literal['validation', 'serialization'] +""" +A type alias that represents the mode of a JSON schema; either 'validation' or 'serialization'. + +For some types, the inputs to validation differ from the outputs of serialization. For example, +computed fields will only be present when serializing, and should not be provided when +validating. This flag provides a way to indicate whether you want the JSON schema required +for validation inputs, or that will be matched by serialization outputs. +""" + +_MODE_TITLE_MAPPING: dict[JsonSchemaMode, str] = {'validation': 'Input', 'serialization': 'Output'} + + +def update_json_schema(schema: JsonSchemaValue, updates: dict[str, Any]) -> JsonSchemaValue: + """Update a JSON schema in-place by providing a dictionary of updates. + + This function sets the provided key-value pairs in the schema and returns the updated schema. + + Args: + schema: The JSON schema to update. + updates: A dictionary of key-value pairs to set in the schema. + + Returns: + The updated JSON schema. + """ + schema.update(updates) + return schema + + +JsonSchemaWarningKind = Literal['skipped-choice', 'non-serializable-default'] +""" +A type alias representing the kinds of warnings that can be emitted during JSON schema generation. + +See [`GenerateJsonSchema.render_warning_message`][pydantic.json_schema.GenerateJsonSchema.render_warning_message] +for more details. +""" + + +class PydanticJsonSchemaWarning(UserWarning): + """This class is used to emit warnings produced during JSON schema generation. + See the [`GenerateJsonSchema.emit_warning`][pydantic.json_schema.GenerateJsonSchema.emit_warning] and + [`GenerateJsonSchema.render_warning_message`][pydantic.json_schema.GenerateJsonSchema.render_warning_message] + methods for more details; these can be overridden to control warning behavior. + """ + + +# ##### JSON Schema Generation ##### +DEFAULT_REF_TEMPLATE = '#/$defs/{model}' +"""The default format string used to generate reference names.""" + +# There are three types of references relevant to building JSON schemas: +# 1. core_schema "ref" values; these are not exposed as part of the JSON schema +# * these might look like the fully qualified path of a model, its id, or something similar +CoreRef = NewType('CoreRef', str) +# 2. keys of the "definitions" object that will eventually go into the JSON schema +# * by default, these look like "MyModel", though may change in the presence of collisions +# * eventually, we may want to make it easier to modify the way these names are generated +DefsRef = NewType('DefsRef', str) +# 3. the values corresponding to the "$ref" key in the schema +# * By default, these look like "#/$defs/MyModel", as in {"$ref": "#/$defs/MyModel"} +JsonRef = NewType('JsonRef', str) + +CoreModeRef = Tuple[CoreRef, JsonSchemaMode] +JsonSchemaKeyT = TypeVar('JsonSchemaKeyT', bound=Hashable) + + +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class _DefinitionsRemapping: + defs_remapping: dict[DefsRef, DefsRef] + json_remapping: dict[JsonRef, JsonRef] + + @staticmethod + def from_prioritized_choices( + prioritized_choices: dict[DefsRef, list[DefsRef]], + defs_to_json: dict[DefsRef, JsonRef], + definitions: dict[DefsRef, JsonSchemaValue], + ) -> _DefinitionsRemapping: + """ + This function should produce a remapping that replaces complex DefsRef with the simpler ones from the + prioritized_choices such that applying the name remapping would result in an equivalent JSON schema. + """ + # We need to iteratively simplify the definitions until we reach a fixed point. + # The reason for this is that outer definitions may reference inner definitions that get simplified + # into an equivalent reference, and the outer definitions won't be equivalent until we've simplified + # the inner definitions. + copied_definitions = deepcopy(definitions) + definitions_schema = {'$defs': copied_definitions} + for _iter in range(100): # prevent an infinite loop in the case of a bug, 100 iterations should be enough + # For every possible remapped DefsRef, collect all schemas that that DefsRef might be used for: + schemas_for_alternatives: dict[DefsRef, list[JsonSchemaValue]] = defaultdict(list) + for defs_ref in copied_definitions: + alternatives = prioritized_choices[defs_ref] + for alternative in alternatives: + schemas_for_alternatives[alternative].append(copied_definitions[defs_ref]) + + # Deduplicate the schemas for each alternative; the idea is that we only want to remap to a new DefsRef + # if it introduces no ambiguity, i.e., there is only one distinct schema for that DefsRef. + for defs_ref, schemas in schemas_for_alternatives.items(): + schemas_for_alternatives[defs_ref] = _deduplicate_schemas(schemas_for_alternatives[defs_ref]) + + # Build the remapping + defs_remapping: dict[DefsRef, DefsRef] = {} + json_remapping: dict[JsonRef, JsonRef] = {} + for original_defs_ref in definitions: + alternatives = prioritized_choices[original_defs_ref] + # Pick the first alternative that has only one schema, since that means there is no collision + remapped_defs_ref = next(x for x in alternatives if len(schemas_for_alternatives[x]) == 1) + defs_remapping[original_defs_ref] = remapped_defs_ref + json_remapping[defs_to_json[original_defs_ref]] = defs_to_json[remapped_defs_ref] + remapping = _DefinitionsRemapping(defs_remapping, json_remapping) + new_definitions_schema = remapping.remap_json_schema({'$defs': copied_definitions}) + if definitions_schema == new_definitions_schema: + # We've reached the fixed point + return remapping + definitions_schema = new_definitions_schema + + raise PydanticInvalidForJsonSchema('Failed to simplify the JSON schema definitions') + + def remap_defs_ref(self, ref: DefsRef) -> DefsRef: + return self.defs_remapping.get(ref, ref) + + def remap_json_ref(self, ref: JsonRef) -> JsonRef: + return self.json_remapping.get(ref, ref) + + def remap_json_schema(self, schema: Any) -> Any: + """ + Recursively update the JSON schema replacing all $refs + """ + if isinstance(schema, str): + # Note: this may not really be a JsonRef; we rely on having no collisions between JsonRefs and other strings + return self.remap_json_ref(JsonRef(schema)) + elif isinstance(schema, list): + return [self.remap_json_schema(item) for item in schema] + elif isinstance(schema, dict): + for key, value in schema.items(): + if key == '$ref' and isinstance(value, str): + schema['$ref'] = self.remap_json_ref(JsonRef(value)) + elif key == '$defs': + schema['$defs'] = { + self.remap_defs_ref(DefsRef(key)): self.remap_json_schema(value) + for key, value in schema['$defs'].items() + } + else: + schema[key] = self.remap_json_schema(value) + return schema + + +class GenerateJsonSchema: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/json_schema/#customizing-the-json-schema-generation-process + + A class for generating JSON schemas. + + This class generates JSON schemas based on configured parameters. The default schema dialect + is [https://json-schema.org/draft/2020-12/schema](https://json-schema.org/draft/2020-12/schema). + The class uses `by_alias` to configure how fields with + multiple names are handled and `ref_template` to format reference names. + + Attributes: + schema_dialect: The JSON schema dialect used to generate the schema. See + [Declaring a Dialect](https://json-schema.org/understanding-json-schema/reference/schema.html#id4) + in the JSON Schema documentation for more information about dialects. + ignored_warning_kinds: Warnings to ignore when generating the schema. `self.render_warning_message` will + do nothing if its argument `kind` is in `ignored_warning_kinds`; + this value can be modified on subclasses to easily control which warnings are emitted. + by_alias: Whether to use field aliases when generating the schema. + ref_template: The format string used when generating reference names. + core_to_json_refs: A mapping of core refs to JSON refs. + core_to_defs_refs: A mapping of core refs to definition refs. + defs_to_core_refs: A mapping of definition refs to core refs. + json_to_defs_refs: A mapping of JSON refs to definition refs. + definitions: Definitions in the schema. + + Args: + by_alias: Whether to use field aliases in the generated schemas. + ref_template: The format string to use when generating reference names. + + Raises: + JsonSchemaError: If the instance of the class is inadvertently re-used after generating a schema. + """ + + schema_dialect = 'https://json-schema.org/draft/2020-12/schema' + + # `self.render_warning_message` will do nothing if its argument `kind` is in `ignored_warning_kinds`; + # this value can be modified on subclasses to easily control which warnings are emitted + ignored_warning_kinds: set[JsonSchemaWarningKind] = {'skipped-choice'} + + def __init__(self, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE): + self.by_alias = by_alias + self.ref_template = ref_template + + self.core_to_json_refs: dict[CoreModeRef, JsonRef] = {} + self.core_to_defs_refs: dict[CoreModeRef, DefsRef] = {} + self.defs_to_core_refs: dict[DefsRef, CoreModeRef] = {} + self.json_to_defs_refs: dict[JsonRef, DefsRef] = {} + + self.definitions: dict[DefsRef, JsonSchemaValue] = {} + self._config_wrapper_stack = _config.ConfigWrapperStack(_config.ConfigWrapper({})) + + self._mode: JsonSchemaMode = 'validation' + + # The following includes a mapping of a fully-unique defs ref choice to a list of preferred + # alternatives, which are generally simpler, such as only including the class name. + # At the end of schema generation, we use these to produce a JSON schema with more human-readable + # definitions, which would also work better in a generated OpenAPI client, etc. + self._prioritized_defsref_choices: dict[DefsRef, list[DefsRef]] = {} + self._collision_counter: dict[str, int] = defaultdict(int) + self._collision_index: dict[str, int] = {} + + self._schema_type_to_method = self.build_schema_type_to_method() + + # When we encounter definitions we need to try to build them immediately + # so that they are available schemas that reference them + # But it's possible that CoreSchema was never going to be used + # (e.g. because the CoreSchema that references short circuits is JSON schema generation without needing + # the reference) so instead of failing altogether if we can't build a definition we + # store the error raised and re-throw it if we end up needing that def + self._core_defs_invalid_for_json_schema: dict[DefsRef, PydanticInvalidForJsonSchema] = {} + + # This changes to True after generating a schema, to prevent issues caused by accidental re-use + # of a single instance of a schema generator + self._used = False + + @property + def _config(self) -> _config.ConfigWrapper: + return self._config_wrapper_stack.tail + + @property + def mode(self) -> JsonSchemaMode: + if self._config.json_schema_mode_override is not None: + return self._config.json_schema_mode_override + else: + return self._mode + + def build_schema_type_to_method( + self, + ) -> dict[CoreSchemaOrFieldType, Callable[[CoreSchemaOrField], JsonSchemaValue]]: + """Builds a dictionary mapping fields to methods for generating JSON schemas. + + Returns: + A dictionary containing the mapping of `CoreSchemaOrFieldType` to a handler method. + + Raises: + TypeError: If no method has been defined for generating a JSON schema for a given pydantic core schema type. + """ + mapping: dict[CoreSchemaOrFieldType, Callable[[CoreSchemaOrField], JsonSchemaValue]] = {} + core_schema_types: list[CoreSchemaOrFieldType] = _typing_extra.all_literal_values( + CoreSchemaOrFieldType # type: ignore + ) + for key in core_schema_types: + method_name = f"{key.replace('-', '_')}_schema" + try: + mapping[key] = getattr(self, method_name) + except AttributeError as e: # pragma: no cover + raise TypeError( + f'No method for generating JsonSchema for core_schema.type={key!r} ' + f'(expected: {type(self).__name__}.{method_name})' + ) from e + return mapping + + def generate_definitions( + self, inputs: Sequence[tuple[JsonSchemaKeyT, JsonSchemaMode, core_schema.CoreSchema]] + ) -> tuple[dict[tuple[JsonSchemaKeyT, JsonSchemaMode], JsonSchemaValue], dict[DefsRef, JsonSchemaValue]]: + """Generates JSON schema definitions from a list of core schemas, pairing the generated definitions with a + mapping that links the input keys to the definition references. + + Args: + inputs: A sequence of tuples, where: + + - The first element is a JSON schema key type. + - The second element is the JSON mode: either 'validation' or 'serialization'. + - The third element is a core schema. + + Returns: + A tuple where: + + - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and + whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have + JsonRef references to definitions that are defined in the second returned element.) + - The second element is a dictionary whose keys are definition references for the JSON schemas + from the first returned element, and whose values are the actual JSON schema definitions. + + Raises: + PydanticUserError: Raised if the JSON schema generator has already been used to generate a JSON schema. + """ + if self._used: + raise PydanticUserError( + 'This JSON schema generator has already been used to generate a JSON schema. ' + f'You must create a new instance of {type(self).__name__} to generate a new JSON schema.', + code='json-schema-already-used', + ) + + for key, mode, schema in inputs: + self._mode = mode + self.generate_inner(schema) + + definitions_remapping = self._build_definitions_remapping() + + json_schemas_map: dict[tuple[JsonSchemaKeyT, JsonSchemaMode], DefsRef] = {} + for key, mode, schema in inputs: + self._mode = mode + json_schema = self.generate_inner(schema) + json_schemas_map[(key, mode)] = definitions_remapping.remap_json_schema(json_schema) + + json_schema = {'$defs': self.definitions} + json_schema = definitions_remapping.remap_json_schema(json_schema) + self._used = True + return json_schemas_map, _sort_json_schema(json_schema['$defs']) # type: ignore + + def generate(self, schema: CoreSchema, mode: JsonSchemaMode = 'validation') -> JsonSchemaValue: + """Generates a JSON schema for a specified schema in a specified mode. + + Args: + schema: A Pydantic model. + mode: The mode in which to generate the schema. Defaults to 'validation'. + + Returns: + A JSON schema representing the specified schema. + + Raises: + PydanticUserError: If the JSON schema generator has already been used to generate a JSON schema. + """ + self._mode = mode + if self._used: + raise PydanticUserError( + 'This JSON schema generator has already been used to generate a JSON schema. ' + f'You must create a new instance of {type(self).__name__} to generate a new JSON schema.', + code='json-schema-already-used', + ) + + json_schema: JsonSchemaValue = self.generate_inner(schema) + json_ref_counts = self.get_json_ref_counts(json_schema) + + # Remove the top-level $ref if present; note that the _generate method already ensures there are no sibling keys + ref = cast(JsonRef, json_schema.get('$ref')) + while ref is not None: # may need to unpack multiple levels + ref_json_schema = self.get_schema_from_definitions(ref) + if json_ref_counts[ref] > 1 or ref_json_schema is None: + # Keep the ref, but use an allOf to remove the top level $ref + json_schema = {'allOf': [{'$ref': ref}]} + else: + # "Unpack" the ref since this is the only reference + json_schema = ref_json_schema.copy() # copy to prevent recursive dict reference + json_ref_counts[ref] -= 1 + ref = cast(JsonRef, json_schema.get('$ref')) + + self._garbage_collect_definitions(json_schema) + definitions_remapping = self._build_definitions_remapping() + + if self.definitions: + json_schema['$defs'] = self.definitions + + json_schema = definitions_remapping.remap_json_schema(json_schema) + + # For now, we will not set the $schema key. However, if desired, this can be easily added by overriding + # this method and adding the following line after a call to super().generate(schema): + # json_schema['$schema'] = self.schema_dialect + + self._used = True + return _sort_json_schema(json_schema) + + def generate_inner(self, schema: CoreSchemaOrField) -> JsonSchemaValue: # noqa: C901 + """Generates a JSON schema for a given core schema. + + Args: + schema: The given core schema. + + Returns: + The generated JSON schema. + """ + # If a schema with the same CoreRef has been handled, just return a reference to it + # Note that this assumes that it will _never_ be the case that the same CoreRef is used + # on types that should have different JSON schemas + if 'ref' in schema: + core_ref = CoreRef(schema['ref']) # type: ignore[typeddict-item] + core_mode_ref = (core_ref, self.mode) + if core_mode_ref in self.core_to_defs_refs and self.core_to_defs_refs[core_mode_ref] in self.definitions: + return {'$ref': self.core_to_json_refs[core_mode_ref]} + + # Generate the JSON schema, accounting for the json_schema_override and core_schema_override + metadata_handler = _core_metadata.CoreMetadataHandler(schema) + + def populate_defs(core_schema: CoreSchema, json_schema: JsonSchemaValue) -> JsonSchemaValue: + if 'ref' in core_schema: + core_ref = CoreRef(core_schema['ref']) # type: ignore[typeddict-item] + defs_ref, ref_json_schema = self.get_cache_defs_ref_schema(core_ref) + json_ref = JsonRef(ref_json_schema['$ref']) + self.json_to_defs_refs[json_ref] = defs_ref + # Replace the schema if it's not a reference to itself + # What we want to avoid is having the def be just a ref to itself + # which is what would happen if we blindly assigned any + if json_schema.get('$ref', None) != json_ref: + self.definitions[defs_ref] = json_schema + self._core_defs_invalid_for_json_schema.pop(defs_ref, None) + json_schema = ref_json_schema + return json_schema + + def convert_to_all_of(json_schema: JsonSchemaValue) -> JsonSchemaValue: + if '$ref' in json_schema and len(json_schema.keys()) > 1: + # technically you can't have any other keys next to a "$ref" + # but it's an easy mistake to make and not hard to correct automatically here + json_schema = json_schema.copy() + ref = json_schema.pop('$ref') + json_schema = {'allOf': [{'$ref': ref}], **json_schema} + return json_schema + + def handler_func(schema_or_field: CoreSchemaOrField) -> JsonSchemaValue: + """Generate a JSON schema based on the input schema. + + Args: + schema_or_field: The core schema to generate a JSON schema from. + + Returns: + The generated JSON schema. + + Raises: + TypeError: If an unexpected schema type is encountered. + """ + # Generate the core-schema-type-specific bits of the schema generation: + json_schema: JsonSchemaValue | None = None + if self.mode == 'serialization' and 'serialization' in schema_or_field: + ser_schema = schema_or_field['serialization'] # type: ignore + json_schema = self.ser_schema(ser_schema) + if json_schema is None: + if _core_utils.is_core_schema(schema_or_field) or _core_utils.is_core_schema_field(schema_or_field): + generate_for_schema_type = self._schema_type_to_method[schema_or_field['type']] + json_schema = generate_for_schema_type(schema_or_field) + else: + raise TypeError(f'Unexpected schema type: schema={schema_or_field}') + if _core_utils.is_core_schema(schema_or_field): + json_schema = populate_defs(schema_or_field, json_schema) + json_schema = convert_to_all_of(json_schema) + return json_schema + + current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, handler_func) + + for js_modify_function in metadata_handler.metadata.get('pydantic_js_functions', ()): + + def new_handler_func( + schema_or_field: CoreSchemaOrField, + current_handler: GetJsonSchemaHandler = current_handler, + js_modify_function: GetJsonSchemaFunction = js_modify_function, + ) -> JsonSchemaValue: + json_schema = js_modify_function(schema_or_field, current_handler) + if _core_utils.is_core_schema(schema_or_field): + json_schema = populate_defs(schema_or_field, json_schema) + original_schema = current_handler.resolve_ref_schema(json_schema) + ref = json_schema.pop('$ref', None) + if ref and json_schema: + original_schema.update(json_schema) + return original_schema + + current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, new_handler_func) + + for js_modify_function in metadata_handler.metadata.get('pydantic_js_annotation_functions', ()): + + def new_handler_func( + schema_or_field: CoreSchemaOrField, + current_handler: GetJsonSchemaHandler = current_handler, + js_modify_function: GetJsonSchemaFunction = js_modify_function, + ) -> JsonSchemaValue: + json_schema = js_modify_function(schema_or_field, current_handler) + if _core_utils.is_core_schema(schema_or_field): + json_schema = populate_defs(schema_or_field, json_schema) + json_schema = convert_to_all_of(json_schema) + return json_schema + + current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, new_handler_func) + + json_schema = current_handler(schema) + if _core_utils.is_core_schema(schema): + json_schema = populate_defs(schema, json_schema) + json_schema = convert_to_all_of(json_schema) + return json_schema + + # ### Schema generation methods + def any_schema(self, schema: core_schema.AnySchema) -> JsonSchemaValue: + """Generates a JSON schema that matches any value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return {} + + def none_schema(self, schema: core_schema.NoneSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches `None`. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return {'type': 'null'} + + def bool_schema(self, schema: core_schema.BoolSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a bool value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return {'type': 'boolean'} + + def int_schema(self, schema: core_schema.IntSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches an int value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema: dict[str, Any] = {'type': 'integer'} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.numeric) + json_schema = {k: v for k, v in json_schema.items() if v not in {math.inf, -math.inf}} + return json_schema + + def float_schema(self, schema: core_schema.FloatSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a float value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema: dict[str, Any] = {'type': 'number'} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.numeric) + json_schema = {k: v for k, v in json_schema.items() if v not in {math.inf, -math.inf}} + return json_schema + + def decimal_schema(self, schema: core_schema.DecimalSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a decimal value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema = self.str_schema(core_schema.str_schema()) + if self.mode == 'validation': + multiple_of = schema.get('multiple_of') + le = schema.get('le') + ge = schema.get('ge') + lt = schema.get('lt') + gt = schema.get('gt') + json_schema = { + 'anyOf': [ + self.float_schema( + core_schema.float_schema( + allow_inf_nan=schema.get('allow_inf_nan'), + multiple_of=None if multiple_of is None else float(multiple_of), + le=None if le is None else float(le), + ge=None if ge is None else float(ge), + lt=None if lt is None else float(lt), + gt=None if gt is None else float(gt), + ) + ), + json_schema, + ], + } + return json_schema + + def str_schema(self, schema: core_schema.StringSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a string value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema = {'type': 'string'} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.string) + return json_schema + + def bytes_schema(self, schema: core_schema.BytesSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a bytes value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema = {'type': 'string', 'format': 'base64url' if self._config.ser_json_bytes == 'base64' else 'binary'} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.bytes) + return json_schema + + def date_schema(self, schema: core_schema.DateSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a date value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema = {'type': 'string', 'format': 'date'} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.date) + return json_schema + + def time_schema(self, schema: core_schema.TimeSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a time value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return {'type': 'string', 'format': 'time'} + + def datetime_schema(self, schema: core_schema.DatetimeSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a datetime value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return {'type': 'string', 'format': 'date-time'} + + def timedelta_schema(self, schema: core_schema.TimedeltaSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a timedelta value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + if self._config.ser_json_timedelta == 'float': + return {'type': 'number'} + return {'type': 'string', 'format': 'duration'} + + def literal_schema(self, schema: core_schema.LiteralSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a literal value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + expected = [v.value if isinstance(v, Enum) else v for v in schema['expected']] + # jsonify the expected values + expected = [to_jsonable_python(v) for v in expected] + + if len(expected) == 1: + return {'const': expected[0]} + + types = {type(e) for e in expected} + if types == {str}: + return {'enum': expected, 'type': 'string'} + elif types == {int}: + return {'enum': expected, 'type': 'integer'} + elif types == {float}: + return {'enum': expected, 'type': 'number'} + elif types == {bool}: + return {'enum': expected, 'type': 'boolean'} + elif types == {list}: + return {'enum': expected, 'type': 'array'} + # there is not None case because if it's mixed it hits the final `else` + # if it's a single Literal[None] then it becomes a `const` schema above + else: + return {'enum': expected} + + def is_instance_schema(self, schema: core_schema.IsInstanceSchema) -> JsonSchemaValue: + """Handles JSON schema generation for a core schema that checks if a value is an instance of a class. + + Unless overridden in a subclass, this raises an error. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.handle_invalid_for_json_schema(schema, f'core_schema.IsInstanceSchema ({schema["cls"]})') + + def is_subclass_schema(self, schema: core_schema.IsSubclassSchema) -> JsonSchemaValue: + """Handles JSON schema generation for a core schema that checks if a value is a subclass of a class. + + For backwards compatibility with v1, this does not raise an error, but can be overridden to change this. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + # Note: This is for compatibility with V1; you can override if you want different behavior. + return {} + + def callable_schema(self, schema: core_schema.CallableSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a callable value. + + Unless overridden in a subclass, this raises an error. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.handle_invalid_for_json_schema(schema, 'core_schema.CallableSchema') + + def list_schema(self, schema: core_schema.ListSchema) -> JsonSchemaValue: + """Returns a schema that matches a list schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema']) + json_schema = {'type': 'array', 'items': items_schema} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.array) + return json_schema + + @deprecated('`tuple_positional_schema` is deprecated. Use `tuple_schema` instead.', category=None) + @final + def tuple_positional_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue: + """Replaced by `tuple_schema`.""" + warnings.warn( + '`tuple_positional_schema` is deprecated. Use `tuple_schema` instead.', + PydanticDeprecatedSince26, + stacklevel=2, + ) + return self.tuple_schema(schema) + + @deprecated('`tuple_variable_schema` is deprecated. Use `tuple_schema` instead.', category=None) + @final + def tuple_variable_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue: + """Replaced by `tuple_schema`.""" + warnings.warn( + '`tuple_variable_schema` is deprecated. Use `tuple_schema` instead.', + PydanticDeprecatedSince26, + stacklevel=2, + ) + return self.tuple_schema(schema) + + def tuple_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a tuple schema e.g. `Tuple[int, + str, bool]` or `Tuple[int, ...]`. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema: JsonSchemaValue = {'type': 'array'} + if 'variadic_item_index' in schema: + variadic_item_index = schema['variadic_item_index'] + if variadic_item_index > 0: + json_schema['minItems'] = variadic_item_index + json_schema['prefixItems'] = [ + self.generate_inner(item) for item in schema['items_schema'][:variadic_item_index] + ] + if variadic_item_index + 1 == len(schema['items_schema']): + # if the variadic item is the last item, then represent it faithfully + json_schema['items'] = self.generate_inner(schema['items_schema'][variadic_item_index]) + else: + # otherwise, 'items' represents the schema for the variadic + # item plus the suffix, so just allow anything for simplicity + # for now + json_schema['items'] = True + else: + prefixItems = [self.generate_inner(item) for item in schema['items_schema']] + if prefixItems: + json_schema['prefixItems'] = prefixItems + json_schema['minItems'] = len(prefixItems) + json_schema['maxItems'] = len(prefixItems) + self.update_with_validations(json_schema, schema, self.ValidationsMapping.array) + return json_schema + + def set_schema(self, schema: core_schema.SetSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a set schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self._common_set_schema(schema) + + def frozenset_schema(self, schema: core_schema.FrozenSetSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a frozenset schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self._common_set_schema(schema) + + def _common_set_schema(self, schema: core_schema.SetSchema | core_schema.FrozenSetSchema) -> JsonSchemaValue: + items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema']) + json_schema = {'type': 'array', 'uniqueItems': True, 'items': items_schema} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.array) + return json_schema + + def generator_schema(self, schema: core_schema.GeneratorSchema) -> JsonSchemaValue: + """Returns a JSON schema that represents the provided GeneratorSchema. + + Args: + schema: The schema. + + Returns: + The generated JSON schema. + """ + items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema']) + json_schema = {'type': 'array', 'items': items_schema} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.array) + return json_schema + + def dict_schema(self, schema: core_schema.DictSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a dict schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema: JsonSchemaValue = {'type': 'object'} + + keys_schema = self.generate_inner(schema['keys_schema']).copy() if 'keys_schema' in schema else {} + keys_pattern = keys_schema.pop('pattern', None) + + values_schema = self.generate_inner(schema['values_schema']).copy() if 'values_schema' in schema else {} + values_schema.pop('title', None) # don't give a title to the additionalProperties + if values_schema or keys_pattern is not None: # don't add additionalProperties if it's empty + if keys_pattern is None: + json_schema['additionalProperties'] = values_schema + else: + json_schema['patternProperties'] = {keys_pattern: values_schema} + + self.update_with_validations(json_schema, schema, self.ValidationsMapping.object) + return json_schema + + def _function_schema( + self, + schema: _core_utils.AnyFunctionSchema, + ) -> JsonSchemaValue: + if _core_utils.is_function_with_inner_schema(schema): + # This could be wrong if the function's mode is 'before', but in practice will often be right, and when it + # isn't, I think it would be hard to automatically infer what the desired schema should be. + return self.generate_inner(schema['schema']) + + # function-plain + return self.handle_invalid_for_json_schema( + schema, f'core_schema.PlainValidatorFunctionSchema ({schema["function"]})' + ) + + def function_before_schema(self, schema: core_schema.BeforeValidatorFunctionSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a function-before schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self._function_schema(schema) + + def function_after_schema(self, schema: core_schema.AfterValidatorFunctionSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a function-after schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self._function_schema(schema) + + def function_plain_schema(self, schema: core_schema.PlainValidatorFunctionSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a function-plain schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self._function_schema(schema) + + def function_wrap_schema(self, schema: core_schema.WrapValidatorFunctionSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a function-wrap schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self._function_schema(schema) + + def default_schema(self, schema: core_schema.WithDefaultSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema with a default value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema = self.generate_inner(schema['schema']) + + if 'default' not in schema: + return json_schema + default = schema['default'] + # Note: if you want to include the value returned by the default_factory, + # override this method and replace the code above with: + # if 'default' in schema: + # default = schema['default'] + # elif 'default_factory' in schema: + # default = schema['default_factory']() + # else: + # return json_schema + + try: + encoded_default = self.encode_default(default) + except pydantic_core.PydanticSerializationError: + self.emit_warning( + 'non-serializable-default', + f'Default value {default} is not JSON serializable; excluding default from JSON schema', + ) + # Return the inner schema, as though there was no default + return json_schema + + if '$ref' in json_schema: + # Since reference schemas do not support child keys, we wrap the reference schema in a single-case allOf: + return {'allOf': [json_schema], 'default': encoded_default} + else: + json_schema['default'] = encoded_default + return json_schema + + def nullable_schema(self, schema: core_schema.NullableSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that allows null values. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + null_schema = {'type': 'null'} + inner_json_schema = self.generate_inner(schema['schema']) + + if inner_json_schema == null_schema: + return null_schema + else: + # Thanks to the equality check against `null_schema` above, I think 'oneOf' would also be valid here; + # I'll use 'anyOf' for now, but it could be changed it if it would work better with some external tooling + return self.get_flattened_anyof([inner_json_schema, null_schema]) + + def union_schema(self, schema: core_schema.UnionSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that allows values matching any of the given schemas. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + generated: list[JsonSchemaValue] = [] + + choices = schema['choices'] + for choice in choices: + # choice will be a tuple if an explicit label was provided + choice_schema = choice[0] if isinstance(choice, tuple) else choice + try: + generated.append(self.generate_inner(choice_schema)) + except PydanticOmit: + continue + except PydanticInvalidForJsonSchema as exc: + self.emit_warning('skipped-choice', exc.message) + if len(generated) == 1: + return generated[0] + return self.get_flattened_anyof(generated) + + def tagged_union_schema(self, schema: core_schema.TaggedUnionSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that allows values matching any of the given schemas, where + the schemas are tagged with a discriminator field that indicates which schema should be used to validate + the value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + generated: dict[str, JsonSchemaValue] = {} + for k, v in schema['choices'].items(): + if isinstance(k, Enum): + k = k.value + try: + # Use str(k) since keys must be strings for json; while not technically correct, + # it's the closest that can be represented in valid JSON + generated[str(k)] = self.generate_inner(v).copy() + except PydanticOmit: + continue + except PydanticInvalidForJsonSchema as exc: + self.emit_warning('skipped-choice', exc.message) + + one_of_choices = _deduplicate_schemas(generated.values()) + json_schema: JsonSchemaValue = {'oneOf': one_of_choices} + + # This reflects the v1 behavior; TODO: we should make it possible to exclude OpenAPI stuff from the JSON schema + openapi_discriminator = self._extract_discriminator(schema, one_of_choices) + if openapi_discriminator is not None: + json_schema['discriminator'] = { + 'propertyName': openapi_discriminator, + 'mapping': {k: v.get('$ref', v) for k, v in generated.items()}, + } + + return json_schema + + def _extract_discriminator( + self, schema: core_schema.TaggedUnionSchema, one_of_choices: list[JsonDict] + ) -> str | None: + """Extract a compatible OpenAPI discriminator from the schema and one_of choices that end up in the final + schema.""" + openapi_discriminator: str | None = None + + if isinstance(schema['discriminator'], str): + return schema['discriminator'] + + if isinstance(schema['discriminator'], list): + # If the discriminator is a single item list containing a string, that is equivalent to the string case + if len(schema['discriminator']) == 1 and isinstance(schema['discriminator'][0], str): + return schema['discriminator'][0] + # When an alias is used that is different from the field name, the discriminator will be a list of single + # str lists, one for the attribute and one for the actual alias. The logic here will work even if there is + # more than one possible attribute, and looks for whether a single alias choice is present as a documented + # property on all choices. If so, that property will be used as the OpenAPI discriminator. + for alias_path in schema['discriminator']: + if not isinstance(alias_path, list): + break # this means that the discriminator is not a list of alias paths + if len(alias_path) != 1: + continue # this means that the "alias" does not represent a single field + alias = alias_path[0] + if not isinstance(alias, str): + continue # this means that the "alias" does not represent a field + alias_is_present_on_all_choices = True + for choice in one_of_choices: + while '$ref' in choice: + assert isinstance(choice['$ref'], str) + choice = self.get_schema_from_definitions(JsonRef(choice['$ref'])) or {} + properties = choice.get('properties', {}) + if not isinstance(properties, dict) or alias not in properties: + alias_is_present_on_all_choices = False + break + if alias_is_present_on_all_choices: + openapi_discriminator = alias + break + return openapi_discriminator + + def chain_schema(self, schema: core_schema.ChainSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a core_schema.ChainSchema. + + When generating a schema for validation, we return the validation JSON schema for the first step in the chain. + For serialization, we return the serialization JSON schema for the last step in the chain. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + step_index = 0 if self.mode == 'validation' else -1 # use first step for validation, last for serialization + return self.generate_inner(schema['steps'][step_index]) + + def lax_or_strict_schema(self, schema: core_schema.LaxOrStrictSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that allows values matching either the lax schema or the + strict schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + # TODO: Need to read the default value off of model config or whatever + use_strict = schema.get('strict', False) # TODO: replace this default False + # If your JSON schema fails to generate it is probably + # because one of the following two branches failed. + if use_strict: + return self.generate_inner(schema['strict_schema']) + else: + return self.generate_inner(schema['lax_schema']) + + def json_or_python_schema(self, schema: core_schema.JsonOrPythonSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that allows values matching either the JSON schema or the + Python schema. + + The JSON schema is used instead of the Python schema. If you want to use the Python schema, you should override + this method. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['json_schema']) + + def typed_dict_schema(self, schema: core_schema.TypedDictSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a typed dict. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + total = schema.get('total', True) + named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [ + (name, self.field_is_required(field, total), field) + for name, field in schema['fields'].items() + if self.field_is_present(field) + ] + if self.mode == 'serialization': + named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', []))) + + config = _get_typed_dict_config(schema) + with self._config_wrapper_stack.push(config): + json_schema = self._named_required_fields_schema(named_required_fields) + + extra = schema.get('extra_behavior') + if extra is None: + extra = config.get('extra', 'ignore') + if extra == 'forbid': + json_schema['additionalProperties'] = False + elif extra == 'allow': + json_schema['additionalProperties'] = True + + return json_schema + + @staticmethod + def _name_required_computed_fields( + computed_fields: list[ComputedField], + ) -> list[tuple[str, bool, core_schema.ComputedField]]: + return [(field['property_name'], True, field) for field in computed_fields] + + def _named_required_fields_schema( + self, named_required_fields: Sequence[tuple[str, bool, CoreSchemaField]] + ) -> JsonSchemaValue: + properties: dict[str, JsonSchemaValue] = {} + required_fields: list[str] = [] + for name, required, field in named_required_fields: + if self.by_alias: + name = self._get_alias_name(field, name) + try: + field_json_schema = self.generate_inner(field).copy() + except PydanticOmit: + continue + if 'title' not in field_json_schema and self.field_title_should_be_set(field): + title = self.get_title_from_name(name) + field_json_schema['title'] = title + field_json_schema = self.handle_ref_overrides(field_json_schema) + properties[name] = field_json_schema + if required: + required_fields.append(name) + + json_schema = {'type': 'object', 'properties': properties} + if required_fields: + json_schema['required'] = required_fields + return json_schema + + def _get_alias_name(self, field: CoreSchemaField, name: str) -> str: + if field['type'] == 'computed-field': + alias: Any = field.get('alias', name) + elif self.mode == 'validation': + alias = field.get('validation_alias', name) + else: + alias = field.get('serialization_alias', name) + if isinstance(alias, str): + name = alias + elif isinstance(alias, list): + alias = cast('list[str] | str', alias) + for path in alias: + if isinstance(path, list) and len(path) == 1 and isinstance(path[0], str): + # Use the first valid single-item string path; the code that constructs the alias array + # should ensure the first such item is what belongs in the JSON schema + name = path[0] + break + else: + assert_never(alias) + return name + + def typed_dict_field_schema(self, schema: core_schema.TypedDictField) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a typed dict field. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['schema']) + + def dataclass_field_schema(self, schema: core_schema.DataclassField) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a dataclass field. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['schema']) + + def model_field_schema(self, schema: core_schema.ModelField) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a model field. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['schema']) + + def computed_field_schema(self, schema: core_schema.ComputedField) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a computed field. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['return_schema']) + + def model_schema(self, schema: core_schema.ModelSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a model. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + # We do not use schema['model'].model_json_schema() here + # because it could lead to inconsistent refs handling, etc. + cls = cast('type[BaseModel]', schema['cls']) + config = cls.model_config + title = config.get('title') + + with self._config_wrapper_stack.push(config): + json_schema = self.generate_inner(schema['schema']) + + json_schema_extra = config.get('json_schema_extra') + if cls.__pydantic_root_model__: + root_json_schema_extra = cls.model_fields['root'].json_schema_extra + if json_schema_extra and root_json_schema_extra: + raise ValueError( + '"model_config[\'json_schema_extra\']" and "Field.json_schema_extra" on "RootModel.root"' + ' field must not be set simultaneously' + ) + if root_json_schema_extra: + json_schema_extra = root_json_schema_extra + + json_schema = self._update_class_schema(json_schema, title, config.get('extra', None), cls, json_schema_extra) + + return json_schema + + def _update_class_schema( + self, + json_schema: JsonSchemaValue, + title: str | None, + extra: Literal['allow', 'ignore', 'forbid'] | None, + cls: type[Any], + json_schema_extra: JsonDict | JsonSchemaExtraCallable | None, + ) -> JsonSchemaValue: + if '$ref' in json_schema: + schema_to_update = self.get_schema_from_definitions(JsonRef(json_schema['$ref'])) or json_schema + else: + schema_to_update = json_schema + + if title is not None: + # referenced_schema['title'] = title + schema_to_update.setdefault('title', title) + + if 'additionalProperties' not in schema_to_update: + if extra == 'allow': + schema_to_update['additionalProperties'] = True + elif extra == 'forbid': + schema_to_update['additionalProperties'] = False + + if isinstance(json_schema_extra, (staticmethod, classmethod)): + # In older versions of python, this is necessary to ensure staticmethod/classmethods are callable + json_schema_extra = json_schema_extra.__get__(cls) + + if isinstance(json_schema_extra, dict): + schema_to_update.update(json_schema_extra) + elif callable(json_schema_extra): + if len(inspect.signature(json_schema_extra).parameters) > 1: + json_schema_extra(schema_to_update, cls) # type: ignore + else: + json_schema_extra(schema_to_update) # type: ignore + elif json_schema_extra is not None: + raise ValueError( + f"model_config['json_schema_extra']={json_schema_extra} should be a dict, callable, or None" + ) + + return json_schema + + def resolve_schema_to_update(self, json_schema: JsonSchemaValue) -> JsonSchemaValue: + """Resolve a JsonSchemaValue to the non-ref schema if it is a $ref schema. + + Args: + json_schema: The schema to resolve. + + Returns: + The resolved schema. + """ + if '$ref' in json_schema: + schema_to_update = self.get_schema_from_definitions(JsonRef(json_schema['$ref'])) + if schema_to_update is None: + raise RuntimeError(f'Cannot update undefined schema for $ref={json_schema["$ref"]}') + return self.resolve_schema_to_update(schema_to_update) + else: + schema_to_update = json_schema + return schema_to_update + + def model_fields_schema(self, schema: core_schema.ModelFieldsSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a model's fields. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [ + (name, self.field_is_required(field, total=True), field) + for name, field in schema['fields'].items() + if self.field_is_present(field) + ] + if self.mode == 'serialization': + named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', []))) + json_schema = self._named_required_fields_schema(named_required_fields) + extras_schema = schema.get('extras_schema', None) + if extras_schema is not None: + schema_to_update = self.resolve_schema_to_update(json_schema) + schema_to_update['additionalProperties'] = self.generate_inner(extras_schema) + return json_schema + + def field_is_present(self, field: CoreSchemaField) -> bool: + """Whether the field should be included in the generated JSON schema. + + Args: + field: The schema for the field itself. + + Returns: + `True` if the field should be included in the generated JSON schema, `False` otherwise. + """ + if self.mode == 'serialization': + # If you still want to include the field in the generated JSON schema, + # override this method and return True + return not field.get('serialization_exclude') + elif self.mode == 'validation': + return True + else: + assert_never(self.mode) + + def field_is_required( + self, + field: core_schema.ModelField | core_schema.DataclassField | core_schema.TypedDictField, + total: bool, + ) -> bool: + """Whether the field should be marked as required in the generated JSON schema. + (Note that this is irrelevant if the field is not present in the JSON schema.). + + Args: + field: The schema for the field itself. + total: Only applies to `TypedDictField`s. + Indicates if the `TypedDict` this field belongs to is total, in which case any fields that don't + explicitly specify `required=False` are required. + + Returns: + `True` if the field should be marked as required in the generated JSON schema, `False` otherwise. + """ + if self.mode == 'serialization' and self._config.json_schema_serialization_defaults_required: + return not field.get('serialization_exclude') + else: + if field['type'] == 'typed-dict-field': + return field.get('required', total) + else: + return field['schema']['type'] != 'default' + + def dataclass_args_schema(self, schema: core_schema.DataclassArgsSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a dataclass's constructor arguments. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [ + (field['name'], self.field_is_required(field, total=True), field) + for field in schema['fields'] + if self.field_is_present(field) + ] + if self.mode == 'serialization': + named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', []))) + return self._named_required_fields_schema(named_required_fields) + + def dataclass_schema(self, schema: core_schema.DataclassSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a dataclass. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + cls = schema['cls'] + config: ConfigDict = getattr(cls, '__pydantic_config__', cast('ConfigDict', {})) + title = config.get('title') or cls.__name__ + + with self._config_wrapper_stack.push(config): + json_schema = self.generate_inner(schema['schema']).copy() + + json_schema_extra = config.get('json_schema_extra') + json_schema = self._update_class_schema(json_schema, title, config.get('extra', None), cls, json_schema_extra) + + # Dataclass-specific handling of description + if is_dataclass(cls) and not hasattr(cls, '__pydantic_validator__'): + # vanilla dataclass; don't use cls.__doc__ as it will contain the class signature by default + description = None + else: + description = None if cls.__doc__ is None else inspect.cleandoc(cls.__doc__) + if description: + json_schema['description'] = description + + return json_schema + + def arguments_schema(self, schema: core_schema.ArgumentsSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a function's arguments. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + metadata = _core_metadata.CoreMetadataHandler(schema).metadata + prefer_positional = metadata.get('pydantic_js_prefer_positional_arguments') + + arguments = schema['arguments_schema'] + kw_only_arguments = [a for a in arguments if a.get('mode') == 'keyword_only'] + kw_or_p_arguments = [a for a in arguments if a.get('mode') in {'positional_or_keyword', None}] + p_only_arguments = [a for a in arguments if a.get('mode') == 'positional_only'] + var_args_schema = schema.get('var_args_schema') + var_kwargs_schema = schema.get('var_kwargs_schema') + + if prefer_positional: + positional_possible = not kw_only_arguments and not var_kwargs_schema + if positional_possible: + return self.p_arguments_schema(p_only_arguments + kw_or_p_arguments, var_args_schema) + + keyword_possible = not p_only_arguments and not var_args_schema + if keyword_possible: + return self.kw_arguments_schema(kw_or_p_arguments + kw_only_arguments, var_kwargs_schema) + + if not prefer_positional: + positional_possible = not kw_only_arguments and not var_kwargs_schema + if positional_possible: + return self.p_arguments_schema(p_only_arguments + kw_or_p_arguments, var_args_schema) + + raise PydanticInvalidForJsonSchema( + 'Unable to generate JSON schema for arguments validator with positional-only and keyword-only arguments' + ) + + def kw_arguments_schema( + self, arguments: list[core_schema.ArgumentsParameter], var_kwargs_schema: CoreSchema | None + ) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a function's keyword arguments. + + Args: + arguments: The core schema. + + Returns: + The generated JSON schema. + """ + properties: dict[str, JsonSchemaValue] = {} + required: list[str] = [] + for argument in arguments: + name = self.get_argument_name(argument) + argument_schema = self.generate_inner(argument['schema']).copy() + argument_schema['title'] = self.get_title_from_name(name) + properties[name] = argument_schema + + if argument['schema']['type'] != 'default': + # This assumes that if the argument has a default value, + # the inner schema must be of type WithDefaultSchema. + # I believe this is true, but I am not 100% sure + required.append(name) + + json_schema: JsonSchemaValue = {'type': 'object', 'properties': properties} + if required: + json_schema['required'] = required + + if var_kwargs_schema: + additional_properties_schema = self.generate_inner(var_kwargs_schema) + if additional_properties_schema: + json_schema['additionalProperties'] = additional_properties_schema + else: + json_schema['additionalProperties'] = False + return json_schema + + def p_arguments_schema( + self, arguments: list[core_schema.ArgumentsParameter], var_args_schema: CoreSchema | None + ) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a function's positional arguments. + + Args: + arguments: The core schema. + + Returns: + The generated JSON schema. + """ + prefix_items: list[JsonSchemaValue] = [] + min_items = 0 + + for argument in arguments: + name = self.get_argument_name(argument) + + argument_schema = self.generate_inner(argument['schema']).copy() + argument_schema['title'] = self.get_title_from_name(name) + prefix_items.append(argument_schema) + + if argument['schema']['type'] != 'default': + # This assumes that if the argument has a default value, + # the inner schema must be of type WithDefaultSchema. + # I believe this is true, but I am not 100% sure + min_items += 1 + + json_schema: JsonSchemaValue = {'type': 'array', 'prefixItems': prefix_items} + if min_items: + json_schema['minItems'] = min_items + + if var_args_schema: + items_schema = self.generate_inner(var_args_schema) + if items_schema: + json_schema['items'] = items_schema + else: + json_schema['maxItems'] = len(prefix_items) + + return json_schema + + def get_argument_name(self, argument: core_schema.ArgumentsParameter) -> str: + """Retrieves the name of an argument. + + Args: + argument: The core schema. + + Returns: + The name of the argument. + """ + name = argument['name'] + if self.by_alias: + alias = argument.get('alias') + if isinstance(alias, str): + name = alias + else: + pass # might want to do something else? + return name + + def call_schema(self, schema: core_schema.CallSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a function call. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['arguments_schema']) + + def custom_error_schema(self, schema: core_schema.CustomErrorSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a custom error. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['schema']) + + def json_schema(self, schema: core_schema.JsonSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a JSON object. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + content_core_schema = schema.get('schema') or core_schema.any_schema() + content_json_schema = self.generate_inner(content_core_schema) + if self.mode == 'validation': + return {'type': 'string', 'contentMediaType': 'application/json', 'contentSchema': content_json_schema} + else: + # self.mode == 'serialization' + return content_json_schema + + def url_schema(self, schema: core_schema.UrlSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a URL. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema = {'type': 'string', 'format': 'uri', 'minLength': 1} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.string) + return json_schema + + def multi_host_url_schema(self, schema: core_schema.MultiHostUrlSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a URL that can be used with multiple hosts. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + # Note: 'multi-host-uri' is a custom/pydantic-specific format, not part of the JSON Schema spec + json_schema = {'type': 'string', 'format': 'multi-host-uri', 'minLength': 1} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.string) + return json_schema + + def uuid_schema(self, schema: core_schema.UuidSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a UUID. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return {'type': 'string', 'format': 'uuid'} + + def definitions_schema(self, schema: core_schema.DefinitionsSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a JSON object with definitions. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + for definition in schema['definitions']: + try: + self.generate_inner(definition) + except PydanticInvalidForJsonSchema as e: + core_ref: CoreRef = CoreRef(definition['ref']) # type: ignore + self._core_defs_invalid_for_json_schema[self.get_defs_ref((core_ref, self.mode))] = e + continue + return self.generate_inner(schema['schema']) + + def definition_ref_schema(self, schema: core_schema.DefinitionReferenceSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that references a definition. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + core_ref = CoreRef(schema['schema_ref']) + _, ref_json_schema = self.get_cache_defs_ref_schema(core_ref) + return ref_json_schema + + def ser_schema( + self, schema: core_schema.SerSchema | core_schema.IncExSeqSerSchema | core_schema.IncExDictSerSchema + ) -> JsonSchemaValue | None: + """Generates a JSON schema that matches a schema that defines a serialized object. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + schema_type = schema['type'] + if schema_type == 'function-plain' or schema_type == 'function-wrap': + # PlainSerializerFunctionSerSchema or WrapSerializerFunctionSerSchema + return_schema = schema.get('return_schema') + if return_schema is not None: + return self.generate_inner(return_schema) + elif schema_type == 'format' or schema_type == 'to-string': + # FormatSerSchema or ToStringSerSchema + return self.str_schema(core_schema.str_schema()) + elif schema['type'] == 'model': + # ModelSerSchema + return self.generate_inner(schema['schema']) + return None + + # ### Utility methods + + def get_title_from_name(self, name: str) -> str: + """Retrieves a title from a name. + + Args: + name: The name to retrieve a title from. + + Returns: + The title. + """ + return name.title().replace('_', ' ') + + def field_title_should_be_set(self, schema: CoreSchemaOrField) -> bool: + """Returns true if a field with the given schema should have a title set based on the field name. + + Intuitively, we want this to return true for schemas that wouldn't otherwise provide their own title + (e.g., int, float, str), and false for those that would (e.g., BaseModel subclasses). + + Args: + schema: The schema to check. + + Returns: + `True` if the field should have a title set, `False` otherwise. + """ + if _core_utils.is_core_schema_field(schema): + if schema['type'] == 'computed-field': + field_schema = schema['return_schema'] + else: + field_schema = schema['schema'] + return self.field_title_should_be_set(field_schema) + + elif _core_utils.is_core_schema(schema): + if schema.get('ref'): # things with refs, such as models and enums, should not have titles set + return False + if schema['type'] in {'default', 'nullable', 'definitions'}: + return self.field_title_should_be_set(schema['schema']) # type: ignore[typeddict-item] + if _core_utils.is_function_with_inner_schema(schema): + return self.field_title_should_be_set(schema['schema']) + if schema['type'] == 'definition-ref': + # Referenced schemas should not have titles set for the same reason + # schemas with refs should not + return False + return True # anything else should have title set + + else: + raise PydanticInvalidForJsonSchema(f'Unexpected schema type: schema={schema}') # pragma: no cover + + def normalize_name(self, name: str) -> str: + """Normalizes a name to be used as a key in a dictionary. + + Args: + name: The name to normalize. + + Returns: + The normalized name. + """ + return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name).replace('.', '__') + + def get_defs_ref(self, core_mode_ref: CoreModeRef) -> DefsRef: + """Override this method to change the way that definitions keys are generated from a core reference. + + Args: + core_mode_ref: The core reference. + + Returns: + The definitions key. + """ + # Split the core ref into "components"; generic origins and arguments are each separate components + core_ref, mode = core_mode_ref + components = re.split(r'([\][,])', core_ref) + # Remove IDs from each component + components = [x.rsplit(':', 1)[0] for x in components] + core_ref_no_id = ''.join(components) + # Remove everything before the last period from each "component" + components = [re.sub(r'(?:[^.[\]]+\.)+((?:[^.[\]]+))', r'\1', x) for x in components] + short_ref = ''.join(components) + + mode_title = _MODE_TITLE_MAPPING[mode] + + # It is important that the generated defs_ref values be such that at least one choice will not + # be generated for any other core_ref. Currently, this should be the case because we include + # the id of the source type in the core_ref + name = DefsRef(self.normalize_name(short_ref)) + name_mode = DefsRef(self.normalize_name(short_ref) + f'-{mode_title}') + module_qualname = DefsRef(self.normalize_name(core_ref_no_id)) + module_qualname_mode = DefsRef(f'{module_qualname}-{mode_title}') + module_qualname_id = DefsRef(self.normalize_name(core_ref)) + occurrence_index = self._collision_index.get(module_qualname_id) + if occurrence_index is None: + self._collision_counter[module_qualname] += 1 + occurrence_index = self._collision_index[module_qualname_id] = self._collision_counter[module_qualname] + + module_qualname_occurrence = DefsRef(f'{module_qualname}__{occurrence_index}') + module_qualname_occurrence_mode = DefsRef(f'{module_qualname_mode}__{occurrence_index}') + + self._prioritized_defsref_choices[module_qualname_occurrence_mode] = [ + name, + name_mode, + module_qualname, + module_qualname_mode, + module_qualname_occurrence, + module_qualname_occurrence_mode, + ] + + return module_qualname_occurrence_mode + + def get_cache_defs_ref_schema(self, core_ref: CoreRef) -> tuple[DefsRef, JsonSchemaValue]: + """This method wraps the get_defs_ref method with some cache-lookup/population logic, + and returns both the produced defs_ref and the JSON schema that will refer to the right definition. + + Args: + core_ref: The core reference to get the definitions reference for. + + Returns: + A tuple of the definitions reference and the JSON schema that will refer to it. + """ + core_mode_ref = (core_ref, self.mode) + maybe_defs_ref = self.core_to_defs_refs.get(core_mode_ref) + if maybe_defs_ref is not None: + json_ref = self.core_to_json_refs[core_mode_ref] + return maybe_defs_ref, {'$ref': json_ref} + + defs_ref = self.get_defs_ref(core_mode_ref) + + # populate the ref translation mappings + self.core_to_defs_refs[core_mode_ref] = defs_ref + self.defs_to_core_refs[defs_ref] = core_mode_ref + + json_ref = JsonRef(self.ref_template.format(model=defs_ref)) + self.core_to_json_refs[core_mode_ref] = json_ref + self.json_to_defs_refs[json_ref] = defs_ref + ref_json_schema = {'$ref': json_ref} + return defs_ref, ref_json_schema + + def handle_ref_overrides(self, json_schema: JsonSchemaValue) -> JsonSchemaValue: + """It is not valid for a schema with a top-level $ref to have sibling keys. + + During our own schema generation, we treat sibling keys as overrides to the referenced schema, + but this is not how the official JSON schema spec works. + + Because of this, we first remove any sibling keys that are redundant with the referenced schema, then if + any remain, we transform the schema from a top-level '$ref' to use allOf to move the $ref out of the top level. + (See bottom of https://swagger.io/docs/specification/using-ref/ for a reference about this behavior) + """ + if '$ref' in json_schema: + # prevent modifications to the input; this copy may be safe to drop if there is significant overhead + json_schema = json_schema.copy() + + referenced_json_schema = self.get_schema_from_definitions(JsonRef(json_schema['$ref'])) + if referenced_json_schema is None: + # This can happen when building schemas for models with not-yet-defined references. + # It may be a good idea to do a recursive pass at the end of the generation to remove + # any redundant override keys. + if len(json_schema) > 1: + # Make it an allOf to at least resolve the sibling keys issue + json_schema = json_schema.copy() + json_schema.setdefault('allOf', []) + json_schema['allOf'].append({'$ref': json_schema['$ref']}) + del json_schema['$ref'] + + return json_schema + for k, v in list(json_schema.items()): + if k == '$ref': + continue + if k in referenced_json_schema and referenced_json_schema[k] == v: + del json_schema[k] # redundant key + if len(json_schema) > 1: + # There is a remaining "override" key, so we need to move $ref out of the top level + json_ref = JsonRef(json_schema['$ref']) + del json_schema['$ref'] + assert 'allOf' not in json_schema # this should never happen, but just in case + json_schema['allOf'] = [{'$ref': json_ref}] + + return json_schema + + def get_schema_from_definitions(self, json_ref: JsonRef) -> JsonSchemaValue | None: + def_ref = self.json_to_defs_refs[json_ref] + if def_ref in self._core_defs_invalid_for_json_schema: + raise self._core_defs_invalid_for_json_schema[def_ref] + return self.definitions.get(def_ref, None) + + def encode_default(self, dft: Any) -> Any: + """Encode a default value to a JSON-serializable value. + + This is used to encode default values for fields in the generated JSON schema. + + Args: + dft: The default value to encode. + + Returns: + The encoded default value. + """ + config = self._config + return pydantic_core.to_jsonable_python( + dft, + timedelta_mode=config.ser_json_timedelta, + bytes_mode=config.ser_json_bytes, + ) + + def update_with_validations( + self, json_schema: JsonSchemaValue, core_schema: CoreSchema, mapping: dict[str, str] + ) -> None: + """Update the json_schema with the corresponding validations specified in the core_schema, + using the provided mapping to translate keys in core_schema to the appropriate keys for a JSON schema. + + Args: + json_schema: The JSON schema to update. + core_schema: The core schema to get the validations from. + mapping: A mapping from core_schema attribute names to the corresponding JSON schema attribute names. + """ + for core_key, json_schema_key in mapping.items(): + if core_key in core_schema: + json_schema[json_schema_key] = core_schema[core_key] + + class ValidationsMapping: + """This class just contains mappings from core_schema attribute names to the corresponding + JSON schema attribute names. While I suspect it is unlikely to be necessary, you can in + principle override this class in a subclass of GenerateJsonSchema (by inheriting from + GenerateJsonSchema.ValidationsMapping) to change these mappings. + """ + + numeric = { + 'multiple_of': 'multipleOf', + 'le': 'maximum', + 'ge': 'minimum', + 'lt': 'exclusiveMaximum', + 'gt': 'exclusiveMinimum', + } + bytes = { + 'min_length': 'minLength', + 'max_length': 'maxLength', + } + string = { + 'min_length': 'minLength', + 'max_length': 'maxLength', + 'pattern': 'pattern', + } + array = { + 'min_length': 'minItems', + 'max_length': 'maxItems', + } + object = { + 'min_length': 'minProperties', + 'max_length': 'maxProperties', + } + date = { + 'le': 'maximum', + 'ge': 'minimum', + 'lt': 'exclusiveMaximum', + 'gt': 'exclusiveMinimum', + } + + def get_flattened_anyof(self, schemas: list[JsonSchemaValue]) -> JsonSchemaValue: + members = [] + for schema in schemas: + if len(schema) == 1 and 'anyOf' in schema: + members.extend(schema['anyOf']) + else: + members.append(schema) + members = _deduplicate_schemas(members) + if len(members) == 1: + return members[0] + return {'anyOf': members} + + def get_json_ref_counts(self, json_schema: JsonSchemaValue) -> dict[JsonRef, int]: + """Get all values corresponding to the key '$ref' anywhere in the json_schema.""" + json_refs: dict[JsonRef, int] = Counter() + + def _add_json_refs(schema: Any) -> None: + if isinstance(schema, dict): + if '$ref' in schema: + json_ref = JsonRef(schema['$ref']) + if not isinstance(json_ref, str): + return # in this case, '$ref' might have been the name of a property + already_visited = json_ref in json_refs + json_refs[json_ref] += 1 + if already_visited: + return # prevent recursion on a definition that was already visited + defs_ref = self.json_to_defs_refs[json_ref] + if defs_ref in self._core_defs_invalid_for_json_schema: + raise self._core_defs_invalid_for_json_schema[defs_ref] + _add_json_refs(self.definitions[defs_ref]) + + for v in schema.values(): + _add_json_refs(v) + elif isinstance(schema, list): + for v in schema: + _add_json_refs(v) + + _add_json_refs(json_schema) + return json_refs + + def handle_invalid_for_json_schema(self, schema: CoreSchemaOrField, error_info: str) -> JsonSchemaValue: + raise PydanticInvalidForJsonSchema(f'Cannot generate a JsonSchema for {error_info}') + + def emit_warning(self, kind: JsonSchemaWarningKind, detail: str) -> None: + """This method simply emits PydanticJsonSchemaWarnings based on handling in the `warning_message` method.""" + message = self.render_warning_message(kind, detail) + if message is not None: + warnings.warn(message, PydanticJsonSchemaWarning) + + def render_warning_message(self, kind: JsonSchemaWarningKind, detail: str) -> str | None: + """This method is responsible for ignoring warnings as desired, and for formatting the warning messages. + + You can override the value of `ignored_warning_kinds` in a subclass of GenerateJsonSchema + to modify what warnings are generated. If you want more control, you can override this method; + just return None in situations where you don't want warnings to be emitted. + + Args: + kind: The kind of warning to render. It can be one of the following: + + - 'skipped-choice': A choice field was skipped because it had no valid choices. + - 'non-serializable-default': A default value was skipped because it was not JSON-serializable. + detail: A string with additional details about the warning. + + Returns: + The formatted warning message, or `None` if no warning should be emitted. + """ + if kind in self.ignored_warning_kinds: + return None + return f'{detail} [{kind}]' + + def _build_definitions_remapping(self) -> _DefinitionsRemapping: + defs_to_json: dict[DefsRef, JsonRef] = {} + for defs_refs in self._prioritized_defsref_choices.values(): + for defs_ref in defs_refs: + json_ref = JsonRef(self.ref_template.format(model=defs_ref)) + defs_to_json[defs_ref] = json_ref + + return _DefinitionsRemapping.from_prioritized_choices( + self._prioritized_defsref_choices, defs_to_json, self.definitions + ) + + def _garbage_collect_definitions(self, schema: JsonSchemaValue) -> None: + visited_defs_refs: set[DefsRef] = set() + unvisited_json_refs = _get_all_json_refs(schema) + while unvisited_json_refs: + next_json_ref = unvisited_json_refs.pop() + next_defs_ref = self.json_to_defs_refs[next_json_ref] + if next_defs_ref in visited_defs_refs: + continue + visited_defs_refs.add(next_defs_ref) + unvisited_json_refs.update(_get_all_json_refs(self.definitions[next_defs_ref])) + + self.definitions = {k: v for k, v in self.definitions.items() if k in visited_defs_refs} + + +# ##### Start JSON Schema Generation Functions ##### + + +def model_json_schema( + cls: type[BaseModel] | type[PydanticDataclass], + by_alias: bool = True, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, + mode: JsonSchemaMode = 'validation', +) -> dict[str, Any]: + """Utility function to generate a JSON Schema for a model. + + Args: + cls: The model class to generate a JSON Schema for. + by_alias: If `True` (the default), fields will be serialized according to their alias. + If `False`, fields will be serialized according to their attribute name. + ref_template: The template to use for generating JSON Schema references. + schema_generator: The class to use for generating the JSON Schema. + mode: The mode to use for generating the JSON Schema. It can be one of the following: + + - 'validation': Generate a JSON Schema for validating data. + - 'serialization': Generate a JSON Schema for serializing data. + + Returns: + The generated JSON Schema. + """ + schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template) + if isinstance(cls.__pydantic_validator__, _mock_val_ser.MockValSer): + cls.__pydantic_validator__.rebuild() + assert '__pydantic_core_schema__' in cls.__dict__, 'this is a bug! please report it' + return schema_generator_instance.generate(cls.__pydantic_core_schema__, mode=mode) + + +def models_json_schema( + models: Sequence[tuple[type[BaseModel] | type[PydanticDataclass], JsonSchemaMode]], + *, + by_alias: bool = True, + title: str | None = None, + description: str | None = None, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, +) -> tuple[dict[tuple[type[BaseModel] | type[PydanticDataclass], JsonSchemaMode], JsonSchemaValue], JsonSchemaValue]: + """Utility function to generate a JSON Schema for multiple models. + + Args: + models: A sequence of tuples of the form (model, mode). + by_alias: Whether field aliases should be used as keys in the generated JSON Schema. + title: The title of the generated JSON Schema. + description: The description of the generated JSON Schema. + ref_template: The reference template to use for generating JSON Schema references. + schema_generator: The schema generator to use for generating the JSON Schema. + + Returns: + A tuple where: + - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and + whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have + JsonRef references to definitions that are defined in the second returned element.) + - The second element is a JSON schema containing all definitions referenced in the first returned + element, along with the optional title and description keys. + """ + for cls, _ in models: + if isinstance(cls.__pydantic_validator__, _mock_val_ser.MockValSer): + cls.__pydantic_validator__.rebuild() + + instance = schema_generator(by_alias=by_alias, ref_template=ref_template) + inputs = [(m, mode, m.__pydantic_core_schema__) for m, mode in models] + json_schemas_map, definitions = instance.generate_definitions(inputs) + + json_schema: dict[str, Any] = {} + if definitions: + json_schema['$defs'] = definitions + if title: + json_schema['title'] = title + if description: + json_schema['description'] = description + + return json_schemas_map, json_schema + + +# ##### End JSON Schema Generation Functions ##### + + +_HashableJsonValue: TypeAlias = Union[ + int, float, str, bool, None, Tuple['_HashableJsonValue', ...], Tuple[Tuple[str, '_HashableJsonValue'], ...] +] + + +def _deduplicate_schemas(schemas: Iterable[JsonDict]) -> list[JsonDict]: + return list({_make_json_hashable(schema): schema for schema in schemas}.values()) + + +def _make_json_hashable(value: JsonValue) -> _HashableJsonValue: + if isinstance(value, dict): + return tuple(sorted((k, _make_json_hashable(v)) for k, v in value.items())) + elif isinstance(value, list): + return tuple(_make_json_hashable(v) for v in value) + else: + return value + + +def _sort_json_schema(value: JsonSchemaValue, parent_key: str | None = None) -> JsonSchemaValue: + if isinstance(value, dict): + sorted_dict: dict[str, JsonSchemaValue] = {} + keys = value.keys() + if (parent_key != 'properties') and (parent_key != 'default'): + keys = sorted(keys) + for key in keys: + sorted_dict[key] = _sort_json_schema(value[key], parent_key=key) + return sorted_dict + elif isinstance(value, list): + sorted_list: list[JsonSchemaValue] = [] + for item in value: # type: ignore + sorted_list.append(_sort_json_schema(item, parent_key)) + return sorted_list # type: ignore + else: + return value + + +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class WithJsonSchema: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/json_schema/#withjsonschema-annotation + + Add this as an annotation on a field to override the (base) JSON schema that would be generated for that field. + This provides a way to set a JSON schema for types that would otherwise raise errors when producing a JSON schema, + such as Callable, or types that have an is-instance core schema, without needing to go so far as creating a + custom subclass of pydantic.json_schema.GenerateJsonSchema. + Note that any _modifications_ to the schema that would normally be made (such as setting the title for model fields) + will still be performed. + + If `mode` is set this will only apply to that schema generation mode, allowing you + to set different json schemas for validation and serialization. + """ + + json_schema: JsonSchemaValue | None + mode: Literal['validation', 'serialization'] | None = None + + def __get_pydantic_json_schema__( + self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + mode = self.mode or handler.mode + if mode != handler.mode: + return handler(core_schema) + if self.json_schema is None: + # This exception is handled in pydantic.json_schema.GenerateJsonSchema._named_required_fields_schema + raise PydanticOmit + else: + return self.json_schema + + def __hash__(self) -> int: + return hash(type(self.mode)) + + +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class Examples: + """Add examples to a JSON schema. + + Examples should be a map of example names (strings) + to example values (any valid JSON). + + If `mode` is set this will only apply to that schema generation mode, + allowing you to add different examples for validation and serialization. + """ + + examples: dict[str, Any] + mode: Literal['validation', 'serialization'] | None = None + + def __get_pydantic_json_schema__( + self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + mode = self.mode or handler.mode + json_schema = handler(core_schema) + if mode != handler.mode: + return json_schema + examples = json_schema.get('examples', {}) + examples.update(to_jsonable_python(self.examples)) + json_schema['examples'] = examples + return json_schema + + def __hash__(self) -> int: + return hash(type(self.mode)) + + +def _get_all_json_refs(item: Any) -> set[JsonRef]: + """Get all the definitions references from a JSON schema.""" + refs: set[JsonRef] = set() + if isinstance(item, dict): + for key, value in item.items(): + if key == '$ref' and isinstance(value, str): + # the isinstance check ensures that '$ref' isn't the name of a property, etc. + refs.add(JsonRef(value)) + elif isinstance(value, dict): + refs.update(_get_all_json_refs(value)) + elif isinstance(value, list): + for item in value: + refs.update(_get_all_json_refs(item)) + elif isinstance(item, list): + for item in item: + refs.update(_get_all_json_refs(item)) + return refs + + +AnyType = TypeVar('AnyType') + +if TYPE_CHECKING: + SkipJsonSchema = Annotated[AnyType, ...] +else: + + @dataclasses.dataclass(**_internal_dataclass.slots_true) + class SkipJsonSchema: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/json_schema/#skipjsonschema-annotation + + Add this as an annotation on a field to skip generating a JSON schema for that field. + + Example: + ```py + from typing import Union + + from pydantic import BaseModel + from pydantic.json_schema import SkipJsonSchema + + from pprint import pprint + + + class Model(BaseModel): + a: Union[int, None] = None # (1)! + b: Union[int, SkipJsonSchema[None]] = None # (2)! + c: SkipJsonSchema[Union[int, None]] = None # (3)! + + + pprint(Model.model_json_schema()) + ''' + { + 'properties': { + 'a': { + 'anyOf': [ + {'type': 'integer'}, + {'type': 'null'} + ], + 'default': None, + 'title': 'A' + }, + 'b': { + 'default': None, + 'title': 'B', + 'type': 'integer' + } + }, + 'title': 'Model', + 'type': 'object' + } + ''' + ``` + + 1. The integer and null types are both included in the schema for `a`. + 2. The integer type is the only type included in the schema for `b`. + 3. The entirety of the `c` field is omitted from the schema. + """ + + def __class_getitem__(cls, item: AnyType) -> AnyType: + return Annotated[item, cls()] + + def __get_pydantic_json_schema__( + self, core_schema: CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + raise PydanticOmit + + def __hash__(self) -> int: + return hash(type(self)) + + +def _get_typed_dict_config(schema: core_schema.TypedDictSchema) -> ConfigDict: + metadata = _core_metadata.CoreMetadataHandler(schema).metadata + cls = metadata.get('pydantic_typed_dict_cls') + if cls is not None: + try: + return _decorators.get_attribute_from_bases(cls, '__pydantic_config__') + except AttributeError: + pass + return {} diff --git a/lib/pydantic/main.py b/lib/pydantic/main.py index 69f3b751..8c7ebbbf 100644 --- a/lib/pydantic/main.py +++ b/lib/pydantic/main.py @@ -1,980 +1,1434 @@ +"""Logic for creating models.""" +from __future__ import annotations as _annotations + +import operator +import sys +import types +import typing import warnings -from abc import ABCMeta -from copy import deepcopy -from enum import Enum -from functools import partial -from pathlib import Path -from types import FunctionType, prepare_class, resolve_bases -from typing import ( - TYPE_CHECKING, - AbstractSet, - Any, - Callable, - ClassVar, - Dict, - List, - Mapping, - Optional, - Tuple, - Type, - TypeVar, - Union, - cast, - no_type_check, - overload, -) +from copy import copy, deepcopy +from typing import Any, ClassVar -from typing_extensions import dataclass_transform +import pydantic_core +import typing_extensions +from pydantic_core import PydanticUndefined -from .class_validators import ValidatorGroup, extract_root_validators, extract_validators, inherit_validators -from .config import BaseConfig, Extra, inherit_config, prepare_config -from .error_wrappers import ErrorWrapper, ValidationError -from .errors import ConfigError, DictError, ExtraError, MissingError -from .fields import ( - MAPPING_LIKE_SHAPES, - Field, - FieldInfo, - ModelField, - ModelPrivateAttr, - PrivateAttr, - Undefined, - is_finalvar_with_default_val, -) -from .json import custom_pydantic_encoder, pydantic_encoder -from .parse import Protocol, load_file, load_str_bytes -from .schema import default_ref_template, model_schema -from .types import PyObject, StrBytes -from .typing import ( - AnyCallable, - get_args, - get_origin, - is_classvar, - is_namedtuple, - is_union, - resolve_annotations, - update_model_forward_refs, -) -from .utils import ( - DUNDER_ATTRIBUTES, - ROOT_KEY, - ClassAttribute, - GetterDict, - Representation, - ValueItems, - generate_model_signature, - is_valid_field, - is_valid_private_name, - lenient_issubclass, - sequence_like, - smart_deepcopy, - unique_list, - validate_field_name, +from ._internal import ( + _config, + _decorators, + _fields, + _forward_ref, + _generics, + _mock_val_ser, + _model_construction, + _repr, + _typing_extra, + _utils, ) +from ._migration import getattr_migration +from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler +from .config import ConfigDict +from .errors import PydanticUndefinedAnnotation, PydanticUserError +from .json_schema import DEFAULT_REF_TEMPLATE, GenerateJsonSchema, JsonSchemaMode, JsonSchemaValue, model_json_schema +from .warnings import PydanticDeprecatedSince20 -if TYPE_CHECKING: +if typing.TYPE_CHECKING: from inspect import Signature + from pathlib import Path - from .class_validators import ValidatorListDict - from .types import ModelOrDc - from .typing import ( - AbstractSetIntStr, - AnyClassMethod, - CallableGenerator, - DictAny, - DictStrAny, - MappingIntStrAny, - ReprArgs, - SetStr, - TupleGenerator, - ) + from pydantic_core import CoreSchema, SchemaSerializer, SchemaValidator + from typing_extensions import Literal, Unpack - Model = TypeVar('Model', bound='BaseModel') + from ._internal._utils import AbstractSetIntStr, MappingIntStrAny + from .deprecated.parse import Protocol as DeprecatedParseProtocol + from .fields import ComputedFieldInfo, FieldInfo, ModelPrivateAttr + from .fields import Field as _Field -__all__ = 'BaseModel', 'create_model', 'validate_model' + TupleGenerator = typing.Generator[typing.Tuple[str, Any], None, None] + Model = typing.TypeVar('Model', bound='BaseModel') + # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope + IncEx: typing_extensions.TypeAlias = 'set[int] | set[str] | dict[int, Any] | dict[str, Any] | None' +else: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 -_T = TypeVar('_T') +__all__ = 'BaseModel', 'create_model' + +_object_setattr = _model_construction.object_setattr -def validate_custom_root_type(fields: Dict[str, ModelField]) -> None: - if len(fields) > 1: - raise ValueError(f'{ROOT_KEY} cannot be mixed with other fields') +class BaseModel(metaclass=_model_construction.ModelMetaclass): + """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/ + A base class for creating Pydantic models. -def generate_hash_function(frozen: bool) -> Optional[Callable[[Any], int]]: - def hash_function(self_: Any) -> int: - return hash(self_.__class__) + hash(tuple(self_.__dict__.values())) + Attributes: + __class_vars__: The names of classvars defined on the model. + __private_attributes__: Metadata about the private attributes of the model. + __signature__: The signature for instantiating the model. - return hash_function if frozen else None + __pydantic_complete__: Whether model building is completed, or if there are still undefined fields. + __pydantic_core_schema__: The pydantic-core schema used to build the SchemaValidator and SchemaSerializer. + __pydantic_custom_init__: Whether the model has a custom `__init__` function. + __pydantic_decorators__: Metadata containing the decorators defined on the model. + This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1. + __pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to + __args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these. + __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models. + __pydantic_post_init__: The name of the post-init method for the model, if defined. + __pydantic_root_model__: Whether the model is a `RootModel`. + __pydantic_serializer__: The pydantic-core SchemaSerializer used to dump instances of the model. + __pydantic_validator__: The pydantic-core SchemaValidator used to validate instances of the model. + __pydantic_extra__: An instance attribute with the values of extra fields from validation when + `model_config['extra'] == 'allow'`. + __pydantic_fields_set__: An instance attribute with the names of fields explicitly set. + __pydantic_private__: Instance attribute with the values of private attributes set on the model instance. + """ -# If a field is of type `Callable`, its default value should be a function and cannot to ignored. -ANNOTATED_FIELD_UNTOUCHED_TYPES: Tuple[Any, ...] = (property, type, classmethod, staticmethod) -# When creating a `BaseModel` instance, we bypass all the methods, properties... added to the model -UNTOUCHED_TYPES: Tuple[Any, ...] = (FunctionType,) + ANNOTATED_FIELD_UNTOUCHED_TYPES -# Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we need to add this extra -# (somewhat hacky) boolean to keep track of whether we've created the `BaseModel` class yet, and therefore whether it's -# safe to refer to it. If it *hasn't* been created, we assume that the `__new__` call we're in the middle of is for -# the `BaseModel` class, since that's defined immediately after the metaclass. -_is_base_model_class_defined = False + if typing.TYPE_CHECKING: + # Here we provide annotations for the attributes of BaseModel. + # Many of these are populated by the metaclass, which is why this section is in a `TYPE_CHECKING` block. + # However, for the sake of easy review, we have included type annotations of all class and instance attributes + # of `BaseModel` here: + # Class attributes + model_config: ClassVar[ConfigDict] + """ + Configuration for the model, should be a dictionary conforming to [`ConfigDict`][pydantic.config.ConfigDict]. + """ -@dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo)) -class ModelMetaclass(ABCMeta): - @no_type_check # noqa C901 - def __new__(mcs, name, bases, namespace, **kwargs): # noqa C901 - fields: Dict[str, ModelField] = {} - config = BaseConfig - validators: 'ValidatorListDict' = {} + model_fields: ClassVar[dict[str, FieldInfo]] + """ + Metadata about the fields defined on the model, + mapping of field names to [`FieldInfo`][pydantic.fields.FieldInfo]. - pre_root_validators, post_root_validators = [], [] - private_attributes: Dict[str, ModelPrivateAttr] = {} - base_private_attributes: Dict[str, ModelPrivateAttr] = {} - slots: SetStr = namespace.get('__slots__', ()) - slots = {slots} if isinstance(slots, str) else set(slots) - class_vars: SetStr = set() - hash_func: Optional[Callable[[Any], int]] = None + This replaces `Model.__fields__` from Pydantic V1. + """ - for base in reversed(bases): - if _is_base_model_class_defined and issubclass(base, BaseModel) and base != BaseModel: - fields.update(smart_deepcopy(base.__fields__)) - config = inherit_config(base.__config__, config) - validators = inherit_validators(base.__validators__, validators) - pre_root_validators += base.__pre_root_validators__ - post_root_validators += base.__post_root_validators__ - base_private_attributes.update(base.__private_attributes__) - class_vars.update(base.__class_vars__) - hash_func = base.__hash__ + model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] + """A dictionary of computed field names and their corresponding `ComputedFieldInfo` objects.""" - resolve_forward_refs = kwargs.pop('__resolve_forward_refs__', True) - allowed_config_kwargs: SetStr = { - key - for key in dir(config) - if not (key.startswith('__') and key.endswith('__')) # skip dunder methods and attributes - } - config_kwargs = {key: kwargs.pop(key) for key in kwargs.keys() & allowed_config_kwargs} - config_from_namespace = namespace.get('Config') - if config_kwargs and config_from_namespace: - raise TypeError('Specifying config in two places is ambiguous, use either Config attribute or class kwargs') - config = inherit_config(config_from_namespace, config, **config_kwargs) + __class_vars__: ClassVar[set[str]] + __private_attributes__: ClassVar[dict[str, ModelPrivateAttr]] + __signature__: ClassVar[Signature] - validators = inherit_validators(extract_validators(namespace), validators) - vg = ValidatorGroup(validators) + __pydantic_complete__: ClassVar[bool] + __pydantic_core_schema__: ClassVar[CoreSchema] + __pydantic_custom_init__: ClassVar[bool] + __pydantic_decorators__: ClassVar[_decorators.DecoratorInfos] + __pydantic_generic_metadata__: ClassVar[_generics.PydanticGenericMetadata] + __pydantic_parent_namespace__: ClassVar[dict[str, Any] | None] + __pydantic_post_init__: ClassVar[None | Literal['model_post_init']] + __pydantic_root_model__: ClassVar[bool] + __pydantic_serializer__: ClassVar[SchemaSerializer] + __pydantic_validator__: ClassVar[SchemaValidator] - for f in fields.values(): - f.set_config(config) - extra_validators = vg.get_validators(f.name) - if extra_validators: - f.class_validators.update(extra_validators) - # re-run prepare to add extra validators - f.populate_validators() + # Instance attributes + # Note: we use the non-existent kwarg `init=False` in pydantic.fields.Field below so that @dataclass_transform + # doesn't think these are valid as keyword arguments to the class initializer. + __pydantic_extra__: dict[str, Any] | None = _Field(init=False) # type: ignore + __pydantic_fields_set__: set[str] = _Field(init=False) # type: ignore + __pydantic_private__: dict[str, Any] | None = _Field(init=False) # type: ignore - prepare_config(config, name) + else: + # `model_fields` and `__pydantic_decorators__` must be set for + # pydantic._internal._generate_schema.GenerateSchema.model_schema to work for a plain BaseModel annotation + model_fields = {} + model_computed_fields = {} - untouched_types = ANNOTATED_FIELD_UNTOUCHED_TYPES + __pydantic_decorators__ = _decorators.DecoratorInfos() + __pydantic_parent_namespace__ = None + # Prevent `BaseModel` from being instantiated directly: + __pydantic_validator__ = _mock_val_ser.MockValSer( + 'Pydantic models should inherit from BaseModel, BaseModel cannot be instantiated directly', + val_or_ser='validator', + code='base-model-instantiated', + ) + __pydantic_serializer__ = _mock_val_ser.MockValSer( + 'Pydantic models should inherit from BaseModel, BaseModel cannot be instantiated directly', + val_or_ser='serializer', + code='base-model-instantiated', + ) - def is_untouched(v: Any) -> bool: - return isinstance(v, untouched_types) or v.__class__.__name__ == 'cython_function_or_method' + __slots__ = '__dict__', '__pydantic_fields_set__', '__pydantic_extra__', '__pydantic_private__' - if (namespace.get('__module__'), namespace.get('__qualname__')) != ('pydantic.main', 'BaseModel'): - annotations = resolve_annotations(namespace.get('__annotations__', {}), namespace.get('__module__', None)) - # annotation only fields need to come first in fields - for ann_name, ann_type in annotations.items(): - if is_classvar(ann_type): - class_vars.add(ann_name) - elif is_finalvar_with_default_val(ann_type, namespace.get(ann_name, Undefined)): - class_vars.add(ann_name) - elif is_valid_field(ann_name): - validate_field_name(bases, ann_name) - value = namespace.get(ann_name, Undefined) - allowed_types = get_args(ann_type) if is_union(get_origin(ann_type)) else (ann_type,) - if ( - is_untouched(value) - and ann_type != PyObject - and not any( - lenient_issubclass(get_origin(allowed_type), Type) for allowed_type in allowed_types - ) - ): - continue - fields[ann_name] = ModelField.infer( - name=ann_name, - value=value, - annotation=ann_type, - class_validators=vg.get_validators(ann_name), - config=config, - ) - elif ann_name not in namespace and config.underscore_attrs_are_private: - private_attributes[ann_name] = PrivateAttr() + model_config = ConfigDict() + __pydantic_complete__ = False + __pydantic_root_model__ = False - untouched_types = UNTOUCHED_TYPES + config.keep_untouched - for var_name, value in namespace.items(): - can_be_changed = var_name not in class_vars and not is_untouched(value) - if isinstance(value, ModelPrivateAttr): - if not is_valid_private_name(var_name): - raise NameError( - f'Private attributes "{var_name}" must not be a valid field name; ' - f'Use sunder or dunder names, e. g. "_{var_name}" or "__{var_name}__"' - ) - private_attributes[var_name] = value - elif config.underscore_attrs_are_private and is_valid_private_name(var_name) and can_be_changed: - private_attributes[var_name] = PrivateAttr(default=value) - elif is_valid_field(var_name) and var_name not in annotations and can_be_changed: - validate_field_name(bases, var_name) - inferred = ModelField.infer( - name=var_name, - value=value, - annotation=annotations.get(var_name, Undefined), - class_validators=vg.get_validators(var_name), - config=config, - ) - if var_name in fields: - if lenient_issubclass(inferred.type_, fields[var_name].type_): - inferred.type_ = fields[var_name].type_ - else: - raise TypeError( - f'The type of {name}.{var_name} differs from the new default value; ' - f'if you wish to change the type of this field, please use a type annotation' - ) - fields[var_name] = inferred + def __init__(self, /, **data: Any) -> None: # type: ignore + """Create a new model by parsing and validating input data from keyword arguments. - _custom_root_type = ROOT_KEY in fields - if _custom_root_type: - validate_custom_root_type(fields) - vg.check_for_unused() - if config.json_encoders: - json_encoder = partial(custom_pydantic_encoder, config.json_encoders) + Raises [`ValidationError`][pydantic_core.ValidationError] if the input data cannot be + validated to form a valid model. + + `self` is explicitly positional-only to allow `self` as a field name. + """ + # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks + __tracebackhide__ = True + self.__pydantic_validator__.validate_python(data, self_instance=self) + + # The following line sets a flag that we use to determine when `__init__` gets overridden by the user + __init__.__pydantic_base_init__ = True # pyright: ignore[reportFunctionMemberAccess] + + @property + def model_extra(self) -> dict[str, Any] | None: + """Get extra fields set during validation. + + Returns: + A dictionary of extra fields, or `None` if `config.extra` is not set to `"allow"`. + """ + return self.__pydantic_extra__ + + @property + def model_fields_set(self) -> set[str]: + """Returns the set of fields that have been explicitly set on this model instance. + + Returns: + A set of strings representing the fields that have been set, + i.e. that were not filled from defaults. + """ + return self.__pydantic_fields_set__ + + @classmethod + def model_construct(cls: type[Model], _fields_set: set[str] | None = None, **values: Any) -> Model: + """Creates a new instance of the `Model` class with validated data. + + Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data. + Default values are respected, but no other validation is performed. + Behaves as if `Config.extra = 'allow'` was set since it adds all passed values + + Args: + _fields_set: The set of field names accepted for the Model instance. + values: Trusted or pre-validated data dictionary. + + Returns: + A new instance of the `Model` class with validated data. + """ + m = cls.__new__(cls) + fields_values: dict[str, Any] = {} + fields_set = set() + + for name, field in cls.model_fields.items(): + if field.alias and field.alias in values: + fields_values[name] = values.pop(field.alias) + fields_set.add(name) + elif name in values: + fields_values[name] = values.pop(name) + fields_set.add(name) + elif not field.is_required(): + fields_values[name] = field.get_default(call_default_factory=True) + if _fields_set is None: + _fields_set = fields_set + + _extra: dict[str, Any] | None = None + if cls.model_config.get('extra') == 'allow': + _extra = {} + for k, v in values.items(): + _extra[k] = v else: - json_encoder = pydantic_encoder - pre_rv_new, post_rv_new = extract_root_validators(namespace) + fields_values.update(values) + _object_setattr(m, '__dict__', fields_values) + _object_setattr(m, '__pydantic_fields_set__', _fields_set) + if not cls.__pydantic_root_model__: + _object_setattr(m, '__pydantic_extra__', _extra) - if hash_func is None: - hash_func = generate_hash_function(config.frozen) + if cls.__pydantic_post_init__: + m.model_post_init(None) + # update private attributes with values set + if hasattr(m, '__pydantic_private__') and m.__pydantic_private__ is not None: + for k, v in values.items(): + if k in m.__private_attributes__: + m.__pydantic_private__[k] = v - exclude_from_namespace = fields | private_attributes.keys() | {'__slots__'} - new_namespace = { - '__config__': config, - '__fields__': fields, - '__exclude_fields__': { - name: field.field_info.exclude for name, field in fields.items() if field.field_info.exclude is not None - } - or None, - '__include_fields__': { - name: field.field_info.include for name, field in fields.items() if field.field_info.include is not None - } - or None, - '__validators__': vg.validators, - '__pre_root_validators__': unique_list( - pre_root_validators + pre_rv_new, - name_factory=lambda v: v.__name__, - ), - '__post_root_validators__': unique_list( - post_root_validators + post_rv_new, - name_factory=lambda skip_on_failure_and_v: skip_on_failure_and_v[1].__name__, - ), - '__schema_cache__': {}, - '__json_encoder__': staticmethod(json_encoder), - '__custom_root_type__': _custom_root_type, - '__private_attributes__': {**base_private_attributes, **private_attributes}, - '__slots__': slots | private_attributes.keys(), - '__hash__': hash_func, - '__class_vars__': class_vars, - **{n: v for n, v in namespace.items() if n not in exclude_from_namespace}, - } + elif not cls.__pydantic_root_model__: + # Note: if there are any private attributes, cls.__pydantic_post_init__ would exist + # Since it doesn't, that means that `__pydantic_private__` should be set to None + _object_setattr(m, '__pydantic_private__', None) - cls = super().__new__(mcs, name, bases, new_namespace, **kwargs) - # set __signature__ attr only for model class, but not for its instances - cls.__signature__ = ClassAttribute('__signature__', generate_model_signature(cls.__init__, fields, config)) - if resolve_forward_refs: - cls.__try_update_forward_refs__() + return m - # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487 - # for attributes not in `new_namespace` (e.g. private attributes) - for name, obj in namespace.items(): - if name not in new_namespace: - set_name = getattr(obj, '__set_name__', None) - if callable(set_name): - set_name(cls, name) + def model_copy(self: Model, *, update: dict[str, Any] | None = None, deep: bool = False) -> Model: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/serialization/#model_copy - return cls + Returns a copy of the model. - def __instancecheck__(self, instance: Any) -> bool: + Args: + update: Values to change/add in the new model. Note: the data is not validated + before creating the new model. You should trust this data. + deep: Set to `True` to make a deep copy of the model. + + Returns: + New model instance. """ - Avoid calling ABC _abc_subclasscheck unless we're pretty sure. + copied = self.__deepcopy__() if deep else self.__copy__() + if update: + if self.model_config.get('extra') == 'allow': + for k, v in update.items(): + if k in self.model_fields: + copied.__dict__[k] = v + else: + if copied.__pydantic_extra__ is None: + copied.__pydantic_extra__ = {} + copied.__pydantic_extra__[k] = v + else: + copied.__dict__.update(update) + copied.__pydantic_fields_set__.update(update.keys()) + return copied - See #3829 and python/cpython#92810 - """ - return hasattr(instance, '__fields__') and super().__instancecheck__(instance) - - -object_setattr = object.__setattr__ - - -class BaseModel(Representation, metaclass=ModelMetaclass): - if TYPE_CHECKING: - # populated by the metaclass, defined here to help IDEs only - __fields__: ClassVar[Dict[str, ModelField]] = {} - __include_fields__: ClassVar[Optional[Mapping[str, Any]]] = None - __exclude_fields__: ClassVar[Optional[Mapping[str, Any]]] = None - __validators__: ClassVar[Dict[str, AnyCallable]] = {} - __pre_root_validators__: ClassVar[List[AnyCallable]] - __post_root_validators__: ClassVar[List[Tuple[bool, AnyCallable]]] - __config__: ClassVar[Type[BaseConfig]] = BaseConfig - __json_encoder__: ClassVar[Callable[[Any], Any]] = lambda x: x - __schema_cache__: ClassVar['DictAny'] = {} - __custom_root_type__: ClassVar[bool] = False - __signature__: ClassVar['Signature'] - __private_attributes__: ClassVar[Dict[str, ModelPrivateAttr]] - __class_vars__: ClassVar[SetStr] - __fields_set__: ClassVar[SetStr] = set() - - Config = BaseConfig - __slots__ = ('__dict__', '__fields_set__') - __doc__ = '' # Null out the Representation docstring - - def __init__(__pydantic_self__, **data: Any) -> None: - """ - Create a new model by parsing and validating input data from keyword arguments. - - Raises ValidationError if the input data cannot be parsed to form a valid model. - """ - # Uses something other than `self` the first arg to allow "self" as a settable attribute - values, fields_set, validation_error = validate_model(__pydantic_self__.__class__, data) - if validation_error: - raise validation_error - try: - object_setattr(__pydantic_self__, '__dict__', values) - except TypeError as e: - raise TypeError( - 'Model values must be a dict; you may not have returned a dictionary from a root validator' - ) from e - object_setattr(__pydantic_self__, '__fields_set__', fields_set) - __pydantic_self__._init_private_attributes() - - @no_type_check - def __setattr__(self, name, value): # noqa: C901 (ignore complexity) - if name in self.__private_attributes__ or name in DUNDER_ATTRIBUTES: - return object_setattr(self, name, value) - - if self.__config__.extra is not Extra.allow and name not in self.__fields__: - raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"') - elif not self.__config__.allow_mutation or self.__config__.frozen: - raise TypeError(f'"{self.__class__.__name__}" is immutable and does not support item assignment') - elif name in self.__fields__ and self.__fields__[name].final: - raise TypeError( - f'"{self.__class__.__name__}" object "{name}" field is final and does not support reassignment' - ) - elif self.__config__.validate_assignment: - new_values = {**self.__dict__, name: value} - - for validator in self.__pre_root_validators__: - try: - new_values = validator(self.__class__, new_values) - except (ValueError, TypeError, AssertionError) as exc: - raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], self.__class__) - - known_field = self.__fields__.get(name, None) - if known_field: - # We want to - # - make sure validators are called without the current value for this field inside `values` - # - keep other values (e.g. submodels) untouched (using `BaseModel.dict()` will change them into dicts) - # - keep the order of the fields - if not known_field.field_info.allow_mutation: - raise TypeError(f'"{known_field.name}" has allow_mutation set to False and cannot be assigned') - dict_without_original_value = {k: v for k, v in self.__dict__.items() if k != name} - value, error_ = known_field.validate(value, dict_without_original_value, loc=name, cls=self.__class__) - if error_: - raise ValidationError([error_], self.__class__) - else: - new_values[name] = value - - errors = [] - for skip_on_failure, validator in self.__post_root_validators__: - if skip_on_failure and errors: - continue - try: - new_values = validator(self.__class__, new_values) - except (ValueError, TypeError, AssertionError) as exc: - errors.append(ErrorWrapper(exc, loc=ROOT_KEY)) - if errors: - raise ValidationError(errors, self.__class__) - - # update the whole __dict__ as other values than just `value` - # may be changed (e.g. with `root_validator`) - object_setattr(self, '__dict__', new_values) - else: - self.__dict__[name] = value - - self.__fields_set__.add(name) - - def __getstate__(self) -> 'DictAny': - private_attrs = ((k, getattr(self, k, Undefined)) for k in self.__private_attributes__) - return { - '__dict__': self.__dict__, - '__fields_set__': self.__fields_set__, - '__private_attribute_values__': {k: v for k, v in private_attrs if v is not Undefined}, - } - - def __setstate__(self, state: 'DictAny') -> None: - object_setattr(self, '__dict__', state['__dict__']) - object_setattr(self, '__fields_set__', state['__fields_set__']) - for name, value in state.get('__private_attribute_values__', {}).items(): - object_setattr(self, name, value) - - def _init_private_attributes(self) -> None: - for name, private_attr in self.__private_attributes__.items(): - default = private_attr.get_default() - if default is not Undefined: - object_setattr(self, name, default) - - def dict( + def model_dump( self, *, - include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, - exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + mode: Literal['json', 'python'] | str = 'python', + include: IncEx = None, + exclude: IncEx = None, by_alias: bool = False, - skip_defaults: Optional[bool] = None, exclude_unset: bool = False, exclude_defaults: bool = False, exclude_none: bool = False, - ) -> 'DictStrAny': - """ + round_trip: bool = False, + warnings: bool = True, + ) -> dict[str, Any]: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/serialization/#modelmodel_dump + Generate a dictionary representation of the model, optionally specifying which fields to include or exclude. - """ - if skip_defaults is not None: - warnings.warn( - f'{self.__class__.__name__}.dict(): "skip_defaults" is deprecated and replaced by "exclude_unset"', - DeprecationWarning, - ) - exclude_unset = skip_defaults + Args: + mode: The mode in which `to_python` should run. + If mode is 'json', the output will only contain JSON serializable types. + If mode is 'python', the output may contain non-JSON-serializable Python objects. + include: A list of fields to include in the output. + exclude: A list of fields to exclude from the output. + by_alias: Whether to use the field's alias in the dictionary key if defined. + exclude_unset: Whether to exclude fields that have not been explicitly set. + exclude_defaults: Whether to exclude fields that are set to their default value. + exclude_none: Whether to exclude fields that have a value of `None`. + round_trip: If True, dumped values should be valid as input for non-idempotent types such as Json[T]. + warnings: Whether to log warnings when invalid fields are encountered. - return dict( - self._iter( - to_dict=True, - by_alias=by_alias, - include=include, - exclude=exclude, - exclude_unset=exclude_unset, - exclude_defaults=exclude_defaults, - exclude_none=exclude_none, - ) + Returns: + A dictionary representation of the model. + """ + return self.__pydantic_serializer__.to_python( + self, + mode=mode, + by_alias=by_alias, + include=include, + exclude=exclude, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + round_trip=round_trip, + warnings=warnings, ) - def json( + def model_dump_json( self, *, - include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, - exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + indent: int | None = None, + include: IncEx = None, + exclude: IncEx = None, by_alias: bool = False, - skip_defaults: Optional[bool] = None, exclude_unset: bool = False, exclude_defaults: bool = False, exclude_none: bool = False, - encoder: Optional[Callable[[Any], Any]] = None, - models_as_dict: bool = True, + round_trip: bool = False, + warnings: bool = True, + ) -> str: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/serialization/#modelmodel_dump_json + + Generates a JSON representation of the model using Pydantic's `to_json` method. + + Args: + indent: Indentation to use in the JSON output. If None is passed, the output will be compact. + include: Field(s) to include in the JSON output. + exclude: Field(s) to exclude from the JSON output. + by_alias: Whether to serialize using field aliases. + exclude_unset: Whether to exclude fields that have not been explicitly set. + exclude_defaults: Whether to exclude fields that are set to their default value. + exclude_none: Whether to exclude fields that have a value of `None`. + round_trip: If True, dumped values should be valid as input for non-idempotent types such as Json[T]. + warnings: Whether to log warnings when invalid fields are encountered. + + Returns: + A JSON string representation of the model. + """ + return self.__pydantic_serializer__.to_json( + self, + indent=indent, + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + round_trip=round_trip, + warnings=warnings, + ).decode() + + @classmethod + def model_json_schema( + cls, + by_alias: bool = True, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, + mode: JsonSchemaMode = 'validation', + ) -> dict[str, Any]: + """Generates a JSON schema for a model class. + + Args: + by_alias: Whether to use attribute aliases or not. + ref_template: The reference template. + schema_generator: To override the logic used to generate the JSON schema, as a subclass of + `GenerateJsonSchema` with your desired modifications + mode: The mode in which to generate the schema. + + Returns: + The JSON schema for the given model class. + """ + return model_json_schema( + cls, by_alias=by_alias, ref_template=ref_template, schema_generator=schema_generator, mode=mode + ) + + @classmethod + def model_parametrized_name(cls, params: tuple[type[Any], ...]) -> str: + """Compute the class name for parametrizations of generic classes. + + This method can be overridden to achieve a custom naming scheme for generic BaseModels. + + Args: + params: Tuple of types of the class. Given a generic class + `Model` with 2 type variables and a concrete model `Model[str, int]`, + the value `(str, int)` would be passed to `params`. + + Returns: + String representing the new class where `params` are passed to `cls` as type variables. + + Raises: + TypeError: Raised when trying to generate concrete names for non-generic models. + """ + if not issubclass(cls, typing.Generic): + raise TypeError('Concrete names should only be generated for generic models.') + + # Any strings received should represent forward references, so we handle them specially below. + # If we eventually move toward wrapping them in a ForwardRef in __class_getitem__ in the future, + # we may be able to remove this special case. + param_names = [param if isinstance(param, str) else _repr.display_as_type(param) for param in params] + params_component = ', '.join(param_names) + return f'{cls.__name__}[{params_component}]' + + def model_post_init(self, __context: Any) -> None: + """Override this method to perform additional initialization after `__init__` and `model_construct`. + This is useful if you want to do some validation that requires the entire model to be initialized. + """ + pass + + @classmethod + def model_rebuild( + cls, + *, + force: bool = False, + raise_errors: bool = True, + _parent_namespace_depth: int = 2, + _types_namespace: dict[str, Any] | None = None, + ) -> bool | None: + """Try to rebuild the pydantic-core schema for the model. + + This may be necessary when one of the annotations is a ForwardRef which could not be resolved during + the initial attempt to build the schema, and automatic rebuilding fails. + + Args: + force: Whether to force the rebuilding of the model schema, defaults to `False`. + raise_errors: Whether to raise errors, defaults to `True`. + _parent_namespace_depth: The depth level of the parent namespace, defaults to 2. + _types_namespace: The types namespace, defaults to `None`. + + Returns: + Returns `None` if the schema is already "complete" and rebuilding was not required. + If rebuilding _was_ required, returns `True` if rebuilding was successful, otherwise `False`. + """ + if not force and cls.__pydantic_complete__: + return None + else: + if '__pydantic_core_schema__' in cls.__dict__: + delattr(cls, '__pydantic_core_schema__') # delete cached value to ensure full rebuild happens + if _types_namespace is not None: + types_namespace: dict[str, Any] | None = _types_namespace.copy() + else: + if _parent_namespace_depth > 0: + frame_parent_ns = _typing_extra.parent_frame_namespace(parent_depth=_parent_namespace_depth) or {} + cls_parent_ns = ( + _model_construction.unpack_lenient_weakvaluedict(cls.__pydantic_parent_namespace__) or {} + ) + types_namespace = {**cls_parent_ns, **frame_parent_ns} + cls.__pydantic_parent_namespace__ = _model_construction.build_lenient_weakvaluedict(types_namespace) + else: + types_namespace = _model_construction.unpack_lenient_weakvaluedict( + cls.__pydantic_parent_namespace__ + ) + + types_namespace = _typing_extra.get_cls_types_namespace(cls, types_namespace) + + # manually override defer_build so complete_model_class doesn't skip building the model again + config = {**cls.model_config, 'defer_build': False} + return _model_construction.complete_model_class( + cls, + cls.__name__, + _config.ConfigWrapper(config, check=False), + raise_errors=raise_errors, + types_namespace=types_namespace, + ) + + @classmethod + def model_validate( + cls: type[Model], + obj: Any, + *, + strict: bool | None = None, + from_attributes: bool | None = None, + context: dict[str, Any] | None = None, + ) -> Model: + """Validate a pydantic model instance. + + Args: + obj: The object to validate. + strict: Whether to enforce types strictly. + from_attributes: Whether to extract data from object attributes. + context: Additional context to pass to the validator. + + Raises: + ValidationError: If the object could not be validated. + + Returns: + The validated model instance. + """ + # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks + __tracebackhide__ = True + return cls.__pydantic_validator__.validate_python( + obj, strict=strict, from_attributes=from_attributes, context=context + ) + + @classmethod + def model_validate_json( + cls: type[Model], + json_data: str | bytes | bytearray, + *, + strict: bool | None = None, + context: dict[str, Any] | None = None, + ) -> Model: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/json/#json-parsing + + Validate the given JSON data against the Pydantic model. + + Args: + json_data: The JSON data to validate. + strict: Whether to enforce types strictly. + context: Extra variables to pass to the validator. + + Returns: + The validated Pydantic model. + + Raises: + ValueError: If `json_data` is not a JSON string. + """ + # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks + __tracebackhide__ = True + return cls.__pydantic_validator__.validate_json(json_data, strict=strict, context=context) + + @classmethod + def model_validate_strings( + cls: type[Model], + obj: Any, + *, + strict: bool | None = None, + context: dict[str, Any] | None = None, + ) -> Model: + """Validate the given object contains string data against the Pydantic model. + + Args: + obj: The object contains string data to validate. + strict: Whether to enforce types strictly. + context: Extra variables to pass to the validator. + + Returns: + The validated Pydantic model. + """ + # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks + __tracebackhide__ = True + return cls.__pydantic_validator__.validate_strings(obj, strict=strict, context=context) + + @classmethod + def __get_pydantic_core_schema__(cls, __source: type[BaseModel], __handler: GetCoreSchemaHandler) -> CoreSchema: + """Hook into generating the model's CoreSchema. + + Args: + __source: The class we are generating a schema for. + This will generally be the same as the `cls` argument if this is a classmethod. + __handler: Call into Pydantic's internal JSON schema generation. + A callable that calls into Pydantic's internal CoreSchema generation logic. + + Returns: + A `pydantic-core` `CoreSchema`. + """ + # Only use the cached value from this _exact_ class; we don't want one from a parent class + # This is why we check `cls.__dict__` and don't use `cls.__pydantic_core_schema__` or similar. + if '__pydantic_core_schema__' in cls.__dict__: + # Due to the way generic classes are built, it's possible that an invalid schema may be temporarily + # set on generic classes. I think we could resolve this to ensure that we get proper schema caching + # for generics, but for simplicity for now, we just always rebuild if the class has a generic origin. + if not cls.__pydantic_generic_metadata__['origin']: + return cls.__pydantic_core_schema__ + + return __handler(__source) + + @classmethod + def __get_pydantic_json_schema__( + cls, + __core_schema: CoreSchema, + __handler: GetJsonSchemaHandler, + ) -> JsonSchemaValue: + """Hook into generating the model's JSON schema. + + Args: + __core_schema: A `pydantic-core` CoreSchema. + You can ignore this argument and call the handler with a new CoreSchema, + wrap this CoreSchema (`{'type': 'nullable', 'schema': current_schema}`), + or just call the handler with the original schema. + __handler: Call into Pydantic's internal JSON schema generation. + This will raise a `pydantic.errors.PydanticInvalidForJsonSchema` if JSON schema + generation fails. + Since this gets called by `BaseModel.model_json_schema` you can override the + `schema_generator` argument to that function to change JSON schema generation globally + for a type. + + Returns: + A JSON schema, as a Python object. + """ + return __handler(__core_schema) + + @classmethod + def __pydantic_init_subclass__(cls, **kwargs: Any) -> None: + """This is intended to behave just like `__init_subclass__`, but is called by `ModelMetaclass` + only after the class is actually fully initialized. In particular, attributes like `model_fields` will + be present when this is called. + + This is necessary because `__init_subclass__` will always be called by `type.__new__`, + and it would require a prohibitively large refactor to the `ModelMetaclass` to ensure that + `type.__new__` was called in such a manner that the class would already be sufficiently initialized. + + This will receive the same `kwargs` that would be passed to the standard `__init_subclass__`, namely, + any kwargs passed to the class definition that aren't used internally by pydantic. + + Args: + **kwargs: Any keyword arguments passed to the class definition that aren't used internally + by pydantic. + """ + pass + + def __class_getitem__( + cls, typevar_values: type[Any] | tuple[type[Any], ...] + ) -> type[BaseModel] | _forward_ref.PydanticRecursiveRef: + cached = _generics.get_cached_generic_type_early(cls, typevar_values) + if cached is not None: + return cached + + if cls is BaseModel: + raise TypeError('Type parameters should be placed on typing.Generic, not BaseModel') + if not hasattr(cls, '__parameters__'): + raise TypeError(f'{cls} cannot be parametrized because it does not inherit from typing.Generic') + if not cls.__pydantic_generic_metadata__['parameters'] and typing.Generic not in cls.__bases__: + raise TypeError(f'{cls} is not a generic class') + + if not isinstance(typevar_values, tuple): + typevar_values = (typevar_values,) + _generics.check_parameters_count(cls, typevar_values) + + # Build map from generic typevars to passed params + typevars_map: dict[_typing_extra.TypeVarType, type[Any]] = dict( + zip(cls.__pydantic_generic_metadata__['parameters'], typevar_values) + ) + + if _utils.all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map: + submodel = cls # if arguments are equal to parameters it's the same object + _generics.set_cached_generic_type(cls, typevar_values, submodel) + else: + parent_args = cls.__pydantic_generic_metadata__['args'] + if not parent_args: + args = typevar_values + else: + args = tuple(_generics.replace_types(arg, typevars_map) for arg in parent_args) + + origin = cls.__pydantic_generic_metadata__['origin'] or cls + model_name = origin.model_parametrized_name(args) + params = tuple( + {param: None for param in _generics.iter_contained_typevars(typevars_map.values())} + ) # use dict as ordered set + + with _generics.generic_recursion_self_type(origin, args) as maybe_self_type: + if maybe_self_type is not None: + return maybe_self_type + + cached = _generics.get_cached_generic_type_late(cls, typevar_values, origin, args) + if cached is not None: + return cached + + # Attempt to rebuild the origin in case new types have been defined + try: + # depth 3 gets you above this __class_getitem__ call + origin.model_rebuild(_parent_namespace_depth=3) + except PydanticUndefinedAnnotation: + # It's okay if it fails, it just means there are still undefined types + # that could be evaluated later. + # TODO: Make sure validation fails if there are still undefined types, perhaps using MockValidator + pass + + submodel = _generics.create_generic_submodel(model_name, origin, args, params) + + # Update cache + _generics.set_cached_generic_type(cls, typevar_values, submodel, origin, args) + + return submodel + + def __copy__(self: Model) -> Model: + """Returns a shallow copy of the model.""" + cls = type(self) + m = cls.__new__(cls) + _object_setattr(m, '__dict__', copy(self.__dict__)) + _object_setattr(m, '__pydantic_extra__', copy(self.__pydantic_extra__)) + _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__)) + + if self.__pydantic_private__ is None: + _object_setattr(m, '__pydantic_private__', None) + else: + _object_setattr( + m, + '__pydantic_private__', + {k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined}, + ) + + return m + + def __deepcopy__(self: Model, memo: dict[int, Any] | None = None) -> Model: + """Returns a deep copy of the model.""" + cls = type(self) + m = cls.__new__(cls) + _object_setattr(m, '__dict__', deepcopy(self.__dict__, memo=memo)) + _object_setattr(m, '__pydantic_extra__', deepcopy(self.__pydantic_extra__, memo=memo)) + # This next line doesn't need a deepcopy because __pydantic_fields_set__ is a set[str], + # and attempting a deepcopy would be marginally slower. + _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__)) + + if self.__pydantic_private__ is None: + _object_setattr(m, '__pydantic_private__', None) + else: + _object_setattr( + m, + '__pydantic_private__', + deepcopy({k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined}, memo=memo), + ) + + return m + + if not typing.TYPE_CHECKING: + # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access + + def __getattr__(self, item: str) -> Any: + private_attributes = object.__getattribute__(self, '__private_attributes__') + if item in private_attributes: + attribute = private_attributes[item] + if hasattr(attribute, '__get__'): + return attribute.__get__(self, type(self)) # type: ignore + + try: + # Note: self.__pydantic_private__ cannot be None if self.__private_attributes__ has items + return self.__pydantic_private__[item] # type: ignore + except KeyError as exc: + raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc + else: + # `__pydantic_extra__` can fail to be set if the model is not yet fully initialized. + # See `BaseModel.__repr_args__` for more details + try: + pydantic_extra = object.__getattribute__(self, '__pydantic_extra__') + except AttributeError: + pydantic_extra = None + + if pydantic_extra is not None: + try: + return pydantic_extra[item] + except KeyError as exc: + raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc + else: + if hasattr(self.__class__, item): + return super().__getattribute__(item) # Raises AttributeError if appropriate + else: + # this is the current error + raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') + + def __setattr__(self, name: str, value: Any) -> None: + if name in self.__class_vars__: + raise AttributeError( + f'{name!r} is a ClassVar of `{self.__class__.__name__}` and cannot be set on an instance. ' + f'If you want to set a value on the class, use `{self.__class__.__name__}.{name} = value`.' + ) + elif not _fields.is_valid_field_name(name): + if self.__pydantic_private__ is None or name not in self.__private_attributes__: + _object_setattr(self, name, value) + else: + attribute = self.__private_attributes__[name] + if hasattr(attribute, '__set__'): + attribute.__set__(self, value) # type: ignore + else: + self.__pydantic_private__[name] = value + return + + self._check_frozen(name, value) + + attr = getattr(self.__class__, name, None) + if isinstance(attr, property): + attr.__set__(self, value) + elif self.model_config.get('validate_assignment', None): + self.__pydantic_validator__.validate_assignment(self, name, value) + elif self.model_config.get('extra') != 'allow' and name not in self.model_fields: + # TODO - matching error + raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"') + elif self.model_config.get('extra') == 'allow' and name not in self.model_fields: + if self.model_extra and name in self.model_extra: + self.__pydantic_extra__[name] = value # type: ignore + else: + try: + getattr(self, name) + except AttributeError: + # attribute does not already exist on instance, so put it in extra + self.__pydantic_extra__[name] = value # type: ignore + else: + # attribute _does_ already exist on instance, and was not in extra, so update it + _object_setattr(self, name, value) + else: + self.__dict__[name] = value + self.__pydantic_fields_set__.add(name) + + def __delattr__(self, item: str) -> Any: + if item in self.__private_attributes__: + attribute = self.__private_attributes__[item] + if hasattr(attribute, '__delete__'): + attribute.__delete__(self) # type: ignore + return + + try: + # Note: self.__pydantic_private__ cannot be None if self.__private_attributes__ has items + del self.__pydantic_private__[item] # type: ignore + return + except KeyError as exc: + raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc + + self._check_frozen(item, None) + + if item in self.model_fields: + object.__delattr__(self, item) + elif self.__pydantic_extra__ is not None and item in self.__pydantic_extra__: + del self.__pydantic_extra__[item] + else: + try: + object.__delattr__(self, item) + except AttributeError: + raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') + + def _check_frozen(self, name: str, value: Any) -> None: + if self.model_config.get('frozen', None): + typ = 'frozen_instance' + elif getattr(self.model_fields.get(name), 'frozen', False): + typ = 'frozen_field' + else: + return + error: pydantic_core.InitErrorDetails = { + 'type': typ, + 'loc': (name,), + 'input': value, + } + raise pydantic_core.ValidationError.from_exception_data(self.__class__.__name__, [error]) + + def __getstate__(self) -> dict[Any, Any]: + private = self.__pydantic_private__ + if private: + private = {k: v for k, v in private.items() if v is not PydanticUndefined} + return { + '__dict__': self.__dict__, + '__pydantic_extra__': self.__pydantic_extra__, + '__pydantic_fields_set__': self.__pydantic_fields_set__, + '__pydantic_private__': private, + } + + def __setstate__(self, state: dict[Any, Any]) -> None: + _object_setattr(self, '__pydantic_fields_set__', state['__pydantic_fields_set__']) + _object_setattr(self, '__pydantic_extra__', state['__pydantic_extra__']) + _object_setattr(self, '__pydantic_private__', state['__pydantic_private__']) + _object_setattr(self, '__dict__', state['__dict__']) + + def __eq__(self, other: Any) -> bool: + if isinstance(other, BaseModel): + # When comparing instances of generic types for equality, as long as all field values are equal, + # only require their generic origin types to be equal, rather than exact type equality. + # This prevents headaches like MyGeneric(x=1) != MyGeneric[Any](x=1). + self_type = self.__pydantic_generic_metadata__['origin'] or self.__class__ + other_type = other.__pydantic_generic_metadata__['origin'] or other.__class__ + + # Perform common checks first + if not ( + self_type == other_type + and self.__pydantic_private__ == other.__pydantic_private__ + and self.__pydantic_extra__ == other.__pydantic_extra__ + ): + return False + + # We only want to compare pydantic fields but ignoring fields is costly. + # We'll perform a fast check first, and fallback only when needed + # See GH-7444 and GH-7825 for rationale and a performance benchmark + + # First, do the fast (and sometimes faulty) __dict__ comparison + if self.__dict__ == other.__dict__: + # If the check above passes, then pydantic fields are equal, we can return early + return True + + # We don't want to trigger unnecessary costly filtering of __dict__ on all unequal objects, so we return + # early if there are no keys to ignore (we would just return False later on anyway) + model_fields = type(self).model_fields.keys() + if self.__dict__.keys() <= model_fields and other.__dict__.keys() <= model_fields: + return False + + # If we reach here, there are non-pydantic-fields keys, mapped to unequal values, that we need to ignore + # Resort to costly filtering of the __dict__ objects + # We use operator.itemgetter because it is much faster than dict comprehensions + # NOTE: Contrary to standard python class and instances, when the Model class has a default value for an + # attribute and the model instance doesn't have a corresponding attribute, accessing the missing attribute + # raises an error in BaseModel.__getattr__ instead of returning the class attribute + # So we can use operator.itemgetter() instead of operator.attrgetter() + getter = operator.itemgetter(*model_fields) if model_fields else lambda _: _utils._SENTINEL + try: + return getter(self.__dict__) == getter(other.__dict__) + except KeyError: + # In rare cases (such as when using the deprecated BaseModel.copy() method), + # the __dict__ may not contain all model fields, which is how we can get here. + # getter(self.__dict__) is much faster than any 'safe' method that accounts + # for missing keys, and wrapping it in a `try` doesn't slow things down much + # in the common case. + self_fields_proxy = _utils.SafeGetItemProxy(self.__dict__) + other_fields_proxy = _utils.SafeGetItemProxy(other.__dict__) + return getter(self_fields_proxy) == getter(other_fields_proxy) + + # other instance is not a BaseModel + else: + return NotImplemented # delegate to the other item in the comparison + + if typing.TYPE_CHECKING: + # We put `__init_subclass__` in a TYPE_CHECKING block because, even though we want the type-checking benefits + # described in the signature of `__init_subclass__` below, we don't want to modify the default behavior of + # subclass initialization. + + def __init_subclass__(cls, **kwargs: Unpack[ConfigDict]): + """This signature is included purely to help type-checkers check arguments to class declaration, which + provides a way to conveniently set model_config key/value pairs. + + ```py + from pydantic import BaseModel + + class MyModel(BaseModel, extra='allow'): + ... + ``` + + However, this may be deceiving, since the _actual_ calls to `__init_subclass__` will not receive any + of the config arguments, and will only receive any keyword arguments passed during class initialization + that are _not_ expected keys in ConfigDict. (This is due to the way `ModelMetaclass.__new__` works.) + + Args: + **kwargs: Keyword arguments passed to the class definition, which set model_config + + Note: + You may want to override `__pydantic_init_subclass__` instead, which behaves similarly but is called + *after* the class is fully initialized. + """ + + def __iter__(self) -> TupleGenerator: + """So `dict(model)` works.""" + yield from [(k, v) for (k, v) in self.__dict__.items() if not k.startswith('_')] + extra = self.__pydantic_extra__ + if extra: + yield from extra.items() + + def __repr__(self) -> str: + return f'{self.__repr_name__()}({self.__repr_str__(", ")})' + + def __repr_args__(self) -> _repr.ReprArgs: + for k, v in self.__dict__.items(): + field = self.model_fields.get(k) + if field and field.repr: + yield k, v + + # `__pydantic_extra__` can fail to be set if the model is not yet fully initialized. + # This can happen if a `ValidationError` is raised during initialization and the instance's + # repr is generated as part of the exception handling. Therefore, we use `getattr` here + # with a fallback, even though the type hints indicate the attribute will always be present. + try: + pydantic_extra = object.__getattribute__(self, '__pydantic_extra__') + except AttributeError: + pydantic_extra = None + + if pydantic_extra is not None: + yield from ((k, v) for k, v in pydantic_extra.items()) + yield from ((k, getattr(self, k)) for k, v in self.model_computed_fields.items() if v.repr) + + # take logic from `_repr.Representation` without the side effects of inheritance, see #5740 + __repr_name__ = _repr.Representation.__repr_name__ + __repr_str__ = _repr.Representation.__repr_str__ + __pretty__ = _repr.Representation.__pretty__ + __rich_repr__ = _repr.Representation.__rich_repr__ + + def __str__(self) -> str: + return self.__repr_str__(' ') + + # ##### Deprecated methods from v1 ##### + @property + @typing_extensions.deprecated( + 'The `__fields__` attribute is deprecated, use `model_fields` instead.', category=None + ) + def __fields__(self) -> dict[str, FieldInfo]: + warnings.warn( + 'The `__fields__` attribute is deprecated, use `model_fields` instead.', category=PydanticDeprecatedSince20 + ) + return self.model_fields + + @property + @typing_extensions.deprecated( + 'The `__fields_set__` attribute is deprecated, use `model_fields_set` instead.', + category=None, + ) + def __fields_set__(self) -> set[str]: + warnings.warn( + 'The `__fields_set__` attribute is deprecated, use `model_fields_set` instead.', + category=PydanticDeprecatedSince20, + ) + return self.__pydantic_fields_set__ + + @typing_extensions.deprecated('The `dict` method is deprecated; use `model_dump` instead.', category=None) + def dict( # noqa: D102 + self, + *, + include: IncEx = None, + exclude: IncEx = None, + by_alias: bool = False, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + ) -> typing.Dict[str, Any]: # noqa UP006 + warnings.warn('The `dict` method is deprecated; use `model_dump` instead.', category=PydanticDeprecatedSince20) + return self.model_dump( + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + + @typing_extensions.deprecated('The `json` method is deprecated; use `model_dump_json` instead.', category=None) + def json( # noqa: D102 + self, + *, + include: IncEx = None, + exclude: IncEx = None, + by_alias: bool = False, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + encoder: typing.Callable[[Any], Any] | None = PydanticUndefined, # type: ignore[assignment] + models_as_dict: bool = PydanticUndefined, # type: ignore[assignment] **dumps_kwargs: Any, ) -> str: - """ - Generate a JSON representation of the model, `include` and `exclude` arguments as per `dict()`. - - `encoder` is an optional function to supply as `default` to json.dumps(), other arguments as per `json.dumps()`. - """ - if skip_defaults is not None: - warnings.warn( - f'{self.__class__.__name__}.json(): "skip_defaults" is deprecated and replaced by "exclude_unset"', - DeprecationWarning, - ) - exclude_unset = skip_defaults - encoder = cast(Callable[[Any], Any], encoder or self.__json_encoder__) - - # We don't directly call `self.dict()`, which does exactly this with `to_dict=True` - # because we want to be able to keep raw `BaseModel` instances and not as `dict`. - # This allows users to write custom JSON encoders for given `BaseModel` classes. - data = dict( - self._iter( - to_dict=models_as_dict, - by_alias=by_alias, - include=include, - exclude=exclude, - exclude_unset=exclude_unset, - exclude_defaults=exclude_defaults, - exclude_none=exclude_none, - ) + warnings.warn( + 'The `json` method is deprecated; use `model_dump_json` instead.', category=PydanticDeprecatedSince20 + ) + if encoder is not PydanticUndefined: + raise TypeError('The `encoder` argument is no longer supported; use field serializers instead.') + if models_as_dict is not PydanticUndefined: + raise TypeError('The `models_as_dict` argument is no longer supported; use a model serializer instead.') + if dumps_kwargs: + raise TypeError('`dumps_kwargs` keyword arguments are no longer supported.') + return self.model_dump_json( + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, ) - if self.__custom_root_type__: - data = data[ROOT_KEY] - return self.__config__.json_dumps(data, default=encoder, **dumps_kwargs) @classmethod - def _enforce_dict_if_root(cls, obj: Any) -> Any: - if cls.__custom_root_type__ and ( - not (isinstance(obj, dict) and obj.keys() == {ROOT_KEY}) - or cls.__fields__[ROOT_KEY].shape in MAPPING_LIKE_SHAPES - ): - return {ROOT_KEY: obj} - else: - return obj + @typing_extensions.deprecated('The `parse_obj` method is deprecated; use `model_validate` instead.', category=None) + def parse_obj(cls: type[Model], obj: Any) -> Model: # noqa: D102 + warnings.warn( + 'The `parse_obj` method is deprecated; use `model_validate` instead.', category=PydanticDeprecatedSince20 + ) + return cls.model_validate(obj) @classmethod - def parse_obj(cls: Type['Model'], obj: Any) -> 'Model': - obj = cls._enforce_dict_if_root(obj) - if not isinstance(obj, dict): - try: - obj = dict(obj) - except (TypeError, ValueError) as e: - exc = TypeError(f'{cls.__name__} expected dict not {obj.__class__.__name__}') - raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls) from e - return cls(**obj) - - @classmethod - def parse_raw( - cls: Type['Model'], - b: StrBytes, + @typing_extensions.deprecated( + 'The `parse_raw` method is deprecated; if your data is JSON use `model_validate_json`, ' + 'otherwise load the data then use `model_validate` instead.', + category=None, + ) + def parse_raw( # noqa: D102 + cls: type[Model], + b: str | bytes, *, - content_type: str = None, + content_type: str | None = None, encoding: str = 'utf8', - proto: Protocol = None, + proto: DeprecatedParseProtocol | None = None, allow_pickle: bool = False, - ) -> 'Model': + ) -> Model: # pragma: no cover + warnings.warn( + 'The `parse_raw` method is deprecated; if your data is JSON use `model_validate_json`, ' + 'otherwise load the data then use `model_validate` instead.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import parse + try: - obj = load_str_bytes( + obj = parse.load_str_bytes( b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, - json_loads=cls.__config__.json_loads, ) - except (ValueError, TypeError, UnicodeDecodeError) as e: - raise ValidationError([ErrorWrapper(e, loc=ROOT_KEY)], cls) - return cls.parse_obj(obj) + except (ValueError, TypeError) as exc: + import json + + # try to match V1 + if isinstance(exc, UnicodeDecodeError): + type_str = 'value_error.unicodedecode' + elif isinstance(exc, json.JSONDecodeError): + type_str = 'value_error.jsondecode' + elif isinstance(exc, ValueError): + type_str = 'value_error' + else: + type_str = 'type_error' + + # ctx is missing here, but since we've added `input` to the error, we're not pretending it's the same + error: pydantic_core.InitErrorDetails = { + # The type: ignore on the next line is to ignore the requirement of LiteralString + 'type': pydantic_core.PydanticCustomError(type_str, str(exc)), # type: ignore + 'loc': ('__root__',), + 'input': b, + } + raise pydantic_core.ValidationError.from_exception_data(cls.__name__, [error]) + return cls.model_validate(obj) @classmethod - def parse_file( - cls: Type['Model'], - path: Union[str, Path], + @typing_extensions.deprecated( + 'The `parse_file` method is deprecated; load the data from file, then if your data is JSON ' + 'use `model_validate_json`, otherwise `model_validate` instead.', + category=None, + ) + def parse_file( # noqa: D102 + cls: type[Model], + path: str | Path, *, - content_type: str = None, + content_type: str | None = None, encoding: str = 'utf8', - proto: Protocol = None, + proto: DeprecatedParseProtocol | None = None, allow_pickle: bool = False, - ) -> 'Model': - obj = load_file( + ) -> Model: + warnings.warn( + 'The `parse_file` method is deprecated; load the data from file, then if your data is JSON ' + 'use `model_validate_json`, otherwise `model_validate` instead.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import parse + + obj = parse.load_file( path, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, - json_loads=cls.__config__.json_loads, ) return cls.parse_obj(obj) @classmethod - def from_orm(cls: Type['Model'], obj: Any) -> 'Model': - if not cls.__config__.orm_mode: - raise ConfigError('You must have the config attribute orm_mode=True to use from_orm') - obj = {ROOT_KEY: obj} if cls.__custom_root_type__ else cls._decompose_class(obj) - m = cls.__new__(cls) - values, fields_set, validation_error = validate_model(cls, obj) - if validation_error: - raise validation_error - object_setattr(m, '__dict__', values) - object_setattr(m, '__fields_set__', fields_set) - m._init_private_attributes() - return m + @typing_extensions.deprecated( + 'The `from_orm` method is deprecated; set ' + "`model_config['from_attributes']=True` and use `model_validate` instead.", + category=None, + ) + def from_orm(cls: type[Model], obj: Any) -> Model: # noqa: D102 + warnings.warn( + 'The `from_orm` method is deprecated; set ' + "`model_config['from_attributes']=True` and use `model_validate` instead.", + category=PydanticDeprecatedSince20, + ) + if not cls.model_config.get('from_attributes', None): + raise PydanticUserError( + 'You must set the config attribute `from_attributes=True` to use from_orm', code=None + ) + return cls.model_validate(obj) @classmethod - def construct(cls: Type['Model'], _fields_set: Optional['SetStr'] = None, **values: Any) -> 'Model': - """ - Creates a new model setting __dict__ and __fields_set__ from trusted or pre-validated data. - Default values are respected, but no other validation is performed. - Behaves as if `Config.extra = 'allow'` was set since it adds all passed values - """ - m = cls.__new__(cls) - fields_values: Dict[str, Any] = {} - for name, field in cls.__fields__.items(): - if field.alt_alias and field.alias in values: - fields_values[name] = values[field.alias] - elif name in values: - fields_values[name] = values[name] - elif not field.required: - fields_values[name] = field.get_default() - fields_values.update(values) - object_setattr(m, '__dict__', fields_values) - if _fields_set is None: - _fields_set = set(values.keys()) - object_setattr(m, '__fields_set__', _fields_set) - m._init_private_attributes() - return m - - def _copy_and_set_values(self: 'Model', values: 'DictStrAny', fields_set: 'SetStr', *, deep: bool) -> 'Model': - if deep: - # chances of having empty dict here are quite low for using smart_deepcopy - values = deepcopy(values) - - cls = self.__class__ - m = cls.__new__(cls) - object_setattr(m, '__dict__', values) - object_setattr(m, '__fields_set__', fields_set) - for name in self.__private_attributes__: - value = getattr(self, name, Undefined) - if value is not Undefined: - if deep: - value = deepcopy(value) - object_setattr(m, name, value) - - return m + @typing_extensions.deprecated('The `construct` method is deprecated; use `model_construct` instead.', category=None) + def construct(cls: type[Model], _fields_set: set[str] | None = None, **values: Any) -> Model: # noqa: D102 + warnings.warn( + 'The `construct` method is deprecated; use `model_construct` instead.', category=PydanticDeprecatedSince20 + ) + return cls.model_construct(_fields_set=_fields_set, **values) + @typing_extensions.deprecated( + 'The `copy` method is deprecated; use `model_copy` instead. ' + 'See the docstring of `BaseModel.copy` for details about how to handle `include` and `exclude`.', + category=None, + ) def copy( - self: 'Model', + self: Model, *, - include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, - exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, - update: Optional['DictStrAny'] = None, + include: AbstractSetIntStr | MappingIntStrAny | None = None, + exclude: AbstractSetIntStr | MappingIntStrAny | None = None, + update: typing.Dict[str, Any] | None = None, # noqa UP006 deep: bool = False, - ) -> 'Model': - """ - Duplicate a model, optionally choose which fields to include, exclude and change. + ) -> Model: # pragma: no cover + """Returns a copy of the model. - :param include: fields to include in new model - :param exclude: fields to exclude from new model, as with values this takes precedence over include - :param update: values to change/add in the new model. Note: the data is not validated before creating - the new model: you should trust this data - :param deep: set to `True` to make a deep copy of the model - :return: new model instance + !!! warning "Deprecated" + This method is now deprecated; use `model_copy` instead. + + If you need `include` or `exclude`, use: + + ```py + data = self.model_dump(include=include, exclude=exclude, round_trip=True) + data = {**data, **(update or {})} + copied = self.model_validate(data) + ``` + + Args: + include: Optional set or mapping specifying which fields to include in the copied model. + exclude: Optional set or mapping specifying which fields to exclude in the copied model. + update: Optional dictionary of field-value pairs to override field values in the copied model. + deep: If True, the values of fields that are Pydantic models will be deep-copied. + + Returns: + A copy of the model with included, excluded and updated fields as specified. """ + warnings.warn( + 'The `copy` method is deprecated; use `model_copy` instead. ' + 'See the docstring of `BaseModel.copy` for details about how to handle `include` and `exclude`.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import copy_internals values = dict( - self._iter(to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False), + copy_internals._iter( + self, to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False + ), **(update or {}), ) + if self.__pydantic_private__ is None: + private = None + else: + private = {k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined} - # new `__fields_set__` can have unset optional fields with a set value in `update` kwarg + if self.__pydantic_extra__ is None: + extra: dict[str, Any] | None = None + else: + extra = self.__pydantic_extra__.copy() + for k in list(self.__pydantic_extra__): + if k not in values: # k was in the exclude + extra.pop(k) + for k in list(values): + if k in self.__pydantic_extra__: # k must have come from extra + extra[k] = values.pop(k) + + # new `__pydantic_fields_set__` can have unset optional fields with a set value in `update` kwarg if update: - fields_set = self.__fields_set__ | update.keys() + fields_set = self.__pydantic_fields_set__ | update.keys() else: - fields_set = set(self.__fields_set__) - - return self._copy_and_set_values(values, fields_set, deep=deep) - - @classmethod - def schema(cls, by_alias: bool = True, ref_template: str = default_ref_template) -> 'DictStrAny': - cached = cls.__schema_cache__.get((by_alias, ref_template)) - if cached is not None: - return cached - s = model_schema(cls, by_alias=by_alias, ref_template=ref_template) - cls.__schema_cache__[(by_alias, ref_template)] = s - return s - - @classmethod - def schema_json( - cls, *, by_alias: bool = True, ref_template: str = default_ref_template, **dumps_kwargs: Any - ) -> str: - from .json import pydantic_encoder - - return cls.__config__.json_dumps( - cls.schema(by_alias=by_alias, ref_template=ref_template), default=pydantic_encoder, **dumps_kwargs - ) - - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls.validate - - @classmethod - def validate(cls: Type['Model'], value: Any) -> 'Model': - if isinstance(value, cls): - copy_on_model_validation = cls.__config__.copy_on_model_validation - # whether to deep or shallow copy the model on validation, None means do not copy - deep_copy: Optional[bool] = None - if copy_on_model_validation not in {'deep', 'shallow', 'none'}: - # Warn about deprecated behavior - warnings.warn( - "`copy_on_model_validation` should be a string: 'deep', 'shallow' or 'none'", DeprecationWarning - ) - if copy_on_model_validation: - deep_copy = False - - if copy_on_model_validation == 'shallow': - # shallow copy - deep_copy = False - elif copy_on_model_validation == 'deep': - # deep copy - deep_copy = True - - if deep_copy is None: - return value - else: - return value._copy_and_set_values(value.__dict__, value.__fields_set__, deep=deep_copy) - - value = cls._enforce_dict_if_root(value) - - if isinstance(value, dict): - return cls(**value) - elif cls.__config__.orm_mode: - return cls.from_orm(value) - else: - try: - value_as_dict = dict(value) - except (TypeError, ValueError) as e: - raise DictError() from e - return cls(**value_as_dict) - - @classmethod - def _decompose_class(cls: Type['Model'], obj: Any) -> GetterDict: - if isinstance(obj, GetterDict): - return obj - return cls.__config__.getter_dict(obj) - - @classmethod - @no_type_check - def _get_value( - cls, - v: Any, - to_dict: bool, - by_alias: bool, - include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']], - exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']], - exclude_unset: bool, - exclude_defaults: bool, - exclude_none: bool, - ) -> Any: - - if isinstance(v, BaseModel): - if to_dict: - v_dict = v.dict( - by_alias=by_alias, - exclude_unset=exclude_unset, - exclude_defaults=exclude_defaults, - include=include, - exclude=exclude, - exclude_none=exclude_none, - ) - if ROOT_KEY in v_dict: - return v_dict[ROOT_KEY] - return v_dict - else: - return v.copy(include=include, exclude=exclude) - - value_exclude = ValueItems(v, exclude) if exclude else None - value_include = ValueItems(v, include) if include else None - - if isinstance(v, dict): - return { - k_: cls._get_value( - v_, - to_dict=to_dict, - by_alias=by_alias, - exclude_unset=exclude_unset, - exclude_defaults=exclude_defaults, - include=value_include and value_include.for_element(k_), - exclude=value_exclude and value_exclude.for_element(k_), - exclude_none=exclude_none, - ) - for k_, v_ in v.items() - if (not value_exclude or not value_exclude.is_excluded(k_)) - and (not value_include or value_include.is_included(k_)) - } - - elif sequence_like(v): - seq_args = ( - cls._get_value( - v_, - to_dict=to_dict, - by_alias=by_alias, - exclude_unset=exclude_unset, - exclude_defaults=exclude_defaults, - include=value_include and value_include.for_element(i), - exclude=value_exclude and value_exclude.for_element(i), - exclude_none=exclude_none, - ) - for i, v_ in enumerate(v) - if (not value_exclude or not value_exclude.is_excluded(i)) - and (not value_include or value_include.is_included(i)) - ) - - return v.__class__(*seq_args) if is_namedtuple(v.__class__) else v.__class__(seq_args) - - elif isinstance(v, Enum) and getattr(cls.Config, 'use_enum_values', False): - return v.value - - else: - return v - - @classmethod - def __try_update_forward_refs__(cls, **localns: Any) -> None: - """ - Same as update_forward_refs but will not raise exception - when forward references are not defined. - """ - update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns, (NameError,)) - - @classmethod - def update_forward_refs(cls, **localns: Any) -> None: - """ - Try to update ForwardRefs on fields based on this Model, globalns and localns. - """ - update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns) - - def __iter__(self) -> 'TupleGenerator': - """ - so `dict(model)` works - """ - yield from self.__dict__.items() - - def _iter( - self, - to_dict: bool = False, - by_alias: bool = False, - include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, - exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, - exclude_unset: bool = False, - exclude_defaults: bool = False, - exclude_none: bool = False, - ) -> 'TupleGenerator': - - # Merge field set excludes with explicit exclude parameter with explicit overriding field set options. - # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case. - if exclude is not None or self.__exclude_fields__ is not None: - exclude = ValueItems.merge(self.__exclude_fields__, exclude) - - if include is not None or self.__include_fields__ is not None: - include = ValueItems.merge(self.__include_fields__, include, intersect=True) - - allowed_keys = self._calculate_keys( - include=include, exclude=exclude, exclude_unset=exclude_unset # type: ignore - ) - if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none): - # huge boost for plain _iter() - yield from self.__dict__.items() - return - - value_exclude = ValueItems(self, exclude) if exclude is not None else None - value_include = ValueItems(self, include) if include is not None else None - - for field_key, v in self.__dict__.items(): - if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None): - continue - - if exclude_defaults: - model_field = self.__fields__.get(field_key) - if not getattr(model_field, 'required', True) and getattr(model_field, 'default', _missing) == v: - continue - - if by_alias and field_key in self.__fields__: - dict_key = self.__fields__[field_key].alias - else: - dict_key = field_key - - if to_dict or value_include or value_exclude: - v = self._get_value( - v, - to_dict=to_dict, - by_alias=by_alias, - include=value_include and value_include.for_element(field_key), - exclude=value_exclude and value_exclude.for_element(field_key), - exclude_unset=exclude_unset, - exclude_defaults=exclude_defaults, - exclude_none=exclude_none, - ) - yield dict_key, v - - def _calculate_keys( - self, - include: Optional['MappingIntStrAny'], - exclude: Optional['MappingIntStrAny'], - exclude_unset: bool, - update: Optional['DictStrAny'] = None, - ) -> Optional[AbstractSet[str]]: - if include is None and exclude is None and exclude_unset is False: - return None - - keys: AbstractSet[str] - if exclude_unset: - keys = self.__fields_set__.copy() - else: - keys = self.__dict__.keys() - - if include is not None: - keys &= include.keys() - - if update: - keys -= update.keys() + fields_set = set(self.__pydantic_fields_set__) + # removing excluded fields from `__pydantic_fields_set__` if exclude: - keys -= {k for k, v in exclude.items() if ValueItems.is_true(v)} + fields_set -= set(exclude) - return keys + return copy_internals._copy_and_set_values(self, values, fields_set, extra, private, deep=deep) - def __eq__(self, other: Any) -> bool: - if isinstance(other, BaseModel): - return self.dict() == other.dict() - else: - return self.dict() == other + @classmethod + @typing_extensions.deprecated('The `schema` method is deprecated; use `model_json_schema` instead.', category=None) + def schema( # noqa: D102 + cls, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE + ) -> typing.Dict[str, Any]: # noqa UP006 + warnings.warn( + 'The `schema` method is deprecated; use `model_json_schema` instead.', category=PydanticDeprecatedSince20 + ) + return cls.model_json_schema(by_alias=by_alias, ref_template=ref_template) - def __repr_args__(self) -> 'ReprArgs': - return [ - (k, v) - for k, v in self.__dict__.items() - if k not in DUNDER_ATTRIBUTES and (k not in self.__fields__ or self.__fields__[k].field_info.repr) - ] + @classmethod + @typing_extensions.deprecated( + 'The `schema_json` method is deprecated; use `model_json_schema` and json.dumps instead.', + category=None, + ) + def schema_json( # noqa: D102 + cls, *, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE, **dumps_kwargs: Any + ) -> str: # pragma: no cover + warnings.warn( + 'The `schema_json` method is deprecated; use `model_json_schema` and json.dumps instead.', + category=PydanticDeprecatedSince20, + ) + import json + + from .deprecated.json import pydantic_encoder + + return json.dumps( + cls.model_json_schema(by_alias=by_alias, ref_template=ref_template), + default=pydantic_encoder, + **dumps_kwargs, + ) + + @classmethod + @typing_extensions.deprecated('The `validate` method is deprecated; use `model_validate` instead.', category=None) + def validate(cls: type[Model], value: Any) -> Model: # noqa: D102 + warnings.warn( + 'The `validate` method is deprecated; use `model_validate` instead.', category=PydanticDeprecatedSince20 + ) + return cls.model_validate(value) + + @classmethod + @typing_extensions.deprecated( + 'The `update_forward_refs` method is deprecated; use `model_rebuild` instead.', + category=None, + ) + def update_forward_refs(cls, **localns: Any) -> None: # noqa: D102 + warnings.warn( + 'The `update_forward_refs` method is deprecated; use `model_rebuild` instead.', + category=PydanticDeprecatedSince20, + ) + if localns: # pragma: no cover + raise TypeError('`localns` arguments are not longer accepted.') + cls.model_rebuild(force=True) + + @typing_extensions.deprecated( + 'The private method `_iter` will be removed and should no longer be used.', category=None + ) + def _iter(self, *args: Any, **kwargs: Any) -> Any: + warnings.warn( + 'The private method `_iter` will be removed and should no longer be used.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import copy_internals + + return copy_internals._iter(self, *args, **kwargs) + + @typing_extensions.deprecated( + 'The private method `_copy_and_set_values` will be removed and should no longer be used.', + category=None, + ) + def _copy_and_set_values(self, *args: Any, **kwargs: Any) -> Any: + warnings.warn( + 'The private method `_copy_and_set_values` will be removed and should no longer be used.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import copy_internals + + return copy_internals._copy_and_set_values(self, *args, **kwargs) + + @classmethod + @typing_extensions.deprecated( + 'The private method `_get_value` will be removed and should no longer be used.', + category=None, + ) + def _get_value(cls, *args: Any, **kwargs: Any) -> Any: + warnings.warn( + 'The private method `_get_value` will be removed and should no longer be used.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import copy_internals + + return copy_internals._get_value(cls, *args, **kwargs) + + @typing_extensions.deprecated( + 'The private method `_calculate_keys` will be removed and should no longer be used.', + category=None, + ) + def _calculate_keys(self, *args: Any, **kwargs: Any) -> Any: + warnings.warn( + 'The private method `_calculate_keys` will be removed and should no longer be used.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import copy_internals + + return copy_internals._calculate_keys(self, *args, **kwargs) -_is_base_model_class_defined = True - - -@overload +@typing.overload def create_model( __model_name: str, *, - __config__: Optional[Type[BaseConfig]] = None, + __config__: ConfigDict | None = None, + __doc__: str | None = None, __base__: None = None, __module__: str = __name__, - __validators__: Dict[str, 'AnyClassMethod'] = None, - __cls_kwargs__: Dict[str, Any] = None, + __validators__: dict[str, classmethod] | None = None, + __cls_kwargs__: dict[str, Any] | None = None, **field_definitions: Any, -) -> Type['BaseModel']: +) -> type[BaseModel]: ... -@overload +@typing.overload def create_model( __model_name: str, *, - __config__: Optional[Type[BaseConfig]] = None, - __base__: Union[Type['Model'], Tuple[Type['Model'], ...]], + __config__: ConfigDict | None = None, + __doc__: str | None = None, + __base__: type[Model] | tuple[type[Model], ...], __module__: str = __name__, - __validators__: Dict[str, 'AnyClassMethod'] = None, - __cls_kwargs__: Dict[str, Any] = None, + __validators__: dict[str, classmethod] | None = None, + __cls_kwargs__: dict[str, Any] | None = None, **field_definitions: Any, -) -> Type['Model']: +) -> type[Model]: ... -def create_model( +def create_model( # noqa: C901 __model_name: str, *, - __config__: Optional[Type[BaseConfig]] = None, - __base__: Union[None, Type['Model'], Tuple[Type['Model'], ...]] = None, - __module__: str = __name__, - __validators__: Dict[str, 'AnyClassMethod'] = None, - __cls_kwargs__: Dict[str, Any] = None, - __slots__: Optional[Tuple[str, ...]] = None, + __config__: ConfigDict | None = None, + __doc__: str | None = None, + __base__: type[Model] | tuple[type[Model], ...] | None = None, + __module__: str | None = None, + __validators__: dict[str, classmethod] | None = None, + __cls_kwargs__: dict[str, Any] | None = None, + __slots__: tuple[str, ...] | None = None, **field_definitions: Any, -) -> Type['Model']: - """ - Dynamically create a model. - :param __model_name: name of the created model - :param __config__: config class to use for the new model - :param __base__: base class for the new model to inherit from - :param __module__: module of the created model - :param __validators__: a dict of method names and @validator class methods - :param __cls_kwargs__: a dict for class creation - :param __slots__: Deprecated, `__slots__` should not be passed to `create_model` - :param field_definitions: fields of the model (or extra fields if a base is supplied) - in the format `=(, )` or `=, e.g. - `foobar=(str, ...)` or `foobar=123`, or, for complex use-cases, in the format - `=` or `=(, )`, e.g. - `foo=Field(datetime, default_factory=datetime.utcnow, alias='bar')` or - `foo=(str, FieldInfo(title='Foo'))` +) -> type[Model]: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/#dynamic-model-creation + + Dynamically creates and returns a new Pydantic model, in other words, `create_model` dynamically creates a + subclass of [`BaseModel`][pydantic.BaseModel]. + + Args: + __model_name: The name of the newly created model. + __config__: The configuration of the new model. + __doc__: The docstring of the new model. + __base__: The base class or classes for the new model. + __module__: The name of the module that the model belongs to; + if `None`, the value is taken from `sys._getframe(1)` + __validators__: A dictionary of methods that validate fields. + __cls_kwargs__: A dictionary of keyword arguments for class creation, such as `metaclass`. + __slots__: Deprecated. Should not be passed to `create_model`. + **field_definitions: Attributes of the new model. They should be passed in the format: + `=(, )` or `=(, )`. + + Returns: + The new [model][pydantic.BaseModel]. + + Raises: + PydanticUserError: If `__base__` and `__config__` are both passed. """ if __slots__ is not None: # __slots__ will be ignored from here on @@ -982,11 +1436,14 @@ def create_model( if __base__ is not None: if __config__ is not None: - raise ConfigError('to avoid confusion __config__ and __base__ cannot be used together') + raise PydanticUserError( + 'to avoid confusion `__config__` and `__base__` cannot be used together', + code='create-model-config-base', + ) if not isinstance(__base__, tuple): __base__ = (__base__,) else: - __base__ = (cast(Type['Model'], BaseModel),) + __base__ = (typing.cast(typing.Type['Model'], BaseModel),) __cls_kwargs__ = __cls_kwargs__ or {} @@ -994,16 +1451,16 @@ def create_model( annotations = {} for f_name, f_def in field_definitions.items(): - if not is_valid_field(f_name): + if not _fields.is_valid_field_name(f_name): warnings.warn(f'fields may not start with an underscore, ignoring "{f_name}"', RuntimeWarning) if isinstance(f_def, tuple): + f_def = typing.cast('tuple[str, Any]', f_def) try: f_annotation, f_value = f_def except ValueError as e: - raise ConfigError( - 'field definitions should either be a tuple of (, ) or just a ' - 'default value, unfortunately this means tuples as ' - 'default values are not allowed' + raise PydanticUserError( + 'Field definitions should be a `(, )`.', + code='create-model-field-definitions', ) from e else: f_annotation, f_value = None, f_def @@ -1012,98 +1469,32 @@ def create_model( annotations[f_name] = f_annotation fields[f_name] = f_value - namespace: 'DictStrAny' = {'__annotations__': annotations, '__module__': __module__} + if __module__ is None: + f = sys._getframe(1) + __module__ = f.f_globals['__name__'] + + namespace: dict[str, Any] = {'__annotations__': annotations, '__module__': __module__} + if __doc__: + namespace.update({'__doc__': __doc__}) if __validators__: namespace.update(__validators__) namespace.update(fields) if __config__: - namespace['Config'] = inherit_config(__config__, BaseConfig) - resolved_bases = resolve_bases(__base__) - meta, ns, kwds = prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__) + namespace['model_config'] = _config.ConfigWrapper(__config__).config_dict + resolved_bases = types.resolve_bases(__base__) + meta, ns, kwds = types.prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__) if resolved_bases is not __base__: ns['__orig_bases__'] = __base__ namespace.update(ns) - return meta(__model_name, resolved_bases, namespace, **kwds) + + return meta( + __model_name, + resolved_bases, + namespace, + __pydantic_reset_parent_namespace__=False, + _create_model_module=__module__, + **kwds, + ) -_missing = object() - - -def validate_model( # noqa: C901 (ignore complexity) - model: Type[BaseModel], input_data: 'DictStrAny', cls: 'ModelOrDc' = None -) -> Tuple['DictStrAny', 'SetStr', Optional[ValidationError]]: - """ - validate data against a model. - """ - values = {} - errors = [] - # input_data names, possibly alias - names_used = set() - # field names, never aliases - fields_set = set() - config = model.__config__ - check_extra = config.extra is not Extra.ignore - cls_ = cls or model - - for validator in model.__pre_root_validators__: - try: - input_data = validator(cls_, input_data) - except (ValueError, TypeError, AssertionError) as exc: - return {}, set(), ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls_) - - for name, field in model.__fields__.items(): - value = input_data.get(field.alias, _missing) - using_name = False - if value is _missing and config.allow_population_by_field_name and field.alt_alias: - value = input_data.get(field.name, _missing) - using_name = True - - if value is _missing: - if field.required: - errors.append(ErrorWrapper(MissingError(), loc=field.alias)) - continue - - value = field.get_default() - - if not config.validate_all and not field.validate_always: - values[name] = value - continue - else: - fields_set.add(name) - if check_extra: - names_used.add(field.name if using_name else field.alias) - - v_, errors_ = field.validate(value, values, loc=field.alias, cls=cls_) - if isinstance(errors_, ErrorWrapper): - errors.append(errors_) - elif isinstance(errors_, list): - errors.extend(errors_) - else: - values[name] = v_ - - if check_extra: - if isinstance(input_data, GetterDict): - extra = input_data.extra_keys() - names_used - else: - extra = input_data.keys() - names_used - if extra: - fields_set |= extra - if config.extra is Extra.allow: - for f in extra: - values[f] = input_data[f] - else: - for f in sorted(extra): - errors.append(ErrorWrapper(ExtraError(), loc=f)) - - for skip_on_failure, validator in model.__post_root_validators__: - if skip_on_failure and errors: - continue - try: - values = validator(cls_, values) - except (ValueError, TypeError, AssertionError) as exc: - errors.append(ErrorWrapper(exc, loc=ROOT_KEY)) - - if errors: - return values, fields_set, ValidationError(errors, cls_) - else: - return values, fields_set, None +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/mypy.py b/lib/pydantic/mypy.py index 6bd9db18..0e70eab5 100644 --- a/lib/pydantic/mypy.py +++ b/lib/pydantic/mypy.py @@ -1,8 +1,13 @@ +"""This module includes classes and functions designed specifically for use with the mypy plugin.""" + +from __future__ import annotations + import sys from configparser import ConfigParser -from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Type as TypingType, Union +from typing import Any, Callable, Iterator from mypy.errorcodes import ErrorCode +from mypy.expandtype import expand_type, expand_type_by_instance from mypy.nodes import ( ARG_NAMED, ARG_NAMED_OPT, @@ -17,21 +22,23 @@ from mypy.nodes import ( ClassDef, Context, Decorator, + DictExpr, EllipsisExpr, - FuncBase, + Expression, FuncDef, + IfStmt, JsonDict, MemberExpr, NameExpr, PassStmt, PlaceholderNode, RefExpr, + Statement, StrExpr, - SymbolNode, SymbolTableNode, TempNode, + TypeAlias, TypeInfo, - TypeVarExpr, Var, ) from mypy.options import Options @@ -41,11 +48,17 @@ from mypy.plugin import ( FunctionContext, MethodContext, Plugin, + ReportConfigContext, SemanticAnalyzerPluginInterface, ) from mypy.plugins import dataclasses -from mypy.semanal import set_callable_name # type: ignore +from mypy.plugins.common import ( + deserialize_and_fixup_type, +) +from mypy.semanal import set_callable_name from mypy.server.trigger import make_wildcard_trigger +from mypy.state import state +from mypy.typeops import map_type_from_supertype from mypy.types import ( AnyType, CallableType, @@ -63,76 +76,131 @@ from mypy.typevars import fill_typevars from mypy.util import get_unique_redefinition_name from mypy.version import __version__ as mypy_version -from pydantic.utils import is_valid_field +from pydantic._internal import _fields +from pydantic.version import parse_mypy_version try: from mypy.types import TypeVarDef # type: ignore[attr-defined] except ImportError: # pragma: no cover - # Backward-compatible with TypeVarDef from Mypy 0.910. + # Backward-compatible with TypeVarDef from Mypy 0.930. from mypy.types import TypeVarType as TypeVarDef CONFIGFILE_KEY = 'pydantic-mypy' METADATA_KEY = 'pydantic-mypy-metadata' BASEMODEL_FULLNAME = 'pydantic.main.BaseModel' -BASESETTINGS_FULLNAME = 'pydantic.env_settings.BaseSettings' +BASESETTINGS_FULLNAME = 'pydantic_settings.main.BaseSettings' +ROOT_MODEL_FULLNAME = 'pydantic.root_model.RootModel' +MODEL_METACLASS_FULLNAME = 'pydantic._internal._model_construction.ModelMetaclass' FIELD_FULLNAME = 'pydantic.fields.Field' DATACLASS_FULLNAME = 'pydantic.dataclasses.dataclass' - - -def parse_mypy_version(version: str) -> Tuple[int, ...]: - return tuple(int(part) for part in version.split('+', 1)[0].split('.')) +MODEL_VALIDATOR_FULLNAME = 'pydantic.functional_validators.model_validator' +DECORATOR_FULLNAMES = { + 'pydantic.functional_validators.field_validator', + 'pydantic.functional_validators.model_validator', + 'pydantic.functional_serializers.serializer', + 'pydantic.functional_serializers.model_serializer', + 'pydantic.deprecated.class_validators.validator', + 'pydantic.deprecated.class_validators.root_validator', +} MYPY_VERSION_TUPLE = parse_mypy_version(mypy_version) BUILTINS_NAME = 'builtins' if MYPY_VERSION_TUPLE >= (0, 930) else '__builtins__' +# Increment version if plugin changes and mypy caches should be invalidated +__version__ = 2 -def plugin(version: str) -> 'TypingType[Plugin]': - """ - `version` is the mypy version string + +def plugin(version: str) -> type[Plugin]: + """`version` is the mypy version string. We might want to use this to print a warning if the mypy version being used is newer, or especially older, than we expect (or need). + + Args: + version: The mypy version string. + + Return: + The Pydantic mypy plugin type. """ return PydanticPlugin +class _DeferAnalysis(Exception): + pass + + class PydanticPlugin(Plugin): + """The Pydantic mypy plugin.""" + def __init__(self, options: Options) -> None: self.plugin_config = PydanticPluginConfig(options) + self._plugin_data = self.plugin_config.to_data() super().__init__(options) - def get_base_class_hook(self, fullname: str) -> 'Optional[Callable[[ClassDefContext], None]]': + def get_base_class_hook(self, fullname: str) -> Callable[[ClassDefContext], bool] | None: + """Update Pydantic model class.""" sym = self.lookup_fully_qualified(fullname) if sym and isinstance(sym.node, TypeInfo): # pragma: no branch # No branching may occur if the mypy cache has not been cleared - if any(get_fullname(base) == BASEMODEL_FULLNAME for base in sym.node.mro): + if any(base.fullname == BASEMODEL_FULLNAME for base in sym.node.mro): return self._pydantic_model_class_maker_callback return None - def get_function_hook(self, fullname: str) -> 'Optional[Callable[[FunctionContext], Type]]': + def get_metaclass_hook(self, fullname: str) -> Callable[[ClassDefContext], None] | None: + """Update Pydantic `ModelMetaclass` definition.""" + if fullname == MODEL_METACLASS_FULLNAME: + return self._pydantic_model_metaclass_marker_callback + return None + + def get_function_hook(self, fullname: str) -> Callable[[FunctionContext], Type] | None: + """Adjust the return type of the `Field` function.""" sym = self.lookup_fully_qualified(fullname) if sym and sym.fullname == FIELD_FULLNAME: return self._pydantic_field_callback return None - def get_method_hook(self, fullname: str) -> Optional[Callable[[MethodContext], Type]]: + def get_method_hook(self, fullname: str) -> Callable[[MethodContext], Type] | None: + """Adjust return type of `from_orm` method call.""" if fullname.endswith('.from_orm'): - return from_orm_callback + return from_attributes_callback return None - def get_class_decorator_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]: - if fullname == DATACLASS_FULLNAME: + def get_class_decorator_hook(self, fullname: str) -> Callable[[ClassDefContext], None] | None: + """Mark pydantic.dataclasses as dataclass. + + Mypy version 1.1.1 added support for `@dataclass_transform` decorator. + """ + if fullname == DATACLASS_FULLNAME and MYPY_VERSION_TUPLE < (1, 1): return dataclasses.dataclass_class_maker_callback # type: ignore[return-value] return None - def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> None: - transformer = PydanticModelTransformer(ctx, self.plugin_config) - transformer.transform() + def report_config_data(self, ctx: ReportConfigContext) -> dict[str, Any]: + """Return all plugin config data. - def _pydantic_field_callback(self, ctx: FunctionContext) -> 'Type': + Used by mypy to determine if cache needs to be discarded. """ - Extract the type of the `default` argument from the Field function, and use it as the return type. + return self._plugin_data + + def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> bool: + transformer = PydanticModelTransformer(ctx.cls, ctx.reason, ctx.api, self.plugin_config) + return transformer.transform() + + def _pydantic_model_metaclass_marker_callback(self, ctx: ClassDefContext) -> None: + """Reset dataclass_transform_spec attribute of ModelMetaclass. + + Let the plugin handle it. This behavior can be disabled + if 'debug_dataclass_transform' is set to True', for testing purposes. + """ + if self.plugin_config.debug_dataclass_transform: + return + info_metaclass = ctx.cls.info.declared_metaclass + assert info_metaclass, "callback not passed from 'get_metaclass_hook'" + if getattr(info_metaclass.type, 'dataclass_transform_spec', None): + info_metaclass.type.dataclass_transform_spec = None + + def _pydantic_field_callback(self, ctx: FunctionContext) -> Type: + """Extract the type of the `default` argument from the Field function, and use it as the return type. In particular: * Check whether the default and default_factory argument is specified. @@ -164,11 +232,7 @@ class PydanticPlugin(Plugin): # Functions which use `ParamSpec` can be overloaded, exposing the callable's types as a parameter # Pydantic calls the default factory without any argument, so we retrieve the first item if isinstance(default_factory_type, Overloaded): - if MYPY_VERSION_TUPLE > (0, 910): - default_factory_type = default_factory_type.items[0] - else: - # Mypy0.910 exposes the items of overloaded types in a function - default_factory_type = default_factory_type.items()[0] # type: ignore[operator] + default_factory_type = default_factory_type.items[0] if isinstance(default_factory_type, CallableType): ret_type = default_factory_type.ret_type @@ -185,11 +249,26 @@ class PydanticPlugin(Plugin): class PydanticPluginConfig: - __slots__ = ('init_forbid_extra', 'init_typed', 'warn_required_dynamic_aliases', 'warn_untyped_fields') + """A Pydantic mypy plugin config holder. + + Attributes: + init_forbid_extra: Whether to add a `**kwargs` at the end of the generated `__init__` signature. + init_typed: Whether to annotate fields in the generated `__init__`. + warn_required_dynamic_aliases: Whether to raise required dynamic aliases error. + debug_dataclass_transform: Whether to not reset `dataclass_transform_spec` attribute + of `ModelMetaclass` for testing purposes. + """ + + __slots__ = ( + 'init_forbid_extra', + 'init_typed', + 'warn_required_dynamic_aliases', + 'debug_dataclass_transform', + ) init_forbid_extra: bool init_typed: bool warn_required_dynamic_aliases: bool - warn_untyped_fields: bool + debug_dataclass_transform: bool # undocumented def __init__(self, options: Options) -> None: if options.config_file is None: # pragma: no cover @@ -210,343 +289,724 @@ class PydanticPluginConfig: setting = plugin_config.getboolean(CONFIGFILE_KEY, key, fallback=False) setattr(self, key, setting) + def to_data(self) -> dict[str, Any]: + """Returns a dict of config names to their values.""" + return {key: getattr(self, key) for key in self.__slots__} -def from_orm_callback(ctx: MethodContext) -> Type: - """ - Raise an error if orm_mode is not enabled - """ + +def from_attributes_callback(ctx: MethodContext) -> Type: + """Raise an error if from_attributes is not enabled.""" model_type: Instance - if isinstance(ctx.type, CallableType) and isinstance(ctx.type.ret_type, Instance): - model_type = ctx.type.ret_type # called on the class - elif isinstance(ctx.type, Instance): - model_type = ctx.type # called on an instance (unusual, but still valid) + ctx_type = ctx.type + if isinstance(ctx_type, TypeType): + ctx_type = ctx_type.item + if isinstance(ctx_type, CallableType) and isinstance(ctx_type.ret_type, Instance): + model_type = ctx_type.ret_type # called on the class + elif isinstance(ctx_type, Instance): + model_type = ctx_type # called on an instance (unusual, but still valid) else: # pragma: no cover - detail = f'ctx.type: {ctx.type} (of type {ctx.type.__class__.__name__})' + detail = f'ctx.type: {ctx_type} (of type {ctx_type.__class__.__name__})' error_unexpected_behavior(detail, ctx.api, ctx.context) return ctx.default_return_type pydantic_metadata = model_type.type.metadata.get(METADATA_KEY) if pydantic_metadata is None: return ctx.default_return_type - orm_mode = pydantic_metadata.get('config', {}).get('orm_mode') - if orm_mode is not True: - error_from_orm(get_name(model_type.type), ctx.api, ctx.context) + from_attributes = pydantic_metadata.get('config', {}).get('from_attributes') + if from_attributes is not True: + error_from_attributes(model_type.type.name, ctx.api, ctx.context) return ctx.default_return_type +class PydanticModelField: + """Based on mypy.plugins.dataclasses.DataclassAttribute.""" + + def __init__( + self, + name: str, + alias: str | None, + has_dynamic_alias: bool, + has_default: bool, + line: int, + column: int, + type: Type | None, + info: TypeInfo, + ): + self.name = name + self.alias = alias + self.has_dynamic_alias = has_dynamic_alias + self.has_default = has_default + self.line = line + self.column = column + self.type = type + self.info = info + + def to_argument( + self, + current_info: TypeInfo, + typed: bool, + force_optional: bool, + use_alias: bool, + api: SemanticAnalyzerPluginInterface, + ) -> Argument: + """Based on mypy.plugins.dataclasses.DataclassAttribute.to_argument.""" + variable = self.to_var(current_info, api, use_alias) + type_annotation = self.expand_type(current_info, api) if typed else AnyType(TypeOfAny.explicit) + return Argument( + variable=variable, + type_annotation=type_annotation, + initializer=None, + kind=ARG_NAMED_OPT if force_optional or self.has_default else ARG_NAMED, + ) + + def expand_type(self, current_info: TypeInfo, api: SemanticAnalyzerPluginInterface) -> Type | None: + """Based on mypy.plugins.dataclasses.DataclassAttribute.expand_type.""" + # The getattr in the next line is used to prevent errors in legacy versions of mypy without this attribute + if self.type is not None and getattr(self.info, 'self_type', None) is not None: + # In general, it is not safe to call `expand_type()` during semantic analyzis, + # however this plugin is called very late, so all types should be fully ready. + # Also, it is tricky to avoid eager expansion of Self types here (e.g. because + # we serialize attributes). + expanded_type = expand_type(self.type, {self.info.self_type.id: fill_typevars(current_info)}) + if isinstance(self.type, UnionType) and not isinstance(expanded_type, UnionType): + if not api.final_iteration: + raise _DeferAnalysis() + return expanded_type + return self.type + + def to_var(self, current_info: TypeInfo, api: SemanticAnalyzerPluginInterface, use_alias: bool) -> Var: + """Based on mypy.plugins.dataclasses.DataclassAttribute.to_var.""" + if use_alias and self.alias is not None: + name = self.alias + else: + name = self.name + + return Var(name, self.expand_type(current_info, api)) + + def serialize(self) -> JsonDict: + """Based on mypy.plugins.dataclasses.DataclassAttribute.serialize.""" + assert self.type + return { + 'name': self.name, + 'alias': self.alias, + 'has_dynamic_alias': self.has_dynamic_alias, + 'has_default': self.has_default, + 'line': self.line, + 'column': self.column, + 'type': self.type.serialize(), + } + + @classmethod + def deserialize(cls, info: TypeInfo, data: JsonDict, api: SemanticAnalyzerPluginInterface) -> PydanticModelField: + """Based on mypy.plugins.dataclasses.DataclassAttribute.deserialize.""" + data = data.copy() + typ = deserialize_and_fixup_type(data.pop('type'), api) + return cls(type=typ, info=info, **data) + + def expand_typevar_from_subtype(self, sub_type: TypeInfo) -> None: + """Expands type vars in the context of a subtype when an attribute is inherited + from a generic super type. + """ + if self.type is not None: + self.type = map_type_from_supertype(self.type, sub_type, self.info) + + +class PydanticModelClassVar: + """Based on mypy.plugins.dataclasses.DataclassAttribute. + + ClassVars are ignored by subclasses. + + Attributes: + name: the ClassVar name + """ + + def __init__(self, name): + self.name = name + + @classmethod + def deserialize(cls, data: JsonDict) -> PydanticModelClassVar: + """Based on mypy.plugins.dataclasses.DataclassAttribute.deserialize.""" + data = data.copy() + return cls(**data) + + def serialize(self) -> JsonDict: + """Based on mypy.plugins.dataclasses.DataclassAttribute.serialize.""" + return { + 'name': self.name, + } + + class PydanticModelTransformer: - tracked_config_fields: Set[str] = { + """Transform the BaseModel subclass according to the plugin settings. + + Attributes: + tracked_config_fields: A set of field configs that the plugin has to track their value. + """ + + tracked_config_fields: set[str] = { 'extra', - 'allow_mutation', 'frozen', - 'orm_mode', - 'allow_population_by_field_name', + 'from_attributes', + 'populate_by_name', 'alias_generator', } - def __init__(self, ctx: ClassDefContext, plugin_config: PydanticPluginConfig) -> None: - self._ctx = ctx + def __init__( + self, + cls: ClassDef, + reason: Expression | Statement, + api: SemanticAnalyzerPluginInterface, + plugin_config: PydanticPluginConfig, + ) -> None: + self._cls = cls + self._reason = reason + self._api = api + self.plugin_config = plugin_config - def transform(self) -> None: - """ - Configures the BaseModel subclass according to the plugin settings. + def transform(self) -> bool: + """Configures the BaseModel subclass according to the plugin settings. In particular: + * determines the model config and fields, * adds a fields-aware signature for the initializer and construct methods - * freezes the class if allow_mutation = False or frozen = True + * freezes the class if frozen = True * stores the fields, config, and if the class is settings in the mypy metadata for access by subclasses """ - ctx = self._ctx - info = self._ctx.cls.info - - self.adjust_validator_signatures() + info = self._cls.info + is_root_model = any(ROOT_MODEL_FULLNAME in base.fullname for base in info.mro[:-1]) config = self.collect_config() - fields = self.collect_fields(config) + fields, class_vars = self.collect_fields_and_class_vars(config, is_root_model) + if fields is None or class_vars is None: + # Some definitions are not ready. We need another pass. + return False for field in fields: - if info[field.name].type is None: - if not ctx.api.final_iteration: - ctx.api.defer() - is_settings = any(get_fullname(base) == BASESETTINGS_FULLNAME for base in info.mro[:-1]) - self.add_initializer(fields, config, is_settings) - self.add_construct_method(fields) - self.set_frozen(fields, frozen=config.allow_mutation is False or config.frozen is True) + if field.type is None: + return False + + is_settings = any(base.fullname == BASESETTINGS_FULLNAME for base in info.mro[:-1]) + try: + self.add_initializer(fields, config, is_settings, is_root_model) + self.add_model_construct_method(fields, config, is_settings) + self.set_frozen(fields, self._api, frozen=config.frozen is True) + except _DeferAnalysis: + if not self._api.final_iteration: + self._api.defer() + + self.adjust_decorator_signatures() + info.metadata[METADATA_KEY] = { 'fields': {field.name: field.serialize() for field in fields}, - 'config': config.set_values_dict(), + 'class_vars': {class_var.name: class_var.serialize() for class_var in class_vars}, + 'config': config.get_values_dict(), } - def adjust_validator_signatures(self) -> None: - """When we decorate a function `f` with `pydantic.validator(...), mypy sees - `f` as a regular method taking a `self` instance, even though pydantic - internally wraps `f` with `classmethod` if necessary. + return True - Teach mypy this by marking any function whose outermost decorator is a - `validator()` call as a classmethod. + def adjust_decorator_signatures(self) -> None: + """When we decorate a function `f` with `pydantic.validator(...)`, `pydantic.field_validator` + or `pydantic.serializer(...)`, mypy sees `f` as a regular method taking a `self` instance, + even though pydantic internally wraps `f` with `classmethod` if necessary. + + Teach mypy this by marking any function whose outermost decorator is a `validator()`, + `field_validator()` or `serializer()` call as a `classmethod`. """ - for name, sym in self._ctx.cls.info.names.items(): + for name, sym in self._cls.info.names.items(): if isinstance(sym.node, Decorator): first_dec = sym.node.original_decorators[0] if ( isinstance(first_dec, CallExpr) and isinstance(first_dec.callee, NameExpr) - and first_dec.callee.fullname == 'pydantic.class_validators.validator' + and first_dec.callee.fullname in DECORATOR_FULLNAMES + # @model_validator(mode="after") is an exception, it expects a regular method + and not ( + first_dec.callee.fullname == MODEL_VALIDATOR_FULLNAME + and any( + first_dec.arg_names[i] == 'mode' and isinstance(arg, StrExpr) and arg.value == 'after' + for i, arg in enumerate(first_dec.args) + ) + ) ): + # TODO: Only do this if the first argument of the decorated function is `cls` sym.node.func.is_class = True - def collect_config(self) -> 'ModelConfigData': - """ - Collects the values of the config attributes that are used by the plugin, accounting for parent classes. - """ - ctx = self._ctx - cls = ctx.cls + def collect_config(self) -> ModelConfigData: # noqa: C901 (ignore complexity) + """Collects the values of the config attributes that are used by the plugin, accounting for parent classes.""" + cls = self._cls config = ModelConfigData() + + has_config_kwargs = False + has_config_from_namespace = False + + # Handle `class MyModel(BaseModel, =, ...):` + for name, expr in cls.keywords.items(): + config_data = self.get_config_update(name, expr) + if config_data: + has_config_kwargs = True + config.update(config_data) + + # Handle `model_config` + stmt: Statement | None = None for stmt in cls.defs.body: - if not isinstance(stmt, ClassDef): + if not isinstance(stmt, (AssignmentStmt, ClassDef)): continue - if stmt.name == 'Config': + + if isinstance(stmt, AssignmentStmt): + lhs = stmt.lvalues[0] + if not isinstance(lhs, NameExpr) or lhs.name != 'model_config': + continue + + if isinstance(stmt.rvalue, CallExpr): # calls to `dict` or `ConfigDict` + for arg_name, arg in zip(stmt.rvalue.arg_names, stmt.rvalue.args): + if arg_name is None: + continue + config.update(self.get_config_update(arg_name, arg)) + elif isinstance(stmt.rvalue, DictExpr): # dict literals + for key_expr, value_expr in stmt.rvalue.items: + if not isinstance(key_expr, StrExpr): + continue + config.update(self.get_config_update(key_expr.value, value_expr)) + + elif isinstance(stmt, ClassDef): + if stmt.name != 'Config': # 'deprecated' Config-class + continue for substmt in stmt.defs.body: if not isinstance(substmt, AssignmentStmt): continue - config.update(self.get_config_update(substmt)) - if ( - config.has_alias_generator - and not config.allow_population_by_field_name - and self.plugin_config.warn_required_dynamic_aliases - ): - error_required_dynamic_aliases(ctx.api, stmt) + lhs = substmt.lvalues[0] + if not isinstance(lhs, NameExpr): + continue + config.update(self.get_config_update(lhs.name, substmt.rvalue)) + + if has_config_kwargs: + self._api.fail( + 'Specifying config in two places is ambiguous, use either Config attribute or class kwargs', + cls, + ) + break + + has_config_from_namespace = True + + if has_config_kwargs or has_config_from_namespace: + if ( + stmt + and config.has_alias_generator + and not config.populate_by_name + and self.plugin_config.warn_required_dynamic_aliases + ): + error_required_dynamic_aliases(self._api, stmt) + for info in cls.info.mro[1:]: # 0 is the current class if METADATA_KEY not in info.metadata: continue # Each class depends on the set of fields in its ancestors - ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info))) + self._api.add_plugin_dependency(make_wildcard_trigger(info.fullname)) for name, value in info.metadata[METADATA_KEY]['config'].items(): config.setdefault(name, value) return config - def collect_fields(self, model_config: 'ModelConfigData') -> List['PydanticModelField']: - """ - Collects the fields for the model, accounting for parent classes - """ - # First, collect fields belonging to the current class. - ctx = self._ctx - cls = self._ctx.cls - fields = [] # type: List[PydanticModelField] - known_fields = set() # type: Set[str] - for stmt in cls.defs.body: - if not isinstance(stmt, AssignmentStmt): # `and stmt.new_syntax` to require annotation - continue + def collect_fields_and_class_vars( + self, model_config: ModelConfigData, is_root_model: bool + ) -> tuple[list[PydanticModelField] | None, list[PydanticModelClassVar] | None]: + """Collects the fields for the model, accounting for parent classes.""" + cls = self._cls - lhs = stmt.lvalues[0] - if not isinstance(lhs, NameExpr) or not is_valid_field(lhs.name): - continue - - if not stmt.new_syntax and self.plugin_config.warn_untyped_fields: - error_untyped_fields(ctx.api, stmt) - - # if lhs.name == '__config__': # BaseConfig not well handled; I'm not sure why yet - # continue - - sym = cls.info.names.get(lhs.name) - if sym is None: # pragma: no cover - # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation) - # This is the same logic used in the dataclasses plugin - continue - - node = sym.node - if isinstance(node, PlaceholderNode): # pragma: no cover - # See the PlaceholderNode docstring for more detail about how this can occur - # Basically, it is an edge case when dealing with complex import logic - # This is the same logic used in the dataclasses plugin - continue - if not isinstance(node, Var): # pragma: no cover - # Don't know if this edge case still happens with the `is_valid_field` check above - # but better safe than sorry - continue - - # x: ClassVar[int] is ignored by dataclasses. - if node.is_classvar: - continue - - is_required = self.get_is_required(cls, stmt, lhs) - alias, has_dynamic_alias = self.get_alias_info(stmt) - if ( - has_dynamic_alias - and not model_config.allow_population_by_field_name - and self.plugin_config.warn_required_dynamic_aliases - ): - error_required_dynamic_aliases(ctx.api, stmt) - fields.append( - PydanticModelField( - name=lhs.name, - is_required=is_required, - alias=alias, - has_dynamic_alias=has_dynamic_alias, - line=stmt.line, - column=stmt.column, - ) - ) - known_fields.add(lhs.name) - all_fields = fields.copy() - for info in cls.info.mro[1:]: # 0 is the current class, -2 is BaseModel, -1 is object + # First, collect fields and ClassVars belonging to any class in the MRO, ignoring duplicates. + # + # We iterate through the MRO in reverse because attrs defined in the parent must appear + # earlier in the attributes list than attrs defined in the child. See: + # https://docs.python.org/3/library/dataclasses.html#inheritance + # + # However, we also want fields defined in the subtype to override ones defined + # in the parent. We can implement this via a dict without disrupting the attr order + # because dicts preserve insertion order in Python 3.7+. + found_fields: dict[str, PydanticModelField] = {} + found_class_vars: dict[str, PydanticModelClassVar] = {} + for info in reversed(cls.info.mro[1:-1]): # 0 is the current class, -2 is BaseModel, -1 is object + # if BASEMODEL_METADATA_TAG_KEY in info.metadata and BASEMODEL_METADATA_KEY not in info.metadata: + # # We haven't processed the base class yet. Need another pass. + # return None, None if METADATA_KEY not in info.metadata: continue - superclass_fields = [] - # Each class depends on the set of fields in its ancestors - ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info))) + # Each class depends on the set of attributes in its dataclass ancestors. + self._api.add_plugin_dependency(make_wildcard_trigger(info.fullname)) for name, data in info.metadata[METADATA_KEY]['fields'].items(): - if name not in known_fields: - field = PydanticModelField.deserialize(info, data) - known_fields.add(name) - superclass_fields.append(field) - else: - (field,) = (a for a in all_fields if a.name == name) - all_fields.remove(field) - superclass_fields.append(field) - all_fields = superclass_fields + all_fields - return all_fields + field = PydanticModelField.deserialize(info, data, self._api) + # (The following comment comes directly from the dataclasses plugin) + # TODO: We shouldn't be performing type operations during the main + # semantic analysis pass, since some TypeInfo attributes might + # still be in flux. This should be performed in a later phase. + with state.strict_optional_set(self._api.options.strict_optional): + field.expand_typevar_from_subtype(cls.info) + found_fields[name] = field - def add_initializer(self, fields: List['PydanticModelField'], config: 'ModelConfigData', is_settings: bool) -> None: + sym_node = cls.info.names.get(name) + if sym_node and sym_node.node and not isinstance(sym_node.node, Var): + self._api.fail( + 'BaseModel field may only be overridden by another field', + sym_node.node, + ) + # Collect ClassVars + for name, data in info.metadata[METADATA_KEY]['class_vars'].items(): + found_class_vars[name] = PydanticModelClassVar.deserialize(data) + + # Second, collect fields and ClassVars belonging to the current class. + current_field_names: set[str] = set() + current_class_vars_names: set[str] = set() + for stmt in self._get_assignment_statements_from_block(cls.defs): + maybe_field = self.collect_field_or_class_var_from_stmt(stmt, model_config, found_class_vars) + if isinstance(maybe_field, PydanticModelField): + lhs = stmt.lvalues[0] + if is_root_model and lhs.name != 'root': + error_extra_fields_on_root_model(self._api, stmt) + else: + current_field_names.add(lhs.name) + found_fields[lhs.name] = maybe_field + elif isinstance(maybe_field, PydanticModelClassVar): + lhs = stmt.lvalues[0] + current_class_vars_names.add(lhs.name) + found_class_vars[lhs.name] = maybe_field + + return list(found_fields.values()), list(found_class_vars.values()) + + def _get_assignment_statements_from_if_statement(self, stmt: IfStmt) -> Iterator[AssignmentStmt]: + for body in stmt.body: + if not body.is_unreachable: + yield from self._get_assignment_statements_from_block(body) + if stmt.else_body is not None and not stmt.else_body.is_unreachable: + yield from self._get_assignment_statements_from_block(stmt.else_body) + + def _get_assignment_statements_from_block(self, block: Block) -> Iterator[AssignmentStmt]: + for stmt in block.body: + if isinstance(stmt, AssignmentStmt): + yield stmt + elif isinstance(stmt, IfStmt): + yield from self._get_assignment_statements_from_if_statement(stmt) + + def collect_field_or_class_var_from_stmt( # noqa C901 + self, stmt: AssignmentStmt, model_config: ModelConfigData, class_vars: dict[str, PydanticModelClassVar] + ) -> PydanticModelField | PydanticModelClassVar | None: + """Get pydantic model field from statement. + + Args: + stmt: The statement. + model_config: Configuration settings for the model. + class_vars: ClassVars already known to be defined on the model. + + Returns: + A pydantic model field if it could find the field in statement. Otherwise, `None`. """ - Adds a fields-aware `__init__` method to the class. + cls = self._cls + + lhs = stmt.lvalues[0] + if not isinstance(lhs, NameExpr) or not _fields.is_valid_field_name(lhs.name) or lhs.name == 'model_config': + return None + + if not stmt.new_syntax: + if ( + isinstance(stmt.rvalue, CallExpr) + and isinstance(stmt.rvalue.callee, CallExpr) + and isinstance(stmt.rvalue.callee.callee, NameExpr) + and stmt.rvalue.callee.callee.fullname in DECORATOR_FULLNAMES + ): + # This is a (possibly-reused) validator or serializer, not a field + # In particular, it looks something like: my_validator = validator('my_field')(f) + # Eventually, we may want to attempt to respect model_config['ignored_types'] + return None + + if lhs.name in class_vars: + # Class vars are not fields and are not required to be annotated + return None + + # The assignment does not have an annotation, and it's not anything else we recognize + error_untyped_fields(self._api, stmt) + return None + + lhs = stmt.lvalues[0] + if not isinstance(lhs, NameExpr): + return None + + if not _fields.is_valid_field_name(lhs.name) or lhs.name == 'model_config': + return None + + sym = cls.info.names.get(lhs.name) + if sym is None: # pragma: no cover + # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation) + # This is the same logic used in the dataclasses plugin + return None + + node = sym.node + if isinstance(node, PlaceholderNode): # pragma: no cover + # See the PlaceholderNode docstring for more detail about how this can occur + # Basically, it is an edge case when dealing with complex import logic + + # The dataclasses plugin now asserts this cannot happen, but I'd rather not error if it does.. + return None + + if isinstance(node, TypeAlias): + self._api.fail( + 'Type aliases inside BaseModel definitions are not supported at runtime', + node, + ) + # Skip processing this node. This doesn't match the runtime behaviour, + # but the only alternative would be to modify the SymbolTable, + # and it's a little hairy to do that in a plugin. + return None + + if not isinstance(node, Var): # pragma: no cover + # Don't know if this edge case still happens with the `is_valid_field` check above + # but better safe than sorry + + # The dataclasses plugin now asserts this cannot happen, but I'd rather not error if it does.. + return None + + # x: ClassVar[int] is not a field + if node.is_classvar: + return PydanticModelClassVar(lhs.name) + + # x: InitVar[int] is not supported in BaseModel + node_type = get_proper_type(node.type) + if isinstance(node_type, Instance) and node_type.type.fullname == 'dataclasses.InitVar': + self._api.fail( + 'InitVar is not supported in BaseModel', + node, + ) + + has_default = self.get_has_default(stmt) + + if sym.type is None and node.is_final and node.is_inferred: + # This follows the logic from the dataclasses plugin. The following comment is taken verbatim: + # + # This is a special case, assignment like x: Final = 42 is classified + # annotated above, but mypy strips the `Final` turning it into x = 42. + # We do not support inferred types in dataclasses, so we can try inferring + # type for simple literals, and otherwise require an explicit type + # argument for Final[...]. + typ = self._api.analyze_simple_literal_type(stmt.rvalue, is_final=True) + if typ: + node.type = typ + else: + self._api.fail( + 'Need type argument for Final[...] with non-literal default in BaseModel', + stmt, + ) + node.type = AnyType(TypeOfAny.from_error) + + alias, has_dynamic_alias = self.get_alias_info(stmt) + if has_dynamic_alias and not model_config.populate_by_name and self.plugin_config.warn_required_dynamic_aliases: + error_required_dynamic_aliases(self._api, stmt) + + init_type = self._infer_dataclass_attr_init_type(sym, lhs.name, stmt) + return PydanticModelField( + name=lhs.name, + has_dynamic_alias=has_dynamic_alias, + has_default=has_default, + alias=alias, + line=stmt.line, + column=stmt.column, + type=init_type, + info=cls.info, + ) + + def _infer_dataclass_attr_init_type(self, sym: SymbolTableNode, name: str, context: Context) -> Type | None: + """Infer __init__ argument type for an attribute. + + In particular, possibly use the signature of __set__. + """ + default = sym.type + if sym.implicit: + return default + t = get_proper_type(sym.type) + + # Perform a simple-minded inference from the signature of __set__, if present. + # We can't use mypy.checkmember here, since this plugin runs before type checking. + # We only support some basic scanerios here, which is hopefully sufficient for + # the vast majority of use cases. + if not isinstance(t, Instance): + return default + setter = t.type.get('__set__') + if setter: + if isinstance(setter.node, FuncDef): + super_info = t.type.get_containing_type_info('__set__') + assert super_info + if setter.type: + setter_type = get_proper_type(map_type_from_supertype(setter.type, t.type, super_info)) + else: + return AnyType(TypeOfAny.unannotated) + if isinstance(setter_type, CallableType) and setter_type.arg_kinds == [ + ARG_POS, + ARG_POS, + ARG_POS, + ]: + return expand_type_by_instance(setter_type.arg_types[2], t) + else: + self._api.fail(f'Unsupported signature for "__set__" in "{t.type.name}"', context) + else: + self._api.fail(f'Unsupported "__set__" in "{t.type.name}"', context) + + return default + + def add_initializer( + self, fields: list[PydanticModelField], config: ModelConfigData, is_settings: bool, is_root_model: bool + ) -> None: + """Adds a fields-aware `__init__` method to the class. The added `__init__` will be annotated with types vs. all `Any` depending on the plugin settings. """ - ctx = self._ctx + if '__init__' in self._cls.info.names and not self._cls.info.names['__init__'].plugin_generated: + return # Don't generate an __init__ if one already exists + typed = self.plugin_config.init_typed - use_alias = config.allow_population_by_field_name is not True - force_all_optional = is_settings or bool( - config.has_alias_generator and not config.allow_population_by_field_name - ) - init_arguments = self.get_field_arguments( - fields, typed=typed, force_all_optional=force_all_optional, use_alias=use_alias - ) + use_alias = config.populate_by_name is not True + requires_dynamic_aliases = bool(config.has_alias_generator and not config.populate_by_name) + with state.strict_optional_set(self._api.options.strict_optional): + args = self.get_field_arguments( + fields, + typed=typed, + requires_dynamic_aliases=requires_dynamic_aliases, + use_alias=use_alias, + is_settings=is_settings, + ) + + if is_root_model and MYPY_VERSION_TUPLE <= (1, 0, 1): + # convert root argument to positional argument + # This is needed because mypy support for `dataclass_transform` isn't complete on 1.0.1 + args[0].kind = ARG_POS if args[0].kind == ARG_NAMED else ARG_OPT + + if is_settings: + base_settings_node = self._api.lookup_fully_qualified(BASESETTINGS_FULLNAME).node + if '__init__' in base_settings_node.names: + base_settings_init_node = base_settings_node.names['__init__'].node + if base_settings_init_node is not None and base_settings_init_node.type is not None: + func_type = base_settings_init_node.type + for arg_idx, arg_name in enumerate(func_type.arg_names): + if arg_name.startswith('__') or not arg_name.startswith('_'): + continue + analyzed_variable_type = self._api.anal_type(func_type.arg_types[arg_idx]) + variable = Var(arg_name, analyzed_variable_type) + args.append(Argument(variable, analyzed_variable_type, None, ARG_OPT)) + if not self.should_init_forbid_extra(fields, config): var = Var('kwargs') - init_arguments.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2)) + args.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2)) - if '__init__' not in ctx.cls.info.names: - add_method(ctx, '__init__', init_arguments, NoneType()) + add_method(self._api, self._cls, '__init__', args=args, return_type=NoneType()) - def add_construct_method(self, fields: List['PydanticModelField']) -> None: - """ - Adds a fully typed `construct` classmethod to the class. + def add_model_construct_method( + self, fields: list[PydanticModelField], config: ModelConfigData, is_settings: bool + ) -> None: + """Adds a fully typed `model_construct` classmethod to the class. Similar to the fields-aware __init__ method, but always uses the field names (not aliases), and does not treat settings fields as optional. """ - ctx = self._ctx - set_str = ctx.api.named_type(f'{BUILTINS_NAME}.set', [ctx.api.named_type(f'{BUILTINS_NAME}.str')]) + set_str = self._api.named_type(f'{BUILTINS_NAME}.set', [self._api.named_type(f'{BUILTINS_NAME}.str')]) optional_set_str = UnionType([set_str, NoneType()]) fields_set_argument = Argument(Var('_fields_set', optional_set_str), optional_set_str, None, ARG_OPT) - construct_arguments = self.get_field_arguments(fields, typed=True, force_all_optional=False, use_alias=False) - construct_arguments = [fields_set_argument] + construct_arguments + with state.strict_optional_set(self._api.options.strict_optional): + args = self.get_field_arguments( + fields, typed=True, requires_dynamic_aliases=False, use_alias=False, is_settings=is_settings + ) + if not self.should_init_forbid_extra(fields, config): + var = Var('kwargs') + args.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2)) - obj_type = ctx.api.named_type(f'{BUILTINS_NAME}.object') - self_tvar_name = '_PydanticBaseModel' # Make sure it does not conflict with other names in the class - tvar_fullname = ctx.cls.fullname + '.' + self_tvar_name - tvd = TypeVarDef(self_tvar_name, tvar_fullname, -1, [], obj_type) - self_tvar_expr = TypeVarExpr(self_tvar_name, tvar_fullname, [], obj_type) - ctx.cls.info.names[self_tvar_name] = SymbolTableNode(MDEF, self_tvar_expr) - - # Backward-compatible with TypeVarDef from Mypy 0.910. - if isinstance(tvd, TypeVarType): - self_type = tvd - else: - self_type = TypeVarType(tvd) # type: ignore[call-arg] + args = [fields_set_argument] + args add_method( - ctx, - 'construct', - construct_arguments, - return_type=self_type, - self_type=self_type, - tvar_def=tvd, + self._api, + self._cls, + 'model_construct', + args=args, + return_type=fill_typevars(self._cls.info), is_classmethod=True, ) - def set_frozen(self, fields: List['PydanticModelField'], frozen: bool) -> None: - """ - Marks all fields as properties so that attempts to set them trigger mypy errors. + def set_frozen(self, fields: list[PydanticModelField], api: SemanticAnalyzerPluginInterface, frozen: bool) -> None: + """Marks all fields as properties so that attempts to set them trigger mypy errors. This is the same approach used by the attrs and dataclasses plugins. """ - info = self._ctx.cls.info + info = self._cls.info for field in fields: sym_node = info.names.get(field.name) if sym_node is not None: var = sym_node.node - assert isinstance(var, Var) - var.is_property = frozen + if isinstance(var, Var): + var.is_property = frozen + elif isinstance(var, PlaceholderNode) and not self._api.final_iteration: + # See https://github.com/pydantic/pydantic/issues/5191 to hit this branch for test coverage + self._api.defer() + else: # pragma: no cover + # I don't know whether it's possible to hit this branch, but I've added it for safety + try: + var_str = str(var) + except TypeError: + # This happens for PlaceholderNode; perhaps it will happen for other types in the future.. + var_str = repr(var) + detail = f'sym_node.node: {var_str} (of type {var.__class__})' + error_unexpected_behavior(detail, self._api, self._cls) else: - var = field.to_var(info, use_alias=False) + var = field.to_var(info, api, use_alias=False) var.info = info var.is_property = frozen - var._fullname = get_fullname(info) + '.' + get_name(var) - info.names[get_name(var)] = SymbolTableNode(MDEF, var) + var._fullname = info.fullname + '.' + var.name + info.names[var.name] = SymbolTableNode(MDEF, var) - def get_config_update(self, substmt: AssignmentStmt) -> Optional['ModelConfigData']: - """ - Determines the config update due to a single statement in the Config class definition. + def get_config_update(self, name: str, arg: Expression) -> ModelConfigData | None: + """Determines the config update due to a single kwarg in the ConfigDict definition. Warns if a tracked config attribute is set to a value the plugin doesn't know how to interpret (e.g., an int) """ - lhs = substmt.lvalues[0] - if not (isinstance(lhs, NameExpr) and lhs.name in self.tracked_config_fields): + if name not in self.tracked_config_fields: return None - if lhs.name == 'extra': - if isinstance(substmt.rvalue, StrExpr): - forbid_extra = substmt.rvalue.value == 'forbid' - elif isinstance(substmt.rvalue, MemberExpr): - forbid_extra = substmt.rvalue.name == 'forbid' + if name == 'extra': + if isinstance(arg, StrExpr): + forbid_extra = arg.value == 'forbid' + elif isinstance(arg, MemberExpr): + forbid_extra = arg.name == 'forbid' else: - error_invalid_config_value(lhs.name, self._ctx.api, substmt) + error_invalid_config_value(name, self._api, arg) return None return ModelConfigData(forbid_extra=forbid_extra) - if lhs.name == 'alias_generator': + if name == 'alias_generator': has_alias_generator = True - if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname == 'builtins.None': + if isinstance(arg, NameExpr) and arg.fullname == 'builtins.None': has_alias_generator = False return ModelConfigData(has_alias_generator=has_alias_generator) - if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname in ('builtins.True', 'builtins.False'): - return ModelConfigData(**{lhs.name: substmt.rvalue.fullname == 'builtins.True'}) - error_invalid_config_value(lhs.name, self._ctx.api, substmt) + if isinstance(arg, NameExpr) and arg.fullname in ('builtins.True', 'builtins.False'): + return ModelConfigData(**{name: arg.fullname == 'builtins.True'}) + error_invalid_config_value(name, self._api, arg) return None @staticmethod - def get_is_required(cls: ClassDef, stmt: AssignmentStmt, lhs: NameExpr) -> bool: - """ - Returns a boolean indicating whether the field defined in `stmt` is a required field. - """ + def get_has_default(stmt: AssignmentStmt) -> bool: + """Returns a boolean indicating whether the field defined in `stmt` is a required field.""" expr = stmt.rvalue if isinstance(expr, TempNode): - # TempNode means annotation-only, so only non-required if Optional - value_type = get_proper_type(cls.info[lhs.name].type) - if isinstance(value_type, UnionType) and any(isinstance(item, NoneType) for item in value_type.items): - # Annotated as Optional, or otherwise having NoneType in the union - return False - return True + # TempNode means annotation-only, so has no default + return False if isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME: - # The "default value" is a call to `Field`; at this point, the field is - # only required if default is Ellipsis (i.e., `field_name: Annotation = Field(...)`) or if default_factory - # is specified. + # The "default value" is a call to `Field`; at this point, the field has a default if and only if: + # * there is a positional argument that is not `...` + # * there is a keyword argument named "default" that is not `...` + # * there is a "default_factory" that is not `None` for arg, name in zip(expr.args, expr.arg_names): - # If name is None, then this arg is the default because it is the only positonal argument. + # If name is None, then this arg is the default because it is the only positional argument. if name is None or name == 'default': - return arg.__class__ is EllipsisExpr + return arg.__class__ is not EllipsisExpr if name == 'default_factory': - return False - return True - # Only required if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`) - return isinstance(expr, EllipsisExpr) + return not (isinstance(arg, NameExpr) and arg.fullname == 'builtins.None') + return False + # Has no default if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`) + return not isinstance(expr, EllipsisExpr) @staticmethod - def get_alias_info(stmt: AssignmentStmt) -> Tuple[Optional[str], bool]: - """ - Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`. + def get_alias_info(stmt: AssignmentStmt) -> tuple[str | None, bool]: + """Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`. `has_dynamic_alias` is True if and only if an alias is provided, but not as a string literal. If `has_dynamic_alias` is True, `alias` will be None. @@ -573,29 +1033,38 @@ class PydanticModelTransformer: return None, False def get_field_arguments( - self, fields: List['PydanticModelField'], typed: bool, force_all_optional: bool, use_alias: bool - ) -> List[Argument]: - """ - Helper function used during the construction of the `__init__` and `construct` method signatures. + self, + fields: list[PydanticModelField], + typed: bool, + use_alias: bool, + requires_dynamic_aliases: bool, + is_settings: bool, + ) -> list[Argument]: + """Helper function used during the construction of the `__init__` and `model_construct` method signatures. Returns a list of mypy Argument instances for use in the generated signatures. """ - info = self._ctx.cls.info + info = self._cls.info arguments = [ - field.to_argument(info, typed=typed, force_optional=force_all_optional, use_alias=use_alias) + field.to_argument( + info, + typed=typed, + force_optional=requires_dynamic_aliases or is_settings, + use_alias=use_alias, + api=self._api, + ) for field in fields if not (use_alias and field.has_dynamic_alias) ] return arguments - def should_init_forbid_extra(self, fields: List['PydanticModelField'], config: 'ModelConfigData') -> bool: - """ - Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature + def should_init_forbid_extra(self, fields: list[PydanticModelField], config: ModelConfigData) -> bool: + """Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature. We disallow arbitrary kwargs if the extra config setting is "forbid", or if the plugin config says to, *unless* a required dynamic alias is present (since then we can't determine a valid signature). """ - if not config.allow_population_by_field_name: + if not config.populate_by_name: if self.is_dynamic_alias_present(fields, bool(config.has_alias_generator)): return False if config.forbid_extra: @@ -603,9 +1072,8 @@ class PydanticModelTransformer: return self.plugin_config.init_forbid_extra @staticmethod - def is_dynamic_alias_present(fields: List['PydanticModelField'], has_alias_generator: bool) -> bool: - """ - Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be + def is_dynamic_alias_present(fields: list[PydanticModelField], has_alias_generator: bool) -> bool: + """Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be determined during static analysis. """ for field in fields: @@ -618,95 +1086,74 @@ class PydanticModelTransformer: return False -class PydanticModelField: - def __init__( - self, name: str, is_required: bool, alias: Optional[str], has_dynamic_alias: bool, line: int, column: int - ): - self.name = name - self.is_required = is_required - self.alias = alias - self.has_dynamic_alias = has_dynamic_alias - self.line = line - self.column = column - - def to_var(self, info: TypeInfo, use_alias: bool) -> Var: - name = self.name - if use_alias and self.alias is not None: - name = self.alias - return Var(name, info[self.name].type) - - def to_argument(self, info: TypeInfo, typed: bool, force_optional: bool, use_alias: bool) -> Argument: - if typed and info[self.name].type is not None: - type_annotation = info[self.name].type - else: - type_annotation = AnyType(TypeOfAny.explicit) - return Argument( - variable=self.to_var(info, use_alias), - type_annotation=type_annotation, - initializer=None, - kind=ARG_NAMED_OPT if force_optional or not self.is_required else ARG_NAMED, - ) - - def serialize(self) -> JsonDict: - return self.__dict__ - - @classmethod - def deserialize(cls, info: TypeInfo, data: JsonDict) -> 'PydanticModelField': - return cls(**data) - - class ModelConfigData: + """Pydantic mypy plugin model config class.""" + def __init__( self, - forbid_extra: Optional[bool] = None, - allow_mutation: Optional[bool] = None, - frozen: Optional[bool] = None, - orm_mode: Optional[bool] = None, - allow_population_by_field_name: Optional[bool] = None, - has_alias_generator: Optional[bool] = None, + forbid_extra: bool | None = None, + frozen: bool | None = None, + from_attributes: bool | None = None, + populate_by_name: bool | None = None, + has_alias_generator: bool | None = None, ): self.forbid_extra = forbid_extra - self.allow_mutation = allow_mutation self.frozen = frozen - self.orm_mode = orm_mode - self.allow_population_by_field_name = allow_population_by_field_name + self.from_attributes = from_attributes + self.populate_by_name = populate_by_name self.has_alias_generator = has_alias_generator - def set_values_dict(self) -> Dict[str, Any]: + def get_values_dict(self) -> dict[str, Any]: + """Returns a dict of Pydantic model config names to their values. + + It includes the config if config value is not `None`. + """ return {k: v for k, v in self.__dict__.items() if v is not None} - def update(self, config: Optional['ModelConfigData']) -> None: + def update(self, config: ModelConfigData | None) -> None: + """Update Pydantic model config values.""" if config is None: return - for k, v in config.set_values_dict().items(): + for k, v in config.get_values_dict().items(): setattr(self, k, v) def setdefault(self, key: str, value: Any) -> None: + """Set default value for Pydantic model config if config value is `None`.""" if getattr(self, key) is None: setattr(self, key, value) -ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_orm call', 'Pydantic') +ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_attributes call', 'Pydantic') ERROR_CONFIG = ErrorCode('pydantic-config', 'Invalid config value', 'Pydantic') ERROR_ALIAS = ErrorCode('pydantic-alias', 'Dynamic alias disallowed', 'Pydantic') ERROR_UNEXPECTED = ErrorCode('pydantic-unexpected', 'Unexpected behavior', 'Pydantic') ERROR_UNTYPED = ErrorCode('pydantic-field', 'Untyped field disallowed', 'Pydantic') ERROR_FIELD_DEFAULTS = ErrorCode('pydantic-field', 'Invalid Field defaults', 'Pydantic') +ERROR_EXTRA_FIELD_ROOT_MODEL = ErrorCode('pydantic-field', 'Extra field on RootModel subclass', 'Pydantic') -def error_from_orm(model_name: str, api: CheckerPluginInterface, context: Context) -> None: - api.fail(f'"{model_name}" does not have orm_mode=True', context, code=ERROR_ORM) +def error_from_attributes(model_name: str, api: CheckerPluginInterface, context: Context) -> None: + """Emits an error when the model does not have `from_attributes=True`.""" + api.fail(f'"{model_name}" does not have from_attributes=True', context, code=ERROR_ORM) def error_invalid_config_value(name: str, api: SemanticAnalyzerPluginInterface, context: Context) -> None: + """Emits an error when the config value is invalid.""" api.fail(f'Invalid value for "Config.{name}"', context, code=ERROR_CONFIG) def error_required_dynamic_aliases(api: SemanticAnalyzerPluginInterface, context: Context) -> None: + """Emits required dynamic aliases error. + + This will be called when `warn_required_dynamic_aliases=True`. + """ api.fail('Required dynamic aliases disallowed', context, code=ERROR_ALIAS) -def error_unexpected_behavior(detail: str, api: CheckerPluginInterface, context: Context) -> None: # pragma: no cover +def error_unexpected_behavior( + detail: str, api: CheckerPluginInterface | SemanticAnalyzerPluginInterface, context: Context +) -> None: # pragma: no cover + """Emits unexpected behavior error.""" # Can't think of a good way to test this, but I confirmed it renders as desired by adding to a non-error path link = 'https://github.com/pydantic/pydantic/issues/new/choose' full_message = f'The pydantic mypy plugin ran into unexpected behavior: {detail}\n' @@ -715,55 +1162,70 @@ def error_unexpected_behavior(detail: str, api: CheckerPluginInterface, context: def error_untyped_fields(api: SemanticAnalyzerPluginInterface, context: Context) -> None: + """Emits an error when there is an untyped field in the model.""" api.fail('Untyped fields disallowed', context, code=ERROR_UNTYPED) +def error_extra_fields_on_root_model(api: CheckerPluginInterface, context: Context) -> None: + """Emits an error when there is more than just a root field defined for a subclass of RootModel.""" + api.fail('Only `root` is allowed as a field of a `RootModel`', context, code=ERROR_EXTRA_FIELD_ROOT_MODEL) + + def error_default_and_default_factory_specified(api: CheckerPluginInterface, context: Context) -> None: + """Emits an error when `Field` has both `default` and `default_factory` together.""" api.fail('Field default and default_factory cannot be specified together', context, code=ERROR_FIELD_DEFAULTS) def add_method( - ctx: ClassDefContext, + api: SemanticAnalyzerPluginInterface | CheckerPluginInterface, + cls: ClassDef, name: str, - args: List[Argument], + args: list[Argument], return_type: Type, - self_type: Optional[Type] = None, - tvar_def: Optional[TypeVarDef] = None, + self_type: Type | None = None, + tvar_def: TypeVarDef | None = None, is_classmethod: bool = False, - is_new: bool = False, - # is_staticmethod: bool = False, ) -> None: - """ - Adds a new method to a class. - - This can be dropped if/when https://github.com/python/mypy/issues/7301 is merged - """ - info = ctx.cls.info + """Very closely related to `mypy.plugins.common.add_method_to_class`, with a few pydantic-specific changes.""" + info = cls.info # First remove any previously generated methods with the same name # to avoid clashes and problems in the semantic analyzer. if name in info.names: sym = info.names[name] if sym.plugin_generated and isinstance(sym.node, FuncDef): - ctx.cls.defs.body.remove(sym.node) # pragma: no cover + cls.defs.body.remove(sym.node) # pragma: no cover - self_type = self_type or fill_typevars(info) - if is_classmethod or is_new: - first = [Argument(Var('_cls'), TypeType.make_normalized(self_type), None, ARG_POS)] - # elif is_staticmethod: - # first = [] + if isinstance(api, SemanticAnalyzerPluginInterface): + function_type = api.named_type('builtins.function') + else: + function_type = api.named_generic_type('builtins.function', []) + + if is_classmethod: + self_type = self_type or TypeType(fill_typevars(info)) + first = [Argument(Var('_cls'), self_type, None, ARG_POS, True)] else: self_type = self_type or fill_typevars(info) + # `self` is positional *ONLY* here, but this can't be expressed + # fully in the mypy internal API. ARG_POS is the closest we can get. + # Using ARG_POS will, however, give mypy errors if a `self` field + # is present on a model: + # + # Name "self" already defined (possibly by an import) [no-redef] + # + # As a workaround, we give this argument a name that will + # never conflict. By its positional nature, this name will not + # be used or exposed to users. first = [Argument(Var('__pydantic_self__'), self_type, None, ARG_POS)] args = first + args + arg_types, arg_names, arg_kinds = [], [], [] for arg in args: assert arg.type_annotation, 'All arguments must be fully typed.' arg_types.append(arg.type_annotation) - arg_names.append(get_name(arg.variable)) + arg_names.append(arg.variable.name) arg_kinds.append(arg.kind) - function_type = ctx.api.named_type(f'{BUILTINS_NAME}.function') signature = CallableType(arg_types, arg_kinds, arg_names, return_type, function_type) if tvar_def: signature.variables = [tvar_def] @@ -772,8 +1234,7 @@ def add_method( func.info = info func.type = set_callable_name(signature, func) func.is_class = is_classmethod - # func.is_static = is_staticmethod - func._fullname = get_fullname(info) + '.' + name + func._fullname = info.fullname + '.' + name func.line = info.line # NOTE: we would like the plugin generated node to dominate, but we still @@ -783,68 +1244,44 @@ def add_method( r_name = get_unique_redefinition_name(name, info.names) info.names[r_name] = info.names[name] - if is_classmethod: # or is_staticmethod: + # Add decorator for is_classmethod + # The dataclasses plugin claims this is unnecessary for classmethods, but not including it results in a + # signature incompatible with the superclass, which causes mypy errors to occur for every subclass of BaseModel. + if is_classmethod: func.is_decorated = True v = Var(name, func.type) v.info = info v._fullname = func._fullname - # if is_classmethod: v.is_classmethod = True dec = Decorator(func, [NameExpr('classmethod')], v) - # else: - # v.is_staticmethod = True - # dec = Decorator(func, [NameExpr('staticmethod')], v) - dec.line = info.line sym = SymbolTableNode(MDEF, dec) else: sym = SymbolTableNode(MDEF, func) sym.plugin_generated = True - info.names[name] = sym + info.defn.defs.body.append(func) -def get_fullname(x: Union[FuncBase, SymbolNode]) -> str: - """ - Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped. - """ - fn = x.fullname - if callable(fn): # pragma: no cover - return fn() - return fn +def parse_toml(config_file: str) -> dict[str, Any] | None: + """Returns a dict of config keys to values. - -def get_name(x: Union[FuncBase, SymbolNode]) -> str: + It reads configs from toml file and returns `None` if the file is not a toml file. """ - Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped. - """ - fn = x.name - if callable(fn): # pragma: no cover - return fn() - return fn - - -def parse_toml(config_file: str) -> Optional[Dict[str, Any]]: if not config_file.endswith('.toml'): return None - read_mode = 'rb' if sys.version_info >= (3, 11): import tomllib as toml_ else: try: import tomli as toml_ - except ImportError: - # older versions of mypy have toml as a dependency, not tomli - read_mode = 'r' - try: - import toml as toml_ # type: ignore[no-redef] - except ImportError: # pragma: no cover - import warnings + except ImportError: # pragma: no cover + import warnings - warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.') - return None + warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.') + return None - with open(config_file, read_mode) as rf: - return toml_.load(rf) # type: ignore[arg-type] + with open(config_file, 'rb') as rf: + return toml_.load(rf) diff --git a/lib/pydantic/networks.py b/lib/pydantic/networks.py index c7d97186..6d9d292f 100644 --- a/lib/pydantic/networks.py +++ b/lib/pydantic/networks.py @@ -1,80 +1,35 @@ -import re -from ipaddress import ( - IPv4Address, - IPv4Interface, - IPv4Network, - IPv6Address, - IPv6Interface, - IPv6Network, - _BaseAddress, - _BaseNetwork, -) -from typing import ( - TYPE_CHECKING, - Any, - Collection, - Dict, - Generator, - List, - Match, - Optional, - Pattern, - Set, - Tuple, - Type, - Union, - cast, - no_type_check, -) +"""The networks module contains types for common network-related fields.""" +from __future__ import annotations as _annotations -from . import errors -from .utils import Representation, update_not_none -from .validators import constr_length_validator, str_validator +import dataclasses as _dataclasses +import re +from importlib.metadata import version +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from typing import TYPE_CHECKING, Any + +from pydantic_core import MultiHostUrl, PydanticCustomError, Url, core_schema +from typing_extensions import Annotated, TypeAlias + +from ._internal import _fields, _repr, _schema_generation_shared +from ._migration import getattr_migration +from .annotated_handlers import GetCoreSchemaHandler +from .json_schema import JsonSchemaValue if TYPE_CHECKING: import email_validator - from typing_extensions import TypedDict - from .config import BaseConfig - from .fields import ModelField - from .typing import AnyCallable - - CallableGenerator = Generator[AnyCallable, None, None] - - class Parts(TypedDict, total=False): - scheme: str - user: Optional[str] - password: Optional[str] - ipv4: Optional[str] - ipv6: Optional[str] - domain: Optional[str] - port: Optional[str] - path: Optional[str] - query: Optional[str] - fragment: Optional[str] - - class HostParts(TypedDict, total=False): - host: str - tld: Optional[str] - host_type: Optional[str] - port: Optional[str] - rebuild: bool + NetworkType: TypeAlias = 'str | bytes | int | tuple[str | bytes | int, str | int]' else: email_validator = None - class Parts(dict): - pass - - -NetworkType = Union[str, bytes, int, Tuple[Union[str, bytes, int], Union[str, int]]] __all__ = [ 'AnyUrl', 'AnyHttpUrl', 'FileUrl', 'HttpUrl', - 'stricturl', + 'UrlConstraints', 'EmailStr', 'NameEmail', 'IPvAnyAddress', @@ -86,489 +41,321 @@ __all__ = [ 'RedisDsn', 'MongoDsn', 'KafkaDsn', + 'NatsDsn', 'validate_email', + 'MySQLDsn', + 'MariaDBDsn', ] -_url_regex_cache = None -_multi_host_url_regex_cache = None -_ascii_domain_regex_cache = None -_int_domain_regex_cache = None -_host_regex_cache = None -_host_regex = ( - r'(?:' - r'(?P(?:\d{1,3}\.){3}\d{1,3})(?=$|[/:#?])|' # ipv4 - r'(?P\[[A-F0-9]*:[A-F0-9:]+\])(?=$|[/:#?])|' # ipv6 - r'(?P[^\s/:?#]+)' # domain, validation occurs later - r')?' - r'(?::(?P\d+))?' # port +@_dataclasses.dataclass +class UrlConstraints(_fields.PydanticMetadata): + """Url constraints. + + Attributes: + max_length: The maximum length of the url. Defaults to `None`. + allowed_schemes: The allowed schemes. Defaults to `None`. + host_required: Whether the host is required. Defaults to `None`. + default_host: The default host. Defaults to `None`. + default_port: The default port. Defaults to `None`. + default_path: The default path. Defaults to `None`. + """ + + max_length: int | None = None + allowed_schemes: list[str] | None = None + host_required: bool | None = None + default_host: str | None = None + default_port: int | None = None + default_path: str | None = None + + def __hash__(self) -> int: + return hash( + ( + self.max_length, + tuple(self.allowed_schemes) if self.allowed_schemes is not None else None, + self.host_required, + self.default_host, + self.default_port, + self.default_path, + ) + ) + + +AnyUrl = Url +"""Base type for all URLs. + +* Any scheme allowed +* Top-level domain (TLD) not required +* Host required + +Assuming an input URL of `http://samuel:pass@example.com:8000/the/path/?query=here#fragment=is;this=bit`, +the types export the following properties: + +- `scheme`: the URL scheme (`http`), always set. +- `host`: the URL host (`example.com`), always set. +- `username`: optional username if included (`samuel`). +- `password`: optional password if included (`pass`). +- `port`: optional port (`8000`). +- `path`: optional path (`/the/path/`). +- `query`: optional URL query (for example, `GET` arguments or "search string", such as `query=here`). +- `fragment`: optional fragment (`fragment=is;this=bit`). +""" +AnyHttpUrl = Annotated[Url, UrlConstraints(allowed_schemes=['http', 'https'])] +"""A type that will accept any http or https URL. + +* TLD not required +* Host required +""" +HttpUrl = Annotated[Url, UrlConstraints(max_length=2083, allowed_schemes=['http', 'https'])] +"""A type that will accept any http or https URL. + +* TLD required +* Host required +* Max length 2083 + +```py +from pydantic import BaseModel, HttpUrl, ValidationError + +class MyModel(BaseModel): + url: HttpUrl + +m = MyModel(url='http://www.example.com') +print(m.url) +#> http://www.example.com/ + +try: + MyModel(url='ftp://invalid.url') +except ValidationError as e: + print(e) + ''' + 1 validation error for MyModel + url + URL scheme should be 'http' or 'https' [type=url_scheme, input_value='ftp://invalid.url', input_type=str] + ''' + +try: + MyModel(url='not a url') +except ValidationError as e: + print(e) + ''' + 1 validation error for MyModel + url + Input should be a valid URL, relative URL without a base [type=url_parsing, input_value='not a url', input_type=str] + ''' +``` + +"International domains" (e.g. a URL where the host or TLD includes non-ascii characters) will be encoded via +[punycode](https://en.wikipedia.org/wiki/Punycode) (see +[this article](https://www.xudongz.com/blog/2017/idn-phishing/) for a good description of why this is important): + +```py +from pydantic import BaseModel, HttpUrl + +class MyModel(BaseModel): + url: HttpUrl + +m1 = MyModel(url='http://puny£code.com') +print(m1.url) +#> http://xn--punycode-eja.com/ +m2 = MyModel(url='https://www.аррÓе.com/') +print(m2.url) +#> https://www.xn--80ak6aa92e.com/ +m3 = MyModel(url='https://www.example.ç å®/') +print(m3.url) +#> https://www.example.xn--pbt977c/ +``` + + +!!! warning "Underscores in Hostnames" + In Pydantic, underscores are allowed in all parts of a domain except the TLD. + Technically this might be wrong - in theory the hostname cannot have underscores, but subdomains can. + + To explain this; consider the following two cases: + + - `exam_ple.co.uk`: the hostname is `exam_ple`, which should not be allowed since it contains an underscore. + - `foo_bar.example.com` the hostname is `example`, which should be allowed since the underscore is in the subdomain. + + Without having an exhaustive list of TLDs, it would be impossible to differentiate between these two. Therefore + underscores are allowed, but you can always do further validation in a validator if desired. + + Also, Chrome, Firefox, and Safari all currently accept `http://exam_ple.com` as a URL, so we're in good + (or at least big) company. +""" +FileUrl = Annotated[Url, UrlConstraints(allowed_schemes=['file'])] +"""A type that will accept any file URL. + +* Host not required +""" +PostgresDsn = Annotated[ + MultiHostUrl, + UrlConstraints( + host_required=True, + allowed_schemes=[ + 'postgres', + 'postgresql', + 'postgresql+asyncpg', + 'postgresql+pg8000', + 'postgresql+psycopg', + 'postgresql+psycopg2', + 'postgresql+psycopg2cffi', + 'postgresql+py-postgresql', + 'postgresql+pygresql', + ], + ), +] +"""A type that will accept any Postgres DSN. + +* User info required +* TLD not required +* Host required +* Supports multiple hosts + +If further validation is required, these properties can be used by validators to enforce specific behaviour: + +```py +from pydantic import ( + BaseModel, + HttpUrl, + PostgresDsn, + ValidationError, + field_validator, ) -_scheme_regex = r'(?:(?P[a-z][a-z0-9+\-.]+)://)?' # scheme https://tools.ietf.org/html/rfc3986#appendix-A -_user_info_regex = r'(?:(?P[^\s:/]*)(?::(?P[^\s/]*))?@)?' -_path_regex = r'(?P/[^\s?#]*)?' -_query_regex = r'(?:\?(?P[^\s#]*))?' -_fragment_regex = r'(?:#(?P[^\s#]*))?' - -def url_regex() -> Pattern[str]: - global _url_regex_cache - if _url_regex_cache is None: - _url_regex_cache = re.compile( - rf'{_scheme_regex}{_user_info_regex}{_host_regex}{_path_regex}{_query_regex}{_fragment_regex}', - re.IGNORECASE, - ) - return _url_regex_cache - - -def multi_host_url_regex() -> Pattern[str]: - """ - Compiled multi host url regex. - - Additionally to `url_regex` it allows to match multiple hosts. - E.g. host1.db.net,host2.db.net - """ - global _multi_host_url_regex_cache - if _multi_host_url_regex_cache is None: - _multi_host_url_regex_cache = re.compile( - rf'{_scheme_regex}{_user_info_regex}' - r'(?P([^/]*))' # validation occurs later - rf'{_path_regex}{_query_regex}{_fragment_regex}', - re.IGNORECASE, - ) - return _multi_host_url_regex_cache - - -def ascii_domain_regex() -> Pattern[str]: - global _ascii_domain_regex_cache - if _ascii_domain_regex_cache is None: - ascii_chunk = r'[_0-9a-z](?:[-_0-9a-z]{0,61}[_0-9a-z])?' - ascii_domain_ending = r'(?P\.[a-z]{2,63})?\.?' - _ascii_domain_regex_cache = re.compile( - fr'(?:{ascii_chunk}\.)*?{ascii_chunk}{ascii_domain_ending}', re.IGNORECASE - ) - return _ascii_domain_regex_cache - - -def int_domain_regex() -> Pattern[str]: - global _int_domain_regex_cache - if _int_domain_regex_cache is None: - int_chunk = r'[_0-9a-\U00040000](?:[-_0-9a-\U00040000]{0,61}[_0-9a-\U00040000])?' - int_domain_ending = r'(?P(\.[^\W\d_]{2,63})|(\.(?:xn--)[_0-9a-z-]{2,63}))?\.?' - _int_domain_regex_cache = re.compile(fr'(?:{int_chunk}\.)*?{int_chunk}{int_domain_ending}', re.IGNORECASE) - return _int_domain_regex_cache - - -def host_regex() -> Pattern[str]: - global _host_regex_cache - if _host_regex_cache is None: - _host_regex_cache = re.compile( - _host_regex, - re.IGNORECASE, - ) - return _host_regex_cache - - -class AnyUrl(str): - strip_whitespace = True - min_length = 1 - max_length = 2**16 - allowed_schemes: Optional[Collection[str]] = None - tld_required: bool = False - user_required: bool = False - host_required: bool = True - hidden_parts: Set[str] = set() - - __slots__ = ('scheme', 'user', 'password', 'host', 'tld', 'host_type', 'port', 'path', 'query', 'fragment') - - @no_type_check - def __new__(cls, url: Optional[str], **kwargs) -> object: - return str.__new__(cls, cls.build(**kwargs) if url is None else url) - - def __init__( - self, - url: str, - *, - scheme: str, - user: Optional[str] = None, - password: Optional[str] = None, - host: Optional[str] = None, - tld: Optional[str] = None, - host_type: str = 'domain', - port: Optional[str] = None, - path: Optional[str] = None, - query: Optional[str] = None, - fragment: Optional[str] = None, - ) -> None: - str.__init__(url) - self.scheme = scheme - self.user = user - self.password = password - self.host = host - self.tld = tld - self.host_type = host_type - self.port = port - self.path = path - self.query = query - self.fragment = fragment - - @classmethod - def build( - cls, - *, - scheme: str, - user: Optional[str] = None, - password: Optional[str] = None, - host: str, - port: Optional[str] = None, - path: Optional[str] = None, - query: Optional[str] = None, - fragment: Optional[str] = None, - **_kwargs: str, - ) -> str: - parts = Parts( - scheme=scheme, - user=user, - password=password, - host=host, - port=port, - path=path, - query=query, - fragment=fragment, - **_kwargs, # type: ignore[misc] - ) - - url = scheme + '://' - if user: - url += user - if password: - url += ':' + password - if user or password: - url += '@' - url += host - if port and ('port' not in cls.hidden_parts or cls.get_default_parts(parts).get('port') != port): - url += ':' + port - if path: - url += path - if query: - url += '?' + query - if fragment: - url += '#' + fragment - return url - - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length, format='uri') - - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls.validate - - @classmethod - def validate(cls, value: Any, field: 'ModelField', config: 'BaseConfig') -> 'AnyUrl': - if value.__class__ == cls: - return value - value = str_validator(value) - if cls.strip_whitespace: - value = value.strip() - url: str = cast(str, constr_length_validator(value, field, config)) - - m = cls._match_url(url) - # the regex should always match, if it doesn't please report with details of the URL tried - assert m, 'URL regex failed unexpectedly' - - original_parts = cast('Parts', m.groupdict()) - parts = cls.apply_default_parts(original_parts) - parts = cls.validate_parts(parts) - - if m.end() != len(url): - raise errors.UrlExtraError(extra=url[m.end() :]) - - return cls._build_url(m, url, parts) - - @classmethod - def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'AnyUrl': - """ - Validate hosts and build the AnyUrl object. Split from `validate` so this method - can be altered in `MultiHostDsn`. - """ - host, tld, host_type, rebuild = cls.validate_host(parts) - - return cls( - None if rebuild else url, - scheme=parts['scheme'], - user=parts['user'], - password=parts['password'], - host=host, - tld=tld, - host_type=host_type, - port=parts['port'], - path=parts['path'], - query=parts['query'], - fragment=parts['fragment'], - ) - - @staticmethod - def _match_url(url: str) -> Optional[Match[str]]: - return url_regex().match(url) - - @staticmethod - def _validate_port(port: Optional[str]) -> None: - if port is not None and int(port) > 65_535: - raise errors.UrlPortError() - - @classmethod - def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts': - """ - A method used to validate parts of a URL. - Could be overridden to set default values for parts if missing - """ - scheme = parts['scheme'] - if scheme is None: - raise errors.UrlSchemeError() - - if cls.allowed_schemes and scheme.lower() not in cls.allowed_schemes: - raise errors.UrlSchemePermittedError(set(cls.allowed_schemes)) - - if validate_port: - cls._validate_port(parts['port']) - - user = parts['user'] - if cls.user_required and user is None: - raise errors.UrlUserInfoError() - - return parts - - @classmethod - def validate_host(cls, parts: 'Parts') -> Tuple[str, Optional[str], str, bool]: - tld, host_type, rebuild = None, None, False - for f in ('domain', 'ipv4', 'ipv6'): - host = parts[f] # type: ignore[literal-required] - if host: - host_type = f - break - - if host is None: - if cls.host_required: - raise errors.UrlHostError() - elif host_type == 'domain': - is_international = False - d = ascii_domain_regex().fullmatch(host) - if d is None: - d = int_domain_regex().fullmatch(host) - if d is None: - raise errors.UrlHostError() - is_international = True - - tld = d.group('tld') - if tld is None and not is_international: - d = int_domain_regex().fullmatch(host) - assert d is not None - tld = d.group('tld') - is_international = True - - if tld is not None: - tld = tld[1:] - elif cls.tld_required: - raise errors.UrlHostTldError() - - if is_international: - host_type = 'int_domain' - rebuild = True - host = host.encode('idna').decode('ascii') - if tld is not None: - tld = tld.encode('idna').decode('ascii') - - return host, tld, host_type, rebuild # type: ignore - - @staticmethod - def get_default_parts(parts: 'Parts') -> 'Parts': - return {} - - @classmethod - def apply_default_parts(cls, parts: 'Parts') -> 'Parts': - for key, value in cls.get_default_parts(parts).items(): - if not parts[key]: # type: ignore[literal-required] - parts[key] = value # type: ignore[literal-required] - return parts - - def __repr__(self) -> str: - extra = ', '.join(f'{n}={getattr(self, n)!r}' for n in self.__slots__ if getattr(self, n) is not None) - return f'{self.__class__.__name__}({super().__repr__()}, {extra})' - - -class AnyHttpUrl(AnyUrl): - allowed_schemes = {'http', 'https'} - - __slots__ = () - - -class HttpUrl(AnyHttpUrl): - tld_required = True - # https://stackoverflow.com/questions/417142/what-is-the-maximum-length-of-a-url-in-different-browsers - max_length = 2083 - hidden_parts = {'port'} - - @staticmethod - def get_default_parts(parts: 'Parts') -> 'Parts': - return {'port': '80' if parts['scheme'] == 'http' else '443'} - - -class FileUrl(AnyUrl): - allowed_schemes = {'file'} - host_required = False - - __slots__ = () - - -class MultiHostDsn(AnyUrl): - __slots__ = AnyUrl.__slots__ + ('hosts',) - - def __init__(self, *args: Any, hosts: Optional[List['HostParts']] = None, **kwargs: Any): - super().__init__(*args, **kwargs) - self.hosts = hosts - - @staticmethod - def _match_url(url: str) -> Optional[Match[str]]: - return multi_host_url_regex().match(url) - - @classmethod - def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts': - return super().validate_parts(parts, validate_port=False) - - @classmethod - def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'MultiHostDsn': - hosts_parts: List['HostParts'] = [] - host_re = host_regex() - for host in m.groupdict()['hosts'].split(','): - d: Parts = host_re.match(host).groupdict() # type: ignore - host, tld, host_type, rebuild = cls.validate_host(d) - port = d.get('port') - cls._validate_port(port) - hosts_parts.append( - { - 'host': host, - 'host_type': host_type, - 'tld': tld, - 'rebuild': rebuild, - 'port': port, - } - ) - - if len(hosts_parts) > 1: - return cls( - None if any([hp['rebuild'] for hp in hosts_parts]) else url, - scheme=parts['scheme'], - user=parts['user'], - password=parts['password'], - path=parts['path'], - query=parts['query'], - fragment=parts['fragment'], - host_type=None, - hosts=hosts_parts, - ) - else: - # backwards compatibility with single host - host_part = hosts_parts[0] - return cls( - None if host_part['rebuild'] else url, - scheme=parts['scheme'], - user=parts['user'], - password=parts['password'], - host=host_part['host'], - tld=host_part['tld'], - host_type=host_part['host_type'], - port=host_part.get('port'), - path=parts['path'], - query=parts['query'], - fragment=parts['fragment'], - ) - - -class PostgresDsn(MultiHostDsn): - allowed_schemes = { - 'postgres', - 'postgresql', - 'postgresql+asyncpg', - 'postgresql+pg8000', - 'postgresql+psycopg2', - 'postgresql+psycopg2cffi', - 'postgresql+py-postgresql', - 'postgresql+pygresql', - } - user_required = True - - __slots__ = () - - -class CockroachDsn(AnyUrl): - allowed_schemes = { - 'cockroachdb', - 'cockroachdb+psycopg2', - 'cockroachdb+asyncpg', - } - user_required = True - - -class AmqpDsn(AnyUrl): - allowed_schemes = {'amqp', 'amqps'} - host_required = False - - -class RedisDsn(AnyUrl): - __slots__ = () - allowed_schemes = {'redis', 'rediss'} - host_required = False - - @staticmethod - def get_default_parts(parts: 'Parts') -> 'Parts': - return { - 'domain': 'localhost' if not (parts['ipv4'] or parts['ipv6']) else '', - 'port': '6379', - 'path': '/0', - } - - -class MongoDsn(AnyUrl): - allowed_schemes = {'mongodb'} - - # TODO: Needed to generic "Parts" for "Replica Set", "Sharded Cluster", and other mongodb deployment modes - @staticmethod - def get_default_parts(parts: 'Parts') -> 'Parts': - return { - 'port': '27017', - } - - -class KafkaDsn(AnyUrl): - allowed_schemes = {'kafka'} - - @staticmethod - def get_default_parts(parts: 'Parts') -> 'Parts': - return { - 'domain': 'localhost', - 'port': '9092', - } - - -def stricturl( - *, - strip_whitespace: bool = True, - min_length: int = 1, - max_length: int = 2**16, - tld_required: bool = True, - host_required: bool = True, - allowed_schemes: Optional[Collection[str]] = None, -) -> Type[AnyUrl]: - # use kwargs then define conf in a dict to aid with IDE type hinting - namespace = dict( - strip_whitespace=strip_whitespace, - min_length=min_length, - max_length=max_length, - tld_required=tld_required, - host_required=host_required, - allowed_schemes=allowed_schemes, - ) - return type('UrlValue', (AnyUrl,), namespace) +class MyModel(BaseModel): + url: HttpUrl + +m = MyModel(url='http://www.example.com') + +# the repr() method for a url will display all properties of the url +print(repr(m.url)) +#> Url('http://www.example.com/') +print(m.url.scheme) +#> http +print(m.url.host) +#> www.example.com +print(m.url.port) +#> 80 + +class MyDatabaseModel(BaseModel): + db: PostgresDsn + + @field_validator('db') + def check_db_name(cls, v): + assert v.path and len(v.path) > 1, 'database must be provided' + return v + +m = MyDatabaseModel(db='postgres://user:pass@localhost:5432/foobar') +print(m.db) +#> postgres://user:pass@localhost:5432/foobar + +try: + MyDatabaseModel(db='postgres://user:pass@localhost:5432') +except ValidationError as e: + print(e) + ''' + 1 validation error for MyDatabaseModel + db + Assertion failed, database must be provided + assert (None) + + where None = MultiHostUrl('postgres://user:pass@localhost:5432').path [type=assertion_error, input_value='postgres://user:pass@localhost:5432', input_type=str] + ''' +``` +""" + +CockroachDsn = Annotated[ + Url, + UrlConstraints( + host_required=True, + allowed_schemes=[ + 'cockroachdb', + 'cockroachdb+psycopg2', + 'cockroachdb+asyncpg', + ], + ), +] +"""A type that will accept any Cockroach DSN. + +* User info required +* TLD not required +* Host required +""" +AmqpDsn = Annotated[Url, UrlConstraints(allowed_schemes=['amqp', 'amqps'])] +"""A type that will accept any AMQP DSN. + +* User info required +* TLD not required +* Host required +""" +RedisDsn = Annotated[ + Url, + UrlConstraints(allowed_schemes=['redis', 'rediss'], default_host='localhost', default_port=6379, default_path='/0'), +] +"""A type that will accept any Redis DSN. + +* User info required +* TLD not required +* Host required (e.g., `rediss://:pass@localhost`) +""" +MongoDsn = Annotated[MultiHostUrl, UrlConstraints(allowed_schemes=['mongodb', 'mongodb+srv'], default_port=27017)] +"""A type that will accept any MongoDB DSN. + +* User info not required +* Database name not required +* Port not required +* User info may be passed without user part (e.g., `mongodb://mongodb0.example.com:27017`). +""" +KafkaDsn = Annotated[Url, UrlConstraints(allowed_schemes=['kafka'], default_host='localhost', default_port=9092)] +"""A type that will accept any Kafka DSN. + +* User info required +* TLD not required +* Host required +""" +NatsDsn = Annotated[ + MultiHostUrl, UrlConstraints(allowed_schemes=['nats', 'tls', 'ws'], default_host='localhost', default_port=4222) +] +"""A type that will accept any NATS DSN. + +NATS is a connective technology built for the ever increasingly hyper-connected world. +It is a single technology that enables applications to securely communicate across +any combination of cloud vendors, on-premise, edge, web and mobile, and devices. +More: https://nats.io +""" +MySQLDsn = Annotated[ + Url, + UrlConstraints( + allowed_schemes=[ + 'mysql', + 'mysql+mysqlconnector', + 'mysql+aiomysql', + 'mysql+asyncmy', + 'mysql+mysqldb', + 'mysql+pymysql', + 'mysql+cymysql', + 'mysql+pyodbc', + ], + default_port=3306, + ), +] +"""A type that will accept any MySQL DSN. + +* User info required +* TLD not required +* Host required +""" +MariaDBDsn = Annotated[ + Url, + UrlConstraints( + allowed_schemes=['mariadb', 'mariadb+mariadbconnector', 'mariadb+pymysql'], + default_port=3306, + ), +] +"""A type that will accept any MariaDB DSN. + +* User info required +* TLD not required +* Host required +""" def import_email_validator() -> None: @@ -577,27 +364,95 @@ def import_email_validator() -> None: import email_validator except ImportError as e: raise ImportError('email-validator is not installed, run `pip install pydantic[email]`') from e + if not version('email-validator').partition('.')[0] == '2': + raise ImportError('email-validator version >= 2.0 required, run pip install -U email-validator') -class EmailStr(str): - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - field_schema.update(type='string', format='email') +if TYPE_CHECKING: + EmailStr = Annotated[str, ...] +else: - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - # included here and below so the error happens straight away - import_email_validator() + class EmailStr: + """ + Info: + To use this type, you need to install the optional + [`email-validator`](https://github.com/JoshData/python-email-validator) package: - yield str_validator - yield cls.validate + ```bash + pip install email-validator + ``` - @classmethod - def validate(cls, value: Union[str]) -> str: - return validate_email(value)[1] + Validate email addresses. + + ```py + from pydantic import BaseModel, EmailStr + + class Model(BaseModel): + email: EmailStr + + print(Model(email='contact@mail.com')) + #> email='contact@mail.com' + ``` + """ # noqa: D212 + + @classmethod + def __get_pydantic_core_schema__( + cls, + _source: type[Any], + _handler: GetCoreSchemaHandler, + ) -> core_schema.CoreSchema: + import_email_validator() + return core_schema.no_info_after_validator_function(cls._validate, core_schema.str_schema()) + + @classmethod + def __get_pydantic_json_schema__( + cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = handler(core_schema) + field_schema.update(type='string', format='email') + return field_schema + + @classmethod + def _validate(cls, __input_value: str) -> str: + return validate_email(__input_value)[1] -class NameEmail(Representation): +class NameEmail(_repr.Representation): + """ + Info: + To use this type, you need to install the optional + [`email-validator`](https://github.com/JoshData/python-email-validator) package: + + ```bash + pip install email-validator + ``` + + Validate a name and email address combination, as specified by + [RFC 5322](https://datatracker.ietf.org/doc/html/rfc5322#section-3.4). + + The `NameEmail` has two properties: `name` and `email`. + In case the `name` is not provided, it's inferred from the email address. + + ```py + from pydantic import BaseModel, NameEmail + + class User(BaseModel): + email: NameEmail + + user = User(email='Fred Bloggs ') + print(user.email) + #> Fred Bloggs + print(user.email.name) + #> Fred Bloggs + + user = User(email='fred.bloggs@example.com') + print(user.email) + #> fred.bloggs + print(user.email.name) + #> fred.bloggs + ``` + """ # noqa: D212 + __slots__ = 'name', 'email' def __init__(self, name: str, email: str): @@ -608,39 +463,76 @@ class NameEmail(Representation): return isinstance(other, NameEmail) and (self.name, self.email) == (other.name, other.email) @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + def __get_pydantic_json_schema__( + cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = handler(core_schema) field_schema.update(type='string', format='name-email') + return field_schema @classmethod - def __get_validators__(cls) -> 'CallableGenerator': + def __get_pydantic_core_schema__( + cls, + _source: type[Any], + _handler: GetCoreSchemaHandler, + ) -> core_schema.CoreSchema: import_email_validator() - - yield cls.validate + return core_schema.no_info_after_validator_function( + cls._validate, + core_schema.union_schema( + [core_schema.is_instance_schema(cls), core_schema.str_schema()], + custom_error_type='name_email_type', + custom_error_message='Input is not a valid NameEmail', + ), + serialization=core_schema.to_string_ser_schema(), + ) @classmethod - def validate(cls, value: Any) -> 'NameEmail': - if value.__class__ == cls: - return value - value = str_validator(value) - return cls(*validate_email(value)) + def _validate(cls, __input_value: NameEmail | str) -> NameEmail: + if isinstance(__input_value, cls): + return __input_value + else: + name, email = validate_email(__input_value) # type: ignore[arg-type] + return cls(name, email) def __str__(self) -> str: return f'{self.name} <{self.email}>' -class IPvAnyAddress(_BaseAddress): +class IPvAnyAddress: + """Validate an IPv4 or IPv6 address. + + ```py + from pydantic import BaseModel + from pydantic.networks import IPvAnyAddress + + class IpModel(BaseModel): + ip: IPvAnyAddress + + print(IpModel(ip='127.0.0.1')) + #> ip=IPv4Address('127.0.0.1') + + try: + IpModel(ip='http://www.example.com') + except ValueError as e: + print(e.errors()) + ''' + [ + { + 'type': 'ip_any_address', + 'loc': ('ip',), + 'msg': 'value is not a valid IPv4 or IPv6 address', + 'input': 'http://www.example.com', + } + ] + ''' + ``` + """ + __slots__ = () - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - field_schema.update(type='string', format='ipvanyaddress') - - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls.validate - - @classmethod - def validate(cls, value: Union[str, bytes, int]) -> Union[IPv4Address, IPv6Address]: + def __new__(cls, value: Any) -> IPv4Address | IPv6Address: + """Validate an IPv4 or IPv6 address.""" try: return IPv4Address(value) except ValueError: @@ -649,22 +541,38 @@ class IPvAnyAddress(_BaseAddress): try: return IPv6Address(value) except ValueError: - raise errors.IPvAnyAddressError() + raise PydanticCustomError('ip_any_address', 'value is not a valid IPv4 or IPv6 address') + + @classmethod + def __get_pydantic_json_schema__( + cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = {} + field_schema.update(type='string', format='ipvanyaddress') + return field_schema + + @classmethod + def __get_pydantic_core_schema__( + cls, + _source: type[Any], + _handler: GetCoreSchemaHandler, + ) -> core_schema.CoreSchema: + return core_schema.no_info_plain_validator_function( + cls._validate, serialization=core_schema.to_string_ser_schema() + ) + + @classmethod + def _validate(cls, __input_value: Any) -> IPv4Address | IPv6Address: + return cls(__input_value) # type: ignore[return-value] -class IPvAnyInterface(_BaseAddress): +class IPvAnyInterface: + """Validate an IPv4 or IPv6 interface.""" + __slots__ = () - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - field_schema.update(type='string', format='ipvanyinterface') - - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls.validate - - @classmethod - def validate(cls, value: NetworkType) -> Union[IPv4Interface, IPv6Interface]: + def __new__(cls, value: NetworkType) -> IPv4Interface | IPv6Interface: + """Validate an IPv4 or IPv6 interface.""" try: return IPv4Interface(value) except ValueError: @@ -673,21 +581,39 @@ class IPvAnyInterface(_BaseAddress): try: return IPv6Interface(value) except ValueError: - raise errors.IPvAnyInterfaceError() - - -class IPvAnyNetwork(_BaseNetwork): # type: ignore - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - field_schema.update(type='string', format='ipvanynetwork') + raise PydanticCustomError('ip_any_interface', 'value is not a valid IPv4 or IPv6 interface') @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls.validate + def __get_pydantic_json_schema__( + cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = {} + field_schema.update(type='string', format='ipvanyinterface') + return field_schema @classmethod - def validate(cls, value: NetworkType) -> Union[IPv4Network, IPv6Network]: - # Assume IP Network is defined with a default value for ``strict`` argument. + def __get_pydantic_core_schema__( + cls, + _source: type[Any], + _handler: GetCoreSchemaHandler, + ) -> core_schema.CoreSchema: + return core_schema.no_info_plain_validator_function( + cls._validate, serialization=core_schema.to_string_ser_schema() + ) + + @classmethod + def _validate(cls, __input_value: NetworkType) -> IPv4Interface | IPv6Interface: + return cls(__input_value) # type: ignore[return-value] + + +class IPvAnyNetwork: + """Validate an IPv4 or IPv6 network.""" + + __slots__ = () + + def __new__(cls, value: NetworkType) -> IPv4Network | IPv6Network: + """Validate an IPv4 or IPv6 network.""" + # Assume IP Network is defined with a default value for `strict` argument. # Define your own class if you want to specify network address check strictness. try: return IPv4Network(value) @@ -697,40 +623,86 @@ class IPvAnyNetwork(_BaseNetwork): # type: ignore try: return IPv6Network(value) except ValueError: - raise errors.IPvAnyNetworkError() + raise PydanticCustomError('ip_any_network', 'value is not a valid IPv4 or IPv6 network') + + @classmethod + def __get_pydantic_json_schema__( + cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = {} + field_schema.update(type='string', format='ipvanynetwork') + return field_schema + + @classmethod + def __get_pydantic_core_schema__( + cls, + _source: type[Any], + _handler: GetCoreSchemaHandler, + ) -> core_schema.CoreSchema: + return core_schema.no_info_plain_validator_function( + cls._validate, serialization=core_schema.to_string_ser_schema() + ) + + @classmethod + def _validate(cls, __input_value: NetworkType) -> IPv4Network | IPv6Network: + return cls(__input_value) # type: ignore[return-value] -pretty_email_regex = re.compile(r'([\w ]*?) *<(.*)> *') +def _build_pretty_email_regex() -> re.Pattern[str]: + name_chars = r'[\w!#$%&\'*+\-/=?^_`{|}~]' + unquoted_name_group = rf'((?:{name_chars}+\s+)*{name_chars}+)' + quoted_name_group = r'"((?:[^"]|\")+)"' + email_group = r'<\s*(.+)\s*>' + return re.compile(rf'\s*(?:{unquoted_name_group}|{quoted_name_group})?\s*{email_group}\s*') -def validate_email(value: Union[str]) -> Tuple[str, str]: - """ - Brutally simple email address validation. Note unlike most email address validation - * raw ip address (literal) domain parts are not allowed. - * "John Doe " style "pretty" email addresses are processed - * the local part check is extremely basic. This raises the possibility of unicode spoofing, but no better - solution is really possible. - * spaces are striped from the beginning and end of addresses but no error is raised +pretty_email_regex = _build_pretty_email_regex() - See RFC 5322 but treat it with suspicion, there seems to exist no universally acknowledged test for a valid email! +MAX_EMAIL_LENGTH = 2048 +"""Maximum length for an email. +A somewhat arbitrary but very generous number compared to what is allowed by most implementations. +""" + + +def validate_email(value: str) -> tuple[str, str]: + """Email address validation using [email-validator](https://pypi.org/project/email-validator/). + + Note: + Note that: + + * Raw IP address (literal) domain parts are not allowed. + * `"John Doe "` style "pretty" email addresses are processed. + * Spaces are striped from the beginning and end of addresses, but no error is raised. """ if email_validator is None: import_email_validator() + if len(value) > MAX_EMAIL_LENGTH: + raise PydanticCustomError( + 'value_error', + 'value is not a valid email address: {reason}', + {'reason': f'Length must not exceed {MAX_EMAIL_LENGTH} characters'}, + ) + m = pretty_email_regex.fullmatch(value) - name: Optional[str] = None + name: str | None = None if m: - name, value = m.groups() + unquoted_name, quoted_name, value = m.groups() + name = unquoted_name or quoted_name email = value.strip() try: - email_validator.validate_email(email, check_deliverability=False) + parts = email_validator.validate_email(email, check_deliverability=False) except email_validator.EmailNotValidError as e: - raise errors.EmailError() from e + raise PydanticCustomError( + 'value_error', 'value is not a valid email address: {reason}', {'reason': str(e.args[0])} + ) from e - at_index = email.index('@') - local_part = email[:at_index] # RFC 5321, local part must be case-sensitive. - global_part = email[at_index:].lower() + email = parts.normalized + assert email is not None + name = name or parts.local_part + return name, email - return name or local_part, local_part + global_part + +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/parse.py b/lib/pydantic/parse.py index 7ac330ca..ceee6342 100644 --- a/lib/pydantic/parse.py +++ b/lib/pydantic/parse.py @@ -1,66 +1,4 @@ -import json -import pickle -from enum import Enum -from pathlib import Path -from typing import Any, Callable, Union +"""The `parse` module is a backport module from V1.""" +from ._migration import getattr_migration -from .types import StrBytes - - -class Protocol(str, Enum): - json = 'json' - pickle = 'pickle' - - -def load_str_bytes( - b: StrBytes, - *, - content_type: str = None, - encoding: str = 'utf8', - proto: Protocol = None, - allow_pickle: bool = False, - json_loads: Callable[[str], Any] = json.loads, -) -> Any: - if proto is None and content_type: - if content_type.endswith(('json', 'javascript')): - pass - elif allow_pickle and content_type.endswith('pickle'): - proto = Protocol.pickle - else: - raise TypeError(f'Unknown content-type: {content_type}') - - proto = proto or Protocol.json - - if proto == Protocol.json: - if isinstance(b, bytes): - b = b.decode(encoding) - return json_loads(b) - elif proto == Protocol.pickle: - if not allow_pickle: - raise RuntimeError('Trying to decode with pickle with allow_pickle=False') - bb = b if isinstance(b, bytes) else b.encode() - return pickle.loads(bb) - else: - raise TypeError(f'Unknown protocol: {proto}') - - -def load_file( - path: Union[str, Path], - *, - content_type: str = None, - encoding: str = 'utf8', - proto: Protocol = None, - allow_pickle: bool = False, - json_loads: Callable[[str], Any] = json.loads, -) -> Any: - path = Path(path) - b = path.read_bytes() - if content_type is None: - if path.suffix in ('.js', '.json'): - proto = Protocol.json - elif path.suffix == '.pkl': - proto = Protocol.pickle - - return load_str_bytes( - b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads - ) +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/plugin/__init__.py b/lib/pydantic/plugin/__init__.py new file mode 100644 index 00000000..84197006 --- /dev/null +++ b/lib/pydantic/plugin/__init__.py @@ -0,0 +1,170 @@ +"""Usage docs: https://docs.pydantic.dev/2.6/concepts/plugins#build-a-plugin + +Plugin interface for Pydantic plugins, and related types. +""" +from __future__ import annotations + +from typing import Any, Callable, NamedTuple + +from pydantic_core import CoreConfig, CoreSchema, ValidationError +from typing_extensions import Literal, Protocol, TypeAlias + +__all__ = ( + 'PydanticPluginProtocol', + 'BaseValidateHandlerProtocol', + 'ValidatePythonHandlerProtocol', + 'ValidateJsonHandlerProtocol', + 'ValidateStringsHandlerProtocol', + 'NewSchemaReturns', + 'SchemaTypePath', + 'SchemaKind', +) + +NewSchemaReturns: TypeAlias = 'tuple[ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None]' + + +class SchemaTypePath(NamedTuple): + """Path defining where `schema_type` was defined, or where `TypeAdapter` was called.""" + + module: str + name: str + + +SchemaKind: TypeAlias = Literal['BaseModel', 'TypeAdapter', 'dataclass', 'create_model', 'validate_call'] + + +class PydanticPluginProtocol(Protocol): + """Protocol defining the interface for Pydantic plugins.""" + + def new_schema_validator( + self, + schema: CoreSchema, + schema_type: Any, + schema_type_path: SchemaTypePath, + schema_kind: SchemaKind, + config: CoreConfig | None, + plugin_settings: dict[str, object], + ) -> tuple[ + ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None + ]: + """This method is called for each plugin every time a new [`SchemaValidator`][pydantic_core.SchemaValidator] + is created. + + It should return an event handler for each of the three validation methods, or `None` if the plugin does not + implement that method. + + Args: + schema: The schema to validate against. + schema_type: The original type which the schema was created from, e.g. the model class. + schema_type_path: Path defining where `schema_type` was defined, or where `TypeAdapter` was called. + schema_kind: The kind of schema to validate against. + config: The config to use for validation. + plugin_settings: Any plugin settings. + + Returns: + A tuple of optional event handlers for each of the three validation methods - + `validate_python`, `validate_json`, `validate_strings`. + """ + raise NotImplementedError('Pydantic plugins should implement `new_schema_validator`.') + + +class BaseValidateHandlerProtocol(Protocol): + """Base class for plugin callbacks protocols. + + You shouldn't implement this protocol directly, instead use one of the subclasses with adds the correctly + typed `on_error` method. + """ + + on_enter: Callable[..., None] + """`on_enter` is changed to be more specific on all subclasses""" + + def on_success(self, result: Any) -> None: + """Callback to be notified of successful validation. + + Args: + result: The result of the validation. + """ + return + + def on_error(self, error: ValidationError) -> None: + """Callback to be notified of validation errors. + + Args: + error: The validation error. + """ + return + + def on_exception(self, exception: Exception) -> None: + """Callback to be notified of validation exceptions. + + Args: + exception: The exception raised during validation. + """ + return + + +class ValidatePythonHandlerProtocol(BaseValidateHandlerProtocol, Protocol): + """Event handler for `SchemaValidator.validate_python`.""" + + def on_enter( + self, + input: Any, + *, + strict: bool | None = None, + from_attributes: bool | None = None, + context: dict[str, Any] | None = None, + self_instance: Any | None = None, + ) -> None: + """Callback to be notified of validation start, and create an instance of the event handler. + + Args: + input: The input to be validated. + strict: Whether to validate the object in strict mode. + from_attributes: Whether to validate objects as inputs by extracting attributes. + context: The context to use for validation, this is passed to functional validators. + self_instance: An instance of a model to set attributes on from validation, this is used when running + validation from the `__init__` method of a model. + """ + pass + + +class ValidateJsonHandlerProtocol(BaseValidateHandlerProtocol, Protocol): + """Event handler for `SchemaValidator.validate_json`.""" + + def on_enter( + self, + input: str | bytes | bytearray, + *, + strict: bool | None = None, + context: dict[str, Any] | None = None, + self_instance: Any | None = None, + ) -> None: + """Callback to be notified of validation start, and create an instance of the event handler. + + Args: + input: The JSON data to be validated. + strict: Whether to validate the object in strict mode. + context: The context to use for validation, this is passed to functional validators. + self_instance: An instance of a model to set attributes on from validation, this is used when running + validation from the `__init__` method of a model. + """ + pass + + +StringInput: TypeAlias = 'dict[str, StringInput]' + + +class ValidateStringsHandlerProtocol(BaseValidateHandlerProtocol, Protocol): + """Event handler for `SchemaValidator.validate_strings`.""" + + def on_enter( + self, input: StringInput, *, strict: bool | None = None, context: dict[str, Any] | None = None + ) -> None: + """Callback to be notified of validation start, and create an instance of the event handler. + + Args: + input: The string data to be validated. + strict: Whether to validate the object in strict mode. + context: The context to use for validation, this is passed to functional validators. + """ + pass diff --git a/lib/pydantic/plugin/_loader.py b/lib/pydantic/plugin/_loader.py new file mode 100644 index 00000000..9e0e33ca --- /dev/null +++ b/lib/pydantic/plugin/_loader.py @@ -0,0 +1,50 @@ +from __future__ import annotations + +import importlib.metadata as importlib_metadata +import warnings +from typing import TYPE_CHECKING, Final, Iterable + +if TYPE_CHECKING: + from . import PydanticPluginProtocol + + +PYDANTIC_ENTRY_POINT_GROUP: Final[str] = 'pydantic' + +# cache of plugins +_plugins: dict[str, PydanticPluginProtocol] | None = None +# return no plugins while loading plugins to avoid recursion and errors while import plugins +# this means that if plugins use pydantic +_loading_plugins: bool = False + + +def get_plugins() -> Iterable[PydanticPluginProtocol]: + """Load plugins for Pydantic. + + Inspired by: https://github.com/pytest-dev/pluggy/blob/1.3.0/src/pluggy/_manager.py#L376-L402 + """ + global _plugins, _loading_plugins + if _loading_plugins: + # this happens when plugins themselves use pydantic, we return no plugins + return () + elif _plugins is None: + _plugins = {} + # set _loading_plugins so any plugins that use pydantic don't themselves use plugins + _loading_plugins = True + try: + for dist in importlib_metadata.distributions(): + for entry_point in dist.entry_points: + if entry_point.group != PYDANTIC_ENTRY_POINT_GROUP: + continue + if entry_point.value in _plugins: + continue + try: + _plugins[entry_point.value] = entry_point.load() + except (ImportError, AttributeError) as e: + warnings.warn( + f'{e.__class__.__name__} while loading the `{entry_point.name}` Pydantic plugin, ' + f'this plugin will not be installed.\n\n{e!r}' + ) + finally: + _loading_plugins = False + + return _plugins.values() diff --git a/lib/pydantic/plugin/_schema_validator.py b/lib/pydantic/plugin/_schema_validator.py new file mode 100644 index 00000000..7186ece6 --- /dev/null +++ b/lib/pydantic/plugin/_schema_validator.py @@ -0,0 +1,138 @@ +"""Pluggable schema validator for pydantic.""" +from __future__ import annotations + +import functools +from typing import TYPE_CHECKING, Any, Callable, Iterable, TypeVar + +from pydantic_core import CoreConfig, CoreSchema, SchemaValidator, ValidationError +from typing_extensions import Literal, ParamSpec + +if TYPE_CHECKING: + from . import BaseValidateHandlerProtocol, PydanticPluginProtocol, SchemaKind, SchemaTypePath + + +P = ParamSpec('P') +R = TypeVar('R') +Event = Literal['on_validate_python', 'on_validate_json', 'on_validate_strings'] +events: list[Event] = list(Event.__args__) # type: ignore + + +def create_schema_validator( + schema: CoreSchema, + schema_type: Any, + schema_type_module: str, + schema_type_name: str, + schema_kind: SchemaKind, + config: CoreConfig | None = None, + plugin_settings: dict[str, Any] | None = None, +) -> SchemaValidator: + """Create a `SchemaValidator` or `PluggableSchemaValidator` if plugins are installed. + + Returns: + If plugins are installed then return `PluggableSchemaValidator`, otherwise return `SchemaValidator`. + """ + from . import SchemaTypePath + from ._loader import get_plugins + + plugins = get_plugins() + if plugins: + return PluggableSchemaValidator( + schema, + schema_type, + SchemaTypePath(schema_type_module, schema_type_name), + schema_kind, + config, + plugins, + plugin_settings or {}, + ) # type: ignore + else: + return SchemaValidator(schema, config) + + +class PluggableSchemaValidator: + """Pluggable schema validator.""" + + __slots__ = '_schema_validator', 'validate_json', 'validate_python', 'validate_strings' + + def __init__( + self, + schema: CoreSchema, + schema_type: Any, + schema_type_path: SchemaTypePath, + schema_kind: SchemaKind, + config: CoreConfig | None, + plugins: Iterable[PydanticPluginProtocol], + plugin_settings: dict[str, Any], + ) -> None: + self._schema_validator = SchemaValidator(schema, config) + + python_event_handlers: list[BaseValidateHandlerProtocol] = [] + json_event_handlers: list[BaseValidateHandlerProtocol] = [] + strings_event_handlers: list[BaseValidateHandlerProtocol] = [] + for plugin in plugins: + try: + p, j, s = plugin.new_schema_validator( + schema, schema_type, schema_type_path, schema_kind, config, plugin_settings + ) + except TypeError as e: # pragma: no cover + raise TypeError(f'Error using plugin `{plugin.__module__}:{plugin.__class__.__name__}`: {e}') from e + if p is not None: + python_event_handlers.append(p) + if j is not None: + json_event_handlers.append(j) + if s is not None: + strings_event_handlers.append(s) + + self.validate_python = build_wrapper(self._schema_validator.validate_python, python_event_handlers) + self.validate_json = build_wrapper(self._schema_validator.validate_json, json_event_handlers) + self.validate_strings = build_wrapper(self._schema_validator.validate_strings, strings_event_handlers) + + def __getattr__(self, name: str) -> Any: + return getattr(self._schema_validator, name) + + +def build_wrapper(func: Callable[P, R], event_handlers: list[BaseValidateHandlerProtocol]) -> Callable[P, R]: + if not event_handlers: + return func + else: + on_enters = tuple(h.on_enter for h in event_handlers if filter_handlers(h, 'on_enter')) + on_successes = tuple(h.on_success for h in event_handlers if filter_handlers(h, 'on_success')) + on_errors = tuple(h.on_error for h in event_handlers if filter_handlers(h, 'on_error')) + on_exceptions = tuple(h.on_exception for h in event_handlers if filter_handlers(h, 'on_exception')) + + @functools.wraps(func) + def wrapper(*args: P.args, **kwargs: P.kwargs) -> R: + for on_enter_handler in on_enters: + on_enter_handler(*args, **kwargs) + + try: + result = func(*args, **kwargs) + except ValidationError as error: + for on_error_handler in on_errors: + on_error_handler(error) + raise + except Exception as exception: + for on_exception_handler in on_exceptions: + on_exception_handler(exception) + raise + else: + for on_success_handler in on_successes: + on_success_handler(result) + return result + + return wrapper + + +def filter_handlers(handler_cls: BaseValidateHandlerProtocol, method_name: str) -> bool: + """Filter out handler methods which are not implemented by the plugin directly - e.g. are missing + or are inherited from the protocol. + """ + handler = getattr(handler_cls, method_name, None) + if handler is None: + return False + elif handler.__module__ == 'pydantic.plugin': + # this is the original handler, from the protocol due to runtime inheritance + # we don't want to call it + return False + else: + return True diff --git a/lib/pydantic/root_model.py b/lib/pydantic/root_model.py new file mode 100644 index 00000000..42186b9d --- /dev/null +++ b/lib/pydantic/root_model.py @@ -0,0 +1,149 @@ +"""RootModel class and type definitions.""" + +from __future__ import annotations as _annotations + +import typing +from copy import copy, deepcopy + +from pydantic_core import PydanticUndefined + +from . import PydanticUserError +from ._internal import _model_construction, _repr +from .main import BaseModel, _object_setattr + +if typing.TYPE_CHECKING: + from typing import Any + + from typing_extensions import Literal, dataclass_transform + + from .fields import Field as PydanticModelField + + # dataclass_transform could be applied to RootModel directly, but `ModelMetaclass`'s dataclass_transform + # takes priority (at least with pyright). We trick type checkers into thinking we apply dataclass_transform + # on a new metaclass. + @dataclass_transform(kw_only_default=False, field_specifiers=(PydanticModelField,)) + class _RootModelMetaclass(_model_construction.ModelMetaclass): + ... + + Model = typing.TypeVar('Model', bound='BaseModel') +else: + _RootModelMetaclass = _model_construction.ModelMetaclass + +__all__ = ('RootModel',) + + +RootModelRootType = typing.TypeVar('RootModelRootType') + + +class RootModel(BaseModel, typing.Generic[RootModelRootType], metaclass=_RootModelMetaclass): + """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/#rootmodel-and-custom-root-types + + A Pydantic `BaseModel` for the root object of the model. + + Attributes: + root: The root object of the model. + __pydantic_root_model__: Whether the model is a RootModel. + __pydantic_private__: Private fields in the model. + __pydantic_extra__: Extra fields in the model. + + """ + + __pydantic_root_model__ = True + __pydantic_private__ = None + __pydantic_extra__ = None + + root: RootModelRootType + + def __init_subclass__(cls, **kwargs): + extra = cls.model_config.get('extra') + if extra is not None: + raise PydanticUserError( + "`RootModel` does not support setting `model_config['extra']`", code='root-model-extra' + ) + super().__init_subclass__(**kwargs) + + def __init__(self, /, root: RootModelRootType = PydanticUndefined, **data) -> None: # type: ignore + __tracebackhide__ = True + if data: + if root is not PydanticUndefined: + raise ValueError( + '"RootModel.__init__" accepts either a single positional argument or arbitrary keyword arguments' + ) + root = data # type: ignore + self.__pydantic_validator__.validate_python(root, self_instance=self) + + __init__.__pydantic_base_init__ = True # pyright: ignore[reportFunctionMemberAccess] + + @classmethod + def model_construct(cls: type[Model], root: RootModelRootType, _fields_set: set[str] | None = None) -> Model: # type: ignore + """Create a new model using the provided root object and update fields set. + + Args: + root: The root object of the model. + _fields_set: The set of fields to be updated. + + Returns: + The new model. + + Raises: + NotImplemented: If the model is not a subclass of `RootModel`. + """ + return super().model_construct(root=root, _fields_set=_fields_set) + + def __getstate__(self) -> dict[Any, Any]: + return { + '__dict__': self.__dict__, + '__pydantic_fields_set__': self.__pydantic_fields_set__, + } + + def __setstate__(self, state: dict[Any, Any]) -> None: + _object_setattr(self, '__pydantic_fields_set__', state['__pydantic_fields_set__']) + _object_setattr(self, '__dict__', state['__dict__']) + + def __copy__(self: Model) -> Model: + """Returns a shallow copy of the model.""" + cls = type(self) + m = cls.__new__(cls) + _object_setattr(m, '__dict__', copy(self.__dict__)) + _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__)) + return m + + def __deepcopy__(self: Model, memo: dict[int, Any] | None = None) -> Model: + """Returns a deep copy of the model.""" + cls = type(self) + m = cls.__new__(cls) + _object_setattr(m, '__dict__', deepcopy(self.__dict__, memo=memo)) + # This next line doesn't need a deepcopy because __pydantic_fields_set__ is a set[str], + # and attempting a deepcopy would be marginally slower. + _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__)) + return m + + if typing.TYPE_CHECKING: + + def model_dump( # type: ignore + self, + *, + mode: Literal['json', 'python'] | str = 'python', + include: Any = None, + exclude: Any = None, + by_alias: bool = False, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + round_trip: bool = False, + warnings: bool = True, + ) -> RootModelRootType: + """This method is included just to get a more accurate return type for type checkers. + It is included in this `if TYPE_CHECKING:` block since no override is actually necessary. + + See the documentation of `BaseModel.model_dump` for more details about the arguments. + """ + ... + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, RootModel): + return NotImplemented + return self.model_fields['root'].annotation == other.model_fields['root'].annotation and super().__eq__(other) + + def __repr_args__(self) -> _repr.ReprArgs: + yield 'root', self.root diff --git a/lib/pydantic/schema.py b/lib/pydantic/schema.py index e7af56f1..e290aed9 100644 --- a/lib/pydantic/schema.py +++ b/lib/pydantic/schema.py @@ -1,1153 +1,4 @@ -import re -import warnings -from collections import defaultdict -from datetime import date, datetime, time, timedelta -from decimal import Decimal -from enum import Enum -from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network -from pathlib import Path -from typing import ( - TYPE_CHECKING, - Any, - Callable, - Dict, - ForwardRef, - FrozenSet, - Generic, - Iterable, - List, - Optional, - Pattern, - Sequence, - Set, - Tuple, - Type, - TypeVar, - Union, - cast, -) -from uuid import UUID +"""The `schema` module is a backport module from V1.""" +from ._migration import getattr_migration -from typing_extensions import Annotated, Literal - -from .fields import ( - MAPPING_LIKE_SHAPES, - SHAPE_DEQUE, - SHAPE_FROZENSET, - SHAPE_GENERIC, - SHAPE_ITERABLE, - SHAPE_LIST, - SHAPE_SEQUENCE, - SHAPE_SET, - SHAPE_SINGLETON, - SHAPE_TUPLE, - SHAPE_TUPLE_ELLIPSIS, - FieldInfo, - ModelField, -) -from .json import pydantic_encoder -from .networks import AnyUrl, EmailStr -from .types import ( - ConstrainedDecimal, - ConstrainedFloat, - ConstrainedFrozenSet, - ConstrainedInt, - ConstrainedList, - ConstrainedSet, - SecretBytes, - SecretStr, - StrictBytes, - StrictStr, - conbytes, - condecimal, - confloat, - confrozenset, - conint, - conlist, - conset, - constr, -) -from .typing import ( - all_literal_values, - get_args, - get_origin, - get_sub_types, - is_callable_type, - is_literal_type, - is_namedtuple, - is_none_type, - is_union, -) -from .utils import ROOT_KEY, get_model, lenient_issubclass - -if TYPE_CHECKING: - from .dataclasses import Dataclass - from .main import BaseModel - -default_prefix = '#/definitions/' -default_ref_template = '#/definitions/{model}' - -TypeModelOrEnum = Union[Type['BaseModel'], Type[Enum]] -TypeModelSet = Set[TypeModelOrEnum] - - -def _apply_modify_schema( - modify_schema: Callable[..., None], field: Optional[ModelField], field_schema: Dict[str, Any] -) -> None: - from inspect import signature - - sig = signature(modify_schema) - args = set(sig.parameters.keys()) - if 'field' in args or 'kwargs' in args: - modify_schema(field_schema, field=field) - else: - modify_schema(field_schema) - - -def schema( - models: Sequence[Union[Type['BaseModel'], Type['Dataclass']]], - *, - by_alias: bool = True, - title: Optional[str] = None, - description: Optional[str] = None, - ref_prefix: Optional[str] = None, - ref_template: str = default_ref_template, -) -> Dict[str, Any]: - """ - Process a list of models and generate a single JSON Schema with all of them defined in the ``definitions`` - top-level JSON key, including their sub-models. - - :param models: a list of models to include in the generated JSON Schema - :param by_alias: generate the schemas using the aliases defined, if any - :param title: title for the generated schema that includes the definitions - :param description: description for the generated schema - :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the - default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere - else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the - top-level key ``definitions``, so you can extract them from there. But all the references will have the set - prefix. - :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful - for references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For - a sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``. - :return: dict with the JSON Schema with a ``definitions`` top-level key including the schema definitions for - the models and sub-models passed in ``models``. - """ - clean_models = [get_model(model) for model in models] - flat_models = get_flat_models_from_models(clean_models) - model_name_map = get_model_name_map(flat_models) - definitions = {} - output_schema: Dict[str, Any] = {} - if title: - output_schema['title'] = title - if description: - output_schema['description'] = description - for model in clean_models: - m_schema, m_definitions, m_nested_models = model_process_schema( - model, - by_alias=by_alias, - model_name_map=model_name_map, - ref_prefix=ref_prefix, - ref_template=ref_template, - ) - definitions.update(m_definitions) - model_name = model_name_map[model] - definitions[model_name] = m_schema - if definitions: - output_schema['definitions'] = definitions - return output_schema - - -def model_schema( - model: Union[Type['BaseModel'], Type['Dataclass']], - by_alias: bool = True, - ref_prefix: Optional[str] = None, - ref_template: str = default_ref_template, -) -> Dict[str, Any]: - """ - Generate a JSON Schema for one model. With all the sub-models defined in the ``definitions`` top-level - JSON key. - - :param model: a Pydantic model (a class that inherits from BaseModel) - :param by_alias: generate the schemas using the aliases defined, if any - :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the - default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere - else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the - top-level key ``definitions``, so you can extract them from there. But all the references will have the set - prefix. - :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for - references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a - sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``. - :return: dict with the JSON Schema for the passed ``model`` - """ - model = get_model(model) - flat_models = get_flat_models_from_model(model) - model_name_map = get_model_name_map(flat_models) - model_name = model_name_map[model] - m_schema, m_definitions, nested_models = model_process_schema( - model, by_alias=by_alias, model_name_map=model_name_map, ref_prefix=ref_prefix, ref_template=ref_template - ) - if model_name in nested_models: - # model_name is in Nested models, it has circular references - m_definitions[model_name] = m_schema - m_schema = get_schema_ref(model_name, ref_prefix, ref_template, False) - if m_definitions: - m_schema.update({'definitions': m_definitions}) - return m_schema - - -def get_field_info_schema(field: ModelField, schema_overrides: bool = False) -> Tuple[Dict[str, Any], bool]: - - # If no title is explicitly set, we don't set title in the schema for enums. - # The behaviour is the same as `BaseModel` reference, where the default title - # is in the definitions part of the schema. - schema_: Dict[str, Any] = {} - if field.field_info.title or not lenient_issubclass(field.type_, Enum): - schema_['title'] = field.field_info.title or field.alias.title().replace('_', ' ') - - if field.field_info.title: - schema_overrides = True - - if field.field_info.description: - schema_['description'] = field.field_info.description - schema_overrides = True - - if not field.required and field.default is not None and not is_callable_type(field.outer_type_): - schema_['default'] = encode_default(field.default) - schema_overrides = True - - return schema_, schema_overrides - - -def field_schema( - field: ModelField, - *, - by_alias: bool = True, - model_name_map: Dict[TypeModelOrEnum, str], - ref_prefix: Optional[str] = None, - ref_template: str = default_ref_template, - known_models: TypeModelSet = None, -) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: - """ - Process a Pydantic field and return a tuple with a JSON Schema for it as the first item. - Also return a dictionary of definitions with models as keys and their schemas as values. If the passed field - is a model and has sub-models, and those sub-models don't have overrides (as ``title``, ``default``, etc), they - will be included in the definitions and referenced in the schema instead of included recursively. - - :param field: a Pydantic ``ModelField`` - :param by_alias: use the defined alias (if any) in the returned schema - :param model_name_map: used to generate the JSON Schema references to other models included in the definitions - :param ref_prefix: the JSON Pointer prefix to use for references to other schemas, if None, the default of - #/definitions/ will be used - :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for - references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a - sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``. - :param known_models: used to solve circular references - :return: tuple of the schema for this field and additional definitions - """ - s, schema_overrides = get_field_info_schema(field) - - validation_schema = get_field_schema_validations(field) - if validation_schema: - s.update(validation_schema) - schema_overrides = True - - f_schema, f_definitions, f_nested_models = field_type_schema( - field, - by_alias=by_alias, - model_name_map=model_name_map, - schema_overrides=schema_overrides, - ref_prefix=ref_prefix, - ref_template=ref_template, - known_models=known_models or set(), - ) - - # $ref will only be returned when there are no schema_overrides - if '$ref' in f_schema: - return f_schema, f_definitions, f_nested_models - else: - s.update(f_schema) - return s, f_definitions, f_nested_models - - -numeric_types = (int, float, Decimal) -_str_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = ( - ('max_length', numeric_types, 'maxLength'), - ('min_length', numeric_types, 'minLength'), - ('regex', str, 'pattern'), -) - -_numeric_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = ( - ('gt', numeric_types, 'exclusiveMinimum'), - ('lt', numeric_types, 'exclusiveMaximum'), - ('ge', numeric_types, 'minimum'), - ('le', numeric_types, 'maximum'), - ('multiple_of', numeric_types, 'multipleOf'), -) - - -def get_field_schema_validations(field: ModelField) -> Dict[str, Any]: - """ - Get the JSON Schema validation keywords for a ``field`` with an annotation of - a Pydantic ``FieldInfo`` with validation arguments. - """ - f_schema: Dict[str, Any] = {} - - if lenient_issubclass(field.type_, Enum): - # schema is already updated by `enum_process_schema`; just update with field extra - if field.field_info.extra: - f_schema.update(field.field_info.extra) - return f_schema - - if lenient_issubclass(field.type_, (str, bytes)): - for attr_name, t, keyword in _str_types_attrs: - attr = getattr(field.field_info, attr_name, None) - if isinstance(attr, t): - f_schema[keyword] = attr - if lenient_issubclass(field.type_, numeric_types) and not issubclass(field.type_, bool): - for attr_name, t, keyword in _numeric_types_attrs: - attr = getattr(field.field_info, attr_name, None) - if isinstance(attr, t): - f_schema[keyword] = attr - if field.field_info is not None and field.field_info.const: - f_schema['const'] = field.default - if field.field_info.extra: - f_schema.update(field.field_info.extra) - modify_schema = getattr(field.outer_type_, '__modify_schema__', None) - if modify_schema: - _apply_modify_schema(modify_schema, field, f_schema) - return f_schema - - -def get_model_name_map(unique_models: TypeModelSet) -> Dict[TypeModelOrEnum, str]: - """ - Process a set of models and generate unique names for them to be used as keys in the JSON Schema - definitions. By default the names are the same as the class name. But if two models in different Python - modules have the same name (e.g. "users.Model" and "items.Model"), the generated names will be - based on the Python module path for those conflicting models to prevent name collisions. - - :param unique_models: a Python set of models - :return: dict mapping models to names - """ - name_model_map = {} - conflicting_names: Set[str] = set() - for model in unique_models: - model_name = normalize_name(model.__name__) - if model_name in conflicting_names: - model_name = get_long_model_name(model) - name_model_map[model_name] = model - elif model_name in name_model_map: - conflicting_names.add(model_name) - conflicting_model = name_model_map.pop(model_name) - name_model_map[get_long_model_name(conflicting_model)] = conflicting_model - name_model_map[get_long_model_name(model)] = model - else: - name_model_map[model_name] = model - return {v: k for k, v in name_model_map.items()} - - -def get_flat_models_from_model(model: Type['BaseModel'], known_models: TypeModelSet = None) -> TypeModelSet: - """ - Take a single ``model`` and generate a set with itself and all the sub-models in the tree. I.e. if you pass - model ``Foo`` (subclass of Pydantic ``BaseModel``) as ``model``, and it has a field of type ``Bar`` (also - subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also subclass of ``BaseModel``), - the return value will be ``set([Foo, Bar, Baz])``. - - :param model: a Pydantic ``BaseModel`` subclass - :param known_models: used to solve circular references - :return: a set with the initial model and all its sub-models - """ - known_models = known_models or set() - flat_models: TypeModelSet = set() - flat_models.add(model) - known_models |= flat_models - fields = cast(Sequence[ModelField], model.__fields__.values()) - flat_models |= get_flat_models_from_fields(fields, known_models=known_models) - return flat_models - - -def get_flat_models_from_field(field: ModelField, known_models: TypeModelSet) -> TypeModelSet: - """ - Take a single Pydantic ``ModelField`` (from a model) that could have been declared as a sublcass of BaseModel - (so, it could be a submodel), and generate a set with its model and all the sub-models in the tree. - I.e. if you pass a field that was declared to be of type ``Foo`` (subclass of BaseModel) as ``field``, and that - model ``Foo`` has a field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of - type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``. - - :param field: a Pydantic ``ModelField`` - :param known_models: used to solve circular references - :return: a set with the model used in the declaration for this field, if any, and all its sub-models - """ - from .main import BaseModel - - flat_models: TypeModelSet = set() - - field_type = field.type_ - if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel): - field_type = field_type.__pydantic_model__ - - if field.sub_fields and not lenient_issubclass(field_type, BaseModel): - flat_models |= get_flat_models_from_fields(field.sub_fields, known_models=known_models) - elif lenient_issubclass(field_type, BaseModel) and field_type not in known_models: - flat_models |= get_flat_models_from_model(field_type, known_models=known_models) - elif lenient_issubclass(field_type, Enum): - flat_models.add(field_type) - return flat_models - - -def get_flat_models_from_fields(fields: Sequence[ModelField], known_models: TypeModelSet) -> TypeModelSet: - """ - Take a list of Pydantic ``ModelField``s (from a model) that could have been declared as subclasses of ``BaseModel`` - (so, any of them could be a submodel), and generate a set with their models and all the sub-models in the tree. - I.e. if you pass a the fields of a model ``Foo`` (subclass of ``BaseModel``) as ``fields``, and on of them has a - field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also - subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``. - - :param fields: a list of Pydantic ``ModelField``s - :param known_models: used to solve circular references - :return: a set with any model declared in the fields, and all their sub-models - """ - flat_models: TypeModelSet = set() - for field in fields: - flat_models |= get_flat_models_from_field(field, known_models=known_models) - return flat_models - - -def get_flat_models_from_models(models: Sequence[Type['BaseModel']]) -> TypeModelSet: - """ - Take a list of ``models`` and generate a set with them and all their sub-models in their trees. I.e. if you pass - a list of two models, ``Foo`` and ``Bar``, both subclasses of Pydantic ``BaseModel`` as models, and ``Bar`` has - a field of type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``. - """ - flat_models: TypeModelSet = set() - for model in models: - flat_models |= get_flat_models_from_model(model) - return flat_models - - -def get_long_model_name(model: TypeModelOrEnum) -> str: - return f'{model.__module__}__{model.__qualname__}'.replace('.', '__') - - -def field_type_schema( - field: ModelField, - *, - by_alias: bool, - model_name_map: Dict[TypeModelOrEnum, str], - ref_template: str, - schema_overrides: bool = False, - ref_prefix: Optional[str] = None, - known_models: TypeModelSet, -) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: - """ - Used by ``field_schema()``, you probably should be using that function. - - Take a single ``field`` and generate the schema for its type only, not including additional - information as title, etc. Also return additional schema definitions, from sub-models. - """ - from .main import BaseModel # noqa: F811 - - definitions = {} - nested_models: Set[str] = set() - f_schema: Dict[str, Any] - if field.shape in { - SHAPE_LIST, - SHAPE_TUPLE_ELLIPSIS, - SHAPE_SEQUENCE, - SHAPE_SET, - SHAPE_FROZENSET, - SHAPE_ITERABLE, - SHAPE_DEQUE, - }: - items_schema, f_definitions, f_nested_models = field_singleton_schema( - field, - by_alias=by_alias, - model_name_map=model_name_map, - ref_prefix=ref_prefix, - ref_template=ref_template, - known_models=known_models, - ) - definitions.update(f_definitions) - nested_models.update(f_nested_models) - f_schema = {'type': 'array', 'items': items_schema} - if field.shape in {SHAPE_SET, SHAPE_FROZENSET}: - f_schema['uniqueItems'] = True - - elif field.shape in MAPPING_LIKE_SHAPES: - f_schema = {'type': 'object'} - key_field = cast(ModelField, field.key_field) - regex = getattr(key_field.type_, 'regex', None) - items_schema, f_definitions, f_nested_models = field_singleton_schema( - field, - by_alias=by_alias, - model_name_map=model_name_map, - ref_prefix=ref_prefix, - ref_template=ref_template, - known_models=known_models, - ) - definitions.update(f_definitions) - nested_models.update(f_nested_models) - if regex: - # Dict keys have a regex pattern - # items_schema might be a schema or empty dict, add it either way - f_schema['patternProperties'] = {regex.pattern: items_schema} - elif items_schema: - # The dict values are not simply Any, so they need a schema - f_schema['additionalProperties'] = items_schema - elif field.shape == SHAPE_TUPLE or (field.shape == SHAPE_GENERIC and not issubclass(field.type_, BaseModel)): - sub_schema = [] - sub_fields = cast(List[ModelField], field.sub_fields) - for sf in sub_fields: - sf_schema, sf_definitions, sf_nested_models = field_type_schema( - sf, - by_alias=by_alias, - model_name_map=model_name_map, - ref_prefix=ref_prefix, - ref_template=ref_template, - known_models=known_models, - ) - definitions.update(sf_definitions) - nested_models.update(sf_nested_models) - sub_schema.append(sf_schema) - - sub_fields_len = len(sub_fields) - if field.shape == SHAPE_GENERIC: - all_of_schemas = sub_schema[0] if sub_fields_len == 1 else {'type': 'array', 'items': sub_schema} - f_schema = {'allOf': [all_of_schemas]} - else: - f_schema = { - 'type': 'array', - 'minItems': sub_fields_len, - 'maxItems': sub_fields_len, - } - if sub_fields_len >= 1: - f_schema['items'] = sub_schema - else: - assert field.shape in {SHAPE_SINGLETON, SHAPE_GENERIC}, field.shape - f_schema, f_definitions, f_nested_models = field_singleton_schema( - field, - by_alias=by_alias, - model_name_map=model_name_map, - schema_overrides=schema_overrides, - ref_prefix=ref_prefix, - ref_template=ref_template, - known_models=known_models, - ) - definitions.update(f_definitions) - nested_models.update(f_nested_models) - - # check field type to avoid repeated calls to the same __modify_schema__ method - if field.type_ != field.outer_type_: - if field.shape == SHAPE_GENERIC: - field_type = field.type_ - else: - field_type = field.outer_type_ - modify_schema = getattr(field_type, '__modify_schema__', None) - if modify_schema: - _apply_modify_schema(modify_schema, field, f_schema) - return f_schema, definitions, nested_models - - -def model_process_schema( - model: TypeModelOrEnum, - *, - by_alias: bool = True, - model_name_map: Dict[TypeModelOrEnum, str], - ref_prefix: Optional[str] = None, - ref_template: str = default_ref_template, - known_models: TypeModelSet = None, - field: Optional[ModelField] = None, -) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: - """ - Used by ``model_schema()``, you probably should be using that function. - - Take a single ``model`` and generate its schema. Also return additional schema definitions, from sub-models. The - sub-models of the returned schema will be referenced, but their definitions will not be included in the schema. All - the definitions are returned as the second value. - """ - from inspect import getdoc, signature - - known_models = known_models or set() - if lenient_issubclass(model, Enum): - model = cast(Type[Enum], model) - s = enum_process_schema(model, field=field) - return s, {}, set() - model = cast(Type['BaseModel'], model) - s = {'title': model.__config__.title or model.__name__} - doc = getdoc(model) - if doc: - s['description'] = doc - known_models.add(model) - m_schema, m_definitions, nested_models = model_type_schema( - model, - by_alias=by_alias, - model_name_map=model_name_map, - ref_prefix=ref_prefix, - ref_template=ref_template, - known_models=known_models, - ) - s.update(m_schema) - schema_extra = model.__config__.schema_extra - if callable(schema_extra): - if len(signature(schema_extra).parameters) == 1: - schema_extra(s) - else: - schema_extra(s, model) - else: - s.update(schema_extra) - return s, m_definitions, nested_models - - -def model_type_schema( - model: Type['BaseModel'], - *, - by_alias: bool, - model_name_map: Dict[TypeModelOrEnum, str], - ref_template: str, - ref_prefix: Optional[str] = None, - known_models: TypeModelSet, -) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: - """ - You probably should be using ``model_schema()``, this function is indirectly used by that function. - - Take a single ``model`` and generate the schema for its type only, not including additional - information as title, etc. Also return additional schema definitions, from sub-models. - """ - properties = {} - required = [] - definitions: Dict[str, Any] = {} - nested_models: Set[str] = set() - for k, f in model.__fields__.items(): - try: - f_schema, f_definitions, f_nested_models = field_schema( - f, - by_alias=by_alias, - model_name_map=model_name_map, - ref_prefix=ref_prefix, - ref_template=ref_template, - known_models=known_models, - ) - except SkipField as skip: - warnings.warn(skip.message, UserWarning) - continue - definitions.update(f_definitions) - nested_models.update(f_nested_models) - if by_alias: - properties[f.alias] = f_schema - if f.required: - required.append(f.alias) - else: - properties[k] = f_schema - if f.required: - required.append(k) - if ROOT_KEY in properties: - out_schema = properties[ROOT_KEY] - out_schema['title'] = model.__config__.title or model.__name__ - else: - out_schema = {'type': 'object', 'properties': properties} - if required: - out_schema['required'] = required - if model.__config__.extra == 'forbid': - out_schema['additionalProperties'] = False - return out_schema, definitions, nested_models - - -def enum_process_schema(enum: Type[Enum], *, field: Optional[ModelField] = None) -> Dict[str, Any]: - """ - Take a single `enum` and generate its schema. - - This is similar to the `model_process_schema` function, but applies to ``Enum`` objects. - """ - schema_: Dict[str, Any] = { - 'title': enum.__name__, - # Python assigns all enums a default docstring value of 'An enumeration', so - # all enums will have a description field even if not explicitly provided. - 'description': enum.__doc__ or 'An enumeration.', - # Add enum values and the enum field type to the schema. - 'enum': [item.value for item in cast(Iterable[Enum], enum)], - } - - add_field_type_to_schema(enum, schema_) - - modify_schema = getattr(enum, '__modify_schema__', None) - if modify_schema: - _apply_modify_schema(modify_schema, field, schema_) - - return schema_ - - -def field_singleton_sub_fields_schema( - field: ModelField, - *, - by_alias: bool, - model_name_map: Dict[TypeModelOrEnum, str], - ref_template: str, - schema_overrides: bool = False, - ref_prefix: Optional[str] = None, - known_models: TypeModelSet, -) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: - """ - This function is indirectly used by ``field_schema()``, you probably should be using that function. - - Take a list of Pydantic ``ModelField`` from the declaration of a type with parameters, and generate their - schema. I.e., fields used as "type parameters", like ``str`` and ``int`` in ``Tuple[str, int]``. - """ - sub_fields = cast(List[ModelField], field.sub_fields) - definitions = {} - nested_models: Set[str] = set() - if len(sub_fields) == 1: - return field_type_schema( - sub_fields[0], - by_alias=by_alias, - model_name_map=model_name_map, - schema_overrides=schema_overrides, - ref_prefix=ref_prefix, - ref_template=ref_template, - known_models=known_models, - ) - else: - s: Dict[str, Any] = {} - # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#discriminator-object - field_has_discriminator: bool = field.discriminator_key is not None - if field_has_discriminator: - assert field.sub_fields_mapping is not None - - discriminator_models_refs: Dict[str, Union[str, Dict[str, Any]]] = {} - - for discriminator_value, sub_field in field.sub_fields_mapping.items(): - # sub_field is either a `BaseModel` or directly an `Annotated` `Union` of many - if is_union(get_origin(sub_field.type_)): - sub_models = get_sub_types(sub_field.type_) - discriminator_models_refs[discriminator_value] = { - model_name_map[sub_model]: get_schema_ref( - model_name_map[sub_model], ref_prefix, ref_template, False - ) - for sub_model in sub_models - } - else: - sub_field_type = sub_field.type_ - if hasattr(sub_field_type, '__pydantic_model__'): - sub_field_type = sub_field_type.__pydantic_model__ - - discriminator_model_name = model_name_map[sub_field_type] - discriminator_model_ref = get_schema_ref(discriminator_model_name, ref_prefix, ref_template, False) - discriminator_models_refs[discriminator_value] = discriminator_model_ref['$ref'] - - s['discriminator'] = { - 'propertyName': field.discriminator_alias, - 'mapping': discriminator_models_refs, - } - - sub_field_schemas = [] - for sf in sub_fields: - sub_schema, sub_definitions, sub_nested_models = field_type_schema( - sf, - by_alias=by_alias, - model_name_map=model_name_map, - schema_overrides=schema_overrides, - ref_prefix=ref_prefix, - ref_template=ref_template, - known_models=known_models, - ) - definitions.update(sub_definitions) - if schema_overrides and 'allOf' in sub_schema: - # if the sub_field is a referenced schema we only need the referenced - # object. Otherwise we will end up with several allOf inside anyOf/oneOf. - # See https://github.com/pydantic/pydantic/issues/1209 - sub_schema = sub_schema['allOf'][0] - - if sub_schema.keys() == {'discriminator', 'oneOf'}: - # we don't want discriminator information inside oneOf choices, this is dealt with elsewhere - sub_schema.pop('discriminator') - sub_field_schemas.append(sub_schema) - nested_models.update(sub_nested_models) - s['oneOf' if field_has_discriminator else 'anyOf'] = sub_field_schemas - return s, definitions, nested_models - - -# Order is important, e.g. subclasses of str must go before str -# this is used only for standard library types, custom types should use __modify_schema__ instead -field_class_to_schema: Tuple[Tuple[Any, Dict[str, Any]], ...] = ( - (Path, {'type': 'string', 'format': 'path'}), - (datetime, {'type': 'string', 'format': 'date-time'}), - (date, {'type': 'string', 'format': 'date'}), - (time, {'type': 'string', 'format': 'time'}), - (timedelta, {'type': 'number', 'format': 'time-delta'}), - (IPv4Network, {'type': 'string', 'format': 'ipv4network'}), - (IPv6Network, {'type': 'string', 'format': 'ipv6network'}), - (IPv4Interface, {'type': 'string', 'format': 'ipv4interface'}), - (IPv6Interface, {'type': 'string', 'format': 'ipv6interface'}), - (IPv4Address, {'type': 'string', 'format': 'ipv4'}), - (IPv6Address, {'type': 'string', 'format': 'ipv6'}), - (Pattern, {'type': 'string', 'format': 'regex'}), - (str, {'type': 'string'}), - (bytes, {'type': 'string', 'format': 'binary'}), - (bool, {'type': 'boolean'}), - (int, {'type': 'integer'}), - (float, {'type': 'number'}), - (Decimal, {'type': 'number'}), - (UUID, {'type': 'string', 'format': 'uuid'}), - (dict, {'type': 'object'}), - (list, {'type': 'array', 'items': {}}), - (tuple, {'type': 'array', 'items': {}}), - (set, {'type': 'array', 'items': {}, 'uniqueItems': True}), - (frozenset, {'type': 'array', 'items': {}, 'uniqueItems': True}), -) - -json_scheme = {'type': 'string', 'format': 'json-string'} - - -def add_field_type_to_schema(field_type: Any, schema_: Dict[str, Any]) -> None: - """ - Update the given `schema` with the type-specific metadata for the given `field_type`. - - This function looks through `field_class_to_schema` for a class that matches the given `field_type`, - and then modifies the given `schema` with the information from that type. - """ - for type_, t_schema in field_class_to_schema: - # Fallback for `typing.Pattern` and `re.Pattern` as they are not a valid class - if lenient_issubclass(field_type, type_) or field_type is type_ is Pattern: - schema_.update(t_schema) - break - - -def get_schema_ref(name: str, ref_prefix: Optional[str], ref_template: str, schema_overrides: bool) -> Dict[str, Any]: - if ref_prefix: - schema_ref = {'$ref': ref_prefix + name} - else: - schema_ref = {'$ref': ref_template.format(model=name)} - return {'allOf': [schema_ref]} if schema_overrides else schema_ref - - -def field_singleton_schema( # noqa: C901 (ignore complexity) - field: ModelField, - *, - by_alias: bool, - model_name_map: Dict[TypeModelOrEnum, str], - ref_template: str, - schema_overrides: bool = False, - ref_prefix: Optional[str] = None, - known_models: TypeModelSet, -) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: - """ - This function is indirectly used by ``field_schema()``, you should probably be using that function. - - Take a single Pydantic ``ModelField``, and return its schema and any additional definitions from sub-models. - """ - from .main import BaseModel - - definitions: Dict[str, Any] = {} - nested_models: Set[str] = set() - field_type = field.type_ - - # Recurse into this field if it contains sub_fields and is NOT a - # BaseModel OR that BaseModel is a const - if field.sub_fields and ( - (field.field_info and field.field_info.const) or not lenient_issubclass(field_type, BaseModel) - ): - return field_singleton_sub_fields_schema( - field, - by_alias=by_alias, - model_name_map=model_name_map, - schema_overrides=schema_overrides, - ref_prefix=ref_prefix, - ref_template=ref_template, - known_models=known_models, - ) - if field_type is Any or field_type is object or field_type.__class__ == TypeVar or get_origin(field_type) is type: - return {}, definitions, nested_models # no restrictions - if is_none_type(field_type): - return {'type': 'null'}, definitions, nested_models - if is_callable_type(field_type): - raise SkipField(f'Callable {field.name} was excluded from schema since JSON schema has no equivalent type.') - f_schema: Dict[str, Any] = {} - if field.field_info is not None and field.field_info.const: - f_schema['const'] = field.default - - if is_literal_type(field_type): - values = all_literal_values(field_type) - - if len({v.__class__ for v in values}) > 1: - return field_schema( - multitypes_literal_field_for_schema(values, field), - by_alias=by_alias, - model_name_map=model_name_map, - ref_prefix=ref_prefix, - ref_template=ref_template, - known_models=known_models, - ) - - # All values have the same type - field_type = values[0].__class__ - f_schema['enum'] = list(values) - add_field_type_to_schema(field_type, f_schema) - elif lenient_issubclass(field_type, Enum): - enum_name = model_name_map[field_type] - f_schema, schema_overrides = get_field_info_schema(field, schema_overrides) - f_schema.update(get_schema_ref(enum_name, ref_prefix, ref_template, schema_overrides)) - definitions[enum_name] = enum_process_schema(field_type, field=field) - elif is_namedtuple(field_type): - sub_schema, *_ = model_process_schema( - field_type.__pydantic_model__, - by_alias=by_alias, - model_name_map=model_name_map, - ref_prefix=ref_prefix, - ref_template=ref_template, - known_models=known_models, - field=field, - ) - items_schemas = list(sub_schema['properties'].values()) - f_schema.update( - { - 'type': 'array', - 'items': items_schemas, - 'minItems': len(items_schemas), - 'maxItems': len(items_schemas), - } - ) - elif not hasattr(field_type, '__pydantic_model__'): - add_field_type_to_schema(field_type, f_schema) - - modify_schema = getattr(field_type, '__modify_schema__', None) - if modify_schema: - _apply_modify_schema(modify_schema, field, f_schema) - - if f_schema: - return f_schema, definitions, nested_models - - # Handle dataclass-based models - if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel): - field_type = field_type.__pydantic_model__ - - if issubclass(field_type, BaseModel): - model_name = model_name_map[field_type] - if field_type not in known_models: - sub_schema, sub_definitions, sub_nested_models = model_process_schema( - field_type, - by_alias=by_alias, - model_name_map=model_name_map, - ref_prefix=ref_prefix, - ref_template=ref_template, - known_models=known_models, - field=field, - ) - definitions.update(sub_definitions) - definitions[model_name] = sub_schema - nested_models.update(sub_nested_models) - else: - nested_models.add(model_name) - schema_ref = get_schema_ref(model_name, ref_prefix, ref_template, schema_overrides) - return schema_ref, definitions, nested_models - - # For generics with no args - args = get_args(field_type) - if args is not None and not args and Generic in field_type.__bases__: - return f_schema, definitions, nested_models - - raise ValueError(f'Value not declarable with JSON Schema, field: {field}') - - -def multitypes_literal_field_for_schema(values: Tuple[Any, ...], field: ModelField) -> ModelField: - """ - To support `Literal` with values of different types, we split it into multiple `Literal` with same type - e.g. `Literal['qwe', 'asd', 1, 2]` becomes `Union[Literal['qwe', 'asd'], Literal[1, 2]]` - """ - literal_distinct_types = defaultdict(list) - for v in values: - literal_distinct_types[v.__class__].append(v) - distinct_literals = (Literal[tuple(same_type_values)] for same_type_values in literal_distinct_types.values()) - - return ModelField( - name=field.name, - type_=Union[tuple(distinct_literals)], # type: ignore - class_validators=field.class_validators, - model_config=field.model_config, - default=field.default, - required=field.required, - alias=field.alias, - field_info=field.field_info, - ) - - -def encode_default(dft: Any) -> Any: - if isinstance(dft, Enum): - return dft.value - elif isinstance(dft, (int, float, str)): - return dft - elif isinstance(dft, (list, tuple)): - t = dft.__class__ - seq_args = (encode_default(v) for v in dft) - return t(*seq_args) if is_namedtuple(t) else t(seq_args) - elif isinstance(dft, dict): - return {encode_default(k): encode_default(v) for k, v in dft.items()} - elif dft is None: - return None - else: - return pydantic_encoder(dft) - - -_map_types_constraint: Dict[Any, Callable[..., type]] = {int: conint, float: confloat, Decimal: condecimal} - - -def get_annotation_from_field_info( - annotation: Any, field_info: FieldInfo, field_name: str, validate_assignment: bool = False -) -> Type[Any]: - """ - Get an annotation with validation implemented for numbers and strings based on the field_info. - :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr`` - :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema - :param field_name: name of the field for use in error messages - :param validate_assignment: default False, flag for BaseModel Config value of validate_assignment - :return: the same ``annotation`` if unmodified or a new annotation with validation in place - """ - constraints = field_info.get_constraints() - used_constraints: Set[str] = set() - if constraints: - annotation, used_constraints = get_annotation_with_constraints(annotation, field_info) - if validate_assignment: - used_constraints.add('allow_mutation') - - unused_constraints = constraints - used_constraints - if unused_constraints: - raise ValueError( - f'On field "{field_name}" the following field constraints are set but not enforced: ' - f'{", ".join(unused_constraints)}. ' - f'\nFor more details see https://pydantic-docs.helpmanual.io/usage/schema/#unenforced-field-constraints' - ) - - return annotation - - -def get_annotation_with_constraints(annotation: Any, field_info: FieldInfo) -> Tuple[Type[Any], Set[str]]: # noqa: C901 - """ - Get an annotation with used constraints implemented for numbers and strings based on the field_info. - - :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr`` - :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema - :return: the same ``annotation`` if unmodified or a new annotation along with the used constraints. - """ - used_constraints: Set[str] = set() - - def go(type_: Any) -> Type[Any]: - if ( - is_literal_type(type_) - or isinstance(type_, ForwardRef) - or lenient_issubclass(type_, (ConstrainedList, ConstrainedSet, ConstrainedFrozenSet)) - ): - return type_ - origin = get_origin(type_) - if origin is not None: - args: Tuple[Any, ...] = get_args(type_) - if any(isinstance(a, ForwardRef) for a in args): - # forward refs cause infinite recursion below - return type_ - - if origin is Annotated: - return go(args[0]) - if is_union(origin): - return Union[tuple(go(a) for a in args)] # type: ignore - - if issubclass(origin, List) and ( - field_info.min_items is not None - or field_info.max_items is not None - or field_info.unique_items is not None - ): - used_constraints.update({'min_items', 'max_items', 'unique_items'}) - return conlist( - go(args[0]), - min_items=field_info.min_items, - max_items=field_info.max_items, - unique_items=field_info.unique_items, - ) - - if issubclass(origin, Set) and (field_info.min_items is not None or field_info.max_items is not None): - used_constraints.update({'min_items', 'max_items'}) - return conset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items) - - if issubclass(origin, FrozenSet) and (field_info.min_items is not None or field_info.max_items is not None): - used_constraints.update({'min_items', 'max_items'}) - return confrozenset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items) - - for t in (Tuple, List, Set, FrozenSet, Sequence): - if issubclass(origin, t): # type: ignore - return t[tuple(go(a) for a in args)] # type: ignore - - if issubclass(origin, Dict): - return Dict[args[0], go(args[1])] # type: ignore - - attrs: Optional[Tuple[str, ...]] = None - constraint_func: Optional[Callable[..., type]] = None - if isinstance(type_, type): - if issubclass(type_, (SecretStr, SecretBytes)): - attrs = ('max_length', 'min_length') - - def constraint_func(**kw: Any) -> Type[Any]: - return type(type_.__name__, (type_,), kw) - - elif issubclass(type_, str) and not issubclass(type_, (EmailStr, AnyUrl)): - attrs = ('max_length', 'min_length', 'regex') - if issubclass(type_, StrictStr): - - def constraint_func(**kw: Any) -> Type[Any]: - return type(type_.__name__, (type_,), kw) - - else: - constraint_func = constr - elif issubclass(type_, bytes): - attrs = ('max_length', 'min_length', 'regex') - if issubclass(type_, StrictBytes): - - def constraint_func(**kw: Any) -> Type[Any]: - return type(type_.__name__, (type_,), kw) - - else: - constraint_func = conbytes - elif issubclass(type_, numeric_types) and not issubclass( - type_, - ( - ConstrainedInt, - ConstrainedFloat, - ConstrainedDecimal, - ConstrainedList, - ConstrainedSet, - ConstrainedFrozenSet, - bool, - ), - ): - # Is numeric type - attrs = ('gt', 'lt', 'ge', 'le', 'multiple_of') - if issubclass(type_, float): - attrs += ('allow_inf_nan',) - if issubclass(type_, Decimal): - attrs += ('max_digits', 'decimal_places') - numeric_type = next(t for t in numeric_types if issubclass(type_, t)) # pragma: no branch - constraint_func = _map_types_constraint[numeric_type] - - if attrs: - used_constraints.update(set(attrs)) - kwargs = { - attr_name: attr - for attr_name, attr in ((attr_name, getattr(field_info, attr_name)) for attr_name in attrs) - if attr is not None - } - if kwargs: - constraint_func = cast(Callable[..., type], constraint_func) - return constraint_func(**kwargs) - return type_ - - return go(annotation), used_constraints - - -def normalize_name(name: str) -> str: - """ - Normalizes the given name. This can be applied to either a model *or* enum. - """ - return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name) - - -class SkipField(Exception): - """ - Utility exception used to exclude fields from schema. - """ - - def __init__(self, message: str) -> None: - self.message = message +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/tools.py b/lib/pydantic/tools.py index 9cdb4538..8e317c92 100644 --- a/lib/pydantic/tools.py +++ b/lib/pydantic/tools.py @@ -1,92 +1,4 @@ -import json -from functools import lru_cache -from pathlib import Path -from typing import TYPE_CHECKING, Any, Callable, Optional, Type, TypeVar, Union +"""The `tools` module is a backport module from V1.""" +from ._migration import getattr_migration -from .parse import Protocol, load_file, load_str_bytes -from .types import StrBytes -from .typing import display_as_type - -__all__ = ('parse_file_as', 'parse_obj_as', 'parse_raw_as', 'schema_of', 'schema_json_of') - -NameFactory = Union[str, Callable[[Type[Any]], str]] - -if TYPE_CHECKING: - from .typing import DictStrAny - - -def _generate_parsing_type_name(type_: Any) -> str: - return f'ParsingModel[{display_as_type(type_)}]' - - -@lru_cache(maxsize=2048) -def _get_parsing_type(type_: Any, *, type_name: Optional[NameFactory] = None) -> Any: - from pydantic.main import create_model - - if type_name is None: - type_name = _generate_parsing_type_name - if not isinstance(type_name, str): - type_name = type_name(type_) - return create_model(type_name, __root__=(type_, ...)) - - -T = TypeVar('T') - - -def parse_obj_as(type_: Type[T], obj: Any, *, type_name: Optional[NameFactory] = None) -> T: - model_type = _get_parsing_type(type_, type_name=type_name) # type: ignore[arg-type] - return model_type(__root__=obj).__root__ - - -def parse_file_as( - type_: Type[T], - path: Union[str, Path], - *, - content_type: str = None, - encoding: str = 'utf8', - proto: Protocol = None, - allow_pickle: bool = False, - json_loads: Callable[[str], Any] = json.loads, - type_name: Optional[NameFactory] = None, -) -> T: - obj = load_file( - path, - proto=proto, - content_type=content_type, - encoding=encoding, - allow_pickle=allow_pickle, - json_loads=json_loads, - ) - return parse_obj_as(type_, obj, type_name=type_name) - - -def parse_raw_as( - type_: Type[T], - b: StrBytes, - *, - content_type: str = None, - encoding: str = 'utf8', - proto: Protocol = None, - allow_pickle: bool = False, - json_loads: Callable[[str], Any] = json.loads, - type_name: Optional[NameFactory] = None, -) -> T: - obj = load_str_bytes( - b, - proto=proto, - content_type=content_type, - encoding=encoding, - allow_pickle=allow_pickle, - json_loads=json_loads, - ) - return parse_obj_as(type_, obj, type_name=type_name) - - -def schema_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_kwargs: Any) -> 'DictStrAny': - """Generate a JSON schema (as dict) for the passed model or dynamically generated one""" - return _get_parsing_type(type_, type_name=title).schema(**schema_kwargs) - - -def schema_json_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_json_kwargs: Any) -> str: - """Generate a JSON schema (as JSON) for the passed model or dynamically generated one""" - return _get_parsing_type(type_, type_name=title).schema_json(**schema_json_kwargs) +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/type_adapter.py b/lib/pydantic/type_adapter.py new file mode 100644 index 00000000..366262fe --- /dev/null +++ b/lib/pydantic/type_adapter.py @@ -0,0 +1,460 @@ +"""Type adapter specification.""" +from __future__ import annotations as _annotations + +import sys +from dataclasses import is_dataclass +from typing import TYPE_CHECKING, Any, Dict, Generic, Iterable, Set, TypeVar, Union, cast, final, overload + +from pydantic_core import CoreSchema, SchemaSerializer, SchemaValidator, Some +from typing_extensions import Literal, get_args, is_typeddict + +from pydantic.errors import PydanticUserError +from pydantic.main import BaseModel + +from ._internal import _config, _generate_schema, _typing_extra +from .config import ConfigDict +from .json_schema import ( + DEFAULT_REF_TEMPLATE, + GenerateJsonSchema, + JsonSchemaKeyT, + JsonSchemaMode, + JsonSchemaValue, +) +from .plugin._schema_validator import create_schema_validator + +T = TypeVar('T') + + +if TYPE_CHECKING: + # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope + IncEx = Union[Set[int], Set[str], Dict[int, Any], Dict[str, Any]] + + +def _get_schema(type_: Any, config_wrapper: _config.ConfigWrapper, parent_depth: int) -> CoreSchema: + """`BaseModel` uses its own `__module__` to find out where it was defined + and then looks for symbols to resolve forward references in those globals. + On the other hand this function can be called with arbitrary objects, + including type aliases, where `__module__` (always `typing.py`) is not useful. + So instead we look at the globals in our parent stack frame. + + This works for the case where this function is called in a module that + has the target of forward references in its scope, but + does not always work for more complex cases. + + For example, take the following: + + a.py + ```python + from typing import Dict, List + + IntList = List[int] + OuterDict = Dict[str, 'IntList'] + ``` + + b.py + ```python test="skip" + from a import OuterDict + + from pydantic import TypeAdapter + + IntList = int # replaces the symbol the forward reference is looking for + v = TypeAdapter(OuterDict) + v({'x': 1}) # should fail but doesn't + ``` + + If `OuterDict` were a `BaseModel`, this would work because it would resolve + the forward reference within the `a.py` namespace. + But `TypeAdapter(OuterDict)` can't determine what module `OuterDict` came from. + + In other words, the assumption that _all_ forward references exist in the + module we are being called from is not technically always true. + Although most of the time it is and it works fine for recursive models and such, + `BaseModel`'s behavior isn't perfect either and _can_ break in similar ways, + so there is no right or wrong between the two. + + But at the very least this behavior is _subtly_ different from `BaseModel`'s. + """ + local_ns = _typing_extra.parent_frame_namespace(parent_depth=parent_depth) + global_ns = sys._getframe(max(parent_depth - 1, 1)).f_globals.copy() + global_ns.update(local_ns or {}) + gen = _generate_schema.GenerateSchema(config_wrapper, types_namespace=global_ns, typevars_map={}) + schema = gen.generate_schema(type_) + schema = gen.clean_schema(schema) + return schema + + +def _getattr_no_parents(obj: Any, attribute: str) -> Any: + """Returns the attribute value without attempting to look up attributes from parent types.""" + if hasattr(obj, '__dict__'): + try: + return obj.__dict__[attribute] + except KeyError: + pass + + slots = getattr(obj, '__slots__', None) + if slots is not None and attribute in slots: + return getattr(obj, attribute) + else: + raise AttributeError(attribute) + + +def _type_has_config(type_: Any) -> bool: + """Returns whether the type has config.""" + try: + return issubclass(type_, BaseModel) or is_dataclass(type_) or is_typeddict(type_) + except TypeError: + # type is not a class + return False + + +@final +class TypeAdapter(Generic[T]): + """Usage docs: https://docs.pydantic.dev/2.6/concepts/type_adapter/ + + Type adapters provide a flexible way to perform validation and serialization based on a Python type. + + A `TypeAdapter` instance exposes some of the functionality from `BaseModel` instance methods + for types that do not have such methods (such as dataclasses, primitive types, and more). + + **Note:** `TypeAdapter` instances are not types, and cannot be used as type annotations for fields. + + Attributes: + core_schema: The core schema for the type. + validator (SchemaValidator): The schema validator for the type. + serializer: The schema serializer for the type. + """ + + @overload + def __init__( + self, + type: type[T], + *, + config: ConfigDict | None = ..., + _parent_depth: int = ..., + module: str | None = ..., + ) -> None: + ... + + # This second overload is for unsupported special forms (such as Union). `pyright` handles them fine, but `mypy` does not match + # them against `type: type[T]`, so an explicit overload with `type: T` is needed. + @overload + def __init__( # pyright: ignore[reportOverlappingOverload] + self, + type: T, + *, + config: ConfigDict | None = ..., + _parent_depth: int = ..., + module: str | None = ..., + ) -> None: + ... + + def __init__( + self, + type: type[T] | T, + *, + config: ConfigDict | None = None, + _parent_depth: int = 2, + module: str | None = None, + ) -> None: + """Initializes the TypeAdapter object. + + Args: + type: The type associated with the `TypeAdapter`. + config: Configuration for the `TypeAdapter`, should be a dictionary conforming to [`ConfigDict`][pydantic.config.ConfigDict]. + _parent_depth: depth at which to search the parent namespace to construct the local namespace. + module: The module that passes to plugin if provided. + + !!! note + You cannot use the `config` argument when instantiating a `TypeAdapter` if the type you're using has its own + config that cannot be overridden (ex: `BaseModel`, `TypedDict`, and `dataclass`). A + [`type-adapter-config-unused`](../errors/usage_errors.md#type-adapter-config-unused) error will be raised in this case. + + !!! note + The `_parent_depth` argument is named with an underscore to suggest its private nature and discourage use. + It may be deprecated in a minor version, so we only recommend using it if you're + comfortable with potential change in behavior / support. + + ??? tip "Compatibility with `mypy`" + Depending on the type used, `mypy` might raise an error when instantiating a `TypeAdapter`. As a workaround, you can explicitly + annotate your variable: + + ```py + from typing import Union + + from pydantic import TypeAdapter + + ta: TypeAdapter[Union[str, int]] = TypeAdapter(Union[str, int]) # type: ignore[arg-type] + ``` + + Returns: + A type adapter configured for the specified `type`. + """ + type_is_annotated: bool = _typing_extra.is_annotated(type) + annotated_type: Any = get_args(type)[0] if type_is_annotated else None + type_has_config: bool = _type_has_config(annotated_type if type_is_annotated else type) + + if type_has_config and config is not None: + raise PydanticUserError( + 'Cannot use `config` when the type is a BaseModel, dataclass or TypedDict.' + ' These types can have their own config and setting the config via the `config`' + ' parameter to TypeAdapter will not override it, thus the `config` you passed to' + ' TypeAdapter becomes meaningless, which is probably not what you want.', + code='type-adapter-config-unused', + ) + + config_wrapper = _config.ConfigWrapper(config) + + core_schema: CoreSchema + try: + core_schema = _getattr_no_parents(type, '__pydantic_core_schema__') + except AttributeError: + core_schema = _get_schema(type, config_wrapper, parent_depth=_parent_depth + 1) + + core_config = config_wrapper.core_config(None) + validator: SchemaValidator + try: + validator = _getattr_no_parents(type, '__pydantic_validator__') + except AttributeError: + if module is None: + f = sys._getframe(1) + module = cast(str, f.f_globals.get('__name__', '')) + validator = create_schema_validator( + core_schema, type, module, str(type), 'TypeAdapter', core_config, config_wrapper.plugin_settings + ) # type: ignore + + serializer: SchemaSerializer + try: + serializer = _getattr_no_parents(type, '__pydantic_serializer__') + except AttributeError: + serializer = SchemaSerializer(core_schema, core_config) + + self.core_schema = core_schema + self.validator = validator + self.serializer = serializer + + def validate_python( + self, + __object: Any, + *, + strict: bool | None = None, + from_attributes: bool | None = None, + context: dict[str, Any] | None = None, + ) -> T: + """Validate a Python object against the model. + + Args: + __object: The Python object to validate against the model. + strict: Whether to strictly check types. + from_attributes: Whether to extract data from object attributes. + context: Additional context to pass to the validator. + + !!! note + When using `TypeAdapter` with a Pydantic `dataclass`, the use of the `from_attributes` + argument is not supported. + + Returns: + The validated object. + """ + return self.validator.validate_python(__object, strict=strict, from_attributes=from_attributes, context=context) + + def validate_json( + self, __data: str | bytes, *, strict: bool | None = None, context: dict[str, Any] | None = None + ) -> T: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/json/#json-parsing + + Validate a JSON string or bytes against the model. + + Args: + __data: The JSON data to validate against the model. + strict: Whether to strictly check types. + context: Additional context to use during validation. + + Returns: + The validated object. + """ + return self.validator.validate_json(__data, strict=strict, context=context) + + def validate_strings(self, __obj: Any, *, strict: bool | None = None, context: dict[str, Any] | None = None) -> T: + """Validate object contains string data against the model. + + Args: + __obj: The object contains string data to validate. + strict: Whether to strictly check types. + context: Additional context to use during validation. + + Returns: + The validated object. + """ + return self.validator.validate_strings(__obj, strict=strict, context=context) + + def get_default_value(self, *, strict: bool | None = None, context: dict[str, Any] | None = None) -> Some[T] | None: + """Get the default value for the wrapped type. + + Args: + strict: Whether to strictly check types. + context: Additional context to pass to the validator. + + Returns: + The default value wrapped in a `Some` if there is one or None if not. + """ + return self.validator.get_default_value(strict=strict, context=context) + + def dump_python( + self, + __instance: T, + *, + mode: Literal['json', 'python'] = 'python', + include: IncEx | None = None, + exclude: IncEx | None = None, + by_alias: bool = False, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + round_trip: bool = False, + warnings: bool = True, + ) -> Any: + """Dump an instance of the adapted type to a Python object. + + Args: + __instance: The Python object to serialize. + mode: The output format. + include: Fields to include in the output. + exclude: Fields to exclude from the output. + by_alias: Whether to use alias names for field names. + exclude_unset: Whether to exclude unset fields. + exclude_defaults: Whether to exclude fields with default values. + exclude_none: Whether to exclude fields with None values. + round_trip: Whether to output the serialized data in a way that is compatible with deserialization. + warnings: Whether to display serialization warnings. + + Returns: + The serialized object. + """ + return self.serializer.to_python( + __instance, + mode=mode, + by_alias=by_alias, + include=include, + exclude=exclude, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + round_trip=round_trip, + warnings=warnings, + ) + + def dump_json( + self, + __instance: T, + *, + indent: int | None = None, + include: IncEx | None = None, + exclude: IncEx | None = None, + by_alias: bool = False, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + round_trip: bool = False, + warnings: bool = True, + ) -> bytes: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/json/#json-serialization + + Serialize an instance of the adapted type to JSON. + + Args: + __instance: The instance to be serialized. + indent: Number of spaces for JSON indentation. + include: Fields to include. + exclude: Fields to exclude. + by_alias: Whether to use alias names for field names. + exclude_unset: Whether to exclude unset fields. + exclude_defaults: Whether to exclude fields with default values. + exclude_none: Whether to exclude fields with a value of `None`. + round_trip: Whether to serialize and deserialize the instance to ensure round-tripping. + warnings: Whether to emit serialization warnings. + + Returns: + The JSON representation of the given instance as bytes. + """ + return self.serializer.to_json( + __instance, + indent=indent, + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + round_trip=round_trip, + warnings=warnings, + ) + + def json_schema( + self, + *, + by_alias: bool = True, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, + mode: JsonSchemaMode = 'validation', + ) -> dict[str, Any]: + """Generate a JSON schema for the adapted type. + + Args: + by_alias: Whether to use alias names for field names. + ref_template: The format string used for generating $ref strings. + schema_generator: The generator class used for creating the schema. + mode: The mode to use for schema generation. + + Returns: + The JSON schema for the model as a dictionary. + """ + schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template) + return schema_generator_instance.generate(self.core_schema, mode=mode) + + @staticmethod + def json_schemas( + __inputs: Iterable[tuple[JsonSchemaKeyT, JsonSchemaMode, TypeAdapter[Any]]], + *, + by_alias: bool = True, + title: str | None = None, + description: str | None = None, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, + ) -> tuple[dict[tuple[JsonSchemaKeyT, JsonSchemaMode], JsonSchemaValue], JsonSchemaValue]: + """Generate a JSON schema including definitions from multiple type adapters. + + Args: + __inputs: Inputs to schema generation. The first two items will form the keys of the (first) + output mapping; the type adapters will provide the core schemas that get converted into + definitions in the output JSON schema. + by_alias: Whether to use alias names. + title: The title for the schema. + description: The description for the schema. + ref_template: The format string used for generating $ref strings. + schema_generator: The generator class used for creating the schema. + + Returns: + A tuple where: + + - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and + whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have + JsonRef references to definitions that are defined in the second returned element.) + - The second element is a JSON schema containing all definitions referenced in the first returned + element, along with the optional title and description keys. + + """ + schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template) + + inputs = [(key, mode, adapter.core_schema) for key, mode, adapter in __inputs] + + json_schemas_map, definitions = schema_generator_instance.generate_definitions(inputs) + + json_schema: dict[str, Any] = {} + if definitions: + json_schema['$defs'] = definitions + if title: + json_schema['title'] = title + if description: + json_schema['description'] = description + + return json_schemas_map, json_schema diff --git a/lib/pydantic/types.py b/lib/pydantic/types.py index f98dba3d..c2534c88 100644 --- a/lib/pydantic/types.py +++ b/lib/pydantic/types.py @@ -1,12 +1,14 @@ -import abc -import math +"""The types module contains custom types used by pydantic.""" +from __future__ import annotations as _annotations + +import base64 +import dataclasses as _dataclasses import re -import warnings -from datetime import date +from datetime import date, datetime from decimal import Decimal from enum import Enum from pathlib import Path -from types import new_class +from types import ModuleType from typing import ( TYPE_CHECKING, Any, @@ -14,78 +16,56 @@ from typing import ( ClassVar, Dict, FrozenSet, + Generic, + Hashable, + Iterator, List, - Optional, - Pattern, Set, - Tuple, - Type, TypeVar, Union, cast, - overload, ) from uuid import UUID -from weakref import WeakSet -from . import errors -from .datetime_parse import parse_date -from .utils import import_string, update_not_none -from .validators import ( - bytes_validator, - constr_length_validator, - constr_lower, - constr_strip_whitespace, - constr_upper, - decimal_validator, - float_finite_validator, - float_validator, - frozenset_validator, - int_validator, - list_validator, - number_multiple_validator, - number_size_validator, - path_exists_validator, - path_validator, - set_validator, - str_validator, - strict_bytes_validator, - strict_float_validator, - strict_int_validator, - strict_str_validator, +import annotated_types +from annotated_types import BaseMetadata, MaxLen, MinLen +from pydantic_core import CoreSchema, PydanticCustomError, core_schema +from typing_extensions import Annotated, Literal, Protocol, TypeAlias, TypeAliasType, deprecated + +from ._internal import ( + _core_utils, + _fields, + _internal_dataclass, + _typing_extra, + _utils, + _validators, ) +from ._migration import getattr_migration +from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler +from .errors import PydanticUserError +from .json_schema import JsonSchemaValue +from .warnings import PydanticDeprecatedSince20 -__all__ = [ - 'NoneStr', - 'NoneBytes', - 'StrBytes', - 'NoneStrBytes', +__all__ = ( + 'Strict', 'StrictStr', - 'ConstrainedBytes', 'conbytes', - 'ConstrainedList', 'conlist', - 'ConstrainedSet', 'conset', - 'ConstrainedFrozenSet', 'confrozenset', - 'ConstrainedStr', 'constr', - 'PyObject', - 'ConstrainedInt', + 'ImportString', 'conint', 'PositiveInt', 'NegativeInt', 'NonNegativeInt', 'NonPositiveInt', - 'ConstrainedFloat', 'confloat', 'PositiveFloat', 'NegativeFloat', 'NonNegativeFloat', 'NonPositiveFloat', 'FiniteFloat', - 'ConstrainedDecimal', 'condecimal', 'UUID1', 'UUID3', @@ -93,9 +73,8 @@ __all__ = [ 'UUID5', 'FilePath', 'DirectoryPath', + 'NewPath', 'Json', - 'JsonWrapper', - 'SecretField', 'SecretStr', 'SecretBytes', 'StrictBool', @@ -106,845 +85,1512 @@ __all__ = [ 'ByteSize', 'PastDate', 'FutureDate', - 'ConstrainedDate', + 'PastDatetime', + 'FutureDatetime', 'condate', -] + 'AwareDatetime', + 'NaiveDatetime', + 'AllowInfNan', + 'EncoderProtocol', + 'EncodedBytes', + 'EncodedStr', + 'Base64Encoder', + 'Base64Bytes', + 'Base64Str', + 'Base64UrlBytes', + 'Base64UrlStr', + 'GetPydanticSchema', + 'StringConstraints', + 'Tag', + 'Discriminator', + 'JsonValue', + 'OnErrorOmit', +) -NoneStr = Optional[str] -NoneBytes = Optional[bytes] -StrBytes = Union[str, bytes] -NoneStrBytes = Optional[StrBytes] -OptionalInt = Optional[int] -OptionalIntFloat = Union[OptionalInt, float] -OptionalIntFloatDecimal = Union[OptionalIntFloat, Decimal] -OptionalDate = Optional[date] -StrIntFloat = Union[str, int, float] - -if TYPE_CHECKING: - from typing_extensions import Annotated - - from .dataclasses import Dataclass - from .main import BaseModel - from .typing import CallableGenerator - - ModelOrDc = Type[Union[BaseModel, Dataclass]] T = TypeVar('T') -_DEFINED_TYPES: 'WeakSet[type]' = WeakSet() -@overload -def _registered(typ: Type[T]) -> Type[T]: - pass +@_dataclasses.dataclass +class Strict(_fields.PydanticMetadata, BaseMetadata): + """Usage docs: https://docs.pydantic.dev/2.6/concepts/strict_mode/#strict-mode-with-annotated-strict + A field metadata class to indicate that a field should be validated in strict mode. -@overload -def _registered(typ: 'ConstrainedNumberMeta') -> 'ConstrainedNumberMeta': - pass + Attributes: + strict: Whether to validate the field in strict mode. + Example: + ```python + from typing_extensions import Annotated -def _registered(typ: Union[Type[T], 'ConstrainedNumberMeta']) -> Union[Type[T], 'ConstrainedNumberMeta']: - # In order to generate valid examples of constrained types, Hypothesis needs - # to inspect the type object - so we keep a weakref to each contype object - # until it can be registered. When (or if) our Hypothesis plugin is loaded, - # it monkeypatches this function. - # If Hypothesis is never used, the total effect is to keep a weak reference - # which has minimal memory usage and doesn't even affect garbage collection. - _DEFINED_TYPES.add(typ) - return typ + from pydantic.types import Strict + StrictBool = Annotated[bool, Strict()] + ``` + """ -class ConstrainedNumberMeta(type): - def __new__(cls, name: str, bases: Any, dct: Dict[str, Any]) -> 'ConstrainedInt': # type: ignore - new_cls = cast('ConstrainedInt', type.__new__(cls, name, bases, dct)) + strict: bool = True - if new_cls.gt is not None and new_cls.ge is not None: - raise errors.ConfigError('bounds gt and ge cannot be specified at the same time') - if new_cls.lt is not None and new_cls.le is not None: - raise errors.ConfigError('bounds lt and le cannot be specified at the same time') - - return _registered(new_cls) # type: ignore + def __hash__(self) -> int: + return hash(self.strict) # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BOOLEAN TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -if TYPE_CHECKING: - StrictBool = bool -else: - - class StrictBool(int): - """ - StrictBool to allow for bools which are not type-coerced. - """ - - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - field_schema.update(type='boolean') - - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls.validate - - @classmethod - def validate(cls, value: Any) -> bool: - """ - Ensure that we only allow bools. - """ - if isinstance(value, bool): - return value - - raise errors.StrictBoolError() - +StrictBool = Annotated[bool, Strict()] +"""A boolean that must be either ``True`` or ``False``.""" # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTEGER TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -class ConstrainedInt(int, metaclass=ConstrainedNumberMeta): - strict: bool = False - gt: OptionalInt = None - ge: OptionalInt = None - lt: OptionalInt = None - le: OptionalInt = None - multiple_of: OptionalInt = None - - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - update_not_none( - field_schema, - exclusiveMinimum=cls.gt, - exclusiveMaximum=cls.lt, - minimum=cls.ge, - maximum=cls.le, - multipleOf=cls.multiple_of, - ) - - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield strict_int_validator if cls.strict else int_validator - yield number_size_validator - yield number_multiple_validator - - def conint( - *, strict: bool = False, gt: int = None, ge: int = None, lt: int = None, le: int = None, multiple_of: int = None -) -> Type[int]: - # use kwargs then define conf in a dict to aid with IDE type hinting - namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of) - return type('ConstrainedIntValue', (ConstrainedInt,), namespace) + *, + strict: bool | None = None, + gt: int | None = None, + ge: int | None = None, + lt: int | None = None, + le: int | None = None, + multiple_of: int | None = None, +) -> type[int]: + """ + !!! warning "Discouraged" + This function is **discouraged** in favor of using + [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with + [`Field`][pydantic.fields.Field] instead. + + This function will be **deprecated** in Pydantic 3.0. + + The reason is that `conint` returns a type, which doesn't play well with static analysis tools. + + === ":x: Don't do this" + ```py + from pydantic import BaseModel, conint + + class Foo(BaseModel): + bar: conint(strict=True, gt=0) + ``` + + === ":white_check_mark: Do this" + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, Field + + class Foo(BaseModel): + bar: Annotated[int, Field(strict=True, gt=0)] + ``` + + A wrapper around `int` that allows for additional constraints. + + Args: + strict: Whether to validate the integer in strict mode. Defaults to `None`. + gt: The value must be greater than this. + ge: The value must be greater than or equal to this. + lt: The value must be less than this. + le: The value must be less than or equal to this. + multiple_of: The value must be a multiple of this. + + Returns: + The wrapped integer type. + + ```py + from pydantic import BaseModel, ValidationError, conint + + class ConstrainedExample(BaseModel): + constrained_int: conint(gt=1) + + m = ConstrainedExample(constrained_int=2) + print(repr(m)) + #> ConstrainedExample(constrained_int=2) + + try: + ConstrainedExample(constrained_int=0) + except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than', + 'loc': ('constrained_int',), + 'msg': 'Input should be greater than 1', + 'input': 0, + 'ctx': {'gt': 1}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than', + } + ] + ''' + ``` + + """ # noqa: D212 + return Annotated[ + int, + Strict(strict) if strict is not None else None, + annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le), + annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None, + ] -if TYPE_CHECKING: - PositiveInt = int - NegativeInt = int - NonPositiveInt = int - NonNegativeInt = int - StrictInt = int -else: +PositiveInt = Annotated[int, annotated_types.Gt(0)] +"""An integer that must be greater than zero. - class PositiveInt(ConstrainedInt): - gt = 0 +```py +from pydantic import BaseModel, PositiveInt, ValidationError - class NegativeInt(ConstrainedInt): - lt = 0 +class Model(BaseModel): + positive_int: PositiveInt - class NonPositiveInt(ConstrainedInt): - le = 0 +m = Model(positive_int=1) +print(repr(m)) +#> Model(positive_int=1) - class NonNegativeInt(ConstrainedInt): - ge = 0 +try: + Model(positive_int=-1) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than', + 'loc': ('positive_int',), + 'msg': 'Input should be greater than 0', + 'input': -1, + 'ctx': {'gt': 0}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than', + } + ] + ''' +``` +""" +NegativeInt = Annotated[int, annotated_types.Lt(0)] +"""An integer that must be less than zero. - class StrictInt(ConstrainedInt): - strict = True +```py +from pydantic import BaseModel, NegativeInt, ValidationError +class Model(BaseModel): + negative_int: NegativeInt + +m = Model(negative_int=-1) +print(repr(m)) +#> Model(negative_int=-1) + +try: + Model(negative_int=1) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'less_than', + 'loc': ('negative_int',), + 'msg': 'Input should be less than 0', + 'input': 1, + 'ctx': {'lt': 0}, + 'url': 'https://errors.pydantic.dev/2/v/less_than', + } + ] + ''' +``` +""" +NonPositiveInt = Annotated[int, annotated_types.Le(0)] +"""An integer that must be less than or equal to zero. + +```py +from pydantic import BaseModel, NonPositiveInt, ValidationError + +class Model(BaseModel): + non_positive_int: NonPositiveInt + +m = Model(non_positive_int=0) +print(repr(m)) +#> Model(non_positive_int=0) + +try: + Model(non_positive_int=1) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'less_than_equal', + 'loc': ('non_positive_int',), + 'msg': 'Input should be less than or equal to 0', + 'input': 1, + 'ctx': {'le': 0}, + 'url': 'https://errors.pydantic.dev/2/v/less_than_equal', + } + ] + ''' +``` +""" +NonNegativeInt = Annotated[int, annotated_types.Ge(0)] +"""An integer that must be greater than or equal to zero. + +```py +from pydantic import BaseModel, NonNegativeInt, ValidationError + +class Model(BaseModel): + non_negative_int: NonNegativeInt + +m = Model(non_negative_int=0) +print(repr(m)) +#> Model(non_negative_int=0) + +try: + Model(non_negative_int=-1) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than_equal', + 'loc': ('non_negative_int',), + 'msg': 'Input should be greater than or equal to 0', + 'input': -1, + 'ctx': {'ge': 0}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than_equal', + } + ] + ''' +``` +""" +StrictInt = Annotated[int, Strict()] +"""An integer that must be validated in strict mode. + +```py +from pydantic import BaseModel, StrictInt, ValidationError + +class StrictIntModel(BaseModel): + strict_int: StrictInt + +try: + StrictIntModel(strict_int=3.14159) +except ValidationError as e: + print(e) + ''' + 1 validation error for StrictIntModel + strict_int + Input should be a valid integer [type=int_type, input_value=3.14159, input_type=float] + ''' +``` +""" # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ FLOAT TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -class ConstrainedFloat(float, metaclass=ConstrainedNumberMeta): - strict: bool = False - gt: OptionalIntFloat = None - ge: OptionalIntFloat = None - lt: OptionalIntFloat = None - le: OptionalIntFloat = None - multiple_of: OptionalIntFloat = None - allow_inf_nan: Optional[bool] = None +@_dataclasses.dataclass +class AllowInfNan(_fields.PydanticMetadata): + """A field metadata class to indicate that a field should allow ``-inf``, ``inf``, and ``nan``.""" - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - update_not_none( - field_schema, - exclusiveMinimum=cls.gt, - exclusiveMaximum=cls.lt, - minimum=cls.ge, - maximum=cls.le, - multipleOf=cls.multiple_of, - ) - # Modify constraints to account for differences between IEEE floats and JSON - if field_schema.get('exclusiveMinimum') == -math.inf: - del field_schema['exclusiveMinimum'] - if field_schema.get('minimum') == -math.inf: - del field_schema['minimum'] - if field_schema.get('exclusiveMaximum') == math.inf: - del field_schema['exclusiveMaximum'] - if field_schema.get('maximum') == math.inf: - del field_schema['maximum'] + allow_inf_nan: bool = True - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield strict_float_validator if cls.strict else float_validator - yield number_size_validator - yield number_multiple_validator - yield float_finite_validator + def __hash__(self) -> int: + return hash(self.allow_inf_nan) def confloat( *, - strict: bool = False, - gt: float = None, - ge: float = None, - lt: float = None, - le: float = None, - multiple_of: float = None, - allow_inf_nan: Optional[bool] = None, -) -> Type[float]: - # use kwargs then define conf in a dict to aid with IDE type hinting - namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of, allow_inf_nan=allow_inf_nan) - return type('ConstrainedFloatValue', (ConstrainedFloat,), namespace) + strict: bool | None = None, + gt: float | None = None, + ge: float | None = None, + lt: float | None = None, + le: float | None = None, + multiple_of: float | None = None, + allow_inf_nan: bool | None = None, +) -> type[float]: + """ + !!! warning "Discouraged" + This function is **discouraged** in favor of using + [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with + [`Field`][pydantic.fields.Field] instead. + + This function will be **deprecated** in Pydantic 3.0. + + The reason is that `confloat` returns a type, which doesn't play well with static analysis tools. + + === ":x: Don't do this" + ```py + from pydantic import BaseModel, confloat + + class Foo(BaseModel): + bar: confloat(strict=True, gt=0) + ``` + + === ":white_check_mark: Do this" + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, Field + + class Foo(BaseModel): + bar: Annotated[float, Field(strict=True, gt=0)] + ``` + + A wrapper around `float` that allows for additional constraints. + + Args: + strict: Whether to validate the float in strict mode. + gt: The value must be greater than this. + ge: The value must be greater than or equal to this. + lt: The value must be less than this. + le: The value must be less than or equal to this. + multiple_of: The value must be a multiple of this. + allow_inf_nan: Whether to allow `-inf`, `inf`, and `nan`. + + Returns: + The wrapped float type. + + ```py + from pydantic import BaseModel, ValidationError, confloat + + class ConstrainedExample(BaseModel): + constrained_float: confloat(gt=1.0) + + m = ConstrainedExample(constrained_float=1.1) + print(repr(m)) + #> ConstrainedExample(constrained_float=1.1) + + try: + ConstrainedExample(constrained_float=0.9) + except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than', + 'loc': ('constrained_float',), + 'msg': 'Input should be greater than 1', + 'input': 0.9, + 'ctx': {'gt': 1.0}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than', + } + ] + ''' + ``` + """ # noqa: D212 + return Annotated[ + float, + Strict(strict) if strict is not None else None, + annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le), + annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None, + AllowInfNan(allow_inf_nan) if allow_inf_nan is not None else None, + ] -if TYPE_CHECKING: - PositiveFloat = float - NegativeFloat = float - NonPositiveFloat = float - NonNegativeFloat = float - StrictFloat = float - FiniteFloat = float -else: +PositiveFloat = Annotated[float, annotated_types.Gt(0)] +"""A float that must be greater than zero. - class PositiveFloat(ConstrainedFloat): - gt = 0 +```py +from pydantic import BaseModel, PositiveFloat, ValidationError - class NegativeFloat(ConstrainedFloat): - lt = 0 +class Model(BaseModel): + positive_float: PositiveFloat - class NonPositiveFloat(ConstrainedFloat): - le = 0 +m = Model(positive_float=1.0) +print(repr(m)) +#> Model(positive_float=1.0) - class NonNegativeFloat(ConstrainedFloat): - ge = 0 +try: + Model(positive_float=-1.0) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than', + 'loc': ('positive_float',), + 'msg': 'Input should be greater than 0', + 'input': -1.0, + 'ctx': {'gt': 0.0}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than', + } + ] + ''' +``` +""" +NegativeFloat = Annotated[float, annotated_types.Lt(0)] +"""A float that must be less than zero. - class StrictFloat(ConstrainedFloat): - strict = True +```py +from pydantic import BaseModel, NegativeFloat, ValidationError - class FiniteFloat(ConstrainedFloat): - allow_inf_nan = False +class Model(BaseModel): + negative_float: NegativeFloat + +m = Model(negative_float=-1.0) +print(repr(m)) +#> Model(negative_float=-1.0) + +try: + Model(negative_float=1.0) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'less_than', + 'loc': ('negative_float',), + 'msg': 'Input should be less than 0', + 'input': 1.0, + 'ctx': {'lt': 0.0}, + 'url': 'https://errors.pydantic.dev/2/v/less_than', + } + ] + ''' +``` +""" +NonPositiveFloat = Annotated[float, annotated_types.Le(0)] +"""A float that must be less than or equal to zero. + +```py +from pydantic import BaseModel, NonPositiveFloat, ValidationError + +class Model(BaseModel): + non_positive_float: NonPositiveFloat + +m = Model(non_positive_float=0.0) +print(repr(m)) +#> Model(non_positive_float=0.0) + +try: + Model(non_positive_float=1.0) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'less_than_equal', + 'loc': ('non_positive_float',), + 'msg': 'Input should be less than or equal to 0', + 'input': 1.0, + 'ctx': {'le': 0.0}, + 'url': 'https://errors.pydantic.dev/2/v/less_than_equal', + } + ] + ''' +``` +""" +NonNegativeFloat = Annotated[float, annotated_types.Ge(0)] +"""A float that must be greater than or equal to zero. + +```py +from pydantic import BaseModel, NonNegativeFloat, ValidationError + +class Model(BaseModel): + non_negative_float: NonNegativeFloat + +m = Model(non_negative_float=0.0) +print(repr(m)) +#> Model(non_negative_float=0.0) + +try: + Model(non_negative_float=-1.0) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than_equal', + 'loc': ('non_negative_float',), + 'msg': 'Input should be greater than or equal to 0', + 'input': -1.0, + 'ctx': {'ge': 0.0}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than_equal', + } + ] + ''' +``` +""" +StrictFloat = Annotated[float, Strict(True)] +"""A float that must be validated in strict mode. + +```py +from pydantic import BaseModel, StrictFloat, ValidationError + +class StrictFloatModel(BaseModel): + strict_float: StrictFloat + +try: + StrictFloatModel(strict_float='1.0') +except ValidationError as e: + print(e) + ''' + 1 validation error for StrictFloatModel + strict_float + Input should be a valid number [type=float_type, input_value='1.0', input_type=str] + ''' +``` +""" +FiniteFloat = Annotated[float, AllowInfNan(False)] +"""A float that must be finite (not ``-inf``, ``inf``, or ``nan``). + +```py +from pydantic import BaseModel, FiniteFloat + +class Model(BaseModel): + finite: FiniteFloat + +m = Model(finite=1.0) +print(m) +#> finite=1.0 +``` +""" # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTES TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -class ConstrainedBytes(bytes): - strip_whitespace = False - to_upper = False - to_lower = False - min_length: OptionalInt = None - max_length: OptionalInt = None - strict: bool = False - - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length) - - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield strict_bytes_validator if cls.strict else bytes_validator - yield constr_strip_whitespace - yield constr_upper - yield constr_lower - yield constr_length_validator - - def conbytes( *, - strip_whitespace: bool = False, - to_upper: bool = False, - to_lower: bool = False, - min_length: int = None, - max_length: int = None, - strict: bool = False, -) -> Type[bytes]: - # use kwargs then define conf in a dict to aid with IDE type hinting - namespace = dict( - strip_whitespace=strip_whitespace, - to_upper=to_upper, - to_lower=to_lower, - min_length=min_length, - max_length=max_length, - strict=strict, - ) - return _registered(type('ConstrainedBytesValue', (ConstrainedBytes,), namespace)) + min_length: int | None = None, + max_length: int | None = None, + strict: bool | None = None, +) -> type[bytes]: + """A wrapper around `bytes` that allows for additional constraints. + + Args: + min_length: The minimum length of the bytes. + max_length: The maximum length of the bytes. + strict: Whether to validate the bytes in strict mode. + + Returns: + The wrapped bytes type. + """ + return Annotated[ + bytes, + Strict(strict) if strict is not None else None, + annotated_types.Len(min_length or 0, max_length), + ] -if TYPE_CHECKING: - StrictBytes = bytes -else: - - class StrictBytes(ConstrainedBytes): - strict = True +StrictBytes = Annotated[bytes, Strict()] +"""A bytes that must be validated in strict mode.""" # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ STRING TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -class ConstrainedStr(str): - strip_whitespace = False - to_upper = False - to_lower = False - min_length: OptionalInt = None - max_length: OptionalInt = None - curtail_length: OptionalInt = None - regex: Optional[Pattern[str]] = None - strict = False +@_dataclasses.dataclass(frozen=True) +class StringConstraints(annotated_types.GroupedMetadata): + """Usage docs: https://docs.pydantic.dev/2.6/concepts/fields/#string-constraints - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - update_not_none( - field_schema, - minLength=cls.min_length, - maxLength=cls.max_length, - pattern=cls.regex and cls.regex.pattern, - ) + Apply constraints to `str` types. - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield strict_str_validator if cls.strict else str_validator - yield constr_strip_whitespace - yield constr_upper - yield constr_lower - yield constr_length_validator - yield cls.validate + Attributes: + strip_whitespace: Whether to strip whitespace from the string. + to_upper: Whether to convert the string to uppercase. + to_lower: Whether to convert the string to lowercase. + strict: Whether to validate the string in strict mode. + min_length: The minimum length of the string. + max_length: The maximum length of the string. + pattern: A regex pattern that the string must match. + """ - @classmethod - def validate(cls, value: Union[str]) -> Union[str]: - if cls.curtail_length and len(value) > cls.curtail_length: - value = value[: cls.curtail_length] + strip_whitespace: bool | None = None + to_upper: bool | None = None + to_lower: bool | None = None + strict: bool | None = None + min_length: int | None = None + max_length: int | None = None + pattern: str | None = None - if cls.regex: - if not cls.regex.match(value): - raise errors.StrRegexError(pattern=cls.regex.pattern) - - return value + def __iter__(self) -> Iterator[BaseMetadata]: + if self.min_length is not None: + yield MinLen(self.min_length) + if self.max_length is not None: + yield MaxLen(self.max_length) + if self.strict is not None: + yield Strict() + if ( + self.strip_whitespace is not None + or self.pattern is not None + or self.to_lower is not None + or self.to_upper is not None + ): + yield _fields.pydantic_general_metadata( + strip_whitespace=self.strip_whitespace, + to_upper=self.to_upper, + to_lower=self.to_lower, + pattern=self.pattern, + ) def constr( *, - strip_whitespace: bool = False, - to_upper: bool = False, - to_lower: bool = False, - strict: bool = False, - min_length: int = None, - max_length: int = None, - curtail_length: int = None, - regex: str = None, -) -> Type[str]: - # use kwargs then define conf in a dict to aid with IDE type hinting - namespace = dict( - strip_whitespace=strip_whitespace, - to_upper=to_upper, - to_lower=to_lower, - strict=strict, - min_length=min_length, - max_length=max_length, - curtail_length=curtail_length, - regex=regex and re.compile(regex), - ) - return _registered(type('ConstrainedStrValue', (ConstrainedStr,), namespace)) + strip_whitespace: bool | None = None, + to_upper: bool | None = None, + to_lower: bool | None = None, + strict: bool | None = None, + min_length: int | None = None, + max_length: int | None = None, + pattern: str | None = None, +) -> type[str]: + """ + !!! warning "Discouraged" + This function is **discouraged** in favor of using + [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with + [`StringConstraints`][pydantic.types.StringConstraints] instead. + + This function will be **deprecated** in Pydantic 3.0. + + The reason is that `constr` returns a type, which doesn't play well with static analysis tools. + + === ":x: Don't do this" + ```py + from pydantic import BaseModel, constr + + class Foo(BaseModel): + bar: constr(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$') + ``` + + === ":white_check_mark: Do this" + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, StringConstraints + + class Foo(BaseModel): + bar: Annotated[str, StringConstraints(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$')] + ``` + + A wrapper around `str` that allows for additional constraints. + + ```py + from pydantic import BaseModel, constr + + class Foo(BaseModel): + bar: constr(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$') -if TYPE_CHECKING: - StrictStr = str -else: + foo = Foo(bar=' hello ') + print(foo) + #> bar='HELLO' + ``` - class StrictStr(ConstrainedStr): - strict = True + Args: + strip_whitespace: Whether to remove leading and trailing whitespace. + to_upper: Whether to turn all characters to uppercase. + to_lower: Whether to turn all characters to lowercase. + strict: Whether to validate the string in strict mode. + min_length: The minimum length of the string. + max_length: The maximum length of the string. + pattern: A regex pattern to validate the string against. + + Returns: + The wrapped string type. + """ # noqa: D212 + return Annotated[ + str, + StringConstraints( + strip_whitespace=strip_whitespace, + to_upper=to_upper, + to_lower=to_lower, + strict=strict, + min_length=min_length, + max_length=max_length, + pattern=pattern, + ), + ] -# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -# This types superclass should be Set[T], but cython chokes on that... -class ConstrainedSet(set): # type: ignore - # Needed for pydantic to detect that this is a set - __origin__ = set - __args__: Set[Type[T]] # type: ignore - - min_items: Optional[int] = None - max_items: Optional[int] = None - item_type: Type[T] # type: ignore - - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls.set_length_validator - - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items) - - @classmethod - def set_length_validator(cls, v: 'Optional[Set[T]]') -> 'Optional[Set[T]]': - if v is None: - return None - - v = set_validator(v) - v_len = len(v) - - if cls.min_items is not None and v_len < cls.min_items: - raise errors.SetMinLengthError(limit_value=cls.min_items) - - if cls.max_items is not None and v_len > cls.max_items: - raise errors.SetMaxLengthError(limit_value=cls.max_items) - - return v +StrictStr = Annotated[str, Strict()] +"""A string that must be validated in strict mode.""" -def conset(item_type: Type[T], *, min_items: int = None, max_items: int = None) -> Type[Set[T]]: - # __args__ is needed to conform to typing generics api - namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]} - # We use new_class to be able to deal with Generic types - return new_class('ConstrainedSetValue', (ConstrainedSet,), {}, lambda ns: ns.update(namespace)) +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~ COLLECTION TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +HashableItemType = TypeVar('HashableItemType', bound=Hashable) -# This types superclass should be FrozenSet[T], but cython chokes on that... -class ConstrainedFrozenSet(frozenset): # type: ignore - # Needed for pydantic to detect that this is a set - __origin__ = frozenset - __args__: FrozenSet[Type[T]] # type: ignore +def conset( + item_type: type[HashableItemType], *, min_length: int | None = None, max_length: int | None = None +) -> type[set[HashableItemType]]: + """A wrapper around `typing.Set` that allows for additional constraints. - min_items: Optional[int] = None - max_items: Optional[int] = None - item_type: Type[T] # type: ignore + Args: + item_type: The type of the items in the set. + min_length: The minimum length of the set. + max_length: The maximum length of the set. - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls.frozenset_length_validator - - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items) - - @classmethod - def frozenset_length_validator(cls, v: 'Optional[FrozenSet[T]]') -> 'Optional[FrozenSet[T]]': - if v is None: - return None - - v = frozenset_validator(v) - v_len = len(v) - - if cls.min_items is not None and v_len < cls.min_items: - raise errors.FrozenSetMinLengthError(limit_value=cls.min_items) - - if cls.max_items is not None and v_len > cls.max_items: - raise errors.FrozenSetMaxLengthError(limit_value=cls.max_items) - - return v + Returns: + The wrapped set type. + """ + return Annotated[Set[item_type], annotated_types.Len(min_length or 0, max_length)] -def confrozenset(item_type: Type[T], *, min_items: int = None, max_items: int = None) -> Type[FrozenSet[T]]: - # __args__ is needed to conform to typing generics api - namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]} - # We use new_class to be able to deal with Generic types - return new_class('ConstrainedFrozenSetValue', (ConstrainedFrozenSet,), {}, lambda ns: ns.update(namespace)) +def confrozenset( + item_type: type[HashableItemType], *, min_length: int | None = None, max_length: int | None = None +) -> type[frozenset[HashableItemType]]: + """A wrapper around `typing.FrozenSet` that allows for additional constraints. + + Args: + item_type: The type of the items in the frozenset. + min_length: The minimum length of the frozenset. + max_length: The maximum length of the frozenset. + + Returns: + The wrapped frozenset type. + """ + return Annotated[FrozenSet[item_type], annotated_types.Len(min_length or 0, max_length)] -# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ LIST TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -# This types superclass should be List[T], but cython chokes on that... -class ConstrainedList(list): # type: ignore - # Needed for pydantic to detect that this is a list - __origin__ = list - __args__: Tuple[Type[T], ...] # type: ignore - - min_items: Optional[int] = None - max_items: Optional[int] = None - unique_items: Optional[bool] = None - item_type: Type[T] # type: ignore - - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls.list_length_validator - if cls.unique_items: - yield cls.unique_items_validator - - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items, uniqueItems=cls.unique_items) - - @classmethod - def list_length_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]': - if v is None: - return None - - v = list_validator(v) - v_len = len(v) - - if cls.min_items is not None and v_len < cls.min_items: - raise errors.ListMinLengthError(limit_value=cls.min_items) - - if cls.max_items is not None and v_len > cls.max_items: - raise errors.ListMaxLengthError(limit_value=cls.max_items) - - return v - - @classmethod - def unique_items_validator(cls, v: 'List[T]') -> 'List[T]': - for i, value in enumerate(v, start=1): - if value in v[i:]: - raise errors.ListUniqueItemsError() - - return v +AnyItemType = TypeVar('AnyItemType') def conlist( - item_type: Type[T], *, min_items: int = None, max_items: int = None, unique_items: bool = None -) -> Type[List[T]]: - # __args__ is needed to conform to typing generics api - namespace = dict( - min_items=min_items, max_items=max_items, unique_items=unique_items, item_type=item_type, __args__=(item_type,) - ) - # We use new_class to be able to deal with Generic types - return new_class('ConstrainedListValue', (ConstrainedList,), {}, lambda ns: ns.update(namespace)) + item_type: type[AnyItemType], + *, + min_length: int | None = None, + max_length: int | None = None, + unique_items: bool | None = None, +) -> type[list[AnyItemType]]: + """A wrapper around typing.List that adds validation. + + Args: + item_type: The type of the items in the list. + min_length: The minimum length of the list. Defaults to None. + max_length: The maximum length of the list. Defaults to None. + unique_items: Whether the items in the list must be unique. Defaults to None. + !!! warning Deprecated + The `unique_items` parameter is deprecated, use `Set` instead. + See [this issue](https://github.com/pydantic/pydantic-core/issues/296) for more details. + + Returns: + The wrapped list type. + """ + if unique_items is not None: + raise PydanticUserError( + ( + '`unique_items` is removed, use `Set` instead' + '(this feature is discussed in https://github.com/pydantic/pydantic-core/issues/296)' + ), + code='removed-kwargs', + ) + return Annotated[List[item_type], annotated_types.Len(min_length or 0, max_length)] -# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PYOBJECT TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - +# ~~~~~~~~~~~~~~~~~~~~~~~~~~ IMPORT STRING TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +AnyType = TypeVar('AnyType') if TYPE_CHECKING: - PyObject = Callable[..., Any] + ImportString = Annotated[AnyType, ...] else: - class PyObject: - validate_always = True + class ImportString: + """A type that can be used to import a type from a string. + + `ImportString` expects a string and loads the Python object importable at that dotted path. + Attributes of modules may be separated from the module by `:` or `.`, e.g. if `'math:cos'` was provided, + the resulting field value would be the function`cos`. If a `.` is used and both an attribute and submodule + are present at the same path, the module will be preferred. + + On model instantiation, pointers will be evaluated and imported. There is + some nuance to this behavior, demonstrated in the examples below. + + **Good behavior:** + ```py + from math import cos + + from pydantic import BaseModel, Field, ImportString, ValidationError + + + class ImportThings(BaseModel): + obj: ImportString + + + # A string value will cause an automatic import + my_cos = ImportThings(obj='math.cos') + + # You can use the imported function as you would expect + cos_of_0 = my_cos.obj(0) + assert cos_of_0 == 1 + + + # A string whose value cannot be imported will raise an error + try: + ImportThings(obj='foo.bar') + except ValidationError as e: + print(e) + ''' + 1 validation error for ImportThings + obj + Invalid python path: No module named 'foo.bar' [type=import_error, input_value='foo.bar', input_type=str] + ''' + + + # Actual python objects can be assigned as well + my_cos = ImportThings(obj=cos) + my_cos_2 = ImportThings(obj='math.cos') + my_cos_3 = ImportThings(obj='math:cos') + assert my_cos == my_cos_2 == my_cos_3 + + + # You can set default field value either as Python object: + class ImportThingsDefaultPyObj(BaseModel): + obj: ImportString = math.cos + + + # or as a string value (but only if used with `validate_default=True`) + class ImportThingsDefaultString(BaseModel): + obj: ImportString = Field(default='math.cos', validate_default=True) + + + my_cos_default1 = ImportThingsDefaultPyObj() + my_cos_default2 = ImportThingsDefaultString() + assert my_cos_default1.obj == my_cos_default2.obj == math.cos + + + # note: this will not work! + class ImportThingsMissingValidateDefault(BaseModel): + obj: ImportString = 'math.cos' + + my_cos_default3 = ImportThingsMissingValidateDefault() + assert my_cos_default3.obj == 'math.cos' # just string, not evaluated + ``` + + Serializing an `ImportString` type to json is also possible. + + ```py + from pydantic import BaseModel, ImportString + + + class ImportThings(BaseModel): + obj: ImportString + + + # Create an instance + m = ImportThings(obj='math.cos') + print(m) + #> obj= + print(m.model_dump_json()) + #> {"obj":"math.cos"} + ``` + """ @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls.validate + def __class_getitem__(cls, item: AnyType) -> AnyType: + return Annotated[item, cls()] @classmethod - def validate(cls, value: Any) -> Any: - if isinstance(value, Callable): - return value + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + serializer = core_schema.plain_serializer_function_ser_schema(cls._serialize, when_used='json') + if cls is source: + # Treat bare usage of ImportString (`schema is None`) as the same as ImportString[Any] + return core_schema.no_info_plain_validator_function( + function=_validators.import_string, serialization=serializer + ) + else: + return core_schema.no_info_before_validator_function( + function=_validators.import_string, schema=handler(source), serialization=serializer + ) - try: - value = str_validator(value) - except errors.StrError: - raise errors.PyObjectError(error_message='value is neither a valid import path not a valid callable') + @staticmethod + def _serialize(v: Any) -> str: + if isinstance(v, ModuleType): + return v.__name__ + elif hasattr(v, '__module__') and hasattr(v, '__name__'): + return f'{v.__module__}.{v.__name__}' + else: + return v - try: - return import_string(value) - except ImportError as e: - raise errors.PyObjectError(error_message=str(e)) + def __repr__(self) -> str: + return 'ImportString' # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DECIMAL TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -class ConstrainedDecimal(Decimal, metaclass=ConstrainedNumberMeta): - gt: OptionalIntFloatDecimal = None - ge: OptionalIntFloatDecimal = None - lt: OptionalIntFloatDecimal = None - le: OptionalIntFloatDecimal = None - max_digits: OptionalInt = None - decimal_places: OptionalInt = None - multiple_of: OptionalIntFloatDecimal = None - - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - update_not_none( - field_schema, - exclusiveMinimum=cls.gt, - exclusiveMaximum=cls.lt, - minimum=cls.ge, - maximum=cls.le, - multipleOf=cls.multiple_of, - ) - - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield decimal_validator - yield number_size_validator - yield number_multiple_validator - yield cls.validate - - @classmethod - def validate(cls, value: Decimal) -> Decimal: - digit_tuple, exponent = value.as_tuple()[1:] - if exponent in {'F', 'n', 'N'}: - raise errors.DecimalIsNotFiniteError() - - if exponent >= 0: - # A positive exponent adds that many trailing zeros. - digits = len(digit_tuple) + exponent - decimals = 0 - else: - # If the absolute value of the negative exponent is larger than the - # number of digits, then it's the same as the number of digits, - # because it'll consume all of the digits in digit_tuple and then - # add abs(exponent) - len(digit_tuple) leading zeros after the - # decimal point. - if abs(exponent) > len(digit_tuple): - digits = decimals = abs(exponent) - else: - digits = len(digit_tuple) - decimals = abs(exponent) - whole_digits = digits - decimals - - if cls.max_digits is not None and digits > cls.max_digits: - raise errors.DecimalMaxDigitsError(max_digits=cls.max_digits) - - if cls.decimal_places is not None and decimals > cls.decimal_places: - raise errors.DecimalMaxPlacesError(decimal_places=cls.decimal_places) - - if cls.max_digits is not None and cls.decimal_places is not None: - expected = cls.max_digits - cls.decimal_places - if whole_digits > expected: - raise errors.DecimalWholeDigitsError(whole_digits=expected) - - return value - - def condecimal( *, - gt: Decimal = None, - ge: Decimal = None, - lt: Decimal = None, - le: Decimal = None, - max_digits: int = None, - decimal_places: int = None, - multiple_of: Decimal = None, -) -> Type[Decimal]: - # use kwargs then define conf in a dict to aid with IDE type hinting - namespace = dict( - gt=gt, ge=ge, lt=lt, le=le, max_digits=max_digits, decimal_places=decimal_places, multiple_of=multiple_of - ) - return type('ConstrainedDecimalValue', (ConstrainedDecimal,), namespace) + strict: bool | None = None, + gt: int | Decimal | None = None, + ge: int | Decimal | None = None, + lt: int | Decimal | None = None, + le: int | Decimal | None = None, + multiple_of: int | Decimal | None = None, + max_digits: int | None = None, + decimal_places: int | None = None, + allow_inf_nan: bool | None = None, +) -> type[Decimal]: + """ + !!! warning "Discouraged" + This function is **discouraged** in favor of using + [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with + [`Field`][pydantic.fields.Field] instead. + + This function will be **deprecated** in Pydantic 3.0. + + The reason is that `condecimal` returns a type, which doesn't play well with static analysis tools. + + === ":x: Don't do this" + ```py + from pydantic import BaseModel, condecimal + + class Foo(BaseModel): + bar: condecimal(strict=True, allow_inf_nan=True) + ``` + + === ":white_check_mark: Do this" + ```py + from decimal import Decimal + + from typing_extensions import Annotated + + from pydantic import BaseModel, Field + + class Foo(BaseModel): + bar: Annotated[Decimal, Field(strict=True, allow_inf_nan=True)] + ``` + + A wrapper around Decimal that adds validation. + + Args: + strict: Whether to validate the value in strict mode. Defaults to `None`. + gt: The value must be greater than this. Defaults to `None`. + ge: The value must be greater than or equal to this. Defaults to `None`. + lt: The value must be less than this. Defaults to `None`. + le: The value must be less than or equal to this. Defaults to `None`. + multiple_of: The value must be a multiple of this. Defaults to `None`. + max_digits: The maximum number of digits. Defaults to `None`. + decimal_places: The number of decimal places. Defaults to `None`. + allow_inf_nan: Whether to allow infinity and NaN. Defaults to `None`. + + ```py + from decimal import Decimal + + from pydantic import BaseModel, ValidationError, condecimal + + class ConstrainedExample(BaseModel): + constrained_decimal: condecimal(gt=Decimal('1.0')) + + m = ConstrainedExample(constrained_decimal=Decimal('1.1')) + print(repr(m)) + #> ConstrainedExample(constrained_decimal=Decimal('1.1')) + + try: + ConstrainedExample(constrained_decimal=Decimal('0.9')) + except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than', + 'loc': ('constrained_decimal',), + 'msg': 'Input should be greater than 1.0', + 'input': Decimal('0.9'), + 'ctx': {'gt': Decimal('1.0')}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than', + } + ] + ''' + ``` + """ # noqa: D212 + return Annotated[ + Decimal, + Strict(strict) if strict is not None else None, + annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le), + annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None, + _fields.pydantic_general_metadata(max_digits=max_digits, decimal_places=decimal_places), + AllowInfNan(allow_inf_nan) if allow_inf_nan is not None else None, + ] # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ UUID TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -if TYPE_CHECKING: - UUID1 = UUID - UUID3 = UUID - UUID4 = UUID - UUID5 = UUID -else: - class UUID1(UUID): - _required_version = 1 +@_dataclasses.dataclass(**_internal_dataclass.slots_true) +class UuidVersion: + """A field metadata class to indicate a [UUID](https://docs.python.org/3/library/uuid.html) version.""" - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - field_schema.update(type='string', format=f'uuid{cls._required_version}') + uuid_version: Literal[1, 3, 4, 5] - class UUID3(UUID1): - _required_version = 3 + def __get_pydantic_json_schema__( + self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = handler(core_schema) + field_schema.pop('anyOf', None) # remove the bytes/str union + field_schema.update(type='string', format=f'uuid{self.uuid_version}') + return field_schema - class UUID4(UUID1): - _required_version = 4 + def __get_pydantic_core_schema__(self, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + if isinstance(self, source): + # used directly as a type + return core_schema.uuid_schema(version=self.uuid_version) + else: + # update existing schema with self.uuid_version + schema = handler(source) + _check_annotated_type(schema['type'], 'uuid', self.__class__.__name__) + schema['version'] = self.uuid_version # type: ignore + return schema - class UUID5(UUID1): - _required_version = 5 + def __hash__(self) -> int: + return hash(type(self.uuid_version)) + + +UUID1 = Annotated[UUID, UuidVersion(1)] +"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 1. + +```py +import uuid + +from pydantic import UUID1, BaseModel + +class Model(BaseModel): + uuid1: UUID1 + +Model(uuid1=uuid.uuid1()) +``` +""" +UUID3 = Annotated[UUID, UuidVersion(3)] +"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 3. + +```py +import uuid + +from pydantic import UUID3, BaseModel + +class Model(BaseModel): + uuid3: UUID3 + +Model(uuid3=uuid.uuid3(uuid.NAMESPACE_DNS, 'pydantic.org')) +``` +""" +UUID4 = Annotated[UUID, UuidVersion(4)] +"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 4. + +```py +import uuid + +from pydantic import UUID4, BaseModel + +class Model(BaseModel): + uuid4: UUID4 + +Model(uuid4=uuid.uuid4()) +``` +""" +UUID5 = Annotated[UUID, UuidVersion(5)] +"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 5. + +```py +import uuid + +from pydantic import UUID5, BaseModel + +class Model(BaseModel): + uuid5: UUID5 + +Model(uuid5=uuid.uuid5(uuid.NAMESPACE_DNS, 'pydantic.org')) +``` +""" # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PATH TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -if TYPE_CHECKING: - FilePath = Path - DirectoryPath = Path -else: - class FilePath(Path): - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - field_schema.update(format='file-path') +@_dataclasses.dataclass +class PathType: + path_type: Literal['file', 'dir', 'new'] - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield path_validator - yield path_exists_validator - yield cls.validate + def __get_pydantic_json_schema__( + self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = handler(core_schema) + format_conversion = {'file': 'file-path', 'dir': 'directory-path'} + field_schema.update(format=format_conversion.get(self.path_type, 'path'), type='string') + return field_schema - @classmethod - def validate(cls, value: Path) -> Path: - if not value.is_file(): - raise errors.PathNotAFileError(path=value) + def __get_pydantic_core_schema__(self, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + function_lookup = { + 'file': cast(core_schema.WithInfoValidatorFunction, self.validate_file), + 'dir': cast(core_schema.WithInfoValidatorFunction, self.validate_directory), + 'new': cast(core_schema.WithInfoValidatorFunction, self.validate_new), + } - return value + return core_schema.with_info_after_validator_function( + function_lookup[self.path_type], + handler(source), + ) - class DirectoryPath(Path): - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - field_schema.update(format='directory-path') + @staticmethod + def validate_file(path: Path, _: core_schema.ValidationInfo) -> Path: + if path.is_file(): + return path + else: + raise PydanticCustomError('path_not_file', 'Path does not point to a file') - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield path_validator - yield path_exists_validator - yield cls.validate + @staticmethod + def validate_directory(path: Path, _: core_schema.ValidationInfo) -> Path: + if path.is_dir(): + return path + else: + raise PydanticCustomError('path_not_directory', 'Path does not point to a directory') - @classmethod - def validate(cls, value: Path) -> Path: - if not value.is_dir(): - raise errors.PathNotADirectoryError(path=value) + @staticmethod + def validate_new(path: Path, _: core_schema.ValidationInfo) -> Path: + if path.exists(): + raise PydanticCustomError('path_exists', 'Path already exists') + elif not path.parent.exists(): + raise PydanticCustomError('parent_does_not_exist', 'Parent directory does not exist') + else: + return path - return value + def __hash__(self) -> int: + return hash(type(self.path_type)) + + +FilePath = Annotated[Path, PathType('file')] +"""A path that must point to a file. + +```py +from pathlib import Path + +from pydantic import BaseModel, FilePath, ValidationError + +class Model(BaseModel): + f: FilePath + +path = Path('text.txt') +path.touch() +m = Model(f='text.txt') +print(m.model_dump()) +#> {'f': PosixPath('text.txt')} +path.unlink() + +path = Path('directory') +path.mkdir(exist_ok=True) +try: + Model(f='directory') # directory +except ValidationError as e: + print(e) + ''' + 1 validation error for Model + f + Path does not point to a file [type=path_not_file, input_value='directory', input_type=str] + ''' +path.rmdir() + +try: + Model(f='not-exists-file') +except ValidationError as e: + print(e) + ''' + 1 validation error for Model + f + Path does not point to a file [type=path_not_file, input_value='not-exists-file', input_type=str] + ''' +``` +""" +DirectoryPath = Annotated[Path, PathType('dir')] +"""A path that must point to a directory. + +```py +from pathlib import Path + +from pydantic import BaseModel, DirectoryPath, ValidationError + +class Model(BaseModel): + f: DirectoryPath + +path = Path('directory/') +path.mkdir() +m = Model(f='directory/') +print(m.model_dump()) +#> {'f': PosixPath('directory')} +path.rmdir() + +path = Path('file.txt') +path.touch() +try: + Model(f='file.txt') # file +except ValidationError as e: + print(e) + ''' + 1 validation error for Model + f + Path does not point to a directory [type=path_not_directory, input_value='file.txt', input_type=str] + ''' +path.unlink() + +try: + Model(f='not-exists-directory') +except ValidationError as e: + print(e) + ''' + 1 validation error for Model + f + Path does not point to a directory [type=path_not_directory, input_value='not-exists-directory', input_type=str] + ''' +``` +""" +NewPath = Annotated[Path, PathType('new')] +"""A path for a new file or directory that must not already exist.""" # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ JSON TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -class JsonWrapper: - pass - - -class JsonMeta(type): - def __getitem__(self, t: Type[Any]) -> Type[JsonWrapper]: - if t is Any: - return Json # allow Json[Any] to replecate plain Json - return _registered(type('JsonWrapperValue', (JsonWrapper,), {'inner_type': t})) - - if TYPE_CHECKING: - Json = Annotated[T, ...] # Json[list[str]] will be recognized by type checkers as list[str] + Json = Annotated[AnyType, ...] # Json[list[str]] will be recognized by type checkers as list[str] else: - class Json(metaclass=JsonMeta): + class Json: + """A special type wrapper which loads JSON before parsing. + + You can use the `Json` data type to make Pydantic first load a raw JSON string before + validating the loaded data into the parametrized type: + + ```py + from typing import Any, List + + from pydantic import BaseModel, Json, ValidationError + + + class AnyJsonModel(BaseModel): + json_obj: Json[Any] + + + class ConstrainedJsonModel(BaseModel): + json_obj: Json[List[int]] + + + print(AnyJsonModel(json_obj='{"b": 1}')) + #> json_obj={'b': 1} + print(ConstrainedJsonModel(json_obj='[1, 2, 3]')) + #> json_obj=[1, 2, 3] + + try: + ConstrainedJsonModel(json_obj=12) + except ValidationError as e: + print(e) + ''' + 1 validation error for ConstrainedJsonModel + json_obj + JSON input should be string, bytes or bytearray [type=json_type, input_value=12, input_type=int] + ''' + + try: + ConstrainedJsonModel(json_obj='[a, b]') + except ValidationError as e: + print(e) + ''' + 1 validation error for ConstrainedJsonModel + json_obj + Invalid JSON: expected value at line 1 column 2 [type=json_invalid, input_value='[a, b]', input_type=str] + ''' + + try: + ConstrainedJsonModel(json_obj='["a", "b"]') + except ValidationError as e: + print(e) + ''' + 2 validation errors for ConstrainedJsonModel + json_obj.0 + Input should be a valid integer, unable to parse string as an integer [type=int_parsing, input_value='a', input_type=str] + json_obj.1 + Input should be a valid integer, unable to parse string as an integer [type=int_parsing, input_value='b', input_type=str] + ''' + ``` + + When you dump the model using `model_dump` or `model_dump_json`, the dumped value will be the result of validation, + not the original JSON string. However, you can use the argument `round_trip=True` to get the original JSON string back: + + ```py + from typing import List + + from pydantic import BaseModel, Json + + + class ConstrainedJsonModel(BaseModel): + json_obj: Json[List[int]] + + + print(ConstrainedJsonModel(json_obj='[1, 2, 3]').model_dump_json()) + #> {"json_obj":[1,2,3]} + print( + ConstrainedJsonModel(json_obj='[1, 2, 3]').model_dump_json(round_trip=True) + ) + #> {"json_obj":"[1,2,3]"} + ``` + """ + @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - field_schema.update(type='string', format='json-string') + def __class_getitem__(cls, item: AnyType) -> AnyType: + return Annotated[item, cls()] + + @classmethod + def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + if cls is source: + return core_schema.json_schema(None) + else: + return core_schema.json_schema(handler(source)) + + def __repr__(self) -> str: + return 'Json' + + def __hash__(self) -> int: + return hash(type(self)) + + def __eq__(self, other: Any) -> bool: + return type(other) == type(self) # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SECRET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +SecretType = TypeVar('SecretType', str, bytes) -class SecretField(abc.ABC): - """ - Note: this should be implemented as a generic like `SecretField(ABC, Generic[T])`, - the `__init__()` should be part of the abstract class and the - `get_secret_value()` method should use the generic `T` type. - However Cython doesn't support very well generics at the moment and - the generated code fails to be imported (see - https://github.com/cython/cython/issues/2753). - """ +class _SecretField(Generic[SecretType]): + def __init__(self, secret_value: SecretType) -> None: + self._secret_value: SecretType = secret_value + + def get_secret_value(self) -> SecretType: + """Get the secret value. + + Returns: + The secret value. + """ + return self._secret_value def __eq__(self, other: Any) -> bool: return isinstance(other, self.__class__) and self.get_secret_value() == other.get_secret_value() - def __str__(self) -> str: - return '**********' if self.get_secret_value() else '' - def __hash__(self) -> int: return hash(self.get_secret_value()) - @abc.abstractmethod - def get_secret_value(self) -> Any: # pragma: no cover - ... - - -class SecretStr(SecretField): - min_length: OptionalInt = None - max_length: OptionalInt = None - - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - update_not_none( - field_schema, - type='string', - writeOnly=True, - format='password', - minLength=cls.min_length, - maxLength=cls.max_length, - ) - - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls.validate - yield constr_length_validator - - @classmethod - def validate(cls, value: Any) -> 'SecretStr': - if isinstance(value, cls): - return value - value = str_validator(value) - return cls(value) - - def __init__(self, value: str): - self._secret_value = value - - def __repr__(self) -> str: - return f"SecretStr('{self}')" - def __len__(self) -> int: return len(self._secret_value) - def display(self) -> str: - warnings.warn('`secret_str.display()` is deprecated, use `str(secret_str)` instead', DeprecationWarning) - return str(self) - - def get_secret_value(self) -> str: - return self._secret_value - - -class SecretBytes(SecretField): - min_length: OptionalInt = None - max_length: OptionalInt = None - - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - update_not_none( - field_schema, - type='string', - writeOnly=True, - format='password', - minLength=cls.min_length, - maxLength=cls.max_length, - ) - - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls.validate - yield constr_length_validator - - @classmethod - def validate(cls, value: Any) -> 'SecretBytes': - if isinstance(value, cls): - return value - value = bytes_validator(value) - return cls(value) - - def __init__(self, value: bytes): - self._secret_value = value + def __str__(self) -> str: + return str(self._display()) def __repr__(self) -> str: - return f"SecretBytes(b'{self}')" + return f'{self.__class__.__name__}({self._display()!r})' - def __len__(self) -> int: - return len(self._secret_value) + def _display(self) -> SecretType: + raise NotImplementedError - def display(self) -> str: - warnings.warn('`secret_bytes.display()` is deprecated, use `str(secret_bytes)` instead', DeprecationWarning) - return str(self) + @classmethod + def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + if issubclass(source, SecretStr): + field_type = str + inner_schema = core_schema.str_schema() + else: + assert issubclass(source, SecretBytes) + field_type = bytes + inner_schema = core_schema.bytes_schema() + error_kind = 'string_type' if field_type is str else 'bytes_type' - def get_secret_value(self) -> bytes: - return self._secret_value + def serialize( + value: _SecretField[SecretType], info: core_schema.SerializationInfo + ) -> str | _SecretField[SecretType]: + if info.mode == 'json': + # we want the output to always be string without the `b'` prefix for bytes, + # hence we just use `secret_display` + return _secret_display(value.get_secret_value()) + else: + return value + + def get_json_schema(_core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue: + json_schema = handler(inner_schema) + _utils.update_not_none( + json_schema, + type='string', + writeOnly=True, + format='password', + ) + return json_schema + + json_schema = core_schema.no_info_after_validator_function( + source, # construct the type + inner_schema, + ) + s = core_schema.json_or_python_schema( + python_schema=core_schema.union_schema( + [ + core_schema.is_instance_schema(source), + json_schema, + ], + strict=True, + custom_error_type=error_kind, + ), + json_schema=json_schema, + serialization=core_schema.plain_serializer_function_ser_schema( + serialize, + info_arg=True, + return_schema=core_schema.str_schema(), + when_used='json', + ), + ) + s.setdefault('metadata', {}).setdefault('pydantic_js_functions', []).append(get_json_schema) + return s + + +def _secret_display(value: str | bytes) -> str: + return '**********' if value else '' + + +class SecretStr(_SecretField[str]): + """A string used for storing sensitive information that you do not want to be visible in logging or tracebacks. + + When the secret value is nonempty, it is displayed as `'**********'` instead of the underlying value in + calls to `repr()` and `str()`. If the value _is_ empty, it is displayed as `''`. + + ```py + from pydantic import BaseModel, SecretStr + + class User(BaseModel): + username: str + password: SecretStr + + user = User(username='scolvin', password='password1') + + print(user) + #> username='scolvin' password=SecretStr('**********') + print(user.password.get_secret_value()) + #> password1 + print((SecretStr('password'), SecretStr(''))) + #> (SecretStr('**********'), SecretStr('')) + ``` + """ + + def _display(self) -> str: + return _secret_display(self.get_secret_value()) + + +class SecretBytes(_SecretField[bytes]): + """A bytes used for storing sensitive information that you do not want to be visible in logging or tracebacks. + + It displays `b'**********'` instead of the string value on `repr()` and `str()` calls. + When the secret value is nonempty, it is displayed as `b'**********'` instead of the underlying value in + calls to `repr()` and `str()`. If the value _is_ empty, it is displayed as `b''`. + + ```py + from pydantic import BaseModel, SecretBytes + + class User(BaseModel): + username: str + password: SecretBytes + + user = User(username='scolvin', password=b'password1') + #> username='scolvin' password=SecretBytes(b'**********') + print(user.password.get_secret_value()) + #> b'password1' + print((SecretBytes(b'password'), SecretBytes(b''))) + #> (SecretBytes(b'**********'), SecretBytes(b'')) + ``` + """ + + def _display(self) -> bytes: + return _secret_display(self.get_secret_value()).encode() # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PAYMENT CARD TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ class PaymentCardBrand(str, Enum): - # If you add another card type, please also add it to the - # Hypothesis strategy in `pydantic._hypothesis_plugin`. amex = 'American Express' mastercard = 'Mastercard' visa = 'Visa' @@ -954,10 +1600,13 @@ class PaymentCardBrand(str, Enum): return self.value +@deprecated( + 'The `PaymentCardNumber` class is deprecated, use `pydantic_extra_types` instead. ' + 'See https://docs.pydantic.dev/latest/api/pydantic_extra_types_payment/#pydantic_extra_types.payment.PaymentCardNumber.', + category=PydanticDeprecatedSince20, +) class PaymentCardNumber(str): - """ - Based on: https://en.wikipedia.org/wiki/Payment_card_number - """ + """Based on: https://en.wikipedia.org/wiki/Payment_card_number.""" strip_whitespace: ClassVar[bool] = True min_length: ClassVar[int] = 12 @@ -967,36 +1616,47 @@ class PaymentCardNumber(str): brand: PaymentCardBrand def __init__(self, card_number: str): + self.validate_digits(card_number) + + card_number = self.validate_luhn_check_digit(card_number) + self.bin = card_number[:6] self.last4 = card_number[-4:] - self.brand = self._get_brand(card_number) + self.brand = self.validate_brand(card_number) @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield str_validator - yield constr_strip_whitespace - yield constr_length_validator - yield cls.validate_digits - yield cls.validate_luhn_check_digit - yield cls - yield cls.validate_length_for_brand + def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + return core_schema.with_info_after_validator_function( + cls.validate, + core_schema.str_schema( + min_length=cls.min_length, max_length=cls.max_length, strip_whitespace=cls.strip_whitespace + ), + ) + + @classmethod + def validate(cls, __input_value: str, _: core_schema.ValidationInfo) -> PaymentCardNumber: + """Validate the card number and return a `PaymentCardNumber` instance.""" + return cls(__input_value) @property def masked(self) -> str: + """Mask all but the last 4 digits of the card number. + + Returns: + A masked card number string. + """ num_masked = len(self) - 10 # len(bin) + len(last4) == 10 return f'{self.bin}{"*" * num_masked}{self.last4}' @classmethod - def validate_digits(cls, card_number: str) -> str: + def validate_digits(cls, card_number: str) -> None: + """Validate that the card number is all digits.""" if not card_number.isdigit(): - raise errors.NotDigitError - return card_number + raise PydanticCustomError('payment_card_number_digits', 'Card number is not all digits') @classmethod def validate_luhn_check_digit(cls, card_number: str) -> str: - """ - Based on: https://en.wikipedia.org/wiki/Luhn_algorithm - """ + """Based on: https://en.wikipedia.org/wiki/Luhn_algorithm.""" sum_ = int(card_number[-1]) length = len(card_number) parity = length % 2 @@ -1009,33 +1669,14 @@ class PaymentCardNumber(str): sum_ += digit valid = sum_ % 10 == 0 if not valid: - raise errors.LuhnValidationError - return card_number - - @classmethod - def validate_length_for_brand(cls, card_number: 'PaymentCardNumber') -> 'PaymentCardNumber': - """ - Validate length based on BIN for major brands: - https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN) - """ - required_length: Union[None, int, str] = None - if card_number.brand in PaymentCardBrand.mastercard: - required_length = 16 - valid = len(card_number) == required_length - elif card_number.brand == PaymentCardBrand.visa: - required_length = '13, 16 or 19' - valid = len(card_number) in {13, 16, 19} - elif card_number.brand == PaymentCardBrand.amex: - required_length = 15 - valid = len(card_number) == required_length - else: - valid = True - if not valid: - raise errors.InvalidLengthForBrand(brand=card_number.brand, required_length=required_length) + raise PydanticCustomError('payment_card_number_luhn', 'Card number is not luhn valid') return card_number @staticmethod - def _get_brand(card_number: str) -> PaymentCardBrand: + def validate_brand(card_number: str) -> PaymentCardBrand: + """Validate length based on BIN for major brands: + https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN). + """ if card_number[0] == '4': brand = PaymentCardBrand.visa elif 51 <= int(card_number[:2]) <= 55: @@ -1044,144 +1685,1195 @@ class PaymentCardNumber(str): brand = PaymentCardBrand.amex else: brand = PaymentCardBrand.other + + required_length: None | int | str = None + if brand in PaymentCardBrand.mastercard: + required_length = 16 + valid = len(card_number) == required_length + elif brand == PaymentCardBrand.visa: + required_length = '13, 16 or 19' + valid = len(card_number) in {13, 16, 19} + elif brand == PaymentCardBrand.amex: + required_length = 15 + valid = len(card_number) == required_length + else: + valid = True + + if not valid: + raise PydanticCustomError( + 'payment_card_number_brand', + 'Length for a {brand} card must be {required_length}', + {'brand': brand, 'required_length': required_length}, + ) return brand # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTE SIZE TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -BYTE_SIZES = { - 'b': 1, - 'kb': 10**3, - 'mb': 10**6, - 'gb': 10**9, - 'tb': 10**12, - 'pb': 10**15, - 'eb': 10**18, - 'kib': 2**10, - 'mib': 2**20, - 'gib': 2**30, - 'tib': 2**40, - 'pib': 2**50, - 'eib': 2**60, -} -BYTE_SIZES.update({k.lower()[0]: v for k, v in BYTE_SIZES.items() if 'i' not in k}) -byte_string_re = re.compile(r'^\s*(\d*\.?\d+)\s*(\w+)?', re.IGNORECASE) - class ByteSize(int): - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield cls.validate + """Converts a string representing a number of bytes with units (such as `'1KB'` or `'11.5MiB'`) into an integer. + + You can use the `ByteSize` data type to (case-insensitively) convert a string representation of a number of bytes into + an integer, and also to print out human-readable strings representing a number of bytes. + + In conformance with [IEC 80000-13 Standard](https://en.wikipedia.org/wiki/ISO/IEC_80000) we interpret `'1KB'` to mean 1000 bytes, + and `'1KiB'` to mean 1024 bytes. In general, including a middle `'i'` will cause the unit to be interpreted as a power of 2, + rather than a power of 10 (so, for example, `'1 MB'` is treated as `1_000_000` bytes, whereas `'1 MiB'` is treated as `1_048_576` bytes). + + !!! info + Note that `1b` will be parsed as "1 byte" and not "1 bit". + + ```py + from pydantic import BaseModel, ByteSize + + class MyModel(BaseModel): + size: ByteSize + + print(MyModel(size=52000).size) + #> 52000 + print(MyModel(size='3000 KiB').size) + #> 3072000 + + m = MyModel(size='50 PB') + print(m.size.human_readable()) + #> 44.4PiB + print(m.size.human_readable(decimal=True)) + #> 50.0PB + + print(m.size.to('TiB')) + #> 45474.73508864641 + ``` + """ + + byte_sizes = { + 'b': 1, + 'kb': 10**3, + 'mb': 10**6, + 'gb': 10**9, + 'tb': 10**12, + 'pb': 10**15, + 'eb': 10**18, + 'kib': 2**10, + 'mib': 2**20, + 'gib': 2**30, + 'tib': 2**40, + 'pib': 2**50, + 'eib': 2**60, + 'bit': 1 / 8, + 'kbit': 10**3 / 8, + 'mbit': 10**6 / 8, + 'gbit': 10**9 / 8, + 'tbit': 10**12 / 8, + 'pbit': 10**15 / 8, + 'ebit': 10**18 / 8, + 'kibit': 2**10 / 8, + 'mibit': 2**20 / 8, + 'gibit': 2**30 / 8, + 'tibit': 2**40 / 8, + 'pibit': 2**50 / 8, + 'eibit': 2**60 / 8, + } + byte_sizes.update({k.lower()[0]: v for k, v in byte_sizes.items() if 'i' not in k}) + + byte_string_pattern = r'^\s*(\d*\.?\d+)\s*(\w+)?' + byte_string_re = re.compile(byte_string_pattern, re.IGNORECASE) @classmethod - def validate(cls, v: StrIntFloat) -> 'ByteSize': + def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + return core_schema.with_info_after_validator_function( + function=cls._validate, + schema=core_schema.union_schema( + [ + core_schema.str_schema(pattern=cls.byte_string_pattern), + core_schema.int_schema(ge=0), + ], + custom_error_type='byte_size', + custom_error_message='could not parse value and unit from byte string', + ), + serialization=core_schema.plain_serializer_function_ser_schema( + int, return_schema=core_schema.int_schema(ge=0) + ), + ) + @classmethod + def _validate(cls, __input_value: Any, _: core_schema.ValidationInfo) -> ByteSize: try: - return cls(int(v)) + return cls(int(__input_value)) except ValueError: pass - str_match = byte_string_re.match(str(v)) + str_match = cls.byte_string_re.match(str(__input_value)) if str_match is None: - raise errors.InvalidByteSize() + raise PydanticCustomError('byte_size', 'could not parse value and unit from byte string') scalar, unit = str_match.groups() if unit is None: unit = 'b' try: - unit_mult = BYTE_SIZES[unit.lower()] + unit_mult = cls.byte_sizes[unit.lower()] except KeyError: - raise errors.InvalidByteSizeUnit(unit=unit) + raise PydanticCustomError('byte_size_unit', 'could not interpret byte unit: {unit}', {'unit': unit}) return cls(int(float(scalar) * unit_mult)) def human_readable(self, decimal: bool = False) -> str: + """Converts a byte size to a human readable string. + Args: + decimal: If True, use decimal units (e.g. 1000 bytes per KB). If False, use binary units + (e.g. 1024 bytes per KiB). + + Returns: + A human readable string representation of the byte size. + """ if decimal: divisor = 1000 - units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'] + units = 'B', 'KB', 'MB', 'GB', 'TB', 'PB' final_unit = 'EB' else: divisor = 1024 - units = ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB'] + units = 'B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB' final_unit = 'EiB' num = float(self) for unit in units: if abs(num) < divisor: - return f'{num:0.1f}{unit}' + if unit == 'B': + return f'{num:0.0f}{unit}' + else: + return f'{num:0.1f}{unit}' num /= divisor return f'{num:0.1f}{final_unit}' def to(self, unit: str) -> float: + """Converts a byte size to another unit, including both byte and bit units. + Args: + unit: The unit to convert to. Must be one of the following: B, KB, MB, GB, TB, PB, EB, + KiB, MiB, GiB, TiB, PiB, EiB (byte units) and + bit, kbit, mbit, gbit, tbit, pbit, ebit, + kibit, mibit, gibit, tibit, pibit, eibit (bit units). + + Returns: + The byte size in the new unit. + """ try: - unit_div = BYTE_SIZES[unit.lower()] + unit_div = self.byte_sizes[unit.lower()] except KeyError: - raise errors.InvalidByteSizeUnit(unit=unit) + raise PydanticCustomError('byte_size_unit', 'Could not interpret byte unit: {unit}', {'unit': unit}) return self / unit_div # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATE TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +def _check_annotated_type(annotated_type: str, expected_type: str, annotation: str) -> None: + if annotated_type != expected_type: + raise PydanticUserError(f"'{annotation}' cannot annotate '{annotated_type}'.", code='invalid_annotated_type') + + if TYPE_CHECKING: - PastDate = date - FutureDate = date + PastDate = Annotated[date, ...] + FutureDate = Annotated[date, ...] else: - class PastDate(date): - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield parse_date - yield cls.validate + class PastDate: + """A date in the past.""" @classmethod - def validate(cls, value: date) -> date: - if value >= date.today(): - raise errors.DateNotInThePastError() + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + if cls is source: + # used directly as a type + return core_schema.date_schema(now_op='past') + else: + schema = handler(source) + _check_annotated_type(schema['type'], 'date', cls.__name__) + schema['now_op'] = 'past' + return schema - return value + def __repr__(self) -> str: + return 'PastDate' - class FutureDate(date): - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield parse_date - yield cls.validate + class FutureDate: + """A date in the future.""" @classmethod - def validate(cls, value: date) -> date: - if value <= date.today(): - raise errors.DateNotInTheFutureError() + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + if cls is source: + # used directly as a type + return core_schema.date_schema(now_op='future') + else: + schema = handler(source) + _check_annotated_type(schema['type'], 'date', cls.__name__) + schema['now_op'] = 'future' + return schema - return value - - -class ConstrainedDate(date, metaclass=ConstrainedNumberMeta): - gt: OptionalDate = None - ge: OptionalDate = None - lt: OptionalDate = None - le: OptionalDate = None - - @classmethod - def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: - update_not_none(field_schema, exclusiveMinimum=cls.gt, exclusiveMaximum=cls.lt, minimum=cls.ge, maximum=cls.le) - - @classmethod - def __get_validators__(cls) -> 'CallableGenerator': - yield parse_date - yield number_size_validator + def __repr__(self) -> str: + return 'FutureDate' def condate( *, - gt: date = None, - ge: date = None, - lt: date = None, - le: date = None, -) -> Type[date]: - # use kwargs then define conf in a dict to aid with IDE type hinting - namespace = dict(gt=gt, ge=ge, lt=lt, le=le) - return type('ConstrainedDateValue', (ConstrainedDate,), namespace) + strict: bool | None = None, + gt: date | None = None, + ge: date | None = None, + lt: date | None = None, + le: date | None = None, +) -> type[date]: + """A wrapper for date that adds constraints. + + Args: + strict: Whether to validate the date value in strict mode. Defaults to `None`. + gt: The value must be greater than this. Defaults to `None`. + ge: The value must be greater than or equal to this. Defaults to `None`. + lt: The value must be less than this. Defaults to `None`. + le: The value must be less than or equal to this. Defaults to `None`. + + Returns: + A date type with the specified constraints. + """ + return Annotated[ + date, + Strict(strict) if strict is not None else None, + annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le), + ] + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATETIME TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +if TYPE_CHECKING: + AwareDatetime = Annotated[datetime, ...] + NaiveDatetime = Annotated[datetime, ...] + PastDatetime = Annotated[datetime, ...] + FutureDatetime = Annotated[datetime, ...] + +else: + + class AwareDatetime: + """A datetime that requires timezone info.""" + + @classmethod + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + if cls is source: + # used directly as a type + return core_schema.datetime_schema(tz_constraint='aware') + else: + schema = handler(source) + _check_annotated_type(schema['type'], 'datetime', cls.__name__) + schema['tz_constraint'] = 'aware' + return schema + + def __repr__(self) -> str: + return 'AwareDatetime' + + class NaiveDatetime: + """A datetime that doesn't require timezone info.""" + + @classmethod + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + if cls is source: + # used directly as a type + return core_schema.datetime_schema(tz_constraint='naive') + else: + schema = handler(source) + _check_annotated_type(schema['type'], 'datetime', cls.__name__) + schema['tz_constraint'] = 'naive' + return schema + + def __repr__(self) -> str: + return 'NaiveDatetime' + + class PastDatetime: + """A datetime that must be in the past.""" + + @classmethod + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + if cls is source: + # used directly as a type + return core_schema.datetime_schema(now_op='past') + else: + schema = handler(source) + _check_annotated_type(schema['type'], 'datetime', cls.__name__) + schema['now_op'] = 'past' + return schema + + def __repr__(self) -> str: + return 'PastDatetime' + + class FutureDatetime: + """A datetime that must be in the future.""" + + @classmethod + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + if cls is source: + # used directly as a type + return core_schema.datetime_schema(now_op='future') + else: + schema = handler(source) + _check_annotated_type(schema['type'], 'datetime', cls.__name__) + schema['now_op'] = 'future' + return schema + + def __repr__(self) -> str: + return 'FutureDatetime' + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Encoded TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class EncoderProtocol(Protocol): + """Protocol for encoding and decoding data to and from bytes.""" + + @classmethod + def decode(cls, data: bytes) -> bytes: + """Decode the data using the encoder. + + Args: + data: The data to decode. + + Returns: + The decoded data. + """ + ... + + @classmethod + def encode(cls, value: bytes) -> bytes: + """Encode the data using the encoder. + + Args: + value: The data to encode. + + Returns: + The encoded data. + """ + ... + + @classmethod + def get_json_format(cls) -> str: + """Get the JSON format for the encoded data. + + Returns: + The JSON format for the encoded data. + """ + ... + + +class Base64Encoder(EncoderProtocol): + """Standard (non-URL-safe) Base64 encoder.""" + + @classmethod + def decode(cls, data: bytes) -> bytes: + """Decode the data from base64 encoded bytes to original bytes data. + + Args: + data: The data to decode. + + Returns: + The decoded data. + """ + try: + return base64.decodebytes(data) + except ValueError as e: + raise PydanticCustomError('base64_decode', "Base64 decoding error: '{error}'", {'error': str(e)}) + + @classmethod + def encode(cls, value: bytes) -> bytes: + """Encode the data from bytes to a base64 encoded bytes. + + Args: + value: The data to encode. + + Returns: + The encoded data. + """ + return base64.encodebytes(value) + + @classmethod + def get_json_format(cls) -> Literal['base64']: + """Get the JSON format for the encoded data. + + Returns: + The JSON format for the encoded data. + """ + return 'base64' + + +class Base64UrlEncoder(EncoderProtocol): + """URL-safe Base64 encoder.""" + + @classmethod + def decode(cls, data: bytes) -> bytes: + """Decode the data from base64 encoded bytes to original bytes data. + + Args: + data: The data to decode. + + Returns: + The decoded data. + """ + try: + return base64.urlsafe_b64decode(data) + except ValueError as e: + raise PydanticCustomError('base64_decode', "Base64 decoding error: '{error}'", {'error': str(e)}) + + @classmethod + def encode(cls, value: bytes) -> bytes: + """Encode the data from bytes to a base64 encoded bytes. + + Args: + value: The data to encode. + + Returns: + The encoded data. + """ + return base64.urlsafe_b64encode(value) + + @classmethod + def get_json_format(cls) -> Literal['base64url']: + """Get the JSON format for the encoded data. + + Returns: + The JSON format for the encoded data. + """ + return 'base64url' + + +@_dataclasses.dataclass(**_internal_dataclass.slots_true) +class EncodedBytes: + """A bytes type that is encoded and decoded using the specified encoder. + + `EncodedBytes` needs an encoder that implements `EncoderProtocol` to operate. + + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, EncodedBytes, EncoderProtocol, ValidationError + + class MyEncoder(EncoderProtocol): + @classmethod + def decode(cls, data: bytes) -> bytes: + if data == b'**undecodable**': + raise ValueError('Cannot decode data') + return data[13:] + + @classmethod + def encode(cls, value: bytes) -> bytes: + return b'**encoded**: ' + value + + @classmethod + def get_json_format(cls) -> str: + return 'my-encoder' + + MyEncodedBytes = Annotated[bytes, EncodedBytes(encoder=MyEncoder)] + + class Model(BaseModel): + my_encoded_bytes: MyEncodedBytes + + # Initialize the model with encoded data + m = Model(my_encoded_bytes=b'**encoded**: some bytes') + + # Access decoded value + print(m.my_encoded_bytes) + #> b'some bytes' + + # Serialize into the encoded form + print(m.model_dump()) + #> {'my_encoded_bytes': b'**encoded**: some bytes'} + + # Validate encoded data + try: + Model(my_encoded_bytes=b'**undecodable**') + except ValidationError as e: + print(e) + ''' + 1 validation error for Model + my_encoded_bytes + Value error, Cannot decode data [type=value_error, input_value=b'**undecodable**', input_type=bytes] + ''' + ``` + """ + + encoder: type[EncoderProtocol] + + def __get_pydantic_json_schema__( + self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = handler(core_schema) + field_schema.update(type='string', format=self.encoder.get_json_format()) + return field_schema + + def __get_pydantic_core_schema__(self, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + return core_schema.with_info_after_validator_function( + function=self.decode, + schema=core_schema.bytes_schema(), + serialization=core_schema.plain_serializer_function_ser_schema(function=self.encode), + ) + + def decode(self, data: bytes, _: core_schema.ValidationInfo) -> bytes: + """Decode the data using the specified encoder. + + Args: + data: The data to decode. + + Returns: + The decoded data. + """ + return self.encoder.decode(data) + + def encode(self, value: bytes) -> bytes: + """Encode the data using the specified encoder. + + Args: + value: The data to encode. + + Returns: + The encoded data. + """ + return self.encoder.encode(value) + + def __hash__(self) -> int: + return hash(self.encoder) + + +@_dataclasses.dataclass(**_internal_dataclass.slots_true) +class EncodedStr(EncodedBytes): + """A str type that is encoded and decoded using the specified encoder. + + `EncodedStr` needs an encoder that implements `EncoderProtocol` to operate. + + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, EncodedStr, EncoderProtocol, ValidationError + + class MyEncoder(EncoderProtocol): + @classmethod + def decode(cls, data: bytes) -> bytes: + if data == b'**undecodable**': + raise ValueError('Cannot decode data') + return data[13:] + + @classmethod + def encode(cls, value: bytes) -> bytes: + return b'**encoded**: ' + value + + @classmethod + def get_json_format(cls) -> str: + return 'my-encoder' + + MyEncodedStr = Annotated[str, EncodedStr(encoder=MyEncoder)] + + class Model(BaseModel): + my_encoded_str: MyEncodedStr + + # Initialize the model with encoded data + m = Model(my_encoded_str='**encoded**: some str') + + # Access decoded value + print(m.my_encoded_str) + #> some str + + # Serialize into the encoded form + print(m.model_dump()) + #> {'my_encoded_str': '**encoded**: some str'} + + # Validate encoded data + try: + Model(my_encoded_str='**undecodable**') + except ValidationError as e: + print(e) + ''' + 1 validation error for Model + my_encoded_str + Value error, Cannot decode data [type=value_error, input_value='**undecodable**', input_type=str] + ''' + ``` + """ + + def __get_pydantic_core_schema__(self, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + return core_schema.with_info_after_validator_function( + function=self.decode_str, + schema=super(EncodedStr, self).__get_pydantic_core_schema__(source=source, handler=handler), # noqa: UP008 + serialization=core_schema.plain_serializer_function_ser_schema(function=self.encode_str), + ) + + def decode_str(self, data: bytes, _: core_schema.ValidationInfo) -> str: + """Decode the data using the specified encoder. + + Args: + data: The data to decode. + + Returns: + The decoded data. + """ + return data.decode() + + def encode_str(self, value: str) -> str: + """Encode the data using the specified encoder. + + Args: + value: The data to encode. + + Returns: + The encoded data. + """ + return super(EncodedStr, self).encode(value=value.encode()).decode() # noqa: UP008 + + def __hash__(self) -> int: + return hash(self.encoder) + + +Base64Bytes = Annotated[bytes, EncodedBytes(encoder=Base64Encoder)] +"""A bytes type that is encoded and decoded using the standard (non-URL-safe) base64 encoder. + +Note: + Under the hood, `Base64Bytes` use standard library `base64.encodebytes` and `base64.decodebytes` functions. + + As a result, attempting to decode url-safe base64 data using the `Base64Bytes` type may fail or produce an incorrect + decoding. + +```py +from pydantic import Base64Bytes, BaseModel, ValidationError + +class Model(BaseModel): + base64_bytes: Base64Bytes + +# Initialize the model with base64 data +m = Model(base64_bytes=b'VGhpcyBpcyB0aGUgd2F5') + +# Access decoded value +print(m.base64_bytes) +#> b'This is the way' + +# Serialize into the base64 form +print(m.model_dump()) +#> {'base64_bytes': b'VGhpcyBpcyB0aGUgd2F5\n'} + +# Validate base64 data +try: + print(Model(base64_bytes=b'undecodable').base64_bytes) +except ValidationError as e: + print(e) + ''' + 1 validation error for Model + base64_bytes + Base64 decoding error: 'Incorrect padding' [type=base64_decode, input_value=b'undecodable', input_type=bytes] + ''' +``` +""" +Base64Str = Annotated[str, EncodedStr(encoder=Base64Encoder)] +"""A str type that is encoded and decoded using the standard (non-URL-safe) base64 encoder. + +Note: + Under the hood, `Base64Bytes` use standard library `base64.encodebytes` and `base64.decodebytes` functions. + + As a result, attempting to decode url-safe base64 data using the `Base64Str` type may fail or produce an incorrect + decoding. + +```py +from pydantic import Base64Str, BaseModel, ValidationError + +class Model(BaseModel): + base64_str: Base64Str + +# Initialize the model with base64 data +m = Model(base64_str='VGhlc2UgYXJlbid0IHRoZSBkcm9pZHMgeW91J3JlIGxvb2tpbmcgZm9y') + +# Access decoded value +print(m.base64_str) +#> These aren't the droids you're looking for + +# Serialize into the base64 form +print(m.model_dump()) +#> {'base64_str': 'VGhlc2UgYXJlbid0IHRoZSBkcm9pZHMgeW91J3JlIGxvb2tpbmcgZm9y\n'} + +# Validate base64 data +try: + print(Model(base64_str='undecodable').base64_str) +except ValidationError as e: + print(e) + ''' + 1 validation error for Model + base64_str + Base64 decoding error: 'Incorrect padding' [type=base64_decode, input_value='undecodable', input_type=str] + ''' +``` +""" +Base64UrlBytes = Annotated[bytes, EncodedBytes(encoder=Base64UrlEncoder)] +"""A bytes type that is encoded and decoded using the URL-safe base64 encoder. + +Note: + Under the hood, `Base64UrlBytes` use standard library `base64.urlsafe_b64encode` and `base64.urlsafe_b64decode` + functions. + + As a result, the `Base64UrlBytes` type can be used to faithfully decode "vanilla" base64 data + (using `'+'` and `'/'`). + +```py +from pydantic import Base64UrlBytes, BaseModel + +class Model(BaseModel): + base64url_bytes: Base64UrlBytes + +# Initialize the model with base64 data +m = Model(base64url_bytes=b'SHc_dHc-TXc==') +print(m) +#> base64url_bytes=b'Hw?tw>Mw' +``` +""" +Base64UrlStr = Annotated[str, EncodedStr(encoder=Base64UrlEncoder)] +"""A str type that is encoded and decoded using the URL-safe base64 encoder. + +Note: + Under the hood, `Base64UrlStr` use standard library `base64.urlsafe_b64encode` and `base64.urlsafe_b64decode` + functions. + + As a result, the `Base64UrlStr` type can be used to faithfully decode "vanilla" base64 data (using `'+'` and `'/'`). + +```py +from pydantic import Base64UrlStr, BaseModel + +class Model(BaseModel): + base64url_str: Base64UrlStr + +# Initialize the model with base64 data +m = Model(base64url_str='SHc_dHc-TXc==') +print(m) +#> base64url_str='Hw?tw>Mw' +``` +""" + + +__getattr__ = getattr_migration(__name__) + + +@_dataclasses.dataclass(**_internal_dataclass.slots_true) +class GetPydanticSchema: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/types/#using-getpydanticschema-to-reduce-boilerplate + + A convenience class for creating an annotation that provides pydantic custom type hooks. + + This class is intended to eliminate the need to create a custom "marker" which defines the + `__get_pydantic_core_schema__` and `__get_pydantic_json_schema__` custom hook methods. + + For example, to have a field treated by type checkers as `int`, but by pydantic as `Any`, you can do: + ```python + from typing import Any + + from typing_extensions import Annotated + + from pydantic import BaseModel, GetPydanticSchema + + HandleAsAny = GetPydanticSchema(lambda _s, h: h(Any)) + + class Model(BaseModel): + x: Annotated[int, HandleAsAny] # pydantic sees `x: Any` + + print(repr(Model(x='abc').x)) + #> 'abc' + ``` + """ + + get_pydantic_core_schema: Callable[[Any, GetCoreSchemaHandler], CoreSchema] | None = None + get_pydantic_json_schema: Callable[[Any, GetJsonSchemaHandler], JsonSchemaValue] | None = None + + # Note: we may want to consider adding a convenience staticmethod `def for_type(type_: Any) -> GetPydanticSchema:` + # which returns `GetPydanticSchema(lambda _s, h: h(type_))` + + if not TYPE_CHECKING: + # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access + + def __getattr__(self, item: str) -> Any: + """Use this rather than defining `__get_pydantic_core_schema__` etc. to reduce the number of nested calls.""" + if item == '__get_pydantic_core_schema__' and self.get_pydantic_core_schema: + return self.get_pydantic_core_schema + elif item == '__get_pydantic_json_schema__' and self.get_pydantic_json_schema: + return self.get_pydantic_json_schema + else: + return object.__getattribute__(self, item) + + __hash__ = object.__hash__ + + +@_dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True) +class Tag: + """Provides a way to specify the expected tag to use for a case of a (callable) discriminated union. + + Also provides a way to label a union case in error messages. + + When using a callable `Discriminator`, attach a `Tag` to each case in the `Union` to specify the tag that + should be used to identify that case. For example, in the below example, the `Tag` is used to specify that + if `get_discriminator_value` returns `'apple'`, the input should be validated as an `ApplePie`, and if it + returns `'pumpkin'`, the input should be validated as a `PumpkinPie`. + + The primary role of the `Tag` here is to map the return value from the callable `Discriminator` function to + the appropriate member of the `Union` in question. + + ```py + from typing import Any, Union + + from typing_extensions import Annotated, Literal + + from pydantic import BaseModel, Discriminator, Tag + + class Pie(BaseModel): + time_to_cook: int + num_ingredients: int + + class ApplePie(Pie): + fruit: Literal['apple'] = 'apple' + + class PumpkinPie(Pie): + filling: Literal['pumpkin'] = 'pumpkin' + + def get_discriminator_value(v: Any) -> str: + if isinstance(v, dict): + return v.get('fruit', v.get('filling')) + return getattr(v, 'fruit', getattr(v, 'filling', None)) + + class ThanksgivingDinner(BaseModel): + dessert: Annotated[ + Union[ + Annotated[ApplePie, Tag('apple')], + Annotated[PumpkinPie, Tag('pumpkin')], + ], + Discriminator(get_discriminator_value), + ] + + apple_variation = ThanksgivingDinner.model_validate( + {'dessert': {'fruit': 'apple', 'time_to_cook': 60, 'num_ingredients': 8}} + ) + print(repr(apple_variation)) + ''' + ThanksgivingDinner(dessert=ApplePie(time_to_cook=60, num_ingredients=8, fruit='apple')) + ''' + + pumpkin_variation = ThanksgivingDinner.model_validate( + { + 'dessert': { + 'filling': 'pumpkin', + 'time_to_cook': 40, + 'num_ingredients': 6, + } + } + ) + print(repr(pumpkin_variation)) + ''' + ThanksgivingDinner(dessert=PumpkinPie(time_to_cook=40, num_ingredients=6, filling='pumpkin')) + ''' + ``` + + !!! note + You must specify a `Tag` for every case in a `Tag` that is associated with a + callable `Discriminator`. Failing to do so will result in a `PydanticUserError` with code + [`callable-discriminator-no-tag`](../errors/usage_errors.md#callable-discriminator-no-tag). + + See the [Discriminated Unions] concepts docs for more details on how to use `Tag`s. + + [Discriminated Unions]: ../concepts/unions.md#discriminated-unions + """ + + tag: str + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + schema = handler(source_type) + metadata = schema.setdefault('metadata', {}) + assert isinstance(metadata, dict) + metadata[_core_utils.TAGGED_UNION_TAG_KEY] = self.tag + return schema + + +@_dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True) +class Discriminator: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/unions/#discriminated-unions-with-callable-discriminator + + Provides a way to use a custom callable as the way to extract the value of a union discriminator. + + This allows you to get validation behavior like you'd get from `Field(discriminator=)`, + but without needing to have a single shared field across all the union choices. This also makes it + possible to handle unions of models and primitive types with discriminated-union-style validation errors. + Finally, this allows you to use a custom callable as the way to identify which member of a union a value + belongs to, while still seeing all the performance benefits of a discriminated union. + + Consider this example, which is much more performant with the use of `Discriminator` and thus a `TaggedUnion` + than it would be as a normal `Union`. + + ```py + from typing import Any, Union + + from typing_extensions import Annotated, Literal + + from pydantic import BaseModel, Discriminator, Tag + + class Pie(BaseModel): + time_to_cook: int + num_ingredients: int + + class ApplePie(Pie): + fruit: Literal['apple'] = 'apple' + + class PumpkinPie(Pie): + filling: Literal['pumpkin'] = 'pumpkin' + + def get_discriminator_value(v: Any) -> str: + if isinstance(v, dict): + return v.get('fruit', v.get('filling')) + return getattr(v, 'fruit', getattr(v, 'filling', None)) + + class ThanksgivingDinner(BaseModel): + dessert: Annotated[ + Union[ + Annotated[ApplePie, Tag('apple')], + Annotated[PumpkinPie, Tag('pumpkin')], + ], + Discriminator(get_discriminator_value), + ] + + apple_variation = ThanksgivingDinner.model_validate( + {'dessert': {'fruit': 'apple', 'time_to_cook': 60, 'num_ingredients': 8}} + ) + print(repr(apple_variation)) + ''' + ThanksgivingDinner(dessert=ApplePie(time_to_cook=60, num_ingredients=8, fruit='apple')) + ''' + + pumpkin_variation = ThanksgivingDinner.model_validate( + { + 'dessert': { + 'filling': 'pumpkin', + 'time_to_cook': 40, + 'num_ingredients': 6, + } + } + ) + print(repr(pumpkin_variation)) + ''' + ThanksgivingDinner(dessert=PumpkinPie(time_to_cook=40, num_ingredients=6, filling='pumpkin')) + ''' + ``` + + See the [Discriminated Unions] concepts docs for more details on how to use `Discriminator`s. + + [Discriminated Unions]: ../concepts/unions.md#discriminated-unions + """ + + discriminator: str | Callable[[Any], Hashable] + """The callable or field name for discriminating the type in a tagged union. + + A `Callable` discriminator must extract the value of the discriminator from the input. + A `str` discriminator must be the name of a field to discriminate against. + """ + custom_error_type: str | None = None + """Type to use in [custom errors](../errors/errors.md#custom-errors) replacing the standard discriminated union + validation errors. + """ + custom_error_message: str | None = None + """Message to use in custom errors.""" + custom_error_context: dict[str, int | str | float] | None = None + """Context to use in custom errors.""" + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + origin = _typing_extra.get_origin(source_type) + if not origin or not _typing_extra.origin_is_union(origin): + raise TypeError(f'{type(self).__name__} must be used with a Union type, not {source_type}') + + if isinstance(self.discriminator, str): + from pydantic import Field + + return handler(Annotated[source_type, Field(discriminator=self.discriminator)]) + else: + original_schema = handler(source_type) + return self._convert_schema(original_schema) + + def _convert_schema(self, original_schema: core_schema.CoreSchema) -> core_schema.TaggedUnionSchema: + if original_schema['type'] != 'union': + # This likely indicates that the schema was a single-item union that was simplified. + # In this case, we do the same thing we do in + # `pydantic._internal._discriminated_union._ApplyInferredDiscriminator._apply_to_root`, namely, + # package the generated schema back into a single-item union. + original_schema = core_schema.union_schema([original_schema]) + + tagged_union_choices = {} + for i, choice in enumerate(original_schema['choices']): + tag = None + if isinstance(choice, tuple): + choice, tag = choice + metadata = choice.get('metadata') + if metadata is not None: + metadata_tag = metadata.get(_core_utils.TAGGED_UNION_TAG_KEY) + if metadata_tag is not None: + tag = metadata_tag + if tag is None: + raise PydanticUserError( + f'`Tag` not provided for choice {choice} used with `Discriminator`', + code='callable-discriminator-no-tag', + ) + tagged_union_choices[tag] = choice + + # Have to do these verbose checks to ensure falsy values ('' and {}) don't get ignored + custom_error_type = self.custom_error_type + if custom_error_type is None: + custom_error_type = original_schema.get('custom_error_type') + + custom_error_message = self.custom_error_message + if custom_error_message is None: + custom_error_message = original_schema.get('custom_error_message') + + custom_error_context = self.custom_error_context + if custom_error_context is None: + custom_error_context = original_schema.get('custom_error_context') + + custom_error_type = original_schema.get('custom_error_type') if custom_error_type is None else custom_error_type + return core_schema.tagged_union_schema( + tagged_union_choices, + self.discriminator, + custom_error_type=custom_error_type, + custom_error_message=custom_error_message, + custom_error_context=custom_error_context, + strict=original_schema.get('strict'), + ref=original_schema.get('ref'), + metadata=original_schema.get('metadata'), + serialization=original_schema.get('serialization'), + ) + + +_JSON_TYPES = {int, float, str, bool, list, dict, type(None)} + + +def _get_type_name(x: Any) -> str: + type_ = type(x) + if type_ in _JSON_TYPES: + return type_.__name__ + + # Handle proper subclasses; note we don't need to handle None or bool here + if isinstance(x, int): + return 'int' + if isinstance(x, float): + return 'float' + if isinstance(x, str): + return 'str' + if isinstance(x, list): + return 'list' + if isinstance(x, dict): + return 'dict' + + # Fail by returning the type's actual name + return getattr(type_, '__name__', '') + + +class _AllowAnyJson: + @classmethod + def __get_pydantic_core_schema__(cls, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + python_schema = handler(source_type) + return core_schema.json_or_python_schema(json_schema=core_schema.any_schema(), python_schema=python_schema) + + +if TYPE_CHECKING: + # This seems to only be necessary for mypy + JsonValue: TypeAlias = Union[ + List['JsonValue'], + Dict[str, 'JsonValue'], + str, + bool, + int, + float, + None, + ] + """A `JsonValue` is used to represent a value that can be serialized to JSON. + + It may be one of: + + * `List['JsonValue']` + * `Dict[str, 'JsonValue']` + * `str` + * `bool` + * `int` + * `float` + * `None` + + The following example demonstrates how to use `JsonValue` to validate JSON data, + and what kind of errors to expect when input data is not json serializable. + + ```py + import json + + from pydantic import BaseModel, JsonValue, ValidationError + + class Model(BaseModel): + j: JsonValue + + valid_json_data = {'j': {'a': {'b': {'c': 1, 'd': [2, None]}}}} + invalid_json_data = {'j': {'a': {'b': ...}}} + + print(repr(Model.model_validate(valid_json_data))) + #> Model(j={'a': {'b': {'c': 1, 'd': [2, None]}}}) + print(repr(Model.model_validate_json(json.dumps(valid_json_data)))) + #> Model(j={'a': {'b': {'c': 1, 'd': [2, None]}}}) + + try: + Model.model_validate(invalid_json_data) + except ValidationError as e: + print(e) + ''' + 1 validation error for Model + j.dict.a.dict.b + input was not a valid JSON value [type=invalid-json-value, input_value=Ellipsis, input_type=ellipsis] + ''' + ``` + """ + +else: + JsonValue = TypeAliasType( + 'JsonValue', + Annotated[ + Union[ + Annotated[List['JsonValue'], Tag('list')], + Annotated[Dict[str, 'JsonValue'], Tag('dict')], + Annotated[str, Tag('str')], + Annotated[bool, Tag('bool')], + Annotated[int, Tag('int')], + Annotated[float, Tag('float')], + Annotated[None, Tag('NoneType')], + ], + Discriminator( + _get_type_name, + custom_error_type='invalid-json-value', + custom_error_message='input was not a valid JSON value', + ), + _AllowAnyJson, + ], + ) + + +class _OnErrorOmit: + @classmethod + def __get_pydantic_core_schema__(cls, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + # there is no actual default value here but we use with_default_schema since it already has the on_error + # behavior implemented and it would be no more efficient to implement it on every other validator + # or as a standalone validator + return core_schema.with_default_schema(schema=handler(source_type), on_error='omit') + + +OnErrorOmit = Annotated[T, _OnErrorOmit] +""" +When used as an item in a list, the key type in a dict, optional values of a TypedDict, etc. +this annotation omits the item from the iteration if there is any error validating it. +That is, instead of a [`ValidationError`][pydantic_core.ValidationError] being propagated up and the entire iterable being discarded +any invalid items are discarded and the valid ones are returned. +""" diff --git a/lib/pydantic/typing.py b/lib/pydantic/typing.py index 5ccf266c..f1b32ba2 100644 --- a/lib/pydantic/typing.py +++ b/lib/pydantic/typing.py @@ -1,602 +1,4 @@ -import sys -from collections.abc import Callable -from os import PathLike -from typing import ( # type: ignore - TYPE_CHECKING, - AbstractSet, - Any, - Callable as TypingCallable, - ClassVar, - Dict, - ForwardRef, - Generator, - Iterable, - List, - Mapping, - NewType, - Optional, - Sequence, - Set, - Tuple, - Type, - TypeVar, - Union, - _eval_type, - cast, - get_type_hints, -) +"""`typing` module is a backport module from V1.""" +from ._migration import getattr_migration -from typing_extensions import ( - Annotated, - Final, - Literal, - NotRequired as TypedDictNotRequired, - Required as TypedDictRequired, -) - -try: - from typing import _TypingBase as typing_base # type: ignore -except ImportError: - from typing import _Final as typing_base # type: ignore - -try: - from typing import GenericAlias as TypingGenericAlias # type: ignore -except ImportError: - # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on) - TypingGenericAlias = () - -try: - from types import UnionType as TypesUnionType # type: ignore -except ImportError: - # python < 3.10 does not have UnionType (str | int, byte | bool and so on) - TypesUnionType = () - - -if sys.version_info < (3, 9): - - def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any: - return type_._evaluate(globalns, localns) - -else: - - def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any: - # Even though it is the right signature for python 3.9, mypy complains with - # `error: Too many arguments for "_evaluate" of "ForwardRef"` hence the cast... - return cast(Any, type_)._evaluate(globalns, localns, set()) - - -if sys.version_info < (3, 9): - # Ensure we always get all the whole `Annotated` hint, not just the annotated type. - # For 3.7 to 3.8, `get_type_hints` doesn't recognize `typing_extensions.Annotated`, - # so it already returns the full annotation - get_all_type_hints = get_type_hints - -else: - - def get_all_type_hints(obj: Any, globalns: Any = None, localns: Any = None) -> Any: - return get_type_hints(obj, globalns, localns, include_extras=True) - - -_T = TypeVar('_T') - -AnyCallable = TypingCallable[..., Any] -NoArgAnyCallable = TypingCallable[[], Any] - -# workaround for https://github.com/python/mypy/issues/9496 -AnyArgTCallable = TypingCallable[..., _T] - - -# Annotated[...] is implemented by returning an instance of one of these classes, depending on -# python/typing_extensions version. -AnnotatedTypeNames = {'AnnotatedMeta', '_AnnotatedAlias'} - - -if sys.version_info < (3, 8): - - def get_origin(t: Type[Any]) -> Optional[Type[Any]]: - if type(t).__name__ in AnnotatedTypeNames: - # weirdly this is a runtime requirement, as well as for mypy - return cast(Type[Any], Annotated) - return getattr(t, '__origin__', None) - -else: - from typing import get_origin as _typing_get_origin - - def get_origin(tp: Type[Any]) -> Optional[Type[Any]]: - """ - We can't directly use `typing.get_origin` since we need a fallback to support - custom generic classes like `ConstrainedList` - It should be useless once https://github.com/cython/cython/issues/3537 is - solved and https://github.com/pydantic/pydantic/pull/1753 is merged. - """ - if type(tp).__name__ in AnnotatedTypeNames: - return cast(Type[Any], Annotated) # mypy complains about _SpecialForm - return _typing_get_origin(tp) or getattr(tp, '__origin__', None) - - -if sys.version_info < (3, 8): - from typing import _GenericAlias - - def get_args(t: Type[Any]) -> Tuple[Any, ...]: - """Compatibility version of get_args for python 3.7. - - Mostly compatible with the python 3.8 `typing` module version - and able to handle almost all use cases. - """ - if type(t).__name__ in AnnotatedTypeNames: - return t.__args__ + t.__metadata__ - if isinstance(t, _GenericAlias): - res = t.__args__ - if t.__origin__ is Callable and res and res[0] is not Ellipsis: - res = (list(res[:-1]), res[-1]) - return res - return getattr(t, '__args__', ()) - -else: - from typing import get_args as _typing_get_args - - def _generic_get_args(tp: Type[Any]) -> Tuple[Any, ...]: - """ - In python 3.9, `typing.Dict`, `typing.List`, ... - do have an empty `__args__` by default (instead of the generic ~T for example). - In order to still support `Dict` for example and consider it as `Dict[Any, Any]`, - we retrieve the `_nparams` value that tells us how many parameters it needs. - """ - if hasattr(tp, '_nparams'): - return (Any,) * tp._nparams - # Special case for `tuple[()]`, which used to return ((),) with `typing.Tuple` - # in python 3.10- but now returns () for `tuple` and `Tuple`. - # This will probably be clarified in pydantic v2 - try: - if tp == Tuple[()] or sys.version_info >= (3, 9) and tp == tuple[()]: # type: ignore[misc] - return ((),) - # there is a TypeError when compiled with cython - except TypeError: # pragma: no cover - pass - return () - - def get_args(tp: Type[Any]) -> Tuple[Any, ...]: - """Get type arguments with all substitutions performed. - - For unions, basic simplifications used by Union constructor are performed. - Examples:: - get_args(Dict[str, int]) == (str, int) - get_args(int) == () - get_args(Union[int, Union[T, int], str][int]) == (int, str) - get_args(Union[int, Tuple[T, int]][str]) == (int, Tuple[str, int]) - get_args(Callable[[], T][int]) == ([], int) - """ - if type(tp).__name__ in AnnotatedTypeNames: - return tp.__args__ + tp.__metadata__ - # the fallback is needed for the same reasons as `get_origin` (see above) - return _typing_get_args(tp) or getattr(tp, '__args__', ()) or _generic_get_args(tp) - - -if sys.version_info < (3, 9): - - def convert_generics(tp: Type[Any]) -> Type[Any]: - """Python 3.9 and older only supports generics from `typing` module. - They convert strings to ForwardRef automatically. - - Examples:: - typing.List['Hero'] == typing.List[ForwardRef('Hero')] - """ - return tp - -else: - from typing import _UnionGenericAlias # type: ignore - - from typing_extensions import _AnnotatedAlias - - def convert_generics(tp: Type[Any]) -> Type[Any]: - """ - Recursively searches for `str` type hints and replaces them with ForwardRef. - - Examples:: - convert_generics(list['Hero']) == list[ForwardRef('Hero')] - convert_generics(dict['Hero', 'Team']) == dict[ForwardRef('Hero'), ForwardRef('Team')] - convert_generics(typing.Dict['Hero', 'Team']) == typing.Dict[ForwardRef('Hero'), ForwardRef('Team')] - convert_generics(list[str | 'Hero'] | int) == list[str | ForwardRef('Hero')] | int - """ - origin = get_origin(tp) - if not origin or not hasattr(tp, '__args__'): - return tp - - args = get_args(tp) - - # typing.Annotated needs special treatment - if origin is Annotated: - return _AnnotatedAlias(convert_generics(args[0]), args[1:]) - - # recursively replace `str` instances inside of `GenericAlias` with `ForwardRef(arg)` - converted = tuple( - ForwardRef(arg) if isinstance(arg, str) and isinstance(tp, TypingGenericAlias) else convert_generics(arg) - for arg in args - ) - - if converted == args: - return tp - elif isinstance(tp, TypingGenericAlias): - return TypingGenericAlias(origin, converted) - elif isinstance(tp, TypesUnionType): - # recreate types.UnionType (PEP604, Python >= 3.10) - return _UnionGenericAlias(origin, converted) - else: - try: - setattr(tp, '__args__', converted) - except AttributeError: - pass - return tp - - -if sys.version_info < (3, 10): - - def is_union(tp: Optional[Type[Any]]) -> bool: - return tp is Union - - WithArgsTypes = (TypingGenericAlias,) - -else: - import types - import typing - - def is_union(tp: Optional[Type[Any]]) -> bool: - return tp is Union or tp is types.UnionType # noqa: E721 - - WithArgsTypes = (typing._GenericAlias, types.GenericAlias, types.UnionType) - - -if sys.version_info < (3, 9): - StrPath = Union[str, PathLike] -else: - StrPath = Union[str, PathLike] - # TODO: Once we switch to Cython 3 to handle generics properly - # (https://github.com/cython/cython/issues/2753), use following lines instead - # of the one above - # # os.PathLike only becomes subscriptable from Python 3.9 onwards - # StrPath = Union[str, PathLike[str]] - - -if TYPE_CHECKING: - from .fields import ModelField - - TupleGenerator = Generator[Tuple[str, Any], None, None] - DictStrAny = Dict[str, Any] - DictAny = Dict[Any, Any] - SetStr = Set[str] - ListStr = List[str] - IntStr = Union[int, str] - AbstractSetIntStr = AbstractSet[IntStr] - DictIntStrAny = Dict[IntStr, Any] - MappingIntStrAny = Mapping[IntStr, Any] - CallableGenerator = Generator[AnyCallable, None, None] - ReprArgs = Sequence[Tuple[Optional[str], Any]] - AnyClassMethod = classmethod[Any] - -__all__ = ( - 'AnyCallable', - 'NoArgAnyCallable', - 'NoneType', - 'is_none_type', - 'display_as_type', - 'resolve_annotations', - 'is_callable_type', - 'is_literal_type', - 'all_literal_values', - 'is_namedtuple', - 'is_typeddict', - 'is_typeddict_special', - 'is_new_type', - 'new_type_supertype', - 'is_classvar', - 'is_finalvar', - 'update_field_forward_refs', - 'update_model_forward_refs', - 'TupleGenerator', - 'DictStrAny', - 'DictAny', - 'SetStr', - 'ListStr', - 'IntStr', - 'AbstractSetIntStr', - 'DictIntStrAny', - 'CallableGenerator', - 'ReprArgs', - 'AnyClassMethod', - 'CallableGenerator', - 'WithArgsTypes', - 'get_args', - 'get_origin', - 'get_sub_types', - 'typing_base', - 'get_all_type_hints', - 'is_union', - 'StrPath', - 'MappingIntStrAny', -) - - -NoneType = None.__class__ - - -NONE_TYPES: Tuple[Any, Any, Any] = (None, NoneType, Literal[None]) - - -if sys.version_info < (3, 8): - # Even though this implementation is slower, we need it for python 3.7: - # In python 3.7 "Literal" is not a builtin type and uses a different - # mechanism. - # for this reason `Literal[None] is Literal[None]` evaluates to `False`, - # breaking the faster implementation used for the other python versions. - - def is_none_type(type_: Any) -> bool: - return type_ in NONE_TYPES - -elif sys.version_info[:2] == (3, 8): - - def is_none_type(type_: Any) -> bool: - for none_type in NONE_TYPES: - if type_ is none_type: - return True - # With python 3.8, specifically 3.8.10, Literal "is" check sare very flakey - # can change on very subtle changes like use of types in other modules, - # hopefully this check avoids that issue. - if is_literal_type(type_): # pragma: no cover - return all_literal_values(type_) == (None,) - return False - -else: - - def is_none_type(type_: Any) -> bool: - for none_type in NONE_TYPES: - if type_ is none_type: - return True - return False - - -def display_as_type(v: Type[Any]) -> str: - if not isinstance(v, typing_base) and not isinstance(v, WithArgsTypes) and not isinstance(v, type): - v = v.__class__ - - if is_union(get_origin(v)): - return f'Union[{", ".join(map(display_as_type, get_args(v)))}]' - - if isinstance(v, WithArgsTypes): - # Generic alias are constructs like `list[int]` - return str(v).replace('typing.', '') - - try: - return v.__name__ - except AttributeError: - # happens with typing objects - return str(v).replace('typing.', '') - - -def resolve_annotations(raw_annotations: Dict[str, Type[Any]], module_name: Optional[str]) -> Dict[str, Type[Any]]: - """ - Partially taken from typing.get_type_hints. - - Resolve string or ForwardRef annotations into type objects if possible. - """ - base_globals: Optional[Dict[str, Any]] = None - if module_name: - try: - module = sys.modules[module_name] - except KeyError: - # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363 - pass - else: - base_globals = module.__dict__ - - annotations = {} - for name, value in raw_annotations.items(): - if isinstance(value, str): - if (3, 10) > sys.version_info >= (3, 9, 8) or sys.version_info >= (3, 10, 1): - value = ForwardRef(value, is_argument=False, is_class=True) - else: - value = ForwardRef(value, is_argument=False) - try: - value = _eval_type(value, base_globals, None) - except NameError: - # this is ok, it can be fixed with update_forward_refs - pass - annotations[name] = value - return annotations - - -def is_callable_type(type_: Type[Any]) -> bool: - return type_ is Callable or get_origin(type_) is Callable - - -def is_literal_type(type_: Type[Any]) -> bool: - return Literal is not None and get_origin(type_) is Literal - - -def literal_values(type_: Type[Any]) -> Tuple[Any, ...]: - return get_args(type_) - - -def all_literal_values(type_: Type[Any]) -> Tuple[Any, ...]: - """ - This method is used to retrieve all Literal values as - Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586) - e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]` - """ - if not is_literal_type(type_): - return (type_,) - - values = literal_values(type_) - return tuple(x for value in values for x in all_literal_values(value)) - - -def is_namedtuple(type_: Type[Any]) -> bool: - """ - Check if a given class is a named tuple. - It can be either a `typing.NamedTuple` or `collections.namedtuple` - """ - from .utils import lenient_issubclass - - return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields') - - -def is_typeddict(type_: Type[Any]) -> bool: - """ - Check if a given class is a typed dict (from `typing` or `typing_extensions`) - In 3.10, there will be a public method (https://docs.python.org/3.10/library/typing.html#typing.is_typeddict) - """ - from .utils import lenient_issubclass - - return lenient_issubclass(type_, dict) and hasattr(type_, '__total__') - - -def _check_typeddict_special(type_: Any) -> bool: - return type_ is TypedDictRequired or type_ is TypedDictNotRequired - - -def is_typeddict_special(type_: Any) -> bool: - """ - Check if type is a TypedDict special form (Required or NotRequired). - """ - return _check_typeddict_special(type_) or _check_typeddict_special(get_origin(type_)) - - -test_type = NewType('test_type', str) - - -def is_new_type(type_: Type[Any]) -> bool: - """ - Check whether type_ was created using typing.NewType - """ - return isinstance(type_, test_type.__class__) and hasattr(type_, '__supertype__') # type: ignore - - -def new_type_supertype(type_: Type[Any]) -> Type[Any]: - while hasattr(type_, '__supertype__'): - type_ = type_.__supertype__ - return type_ - - -def _check_classvar(v: Optional[Type[Any]]) -> bool: - if v is None: - return False - - return v.__class__ == ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar' - - -def _check_finalvar(v: Optional[Type[Any]]) -> bool: - """ - Check if a given type is a `typing.Final` type. - """ - if v is None: - return False - - return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final') - - -def is_classvar(ann_type: Type[Any]) -> bool: - if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)): - return True - - # this is an ugly workaround for class vars that contain forward references and are therefore themselves - # forward references, see #3679 - if ann_type.__class__ == ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['): - return True - - return False - - -def is_finalvar(ann_type: Type[Any]) -> bool: - return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type)) - - -def update_field_forward_refs(field: 'ModelField', globalns: Any, localns: Any) -> None: - """ - Try to update ForwardRefs on fields based on this ModelField, globalns and localns. - """ - prepare = False - if field.type_.__class__ == ForwardRef: - prepare = True - field.type_ = evaluate_forwardref(field.type_, globalns, localns or None) - if field.outer_type_.__class__ == ForwardRef: - prepare = True - field.outer_type_ = evaluate_forwardref(field.outer_type_, globalns, localns or None) - if prepare: - field.prepare() - - if field.sub_fields: - for sub_f in field.sub_fields: - update_field_forward_refs(sub_f, globalns=globalns, localns=localns) - - if field.discriminator_key is not None: - field.prepare_discriminated_union_sub_fields() - - -def update_model_forward_refs( - model: Type[Any], - fields: Iterable['ModelField'], - json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable], - localns: 'DictStrAny', - exc_to_suppress: Tuple[Type[BaseException], ...] = (), -) -> None: - """ - Try to update model fields ForwardRefs based on model and localns. - """ - if model.__module__ in sys.modules: - globalns = sys.modules[model.__module__].__dict__.copy() - else: - globalns = {} - - globalns.setdefault(model.__name__, model) - - for f in fields: - try: - update_field_forward_refs(f, globalns=globalns, localns=localns) - except exc_to_suppress: - pass - - for key in set(json_encoders.keys()): - if isinstance(key, str): - fr: ForwardRef = ForwardRef(key) - elif isinstance(key, ForwardRef): - fr = key - else: - continue - - try: - new_key = evaluate_forwardref(fr, globalns, localns or None) - except exc_to_suppress: # pragma: no cover - continue - - json_encoders[new_key] = json_encoders.pop(key) - - -def get_class(type_: Type[Any]) -> Union[None, bool, Type[Any]]: - """ - Tries to get the class of a Type[T] annotation. Returns True if Type is used - without brackets. Otherwise returns None. - """ - if type_ is type: - return True - - if get_origin(type_) is None: - return None - - args = get_args(type_) - if not args or not isinstance(args[0], type): - return True - else: - return args[0] - - -def get_sub_types(tp: Any) -> List[Any]: - """ - Return all the types that are allowed by type `tp` - `tp` can be a `Union` of allowed types or an `Annotated` type - """ - origin = get_origin(tp) - if origin is Annotated: - return get_sub_types(get_args(tp)[0]) - elif is_union(origin): - return [x for t in get_args(tp) for x in get_sub_types(t)] - else: - return [tp] +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/utils.py b/lib/pydantic/utils.py index 1d016c0e..1619d1db 100644 --- a/lib/pydantic/utils.py +++ b/lib/pydantic/utils.py @@ -1,841 +1,4 @@ -import keyword -import warnings -import weakref -from collections import OrderedDict, defaultdict, deque -from copy import deepcopy -from itertools import islice, zip_longest -from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType -from typing import ( - TYPE_CHECKING, - AbstractSet, - Any, - Callable, - Collection, - Dict, - Generator, - Iterable, - Iterator, - List, - Mapping, - MutableMapping, - NoReturn, - Optional, - Set, - Tuple, - Type, - TypeVar, - Union, -) +"""The `utils` module is a backport module from V1.""" +from ._migration import getattr_migration -from typing_extensions import Annotated - -from .errors import ConfigError -from .typing import ( - NoneType, - WithArgsTypes, - all_literal_values, - display_as_type, - get_args, - get_origin, - is_literal_type, - is_union, -) -from .version import version_info - -if TYPE_CHECKING: - from inspect import Signature - from pathlib import Path - - from .config import BaseConfig - from .dataclasses import Dataclass - from .fields import ModelField - from .main import BaseModel - from .typing import AbstractSetIntStr, DictIntStrAny, IntStr, MappingIntStrAny, ReprArgs - - RichReprResult = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]] - -__all__ = ( - 'import_string', - 'sequence_like', - 'validate_field_name', - 'lenient_isinstance', - 'lenient_issubclass', - 'in_ipython', - 'is_valid_identifier', - 'deep_update', - 'update_not_none', - 'almost_equal_floats', - 'get_model', - 'to_camel', - 'is_valid_field', - 'smart_deepcopy', - 'PyObjectStr', - 'Representation', - 'GetterDict', - 'ValueItems', - 'version_info', # required here to match behaviour in v1.3 - 'ClassAttribute', - 'path_type', - 'ROOT_KEY', - 'get_unique_discriminator_alias', - 'get_discriminator_alias_and_values', - 'DUNDER_ATTRIBUTES', - 'LimitedDict', -) - -ROOT_KEY = '__root__' -# these are types that are returned unchanged by deepcopy -IMMUTABLE_NON_COLLECTIONS_TYPES: Set[Type[Any]] = { - int, - float, - complex, - str, - bool, - bytes, - type, - NoneType, - FunctionType, - BuiltinFunctionType, - LambdaType, - weakref.ref, - CodeType, - # note: including ModuleType will differ from behaviour of deepcopy by not producing error. - # It might be not a good idea in general, but considering that this function used only internally - # against default values of fields, this will allow to actually have a field with module as default value - ModuleType, - NotImplemented.__class__, - Ellipsis.__class__, -} - -# these are types that if empty, might be copied with simple copy() instead of deepcopy() -BUILTIN_COLLECTIONS: Set[Type[Any]] = { - list, - set, - tuple, - frozenset, - dict, - OrderedDict, - defaultdict, - deque, -} - - -def import_string(dotted_path: str) -> Any: - """ - Stolen approximately from django. Import a dotted module path and return the attribute/class designated by the - last name in the path. Raise ImportError if the import fails. - """ - from importlib import import_module - - try: - module_path, class_name = dotted_path.strip(' ').rsplit('.', 1) - except ValueError as e: - raise ImportError(f'"{dotted_path}" doesn\'t look like a module path') from e - - module = import_module(module_path) - try: - return getattr(module, class_name) - except AttributeError as e: - raise ImportError(f'Module "{module_path}" does not define a "{class_name}" attribute') from e - - -def truncate(v: Union[str], *, max_len: int = 80) -> str: - """ - Truncate a value and add a unicode ellipsis (three dots) to the end if it was too long - """ - warnings.warn('`truncate` is no-longer used by pydantic and is deprecated', DeprecationWarning) - if isinstance(v, str) and len(v) > (max_len - 2): - # -3 so quote + string + … + quote has correct length - return (v[: (max_len - 3)] + '…').__repr__() - try: - v = v.__repr__() - except TypeError: - v = v.__class__.__repr__(v) # in case v is a type - if len(v) > max_len: - v = v[: max_len - 1] + '…' - return v - - -def sequence_like(v: Any) -> bool: - return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque)) - - -def validate_field_name(bases: List[Type['BaseModel']], field_name: str) -> None: - """ - Ensure that the field's name does not shadow an existing attribute of the model. - """ - for base in bases: - if getattr(base, field_name, None): - raise NameError( - f'Field name "{field_name}" shadows a BaseModel attribute; ' - f'use a different field name with "alias=\'{field_name}\'".' - ) - - -def lenient_isinstance(o: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool: - try: - return isinstance(o, class_or_tuple) # type: ignore[arg-type] - except TypeError: - return False - - -def lenient_issubclass(cls: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool: - try: - return isinstance(cls, type) and issubclass(cls, class_or_tuple) # type: ignore[arg-type] - except TypeError: - if isinstance(cls, WithArgsTypes): - return False - raise # pragma: no cover - - -def in_ipython() -> bool: - """ - Check whether we're in an ipython environment, including jupyter notebooks. - """ - try: - eval('__IPYTHON__') - except NameError: - return False - else: # pragma: no cover - return True - - -def is_valid_identifier(identifier: str) -> bool: - """ - Checks that a string is a valid identifier and not a Python keyword. - :param identifier: The identifier to test. - :return: True if the identifier is valid. - """ - return identifier.isidentifier() and not keyword.iskeyword(identifier) - - -KeyType = TypeVar('KeyType') - - -def deep_update(mapping: Dict[KeyType, Any], *updating_mappings: Dict[KeyType, Any]) -> Dict[KeyType, Any]: - updated_mapping = mapping.copy() - for updating_mapping in updating_mappings: - for k, v in updating_mapping.items(): - if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict): - updated_mapping[k] = deep_update(updated_mapping[k], v) - else: - updated_mapping[k] = v - return updated_mapping - - -def update_not_none(mapping: Dict[Any, Any], **update: Any) -> None: - mapping.update({k: v for k, v in update.items() if v is not None}) - - -def almost_equal_floats(value_1: float, value_2: float, *, delta: float = 1e-8) -> bool: - """ - Return True if two floats are almost equal - """ - return abs(value_1 - value_2) <= delta - - -def generate_model_signature( - init: Callable[..., None], fields: Dict[str, 'ModelField'], config: Type['BaseConfig'] -) -> 'Signature': - """ - Generate signature for model based on its fields - """ - from inspect import Parameter, Signature, signature - - from .config import Extra - - present_params = signature(init).parameters.values() - merged_params: Dict[str, Parameter] = {} - var_kw = None - use_var_kw = False - - for param in islice(present_params, 1, None): # skip self arg - if param.kind is param.VAR_KEYWORD: - var_kw = param - continue - merged_params[param.name] = param - - if var_kw: # if custom init has no var_kw, fields which are not declared in it cannot be passed through - allow_names = config.allow_population_by_field_name - for field_name, field in fields.items(): - param_name = field.alias - if field_name in merged_params or param_name in merged_params: - continue - elif not is_valid_identifier(param_name): - if allow_names and is_valid_identifier(field_name): - param_name = field_name - else: - use_var_kw = True - continue - - # TODO: replace annotation with actual expected types once #1055 solved - kwargs = {'default': field.default} if not field.required else {} - merged_params[param_name] = Parameter( - param_name, Parameter.KEYWORD_ONLY, annotation=field.annotation, **kwargs - ) - - if config.extra is Extra.allow: - use_var_kw = True - - if var_kw and use_var_kw: - # Make sure the parameter for extra kwargs - # does not have the same name as a field - default_model_signature = [ - ('__pydantic_self__', Parameter.POSITIONAL_OR_KEYWORD), - ('data', Parameter.VAR_KEYWORD), - ] - if [(p.name, p.kind) for p in present_params] == default_model_signature: - # if this is the standard model signature, use extra_data as the extra args name - var_kw_name = 'extra_data' - else: - # else start from var_kw - var_kw_name = var_kw.name - - # generate a name that's definitely unique - while var_kw_name in fields: - var_kw_name += '_' - merged_params[var_kw_name] = var_kw.replace(name=var_kw_name) - - return Signature(parameters=list(merged_params.values()), return_annotation=None) - - -def get_model(obj: Union[Type['BaseModel'], Type['Dataclass']]) -> Type['BaseModel']: - from .main import BaseModel - - try: - model_cls = obj.__pydantic_model__ # type: ignore - except AttributeError: - model_cls = obj - - if not issubclass(model_cls, BaseModel): - raise TypeError('Unsupported type, must be either BaseModel or dataclass') - return model_cls - - -def to_camel(string: str) -> str: - return ''.join(word.capitalize() for word in string.split('_')) - - -def to_lower_camel(string: str) -> str: - if len(string) >= 1: - pascal_string = to_camel(string) - return pascal_string[0].lower() + pascal_string[1:] - return string.lower() - - -T = TypeVar('T') - - -def unique_list( - input_list: Union[List[T], Tuple[T, ...]], - *, - name_factory: Callable[[T], str] = str, -) -> List[T]: - """ - Make a list unique while maintaining order. - We update the list if another one with the same name is set - (e.g. root validator overridden in subclass) - """ - result: List[T] = [] - result_names: List[str] = [] - for v in input_list: - v_name = name_factory(v) - if v_name not in result_names: - result_names.append(v_name) - result.append(v) - else: - result[result_names.index(v_name)] = v - - return result - - -class PyObjectStr(str): - """ - String class where repr doesn't include quotes. Useful with Representation when you want to return a string - representation of something that valid (or pseudo-valid) python. - """ - - def __repr__(self) -> str: - return str(self) - - -class Representation: - """ - Mixin to provide __str__, __repr__, and __pretty__ methods. See #884 for more details. - - __pretty__ is used by [devtools](https://python-devtools.helpmanual.io/) to provide human readable representations - of objects. - """ - - __slots__: Tuple[str, ...] = tuple() - - def __repr_args__(self) -> 'ReprArgs': - """ - Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden. - - Can either return: - * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]` - * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]` - """ - attrs = ((s, getattr(self, s)) for s in self.__slots__) - return [(a, v) for a, v in attrs if v is not None] - - def __repr_name__(self) -> str: - """ - Name of the instance's class, used in __repr__. - """ - return self.__class__.__name__ - - def __repr_str__(self, join_str: str) -> str: - return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__()) - - def __pretty__(self, fmt: Callable[[Any], Any], **kwargs: Any) -> Generator[Any, None, None]: - """ - Used by devtools (https://python-devtools.helpmanual.io/) to provide a human readable representations of objects - """ - yield self.__repr_name__() + '(' - yield 1 - for name, value in self.__repr_args__(): - if name is not None: - yield name + '=' - yield fmt(value) - yield ',' - yield 0 - yield -1 - yield ')' - - def __str__(self) -> str: - return self.__repr_str__(' ') - - def __repr__(self) -> str: - return f'{self.__repr_name__()}({self.__repr_str__(", ")})' - - def __rich_repr__(self) -> 'RichReprResult': - """Get fields for Rich library""" - for name, field_repr in self.__repr_args__(): - if name is None: - yield field_repr - else: - yield name, field_repr - - -class GetterDict(Representation): - """ - Hack to make object's smell just enough like dicts for validate_model. - - We can't inherit from Mapping[str, Any] because it upsets cython so we have to implement all methods ourselves. - """ - - __slots__ = ('_obj',) - - def __init__(self, obj: Any): - self._obj = obj - - def __getitem__(self, key: str) -> Any: - try: - return getattr(self._obj, key) - except AttributeError as e: - raise KeyError(key) from e - - def get(self, key: Any, default: Any = None) -> Any: - return getattr(self._obj, key, default) - - def extra_keys(self) -> Set[Any]: - """ - We don't want to get any other attributes of obj if the model didn't explicitly ask for them - """ - return set() - - def keys(self) -> List[Any]: - """ - Keys of the pseudo dictionary, uses a list not set so order information can be maintained like python - dictionaries. - """ - return list(self) - - def values(self) -> List[Any]: - return [self[k] for k in self] - - def items(self) -> Iterator[Tuple[str, Any]]: - for k in self: - yield k, self.get(k) - - def __iter__(self) -> Iterator[str]: - for name in dir(self._obj): - if not name.startswith('_'): - yield name - - def __len__(self) -> int: - return sum(1 for _ in self) - - def __contains__(self, item: Any) -> bool: - return item in self.keys() - - def __eq__(self, other: Any) -> bool: - return dict(self) == dict(other.items()) - - def __repr_args__(self) -> 'ReprArgs': - return [(None, dict(self))] - - def __repr_name__(self) -> str: - return f'GetterDict[{display_as_type(self._obj)}]' - - -class ValueItems(Representation): - """ - Class for more convenient calculation of excluded or included fields on values. - """ - - __slots__ = ('_items', '_type') - - def __init__(self, value: Any, items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> None: - items = self._coerce_items(items) - - if isinstance(value, (list, tuple)): - items = self._normalize_indexes(items, len(value)) - - self._items: 'MappingIntStrAny' = items - - def is_excluded(self, item: Any) -> bool: - """ - Check if item is fully excluded. - - :param item: key or index of a value - """ - return self.is_true(self._items.get(item)) - - def is_included(self, item: Any) -> bool: - """ - Check if value is contained in self._items - - :param item: key or index of value - """ - return item in self._items - - def for_element(self, e: 'IntStr') -> Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']]: - """ - :param e: key or index of element on value - :return: raw values for element if self._items is dict and contain needed element - """ - - item = self._items.get(e) - return item if not self.is_true(item) else None - - def _normalize_indexes(self, items: 'MappingIntStrAny', v_length: int) -> 'DictIntStrAny': - """ - :param items: dict or set of indexes which will be normalized - :param v_length: length of sequence indexes of which will be - - >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4) - {0: True, 2: True, 3: True} - >>> self._normalize_indexes({'__all__': True}, 4) - {0: True, 1: True, 2: True, 3: True} - """ - - normalized_items: 'DictIntStrAny' = {} - all_items = None - for i, v in items.items(): - if not (isinstance(v, Mapping) or isinstance(v, AbstractSet) or self.is_true(v)): - raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}') - if i == '__all__': - all_items = self._coerce_value(v) - continue - if not isinstance(i, int): - raise TypeError( - 'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: ' - 'expected integer keys or keyword "__all__"' - ) - normalized_i = v_length + i if i < 0 else i - normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i)) - - if not all_items: - return normalized_items - if self.is_true(all_items): - for i in range(v_length): - normalized_items.setdefault(i, ...) - return normalized_items - for i in range(v_length): - normalized_item = normalized_items.setdefault(i, {}) - if not self.is_true(normalized_item): - normalized_items[i] = self.merge(all_items, normalized_item) - return normalized_items - - @classmethod - def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any: - """ - Merge a ``base`` item with an ``override`` item. - - Both ``base`` and ``override`` are converted to dictionaries if possible. - Sets are converted to dictionaries with the sets entries as keys and - Ellipsis as values. - - Each key-value pair existing in ``base`` is merged with ``override``, - while the rest of the key-value pairs are updated recursively with this function. - - Merging takes place based on the "union" of keys if ``intersect`` is - set to ``False`` (default) and on the intersection of keys if - ``intersect`` is set to ``True``. - """ - override = cls._coerce_value(override) - base = cls._coerce_value(base) - if override is None: - return base - if cls.is_true(base) or base is None: - return override - if cls.is_true(override): - return base if intersect else override - - # intersection or union of keys while preserving ordering: - if intersect: - merge_keys = [k for k in base if k in override] + [k for k in override if k in base] - else: - merge_keys = list(base) + [k for k in override if k not in base] - - merged: 'DictIntStrAny' = {} - for k in merge_keys: - merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect) - if merged_item is not None: - merged[k] = merged_item - - return merged - - @staticmethod - def _coerce_items(items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> 'MappingIntStrAny': - if isinstance(items, Mapping): - pass - elif isinstance(items, AbstractSet): - items = dict.fromkeys(items, ...) - else: - class_name = getattr(items, '__class__', '???') - assert_never( - items, - f'Unexpected type of exclude value {class_name}', - ) - return items - - @classmethod - def _coerce_value(cls, value: Any) -> Any: - if value is None or cls.is_true(value): - return value - return cls._coerce_items(value) - - @staticmethod - def is_true(v: Any) -> bool: - return v is True or v is ... - - def __repr_args__(self) -> 'ReprArgs': - return [(None, self._items)] - - -class ClassAttribute: - """ - Hide class attribute from its instances - """ - - __slots__ = ( - 'name', - 'value', - ) - - def __init__(self, name: str, value: Any) -> None: - self.name = name - self.value = value - - def __get__(self, instance: Any, owner: Type[Any]) -> None: - if instance is None: - return self.value - raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only') - - -path_types = { - 'is_dir': 'directory', - 'is_file': 'file', - 'is_mount': 'mount point', - 'is_symlink': 'symlink', - 'is_block_device': 'block device', - 'is_char_device': 'char device', - 'is_fifo': 'FIFO', - 'is_socket': 'socket', -} - - -def path_type(p: 'Path') -> str: - """ - Find out what sort of thing a path is. - """ - assert p.exists(), 'path does not exist' - for method, name in path_types.items(): - if getattr(p, method)(): - return name - - return 'unknown' - - -Obj = TypeVar('Obj') - - -def smart_deepcopy(obj: Obj) -> Obj: - """ - Return type as is for immutable built-in types - Use obj.copy() for built-in empty collections - Use copy.deepcopy() for non-empty collections and unknown objects - """ - - obj_type = obj.__class__ - if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES: - return obj # fastest case: obj is immutable and not collection therefore will not be copied anyway - try: - if not obj and obj_type in BUILTIN_COLLECTIONS: - # faster way for empty collections, no need to copy its members - return obj if obj_type is tuple else obj.copy() # type: ignore # tuple doesn't have copy method - except (TypeError, ValueError, RuntimeError): - # do we really dare to catch ALL errors? Seems a bit risky - pass - - return deepcopy(obj) # slowest way when we actually might need a deepcopy - - -def is_valid_field(name: str) -> bool: - if not name.startswith('_'): - return True - return ROOT_KEY == name - - -DUNDER_ATTRIBUTES = { - '__annotations__', - '__classcell__', - '__doc__', - '__module__', - '__orig_bases__', - '__orig_class__', - '__qualname__', -} - - -def is_valid_private_name(name: str) -> bool: - return not is_valid_field(name) and name not in DUNDER_ATTRIBUTES - - -_EMPTY = object() - - -def all_identical(left: Iterable[Any], right: Iterable[Any]) -> bool: - """ - Check that the items of `left` are the same objects as those in `right`. - - >>> a, b = object(), object() - >>> all_identical([a, b, a], [a, b, a]) - True - >>> all_identical([a, b, [a]], [a, b, [a]]) # new list object, while "equal" is not "identical" - False - """ - for left_item, right_item in zip_longest(left, right, fillvalue=_EMPTY): - if left_item is not right_item: - return False - return True - - -def assert_never(obj: NoReturn, msg: str) -> NoReturn: - """ - Helper to make sure that we have covered all possible types. - - This is mostly useful for ``mypy``, docs: - https://mypy.readthedocs.io/en/latest/literal_types.html#exhaustive-checks - """ - raise TypeError(msg) - - -def get_unique_discriminator_alias(all_aliases: Collection[str], discriminator_key: str) -> str: - """Validate that all aliases are the same and if that's the case return the alias""" - unique_aliases = set(all_aliases) - if len(unique_aliases) > 1: - raise ConfigError( - f'Aliases for discriminator {discriminator_key!r} must be the same (got {", ".join(sorted(all_aliases))})' - ) - return unique_aliases.pop() - - -def get_discriminator_alias_and_values(tp: Any, discriminator_key: str) -> Tuple[str, Tuple[str, ...]]: - """ - Get alias and all valid values in the `Literal` type of the discriminator field - `tp` can be a `BaseModel` class or directly an `Annotated` `Union` of many. - """ - is_root_model = getattr(tp, '__custom_root_type__', False) - - if get_origin(tp) is Annotated: - tp = get_args(tp)[0] - - if hasattr(tp, '__pydantic_model__'): - tp = tp.__pydantic_model__ - - if is_union(get_origin(tp)): - alias, all_values = _get_union_alias_and_all_values(tp, discriminator_key) - return alias, tuple(v for values in all_values for v in values) - elif is_root_model: - union_type = tp.__fields__[ROOT_KEY].type_ - alias, all_values = _get_union_alias_and_all_values(union_type, discriminator_key) - - if len(set(all_values)) > 1: - raise ConfigError( - f'Field {discriminator_key!r} is not the same for all submodels of {display_as_type(tp)!r}' - ) - - return alias, all_values[0] - - else: - try: - t_discriminator_type = tp.__fields__[discriminator_key].type_ - except AttributeError as e: - raise TypeError(f'Type {tp.__name__!r} is not a valid `BaseModel` or `dataclass`') from e - except KeyError as e: - raise ConfigError(f'Model {tp.__name__!r} needs a discriminator field for key {discriminator_key!r}') from e - - if not is_literal_type(t_discriminator_type): - raise ConfigError(f'Field {discriminator_key!r} of model {tp.__name__!r} needs to be a `Literal`') - - return tp.__fields__[discriminator_key].alias, all_literal_values(t_discriminator_type) - - -def _get_union_alias_and_all_values( - union_type: Type[Any], discriminator_key: str -) -> Tuple[str, Tuple[Tuple[str, ...], ...]]: - zipped_aliases_values = [get_discriminator_alias_and_values(t, discriminator_key) for t in get_args(union_type)] - # unzip: [('alias_a',('v1', 'v2)), ('alias_b', ('v3',))] => [('alias_a', 'alias_b'), (('v1', 'v2'), ('v3',))] - all_aliases, all_values = zip(*zipped_aliases_values) - return get_unique_discriminator_alias(all_aliases, discriminator_key), all_values - - -KT = TypeVar('KT') -VT = TypeVar('VT') -if TYPE_CHECKING: - # Annoying inheriting from `MutableMapping` and `dict` breaks cython, hence this work around - class LimitedDict(dict, MutableMapping[KT, VT]): # type: ignore[type-arg] - def __init__(self, size_limit: int = 1000): - ... - -else: - - class LimitedDict(dict): - """ - Limit the size/length of a dict used for caching to avoid unlimited increase in memory usage. - - Since the dict is ordered, and we always remove elements from the beginning, this is effectively a FIFO cache. - - Annoying inheriting from `MutableMapping` breaks cython. - """ - - def __init__(self, size_limit: int = 1000): - self.size_limit = size_limit - super().__init__() - - def __setitem__(self, __key: Any, __value: Any) -> None: - super().__setitem__(__key, __value) - if len(self) > self.size_limit: - excess = len(self) - self.size_limit + self.size_limit // 10 - to_remove = list(self.keys())[:excess] - for key in to_remove: - del self[key] - - def __class_getitem__(cls, *args: Any) -> Any: - # to avoid errors with 3.7 - pass +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/v1/__init__.py b/lib/pydantic/v1/__init__.py new file mode 100644 index 00000000..3bf1418f --- /dev/null +++ b/lib/pydantic/v1/__init__.py @@ -0,0 +1,131 @@ +# flake8: noqa +from . import dataclasses +from .annotated_types import create_model_from_namedtuple, create_model_from_typeddict +from .class_validators import root_validator, validator +from .config import BaseConfig, ConfigDict, Extra +from .decorator import validate_arguments +from .env_settings import BaseSettings +from .error_wrappers import ValidationError +from .errors import * +from .fields import Field, PrivateAttr, Required +from .main import * +from .networks import * +from .parse import Protocol +from .tools import * +from .types import * +from .version import VERSION, compiled + +__version__ = VERSION + +# WARNING __all__ from .errors is not included here, it will be removed as an export here in v2 +# please use "from pydantic.errors import ..." instead +__all__ = [ + # annotated types utils + 'create_model_from_namedtuple', + 'create_model_from_typeddict', + # dataclasses + 'dataclasses', + # class_validators + 'root_validator', + 'validator', + # config + 'BaseConfig', + 'ConfigDict', + 'Extra', + # decorator + 'validate_arguments', + # env_settings + 'BaseSettings', + # error_wrappers + 'ValidationError', + # fields + 'Field', + 'Required', + # main + 'BaseModel', + 'create_model', + 'validate_model', + # network + 'AnyUrl', + 'AnyHttpUrl', + 'FileUrl', + 'HttpUrl', + 'stricturl', + 'EmailStr', + 'NameEmail', + 'IPvAnyAddress', + 'IPvAnyInterface', + 'IPvAnyNetwork', + 'PostgresDsn', + 'CockroachDsn', + 'AmqpDsn', + 'RedisDsn', + 'MongoDsn', + 'KafkaDsn', + 'validate_email', + # parse + 'Protocol', + # tools + 'parse_file_as', + 'parse_obj_as', + 'parse_raw_as', + 'schema_of', + 'schema_json_of', + # types + 'NoneStr', + 'NoneBytes', + 'StrBytes', + 'NoneStrBytes', + 'StrictStr', + 'ConstrainedBytes', + 'conbytes', + 'ConstrainedList', + 'conlist', + 'ConstrainedSet', + 'conset', + 'ConstrainedFrozenSet', + 'confrozenset', + 'ConstrainedStr', + 'constr', + 'PyObject', + 'ConstrainedInt', + 'conint', + 'PositiveInt', + 'NegativeInt', + 'NonNegativeInt', + 'NonPositiveInt', + 'ConstrainedFloat', + 'confloat', + 'PositiveFloat', + 'NegativeFloat', + 'NonNegativeFloat', + 'NonPositiveFloat', + 'FiniteFloat', + 'ConstrainedDecimal', + 'condecimal', + 'ConstrainedDate', + 'condate', + 'UUID1', + 'UUID3', + 'UUID4', + 'UUID5', + 'FilePath', + 'DirectoryPath', + 'Json', + 'JsonWrapper', + 'SecretField', + 'SecretStr', + 'SecretBytes', + 'StrictBool', + 'StrictBytes', + 'StrictInt', + 'StrictFloat', + 'PaymentCardNumber', + 'PrivateAttr', + 'ByteSize', + 'PastDate', + 'FutureDate', + # version + 'compiled', + 'VERSION', +] diff --git a/lib/pydantic/_hypothesis_plugin.py b/lib/pydantic/v1/_hypothesis_plugin.py similarity index 97% rename from lib/pydantic/_hypothesis_plugin.py rename to lib/pydantic/v1/_hypothesis_plugin.py index a56d2b98..0c529620 100644 --- a/lib/pydantic/_hypothesis_plugin.py +++ b/lib/pydantic/v1/_hypothesis_plugin.py @@ -10,7 +10,7 @@ Pydantic is installed. See also: https://hypothesis.readthedocs.io/en/latest/strategies.html#registering-strategies-via-setuptools-entry-points https://hypothesis.readthedocs.io/en/latest/data.html#hypothesis.strategies.register_type_strategy https://hypothesis.readthedocs.io/en/latest/strategies.html#interaction-with-pytest-cov -https://pydantic-docs.helpmanual.io/usage/types/#pydantic-types +https://docs.pydantic.dev/usage/types/#pydantic-types Note that because our motivation is to *improve user experience*, the strategies are always sound (never generate invalid data) but sacrifice completeness for @@ -46,7 +46,7 @@ from pydantic.utils import lenient_issubclass # # conlist() and conset() are unsupported for now, because the workarounds for # Cython and Hypothesis to handle parametrized generic types are incompatible. -# Once Cython can support 'normal' generics we'll revisit this. +# We are rethinking Hypothesis compatibility in Pydantic v2. # Emails try: @@ -168,6 +168,11 @@ st.register_type_strategy(pydantic.StrictBool, st.booleans()) st.register_type_strategy(pydantic.StrictStr, st.text()) +# FutureDate, PastDate +st.register_type_strategy(pydantic.FutureDate, st.dates(min_value=datetime.date.today() + datetime.timedelta(days=1))) +st.register_type_strategy(pydantic.PastDate, st.dates(max_value=datetime.date.today() - datetime.timedelta(days=1))) + + # Constrained-type resolver functions # # For these ones, we actually want to inspect the type in order to work out a diff --git a/lib/pydantic/annotated_types.py b/lib/pydantic/v1/annotated_types.py similarity index 100% rename from lib/pydantic/annotated_types.py rename to lib/pydantic/v1/annotated_types.py diff --git a/lib/pydantic/v1/class_validators.py b/lib/pydantic/v1/class_validators.py new file mode 100644 index 00000000..71e66509 --- /dev/null +++ b/lib/pydantic/v1/class_validators.py @@ -0,0 +1,361 @@ +import warnings +from collections import ChainMap +from functools import partial, partialmethod, wraps +from itertools import chain +from types import FunctionType +from typing import TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Optional, Set, Tuple, Type, Union, overload + +from .errors import ConfigError +from .typing import AnyCallable +from .utils import ROOT_KEY, in_ipython + +if TYPE_CHECKING: + from .typing import AnyClassMethod + + +class Validator: + __slots__ = 'func', 'pre', 'each_item', 'always', 'check_fields', 'skip_on_failure' + + def __init__( + self, + func: AnyCallable, + pre: bool = False, + each_item: bool = False, + always: bool = False, + check_fields: bool = False, + skip_on_failure: bool = False, + ): + self.func = func + self.pre = pre + self.each_item = each_item + self.always = always + self.check_fields = check_fields + self.skip_on_failure = skip_on_failure + + +if TYPE_CHECKING: + from inspect import Signature + + from .config import BaseConfig + from .fields import ModelField + from .types import ModelOrDc + + ValidatorCallable = Callable[[Optional[ModelOrDc], Any, Dict[str, Any], ModelField, Type[BaseConfig]], Any] + ValidatorsList = List[ValidatorCallable] + ValidatorListDict = Dict[str, List[Validator]] + +_FUNCS: Set[str] = set() +VALIDATOR_CONFIG_KEY = '__validator_config__' +ROOT_VALIDATOR_CONFIG_KEY = '__root_validator_config__' + + +def validator( + *fields: str, + pre: bool = False, + each_item: bool = False, + always: bool = False, + check_fields: bool = True, + whole: Optional[bool] = None, + allow_reuse: bool = False, +) -> Callable[[AnyCallable], 'AnyClassMethod']: + """ + Decorate methods on the class indicating that they should be used to validate fields + :param fields: which field(s) the method should be called on + :param pre: whether or not this validator should be called before the standard validators (else after) + :param each_item: for complex objects (sets, lists etc.) whether to validate individual elements rather than the + whole object + :param always: whether this method and other validators should be called even if the value is missing + :param check_fields: whether to check that the fields actually exist on the model + :param allow_reuse: whether to track and raise an error if another validator refers to the decorated function + """ + if not fields: + raise ConfigError('validator with no fields specified') + elif isinstance(fields[0], FunctionType): + raise ConfigError( + "validators should be used with fields and keyword arguments, not bare. " # noqa: Q000 + "E.g. usage should be `@validator('', ...)`" + ) + elif not all(isinstance(field, str) for field in fields): + raise ConfigError( + "validator fields should be passed as separate string args. " # noqa: Q000 + "E.g. usage should be `@validator('', '', ...)`" + ) + + if whole is not None: + warnings.warn( + 'The "whole" keyword argument is deprecated, use "each_item" (inverse meaning, default False) instead', + DeprecationWarning, + ) + assert each_item is False, '"each_item" and "whole" conflict, remove "whole"' + each_item = not whole + + def dec(f: AnyCallable) -> 'AnyClassMethod': + f_cls = _prepare_validator(f, allow_reuse) + setattr( + f_cls, + VALIDATOR_CONFIG_KEY, + ( + fields, + Validator(func=f_cls.__func__, pre=pre, each_item=each_item, always=always, check_fields=check_fields), + ), + ) + return f_cls + + return dec + + +@overload +def root_validator(_func: AnyCallable) -> 'AnyClassMethod': + ... + + +@overload +def root_validator( + *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False +) -> Callable[[AnyCallable], 'AnyClassMethod']: + ... + + +def root_validator( + _func: Optional[AnyCallable] = None, *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False +) -> Union['AnyClassMethod', Callable[[AnyCallable], 'AnyClassMethod']]: + """ + Decorate methods on a model indicating that they should be used to validate (and perhaps modify) data either + before or after standard model parsing/validation is performed. + """ + if _func: + f_cls = _prepare_validator(_func, allow_reuse) + setattr( + f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure) + ) + return f_cls + + def dec(f: AnyCallable) -> 'AnyClassMethod': + f_cls = _prepare_validator(f, allow_reuse) + setattr( + f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure) + ) + return f_cls + + return dec + + +def _prepare_validator(function: AnyCallable, allow_reuse: bool) -> 'AnyClassMethod': + """ + Avoid validators with duplicated names since without this, validators can be overwritten silently + which generally isn't the intended behaviour, don't run in ipython (see #312) or if allow_reuse is False. + """ + f_cls = function if isinstance(function, classmethod) else classmethod(function) + if not in_ipython() and not allow_reuse: + ref = ( + getattr(f_cls.__func__, '__module__', '') + + '.' + + getattr(f_cls.__func__, '__qualname__', f'') + ) + if ref in _FUNCS: + raise ConfigError(f'duplicate validator function "{ref}"; if this is intended, set `allow_reuse=True`') + _FUNCS.add(ref) + return f_cls + + +class ValidatorGroup: + def __init__(self, validators: 'ValidatorListDict') -> None: + self.validators = validators + self.used_validators = {'*'} + + def get_validators(self, name: str) -> Optional[Dict[str, Validator]]: + self.used_validators.add(name) + validators = self.validators.get(name, []) + if name != ROOT_KEY: + validators += self.validators.get('*', []) + if validators: + return {getattr(v.func, '__name__', f''): v for v in validators} + else: + return None + + def check_for_unused(self) -> None: + unused_validators = set( + chain.from_iterable( + ( + getattr(v.func, '__name__', f'') + for v in self.validators[f] + if v.check_fields + ) + for f in (self.validators.keys() - self.used_validators) + ) + ) + if unused_validators: + fn = ', '.join(unused_validators) + raise ConfigError( + f"Validators defined with incorrect fields: {fn} " # noqa: Q000 + f"(use check_fields=False if you're inheriting from the model and intended this)" + ) + + +def extract_validators(namespace: Dict[str, Any]) -> Dict[str, List[Validator]]: + validators: Dict[str, List[Validator]] = {} + for var_name, value in namespace.items(): + validator_config = getattr(value, VALIDATOR_CONFIG_KEY, None) + if validator_config: + fields, v = validator_config + for field in fields: + if field in validators: + validators[field].append(v) + else: + validators[field] = [v] + return validators + + +def extract_root_validators(namespace: Dict[str, Any]) -> Tuple[List[AnyCallable], List[Tuple[bool, AnyCallable]]]: + from inspect import signature + + pre_validators: List[AnyCallable] = [] + post_validators: List[Tuple[bool, AnyCallable]] = [] + for name, value in namespace.items(): + validator_config: Optional[Validator] = getattr(value, ROOT_VALIDATOR_CONFIG_KEY, None) + if validator_config: + sig = signature(validator_config.func) + args = list(sig.parameters.keys()) + if args[0] == 'self': + raise ConfigError( + f'Invalid signature for root validator {name}: {sig}, "self" not permitted as first argument, ' + f'should be: (cls, values).' + ) + if len(args) != 2: + raise ConfigError(f'Invalid signature for root validator {name}: {sig}, should be: (cls, values).') + # check function signature + if validator_config.pre: + pre_validators.append(validator_config.func) + else: + post_validators.append((validator_config.skip_on_failure, validator_config.func)) + return pre_validators, post_validators + + +def inherit_validators(base_validators: 'ValidatorListDict', validators: 'ValidatorListDict') -> 'ValidatorListDict': + for field, field_validators in base_validators.items(): + if field not in validators: + validators[field] = [] + validators[field] += field_validators + return validators + + +def make_generic_validator(validator: AnyCallable) -> 'ValidatorCallable': + """ + Make a generic function which calls a validator with the right arguments. + + Unfortunately other approaches (eg. return a partial of a function that builds the arguments) is slow, + hence this laborious way of doing things. + + It's done like this so validators don't all need **kwargs in their signature, eg. any combination of + the arguments "values", "fields" and/or "config" are permitted. + """ + from inspect import signature + + if not isinstance(validator, (partial, partialmethod)): + # This should be the default case, so overhead is reduced + sig = signature(validator) + args = list(sig.parameters.keys()) + else: + # Fix the generated argument lists of partial methods + sig = signature(validator.func) + args = [ + k + for k in signature(validator.func).parameters.keys() + if k not in validator.args | validator.keywords.keys() + ] + + first_arg = args.pop(0) + if first_arg == 'self': + raise ConfigError( + f'Invalid signature for validator {validator}: {sig}, "self" not permitted as first argument, ' + f'should be: (cls, value, values, config, field), "values", "config" and "field" are all optional.' + ) + elif first_arg == 'cls': + # assume the second argument is value + return wraps(validator)(_generic_validator_cls(validator, sig, set(args[1:]))) + else: + # assume the first argument was value which has already been removed + return wraps(validator)(_generic_validator_basic(validator, sig, set(args))) + + +def prep_validators(v_funcs: Iterable[AnyCallable]) -> 'ValidatorsList': + return [make_generic_validator(f) for f in v_funcs if f] + + +all_kwargs = {'values', 'field', 'config'} + + +def _generic_validator_cls(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable': + # assume the first argument is value + has_kwargs = False + if 'kwargs' in args: + has_kwargs = True + args -= {'kwargs'} + + if not args.issubset(all_kwargs): + raise ConfigError( + f'Invalid signature for validator {validator}: {sig}, should be: ' + f'(cls, value, values, config, field), "values", "config" and "field" are all optional.' + ) + + if has_kwargs: + return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config) + elif args == set(): + return lambda cls, v, values, field, config: validator(cls, v) + elif args == {'values'}: + return lambda cls, v, values, field, config: validator(cls, v, values=values) + elif args == {'field'}: + return lambda cls, v, values, field, config: validator(cls, v, field=field) + elif args == {'config'}: + return lambda cls, v, values, field, config: validator(cls, v, config=config) + elif args == {'values', 'field'}: + return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field) + elif args == {'values', 'config'}: + return lambda cls, v, values, field, config: validator(cls, v, values=values, config=config) + elif args == {'field', 'config'}: + return lambda cls, v, values, field, config: validator(cls, v, field=field, config=config) + else: + # args == {'values', 'field', 'config'} + return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config) + + +def _generic_validator_basic(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable': + has_kwargs = False + if 'kwargs' in args: + has_kwargs = True + args -= {'kwargs'} + + if not args.issubset(all_kwargs): + raise ConfigError( + f'Invalid signature for validator {validator}: {sig}, should be: ' + f'(value, values, config, field), "values", "config" and "field" are all optional.' + ) + + if has_kwargs: + return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config) + elif args == set(): + return lambda cls, v, values, field, config: validator(v) + elif args == {'values'}: + return lambda cls, v, values, field, config: validator(v, values=values) + elif args == {'field'}: + return lambda cls, v, values, field, config: validator(v, field=field) + elif args == {'config'}: + return lambda cls, v, values, field, config: validator(v, config=config) + elif args == {'values', 'field'}: + return lambda cls, v, values, field, config: validator(v, values=values, field=field) + elif args == {'values', 'config'}: + return lambda cls, v, values, field, config: validator(v, values=values, config=config) + elif args == {'field', 'config'}: + return lambda cls, v, values, field, config: validator(v, field=field, config=config) + else: + # args == {'values', 'field', 'config'} + return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config) + + +def gather_all_validators(type_: 'ModelOrDc') -> Dict[str, 'AnyClassMethod']: + all_attributes = ChainMap(*[cls.__dict__ for cls in type_.__mro__]) # type: ignore[arg-type,var-annotated] + return { + k: v + for k, v in all_attributes.items() + if hasattr(v, VALIDATOR_CONFIG_KEY) or hasattr(v, ROOT_VALIDATOR_CONFIG_KEY) + } diff --git a/lib/pydantic/v1/color.py b/lib/pydantic/v1/color.py new file mode 100644 index 00000000..6fdc9fb1 --- /dev/null +++ b/lib/pydantic/v1/color.py @@ -0,0 +1,494 @@ +""" +Color definitions are used as per CSS3 specification: +http://www.w3.org/TR/css3-color/#svg-color + +A few colors have multiple names referring to the sames colors, eg. `grey` and `gray` or `aqua` and `cyan`. + +In these cases the LAST color when sorted alphabetically takes preferences, +eg. Color((0, 255, 255)).as_named() == 'cyan' because "cyan" comes after "aqua". +""" +import math +import re +from colorsys import hls_to_rgb, rgb_to_hls +from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union, cast + +from .errors import ColorError +from .utils import Representation, almost_equal_floats + +if TYPE_CHECKING: + from .typing import CallableGenerator, ReprArgs + +ColorTuple = Union[Tuple[int, int, int], Tuple[int, int, int, float]] +ColorType = Union[ColorTuple, str] +HslColorTuple = Union[Tuple[float, float, float], Tuple[float, float, float, float]] + + +class RGBA: + """ + Internal use only as a representation of a color. + """ + + __slots__ = 'r', 'g', 'b', 'alpha', '_tuple' + + def __init__(self, r: float, g: float, b: float, alpha: Optional[float]): + self.r = r + self.g = g + self.b = b + self.alpha = alpha + + self._tuple: Tuple[float, float, float, Optional[float]] = (r, g, b, alpha) + + def __getitem__(self, item: Any) -> Any: + return self._tuple[item] + + +# these are not compiled here to avoid import slowdown, they'll be compiled the first time they're used, then cached +r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*' +r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*' +_r_255 = r'(\d{1,3}(?:\.\d+)?)' +_r_comma = r'\s*,\s*' +r_rgb = fr'\s*rgb\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}\)\s*' +_r_alpha = r'(\d(?:\.\d+)?|\.\d+|\d{1,2}%)' +r_rgba = fr'\s*rgba\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_alpha}\s*\)\s*' +_r_h = r'(-?\d+(?:\.\d+)?|-?\.\d+)(deg|rad|turn)?' +_r_sl = r'(\d{1,3}(?:\.\d+)?)%' +r_hsl = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}\s*\)\s*' +r_hsla = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}{_r_comma}{_r_alpha}\s*\)\s*' + +# colors where the two hex characters are the same, if all colors match this the short version of hex colors can be used +repeat_colors = {int(c * 2, 16) for c in '0123456789abcdef'} +rads = 2 * math.pi + + +class Color(Representation): + __slots__ = '_original', '_rgba' + + def __init__(self, value: ColorType) -> None: + self._rgba: RGBA + self._original: ColorType + if isinstance(value, (tuple, list)): + self._rgba = parse_tuple(value) + elif isinstance(value, str): + self._rgba = parse_str(value) + elif isinstance(value, Color): + self._rgba = value._rgba + value = value._original + else: + raise ColorError(reason='value must be a tuple, list or string') + + # if we've got here value must be a valid color + self._original = value + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='color') + + def original(self) -> ColorType: + """ + Original value passed to Color + """ + return self._original + + def as_named(self, *, fallback: bool = False) -> str: + if self._rgba.alpha is None: + rgb = cast(Tuple[int, int, int], self.as_rgb_tuple()) + try: + return COLORS_BY_VALUE[rgb] + except KeyError as e: + if fallback: + return self.as_hex() + else: + raise ValueError('no named color found, use fallback=True, as_hex() or as_rgb()') from e + else: + return self.as_hex() + + def as_hex(self) -> str: + """ + Hex string representing the color can be 3, 4, 6 or 8 characters depending on whether the string + a "short" representation of the color is possible and whether there's an alpha channel. + """ + values = [float_to_255(c) for c in self._rgba[:3]] + if self._rgba.alpha is not None: + values.append(float_to_255(self._rgba.alpha)) + + as_hex = ''.join(f'{v:02x}' for v in values) + if all(c in repeat_colors for c in values): + as_hex = ''.join(as_hex[c] for c in range(0, len(as_hex), 2)) + return '#' + as_hex + + def as_rgb(self) -> str: + """ + Color as an rgb(, , ) or rgba(, , , ) string. + """ + if self._rgba.alpha is None: + return f'rgb({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)})' + else: + return ( + f'rgba({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)}, ' + f'{round(self._alpha_float(), 2)})' + ) + + def as_rgb_tuple(self, *, alpha: Optional[bool] = None) -> ColorTuple: + """ + Color as an RGB or RGBA tuple; red, green and blue are in the range 0 to 255, alpha if included is + in the range 0 to 1. + + :param alpha: whether to include the alpha channel, options are + None - (default) include alpha only if it's set (e.g. not None) + True - always include alpha, + False - always omit alpha, + """ + r, g, b = (float_to_255(c) for c in self._rgba[:3]) + if alpha is None: + if self._rgba.alpha is None: + return r, g, b + else: + return r, g, b, self._alpha_float() + elif alpha: + return r, g, b, self._alpha_float() + else: + # alpha is False + return r, g, b + + def as_hsl(self) -> str: + """ + Color as an hsl(, , ) or hsl(, , , ) string. + """ + if self._rgba.alpha is None: + h, s, li = self.as_hsl_tuple(alpha=False) # type: ignore + return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%})' + else: + h, s, li, a = self.as_hsl_tuple(alpha=True) # type: ignore + return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%}, {round(a, 2)})' + + def as_hsl_tuple(self, *, alpha: Optional[bool] = None) -> HslColorTuple: + """ + Color as an HSL or HSLA tuple, e.g. hue, saturation, lightness and optionally alpha; all elements are in + the range 0 to 1. + + NOTE: this is HSL as used in HTML and most other places, not HLS as used in python's colorsys. + + :param alpha: whether to include the alpha channel, options are + None - (default) include alpha only if it's set (e.g. not None) + True - always include alpha, + False - always omit alpha, + """ + h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b) + if alpha is None: + if self._rgba.alpha is None: + return h, s, l + else: + return h, s, l, self._alpha_float() + if alpha: + return h, s, l, self._alpha_float() + else: + # alpha is False + return h, s, l + + def _alpha_float(self) -> float: + return 1 if self._rgba.alpha is None else self._rgba.alpha + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls + + def __str__(self) -> str: + return self.as_named(fallback=True) + + def __repr_args__(self) -> 'ReprArgs': + return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())] # type: ignore + + def __eq__(self, other: Any) -> bool: + return isinstance(other, Color) and self.as_rgb_tuple() == other.as_rgb_tuple() + + def __hash__(self) -> int: + return hash(self.as_rgb_tuple()) + + +def parse_tuple(value: Tuple[Any, ...]) -> RGBA: + """ + Parse a tuple or list as a color. + """ + if len(value) == 3: + r, g, b = (parse_color_value(v) for v in value) + return RGBA(r, g, b, None) + elif len(value) == 4: + r, g, b = (parse_color_value(v) for v in value[:3]) + return RGBA(r, g, b, parse_float_alpha(value[3])) + else: + raise ColorError(reason='tuples must have length 3 or 4') + + +def parse_str(value: str) -> RGBA: + """ + Parse a string to an RGBA tuple, trying the following formats (in this order): + * named color, see COLORS_BY_NAME below + * hex short eg. `fff` (prefix can be `#`, `0x` or nothing) + * hex long eg. `ffffff` (prefix can be `#`, `0x` or nothing) + * `rgb(, , ) ` + * `rgba(, , , )` + """ + value_lower = value.lower() + try: + r, g, b = COLORS_BY_NAME[value_lower] + except KeyError: + pass + else: + return ints_to_rgba(r, g, b, None) + + m = re.fullmatch(r_hex_short, value_lower) + if m: + *rgb, a = m.groups() + r, g, b = (int(v * 2, 16) for v in rgb) + if a: + alpha: Optional[float] = int(a * 2, 16) / 255 + else: + alpha = None + return ints_to_rgba(r, g, b, alpha) + + m = re.fullmatch(r_hex_long, value_lower) + if m: + *rgb, a = m.groups() + r, g, b = (int(v, 16) for v in rgb) + if a: + alpha = int(a, 16) / 255 + else: + alpha = None + return ints_to_rgba(r, g, b, alpha) + + m = re.fullmatch(r_rgb, value_lower) + if m: + return ints_to_rgba(*m.groups(), None) # type: ignore + + m = re.fullmatch(r_rgba, value_lower) + if m: + return ints_to_rgba(*m.groups()) # type: ignore + + m = re.fullmatch(r_hsl, value_lower) + if m: + h, h_units, s, l_ = m.groups() + return parse_hsl(h, h_units, s, l_) + + m = re.fullmatch(r_hsla, value_lower) + if m: + h, h_units, s, l_, a = m.groups() + return parse_hsl(h, h_units, s, l_, parse_float_alpha(a)) + + raise ColorError(reason='string not recognised as a valid color') + + +def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float]) -> RGBA: + return RGBA(parse_color_value(r), parse_color_value(g), parse_color_value(b), parse_float_alpha(alpha)) + + +def parse_color_value(value: Union[int, str], max_val: int = 255) -> float: + """ + Parse a value checking it's a valid int in the range 0 to max_val and divide by max_val to give a number + in the range 0 to 1 + """ + try: + color = float(value) + except ValueError: + raise ColorError(reason='color values must be a valid number') + if 0 <= color <= max_val: + return color / max_val + else: + raise ColorError(reason=f'color values must be in the range 0 to {max_val}') + + +def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]: + """ + Parse a value checking it's a valid float in the range 0 to 1 + """ + if value is None: + return None + try: + if isinstance(value, str) and value.endswith('%'): + alpha = float(value[:-1]) / 100 + else: + alpha = float(value) + except ValueError: + raise ColorError(reason='alpha values must be a valid float') + + if almost_equal_floats(alpha, 1): + return None + elif 0 <= alpha <= 1: + return alpha + else: + raise ColorError(reason='alpha values must be in the range 0 to 1') + + +def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float] = None) -> RGBA: + """ + Parse raw hue, saturation, lightness and alpha values and convert to RGBA. + """ + s_value, l_value = parse_color_value(sat, 100), parse_color_value(light, 100) + + h_value = float(h) + if h_units in {None, 'deg'}: + h_value = h_value % 360 / 360 + elif h_units == 'rad': + h_value = h_value % rads / rads + else: + # turns + h_value = h_value % 1 + + r, g, b = hls_to_rgb(h_value, l_value, s_value) + return RGBA(r, g, b, alpha) + + +def float_to_255(c: float) -> int: + return int(round(c * 255)) + + +COLORS_BY_NAME = { + 'aliceblue': (240, 248, 255), + 'antiquewhite': (250, 235, 215), + 'aqua': (0, 255, 255), + 'aquamarine': (127, 255, 212), + 'azure': (240, 255, 255), + 'beige': (245, 245, 220), + 'bisque': (255, 228, 196), + 'black': (0, 0, 0), + 'blanchedalmond': (255, 235, 205), + 'blue': (0, 0, 255), + 'blueviolet': (138, 43, 226), + 'brown': (165, 42, 42), + 'burlywood': (222, 184, 135), + 'cadetblue': (95, 158, 160), + 'chartreuse': (127, 255, 0), + 'chocolate': (210, 105, 30), + 'coral': (255, 127, 80), + 'cornflowerblue': (100, 149, 237), + 'cornsilk': (255, 248, 220), + 'crimson': (220, 20, 60), + 'cyan': (0, 255, 255), + 'darkblue': (0, 0, 139), + 'darkcyan': (0, 139, 139), + 'darkgoldenrod': (184, 134, 11), + 'darkgray': (169, 169, 169), + 'darkgreen': (0, 100, 0), + 'darkgrey': (169, 169, 169), + 'darkkhaki': (189, 183, 107), + 'darkmagenta': (139, 0, 139), + 'darkolivegreen': (85, 107, 47), + 'darkorange': (255, 140, 0), + 'darkorchid': (153, 50, 204), + 'darkred': (139, 0, 0), + 'darksalmon': (233, 150, 122), + 'darkseagreen': (143, 188, 143), + 'darkslateblue': (72, 61, 139), + 'darkslategray': (47, 79, 79), + 'darkslategrey': (47, 79, 79), + 'darkturquoise': (0, 206, 209), + 'darkviolet': (148, 0, 211), + 'deeppink': (255, 20, 147), + 'deepskyblue': (0, 191, 255), + 'dimgray': (105, 105, 105), + 'dimgrey': (105, 105, 105), + 'dodgerblue': (30, 144, 255), + 'firebrick': (178, 34, 34), + 'floralwhite': (255, 250, 240), + 'forestgreen': (34, 139, 34), + 'fuchsia': (255, 0, 255), + 'gainsboro': (220, 220, 220), + 'ghostwhite': (248, 248, 255), + 'gold': (255, 215, 0), + 'goldenrod': (218, 165, 32), + 'gray': (128, 128, 128), + 'green': (0, 128, 0), + 'greenyellow': (173, 255, 47), + 'grey': (128, 128, 128), + 'honeydew': (240, 255, 240), + 'hotpink': (255, 105, 180), + 'indianred': (205, 92, 92), + 'indigo': (75, 0, 130), + 'ivory': (255, 255, 240), + 'khaki': (240, 230, 140), + 'lavender': (230, 230, 250), + 'lavenderblush': (255, 240, 245), + 'lawngreen': (124, 252, 0), + 'lemonchiffon': (255, 250, 205), + 'lightblue': (173, 216, 230), + 'lightcoral': (240, 128, 128), + 'lightcyan': (224, 255, 255), + 'lightgoldenrodyellow': (250, 250, 210), + 'lightgray': (211, 211, 211), + 'lightgreen': (144, 238, 144), + 'lightgrey': (211, 211, 211), + 'lightpink': (255, 182, 193), + 'lightsalmon': (255, 160, 122), + 'lightseagreen': (32, 178, 170), + 'lightskyblue': (135, 206, 250), + 'lightslategray': (119, 136, 153), + 'lightslategrey': (119, 136, 153), + 'lightsteelblue': (176, 196, 222), + 'lightyellow': (255, 255, 224), + 'lime': (0, 255, 0), + 'limegreen': (50, 205, 50), + 'linen': (250, 240, 230), + 'magenta': (255, 0, 255), + 'maroon': (128, 0, 0), + 'mediumaquamarine': (102, 205, 170), + 'mediumblue': (0, 0, 205), + 'mediumorchid': (186, 85, 211), + 'mediumpurple': (147, 112, 219), + 'mediumseagreen': (60, 179, 113), + 'mediumslateblue': (123, 104, 238), + 'mediumspringgreen': (0, 250, 154), + 'mediumturquoise': (72, 209, 204), + 'mediumvioletred': (199, 21, 133), + 'midnightblue': (25, 25, 112), + 'mintcream': (245, 255, 250), + 'mistyrose': (255, 228, 225), + 'moccasin': (255, 228, 181), + 'navajowhite': (255, 222, 173), + 'navy': (0, 0, 128), + 'oldlace': (253, 245, 230), + 'olive': (128, 128, 0), + 'olivedrab': (107, 142, 35), + 'orange': (255, 165, 0), + 'orangered': (255, 69, 0), + 'orchid': (218, 112, 214), + 'palegoldenrod': (238, 232, 170), + 'palegreen': (152, 251, 152), + 'paleturquoise': (175, 238, 238), + 'palevioletred': (219, 112, 147), + 'papayawhip': (255, 239, 213), + 'peachpuff': (255, 218, 185), + 'peru': (205, 133, 63), + 'pink': (255, 192, 203), + 'plum': (221, 160, 221), + 'powderblue': (176, 224, 230), + 'purple': (128, 0, 128), + 'red': (255, 0, 0), + 'rosybrown': (188, 143, 143), + 'royalblue': (65, 105, 225), + 'saddlebrown': (139, 69, 19), + 'salmon': (250, 128, 114), + 'sandybrown': (244, 164, 96), + 'seagreen': (46, 139, 87), + 'seashell': (255, 245, 238), + 'sienna': (160, 82, 45), + 'silver': (192, 192, 192), + 'skyblue': (135, 206, 235), + 'slateblue': (106, 90, 205), + 'slategray': (112, 128, 144), + 'slategrey': (112, 128, 144), + 'snow': (255, 250, 250), + 'springgreen': (0, 255, 127), + 'steelblue': (70, 130, 180), + 'tan': (210, 180, 140), + 'teal': (0, 128, 128), + 'thistle': (216, 191, 216), + 'tomato': (255, 99, 71), + 'turquoise': (64, 224, 208), + 'violet': (238, 130, 238), + 'wheat': (245, 222, 179), + 'white': (255, 255, 255), + 'whitesmoke': (245, 245, 245), + 'yellow': (255, 255, 0), + 'yellowgreen': (154, 205, 50), +} + +COLORS_BY_VALUE = {v: k for k, v in COLORS_BY_NAME.items()} diff --git a/lib/pydantic/v1/config.py b/lib/pydantic/v1/config.py new file mode 100644 index 00000000..a25973af --- /dev/null +++ b/lib/pydantic/v1/config.py @@ -0,0 +1,191 @@ +import json +from enum import Enum +from typing import TYPE_CHECKING, Any, Callable, Dict, ForwardRef, Optional, Tuple, Type, Union + +from typing_extensions import Literal, Protocol + +from .typing import AnyArgTCallable, AnyCallable +from .utils import GetterDict +from .version import compiled + +if TYPE_CHECKING: + from typing import overload + + from .fields import ModelField + from .main import BaseModel + + ConfigType = Type['BaseConfig'] + + class SchemaExtraCallable(Protocol): + @overload + def __call__(self, schema: Dict[str, Any]) -> None: + pass + + @overload + def __call__(self, schema: Dict[str, Any], model_class: Type[BaseModel]) -> None: + pass + +else: + SchemaExtraCallable = Callable[..., None] + +__all__ = 'BaseConfig', 'ConfigDict', 'get_config', 'Extra', 'inherit_config', 'prepare_config' + + +class Extra(str, Enum): + allow = 'allow' + ignore = 'ignore' + forbid = 'forbid' + + +# https://github.com/cython/cython/issues/4003 +# Fixed in Cython 3 and Pydantic v1 won't support Cython 3. +# Pydantic v2 doesn't depend on Cython at all. +if not compiled: + from typing_extensions import TypedDict + + class ConfigDict(TypedDict, total=False): + title: Optional[str] + anystr_lower: bool + anystr_strip_whitespace: bool + min_anystr_length: int + max_anystr_length: Optional[int] + validate_all: bool + extra: Extra + allow_mutation: bool + frozen: bool + allow_population_by_field_name: bool + use_enum_values: bool + fields: Dict[str, Union[str, Dict[str, str]]] + validate_assignment: bool + error_msg_templates: Dict[str, str] + arbitrary_types_allowed: bool + orm_mode: bool + getter_dict: Type[GetterDict] + alias_generator: Optional[Callable[[str], str]] + keep_untouched: Tuple[type, ...] + schema_extra: Union[Dict[str, object], 'SchemaExtraCallable'] + json_loads: Callable[[str], object] + json_dumps: AnyArgTCallable[str] + json_encoders: Dict[Type[object], AnyCallable] + underscore_attrs_are_private: bool + allow_inf_nan: bool + copy_on_model_validation: Literal['none', 'deep', 'shallow'] + # whether dataclass `__post_init__` should be run after validation + post_init_call: Literal['before_validation', 'after_validation'] + +else: + ConfigDict = dict # type: ignore + + +class BaseConfig: + title: Optional[str] = None + anystr_lower: bool = False + anystr_upper: bool = False + anystr_strip_whitespace: bool = False + min_anystr_length: int = 0 + max_anystr_length: Optional[int] = None + validate_all: bool = False + extra: Extra = Extra.ignore + allow_mutation: bool = True + frozen: bool = False + allow_population_by_field_name: bool = False + use_enum_values: bool = False + fields: Dict[str, Union[str, Dict[str, str]]] = {} + validate_assignment: bool = False + error_msg_templates: Dict[str, str] = {} + arbitrary_types_allowed: bool = False + orm_mode: bool = False + getter_dict: Type[GetterDict] = GetterDict + alias_generator: Optional[Callable[[str], str]] = None + keep_untouched: Tuple[type, ...] = () + schema_extra: Union[Dict[str, Any], 'SchemaExtraCallable'] = {} + json_loads: Callable[[str], Any] = json.loads + json_dumps: Callable[..., str] = json.dumps + json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable] = {} + underscore_attrs_are_private: bool = False + allow_inf_nan: bool = True + + # whether inherited models as fields should be reconstructed as base model, + # and whether such a copy should be shallow or deep + copy_on_model_validation: Literal['none', 'deep', 'shallow'] = 'shallow' + + # whether `Union` should check all allowed types before even trying to coerce + smart_union: bool = False + # whether dataclass `__post_init__` should be run before or after validation + post_init_call: Literal['before_validation', 'after_validation'] = 'before_validation' + + @classmethod + def get_field_info(cls, name: str) -> Dict[str, Any]: + """ + Get properties of FieldInfo from the `fields` property of the config class. + """ + + fields_value = cls.fields.get(name) + + if isinstance(fields_value, str): + field_info: Dict[str, Any] = {'alias': fields_value} + elif isinstance(fields_value, dict): + field_info = fields_value + else: + field_info = {} + + if 'alias' in field_info: + field_info.setdefault('alias_priority', 2) + + if field_info.get('alias_priority', 0) <= 1 and cls.alias_generator: + alias = cls.alias_generator(name) + if not isinstance(alias, str): + raise TypeError(f'Config.alias_generator must return str, not {alias.__class__}') + field_info.update(alias=alias, alias_priority=1) + return field_info + + @classmethod + def prepare_field(cls, field: 'ModelField') -> None: + """ + Optional hook to check or modify fields during model creation. + """ + pass + + +def get_config(config: Union[ConfigDict, Type[object], None]) -> Type[BaseConfig]: + if config is None: + return BaseConfig + + else: + config_dict = ( + config + if isinstance(config, dict) + else {k: getattr(config, k) for k in dir(config) if not k.startswith('__')} + ) + + class Config(BaseConfig): + ... + + for k, v in config_dict.items(): + setattr(Config, k, v) + return Config + + +def inherit_config(self_config: 'ConfigType', parent_config: 'ConfigType', **namespace: Any) -> 'ConfigType': + if not self_config: + base_classes: Tuple['ConfigType', ...] = (parent_config,) + elif self_config == parent_config: + base_classes = (self_config,) + else: + base_classes = self_config, parent_config + + namespace['json_encoders'] = { + **getattr(parent_config, 'json_encoders', {}), + **getattr(self_config, 'json_encoders', {}), + **namespace.get('json_encoders', {}), + } + + return type('Config', base_classes, namespace) + + +def prepare_config(config: Type[BaseConfig], cls_name: str) -> None: + if not isinstance(config.extra, Extra): + try: + config.extra = Extra(config.extra) + except ValueError: + raise ValueError(f'"{cls_name}": {config.extra} is not a valid value for "extra"') diff --git a/lib/pydantic/v1/dataclasses.py b/lib/pydantic/v1/dataclasses.py new file mode 100644 index 00000000..2df3987a --- /dev/null +++ b/lib/pydantic/v1/dataclasses.py @@ -0,0 +1,500 @@ +""" +The main purpose is to enhance stdlib dataclasses by adding validation +A pydantic dataclass can be generated from scratch or from a stdlib one. + +Behind the scene, a pydantic dataclass is just like a regular one on which we attach +a `BaseModel` and magic methods to trigger the validation of the data. +`__init__` and `__post_init__` are hence overridden and have extra logic to be +able to validate input data. + +When a pydantic dataclass is generated from scratch, it's just a plain dataclass +with validation triggered at initialization + +The tricky part if for stdlib dataclasses that are converted after into pydantic ones e.g. + +```py +@dataclasses.dataclass +class M: + x: int + +ValidatedM = pydantic.dataclasses.dataclass(M) +``` + +We indeed still want to support equality, hashing, repr, ... as if it was the stdlib one! + +```py +assert isinstance(ValidatedM(x=1), M) +assert ValidatedM(x=1) == M(x=1) +``` + +This means we **don't want to create a new dataclass that inherits from it** +The trick is to create a wrapper around `M` that will act as a proxy to trigger +validation without altering default `M` behaviour. +""" +import copy +import dataclasses +import sys +from contextlib import contextmanager +from functools import wraps + +try: + from functools import cached_property +except ImportError: + # cached_property available only for python3.8+ + pass + +from typing import TYPE_CHECKING, Any, Callable, ClassVar, Dict, Generator, Optional, Type, TypeVar, Union, overload + +from typing_extensions import dataclass_transform + +from .class_validators import gather_all_validators +from .config import BaseConfig, ConfigDict, Extra, get_config +from .error_wrappers import ValidationError +from .errors import DataclassTypeError +from .fields import Field, FieldInfo, Required, Undefined +from .main import create_model, validate_model +from .utils import ClassAttribute + +if TYPE_CHECKING: + from .main import BaseModel + from .typing import CallableGenerator, NoArgAnyCallable + + DataclassT = TypeVar('DataclassT', bound='Dataclass') + + DataclassClassOrWrapper = Union[Type['Dataclass'], 'DataclassProxy'] + + class Dataclass: + # stdlib attributes + __dataclass_fields__: ClassVar[Dict[str, Any]] + __dataclass_params__: ClassVar[Any] # in reality `dataclasses._DataclassParams` + __post_init__: ClassVar[Callable[..., None]] + + # Added by pydantic + __pydantic_run_validation__: ClassVar[bool] + __post_init_post_parse__: ClassVar[Callable[..., None]] + __pydantic_initialised__: ClassVar[bool] + __pydantic_model__: ClassVar[Type[BaseModel]] + __pydantic_validate_values__: ClassVar[Callable[['Dataclass'], None]] + __pydantic_has_field_info_default__: ClassVar[bool] # whether a `pydantic.Field` is used as default value + + def __init__(self, *args: object, **kwargs: object) -> None: + pass + + @classmethod + def __get_validators__(cls: Type['Dataclass']) -> 'CallableGenerator': + pass + + @classmethod + def __validate__(cls: Type['DataclassT'], v: Any) -> 'DataclassT': + pass + + +__all__ = [ + 'dataclass', + 'set_validation', + 'create_pydantic_model_from_dataclass', + 'is_builtin_dataclass', + 'make_dataclass_validator', +] + +_T = TypeVar('_T') + +if sys.version_info >= (3, 10): + + @dataclass_transform(field_specifiers=(dataclasses.field, Field)) + @overload + def dataclass( + *, + init: bool = True, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: Union[ConfigDict, Type[object], None] = None, + validate_on_init: Optional[bool] = None, + use_proxy: Optional[bool] = None, + kw_only: bool = ..., + ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']: + ... + + @dataclass_transform(field_specifiers=(dataclasses.field, Field)) + @overload + def dataclass( + _cls: Type[_T], + *, + init: bool = True, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: Union[ConfigDict, Type[object], None] = None, + validate_on_init: Optional[bool] = None, + use_proxy: Optional[bool] = None, + kw_only: bool = ..., + ) -> 'DataclassClassOrWrapper': + ... + +else: + + @dataclass_transform(field_specifiers=(dataclasses.field, Field)) + @overload + def dataclass( + *, + init: bool = True, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: Union[ConfigDict, Type[object], None] = None, + validate_on_init: Optional[bool] = None, + use_proxy: Optional[bool] = None, + ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']: + ... + + @dataclass_transform(field_specifiers=(dataclasses.field, Field)) + @overload + def dataclass( + _cls: Type[_T], + *, + init: bool = True, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: Union[ConfigDict, Type[object], None] = None, + validate_on_init: Optional[bool] = None, + use_proxy: Optional[bool] = None, + ) -> 'DataclassClassOrWrapper': + ... + + +@dataclass_transform(field_specifiers=(dataclasses.field, Field)) +def dataclass( + _cls: Optional[Type[_T]] = None, + *, + init: bool = True, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: Union[ConfigDict, Type[object], None] = None, + validate_on_init: Optional[bool] = None, + use_proxy: Optional[bool] = None, + kw_only: bool = False, +) -> Union[Callable[[Type[_T]], 'DataclassClassOrWrapper'], 'DataclassClassOrWrapper']: + """ + Like the python standard lib dataclasses but with type validation. + The result is either a pydantic dataclass that will validate input data + or a wrapper that will trigger validation around a stdlib dataclass + to avoid modifying it directly + """ + the_config = get_config(config) + + def wrap(cls: Type[Any]) -> 'DataclassClassOrWrapper': + should_use_proxy = ( + use_proxy + if use_proxy is not None + else ( + is_builtin_dataclass(cls) + and (cls.__bases__[0] is object or set(dir(cls)) == set(dir(cls.__bases__[0]))) + ) + ) + if should_use_proxy: + dc_cls_doc = '' + dc_cls = DataclassProxy(cls) + default_validate_on_init = False + else: + dc_cls_doc = cls.__doc__ or '' # needs to be done before generating dataclass + if sys.version_info >= (3, 10): + dc_cls = dataclasses.dataclass( + cls, + init=init, + repr=repr, + eq=eq, + order=order, + unsafe_hash=unsafe_hash, + frozen=frozen, + kw_only=kw_only, + ) + else: + dc_cls = dataclasses.dataclass( # type: ignore + cls, init=init, repr=repr, eq=eq, order=order, unsafe_hash=unsafe_hash, frozen=frozen + ) + default_validate_on_init = True + + should_validate_on_init = default_validate_on_init if validate_on_init is None else validate_on_init + _add_pydantic_validation_attributes(cls, the_config, should_validate_on_init, dc_cls_doc) + dc_cls.__pydantic_model__.__try_update_forward_refs__(**{cls.__name__: cls}) + return dc_cls + + if _cls is None: + return wrap + + return wrap(_cls) + + +@contextmanager +def set_validation(cls: Type['DataclassT'], value: bool) -> Generator[Type['DataclassT'], None, None]: + original_run_validation = cls.__pydantic_run_validation__ + try: + cls.__pydantic_run_validation__ = value + yield cls + finally: + cls.__pydantic_run_validation__ = original_run_validation + + +class DataclassProxy: + __slots__ = '__dataclass__' + + def __init__(self, dc_cls: Type['Dataclass']) -> None: + object.__setattr__(self, '__dataclass__', dc_cls) + + def __call__(self, *args: Any, **kwargs: Any) -> Any: + with set_validation(self.__dataclass__, True): + return self.__dataclass__(*args, **kwargs) + + def __getattr__(self, name: str) -> Any: + return getattr(self.__dataclass__, name) + + def __setattr__(self, __name: str, __value: Any) -> None: + return setattr(self.__dataclass__, __name, __value) + + def __instancecheck__(self, instance: Any) -> bool: + return isinstance(instance, self.__dataclass__) + + def __copy__(self) -> 'DataclassProxy': + return DataclassProxy(copy.copy(self.__dataclass__)) + + def __deepcopy__(self, memo: Any) -> 'DataclassProxy': + return DataclassProxy(copy.deepcopy(self.__dataclass__, memo)) + + +def _add_pydantic_validation_attributes( # noqa: C901 (ignore complexity) + dc_cls: Type['Dataclass'], + config: Type[BaseConfig], + validate_on_init: bool, + dc_cls_doc: str, +) -> None: + """ + We need to replace the right method. If no `__post_init__` has been set in the stdlib dataclass + it won't even exist (code is generated on the fly by `dataclasses`) + By default, we run validation after `__init__` or `__post_init__` if defined + """ + init = dc_cls.__init__ + + @wraps(init) + def handle_extra_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None: + if config.extra == Extra.ignore: + init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__}) + + elif config.extra == Extra.allow: + for k, v in kwargs.items(): + self.__dict__.setdefault(k, v) + init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__}) + + else: + init(self, *args, **kwargs) + + if hasattr(dc_cls, '__post_init__'): + try: + post_init = dc_cls.__post_init__.__wrapped__ # type: ignore[attr-defined] + except AttributeError: + post_init = dc_cls.__post_init__ + + @wraps(post_init) + def new_post_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None: + if config.post_init_call == 'before_validation': + post_init(self, *args, **kwargs) + + if self.__class__.__pydantic_run_validation__: + self.__pydantic_validate_values__() + if hasattr(self, '__post_init_post_parse__'): + self.__post_init_post_parse__(*args, **kwargs) + + if config.post_init_call == 'after_validation': + post_init(self, *args, **kwargs) + + setattr(dc_cls, '__init__', handle_extra_init) + setattr(dc_cls, '__post_init__', new_post_init) + + else: + + @wraps(init) + def new_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None: + handle_extra_init(self, *args, **kwargs) + + if self.__class__.__pydantic_run_validation__: + self.__pydantic_validate_values__() + + if hasattr(self, '__post_init_post_parse__'): + # We need to find again the initvars. To do that we use `__dataclass_fields__` instead of + # public method `dataclasses.fields` + + # get all initvars and their default values + initvars_and_values: Dict[str, Any] = {} + for i, f in enumerate(self.__class__.__dataclass_fields__.values()): + if f._field_type is dataclasses._FIELD_INITVAR: # type: ignore[attr-defined] + try: + # set arg value by default + initvars_and_values[f.name] = args[i] + except IndexError: + initvars_and_values[f.name] = kwargs.get(f.name, f.default) + + self.__post_init_post_parse__(**initvars_and_values) + + setattr(dc_cls, '__init__', new_init) + + setattr(dc_cls, '__pydantic_run_validation__', ClassAttribute('__pydantic_run_validation__', validate_on_init)) + setattr(dc_cls, '__pydantic_initialised__', False) + setattr(dc_cls, '__pydantic_model__', create_pydantic_model_from_dataclass(dc_cls, config, dc_cls_doc)) + setattr(dc_cls, '__pydantic_validate_values__', _dataclass_validate_values) + setattr(dc_cls, '__validate__', classmethod(_validate_dataclass)) + setattr(dc_cls, '__get_validators__', classmethod(_get_validators)) + + if dc_cls.__pydantic_model__.__config__.validate_assignment and not dc_cls.__dataclass_params__.frozen: + setattr(dc_cls, '__setattr__', _dataclass_validate_assignment_setattr) + + +def _get_validators(cls: 'DataclassClassOrWrapper') -> 'CallableGenerator': + yield cls.__validate__ + + +def _validate_dataclass(cls: Type['DataclassT'], v: Any) -> 'DataclassT': + with set_validation(cls, True): + if isinstance(v, cls): + v.__pydantic_validate_values__() + return v + elif isinstance(v, (list, tuple)): + return cls(*v) + elif isinstance(v, dict): + return cls(**v) + else: + raise DataclassTypeError(class_name=cls.__name__) + + +def create_pydantic_model_from_dataclass( + dc_cls: Type['Dataclass'], + config: Type[Any] = BaseConfig, + dc_cls_doc: Optional[str] = None, +) -> Type['BaseModel']: + field_definitions: Dict[str, Any] = {} + for field in dataclasses.fields(dc_cls): + default: Any = Undefined + default_factory: Optional['NoArgAnyCallable'] = None + field_info: FieldInfo + + if field.default is not dataclasses.MISSING: + default = field.default + elif field.default_factory is not dataclasses.MISSING: + default_factory = field.default_factory + else: + default = Required + + if isinstance(default, FieldInfo): + field_info = default + dc_cls.__pydantic_has_field_info_default__ = True + else: + field_info = Field(default=default, default_factory=default_factory, **field.metadata) + + field_definitions[field.name] = (field.type, field_info) + + validators = gather_all_validators(dc_cls) + model: Type['BaseModel'] = create_model( + dc_cls.__name__, + __config__=config, + __module__=dc_cls.__module__, + __validators__=validators, + __cls_kwargs__={'__resolve_forward_refs__': False}, + **field_definitions, + ) + model.__doc__ = dc_cls_doc if dc_cls_doc is not None else dc_cls.__doc__ or '' + return model + + +if sys.version_info >= (3, 8): + + def _is_field_cached_property(obj: 'Dataclass', k: str) -> bool: + return isinstance(getattr(type(obj), k, None), cached_property) + +else: + + def _is_field_cached_property(obj: 'Dataclass', k: str) -> bool: + return False + + +def _dataclass_validate_values(self: 'Dataclass') -> None: + # validation errors can occur if this function is called twice on an already initialised dataclass. + # for example if Extra.forbid is enabled, it would consider __pydantic_initialised__ an invalid extra property + if getattr(self, '__pydantic_initialised__'): + return + if getattr(self, '__pydantic_has_field_info_default__', False): + # We need to remove `FieldInfo` values since they are not valid as input + # It's ok to do that because they are obviously the default values! + input_data = { + k: v + for k, v in self.__dict__.items() + if not (isinstance(v, FieldInfo) or _is_field_cached_property(self, k)) + } + else: + input_data = {k: v for k, v in self.__dict__.items() if not _is_field_cached_property(self, k)} + d, _, validation_error = validate_model(self.__pydantic_model__, input_data, cls=self.__class__) + if validation_error: + raise validation_error + self.__dict__.update(d) + object.__setattr__(self, '__pydantic_initialised__', True) + + +def _dataclass_validate_assignment_setattr(self: 'Dataclass', name: str, value: Any) -> None: + if self.__pydantic_initialised__: + d = dict(self.__dict__) + d.pop(name, None) + known_field = self.__pydantic_model__.__fields__.get(name, None) + if known_field: + value, error_ = known_field.validate(value, d, loc=name, cls=self.__class__) + if error_: + raise ValidationError([error_], self.__class__) + + object.__setattr__(self, name, value) + + +def is_builtin_dataclass(_cls: Type[Any]) -> bool: + """ + Whether a class is a stdlib dataclass + (useful to discriminated a pydantic dataclass that is actually a wrapper around a stdlib dataclass) + + we check that + - `_cls` is a dataclass + - `_cls` is not a processed pydantic dataclass (with a basemodel attached) + - `_cls` is not a pydantic dataclass inheriting directly from a stdlib dataclass + e.g. + ``` + @dataclasses.dataclass + class A: + x: int + + @pydantic.dataclasses.dataclass + class B(A): + y: int + ``` + In this case, when we first check `B`, we make an extra check and look at the annotations ('y'), + which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x') + """ + return ( + dataclasses.is_dataclass(_cls) + and not hasattr(_cls, '__pydantic_model__') + and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {}))) + ) + + +def make_dataclass_validator(dc_cls: Type['Dataclass'], config: Type[BaseConfig]) -> 'CallableGenerator': + """ + Create a pydantic.dataclass from a builtin dataclass to add type validation + and yield the validators + It retrieves the parameters of the dataclass and forwards them to the newly created dataclass + """ + yield from _get_validators(dataclass(dc_cls, config=config, use_proxy=True)) diff --git a/lib/pydantic/v1/datetime_parse.py b/lib/pydantic/v1/datetime_parse.py new file mode 100644 index 00000000..cfd54593 --- /dev/null +++ b/lib/pydantic/v1/datetime_parse.py @@ -0,0 +1,248 @@ +""" +Functions to parse datetime objects. + +We're using regular expressions rather than time.strptime because: +- They provide both validation and parsing. +- They're more flexible for datetimes. +- The date/datetime/time constructors produce friendlier error messages. + +Stolen from https://raw.githubusercontent.com/django/django/main/django/utils/dateparse.py at +9718fa2e8abe430c3526a9278dd976443d4ae3c6 + +Changed to: +* use standard python datetime types not django.utils.timezone +* raise ValueError when regex doesn't match rather than returning None +* support parsing unix timestamps for dates and datetimes +""" +import re +from datetime import date, datetime, time, timedelta, timezone +from typing import Dict, Optional, Type, Union + +from . import errors + +date_expr = r'(?P\d{4})-(?P\d{1,2})-(?P\d{1,2})' +time_expr = ( + r'(?P\d{1,2}):(?P\d{1,2})' + r'(?::(?P\d{1,2})(?:\.(?P\d{1,6})\d{0,6})?)?' + r'(?PZ|[+-]\d{2}(?::?\d{2})?)?$' +) + +date_re = re.compile(f'{date_expr}$') +time_re = re.compile(time_expr) +datetime_re = re.compile(f'{date_expr}[T ]{time_expr}') + +standard_duration_re = re.compile( + r'^' + r'(?:(?P-?\d+) (days?, )?)?' + r'((?:(?P-?\d+):)(?=\d+:\d+))?' + r'(?:(?P-?\d+):)?' + r'(?P-?\d+)' + r'(?:\.(?P\d{1,6})\d{0,6})?' + r'$' +) + +# Support the sections of ISO 8601 date representation that are accepted by timedelta +iso8601_duration_re = re.compile( + r'^(?P[-+]?)' + r'P' + r'(?:(?P\d+(.\d+)?)D)?' + r'(?:T' + r'(?:(?P\d+(.\d+)?)H)?' + r'(?:(?P\d+(.\d+)?)M)?' + r'(?:(?P\d+(.\d+)?)S)?' + r')?' + r'$' +) + +EPOCH = datetime(1970, 1, 1) +# if greater than this, the number is in ms, if less than or equal it's in seconds +# (in seconds this is 11th October 2603, in ms it's 20th August 1970) +MS_WATERSHED = int(2e10) +# slightly more than datetime.max in ns - (datetime.max - EPOCH).total_seconds() * 1e9 +MAX_NUMBER = int(3e20) +StrBytesIntFloat = Union[str, bytes, int, float] + + +def get_numeric(value: StrBytesIntFloat, native_expected_type: str) -> Union[None, int, float]: + if isinstance(value, (int, float)): + return value + try: + return float(value) + except ValueError: + return None + except TypeError: + raise TypeError(f'invalid type; expected {native_expected_type}, string, bytes, int or float') + + +def from_unix_seconds(seconds: Union[int, float]) -> datetime: + if seconds > MAX_NUMBER: + return datetime.max + elif seconds < -MAX_NUMBER: + return datetime.min + + while abs(seconds) > MS_WATERSHED: + seconds /= 1000 + dt = EPOCH + timedelta(seconds=seconds) + return dt.replace(tzinfo=timezone.utc) + + +def _parse_timezone(value: Optional[str], error: Type[Exception]) -> Union[None, int, timezone]: + if value == 'Z': + return timezone.utc + elif value is not None: + offset_mins = int(value[-2:]) if len(value) > 3 else 0 + offset = 60 * int(value[1:3]) + offset_mins + if value[0] == '-': + offset = -offset + try: + return timezone(timedelta(minutes=offset)) + except ValueError: + raise error() + else: + return None + + +def parse_date(value: Union[date, StrBytesIntFloat]) -> date: + """ + Parse a date/int/float/string and return a datetime.date. + + Raise ValueError if the input is well formatted but not a valid date. + Raise ValueError if the input isn't well formatted. + """ + if isinstance(value, date): + if isinstance(value, datetime): + return value.date() + else: + return value + + number = get_numeric(value, 'date') + if number is not None: + return from_unix_seconds(number).date() + + if isinstance(value, bytes): + value = value.decode() + + match = date_re.match(value) # type: ignore + if match is None: + raise errors.DateError() + + kw = {k: int(v) for k, v in match.groupdict().items()} + + try: + return date(**kw) + except ValueError: + raise errors.DateError() + + +def parse_time(value: Union[time, StrBytesIntFloat]) -> time: + """ + Parse a time/string and return a datetime.time. + + Raise ValueError if the input is well formatted but not a valid time. + Raise ValueError if the input isn't well formatted, in particular if it contains an offset. + """ + if isinstance(value, time): + return value + + number = get_numeric(value, 'time') + if number is not None: + if number >= 86400: + # doesn't make sense since the time time loop back around to 0 + raise errors.TimeError() + return (datetime.min + timedelta(seconds=number)).time() + + if isinstance(value, bytes): + value = value.decode() + + match = time_re.match(value) # type: ignore + if match is None: + raise errors.TimeError() + + kw = match.groupdict() + if kw['microsecond']: + kw['microsecond'] = kw['microsecond'].ljust(6, '0') + + tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.TimeError) + kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None} + kw_['tzinfo'] = tzinfo + + try: + return time(**kw_) # type: ignore + except ValueError: + raise errors.TimeError() + + +def parse_datetime(value: Union[datetime, StrBytesIntFloat]) -> datetime: + """ + Parse a datetime/int/float/string and return a datetime.datetime. + + This function supports time zone offsets. When the input contains one, + the output uses a timezone with a fixed offset from UTC. + + Raise ValueError if the input is well formatted but not a valid datetime. + Raise ValueError if the input isn't well formatted. + """ + if isinstance(value, datetime): + return value + + number = get_numeric(value, 'datetime') + if number is not None: + return from_unix_seconds(number) + + if isinstance(value, bytes): + value = value.decode() + + match = datetime_re.match(value) # type: ignore + if match is None: + raise errors.DateTimeError() + + kw = match.groupdict() + if kw['microsecond']: + kw['microsecond'] = kw['microsecond'].ljust(6, '0') + + tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.DateTimeError) + kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None} + kw_['tzinfo'] = tzinfo + + try: + return datetime(**kw_) # type: ignore + except ValueError: + raise errors.DateTimeError() + + +def parse_duration(value: StrBytesIntFloat) -> timedelta: + """ + Parse a duration int/float/string and return a datetime.timedelta. + + The preferred format for durations in Django is '%d %H:%M:%S.%f'. + + Also supports ISO 8601 representation. + """ + if isinstance(value, timedelta): + return value + + if isinstance(value, (int, float)): + # below code requires a string + value = f'{value:f}' + elif isinstance(value, bytes): + value = value.decode() + + try: + match = standard_duration_re.match(value) or iso8601_duration_re.match(value) + except TypeError: + raise TypeError('invalid type; expected timedelta, string, bytes, int or float') + + if not match: + raise errors.DurationError() + + kw = match.groupdict() + sign = -1 if kw.pop('sign', '+') == '-' else 1 + if kw.get('microseconds'): + kw['microseconds'] = kw['microseconds'].ljust(6, '0') + + if kw.get('seconds') and kw.get('microseconds') and kw['seconds'].startswith('-'): + kw['microseconds'] = '-' + kw['microseconds'] + + kw_ = {k: float(v) for k, v in kw.items() if v is not None} + + return sign * timedelta(**kw_) diff --git a/lib/pydantic/v1/decorator.py b/lib/pydantic/v1/decorator.py new file mode 100644 index 00000000..089aab65 --- /dev/null +++ b/lib/pydantic/v1/decorator.py @@ -0,0 +1,264 @@ +from functools import wraps +from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload + +from . import validator +from .config import Extra +from .errors import ConfigError +from .main import BaseModel, create_model +from .typing import get_all_type_hints +from .utils import to_camel + +__all__ = ('validate_arguments',) + +if TYPE_CHECKING: + from .typing import AnyCallable + + AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable) + ConfigType = Union[None, Type[Any], Dict[str, Any]] + + +@overload +def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']: + ... + + +@overload +def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT': + ... + + +def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any: + """ + Decorator to validate the arguments passed to a function. + """ + + def validate(_func: 'AnyCallable') -> 'AnyCallable': + vd = ValidatedFunction(_func, config) + + @wraps(_func) + def wrapper_function(*args: Any, **kwargs: Any) -> Any: + return vd.call(*args, **kwargs) + + wrapper_function.vd = vd # type: ignore + wrapper_function.validate = vd.init_model_instance # type: ignore + wrapper_function.raw_function = vd.raw_function # type: ignore + wrapper_function.model = vd.model # type: ignore + return wrapper_function + + if func: + return validate(func) + else: + return validate + + +ALT_V_ARGS = 'v__args' +ALT_V_KWARGS = 'v__kwargs' +V_POSITIONAL_ONLY_NAME = 'v__positional_only' +V_DUPLICATE_KWARGS = 'v__duplicate_kwargs' + + +class ValidatedFunction: + def __init__(self, function: 'AnyCallableT', config: 'ConfigType'): # noqa C901 + from inspect import Parameter, signature + + parameters: Mapping[str, Parameter] = signature(function).parameters + + if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}: + raise ConfigError( + f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" ' + f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator' + ) + + self.raw_function = function + self.arg_mapping: Dict[int, str] = {} + self.positional_only_args = set() + self.v_args_name = 'args' + self.v_kwargs_name = 'kwargs' + + type_hints = get_all_type_hints(function) + takes_args = False + takes_kwargs = False + fields: Dict[str, Tuple[Any, Any]] = {} + for i, (name, p) in enumerate(parameters.items()): + if p.annotation is p.empty: + annotation = Any + else: + annotation = type_hints[name] + + default = ... if p.default is p.empty else p.default + if p.kind == Parameter.POSITIONAL_ONLY: + self.arg_mapping[i] = name + fields[name] = annotation, default + fields[V_POSITIONAL_ONLY_NAME] = List[str], None + self.positional_only_args.add(name) + elif p.kind == Parameter.POSITIONAL_OR_KEYWORD: + self.arg_mapping[i] = name + fields[name] = annotation, default + fields[V_DUPLICATE_KWARGS] = List[str], None + elif p.kind == Parameter.KEYWORD_ONLY: + fields[name] = annotation, default + elif p.kind == Parameter.VAR_POSITIONAL: + self.v_args_name = name + fields[name] = Tuple[annotation, ...], None + takes_args = True + else: + assert p.kind == Parameter.VAR_KEYWORD, p.kind + self.v_kwargs_name = name + fields[name] = Dict[str, annotation], None # type: ignore + takes_kwargs = True + + # these checks avoid a clash between "args" and a field with that name + if not takes_args and self.v_args_name in fields: + self.v_args_name = ALT_V_ARGS + + # same with "kwargs" + if not takes_kwargs and self.v_kwargs_name in fields: + self.v_kwargs_name = ALT_V_KWARGS + + if not takes_args: + # we add the field so validation below can raise the correct exception + fields[self.v_args_name] = List[Any], None + + if not takes_kwargs: + # same with kwargs + fields[self.v_kwargs_name] = Dict[Any, Any], None + + self.create_model(fields, takes_args, takes_kwargs, config) + + def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel: + values = self.build_values(args, kwargs) + return self.model(**values) + + def call(self, *args: Any, **kwargs: Any) -> Any: + m = self.init_model_instance(*args, **kwargs) + return self.execute(m) + + def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]: + values: Dict[str, Any] = {} + if args: + arg_iter = enumerate(args) + while True: + try: + i, a = next(arg_iter) + except StopIteration: + break + arg_name = self.arg_mapping.get(i) + if arg_name is not None: + values[arg_name] = a + else: + values[self.v_args_name] = [a] + [a for _, a in arg_iter] + break + + var_kwargs: Dict[str, Any] = {} + wrong_positional_args = [] + duplicate_kwargs = [] + fields_alias = [ + field.alias + for name, field in self.model.__fields__.items() + if name not in (self.v_args_name, self.v_kwargs_name) + ] + non_var_fields = set(self.model.__fields__) - {self.v_args_name, self.v_kwargs_name} + for k, v in kwargs.items(): + if k in non_var_fields or k in fields_alias: + if k in self.positional_only_args: + wrong_positional_args.append(k) + if k in values: + duplicate_kwargs.append(k) + values[k] = v + else: + var_kwargs[k] = v + + if var_kwargs: + values[self.v_kwargs_name] = var_kwargs + if wrong_positional_args: + values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args + if duplicate_kwargs: + values[V_DUPLICATE_KWARGS] = duplicate_kwargs + return values + + def execute(self, m: BaseModel) -> Any: + d = {k: v for k, v in m._iter() if k in m.__fields_set__ or m.__fields__[k].default_factory} + var_kwargs = d.pop(self.v_kwargs_name, {}) + + if self.v_args_name in d: + args_: List[Any] = [] + in_kwargs = False + kwargs = {} + for name, value in d.items(): + if in_kwargs: + kwargs[name] = value + elif name == self.v_args_name: + args_ += value + in_kwargs = True + else: + args_.append(value) + return self.raw_function(*args_, **kwargs, **var_kwargs) + elif self.positional_only_args: + args_ = [] + kwargs = {} + for name, value in d.items(): + if name in self.positional_only_args: + args_.append(value) + else: + kwargs[name] = value + return self.raw_function(*args_, **kwargs, **var_kwargs) + else: + return self.raw_function(**d, **var_kwargs) + + def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None: + pos_args = len(self.arg_mapping) + + class CustomConfig: + pass + + if not TYPE_CHECKING: # pragma: no branch + if isinstance(config, dict): + CustomConfig = type('Config', (), config) # noqa: F811 + elif config is not None: + CustomConfig = config # noqa: F811 + + if hasattr(CustomConfig, 'fields') or hasattr(CustomConfig, 'alias_generator'): + raise ConfigError( + 'Setting the "fields" and "alias_generator" property on custom Config for ' + '@validate_arguments is not yet supported, please remove.' + ) + + class DecoratorBaseModel(BaseModel): + @validator(self.v_args_name, check_fields=False, allow_reuse=True) + def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]: + if takes_args or v is None: + return v + + raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given') + + @validator(self.v_kwargs_name, check_fields=False, allow_reuse=True) + def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]: + if takes_kwargs or v is None: + return v + + plural = '' if len(v) == 1 else 's' + keys = ', '.join(map(repr, v.keys())) + raise TypeError(f'unexpected keyword argument{plural}: {keys}') + + @validator(V_POSITIONAL_ONLY_NAME, check_fields=False, allow_reuse=True) + def check_positional_only(cls, v: Optional[List[str]]) -> None: + if v is None: + return + + plural = '' if len(v) == 1 else 's' + keys = ', '.join(map(repr, v)) + raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}') + + @validator(V_DUPLICATE_KWARGS, check_fields=False, allow_reuse=True) + def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None: + if v is None: + return + + plural = '' if len(v) == 1 else 's' + keys = ', '.join(map(repr, v)) + raise TypeError(f'multiple values for argument{plural}: {keys}') + + class Config(CustomConfig): + extra = getattr(CustomConfig, 'extra', Extra.forbid) + + self.model = create_model(to_camel(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields) diff --git a/lib/pydantic/v1/env_settings.py b/lib/pydantic/v1/env_settings.py new file mode 100644 index 00000000..6c446e51 --- /dev/null +++ b/lib/pydantic/v1/env_settings.py @@ -0,0 +1,350 @@ +import os +import warnings +from pathlib import Path +from typing import AbstractSet, Any, Callable, ClassVar, Dict, List, Mapping, Optional, Tuple, Type, Union + +from .config import BaseConfig, Extra +from .fields import ModelField +from .main import BaseModel +from .types import JsonWrapper +from .typing import StrPath, display_as_type, get_origin, is_union +from .utils import deep_update, lenient_issubclass, path_type, sequence_like + +env_file_sentinel = str(object()) + +SettingsSourceCallable = Callable[['BaseSettings'], Dict[str, Any]] +DotenvType = Union[StrPath, List[StrPath], Tuple[StrPath, ...]] + + +class SettingsError(ValueError): + pass + + +class BaseSettings(BaseModel): + """ + Base class for settings, allowing values to be overridden by environment variables. + + This is useful in production for secrets you do not wish to save in code, it plays nicely with docker(-compose), + Heroku and any 12 factor app design. + """ + + def __init__( + __pydantic_self__, + _env_file: Optional[DotenvType] = env_file_sentinel, + _env_file_encoding: Optional[str] = None, + _env_nested_delimiter: Optional[str] = None, + _secrets_dir: Optional[StrPath] = None, + **values: Any, + ) -> None: + # Uses something other than `self` the first arg to allow "self" as a settable attribute + super().__init__( + **__pydantic_self__._build_values( + values, + _env_file=_env_file, + _env_file_encoding=_env_file_encoding, + _env_nested_delimiter=_env_nested_delimiter, + _secrets_dir=_secrets_dir, + ) + ) + + def _build_values( + self, + init_kwargs: Dict[str, Any], + _env_file: Optional[DotenvType] = None, + _env_file_encoding: Optional[str] = None, + _env_nested_delimiter: Optional[str] = None, + _secrets_dir: Optional[StrPath] = None, + ) -> Dict[str, Any]: + # Configure built-in sources + init_settings = InitSettingsSource(init_kwargs=init_kwargs) + env_settings = EnvSettingsSource( + env_file=(_env_file if _env_file != env_file_sentinel else self.__config__.env_file), + env_file_encoding=( + _env_file_encoding if _env_file_encoding is not None else self.__config__.env_file_encoding + ), + env_nested_delimiter=( + _env_nested_delimiter if _env_nested_delimiter is not None else self.__config__.env_nested_delimiter + ), + env_prefix_len=len(self.__config__.env_prefix), + ) + file_secret_settings = SecretsSettingsSource(secrets_dir=_secrets_dir or self.__config__.secrets_dir) + # Provide a hook to set built-in sources priority and add / remove sources + sources = self.__config__.customise_sources( + init_settings=init_settings, env_settings=env_settings, file_secret_settings=file_secret_settings + ) + if sources: + return deep_update(*reversed([source(self) for source in sources])) + else: + # no one should mean to do this, but I think returning an empty dict is marginally preferable + # to an informative error and much better than a confusing error + return {} + + class Config(BaseConfig): + env_prefix: str = '' + env_file: Optional[DotenvType] = None + env_file_encoding: Optional[str] = None + env_nested_delimiter: Optional[str] = None + secrets_dir: Optional[StrPath] = None + validate_all: bool = True + extra: Extra = Extra.forbid + arbitrary_types_allowed: bool = True + case_sensitive: bool = False + + @classmethod + def prepare_field(cls, field: ModelField) -> None: + env_names: Union[List[str], AbstractSet[str]] + field_info_from_config = cls.get_field_info(field.name) + + env = field_info_from_config.get('env') or field.field_info.extra.get('env') + if env is None: + if field.has_alias: + warnings.warn( + 'aliases are no longer used by BaseSettings to define which environment variables to read. ' + 'Instead use the "env" field setting. ' + 'See https://pydantic-docs.helpmanual.io/usage/settings/#environment-variable-names', + FutureWarning, + ) + env_names = {cls.env_prefix + field.name} + elif isinstance(env, str): + env_names = {env} + elif isinstance(env, (set, frozenset)): + env_names = env + elif sequence_like(env): + env_names = list(env) + else: + raise TypeError(f'invalid field env: {env!r} ({display_as_type(env)}); should be string, list or set') + + if not cls.case_sensitive: + env_names = env_names.__class__(n.lower() for n in env_names) + field.field_info.extra['env_names'] = env_names + + @classmethod + def customise_sources( + cls, + init_settings: SettingsSourceCallable, + env_settings: SettingsSourceCallable, + file_secret_settings: SettingsSourceCallable, + ) -> Tuple[SettingsSourceCallable, ...]: + return init_settings, env_settings, file_secret_settings + + @classmethod + def parse_env_var(cls, field_name: str, raw_val: str) -> Any: + return cls.json_loads(raw_val) + + # populated by the metaclass using the Config class defined above, annotated here to help IDEs only + __config__: ClassVar[Type[Config]] + + +class InitSettingsSource: + __slots__ = ('init_kwargs',) + + def __init__(self, init_kwargs: Dict[str, Any]): + self.init_kwargs = init_kwargs + + def __call__(self, settings: BaseSettings) -> Dict[str, Any]: + return self.init_kwargs + + def __repr__(self) -> str: + return f'InitSettingsSource(init_kwargs={self.init_kwargs!r})' + + +class EnvSettingsSource: + __slots__ = ('env_file', 'env_file_encoding', 'env_nested_delimiter', 'env_prefix_len') + + def __init__( + self, + env_file: Optional[DotenvType], + env_file_encoding: Optional[str], + env_nested_delimiter: Optional[str] = None, + env_prefix_len: int = 0, + ): + self.env_file: Optional[DotenvType] = env_file + self.env_file_encoding: Optional[str] = env_file_encoding + self.env_nested_delimiter: Optional[str] = env_nested_delimiter + self.env_prefix_len: int = env_prefix_len + + def __call__(self, settings: BaseSettings) -> Dict[str, Any]: # noqa C901 + """ + Build environment variables suitable for passing to the Model. + """ + d: Dict[str, Any] = {} + + if settings.__config__.case_sensitive: + env_vars: Mapping[str, Optional[str]] = os.environ + else: + env_vars = {k.lower(): v for k, v in os.environ.items()} + + dotenv_vars = self._read_env_files(settings.__config__.case_sensitive) + if dotenv_vars: + env_vars = {**dotenv_vars, **env_vars} + + for field in settings.__fields__.values(): + env_val: Optional[str] = None + for env_name in field.field_info.extra['env_names']: + env_val = env_vars.get(env_name) + if env_val is not None: + break + + is_complex, allow_parse_failure = self.field_is_complex(field) + if is_complex: + if env_val is None: + # field is complex but no value found so far, try explode_env_vars + env_val_built = self.explode_env_vars(field, env_vars) + if env_val_built: + d[field.alias] = env_val_built + else: + # field is complex and there's a value, decode that as JSON, then add explode_env_vars + try: + env_val = settings.__config__.parse_env_var(field.name, env_val) + except ValueError as e: + if not allow_parse_failure: + raise SettingsError(f'error parsing env var "{env_name}"') from e + + if isinstance(env_val, dict): + d[field.alias] = deep_update(env_val, self.explode_env_vars(field, env_vars)) + else: + d[field.alias] = env_val + elif env_val is not None: + # simplest case, field is not complex, we only need to add the value if it was found + d[field.alias] = env_val + + return d + + def _read_env_files(self, case_sensitive: bool) -> Dict[str, Optional[str]]: + env_files = self.env_file + if env_files is None: + return {} + + if isinstance(env_files, (str, os.PathLike)): + env_files = [env_files] + + dotenv_vars = {} + for env_file in env_files: + env_path = Path(env_file).expanduser() + if env_path.is_file(): + dotenv_vars.update( + read_env_file(env_path, encoding=self.env_file_encoding, case_sensitive=case_sensitive) + ) + + return dotenv_vars + + def field_is_complex(self, field: ModelField) -> Tuple[bool, bool]: + """ + Find out if a field is complex, and if so whether JSON errors should be ignored + """ + if lenient_issubclass(field.annotation, JsonWrapper): + return False, False + + if field.is_complex(): + allow_parse_failure = False + elif is_union(get_origin(field.type_)) and field.sub_fields and any(f.is_complex() for f in field.sub_fields): + allow_parse_failure = True + else: + return False, False + + return True, allow_parse_failure + + def explode_env_vars(self, field: ModelField, env_vars: Mapping[str, Optional[str]]) -> Dict[str, Any]: + """ + Process env_vars and extract the values of keys containing env_nested_delimiter into nested dictionaries. + + This is applied to a single field, hence filtering by env_var prefix. + """ + prefixes = [f'{env_name}{self.env_nested_delimiter}' for env_name in field.field_info.extra['env_names']] + result: Dict[str, Any] = {} + for env_name, env_val in env_vars.items(): + if not any(env_name.startswith(prefix) for prefix in prefixes): + continue + # we remove the prefix before splitting in case the prefix has characters in common with the delimiter + env_name_without_prefix = env_name[self.env_prefix_len :] + _, *keys, last_key = env_name_without_prefix.split(self.env_nested_delimiter) + env_var = result + for key in keys: + env_var = env_var.setdefault(key, {}) + env_var[last_key] = env_val + + return result + + def __repr__(self) -> str: + return ( + f'EnvSettingsSource(env_file={self.env_file!r}, env_file_encoding={self.env_file_encoding!r}, ' + f'env_nested_delimiter={self.env_nested_delimiter!r})' + ) + + +class SecretsSettingsSource: + __slots__ = ('secrets_dir',) + + def __init__(self, secrets_dir: Optional[StrPath]): + self.secrets_dir: Optional[StrPath] = secrets_dir + + def __call__(self, settings: BaseSettings) -> Dict[str, Any]: + """ + Build fields from "secrets" files. + """ + secrets: Dict[str, Optional[str]] = {} + + if self.secrets_dir is None: + return secrets + + secrets_path = Path(self.secrets_dir).expanduser() + + if not secrets_path.exists(): + warnings.warn(f'directory "{secrets_path}" does not exist') + return secrets + + if not secrets_path.is_dir(): + raise SettingsError(f'secrets_dir must reference a directory, not a {path_type(secrets_path)}') + + for field in settings.__fields__.values(): + for env_name in field.field_info.extra['env_names']: + path = find_case_path(secrets_path, env_name, settings.__config__.case_sensitive) + if not path: + # path does not exist, we currently don't return a warning for this + continue + + if path.is_file(): + secret_value = path.read_text().strip() + if field.is_complex(): + try: + secret_value = settings.__config__.parse_env_var(field.name, secret_value) + except ValueError as e: + raise SettingsError(f'error parsing env var "{env_name}"') from e + + secrets[field.alias] = secret_value + else: + warnings.warn( + f'attempted to load secret file "{path}" but found a {path_type(path)} instead.', + stacklevel=4, + ) + return secrets + + def __repr__(self) -> str: + return f'SecretsSettingsSource(secrets_dir={self.secrets_dir!r})' + + +def read_env_file( + file_path: StrPath, *, encoding: str = None, case_sensitive: bool = False +) -> Dict[str, Optional[str]]: + try: + from dotenv import dotenv_values + except ImportError as e: + raise ImportError('python-dotenv is not installed, run `pip install pydantic[dotenv]`') from e + + file_vars: Dict[str, Optional[str]] = dotenv_values(file_path, encoding=encoding or 'utf8') + if not case_sensitive: + return {k.lower(): v for k, v in file_vars.items()} + else: + return file_vars + + +def find_case_path(dir_path: Path, file_name: str, case_sensitive: bool) -> Optional[Path]: + """ + Find a file within path's directory matching filename, optionally ignoring case. + """ + for f in dir_path.iterdir(): + if f.name == file_name: + return f + elif not case_sensitive and f.name.lower() == file_name.lower(): + return f + return None diff --git a/lib/pydantic/v1/error_wrappers.py b/lib/pydantic/v1/error_wrappers.py new file mode 100644 index 00000000..d89a500c --- /dev/null +++ b/lib/pydantic/v1/error_wrappers.py @@ -0,0 +1,161 @@ +import json +from typing import TYPE_CHECKING, Any, Dict, Generator, List, Optional, Sequence, Tuple, Type, Union + +from .json import pydantic_encoder +from .utils import Representation + +if TYPE_CHECKING: + from typing_extensions import TypedDict + + from .config import BaseConfig + from .types import ModelOrDc + from .typing import ReprArgs + + Loc = Tuple[Union[int, str], ...] + + class _ErrorDictRequired(TypedDict): + loc: Loc + msg: str + type: str + + class ErrorDict(_ErrorDictRequired, total=False): + ctx: Dict[str, Any] + + +__all__ = 'ErrorWrapper', 'ValidationError' + + +class ErrorWrapper(Representation): + __slots__ = 'exc', '_loc' + + def __init__(self, exc: Exception, loc: Union[str, 'Loc']) -> None: + self.exc = exc + self._loc = loc + + def loc_tuple(self) -> 'Loc': + if isinstance(self._loc, tuple): + return self._loc + else: + return (self._loc,) + + def __repr_args__(self) -> 'ReprArgs': + return [('exc', self.exc), ('loc', self.loc_tuple())] + + +# ErrorList is something like Union[List[Union[List[ErrorWrapper], ErrorWrapper]], ErrorWrapper] +# but recursive, therefore just use: +ErrorList = Union[Sequence[Any], ErrorWrapper] + + +class ValidationError(Representation, ValueError): + __slots__ = 'raw_errors', 'model', '_error_cache' + + def __init__(self, errors: Sequence[ErrorList], model: 'ModelOrDc') -> None: + self.raw_errors = errors + self.model = model + self._error_cache: Optional[List['ErrorDict']] = None + + def errors(self) -> List['ErrorDict']: + if self._error_cache is None: + try: + config = self.model.__config__ # type: ignore + except AttributeError: + config = self.model.__pydantic_model__.__config__ # type: ignore + self._error_cache = list(flatten_errors(self.raw_errors, config)) + return self._error_cache + + def json(self, *, indent: Union[None, int, str] = 2) -> str: + return json.dumps(self.errors(), indent=indent, default=pydantic_encoder) + + def __str__(self) -> str: + errors = self.errors() + no_errors = len(errors) + return ( + f'{no_errors} validation error{"" if no_errors == 1 else "s"} for {self.model.__name__}\n' + f'{display_errors(errors)}' + ) + + def __repr_args__(self) -> 'ReprArgs': + return [('model', self.model.__name__), ('errors', self.errors())] + + +def display_errors(errors: List['ErrorDict']) -> str: + return '\n'.join(f'{_display_error_loc(e)}\n {e["msg"]} ({_display_error_type_and_ctx(e)})' for e in errors) + + +def _display_error_loc(error: 'ErrorDict') -> str: + return ' -> '.join(str(e) for e in error['loc']) + + +def _display_error_type_and_ctx(error: 'ErrorDict') -> str: + t = 'type=' + error['type'] + ctx = error.get('ctx') + if ctx: + return t + ''.join(f'; {k}={v}' for k, v in ctx.items()) + else: + return t + + +def flatten_errors( + errors: Sequence[Any], config: Type['BaseConfig'], loc: Optional['Loc'] = None +) -> Generator['ErrorDict', None, None]: + for error in errors: + if isinstance(error, ErrorWrapper): + if loc: + error_loc = loc + error.loc_tuple() + else: + error_loc = error.loc_tuple() + + if isinstance(error.exc, ValidationError): + yield from flatten_errors(error.exc.raw_errors, config, error_loc) + else: + yield error_dict(error.exc, config, error_loc) + elif isinstance(error, list): + yield from flatten_errors(error, config, loc=loc) + else: + raise RuntimeError(f'Unknown error object: {error}') + + +def error_dict(exc: Exception, config: Type['BaseConfig'], loc: 'Loc') -> 'ErrorDict': + type_ = get_exc_type(exc.__class__) + msg_template = config.error_msg_templates.get(type_) or getattr(exc, 'msg_template', None) + ctx = exc.__dict__ + if msg_template: + msg = msg_template.format(**ctx) + else: + msg = str(exc) + + d: 'ErrorDict' = {'loc': loc, 'msg': msg, 'type': type_} + + if ctx: + d['ctx'] = ctx + + return d + + +_EXC_TYPE_CACHE: Dict[Type[Exception], str] = {} + + +def get_exc_type(cls: Type[Exception]) -> str: + # slightly more efficient than using lru_cache since we don't need to worry about the cache filling up + try: + return _EXC_TYPE_CACHE[cls] + except KeyError: + r = _get_exc_type(cls) + _EXC_TYPE_CACHE[cls] = r + return r + + +def _get_exc_type(cls: Type[Exception]) -> str: + if issubclass(cls, AssertionError): + return 'assertion_error' + + base_name = 'type_error' if issubclass(cls, TypeError) else 'value_error' + if cls in (TypeError, ValueError): + # just TypeError or ValueError, no extra code + return base_name + + # if it's not a TypeError or ValueError, we just take the lowercase of the exception name + # no chaining or snake case logic, use "code" for more complex error types. + code = getattr(cls, 'code', None) or cls.__name__.replace('Error', '').lower() + return base_name + '.' + code diff --git a/lib/pydantic/v1/errors.py b/lib/pydantic/v1/errors.py new file mode 100644 index 00000000..7bdafdd1 --- /dev/null +++ b/lib/pydantic/v1/errors.py @@ -0,0 +1,646 @@ +from decimal import Decimal +from pathlib import Path +from typing import TYPE_CHECKING, Any, Callable, Sequence, Set, Tuple, Type, Union + +from .typing import display_as_type + +if TYPE_CHECKING: + from .typing import DictStrAny + +# explicitly state exports to avoid "from .errors import *" also importing Decimal, Path etc. +__all__ = ( + 'PydanticTypeError', + 'PydanticValueError', + 'ConfigError', + 'MissingError', + 'ExtraError', + 'NoneIsNotAllowedError', + 'NoneIsAllowedError', + 'WrongConstantError', + 'NotNoneError', + 'BoolError', + 'BytesError', + 'DictError', + 'EmailError', + 'UrlError', + 'UrlSchemeError', + 'UrlSchemePermittedError', + 'UrlUserInfoError', + 'UrlHostError', + 'UrlHostTldError', + 'UrlPortError', + 'UrlExtraError', + 'EnumError', + 'IntEnumError', + 'EnumMemberError', + 'IntegerError', + 'FloatError', + 'PathError', + 'PathNotExistsError', + 'PathNotAFileError', + 'PathNotADirectoryError', + 'PyObjectError', + 'SequenceError', + 'ListError', + 'SetError', + 'FrozenSetError', + 'TupleError', + 'TupleLengthError', + 'ListMinLengthError', + 'ListMaxLengthError', + 'ListUniqueItemsError', + 'SetMinLengthError', + 'SetMaxLengthError', + 'FrozenSetMinLengthError', + 'FrozenSetMaxLengthError', + 'AnyStrMinLengthError', + 'AnyStrMaxLengthError', + 'StrError', + 'StrRegexError', + 'NumberNotGtError', + 'NumberNotGeError', + 'NumberNotLtError', + 'NumberNotLeError', + 'NumberNotMultipleError', + 'DecimalError', + 'DecimalIsNotFiniteError', + 'DecimalMaxDigitsError', + 'DecimalMaxPlacesError', + 'DecimalWholeDigitsError', + 'DateTimeError', + 'DateError', + 'DateNotInThePastError', + 'DateNotInTheFutureError', + 'TimeError', + 'DurationError', + 'HashableError', + 'UUIDError', + 'UUIDVersionError', + 'ArbitraryTypeError', + 'ClassError', + 'SubclassError', + 'JsonError', + 'JsonTypeError', + 'PatternError', + 'DataclassTypeError', + 'CallableError', + 'IPvAnyAddressError', + 'IPvAnyInterfaceError', + 'IPvAnyNetworkError', + 'IPv4AddressError', + 'IPv6AddressError', + 'IPv4NetworkError', + 'IPv6NetworkError', + 'IPv4InterfaceError', + 'IPv6InterfaceError', + 'ColorError', + 'StrictBoolError', + 'NotDigitError', + 'LuhnValidationError', + 'InvalidLengthForBrand', + 'InvalidByteSize', + 'InvalidByteSizeUnit', + 'MissingDiscriminator', + 'InvalidDiscriminator', +) + + +def cls_kwargs(cls: Type['PydanticErrorMixin'], ctx: 'DictStrAny') -> 'PydanticErrorMixin': + """ + For built-in exceptions like ValueError or TypeError, we need to implement + __reduce__ to override the default behaviour (instead of __getstate__/__setstate__) + By default pickle protocol 2 calls `cls.__new__(cls, *args)`. + Since we only use kwargs, we need a little constructor to change that. + Note: the callable can't be a lambda as pickle looks in the namespace to find it + """ + return cls(**ctx) + + +class PydanticErrorMixin: + code: str + msg_template: str + + def __init__(self, **ctx: Any) -> None: + self.__dict__ = ctx + + def __str__(self) -> str: + return self.msg_template.format(**self.__dict__) + + def __reduce__(self) -> Tuple[Callable[..., 'PydanticErrorMixin'], Tuple[Type['PydanticErrorMixin'], 'DictStrAny']]: + return cls_kwargs, (self.__class__, self.__dict__) + + +class PydanticTypeError(PydanticErrorMixin, TypeError): + pass + + +class PydanticValueError(PydanticErrorMixin, ValueError): + pass + + +class ConfigError(RuntimeError): + pass + + +class MissingError(PydanticValueError): + msg_template = 'field required' + + +class ExtraError(PydanticValueError): + msg_template = 'extra fields not permitted' + + +class NoneIsNotAllowedError(PydanticTypeError): + code = 'none.not_allowed' + msg_template = 'none is not an allowed value' + + +class NoneIsAllowedError(PydanticTypeError): + code = 'none.allowed' + msg_template = 'value is not none' + + +class WrongConstantError(PydanticValueError): + code = 'const' + + def __str__(self) -> str: + permitted = ', '.join(repr(v) for v in self.permitted) # type: ignore + return f'unexpected value; permitted: {permitted}' + + +class NotNoneError(PydanticTypeError): + code = 'not_none' + msg_template = 'value is not None' + + +class BoolError(PydanticTypeError): + msg_template = 'value could not be parsed to a boolean' + + +class BytesError(PydanticTypeError): + msg_template = 'byte type expected' + + +class DictError(PydanticTypeError): + msg_template = 'value is not a valid dict' + + +class EmailError(PydanticValueError): + msg_template = 'value is not a valid email address' + + +class UrlError(PydanticValueError): + code = 'url' + + +class UrlSchemeError(UrlError): + code = 'url.scheme' + msg_template = 'invalid or missing URL scheme' + + +class UrlSchemePermittedError(UrlError): + code = 'url.scheme' + msg_template = 'URL scheme not permitted' + + def __init__(self, allowed_schemes: Set[str]): + super().__init__(allowed_schemes=allowed_schemes) + + +class UrlUserInfoError(UrlError): + code = 'url.userinfo' + msg_template = 'userinfo required in URL but missing' + + +class UrlHostError(UrlError): + code = 'url.host' + msg_template = 'URL host invalid' + + +class UrlHostTldError(UrlError): + code = 'url.host' + msg_template = 'URL host invalid, top level domain required' + + +class UrlPortError(UrlError): + code = 'url.port' + msg_template = 'URL port invalid, port cannot exceed 65535' + + +class UrlExtraError(UrlError): + code = 'url.extra' + msg_template = 'URL invalid, extra characters found after valid URL: {extra!r}' + + +class EnumMemberError(PydanticTypeError): + code = 'enum' + + def __str__(self) -> str: + permitted = ', '.join(repr(v.value) for v in self.enum_values) # type: ignore + return f'value is not a valid enumeration member; permitted: {permitted}' + + +class IntegerError(PydanticTypeError): + msg_template = 'value is not a valid integer' + + +class FloatError(PydanticTypeError): + msg_template = 'value is not a valid float' + + +class PathError(PydanticTypeError): + msg_template = 'value is not a valid path' + + +class _PathValueError(PydanticValueError): + def __init__(self, *, path: Path) -> None: + super().__init__(path=str(path)) + + +class PathNotExistsError(_PathValueError): + code = 'path.not_exists' + msg_template = 'file or directory at path "{path}" does not exist' + + +class PathNotAFileError(_PathValueError): + code = 'path.not_a_file' + msg_template = 'path "{path}" does not point to a file' + + +class PathNotADirectoryError(_PathValueError): + code = 'path.not_a_directory' + msg_template = 'path "{path}" does not point to a directory' + + +class PyObjectError(PydanticTypeError): + msg_template = 'ensure this value contains valid import path or valid callable: {error_message}' + + +class SequenceError(PydanticTypeError): + msg_template = 'value is not a valid sequence' + + +class IterableError(PydanticTypeError): + msg_template = 'value is not a valid iterable' + + +class ListError(PydanticTypeError): + msg_template = 'value is not a valid list' + + +class SetError(PydanticTypeError): + msg_template = 'value is not a valid set' + + +class FrozenSetError(PydanticTypeError): + msg_template = 'value is not a valid frozenset' + + +class DequeError(PydanticTypeError): + msg_template = 'value is not a valid deque' + + +class TupleError(PydanticTypeError): + msg_template = 'value is not a valid tuple' + + +class TupleLengthError(PydanticValueError): + code = 'tuple.length' + msg_template = 'wrong tuple length {actual_length}, expected {expected_length}' + + def __init__(self, *, actual_length: int, expected_length: int) -> None: + super().__init__(actual_length=actual_length, expected_length=expected_length) + + +class ListMinLengthError(PydanticValueError): + code = 'list.min_items' + msg_template = 'ensure this value has at least {limit_value} items' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class ListMaxLengthError(PydanticValueError): + code = 'list.max_items' + msg_template = 'ensure this value has at most {limit_value} items' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class ListUniqueItemsError(PydanticValueError): + code = 'list.unique_items' + msg_template = 'the list has duplicated items' + + +class SetMinLengthError(PydanticValueError): + code = 'set.min_items' + msg_template = 'ensure this value has at least {limit_value} items' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class SetMaxLengthError(PydanticValueError): + code = 'set.max_items' + msg_template = 'ensure this value has at most {limit_value} items' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class FrozenSetMinLengthError(PydanticValueError): + code = 'frozenset.min_items' + msg_template = 'ensure this value has at least {limit_value} items' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class FrozenSetMaxLengthError(PydanticValueError): + code = 'frozenset.max_items' + msg_template = 'ensure this value has at most {limit_value} items' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class AnyStrMinLengthError(PydanticValueError): + code = 'any_str.min_length' + msg_template = 'ensure this value has at least {limit_value} characters' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class AnyStrMaxLengthError(PydanticValueError): + code = 'any_str.max_length' + msg_template = 'ensure this value has at most {limit_value} characters' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class StrError(PydanticTypeError): + msg_template = 'str type expected' + + +class StrRegexError(PydanticValueError): + code = 'str.regex' + msg_template = 'string does not match regex "{pattern}"' + + def __init__(self, *, pattern: str) -> None: + super().__init__(pattern=pattern) + + +class _NumberBoundError(PydanticValueError): + def __init__(self, *, limit_value: Union[int, float, Decimal]) -> None: + super().__init__(limit_value=limit_value) + + +class NumberNotGtError(_NumberBoundError): + code = 'number.not_gt' + msg_template = 'ensure this value is greater than {limit_value}' + + +class NumberNotGeError(_NumberBoundError): + code = 'number.not_ge' + msg_template = 'ensure this value is greater than or equal to {limit_value}' + + +class NumberNotLtError(_NumberBoundError): + code = 'number.not_lt' + msg_template = 'ensure this value is less than {limit_value}' + + +class NumberNotLeError(_NumberBoundError): + code = 'number.not_le' + msg_template = 'ensure this value is less than or equal to {limit_value}' + + +class NumberNotFiniteError(PydanticValueError): + code = 'number.not_finite_number' + msg_template = 'ensure this value is a finite number' + + +class NumberNotMultipleError(PydanticValueError): + code = 'number.not_multiple' + msg_template = 'ensure this value is a multiple of {multiple_of}' + + def __init__(self, *, multiple_of: Union[int, float, Decimal]) -> None: + super().__init__(multiple_of=multiple_of) + + +class DecimalError(PydanticTypeError): + msg_template = 'value is not a valid decimal' + + +class DecimalIsNotFiniteError(PydanticValueError): + code = 'decimal.not_finite' + msg_template = 'value is not a valid decimal' + + +class DecimalMaxDigitsError(PydanticValueError): + code = 'decimal.max_digits' + msg_template = 'ensure that there are no more than {max_digits} digits in total' + + def __init__(self, *, max_digits: int) -> None: + super().__init__(max_digits=max_digits) + + +class DecimalMaxPlacesError(PydanticValueError): + code = 'decimal.max_places' + msg_template = 'ensure that there are no more than {decimal_places} decimal places' + + def __init__(self, *, decimal_places: int) -> None: + super().__init__(decimal_places=decimal_places) + + +class DecimalWholeDigitsError(PydanticValueError): + code = 'decimal.whole_digits' + msg_template = 'ensure that there are no more than {whole_digits} digits before the decimal point' + + def __init__(self, *, whole_digits: int) -> None: + super().__init__(whole_digits=whole_digits) + + +class DateTimeError(PydanticValueError): + msg_template = 'invalid datetime format' + + +class DateError(PydanticValueError): + msg_template = 'invalid date format' + + +class DateNotInThePastError(PydanticValueError): + code = 'date.not_in_the_past' + msg_template = 'date is not in the past' + + +class DateNotInTheFutureError(PydanticValueError): + code = 'date.not_in_the_future' + msg_template = 'date is not in the future' + + +class TimeError(PydanticValueError): + msg_template = 'invalid time format' + + +class DurationError(PydanticValueError): + msg_template = 'invalid duration format' + + +class HashableError(PydanticTypeError): + msg_template = 'value is not a valid hashable' + + +class UUIDError(PydanticTypeError): + msg_template = 'value is not a valid uuid' + + +class UUIDVersionError(PydanticValueError): + code = 'uuid.version' + msg_template = 'uuid version {required_version} expected' + + def __init__(self, *, required_version: int) -> None: + super().__init__(required_version=required_version) + + +class ArbitraryTypeError(PydanticTypeError): + code = 'arbitrary_type' + msg_template = 'instance of {expected_arbitrary_type} expected' + + def __init__(self, *, expected_arbitrary_type: Type[Any]) -> None: + super().__init__(expected_arbitrary_type=display_as_type(expected_arbitrary_type)) + + +class ClassError(PydanticTypeError): + code = 'class' + msg_template = 'a class is expected' + + +class SubclassError(PydanticTypeError): + code = 'subclass' + msg_template = 'subclass of {expected_class} expected' + + def __init__(self, *, expected_class: Type[Any]) -> None: + super().__init__(expected_class=display_as_type(expected_class)) + + +class JsonError(PydanticValueError): + msg_template = 'Invalid JSON' + + +class JsonTypeError(PydanticTypeError): + code = 'json' + msg_template = 'JSON object must be str, bytes or bytearray' + + +class PatternError(PydanticValueError): + code = 'regex_pattern' + msg_template = 'Invalid regular expression' + + +class DataclassTypeError(PydanticTypeError): + code = 'dataclass' + msg_template = 'instance of {class_name}, tuple or dict expected' + + +class CallableError(PydanticTypeError): + msg_template = '{value} is not callable' + + +class EnumError(PydanticTypeError): + code = 'enum_instance' + msg_template = '{value} is not a valid Enum instance' + + +class IntEnumError(PydanticTypeError): + code = 'int_enum_instance' + msg_template = '{value} is not a valid IntEnum instance' + + +class IPvAnyAddressError(PydanticValueError): + msg_template = 'value is not a valid IPv4 or IPv6 address' + + +class IPvAnyInterfaceError(PydanticValueError): + msg_template = 'value is not a valid IPv4 or IPv6 interface' + + +class IPvAnyNetworkError(PydanticValueError): + msg_template = 'value is not a valid IPv4 or IPv6 network' + + +class IPv4AddressError(PydanticValueError): + msg_template = 'value is not a valid IPv4 address' + + +class IPv6AddressError(PydanticValueError): + msg_template = 'value is not a valid IPv6 address' + + +class IPv4NetworkError(PydanticValueError): + msg_template = 'value is not a valid IPv4 network' + + +class IPv6NetworkError(PydanticValueError): + msg_template = 'value is not a valid IPv6 network' + + +class IPv4InterfaceError(PydanticValueError): + msg_template = 'value is not a valid IPv4 interface' + + +class IPv6InterfaceError(PydanticValueError): + msg_template = 'value is not a valid IPv6 interface' + + +class ColorError(PydanticValueError): + msg_template = 'value is not a valid color: {reason}' + + +class StrictBoolError(PydanticValueError): + msg_template = 'value is not a valid boolean' + + +class NotDigitError(PydanticValueError): + code = 'payment_card_number.digits' + msg_template = 'card number is not all digits' + + +class LuhnValidationError(PydanticValueError): + code = 'payment_card_number.luhn_check' + msg_template = 'card number is not luhn valid' + + +class InvalidLengthForBrand(PydanticValueError): + code = 'payment_card_number.invalid_length_for_brand' + msg_template = 'Length for a {brand} card must be {required_length}' + + +class InvalidByteSize(PydanticValueError): + msg_template = 'could not parse value and unit from byte string' + + +class InvalidByteSizeUnit(PydanticValueError): + msg_template = 'could not interpret byte unit: {unit}' + + +class MissingDiscriminator(PydanticValueError): + code = 'discriminated_union.missing_discriminator' + msg_template = 'Discriminator {discriminator_key!r} is missing in value' + + +class InvalidDiscriminator(PydanticValueError): + code = 'discriminated_union.invalid_discriminator' + msg_template = ( + 'No match for discriminator {discriminator_key!r} and value {discriminator_value!r} ' + '(allowed values: {allowed_values})' + ) + + def __init__(self, *, discriminator_key: str, discriminator_value: Any, allowed_values: Sequence[Any]) -> None: + super().__init__( + discriminator_key=discriminator_key, + discriminator_value=discriminator_value, + allowed_values=', '.join(map(repr, allowed_values)), + ) diff --git a/lib/pydantic/v1/fields.py b/lib/pydantic/v1/fields.py new file mode 100644 index 00000000..60d260e9 --- /dev/null +++ b/lib/pydantic/v1/fields.py @@ -0,0 +1,1253 @@ +import copy +import re +from collections import Counter as CollectionCounter, defaultdict, deque +from collections.abc import Callable, Hashable as CollectionsHashable, Iterable as CollectionsIterable +from typing import ( + TYPE_CHECKING, + Any, + Counter, + DefaultDict, + Deque, + Dict, + ForwardRef, + FrozenSet, + Generator, + Iterable, + Iterator, + List, + Mapping, + Optional, + Pattern, + Sequence, + Set, + Tuple, + Type, + TypeVar, + Union, +) + +from typing_extensions import Annotated, Final + +from . import errors as errors_ +from .class_validators import Validator, make_generic_validator, prep_validators +from .error_wrappers import ErrorWrapper +from .errors import ConfigError, InvalidDiscriminator, MissingDiscriminator, NoneIsNotAllowedError +from .types import Json, JsonWrapper +from .typing import ( + NoArgAnyCallable, + convert_generics, + display_as_type, + get_args, + get_origin, + is_finalvar, + is_literal_type, + is_new_type, + is_none_type, + is_typeddict, + is_typeddict_special, + is_union, + new_type_supertype, +) +from .utils import ( + PyObjectStr, + Representation, + ValueItems, + get_discriminator_alias_and_values, + get_unique_discriminator_alias, + lenient_isinstance, + lenient_issubclass, + sequence_like, + smart_deepcopy, +) +from .validators import constant_validator, dict_validator, find_validators, validate_json + +Required: Any = Ellipsis + +T = TypeVar('T') + + +class UndefinedType: + def __repr__(self) -> str: + return 'PydanticUndefined' + + def __copy__(self: T) -> T: + return self + + def __reduce__(self) -> str: + return 'Undefined' + + def __deepcopy__(self: T, _: Any) -> T: + return self + + +Undefined = UndefinedType() + +if TYPE_CHECKING: + from .class_validators import ValidatorsList + from .config import BaseConfig + from .error_wrappers import ErrorList + from .types import ModelOrDc + from .typing import AbstractSetIntStr, MappingIntStrAny, ReprArgs + + ValidateReturn = Tuple[Optional[Any], Optional[ErrorList]] + LocStr = Union[Tuple[Union[int, str], ...], str] + BoolUndefined = Union[bool, UndefinedType] + + +class FieldInfo(Representation): + """ + Captures extra information about a field. + """ + + __slots__ = ( + 'default', + 'default_factory', + 'alias', + 'alias_priority', + 'title', + 'description', + 'exclude', + 'include', + 'const', + 'gt', + 'ge', + 'lt', + 'le', + 'multiple_of', + 'allow_inf_nan', + 'max_digits', + 'decimal_places', + 'min_items', + 'max_items', + 'unique_items', + 'min_length', + 'max_length', + 'allow_mutation', + 'repr', + 'regex', + 'discriminator', + 'extra', + ) + + # field constraints with the default value, it's also used in update_from_config below + __field_constraints__ = { + 'min_length': None, + 'max_length': None, + 'regex': None, + 'gt': None, + 'lt': None, + 'ge': None, + 'le': None, + 'multiple_of': None, + 'allow_inf_nan': None, + 'max_digits': None, + 'decimal_places': None, + 'min_items': None, + 'max_items': None, + 'unique_items': None, + 'allow_mutation': True, + } + + def __init__(self, default: Any = Undefined, **kwargs: Any) -> None: + self.default = default + self.default_factory = kwargs.pop('default_factory', None) + self.alias = kwargs.pop('alias', None) + self.alias_priority = kwargs.pop('alias_priority', 2 if self.alias is not None else None) + self.title = kwargs.pop('title', None) + self.description = kwargs.pop('description', None) + self.exclude = kwargs.pop('exclude', None) + self.include = kwargs.pop('include', None) + self.const = kwargs.pop('const', None) + self.gt = kwargs.pop('gt', None) + self.ge = kwargs.pop('ge', None) + self.lt = kwargs.pop('lt', None) + self.le = kwargs.pop('le', None) + self.multiple_of = kwargs.pop('multiple_of', None) + self.allow_inf_nan = kwargs.pop('allow_inf_nan', None) + self.max_digits = kwargs.pop('max_digits', None) + self.decimal_places = kwargs.pop('decimal_places', None) + self.min_items = kwargs.pop('min_items', None) + self.max_items = kwargs.pop('max_items', None) + self.unique_items = kwargs.pop('unique_items', None) + self.min_length = kwargs.pop('min_length', None) + self.max_length = kwargs.pop('max_length', None) + self.allow_mutation = kwargs.pop('allow_mutation', True) + self.regex = kwargs.pop('regex', None) + self.discriminator = kwargs.pop('discriminator', None) + self.repr = kwargs.pop('repr', True) + self.extra = kwargs + + def __repr_args__(self) -> 'ReprArgs': + field_defaults_to_hide: Dict[str, Any] = { + 'repr': True, + **self.__field_constraints__, + } + + attrs = ((s, getattr(self, s)) for s in self.__slots__) + return [(a, v) for a, v in attrs if v != field_defaults_to_hide.get(a, None)] + + def get_constraints(self) -> Set[str]: + """ + Gets the constraints set on the field by comparing the constraint value with its default value + + :return: the constraints set on field_info + """ + return {attr for attr, default in self.__field_constraints__.items() if getattr(self, attr) != default} + + def update_from_config(self, from_config: Dict[str, Any]) -> None: + """ + Update this FieldInfo based on a dict from get_field_info, only fields which have not been set are dated. + """ + for attr_name, value in from_config.items(): + try: + current_value = getattr(self, attr_name) + except AttributeError: + # attr_name is not an attribute of FieldInfo, it should therefore be added to extra + # (except if extra already has this value!) + self.extra.setdefault(attr_name, value) + else: + if current_value is self.__field_constraints__.get(attr_name, None): + setattr(self, attr_name, value) + elif attr_name == 'exclude': + self.exclude = ValueItems.merge(value, current_value) + elif attr_name == 'include': + self.include = ValueItems.merge(value, current_value, intersect=True) + + def _validate(self) -> None: + if self.default is not Undefined and self.default_factory is not None: + raise ValueError('cannot specify both default and default_factory') + + +def Field( + default: Any = Undefined, + *, + default_factory: Optional[NoArgAnyCallable] = None, + alias: Optional[str] = None, + title: Optional[str] = None, + description: Optional[str] = None, + exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny', Any]] = None, + include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny', Any]] = None, + const: Optional[bool] = None, + gt: Optional[float] = None, + ge: Optional[float] = None, + lt: Optional[float] = None, + le: Optional[float] = None, + multiple_of: Optional[float] = None, + allow_inf_nan: Optional[bool] = None, + max_digits: Optional[int] = None, + decimal_places: Optional[int] = None, + min_items: Optional[int] = None, + max_items: Optional[int] = None, + unique_items: Optional[bool] = None, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + allow_mutation: bool = True, + regex: Optional[str] = None, + discriminator: Optional[str] = None, + repr: bool = True, + **extra: Any, +) -> Any: + """ + Used to provide extra information about a field, either for the model schema or complex validation. Some arguments + apply only to number fields (``int``, ``float``, ``Decimal``) and some apply only to ``str``. + + :param default: since this is replacing the field’s default, its first argument is used + to set the default, use ellipsis (``...``) to indicate the field is required + :param default_factory: callable that will be called when a default value is needed for this field + If both `default` and `default_factory` are set, an error is raised. + :param alias: the public name of the field + :param title: can be any string, used in the schema + :param description: can be any string, used in the schema + :param exclude: exclude this field while dumping. + Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method. + :param include: include this field while dumping. + Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method. + :param const: this field is required and *must* take it's default value + :param gt: only applies to numbers, requires the field to be "greater than". The schema + will have an ``exclusiveMinimum`` validation keyword + :param ge: only applies to numbers, requires the field to be "greater than or equal to". The + schema will have a ``minimum`` validation keyword + :param lt: only applies to numbers, requires the field to be "less than". The schema + will have an ``exclusiveMaximum`` validation keyword + :param le: only applies to numbers, requires the field to be "less than or equal to". The + schema will have a ``maximum`` validation keyword + :param multiple_of: only applies to numbers, requires the field to be "a multiple of". The + schema will have a ``multipleOf`` validation keyword + :param allow_inf_nan: only applies to numbers, allows the field to be NaN or infinity (+inf or -inf), + which is a valid Python float. Default True, set to False for compatibility with JSON. + :param max_digits: only applies to Decimals, requires the field to have a maximum number + of digits within the decimal. It does not include a zero before the decimal point or trailing decimal zeroes. + :param decimal_places: only applies to Decimals, requires the field to have at most a number of decimal places + allowed. It does not include trailing decimal zeroes. + :param min_items: only applies to lists, requires the field to have a minimum number of + elements. The schema will have a ``minItems`` validation keyword + :param max_items: only applies to lists, requires the field to have a maximum number of + elements. The schema will have a ``maxItems`` validation keyword + :param unique_items: only applies to lists, requires the field not to have duplicated + elements. The schema will have a ``uniqueItems`` validation keyword + :param min_length: only applies to strings, requires the field to have a minimum length. The + schema will have a ``minLength`` validation keyword + :param max_length: only applies to strings, requires the field to have a maximum length. The + schema will have a ``maxLength`` validation keyword + :param allow_mutation: a boolean which defaults to True. When False, the field raises a TypeError if the field is + assigned on an instance. The BaseModel Config must set validate_assignment to True + :param regex: only applies to strings, requires the field match against a regular expression + pattern string. The schema will have a ``pattern`` validation keyword + :param discriminator: only useful with a (discriminated a.k.a. tagged) `Union` of sub models with a common field. + The `discriminator` is the name of this common field to shorten validation and improve generated schema + :param repr: show this field in the representation + :param **extra: any additional keyword arguments will be added as is to the schema + """ + field_info = FieldInfo( + default, + default_factory=default_factory, + alias=alias, + title=title, + description=description, + exclude=exclude, + include=include, + const=const, + gt=gt, + ge=ge, + lt=lt, + le=le, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + min_items=min_items, + max_items=max_items, + unique_items=unique_items, + min_length=min_length, + max_length=max_length, + allow_mutation=allow_mutation, + regex=regex, + discriminator=discriminator, + repr=repr, + **extra, + ) + field_info._validate() + return field_info + + +# used to be an enum but changed to int's for small performance improvement as less access overhead +SHAPE_SINGLETON = 1 +SHAPE_LIST = 2 +SHAPE_SET = 3 +SHAPE_MAPPING = 4 +SHAPE_TUPLE = 5 +SHAPE_TUPLE_ELLIPSIS = 6 +SHAPE_SEQUENCE = 7 +SHAPE_FROZENSET = 8 +SHAPE_ITERABLE = 9 +SHAPE_GENERIC = 10 +SHAPE_DEQUE = 11 +SHAPE_DICT = 12 +SHAPE_DEFAULTDICT = 13 +SHAPE_COUNTER = 14 +SHAPE_NAME_LOOKUP = { + SHAPE_LIST: 'List[{}]', + SHAPE_SET: 'Set[{}]', + SHAPE_TUPLE_ELLIPSIS: 'Tuple[{}, ...]', + SHAPE_SEQUENCE: 'Sequence[{}]', + SHAPE_FROZENSET: 'FrozenSet[{}]', + SHAPE_ITERABLE: 'Iterable[{}]', + SHAPE_DEQUE: 'Deque[{}]', + SHAPE_DICT: 'Dict[{}]', + SHAPE_DEFAULTDICT: 'DefaultDict[{}]', + SHAPE_COUNTER: 'Counter[{}]', +} + +MAPPING_LIKE_SHAPES: Set[int] = {SHAPE_DEFAULTDICT, SHAPE_DICT, SHAPE_MAPPING, SHAPE_COUNTER} + + +class ModelField(Representation): + __slots__ = ( + 'type_', + 'outer_type_', + 'annotation', + 'sub_fields', + 'sub_fields_mapping', + 'key_field', + 'validators', + 'pre_validators', + 'post_validators', + 'default', + 'default_factory', + 'required', + 'final', + 'model_config', + 'name', + 'alias', + 'has_alias', + 'field_info', + 'discriminator_key', + 'discriminator_alias', + 'validate_always', + 'allow_none', + 'shape', + 'class_validators', + 'parse_json', + ) + + def __init__( + self, + *, + name: str, + type_: Type[Any], + class_validators: Optional[Dict[str, Validator]], + model_config: Type['BaseConfig'], + default: Any = None, + default_factory: Optional[NoArgAnyCallable] = None, + required: 'BoolUndefined' = Undefined, + final: bool = False, + alias: Optional[str] = None, + field_info: Optional[FieldInfo] = None, + ) -> None: + self.name: str = name + self.has_alias: bool = alias is not None + self.alias: str = alias if alias is not None else name + self.annotation = type_ + self.type_: Any = convert_generics(type_) + self.outer_type_: Any = type_ + self.class_validators = class_validators or {} + self.default: Any = default + self.default_factory: Optional[NoArgAnyCallable] = default_factory + self.required: 'BoolUndefined' = required + self.final: bool = final + self.model_config = model_config + self.field_info: FieldInfo = field_info or FieldInfo(default) + self.discriminator_key: Optional[str] = self.field_info.discriminator + self.discriminator_alias: Optional[str] = self.discriminator_key + + self.allow_none: bool = False + self.validate_always: bool = False + self.sub_fields: Optional[List[ModelField]] = None + self.sub_fields_mapping: Optional[Dict[str, 'ModelField']] = None # used for discriminated union + self.key_field: Optional[ModelField] = None + self.validators: 'ValidatorsList' = [] + self.pre_validators: Optional['ValidatorsList'] = None + self.post_validators: Optional['ValidatorsList'] = None + self.parse_json: bool = False + self.shape: int = SHAPE_SINGLETON + self.model_config.prepare_field(self) + self.prepare() + + def get_default(self) -> Any: + return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory() + + @staticmethod + def _get_field_info( + field_name: str, annotation: Any, value: Any, config: Type['BaseConfig'] + ) -> Tuple[FieldInfo, Any]: + """ + Get a FieldInfo from a root typing.Annotated annotation, value, or config default. + + The FieldInfo may be set in typing.Annotated or the value, but not both. If neither contain + a FieldInfo, a new one will be created using the config. + + :param field_name: name of the field for use in error messages + :param annotation: a type hint such as `str` or `Annotated[str, Field(..., min_length=5)]` + :param value: the field's assigned value + :param config: the model's config object + :return: the FieldInfo contained in the `annotation`, the value, or a new one from the config. + """ + field_info_from_config = config.get_field_info(field_name) + + field_info = None + if get_origin(annotation) is Annotated: + field_infos = [arg for arg in get_args(annotation)[1:] if isinstance(arg, FieldInfo)] + if len(field_infos) > 1: + raise ValueError(f'cannot specify multiple `Annotated` `Field`s for {field_name!r}') + field_info = next(iter(field_infos), None) + if field_info is not None: + field_info = copy.copy(field_info) + field_info.update_from_config(field_info_from_config) + if field_info.default not in (Undefined, Required): + raise ValueError(f'`Field` default cannot be set in `Annotated` for {field_name!r}') + if value is not Undefined and value is not Required: + # check also `Required` because of `validate_arguments` that sets `...` as default value + field_info.default = value + + if isinstance(value, FieldInfo): + if field_info is not None: + raise ValueError(f'cannot specify `Annotated` and value `Field`s together for {field_name!r}') + field_info = value + field_info.update_from_config(field_info_from_config) + elif field_info is None: + field_info = FieldInfo(value, **field_info_from_config) + value = None if field_info.default_factory is not None else field_info.default + field_info._validate() + return field_info, value + + @classmethod + def infer( + cls, + *, + name: str, + value: Any, + annotation: Any, + class_validators: Optional[Dict[str, Validator]], + config: Type['BaseConfig'], + ) -> 'ModelField': + from .schema import get_annotation_from_field_info + + field_info, value = cls._get_field_info(name, annotation, value, config) + required: 'BoolUndefined' = Undefined + if value is Required: + required = True + value = None + elif value is not Undefined: + required = False + annotation = get_annotation_from_field_info(annotation, field_info, name, config.validate_assignment) + + return cls( + name=name, + type_=annotation, + alias=field_info.alias, + class_validators=class_validators, + default=value, + default_factory=field_info.default_factory, + required=required, + model_config=config, + field_info=field_info, + ) + + def set_config(self, config: Type['BaseConfig']) -> None: + self.model_config = config + info_from_config = config.get_field_info(self.name) + config.prepare_field(self) + new_alias = info_from_config.get('alias') + new_alias_priority = info_from_config.get('alias_priority') or 0 + if new_alias and new_alias_priority >= (self.field_info.alias_priority or 0): + self.field_info.alias = new_alias + self.field_info.alias_priority = new_alias_priority + self.alias = new_alias + new_exclude = info_from_config.get('exclude') + if new_exclude is not None: + self.field_info.exclude = ValueItems.merge(self.field_info.exclude, new_exclude) + new_include = info_from_config.get('include') + if new_include is not None: + self.field_info.include = ValueItems.merge(self.field_info.include, new_include, intersect=True) + + @property + def alt_alias(self) -> bool: + return self.name != self.alias + + def prepare(self) -> None: + """ + Prepare the field but inspecting self.default, self.type_ etc. + + Note: this method is **not** idempotent (because _type_analysis is not idempotent), + e.g. calling it it multiple times may modify the field and configure it incorrectly. + """ + self._set_default_and_type() + if self.type_.__class__ is ForwardRef or self.type_.__class__ is DeferredType: + # self.type_ is currently a ForwardRef and there's nothing we can do now, + # user will need to call model.update_forward_refs() + return + + self._type_analysis() + if self.required is Undefined: + self.required = True + if self.default is Undefined and self.default_factory is None: + self.default = None + self.populate_validators() + + def _set_default_and_type(self) -> None: + """ + Set the default value, infer the type if needed and check if `None` value is valid. + """ + if self.default_factory is not None: + if self.type_ is Undefined: + raise errors_.ConfigError( + f'you need to set the type of field {self.name!r} when using `default_factory`' + ) + return + + default_value = self.get_default() + + if default_value is not None and self.type_ is Undefined: + self.type_ = default_value.__class__ + self.outer_type_ = self.type_ + self.annotation = self.type_ + + if self.type_ is Undefined: + raise errors_.ConfigError(f'unable to infer type for attribute "{self.name}"') + + if self.required is False and default_value is None: + self.allow_none = True + + def _type_analysis(self) -> None: # noqa: C901 (ignore complexity) + # typing interface is horrible, we have to do some ugly checks + if lenient_issubclass(self.type_, JsonWrapper): + self.type_ = self.type_.inner_type + self.parse_json = True + elif lenient_issubclass(self.type_, Json): + self.type_ = Any + self.parse_json = True + elif isinstance(self.type_, TypeVar): + if self.type_.__bound__: + self.type_ = self.type_.__bound__ + elif self.type_.__constraints__: + self.type_ = Union[self.type_.__constraints__] + else: + self.type_ = Any + elif is_new_type(self.type_): + self.type_ = new_type_supertype(self.type_) + + if self.type_ is Any or self.type_ is object: + if self.required is Undefined: + self.required = False + self.allow_none = True + return + elif self.type_ is Pattern or self.type_ is re.Pattern: + # python 3.7 only, Pattern is a typing object but without sub fields + return + elif is_literal_type(self.type_): + return + elif is_typeddict(self.type_): + return + + if is_finalvar(self.type_): + self.final = True + + if self.type_ is Final: + self.type_ = Any + else: + self.type_ = get_args(self.type_)[0] + + self._type_analysis() + return + + origin = get_origin(self.type_) + + if origin is Annotated or is_typeddict_special(origin): + self.type_ = get_args(self.type_)[0] + self._type_analysis() + return + + if self.discriminator_key is not None and not is_union(origin): + raise TypeError('`discriminator` can only be used with `Union` type with more than one variant') + + # add extra check for `collections.abc.Hashable` for python 3.10+ where origin is not `None` + if origin is None or origin is CollectionsHashable: + # field is not "typing" object eg. Union, Dict, List etc. + # allow None for virtual superclasses of NoneType, e.g. Hashable + if isinstance(self.type_, type) and isinstance(None, self.type_): + self.allow_none = True + return + elif origin is Callable: + return + elif is_union(origin): + types_ = [] + for type_ in get_args(self.type_): + if is_none_type(type_) or type_ is Any or type_ is object: + if self.required is Undefined: + self.required = False + self.allow_none = True + if is_none_type(type_): + continue + types_.append(type_) + + if len(types_) == 1: + # Optional[] + self.type_ = types_[0] + # this is the one case where the "outer type" isn't just the original type + self.outer_type_ = self.type_ + # re-run to correctly interpret the new self.type_ + self._type_analysis() + else: + self.sub_fields = [self._create_sub_type(t, f'{self.name}_{display_as_type(t)}') for t in types_] + + if self.discriminator_key is not None: + self.prepare_discriminated_union_sub_fields() + return + elif issubclass(origin, Tuple): # type: ignore + # origin == Tuple without item type + args = get_args(self.type_) + if not args: # plain tuple + self.type_ = Any + self.shape = SHAPE_TUPLE_ELLIPSIS + elif len(args) == 2 and args[1] is Ellipsis: # e.g. Tuple[int, ...] + self.type_ = args[0] + self.shape = SHAPE_TUPLE_ELLIPSIS + self.sub_fields = [self._create_sub_type(args[0], f'{self.name}_0')] + elif args == ((),): # Tuple[()] means empty tuple + self.shape = SHAPE_TUPLE + self.type_ = Any + self.sub_fields = [] + else: + self.shape = SHAPE_TUPLE + self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(args)] + return + elif issubclass(origin, List): + # Create self validators + get_validators = getattr(self.type_, '__get_validators__', None) + if get_validators: + self.class_validators.update( + {f'list_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())} + ) + + self.type_ = get_args(self.type_)[0] + self.shape = SHAPE_LIST + elif issubclass(origin, Set): + # Create self validators + get_validators = getattr(self.type_, '__get_validators__', None) + if get_validators: + self.class_validators.update( + {f'set_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())} + ) + + self.type_ = get_args(self.type_)[0] + self.shape = SHAPE_SET + elif issubclass(origin, FrozenSet): + # Create self validators + get_validators = getattr(self.type_, '__get_validators__', None) + if get_validators: + self.class_validators.update( + {f'frozenset_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())} + ) + + self.type_ = get_args(self.type_)[0] + self.shape = SHAPE_FROZENSET + elif issubclass(origin, Deque): + self.type_ = get_args(self.type_)[0] + self.shape = SHAPE_DEQUE + elif issubclass(origin, Sequence): + self.type_ = get_args(self.type_)[0] + self.shape = SHAPE_SEQUENCE + # priority to most common mapping: dict + elif origin is dict or origin is Dict: + self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True) + self.type_ = get_args(self.type_)[1] + self.shape = SHAPE_DICT + elif issubclass(origin, DefaultDict): + self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True) + self.type_ = get_args(self.type_)[1] + self.shape = SHAPE_DEFAULTDICT + elif issubclass(origin, Counter): + self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True) + self.type_ = int + self.shape = SHAPE_COUNTER + elif issubclass(origin, Mapping): + self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True) + self.type_ = get_args(self.type_)[1] + self.shape = SHAPE_MAPPING + # Equality check as almost everything inherits form Iterable, including str + # check for Iterable and CollectionsIterable, as it could receive one even when declared with the other + elif origin in {Iterable, CollectionsIterable}: + self.type_ = get_args(self.type_)[0] + self.shape = SHAPE_ITERABLE + self.sub_fields = [self._create_sub_type(self.type_, f'{self.name}_type')] + elif issubclass(origin, Type): # type: ignore + return + elif hasattr(origin, '__get_validators__') or self.model_config.arbitrary_types_allowed: + # Is a Pydantic-compatible generic that handles itself + # or we have arbitrary_types_allowed = True + self.shape = SHAPE_GENERIC + self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(get_args(self.type_))] + self.type_ = origin + return + else: + raise TypeError(f'Fields of type "{origin}" are not supported.') + + # type_ has been refined eg. as the type of a List and sub_fields needs to be populated + self.sub_fields = [self._create_sub_type(self.type_, '_' + self.name)] + + def prepare_discriminated_union_sub_fields(self) -> None: + """ + Prepare the mapping -> and update `sub_fields` + Note that this process can be aborted if a `ForwardRef` is encountered + """ + assert self.discriminator_key is not None + + if self.type_.__class__ is DeferredType: + return + + assert self.sub_fields is not None + sub_fields_mapping: Dict[str, 'ModelField'] = {} + all_aliases: Set[str] = set() + + for sub_field in self.sub_fields: + t = sub_field.type_ + if t.__class__ is ForwardRef: + # Stopping everything...will need to call `update_forward_refs` + return + + alias, discriminator_values = get_discriminator_alias_and_values(t, self.discriminator_key) + all_aliases.add(alias) + for discriminator_value in discriminator_values: + sub_fields_mapping[discriminator_value] = sub_field + + self.sub_fields_mapping = sub_fields_mapping + self.discriminator_alias = get_unique_discriminator_alias(all_aliases, self.discriminator_key) + + def _create_sub_type(self, type_: Type[Any], name: str, *, for_keys: bool = False) -> 'ModelField': + if for_keys: + class_validators = None + else: + # validators for sub items should not have `each_item` as we want to check only the first sublevel + class_validators = { + k: Validator( + func=v.func, + pre=v.pre, + each_item=False, + always=v.always, + check_fields=v.check_fields, + skip_on_failure=v.skip_on_failure, + ) + for k, v in self.class_validators.items() + if v.each_item + } + + field_info, _ = self._get_field_info(name, type_, None, self.model_config) + + return self.__class__( + type_=type_, + name=name, + class_validators=class_validators, + model_config=self.model_config, + field_info=field_info, + ) + + def populate_validators(self) -> None: + """ + Prepare self.pre_validators, self.validators, and self.post_validators based on self.type_'s __get_validators__ + and class validators. This method should be idempotent, e.g. it should be safe to call multiple times + without mis-configuring the field. + """ + self.validate_always = getattr(self.type_, 'validate_always', False) or any( + v.always for v in self.class_validators.values() + ) + + class_validators_ = self.class_validators.values() + if not self.sub_fields or self.shape == SHAPE_GENERIC: + get_validators = getattr(self.type_, '__get_validators__', None) + v_funcs = ( + *[v.func for v in class_validators_ if v.each_item and v.pre], + *(get_validators() if get_validators else list(find_validators(self.type_, self.model_config))), + *[v.func for v in class_validators_ if v.each_item and not v.pre], + ) + self.validators = prep_validators(v_funcs) + + self.pre_validators = [] + self.post_validators = [] + + if self.field_info and self.field_info.const: + self.post_validators.append(make_generic_validator(constant_validator)) + + if class_validators_: + self.pre_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and v.pre) + self.post_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and not v.pre) + + if self.parse_json: + self.pre_validators.append(make_generic_validator(validate_json)) + + self.pre_validators = self.pre_validators or None + self.post_validators = self.post_validators or None + + def validate( + self, v: Any, values: Dict[str, Any], *, loc: 'LocStr', cls: Optional['ModelOrDc'] = None + ) -> 'ValidateReturn': + assert self.type_.__class__ is not DeferredType + + if self.type_.__class__ is ForwardRef: + assert cls is not None + raise ConfigError( + f'field "{self.name}" not yet prepared so type is still a ForwardRef, ' + f'you might need to call {cls.__name__}.update_forward_refs().' + ) + + errors: Optional['ErrorList'] + if self.pre_validators: + v, errors = self._apply_validators(v, values, loc, cls, self.pre_validators) + if errors: + return v, errors + + if v is None: + if is_none_type(self.type_): + # keep validating + pass + elif self.allow_none: + if self.post_validators: + return self._apply_validators(v, values, loc, cls, self.post_validators) + else: + return None, None + else: + return v, ErrorWrapper(NoneIsNotAllowedError(), loc) + + if self.shape == SHAPE_SINGLETON: + v, errors = self._validate_singleton(v, values, loc, cls) + elif self.shape in MAPPING_LIKE_SHAPES: + v, errors = self._validate_mapping_like(v, values, loc, cls) + elif self.shape == SHAPE_TUPLE: + v, errors = self._validate_tuple(v, values, loc, cls) + elif self.shape == SHAPE_ITERABLE: + v, errors = self._validate_iterable(v, values, loc, cls) + elif self.shape == SHAPE_GENERIC: + v, errors = self._apply_validators(v, values, loc, cls, self.validators) + else: + # sequence, list, set, generator, tuple with ellipsis, frozen set + v, errors = self._validate_sequence_like(v, values, loc, cls) + + if not errors and self.post_validators: + v, errors = self._apply_validators(v, values, loc, cls, self.post_validators) + return v, errors + + def _validate_sequence_like( # noqa: C901 (ignore complexity) + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] + ) -> 'ValidateReturn': + """ + Validate sequence-like containers: lists, tuples, sets and generators + Note that large if-else blocks are necessary to enable Cython + optimization, which is why we disable the complexity check above. + """ + if not sequence_like(v): + e: errors_.PydanticTypeError + if self.shape == SHAPE_LIST: + e = errors_.ListError() + elif self.shape in (SHAPE_TUPLE, SHAPE_TUPLE_ELLIPSIS): + e = errors_.TupleError() + elif self.shape == SHAPE_SET: + e = errors_.SetError() + elif self.shape == SHAPE_FROZENSET: + e = errors_.FrozenSetError() + else: + e = errors_.SequenceError() + return v, ErrorWrapper(e, loc) + + loc = loc if isinstance(loc, tuple) else (loc,) + result = [] + errors: List[ErrorList] = [] + for i, v_ in enumerate(v): + v_loc = *loc, i + r, ee = self._validate_singleton(v_, values, v_loc, cls) + if ee: + errors.append(ee) + else: + result.append(r) + + if errors: + return v, errors + + converted: Union[List[Any], Set[Any], FrozenSet[Any], Tuple[Any, ...], Iterator[Any], Deque[Any]] = result + + if self.shape == SHAPE_SET: + converted = set(result) + elif self.shape == SHAPE_FROZENSET: + converted = frozenset(result) + elif self.shape == SHAPE_TUPLE_ELLIPSIS: + converted = tuple(result) + elif self.shape == SHAPE_DEQUE: + converted = deque(result, maxlen=getattr(v, 'maxlen', None)) + elif self.shape == SHAPE_SEQUENCE: + if isinstance(v, tuple): + converted = tuple(result) + elif isinstance(v, set): + converted = set(result) + elif isinstance(v, Generator): + converted = iter(result) + elif isinstance(v, deque): + converted = deque(result, maxlen=getattr(v, 'maxlen', None)) + return converted, None + + def _validate_iterable( + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] + ) -> 'ValidateReturn': + """ + Validate Iterables. + + This intentionally doesn't validate values to allow infinite generators. + """ + + try: + iterable = iter(v) + except TypeError: + return v, ErrorWrapper(errors_.IterableError(), loc) + return iterable, None + + def _validate_tuple( + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] + ) -> 'ValidateReturn': + e: Optional[Exception] = None + if not sequence_like(v): + e = errors_.TupleError() + else: + actual_length, expected_length = len(v), len(self.sub_fields) # type: ignore + if actual_length != expected_length: + e = errors_.TupleLengthError(actual_length=actual_length, expected_length=expected_length) + + if e: + return v, ErrorWrapper(e, loc) + + loc = loc if isinstance(loc, tuple) else (loc,) + result = [] + errors: List[ErrorList] = [] + for i, (v_, field) in enumerate(zip(v, self.sub_fields)): # type: ignore + v_loc = *loc, i + r, ee = field.validate(v_, values, loc=v_loc, cls=cls) + if ee: + errors.append(ee) + else: + result.append(r) + + if errors: + return v, errors + else: + return tuple(result), None + + def _validate_mapping_like( + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] + ) -> 'ValidateReturn': + try: + v_iter = dict_validator(v) + except TypeError as exc: + return v, ErrorWrapper(exc, loc) + + loc = loc if isinstance(loc, tuple) else (loc,) + result, errors = {}, [] + for k, v_ in v_iter.items(): + v_loc = *loc, '__key__' + key_result, key_errors = self.key_field.validate(k, values, loc=v_loc, cls=cls) # type: ignore + if key_errors: + errors.append(key_errors) + continue + + v_loc = *loc, k + value_result, value_errors = self._validate_singleton(v_, values, v_loc, cls) + if value_errors: + errors.append(value_errors) + continue + + result[key_result] = value_result + if errors: + return v, errors + elif self.shape == SHAPE_DICT: + return result, None + elif self.shape == SHAPE_DEFAULTDICT: + return defaultdict(self.type_, result), None + elif self.shape == SHAPE_COUNTER: + return CollectionCounter(result), None + else: + return self._get_mapping_value(v, result), None + + def _get_mapping_value(self, original: T, converted: Dict[Any, Any]) -> Union[T, Dict[Any, Any]]: + """ + When type is `Mapping[KT, KV]` (or another unsupported mapping), we try to avoid + coercing to `dict` unwillingly. + """ + original_cls = original.__class__ + + if original_cls == dict or original_cls == Dict: + return converted + elif original_cls in {defaultdict, DefaultDict}: + return defaultdict(self.type_, converted) + else: + try: + # Counter, OrderedDict, UserDict, ... + return original_cls(converted) # type: ignore + except TypeError: + raise RuntimeError(f'Could not convert dictionary to {original_cls.__name__!r}') from None + + def _validate_singleton( + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] + ) -> 'ValidateReturn': + if self.sub_fields: + if self.discriminator_key is not None: + return self._validate_discriminated_union(v, values, loc, cls) + + errors = [] + + if self.model_config.smart_union and is_union(get_origin(self.type_)): + # 1st pass: check if the value is an exact instance of one of the Union types + # (e.g. to avoid coercing a bool into an int) + for field in self.sub_fields: + if v.__class__ is field.outer_type_: + return v, None + + # 2nd pass: check if the value is an instance of any subclass of the Union types + for field in self.sub_fields: + # This whole logic will be improved later on to support more complex `isinstance` checks + # It will probably be done once a strict mode is added and be something like: + # ``` + # value, error = field.validate(v, values, strict=True) + # if error is None: + # return value, None + # ``` + try: + if isinstance(v, field.outer_type_): + return v, None + except TypeError: + # compound type + if lenient_isinstance(v, get_origin(field.outer_type_)): + value, error = field.validate(v, values, loc=loc, cls=cls) + if not error: + return value, None + + # 1st pass by default or 3rd pass with `smart_union` enabled: + # check if the value can be coerced into one of the Union types + for field in self.sub_fields: + value, error = field.validate(v, values, loc=loc, cls=cls) + if error: + errors.append(error) + else: + return value, None + return v, errors + else: + return self._apply_validators(v, values, loc, cls, self.validators) + + def _validate_discriminated_union( + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] + ) -> 'ValidateReturn': + assert self.discriminator_key is not None + assert self.discriminator_alias is not None + + try: + try: + discriminator_value = v[self.discriminator_alias] + except KeyError: + if self.model_config.allow_population_by_field_name: + discriminator_value = v[self.discriminator_key] + else: + raise + except KeyError: + return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc) + except TypeError: + try: + # BaseModel or dataclass + discriminator_value = getattr(v, self.discriminator_key) + except (AttributeError, TypeError): + return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc) + + if self.sub_fields_mapping is None: + assert cls is not None + raise ConfigError( + f'field "{self.name}" not yet prepared so type is still a ForwardRef, ' + f'you might need to call {cls.__name__}.update_forward_refs().' + ) + + try: + sub_field = self.sub_fields_mapping[discriminator_value] + except (KeyError, TypeError): + # KeyError: `discriminator_value` is not in the dictionary. + # TypeError: `discriminator_value` is unhashable. + assert self.sub_fields_mapping is not None + return v, ErrorWrapper( + InvalidDiscriminator( + discriminator_key=self.discriminator_key, + discriminator_value=discriminator_value, + allowed_values=list(self.sub_fields_mapping), + ), + loc, + ) + else: + if not isinstance(loc, tuple): + loc = (loc,) + return sub_field.validate(v, values, loc=(*loc, display_as_type(sub_field.type_)), cls=cls) + + def _apply_validators( + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'], validators: 'ValidatorsList' + ) -> 'ValidateReturn': + for validator in validators: + try: + v = validator(cls, v, values, self, self.model_config) + except (ValueError, TypeError, AssertionError) as exc: + return v, ErrorWrapper(exc, loc) + return v, None + + def is_complex(self) -> bool: + """ + Whether the field is "complex" eg. env variables should be parsed as JSON. + """ + from .main import BaseModel + + return ( + self.shape != SHAPE_SINGLETON + or hasattr(self.type_, '__pydantic_model__') + or lenient_issubclass(self.type_, (BaseModel, list, set, frozenset, dict)) + ) + + def _type_display(self) -> PyObjectStr: + t = display_as_type(self.type_) + + if self.shape in MAPPING_LIKE_SHAPES: + t = f'Mapping[{display_as_type(self.key_field.type_)}, {t}]' # type: ignore + elif self.shape == SHAPE_TUPLE: + t = 'Tuple[{}]'.format(', '.join(display_as_type(f.type_) for f in self.sub_fields)) # type: ignore + elif self.shape == SHAPE_GENERIC: + assert self.sub_fields + t = '{}[{}]'.format( + display_as_type(self.type_), ', '.join(display_as_type(f.type_) for f in self.sub_fields) + ) + elif self.shape != SHAPE_SINGLETON: + t = SHAPE_NAME_LOOKUP[self.shape].format(t) + + if self.allow_none and (self.shape != SHAPE_SINGLETON or not self.sub_fields): + t = f'Optional[{t}]' + return PyObjectStr(t) + + def __repr_args__(self) -> 'ReprArgs': + args = [('name', self.name), ('type', self._type_display()), ('required', self.required)] + + if not self.required: + if self.default_factory is not None: + args.append(('default_factory', f'')) + else: + args.append(('default', self.default)) + + if self.alt_alias: + args.append(('alias', self.alias)) + return args + + +class ModelPrivateAttr(Representation): + __slots__ = ('default', 'default_factory') + + def __init__(self, default: Any = Undefined, *, default_factory: Optional[NoArgAnyCallable] = None) -> None: + self.default = default + self.default_factory = default_factory + + def get_default(self) -> Any: + return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory() + + def __eq__(self, other: Any) -> bool: + return isinstance(other, self.__class__) and (self.default, self.default_factory) == ( + other.default, + other.default_factory, + ) + + +def PrivateAttr( + default: Any = Undefined, + *, + default_factory: Optional[NoArgAnyCallable] = None, +) -> Any: + """ + Indicates that attribute is only used internally and never mixed with regular fields. + + Types or values of private attrs are not checked by pydantic and it's up to you to keep them relevant. + + Private attrs are stored in model __slots__. + + :param default: the attribute’s default value + :param default_factory: callable that will be called when a default value is needed for this attribute + If both `default` and `default_factory` are set, an error is raised. + """ + if default is not Undefined and default_factory is not None: + raise ValueError('cannot specify both default and default_factory') + + return ModelPrivateAttr( + default, + default_factory=default_factory, + ) + + +class DeferredType: + """ + Used to postpone field preparation, while creating recursive generic models. + """ + + +def is_finalvar_with_default_val(type_: Type[Any], val: Any) -> bool: + return is_finalvar(type_) and val is not Undefined and not isinstance(val, FieldInfo) diff --git a/lib/pydantic/v1/generics.py b/lib/pydantic/v1/generics.py new file mode 100644 index 00000000..a75b6b98 --- /dev/null +++ b/lib/pydantic/v1/generics.py @@ -0,0 +1,400 @@ +import sys +import types +import typing +from typing import ( + TYPE_CHECKING, + Any, + ClassVar, + Dict, + ForwardRef, + Generic, + Iterator, + List, + Mapping, + Optional, + Tuple, + Type, + TypeVar, + Union, + cast, +) +from weakref import WeakKeyDictionary, WeakValueDictionary + +from typing_extensions import Annotated, Literal as ExtLiteral + +from .class_validators import gather_all_validators +from .fields import DeferredType +from .main import BaseModel, create_model +from .types import JsonWrapper +from .typing import display_as_type, get_all_type_hints, get_args, get_origin, typing_base +from .utils import all_identical, lenient_issubclass + +if sys.version_info >= (3, 10): + from typing import _UnionGenericAlias +if sys.version_info >= (3, 8): + from typing import Literal + +GenericModelT = TypeVar('GenericModelT', bound='GenericModel') +TypeVarType = Any # since mypy doesn't allow the use of TypeVar as a type + +CacheKey = Tuple[Type[Any], Any, Tuple[Any, ...]] +Parametrization = Mapping[TypeVarType, Type[Any]] + +# weak dictionaries allow the dynamically created parametrized versions of generic models to get collected +# once they are no longer referenced by the caller. +if sys.version_info >= (3, 9): # Typing for weak dictionaries available at 3.9 + GenericTypesCache = WeakValueDictionary[CacheKey, Type[BaseModel]] + AssignedParameters = WeakKeyDictionary[Type[BaseModel], Parametrization] +else: + GenericTypesCache = WeakValueDictionary + AssignedParameters = WeakKeyDictionary + +# _generic_types_cache is a Mapping from __class_getitem__ arguments to the parametrized version of generic models. +# This ensures multiple calls of e.g. A[B] return always the same class. +_generic_types_cache = GenericTypesCache() + +# _assigned_parameters is a Mapping from parametrized version of generic models to assigned types of parametrizations +# as captured during construction of the class (not instances). +# E.g., for generic model `Model[A, B]`, when parametrized model `Model[int, str]` is created, +# `Model[int, str]`: {A: int, B: str}` will be stored in `_assigned_parameters`. +# (This information is only otherwise available after creation from the class name string). +_assigned_parameters = AssignedParameters() + + +class GenericModel(BaseModel): + __slots__ = () + __concrete__: ClassVar[bool] = False + + if TYPE_CHECKING: + # Putting this in a TYPE_CHECKING block allows us to replace `if Generic not in cls.__bases__` with + # `not hasattr(cls, "__parameters__")`. This means we don't need to force non-concrete subclasses of + # `GenericModel` to also inherit from `Generic`, which would require changes to the use of `create_model` below. + __parameters__: ClassVar[Tuple[TypeVarType, ...]] + + # Setting the return type as Type[Any] instead of Type[BaseModel] prevents PyCharm warnings + def __class_getitem__(cls: Type[GenericModelT], params: Union[Type[Any], Tuple[Type[Any], ...]]) -> Type[Any]: + """Instantiates a new class from a generic class `cls` and type variables `params`. + + :param params: Tuple of types the class . Given a generic class + `Model` with 2 type variables and a concrete model `Model[str, int]`, + the value `(str, int)` would be passed to `params`. + :return: New model class inheriting from `cls` with instantiated + types described by `params`. If no parameters are given, `cls` is + returned as is. + + """ + + def _cache_key(_params: Any) -> CacheKey: + args = get_args(_params) + # python returns a list for Callables, which is not hashable + if len(args) == 2 and isinstance(args[0], list): + args = (tuple(args[0]), args[1]) + return cls, _params, args + + cached = _generic_types_cache.get(_cache_key(params)) + if cached is not None: + return cached + if cls.__concrete__ and Generic not in cls.__bases__: + raise TypeError('Cannot parameterize a concrete instantiation of a generic model') + if not isinstance(params, tuple): + params = (params,) + if cls is GenericModel and any(isinstance(param, TypeVar) for param in params): + raise TypeError('Type parameters should be placed on typing.Generic, not GenericModel') + if not hasattr(cls, '__parameters__'): + raise TypeError(f'Type {cls.__name__} must inherit from typing.Generic before being parameterized') + + check_parameters_count(cls, params) + # Build map from generic typevars to passed params + typevars_map: Dict[TypeVarType, Type[Any]] = dict(zip(cls.__parameters__, params)) + if all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map: + return cls # if arguments are equal to parameters it's the same object + + # Create new model with original model as parent inserting fields with DeferredType. + model_name = cls.__concrete_name__(params) + validators = gather_all_validators(cls) + + type_hints = get_all_type_hints(cls).items() + instance_type_hints = {k: v for k, v in type_hints if get_origin(v) is not ClassVar} + + fields = {k: (DeferredType(), cls.__fields__[k].field_info) for k in instance_type_hints if k in cls.__fields__} + + model_module, called_globally = get_caller_frame_info() + created_model = cast( + Type[GenericModel], # casting ensures mypy is aware of the __concrete__ and __parameters__ attributes + create_model( + model_name, + __module__=model_module or cls.__module__, + __base__=(cls,) + tuple(cls.__parameterized_bases__(typevars_map)), + __config__=None, + __validators__=validators, + __cls_kwargs__=None, + **fields, + ), + ) + + _assigned_parameters[created_model] = typevars_map + + if called_globally: # create global reference and therefore allow pickling + object_by_reference = None + reference_name = model_name + reference_module_globals = sys.modules[created_model.__module__].__dict__ + while object_by_reference is not created_model: + object_by_reference = reference_module_globals.setdefault(reference_name, created_model) + reference_name += '_' + + created_model.Config = cls.Config + + # Find any typevars that are still present in the model. + # If none are left, the model is fully "concrete", otherwise the new + # class is a generic class as well taking the found typevars as + # parameters. + new_params = tuple( + {param: None for param in iter_contained_typevars(typevars_map.values())} + ) # use dict as ordered set + created_model.__concrete__ = not new_params + if new_params: + created_model.__parameters__ = new_params + + # Save created model in cache so we don't end up creating duplicate + # models that should be identical. + _generic_types_cache[_cache_key(params)] = created_model + if len(params) == 1: + _generic_types_cache[_cache_key(params[0])] = created_model + + # Recursively walk class type hints and replace generic typevars + # with concrete types that were passed. + _prepare_model_fields(created_model, fields, instance_type_hints, typevars_map) + + return created_model + + @classmethod + def __concrete_name__(cls: Type[Any], params: Tuple[Type[Any], ...]) -> str: + """Compute class name for child classes. + + :param params: Tuple of types the class . Given a generic class + `Model` with 2 type variables and a concrete model `Model[str, int]`, + the value `(str, int)` would be passed to `params`. + :return: String representing a the new class where `params` are + passed to `cls` as type variables. + + This method can be overridden to achieve a custom naming scheme for GenericModels. + """ + param_names = [display_as_type(param) for param in params] + params_component = ', '.join(param_names) + return f'{cls.__name__}[{params_component}]' + + @classmethod + def __parameterized_bases__(cls, typevars_map: Parametrization) -> Iterator[Type[Any]]: + """ + Returns unbound bases of cls parameterised to given type variables + + :param typevars_map: Dictionary of type applications for binding subclasses. + Given a generic class `Model` with 2 type variables [S, T] + and a concrete model `Model[str, int]`, + the value `{S: str, T: int}` would be passed to `typevars_map`. + :return: an iterator of generic sub classes, parameterised by `typevars_map` + and other assigned parameters of `cls` + + e.g.: + ``` + class A(GenericModel, Generic[T]): + ... + + class B(A[V], Generic[V]): + ... + + assert A[int] in B.__parameterized_bases__({V: int}) + ``` + """ + + def build_base_model( + base_model: Type[GenericModel], mapped_types: Parametrization + ) -> Iterator[Type[GenericModel]]: + base_parameters = tuple(mapped_types[param] for param in base_model.__parameters__) + parameterized_base = base_model.__class_getitem__(base_parameters) + if parameterized_base is base_model or parameterized_base is cls: + # Avoid duplication in MRO + return + yield parameterized_base + + for base_model in cls.__bases__: + if not issubclass(base_model, GenericModel): + # not a class that can be meaningfully parameterized + continue + elif not getattr(base_model, '__parameters__', None): + # base_model is "GenericModel" (and has no __parameters__) + # or + # base_model is already concrete, and will be included transitively via cls. + continue + elif cls in _assigned_parameters: + if base_model in _assigned_parameters: + # cls is partially parameterised but not from base_model + # e.g. cls = B[S], base_model = A[S] + # B[S][int] should subclass A[int], (and will be transitively via B[int]) + # but it's not viable to consistently subclass types with arbitrary construction + # So don't attempt to include A[S][int] + continue + else: # base_model not in _assigned_parameters: + # cls is partially parameterized, base_model is original generic + # e.g. cls = B[str, T], base_model = B[S, T] + # Need to determine the mapping for the base_model parameters + mapped_types: Parametrization = { + key: typevars_map.get(value, value) for key, value in _assigned_parameters[cls].items() + } + yield from build_base_model(base_model, mapped_types) + else: + # cls is base generic, so base_class has a distinct base + # can construct the Parameterised base model using typevars_map directly + yield from build_base_model(base_model, typevars_map) + + +def replace_types(type_: Any, type_map: Mapping[Any, Any]) -> Any: + """Return type with all occurrences of `type_map` keys recursively replaced with their values. + + :param type_: Any type, class or generic alias + :param type_map: Mapping from `TypeVar` instance to concrete types. + :return: New type representing the basic structure of `type_` with all + `typevar_map` keys recursively replaced. + + >>> replace_types(Tuple[str, Union[List[str], float]], {str: int}) + Tuple[int, Union[List[int], float]] + + """ + if not type_map: + return type_ + + type_args = get_args(type_) + origin_type = get_origin(type_) + + if origin_type is Annotated: + annotated_type, *annotations = type_args + return Annotated[replace_types(annotated_type, type_map), tuple(annotations)] + + if (origin_type is ExtLiteral) or (sys.version_info >= (3, 8) and origin_type is Literal): + return type_map.get(type_, type_) + # Having type args is a good indicator that this is a typing module + # class instantiation or a generic alias of some sort. + if type_args: + resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args) + if all_identical(type_args, resolved_type_args): + # If all arguments are the same, there is no need to modify the + # type or create a new object at all + return type_ + if ( + origin_type is not None + and isinstance(type_, typing_base) + and not isinstance(origin_type, typing_base) + and getattr(type_, '_name', None) is not None + ): + # In python < 3.9 generic aliases don't exist so any of these like `list`, + # `type` or `collections.abc.Callable` need to be translated. + # See: https://www.python.org/dev/peps/pep-0585 + origin_type = getattr(typing, type_._name) + assert origin_type is not None + # PEP-604 syntax (Ex.: list | str) is represented with a types.UnionType object that does not have __getitem__. + # We also cannot use isinstance() since we have to compare types. + if sys.version_info >= (3, 10) and origin_type is types.UnionType: # noqa: E721 + return _UnionGenericAlias(origin_type, resolved_type_args) + return origin_type[resolved_type_args] + + # We handle pydantic generic models separately as they don't have the same + # semantics as "typing" classes or generic aliases + if not origin_type and lenient_issubclass(type_, GenericModel) and not type_.__concrete__: + type_args = type_.__parameters__ + resolved_type_args = tuple(replace_types(t, type_map) for t in type_args) + if all_identical(type_args, resolved_type_args): + return type_ + return type_[resolved_type_args] + + # Handle special case for typehints that can have lists as arguments. + # `typing.Callable[[int, str], int]` is an example for this. + if isinstance(type_, (List, list)): + resolved_list = list(replace_types(element, type_map) for element in type_) + if all_identical(type_, resolved_list): + return type_ + return resolved_list + + # For JsonWrapperValue, need to handle its inner type to allow correct parsing + # of generic Json arguments like Json[T] + if not origin_type and lenient_issubclass(type_, JsonWrapper): + type_.inner_type = replace_types(type_.inner_type, type_map) + return type_ + + # If all else fails, we try to resolve the type directly and otherwise just + # return the input with no modifications. + new_type = type_map.get(type_, type_) + # Convert string to ForwardRef + if isinstance(new_type, str): + return ForwardRef(new_type) + else: + return new_type + + +def check_parameters_count(cls: Type[GenericModel], parameters: Tuple[Any, ...]) -> None: + actual = len(parameters) + expected = len(cls.__parameters__) + if actual != expected: + description = 'many' if actual > expected else 'few' + raise TypeError(f'Too {description} parameters for {cls.__name__}; actual {actual}, expected {expected}') + + +DictValues: Type[Any] = {}.values().__class__ + + +def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]: + """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found.""" + if isinstance(v, TypeVar): + yield v + elif hasattr(v, '__parameters__') and not get_origin(v) and lenient_issubclass(v, GenericModel): + yield from v.__parameters__ + elif isinstance(v, (DictValues, list)): + for var in v: + yield from iter_contained_typevars(var) + else: + args = get_args(v) + for arg in args: + yield from iter_contained_typevars(arg) + + +def get_caller_frame_info() -> Tuple[Optional[str], bool]: + """ + Used inside a function to check whether it was called globally + + Will only work against non-compiled code, therefore used only in pydantic.generics + + :returns Tuple[module_name, called_globally] + """ + try: + previous_caller_frame = sys._getframe(2) + except ValueError as e: + raise RuntimeError('This function must be used inside another function') from e + except AttributeError: # sys module does not have _getframe function, so there's nothing we can do about it + return None, False + frame_globals = previous_caller_frame.f_globals + return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals + + +def _prepare_model_fields( + created_model: Type[GenericModel], + fields: Mapping[str, Any], + instance_type_hints: Mapping[str, type], + typevars_map: Mapping[Any, type], +) -> None: + """ + Replace DeferredType fields with concrete type hints and prepare them. + """ + + for key, field in created_model.__fields__.items(): + if key not in fields: + assert field.type_.__class__ is not DeferredType + # https://github.com/nedbat/coveragepy/issues/198 + continue # pragma: no cover + + assert field.type_.__class__ is DeferredType, field.type_.__class__ + + field_type_hint = instance_type_hints[key] + concrete_type = replace_types(field_type_hint, typevars_map) + field.type_ = concrete_type + field.outer_type_ = concrete_type + field.prepare() + created_model.__annotations__[key] = concrete_type diff --git a/lib/pydantic/v1/json.py b/lib/pydantic/v1/json.py new file mode 100644 index 00000000..b358b850 --- /dev/null +++ b/lib/pydantic/v1/json.py @@ -0,0 +1,112 @@ +import datetime +from collections import deque +from decimal import Decimal +from enum import Enum +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from pathlib import Path +from re import Pattern +from types import GeneratorType +from typing import Any, Callable, Dict, Type, Union +from uuid import UUID + +from .color import Color +from .networks import NameEmail +from .types import SecretBytes, SecretStr + +__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat' + + +def isoformat(o: Union[datetime.date, datetime.time]) -> str: + return o.isoformat() + + +def decimal_encoder(dec_value: Decimal) -> Union[int, float]: + """ + Encodes a Decimal as int of there's no exponent, otherwise float + + This is useful when we use ConstrainedDecimal to represent Numeric(x,0) + where a integer (but not int typed) is used. Encoding this as a float + results in failed round-tripping between encode and parse. + Our Id type is a prime example of this. + + >>> decimal_encoder(Decimal("1.0")) + 1.0 + + >>> decimal_encoder(Decimal("1")) + 1 + """ + if dec_value.as_tuple().exponent >= 0: + return int(dec_value) + else: + return float(dec_value) + + +ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = { + bytes: lambda o: o.decode(), + Color: str, + datetime.date: isoformat, + datetime.datetime: isoformat, + datetime.time: isoformat, + datetime.timedelta: lambda td: td.total_seconds(), + Decimal: decimal_encoder, + Enum: lambda o: o.value, + frozenset: list, + deque: list, + GeneratorType: list, + IPv4Address: str, + IPv4Interface: str, + IPv4Network: str, + IPv6Address: str, + IPv6Interface: str, + IPv6Network: str, + NameEmail: str, + Path: str, + Pattern: lambda o: o.pattern, + SecretBytes: str, + SecretStr: str, + set: list, + UUID: str, +} + + +def pydantic_encoder(obj: Any) -> Any: + from dataclasses import asdict, is_dataclass + + from .main import BaseModel + + if isinstance(obj, BaseModel): + return obj.dict() + elif is_dataclass(obj): + return asdict(obj) + + # Check the class type and its superclasses for a matching encoder + for base in obj.__class__.__mro__[:-1]: + try: + encoder = ENCODERS_BY_TYPE[base] + except KeyError: + continue + return encoder(obj) + else: # We have exited the for loop without finding a suitable encoder + raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable") + + +def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any: + # Check the class type and its superclasses for a matching encoder + for base in obj.__class__.__mro__[:-1]: + try: + encoder = type_encoders[base] + except KeyError: + continue + + return encoder(obj) + else: # We have exited the for loop without finding a suitable encoder + return pydantic_encoder(obj) + + +def timedelta_isoformat(td: datetime.timedelta) -> str: + """ + ISO 8601 encoding for Python timedelta object. + """ + minutes, seconds = divmod(td.seconds, 60) + hours, minutes = divmod(minutes, 60) + return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S' diff --git a/lib/pydantic/v1/main.py b/lib/pydantic/v1/main.py new file mode 100644 index 00000000..08b8af55 --- /dev/null +++ b/lib/pydantic/v1/main.py @@ -0,0 +1,1107 @@ +import warnings +from abc import ABCMeta +from copy import deepcopy +from enum import Enum +from functools import partial +from pathlib import Path +from types import FunctionType, prepare_class, resolve_bases +from typing import ( + TYPE_CHECKING, + AbstractSet, + Any, + Callable, + ClassVar, + Dict, + List, + Mapping, + Optional, + Tuple, + Type, + TypeVar, + Union, + cast, + no_type_check, + overload, +) + +from typing_extensions import dataclass_transform + +from .class_validators import ValidatorGroup, extract_root_validators, extract_validators, inherit_validators +from .config import BaseConfig, Extra, inherit_config, prepare_config +from .error_wrappers import ErrorWrapper, ValidationError +from .errors import ConfigError, DictError, ExtraError, MissingError +from .fields import ( + MAPPING_LIKE_SHAPES, + Field, + ModelField, + ModelPrivateAttr, + PrivateAttr, + Undefined, + is_finalvar_with_default_val, +) +from .json import custom_pydantic_encoder, pydantic_encoder +from .parse import Protocol, load_file, load_str_bytes +from .schema import default_ref_template, model_schema +from .types import PyObject, StrBytes +from .typing import ( + AnyCallable, + get_args, + get_origin, + is_classvar, + is_namedtuple, + is_union, + resolve_annotations, + update_model_forward_refs, +) +from .utils import ( + DUNDER_ATTRIBUTES, + ROOT_KEY, + ClassAttribute, + GetterDict, + Representation, + ValueItems, + generate_model_signature, + is_valid_field, + is_valid_private_name, + lenient_issubclass, + sequence_like, + smart_deepcopy, + unique_list, + validate_field_name, +) + +if TYPE_CHECKING: + from inspect import Signature + + from .class_validators import ValidatorListDict + from .types import ModelOrDc + from .typing import ( + AbstractSetIntStr, + AnyClassMethod, + CallableGenerator, + DictAny, + DictStrAny, + MappingIntStrAny, + ReprArgs, + SetStr, + TupleGenerator, + ) + + Model = TypeVar('Model', bound='BaseModel') + +__all__ = 'BaseModel', 'create_model', 'validate_model' + +_T = TypeVar('_T') + + +def validate_custom_root_type(fields: Dict[str, ModelField]) -> None: + if len(fields) > 1: + raise ValueError(f'{ROOT_KEY} cannot be mixed with other fields') + + +def generate_hash_function(frozen: bool) -> Optional[Callable[[Any], int]]: + def hash_function(self_: Any) -> int: + return hash(self_.__class__) + hash(tuple(self_.__dict__.values())) + + return hash_function if frozen else None + + +# If a field is of type `Callable`, its default value should be a function and cannot to ignored. +ANNOTATED_FIELD_UNTOUCHED_TYPES: Tuple[Any, ...] = (property, type, classmethod, staticmethod) +# When creating a `BaseModel` instance, we bypass all the methods, properties... added to the model +UNTOUCHED_TYPES: Tuple[Any, ...] = (FunctionType,) + ANNOTATED_FIELD_UNTOUCHED_TYPES +# Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we need to add this extra +# (somewhat hacky) boolean to keep track of whether we've created the `BaseModel` class yet, and therefore whether it's +# safe to refer to it. If it *hasn't* been created, we assume that the `__new__` call we're in the middle of is for +# the `BaseModel` class, since that's defined immediately after the metaclass. +_is_base_model_class_defined = False + + +@dataclass_transform(kw_only_default=True, field_specifiers=(Field,)) +class ModelMetaclass(ABCMeta): + @no_type_check # noqa C901 + def __new__(mcs, name, bases, namespace, **kwargs): # noqa C901 + fields: Dict[str, ModelField] = {} + config = BaseConfig + validators: 'ValidatorListDict' = {} + + pre_root_validators, post_root_validators = [], [] + private_attributes: Dict[str, ModelPrivateAttr] = {} + base_private_attributes: Dict[str, ModelPrivateAttr] = {} + slots: SetStr = namespace.get('__slots__', ()) + slots = {slots} if isinstance(slots, str) else set(slots) + class_vars: SetStr = set() + hash_func: Optional[Callable[[Any], int]] = None + + for base in reversed(bases): + if _is_base_model_class_defined and issubclass(base, BaseModel) and base != BaseModel: + fields.update(smart_deepcopy(base.__fields__)) + config = inherit_config(base.__config__, config) + validators = inherit_validators(base.__validators__, validators) + pre_root_validators += base.__pre_root_validators__ + post_root_validators += base.__post_root_validators__ + base_private_attributes.update(base.__private_attributes__) + class_vars.update(base.__class_vars__) + hash_func = base.__hash__ + + resolve_forward_refs = kwargs.pop('__resolve_forward_refs__', True) + allowed_config_kwargs: SetStr = { + key + for key in dir(config) + if not (key.startswith('__') and key.endswith('__')) # skip dunder methods and attributes + } + config_kwargs = {key: kwargs.pop(key) for key in kwargs.keys() & allowed_config_kwargs} + config_from_namespace = namespace.get('Config') + if config_kwargs and config_from_namespace: + raise TypeError('Specifying config in two places is ambiguous, use either Config attribute or class kwargs') + config = inherit_config(config_from_namespace, config, **config_kwargs) + + validators = inherit_validators(extract_validators(namespace), validators) + vg = ValidatorGroup(validators) + + for f in fields.values(): + f.set_config(config) + extra_validators = vg.get_validators(f.name) + if extra_validators: + f.class_validators.update(extra_validators) + # re-run prepare to add extra validators + f.populate_validators() + + prepare_config(config, name) + + untouched_types = ANNOTATED_FIELD_UNTOUCHED_TYPES + + def is_untouched(v: Any) -> bool: + return isinstance(v, untouched_types) or v.__class__.__name__ == 'cython_function_or_method' + + if (namespace.get('__module__'), namespace.get('__qualname__')) != ('pydantic.main', 'BaseModel'): + annotations = resolve_annotations(namespace.get('__annotations__', {}), namespace.get('__module__', None)) + # annotation only fields need to come first in fields + for ann_name, ann_type in annotations.items(): + if is_classvar(ann_type): + class_vars.add(ann_name) + elif is_finalvar_with_default_val(ann_type, namespace.get(ann_name, Undefined)): + class_vars.add(ann_name) + elif is_valid_field(ann_name): + validate_field_name(bases, ann_name) + value = namespace.get(ann_name, Undefined) + allowed_types = get_args(ann_type) if is_union(get_origin(ann_type)) else (ann_type,) + if ( + is_untouched(value) + and ann_type != PyObject + and not any( + lenient_issubclass(get_origin(allowed_type), Type) for allowed_type in allowed_types + ) + ): + continue + fields[ann_name] = ModelField.infer( + name=ann_name, + value=value, + annotation=ann_type, + class_validators=vg.get_validators(ann_name), + config=config, + ) + elif ann_name not in namespace and config.underscore_attrs_are_private: + private_attributes[ann_name] = PrivateAttr() + + untouched_types = UNTOUCHED_TYPES + config.keep_untouched + for var_name, value in namespace.items(): + can_be_changed = var_name not in class_vars and not is_untouched(value) + if isinstance(value, ModelPrivateAttr): + if not is_valid_private_name(var_name): + raise NameError( + f'Private attributes "{var_name}" must not be a valid field name; ' + f'Use sunder or dunder names, e. g. "_{var_name}" or "__{var_name}__"' + ) + private_attributes[var_name] = value + elif config.underscore_attrs_are_private and is_valid_private_name(var_name) and can_be_changed: + private_attributes[var_name] = PrivateAttr(default=value) + elif is_valid_field(var_name) and var_name not in annotations and can_be_changed: + validate_field_name(bases, var_name) + inferred = ModelField.infer( + name=var_name, + value=value, + annotation=annotations.get(var_name, Undefined), + class_validators=vg.get_validators(var_name), + config=config, + ) + if var_name in fields: + if lenient_issubclass(inferred.type_, fields[var_name].type_): + inferred.type_ = fields[var_name].type_ + else: + raise TypeError( + f'The type of {name}.{var_name} differs from the new default value; ' + f'if you wish to change the type of this field, please use a type annotation' + ) + fields[var_name] = inferred + + _custom_root_type = ROOT_KEY in fields + if _custom_root_type: + validate_custom_root_type(fields) + vg.check_for_unused() + if config.json_encoders: + json_encoder = partial(custom_pydantic_encoder, config.json_encoders) + else: + json_encoder = pydantic_encoder + pre_rv_new, post_rv_new = extract_root_validators(namespace) + + if hash_func is None: + hash_func = generate_hash_function(config.frozen) + + exclude_from_namespace = fields | private_attributes.keys() | {'__slots__'} + new_namespace = { + '__config__': config, + '__fields__': fields, + '__exclude_fields__': { + name: field.field_info.exclude for name, field in fields.items() if field.field_info.exclude is not None + } + or None, + '__include_fields__': { + name: field.field_info.include for name, field in fields.items() if field.field_info.include is not None + } + or None, + '__validators__': vg.validators, + '__pre_root_validators__': unique_list( + pre_root_validators + pre_rv_new, + name_factory=lambda v: v.__name__, + ), + '__post_root_validators__': unique_list( + post_root_validators + post_rv_new, + name_factory=lambda skip_on_failure_and_v: skip_on_failure_and_v[1].__name__, + ), + '__schema_cache__': {}, + '__json_encoder__': staticmethod(json_encoder), + '__custom_root_type__': _custom_root_type, + '__private_attributes__': {**base_private_attributes, **private_attributes}, + '__slots__': slots | private_attributes.keys(), + '__hash__': hash_func, + '__class_vars__': class_vars, + **{n: v for n, v in namespace.items() if n not in exclude_from_namespace}, + } + + cls = super().__new__(mcs, name, bases, new_namespace, **kwargs) + # set __signature__ attr only for model class, but not for its instances + cls.__signature__ = ClassAttribute('__signature__', generate_model_signature(cls.__init__, fields, config)) + if resolve_forward_refs: + cls.__try_update_forward_refs__() + + # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487 + # for attributes not in `new_namespace` (e.g. private attributes) + for name, obj in namespace.items(): + if name not in new_namespace: + set_name = getattr(obj, '__set_name__', None) + if callable(set_name): + set_name(cls, name) + + return cls + + def __instancecheck__(self, instance: Any) -> bool: + """ + Avoid calling ABC _abc_subclasscheck unless we're pretty sure. + + See #3829 and python/cpython#92810 + """ + return hasattr(instance, '__fields__') and super().__instancecheck__(instance) + + +object_setattr = object.__setattr__ + + +class BaseModel(Representation, metaclass=ModelMetaclass): + if TYPE_CHECKING: + # populated by the metaclass, defined here to help IDEs only + __fields__: ClassVar[Dict[str, ModelField]] = {} + __include_fields__: ClassVar[Optional[Mapping[str, Any]]] = None + __exclude_fields__: ClassVar[Optional[Mapping[str, Any]]] = None + __validators__: ClassVar[Dict[str, AnyCallable]] = {} + __pre_root_validators__: ClassVar[List[AnyCallable]] + __post_root_validators__: ClassVar[List[Tuple[bool, AnyCallable]]] + __config__: ClassVar[Type[BaseConfig]] = BaseConfig + __json_encoder__: ClassVar[Callable[[Any], Any]] = lambda x: x + __schema_cache__: ClassVar['DictAny'] = {} + __custom_root_type__: ClassVar[bool] = False + __signature__: ClassVar['Signature'] + __private_attributes__: ClassVar[Dict[str, ModelPrivateAttr]] + __class_vars__: ClassVar[SetStr] + __fields_set__: ClassVar[SetStr] = set() + + Config = BaseConfig + __slots__ = ('__dict__', '__fields_set__') + __doc__ = '' # Null out the Representation docstring + + def __init__(__pydantic_self__, **data: Any) -> None: + """ + Create a new model by parsing and validating input data from keyword arguments. + + Raises ValidationError if the input data cannot be parsed to form a valid model. + """ + # Uses something other than `self` the first arg to allow "self" as a settable attribute + values, fields_set, validation_error = validate_model(__pydantic_self__.__class__, data) + if validation_error: + raise validation_error + try: + object_setattr(__pydantic_self__, '__dict__', values) + except TypeError as e: + raise TypeError( + 'Model values must be a dict; you may not have returned a dictionary from a root validator' + ) from e + object_setattr(__pydantic_self__, '__fields_set__', fields_set) + __pydantic_self__._init_private_attributes() + + @no_type_check + def __setattr__(self, name, value): # noqa: C901 (ignore complexity) + if name in self.__private_attributes__ or name in DUNDER_ATTRIBUTES: + return object_setattr(self, name, value) + + if self.__config__.extra is not Extra.allow and name not in self.__fields__: + raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"') + elif not self.__config__.allow_mutation or self.__config__.frozen: + raise TypeError(f'"{self.__class__.__name__}" is immutable and does not support item assignment') + elif name in self.__fields__ and self.__fields__[name].final: + raise TypeError( + f'"{self.__class__.__name__}" object "{name}" field is final and does not support reassignment' + ) + elif self.__config__.validate_assignment: + new_values = {**self.__dict__, name: value} + + for validator in self.__pre_root_validators__: + try: + new_values = validator(self.__class__, new_values) + except (ValueError, TypeError, AssertionError) as exc: + raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], self.__class__) + + known_field = self.__fields__.get(name, None) + if known_field: + # We want to + # - make sure validators are called without the current value for this field inside `values` + # - keep other values (e.g. submodels) untouched (using `BaseModel.dict()` will change them into dicts) + # - keep the order of the fields + if not known_field.field_info.allow_mutation: + raise TypeError(f'"{known_field.name}" has allow_mutation set to False and cannot be assigned') + dict_without_original_value = {k: v for k, v in self.__dict__.items() if k != name} + value, error_ = known_field.validate(value, dict_without_original_value, loc=name, cls=self.__class__) + if error_: + raise ValidationError([error_], self.__class__) + else: + new_values[name] = value + + errors = [] + for skip_on_failure, validator in self.__post_root_validators__: + if skip_on_failure and errors: + continue + try: + new_values = validator(self.__class__, new_values) + except (ValueError, TypeError, AssertionError) as exc: + errors.append(ErrorWrapper(exc, loc=ROOT_KEY)) + if errors: + raise ValidationError(errors, self.__class__) + + # update the whole __dict__ as other values than just `value` + # may be changed (e.g. with `root_validator`) + object_setattr(self, '__dict__', new_values) + else: + self.__dict__[name] = value + + self.__fields_set__.add(name) + + def __getstate__(self) -> 'DictAny': + private_attrs = ((k, getattr(self, k, Undefined)) for k in self.__private_attributes__) + return { + '__dict__': self.__dict__, + '__fields_set__': self.__fields_set__, + '__private_attribute_values__': {k: v for k, v in private_attrs if v is not Undefined}, + } + + def __setstate__(self, state: 'DictAny') -> None: + object_setattr(self, '__dict__', state['__dict__']) + object_setattr(self, '__fields_set__', state['__fields_set__']) + for name, value in state.get('__private_attribute_values__', {}).items(): + object_setattr(self, name, value) + + def _init_private_attributes(self) -> None: + for name, private_attr in self.__private_attributes__.items(): + default = private_attr.get_default() + if default is not Undefined: + object_setattr(self, name, default) + + def dict( + self, + *, + include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + by_alias: bool = False, + skip_defaults: Optional[bool] = None, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + ) -> 'DictStrAny': + """ + Generate a dictionary representation of the model, optionally specifying which fields to include or exclude. + + """ + if skip_defaults is not None: + warnings.warn( + f'{self.__class__.__name__}.dict(): "skip_defaults" is deprecated and replaced by "exclude_unset"', + DeprecationWarning, + ) + exclude_unset = skip_defaults + + return dict( + self._iter( + to_dict=True, + by_alias=by_alias, + include=include, + exclude=exclude, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + ) + + def json( + self, + *, + include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + by_alias: bool = False, + skip_defaults: Optional[bool] = None, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + encoder: Optional[Callable[[Any], Any]] = None, + models_as_dict: bool = True, + **dumps_kwargs: Any, + ) -> str: + """ + Generate a JSON representation of the model, `include` and `exclude` arguments as per `dict()`. + + `encoder` is an optional function to supply as `default` to json.dumps(), other arguments as per `json.dumps()`. + """ + if skip_defaults is not None: + warnings.warn( + f'{self.__class__.__name__}.json(): "skip_defaults" is deprecated and replaced by "exclude_unset"', + DeprecationWarning, + ) + exclude_unset = skip_defaults + encoder = cast(Callable[[Any], Any], encoder or self.__json_encoder__) + + # We don't directly call `self.dict()`, which does exactly this with `to_dict=True` + # because we want to be able to keep raw `BaseModel` instances and not as `dict`. + # This allows users to write custom JSON encoders for given `BaseModel` classes. + data = dict( + self._iter( + to_dict=models_as_dict, + by_alias=by_alias, + include=include, + exclude=exclude, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + ) + if self.__custom_root_type__: + data = data[ROOT_KEY] + return self.__config__.json_dumps(data, default=encoder, **dumps_kwargs) + + @classmethod + def _enforce_dict_if_root(cls, obj: Any) -> Any: + if cls.__custom_root_type__ and ( + not (isinstance(obj, dict) and obj.keys() == {ROOT_KEY}) + and not (isinstance(obj, BaseModel) and obj.__fields__.keys() == {ROOT_KEY}) + or cls.__fields__[ROOT_KEY].shape in MAPPING_LIKE_SHAPES + ): + return {ROOT_KEY: obj} + else: + return obj + + @classmethod + def parse_obj(cls: Type['Model'], obj: Any) -> 'Model': + obj = cls._enforce_dict_if_root(obj) + if not isinstance(obj, dict): + try: + obj = dict(obj) + except (TypeError, ValueError) as e: + exc = TypeError(f'{cls.__name__} expected dict not {obj.__class__.__name__}') + raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls) from e + return cls(**obj) + + @classmethod + def parse_raw( + cls: Type['Model'], + b: StrBytes, + *, + content_type: str = None, + encoding: str = 'utf8', + proto: Protocol = None, + allow_pickle: bool = False, + ) -> 'Model': + try: + obj = load_str_bytes( + b, + proto=proto, + content_type=content_type, + encoding=encoding, + allow_pickle=allow_pickle, + json_loads=cls.__config__.json_loads, + ) + except (ValueError, TypeError, UnicodeDecodeError) as e: + raise ValidationError([ErrorWrapper(e, loc=ROOT_KEY)], cls) + return cls.parse_obj(obj) + + @classmethod + def parse_file( + cls: Type['Model'], + path: Union[str, Path], + *, + content_type: str = None, + encoding: str = 'utf8', + proto: Protocol = None, + allow_pickle: bool = False, + ) -> 'Model': + obj = load_file( + path, + proto=proto, + content_type=content_type, + encoding=encoding, + allow_pickle=allow_pickle, + json_loads=cls.__config__.json_loads, + ) + return cls.parse_obj(obj) + + @classmethod + def from_orm(cls: Type['Model'], obj: Any) -> 'Model': + if not cls.__config__.orm_mode: + raise ConfigError('You must have the config attribute orm_mode=True to use from_orm') + obj = {ROOT_KEY: obj} if cls.__custom_root_type__ else cls._decompose_class(obj) + m = cls.__new__(cls) + values, fields_set, validation_error = validate_model(cls, obj) + if validation_error: + raise validation_error + object_setattr(m, '__dict__', values) + object_setattr(m, '__fields_set__', fields_set) + m._init_private_attributes() + return m + + @classmethod + def construct(cls: Type['Model'], _fields_set: Optional['SetStr'] = None, **values: Any) -> 'Model': + """ + Creates a new model setting __dict__ and __fields_set__ from trusted or pre-validated data. + Default values are respected, but no other validation is performed. + Behaves as if `Config.extra = 'allow'` was set since it adds all passed values + """ + m = cls.__new__(cls) + fields_values: Dict[str, Any] = {} + for name, field in cls.__fields__.items(): + if field.alt_alias and field.alias in values: + fields_values[name] = values[field.alias] + elif name in values: + fields_values[name] = values[name] + elif not field.required: + fields_values[name] = field.get_default() + fields_values.update(values) + object_setattr(m, '__dict__', fields_values) + if _fields_set is None: + _fields_set = set(values.keys()) + object_setattr(m, '__fields_set__', _fields_set) + m._init_private_attributes() + return m + + def _copy_and_set_values(self: 'Model', values: 'DictStrAny', fields_set: 'SetStr', *, deep: bool) -> 'Model': + if deep: + # chances of having empty dict here are quite low for using smart_deepcopy + values = deepcopy(values) + + cls = self.__class__ + m = cls.__new__(cls) + object_setattr(m, '__dict__', values) + object_setattr(m, '__fields_set__', fields_set) + for name in self.__private_attributes__: + value = getattr(self, name, Undefined) + if value is not Undefined: + if deep: + value = deepcopy(value) + object_setattr(m, name, value) + + return m + + def copy( + self: 'Model', + *, + include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + update: Optional['DictStrAny'] = None, + deep: bool = False, + ) -> 'Model': + """ + Duplicate a model, optionally choose which fields to include, exclude and change. + + :param include: fields to include in new model + :param exclude: fields to exclude from new model, as with values this takes precedence over include + :param update: values to change/add in the new model. Note: the data is not validated before creating + the new model: you should trust this data + :param deep: set to `True` to make a deep copy of the model + :return: new model instance + """ + + values = dict( + self._iter(to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False), + **(update or {}), + ) + + # new `__fields_set__` can have unset optional fields with a set value in `update` kwarg + if update: + fields_set = self.__fields_set__ | update.keys() + else: + fields_set = set(self.__fields_set__) + + return self._copy_and_set_values(values, fields_set, deep=deep) + + @classmethod + def schema(cls, by_alias: bool = True, ref_template: str = default_ref_template) -> 'DictStrAny': + cached = cls.__schema_cache__.get((by_alias, ref_template)) + if cached is not None: + return cached + s = model_schema(cls, by_alias=by_alias, ref_template=ref_template) + cls.__schema_cache__[(by_alias, ref_template)] = s + return s + + @classmethod + def schema_json( + cls, *, by_alias: bool = True, ref_template: str = default_ref_template, **dumps_kwargs: Any + ) -> str: + from .json import pydantic_encoder + + return cls.__config__.json_dumps( + cls.schema(by_alias=by_alias, ref_template=ref_template), default=pydantic_encoder, **dumps_kwargs + ) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls: Type['Model'], value: Any) -> 'Model': + if isinstance(value, cls): + copy_on_model_validation = cls.__config__.copy_on_model_validation + # whether to deep or shallow copy the model on validation, None means do not copy + deep_copy: Optional[bool] = None + if copy_on_model_validation not in {'deep', 'shallow', 'none'}: + # Warn about deprecated behavior + warnings.warn( + "`copy_on_model_validation` should be a string: 'deep', 'shallow' or 'none'", DeprecationWarning + ) + if copy_on_model_validation: + deep_copy = False + + if copy_on_model_validation == 'shallow': + # shallow copy + deep_copy = False + elif copy_on_model_validation == 'deep': + # deep copy + deep_copy = True + + if deep_copy is None: + return value + else: + return value._copy_and_set_values(value.__dict__, value.__fields_set__, deep=deep_copy) + + value = cls._enforce_dict_if_root(value) + + if isinstance(value, dict): + return cls(**value) + elif cls.__config__.orm_mode: + return cls.from_orm(value) + else: + try: + value_as_dict = dict(value) + except (TypeError, ValueError) as e: + raise DictError() from e + return cls(**value_as_dict) + + @classmethod + def _decompose_class(cls: Type['Model'], obj: Any) -> GetterDict: + if isinstance(obj, GetterDict): + return obj + return cls.__config__.getter_dict(obj) + + @classmethod + @no_type_check + def _get_value( + cls, + v: Any, + to_dict: bool, + by_alias: bool, + include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']], + exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']], + exclude_unset: bool, + exclude_defaults: bool, + exclude_none: bool, + ) -> Any: + if isinstance(v, BaseModel): + if to_dict: + v_dict = v.dict( + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + include=include, + exclude=exclude, + exclude_none=exclude_none, + ) + if ROOT_KEY in v_dict: + return v_dict[ROOT_KEY] + return v_dict + else: + return v.copy(include=include, exclude=exclude) + + value_exclude = ValueItems(v, exclude) if exclude else None + value_include = ValueItems(v, include) if include else None + + if isinstance(v, dict): + return { + k_: cls._get_value( + v_, + to_dict=to_dict, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + include=value_include and value_include.for_element(k_), + exclude=value_exclude and value_exclude.for_element(k_), + exclude_none=exclude_none, + ) + for k_, v_ in v.items() + if (not value_exclude or not value_exclude.is_excluded(k_)) + and (not value_include or value_include.is_included(k_)) + } + + elif sequence_like(v): + seq_args = ( + cls._get_value( + v_, + to_dict=to_dict, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + include=value_include and value_include.for_element(i), + exclude=value_exclude and value_exclude.for_element(i), + exclude_none=exclude_none, + ) + for i, v_ in enumerate(v) + if (not value_exclude or not value_exclude.is_excluded(i)) + and (not value_include or value_include.is_included(i)) + ) + + return v.__class__(*seq_args) if is_namedtuple(v.__class__) else v.__class__(seq_args) + + elif isinstance(v, Enum) and getattr(cls.Config, 'use_enum_values', False): + return v.value + + else: + return v + + @classmethod + def __try_update_forward_refs__(cls, **localns: Any) -> None: + """ + Same as update_forward_refs but will not raise exception + when forward references are not defined. + """ + update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns, (NameError,)) + + @classmethod + def update_forward_refs(cls, **localns: Any) -> None: + """ + Try to update ForwardRefs on fields based on this Model, globalns and localns. + """ + update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns) + + def __iter__(self) -> 'TupleGenerator': + """ + so `dict(model)` works + """ + yield from self.__dict__.items() + + def _iter( + self, + to_dict: bool = False, + by_alias: bool = False, + include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + ) -> 'TupleGenerator': + # Merge field set excludes with explicit exclude parameter with explicit overriding field set options. + # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case. + if exclude is not None or self.__exclude_fields__ is not None: + exclude = ValueItems.merge(self.__exclude_fields__, exclude) + + if include is not None or self.__include_fields__ is not None: + include = ValueItems.merge(self.__include_fields__, include, intersect=True) + + allowed_keys = self._calculate_keys( + include=include, exclude=exclude, exclude_unset=exclude_unset # type: ignore + ) + if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none): + # huge boost for plain _iter() + yield from self.__dict__.items() + return + + value_exclude = ValueItems(self, exclude) if exclude is not None else None + value_include = ValueItems(self, include) if include is not None else None + + for field_key, v in self.__dict__.items(): + if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None): + continue + + if exclude_defaults: + model_field = self.__fields__.get(field_key) + if not getattr(model_field, 'required', True) and getattr(model_field, 'default', _missing) == v: + continue + + if by_alias and field_key in self.__fields__: + dict_key = self.__fields__[field_key].alias + else: + dict_key = field_key + + if to_dict or value_include or value_exclude: + v = self._get_value( + v, + to_dict=to_dict, + by_alias=by_alias, + include=value_include and value_include.for_element(field_key), + exclude=value_exclude and value_exclude.for_element(field_key), + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + yield dict_key, v + + def _calculate_keys( + self, + include: Optional['MappingIntStrAny'], + exclude: Optional['MappingIntStrAny'], + exclude_unset: bool, + update: Optional['DictStrAny'] = None, + ) -> Optional[AbstractSet[str]]: + if include is None and exclude is None and exclude_unset is False: + return None + + keys: AbstractSet[str] + if exclude_unset: + keys = self.__fields_set__.copy() + else: + keys = self.__dict__.keys() + + if include is not None: + keys &= include.keys() + + if update: + keys -= update.keys() + + if exclude: + keys -= {k for k, v in exclude.items() if ValueItems.is_true(v)} + + return keys + + def __eq__(self, other: Any) -> bool: + if isinstance(other, BaseModel): + return self.dict() == other.dict() + else: + return self.dict() == other + + def __repr_args__(self) -> 'ReprArgs': + return [ + (k, v) + for k, v in self.__dict__.items() + if k not in DUNDER_ATTRIBUTES and (k not in self.__fields__ or self.__fields__[k].field_info.repr) + ] + + +_is_base_model_class_defined = True + + +@overload +def create_model( + __model_name: str, + *, + __config__: Optional[Type[BaseConfig]] = None, + __base__: None = None, + __module__: str = __name__, + __validators__: Dict[str, 'AnyClassMethod'] = None, + __cls_kwargs__: Dict[str, Any] = None, + **field_definitions: Any, +) -> Type['BaseModel']: + ... + + +@overload +def create_model( + __model_name: str, + *, + __config__: Optional[Type[BaseConfig]] = None, + __base__: Union[Type['Model'], Tuple[Type['Model'], ...]], + __module__: str = __name__, + __validators__: Dict[str, 'AnyClassMethod'] = None, + __cls_kwargs__: Dict[str, Any] = None, + **field_definitions: Any, +) -> Type['Model']: + ... + + +def create_model( + __model_name: str, + *, + __config__: Optional[Type[BaseConfig]] = None, + __base__: Union[None, Type['Model'], Tuple[Type['Model'], ...]] = None, + __module__: str = __name__, + __validators__: Dict[str, 'AnyClassMethod'] = None, + __cls_kwargs__: Dict[str, Any] = None, + __slots__: Optional[Tuple[str, ...]] = None, + **field_definitions: Any, +) -> Type['Model']: + """ + Dynamically create a model. + :param __model_name: name of the created model + :param __config__: config class to use for the new model + :param __base__: base class for the new model to inherit from + :param __module__: module of the created model + :param __validators__: a dict of method names and @validator class methods + :param __cls_kwargs__: a dict for class creation + :param __slots__: Deprecated, `__slots__` should not be passed to `create_model` + :param field_definitions: fields of the model (or extra fields if a base is supplied) + in the format `=(, )` or `=, e.g. + `foobar=(str, ...)` or `foobar=123`, or, for complex use-cases, in the format + `=` or `=(, )`, e.g. + `foo=Field(datetime, default_factory=datetime.utcnow, alias='bar')` or + `foo=(str, FieldInfo(title='Foo'))` + """ + if __slots__ is not None: + # __slots__ will be ignored from here on + warnings.warn('__slots__ should not be passed to create_model', RuntimeWarning) + + if __base__ is not None: + if __config__ is not None: + raise ConfigError('to avoid confusion __config__ and __base__ cannot be used together') + if not isinstance(__base__, tuple): + __base__ = (__base__,) + else: + __base__ = (cast(Type['Model'], BaseModel),) + + __cls_kwargs__ = __cls_kwargs__ or {} + + fields = {} + annotations = {} + + for f_name, f_def in field_definitions.items(): + if not is_valid_field(f_name): + warnings.warn(f'fields may not start with an underscore, ignoring "{f_name}"', RuntimeWarning) + if isinstance(f_def, tuple): + try: + f_annotation, f_value = f_def + except ValueError as e: + raise ConfigError( + 'field definitions should either be a tuple of (, ) or just a ' + 'default value, unfortunately this means tuples as ' + 'default values are not allowed' + ) from e + else: + f_annotation, f_value = None, f_def + + if f_annotation: + annotations[f_name] = f_annotation + fields[f_name] = f_value + + namespace: 'DictStrAny' = {'__annotations__': annotations, '__module__': __module__} + if __validators__: + namespace.update(__validators__) + namespace.update(fields) + if __config__: + namespace['Config'] = inherit_config(__config__, BaseConfig) + resolved_bases = resolve_bases(__base__) + meta, ns, kwds = prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__) + if resolved_bases is not __base__: + ns['__orig_bases__'] = __base__ + namespace.update(ns) + return meta(__model_name, resolved_bases, namespace, **kwds) + + +_missing = object() + + +def validate_model( # noqa: C901 (ignore complexity) + model: Type[BaseModel], input_data: 'DictStrAny', cls: 'ModelOrDc' = None +) -> Tuple['DictStrAny', 'SetStr', Optional[ValidationError]]: + """ + validate data against a model. + """ + values = {} + errors = [] + # input_data names, possibly alias + names_used = set() + # field names, never aliases + fields_set = set() + config = model.__config__ + check_extra = config.extra is not Extra.ignore + cls_ = cls or model + + for validator in model.__pre_root_validators__: + try: + input_data = validator(cls_, input_data) + except (ValueError, TypeError, AssertionError) as exc: + return {}, set(), ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls_) + + for name, field in model.__fields__.items(): + value = input_data.get(field.alias, _missing) + using_name = False + if value is _missing and config.allow_population_by_field_name and field.alt_alias: + value = input_data.get(field.name, _missing) + using_name = True + + if value is _missing: + if field.required: + errors.append(ErrorWrapper(MissingError(), loc=field.alias)) + continue + + value = field.get_default() + + if not config.validate_all and not field.validate_always: + values[name] = value + continue + else: + fields_set.add(name) + if check_extra: + names_used.add(field.name if using_name else field.alias) + + v_, errors_ = field.validate(value, values, loc=field.alias, cls=cls_) + if isinstance(errors_, ErrorWrapper): + errors.append(errors_) + elif isinstance(errors_, list): + errors.extend(errors_) + else: + values[name] = v_ + + if check_extra: + if isinstance(input_data, GetterDict): + extra = input_data.extra_keys() - names_used + else: + extra = input_data.keys() - names_used + if extra: + fields_set |= extra + if config.extra is Extra.allow: + for f in extra: + values[f] = input_data[f] + else: + for f in sorted(extra): + errors.append(ErrorWrapper(ExtraError(), loc=f)) + + for skip_on_failure, validator in model.__post_root_validators__: + if skip_on_failure and errors: + continue + try: + values = validator(cls_, values) + except (ValueError, TypeError, AssertionError) as exc: + errors.append(ErrorWrapper(exc, loc=ROOT_KEY)) + + if errors: + return values, fields_set, ValidationError(errors, cls_) + else: + return values, fields_set, None diff --git a/lib/pydantic/v1/mypy.py b/lib/pydantic/v1/mypy.py new file mode 100644 index 00000000..1d6d5ae2 --- /dev/null +++ b/lib/pydantic/v1/mypy.py @@ -0,0 +1,944 @@ +import sys +from configparser import ConfigParser +from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Type as TypingType, Union + +from mypy.errorcodes import ErrorCode +from mypy.nodes import ( + ARG_NAMED, + ARG_NAMED_OPT, + ARG_OPT, + ARG_POS, + ARG_STAR2, + MDEF, + Argument, + AssignmentStmt, + Block, + CallExpr, + ClassDef, + Context, + Decorator, + EllipsisExpr, + FuncBase, + FuncDef, + JsonDict, + MemberExpr, + NameExpr, + PassStmt, + PlaceholderNode, + RefExpr, + StrExpr, + SymbolNode, + SymbolTableNode, + TempNode, + TypeInfo, + TypeVarExpr, + Var, +) +from mypy.options import Options +from mypy.plugin import ( + CheckerPluginInterface, + ClassDefContext, + FunctionContext, + MethodContext, + Plugin, + ReportConfigContext, + SemanticAnalyzerPluginInterface, +) +from mypy.plugins import dataclasses +from mypy.semanal import set_callable_name # type: ignore +from mypy.server.trigger import make_wildcard_trigger +from mypy.types import ( + AnyType, + CallableType, + Instance, + NoneType, + Overloaded, + ProperType, + Type, + TypeOfAny, + TypeType, + TypeVarType, + UnionType, + get_proper_type, +) +from mypy.typevars import fill_typevars +from mypy.util import get_unique_redefinition_name +from mypy.version import __version__ as mypy_version + +from pydantic.utils import is_valid_field + +try: + from mypy.types import TypeVarDef # type: ignore[attr-defined] +except ImportError: # pragma: no cover + # Backward-compatible with TypeVarDef from Mypy 0.910. + from mypy.types import TypeVarType as TypeVarDef + +CONFIGFILE_KEY = 'pydantic-mypy' +METADATA_KEY = 'pydantic-mypy-metadata' +_NAMESPACE = __name__[:-5] # 'pydantic' in 1.10.X, 'pydantic.v1' in v2.X +BASEMODEL_FULLNAME = f'{_NAMESPACE}.main.BaseModel' +BASESETTINGS_FULLNAME = f'{_NAMESPACE}.env_settings.BaseSettings' +MODEL_METACLASS_FULLNAME = f'{_NAMESPACE}.main.ModelMetaclass' +FIELD_FULLNAME = f'{_NAMESPACE}.fields.Field' +DATACLASS_FULLNAME = f'{_NAMESPACE}.dataclasses.dataclass' + + +def parse_mypy_version(version: str) -> Tuple[int, ...]: + return tuple(map(int, version.partition('+')[0].split('.'))) + + +MYPY_VERSION_TUPLE = parse_mypy_version(mypy_version) +BUILTINS_NAME = 'builtins' if MYPY_VERSION_TUPLE >= (0, 930) else '__builtins__' + +# Increment version if plugin changes and mypy caches should be invalidated +__version__ = 2 + + +def plugin(version: str) -> 'TypingType[Plugin]': + """ + `version` is the mypy version string + + We might want to use this to print a warning if the mypy version being used is + newer, or especially older, than we expect (or need). + """ + return PydanticPlugin + + +class PydanticPlugin(Plugin): + def __init__(self, options: Options) -> None: + self.plugin_config = PydanticPluginConfig(options) + self._plugin_data = self.plugin_config.to_data() + super().__init__(options) + + def get_base_class_hook(self, fullname: str) -> 'Optional[Callable[[ClassDefContext], None]]': + sym = self.lookup_fully_qualified(fullname) + if sym and isinstance(sym.node, TypeInfo): # pragma: no branch + # No branching may occur if the mypy cache has not been cleared + if any(get_fullname(base) == BASEMODEL_FULLNAME for base in sym.node.mro): + return self._pydantic_model_class_maker_callback + return None + + def get_metaclass_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]: + if fullname == MODEL_METACLASS_FULLNAME: + return self._pydantic_model_metaclass_marker_callback + return None + + def get_function_hook(self, fullname: str) -> 'Optional[Callable[[FunctionContext], Type]]': + sym = self.lookup_fully_qualified(fullname) + if sym and sym.fullname == FIELD_FULLNAME: + return self._pydantic_field_callback + return None + + def get_method_hook(self, fullname: str) -> Optional[Callable[[MethodContext], Type]]: + if fullname.endswith('.from_orm'): + return from_orm_callback + return None + + def get_class_decorator_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]: + """Mark pydantic.dataclasses as dataclass. + + Mypy version 1.1.1 added support for `@dataclass_transform` decorator. + """ + if fullname == DATACLASS_FULLNAME and MYPY_VERSION_TUPLE < (1, 1): + return dataclasses.dataclass_class_maker_callback # type: ignore[return-value] + return None + + def report_config_data(self, ctx: ReportConfigContext) -> Dict[str, Any]: + """Return all plugin config data. + + Used by mypy to determine if cache needs to be discarded. + """ + return self._plugin_data + + def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> None: + transformer = PydanticModelTransformer(ctx, self.plugin_config) + transformer.transform() + + def _pydantic_model_metaclass_marker_callback(self, ctx: ClassDefContext) -> None: + """Reset dataclass_transform_spec attribute of ModelMetaclass. + + Let the plugin handle it. This behavior can be disabled + if 'debug_dataclass_transform' is set to True', for testing purposes. + """ + if self.plugin_config.debug_dataclass_transform: + return + info_metaclass = ctx.cls.info.declared_metaclass + assert info_metaclass, "callback not passed from 'get_metaclass_hook'" + if getattr(info_metaclass.type, 'dataclass_transform_spec', None): + info_metaclass.type.dataclass_transform_spec = None # type: ignore[attr-defined] + + def _pydantic_field_callback(self, ctx: FunctionContext) -> 'Type': + """ + Extract the type of the `default` argument from the Field function, and use it as the return type. + + In particular: + * Check whether the default and default_factory argument is specified. + * Output an error if both are specified. + * Retrieve the type of the argument which is specified, and use it as return type for the function. + """ + default_any_type = ctx.default_return_type + + assert ctx.callee_arg_names[0] == 'default', '"default" is no longer first argument in Field()' + assert ctx.callee_arg_names[1] == 'default_factory', '"default_factory" is no longer second argument in Field()' + default_args = ctx.args[0] + default_factory_args = ctx.args[1] + + if default_args and default_factory_args: + error_default_and_default_factory_specified(ctx.api, ctx.context) + return default_any_type + + if default_args: + default_type = ctx.arg_types[0][0] + default_arg = default_args[0] + + # Fallback to default Any type if the field is required + if not isinstance(default_arg, EllipsisExpr): + return default_type + + elif default_factory_args: + default_factory_type = ctx.arg_types[1][0] + + # Functions which use `ParamSpec` can be overloaded, exposing the callable's types as a parameter + # Pydantic calls the default factory without any argument, so we retrieve the first item + if isinstance(default_factory_type, Overloaded): + if MYPY_VERSION_TUPLE > (0, 910): + default_factory_type = default_factory_type.items[0] + else: + # Mypy0.910 exposes the items of overloaded types in a function + default_factory_type = default_factory_type.items()[0] # type: ignore[operator] + + if isinstance(default_factory_type, CallableType): + ret_type = default_factory_type.ret_type + # mypy doesn't think `ret_type` has `args`, you'd think mypy should know, + # add this check in case it varies by version + args = getattr(ret_type, 'args', None) + if args: + if all(isinstance(arg, TypeVarType) for arg in args): + # Looks like the default factory is a type like `list` or `dict`, replace all args with `Any` + ret_type.args = tuple(default_any_type for _ in args) # type: ignore[attr-defined] + return ret_type + + return default_any_type + + +class PydanticPluginConfig: + __slots__ = ( + 'init_forbid_extra', + 'init_typed', + 'warn_required_dynamic_aliases', + 'warn_untyped_fields', + 'debug_dataclass_transform', + ) + init_forbid_extra: bool + init_typed: bool + warn_required_dynamic_aliases: bool + warn_untyped_fields: bool + debug_dataclass_transform: bool # undocumented + + def __init__(self, options: Options) -> None: + if options.config_file is None: # pragma: no cover + return + + toml_config = parse_toml(options.config_file) + if toml_config is not None: + config = toml_config.get('tool', {}).get('pydantic-mypy', {}) + for key in self.__slots__: + setting = config.get(key, False) + if not isinstance(setting, bool): + raise ValueError(f'Configuration value must be a boolean for key: {key}') + setattr(self, key, setting) + else: + plugin_config = ConfigParser() + plugin_config.read(options.config_file) + for key in self.__slots__: + setting = plugin_config.getboolean(CONFIGFILE_KEY, key, fallback=False) + setattr(self, key, setting) + + def to_data(self) -> Dict[str, Any]: + return {key: getattr(self, key) for key in self.__slots__} + + +def from_orm_callback(ctx: MethodContext) -> Type: + """ + Raise an error if orm_mode is not enabled + """ + model_type: Instance + ctx_type = ctx.type + if isinstance(ctx_type, TypeType): + ctx_type = ctx_type.item + if isinstance(ctx_type, CallableType) and isinstance(ctx_type.ret_type, Instance): + model_type = ctx_type.ret_type # called on the class + elif isinstance(ctx_type, Instance): + model_type = ctx_type # called on an instance (unusual, but still valid) + else: # pragma: no cover + detail = f'ctx.type: {ctx_type} (of type {ctx_type.__class__.__name__})' + error_unexpected_behavior(detail, ctx.api, ctx.context) + return ctx.default_return_type + pydantic_metadata = model_type.type.metadata.get(METADATA_KEY) + if pydantic_metadata is None: + return ctx.default_return_type + orm_mode = pydantic_metadata.get('config', {}).get('orm_mode') + if orm_mode is not True: + error_from_orm(get_name(model_type.type), ctx.api, ctx.context) + return ctx.default_return_type + + +class PydanticModelTransformer: + tracked_config_fields: Set[str] = { + 'extra', + 'allow_mutation', + 'frozen', + 'orm_mode', + 'allow_population_by_field_name', + 'alias_generator', + } + + def __init__(self, ctx: ClassDefContext, plugin_config: PydanticPluginConfig) -> None: + self._ctx = ctx + self.plugin_config = plugin_config + + def transform(self) -> None: + """ + Configures the BaseModel subclass according to the plugin settings. + + In particular: + * determines the model config and fields, + * adds a fields-aware signature for the initializer and construct methods + * freezes the class if allow_mutation = False or frozen = True + * stores the fields, config, and if the class is settings in the mypy metadata for access by subclasses + """ + ctx = self._ctx + info = ctx.cls.info + + self.adjust_validator_signatures() + config = self.collect_config() + fields = self.collect_fields(config) + is_settings = any(get_fullname(base) == BASESETTINGS_FULLNAME for base in info.mro[:-1]) + self.add_initializer(fields, config, is_settings) + self.add_construct_method(fields) + self.set_frozen(fields, frozen=config.allow_mutation is False or config.frozen is True) + info.metadata[METADATA_KEY] = { + 'fields': {field.name: field.serialize() for field in fields}, + 'config': config.set_values_dict(), + } + + def adjust_validator_signatures(self) -> None: + """When we decorate a function `f` with `pydantic.validator(...), mypy sees + `f` as a regular method taking a `self` instance, even though pydantic + internally wraps `f` with `classmethod` if necessary. + + Teach mypy this by marking any function whose outermost decorator is a + `validator()` call as a classmethod. + """ + for name, sym in self._ctx.cls.info.names.items(): + if isinstance(sym.node, Decorator): + first_dec = sym.node.original_decorators[0] + if ( + isinstance(first_dec, CallExpr) + and isinstance(first_dec.callee, NameExpr) + and first_dec.callee.fullname == f'{_NAMESPACE}.class_validators.validator' + ): + sym.node.func.is_class = True + + def collect_config(self) -> 'ModelConfigData': + """ + Collects the values of the config attributes that are used by the plugin, accounting for parent classes. + """ + ctx = self._ctx + cls = ctx.cls + config = ModelConfigData() + for stmt in cls.defs.body: + if not isinstance(stmt, ClassDef): + continue + if stmt.name == 'Config': + for substmt in stmt.defs.body: + if not isinstance(substmt, AssignmentStmt): + continue + config.update(self.get_config_update(substmt)) + if ( + config.has_alias_generator + and not config.allow_population_by_field_name + and self.plugin_config.warn_required_dynamic_aliases + ): + error_required_dynamic_aliases(ctx.api, stmt) + for info in cls.info.mro[1:]: # 0 is the current class + if METADATA_KEY not in info.metadata: + continue + + # Each class depends on the set of fields in its ancestors + ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info))) + for name, value in info.metadata[METADATA_KEY]['config'].items(): + config.setdefault(name, value) + return config + + def collect_fields(self, model_config: 'ModelConfigData') -> List['PydanticModelField']: + """ + Collects the fields for the model, accounting for parent classes + """ + # First, collect fields belonging to the current class. + ctx = self._ctx + cls = self._ctx.cls + fields = [] # type: List[PydanticModelField] + known_fields = set() # type: Set[str] + for stmt in cls.defs.body: + if not isinstance(stmt, AssignmentStmt): # `and stmt.new_syntax` to require annotation + continue + + lhs = stmt.lvalues[0] + if not isinstance(lhs, NameExpr) or not is_valid_field(lhs.name): + continue + + if not stmt.new_syntax and self.plugin_config.warn_untyped_fields: + error_untyped_fields(ctx.api, stmt) + + # if lhs.name == '__config__': # BaseConfig not well handled; I'm not sure why yet + # continue + + sym = cls.info.names.get(lhs.name) + if sym is None: # pragma: no cover + # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation) + # This is the same logic used in the dataclasses plugin + continue + + node = sym.node + if isinstance(node, PlaceholderNode): # pragma: no cover + # See the PlaceholderNode docstring for more detail about how this can occur + # Basically, it is an edge case when dealing with complex import logic + # This is the same logic used in the dataclasses plugin + continue + if not isinstance(node, Var): # pragma: no cover + # Don't know if this edge case still happens with the `is_valid_field` check above + # but better safe than sorry + continue + + # x: ClassVar[int] is ignored by dataclasses. + if node.is_classvar: + continue + + is_required = self.get_is_required(cls, stmt, lhs) + alias, has_dynamic_alias = self.get_alias_info(stmt) + if ( + has_dynamic_alias + and not model_config.allow_population_by_field_name + and self.plugin_config.warn_required_dynamic_aliases + ): + error_required_dynamic_aliases(ctx.api, stmt) + fields.append( + PydanticModelField( + name=lhs.name, + is_required=is_required, + alias=alias, + has_dynamic_alias=has_dynamic_alias, + line=stmt.line, + column=stmt.column, + ) + ) + known_fields.add(lhs.name) + all_fields = fields.copy() + for info in cls.info.mro[1:]: # 0 is the current class, -2 is BaseModel, -1 is object + if METADATA_KEY not in info.metadata: + continue + + superclass_fields = [] + # Each class depends on the set of fields in its ancestors + ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info))) + + for name, data in info.metadata[METADATA_KEY]['fields'].items(): + if name not in known_fields: + field = PydanticModelField.deserialize(info, data) + known_fields.add(name) + superclass_fields.append(field) + else: + (field,) = (a for a in all_fields if a.name == name) + all_fields.remove(field) + superclass_fields.append(field) + all_fields = superclass_fields + all_fields + return all_fields + + def add_initializer(self, fields: List['PydanticModelField'], config: 'ModelConfigData', is_settings: bool) -> None: + """ + Adds a fields-aware `__init__` method to the class. + + The added `__init__` will be annotated with types vs. all `Any` depending on the plugin settings. + """ + ctx = self._ctx + typed = self.plugin_config.init_typed + use_alias = config.allow_population_by_field_name is not True + force_all_optional = is_settings or bool( + config.has_alias_generator and not config.allow_population_by_field_name + ) + init_arguments = self.get_field_arguments( + fields, typed=typed, force_all_optional=force_all_optional, use_alias=use_alias + ) + if not self.should_init_forbid_extra(fields, config): + var = Var('kwargs') + init_arguments.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2)) + + if '__init__' not in ctx.cls.info.names: + add_method(ctx, '__init__', init_arguments, NoneType()) + + def add_construct_method(self, fields: List['PydanticModelField']) -> None: + """ + Adds a fully typed `construct` classmethod to the class. + + Similar to the fields-aware __init__ method, but always uses the field names (not aliases), + and does not treat settings fields as optional. + """ + ctx = self._ctx + set_str = ctx.api.named_type(f'{BUILTINS_NAME}.set', [ctx.api.named_type(f'{BUILTINS_NAME}.str')]) + optional_set_str = UnionType([set_str, NoneType()]) + fields_set_argument = Argument(Var('_fields_set', optional_set_str), optional_set_str, None, ARG_OPT) + construct_arguments = self.get_field_arguments(fields, typed=True, force_all_optional=False, use_alias=False) + construct_arguments = [fields_set_argument] + construct_arguments + + obj_type = ctx.api.named_type(f'{BUILTINS_NAME}.object') + self_tvar_name = '_PydanticBaseModel' # Make sure it does not conflict with other names in the class + tvar_fullname = ctx.cls.fullname + '.' + self_tvar_name + if MYPY_VERSION_TUPLE >= (1, 4): + tvd = TypeVarType( + self_tvar_name, + tvar_fullname, + -1, + [], + obj_type, + AnyType(TypeOfAny.from_omitted_generics), # type: ignore[arg-type] + ) + self_tvar_expr = TypeVarExpr( + self_tvar_name, + tvar_fullname, + [], + obj_type, + AnyType(TypeOfAny.from_omitted_generics), # type: ignore[arg-type] + ) + else: + tvd = TypeVarDef(self_tvar_name, tvar_fullname, -1, [], obj_type) + self_tvar_expr = TypeVarExpr(self_tvar_name, tvar_fullname, [], obj_type) + ctx.cls.info.names[self_tvar_name] = SymbolTableNode(MDEF, self_tvar_expr) + + # Backward-compatible with TypeVarDef from Mypy 0.910. + if isinstance(tvd, TypeVarType): + self_type = tvd + else: + self_type = TypeVarType(tvd) + + add_method( + ctx, + 'construct', + construct_arguments, + return_type=self_type, + self_type=self_type, + tvar_def=tvd, + is_classmethod=True, + ) + + def set_frozen(self, fields: List['PydanticModelField'], frozen: bool) -> None: + """ + Marks all fields as properties so that attempts to set them trigger mypy errors. + + This is the same approach used by the attrs and dataclasses plugins. + """ + ctx = self._ctx + info = ctx.cls.info + for field in fields: + sym_node = info.names.get(field.name) + if sym_node is not None: + var = sym_node.node + if isinstance(var, Var): + var.is_property = frozen + elif isinstance(var, PlaceholderNode) and not ctx.api.final_iteration: + # See https://github.com/pydantic/pydantic/issues/5191 to hit this branch for test coverage + ctx.api.defer() + else: # pragma: no cover + # I don't know whether it's possible to hit this branch, but I've added it for safety + try: + var_str = str(var) + except TypeError: + # This happens for PlaceholderNode; perhaps it will happen for other types in the future.. + var_str = repr(var) + detail = f'sym_node.node: {var_str} (of type {var.__class__})' + error_unexpected_behavior(detail, ctx.api, ctx.cls) + else: + var = field.to_var(info, use_alias=False) + var.info = info + var.is_property = frozen + var._fullname = get_fullname(info) + '.' + get_name(var) + info.names[get_name(var)] = SymbolTableNode(MDEF, var) + + def get_config_update(self, substmt: AssignmentStmt) -> Optional['ModelConfigData']: + """ + Determines the config update due to a single statement in the Config class definition. + + Warns if a tracked config attribute is set to a value the plugin doesn't know how to interpret (e.g., an int) + """ + lhs = substmt.lvalues[0] + if not (isinstance(lhs, NameExpr) and lhs.name in self.tracked_config_fields): + return None + if lhs.name == 'extra': + if isinstance(substmt.rvalue, StrExpr): + forbid_extra = substmt.rvalue.value == 'forbid' + elif isinstance(substmt.rvalue, MemberExpr): + forbid_extra = substmt.rvalue.name == 'forbid' + else: + error_invalid_config_value(lhs.name, self._ctx.api, substmt) + return None + return ModelConfigData(forbid_extra=forbid_extra) + if lhs.name == 'alias_generator': + has_alias_generator = True + if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname == 'builtins.None': + has_alias_generator = False + return ModelConfigData(has_alias_generator=has_alias_generator) + if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname in ('builtins.True', 'builtins.False'): + return ModelConfigData(**{lhs.name: substmt.rvalue.fullname == 'builtins.True'}) + error_invalid_config_value(lhs.name, self._ctx.api, substmt) + return None + + @staticmethod + def get_is_required(cls: ClassDef, stmt: AssignmentStmt, lhs: NameExpr) -> bool: + """ + Returns a boolean indicating whether the field defined in `stmt` is a required field. + """ + expr = stmt.rvalue + if isinstance(expr, TempNode): + # TempNode means annotation-only, so only non-required if Optional + value_type = get_proper_type(cls.info[lhs.name].type) + return not PydanticModelTransformer.type_has_implicit_default(value_type) + if isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME: + # The "default value" is a call to `Field`; at this point, the field is + # only required if default is Ellipsis (i.e., `field_name: Annotation = Field(...)`) or if default_factory + # is specified. + for arg, name in zip(expr.args, expr.arg_names): + # If name is None, then this arg is the default because it is the only positional argument. + if name is None or name == 'default': + return arg.__class__ is EllipsisExpr + if name == 'default_factory': + return False + # In this case, default and default_factory are not specified, so we need to look at the annotation + value_type = get_proper_type(cls.info[lhs.name].type) + return not PydanticModelTransformer.type_has_implicit_default(value_type) + # Only required if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`) + return isinstance(expr, EllipsisExpr) + + @staticmethod + def type_has_implicit_default(type_: Optional[ProperType]) -> bool: + """ + Returns True if the passed type will be given an implicit default value. + + In pydantic v1, this is the case for Optional types and Any (with default value None). + """ + if isinstance(type_, AnyType): + # Annotated as Any + return True + if isinstance(type_, UnionType) and any( + isinstance(item, NoneType) or isinstance(item, AnyType) for item in type_.items + ): + # Annotated as Optional, or otherwise having NoneType or AnyType in the union + return True + return False + + @staticmethod + def get_alias_info(stmt: AssignmentStmt) -> Tuple[Optional[str], bool]: + """ + Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`. + + `has_dynamic_alias` is True if and only if an alias is provided, but not as a string literal. + If `has_dynamic_alias` is True, `alias` will be None. + """ + expr = stmt.rvalue + if isinstance(expr, TempNode): + # TempNode means annotation-only + return None, False + + if not ( + isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME + ): + # Assigned value is not a call to pydantic.fields.Field + return None, False + + for i, arg_name in enumerate(expr.arg_names): + if arg_name != 'alias': + continue + arg = expr.args[i] + if isinstance(arg, StrExpr): + return arg.value, False + else: + return None, True + return None, False + + def get_field_arguments( + self, fields: List['PydanticModelField'], typed: bool, force_all_optional: bool, use_alias: bool + ) -> List[Argument]: + """ + Helper function used during the construction of the `__init__` and `construct` method signatures. + + Returns a list of mypy Argument instances for use in the generated signatures. + """ + info = self._ctx.cls.info + arguments = [ + field.to_argument(info, typed=typed, force_optional=force_all_optional, use_alias=use_alias) + for field in fields + if not (use_alias and field.has_dynamic_alias) + ] + return arguments + + def should_init_forbid_extra(self, fields: List['PydanticModelField'], config: 'ModelConfigData') -> bool: + """ + Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature + + We disallow arbitrary kwargs if the extra config setting is "forbid", or if the plugin config says to, + *unless* a required dynamic alias is present (since then we can't determine a valid signature). + """ + if not config.allow_population_by_field_name: + if self.is_dynamic_alias_present(fields, bool(config.has_alias_generator)): + return False + if config.forbid_extra: + return True + return self.plugin_config.init_forbid_extra + + @staticmethod + def is_dynamic_alias_present(fields: List['PydanticModelField'], has_alias_generator: bool) -> bool: + """ + Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be + determined during static analysis. + """ + for field in fields: + if field.has_dynamic_alias: + return True + if has_alias_generator: + for field in fields: + if field.alias is None: + return True + return False + + +class PydanticModelField: + def __init__( + self, name: str, is_required: bool, alias: Optional[str], has_dynamic_alias: bool, line: int, column: int + ): + self.name = name + self.is_required = is_required + self.alias = alias + self.has_dynamic_alias = has_dynamic_alias + self.line = line + self.column = column + + def to_var(self, info: TypeInfo, use_alias: bool) -> Var: + name = self.name + if use_alias and self.alias is not None: + name = self.alias + return Var(name, info[self.name].type) + + def to_argument(self, info: TypeInfo, typed: bool, force_optional: bool, use_alias: bool) -> Argument: + if typed and info[self.name].type is not None: + type_annotation = info[self.name].type + else: + type_annotation = AnyType(TypeOfAny.explicit) + return Argument( + variable=self.to_var(info, use_alias), + type_annotation=type_annotation, + initializer=None, + kind=ARG_NAMED_OPT if force_optional or not self.is_required else ARG_NAMED, + ) + + def serialize(self) -> JsonDict: + return self.__dict__ + + @classmethod + def deserialize(cls, info: TypeInfo, data: JsonDict) -> 'PydanticModelField': + return cls(**data) + + +class ModelConfigData: + def __init__( + self, + forbid_extra: Optional[bool] = None, + allow_mutation: Optional[bool] = None, + frozen: Optional[bool] = None, + orm_mode: Optional[bool] = None, + allow_population_by_field_name: Optional[bool] = None, + has_alias_generator: Optional[bool] = None, + ): + self.forbid_extra = forbid_extra + self.allow_mutation = allow_mutation + self.frozen = frozen + self.orm_mode = orm_mode + self.allow_population_by_field_name = allow_population_by_field_name + self.has_alias_generator = has_alias_generator + + def set_values_dict(self) -> Dict[str, Any]: + return {k: v for k, v in self.__dict__.items() if v is not None} + + def update(self, config: Optional['ModelConfigData']) -> None: + if config is None: + return + for k, v in config.set_values_dict().items(): + setattr(self, k, v) + + def setdefault(self, key: str, value: Any) -> None: + if getattr(self, key) is None: + setattr(self, key, value) + + +ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_orm call', 'Pydantic') +ERROR_CONFIG = ErrorCode('pydantic-config', 'Invalid config value', 'Pydantic') +ERROR_ALIAS = ErrorCode('pydantic-alias', 'Dynamic alias disallowed', 'Pydantic') +ERROR_UNEXPECTED = ErrorCode('pydantic-unexpected', 'Unexpected behavior', 'Pydantic') +ERROR_UNTYPED = ErrorCode('pydantic-field', 'Untyped field disallowed', 'Pydantic') +ERROR_FIELD_DEFAULTS = ErrorCode('pydantic-field', 'Invalid Field defaults', 'Pydantic') + + +def error_from_orm(model_name: str, api: CheckerPluginInterface, context: Context) -> None: + api.fail(f'"{model_name}" does not have orm_mode=True', context, code=ERROR_ORM) + + +def error_invalid_config_value(name: str, api: SemanticAnalyzerPluginInterface, context: Context) -> None: + api.fail(f'Invalid value for "Config.{name}"', context, code=ERROR_CONFIG) + + +def error_required_dynamic_aliases(api: SemanticAnalyzerPluginInterface, context: Context) -> None: + api.fail('Required dynamic aliases disallowed', context, code=ERROR_ALIAS) + + +def error_unexpected_behavior( + detail: str, api: Union[CheckerPluginInterface, SemanticAnalyzerPluginInterface], context: Context +) -> None: # pragma: no cover + # Can't think of a good way to test this, but I confirmed it renders as desired by adding to a non-error path + link = 'https://github.com/pydantic/pydantic/issues/new/choose' + full_message = f'The pydantic mypy plugin ran into unexpected behavior: {detail}\n' + full_message += f'Please consider reporting this bug at {link} so we can try to fix it!' + api.fail(full_message, context, code=ERROR_UNEXPECTED) + + +def error_untyped_fields(api: SemanticAnalyzerPluginInterface, context: Context) -> None: + api.fail('Untyped fields disallowed', context, code=ERROR_UNTYPED) + + +def error_default_and_default_factory_specified(api: CheckerPluginInterface, context: Context) -> None: + api.fail('Field default and default_factory cannot be specified together', context, code=ERROR_FIELD_DEFAULTS) + + +def add_method( + ctx: ClassDefContext, + name: str, + args: List[Argument], + return_type: Type, + self_type: Optional[Type] = None, + tvar_def: Optional[TypeVarDef] = None, + is_classmethod: bool = False, + is_new: bool = False, + # is_staticmethod: bool = False, +) -> None: + """ + Adds a new method to a class. + + This can be dropped if/when https://github.com/python/mypy/issues/7301 is merged + """ + info = ctx.cls.info + + # First remove any previously generated methods with the same name + # to avoid clashes and problems in the semantic analyzer. + if name in info.names: + sym = info.names[name] + if sym.plugin_generated and isinstance(sym.node, FuncDef): + ctx.cls.defs.body.remove(sym.node) # pragma: no cover + + self_type = self_type or fill_typevars(info) + if is_classmethod or is_new: + first = [Argument(Var('_cls'), TypeType.make_normalized(self_type), None, ARG_POS)] + # elif is_staticmethod: + # first = [] + else: + self_type = self_type or fill_typevars(info) + first = [Argument(Var('__pydantic_self__'), self_type, None, ARG_POS)] + args = first + args + arg_types, arg_names, arg_kinds = [], [], [] + for arg in args: + assert arg.type_annotation, 'All arguments must be fully typed.' + arg_types.append(arg.type_annotation) + arg_names.append(get_name(arg.variable)) + arg_kinds.append(arg.kind) + + function_type = ctx.api.named_type(f'{BUILTINS_NAME}.function') + signature = CallableType(arg_types, arg_kinds, arg_names, return_type, function_type) + if tvar_def: + signature.variables = [tvar_def] + + func = FuncDef(name, args, Block([PassStmt()])) + func.info = info + func.type = set_callable_name(signature, func) + func.is_class = is_classmethod + # func.is_static = is_staticmethod + func._fullname = get_fullname(info) + '.' + name + func.line = info.line + + # NOTE: we would like the plugin generated node to dominate, but we still + # need to keep any existing definitions so they get semantically analyzed. + if name in info.names: + # Get a nice unique name instead. + r_name = get_unique_redefinition_name(name, info.names) + info.names[r_name] = info.names[name] + + if is_classmethod: # or is_staticmethod: + func.is_decorated = True + v = Var(name, func.type) + v.info = info + v._fullname = func._fullname + # if is_classmethod: + v.is_classmethod = True + dec = Decorator(func, [NameExpr('classmethod')], v) + # else: + # v.is_staticmethod = True + # dec = Decorator(func, [NameExpr('staticmethod')], v) + + dec.line = info.line + sym = SymbolTableNode(MDEF, dec) + else: + sym = SymbolTableNode(MDEF, func) + sym.plugin_generated = True + + info.names[name] = sym + info.defn.defs.body.append(func) + + +def get_fullname(x: Union[FuncBase, SymbolNode]) -> str: + """ + Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped. + """ + fn = x.fullname + if callable(fn): # pragma: no cover + return fn() + return fn + + +def get_name(x: Union[FuncBase, SymbolNode]) -> str: + """ + Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped. + """ + fn = x.name + if callable(fn): # pragma: no cover + return fn() + return fn + + +def parse_toml(config_file: str) -> Optional[Dict[str, Any]]: + if not config_file.endswith('.toml'): + return None + + read_mode = 'rb' + if sys.version_info >= (3, 11): + import tomllib as toml_ + else: + try: + import tomli as toml_ + except ImportError: + # older versions of mypy have toml as a dependency, not tomli + read_mode = 'r' + try: + import toml as toml_ # type: ignore[no-redef] + except ImportError: # pragma: no cover + import warnings + + warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.') + return None + + with open(config_file, read_mode) as rf: + return toml_.load(rf) # type: ignore[arg-type] diff --git a/lib/pydantic/v1/networks.py b/lib/pydantic/v1/networks.py new file mode 100644 index 00000000..cfebe588 --- /dev/null +++ b/lib/pydantic/v1/networks.py @@ -0,0 +1,747 @@ +import re +from ipaddress import ( + IPv4Address, + IPv4Interface, + IPv4Network, + IPv6Address, + IPv6Interface, + IPv6Network, + _BaseAddress, + _BaseNetwork, +) +from typing import ( + TYPE_CHECKING, + Any, + Collection, + Dict, + Generator, + List, + Match, + Optional, + Pattern, + Set, + Tuple, + Type, + Union, + cast, + no_type_check, +) + +from . import errors +from .utils import Representation, update_not_none +from .validators import constr_length_validator, str_validator + +if TYPE_CHECKING: + import email_validator + from typing_extensions import TypedDict + + from .config import BaseConfig + from .fields import ModelField + from .typing import AnyCallable + + CallableGenerator = Generator[AnyCallable, None, None] + + class Parts(TypedDict, total=False): + scheme: str + user: Optional[str] + password: Optional[str] + ipv4: Optional[str] + ipv6: Optional[str] + domain: Optional[str] + port: Optional[str] + path: Optional[str] + query: Optional[str] + fragment: Optional[str] + + class HostParts(TypedDict, total=False): + host: str + tld: Optional[str] + host_type: Optional[str] + port: Optional[str] + rebuild: bool + +else: + email_validator = None + + class Parts(dict): + pass + + +NetworkType = Union[str, bytes, int, Tuple[Union[str, bytes, int], Union[str, int]]] + +__all__ = [ + 'AnyUrl', + 'AnyHttpUrl', + 'FileUrl', + 'HttpUrl', + 'stricturl', + 'EmailStr', + 'NameEmail', + 'IPvAnyAddress', + 'IPvAnyInterface', + 'IPvAnyNetwork', + 'PostgresDsn', + 'CockroachDsn', + 'AmqpDsn', + 'RedisDsn', + 'MongoDsn', + 'KafkaDsn', + 'validate_email', +] + +_url_regex_cache = None +_multi_host_url_regex_cache = None +_ascii_domain_regex_cache = None +_int_domain_regex_cache = None +_host_regex_cache = None + +_host_regex = ( + r'(?:' + r'(?P(?:\d{1,3}\.){3}\d{1,3})(?=$|[/:#?])|' # ipv4 + r'(?P\[[A-F0-9]*:[A-F0-9:]+\])(?=$|[/:#?])|' # ipv6 + r'(?P[^\s/:?#]+)' # domain, validation occurs later + r')?' + r'(?::(?P\d+))?' # port +) +_scheme_regex = r'(?:(?P[a-z][a-z0-9+\-.]+)://)?' # scheme https://tools.ietf.org/html/rfc3986#appendix-A +_user_info_regex = r'(?:(?P[^\s:/]*)(?::(?P[^\s/]*))?@)?' +_path_regex = r'(?P/[^\s?#]*)?' +_query_regex = r'(?:\?(?P[^\s#]*))?' +_fragment_regex = r'(?:#(?P[^\s#]*))?' + + +def url_regex() -> Pattern[str]: + global _url_regex_cache + if _url_regex_cache is None: + _url_regex_cache = re.compile( + rf'{_scheme_regex}{_user_info_regex}{_host_regex}{_path_regex}{_query_regex}{_fragment_regex}', + re.IGNORECASE, + ) + return _url_regex_cache + + +def multi_host_url_regex() -> Pattern[str]: + """ + Compiled multi host url regex. + + Additionally to `url_regex` it allows to match multiple hosts. + E.g. host1.db.net,host2.db.net + """ + global _multi_host_url_regex_cache + if _multi_host_url_regex_cache is None: + _multi_host_url_regex_cache = re.compile( + rf'{_scheme_regex}{_user_info_regex}' + r'(?P([^/]*))' # validation occurs later + rf'{_path_regex}{_query_regex}{_fragment_regex}', + re.IGNORECASE, + ) + return _multi_host_url_regex_cache + + +def ascii_domain_regex() -> Pattern[str]: + global _ascii_domain_regex_cache + if _ascii_domain_regex_cache is None: + ascii_chunk = r'[_0-9a-z](?:[-_0-9a-z]{0,61}[_0-9a-z])?' + ascii_domain_ending = r'(?P\.[a-z]{2,63})?\.?' + _ascii_domain_regex_cache = re.compile( + fr'(?:{ascii_chunk}\.)*?{ascii_chunk}{ascii_domain_ending}', re.IGNORECASE + ) + return _ascii_domain_regex_cache + + +def int_domain_regex() -> Pattern[str]: + global _int_domain_regex_cache + if _int_domain_regex_cache is None: + int_chunk = r'[_0-9a-\U00040000](?:[-_0-9a-\U00040000]{0,61}[_0-9a-\U00040000])?' + int_domain_ending = r'(?P(\.[^\W\d_]{2,63})|(\.(?:xn--)[_0-9a-z-]{2,63}))?\.?' + _int_domain_regex_cache = re.compile(fr'(?:{int_chunk}\.)*?{int_chunk}{int_domain_ending}', re.IGNORECASE) + return _int_domain_regex_cache + + +def host_regex() -> Pattern[str]: + global _host_regex_cache + if _host_regex_cache is None: + _host_regex_cache = re.compile( + _host_regex, + re.IGNORECASE, + ) + return _host_regex_cache + + +class AnyUrl(str): + strip_whitespace = True + min_length = 1 + max_length = 2**16 + allowed_schemes: Optional[Collection[str]] = None + tld_required: bool = False + user_required: bool = False + host_required: bool = True + hidden_parts: Set[str] = set() + + __slots__ = ('scheme', 'user', 'password', 'host', 'tld', 'host_type', 'port', 'path', 'query', 'fragment') + + @no_type_check + def __new__(cls, url: Optional[str], **kwargs) -> object: + return str.__new__(cls, cls.build(**kwargs) if url is None else url) + + def __init__( + self, + url: str, + *, + scheme: str, + user: Optional[str] = None, + password: Optional[str] = None, + host: Optional[str] = None, + tld: Optional[str] = None, + host_type: str = 'domain', + port: Optional[str] = None, + path: Optional[str] = None, + query: Optional[str] = None, + fragment: Optional[str] = None, + ) -> None: + str.__init__(url) + self.scheme = scheme + self.user = user + self.password = password + self.host = host + self.tld = tld + self.host_type = host_type + self.port = port + self.path = path + self.query = query + self.fragment = fragment + + @classmethod + def build( + cls, + *, + scheme: str, + user: Optional[str] = None, + password: Optional[str] = None, + host: str, + port: Optional[str] = None, + path: Optional[str] = None, + query: Optional[str] = None, + fragment: Optional[str] = None, + **_kwargs: str, + ) -> str: + parts = Parts( + scheme=scheme, + user=user, + password=password, + host=host, + port=port, + path=path, + query=query, + fragment=fragment, + **_kwargs, # type: ignore[misc] + ) + + url = scheme + '://' + if user: + url += user + if password: + url += ':' + password + if user or password: + url += '@' + url += host + if port and ('port' not in cls.hidden_parts or cls.get_default_parts(parts).get('port') != port): + url += ':' + port + if path: + url += path + if query: + url += '?' + query + if fragment: + url += '#' + fragment + return url + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length, format='uri') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, value: Any, field: 'ModelField', config: 'BaseConfig') -> 'AnyUrl': + if value.__class__ == cls: + return value + value = str_validator(value) + if cls.strip_whitespace: + value = value.strip() + url: str = cast(str, constr_length_validator(value, field, config)) + + m = cls._match_url(url) + # the regex should always match, if it doesn't please report with details of the URL tried + assert m, 'URL regex failed unexpectedly' + + original_parts = cast('Parts', m.groupdict()) + parts = cls.apply_default_parts(original_parts) + parts = cls.validate_parts(parts) + + if m.end() != len(url): + raise errors.UrlExtraError(extra=url[m.end() :]) + + return cls._build_url(m, url, parts) + + @classmethod + def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'AnyUrl': + """ + Validate hosts and build the AnyUrl object. Split from `validate` so this method + can be altered in `MultiHostDsn`. + """ + host, tld, host_type, rebuild = cls.validate_host(parts) + + return cls( + None if rebuild else url, + scheme=parts['scheme'], + user=parts['user'], + password=parts['password'], + host=host, + tld=tld, + host_type=host_type, + port=parts['port'], + path=parts['path'], + query=parts['query'], + fragment=parts['fragment'], + ) + + @staticmethod + def _match_url(url: str) -> Optional[Match[str]]: + return url_regex().match(url) + + @staticmethod + def _validate_port(port: Optional[str]) -> None: + if port is not None and int(port) > 65_535: + raise errors.UrlPortError() + + @classmethod + def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts': + """ + A method used to validate parts of a URL. + Could be overridden to set default values for parts if missing + """ + scheme = parts['scheme'] + if scheme is None: + raise errors.UrlSchemeError() + + if cls.allowed_schemes and scheme.lower() not in cls.allowed_schemes: + raise errors.UrlSchemePermittedError(set(cls.allowed_schemes)) + + if validate_port: + cls._validate_port(parts['port']) + + user = parts['user'] + if cls.user_required and user is None: + raise errors.UrlUserInfoError() + + return parts + + @classmethod + def validate_host(cls, parts: 'Parts') -> Tuple[str, Optional[str], str, bool]: + tld, host_type, rebuild = None, None, False + for f in ('domain', 'ipv4', 'ipv6'): + host = parts[f] # type: ignore[literal-required] + if host: + host_type = f + break + + if host is None: + if cls.host_required: + raise errors.UrlHostError() + elif host_type == 'domain': + is_international = False + d = ascii_domain_regex().fullmatch(host) + if d is None: + d = int_domain_regex().fullmatch(host) + if d is None: + raise errors.UrlHostError() + is_international = True + + tld = d.group('tld') + if tld is None and not is_international: + d = int_domain_regex().fullmatch(host) + assert d is not None + tld = d.group('tld') + is_international = True + + if tld is not None: + tld = tld[1:] + elif cls.tld_required: + raise errors.UrlHostTldError() + + if is_international: + host_type = 'int_domain' + rebuild = True + host = host.encode('idna').decode('ascii') + if tld is not None: + tld = tld.encode('idna').decode('ascii') + + return host, tld, host_type, rebuild # type: ignore + + @staticmethod + def get_default_parts(parts: 'Parts') -> 'Parts': + return {} + + @classmethod + def apply_default_parts(cls, parts: 'Parts') -> 'Parts': + for key, value in cls.get_default_parts(parts).items(): + if not parts[key]: # type: ignore[literal-required] + parts[key] = value # type: ignore[literal-required] + return parts + + def __repr__(self) -> str: + extra = ', '.join(f'{n}={getattr(self, n)!r}' for n in self.__slots__ if getattr(self, n) is not None) + return f'{self.__class__.__name__}({super().__repr__()}, {extra})' + + +class AnyHttpUrl(AnyUrl): + allowed_schemes = {'http', 'https'} + + __slots__ = () + + +class HttpUrl(AnyHttpUrl): + tld_required = True + # https://stackoverflow.com/questions/417142/what-is-the-maximum-length-of-a-url-in-different-browsers + max_length = 2083 + hidden_parts = {'port'} + + @staticmethod + def get_default_parts(parts: 'Parts') -> 'Parts': + return {'port': '80' if parts['scheme'] == 'http' else '443'} + + +class FileUrl(AnyUrl): + allowed_schemes = {'file'} + host_required = False + + __slots__ = () + + +class MultiHostDsn(AnyUrl): + __slots__ = AnyUrl.__slots__ + ('hosts',) + + def __init__(self, *args: Any, hosts: Optional[List['HostParts']] = None, **kwargs: Any): + super().__init__(*args, **kwargs) + self.hosts = hosts + + @staticmethod + def _match_url(url: str) -> Optional[Match[str]]: + return multi_host_url_regex().match(url) + + @classmethod + def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts': + return super().validate_parts(parts, validate_port=False) + + @classmethod + def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'MultiHostDsn': + hosts_parts: List['HostParts'] = [] + host_re = host_regex() + for host in m.groupdict()['hosts'].split(','): + d: Parts = host_re.match(host).groupdict() # type: ignore + host, tld, host_type, rebuild = cls.validate_host(d) + port = d.get('port') + cls._validate_port(port) + hosts_parts.append( + { + 'host': host, + 'host_type': host_type, + 'tld': tld, + 'rebuild': rebuild, + 'port': port, + } + ) + + if len(hosts_parts) > 1: + return cls( + None if any([hp['rebuild'] for hp in hosts_parts]) else url, + scheme=parts['scheme'], + user=parts['user'], + password=parts['password'], + path=parts['path'], + query=parts['query'], + fragment=parts['fragment'], + host_type=None, + hosts=hosts_parts, + ) + else: + # backwards compatibility with single host + host_part = hosts_parts[0] + return cls( + None if host_part['rebuild'] else url, + scheme=parts['scheme'], + user=parts['user'], + password=parts['password'], + host=host_part['host'], + tld=host_part['tld'], + host_type=host_part['host_type'], + port=host_part.get('port'), + path=parts['path'], + query=parts['query'], + fragment=parts['fragment'], + ) + + +class PostgresDsn(MultiHostDsn): + allowed_schemes = { + 'postgres', + 'postgresql', + 'postgresql+asyncpg', + 'postgresql+pg8000', + 'postgresql+psycopg', + 'postgresql+psycopg2', + 'postgresql+psycopg2cffi', + 'postgresql+py-postgresql', + 'postgresql+pygresql', + } + user_required = True + + __slots__ = () + + +class CockroachDsn(AnyUrl): + allowed_schemes = { + 'cockroachdb', + 'cockroachdb+psycopg2', + 'cockroachdb+asyncpg', + } + user_required = True + + +class AmqpDsn(AnyUrl): + allowed_schemes = {'amqp', 'amqps'} + host_required = False + + +class RedisDsn(AnyUrl): + __slots__ = () + allowed_schemes = {'redis', 'rediss'} + host_required = False + + @staticmethod + def get_default_parts(parts: 'Parts') -> 'Parts': + return { + 'domain': 'localhost' if not (parts['ipv4'] or parts['ipv6']) else '', + 'port': '6379', + 'path': '/0', + } + + +class MongoDsn(AnyUrl): + allowed_schemes = {'mongodb'} + + # TODO: Needed to generic "Parts" for "Replica Set", "Sharded Cluster", and other mongodb deployment modes + @staticmethod + def get_default_parts(parts: 'Parts') -> 'Parts': + return { + 'port': '27017', + } + + +class KafkaDsn(AnyUrl): + allowed_schemes = {'kafka'} + + @staticmethod + def get_default_parts(parts: 'Parts') -> 'Parts': + return { + 'domain': 'localhost', + 'port': '9092', + } + + +def stricturl( + *, + strip_whitespace: bool = True, + min_length: int = 1, + max_length: int = 2**16, + tld_required: bool = True, + host_required: bool = True, + allowed_schemes: Optional[Collection[str]] = None, +) -> Type[AnyUrl]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict( + strip_whitespace=strip_whitespace, + min_length=min_length, + max_length=max_length, + tld_required=tld_required, + host_required=host_required, + allowed_schemes=allowed_schemes, + ) + return type('UrlValue', (AnyUrl,), namespace) + + +def import_email_validator() -> None: + global email_validator + try: + import email_validator + except ImportError as e: + raise ImportError('email-validator is not installed, run `pip install pydantic[email]`') from e + + +class EmailStr(str): + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='email') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + # included here and below so the error happens straight away + import_email_validator() + + yield str_validator + yield cls.validate + + @classmethod + def validate(cls, value: Union[str]) -> str: + return validate_email(value)[1] + + +class NameEmail(Representation): + __slots__ = 'name', 'email' + + def __init__(self, name: str, email: str): + self.name = name + self.email = email + + def __eq__(self, other: Any) -> bool: + return isinstance(other, NameEmail) and (self.name, self.email) == (other.name, other.email) + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='name-email') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + import_email_validator() + + yield cls.validate + + @classmethod + def validate(cls, value: Any) -> 'NameEmail': + if value.__class__ == cls: + return value + value = str_validator(value) + return cls(*validate_email(value)) + + def __str__(self) -> str: + return f'{self.name} <{self.email}>' + + +class IPvAnyAddress(_BaseAddress): + __slots__ = () + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='ipvanyaddress') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, value: Union[str, bytes, int]) -> Union[IPv4Address, IPv6Address]: + try: + return IPv4Address(value) + except ValueError: + pass + + try: + return IPv6Address(value) + except ValueError: + raise errors.IPvAnyAddressError() + + +class IPvAnyInterface(_BaseAddress): + __slots__ = () + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='ipvanyinterface') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, value: NetworkType) -> Union[IPv4Interface, IPv6Interface]: + try: + return IPv4Interface(value) + except ValueError: + pass + + try: + return IPv6Interface(value) + except ValueError: + raise errors.IPvAnyInterfaceError() + + +class IPvAnyNetwork(_BaseNetwork): # type: ignore + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='ipvanynetwork') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, value: NetworkType) -> Union[IPv4Network, IPv6Network]: + # Assume IP Network is defined with a default value for ``strict`` argument. + # Define your own class if you want to specify network address check strictness. + try: + return IPv4Network(value) + except ValueError: + pass + + try: + return IPv6Network(value) + except ValueError: + raise errors.IPvAnyNetworkError() + + +pretty_email_regex = re.compile(r'([\w ]*?) *<(.*)> *') +MAX_EMAIL_LENGTH = 2048 +"""Maximum length for an email. +A somewhat arbitrary but very generous number compared to what is allowed by most implementations. +""" + + +def validate_email(value: Union[str]) -> Tuple[str, str]: + """ + Email address validation using https://pypi.org/project/email-validator/ + Notes: + * raw ip address (literal) domain parts are not allowed. + * "John Doe " style "pretty" email addresses are processed + * spaces are striped from the beginning and end of addresses but no error is raised + """ + if email_validator is None: + import_email_validator() + + if len(value) > MAX_EMAIL_LENGTH: + raise errors.EmailError() + + m = pretty_email_regex.fullmatch(value) + name: Union[str, None] = None + if m: + name, value = m.groups() + email = value.strip() + try: + parts = email_validator.validate_email(email, check_deliverability=False) + except email_validator.EmailNotValidError as e: + raise errors.EmailError from e + + if hasattr(parts, 'normalized'): + # email-validator >= 2 + email = parts.normalized + assert email is not None + name = name or parts.local_part + return name, email + else: + # email-validator >1, <2 + at_index = email.index('@') + local_part = email[:at_index] # RFC 5321, local part must be case-sensitive. + global_part = email[at_index:].lower() + + return name or local_part, local_part + global_part diff --git a/lib/pydantic/v1/parse.py b/lib/pydantic/v1/parse.py new file mode 100644 index 00000000..7ac330ca --- /dev/null +++ b/lib/pydantic/v1/parse.py @@ -0,0 +1,66 @@ +import json +import pickle +from enum import Enum +from pathlib import Path +from typing import Any, Callable, Union + +from .types import StrBytes + + +class Protocol(str, Enum): + json = 'json' + pickle = 'pickle' + + +def load_str_bytes( + b: StrBytes, + *, + content_type: str = None, + encoding: str = 'utf8', + proto: Protocol = None, + allow_pickle: bool = False, + json_loads: Callable[[str], Any] = json.loads, +) -> Any: + if proto is None and content_type: + if content_type.endswith(('json', 'javascript')): + pass + elif allow_pickle and content_type.endswith('pickle'): + proto = Protocol.pickle + else: + raise TypeError(f'Unknown content-type: {content_type}') + + proto = proto or Protocol.json + + if proto == Protocol.json: + if isinstance(b, bytes): + b = b.decode(encoding) + return json_loads(b) + elif proto == Protocol.pickle: + if not allow_pickle: + raise RuntimeError('Trying to decode with pickle with allow_pickle=False') + bb = b if isinstance(b, bytes) else b.encode() + return pickle.loads(bb) + else: + raise TypeError(f'Unknown protocol: {proto}') + + +def load_file( + path: Union[str, Path], + *, + content_type: str = None, + encoding: str = 'utf8', + proto: Protocol = None, + allow_pickle: bool = False, + json_loads: Callable[[str], Any] = json.loads, +) -> Any: + path = Path(path) + b = path.read_bytes() + if content_type is None: + if path.suffix in ('.js', '.json'): + proto = Protocol.json + elif path.suffix == '.pkl': + proto = Protocol.pickle + + return load_str_bytes( + b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads + ) diff --git a/lib/pydantic/v1/py.typed b/lib/pydantic/v1/py.typed new file mode 100644 index 00000000..e69de29b diff --git a/lib/pydantic/v1/schema.py b/lib/pydantic/v1/schema.py new file mode 100644 index 00000000..ea16a72a --- /dev/null +++ b/lib/pydantic/v1/schema.py @@ -0,0 +1,1163 @@ +import re +import warnings +from collections import defaultdict +from dataclasses import is_dataclass +from datetime import date, datetime, time, timedelta +from decimal import Decimal +from enum import Enum +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from pathlib import Path +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + ForwardRef, + FrozenSet, + Generic, + Iterable, + List, + Optional, + Pattern, + Sequence, + Set, + Tuple, + Type, + TypeVar, + Union, + cast, +) +from uuid import UUID + +from typing_extensions import Annotated, Literal + +from .fields import ( + MAPPING_LIKE_SHAPES, + SHAPE_DEQUE, + SHAPE_FROZENSET, + SHAPE_GENERIC, + SHAPE_ITERABLE, + SHAPE_LIST, + SHAPE_SEQUENCE, + SHAPE_SET, + SHAPE_SINGLETON, + SHAPE_TUPLE, + SHAPE_TUPLE_ELLIPSIS, + FieldInfo, + ModelField, +) +from .json import pydantic_encoder +from .networks import AnyUrl, EmailStr +from .types import ( + ConstrainedDecimal, + ConstrainedFloat, + ConstrainedFrozenSet, + ConstrainedInt, + ConstrainedList, + ConstrainedSet, + ConstrainedStr, + SecretBytes, + SecretStr, + StrictBytes, + StrictStr, + conbytes, + condecimal, + confloat, + confrozenset, + conint, + conlist, + conset, + constr, +) +from .typing import ( + all_literal_values, + get_args, + get_origin, + get_sub_types, + is_callable_type, + is_literal_type, + is_namedtuple, + is_none_type, + is_union, +) +from .utils import ROOT_KEY, get_model, lenient_issubclass + +if TYPE_CHECKING: + from .dataclasses import Dataclass + from .main import BaseModel + +default_prefix = '#/definitions/' +default_ref_template = '#/definitions/{model}' + +TypeModelOrEnum = Union[Type['BaseModel'], Type[Enum]] +TypeModelSet = Set[TypeModelOrEnum] + + +def _apply_modify_schema( + modify_schema: Callable[..., None], field: Optional[ModelField], field_schema: Dict[str, Any] +) -> None: + from inspect import signature + + sig = signature(modify_schema) + args = set(sig.parameters.keys()) + if 'field' in args or 'kwargs' in args: + modify_schema(field_schema, field=field) + else: + modify_schema(field_schema) + + +def schema( + models: Sequence[Union[Type['BaseModel'], Type['Dataclass']]], + *, + by_alias: bool = True, + title: Optional[str] = None, + description: Optional[str] = None, + ref_prefix: Optional[str] = None, + ref_template: str = default_ref_template, +) -> Dict[str, Any]: + """ + Process a list of models and generate a single JSON Schema with all of them defined in the ``definitions`` + top-level JSON key, including their sub-models. + + :param models: a list of models to include in the generated JSON Schema + :param by_alias: generate the schemas using the aliases defined, if any + :param title: title for the generated schema that includes the definitions + :param description: description for the generated schema + :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the + default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere + else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the + top-level key ``definitions``, so you can extract them from there. But all the references will have the set + prefix. + :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful + for references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For + a sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``. + :return: dict with the JSON Schema with a ``definitions`` top-level key including the schema definitions for + the models and sub-models passed in ``models``. + """ + clean_models = [get_model(model) for model in models] + flat_models = get_flat_models_from_models(clean_models) + model_name_map = get_model_name_map(flat_models) + definitions = {} + output_schema: Dict[str, Any] = {} + if title: + output_schema['title'] = title + if description: + output_schema['description'] = description + for model in clean_models: + m_schema, m_definitions, m_nested_models = model_process_schema( + model, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + ) + definitions.update(m_definitions) + model_name = model_name_map[model] + definitions[model_name] = m_schema + if definitions: + output_schema['definitions'] = definitions + return output_schema + + +def model_schema( + model: Union[Type['BaseModel'], Type['Dataclass']], + by_alias: bool = True, + ref_prefix: Optional[str] = None, + ref_template: str = default_ref_template, +) -> Dict[str, Any]: + """ + Generate a JSON Schema for one model. With all the sub-models defined in the ``definitions`` top-level + JSON key. + + :param model: a Pydantic model (a class that inherits from BaseModel) + :param by_alias: generate the schemas using the aliases defined, if any + :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the + default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere + else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the + top-level key ``definitions``, so you can extract them from there. But all the references will have the set + prefix. + :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for + references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a + sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``. + :return: dict with the JSON Schema for the passed ``model`` + """ + model = get_model(model) + flat_models = get_flat_models_from_model(model) + model_name_map = get_model_name_map(flat_models) + model_name = model_name_map[model] + m_schema, m_definitions, nested_models = model_process_schema( + model, by_alias=by_alias, model_name_map=model_name_map, ref_prefix=ref_prefix, ref_template=ref_template + ) + if model_name in nested_models: + # model_name is in Nested models, it has circular references + m_definitions[model_name] = m_schema + m_schema = get_schema_ref(model_name, ref_prefix, ref_template, False) + if m_definitions: + m_schema.update({'definitions': m_definitions}) + return m_schema + + +def get_field_info_schema(field: ModelField, schema_overrides: bool = False) -> Tuple[Dict[str, Any], bool]: + # If no title is explicitly set, we don't set title in the schema for enums. + # The behaviour is the same as `BaseModel` reference, where the default title + # is in the definitions part of the schema. + schema_: Dict[str, Any] = {} + if field.field_info.title or not lenient_issubclass(field.type_, Enum): + schema_['title'] = field.field_info.title or field.alias.title().replace('_', ' ') + + if field.field_info.title: + schema_overrides = True + + if field.field_info.description: + schema_['description'] = field.field_info.description + schema_overrides = True + + if not field.required and field.default is not None and not is_callable_type(field.outer_type_): + schema_['default'] = encode_default(field.default) + schema_overrides = True + + return schema_, schema_overrides + + +def field_schema( + field: ModelField, + *, + by_alias: bool = True, + model_name_map: Dict[TypeModelOrEnum, str], + ref_prefix: Optional[str] = None, + ref_template: str = default_ref_template, + known_models: Optional[TypeModelSet] = None, +) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: + """ + Process a Pydantic field and return a tuple with a JSON Schema for it as the first item. + Also return a dictionary of definitions with models as keys and their schemas as values. If the passed field + is a model and has sub-models, and those sub-models don't have overrides (as ``title``, ``default``, etc), they + will be included in the definitions and referenced in the schema instead of included recursively. + + :param field: a Pydantic ``ModelField`` + :param by_alias: use the defined alias (if any) in the returned schema + :param model_name_map: used to generate the JSON Schema references to other models included in the definitions + :param ref_prefix: the JSON Pointer prefix to use for references to other schemas, if None, the default of + #/definitions/ will be used + :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for + references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a + sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``. + :param known_models: used to solve circular references + :return: tuple of the schema for this field and additional definitions + """ + s, schema_overrides = get_field_info_schema(field) + + validation_schema = get_field_schema_validations(field) + if validation_schema: + s.update(validation_schema) + schema_overrides = True + + f_schema, f_definitions, f_nested_models = field_type_schema( + field, + by_alias=by_alias, + model_name_map=model_name_map, + schema_overrides=schema_overrides, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models or set(), + ) + + # $ref will only be returned when there are no schema_overrides + if '$ref' in f_schema: + return f_schema, f_definitions, f_nested_models + else: + s.update(f_schema) + return s, f_definitions, f_nested_models + + +numeric_types = (int, float, Decimal) +_str_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = ( + ('max_length', numeric_types, 'maxLength'), + ('min_length', numeric_types, 'minLength'), + ('regex', str, 'pattern'), +) + +_numeric_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = ( + ('gt', numeric_types, 'exclusiveMinimum'), + ('lt', numeric_types, 'exclusiveMaximum'), + ('ge', numeric_types, 'minimum'), + ('le', numeric_types, 'maximum'), + ('multiple_of', numeric_types, 'multipleOf'), +) + + +def get_field_schema_validations(field: ModelField) -> Dict[str, Any]: + """ + Get the JSON Schema validation keywords for a ``field`` with an annotation of + a Pydantic ``FieldInfo`` with validation arguments. + """ + f_schema: Dict[str, Any] = {} + + if lenient_issubclass(field.type_, Enum): + # schema is already updated by `enum_process_schema`; just update with field extra + if field.field_info.extra: + f_schema.update(field.field_info.extra) + return f_schema + + if lenient_issubclass(field.type_, (str, bytes)): + for attr_name, t, keyword in _str_types_attrs: + attr = getattr(field.field_info, attr_name, None) + if isinstance(attr, t): + f_schema[keyword] = attr + if lenient_issubclass(field.type_, numeric_types) and not issubclass(field.type_, bool): + for attr_name, t, keyword in _numeric_types_attrs: + attr = getattr(field.field_info, attr_name, None) + if isinstance(attr, t): + f_schema[keyword] = attr + if field.field_info is not None and field.field_info.const: + f_schema['const'] = field.default + if field.field_info.extra: + f_schema.update(field.field_info.extra) + modify_schema = getattr(field.outer_type_, '__modify_schema__', None) + if modify_schema: + _apply_modify_schema(modify_schema, field, f_schema) + return f_schema + + +def get_model_name_map(unique_models: TypeModelSet) -> Dict[TypeModelOrEnum, str]: + """ + Process a set of models and generate unique names for them to be used as keys in the JSON Schema + definitions. By default the names are the same as the class name. But if two models in different Python + modules have the same name (e.g. "users.Model" and "items.Model"), the generated names will be + based on the Python module path for those conflicting models to prevent name collisions. + + :param unique_models: a Python set of models + :return: dict mapping models to names + """ + name_model_map = {} + conflicting_names: Set[str] = set() + for model in unique_models: + model_name = normalize_name(model.__name__) + if model_name in conflicting_names: + model_name = get_long_model_name(model) + name_model_map[model_name] = model + elif model_name in name_model_map: + conflicting_names.add(model_name) + conflicting_model = name_model_map.pop(model_name) + name_model_map[get_long_model_name(conflicting_model)] = conflicting_model + name_model_map[get_long_model_name(model)] = model + else: + name_model_map[model_name] = model + return {v: k for k, v in name_model_map.items()} + + +def get_flat_models_from_model(model: Type['BaseModel'], known_models: Optional[TypeModelSet] = None) -> TypeModelSet: + """ + Take a single ``model`` and generate a set with itself and all the sub-models in the tree. I.e. if you pass + model ``Foo`` (subclass of Pydantic ``BaseModel``) as ``model``, and it has a field of type ``Bar`` (also + subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also subclass of ``BaseModel``), + the return value will be ``set([Foo, Bar, Baz])``. + + :param model: a Pydantic ``BaseModel`` subclass + :param known_models: used to solve circular references + :return: a set with the initial model and all its sub-models + """ + known_models = known_models or set() + flat_models: TypeModelSet = set() + flat_models.add(model) + known_models |= flat_models + fields = cast(Sequence[ModelField], model.__fields__.values()) + flat_models |= get_flat_models_from_fields(fields, known_models=known_models) + return flat_models + + +def get_flat_models_from_field(field: ModelField, known_models: TypeModelSet) -> TypeModelSet: + """ + Take a single Pydantic ``ModelField`` (from a model) that could have been declared as a subclass of BaseModel + (so, it could be a submodel), and generate a set with its model and all the sub-models in the tree. + I.e. if you pass a field that was declared to be of type ``Foo`` (subclass of BaseModel) as ``field``, and that + model ``Foo`` has a field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of + type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``. + + :param field: a Pydantic ``ModelField`` + :param known_models: used to solve circular references + :return: a set with the model used in the declaration for this field, if any, and all its sub-models + """ + from .main import BaseModel + + flat_models: TypeModelSet = set() + + field_type = field.type_ + if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel): + field_type = field_type.__pydantic_model__ + + if field.sub_fields and not lenient_issubclass(field_type, BaseModel): + flat_models |= get_flat_models_from_fields(field.sub_fields, known_models=known_models) + elif lenient_issubclass(field_type, BaseModel) and field_type not in known_models: + flat_models |= get_flat_models_from_model(field_type, known_models=known_models) + elif lenient_issubclass(field_type, Enum): + flat_models.add(field_type) + return flat_models + + +def get_flat_models_from_fields(fields: Sequence[ModelField], known_models: TypeModelSet) -> TypeModelSet: + """ + Take a list of Pydantic ``ModelField``s (from a model) that could have been declared as subclasses of ``BaseModel`` + (so, any of them could be a submodel), and generate a set with their models and all the sub-models in the tree. + I.e. if you pass a the fields of a model ``Foo`` (subclass of ``BaseModel``) as ``fields``, and on of them has a + field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also + subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``. + + :param fields: a list of Pydantic ``ModelField``s + :param known_models: used to solve circular references + :return: a set with any model declared in the fields, and all their sub-models + """ + flat_models: TypeModelSet = set() + for field in fields: + flat_models |= get_flat_models_from_field(field, known_models=known_models) + return flat_models + + +def get_flat_models_from_models(models: Sequence[Type['BaseModel']]) -> TypeModelSet: + """ + Take a list of ``models`` and generate a set with them and all their sub-models in their trees. I.e. if you pass + a list of two models, ``Foo`` and ``Bar``, both subclasses of Pydantic ``BaseModel`` as models, and ``Bar`` has + a field of type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``. + """ + flat_models: TypeModelSet = set() + for model in models: + flat_models |= get_flat_models_from_model(model) + return flat_models + + +def get_long_model_name(model: TypeModelOrEnum) -> str: + return f'{model.__module__}__{model.__qualname__}'.replace('.', '__') + + +def field_type_schema( + field: ModelField, + *, + by_alias: bool, + model_name_map: Dict[TypeModelOrEnum, str], + ref_template: str, + schema_overrides: bool = False, + ref_prefix: Optional[str] = None, + known_models: TypeModelSet, +) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: + """ + Used by ``field_schema()``, you probably should be using that function. + + Take a single ``field`` and generate the schema for its type only, not including additional + information as title, etc. Also return additional schema definitions, from sub-models. + """ + from .main import BaseModel # noqa: F811 + + definitions = {} + nested_models: Set[str] = set() + f_schema: Dict[str, Any] + if field.shape in { + SHAPE_LIST, + SHAPE_TUPLE_ELLIPSIS, + SHAPE_SEQUENCE, + SHAPE_SET, + SHAPE_FROZENSET, + SHAPE_ITERABLE, + SHAPE_DEQUE, + }: + items_schema, f_definitions, f_nested_models = field_singleton_schema( + field, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + definitions.update(f_definitions) + nested_models.update(f_nested_models) + f_schema = {'type': 'array', 'items': items_schema} + if field.shape in {SHAPE_SET, SHAPE_FROZENSET}: + f_schema['uniqueItems'] = True + + elif field.shape in MAPPING_LIKE_SHAPES: + f_schema = {'type': 'object'} + key_field = cast(ModelField, field.key_field) + regex = getattr(key_field.type_, 'regex', None) + items_schema, f_definitions, f_nested_models = field_singleton_schema( + field, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + definitions.update(f_definitions) + nested_models.update(f_nested_models) + if regex: + # Dict keys have a regex pattern + # items_schema might be a schema or empty dict, add it either way + f_schema['patternProperties'] = {ConstrainedStr._get_pattern(regex): items_schema} + if items_schema: + # The dict values are not simply Any, so they need a schema + f_schema['additionalProperties'] = items_schema + elif field.shape == SHAPE_TUPLE or (field.shape == SHAPE_GENERIC and not issubclass(field.type_, BaseModel)): + sub_schema = [] + sub_fields = cast(List[ModelField], field.sub_fields) + for sf in sub_fields: + sf_schema, sf_definitions, sf_nested_models = field_type_schema( + sf, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + definitions.update(sf_definitions) + nested_models.update(sf_nested_models) + sub_schema.append(sf_schema) + + sub_fields_len = len(sub_fields) + if field.shape == SHAPE_GENERIC: + all_of_schemas = sub_schema[0] if sub_fields_len == 1 else {'type': 'array', 'items': sub_schema} + f_schema = {'allOf': [all_of_schemas]} + else: + f_schema = { + 'type': 'array', + 'minItems': sub_fields_len, + 'maxItems': sub_fields_len, + } + if sub_fields_len >= 1: + f_schema['items'] = sub_schema + else: + assert field.shape in {SHAPE_SINGLETON, SHAPE_GENERIC}, field.shape + f_schema, f_definitions, f_nested_models = field_singleton_schema( + field, + by_alias=by_alias, + model_name_map=model_name_map, + schema_overrides=schema_overrides, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + definitions.update(f_definitions) + nested_models.update(f_nested_models) + + # check field type to avoid repeated calls to the same __modify_schema__ method + if field.type_ != field.outer_type_: + if field.shape == SHAPE_GENERIC: + field_type = field.type_ + else: + field_type = field.outer_type_ + modify_schema = getattr(field_type, '__modify_schema__', None) + if modify_schema: + _apply_modify_schema(modify_schema, field, f_schema) + return f_schema, definitions, nested_models + + +def model_process_schema( + model: TypeModelOrEnum, + *, + by_alias: bool = True, + model_name_map: Dict[TypeModelOrEnum, str], + ref_prefix: Optional[str] = None, + ref_template: str = default_ref_template, + known_models: Optional[TypeModelSet] = None, + field: Optional[ModelField] = None, +) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: + """ + Used by ``model_schema()``, you probably should be using that function. + + Take a single ``model`` and generate its schema. Also return additional schema definitions, from sub-models. The + sub-models of the returned schema will be referenced, but their definitions will not be included in the schema. All + the definitions are returned as the second value. + """ + from inspect import getdoc, signature + + known_models = known_models or set() + if lenient_issubclass(model, Enum): + model = cast(Type[Enum], model) + s = enum_process_schema(model, field=field) + return s, {}, set() + model = cast(Type['BaseModel'], model) + s = {'title': model.__config__.title or model.__name__} + doc = getdoc(model) + if doc: + s['description'] = doc + known_models.add(model) + m_schema, m_definitions, nested_models = model_type_schema( + model, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + s.update(m_schema) + schema_extra = model.__config__.schema_extra + if callable(schema_extra): + if len(signature(schema_extra).parameters) == 1: + schema_extra(s) + else: + schema_extra(s, model) + else: + s.update(schema_extra) + return s, m_definitions, nested_models + + +def model_type_schema( + model: Type['BaseModel'], + *, + by_alias: bool, + model_name_map: Dict[TypeModelOrEnum, str], + ref_template: str, + ref_prefix: Optional[str] = None, + known_models: TypeModelSet, +) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: + """ + You probably should be using ``model_schema()``, this function is indirectly used by that function. + + Take a single ``model`` and generate the schema for its type only, not including additional + information as title, etc. Also return additional schema definitions, from sub-models. + """ + properties = {} + required = [] + definitions: Dict[str, Any] = {} + nested_models: Set[str] = set() + for k, f in model.__fields__.items(): + try: + f_schema, f_definitions, f_nested_models = field_schema( + f, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + except SkipField as skip: + warnings.warn(skip.message, UserWarning) + continue + definitions.update(f_definitions) + nested_models.update(f_nested_models) + if by_alias: + properties[f.alias] = f_schema + if f.required: + required.append(f.alias) + else: + properties[k] = f_schema + if f.required: + required.append(k) + if ROOT_KEY in properties: + out_schema = properties[ROOT_KEY] + out_schema['title'] = model.__config__.title or model.__name__ + else: + out_schema = {'type': 'object', 'properties': properties} + if required: + out_schema['required'] = required + if model.__config__.extra == 'forbid': + out_schema['additionalProperties'] = False + return out_schema, definitions, nested_models + + +def enum_process_schema(enum: Type[Enum], *, field: Optional[ModelField] = None) -> Dict[str, Any]: + """ + Take a single `enum` and generate its schema. + + This is similar to the `model_process_schema` function, but applies to ``Enum`` objects. + """ + import inspect + + schema_: Dict[str, Any] = { + 'title': enum.__name__, + # Python assigns all enums a default docstring value of 'An enumeration', so + # all enums will have a description field even if not explicitly provided. + 'description': inspect.cleandoc(enum.__doc__ or 'An enumeration.'), + # Add enum values and the enum field type to the schema. + 'enum': [item.value for item in cast(Iterable[Enum], enum)], + } + + add_field_type_to_schema(enum, schema_) + + modify_schema = getattr(enum, '__modify_schema__', None) + if modify_schema: + _apply_modify_schema(modify_schema, field, schema_) + + return schema_ + + +def field_singleton_sub_fields_schema( + field: ModelField, + *, + by_alias: bool, + model_name_map: Dict[TypeModelOrEnum, str], + ref_template: str, + schema_overrides: bool = False, + ref_prefix: Optional[str] = None, + known_models: TypeModelSet, +) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: + """ + This function is indirectly used by ``field_schema()``, you probably should be using that function. + + Take a list of Pydantic ``ModelField`` from the declaration of a type with parameters, and generate their + schema. I.e., fields used as "type parameters", like ``str`` and ``int`` in ``Tuple[str, int]``. + """ + sub_fields = cast(List[ModelField], field.sub_fields) + definitions = {} + nested_models: Set[str] = set() + if len(sub_fields) == 1: + return field_type_schema( + sub_fields[0], + by_alias=by_alias, + model_name_map=model_name_map, + schema_overrides=schema_overrides, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + else: + s: Dict[str, Any] = {} + # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#discriminator-object + field_has_discriminator: bool = field.discriminator_key is not None + if field_has_discriminator: + assert field.sub_fields_mapping is not None + + discriminator_models_refs: Dict[str, Union[str, Dict[str, Any]]] = {} + + for discriminator_value, sub_field in field.sub_fields_mapping.items(): + if isinstance(discriminator_value, Enum): + discriminator_value = str(discriminator_value.value) + # sub_field is either a `BaseModel` or directly an `Annotated` `Union` of many + if is_union(get_origin(sub_field.type_)): + sub_models = get_sub_types(sub_field.type_) + discriminator_models_refs[discriminator_value] = { + model_name_map[sub_model]: get_schema_ref( + model_name_map[sub_model], ref_prefix, ref_template, False + ) + for sub_model in sub_models + } + else: + sub_field_type = sub_field.type_ + if hasattr(sub_field_type, '__pydantic_model__'): + sub_field_type = sub_field_type.__pydantic_model__ + + discriminator_model_name = model_name_map[sub_field_type] + discriminator_model_ref = get_schema_ref(discriminator_model_name, ref_prefix, ref_template, False) + discriminator_models_refs[discriminator_value] = discriminator_model_ref['$ref'] + + s['discriminator'] = { + 'propertyName': field.discriminator_alias, + 'mapping': discriminator_models_refs, + } + + sub_field_schemas = [] + for sf in sub_fields: + sub_schema, sub_definitions, sub_nested_models = field_type_schema( + sf, + by_alias=by_alias, + model_name_map=model_name_map, + schema_overrides=schema_overrides, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + definitions.update(sub_definitions) + if schema_overrides and 'allOf' in sub_schema: + # if the sub_field is a referenced schema we only need the referenced + # object. Otherwise we will end up with several allOf inside anyOf/oneOf. + # See https://github.com/pydantic/pydantic/issues/1209 + sub_schema = sub_schema['allOf'][0] + + if sub_schema.keys() == {'discriminator', 'oneOf'}: + # we don't want discriminator information inside oneOf choices, this is dealt with elsewhere + sub_schema.pop('discriminator') + sub_field_schemas.append(sub_schema) + nested_models.update(sub_nested_models) + s['oneOf' if field_has_discriminator else 'anyOf'] = sub_field_schemas + return s, definitions, nested_models + + +# Order is important, e.g. subclasses of str must go before str +# this is used only for standard library types, custom types should use __modify_schema__ instead +field_class_to_schema: Tuple[Tuple[Any, Dict[str, Any]], ...] = ( + (Path, {'type': 'string', 'format': 'path'}), + (datetime, {'type': 'string', 'format': 'date-time'}), + (date, {'type': 'string', 'format': 'date'}), + (time, {'type': 'string', 'format': 'time'}), + (timedelta, {'type': 'number', 'format': 'time-delta'}), + (IPv4Network, {'type': 'string', 'format': 'ipv4network'}), + (IPv6Network, {'type': 'string', 'format': 'ipv6network'}), + (IPv4Interface, {'type': 'string', 'format': 'ipv4interface'}), + (IPv6Interface, {'type': 'string', 'format': 'ipv6interface'}), + (IPv4Address, {'type': 'string', 'format': 'ipv4'}), + (IPv6Address, {'type': 'string', 'format': 'ipv6'}), + (Pattern, {'type': 'string', 'format': 'regex'}), + (str, {'type': 'string'}), + (bytes, {'type': 'string', 'format': 'binary'}), + (bool, {'type': 'boolean'}), + (int, {'type': 'integer'}), + (float, {'type': 'number'}), + (Decimal, {'type': 'number'}), + (UUID, {'type': 'string', 'format': 'uuid'}), + (dict, {'type': 'object'}), + (list, {'type': 'array', 'items': {}}), + (tuple, {'type': 'array', 'items': {}}), + (set, {'type': 'array', 'items': {}, 'uniqueItems': True}), + (frozenset, {'type': 'array', 'items': {}, 'uniqueItems': True}), +) + +json_scheme = {'type': 'string', 'format': 'json-string'} + + +def add_field_type_to_schema(field_type: Any, schema_: Dict[str, Any]) -> None: + """ + Update the given `schema` with the type-specific metadata for the given `field_type`. + + This function looks through `field_class_to_schema` for a class that matches the given `field_type`, + and then modifies the given `schema` with the information from that type. + """ + for type_, t_schema in field_class_to_schema: + # Fallback for `typing.Pattern` and `re.Pattern` as they are not a valid class + if lenient_issubclass(field_type, type_) or field_type is type_ is Pattern: + schema_.update(t_schema) + break + + +def get_schema_ref(name: str, ref_prefix: Optional[str], ref_template: str, schema_overrides: bool) -> Dict[str, Any]: + if ref_prefix: + schema_ref = {'$ref': ref_prefix + name} + else: + schema_ref = {'$ref': ref_template.format(model=name)} + return {'allOf': [schema_ref]} if schema_overrides else schema_ref + + +def field_singleton_schema( # noqa: C901 (ignore complexity) + field: ModelField, + *, + by_alias: bool, + model_name_map: Dict[TypeModelOrEnum, str], + ref_template: str, + schema_overrides: bool = False, + ref_prefix: Optional[str] = None, + known_models: TypeModelSet, +) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: + """ + This function is indirectly used by ``field_schema()``, you should probably be using that function. + + Take a single Pydantic ``ModelField``, and return its schema and any additional definitions from sub-models. + """ + from .main import BaseModel + + definitions: Dict[str, Any] = {} + nested_models: Set[str] = set() + field_type = field.type_ + + # Recurse into this field if it contains sub_fields and is NOT a + # BaseModel OR that BaseModel is a const + if field.sub_fields and ( + (field.field_info and field.field_info.const) or not lenient_issubclass(field_type, BaseModel) + ): + return field_singleton_sub_fields_schema( + field, + by_alias=by_alias, + model_name_map=model_name_map, + schema_overrides=schema_overrides, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + if field_type is Any or field_type is object or field_type.__class__ == TypeVar or get_origin(field_type) is type: + return {}, definitions, nested_models # no restrictions + if is_none_type(field_type): + return {'type': 'null'}, definitions, nested_models + if is_callable_type(field_type): + raise SkipField(f'Callable {field.name} was excluded from schema since JSON schema has no equivalent type.') + f_schema: Dict[str, Any] = {} + if field.field_info is not None and field.field_info.const: + f_schema['const'] = field.default + + if is_literal_type(field_type): + values = tuple(x.value if isinstance(x, Enum) else x for x in all_literal_values(field_type)) + + if len({v.__class__ for v in values}) > 1: + return field_schema( + multitypes_literal_field_for_schema(values, field), + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + + # All values have the same type + field_type = values[0].__class__ + f_schema['enum'] = list(values) + add_field_type_to_schema(field_type, f_schema) + elif lenient_issubclass(field_type, Enum): + enum_name = model_name_map[field_type] + f_schema, schema_overrides = get_field_info_schema(field, schema_overrides) + f_schema.update(get_schema_ref(enum_name, ref_prefix, ref_template, schema_overrides)) + definitions[enum_name] = enum_process_schema(field_type, field=field) + elif is_namedtuple(field_type): + sub_schema, *_ = model_process_schema( + field_type.__pydantic_model__, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + field=field, + ) + items_schemas = list(sub_schema['properties'].values()) + f_schema.update( + { + 'type': 'array', + 'items': items_schemas, + 'minItems': len(items_schemas), + 'maxItems': len(items_schemas), + } + ) + elif not hasattr(field_type, '__pydantic_model__'): + add_field_type_to_schema(field_type, f_schema) + + modify_schema = getattr(field_type, '__modify_schema__', None) + if modify_schema: + _apply_modify_schema(modify_schema, field, f_schema) + + if f_schema: + return f_schema, definitions, nested_models + + # Handle dataclass-based models + if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel): + field_type = field_type.__pydantic_model__ + + if issubclass(field_type, BaseModel): + model_name = model_name_map[field_type] + if field_type not in known_models: + sub_schema, sub_definitions, sub_nested_models = model_process_schema( + field_type, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + field=field, + ) + definitions.update(sub_definitions) + definitions[model_name] = sub_schema + nested_models.update(sub_nested_models) + else: + nested_models.add(model_name) + schema_ref = get_schema_ref(model_name, ref_prefix, ref_template, schema_overrides) + return schema_ref, definitions, nested_models + + # For generics with no args + args = get_args(field_type) + if args is not None and not args and Generic in field_type.__bases__: + return f_schema, definitions, nested_models + + raise ValueError(f'Value not declarable with JSON Schema, field: {field}') + + +def multitypes_literal_field_for_schema(values: Tuple[Any, ...], field: ModelField) -> ModelField: + """ + To support `Literal` with values of different types, we split it into multiple `Literal` with same type + e.g. `Literal['qwe', 'asd', 1, 2]` becomes `Union[Literal['qwe', 'asd'], Literal[1, 2]]` + """ + literal_distinct_types = defaultdict(list) + for v in values: + literal_distinct_types[v.__class__].append(v) + distinct_literals = (Literal[tuple(same_type_values)] for same_type_values in literal_distinct_types.values()) + + return ModelField( + name=field.name, + type_=Union[tuple(distinct_literals)], # type: ignore + class_validators=field.class_validators, + model_config=field.model_config, + default=field.default, + required=field.required, + alias=field.alias, + field_info=field.field_info, + ) + + +def encode_default(dft: Any) -> Any: + from .main import BaseModel + + if isinstance(dft, BaseModel) or is_dataclass(dft): + dft = cast('dict[str, Any]', pydantic_encoder(dft)) + + if isinstance(dft, dict): + return {encode_default(k): encode_default(v) for k, v in dft.items()} + elif isinstance(dft, Enum): + return dft.value + elif isinstance(dft, (int, float, str)): + return dft + elif isinstance(dft, (list, tuple)): + t = dft.__class__ + seq_args = (encode_default(v) for v in dft) + return t(*seq_args) if is_namedtuple(t) else t(seq_args) + elif dft is None: + return None + else: + return pydantic_encoder(dft) + + +_map_types_constraint: Dict[Any, Callable[..., type]] = {int: conint, float: confloat, Decimal: condecimal} + + +def get_annotation_from_field_info( + annotation: Any, field_info: FieldInfo, field_name: str, validate_assignment: bool = False +) -> Type[Any]: + """ + Get an annotation with validation implemented for numbers and strings based on the field_info. + :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr`` + :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema + :param field_name: name of the field for use in error messages + :param validate_assignment: default False, flag for BaseModel Config value of validate_assignment + :return: the same ``annotation`` if unmodified or a new annotation with validation in place + """ + constraints = field_info.get_constraints() + used_constraints: Set[str] = set() + if constraints: + annotation, used_constraints = get_annotation_with_constraints(annotation, field_info) + if validate_assignment: + used_constraints.add('allow_mutation') + + unused_constraints = constraints - used_constraints + if unused_constraints: + raise ValueError( + f'On field "{field_name}" the following field constraints are set but not enforced: ' + f'{", ".join(unused_constraints)}. ' + f'\nFor more details see https://docs.pydantic.dev/usage/schema/#unenforced-field-constraints' + ) + + return annotation + + +def get_annotation_with_constraints(annotation: Any, field_info: FieldInfo) -> Tuple[Type[Any], Set[str]]: # noqa: C901 + """ + Get an annotation with used constraints implemented for numbers and strings based on the field_info. + + :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr`` + :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema + :return: the same ``annotation`` if unmodified or a new annotation along with the used constraints. + """ + used_constraints: Set[str] = set() + + def go(type_: Any) -> Type[Any]: + if ( + is_literal_type(type_) + or isinstance(type_, ForwardRef) + or lenient_issubclass(type_, (ConstrainedList, ConstrainedSet, ConstrainedFrozenSet)) + ): + return type_ + origin = get_origin(type_) + if origin is not None: + args: Tuple[Any, ...] = get_args(type_) + if any(isinstance(a, ForwardRef) for a in args): + # forward refs cause infinite recursion below + return type_ + + if origin is Annotated: + return go(args[0]) + if is_union(origin): + return Union[tuple(go(a) for a in args)] # type: ignore + + if issubclass(origin, List) and ( + field_info.min_items is not None + or field_info.max_items is not None + or field_info.unique_items is not None + ): + used_constraints.update({'min_items', 'max_items', 'unique_items'}) + return conlist( + go(args[0]), + min_items=field_info.min_items, + max_items=field_info.max_items, + unique_items=field_info.unique_items, + ) + + if issubclass(origin, Set) and (field_info.min_items is not None or field_info.max_items is not None): + used_constraints.update({'min_items', 'max_items'}) + return conset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items) + + if issubclass(origin, FrozenSet) and (field_info.min_items is not None or field_info.max_items is not None): + used_constraints.update({'min_items', 'max_items'}) + return confrozenset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items) + + for t in (Tuple, List, Set, FrozenSet, Sequence): + if issubclass(origin, t): # type: ignore + return t[tuple(go(a) for a in args)] # type: ignore + + if issubclass(origin, Dict): + return Dict[args[0], go(args[1])] # type: ignore + + attrs: Optional[Tuple[str, ...]] = None + constraint_func: Optional[Callable[..., type]] = None + if isinstance(type_, type): + if issubclass(type_, (SecretStr, SecretBytes)): + attrs = ('max_length', 'min_length') + + def constraint_func(**kw: Any) -> Type[Any]: + return type(type_.__name__, (type_,), kw) + + elif issubclass(type_, str) and not issubclass(type_, (EmailStr, AnyUrl)): + attrs = ('max_length', 'min_length', 'regex') + if issubclass(type_, StrictStr): + + def constraint_func(**kw: Any) -> Type[Any]: + return type(type_.__name__, (type_,), kw) + + else: + constraint_func = constr + elif issubclass(type_, bytes): + attrs = ('max_length', 'min_length', 'regex') + if issubclass(type_, StrictBytes): + + def constraint_func(**kw: Any) -> Type[Any]: + return type(type_.__name__, (type_,), kw) + + else: + constraint_func = conbytes + elif issubclass(type_, numeric_types) and not issubclass( + type_, + ( + ConstrainedInt, + ConstrainedFloat, + ConstrainedDecimal, + ConstrainedList, + ConstrainedSet, + ConstrainedFrozenSet, + bool, + ), + ): + # Is numeric type + attrs = ('gt', 'lt', 'ge', 'le', 'multiple_of') + if issubclass(type_, float): + attrs += ('allow_inf_nan',) + if issubclass(type_, Decimal): + attrs += ('max_digits', 'decimal_places') + numeric_type = next(t for t in numeric_types if issubclass(type_, t)) # pragma: no branch + constraint_func = _map_types_constraint[numeric_type] + + if attrs: + used_constraints.update(set(attrs)) + kwargs = { + attr_name: attr + for attr_name, attr in ((attr_name, getattr(field_info, attr_name)) for attr_name in attrs) + if attr is not None + } + if kwargs: + constraint_func = cast(Callable[..., type], constraint_func) + return constraint_func(**kwargs) + return type_ + + return go(annotation), used_constraints + + +def normalize_name(name: str) -> str: + """ + Normalizes the given name. This can be applied to either a model *or* enum. + """ + return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name) + + +class SkipField(Exception): + """ + Utility exception used to exclude fields from schema. + """ + + def __init__(self, message: str) -> None: + self.message = message diff --git a/lib/pydantic/v1/tools.py b/lib/pydantic/v1/tools.py new file mode 100644 index 00000000..45be2770 --- /dev/null +++ b/lib/pydantic/v1/tools.py @@ -0,0 +1,92 @@ +import json +from functools import lru_cache +from pathlib import Path +from typing import TYPE_CHECKING, Any, Callable, Optional, Type, TypeVar, Union + +from .parse import Protocol, load_file, load_str_bytes +from .types import StrBytes +from .typing import display_as_type + +__all__ = ('parse_file_as', 'parse_obj_as', 'parse_raw_as', 'schema_of', 'schema_json_of') + +NameFactory = Union[str, Callable[[Type[Any]], str]] + +if TYPE_CHECKING: + from .typing import DictStrAny + + +def _generate_parsing_type_name(type_: Any) -> str: + return f'ParsingModel[{display_as_type(type_)}]' + + +@lru_cache(maxsize=2048) +def _get_parsing_type(type_: Any, *, type_name: Optional[NameFactory] = None) -> Any: + from .main import create_model + + if type_name is None: + type_name = _generate_parsing_type_name + if not isinstance(type_name, str): + type_name = type_name(type_) + return create_model(type_name, __root__=(type_, ...)) + + +T = TypeVar('T') + + +def parse_obj_as(type_: Type[T], obj: Any, *, type_name: Optional[NameFactory] = None) -> T: + model_type = _get_parsing_type(type_, type_name=type_name) # type: ignore[arg-type] + return model_type(__root__=obj).__root__ + + +def parse_file_as( + type_: Type[T], + path: Union[str, Path], + *, + content_type: str = None, + encoding: str = 'utf8', + proto: Protocol = None, + allow_pickle: bool = False, + json_loads: Callable[[str], Any] = json.loads, + type_name: Optional[NameFactory] = None, +) -> T: + obj = load_file( + path, + proto=proto, + content_type=content_type, + encoding=encoding, + allow_pickle=allow_pickle, + json_loads=json_loads, + ) + return parse_obj_as(type_, obj, type_name=type_name) + + +def parse_raw_as( + type_: Type[T], + b: StrBytes, + *, + content_type: str = None, + encoding: str = 'utf8', + proto: Protocol = None, + allow_pickle: bool = False, + json_loads: Callable[[str], Any] = json.loads, + type_name: Optional[NameFactory] = None, +) -> T: + obj = load_str_bytes( + b, + proto=proto, + content_type=content_type, + encoding=encoding, + allow_pickle=allow_pickle, + json_loads=json_loads, + ) + return parse_obj_as(type_, obj, type_name=type_name) + + +def schema_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_kwargs: Any) -> 'DictStrAny': + """Generate a JSON schema (as dict) for the passed model or dynamically generated one""" + return _get_parsing_type(type_, type_name=title).schema(**schema_kwargs) + + +def schema_json_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_json_kwargs: Any) -> str: + """Generate a JSON schema (as JSON) for the passed model or dynamically generated one""" + return _get_parsing_type(type_, type_name=title).schema_json(**schema_json_kwargs) diff --git a/lib/pydantic/v1/types.py b/lib/pydantic/v1/types.py new file mode 100644 index 00000000..754e58ff --- /dev/null +++ b/lib/pydantic/v1/types.py @@ -0,0 +1,1205 @@ +import abc +import math +import re +import warnings +from datetime import date +from decimal import Decimal, InvalidOperation +from enum import Enum +from pathlib import Path +from types import new_class +from typing import ( + TYPE_CHECKING, + Any, + Callable, + ClassVar, + Dict, + FrozenSet, + List, + Optional, + Pattern, + Set, + Tuple, + Type, + TypeVar, + Union, + cast, + overload, +) +from uuid import UUID +from weakref import WeakSet + +from . import errors +from .datetime_parse import parse_date +from .utils import import_string, update_not_none +from .validators import ( + bytes_validator, + constr_length_validator, + constr_lower, + constr_strip_whitespace, + constr_upper, + decimal_validator, + float_finite_validator, + float_validator, + frozenset_validator, + int_validator, + list_validator, + number_multiple_validator, + number_size_validator, + path_exists_validator, + path_validator, + set_validator, + str_validator, + strict_bytes_validator, + strict_float_validator, + strict_int_validator, + strict_str_validator, +) + +__all__ = [ + 'NoneStr', + 'NoneBytes', + 'StrBytes', + 'NoneStrBytes', + 'StrictStr', + 'ConstrainedBytes', + 'conbytes', + 'ConstrainedList', + 'conlist', + 'ConstrainedSet', + 'conset', + 'ConstrainedFrozenSet', + 'confrozenset', + 'ConstrainedStr', + 'constr', + 'PyObject', + 'ConstrainedInt', + 'conint', + 'PositiveInt', + 'NegativeInt', + 'NonNegativeInt', + 'NonPositiveInt', + 'ConstrainedFloat', + 'confloat', + 'PositiveFloat', + 'NegativeFloat', + 'NonNegativeFloat', + 'NonPositiveFloat', + 'FiniteFloat', + 'ConstrainedDecimal', + 'condecimal', + 'UUID1', + 'UUID3', + 'UUID4', + 'UUID5', + 'FilePath', + 'DirectoryPath', + 'Json', + 'JsonWrapper', + 'SecretField', + 'SecretStr', + 'SecretBytes', + 'StrictBool', + 'StrictBytes', + 'StrictInt', + 'StrictFloat', + 'PaymentCardNumber', + 'ByteSize', + 'PastDate', + 'FutureDate', + 'ConstrainedDate', + 'condate', +] + +NoneStr = Optional[str] +NoneBytes = Optional[bytes] +StrBytes = Union[str, bytes] +NoneStrBytes = Optional[StrBytes] +OptionalInt = Optional[int] +OptionalIntFloat = Union[OptionalInt, float] +OptionalIntFloatDecimal = Union[OptionalIntFloat, Decimal] +OptionalDate = Optional[date] +StrIntFloat = Union[str, int, float] + +if TYPE_CHECKING: + from typing_extensions import Annotated + + from .dataclasses import Dataclass + from .main import BaseModel + from .typing import CallableGenerator + + ModelOrDc = Type[Union[BaseModel, Dataclass]] + +T = TypeVar('T') +_DEFINED_TYPES: 'WeakSet[type]' = WeakSet() + + +@overload +def _registered(typ: Type[T]) -> Type[T]: + pass + + +@overload +def _registered(typ: 'ConstrainedNumberMeta') -> 'ConstrainedNumberMeta': + pass + + +def _registered(typ: Union[Type[T], 'ConstrainedNumberMeta']) -> Union[Type[T], 'ConstrainedNumberMeta']: + # In order to generate valid examples of constrained types, Hypothesis needs + # to inspect the type object - so we keep a weakref to each contype object + # until it can be registered. When (or if) our Hypothesis plugin is loaded, + # it monkeypatches this function. + # If Hypothesis is never used, the total effect is to keep a weak reference + # which has minimal memory usage and doesn't even affect garbage collection. + _DEFINED_TYPES.add(typ) + return typ + + +class ConstrainedNumberMeta(type): + def __new__(cls, name: str, bases: Any, dct: Dict[str, Any]) -> 'ConstrainedInt': # type: ignore + new_cls = cast('ConstrainedInt', type.__new__(cls, name, bases, dct)) + + if new_cls.gt is not None and new_cls.ge is not None: + raise errors.ConfigError('bounds gt and ge cannot be specified at the same time') + if new_cls.lt is not None and new_cls.le is not None: + raise errors.ConfigError('bounds lt and le cannot be specified at the same time') + + return _registered(new_cls) # type: ignore + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BOOLEAN TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +if TYPE_CHECKING: + StrictBool = bool +else: + + class StrictBool(int): + """ + StrictBool to allow for bools which are not type-coerced. + """ + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='boolean') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, value: Any) -> bool: + """ + Ensure that we only allow bools. + """ + if isinstance(value, bool): + return value + + raise errors.StrictBoolError() + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTEGER TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class ConstrainedInt(int, metaclass=ConstrainedNumberMeta): + strict: bool = False + gt: OptionalInt = None + ge: OptionalInt = None + lt: OptionalInt = None + le: OptionalInt = None + multiple_of: OptionalInt = None + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none( + field_schema, + exclusiveMinimum=cls.gt, + exclusiveMaximum=cls.lt, + minimum=cls.ge, + maximum=cls.le, + multipleOf=cls.multiple_of, + ) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield strict_int_validator if cls.strict else int_validator + yield number_size_validator + yield number_multiple_validator + + +def conint( + *, + strict: bool = False, + gt: Optional[int] = None, + ge: Optional[int] = None, + lt: Optional[int] = None, + le: Optional[int] = None, + multiple_of: Optional[int] = None, +) -> Type[int]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of) + return type('ConstrainedIntValue', (ConstrainedInt,), namespace) + + +if TYPE_CHECKING: + PositiveInt = int + NegativeInt = int + NonPositiveInt = int + NonNegativeInt = int + StrictInt = int +else: + + class PositiveInt(ConstrainedInt): + gt = 0 + + class NegativeInt(ConstrainedInt): + lt = 0 + + class NonPositiveInt(ConstrainedInt): + le = 0 + + class NonNegativeInt(ConstrainedInt): + ge = 0 + + class StrictInt(ConstrainedInt): + strict = True + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ FLOAT TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class ConstrainedFloat(float, metaclass=ConstrainedNumberMeta): + strict: bool = False + gt: OptionalIntFloat = None + ge: OptionalIntFloat = None + lt: OptionalIntFloat = None + le: OptionalIntFloat = None + multiple_of: OptionalIntFloat = None + allow_inf_nan: Optional[bool] = None + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none( + field_schema, + exclusiveMinimum=cls.gt, + exclusiveMaximum=cls.lt, + minimum=cls.ge, + maximum=cls.le, + multipleOf=cls.multiple_of, + ) + # Modify constraints to account for differences between IEEE floats and JSON + if field_schema.get('exclusiveMinimum') == -math.inf: + del field_schema['exclusiveMinimum'] + if field_schema.get('minimum') == -math.inf: + del field_schema['minimum'] + if field_schema.get('exclusiveMaximum') == math.inf: + del field_schema['exclusiveMaximum'] + if field_schema.get('maximum') == math.inf: + del field_schema['maximum'] + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield strict_float_validator if cls.strict else float_validator + yield number_size_validator + yield number_multiple_validator + yield float_finite_validator + + +def confloat( + *, + strict: bool = False, + gt: float = None, + ge: float = None, + lt: float = None, + le: float = None, + multiple_of: float = None, + allow_inf_nan: Optional[bool] = None, +) -> Type[float]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of, allow_inf_nan=allow_inf_nan) + return type('ConstrainedFloatValue', (ConstrainedFloat,), namespace) + + +if TYPE_CHECKING: + PositiveFloat = float + NegativeFloat = float + NonPositiveFloat = float + NonNegativeFloat = float + StrictFloat = float + FiniteFloat = float +else: + + class PositiveFloat(ConstrainedFloat): + gt = 0 + + class NegativeFloat(ConstrainedFloat): + lt = 0 + + class NonPositiveFloat(ConstrainedFloat): + le = 0 + + class NonNegativeFloat(ConstrainedFloat): + ge = 0 + + class StrictFloat(ConstrainedFloat): + strict = True + + class FiniteFloat(ConstrainedFloat): + allow_inf_nan = False + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTES TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class ConstrainedBytes(bytes): + strip_whitespace = False + to_upper = False + to_lower = False + min_length: OptionalInt = None + max_length: OptionalInt = None + strict: bool = False + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield strict_bytes_validator if cls.strict else bytes_validator + yield constr_strip_whitespace + yield constr_upper + yield constr_lower + yield constr_length_validator + + +def conbytes( + *, + strip_whitespace: bool = False, + to_upper: bool = False, + to_lower: bool = False, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + strict: bool = False, +) -> Type[bytes]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict( + strip_whitespace=strip_whitespace, + to_upper=to_upper, + to_lower=to_lower, + min_length=min_length, + max_length=max_length, + strict=strict, + ) + return _registered(type('ConstrainedBytesValue', (ConstrainedBytes,), namespace)) + + +if TYPE_CHECKING: + StrictBytes = bytes +else: + + class StrictBytes(ConstrainedBytes): + strict = True + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ STRING TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class ConstrainedStr(str): + strip_whitespace = False + to_upper = False + to_lower = False + min_length: OptionalInt = None + max_length: OptionalInt = None + curtail_length: OptionalInt = None + regex: Optional[Union[str, Pattern[str]]] = None + strict = False + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none( + field_schema, + minLength=cls.min_length, + maxLength=cls.max_length, + pattern=cls.regex and cls._get_pattern(cls.regex), + ) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield strict_str_validator if cls.strict else str_validator + yield constr_strip_whitespace + yield constr_upper + yield constr_lower + yield constr_length_validator + yield cls.validate + + @classmethod + def validate(cls, value: Union[str]) -> Union[str]: + if cls.curtail_length and len(value) > cls.curtail_length: + value = value[: cls.curtail_length] + + if cls.regex: + if not re.match(cls.regex, value): + raise errors.StrRegexError(pattern=cls._get_pattern(cls.regex)) + + return value + + @staticmethod + def _get_pattern(regex: Union[str, Pattern[str]]) -> str: + return regex if isinstance(regex, str) else regex.pattern + + +def constr( + *, + strip_whitespace: bool = False, + to_upper: bool = False, + to_lower: bool = False, + strict: bool = False, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + curtail_length: Optional[int] = None, + regex: Optional[str] = None, +) -> Type[str]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict( + strip_whitespace=strip_whitespace, + to_upper=to_upper, + to_lower=to_lower, + strict=strict, + min_length=min_length, + max_length=max_length, + curtail_length=curtail_length, + regex=regex and re.compile(regex), + ) + return _registered(type('ConstrainedStrValue', (ConstrainedStr,), namespace)) + + +if TYPE_CHECKING: + StrictStr = str +else: + + class StrictStr(ConstrainedStr): + strict = True + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +# This types superclass should be Set[T], but cython chokes on that... +class ConstrainedSet(set): # type: ignore + # Needed for pydantic to detect that this is a set + __origin__ = set + __args__: Set[Type[T]] # type: ignore + + min_items: Optional[int] = None + max_items: Optional[int] = None + item_type: Type[T] # type: ignore + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.set_length_validator + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items) + + @classmethod + def set_length_validator(cls, v: 'Optional[Set[T]]') -> 'Optional[Set[T]]': + if v is None: + return None + + v = set_validator(v) + v_len = len(v) + + if cls.min_items is not None and v_len < cls.min_items: + raise errors.SetMinLengthError(limit_value=cls.min_items) + + if cls.max_items is not None and v_len > cls.max_items: + raise errors.SetMaxLengthError(limit_value=cls.max_items) + + return v + + +def conset(item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None) -> Type[Set[T]]: + # __args__ is needed to conform to typing generics api + namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]} + # We use new_class to be able to deal with Generic types + return new_class('ConstrainedSetValue', (ConstrainedSet,), {}, lambda ns: ns.update(namespace)) + + +# This types superclass should be FrozenSet[T], but cython chokes on that... +class ConstrainedFrozenSet(frozenset): # type: ignore + # Needed for pydantic to detect that this is a set + __origin__ = frozenset + __args__: FrozenSet[Type[T]] # type: ignore + + min_items: Optional[int] = None + max_items: Optional[int] = None + item_type: Type[T] # type: ignore + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.frozenset_length_validator + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items) + + @classmethod + def frozenset_length_validator(cls, v: 'Optional[FrozenSet[T]]') -> 'Optional[FrozenSet[T]]': + if v is None: + return None + + v = frozenset_validator(v) + v_len = len(v) + + if cls.min_items is not None and v_len < cls.min_items: + raise errors.FrozenSetMinLengthError(limit_value=cls.min_items) + + if cls.max_items is not None and v_len > cls.max_items: + raise errors.FrozenSetMaxLengthError(limit_value=cls.max_items) + + return v + + +def confrozenset( + item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None +) -> Type[FrozenSet[T]]: + # __args__ is needed to conform to typing generics api + namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]} + # We use new_class to be able to deal with Generic types + return new_class('ConstrainedFrozenSetValue', (ConstrainedFrozenSet,), {}, lambda ns: ns.update(namespace)) + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ LIST TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +# This types superclass should be List[T], but cython chokes on that... +class ConstrainedList(list): # type: ignore + # Needed for pydantic to detect that this is a list + __origin__ = list + __args__: Tuple[Type[T], ...] # type: ignore + + min_items: Optional[int] = None + max_items: Optional[int] = None + unique_items: Optional[bool] = None + item_type: Type[T] # type: ignore + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.list_length_validator + if cls.unique_items: + yield cls.unique_items_validator + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items, uniqueItems=cls.unique_items) + + @classmethod + def list_length_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]': + if v is None: + return None + + v = list_validator(v) + v_len = len(v) + + if cls.min_items is not None and v_len < cls.min_items: + raise errors.ListMinLengthError(limit_value=cls.min_items) + + if cls.max_items is not None and v_len > cls.max_items: + raise errors.ListMaxLengthError(limit_value=cls.max_items) + + return v + + @classmethod + def unique_items_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]': + if v is None: + return None + + for i, value in enumerate(v, start=1): + if value in v[i:]: + raise errors.ListUniqueItemsError() + + return v + + +def conlist( + item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None, unique_items: bool = None +) -> Type[List[T]]: + # __args__ is needed to conform to typing generics api + namespace = dict( + min_items=min_items, max_items=max_items, unique_items=unique_items, item_type=item_type, __args__=(item_type,) + ) + # We use new_class to be able to deal with Generic types + return new_class('ConstrainedListValue', (ConstrainedList,), {}, lambda ns: ns.update(namespace)) + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PYOBJECT TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +if TYPE_CHECKING: + PyObject = Callable[..., Any] +else: + + class PyObject: + validate_always = True + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, value: Any) -> Any: + if isinstance(value, Callable): + return value + + try: + value = str_validator(value) + except errors.StrError: + raise errors.PyObjectError(error_message='value is neither a valid import path not a valid callable') + + try: + return import_string(value) + except ImportError as e: + raise errors.PyObjectError(error_message=str(e)) + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DECIMAL TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class ConstrainedDecimal(Decimal, metaclass=ConstrainedNumberMeta): + gt: OptionalIntFloatDecimal = None + ge: OptionalIntFloatDecimal = None + lt: OptionalIntFloatDecimal = None + le: OptionalIntFloatDecimal = None + max_digits: OptionalInt = None + decimal_places: OptionalInt = None + multiple_of: OptionalIntFloatDecimal = None + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none( + field_schema, + exclusiveMinimum=cls.gt, + exclusiveMaximum=cls.lt, + minimum=cls.ge, + maximum=cls.le, + multipleOf=cls.multiple_of, + ) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield decimal_validator + yield number_size_validator + yield number_multiple_validator + yield cls.validate + + @classmethod + def validate(cls, value: Decimal) -> Decimal: + try: + normalized_value = value.normalize() + except InvalidOperation: + normalized_value = value + digit_tuple, exponent = normalized_value.as_tuple()[1:] + if exponent in {'F', 'n', 'N'}: + raise errors.DecimalIsNotFiniteError() + + if exponent >= 0: + # A positive exponent adds that many trailing zeros. + digits = len(digit_tuple) + exponent + decimals = 0 + else: + # If the absolute value of the negative exponent is larger than the + # number of digits, then it's the same as the number of digits, + # because it'll consume all of the digits in digit_tuple and then + # add abs(exponent) - len(digit_tuple) leading zeros after the + # decimal point. + if abs(exponent) > len(digit_tuple): + digits = decimals = abs(exponent) + else: + digits = len(digit_tuple) + decimals = abs(exponent) + whole_digits = digits - decimals + + if cls.max_digits is not None and digits > cls.max_digits: + raise errors.DecimalMaxDigitsError(max_digits=cls.max_digits) + + if cls.decimal_places is not None and decimals > cls.decimal_places: + raise errors.DecimalMaxPlacesError(decimal_places=cls.decimal_places) + + if cls.max_digits is not None and cls.decimal_places is not None: + expected = cls.max_digits - cls.decimal_places + if whole_digits > expected: + raise errors.DecimalWholeDigitsError(whole_digits=expected) + + return value + + +def condecimal( + *, + gt: Decimal = None, + ge: Decimal = None, + lt: Decimal = None, + le: Decimal = None, + max_digits: Optional[int] = None, + decimal_places: Optional[int] = None, + multiple_of: Decimal = None, +) -> Type[Decimal]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict( + gt=gt, ge=ge, lt=lt, le=le, max_digits=max_digits, decimal_places=decimal_places, multiple_of=multiple_of + ) + return type('ConstrainedDecimalValue', (ConstrainedDecimal,), namespace) + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ UUID TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +if TYPE_CHECKING: + UUID1 = UUID + UUID3 = UUID + UUID4 = UUID + UUID5 = UUID +else: + + class UUID1(UUID): + _required_version = 1 + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format=f'uuid{cls._required_version}') + + class UUID3(UUID1): + _required_version = 3 + + class UUID4(UUID1): + _required_version = 4 + + class UUID5(UUID1): + _required_version = 5 + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PATH TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +if TYPE_CHECKING: + FilePath = Path + DirectoryPath = Path +else: + + class FilePath(Path): + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(format='file-path') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield path_validator + yield path_exists_validator + yield cls.validate + + @classmethod + def validate(cls, value: Path) -> Path: + if not value.is_file(): + raise errors.PathNotAFileError(path=value) + + return value + + class DirectoryPath(Path): + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(format='directory-path') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield path_validator + yield path_exists_validator + yield cls.validate + + @classmethod + def validate(cls, value: Path) -> Path: + if not value.is_dir(): + raise errors.PathNotADirectoryError(path=value) + + return value + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ JSON TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class JsonWrapper: + pass + + +class JsonMeta(type): + def __getitem__(self, t: Type[Any]) -> Type[JsonWrapper]: + if t is Any: + return Json # allow Json[Any] to replecate plain Json + return _registered(type('JsonWrapperValue', (JsonWrapper,), {'inner_type': t})) + + +if TYPE_CHECKING: + Json = Annotated[T, ...] # Json[list[str]] will be recognized by type checkers as list[str] + +else: + + class Json(metaclass=JsonMeta): + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='json-string') + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SECRET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class SecretField(abc.ABC): + """ + Note: this should be implemented as a generic like `SecretField(ABC, Generic[T])`, + the `__init__()` should be part of the abstract class and the + `get_secret_value()` method should use the generic `T` type. + + However Cython doesn't support very well generics at the moment and + the generated code fails to be imported (see + https://github.com/cython/cython/issues/2753). + """ + + def __eq__(self, other: Any) -> bool: + return isinstance(other, self.__class__) and self.get_secret_value() == other.get_secret_value() + + def __str__(self) -> str: + return '**********' if self.get_secret_value() else '' + + def __hash__(self) -> int: + return hash(self.get_secret_value()) + + @abc.abstractmethod + def get_secret_value(self) -> Any: # pragma: no cover + ... + + +class SecretStr(SecretField): + min_length: OptionalInt = None + max_length: OptionalInt = None + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none( + field_schema, + type='string', + writeOnly=True, + format='password', + minLength=cls.min_length, + maxLength=cls.max_length, + ) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + yield constr_length_validator + + @classmethod + def validate(cls, value: Any) -> 'SecretStr': + if isinstance(value, cls): + return value + value = str_validator(value) + return cls(value) + + def __init__(self, value: str): + self._secret_value = value + + def __repr__(self) -> str: + return f"SecretStr('{self}')" + + def __len__(self) -> int: + return len(self._secret_value) + + def display(self) -> str: + warnings.warn('`secret_str.display()` is deprecated, use `str(secret_str)` instead', DeprecationWarning) + return str(self) + + def get_secret_value(self) -> str: + return self._secret_value + + +class SecretBytes(SecretField): + min_length: OptionalInt = None + max_length: OptionalInt = None + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none( + field_schema, + type='string', + writeOnly=True, + format='password', + minLength=cls.min_length, + maxLength=cls.max_length, + ) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + yield constr_length_validator + + @classmethod + def validate(cls, value: Any) -> 'SecretBytes': + if isinstance(value, cls): + return value + value = bytes_validator(value) + return cls(value) + + def __init__(self, value: bytes): + self._secret_value = value + + def __repr__(self) -> str: + return f"SecretBytes(b'{self}')" + + def __len__(self) -> int: + return len(self._secret_value) + + def display(self) -> str: + warnings.warn('`secret_bytes.display()` is deprecated, use `str(secret_bytes)` instead', DeprecationWarning) + return str(self) + + def get_secret_value(self) -> bytes: + return self._secret_value + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PAYMENT CARD TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class PaymentCardBrand(str, Enum): + # If you add another card type, please also add it to the + # Hypothesis strategy in `pydantic._hypothesis_plugin`. + amex = 'American Express' + mastercard = 'Mastercard' + visa = 'Visa' + other = 'other' + + def __str__(self) -> str: + return self.value + + +class PaymentCardNumber(str): + """ + Based on: https://en.wikipedia.org/wiki/Payment_card_number + """ + + strip_whitespace: ClassVar[bool] = True + min_length: ClassVar[int] = 12 + max_length: ClassVar[int] = 19 + bin: str + last4: str + brand: PaymentCardBrand + + def __init__(self, card_number: str): + self.bin = card_number[:6] + self.last4 = card_number[-4:] + self.brand = self._get_brand(card_number) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield str_validator + yield constr_strip_whitespace + yield constr_length_validator + yield cls.validate_digits + yield cls.validate_luhn_check_digit + yield cls + yield cls.validate_length_for_brand + + @property + def masked(self) -> str: + num_masked = len(self) - 10 # len(bin) + len(last4) == 10 + return f'{self.bin}{"*" * num_masked}{self.last4}' + + @classmethod + def validate_digits(cls, card_number: str) -> str: + if not card_number.isdigit(): + raise errors.NotDigitError + return card_number + + @classmethod + def validate_luhn_check_digit(cls, card_number: str) -> str: + """ + Based on: https://en.wikipedia.org/wiki/Luhn_algorithm + """ + sum_ = int(card_number[-1]) + length = len(card_number) + parity = length % 2 + for i in range(length - 1): + digit = int(card_number[i]) + if i % 2 == parity: + digit *= 2 + if digit > 9: + digit -= 9 + sum_ += digit + valid = sum_ % 10 == 0 + if not valid: + raise errors.LuhnValidationError + return card_number + + @classmethod + def validate_length_for_brand(cls, card_number: 'PaymentCardNumber') -> 'PaymentCardNumber': + """ + Validate length based on BIN for major brands: + https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN) + """ + required_length: Union[None, int, str] = None + if card_number.brand in PaymentCardBrand.mastercard: + required_length = 16 + valid = len(card_number) == required_length + elif card_number.brand == PaymentCardBrand.visa: + required_length = '13, 16 or 19' + valid = len(card_number) in {13, 16, 19} + elif card_number.brand == PaymentCardBrand.amex: + required_length = 15 + valid = len(card_number) == required_length + else: + valid = True + if not valid: + raise errors.InvalidLengthForBrand(brand=card_number.brand, required_length=required_length) + return card_number + + @staticmethod + def _get_brand(card_number: str) -> PaymentCardBrand: + if card_number[0] == '4': + brand = PaymentCardBrand.visa + elif 51 <= int(card_number[:2]) <= 55: + brand = PaymentCardBrand.mastercard + elif card_number[:2] in {'34', '37'}: + brand = PaymentCardBrand.amex + else: + brand = PaymentCardBrand.other + return brand + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTE SIZE TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +BYTE_SIZES = { + 'b': 1, + 'kb': 10**3, + 'mb': 10**6, + 'gb': 10**9, + 'tb': 10**12, + 'pb': 10**15, + 'eb': 10**18, + 'kib': 2**10, + 'mib': 2**20, + 'gib': 2**30, + 'tib': 2**40, + 'pib': 2**50, + 'eib': 2**60, +} +BYTE_SIZES.update({k.lower()[0]: v for k, v in BYTE_SIZES.items() if 'i' not in k}) +byte_string_re = re.compile(r'^\s*(\d*\.?\d+)\s*(\w+)?', re.IGNORECASE) + + +class ByteSize(int): + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, v: StrIntFloat) -> 'ByteSize': + try: + return cls(int(v)) + except ValueError: + pass + + str_match = byte_string_re.match(str(v)) + if str_match is None: + raise errors.InvalidByteSize() + + scalar, unit = str_match.groups() + if unit is None: + unit = 'b' + + try: + unit_mult = BYTE_SIZES[unit.lower()] + except KeyError: + raise errors.InvalidByteSizeUnit(unit=unit) + + return cls(int(float(scalar) * unit_mult)) + + def human_readable(self, decimal: bool = False) -> str: + if decimal: + divisor = 1000 + units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'] + final_unit = 'EB' + else: + divisor = 1024 + units = ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB'] + final_unit = 'EiB' + + num = float(self) + for unit in units: + if abs(num) < divisor: + return f'{num:0.1f}{unit}' + num /= divisor + + return f'{num:0.1f}{final_unit}' + + def to(self, unit: str) -> float: + try: + unit_div = BYTE_SIZES[unit.lower()] + except KeyError: + raise errors.InvalidByteSizeUnit(unit=unit) + + return self / unit_div + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATE TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +if TYPE_CHECKING: + PastDate = date + FutureDate = date +else: + + class PastDate(date): + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield parse_date + yield cls.validate + + @classmethod + def validate(cls, value: date) -> date: + if value >= date.today(): + raise errors.DateNotInThePastError() + + return value + + class FutureDate(date): + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield parse_date + yield cls.validate + + @classmethod + def validate(cls, value: date) -> date: + if value <= date.today(): + raise errors.DateNotInTheFutureError() + + return value + + +class ConstrainedDate(date, metaclass=ConstrainedNumberMeta): + gt: OptionalDate = None + ge: OptionalDate = None + lt: OptionalDate = None + le: OptionalDate = None + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none(field_schema, exclusiveMinimum=cls.gt, exclusiveMaximum=cls.lt, minimum=cls.ge, maximum=cls.le) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield parse_date + yield number_size_validator + + +def condate( + *, + gt: date = None, + ge: date = None, + lt: date = None, + le: date = None, +) -> Type[date]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict(gt=gt, ge=ge, lt=lt, le=le) + return type('ConstrainedDateValue', (ConstrainedDate,), namespace) diff --git a/lib/pydantic/v1/typing.py b/lib/pydantic/v1/typing.py new file mode 100644 index 00000000..a690a053 --- /dev/null +++ b/lib/pydantic/v1/typing.py @@ -0,0 +1,603 @@ +import sys +import typing +from collections.abc import Callable +from os import PathLike +from typing import ( # type: ignore + TYPE_CHECKING, + AbstractSet, + Any, + Callable as TypingCallable, + ClassVar, + Dict, + ForwardRef, + Generator, + Iterable, + List, + Mapping, + NewType, + Optional, + Sequence, + Set, + Tuple, + Type, + TypeVar, + Union, + _eval_type, + cast, + get_type_hints, +) + +from typing_extensions import ( + Annotated, + Final, + Literal, + NotRequired as TypedDictNotRequired, + Required as TypedDictRequired, +) + +try: + from typing import _TypingBase as typing_base # type: ignore +except ImportError: + from typing import _Final as typing_base # type: ignore + +try: + from typing import GenericAlias as TypingGenericAlias # type: ignore +except ImportError: + # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on) + TypingGenericAlias = () + +try: + from types import UnionType as TypesUnionType # type: ignore +except ImportError: + # python < 3.10 does not have UnionType (str | int, byte | bool and so on) + TypesUnionType = () + + +if sys.version_info < (3, 9): + + def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any: + return type_._evaluate(globalns, localns) + +else: + + def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any: + # Even though it is the right signature for python 3.9, mypy complains with + # `error: Too many arguments for "_evaluate" of "ForwardRef"` hence the cast... + return cast(Any, type_)._evaluate(globalns, localns, set()) + + +if sys.version_info < (3, 9): + # Ensure we always get all the whole `Annotated` hint, not just the annotated type. + # For 3.7 to 3.8, `get_type_hints` doesn't recognize `typing_extensions.Annotated`, + # so it already returns the full annotation + get_all_type_hints = get_type_hints + +else: + + def get_all_type_hints(obj: Any, globalns: Any = None, localns: Any = None) -> Any: + return get_type_hints(obj, globalns, localns, include_extras=True) + + +_T = TypeVar('_T') + +AnyCallable = TypingCallable[..., Any] +NoArgAnyCallable = TypingCallable[[], Any] + +# workaround for https://github.com/python/mypy/issues/9496 +AnyArgTCallable = TypingCallable[..., _T] + + +# Annotated[...] is implemented by returning an instance of one of these classes, depending on +# python/typing_extensions version. +AnnotatedTypeNames = {'AnnotatedMeta', '_AnnotatedAlias'} + + +LITERAL_TYPES: Set[Any] = {Literal} +if hasattr(typing, 'Literal'): + LITERAL_TYPES.add(typing.Literal) + + +if sys.version_info < (3, 8): + + def get_origin(t: Type[Any]) -> Optional[Type[Any]]: + if type(t).__name__ in AnnotatedTypeNames: + # weirdly this is a runtime requirement, as well as for mypy + return cast(Type[Any], Annotated) + return getattr(t, '__origin__', None) + +else: + from typing import get_origin as _typing_get_origin + + def get_origin(tp: Type[Any]) -> Optional[Type[Any]]: + """ + We can't directly use `typing.get_origin` since we need a fallback to support + custom generic classes like `ConstrainedList` + It should be useless once https://github.com/cython/cython/issues/3537 is + solved and https://github.com/pydantic/pydantic/pull/1753 is merged. + """ + if type(tp).__name__ in AnnotatedTypeNames: + return cast(Type[Any], Annotated) # mypy complains about _SpecialForm + return _typing_get_origin(tp) or getattr(tp, '__origin__', None) + + +if sys.version_info < (3, 8): + from typing import _GenericAlias + + def get_args(t: Type[Any]) -> Tuple[Any, ...]: + """Compatibility version of get_args for python 3.7. + + Mostly compatible with the python 3.8 `typing` module version + and able to handle almost all use cases. + """ + if type(t).__name__ in AnnotatedTypeNames: + return t.__args__ + t.__metadata__ + if isinstance(t, _GenericAlias): + res = t.__args__ + if t.__origin__ is Callable and res and res[0] is not Ellipsis: + res = (list(res[:-1]), res[-1]) + return res + return getattr(t, '__args__', ()) + +else: + from typing import get_args as _typing_get_args + + def _generic_get_args(tp: Type[Any]) -> Tuple[Any, ...]: + """ + In python 3.9, `typing.Dict`, `typing.List`, ... + do have an empty `__args__` by default (instead of the generic ~T for example). + In order to still support `Dict` for example and consider it as `Dict[Any, Any]`, + we retrieve the `_nparams` value that tells us how many parameters it needs. + """ + if hasattr(tp, '_nparams'): + return (Any,) * tp._nparams + # Special case for `tuple[()]`, which used to return ((),) with `typing.Tuple` + # in python 3.10- but now returns () for `tuple` and `Tuple`. + # This will probably be clarified in pydantic v2 + try: + if tp == Tuple[()] or sys.version_info >= (3, 9) and tp == tuple[()]: # type: ignore[misc] + return ((),) + # there is a TypeError when compiled with cython + except TypeError: # pragma: no cover + pass + return () + + def get_args(tp: Type[Any]) -> Tuple[Any, ...]: + """Get type arguments with all substitutions performed. + + For unions, basic simplifications used by Union constructor are performed. + Examples:: + get_args(Dict[str, int]) == (str, int) + get_args(int) == () + get_args(Union[int, Union[T, int], str][int]) == (int, str) + get_args(Union[int, Tuple[T, int]][str]) == (int, Tuple[str, int]) + get_args(Callable[[], T][int]) == ([], int) + """ + if type(tp).__name__ in AnnotatedTypeNames: + return tp.__args__ + tp.__metadata__ + # the fallback is needed for the same reasons as `get_origin` (see above) + return _typing_get_args(tp) or getattr(tp, '__args__', ()) or _generic_get_args(tp) + + +if sys.version_info < (3, 9): + + def convert_generics(tp: Type[Any]) -> Type[Any]: + """Python 3.9 and older only supports generics from `typing` module. + They convert strings to ForwardRef automatically. + + Examples:: + typing.List['Hero'] == typing.List[ForwardRef('Hero')] + """ + return tp + +else: + from typing import _UnionGenericAlias # type: ignore + + from typing_extensions import _AnnotatedAlias + + def convert_generics(tp: Type[Any]) -> Type[Any]: + """ + Recursively searches for `str` type hints and replaces them with ForwardRef. + + Examples:: + convert_generics(list['Hero']) == list[ForwardRef('Hero')] + convert_generics(dict['Hero', 'Team']) == dict[ForwardRef('Hero'), ForwardRef('Team')] + convert_generics(typing.Dict['Hero', 'Team']) == typing.Dict[ForwardRef('Hero'), ForwardRef('Team')] + convert_generics(list[str | 'Hero'] | int) == list[str | ForwardRef('Hero')] | int + """ + origin = get_origin(tp) + if not origin or not hasattr(tp, '__args__'): + return tp + + args = get_args(tp) + + # typing.Annotated needs special treatment + if origin is Annotated: + return _AnnotatedAlias(convert_generics(args[0]), args[1:]) + + # recursively replace `str` instances inside of `GenericAlias` with `ForwardRef(arg)` + converted = tuple( + ForwardRef(arg) if isinstance(arg, str) and isinstance(tp, TypingGenericAlias) else convert_generics(arg) + for arg in args + ) + + if converted == args: + return tp + elif isinstance(tp, TypingGenericAlias): + return TypingGenericAlias(origin, converted) + elif isinstance(tp, TypesUnionType): + # recreate types.UnionType (PEP604, Python >= 3.10) + return _UnionGenericAlias(origin, converted) + else: + try: + setattr(tp, '__args__', converted) + except AttributeError: + pass + return tp + + +if sys.version_info < (3, 10): + + def is_union(tp: Optional[Type[Any]]) -> bool: + return tp is Union + + WithArgsTypes = (TypingGenericAlias,) + +else: + import types + import typing + + def is_union(tp: Optional[Type[Any]]) -> bool: + return tp is Union or tp is types.UnionType # noqa: E721 + + WithArgsTypes = (typing._GenericAlias, types.GenericAlias, types.UnionType) + + +StrPath = Union[str, PathLike] + + +if TYPE_CHECKING: + from .fields import ModelField + + TupleGenerator = Generator[Tuple[str, Any], None, None] + DictStrAny = Dict[str, Any] + DictAny = Dict[Any, Any] + SetStr = Set[str] + ListStr = List[str] + IntStr = Union[int, str] + AbstractSetIntStr = AbstractSet[IntStr] + DictIntStrAny = Dict[IntStr, Any] + MappingIntStrAny = Mapping[IntStr, Any] + CallableGenerator = Generator[AnyCallable, None, None] + ReprArgs = Sequence[Tuple[Optional[str], Any]] + + MYPY = False + if MYPY: + AnyClassMethod = classmethod[Any] + else: + # classmethod[TargetType, CallableParamSpecType, CallableReturnType] + AnyClassMethod = classmethod[Any, Any, Any] + +__all__ = ( + 'AnyCallable', + 'NoArgAnyCallable', + 'NoneType', + 'is_none_type', + 'display_as_type', + 'resolve_annotations', + 'is_callable_type', + 'is_literal_type', + 'all_literal_values', + 'is_namedtuple', + 'is_typeddict', + 'is_typeddict_special', + 'is_new_type', + 'new_type_supertype', + 'is_classvar', + 'is_finalvar', + 'update_field_forward_refs', + 'update_model_forward_refs', + 'TupleGenerator', + 'DictStrAny', + 'DictAny', + 'SetStr', + 'ListStr', + 'IntStr', + 'AbstractSetIntStr', + 'DictIntStrAny', + 'CallableGenerator', + 'ReprArgs', + 'AnyClassMethod', + 'CallableGenerator', + 'WithArgsTypes', + 'get_args', + 'get_origin', + 'get_sub_types', + 'typing_base', + 'get_all_type_hints', + 'is_union', + 'StrPath', + 'MappingIntStrAny', +) + + +NoneType = None.__class__ + + +NONE_TYPES: Tuple[Any, Any, Any] = (None, NoneType, Literal[None]) + + +if sys.version_info < (3, 8): + # Even though this implementation is slower, we need it for python 3.7: + # In python 3.7 "Literal" is not a builtin type and uses a different + # mechanism. + # for this reason `Literal[None] is Literal[None]` evaluates to `False`, + # breaking the faster implementation used for the other python versions. + + def is_none_type(type_: Any) -> bool: + return type_ in NONE_TYPES + +elif sys.version_info[:2] == (3, 8): + + def is_none_type(type_: Any) -> bool: + for none_type in NONE_TYPES: + if type_ is none_type: + return True + # With python 3.8, specifically 3.8.10, Literal "is" check sare very flakey + # can change on very subtle changes like use of types in other modules, + # hopefully this check avoids that issue. + if is_literal_type(type_): # pragma: no cover + return all_literal_values(type_) == (None,) + return False + +else: + + def is_none_type(type_: Any) -> bool: + return type_ in NONE_TYPES + + +def display_as_type(v: Type[Any]) -> str: + if not isinstance(v, typing_base) and not isinstance(v, WithArgsTypes) and not isinstance(v, type): + v = v.__class__ + + if is_union(get_origin(v)): + return f'Union[{", ".join(map(display_as_type, get_args(v)))}]' + + if isinstance(v, WithArgsTypes): + # Generic alias are constructs like `list[int]` + return str(v).replace('typing.', '') + + try: + return v.__name__ + except AttributeError: + # happens with typing objects + return str(v).replace('typing.', '') + + +def resolve_annotations(raw_annotations: Dict[str, Type[Any]], module_name: Optional[str]) -> Dict[str, Type[Any]]: + """ + Partially taken from typing.get_type_hints. + + Resolve string or ForwardRef annotations into type objects if possible. + """ + base_globals: Optional[Dict[str, Any]] = None + if module_name: + try: + module = sys.modules[module_name] + except KeyError: + # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363 + pass + else: + base_globals = module.__dict__ + + annotations = {} + for name, value in raw_annotations.items(): + if isinstance(value, str): + if (3, 10) > sys.version_info >= (3, 9, 8) or sys.version_info >= (3, 10, 1): + value = ForwardRef(value, is_argument=False, is_class=True) + else: + value = ForwardRef(value, is_argument=False) + try: + value = _eval_type(value, base_globals, None) + except NameError: + # this is ok, it can be fixed with update_forward_refs + pass + annotations[name] = value + return annotations + + +def is_callable_type(type_: Type[Any]) -> bool: + return type_ is Callable or get_origin(type_) is Callable + + +def is_literal_type(type_: Type[Any]) -> bool: + return Literal is not None and get_origin(type_) in LITERAL_TYPES + + +def literal_values(type_: Type[Any]) -> Tuple[Any, ...]: + return get_args(type_) + + +def all_literal_values(type_: Type[Any]) -> Tuple[Any, ...]: + """ + This method is used to retrieve all Literal values as + Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586) + e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]` + """ + if not is_literal_type(type_): + return (type_,) + + values = literal_values(type_) + return tuple(x for value in values for x in all_literal_values(value)) + + +def is_namedtuple(type_: Type[Any]) -> bool: + """ + Check if a given class is a named tuple. + It can be either a `typing.NamedTuple` or `collections.namedtuple` + """ + from .utils import lenient_issubclass + + return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields') + + +def is_typeddict(type_: Type[Any]) -> bool: + """ + Check if a given class is a typed dict (from `typing` or `typing_extensions`) + In 3.10, there will be a public method (https://docs.python.org/3.10/library/typing.html#typing.is_typeddict) + """ + from .utils import lenient_issubclass + + return lenient_issubclass(type_, dict) and hasattr(type_, '__total__') + + +def _check_typeddict_special(type_: Any) -> bool: + return type_ is TypedDictRequired or type_ is TypedDictNotRequired + + +def is_typeddict_special(type_: Any) -> bool: + """ + Check if type is a TypedDict special form (Required or NotRequired). + """ + return _check_typeddict_special(type_) or _check_typeddict_special(get_origin(type_)) + + +test_type = NewType('test_type', str) + + +def is_new_type(type_: Type[Any]) -> bool: + """ + Check whether type_ was created using typing.NewType + """ + return isinstance(type_, test_type.__class__) and hasattr(type_, '__supertype__') # type: ignore + + +def new_type_supertype(type_: Type[Any]) -> Type[Any]: + while hasattr(type_, '__supertype__'): + type_ = type_.__supertype__ + return type_ + + +def _check_classvar(v: Optional[Type[Any]]) -> bool: + if v is None: + return False + + return v.__class__ == ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar' + + +def _check_finalvar(v: Optional[Type[Any]]) -> bool: + """ + Check if a given type is a `typing.Final` type. + """ + if v is None: + return False + + return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final') + + +def is_classvar(ann_type: Type[Any]) -> bool: + if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)): + return True + + # this is an ugly workaround for class vars that contain forward references and are therefore themselves + # forward references, see #3679 + if ann_type.__class__ == ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['): + return True + + return False + + +def is_finalvar(ann_type: Type[Any]) -> bool: + return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type)) + + +def update_field_forward_refs(field: 'ModelField', globalns: Any, localns: Any) -> None: + """ + Try to update ForwardRefs on fields based on this ModelField, globalns and localns. + """ + prepare = False + if field.type_.__class__ == ForwardRef: + prepare = True + field.type_ = evaluate_forwardref(field.type_, globalns, localns or None) + if field.outer_type_.__class__ == ForwardRef: + prepare = True + field.outer_type_ = evaluate_forwardref(field.outer_type_, globalns, localns or None) + if prepare: + field.prepare() + + if field.sub_fields: + for sub_f in field.sub_fields: + update_field_forward_refs(sub_f, globalns=globalns, localns=localns) + + if field.discriminator_key is not None: + field.prepare_discriminated_union_sub_fields() + + +def update_model_forward_refs( + model: Type[Any], + fields: Iterable['ModelField'], + json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable], + localns: 'DictStrAny', + exc_to_suppress: Tuple[Type[BaseException], ...] = (), +) -> None: + """ + Try to update model fields ForwardRefs based on model and localns. + """ + if model.__module__ in sys.modules: + globalns = sys.modules[model.__module__].__dict__.copy() + else: + globalns = {} + + globalns.setdefault(model.__name__, model) + + for f in fields: + try: + update_field_forward_refs(f, globalns=globalns, localns=localns) + except exc_to_suppress: + pass + + for key in set(json_encoders.keys()): + if isinstance(key, str): + fr: ForwardRef = ForwardRef(key) + elif isinstance(key, ForwardRef): + fr = key + else: + continue + + try: + new_key = evaluate_forwardref(fr, globalns, localns or None) + except exc_to_suppress: # pragma: no cover + continue + + json_encoders[new_key] = json_encoders.pop(key) + + +def get_class(type_: Type[Any]) -> Union[None, bool, Type[Any]]: + """ + Tries to get the class of a Type[T] annotation. Returns True if Type is used + without brackets. Otherwise returns None. + """ + if type_ is type: + return True + + if get_origin(type_) is None: + return None + + args = get_args(type_) + if not args or not isinstance(args[0], type): + return True + else: + return args[0] + + +def get_sub_types(tp: Any) -> List[Any]: + """ + Return all the types that are allowed by type `tp` + `tp` can be a `Union` of allowed types or an `Annotated` type + """ + origin = get_origin(tp) + if origin is Annotated: + return get_sub_types(get_args(tp)[0]) + elif is_union(origin): + return [x for t in get_args(tp) for x in get_sub_types(t)] + else: + return [tp] diff --git a/lib/pydantic/v1/utils.py b/lib/pydantic/v1/utils.py new file mode 100644 index 00000000..4d0f68ed --- /dev/null +++ b/lib/pydantic/v1/utils.py @@ -0,0 +1,803 @@ +import keyword +import warnings +import weakref +from collections import OrderedDict, defaultdict, deque +from copy import deepcopy +from itertools import islice, zip_longest +from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType +from typing import ( + TYPE_CHECKING, + AbstractSet, + Any, + Callable, + Collection, + Dict, + Generator, + Iterable, + Iterator, + List, + Mapping, + NoReturn, + Optional, + Set, + Tuple, + Type, + TypeVar, + Union, +) + +from typing_extensions import Annotated + +from .errors import ConfigError +from .typing import ( + NoneType, + WithArgsTypes, + all_literal_values, + display_as_type, + get_args, + get_origin, + is_literal_type, + is_union, +) +from .version import version_info + +if TYPE_CHECKING: + from inspect import Signature + from pathlib import Path + + from .config import BaseConfig + from .dataclasses import Dataclass + from .fields import ModelField + from .main import BaseModel + from .typing import AbstractSetIntStr, DictIntStrAny, IntStr, MappingIntStrAny, ReprArgs + + RichReprResult = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]] + +__all__ = ( + 'import_string', + 'sequence_like', + 'validate_field_name', + 'lenient_isinstance', + 'lenient_issubclass', + 'in_ipython', + 'is_valid_identifier', + 'deep_update', + 'update_not_none', + 'almost_equal_floats', + 'get_model', + 'to_camel', + 'is_valid_field', + 'smart_deepcopy', + 'PyObjectStr', + 'Representation', + 'GetterDict', + 'ValueItems', + 'version_info', # required here to match behaviour in v1.3 + 'ClassAttribute', + 'path_type', + 'ROOT_KEY', + 'get_unique_discriminator_alias', + 'get_discriminator_alias_and_values', + 'DUNDER_ATTRIBUTES', +) + +ROOT_KEY = '__root__' +# these are types that are returned unchanged by deepcopy +IMMUTABLE_NON_COLLECTIONS_TYPES: Set[Type[Any]] = { + int, + float, + complex, + str, + bool, + bytes, + type, + NoneType, + FunctionType, + BuiltinFunctionType, + LambdaType, + weakref.ref, + CodeType, + # note: including ModuleType will differ from behaviour of deepcopy by not producing error. + # It might be not a good idea in general, but considering that this function used only internally + # against default values of fields, this will allow to actually have a field with module as default value + ModuleType, + NotImplemented.__class__, + Ellipsis.__class__, +} + +# these are types that if empty, might be copied with simple copy() instead of deepcopy() +BUILTIN_COLLECTIONS: Set[Type[Any]] = { + list, + set, + tuple, + frozenset, + dict, + OrderedDict, + defaultdict, + deque, +} + + +def import_string(dotted_path: str) -> Any: + """ + Stolen approximately from django. Import a dotted module path and return the attribute/class designated by the + last name in the path. Raise ImportError if the import fails. + """ + from importlib import import_module + + try: + module_path, class_name = dotted_path.strip(' ').rsplit('.', 1) + except ValueError as e: + raise ImportError(f'"{dotted_path}" doesn\'t look like a module path') from e + + module = import_module(module_path) + try: + return getattr(module, class_name) + except AttributeError as e: + raise ImportError(f'Module "{module_path}" does not define a "{class_name}" attribute') from e + + +def truncate(v: Union[str], *, max_len: int = 80) -> str: + """ + Truncate a value and add a unicode ellipsis (three dots) to the end if it was too long + """ + warnings.warn('`truncate` is no-longer used by pydantic and is deprecated', DeprecationWarning) + if isinstance(v, str) and len(v) > (max_len - 2): + # -3 so quote + string + … + quote has correct length + return (v[: (max_len - 3)] + '…').__repr__() + try: + v = v.__repr__() + except TypeError: + v = v.__class__.__repr__(v) # in case v is a type + if len(v) > max_len: + v = v[: max_len - 1] + '…' + return v + + +def sequence_like(v: Any) -> bool: + return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque)) + + +def validate_field_name(bases: List[Type['BaseModel']], field_name: str) -> None: + """ + Ensure that the field's name does not shadow an existing attribute of the model. + """ + for base in bases: + if getattr(base, field_name, None): + raise NameError( + f'Field name "{field_name}" shadows a BaseModel attribute; ' + f'use a different field name with "alias=\'{field_name}\'".' + ) + + +def lenient_isinstance(o: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool: + try: + return isinstance(o, class_or_tuple) # type: ignore[arg-type] + except TypeError: + return False + + +def lenient_issubclass(cls: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool: + try: + return isinstance(cls, type) and issubclass(cls, class_or_tuple) # type: ignore[arg-type] + except TypeError: + if isinstance(cls, WithArgsTypes): + return False + raise # pragma: no cover + + +def in_ipython() -> bool: + """ + Check whether we're in an ipython environment, including jupyter notebooks. + """ + try: + eval('__IPYTHON__') + except NameError: + return False + else: # pragma: no cover + return True + + +def is_valid_identifier(identifier: str) -> bool: + """ + Checks that a string is a valid identifier and not a Python keyword. + :param identifier: The identifier to test. + :return: True if the identifier is valid. + """ + return identifier.isidentifier() and not keyword.iskeyword(identifier) + + +KeyType = TypeVar('KeyType') + + +def deep_update(mapping: Dict[KeyType, Any], *updating_mappings: Dict[KeyType, Any]) -> Dict[KeyType, Any]: + updated_mapping = mapping.copy() + for updating_mapping in updating_mappings: + for k, v in updating_mapping.items(): + if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict): + updated_mapping[k] = deep_update(updated_mapping[k], v) + else: + updated_mapping[k] = v + return updated_mapping + + +def update_not_none(mapping: Dict[Any, Any], **update: Any) -> None: + mapping.update({k: v for k, v in update.items() if v is not None}) + + +def almost_equal_floats(value_1: float, value_2: float, *, delta: float = 1e-8) -> bool: + """ + Return True if two floats are almost equal + """ + return abs(value_1 - value_2) <= delta + + +def generate_model_signature( + init: Callable[..., None], fields: Dict[str, 'ModelField'], config: Type['BaseConfig'] +) -> 'Signature': + """ + Generate signature for model based on its fields + """ + from inspect import Parameter, Signature, signature + + from .config import Extra + + present_params = signature(init).parameters.values() + merged_params: Dict[str, Parameter] = {} + var_kw = None + use_var_kw = False + + for param in islice(present_params, 1, None): # skip self arg + if param.kind is param.VAR_KEYWORD: + var_kw = param + continue + merged_params[param.name] = param + + if var_kw: # if custom init has no var_kw, fields which are not declared in it cannot be passed through + allow_names = config.allow_population_by_field_name + for field_name, field in fields.items(): + param_name = field.alias + if field_name in merged_params or param_name in merged_params: + continue + elif not is_valid_identifier(param_name): + if allow_names and is_valid_identifier(field_name): + param_name = field_name + else: + use_var_kw = True + continue + + # TODO: replace annotation with actual expected types once #1055 solved + kwargs = {'default': field.default} if not field.required else {} + merged_params[param_name] = Parameter( + param_name, Parameter.KEYWORD_ONLY, annotation=field.annotation, **kwargs + ) + + if config.extra is Extra.allow: + use_var_kw = True + + if var_kw and use_var_kw: + # Make sure the parameter for extra kwargs + # does not have the same name as a field + default_model_signature = [ + ('__pydantic_self__', Parameter.POSITIONAL_OR_KEYWORD), + ('data', Parameter.VAR_KEYWORD), + ] + if [(p.name, p.kind) for p in present_params] == default_model_signature: + # if this is the standard model signature, use extra_data as the extra args name + var_kw_name = 'extra_data' + else: + # else start from var_kw + var_kw_name = var_kw.name + + # generate a name that's definitely unique + while var_kw_name in fields: + var_kw_name += '_' + merged_params[var_kw_name] = var_kw.replace(name=var_kw_name) + + return Signature(parameters=list(merged_params.values()), return_annotation=None) + + +def get_model(obj: Union[Type['BaseModel'], Type['Dataclass']]) -> Type['BaseModel']: + from .main import BaseModel + + try: + model_cls = obj.__pydantic_model__ # type: ignore + except AttributeError: + model_cls = obj + + if not issubclass(model_cls, BaseModel): + raise TypeError('Unsupported type, must be either BaseModel or dataclass') + return model_cls + + +def to_camel(string: str) -> str: + return ''.join(word.capitalize() for word in string.split('_')) + + +def to_lower_camel(string: str) -> str: + if len(string) >= 1: + pascal_string = to_camel(string) + return pascal_string[0].lower() + pascal_string[1:] + return string.lower() + + +T = TypeVar('T') + + +def unique_list( + input_list: Union[List[T], Tuple[T, ...]], + *, + name_factory: Callable[[T], str] = str, +) -> List[T]: + """ + Make a list unique while maintaining order. + We update the list if another one with the same name is set + (e.g. root validator overridden in subclass) + """ + result: List[T] = [] + result_names: List[str] = [] + for v in input_list: + v_name = name_factory(v) + if v_name not in result_names: + result_names.append(v_name) + result.append(v) + else: + result[result_names.index(v_name)] = v + + return result + + +class PyObjectStr(str): + """ + String class where repr doesn't include quotes. Useful with Representation when you want to return a string + representation of something that valid (or pseudo-valid) python. + """ + + def __repr__(self) -> str: + return str(self) + + +class Representation: + """ + Mixin to provide __str__, __repr__, and __pretty__ methods. See #884 for more details. + + __pretty__ is used by [devtools](https://python-devtools.helpmanual.io/) to provide human readable representations + of objects. + """ + + __slots__: Tuple[str, ...] = tuple() + + def __repr_args__(self) -> 'ReprArgs': + """ + Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden. + + Can either return: + * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]` + * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]` + """ + attrs = ((s, getattr(self, s)) for s in self.__slots__) + return [(a, v) for a, v in attrs if v is not None] + + def __repr_name__(self) -> str: + """ + Name of the instance's class, used in __repr__. + """ + return self.__class__.__name__ + + def __repr_str__(self, join_str: str) -> str: + return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__()) + + def __pretty__(self, fmt: Callable[[Any], Any], **kwargs: Any) -> Generator[Any, None, None]: + """ + Used by devtools (https://python-devtools.helpmanual.io/) to provide a human readable representations of objects + """ + yield self.__repr_name__() + '(' + yield 1 + for name, value in self.__repr_args__(): + if name is not None: + yield name + '=' + yield fmt(value) + yield ',' + yield 0 + yield -1 + yield ')' + + def __str__(self) -> str: + return self.__repr_str__(' ') + + def __repr__(self) -> str: + return f'{self.__repr_name__()}({self.__repr_str__(", ")})' + + def __rich_repr__(self) -> 'RichReprResult': + """Get fields for Rich library""" + for name, field_repr in self.__repr_args__(): + if name is None: + yield field_repr + else: + yield name, field_repr + + +class GetterDict(Representation): + """ + Hack to make object's smell just enough like dicts for validate_model. + + We can't inherit from Mapping[str, Any] because it upsets cython so we have to implement all methods ourselves. + """ + + __slots__ = ('_obj',) + + def __init__(self, obj: Any): + self._obj = obj + + def __getitem__(self, key: str) -> Any: + try: + return getattr(self._obj, key) + except AttributeError as e: + raise KeyError(key) from e + + def get(self, key: Any, default: Any = None) -> Any: + return getattr(self._obj, key, default) + + def extra_keys(self) -> Set[Any]: + """ + We don't want to get any other attributes of obj if the model didn't explicitly ask for them + """ + return set() + + def keys(self) -> List[Any]: + """ + Keys of the pseudo dictionary, uses a list not set so order information can be maintained like python + dictionaries. + """ + return list(self) + + def values(self) -> List[Any]: + return [self[k] for k in self] + + def items(self) -> Iterator[Tuple[str, Any]]: + for k in self: + yield k, self.get(k) + + def __iter__(self) -> Iterator[str]: + for name in dir(self._obj): + if not name.startswith('_'): + yield name + + def __len__(self) -> int: + return sum(1 for _ in self) + + def __contains__(self, item: Any) -> bool: + return item in self.keys() + + def __eq__(self, other: Any) -> bool: + return dict(self) == dict(other.items()) + + def __repr_args__(self) -> 'ReprArgs': + return [(None, dict(self))] + + def __repr_name__(self) -> str: + return f'GetterDict[{display_as_type(self._obj)}]' + + +class ValueItems(Representation): + """ + Class for more convenient calculation of excluded or included fields on values. + """ + + __slots__ = ('_items', '_type') + + def __init__(self, value: Any, items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> None: + items = self._coerce_items(items) + + if isinstance(value, (list, tuple)): + items = self._normalize_indexes(items, len(value)) + + self._items: 'MappingIntStrAny' = items + + def is_excluded(self, item: Any) -> bool: + """ + Check if item is fully excluded. + + :param item: key or index of a value + """ + return self.is_true(self._items.get(item)) + + def is_included(self, item: Any) -> bool: + """ + Check if value is contained in self._items + + :param item: key or index of value + """ + return item in self._items + + def for_element(self, e: 'IntStr') -> Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']]: + """ + :param e: key or index of element on value + :return: raw values for element if self._items is dict and contain needed element + """ + + item = self._items.get(e) + return item if not self.is_true(item) else None + + def _normalize_indexes(self, items: 'MappingIntStrAny', v_length: int) -> 'DictIntStrAny': + """ + :param items: dict or set of indexes which will be normalized + :param v_length: length of sequence indexes of which will be + + >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4) + {0: True, 2: True, 3: True} + >>> self._normalize_indexes({'__all__': True}, 4) + {0: True, 1: True, 2: True, 3: True} + """ + + normalized_items: 'DictIntStrAny' = {} + all_items = None + for i, v in items.items(): + if not (isinstance(v, Mapping) or isinstance(v, AbstractSet) or self.is_true(v)): + raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}') + if i == '__all__': + all_items = self._coerce_value(v) + continue + if not isinstance(i, int): + raise TypeError( + 'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: ' + 'expected integer keys or keyword "__all__"' + ) + normalized_i = v_length + i if i < 0 else i + normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i)) + + if not all_items: + return normalized_items + if self.is_true(all_items): + for i in range(v_length): + normalized_items.setdefault(i, ...) + return normalized_items + for i in range(v_length): + normalized_item = normalized_items.setdefault(i, {}) + if not self.is_true(normalized_item): + normalized_items[i] = self.merge(all_items, normalized_item) + return normalized_items + + @classmethod + def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any: + """ + Merge a ``base`` item with an ``override`` item. + + Both ``base`` and ``override`` are converted to dictionaries if possible. + Sets are converted to dictionaries with the sets entries as keys and + Ellipsis as values. + + Each key-value pair existing in ``base`` is merged with ``override``, + while the rest of the key-value pairs are updated recursively with this function. + + Merging takes place based on the "union" of keys if ``intersect`` is + set to ``False`` (default) and on the intersection of keys if + ``intersect`` is set to ``True``. + """ + override = cls._coerce_value(override) + base = cls._coerce_value(base) + if override is None: + return base + if cls.is_true(base) or base is None: + return override + if cls.is_true(override): + return base if intersect else override + + # intersection or union of keys while preserving ordering: + if intersect: + merge_keys = [k for k in base if k in override] + [k for k in override if k in base] + else: + merge_keys = list(base) + [k for k in override if k not in base] + + merged: 'DictIntStrAny' = {} + for k in merge_keys: + merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect) + if merged_item is not None: + merged[k] = merged_item + + return merged + + @staticmethod + def _coerce_items(items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> 'MappingIntStrAny': + if isinstance(items, Mapping): + pass + elif isinstance(items, AbstractSet): + items = dict.fromkeys(items, ...) + else: + class_name = getattr(items, '__class__', '???') + assert_never( + items, + f'Unexpected type of exclude value {class_name}', + ) + return items + + @classmethod + def _coerce_value(cls, value: Any) -> Any: + if value is None or cls.is_true(value): + return value + return cls._coerce_items(value) + + @staticmethod + def is_true(v: Any) -> bool: + return v is True or v is ... + + def __repr_args__(self) -> 'ReprArgs': + return [(None, self._items)] + + +class ClassAttribute: + """ + Hide class attribute from its instances + """ + + __slots__ = ( + 'name', + 'value', + ) + + def __init__(self, name: str, value: Any) -> None: + self.name = name + self.value = value + + def __get__(self, instance: Any, owner: Type[Any]) -> None: + if instance is None: + return self.value + raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only') + + +path_types = { + 'is_dir': 'directory', + 'is_file': 'file', + 'is_mount': 'mount point', + 'is_symlink': 'symlink', + 'is_block_device': 'block device', + 'is_char_device': 'char device', + 'is_fifo': 'FIFO', + 'is_socket': 'socket', +} + + +def path_type(p: 'Path') -> str: + """ + Find out what sort of thing a path is. + """ + assert p.exists(), 'path does not exist' + for method, name in path_types.items(): + if getattr(p, method)(): + return name + + return 'unknown' + + +Obj = TypeVar('Obj') + + +def smart_deepcopy(obj: Obj) -> Obj: + """ + Return type as is for immutable built-in types + Use obj.copy() for built-in empty collections + Use copy.deepcopy() for non-empty collections and unknown objects + """ + + obj_type = obj.__class__ + if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES: + return obj # fastest case: obj is immutable and not collection therefore will not be copied anyway + try: + if not obj and obj_type in BUILTIN_COLLECTIONS: + # faster way for empty collections, no need to copy its members + return obj if obj_type is tuple else obj.copy() # type: ignore # tuple doesn't have copy method + except (TypeError, ValueError, RuntimeError): + # do we really dare to catch ALL errors? Seems a bit risky + pass + + return deepcopy(obj) # slowest way when we actually might need a deepcopy + + +def is_valid_field(name: str) -> bool: + if not name.startswith('_'): + return True + return ROOT_KEY == name + + +DUNDER_ATTRIBUTES = { + '__annotations__', + '__classcell__', + '__doc__', + '__module__', + '__orig_bases__', + '__orig_class__', + '__qualname__', +} + + +def is_valid_private_name(name: str) -> bool: + return not is_valid_field(name) and name not in DUNDER_ATTRIBUTES + + +_EMPTY = object() + + +def all_identical(left: Iterable[Any], right: Iterable[Any]) -> bool: + """ + Check that the items of `left` are the same objects as those in `right`. + + >>> a, b = object(), object() + >>> all_identical([a, b, a], [a, b, a]) + True + >>> all_identical([a, b, [a]], [a, b, [a]]) # new list object, while "equal" is not "identical" + False + """ + for left_item, right_item in zip_longest(left, right, fillvalue=_EMPTY): + if left_item is not right_item: + return False + return True + + +def assert_never(obj: NoReturn, msg: str) -> NoReturn: + """ + Helper to make sure that we have covered all possible types. + + This is mostly useful for ``mypy``, docs: + https://mypy.readthedocs.io/en/latest/literal_types.html#exhaustive-checks + """ + raise TypeError(msg) + + +def get_unique_discriminator_alias(all_aliases: Collection[str], discriminator_key: str) -> str: + """Validate that all aliases are the same and if that's the case return the alias""" + unique_aliases = set(all_aliases) + if len(unique_aliases) > 1: + raise ConfigError( + f'Aliases for discriminator {discriminator_key!r} must be the same (got {", ".join(sorted(all_aliases))})' + ) + return unique_aliases.pop() + + +def get_discriminator_alias_and_values(tp: Any, discriminator_key: str) -> Tuple[str, Tuple[str, ...]]: + """ + Get alias and all valid values in the `Literal` type of the discriminator field + `tp` can be a `BaseModel` class or directly an `Annotated` `Union` of many. + """ + is_root_model = getattr(tp, '__custom_root_type__', False) + + if get_origin(tp) is Annotated: + tp = get_args(tp)[0] + + if hasattr(tp, '__pydantic_model__'): + tp = tp.__pydantic_model__ + + if is_union(get_origin(tp)): + alias, all_values = _get_union_alias_and_all_values(tp, discriminator_key) + return alias, tuple(v for values in all_values for v in values) + elif is_root_model: + union_type = tp.__fields__[ROOT_KEY].type_ + alias, all_values = _get_union_alias_and_all_values(union_type, discriminator_key) + + if len(set(all_values)) > 1: + raise ConfigError( + f'Field {discriminator_key!r} is not the same for all submodels of {display_as_type(tp)!r}' + ) + + return alias, all_values[0] + + else: + try: + t_discriminator_type = tp.__fields__[discriminator_key].type_ + except AttributeError as e: + raise TypeError(f'Type {tp.__name__!r} is not a valid `BaseModel` or `dataclass`') from e + except KeyError as e: + raise ConfigError(f'Model {tp.__name__!r} needs a discriminator field for key {discriminator_key!r}') from e + + if not is_literal_type(t_discriminator_type): + raise ConfigError(f'Field {discriminator_key!r} of model {tp.__name__!r} needs to be a `Literal`') + + return tp.__fields__[discriminator_key].alias, all_literal_values(t_discriminator_type) + + +def _get_union_alias_and_all_values( + union_type: Type[Any], discriminator_key: str +) -> Tuple[str, Tuple[Tuple[str, ...], ...]]: + zipped_aliases_values = [get_discriminator_alias_and_values(t, discriminator_key) for t in get_args(union_type)] + # unzip: [('alias_a',('v1', 'v2)), ('alias_b', ('v3',))] => [('alias_a', 'alias_b'), (('v1', 'v2'), ('v3',))] + all_aliases, all_values = zip(*zipped_aliases_values) + return get_unique_discriminator_alias(all_aliases, discriminator_key), all_values diff --git a/lib/pydantic/v1/validators.py b/lib/pydantic/v1/validators.py new file mode 100644 index 00000000..549a235e --- /dev/null +++ b/lib/pydantic/v1/validators.py @@ -0,0 +1,765 @@ +import math +import re +from collections import OrderedDict, deque +from collections.abc import Hashable as CollectionsHashable +from datetime import date, datetime, time, timedelta +from decimal import Decimal, DecimalException +from enum import Enum, IntEnum +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from pathlib import Path +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Deque, + Dict, + ForwardRef, + FrozenSet, + Generator, + Hashable, + List, + NamedTuple, + Pattern, + Set, + Tuple, + Type, + TypeVar, + Union, +) +from uuid import UUID + +from . import errors +from .datetime_parse import parse_date, parse_datetime, parse_duration, parse_time +from .typing import ( + AnyCallable, + all_literal_values, + display_as_type, + get_class, + is_callable_type, + is_literal_type, + is_namedtuple, + is_none_type, + is_typeddict, +) +from .utils import almost_equal_floats, lenient_issubclass, sequence_like + +if TYPE_CHECKING: + from typing_extensions import Literal, TypedDict + + from .config import BaseConfig + from .fields import ModelField + from .types import ConstrainedDecimal, ConstrainedFloat, ConstrainedInt + + ConstrainedNumber = Union[ConstrainedDecimal, ConstrainedFloat, ConstrainedInt] + AnyOrderedDict = OrderedDict[Any, Any] + Number = Union[int, float, Decimal] + StrBytes = Union[str, bytes] + + +def str_validator(v: Any) -> Union[str]: + if isinstance(v, str): + if isinstance(v, Enum): + return v.value + else: + return v + elif isinstance(v, (float, int, Decimal)): + # is there anything else we want to add here? If you think so, create an issue. + return str(v) + elif isinstance(v, (bytes, bytearray)): + return v.decode() + else: + raise errors.StrError() + + +def strict_str_validator(v: Any) -> Union[str]: + if isinstance(v, str) and not isinstance(v, Enum): + return v + raise errors.StrError() + + +def bytes_validator(v: Any) -> Union[bytes]: + if isinstance(v, bytes): + return v + elif isinstance(v, bytearray): + return bytes(v) + elif isinstance(v, str): + return v.encode() + elif isinstance(v, (float, int, Decimal)): + return str(v).encode() + else: + raise errors.BytesError() + + +def strict_bytes_validator(v: Any) -> Union[bytes]: + if isinstance(v, bytes): + return v + elif isinstance(v, bytearray): + return bytes(v) + else: + raise errors.BytesError() + + +BOOL_FALSE = {0, '0', 'off', 'f', 'false', 'n', 'no'} +BOOL_TRUE = {1, '1', 'on', 't', 'true', 'y', 'yes'} + + +def bool_validator(v: Any) -> bool: + if v is True or v is False: + return v + if isinstance(v, bytes): + v = v.decode() + if isinstance(v, str): + v = v.lower() + try: + if v in BOOL_TRUE: + return True + if v in BOOL_FALSE: + return False + except TypeError: + raise errors.BoolError() + raise errors.BoolError() + + +# matches the default limit cpython, see https://github.com/python/cpython/pull/96500 +max_str_int = 4_300 + + +def int_validator(v: Any) -> int: + if isinstance(v, int) and not (v is True or v is False): + return v + + # see https://github.com/pydantic/pydantic/issues/1477 and in turn, https://github.com/python/cpython/issues/95778 + # this check should be unnecessary once patch releases are out for 3.7, 3.8, 3.9 and 3.10 + # but better to check here until then. + # NOTICE: this does not fully protect user from the DOS risk since the standard library JSON implementation + # (and other std lib modules like xml) use `int()` and are likely called before this, the best workaround is to + # 1. update to the latest patch release of python once released, 2. use a different JSON library like ujson + if isinstance(v, (str, bytes, bytearray)) and len(v) > max_str_int: + raise errors.IntegerError() + + try: + return int(v) + except (TypeError, ValueError, OverflowError): + raise errors.IntegerError() + + +def strict_int_validator(v: Any) -> int: + if isinstance(v, int) and not (v is True or v is False): + return v + raise errors.IntegerError() + + +def float_validator(v: Any) -> float: + if isinstance(v, float): + return v + + try: + return float(v) + except (TypeError, ValueError): + raise errors.FloatError() + + +def strict_float_validator(v: Any) -> float: + if isinstance(v, float): + return v + raise errors.FloatError() + + +def float_finite_validator(v: 'Number', field: 'ModelField', config: 'BaseConfig') -> 'Number': + allow_inf_nan = getattr(field.type_, 'allow_inf_nan', None) + if allow_inf_nan is None: + allow_inf_nan = config.allow_inf_nan + + if allow_inf_nan is False and (math.isnan(v) or math.isinf(v)): + raise errors.NumberNotFiniteError() + return v + + +def number_multiple_validator(v: 'Number', field: 'ModelField') -> 'Number': + field_type: ConstrainedNumber = field.type_ + if field_type.multiple_of is not None: + mod = float(v) / float(field_type.multiple_of) % 1 + if not almost_equal_floats(mod, 0.0) and not almost_equal_floats(mod, 1.0): + raise errors.NumberNotMultipleError(multiple_of=field_type.multiple_of) + return v + + +def number_size_validator(v: 'Number', field: 'ModelField') -> 'Number': + field_type: ConstrainedNumber = field.type_ + if field_type.gt is not None and not v > field_type.gt: + raise errors.NumberNotGtError(limit_value=field_type.gt) + elif field_type.ge is not None and not v >= field_type.ge: + raise errors.NumberNotGeError(limit_value=field_type.ge) + + if field_type.lt is not None and not v < field_type.lt: + raise errors.NumberNotLtError(limit_value=field_type.lt) + if field_type.le is not None and not v <= field_type.le: + raise errors.NumberNotLeError(limit_value=field_type.le) + + return v + + +def constant_validator(v: 'Any', field: 'ModelField') -> 'Any': + """Validate ``const`` fields. + + The value provided for a ``const`` field must be equal to the default value + of the field. This is to support the keyword of the same name in JSON + Schema. + """ + if v != field.default: + raise errors.WrongConstantError(given=v, permitted=[field.default]) + + return v + + +def anystr_length_validator(v: 'StrBytes', config: 'BaseConfig') -> 'StrBytes': + v_len = len(v) + + min_length = config.min_anystr_length + if v_len < min_length: + raise errors.AnyStrMinLengthError(limit_value=min_length) + + max_length = config.max_anystr_length + if max_length is not None and v_len > max_length: + raise errors.AnyStrMaxLengthError(limit_value=max_length) + + return v + + +def anystr_strip_whitespace(v: 'StrBytes') -> 'StrBytes': + return v.strip() + + +def anystr_upper(v: 'StrBytes') -> 'StrBytes': + return v.upper() + + +def anystr_lower(v: 'StrBytes') -> 'StrBytes': + return v.lower() + + +def ordered_dict_validator(v: Any) -> 'AnyOrderedDict': + if isinstance(v, OrderedDict): + return v + + try: + return OrderedDict(v) + except (TypeError, ValueError): + raise errors.DictError() + + +def dict_validator(v: Any) -> Dict[Any, Any]: + if isinstance(v, dict): + return v + + try: + return dict(v) + except (TypeError, ValueError): + raise errors.DictError() + + +def list_validator(v: Any) -> List[Any]: + if isinstance(v, list): + return v + elif sequence_like(v): + return list(v) + else: + raise errors.ListError() + + +def tuple_validator(v: Any) -> Tuple[Any, ...]: + if isinstance(v, tuple): + return v + elif sequence_like(v): + return tuple(v) + else: + raise errors.TupleError() + + +def set_validator(v: Any) -> Set[Any]: + if isinstance(v, set): + return v + elif sequence_like(v): + return set(v) + else: + raise errors.SetError() + + +def frozenset_validator(v: Any) -> FrozenSet[Any]: + if isinstance(v, frozenset): + return v + elif sequence_like(v): + return frozenset(v) + else: + raise errors.FrozenSetError() + + +def deque_validator(v: Any) -> Deque[Any]: + if isinstance(v, deque): + return v + elif sequence_like(v): + return deque(v) + else: + raise errors.DequeError() + + +def enum_member_validator(v: Any, field: 'ModelField', config: 'BaseConfig') -> Enum: + try: + enum_v = field.type_(v) + except ValueError: + # field.type_ should be an enum, so will be iterable + raise errors.EnumMemberError(enum_values=list(field.type_)) + return enum_v.value if config.use_enum_values else enum_v + + +def uuid_validator(v: Any, field: 'ModelField') -> UUID: + try: + if isinstance(v, str): + v = UUID(v) + elif isinstance(v, (bytes, bytearray)): + try: + v = UUID(v.decode()) + except ValueError: + # 16 bytes in big-endian order as the bytes argument fail + # the above check + v = UUID(bytes=v) + except ValueError: + raise errors.UUIDError() + + if not isinstance(v, UUID): + raise errors.UUIDError() + + required_version = getattr(field.type_, '_required_version', None) + if required_version and v.version != required_version: + raise errors.UUIDVersionError(required_version=required_version) + + return v + + +def decimal_validator(v: Any) -> Decimal: + if isinstance(v, Decimal): + return v + elif isinstance(v, (bytes, bytearray)): + v = v.decode() + + v = str(v).strip() + + try: + v = Decimal(v) + except DecimalException: + raise errors.DecimalError() + + if not v.is_finite(): + raise errors.DecimalIsNotFiniteError() + + return v + + +def hashable_validator(v: Any) -> Hashable: + if isinstance(v, Hashable): + return v + + raise errors.HashableError() + + +def ip_v4_address_validator(v: Any) -> IPv4Address: + if isinstance(v, IPv4Address): + return v + + try: + return IPv4Address(v) + except ValueError: + raise errors.IPv4AddressError() + + +def ip_v6_address_validator(v: Any) -> IPv6Address: + if isinstance(v, IPv6Address): + return v + + try: + return IPv6Address(v) + except ValueError: + raise errors.IPv6AddressError() + + +def ip_v4_network_validator(v: Any) -> IPv4Network: + """ + Assume IPv4Network initialised with a default ``strict`` argument + + See more: + https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network + """ + if isinstance(v, IPv4Network): + return v + + try: + return IPv4Network(v) + except ValueError: + raise errors.IPv4NetworkError() + + +def ip_v6_network_validator(v: Any) -> IPv6Network: + """ + Assume IPv6Network initialised with a default ``strict`` argument + + See more: + https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network + """ + if isinstance(v, IPv6Network): + return v + + try: + return IPv6Network(v) + except ValueError: + raise errors.IPv6NetworkError() + + +def ip_v4_interface_validator(v: Any) -> IPv4Interface: + if isinstance(v, IPv4Interface): + return v + + try: + return IPv4Interface(v) + except ValueError: + raise errors.IPv4InterfaceError() + + +def ip_v6_interface_validator(v: Any) -> IPv6Interface: + if isinstance(v, IPv6Interface): + return v + + try: + return IPv6Interface(v) + except ValueError: + raise errors.IPv6InterfaceError() + + +def path_validator(v: Any) -> Path: + if isinstance(v, Path): + return v + + try: + return Path(v) + except TypeError: + raise errors.PathError() + + +def path_exists_validator(v: Any) -> Path: + if not v.exists(): + raise errors.PathNotExistsError(path=v) + + return v + + +def callable_validator(v: Any) -> AnyCallable: + """ + Perform a simple check if the value is callable. + + Note: complete matching of argument type hints and return types is not performed + """ + if callable(v): + return v + + raise errors.CallableError(value=v) + + +def enum_validator(v: Any) -> Enum: + if isinstance(v, Enum): + return v + + raise errors.EnumError(value=v) + + +def int_enum_validator(v: Any) -> IntEnum: + if isinstance(v, IntEnum): + return v + + raise errors.IntEnumError(value=v) + + +def make_literal_validator(type_: Any) -> Callable[[Any], Any]: + permitted_choices = all_literal_values(type_) + + # To have a O(1) complexity and still return one of the values set inside the `Literal`, + # we create a dict with the set values (a set causes some problems with the way intersection works). + # In some cases the set value and checked value can indeed be different (see `test_literal_validator_str_enum`) + allowed_choices = {v: v for v in permitted_choices} + + def literal_validator(v: Any) -> Any: + try: + return allowed_choices[v] + except (KeyError, TypeError): + raise errors.WrongConstantError(given=v, permitted=permitted_choices) + + return literal_validator + + +def constr_length_validator(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes': + v_len = len(v) + + min_length = field.type_.min_length if field.type_.min_length is not None else config.min_anystr_length + if v_len < min_length: + raise errors.AnyStrMinLengthError(limit_value=min_length) + + max_length = field.type_.max_length if field.type_.max_length is not None else config.max_anystr_length + if max_length is not None and v_len > max_length: + raise errors.AnyStrMaxLengthError(limit_value=max_length) + + return v + + +def constr_strip_whitespace(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes': + strip_whitespace = field.type_.strip_whitespace or config.anystr_strip_whitespace + if strip_whitespace: + v = v.strip() + + return v + + +def constr_upper(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes': + upper = field.type_.to_upper or config.anystr_upper + if upper: + v = v.upper() + + return v + + +def constr_lower(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes': + lower = field.type_.to_lower or config.anystr_lower + if lower: + v = v.lower() + return v + + +def validate_json(v: Any, config: 'BaseConfig') -> Any: + if v is None: + # pass None through to other validators + return v + try: + return config.json_loads(v) # type: ignore + except ValueError: + raise errors.JsonError() + except TypeError: + raise errors.JsonTypeError() + + +T = TypeVar('T') + + +def make_arbitrary_type_validator(type_: Type[T]) -> Callable[[T], T]: + def arbitrary_type_validator(v: Any) -> T: + if isinstance(v, type_): + return v + raise errors.ArbitraryTypeError(expected_arbitrary_type=type_) + + return arbitrary_type_validator + + +def make_class_validator(type_: Type[T]) -> Callable[[Any], Type[T]]: + def class_validator(v: Any) -> Type[T]: + if lenient_issubclass(v, type_): + return v + raise errors.SubclassError(expected_class=type_) + + return class_validator + + +def any_class_validator(v: Any) -> Type[T]: + if isinstance(v, type): + return v + raise errors.ClassError() + + +def none_validator(v: Any) -> 'Literal[None]': + if v is None: + return v + raise errors.NotNoneError() + + +def pattern_validator(v: Any) -> Pattern[str]: + if isinstance(v, Pattern): + return v + + str_value = str_validator(v) + + try: + return re.compile(str_value) + except re.error: + raise errors.PatternError() + + +NamedTupleT = TypeVar('NamedTupleT', bound=NamedTuple) + + +def make_namedtuple_validator( + namedtuple_cls: Type[NamedTupleT], config: Type['BaseConfig'] +) -> Callable[[Tuple[Any, ...]], NamedTupleT]: + from .annotated_types import create_model_from_namedtuple + + NamedTupleModel = create_model_from_namedtuple( + namedtuple_cls, + __config__=config, + __module__=namedtuple_cls.__module__, + ) + namedtuple_cls.__pydantic_model__ = NamedTupleModel # type: ignore[attr-defined] + + def namedtuple_validator(values: Tuple[Any, ...]) -> NamedTupleT: + annotations = NamedTupleModel.__annotations__ + + if len(values) > len(annotations): + raise errors.ListMaxLengthError(limit_value=len(annotations)) + + dict_values: Dict[str, Any] = dict(zip(annotations, values)) + validated_dict_values: Dict[str, Any] = dict(NamedTupleModel(**dict_values)) + return namedtuple_cls(**validated_dict_values) + + return namedtuple_validator + + +def make_typeddict_validator( + typeddict_cls: Type['TypedDict'], config: Type['BaseConfig'] # type: ignore[valid-type] +) -> Callable[[Any], Dict[str, Any]]: + from .annotated_types import create_model_from_typeddict + + TypedDictModel = create_model_from_typeddict( + typeddict_cls, + __config__=config, + __module__=typeddict_cls.__module__, + ) + typeddict_cls.__pydantic_model__ = TypedDictModel # type: ignore[attr-defined] + + def typeddict_validator(values: 'TypedDict') -> Dict[str, Any]: # type: ignore[valid-type] + return TypedDictModel.parse_obj(values).dict(exclude_unset=True) + + return typeddict_validator + + +class IfConfig: + def __init__(self, validator: AnyCallable, *config_attr_names: str, ignored_value: Any = False) -> None: + self.validator = validator + self.config_attr_names = config_attr_names + self.ignored_value = ignored_value + + def check(self, config: Type['BaseConfig']) -> bool: + return any(getattr(config, name) not in {None, self.ignored_value} for name in self.config_attr_names) + + +# order is important here, for example: bool is a subclass of int so has to come first, datetime before date same, +# IPv4Interface before IPv4Address, etc +_VALIDATORS: List[Tuple[Type[Any], List[Any]]] = [ + (IntEnum, [int_validator, enum_member_validator]), + (Enum, [enum_member_validator]), + ( + str, + [ + str_validator, + IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'), + IfConfig(anystr_upper, 'anystr_upper'), + IfConfig(anystr_lower, 'anystr_lower'), + IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'), + ], + ), + ( + bytes, + [ + bytes_validator, + IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'), + IfConfig(anystr_upper, 'anystr_upper'), + IfConfig(anystr_lower, 'anystr_lower'), + IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'), + ], + ), + (bool, [bool_validator]), + (int, [int_validator]), + (float, [float_validator, IfConfig(float_finite_validator, 'allow_inf_nan', ignored_value=True)]), + (Path, [path_validator]), + (datetime, [parse_datetime]), + (date, [parse_date]), + (time, [parse_time]), + (timedelta, [parse_duration]), + (OrderedDict, [ordered_dict_validator]), + (dict, [dict_validator]), + (list, [list_validator]), + (tuple, [tuple_validator]), + (set, [set_validator]), + (frozenset, [frozenset_validator]), + (deque, [deque_validator]), + (UUID, [uuid_validator]), + (Decimal, [decimal_validator]), + (IPv4Interface, [ip_v4_interface_validator]), + (IPv6Interface, [ip_v6_interface_validator]), + (IPv4Address, [ip_v4_address_validator]), + (IPv6Address, [ip_v6_address_validator]), + (IPv4Network, [ip_v4_network_validator]), + (IPv6Network, [ip_v6_network_validator]), +] + + +def find_validators( # noqa: C901 (ignore complexity) + type_: Type[Any], config: Type['BaseConfig'] +) -> Generator[AnyCallable, None, None]: + from .dataclasses import is_builtin_dataclass, make_dataclass_validator + + if type_ is Any or type_ is object: + return + type_type = type_.__class__ + if type_type == ForwardRef or type_type == TypeVar: + return + + if is_none_type(type_): + yield none_validator + return + if type_ is Pattern or type_ is re.Pattern: + yield pattern_validator + return + if type_ is Hashable or type_ is CollectionsHashable: + yield hashable_validator + return + if is_callable_type(type_): + yield callable_validator + return + if is_literal_type(type_): + yield make_literal_validator(type_) + return + if is_builtin_dataclass(type_): + yield from make_dataclass_validator(type_, config) + return + if type_ is Enum: + yield enum_validator + return + if type_ is IntEnum: + yield int_enum_validator + return + if is_namedtuple(type_): + yield tuple_validator + yield make_namedtuple_validator(type_, config) + return + if is_typeddict(type_): + yield make_typeddict_validator(type_, config) + return + + class_ = get_class(type_) + if class_ is not None: + if class_ is not Any and isinstance(class_, type): + yield make_class_validator(class_) + else: + yield any_class_validator + return + + for val_type, validators in _VALIDATORS: + try: + if issubclass(type_, val_type): + for v in validators: + if isinstance(v, IfConfig): + if v.check(config): + yield v.validator + else: + yield v + return + except TypeError: + raise RuntimeError(f'error checking inheritance of {type_!r} (type: {display_as_type(type_)})') + + if config.arbitrary_types_allowed: + yield make_arbitrary_type_validator(type_) + else: + raise RuntimeError(f'no validator found for {type_}, see `arbitrary_types_allowed` in Config') diff --git a/lib/pydantic/v1/version.py b/lib/pydantic/v1/version.py new file mode 100644 index 00000000..ec982ba7 --- /dev/null +++ b/lib/pydantic/v1/version.py @@ -0,0 +1,38 @@ +__all__ = 'compiled', 'VERSION', 'version_info' + +VERSION = '1.10.14' + +try: + import cython # type: ignore +except ImportError: + compiled: bool = False +else: # pragma: no cover + try: + compiled = cython.compiled + except AttributeError: + compiled = False + + +def version_info() -> str: + import platform + import sys + from importlib import import_module + from pathlib import Path + + optional_deps = [] + for p in ('devtools', 'dotenv', 'email-validator', 'typing-extensions'): + try: + import_module(p.replace('-', '_')) + except ImportError: + continue + optional_deps.append(p) + + info = { + 'pydantic version': VERSION, + 'pydantic compiled': compiled, + 'install path': Path(__file__).resolve().parent, + 'python version': sys.version, + 'platform': platform.platform(), + 'optional deps. installed': optional_deps, + } + return '\n'.join('{:>30} {}'.format(k + ':', str(v).replace('\n', ' ')) for k, v in info.items()) diff --git a/lib/pydantic/validate_call_decorator.py b/lib/pydantic/validate_call_decorator.py new file mode 100644 index 00000000..b95fa3b6 --- /dev/null +++ b/lib/pydantic/validate_call_decorator.py @@ -0,0 +1,67 @@ +"""Decorator for validating function calls.""" +from __future__ import annotations as _annotations + +import functools +from typing import TYPE_CHECKING, Any, Callable, TypeVar, overload + +from ._internal import _validate_call + +__all__ = ('validate_call',) + +if TYPE_CHECKING: + from .config import ConfigDict + + AnyCallableT = TypeVar('AnyCallableT', bound=Callable[..., Any]) + + +@overload +def validate_call( + *, config: ConfigDict | None = None, validate_return: bool = False +) -> Callable[[AnyCallableT], AnyCallableT]: + ... + + +@overload +def validate_call(__func: AnyCallableT) -> AnyCallableT: + ... + + +def validate_call( + __func: AnyCallableT | None = None, + *, + config: ConfigDict | None = None, + validate_return: bool = False, +) -> AnyCallableT | Callable[[AnyCallableT], AnyCallableT]: + """Usage docs: https://docs.pydantic.dev/2.6/concepts/validation_decorator/ + + Returns a decorated wrapper around the function that validates the arguments and, optionally, the return value. + + Usage may be either as a plain decorator `@validate_call` or with arguments `@validate_call(...)`. + + Args: + __func: The function to be decorated. + config: The configuration dictionary. + validate_return: Whether to validate the return value. + + Returns: + The decorated function. + """ + + def validate(function: AnyCallableT) -> AnyCallableT: + if isinstance(function, (classmethod, staticmethod)): + name = type(function).__name__ + raise TypeError(f'The `@{name}` decorator should be applied after `@validate_call` (put `@{name}` on top)') + validate_call_wrapper = _validate_call.ValidateCallWrapper(function, config, validate_return) + + @functools.wraps(function) + def wrapper_function(*args, **kwargs): + return validate_call_wrapper(*args, **kwargs) + + wrapper_function.raw_function = function # type: ignore + + return wrapper_function # type: ignore + + if __func: + return validate(__func) + else: + return validate diff --git a/lib/pydantic/validators.py b/lib/pydantic/validators.py index fb6d0418..55b0339e 100644 --- a/lib/pydantic/validators.py +++ b/lib/pydantic/validators.py @@ -1,765 +1,4 @@ -import math -import re -from collections import OrderedDict, deque -from collections.abc import Hashable as CollectionsHashable -from datetime import date, datetime, time, timedelta -from decimal import Decimal, DecimalException -from enum import Enum, IntEnum -from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network -from pathlib import Path -from typing import ( - TYPE_CHECKING, - Any, - Callable, - Deque, - Dict, - ForwardRef, - FrozenSet, - Generator, - Hashable, - List, - NamedTuple, - Pattern, - Set, - Tuple, - Type, - TypeVar, - Union, -) -from uuid import UUID +"""The `validators` module is a backport module from V1.""" +from ._migration import getattr_migration -from . import errors -from .datetime_parse import parse_date, parse_datetime, parse_duration, parse_time -from .typing import ( - AnyCallable, - all_literal_values, - display_as_type, - get_class, - is_callable_type, - is_literal_type, - is_namedtuple, - is_none_type, - is_typeddict, -) -from .utils import almost_equal_floats, lenient_issubclass, sequence_like - -if TYPE_CHECKING: - from typing_extensions import Literal, TypedDict - - from .config import BaseConfig - from .fields import ModelField - from .types import ConstrainedDecimal, ConstrainedFloat, ConstrainedInt - - ConstrainedNumber = Union[ConstrainedDecimal, ConstrainedFloat, ConstrainedInt] - AnyOrderedDict = OrderedDict[Any, Any] - Number = Union[int, float, Decimal] - StrBytes = Union[str, bytes] - - -def str_validator(v: Any) -> Union[str]: - if isinstance(v, str): - if isinstance(v, Enum): - return v.value - else: - return v - elif isinstance(v, (float, int, Decimal)): - # is there anything else we want to add here? If you think so, create an issue. - return str(v) - elif isinstance(v, (bytes, bytearray)): - return v.decode() - else: - raise errors.StrError() - - -def strict_str_validator(v: Any) -> Union[str]: - if isinstance(v, str) and not isinstance(v, Enum): - return v - raise errors.StrError() - - -def bytes_validator(v: Any) -> Union[bytes]: - if isinstance(v, bytes): - return v - elif isinstance(v, bytearray): - return bytes(v) - elif isinstance(v, str): - return v.encode() - elif isinstance(v, (float, int, Decimal)): - return str(v).encode() - else: - raise errors.BytesError() - - -def strict_bytes_validator(v: Any) -> Union[bytes]: - if isinstance(v, bytes): - return v - elif isinstance(v, bytearray): - return bytes(v) - else: - raise errors.BytesError() - - -BOOL_FALSE = {0, '0', 'off', 'f', 'false', 'n', 'no'} -BOOL_TRUE = {1, '1', 'on', 't', 'true', 'y', 'yes'} - - -def bool_validator(v: Any) -> bool: - if v is True or v is False: - return v - if isinstance(v, bytes): - v = v.decode() - if isinstance(v, str): - v = v.lower() - try: - if v in BOOL_TRUE: - return True - if v in BOOL_FALSE: - return False - except TypeError: - raise errors.BoolError() - raise errors.BoolError() - - -# matches the default limit cpython, see https://github.com/python/cpython/pull/96500 -max_str_int = 4_300 - - -def int_validator(v: Any) -> int: - if isinstance(v, int) and not (v is True or v is False): - return v - - # see https://github.com/pydantic/pydantic/issues/1477 and in turn, https://github.com/python/cpython/issues/95778 - # this check should be unnecessary once patch releases are out for 3.7, 3.8, 3.9 and 3.10 - # but better to check here until then. - # NOTICE: this does not fully protect user from the DOS risk since the standard library JSON implementation - # (and other std lib modules like xml) use `int()` and are likely called before this, the best workaround is to - # 1. update to the latest patch release of python once released, 2. use a different JSON library like ujson - if isinstance(v, (str, bytes, bytearray)) and len(v) > max_str_int: - raise errors.IntegerError() - - try: - return int(v) - except (TypeError, ValueError, OverflowError): - raise errors.IntegerError() - - -def strict_int_validator(v: Any) -> int: - if isinstance(v, int) and not (v is True or v is False): - return v - raise errors.IntegerError() - - -def float_validator(v: Any) -> float: - if isinstance(v, float): - return v - - try: - return float(v) - except (TypeError, ValueError): - raise errors.FloatError() - - -def strict_float_validator(v: Any) -> float: - if isinstance(v, float): - return v - raise errors.FloatError() - - -def float_finite_validator(v: 'Number', field: 'ModelField', config: 'BaseConfig') -> 'Number': - allow_inf_nan = getattr(field.type_, 'allow_inf_nan', None) - if allow_inf_nan is None: - allow_inf_nan = config.allow_inf_nan - - if allow_inf_nan is False and (math.isnan(v) or math.isinf(v)): - raise errors.NumberNotFiniteError() - return v - - -def number_multiple_validator(v: 'Number', field: 'ModelField') -> 'Number': - field_type: ConstrainedNumber = field.type_ - if field_type.multiple_of is not None: - mod = float(v) / float(field_type.multiple_of) % 1 - if not almost_equal_floats(mod, 0.0) and not almost_equal_floats(mod, 1.0): - raise errors.NumberNotMultipleError(multiple_of=field_type.multiple_of) - return v - - -def number_size_validator(v: 'Number', field: 'ModelField') -> 'Number': - field_type: ConstrainedNumber = field.type_ - if field_type.gt is not None and not v > field_type.gt: - raise errors.NumberNotGtError(limit_value=field_type.gt) - elif field_type.ge is not None and not v >= field_type.ge: - raise errors.NumberNotGeError(limit_value=field_type.ge) - - if field_type.lt is not None and not v < field_type.lt: - raise errors.NumberNotLtError(limit_value=field_type.lt) - if field_type.le is not None and not v <= field_type.le: - raise errors.NumberNotLeError(limit_value=field_type.le) - - return v - - -def constant_validator(v: 'Any', field: 'ModelField') -> 'Any': - """Validate ``const`` fields. - - The value provided for a ``const`` field must be equal to the default value - of the field. This is to support the keyword of the same name in JSON - Schema. - """ - if v != field.default: - raise errors.WrongConstantError(given=v, permitted=[field.default]) - - return v - - -def anystr_length_validator(v: 'StrBytes', config: 'BaseConfig') -> 'StrBytes': - v_len = len(v) - - min_length = config.min_anystr_length - if v_len < min_length: - raise errors.AnyStrMinLengthError(limit_value=min_length) - - max_length = config.max_anystr_length - if max_length is not None and v_len > max_length: - raise errors.AnyStrMaxLengthError(limit_value=max_length) - - return v - - -def anystr_strip_whitespace(v: 'StrBytes') -> 'StrBytes': - return v.strip() - - -def anystr_upper(v: 'StrBytes') -> 'StrBytes': - return v.upper() - - -def anystr_lower(v: 'StrBytes') -> 'StrBytes': - return v.lower() - - -def ordered_dict_validator(v: Any) -> 'AnyOrderedDict': - if isinstance(v, OrderedDict): - return v - - try: - return OrderedDict(v) - except (TypeError, ValueError): - raise errors.DictError() - - -def dict_validator(v: Any) -> Dict[Any, Any]: - if isinstance(v, dict): - return v - - try: - return dict(v) - except (TypeError, ValueError): - raise errors.DictError() - - -def list_validator(v: Any) -> List[Any]: - if isinstance(v, list): - return v - elif sequence_like(v): - return list(v) - else: - raise errors.ListError() - - -def tuple_validator(v: Any) -> Tuple[Any, ...]: - if isinstance(v, tuple): - return v - elif sequence_like(v): - return tuple(v) - else: - raise errors.TupleError() - - -def set_validator(v: Any) -> Set[Any]: - if isinstance(v, set): - return v - elif sequence_like(v): - return set(v) - else: - raise errors.SetError() - - -def frozenset_validator(v: Any) -> FrozenSet[Any]: - if isinstance(v, frozenset): - return v - elif sequence_like(v): - return frozenset(v) - else: - raise errors.FrozenSetError() - - -def deque_validator(v: Any) -> Deque[Any]: - if isinstance(v, deque): - return v - elif sequence_like(v): - return deque(v) - else: - raise errors.DequeError() - - -def enum_member_validator(v: Any, field: 'ModelField', config: 'BaseConfig') -> Enum: - try: - enum_v = field.type_(v) - except ValueError: - # field.type_ should be an enum, so will be iterable - raise errors.EnumMemberError(enum_values=list(field.type_)) - return enum_v.value if config.use_enum_values else enum_v - - -def uuid_validator(v: Any, field: 'ModelField') -> UUID: - try: - if isinstance(v, str): - v = UUID(v) - elif isinstance(v, (bytes, bytearray)): - try: - v = UUID(v.decode()) - except ValueError: - # 16 bytes in big-endian order as the bytes argument fail - # the above check - v = UUID(bytes=v) - except ValueError: - raise errors.UUIDError() - - if not isinstance(v, UUID): - raise errors.UUIDError() - - required_version = getattr(field.type_, '_required_version', None) - if required_version and v.version != required_version: - raise errors.UUIDVersionError(required_version=required_version) - - return v - - -def decimal_validator(v: Any) -> Decimal: - if isinstance(v, Decimal): - return v - elif isinstance(v, (bytes, bytearray)): - v = v.decode() - - v = str(v).strip() - - try: - v = Decimal(v) - except DecimalException: - raise errors.DecimalError() - - if not v.is_finite(): - raise errors.DecimalIsNotFiniteError() - - return v - - -def hashable_validator(v: Any) -> Hashable: - if isinstance(v, Hashable): - return v - - raise errors.HashableError() - - -def ip_v4_address_validator(v: Any) -> IPv4Address: - if isinstance(v, IPv4Address): - return v - - try: - return IPv4Address(v) - except ValueError: - raise errors.IPv4AddressError() - - -def ip_v6_address_validator(v: Any) -> IPv6Address: - if isinstance(v, IPv6Address): - return v - - try: - return IPv6Address(v) - except ValueError: - raise errors.IPv6AddressError() - - -def ip_v4_network_validator(v: Any) -> IPv4Network: - """ - Assume IPv4Network initialised with a default ``strict`` argument - - See more: - https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network - """ - if isinstance(v, IPv4Network): - return v - - try: - return IPv4Network(v) - except ValueError: - raise errors.IPv4NetworkError() - - -def ip_v6_network_validator(v: Any) -> IPv6Network: - """ - Assume IPv6Network initialised with a default ``strict`` argument - - See more: - https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network - """ - if isinstance(v, IPv6Network): - return v - - try: - return IPv6Network(v) - except ValueError: - raise errors.IPv6NetworkError() - - -def ip_v4_interface_validator(v: Any) -> IPv4Interface: - if isinstance(v, IPv4Interface): - return v - - try: - return IPv4Interface(v) - except ValueError: - raise errors.IPv4InterfaceError() - - -def ip_v6_interface_validator(v: Any) -> IPv6Interface: - if isinstance(v, IPv6Interface): - return v - - try: - return IPv6Interface(v) - except ValueError: - raise errors.IPv6InterfaceError() - - -def path_validator(v: Any) -> Path: - if isinstance(v, Path): - return v - - try: - return Path(v) - except TypeError: - raise errors.PathError() - - -def path_exists_validator(v: Any) -> Path: - if not v.exists(): - raise errors.PathNotExistsError(path=v) - - return v - - -def callable_validator(v: Any) -> AnyCallable: - """ - Perform a simple check if the value is callable. - - Note: complete matching of argument type hints and return types is not performed - """ - if callable(v): - return v - - raise errors.CallableError(value=v) - - -def enum_validator(v: Any) -> Enum: - if isinstance(v, Enum): - return v - - raise errors.EnumError(value=v) - - -def int_enum_validator(v: Any) -> IntEnum: - if isinstance(v, IntEnum): - return v - - raise errors.IntEnumError(value=v) - - -def make_literal_validator(type_: Any) -> Callable[[Any], Any]: - permitted_choices = all_literal_values(type_) - - # To have a O(1) complexity and still return one of the values set inside the `Literal`, - # we create a dict with the set values (a set causes some problems with the way intersection works). - # In some cases the set value and checked value can indeed be different (see `test_literal_validator_str_enum`) - allowed_choices = {v: v for v in permitted_choices} - - def literal_validator(v: Any) -> Any: - try: - return allowed_choices[v] - except KeyError: - raise errors.WrongConstantError(given=v, permitted=permitted_choices) - - return literal_validator - - -def constr_length_validator(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes': - v_len = len(v) - - min_length = field.type_.min_length if field.type_.min_length is not None else config.min_anystr_length - if v_len < min_length: - raise errors.AnyStrMinLengthError(limit_value=min_length) - - max_length = field.type_.max_length if field.type_.max_length is not None else config.max_anystr_length - if max_length is not None and v_len > max_length: - raise errors.AnyStrMaxLengthError(limit_value=max_length) - - return v - - -def constr_strip_whitespace(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes': - strip_whitespace = field.type_.strip_whitespace or config.anystr_strip_whitespace - if strip_whitespace: - v = v.strip() - - return v - - -def constr_upper(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes': - upper = field.type_.to_upper or config.anystr_upper - if upper: - v = v.upper() - - return v - - -def constr_lower(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes': - lower = field.type_.to_lower or config.anystr_lower - if lower: - v = v.lower() - return v - - -def validate_json(v: Any, config: 'BaseConfig') -> Any: - if v is None: - # pass None through to other validators - return v - try: - return config.json_loads(v) # type: ignore - except ValueError: - raise errors.JsonError() - except TypeError: - raise errors.JsonTypeError() - - -T = TypeVar('T') - - -def make_arbitrary_type_validator(type_: Type[T]) -> Callable[[T], T]: - def arbitrary_type_validator(v: Any) -> T: - if isinstance(v, type_): - return v - raise errors.ArbitraryTypeError(expected_arbitrary_type=type_) - - return arbitrary_type_validator - - -def make_class_validator(type_: Type[T]) -> Callable[[Any], Type[T]]: - def class_validator(v: Any) -> Type[T]: - if lenient_issubclass(v, type_): - return v - raise errors.SubclassError(expected_class=type_) - - return class_validator - - -def any_class_validator(v: Any) -> Type[T]: - if isinstance(v, type): - return v - raise errors.ClassError() - - -def none_validator(v: Any) -> 'Literal[None]': - if v is None: - return v - raise errors.NotNoneError() - - -def pattern_validator(v: Any) -> Pattern[str]: - if isinstance(v, Pattern): - return v - - str_value = str_validator(v) - - try: - return re.compile(str_value) - except re.error: - raise errors.PatternError() - - -NamedTupleT = TypeVar('NamedTupleT', bound=NamedTuple) - - -def make_namedtuple_validator( - namedtuple_cls: Type[NamedTupleT], config: Type['BaseConfig'] -) -> Callable[[Tuple[Any, ...]], NamedTupleT]: - from .annotated_types import create_model_from_namedtuple - - NamedTupleModel = create_model_from_namedtuple( - namedtuple_cls, - __config__=config, - __module__=namedtuple_cls.__module__, - ) - namedtuple_cls.__pydantic_model__ = NamedTupleModel # type: ignore[attr-defined] - - def namedtuple_validator(values: Tuple[Any, ...]) -> NamedTupleT: - annotations = NamedTupleModel.__annotations__ - - if len(values) > len(annotations): - raise errors.ListMaxLengthError(limit_value=len(annotations)) - - dict_values: Dict[str, Any] = dict(zip(annotations, values)) - validated_dict_values: Dict[str, Any] = dict(NamedTupleModel(**dict_values)) - return namedtuple_cls(**validated_dict_values) - - return namedtuple_validator - - -def make_typeddict_validator( - typeddict_cls: Type['TypedDict'], config: Type['BaseConfig'] # type: ignore[valid-type] -) -> Callable[[Any], Dict[str, Any]]: - from .annotated_types import create_model_from_typeddict - - TypedDictModel = create_model_from_typeddict( - typeddict_cls, - __config__=config, - __module__=typeddict_cls.__module__, - ) - typeddict_cls.__pydantic_model__ = TypedDictModel # type: ignore[attr-defined] - - def typeddict_validator(values: 'TypedDict') -> Dict[str, Any]: # type: ignore[valid-type] - return TypedDictModel.parse_obj(values).dict(exclude_unset=True) - - return typeddict_validator - - -class IfConfig: - def __init__(self, validator: AnyCallable, *config_attr_names: str, ignored_value: Any = False) -> None: - self.validator = validator - self.config_attr_names = config_attr_names - self.ignored_value = ignored_value - - def check(self, config: Type['BaseConfig']) -> bool: - return any(getattr(config, name) not in {None, self.ignored_value} for name in self.config_attr_names) - - -# order is important here, for example: bool is a subclass of int so has to come first, datetime before date same, -# IPv4Interface before IPv4Address, etc -_VALIDATORS: List[Tuple[Type[Any], List[Any]]] = [ - (IntEnum, [int_validator, enum_member_validator]), - (Enum, [enum_member_validator]), - ( - str, - [ - str_validator, - IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'), - IfConfig(anystr_upper, 'anystr_upper'), - IfConfig(anystr_lower, 'anystr_lower'), - IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'), - ], - ), - ( - bytes, - [ - bytes_validator, - IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'), - IfConfig(anystr_upper, 'anystr_upper'), - IfConfig(anystr_lower, 'anystr_lower'), - IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'), - ], - ), - (bool, [bool_validator]), - (int, [int_validator]), - (float, [float_validator, IfConfig(float_finite_validator, 'allow_inf_nan', ignored_value=True)]), - (Path, [path_validator]), - (datetime, [parse_datetime]), - (date, [parse_date]), - (time, [parse_time]), - (timedelta, [parse_duration]), - (OrderedDict, [ordered_dict_validator]), - (dict, [dict_validator]), - (list, [list_validator]), - (tuple, [tuple_validator]), - (set, [set_validator]), - (frozenset, [frozenset_validator]), - (deque, [deque_validator]), - (UUID, [uuid_validator]), - (Decimal, [decimal_validator]), - (IPv4Interface, [ip_v4_interface_validator]), - (IPv6Interface, [ip_v6_interface_validator]), - (IPv4Address, [ip_v4_address_validator]), - (IPv6Address, [ip_v6_address_validator]), - (IPv4Network, [ip_v4_network_validator]), - (IPv6Network, [ip_v6_network_validator]), -] - - -def find_validators( # noqa: C901 (ignore complexity) - type_: Type[Any], config: Type['BaseConfig'] -) -> Generator[AnyCallable, None, None]: - from .dataclasses import is_builtin_dataclass, make_dataclass_validator - - if type_ is Any or type_ is object: - return - type_type = type_.__class__ - if type_type == ForwardRef or type_type == TypeVar: - return - - if is_none_type(type_): - yield none_validator - return - if type_ is Pattern or type_ is re.Pattern: - yield pattern_validator - return - if type_ is Hashable or type_ is CollectionsHashable: - yield hashable_validator - return - if is_callable_type(type_): - yield callable_validator - return - if is_literal_type(type_): - yield make_literal_validator(type_) - return - if is_builtin_dataclass(type_): - yield from make_dataclass_validator(type_, config) - return - if type_ is Enum: - yield enum_validator - return - if type_ is IntEnum: - yield int_enum_validator - return - if is_namedtuple(type_): - yield tuple_validator - yield make_namedtuple_validator(type_, config) - return - if is_typeddict(type_): - yield make_typeddict_validator(type_, config) - return - - class_ = get_class(type_) - if class_ is not None: - if class_ is not Any and isinstance(class_, type): - yield make_class_validator(class_) - else: - yield any_class_validator - return - - for val_type, validators in _VALIDATORS: - try: - if issubclass(type_, val_type): - for v in validators: - if isinstance(v, IfConfig): - if v.check(config): - yield v.validator - else: - yield v - return - except TypeError: - raise RuntimeError(f'error checking inheritance of {type_!r} (type: {display_as_type(type_)})') - - if config.arbitrary_types_allowed: - yield make_arbitrary_type_validator(type_) - else: - raise RuntimeError(f'no validator found for {type_}, see `arbitrary_types_allowed` in Config') +__getattr__ = getattr_migration(__name__) diff --git a/lib/pydantic/version.py b/lib/pydantic/version.py index 32c61633..3e233771 100644 --- a/lib/pydantic/version.py +++ b/lib/pydantic/version.py @@ -1,38 +1,80 @@ -__all__ = 'compiled', 'VERSION', 'version_info' +"""The `version` module holds the version information for Pydantic.""" +from __future__ import annotations as _annotations -VERSION = '1.10.2' +__all__ = 'VERSION', 'version_info' -try: - import cython # type: ignore -except ImportError: - compiled: bool = False -else: # pragma: no cover - try: - compiled = cython.compiled - except AttributeError: - compiled = False +VERSION = '2.6.4' +"""The version of Pydantic.""" + + +def version_short() -> str: + """Return the `major.minor` part of Pydantic version. + + It returns '2.1' if Pydantic version is '2.1.1'. + """ + return '.'.join(VERSION.split('.')[:2]) def version_info() -> str: + """Return complete version information for Pydantic and its dependencies.""" + import importlib.metadata as importlib_metadata + import os import platform import sys - from importlib import import_module from pathlib import Path - optional_deps = [] - for p in ('devtools', 'dotenv', 'email-validator', 'typing-extensions'): - try: - import_module(p.replace('-', '_')) - except ImportError: - continue - optional_deps.append(p) + import pydantic_core._pydantic_core as pdc + + from ._internal import _git as git + + # get data about packages that are closely related to pydantic, use pydantic or often conflict with pydantic + package_names = { + 'email-validator', + 'fastapi', + 'mypy', + 'pydantic-extra-types', + 'pydantic-settings', + 'pyright', + 'typing_extensions', + } + related_packages = [] + + for dist in importlib_metadata.distributions(): + name = dist.metadata['Name'] + if name in package_names: + related_packages.append(f'{name}-{dist.version}') + + pydantic_dir = os.path.abspath(os.path.dirname(os.path.dirname(__file__))) + most_recent_commit = ( + git.git_revision(pydantic_dir) if git.is_git_repo(pydantic_dir) and git.have_git() else 'unknown' + ) info = { 'pydantic version': VERSION, - 'pydantic compiled': compiled, + 'pydantic-core version': pdc.__version__, + 'pydantic-core build': getattr(pdc, 'build_info', None) or pdc.build_profile, 'install path': Path(__file__).resolve().parent, 'python version': sys.version, 'platform': platform.platform(), - 'optional deps. installed': optional_deps, + 'related packages': ' '.join(related_packages), + 'commit': most_recent_commit, } return '\n'.join('{:>30} {}'.format(k + ':', str(v).replace('\n', ' ')) for k, v in info.items()) + + +def parse_mypy_version(version: str) -> tuple[int, ...]: + """Parse mypy string version to tuple of ints. + + This function is included here rather than the mypy plugin file because the mypy plugin file cannot be imported + outside a mypy run. + + It parses normal version like `0.930` and dev version + like `0.940+dev.04cac4b5d911c4f9529e6ce86a27b44f28846f5d.dirty`. + + Args: + version: The mypy version string. + + Returns: + A tuple of ints. e.g. (0, 930). + """ + return tuple(map(int, version.partition('+')[0].split('.'))) diff --git a/lib/pydantic/warnings.py b/lib/pydantic/warnings.py new file mode 100644 index 00000000..aedd4fba --- /dev/null +++ b/lib/pydantic/warnings.py @@ -0,0 +1,58 @@ +"""Pydantic-specific warnings.""" +from __future__ import annotations as _annotations + +from .version import version_short + +__all__ = 'PydanticDeprecatedSince20', 'PydanticDeprecationWarning' + + +class PydanticDeprecationWarning(DeprecationWarning): + """A Pydantic specific deprecation warning. + + This warning is raised when using deprecated functionality in Pydantic. It provides information on when the + deprecation was introduced and the expected version in which the corresponding functionality will be removed. + + Attributes: + message: Description of the warning. + since: Pydantic version in what the deprecation was introduced. + expected_removal: Pydantic version in what the corresponding functionality expected to be removed. + """ + + message: str + since: tuple[int, int] + expected_removal: tuple[int, int] + + def __init__( + self, message: str, *args: object, since: tuple[int, int], expected_removal: tuple[int, int] | None = None + ) -> None: + super().__init__(message, *args) + self.message = message.rstrip('.') + self.since = since + self.expected_removal = expected_removal if expected_removal is not None else (since[0] + 1, 0) + + def __str__(self) -> str: + message = ( + f'{self.message}. Deprecated in Pydantic V{self.since[0]}.{self.since[1]}' + f' to be removed in V{self.expected_removal[0]}.{self.expected_removal[1]}.' + ) + if self.since == (2, 0): + message += f' See Pydantic V2 Migration Guide at https://errors.pydantic.dev/{version_short()}/migration/' + return message + + +class PydanticDeprecatedSince20(PydanticDeprecationWarning): + """A specific `PydanticDeprecationWarning` subclass defining functionality deprecated since Pydantic 2.0.""" + + def __init__(self, message: str, *args: object) -> None: + super().__init__(message, *args, since=(2, 0), expected_removal=(3, 0)) + + +class PydanticDeprecatedSince26(PydanticDeprecationWarning): + """A specific `PydanticDeprecationWarning` subclass defining functionality deprecated since Pydantic 2.6.""" + + def __init__(self, message: str, *args: object) -> None: + super().__init__(message, *args, since=(2, 0), expected_removal=(3, 0)) + + +class GenericBeforeBaseModelWarning(Warning): + pass diff --git a/lib/pydantic_core/__init__.py b/lib/pydantic_core/__init__.py new file mode 100644 index 00000000..5b2655c9 --- /dev/null +++ b/lib/pydantic_core/__init__.py @@ -0,0 +1,139 @@ +from __future__ import annotations + +import sys as _sys +from typing import Any as _Any + +from ._pydantic_core import ( + ArgsKwargs, + MultiHostUrl, + PydanticCustomError, + PydanticKnownError, + PydanticOmit, + PydanticSerializationError, + PydanticSerializationUnexpectedValue, + PydanticUndefined, + PydanticUndefinedType, + PydanticUseDefault, + SchemaError, + SchemaSerializer, + SchemaValidator, + Some, + TzInfo, + Url, + ValidationError, + __version__, + from_json, + to_json, + to_jsonable_python, + validate_core_schema, +) +from .core_schema import CoreConfig, CoreSchema, CoreSchemaType, ErrorType + +if _sys.version_info < (3, 11): + from typing_extensions import NotRequired as _NotRequired +else: + from typing import NotRequired as _NotRequired + +if _sys.version_info < (3, 9): + from typing_extensions import TypedDict as _TypedDict +else: + from typing import TypedDict as _TypedDict + +__all__ = [ + '__version__', + 'CoreConfig', + 'CoreSchema', + 'CoreSchemaType', + 'SchemaValidator', + 'SchemaSerializer', + 'Some', + 'Url', + 'MultiHostUrl', + 'ArgsKwargs', + 'PydanticUndefined', + 'PydanticUndefinedType', + 'SchemaError', + 'ErrorDetails', + 'InitErrorDetails', + 'ValidationError', + 'PydanticCustomError', + 'PydanticKnownError', + 'PydanticOmit', + 'PydanticUseDefault', + 'PydanticSerializationError', + 'PydanticSerializationUnexpectedValue', + 'TzInfo', + 'to_json', + 'from_json', + 'to_jsonable_python', + 'validate_core_schema', +] + + +class ErrorDetails(_TypedDict): + type: str + """ + The type of error that occurred, this is an identifier designed for + programmatic use that will change rarely or never. + + `type` is unique for each error message, and can hence be used as an identifier to build custom error messages. + """ + loc: tuple[int | str, ...] + """Tuple of strings and ints identifying where in the schema the error occurred.""" + msg: str + """A human readable error message.""" + input: _Any + """The input data at this `loc` that caused the error.""" + ctx: _NotRequired[dict[str, _Any]] + """ + Values which are required to render the error message, and could hence be useful in rendering custom error messages. + Also useful for passing custom error data forward. + """ + + +class InitErrorDetails(_TypedDict): + type: str | PydanticCustomError + """The type of error that occurred, this should a "slug" identifier that changes rarely or never.""" + loc: _NotRequired[tuple[int | str, ...]] + """Tuple of strings and ints identifying where in the schema the error occurred.""" + input: _Any + """The input data at this `loc` that caused the error.""" + ctx: _NotRequired[dict[str, _Any]] + """ + Values which are required to render the error message, and could hence be useful in rendering custom error messages. + Also useful for passing custom error data forward. + """ + + +class ErrorTypeInfo(_TypedDict): + """ + Gives information about errors. + """ + + type: ErrorType + """The type of error that occurred, this should a "slug" identifier that changes rarely or never.""" + message_template_python: str + """String template to render a human readable error message from using context, when the input is Python.""" + example_message_python: str + """Example of a human readable error message, when the input is Python.""" + message_template_json: _NotRequired[str] + """String template to render a human readable error message from using context, when the input is JSON data.""" + example_message_json: _NotRequired[str] + """Example of a human readable error message, when the input is JSON data.""" + example_context: dict[str, _Any] | None + """Example of context values.""" + + +class MultiHostHost(_TypedDict): + """ + A host part of a multi-host URL. + """ + + username: str | None + """The username part of this host, or `None`.""" + password: str | None + """The password part of this host, or `None`.""" + host: str | None + """The host part of this host, or `None`.""" + port: int | None + """The port part of this host, or `None`.""" diff --git a/lib/pydantic_core/_pydantic_core.pyi b/lib/pydantic_core/_pydantic_core.pyi new file mode 100644 index 00000000..a7b727f8 --- /dev/null +++ b/lib/pydantic_core/_pydantic_core.pyi @@ -0,0 +1,882 @@ +from __future__ import annotations + +import datetime +import sys +from typing import Any, Callable, Generic, Optional, Type, TypeVar + +from pydantic_core import ErrorDetails, ErrorTypeInfo, InitErrorDetails, MultiHostHost +from pydantic_core.core_schema import CoreConfig, CoreSchema, ErrorType + +if sys.version_info < (3, 8): + from typing_extensions import final +else: + from typing import final + +if sys.version_info < (3, 11): + from typing_extensions import Literal, LiteralString, Self, TypeAlias +else: + from typing import Literal, LiteralString, Self, TypeAlias + +from _typeshed import SupportsAllComparisons + +__all__ = [ + '__version__', + 'build_profile', + 'build_info', + '_recursion_limit', + 'ArgsKwargs', + 'SchemaValidator', + 'SchemaSerializer', + 'Url', + 'MultiHostUrl', + 'SchemaError', + 'ValidationError', + 'PydanticCustomError', + 'PydanticKnownError', + 'PydanticOmit', + 'PydanticUseDefault', + 'PydanticSerializationError', + 'PydanticSerializationUnexpectedValue', + 'PydanticUndefined', + 'PydanticUndefinedType', + 'Some', + 'to_json', + 'from_json', + 'to_jsonable_python', + 'list_all_errors', + 'TzInfo', + 'validate_core_schema', +] +__version__: str +build_profile: str +build_info: str +_recursion_limit: int + +_T = TypeVar('_T', default=Any, covariant=True) + +_StringInput: TypeAlias = 'dict[str, _StringInput]' + +@final +class Some(Generic[_T]): + """ + Similar to Rust's [`Option::Some`](https://doc.rust-lang.org/std/option/enum.Option.html) type, this + identifies a value as being present, and provides a way to access it. + + Generally used in a union with `None` to different between "some value which could be None" and no value. + """ + + __match_args__ = ('value',) + + @property + def value(self) -> _T: + """ + Returns the value wrapped by `Some`. + """ + @classmethod + def __class_getitem__(cls, __item: Any) -> Type[Self]: ... + +@final +class SchemaValidator: + """ + `SchemaValidator` is the Python wrapper for `pydantic-core`'s Rust validation logic, internally it owns one + `CombinedValidator` which may in turn own more `CombinedValidator`s which make up the full schema validator. + """ + + def __new__(cls, schema: CoreSchema, config: CoreConfig | None = None) -> Self: + """ + Create a new SchemaValidator. + + Arguments: + schema: The [`CoreSchema`][pydantic_core.core_schema.CoreSchema] to use for validation. + config: Optionally a [`CoreConfig`][pydantic_core.core_schema.CoreConfig] to configure validation. + """ + @property + def title(self) -> str: + """ + The title of the schema, as used in the heading of [`ValidationError.__str__()`][pydantic_core.ValidationError]. + """ + def validate_python( + self, + input: Any, + *, + strict: bool | None = None, + from_attributes: bool | None = None, + context: 'dict[str, Any] | None' = None, + self_instance: Any | None = None, + ) -> Any: + """ + Validate a Python object against the schema and return the validated object. + + Arguments: + input: The Python object to validate. + strict: Whether to validate the object in strict mode. + If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used. + from_attributes: Whether to validate objects as inputs to models by extracting attributes. + If `None`, the value of [`CoreConfig.from_attributes`][pydantic_core.core_schema.CoreConfig] is used. + context: The context to use for validation, this is passed to functional validators as + [`info.context`][pydantic_core.core_schema.ValidationInfo.context]. + self_instance: An instance of a model set attributes on from validation, this is used when running + validation from the `__init__` method of a model. + + Raises: + ValidationError: If validation fails. + Exception: Other error types maybe raised if internal errors occur. + + Returns: + The validated object. + """ + def isinstance_python( + self, + input: Any, + *, + strict: bool | None = None, + from_attributes: bool | None = None, + context: 'dict[str, Any] | None' = None, + self_instance: Any | None = None, + ) -> bool: + """ + Similar to [`validate_python()`][pydantic_core.SchemaValidator.validate_python] but returns a boolean. + + Arguments match `validate_python()`. This method will not raise `ValidationError`s but will raise internal + errors. + + Returns: + `True` if validation succeeds, `False` if validation fails. + """ + def validate_json( + self, + input: str | bytes | bytearray, + *, + strict: bool | None = None, + context: 'dict[str, Any] | None' = None, + self_instance: Any | None = None, + ) -> Any: + """ + Validate JSON data directly against the schema and return the validated Python object. + + This method should be significantly faster than `validate_python(json.loads(json_data))` as it avoids the + need to create intermediate Python objects + + It also handles constructing the correct Python type even in strict mode, where + `validate_python(json.loads(json_data))` would fail validation. + + Arguments: + input: The JSON data to validate. + strict: Whether to validate the object in strict mode. + If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used. + context: The context to use for validation, this is passed to functional validators as + [`info.context`][pydantic_core.core_schema.ValidationInfo.context]. + self_instance: An instance of a model set attributes on from validation. + + Raises: + ValidationError: If validation fails or if the JSON data is invalid. + Exception: Other error types maybe raised if internal errors occur. + + Returns: + The validated Python object. + """ + def validate_strings( + self, input: _StringInput, *, strict: bool | None = None, context: 'dict[str, Any] | None' = None + ) -> Any: + """ + Validate a string against the schema and return the validated Python object. + + This is similar to `validate_json` but applies to scenarios where the input will be a string but not + JSON data, e.g. URL fragments, query parameters, etc. + + Arguments: + input: The input as a string, or bytes/bytearray if `strict=False`. + strict: Whether to validate the object in strict mode. + If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used. + context: The context to use for validation, this is passed to functional validators as + [`info.context`][pydantic_core.core_schema.ValidationInfo.context]. + + Raises: + ValidationError: If validation fails or if the JSON data is invalid. + Exception: Other error types maybe raised if internal errors occur. + + Returns: + The validated Python object. + """ + def validate_assignment( + self, + obj: Any, + field_name: str, + field_value: Any, + *, + strict: bool | None = None, + from_attributes: bool | None = None, + context: 'dict[str, Any] | None' = None, + ) -> dict[str, Any] | tuple[dict[str, Any], dict[str, Any] | None, set[str]]: + """ + Validate an assignment to a field on a model. + + Arguments: + obj: The model instance being assigned to. + field_name: The name of the field to validate assignment for. + field_value: The value to assign to the field. + strict: Whether to validate the object in strict mode. + If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used. + from_attributes: Whether to validate objects as inputs to models by extracting attributes. + If `None`, the value of [`CoreConfig.from_attributes`][pydantic_core.core_schema.CoreConfig] is used. + context: The context to use for validation, this is passed to functional validators as + [`info.context`][pydantic_core.core_schema.ValidationInfo.context]. + + Raises: + ValidationError: If validation fails. + Exception: Other error types maybe raised if internal errors occur. + + Returns: + Either the model dict or a tuple of `(model_data, model_extra, fields_set)` + """ + def get_default_value(self, *, strict: bool | None = None, context: Any = None) -> Some | None: + """ + Get the default value for the schema, including running default value validation. + + Arguments: + strict: Whether to validate the default value in strict mode. + If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used. + context: The context to use for validation, this is passed to functional validators as + [`info.context`][pydantic_core.core_schema.ValidationInfo.context]. + + Raises: + ValidationError: If validation fails. + Exception: Other error types maybe raised if internal errors occur. + + Returns: + `None` if the schema has no default value, otherwise a [`Some`][pydantic_core.Some] containing the default. + """ + +_IncEx: TypeAlias = set[int] | set[str] | dict[int, _IncEx] | dict[str, _IncEx] | None + +@final +class SchemaSerializer: + """ + `SchemaSerializer` is the Python wrapper for `pydantic-core`'s Rust serialization logic, internally it owns one + `CombinedSerializer` which may in turn own more `CombinedSerializer`s which make up the full schema serializer. + """ + + def __new__(cls, schema: CoreSchema, config: CoreConfig | None = None) -> Self: + """ + Create a new SchemaSerializer. + + Arguments: + schema: The [`CoreSchema`][pydantic_core.core_schema.CoreSchema] to use for serialization. + config: Optionally a [`CoreConfig`][pydantic_core.core_schema.CoreConfig] to to configure serialization. + """ + def to_python( + self, + value: Any, + *, + mode: str | None = None, + include: _IncEx = None, + exclude: _IncEx = None, + by_alias: bool = True, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + round_trip: bool = False, + warnings: bool = True, + fallback: Callable[[Any], Any] | None = None, + ) -> Any: + """ + Serialize/marshal a Python object to a Python object including transforming and filtering data. + + Arguments: + value: The Python object to serialize. + mode: The serialization mode to use, either `'python'` or `'json'`, defaults to `'python'`. In JSON mode, + all values are converted to JSON compatible types, e.g. `None`, `int`, `float`, `str`, `list`, `dict`. + include: A set of fields to include, if `None` all fields are included. + exclude: A set of fields to exclude, if `None` no fields are excluded. + by_alias: Whether to use the alias names of fields. + exclude_unset: Whether to exclude fields that are not set, + e.g. are not included in `__pydantic_fields_set__`. + exclude_defaults: Whether to exclude fields that are equal to their default value. + exclude_none: Whether to exclude fields that have a value of `None`. + round_trip: Whether to enable serialization and validation round-trip support. + warnings: Whether to log warnings when invalid fields are encountered. + fallback: A function to call when an unknown value is encountered, + if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised. + + Raises: + PydanticSerializationError: If serialization fails and no `fallback` function is provided. + + Returns: + The serialized Python object. + """ + def to_json( + self, + value: Any, + *, + indent: int | None = None, + include: _IncEx = None, + exclude: _IncEx = None, + by_alias: bool = True, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + round_trip: bool = False, + warnings: bool = True, + fallback: Callable[[Any], Any] | None = None, + ) -> bytes: + """ + Serialize a Python object to JSON including transforming and filtering data. + + Arguments: + value: The Python object to serialize. + indent: If `None`, the JSON will be compact, otherwise it will be pretty-printed with the indent provided. + include: A set of fields to include, if `None` all fields are included. + exclude: A set of fields to exclude, if `None` no fields are excluded. + by_alias: Whether to use the alias names of fields. + exclude_unset: Whether to exclude fields that are not set, + e.g. are not included in `__pydantic_fields_set__`. + exclude_defaults: Whether to exclude fields that are equal to their default value. + exclude_none: Whether to exclude fields that have a value of `None`. + round_trip: Whether to enable serialization and validation round-trip support. + warnings: Whether to log warnings when invalid fields are encountered. + fallback: A function to call when an unknown value is encountered, + if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised. + + Raises: + PydanticSerializationError: If serialization fails and no `fallback` function is provided. + + Returns: + JSON bytes. + """ + +def to_json( + value: Any, + *, + indent: int | None = None, + include: _IncEx = None, + exclude: _IncEx = None, + by_alias: bool = True, + exclude_none: bool = False, + round_trip: bool = False, + timedelta_mode: Literal['iso8601', 'float'] = 'iso8601', + bytes_mode: Literal['utf8', 'base64'] = 'utf8', + inf_nan_mode: Literal['null', 'constants'] = 'constants', + serialize_unknown: bool = False, + fallback: Callable[[Any], Any] | None = None, +) -> bytes: + """ + Serialize a Python object to JSON including transforming and filtering data. + + This is effectively a standalone version of [`SchemaSerializer.to_json`][pydantic_core.SchemaSerializer.to_json]. + + Arguments: + value: The Python object to serialize. + indent: If `None`, the JSON will be compact, otherwise it will be pretty-printed with the indent provided. + include: A set of fields to include, if `None` all fields are included. + exclude: A set of fields to exclude, if `None` no fields are excluded. + by_alias: Whether to use the alias names of fields. + exclude_none: Whether to exclude fields that have a value of `None`. + round_trip: Whether to enable serialization and validation round-trip support. + timedelta_mode: How to serialize `timedelta` objects, either `'iso8601'` or `'float'`. + bytes_mode: How to serialize `bytes` objects, either `'utf8'` or `'base64'`. + inf_nan_mode: How to serialize `Infinity`, `-Infinity` and `NaN` values, either `'null'` or `'constants'`. + serialize_unknown: Attempt to serialize unknown types, `str(value)` will be used, if that fails + `""` will be used. + fallback: A function to call when an unknown value is encountered, + if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised. + + Raises: + PydanticSerializationError: If serialization fails and no `fallback` function is provided. + + Returns: + JSON bytes. + """ + +def from_json(data: str | bytes | bytearray, *, allow_inf_nan: bool = True, cache_strings: bool = True) -> Any: + """ + Deserialize JSON data to a Python object. + + This is effectively a faster version of `json.loads()`. + + Arguments: + data: The JSON data to deserialize. + allow_inf_nan: Whether to allow `Infinity`, `-Infinity` and `NaN` values as `json.loads()` does by default. + cache_strings: Whether to cache strings to avoid constructing new Python objects, + this should have a significant impact on performance while increasing memory usage slightly. + + Raises: + ValueError: If deserialization fails. + + Returns: + The deserialized Python object. + """ + +def to_jsonable_python( + value: Any, + *, + include: _IncEx = None, + exclude: _IncEx = None, + by_alias: bool = True, + exclude_none: bool = False, + round_trip: bool = False, + timedelta_mode: Literal['iso8601', 'float'] = 'iso8601', + bytes_mode: Literal['utf8', 'base64'] = 'utf8', + inf_nan_mode: Literal['null', 'constants'] = 'constants', + serialize_unknown: bool = False, + fallback: Callable[[Any], Any] | None = None, +) -> Any: + """ + Serialize/marshal a Python object to a JSON-serializable Python object including transforming and filtering data. + + This is effectively a standalone version of + [`SchemaSerializer.to_python(mode='json')`][pydantic_core.SchemaSerializer.to_python]. + + Args: + value: The Python object to serialize. + include: A set of fields to include, if `None` all fields are included. + exclude: A set of fields to exclude, if `None` no fields are excluded. + by_alias: Whether to use the alias names of fields. + exclude_none: Whether to exclude fields that have a value of `None`. + round_trip: Whether to enable serialization and validation round-trip support. + timedelta_mode: How to serialize `timedelta` objects, either `'iso8601'` or `'float'`. + bytes_mode: How to serialize `bytes` objects, either `'utf8'` or `'base64'`. + inf_nan_mode: How to serialize `Infinity`, `-Infinity` and `NaN` values, either `'null'` or `'constants'`. + serialize_unknown: Attempt to serialize unknown types, `str(value)` will be used, if that fails + `""` will be used. + fallback: A function to call when an unknown value is encountered, + if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised. + + Raises: + PydanticSerializationError: If serialization fails and no `fallback` function is provided. + + Returns: + The serialized Python object. + """ + +class Url(SupportsAllComparisons): + """ + A URL type, internal logic uses the [url rust crate](https://docs.rs/url/latest/url/) originally developed + by Mozilla. + """ + + def __new__(cls, url: str) -> Self: + """ + Create a new `Url` instance. + + Args: + url: String representation of a URL. + + Returns: + A new `Url` instance. + + Raises: + ValidationError: If the URL is invalid. + """ + @property + def scheme(self) -> str: + """ + The scheme part of the URL. + + e.g. `https` in `https://user:pass@host:port/path?query#fragment` + """ + @property + def username(self) -> str | None: + """ + The username part of the URL, or `None`. + + e.g. `user` in `https://user:pass@host:port/path?query#fragment` + """ + @property + def password(self) -> str | None: + """ + The password part of the URL, or `None`. + + e.g. `pass` in `https://user:pass@host:port/path?query#fragment` + """ + @property + def host(self) -> str | None: + """ + The host part of the URL, or `None`. + + If the URL must be punycode encoded, this is the encoded host, e.g if the input URL is `https://£££.com`, + `host` will be `xn--9aaa.com` + """ + def unicode_host(self) -> str | None: + """ + The host part of the URL as a unicode string, or `None`. + + e.g. `host` in `https://user:pass@host:port/path?query#fragment` + + If the URL must be punycode encoded, this is the decoded host, e.g if the input URL is `https://£££.com`, + `unicode_host()` will be `£££.com` + """ + @property + def port(self) -> int | None: + """ + The port part of the URL, or `None`. + + e.g. `port` in `https://user:pass@host:port/path?query#fragment` + """ + @property + def path(self) -> str | None: + """ + The path part of the URL, or `None`. + + e.g. `/path` in `https://user:pass@host:port/path?query#fragment` + """ + @property + def query(self) -> str | None: + """ + The query part of the URL, or `None`. + + e.g. `query` in `https://user:pass@host:port/path?query#fragment` + """ + def query_params(self) -> list[tuple[str, str]]: + """ + The query part of the URL as a list of key-value pairs. + + e.g. `[('foo', 'bar')]` in `https://user:pass@host:port/path?foo=bar#fragment` + """ + @property + def fragment(self) -> str | None: + """ + The fragment part of the URL, or `None`. + + e.g. `fragment` in `https://user:pass@host:port/path?query#fragment` + """ + def unicode_string(self) -> str: + """ + The URL as a unicode string, unlike `__str__()` this will not punycode encode the host. + + If the URL must be punycode encoded, this is the decoded string, e.g if the input URL is `https://£££.com`, + `unicode_string()` will be `https://£££.com` + """ + def __repr__(self) -> str: ... + def __str__(self) -> str: + """ + The URL as a string, this will punycode encode the host if required. + """ + def __deepcopy__(self, memo: dict) -> str: ... + @classmethod + def build( + cls, + *, + scheme: str, + username: Optional[str] = None, + password: Optional[str] = None, + host: str, + port: Optional[int] = None, + path: Optional[str] = None, + query: Optional[str] = None, + fragment: Optional[str] = None, + ) -> Self: + """ + Build a new `Url` instance from its component parts. + + Args: + scheme: The scheme part of the URL. + username: The username part of the URL, or omit for no username. + password: The password part of the URL, or omit for no password. + host: The host part of the URL. + port: The port part of the URL, or omit for no port. + path: The path part of the URL, or omit for no path. + query: The query part of the URL, or omit for no query. + fragment: The fragment part of the URL, or omit for no fragment. + + Returns: + An instance of URL + """ + +class MultiHostUrl(SupportsAllComparisons): + """ + A URL type with support for multiple hosts, as used by some databases for DSNs, e.g. `https://foo.com,bar.com/path`. + + Internal URL logic uses the [url rust crate](https://docs.rs/url/latest/url/) originally developed + by Mozilla. + """ + + def __new__(cls, url: str) -> Self: + """ + Create a new `MultiHostUrl` instance. + + Args: + url: String representation of a URL. + + Returns: + A new `MultiHostUrl` instance. + + Raises: + ValidationError: If the URL is invalid. + """ + @property + def scheme(self) -> str: + """ + The scheme part of the URL. + + e.g. `https` in `https://foo.com,bar.com/path?query#fragment` + """ + @property + def path(self) -> str | None: + """ + The path part of the URL, or `None`. + + e.g. `/path` in `https://foo.com,bar.com/path?query#fragment` + """ + @property + def query(self) -> str | None: + """ + The query part of the URL, or `None`. + + e.g. `query` in `https://foo.com,bar.com/path?query#fragment` + """ + def query_params(self) -> list[tuple[str, str]]: + """ + The query part of the URL as a list of key-value pairs. + + e.g. `[('foo', 'bar')]` in `https://foo.com,bar.com/path?query#fragment` + """ + @property + def fragment(self) -> str | None: + """ + The fragment part of the URL, or `None`. + + e.g. `fragment` in `https://foo.com,bar.com/path?query#fragment` + """ + def hosts(self) -> list[MultiHostHost]: + ''' + + The hosts of the `MultiHostUrl` as [`MultiHostHost`][pydantic_core.MultiHostHost] typed dicts. + + ```py + from pydantic_core import MultiHostUrl + + mhu = MultiHostUrl('https://foo.com:123,foo:bar@bar.com/path') + print(mhu.hosts()) + """ + [ + {'username': None, 'password': None, 'host': 'foo.com', 'port': 123}, + {'username': 'foo', 'password': 'bar', 'host': 'bar.com', 'port': 443} + ] + ``` + Returns: + A list of dicts, each representing a host. + ''' + def unicode_string(self) -> str: + """ + The URL as a unicode string, unlike `__str__()` this will not punycode encode the hosts. + """ + def __repr__(self) -> str: ... + def __str__(self) -> str: + """ + The URL as a string, this will punycode encode the hosts if required. + """ + def __deepcopy__(self, memo: dict) -> Self: ... + @classmethod + def build( + cls, + *, + scheme: str, + hosts: Optional[list[MultiHostHost]] = None, + username: Optional[str] = None, + password: Optional[str] = None, + host: Optional[str] = None, + port: Optional[int] = None, + path: Optional[str] = None, + query: Optional[str] = None, + fragment: Optional[str] = None, + ) -> Self: + """ + Build a new `MultiHostUrl` instance from its component parts. + + This method takes either `hosts` - a list of `MultiHostHost` typed dicts, or the individual components + `username`, `password`, `host` and `port`. + + Args: + scheme: The scheme part of the URL. + hosts: Multiple hosts to build the URL from. + username: The username part of the URL. + password: The password part of the URL. + host: The host part of the URL. + port: The port part of the URL. + path: The path part of the URL. + query: The query part of the URL, or omit for no query. + fragment: The fragment part of the URL, or omit for no fragment. + + Returns: + An instance of `MultiHostUrl` + """ + +@final +class SchemaError(Exception): + """ + Information about errors that occur while building a [`SchemaValidator`][pydantic_core.SchemaValidator] + or [`SchemaSerializer`][pydantic_core.SchemaSerializer]. + """ + + def error_count(self) -> int: + """ + Returns: + The number of errors in the schema. + """ + def errors(self) -> list[ErrorDetails]: + """ + Returns: + A list of [`ErrorDetails`][pydantic_core.ErrorDetails] for each error in the schema. + """ + +@final +class ValidationError(ValueError): + """ + `ValidationError` is the exception raised by `pydantic-core` when validation fails, it contains a list of errors + which detail why validation failed. + """ + + @staticmethod + def from_exception_data( + title: str, + line_errors: list[InitErrorDetails], + input_type: Literal['python', 'json'] = 'python', + hide_input: bool = False, + ) -> ValidationError: + """ + Python constructor for a Validation Error. + + The API for constructing validation errors will probably change in the future, + hence the static method rather than `__init__`. + + Arguments: + title: The title of the error, as used in the heading of `str(validation_error)` + line_errors: A list of [`InitErrorDetails`][pydantic_core.InitErrorDetails] which contain information + about errors that occurred during validation. + input_type: Whether the error is for a Python object or JSON. + hide_input: Whether to hide the input value in the error message. + """ + @property + def title(self) -> str: + """ + The title of the error, as used in the heading of `str(validation_error)`. + """ + def error_count(self) -> int: + """ + Returns: + The number of errors in the validation error. + """ + def errors( + self, *, include_url: bool = True, include_context: bool = True, include_input: bool = True + ) -> list[ErrorDetails]: + """ + Details about each error in the validation error. + + Args: + include_url: Whether to include a URL to documentation on the error each error. + include_context: Whether to include the context of each error. + include_input: Whether to include the input value of each error. + + Returns: + A list of [`ErrorDetails`][pydantic_core.ErrorDetails] for each error in the validation error. + """ + def json( + self, + *, + indent: int | None = None, + include_url: bool = True, + include_context: bool = True, + include_input: bool = True, + ) -> str: + """ + Same as [`errors()`][pydantic_core.ValidationError.errors] but returns a JSON string. + + Args: + indent: The number of spaces to indent the JSON by, or `None` for no indentation - compact JSON. + include_url: Whether to include a URL to documentation on the error each error. + include_context: Whether to include the context of each error. + include_input: Whether to include the input value of each error. + + Returns: + a JSON string. + """ + + def __repr__(self) -> str: + """ + A string representation of the validation error. + + Whether or not documentation URLs are included in the repr is controlled by the + environment variable `PYDANTIC_ERRORS_INCLUDE_URL` being set to `1` or + `true`; by default, URLs are shown. + + Due to implementation details, this environment variable can only be set once, + before the first validation error is created. + """ + +@final +class PydanticCustomError(ValueError): + def __new__( + cls, error_type: LiteralString, message_template: LiteralString, context: dict[str, Any] | None = None + ) -> Self: ... + @property + def context(self) -> dict[str, Any] | None: ... + @property + def type(self) -> str: ... + @property + def message_template(self) -> str: ... + def message(self) -> str: ... + +@final +class PydanticKnownError(ValueError): + def __new__(cls, error_type: ErrorType, context: dict[str, Any] | None = None) -> Self: ... + @property + def context(self) -> dict[str, Any] | None: ... + @property + def type(self) -> ErrorType: ... + @property + def message_template(self) -> str: ... + def message(self) -> str: ... + +@final +class PydanticOmit(Exception): + def __new__(cls) -> Self: ... + +@final +class PydanticUseDefault(Exception): + def __new__(cls) -> Self: ... + +@final +class PydanticSerializationError(ValueError): + def __new__(cls, message: str) -> Self: ... + +@final +class PydanticSerializationUnexpectedValue(ValueError): + def __new__(cls, message: str | None = None) -> Self: ... + +@final +class ArgsKwargs: + def __new__(cls, args: tuple[Any, ...], kwargs: dict[str, Any] | None = None) -> Self: ... + @property + def args(self) -> tuple[Any, ...]: ... + @property + def kwargs(self) -> dict[str, Any] | None: ... + +@final +class PydanticUndefinedType: + def __copy__(self) -> Self: ... + def __deepcopy__(self, memo: Any) -> Self: ... + +PydanticUndefined: PydanticUndefinedType + +def list_all_errors() -> list[ErrorTypeInfo]: + """ + Get information about all built-in errors. + + Returns: + A list of `ErrorTypeInfo` typed dicts. + """ +@final +class TzInfo(datetime.tzinfo): + def tzname(self, _dt: datetime.datetime | None) -> str | None: ... + def utcoffset(self, _dt: datetime.datetime | None) -> datetime.timedelta: ... + def dst(self, _dt: datetime.datetime | None) -> datetime.timedelta: ... + def fromutc(self, dt: datetime.datetime) -> datetime.datetime: ... + def __deepcopy__(self, _memo: dict[Any, Any]) -> 'TzInfo': ... + +def validate_core_schema(schema: CoreSchema, *, strict: bool | None = None) -> CoreSchema: + """Validate a CoreSchema + This currently uses lax mode for validation (i.e. will coerce strings to dates and such) + but may use strict mode in the future. + We may also remove this function altogether, do not rely on it being present if you are + using pydantic-core directly. + """ diff --git a/lib/pydantic_core/core_schema.py b/lib/pydantic_core/core_schema.py new file mode 100644 index 00000000..31bf4878 --- /dev/null +++ b/lib/pydantic_core/core_schema.py @@ -0,0 +1,3980 @@ +""" +This module contains definitions to build schemas which `pydantic_core` can +validate and serialize. +""" + +from __future__ import annotations as _annotations + +import sys +import warnings +from collections.abc import Mapping +from datetime import date, datetime, time, timedelta +from decimal import Decimal +from typing import TYPE_CHECKING, Any, Callable, Dict, Hashable, List, Set, Tuple, Type, Union + +from typing_extensions import deprecated + +if sys.version_info < (3, 12): + from typing_extensions import TypedDict +else: + from typing import TypedDict + +if sys.version_info < (3, 11): + from typing_extensions import Protocol, Required, TypeAlias +else: + from typing import Protocol, Required, TypeAlias + +if sys.version_info < (3, 9): + from typing_extensions import Literal +else: + from typing import Literal + +if TYPE_CHECKING: + from pydantic_core import PydanticUndefined +else: + # The initial build of pydantic_core requires PydanticUndefined to generate + # the core schema; so we need to conditionally skip it. mypy doesn't like + # this at all, hence the TYPE_CHECKING branch above. + try: + from pydantic_core import PydanticUndefined + except ImportError: + PydanticUndefined = object() + + +ExtraBehavior = Literal['allow', 'forbid', 'ignore'] + + +class CoreConfig(TypedDict, total=False): + """ + Base class for schema configuration options. + + Attributes: + title: The name of the configuration. + strict: Whether the configuration should strictly adhere to specified rules. + extra_fields_behavior: The behavior for handling extra fields. + typed_dict_total: Whether the TypedDict should be considered total. Default is `True`. + from_attributes: Whether to use attributes for models, dataclasses, and tagged union keys. + loc_by_alias: Whether to use the used alias (or first alias for "field required" errors) instead of + `field_names` to construct error `loc`s. Default is `True`. + revalidate_instances: Whether instances of models and dataclasses should re-validate. Default is 'never'. + validate_default: Whether to validate default values during validation. Default is `False`. + populate_by_name: Whether an aliased field may be populated by its name as given by the model attribute, + as well as the alias. (Replaces 'allow_population_by_field_name' in Pydantic v1.) Default is `False`. + str_max_length: The maximum length for string fields. + str_min_length: The minimum length for string fields. + str_strip_whitespace: Whether to strip whitespace from string fields. + str_to_lower: Whether to convert string fields to lowercase. + str_to_upper: Whether to convert string fields to uppercase. + allow_inf_nan: Whether to allow infinity and NaN values for float fields. Default is `True`. + ser_json_timedelta: The serialization option for `timedelta` values. Default is 'iso8601'. + ser_json_bytes: The serialization option for `bytes` values. Default is 'utf8'. + ser_json_inf_nan: The serialization option for infinity and NaN values + in float fields. Default is 'null'. + hide_input_in_errors: Whether to hide input data from `ValidationError` representation. + validation_error_cause: Whether to add user-python excs to the __cause__ of a ValidationError. + Requires exceptiongroup backport pre Python 3.11. + coerce_numbers_to_str: Whether to enable coercion of any `Number` type to `str` (not applicable in `strict` mode). + regex_engine: The regex engine to use for regex pattern validation. Default is 'rust-regex'. See `StringSchema`. + """ + + title: str + strict: bool + # settings related to typed dicts, model fields, dataclass fields + extra_fields_behavior: ExtraBehavior + typed_dict_total: bool # default: True + # used for models, dataclasses, and tagged union keys + from_attributes: bool + # whether to use the used alias (or first alias for "field required" errors) instead of field_names + # to construct error `loc`s, default True + loc_by_alias: bool + # whether instances of models and dataclasses (including subclass instances) should re-validate, default 'never' + revalidate_instances: Literal['always', 'never', 'subclass-instances'] + # whether to validate default values during validation, default False + validate_default: bool + # used on typed-dicts and arguments + populate_by_name: bool # replaces `allow_population_by_field_name` in pydantic v1 + # fields related to string fields only + str_max_length: int + str_min_length: int + str_strip_whitespace: bool + str_to_lower: bool + str_to_upper: bool + # fields related to float fields only + allow_inf_nan: bool # default: True + # the config options are used to customise serialization to JSON + ser_json_timedelta: Literal['iso8601', 'float'] # default: 'iso8601' + ser_json_bytes: Literal['utf8', 'base64', 'hex'] # default: 'utf8' + ser_json_inf_nan: Literal['null', 'constants'] # default: 'null' + # used to hide input data from ValidationError repr + hide_input_in_errors: bool + validation_error_cause: bool # default: False + coerce_numbers_to_str: bool # default: False + regex_engine: Literal['rust-regex', 'python-re'] # default: 'rust-regex' + + +IncExCall: TypeAlias = 'set[int | str] | dict[int | str, IncExCall] | None' + + +class SerializationInfo(Protocol): + @property + def include(self) -> IncExCall: + ... + + @property + def exclude(self) -> IncExCall: + ... + + @property + def mode(self) -> str: + ... + + @property + def by_alias(self) -> bool: + ... + + @property + def exclude_unset(self) -> bool: + ... + + @property + def exclude_defaults(self) -> bool: + ... + + @property + def exclude_none(self) -> bool: + ... + + @property + def round_trip(self) -> bool: + ... + + def mode_is_json(self) -> bool: + ... + + def __str__(self) -> str: + ... + + def __repr__(self) -> str: + ... + + +class FieldSerializationInfo(SerializationInfo, Protocol): + @property + def field_name(self) -> str: + ... + + +class ValidationInfo(Protocol): + """ + Argument passed to validation functions. + """ + + @property + def context(self) -> Any | None: + """Current validation context.""" + ... + + @property + def config(self) -> CoreConfig | None: + """The CoreConfig that applies to this validation.""" + ... + + @property + def mode(self) -> Literal['python', 'json']: + """The type of input data we are currently validating""" + ... + + @property + def data(self) -> Dict[str, Any]: + """The data being validated for this model.""" + ... + + @property + def field_name(self) -> str | None: + """ + The name of the current field being validated if this validator is + attached to a model field. + """ + ... + + +ExpectedSerializationTypes = Literal[ + 'none', + 'int', + 'bool', + 'float', + 'str', + 'bytes', + 'bytearray', + 'list', + 'tuple', + 'set', + 'frozenset', + 'generator', + 'dict', + 'datetime', + 'date', + 'time', + 'timedelta', + 'url', + 'multi-host-url', + 'json', + 'uuid', +] + + +class SimpleSerSchema(TypedDict, total=False): + type: Required[ExpectedSerializationTypes] + + +def simple_ser_schema(type: ExpectedSerializationTypes) -> SimpleSerSchema: + """ + Returns a schema for serialization with a custom type. + + Args: + type: The type to use for serialization + """ + return SimpleSerSchema(type=type) + + +# (__input_value: Any) -> Any +GeneralPlainNoInfoSerializerFunction = Callable[[Any], Any] +# (__input_value: Any, __info: FieldSerializationInfo) -> Any +GeneralPlainInfoSerializerFunction = Callable[[Any, SerializationInfo], Any] +# (__model: Any, __input_value: Any) -> Any +FieldPlainNoInfoSerializerFunction = Callable[[Any, Any], Any] +# (__model: Any, __input_value: Any, __info: FieldSerializationInfo) -> Any +FieldPlainInfoSerializerFunction = Callable[[Any, Any, FieldSerializationInfo], Any] +SerializerFunction = Union[ + GeneralPlainNoInfoSerializerFunction, + GeneralPlainInfoSerializerFunction, + FieldPlainNoInfoSerializerFunction, + FieldPlainInfoSerializerFunction, +] + +WhenUsed = Literal['always', 'unless-none', 'json', 'json-unless-none'] +""" +Values have the following meanings: + +* `'always'` means always use +* `'unless-none'` means use unless the value is `None` +* `'json'` means use when serializing to JSON +* `'json-unless-none'` means use when serializing to JSON and the value is not `None` +""" + + +class PlainSerializerFunctionSerSchema(TypedDict, total=False): + type: Required[Literal['function-plain']] + function: Required[SerializerFunction] + is_field_serializer: bool # default False + info_arg: bool # default False + return_schema: CoreSchema # if omitted, AnySchema is used + when_used: WhenUsed # default: 'always' + + +def plain_serializer_function_ser_schema( + function: SerializerFunction, + *, + is_field_serializer: bool | None = None, + info_arg: bool | None = None, + return_schema: CoreSchema | None = None, + when_used: WhenUsed = 'always', +) -> PlainSerializerFunctionSerSchema: + """ + Returns a schema for serialization with a function, can be either a "general" or "field" function. + + Args: + function: The function to use for serialization + is_field_serializer: Whether the serializer is for a field, e.g. takes `model` as the first argument, + and `info` includes `field_name` + info_arg: Whether the function takes an `__info` argument + return_schema: Schema to use for serializing return value + when_used: When the function should be called + """ + if when_used == 'always': + # just to avoid extra elements in schema, and to use the actual default defined in rust + when_used = None # type: ignore + return _dict_not_none( + type='function-plain', + function=function, + is_field_serializer=is_field_serializer, + info_arg=info_arg, + return_schema=return_schema, + when_used=when_used, + ) + + +class SerializerFunctionWrapHandler(Protocol): # pragma: no cover + def __call__(self, __input_value: Any, __index_key: int | str | None = None) -> Any: + ... + + +# (__input_value: Any, __serializer: SerializerFunctionWrapHandler) -> Any +GeneralWrapNoInfoSerializerFunction = Callable[[Any, SerializerFunctionWrapHandler], Any] +# (__input_value: Any, __serializer: SerializerFunctionWrapHandler, __info: SerializationInfo) -> Any +GeneralWrapInfoSerializerFunction = Callable[[Any, SerializerFunctionWrapHandler, SerializationInfo], Any] +# (__model: Any, __input_value: Any, __serializer: SerializerFunctionWrapHandler) -> Any +FieldWrapNoInfoSerializerFunction = Callable[[Any, Any, SerializerFunctionWrapHandler], Any] +# (__model: Any, __input_value: Any, __serializer: SerializerFunctionWrapHandler, __info: FieldSerializationInfo) -> Any +FieldWrapInfoSerializerFunction = Callable[[Any, Any, SerializerFunctionWrapHandler, FieldSerializationInfo], Any] +WrapSerializerFunction = Union[ + GeneralWrapNoInfoSerializerFunction, + GeneralWrapInfoSerializerFunction, + FieldWrapNoInfoSerializerFunction, + FieldWrapInfoSerializerFunction, +] + + +class WrapSerializerFunctionSerSchema(TypedDict, total=False): + type: Required[Literal['function-wrap']] + function: Required[WrapSerializerFunction] + is_field_serializer: bool # default False + info_arg: bool # default False + schema: CoreSchema # if omitted, the schema on which this serializer is defined is used + return_schema: CoreSchema # if omitted, AnySchema is used + when_used: WhenUsed # default: 'always' + + +def wrap_serializer_function_ser_schema( + function: WrapSerializerFunction, + *, + is_field_serializer: bool | None = None, + info_arg: bool | None = None, + schema: CoreSchema | None = None, + return_schema: CoreSchema | None = None, + when_used: WhenUsed = 'always', +) -> WrapSerializerFunctionSerSchema: + """ + Returns a schema for serialization with a wrap function, can be either a "general" or "field" function. + + Args: + function: The function to use for serialization + is_field_serializer: Whether the serializer is for a field, e.g. takes `model` as the first argument, + and `info` includes `field_name` + info_arg: Whether the function takes an `__info` argument + schema: The schema to use for the inner serialization + return_schema: Schema to use for serializing return value + when_used: When the function should be called + """ + if when_used == 'always': + # just to avoid extra elements in schema, and to use the actual default defined in rust + when_used = None # type: ignore + return _dict_not_none( + type='function-wrap', + function=function, + is_field_serializer=is_field_serializer, + info_arg=info_arg, + schema=schema, + return_schema=return_schema, + when_used=when_used, + ) + + +class FormatSerSchema(TypedDict, total=False): + type: Required[Literal['format']] + formatting_string: Required[str] + when_used: WhenUsed # default: 'json-unless-none' + + +def format_ser_schema(formatting_string: str, *, when_used: WhenUsed = 'json-unless-none') -> FormatSerSchema: + """ + Returns a schema for serialization using python's `format` method. + + Args: + formatting_string: String defining the format to use + when_used: Same meaning as for [general_function_plain_ser_schema], but with a different default + """ + if when_used == 'json-unless-none': + # just to avoid extra elements in schema, and to use the actual default defined in rust + when_used = None # type: ignore + return _dict_not_none(type='format', formatting_string=formatting_string, when_used=when_used) + + +class ToStringSerSchema(TypedDict, total=False): + type: Required[Literal['to-string']] + when_used: WhenUsed # default: 'json-unless-none' + + +def to_string_ser_schema(*, when_used: WhenUsed = 'json-unless-none') -> ToStringSerSchema: + """ + Returns a schema for serialization using python's `str()` / `__str__` method. + + Args: + when_used: Same meaning as for [general_function_plain_ser_schema], but with a different default + """ + s = dict(type='to-string') + if when_used != 'json-unless-none': + # just to avoid extra elements in schema, and to use the actual default defined in rust + s['when_used'] = when_used + return s # type: ignore + + +class ModelSerSchema(TypedDict, total=False): + type: Required[Literal['model']] + cls: Required[Type[Any]] + schema: Required[CoreSchema] + + +def model_ser_schema(cls: Type[Any], schema: CoreSchema) -> ModelSerSchema: + """ + Returns a schema for serialization using a model. + + Args: + cls: The expected class type, used to generate warnings if the wrong type is passed + schema: Internal schema to use to serialize the model dict + """ + return ModelSerSchema(type='model', cls=cls, schema=schema) + + +SerSchema = Union[ + SimpleSerSchema, + PlainSerializerFunctionSerSchema, + WrapSerializerFunctionSerSchema, + FormatSerSchema, + ToStringSerSchema, + ModelSerSchema, +] + + +class ComputedField(TypedDict, total=False): + type: Required[Literal['computed-field']] + property_name: Required[str] + return_schema: Required[CoreSchema] + alias: str + metadata: Any + + +def computed_field( + property_name: str, return_schema: CoreSchema, *, alias: str | None = None, metadata: Any = None +) -> ComputedField: + """ + ComputedFields are properties of a model or dataclass that are included in serialization. + + Args: + property_name: The name of the property on the model or dataclass + return_schema: The schema used for the type returned by the computed field + alias: The name to use in the serialized output + metadata: Any other information you want to include with the schema, not used by pydantic-core + """ + return _dict_not_none( + type='computed-field', property_name=property_name, return_schema=return_schema, alias=alias, metadata=metadata + ) + + +class AnySchema(TypedDict, total=False): + type: Required[Literal['any']] + ref: str + metadata: Any + serialization: SerSchema + + +def any_schema(*, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None) -> AnySchema: + """ + Returns a schema that matches any value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.any_schema() + v = SchemaValidator(schema) + assert v.validate_python(1) == 1 + ``` + + Args: + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none(type='any', ref=ref, metadata=metadata, serialization=serialization) + + +class NoneSchema(TypedDict, total=False): + type: Required[Literal['none']] + ref: str + metadata: Any + serialization: SerSchema + + +def none_schema(*, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None) -> NoneSchema: + """ + Returns a schema that matches a None value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.none_schema() + v = SchemaValidator(schema) + assert v.validate_python(None) is None + ``` + + Args: + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none(type='none', ref=ref, metadata=metadata, serialization=serialization) + + +class BoolSchema(TypedDict, total=False): + type: Required[Literal['bool']] + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def bool_schema( + strict: bool | None = None, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None +) -> BoolSchema: + """ + Returns a schema that matches a bool value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.bool_schema() + v = SchemaValidator(schema) + assert v.validate_python('True') is True + ``` + + Args: + strict: Whether the value should be a bool or a value that can be converted to a bool + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none(type='bool', strict=strict, ref=ref, metadata=metadata, serialization=serialization) + + +class IntSchema(TypedDict, total=False): + type: Required[Literal['int']] + multiple_of: int + le: int + ge: int + lt: int + gt: int + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def int_schema( + *, + multiple_of: int | None = None, + le: int | None = None, + ge: int | None = None, + lt: int | None = None, + gt: int | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> IntSchema: + """ + Returns a schema that matches a int value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.int_schema(multiple_of=2, le=6, ge=2) + v = SchemaValidator(schema) + assert v.validate_python('4') == 4 + ``` + + Args: + multiple_of: The value must be a multiple of this number + le: The value must be less than or equal to this number + ge: The value must be greater than or equal to this number + lt: The value must be strictly less than this number + gt: The value must be strictly greater than this number + strict: Whether the value should be a int or a value that can be converted to a int + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='int', + multiple_of=multiple_of, + le=le, + ge=ge, + lt=lt, + gt=gt, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class FloatSchema(TypedDict, total=False): + type: Required[Literal['float']] + allow_inf_nan: bool # whether 'NaN', '+inf', '-inf' should be forbidden. default: True + multiple_of: float + le: float + ge: float + lt: float + gt: float + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def float_schema( + *, + allow_inf_nan: bool | None = None, + multiple_of: float | None = None, + le: float | None = None, + ge: float | None = None, + lt: float | None = None, + gt: float | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> FloatSchema: + """ + Returns a schema that matches a float value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.float_schema(le=0.8, ge=0.2) + v = SchemaValidator(schema) + assert v.validate_python('0.5') == 0.5 + ``` + + Args: + allow_inf_nan: Whether to allow inf and nan values + multiple_of: The value must be a multiple of this number + le: The value must be less than or equal to this number + ge: The value must be greater than or equal to this number + lt: The value must be strictly less than this number + gt: The value must be strictly greater than this number + strict: Whether the value should be a float or a value that can be converted to a float + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='float', + allow_inf_nan=allow_inf_nan, + multiple_of=multiple_of, + le=le, + ge=ge, + lt=lt, + gt=gt, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class DecimalSchema(TypedDict, total=False): + type: Required[Literal['decimal']] + allow_inf_nan: bool # whether 'NaN', '+inf', '-inf' should be forbidden. default: False + multiple_of: Decimal + le: Decimal + ge: Decimal + lt: Decimal + gt: Decimal + max_digits: int + decimal_places: int + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def decimal_schema( + *, + allow_inf_nan: bool = None, + multiple_of: Decimal | None = None, + le: Decimal | None = None, + ge: Decimal | None = None, + lt: Decimal | None = None, + gt: Decimal | None = None, + max_digits: int | None = None, + decimal_places: int | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> DecimalSchema: + """ + Returns a schema that matches a decimal value, e.g.: + + ```py + from decimal import Decimal + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.decimal_schema(le=0.8, ge=0.2) + v = SchemaValidator(schema) + assert v.validate_python('0.5') == Decimal('0.5') + ``` + + Args: + allow_inf_nan: Whether to allow inf and nan values + multiple_of: The value must be a multiple of this number + le: The value must be less than or equal to this number + ge: The value must be greater than or equal to this number + lt: The value must be strictly less than this number + gt: The value must be strictly greater than this number + max_digits: The maximum number of decimal digits allowed + decimal_places: The maximum number of decimal places allowed + strict: Whether the value should be a float or a value that can be converted to a float + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='decimal', + gt=gt, + ge=ge, + lt=lt, + le=le, + max_digits=max_digits, + decimal_places=decimal_places, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class StringSchema(TypedDict, total=False): + type: Required[Literal['str']] + pattern: str + max_length: int + min_length: int + strip_whitespace: bool + to_lower: bool + to_upper: bool + regex_engine: Literal['rust-regex', 'python-re'] # default: 'rust-regex' + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def str_schema( + *, + pattern: str | None = None, + max_length: int | None = None, + min_length: int | None = None, + strip_whitespace: bool | None = None, + to_lower: bool | None = None, + to_upper: bool | None = None, + regex_engine: Literal['rust-regex', 'python-re'] | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> StringSchema: + """ + Returns a schema that matches a string value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.str_schema(max_length=10, min_length=2) + v = SchemaValidator(schema) + assert v.validate_python('hello') == 'hello' + ``` + + Args: + pattern: A regex pattern that the value must match + max_length: The value must be at most this length + min_length: The value must be at least this length + strip_whitespace: Whether to strip whitespace from the value + to_lower: Whether to convert the value to lowercase + to_upper: Whether to convert the value to uppercase + regex_engine: The regex engine to use for pattern validation. Default is 'rust-regex'. + - `rust-regex` uses the [`regex`](https://docs.rs/regex) Rust + crate, which is non-backtracking and therefore more DDoS + resistant, but does not support all regex features. + - `python-re` use the [`re`](https://docs.python.org/3/library/re.html) module, + which supports all regex features, but may be slower. + strict: Whether the value should be a string or a value that can be converted to a string + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='str', + pattern=pattern, + max_length=max_length, + min_length=min_length, + strip_whitespace=strip_whitespace, + to_lower=to_lower, + to_upper=to_upper, + regex_engine=regex_engine, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class BytesSchema(TypedDict, total=False): + type: Required[Literal['bytes']] + max_length: int + min_length: int + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def bytes_schema( + *, + max_length: int | None = None, + min_length: int | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> BytesSchema: + """ + Returns a schema that matches a bytes value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.bytes_schema(max_length=10, min_length=2) + v = SchemaValidator(schema) + assert v.validate_python(b'hello') == b'hello' + ``` + + Args: + max_length: The value must be at most this length + min_length: The value must be at least this length + strict: Whether the value should be a bytes or a value that can be converted to a bytes + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='bytes', + max_length=max_length, + min_length=min_length, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class DateSchema(TypedDict, total=False): + type: Required[Literal['date']] + strict: bool + le: date + ge: date + lt: date + gt: date + now_op: Literal['past', 'future'] + # defaults to current local utc offset from `time.localtime().tm_gmtoff` + # value is restricted to -86_400 < offset < 86_400 by bounds in generate_self_schema.py + now_utc_offset: int + ref: str + metadata: Any + serialization: SerSchema + + +def date_schema( + *, + strict: bool | None = None, + le: date | None = None, + ge: date | None = None, + lt: date | None = None, + gt: date | None = None, + now_op: Literal['past', 'future'] | None = None, + now_utc_offset: int | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> DateSchema: + """ + Returns a schema that matches a date value, e.g.: + + ```py + from datetime import date + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.date_schema(le=date(2020, 1, 1), ge=date(2019, 1, 1)) + v = SchemaValidator(schema) + assert v.validate_python(date(2019, 6, 1)) == date(2019, 6, 1) + ``` + + Args: + strict: Whether the value should be a date or a value that can be converted to a date + le: The value must be less than or equal to this date + ge: The value must be greater than or equal to this date + lt: The value must be strictly less than this date + gt: The value must be strictly greater than this date + now_op: The value must be in the past or future relative to the current date + now_utc_offset: The value must be in the past or future relative to the current date with this utc offset + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='date', + strict=strict, + le=le, + ge=ge, + lt=lt, + gt=gt, + now_op=now_op, + now_utc_offset=now_utc_offset, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class TimeSchema(TypedDict, total=False): + type: Required[Literal['time']] + strict: bool + le: time + ge: time + lt: time + gt: time + tz_constraint: Union[Literal['aware', 'naive'], int] + microseconds_precision: Literal['truncate', 'error'] + ref: str + metadata: Any + serialization: SerSchema + + +def time_schema( + *, + strict: bool | None = None, + le: time | None = None, + ge: time | None = None, + lt: time | None = None, + gt: time | None = None, + tz_constraint: Literal['aware', 'naive'] | int | None = None, + microseconds_precision: Literal['truncate', 'error'] = 'truncate', + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> TimeSchema: + """ + Returns a schema that matches a time value, e.g.: + + ```py + from datetime import time + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.time_schema(le=time(12, 0, 0), ge=time(6, 0, 0)) + v = SchemaValidator(schema) + assert v.validate_python(time(9, 0, 0)) == time(9, 0, 0) + ``` + + Args: + strict: Whether the value should be a time or a value that can be converted to a time + le: The value must be less than or equal to this time + ge: The value must be greater than or equal to this time + lt: The value must be strictly less than this time + gt: The value must be strictly greater than this time + tz_constraint: The value must be timezone aware or naive, or an int to indicate required tz offset + microseconds_precision: The behavior when seconds have more than 6 digits or microseconds is too large + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='time', + strict=strict, + le=le, + ge=ge, + lt=lt, + gt=gt, + tz_constraint=tz_constraint, + microseconds_precision=microseconds_precision, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class DatetimeSchema(TypedDict, total=False): + type: Required[Literal['datetime']] + strict: bool + le: datetime + ge: datetime + lt: datetime + gt: datetime + now_op: Literal['past', 'future'] + tz_constraint: Union[Literal['aware', 'naive'], int] + # defaults to current local utc offset from `time.localtime().tm_gmtoff` + # value is restricted to -86_400 < offset < 86_400 by bounds in generate_self_schema.py + now_utc_offset: int + microseconds_precision: Literal['truncate', 'error'] # default: 'truncate' + ref: str + metadata: Any + serialization: SerSchema + + +def datetime_schema( + *, + strict: bool | None = None, + le: datetime | None = None, + ge: datetime | None = None, + lt: datetime | None = None, + gt: datetime | None = None, + now_op: Literal['past', 'future'] | None = None, + tz_constraint: Literal['aware', 'naive'] | int | None = None, + now_utc_offset: int | None = None, + microseconds_precision: Literal['truncate', 'error'] = 'truncate', + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> DatetimeSchema: + """ + Returns a schema that matches a datetime value, e.g.: + + ```py + from datetime import datetime + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.datetime_schema() + v = SchemaValidator(schema) + now = datetime.now() + assert v.validate_python(str(now)) == now + ``` + + Args: + strict: Whether the value should be a datetime or a value that can be converted to a datetime + le: The value must be less than or equal to this datetime + ge: The value must be greater than or equal to this datetime + lt: The value must be strictly less than this datetime + gt: The value must be strictly greater than this datetime + now_op: The value must be in the past or future relative to the current datetime + tz_constraint: The value must be timezone aware or naive, or an int to indicate required tz offset + TODO: use of a tzinfo where offset changes based on the datetime is not yet supported + now_utc_offset: The value must be in the past or future relative to the current datetime with this utc offset + microseconds_precision: The behavior when seconds have more than 6 digits or microseconds is too large + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='datetime', + strict=strict, + le=le, + ge=ge, + lt=lt, + gt=gt, + now_op=now_op, + tz_constraint=tz_constraint, + now_utc_offset=now_utc_offset, + microseconds_precision=microseconds_precision, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class TimedeltaSchema(TypedDict, total=False): + type: Required[Literal['timedelta']] + strict: bool + le: timedelta + ge: timedelta + lt: timedelta + gt: timedelta + microseconds_precision: Literal['truncate', 'error'] + ref: str + metadata: Any + serialization: SerSchema + + +def timedelta_schema( + *, + strict: bool | None = None, + le: timedelta | None = None, + ge: timedelta | None = None, + lt: timedelta | None = None, + gt: timedelta | None = None, + microseconds_precision: Literal['truncate', 'error'] = 'truncate', + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> TimedeltaSchema: + """ + Returns a schema that matches a timedelta value, e.g.: + + ```py + from datetime import timedelta + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.timedelta_schema(le=timedelta(days=1), ge=timedelta(days=0)) + v = SchemaValidator(schema) + assert v.validate_python(timedelta(hours=12)) == timedelta(hours=12) + ``` + + Args: + strict: Whether the value should be a timedelta or a value that can be converted to a timedelta + le: The value must be less than or equal to this timedelta + ge: The value must be greater than or equal to this timedelta + lt: The value must be strictly less than this timedelta + gt: The value must be strictly greater than this timedelta + microseconds_precision: The behavior when seconds have more than 6 digits or microseconds is too large + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='timedelta', + strict=strict, + le=le, + ge=ge, + lt=lt, + gt=gt, + microseconds_precision=microseconds_precision, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class LiteralSchema(TypedDict, total=False): + type: Required[Literal['literal']] + expected: Required[List[Any]] + ref: str + metadata: Any + serialization: SerSchema + + +def literal_schema( + expected: list[Any], *, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None +) -> LiteralSchema: + """ + Returns a schema that matches a literal value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.literal_schema(['hello', 'world']) + v = SchemaValidator(schema) + assert v.validate_python('hello') == 'hello' + ``` + + Args: + expected: The value must be one of these values + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none(type='literal', expected=expected, ref=ref, metadata=metadata, serialization=serialization) + + +# must match input/parse_json.rs::JsonType::try_from +JsonType = Literal['null', 'bool', 'int', 'float', 'str', 'list', 'dict'] + + +class IsInstanceSchema(TypedDict, total=False): + type: Required[Literal['is-instance']] + cls: Required[Any] + cls_repr: str + ref: str + metadata: Any + serialization: SerSchema + + +def is_instance_schema( + cls: Any, + *, + cls_repr: str | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> IsInstanceSchema: + """ + Returns a schema that checks if a value is an instance of a class, equivalent to python's `isinstance` method, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + class A: + pass + + schema = core_schema.is_instance_schema(cls=A) + v = SchemaValidator(schema) + v.validate_python(A()) + ``` + + Args: + cls: The value must be an instance of this class + cls_repr: If provided this string is used in the validator name instead of `repr(cls)` + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='is-instance', cls=cls, cls_repr=cls_repr, ref=ref, metadata=metadata, serialization=serialization + ) + + +class IsSubclassSchema(TypedDict, total=False): + type: Required[Literal['is-subclass']] + cls: Required[Type[Any]] + cls_repr: str + ref: str + metadata: Any + serialization: SerSchema + + +def is_subclass_schema( + cls: Type[Any], + *, + cls_repr: str | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> IsInstanceSchema: + """ + Returns a schema that checks if a value is a subtype of a class, equivalent to python's `issubclass` method, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + class A: + pass + + class B(A): + pass + + schema = core_schema.is_subclass_schema(cls=A) + v = SchemaValidator(schema) + v.validate_python(B) + ``` + + Args: + cls: The value must be a subclass of this class + cls_repr: If provided this string is used in the validator name instead of `repr(cls)` + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='is-subclass', cls=cls, cls_repr=cls_repr, ref=ref, metadata=metadata, serialization=serialization + ) + + +class CallableSchema(TypedDict, total=False): + type: Required[Literal['callable']] + ref: str + metadata: Any + serialization: SerSchema + + +def callable_schema( + *, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None +) -> CallableSchema: + """ + Returns a schema that checks if a value is callable, equivalent to python's `callable` method, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.callable_schema() + v = SchemaValidator(schema) + v.validate_python(min) + ``` + + Args: + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none(type='callable', ref=ref, metadata=metadata, serialization=serialization) + + +class UuidSchema(TypedDict, total=False): + type: Required[Literal['uuid']] + version: Literal[1, 3, 4, 5] + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def uuid_schema( + *, + version: Literal[1, 3, 4, 5] | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> UuidSchema: + return _dict_not_none( + type='uuid', version=version, strict=strict, ref=ref, metadata=metadata, serialization=serialization + ) + + +class IncExSeqSerSchema(TypedDict, total=False): + type: Required[Literal['include-exclude-sequence']] + include: Set[int] + exclude: Set[int] + + +def filter_seq_schema(*, include: Set[int] | None = None, exclude: Set[int] | None = None) -> IncExSeqSerSchema: + return _dict_not_none(type='include-exclude-sequence', include=include, exclude=exclude) + + +IncExSeqOrElseSerSchema = Union[IncExSeqSerSchema, SerSchema] + + +class ListSchema(TypedDict, total=False): + type: Required[Literal['list']] + items_schema: CoreSchema + min_length: int + max_length: int + strict: bool + ref: str + metadata: Any + serialization: IncExSeqOrElseSerSchema + + +def list_schema( + items_schema: CoreSchema | None = None, + *, + min_length: int | None = None, + max_length: int | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: IncExSeqOrElseSerSchema | None = None, +) -> ListSchema: + """ + Returns a schema that matches a list value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.list_schema(core_schema.int_schema(), min_length=0, max_length=10) + v = SchemaValidator(schema) + assert v.validate_python(['4']) == [4] + ``` + + Args: + items_schema: The value must be a list of items that match this schema + min_length: The value must be a list with at least this many items + max_length: The value must be a list with at most this many items + strict: The value must be a list with exactly this many items + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='list', + items_schema=items_schema, + min_length=min_length, + max_length=max_length, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +# @deprecated('tuple_positional_schema is deprecated. Use pydantic_core.core_schema.tuple_schema instead.') +def tuple_positional_schema( + items_schema: list[CoreSchema], + *, + extras_schema: CoreSchema | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: IncExSeqOrElseSerSchema | None = None, +) -> TupleSchema: + """ + Returns a schema that matches a tuple of schemas, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.tuple_positional_schema( + [core_schema.int_schema(), core_schema.str_schema()] + ) + v = SchemaValidator(schema) + assert v.validate_python((1, 'hello')) == (1, 'hello') + ``` + + Args: + items_schema: The value must be a tuple with items that match these schemas + extras_schema: The value must be a tuple with items that match this schema + This was inspired by JSON schema's `prefixItems` and `items` fields. + In python's `typing.Tuple`, you can't specify a type for "extra" items -- they must all be the same type + if the length is variable. So this field won't be set from a `typing.Tuple` annotation on a pydantic model. + strict: The value must be a tuple with exactly this many items + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + if extras_schema is not None: + variadic_item_index = len(items_schema) + items_schema = items_schema + [extras_schema] + else: + variadic_item_index = None + return tuple_schema( + items_schema=items_schema, + variadic_item_index=variadic_item_index, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +# @deprecated('tuple_variable_schema is deprecated. Use pydantic_core.core_schema.tuple_schema instead.') +def tuple_variable_schema( + items_schema: CoreSchema | None = None, + *, + min_length: int | None = None, + max_length: int | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: IncExSeqOrElseSerSchema | None = None, +) -> TupleSchema: + """ + Returns a schema that matches a tuple of a given schema, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.tuple_variable_schema( + items_schema=core_schema.int_schema(), min_length=0, max_length=10 + ) + v = SchemaValidator(schema) + assert v.validate_python(('1', 2, 3)) == (1, 2, 3) + ``` + + Args: + items_schema: The value must be a tuple with items that match this schema + min_length: The value must be a tuple with at least this many items + max_length: The value must be a tuple with at most this many items + strict: The value must be a tuple with exactly this many items + ref: Optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return tuple_schema( + items_schema=[items_schema or any_schema()], + variadic_item_index=0, + min_length=min_length, + max_length=max_length, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class TupleSchema(TypedDict, total=False): + type: Required[Literal['tuple']] + items_schema: Required[List[CoreSchema]] + variadic_item_index: int + min_length: int + max_length: int + strict: bool + ref: str + metadata: Any + serialization: IncExSeqOrElseSerSchema + + +def tuple_schema( + items_schema: list[CoreSchema], + *, + variadic_item_index: int | None = None, + min_length: int | None = None, + max_length: int | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: IncExSeqOrElseSerSchema | None = None, +) -> TupleSchema: + """ + Returns a schema that matches a tuple of schemas, with an optional variadic item, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.tuple_schema( + [core_schema.int_schema(), core_schema.str_schema(), core_schema.float_schema()], + variadic_item_index=1, + ) + v = SchemaValidator(schema) + assert v.validate_python((1, 'hello', 'world', 1.5)) == (1, 'hello', 'world', 1.5) + ``` + + Args: + items_schema: The value must be a tuple with items that match these schemas + variadic_item_index: The index of the schema in `items_schema` to be treated as variadic (following PEP 646) + min_length: The value must be a tuple with at least this many items + max_length: The value must be a tuple with at most this many items + strict: The value must be a tuple with exactly this many items + ref: Optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='tuple', + items_schema=items_schema, + variadic_item_index=variadic_item_index, + min_length=min_length, + max_length=max_length, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class SetSchema(TypedDict, total=False): + type: Required[Literal['set']] + items_schema: CoreSchema + min_length: int + max_length: int + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def set_schema( + items_schema: CoreSchema | None = None, + *, + min_length: int | None = None, + max_length: int | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> SetSchema: + """ + Returns a schema that matches a set of a given schema, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.set_schema( + items_schema=core_schema.int_schema(), min_length=0, max_length=10 + ) + v = SchemaValidator(schema) + assert v.validate_python({1, '2', 3}) == {1, 2, 3} + ``` + + Args: + items_schema: The value must be a set with items that match this schema + min_length: The value must be a set with at least this many items + max_length: The value must be a set with at most this many items + strict: The value must be a set with exactly this many items + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='set', + items_schema=items_schema, + min_length=min_length, + max_length=max_length, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class FrozenSetSchema(TypedDict, total=False): + type: Required[Literal['frozenset']] + items_schema: CoreSchema + min_length: int + max_length: int + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def frozenset_schema( + items_schema: CoreSchema | None = None, + *, + min_length: int | None = None, + max_length: int | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> FrozenSetSchema: + """ + Returns a schema that matches a frozenset of a given schema, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.frozenset_schema( + items_schema=core_schema.int_schema(), min_length=0, max_length=10 + ) + v = SchemaValidator(schema) + assert v.validate_python(frozenset(range(3))) == frozenset({0, 1, 2}) + ``` + + Args: + items_schema: The value must be a frozenset with items that match this schema + min_length: The value must be a frozenset with at least this many items + max_length: The value must be a frozenset with at most this many items + strict: The value must be a frozenset with exactly this many items + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='frozenset', + items_schema=items_schema, + min_length=min_length, + max_length=max_length, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class GeneratorSchema(TypedDict, total=False): + type: Required[Literal['generator']] + items_schema: CoreSchema + min_length: int + max_length: int + ref: str + metadata: Any + serialization: IncExSeqOrElseSerSchema + + +def generator_schema( + items_schema: CoreSchema | None = None, + *, + min_length: int | None = None, + max_length: int | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: IncExSeqOrElseSerSchema | None = None, +) -> GeneratorSchema: + """ + Returns a schema that matches a generator value, e.g.: + + ```py + from typing import Iterator + from pydantic_core import SchemaValidator, core_schema + + def gen() -> Iterator[int]: + yield 1 + + schema = core_schema.generator_schema(items_schema=core_schema.int_schema()) + v = SchemaValidator(schema) + v.validate_python(gen()) + ``` + + Unlike other types, validated generators do not raise ValidationErrors eagerly, + but instead will raise a ValidationError when a violating value is actually read from the generator. + This is to ensure that "validated" generators retain the benefit of lazy evaluation. + + Args: + items_schema: The value must be a generator with items that match this schema + min_length: The value must be a generator that yields at least this many items + max_length: The value must be a generator that yields at most this many items + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='generator', + items_schema=items_schema, + min_length=min_length, + max_length=max_length, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +IncExDict = Set[Union[int, str]] + + +class IncExDictSerSchema(TypedDict, total=False): + type: Required[Literal['include-exclude-dict']] + include: IncExDict + exclude: IncExDict + + +def filter_dict_schema(*, include: IncExDict | None = None, exclude: IncExDict | None = None) -> IncExDictSerSchema: + return _dict_not_none(type='include-exclude-dict', include=include, exclude=exclude) + + +IncExDictOrElseSerSchema = Union[IncExDictSerSchema, SerSchema] + + +class DictSchema(TypedDict, total=False): + type: Required[Literal['dict']] + keys_schema: CoreSchema # default: AnySchema + values_schema: CoreSchema # default: AnySchema + min_length: int + max_length: int + strict: bool + ref: str + metadata: Any + serialization: IncExDictOrElseSerSchema + + +def dict_schema( + keys_schema: CoreSchema | None = None, + values_schema: CoreSchema | None = None, + *, + min_length: int | None = None, + max_length: int | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> DictSchema: + """ + Returns a schema that matches a dict value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.dict_schema( + keys_schema=core_schema.str_schema(), values_schema=core_schema.int_schema() + ) + v = SchemaValidator(schema) + assert v.validate_python({'a': '1', 'b': 2}) == {'a': 1, 'b': 2} + ``` + + Args: + keys_schema: The value must be a dict with keys that match this schema + values_schema: The value must be a dict with values that match this schema + min_length: The value must be a dict with at least this many items + max_length: The value must be a dict with at most this many items + strict: Whether the keys and values should be validated with strict mode + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='dict', + keys_schema=keys_schema, + values_schema=values_schema, + min_length=min_length, + max_length=max_length, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +# (__input_value: Any) -> Any +NoInfoValidatorFunction = Callable[[Any], Any] + + +class NoInfoValidatorFunctionSchema(TypedDict): + type: Literal['no-info'] + function: NoInfoValidatorFunction + + +# (__input_value: Any, __info: ValidationInfo) -> Any +WithInfoValidatorFunction = Callable[[Any, ValidationInfo], Any] + + +class WithInfoValidatorFunctionSchema(TypedDict, total=False): + type: Required[Literal['with-info']] + function: Required[WithInfoValidatorFunction] + field_name: str + + +ValidationFunction = Union[NoInfoValidatorFunctionSchema, WithInfoValidatorFunctionSchema] + + +class _ValidatorFunctionSchema(TypedDict, total=False): + function: Required[ValidationFunction] + schema: Required[CoreSchema] + ref: str + metadata: Any + serialization: SerSchema + + +class BeforeValidatorFunctionSchema(_ValidatorFunctionSchema, total=False): + type: Required[Literal['function-before']] + + +def no_info_before_validator_function( + function: NoInfoValidatorFunction, + schema: CoreSchema, + *, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> BeforeValidatorFunctionSchema: + """ + Returns a schema that calls a validator function before validating, no `info` argument is provided, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + def fn(v: bytes) -> str: + return v.decode() + 'world' + + func_schema = core_schema.no_info_before_validator_function( + function=fn, schema=core_schema.str_schema() + ) + schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)}) + + v = SchemaValidator(schema) + assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'} + ``` + + Args: + function: The validator function to call + schema: The schema to validate the output of the validator function + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='function-before', + function={'type': 'no-info', 'function': function}, + schema=schema, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +def with_info_before_validator_function( + function: WithInfoValidatorFunction, + schema: CoreSchema, + *, + field_name: str | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> BeforeValidatorFunctionSchema: + """ + Returns a schema that calls a validator function before validation, the function is called with + an `info` argument, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + def fn(v: bytes, info: core_schema.ValidationInfo) -> str: + assert info.data is not None + assert info.field_name is not None + return v.decode() + 'world' + + func_schema = core_schema.with_info_before_validator_function( + function=fn, schema=core_schema.str_schema(), field_name='a' + ) + schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)}) + + v = SchemaValidator(schema) + assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'} + ``` + + Args: + function: The validator function to call + field_name: The name of the field + schema: The schema to validate the output of the validator function + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='function-before', + function=_dict_not_none(type='with-info', function=function, field_name=field_name), + schema=schema, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class AfterValidatorFunctionSchema(_ValidatorFunctionSchema, total=False): + type: Required[Literal['function-after']] + + +def no_info_after_validator_function( + function: NoInfoValidatorFunction, + schema: CoreSchema, + *, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> AfterValidatorFunctionSchema: + """ + Returns a schema that calls a validator function after validating, no `info` argument is provided, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + def fn(v: str) -> str: + return v + 'world' + + func_schema = core_schema.no_info_after_validator_function(fn, core_schema.str_schema()) + schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)}) + + v = SchemaValidator(schema) + assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'} + ``` + + Args: + function: The validator function to call after the schema is validated + schema: The schema to validate before the validator function + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='function-after', + function={'type': 'no-info', 'function': function}, + schema=schema, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +def with_info_after_validator_function( + function: WithInfoValidatorFunction, + schema: CoreSchema, + *, + field_name: str | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> AfterValidatorFunctionSchema: + """ + Returns a schema that calls a validator function after validation, the function is called with + an `info` argument, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + def fn(v: str, info: core_schema.ValidationInfo) -> str: + assert info.data is not None + assert info.field_name is not None + return v + 'world' + + func_schema = core_schema.with_info_after_validator_function( + function=fn, schema=core_schema.str_schema(), field_name='a' + ) + schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)}) + + v = SchemaValidator(schema) + assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'} + ``` + + Args: + function: The validator function to call after the schema is validated + schema: The schema to validate before the validator function + field_name: The name of the field this validators is applied to, if any + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='function-after', + function=_dict_not_none(type='with-info', function=function, field_name=field_name), + schema=schema, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class ValidatorFunctionWrapHandler(Protocol): + def __call__(self, input_value: Any, outer_location: str | int | None = None) -> Any: # pragma: no cover + ... + + +# (__input_value: Any, __validator: ValidatorFunctionWrapHandler) -> Any +NoInfoWrapValidatorFunction = Callable[[Any, ValidatorFunctionWrapHandler], Any] + + +class NoInfoWrapValidatorFunctionSchema(TypedDict): + type: Literal['no-info'] + function: NoInfoWrapValidatorFunction + + +# (__input_value: Any, __validator: ValidatorFunctionWrapHandler, __info: ValidationInfo) -> Any +WithInfoWrapValidatorFunction = Callable[[Any, ValidatorFunctionWrapHandler, ValidationInfo], Any] + + +class WithInfoWrapValidatorFunctionSchema(TypedDict, total=False): + type: Required[Literal['with-info']] + function: Required[WithInfoWrapValidatorFunction] + field_name: str + + +WrapValidatorFunction = Union[NoInfoWrapValidatorFunctionSchema, WithInfoWrapValidatorFunctionSchema] + + +class WrapValidatorFunctionSchema(TypedDict, total=False): + type: Required[Literal['function-wrap']] + function: Required[WrapValidatorFunction] + schema: Required[CoreSchema] + ref: str + metadata: Any + serialization: SerSchema + + +def no_info_wrap_validator_function( + function: NoInfoWrapValidatorFunction, + schema: CoreSchema, + *, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> WrapValidatorFunctionSchema: + """ + Returns a schema which calls a function with a `validator` callable argument which can + optionally be used to call inner validation with the function logic, this is much like the + "onion" implementation of middleware in many popular web frameworks, no `info` argument is passed, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + def fn( + v: str, + validator: core_schema.ValidatorFunctionWrapHandler, + ) -> str: + return validator(input_value=v) + 'world' + + schema = core_schema.no_info_wrap_validator_function( + function=fn, schema=core_schema.str_schema() + ) + v = SchemaValidator(schema) + assert v.validate_python('hello ') == 'hello world' + ``` + + Args: + function: The validator function to call + schema: The schema to validate the output of the validator function + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='function-wrap', + function={'type': 'no-info', 'function': function}, + schema=schema, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +def with_info_wrap_validator_function( + function: WithInfoWrapValidatorFunction, + schema: CoreSchema, + *, + field_name: str | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> WrapValidatorFunctionSchema: + """ + Returns a schema which calls a function with a `validator` callable argument which can + optionally be used to call inner validation with the function logic, this is much like the + "onion" implementation of middleware in many popular web frameworks, an `info` argument is also passed, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + def fn( + v: str, + validator: core_schema.ValidatorFunctionWrapHandler, + info: core_schema.ValidationInfo, + ) -> str: + return validator(input_value=v) + 'world' + + schema = core_schema.with_info_wrap_validator_function( + function=fn, schema=core_schema.str_schema() + ) + v = SchemaValidator(schema) + assert v.validate_python('hello ') == 'hello world' + ``` + + Args: + function: The validator function to call + schema: The schema to validate the output of the validator function + field_name: The name of the field this validators is applied to, if any + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='function-wrap', + function=_dict_not_none(type='with-info', function=function, field_name=field_name), + schema=schema, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class PlainValidatorFunctionSchema(TypedDict, total=False): + type: Required[Literal['function-plain']] + function: Required[ValidationFunction] + ref: str + metadata: Any + serialization: SerSchema + + +def no_info_plain_validator_function( + function: NoInfoValidatorFunction, + *, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> PlainValidatorFunctionSchema: + """ + Returns a schema that uses the provided function for validation, no `info` argument is passed, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + def fn(v: str) -> str: + assert 'hello' in v + return v + 'world' + + schema = core_schema.no_info_plain_validator_function(function=fn) + v = SchemaValidator(schema) + assert v.validate_python('hello ') == 'hello world' + ``` + + Args: + function: The validator function to call + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='function-plain', + function={'type': 'no-info', 'function': function}, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +def with_info_plain_validator_function( + function: WithInfoValidatorFunction, + *, + field_name: str | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> PlainValidatorFunctionSchema: + """ + Returns a schema that uses the provided function for validation, an `info` argument is passed, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + def fn(v: str, info: core_schema.ValidationInfo) -> str: + assert 'hello' in v + return v + 'world' + + schema = core_schema.with_info_plain_validator_function(function=fn) + v = SchemaValidator(schema) + assert v.validate_python('hello ') == 'hello world' + ``` + + Args: + function: The validator function to call + field_name: The name of the field this validators is applied to, if any + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='function-plain', + function=_dict_not_none(type='with-info', function=function, field_name=field_name), + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class WithDefaultSchema(TypedDict, total=False): + type: Required[Literal['default']] + schema: Required[CoreSchema] + default: Any + default_factory: Callable[[], Any] + on_error: Literal['raise', 'omit', 'default'] # default: 'raise' + validate_default: bool # default: False + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def with_default_schema( + schema: CoreSchema, + *, + default: Any = PydanticUndefined, + default_factory: Callable[[], Any] | None = None, + on_error: Literal['raise', 'omit', 'default'] | None = None, + validate_default: bool | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> WithDefaultSchema: + """ + Returns a schema that adds a default value to the given schema, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.with_default_schema(core_schema.str_schema(), default='hello') + wrapper_schema = core_schema.typed_dict_schema( + {'a': core_schema.typed_dict_field(schema)} + ) + v = SchemaValidator(wrapper_schema) + assert v.validate_python({}) == v.validate_python({'a': 'hello'}) + ``` + + Args: + schema: The schema to add a default value to + default: The default value to use + default_factory: A function that returns the default value to use + on_error: What to do if the schema validation fails. One of 'raise', 'omit', 'default' + validate_default: Whether the default value should be validated + strict: Whether the underlying schema should be validated with strict mode + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + s = _dict_not_none( + type='default', + schema=schema, + default_factory=default_factory, + on_error=on_error, + validate_default=validate_default, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + if default is not PydanticUndefined: + s['default'] = default + return s + + +class NullableSchema(TypedDict, total=False): + type: Required[Literal['nullable']] + schema: Required[CoreSchema] + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def nullable_schema( + schema: CoreSchema, + *, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> NullableSchema: + """ + Returns a schema that matches a nullable value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.nullable_schema(core_schema.str_schema()) + v = SchemaValidator(schema) + assert v.validate_python(None) is None + ``` + + Args: + schema: The schema to wrap + strict: Whether the underlying schema should be validated with strict mode + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='nullable', schema=schema, strict=strict, ref=ref, metadata=metadata, serialization=serialization + ) + + +class UnionSchema(TypedDict, total=False): + type: Required[Literal['union']] + choices: Required[List[Union[CoreSchema, Tuple[CoreSchema, str]]]] + # default true, whether to automatically collapse unions with one element to the inner validator + auto_collapse: bool + custom_error_type: str + custom_error_message: str + custom_error_context: Dict[str, Union[str, int, float]] + mode: Literal['smart', 'left_to_right'] # default: 'smart' + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def union_schema( + choices: list[CoreSchema | tuple[CoreSchema, str]], + *, + auto_collapse: bool | None = None, + custom_error_type: str | None = None, + custom_error_message: str | None = None, + custom_error_context: dict[str, str | int] | None = None, + mode: Literal['smart', 'left_to_right'] | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> UnionSchema: + """ + Returns a schema that matches a union value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.union_schema([core_schema.str_schema(), core_schema.int_schema()]) + v = SchemaValidator(schema) + assert v.validate_python('hello') == 'hello' + assert v.validate_python(1) == 1 + ``` + + Args: + choices: The schemas to match. If a tuple, the second item is used as the label for the case. + auto_collapse: whether to automatically collapse unions with one element to the inner validator, default true + custom_error_type: The custom error type to use if the validation fails + custom_error_message: The custom error message to use if the validation fails + custom_error_context: The custom error context to use if the validation fails + mode: How to select which choice to return + * `smart` (default) will try to return the choice which is the closest match to the input value + * `left_to_right` will return the first choice in `choices` which succeeds validation + strict: Whether the underlying schemas should be validated with strict mode + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='union', + choices=choices, + auto_collapse=auto_collapse, + custom_error_type=custom_error_type, + custom_error_message=custom_error_message, + custom_error_context=custom_error_context, + mode=mode, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class TaggedUnionSchema(TypedDict, total=False): + type: Required[Literal['tagged-union']] + choices: Required[Dict[Hashable, CoreSchema]] + discriminator: Required[Union[str, List[Union[str, int]], List[List[Union[str, int]]], Callable[[Any], Hashable]]] + custom_error_type: str + custom_error_message: str + custom_error_context: Dict[str, Union[str, int, float]] + strict: bool + from_attributes: bool # default: True + ref: str + metadata: Any + serialization: SerSchema + + +def tagged_union_schema( + choices: Dict[Hashable, CoreSchema], + discriminator: str | list[str | int] | list[list[str | int]] | Callable[[Any], Hashable], + *, + custom_error_type: str | None = None, + custom_error_message: str | None = None, + custom_error_context: dict[str, int | str | float] | None = None, + strict: bool | None = None, + from_attributes: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> TaggedUnionSchema: + """ + Returns a schema that matches a tagged union value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + apple_schema = core_schema.typed_dict_schema( + { + 'foo': core_schema.typed_dict_field(core_schema.str_schema()), + 'bar': core_schema.typed_dict_field(core_schema.int_schema()), + } + ) + banana_schema = core_schema.typed_dict_schema( + { + 'foo': core_schema.typed_dict_field(core_schema.str_schema()), + 'spam': core_schema.typed_dict_field( + core_schema.list_schema(items_schema=core_schema.int_schema()) + ), + } + ) + schema = core_schema.tagged_union_schema( + choices={ + 'apple': apple_schema, + 'banana': banana_schema, + }, + discriminator='foo', + ) + v = SchemaValidator(schema) + assert v.validate_python({'foo': 'apple', 'bar': '123'}) == {'foo': 'apple', 'bar': 123} + assert v.validate_python({'foo': 'banana', 'spam': [1, 2, 3]}) == { + 'foo': 'banana', + 'spam': [1, 2, 3], + } + ``` + + Args: + choices: The schemas to match + When retrieving a schema from `choices` using the discriminator value, if the value is a str, + it should be fed back into the `choices` map until a schema is obtained + (This approach is to prevent multiple ownership of a single schema in Rust) + discriminator: The discriminator to use to determine the schema to use + * If `discriminator` is a str, it is the name of the attribute to use as the discriminator + * If `discriminator` is a list of int/str, it should be used as a "path" to access the discriminator + * If `discriminator` is a list of lists, each inner list is a path, and the first path that exists is used + * If `discriminator` is a callable, it should return the discriminator when called on the value to validate; + the callable can return `None` to indicate that there is no matching discriminator present on the input + custom_error_type: The custom error type to use if the validation fails + custom_error_message: The custom error message to use if the validation fails + custom_error_context: The custom error context to use if the validation fails + strict: Whether the underlying schemas should be validated with strict mode + from_attributes: Whether to use the attributes of the object to retrieve the discriminator value + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='tagged-union', + choices=choices, + discriminator=discriminator, + custom_error_type=custom_error_type, + custom_error_message=custom_error_message, + custom_error_context=custom_error_context, + strict=strict, + from_attributes=from_attributes, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class ChainSchema(TypedDict, total=False): + type: Required[Literal['chain']] + steps: Required[List[CoreSchema]] + ref: str + metadata: Any + serialization: SerSchema + + +def chain_schema( + steps: list[CoreSchema], *, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None +) -> ChainSchema: + """ + Returns a schema that chains the provided validation schemas, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + def fn(v: str, info: core_schema.ValidationInfo) -> str: + assert 'hello' in v + return v + ' world' + + fn_schema = core_schema.with_info_plain_validator_function(function=fn) + schema = core_schema.chain_schema( + [fn_schema, fn_schema, fn_schema, core_schema.str_schema()] + ) + v = SchemaValidator(schema) + assert v.validate_python('hello') == 'hello world world world' + ``` + + Args: + steps: The schemas to chain + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none(type='chain', steps=steps, ref=ref, metadata=metadata, serialization=serialization) + + +class LaxOrStrictSchema(TypedDict, total=False): + type: Required[Literal['lax-or-strict']] + lax_schema: Required[CoreSchema] + strict_schema: Required[CoreSchema] + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def lax_or_strict_schema( + lax_schema: CoreSchema, + strict_schema: CoreSchema, + *, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> LaxOrStrictSchema: + """ + Returns a schema that uses the lax or strict schema, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + def fn(v: str, info: core_schema.ValidationInfo) -> str: + assert 'hello' in v + return v + ' world' + + lax_schema = core_schema.int_schema(strict=False) + strict_schema = core_schema.int_schema(strict=True) + + schema = core_schema.lax_or_strict_schema( + lax_schema=lax_schema, strict_schema=strict_schema, strict=True + ) + v = SchemaValidator(schema) + assert v.validate_python(123) == 123 + + schema = core_schema.lax_or_strict_schema( + lax_schema=lax_schema, strict_schema=strict_schema, strict=False + ) + v = SchemaValidator(schema) + assert v.validate_python('123') == 123 + ``` + + Args: + lax_schema: The lax schema to use + strict_schema: The strict schema to use + strict: Whether the strict schema should be used + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='lax-or-strict', + lax_schema=lax_schema, + strict_schema=strict_schema, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class JsonOrPythonSchema(TypedDict, total=False): + type: Required[Literal['json-or-python']] + json_schema: Required[CoreSchema] + python_schema: Required[CoreSchema] + ref: str + metadata: Any + serialization: SerSchema + + +def json_or_python_schema( + json_schema: CoreSchema, + python_schema: CoreSchema, + *, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> JsonOrPythonSchema: + """ + Returns a schema that uses the Json or Python schema depending on the input: + + ```py + from pydantic_core import SchemaValidator, ValidationError, core_schema + + v = SchemaValidator( + core_schema.json_or_python_schema( + json_schema=core_schema.int_schema(), + python_schema=core_schema.int_schema(strict=True), + ) + ) + + assert v.validate_json('"123"') == 123 + + try: + v.validate_python('123') + except ValidationError: + pass + else: + raise AssertionError('Validation should have failed') + ``` + + Args: + json_schema: The schema to use for Json inputs + python_schema: The schema to use for Python inputs + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='json-or-python', + json_schema=json_schema, + python_schema=python_schema, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class TypedDictField(TypedDict, total=False): + type: Required[Literal['typed-dict-field']] + schema: Required[CoreSchema] + required: bool + validation_alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]] + serialization_alias: str + serialization_exclude: bool # default: False + metadata: Any + + +def typed_dict_field( + schema: CoreSchema, + *, + required: bool | None = None, + validation_alias: str | list[str | int] | list[list[str | int]] | None = None, + serialization_alias: str | None = None, + serialization_exclude: bool | None = None, + metadata: Any = None, +) -> TypedDictField: + """ + Returns a schema that matches a typed dict field, e.g.: + + ```py + from pydantic_core import core_schema + + field = core_schema.typed_dict_field(schema=core_schema.int_schema(), required=True) + ``` + + Args: + schema: The schema to use for the field + required: Whether the field is required + validation_alias: The alias(es) to use to find the field in the validation data + serialization_alias: The alias to use as a key when serializing + serialization_exclude: Whether to exclude the field when serializing + metadata: Any other information you want to include with the schema, not used by pydantic-core + """ + return _dict_not_none( + type='typed-dict-field', + schema=schema, + required=required, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + serialization_exclude=serialization_exclude, + metadata=metadata, + ) + + +class TypedDictSchema(TypedDict, total=False): + type: Required[Literal['typed-dict']] + fields: Required[Dict[str, TypedDictField]] + computed_fields: List[ComputedField] + strict: bool + extras_schema: CoreSchema + # all these values can be set via config, equivalent fields have `typed_dict_` prefix + extra_behavior: ExtraBehavior + total: bool # default: True + populate_by_name: bool # replaces `allow_population_by_field_name` in pydantic v1 + ref: str + metadata: Any + serialization: SerSchema + config: CoreConfig + + +def typed_dict_schema( + fields: Dict[str, TypedDictField], + *, + computed_fields: list[ComputedField] | None = None, + strict: bool | None = None, + extras_schema: CoreSchema | None = None, + extra_behavior: ExtraBehavior | None = None, + total: bool | None = None, + populate_by_name: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, + config: CoreConfig | None = None, +) -> TypedDictSchema: + """ + Returns a schema that matches a typed dict, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + wrapper_schema = core_schema.typed_dict_schema( + {'a': core_schema.typed_dict_field(core_schema.str_schema())} + ) + v = SchemaValidator(wrapper_schema) + assert v.validate_python({'a': 'hello'}) == {'a': 'hello'} + ``` + + Args: + fields: The fields to use for the typed dict + computed_fields: Computed fields to use when serializing the model, only applies when directly inside a model + strict: Whether the typed dict is strict + extras_schema: The extra validator to use for the typed dict + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + extra_behavior: The extra behavior to use for the typed dict + total: Whether the typed dict is total + populate_by_name: Whether the typed dict should populate by name + serialization: Custom serialization schema + """ + return _dict_not_none( + type='typed-dict', + fields=fields, + computed_fields=computed_fields, + strict=strict, + extras_schema=extras_schema, + extra_behavior=extra_behavior, + total=total, + populate_by_name=populate_by_name, + ref=ref, + metadata=metadata, + serialization=serialization, + config=config, + ) + + +class ModelField(TypedDict, total=False): + type: Required[Literal['model-field']] + schema: Required[CoreSchema] + validation_alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]] + serialization_alias: str + serialization_exclude: bool # default: False + frozen: bool + metadata: Any + + +def model_field( + schema: CoreSchema, + *, + validation_alias: str | list[str | int] | list[list[str | int]] | None = None, + serialization_alias: str | None = None, + serialization_exclude: bool | None = None, + frozen: bool | None = None, + metadata: Any = None, +) -> ModelField: + """ + Returns a schema for a model field, e.g.: + + ```py + from pydantic_core import core_schema + + field = core_schema.model_field(schema=core_schema.int_schema()) + ``` + + Args: + schema: The schema to use for the field + validation_alias: The alias(es) to use to find the field in the validation data + serialization_alias: The alias to use as a key when serializing + serialization_exclude: Whether to exclude the field when serializing + frozen: Whether the field is frozen + metadata: Any other information you want to include with the schema, not used by pydantic-core + """ + return _dict_not_none( + type='model-field', + schema=schema, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + serialization_exclude=serialization_exclude, + frozen=frozen, + metadata=metadata, + ) + + +class ModelFieldsSchema(TypedDict, total=False): + type: Required[Literal['model-fields']] + fields: Required[Dict[str, ModelField]] + model_name: str + computed_fields: List[ComputedField] + strict: bool + extras_schema: CoreSchema + # all these values can be set via config, equivalent fields have `typed_dict_` prefix + extra_behavior: ExtraBehavior + populate_by_name: bool # replaces `allow_population_by_field_name` in pydantic v1 + from_attributes: bool + ref: str + metadata: Any + serialization: SerSchema + + +def model_fields_schema( + fields: Dict[str, ModelField], + *, + model_name: str | None = None, + computed_fields: list[ComputedField] | None = None, + strict: bool | None = None, + extras_schema: CoreSchema | None = None, + extra_behavior: ExtraBehavior | None = None, + populate_by_name: bool | None = None, + from_attributes: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> ModelFieldsSchema: + """ + Returns a schema that matches a typed dict, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + wrapper_schema = core_schema.model_fields_schema( + {'a': core_schema.model_field(core_schema.str_schema())} + ) + v = SchemaValidator(wrapper_schema) + print(v.validate_python({'a': 'hello'})) + #> ({'a': 'hello'}, None, {'a'}) + ``` + + Args: + fields: The fields to use for the typed dict + model_name: The name of the model, used for error messages, defaults to "Model" + computed_fields: Computed fields to use when serializing the model, only applies when directly inside a model + strict: Whether the typed dict is strict + extras_schema: The extra validator to use for the typed dict + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + extra_behavior: The extra behavior to use for the typed dict + populate_by_name: Whether the typed dict should populate by name + from_attributes: Whether the typed dict should be populated from attributes + serialization: Custom serialization schema + """ + return _dict_not_none( + type='model-fields', + fields=fields, + model_name=model_name, + computed_fields=computed_fields, + strict=strict, + extras_schema=extras_schema, + extra_behavior=extra_behavior, + populate_by_name=populate_by_name, + from_attributes=from_attributes, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class ModelSchema(TypedDict, total=False): + type: Required[Literal['model']] + cls: Required[Type[Any]] + schema: Required[CoreSchema] + custom_init: bool + root_model: bool + post_init: str + revalidate_instances: Literal['always', 'never', 'subclass-instances'] # default: 'never' + strict: bool + frozen: bool + extra_behavior: ExtraBehavior + config: CoreConfig + ref: str + metadata: Any + serialization: SerSchema + + +def model_schema( + cls: Type[Any], + schema: CoreSchema, + *, + custom_init: bool | None = None, + root_model: bool | None = None, + post_init: str | None = None, + revalidate_instances: Literal['always', 'never', 'subclass-instances'] | None = None, + strict: bool | None = None, + frozen: bool | None = None, + extra_behavior: ExtraBehavior | None = None, + config: CoreConfig | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> ModelSchema: + """ + A model schema generally contains a typed-dict schema. + It will run the typed dict validator, then create a new class + and set the dict and fields set returned from the typed dict validator + to `__dict__` and `__pydantic_fields_set__` respectively. + + Example: + + ```py + from pydantic_core import CoreConfig, SchemaValidator, core_schema + + class MyModel: + __slots__ = ( + '__dict__', + '__pydantic_fields_set__', + '__pydantic_extra__', + '__pydantic_private__', + ) + + schema = core_schema.model_schema( + cls=MyModel, + config=CoreConfig(str_max_length=5), + schema=core_schema.model_fields_schema( + fields={'a': core_schema.model_field(core_schema.str_schema())}, + ), + ) + v = SchemaValidator(schema) + assert v.isinstance_python({'a': 'hello'}) is True + assert v.isinstance_python({'a': 'too long'}) is False + ``` + + Args: + cls: The class to use for the model + schema: The schema to use for the model + custom_init: Whether the model has a custom init method + root_model: Whether the model is a `RootModel` + post_init: The call after init to use for the model + revalidate_instances: whether instances of models and dataclasses (including subclass instances) + should re-validate defaults to config.revalidate_instances, else 'never' + strict: Whether the model is strict + frozen: Whether the model is frozen + extra_behavior: The extra behavior to use for the model, used in serialization + config: The config to use for the model + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='model', + cls=cls, + schema=schema, + custom_init=custom_init, + root_model=root_model, + post_init=post_init, + revalidate_instances=revalidate_instances, + strict=strict, + frozen=frozen, + extra_behavior=extra_behavior, + config=config, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class DataclassField(TypedDict, total=False): + type: Required[Literal['dataclass-field']] + name: Required[str] + schema: Required[CoreSchema] + kw_only: bool # default: True + init: bool # default: True + init_only: bool # default: False + frozen: bool # default: False + validation_alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]] + serialization_alias: str + serialization_exclude: bool # default: False + metadata: Any + + +def dataclass_field( + name: str, + schema: CoreSchema, + *, + kw_only: bool | None = None, + init: bool | None = None, + init_only: bool | None = None, + validation_alias: str | list[str | int] | list[list[str | int]] | None = None, + serialization_alias: str | None = None, + serialization_exclude: bool | None = None, + metadata: Any = None, + frozen: bool | None = None, +) -> DataclassField: + """ + Returns a schema for a dataclass field, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + field = core_schema.dataclass_field( + name='a', schema=core_schema.str_schema(), kw_only=False + ) + schema = core_schema.dataclass_args_schema('Foobar', [field]) + v = SchemaValidator(schema) + assert v.validate_python({'a': 'hello'}) == ({'a': 'hello'}, None) + ``` + + Args: + name: The name to use for the argument parameter + schema: The schema to use for the argument parameter + kw_only: Whether the field can be set with a positional argument as well as a keyword argument + init: Whether the field should be validated during initialization + init_only: Whether the field should be omitted from `__dict__` and passed to `__post_init__` + validation_alias: The alias(es) to use to find the field in the validation data + serialization_alias: The alias to use as a key when serializing + serialization_exclude: Whether to exclude the field when serializing + metadata: Any other information you want to include with the schema, not used by pydantic-core + frozen: Whether the field is frozen + """ + return _dict_not_none( + type='dataclass-field', + name=name, + schema=schema, + kw_only=kw_only, + init=init, + init_only=init_only, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + serialization_exclude=serialization_exclude, + metadata=metadata, + frozen=frozen, + ) + + +class DataclassArgsSchema(TypedDict, total=False): + type: Required[Literal['dataclass-args']] + dataclass_name: Required[str] + fields: Required[List[DataclassField]] + computed_fields: List[ComputedField] + populate_by_name: bool # default: False + collect_init_only: bool # default: False + ref: str + metadata: Any + serialization: SerSchema + extra_behavior: ExtraBehavior + + +def dataclass_args_schema( + dataclass_name: str, + fields: list[DataclassField], + *, + computed_fields: List[ComputedField] | None = None, + populate_by_name: bool | None = None, + collect_init_only: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, + extra_behavior: ExtraBehavior | None = None, +) -> DataclassArgsSchema: + """ + Returns a schema for validating dataclass arguments, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + field_a = core_schema.dataclass_field( + name='a', schema=core_schema.str_schema(), kw_only=False + ) + field_b = core_schema.dataclass_field( + name='b', schema=core_schema.bool_schema(), kw_only=False + ) + schema = core_schema.dataclass_args_schema('Foobar', [field_a, field_b]) + v = SchemaValidator(schema) + assert v.validate_python({'a': 'hello', 'b': True}) == ({'a': 'hello', 'b': True}, None) + ``` + + Args: + dataclass_name: The name of the dataclass being validated + fields: The fields to use for the dataclass + computed_fields: Computed fields to use when serializing the dataclass + populate_by_name: Whether to populate by name + collect_init_only: Whether to collect init only fields into a dict to pass to `__post_init__` + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + extra_behavior: How to handle extra fields + """ + return _dict_not_none( + type='dataclass-args', + dataclass_name=dataclass_name, + fields=fields, + computed_fields=computed_fields, + populate_by_name=populate_by_name, + collect_init_only=collect_init_only, + ref=ref, + metadata=metadata, + serialization=serialization, + extra_behavior=extra_behavior, + ) + + +class DataclassSchema(TypedDict, total=False): + type: Required[Literal['dataclass']] + cls: Required[Type[Any]] + schema: Required[CoreSchema] + fields: Required[List[str]] + cls_name: str + post_init: bool # default: False + revalidate_instances: Literal['always', 'never', 'subclass-instances'] # default: 'never' + strict: bool # default: False + frozen: bool # default False + ref: str + metadata: Any + serialization: SerSchema + slots: bool + config: CoreConfig + + +def dataclass_schema( + cls: Type[Any], + schema: CoreSchema, + fields: List[str], + *, + cls_name: str | None = None, + post_init: bool | None = None, + revalidate_instances: Literal['always', 'never', 'subclass-instances'] | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, + frozen: bool | None = None, + slots: bool | None = None, + config: CoreConfig | None = None, +) -> DataclassSchema: + """ + Returns a schema for a dataclass. As with `ModelSchema`, this schema can only be used as a field within + another schema, not as the root type. + + Args: + cls: The dataclass type, used to perform subclass checks + schema: The schema to use for the dataclass fields + fields: Fields of the dataclass, this is used in serialization and in validation during re-validation + and while validating assignment + cls_name: The name to use in error locs, etc; this is useful for generics (default: `cls.__name__`) + post_init: Whether to call `__post_init__` after validation + revalidate_instances: whether instances of models and dataclasses (including subclass instances) + should re-validate defaults to config.revalidate_instances, else 'never' + strict: Whether to require an exact instance of `cls` + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + frozen: Whether the dataclass is frozen + slots: Whether `slots=True` on the dataclass, means each field is assigned independently, rather than + simply setting `__dict__`, default false + """ + return _dict_not_none( + type='dataclass', + cls=cls, + fields=fields, + cls_name=cls_name, + schema=schema, + post_init=post_init, + revalidate_instances=revalidate_instances, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + frozen=frozen, + slots=slots, + config=config, + ) + + +class ArgumentsParameter(TypedDict, total=False): + name: Required[str] + schema: Required[CoreSchema] + mode: Literal['positional_only', 'positional_or_keyword', 'keyword_only'] # default positional_or_keyword + alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]] + + +def arguments_parameter( + name: str, + schema: CoreSchema, + *, + mode: Literal['positional_only', 'positional_or_keyword', 'keyword_only'] | None = None, + alias: str | list[str | int] | list[list[str | int]] | None = None, +) -> ArgumentsParameter: + """ + Returns a schema that matches an argument parameter, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + param = core_schema.arguments_parameter( + name='a', schema=core_schema.str_schema(), mode='positional_only' + ) + schema = core_schema.arguments_schema([param]) + v = SchemaValidator(schema) + assert v.validate_python(('hello',)) == (('hello',), {}) + ``` + + Args: + name: The name to use for the argument parameter + schema: The schema to use for the argument parameter + mode: The mode to use for the argument parameter + alias: The alias to use for the argument parameter + """ + return _dict_not_none(name=name, schema=schema, mode=mode, alias=alias) + + +class ArgumentsSchema(TypedDict, total=False): + type: Required[Literal['arguments']] + arguments_schema: Required[List[ArgumentsParameter]] + populate_by_name: bool + var_args_schema: CoreSchema + var_kwargs_schema: CoreSchema + ref: str + metadata: Any + serialization: SerSchema + + +def arguments_schema( + arguments: list[ArgumentsParameter], + *, + populate_by_name: bool | None = None, + var_args_schema: CoreSchema | None = None, + var_kwargs_schema: CoreSchema | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> ArgumentsSchema: + """ + Returns a schema that matches an arguments schema, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + param_a = core_schema.arguments_parameter( + name='a', schema=core_schema.str_schema(), mode='positional_only' + ) + param_b = core_schema.arguments_parameter( + name='b', schema=core_schema.bool_schema(), mode='positional_only' + ) + schema = core_schema.arguments_schema([param_a, param_b]) + v = SchemaValidator(schema) + assert v.validate_python(('hello', True)) == (('hello', True), {}) + ``` + + Args: + arguments: The arguments to use for the arguments schema + populate_by_name: Whether to populate by name + var_args_schema: The variable args schema to use for the arguments schema + var_kwargs_schema: The variable kwargs schema to use for the arguments schema + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='arguments', + arguments_schema=arguments, + populate_by_name=populate_by_name, + var_args_schema=var_args_schema, + var_kwargs_schema=var_kwargs_schema, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class CallSchema(TypedDict, total=False): + type: Required[Literal['call']] + arguments_schema: Required[CoreSchema] + function: Required[Callable[..., Any]] + function_name: str # default function.__name__ + return_schema: CoreSchema + ref: str + metadata: Any + serialization: SerSchema + + +def call_schema( + arguments: CoreSchema, + function: Callable[..., Any], + *, + function_name: str | None = None, + return_schema: CoreSchema | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> CallSchema: + """ + Returns a schema that matches an arguments schema, then calls a function, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + param_a = core_schema.arguments_parameter( + name='a', schema=core_schema.str_schema(), mode='positional_only' + ) + param_b = core_schema.arguments_parameter( + name='b', schema=core_schema.bool_schema(), mode='positional_only' + ) + args_schema = core_schema.arguments_schema([param_a, param_b]) + + schema = core_schema.call_schema( + arguments=args_schema, + function=lambda a, b: a + str(not b), + return_schema=core_schema.str_schema(), + ) + v = SchemaValidator(schema) + assert v.validate_python((('hello', True))) == 'helloFalse' + ``` + + Args: + arguments: The arguments to use for the arguments schema + function: The function to use for the call schema + function_name: The function name to use for the call schema, if not provided `function.__name__` is used + return_schema: The return schema to use for the call schema + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='call', + arguments_schema=arguments, + function=function, + function_name=function_name, + return_schema=return_schema, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class CustomErrorSchema(TypedDict, total=False): + type: Required[Literal['custom-error']] + schema: Required[CoreSchema] + custom_error_type: Required[str] + custom_error_message: str + custom_error_context: Dict[str, Union[str, int, float]] + ref: str + metadata: Any + serialization: SerSchema + + +def custom_error_schema( + schema: CoreSchema, + custom_error_type: str, + *, + custom_error_message: str | None = None, + custom_error_context: dict[str, Any] | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> CustomErrorSchema: + """ + Returns a schema that matches a custom error value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.custom_error_schema( + schema=core_schema.int_schema(), + custom_error_type='MyError', + custom_error_message='Error msg', + ) + v = SchemaValidator(schema) + v.validate_python(1) + ``` + + Args: + schema: The schema to use for the custom error schema + custom_error_type: The custom error type to use for the custom error schema + custom_error_message: The custom error message to use for the custom error schema + custom_error_context: The custom error context to use for the custom error schema + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='custom-error', + schema=schema, + custom_error_type=custom_error_type, + custom_error_message=custom_error_message, + custom_error_context=custom_error_context, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class JsonSchema(TypedDict, total=False): + type: Required[Literal['json']] + schema: CoreSchema + ref: str + metadata: Any + serialization: SerSchema + + +def json_schema( + schema: CoreSchema | None = None, + *, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> JsonSchema: + """ + Returns a schema that matches a JSON value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + dict_schema = core_schema.model_fields_schema( + { + 'field_a': core_schema.model_field(core_schema.str_schema()), + 'field_b': core_schema.model_field(core_schema.bool_schema()), + }, + ) + + class MyModel: + __slots__ = ( + '__dict__', + '__pydantic_fields_set__', + '__pydantic_extra__', + '__pydantic_private__', + ) + field_a: str + field_b: bool + + json_schema = core_schema.json_schema(schema=dict_schema) + schema = core_schema.model_schema(cls=MyModel, schema=json_schema) + v = SchemaValidator(schema) + m = v.validate_python('{"field_a": "hello", "field_b": true}') + assert isinstance(m, MyModel) + ``` + + Args: + schema: The schema to use for the JSON schema + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none(type='json', schema=schema, ref=ref, metadata=metadata, serialization=serialization) + + +class UrlSchema(TypedDict, total=False): + type: Required[Literal['url']] + max_length: int + allowed_schemes: List[str] + host_required: bool # default False + default_host: str + default_port: int + default_path: str + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def url_schema( + *, + max_length: int | None = None, + allowed_schemes: list[str] | None = None, + host_required: bool | None = None, + default_host: str | None = None, + default_port: int | None = None, + default_path: str | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> UrlSchema: + """ + Returns a schema that matches a URL value, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.url_schema() + v = SchemaValidator(schema) + print(v.validate_python('https://example.com')) + #> https://example.com/ + ``` + + Args: + max_length: The maximum length of the URL + allowed_schemes: The allowed URL schemes + host_required: Whether the URL must have a host + default_host: The default host to use if the URL does not have a host + default_port: The default port to use if the URL does not have a port + default_path: The default path to use if the URL does not have a path + strict: Whether to use strict URL parsing + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='url', + max_length=max_length, + allowed_schemes=allowed_schemes, + host_required=host_required, + default_host=default_host, + default_port=default_port, + default_path=default_path, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class MultiHostUrlSchema(TypedDict, total=False): + type: Required[Literal['multi-host-url']] + max_length: int + allowed_schemes: List[str] + host_required: bool # default False + default_host: str + default_port: int + default_path: str + strict: bool + ref: str + metadata: Any + serialization: SerSchema + + +def multi_host_url_schema( + *, + max_length: int | None = None, + allowed_schemes: list[str] | None = None, + host_required: bool | None = None, + default_host: str | None = None, + default_port: int | None = None, + default_path: str | None = None, + strict: bool | None = None, + ref: str | None = None, + metadata: Any = None, + serialization: SerSchema | None = None, +) -> MultiHostUrlSchema: + """ + Returns a schema that matches a URL value with possibly multiple hosts, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.multi_host_url_schema() + v = SchemaValidator(schema) + print(v.validate_python('redis://localhost,0.0.0.0,127.0.0.1')) + #> redis://localhost,0.0.0.0,127.0.0.1 + ``` + + Args: + max_length: The maximum length of the URL + allowed_schemes: The allowed URL schemes + host_required: Whether the URL must have a host + default_host: The default host to use if the URL does not have a host + default_port: The default port to use if the URL does not have a port + default_path: The default path to use if the URL does not have a path + strict: Whether to use strict URL parsing + ref: optional unique identifier of the schema, used to reference the schema in other places + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='multi-host-url', + max_length=max_length, + allowed_schemes=allowed_schemes, + host_required=host_required, + default_host=default_host, + default_port=default_port, + default_path=default_path, + strict=strict, + ref=ref, + metadata=metadata, + serialization=serialization, + ) + + +class DefinitionsSchema(TypedDict, total=False): + type: Required[Literal['definitions']] + schema: Required[CoreSchema] + definitions: Required[List[CoreSchema]] + metadata: Any + serialization: SerSchema + + +def definitions_schema(schema: CoreSchema, definitions: list[CoreSchema]) -> DefinitionsSchema: + """ + Build a schema that contains both an inner schema and a list of definitions which can be used + within the inner schema. + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema = core_schema.definitions_schema( + core_schema.list_schema(core_schema.definition_reference_schema('foobar')), + [core_schema.int_schema(ref='foobar')], + ) + v = SchemaValidator(schema) + assert v.validate_python([1, 2, '3']) == [1, 2, 3] + ``` + + Args: + schema: The inner schema + definitions: List of definitions which can be referenced within inner schema + """ + return DefinitionsSchema(type='definitions', schema=schema, definitions=definitions) + + +class DefinitionReferenceSchema(TypedDict, total=False): + type: Required[Literal['definition-ref']] + schema_ref: Required[str] + ref: str + metadata: Any + serialization: SerSchema + + +def definition_reference_schema( + schema_ref: str, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None +) -> DefinitionReferenceSchema: + """ + Returns a schema that points to a schema stored in "definitions", this is useful for nested recursive + models and also when you want to define validators separately from the main schema, e.g.: + + ```py + from pydantic_core import SchemaValidator, core_schema + + schema_definition = core_schema.definition_reference_schema('list-schema') + schema = core_schema.definitions_schema( + schema=schema_definition, + definitions=[ + core_schema.list_schema(items_schema=schema_definition, ref='list-schema'), + ], + ) + v = SchemaValidator(schema) + assert v.validate_python([()]) == [[]] + ``` + + Args: + schema_ref: The schema ref to use for the definition reference schema + metadata: Any other information you want to include with the schema, not used by pydantic-core + serialization: Custom serialization schema + """ + return _dict_not_none( + type='definition-ref', schema_ref=schema_ref, ref=ref, metadata=metadata, serialization=serialization + ) + + +MYPY = False +# See https://github.com/python/mypy/issues/14034 for details, in summary mypy is extremely slow to process this +# union which kills performance not just for pydantic, but even for code using pydantic +if not MYPY: + CoreSchema = Union[ + AnySchema, + NoneSchema, + BoolSchema, + IntSchema, + FloatSchema, + DecimalSchema, + StringSchema, + BytesSchema, + DateSchema, + TimeSchema, + DatetimeSchema, + TimedeltaSchema, + LiteralSchema, + IsInstanceSchema, + IsSubclassSchema, + CallableSchema, + ListSchema, + TupleSchema, + SetSchema, + FrozenSetSchema, + GeneratorSchema, + DictSchema, + AfterValidatorFunctionSchema, + BeforeValidatorFunctionSchema, + WrapValidatorFunctionSchema, + PlainValidatorFunctionSchema, + WithDefaultSchema, + NullableSchema, + UnionSchema, + TaggedUnionSchema, + ChainSchema, + LaxOrStrictSchema, + JsonOrPythonSchema, + TypedDictSchema, + ModelFieldsSchema, + ModelSchema, + DataclassArgsSchema, + DataclassSchema, + ArgumentsSchema, + CallSchema, + CustomErrorSchema, + JsonSchema, + UrlSchema, + MultiHostUrlSchema, + DefinitionsSchema, + DefinitionReferenceSchema, + UuidSchema, + ] +elif False: + CoreSchema: TypeAlias = Mapping[str, Any] + + +# to update this, call `pytest -k test_core_schema_type_literal` and copy the output +CoreSchemaType = Literal[ + 'any', + 'none', + 'bool', + 'int', + 'float', + 'decimal', + 'str', + 'bytes', + 'date', + 'time', + 'datetime', + 'timedelta', + 'literal', + 'is-instance', + 'is-subclass', + 'callable', + 'list', + 'tuple', + 'set', + 'frozenset', + 'generator', + 'dict', + 'function-after', + 'function-before', + 'function-wrap', + 'function-plain', + 'default', + 'nullable', + 'union', + 'tagged-union', + 'chain', + 'lax-or-strict', + 'json-or-python', + 'typed-dict', + 'model-fields', + 'model', + 'dataclass-args', + 'dataclass', + 'arguments', + 'call', + 'custom-error', + 'json', + 'url', + 'multi-host-url', + 'definitions', + 'definition-ref', + 'uuid', +] + +CoreSchemaFieldType = Literal['model-field', 'dataclass-field', 'typed-dict-field', 'computed-field'] + + +# used in _pydantic_core.pyi::PydanticKnownError +# to update this, call `pytest -k test_all_errors` and copy the output +ErrorType = Literal[ + 'no_such_attribute', + 'json_invalid', + 'json_type', + 'recursion_loop', + 'missing', + 'frozen_field', + 'frozen_instance', + 'extra_forbidden', + 'invalid_key', + 'get_attribute_error', + 'model_type', + 'model_attributes_type', + 'dataclass_type', + 'dataclass_exact_type', + 'none_required', + 'greater_than', + 'greater_than_equal', + 'less_than', + 'less_than_equal', + 'multiple_of', + 'finite_number', + 'too_short', + 'too_long', + 'iterable_type', + 'iteration_error', + 'string_type', + 'string_sub_type', + 'string_unicode', + 'string_too_short', + 'string_too_long', + 'string_pattern_mismatch', + 'enum', + 'dict_type', + 'mapping_type', + 'list_type', + 'tuple_type', + 'set_type', + 'bool_type', + 'bool_parsing', + 'int_type', + 'int_parsing', + 'int_parsing_size', + 'int_from_float', + 'float_type', + 'float_parsing', + 'bytes_type', + 'bytes_too_short', + 'bytes_too_long', + 'value_error', + 'assertion_error', + 'literal_error', + 'date_type', + 'date_parsing', + 'date_from_datetime_parsing', + 'date_from_datetime_inexact', + 'date_past', + 'date_future', + 'time_type', + 'time_parsing', + 'datetime_type', + 'datetime_parsing', + 'datetime_object_invalid', + 'datetime_from_date_parsing', + 'datetime_past', + 'datetime_future', + 'timezone_naive', + 'timezone_aware', + 'timezone_offset', + 'time_delta_type', + 'time_delta_parsing', + 'frozen_set_type', + 'is_instance_of', + 'is_subclass_of', + 'callable_type', + 'union_tag_invalid', + 'union_tag_not_found', + 'arguments_type', + 'missing_argument', + 'unexpected_keyword_argument', + 'missing_keyword_only_argument', + 'unexpected_positional_argument', + 'missing_positional_only_argument', + 'multiple_argument_values', + 'url_type', + 'url_parsing', + 'url_syntax_violation', + 'url_too_long', + 'url_scheme', + 'uuid_type', + 'uuid_parsing', + 'uuid_version', + 'decimal_type', + 'decimal_parsing', + 'decimal_max_digits', + 'decimal_max_places', + 'decimal_whole_digits', +] + + +def _dict_not_none(**kwargs: Any) -> Any: + return {k: v for k, v in kwargs.items() if v is not None} + + +############################################################################### +# All this stuff is deprecated by #980 and will be removed eventually +# They're kept because some code external code will be using them + + +@deprecated('`field_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.') +def field_before_validator_function(function: WithInfoValidatorFunction, field_name: str, schema: CoreSchema, **kwargs): + warnings.warn( + '`field_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.', + DeprecationWarning, + ) + return with_info_before_validator_function(function, schema, field_name=field_name, **kwargs) + + +@deprecated('`general_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.') +def general_before_validator_function(*args, **kwargs): + warnings.warn( + '`general_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.', + DeprecationWarning, + ) + return with_info_before_validator_function(*args, **kwargs) + + +@deprecated('`field_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.') +def field_after_validator_function(function: WithInfoValidatorFunction, field_name: str, schema: CoreSchema, **kwargs): + warnings.warn( + '`field_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.', + DeprecationWarning, + ) + return with_info_after_validator_function(function, schema, field_name=field_name, **kwargs) + + +@deprecated('`general_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.') +def general_after_validator_function(*args, **kwargs): + warnings.warn( + '`general_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.', + DeprecationWarning, + ) + return with_info_after_validator_function(*args, **kwargs) + + +@deprecated('`field_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.') +def field_wrap_validator_function( + function: WithInfoWrapValidatorFunction, field_name: str, schema: CoreSchema, **kwargs +): + warnings.warn( + '`field_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.', + DeprecationWarning, + ) + return with_info_wrap_validator_function(function, schema, field_name=field_name, **kwargs) + + +@deprecated('`general_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.') +def general_wrap_validator_function(*args, **kwargs): + warnings.warn( + '`general_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.', + DeprecationWarning, + ) + return with_info_wrap_validator_function(*args, **kwargs) + + +@deprecated('`field_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.') +def field_plain_validator_function(function: WithInfoValidatorFunction, field_name: str, **kwargs): + warnings.warn( + '`field_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.', + DeprecationWarning, + ) + return with_info_plain_validator_function(function, field_name=field_name, **kwargs) + + +@deprecated('`general_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.') +def general_plain_validator_function(*args, **kwargs): + warnings.warn( + '`general_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.', + DeprecationWarning, + ) + return with_info_plain_validator_function(*args, **kwargs) + + +_deprecated_import_lookup = { + 'FieldValidationInfo': ValidationInfo, + 'FieldValidatorFunction': WithInfoValidatorFunction, + 'GeneralValidatorFunction': WithInfoValidatorFunction, + 'FieldWrapValidatorFunction': WithInfoWrapValidatorFunction, +} + +if TYPE_CHECKING: + FieldValidationInfo = ValidationInfo + + +def __getattr__(attr_name: str) -> object: + new_attr = _deprecated_import_lookup.get(attr_name) + if new_attr is None: + raise AttributeError(f"module 'pydantic_core' has no attribute '{attr_name}'") + else: + import warnings + + msg = f'`{attr_name}` is deprecated, use `{new_attr.__name__}` instead.' + warnings.warn(msg, DeprecationWarning, stacklevel=1) + return new_attr diff --git a/lib/pydantic_core/py.typed b/lib/pydantic_core/py.typed new file mode 100644 index 00000000..e69de29b diff --git a/lib/pythoncom.py b/lib/pythoncom.py new file mode 100644 index 00000000..2180ecc3 --- /dev/null +++ b/lib/pythoncom.py @@ -0,0 +1,4 @@ +# Magic utility that "redirects" to pythoncomxx.dll +import pywintypes + +pywintypes.__import_pywin32_system_module__("pythoncom", globals()) diff --git a/lib/pythonwin/license.txt b/lib/pythonwin/license.txt new file mode 100644 index 00000000..fa340d74 --- /dev/null +++ b/lib/pythonwin/license.txt @@ -0,0 +1,30 @@ +Unless stated in the specfic source file, this work is +Copyright (c) 1994-2008, Mark Hammond +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: + +Redistributions of source code must retain the above copyright notice, +this list of conditions and the following disclaimer. + +Redistributions in binary form must reproduce the above copyright +notice, this list of conditions and the following disclaimer in +the documentation and/or other materials provided with the distribution. + +Neither name of Mark Hammond nor the name of contributors may be used +to endorse or promote products derived from this software without +specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS +IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A +PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR +CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/lib/pythonwin/pywin/Demos/app/basictimerapp.py b/lib/pythonwin/pywin/Demos/app/basictimerapp.py new file mode 100644 index 00000000..da771da1 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/app/basictimerapp.py @@ -0,0 +1,258 @@ +# basictimerapp - a really simple timer application. +# This should be run using the command line: +# pythonwin /app demos\basictimerapp.py +import sys +import time + +import timer +import win32api +import win32con +import win32ui +from pywin.framework import app, cmdline, dlgappcore + + +class TimerAppDialog(dlgappcore.AppDialog): + softspace = 1 + + def __init__(self, appName=""): + dlgappcore.AppDialog.__init__(self, win32ui.IDD_GENERAL_STATUS) + self.timerAppName = appName + self.argOff = 0 + if len(self.timerAppName) == 0: + if len(sys.argv) > 1 and sys.argv[1][0] != "/": + self.timerAppName = sys.argv[1] + self.argOff = 1 + + def PreDoModal(self): + # sys.stderr = sys.stdout + pass + + def ProcessArgs(self, args): + for arg in args: + if arg == "/now": + self.OnOK() + + def OnInitDialog(self): + win32ui.SetProfileFileName("pytimer.ini") + self.title = win32ui.GetProfileVal( + self.timerAppName, "Title", "Remote System Timer" + ) + self.buildTimer = win32ui.GetProfileVal( + self.timerAppName, "Timer", "EachMinuteIntervaler()" + ) + self.doWork = win32ui.GetProfileVal(self.timerAppName, "Work", "DoDemoWork()") + # replace "\n" with real \n. + self.doWork = self.doWork.replace("\\n", "\n") + dlgappcore.AppDialog.OnInitDialog(self) + + self.SetWindowText(self.title) + self.prompt1 = self.GetDlgItem(win32ui.IDC_PROMPT1) + self.prompt2 = self.GetDlgItem(win32ui.IDC_PROMPT2) + self.prompt3 = self.GetDlgItem(win32ui.IDC_PROMPT3) + self.butOK = self.GetDlgItem(win32con.IDOK) + self.butCancel = self.GetDlgItem(win32con.IDCANCEL) + self.prompt1.SetWindowText("Python Timer App") + self.prompt2.SetWindowText("") + self.prompt3.SetWindowText("") + self.butOK.SetWindowText("Do it now") + self.butCancel.SetWindowText("Close") + + self.timerManager = TimerManager(self) + self.ProcessArgs(sys.argv[self.argOff :]) + self.timerManager.go() + return 1 + + def OnDestroy(self, msg): + dlgappcore.AppDialog.OnDestroy(self, msg) + self.timerManager.stop() + + def OnOK(self): + # stop the timer, then restart after setting special boolean + self.timerManager.stop() + self.timerManager.bConnectNow = 1 + self.timerManager.go() + return + + +# def OnCancel(self): default behaviour - cancel == close. +# return + + +class TimerManager: + def __init__(self, dlg): + self.dlg = dlg + self.timerId = None + self.intervaler = eval(self.dlg.buildTimer) + self.bConnectNow = 0 + self.bHaveSetPrompt1 = 0 + + def CaptureOutput(self): + self.oldOut = sys.stdout + self.oldErr = sys.stderr + sys.stdout = sys.stderr = self + self.bHaveSetPrompt1 = 0 + + def ReleaseOutput(self): + sys.stdout = self.oldOut + sys.stderr = self.oldErr + + def write(self, str): + s = str.strip() + if len(s): + if self.bHaveSetPrompt1: + dest = self.dlg.prompt3 + else: + dest = self.dlg.prompt1 + self.bHaveSetPrompt1 = 1 + dest.SetWindowText(s) + + def go(self): + self.OnTimer(None, None) + + def stop(self): + if self.timerId: + timer.kill_timer(self.timerId) + self.timerId = None + + def OnTimer(self, id, timeVal): + if id: + timer.kill_timer(id) + if self.intervaler.IsTime() or self.bConnectNow: + # do the work. + try: + self.dlg.SetWindowText(self.dlg.title + " - Working...") + self.dlg.butOK.EnableWindow(0) + self.dlg.butCancel.EnableWindow(0) + self.CaptureOutput() + try: + exec(self.dlg.doWork) + print("The last operation completed successfully.") + except: + t, v, tb = sys.exc_info() + str = "Failed: %s: %s" % (t, repr(v)) + print(str) + self.oldErr.write(str) + tb = None # Prevent cycle + finally: + self.ReleaseOutput() + self.dlg.butOK.EnableWindow() + self.dlg.butCancel.EnableWindow() + self.dlg.SetWindowText(self.dlg.title) + else: + now = time.time() + nextTime = self.intervaler.GetNextTime() + if nextTime: + timeDiffSeconds = nextTime - now + timeDiffMinutes = int(timeDiffSeconds / 60) + timeDiffSeconds = timeDiffSeconds % 60 + timeDiffHours = int(timeDiffMinutes / 60) + timeDiffMinutes = timeDiffMinutes % 60 + self.dlg.prompt1.SetWindowText( + "Next connection due in %02d:%02d:%02d" + % (timeDiffHours, timeDiffMinutes, timeDiffSeconds) + ) + self.timerId = timer.set_timer( + self.intervaler.GetWakeupInterval(), self.OnTimer + ) + self.bConnectNow = 0 + + +class TimerIntervaler: + def __init__(self): + self.nextTime = None + self.wakeUpInterval = 2000 + + def GetWakeupInterval(self): + return self.wakeUpInterval + + def GetNextTime(self): + return self.nextTime + + def IsTime(self): + now = time.time() + if self.nextTime is None: + self.nextTime = self.SetFirstTime(now) + ret = 0 + if now >= self.nextTime: + ret = 1 + self.nextTime = self.SetNextTime(self.nextTime, now) + # do the work. + return ret + + +class EachAnyIntervaler(TimerIntervaler): + def __init__(self, timeAt, timePos, timeAdd, wakeUpInterval=None): + TimerIntervaler.__init__(self) + self.timeAt = timeAt + self.timePos = timePos + self.timeAdd = timeAdd + if wakeUpInterval: + self.wakeUpInterval = wakeUpInterval + + def SetFirstTime(self, now): + timeTup = time.localtime(now) + lst = [] + for item in timeTup: + lst.append(item) + bAdd = timeTup[self.timePos] > self.timeAt + lst[self.timePos] = self.timeAt + for pos in range(self.timePos + 1, 6): + lst[pos] = 0 + ret = time.mktime(tuple(lst)) + if bAdd: + ret = ret + self.timeAdd + return ret + + def SetNextTime(self, lastTime, now): + return lastTime + self.timeAdd + + +class EachMinuteIntervaler(EachAnyIntervaler): + def __init__(self, at=0): + EachAnyIntervaler.__init__(self, at, 5, 60, 2000) + + +class EachHourIntervaler(EachAnyIntervaler): + def __init__(self, at=0): + EachAnyIntervaler.__init__(self, at, 4, 3600, 10000) + + +class EachDayIntervaler(EachAnyIntervaler): + def __init__(self, at=0): + EachAnyIntervaler.__init__(self, at, 3, 86400, 10000) + + +class TimerDialogApp(dlgappcore.DialogApp): + def CreateDialog(self): + return TimerAppDialog() + + +def DoDemoWork(): + print("Doing the work...") + print("About to connect") + win32api.MessageBeep(win32con.MB_ICONASTERISK) + win32api.Sleep(2000) + print("Doing something else...") + win32api.MessageBeep(win32con.MB_ICONEXCLAMATION) + win32api.Sleep(2000) + print("More work.") + win32api.MessageBeep(win32con.MB_ICONHAND) + win32api.Sleep(2000) + print("The last bit.") + win32api.MessageBeep(win32con.MB_OK) + win32api.Sleep(2000) + + +app = TimerDialogApp() + + +def t(): + t = TimerAppDialog("Test Dialog") + t.DoModal() + return t + + +if __name__ == "__main__": + import demoutils + + demoutils.NeedApp() diff --git a/lib/pythonwin/pywin/Demos/app/customprint.py b/lib/pythonwin/pywin/Demos/app/customprint.py new file mode 100644 index 00000000..356073e5 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/app/customprint.py @@ -0,0 +1,186 @@ +# A demo of an Application object that has some custom print functionality. + +# If you desire, you can also run this from inside Pythonwin, in which +# case it will do the demo inside the Pythonwin environment. + +# This sample was contributed by Roger Burnham. + +import win32api +import win32con +import win32ui +from pywin.framework import app +from pywin.mfc import afxres, dialog, docview + +PRINTDLGORD = 1538 +IDC_PRINT_MAG_EDIT = 1010 + + +class PrintDemoTemplate(docview.DocTemplate): + def _SetupSharedMenu_(self): + pass + + +class PrintDemoView(docview.ScrollView): + def OnInitialUpdate(self): + ret = self._obj_.OnInitialUpdate() + self.colors = { + "Black": (0x00 << 0) + (0x00 << 8) + (0x00 << 16), + "Red": (0xFF << 0) + (0x00 << 8) + (0x00 << 16), + "Green": (0x00 << 0) + (0xFF << 8) + (0x00 << 16), + "Blue": (0x00 << 0) + (0x00 << 8) + (0xFF << 16), + "Cyan": (0x00 << 0) + (0xFF << 8) + (0xFF << 16), + "Magenta": (0xFF << 0) + (0x00 << 8) + (0xFF << 16), + "Yellow": (0xFF << 0) + (0xFF << 8) + (0x00 << 16), + } + self.pens = {} + for name, color in self.colors.items(): + self.pens[name] = win32ui.CreatePen(win32con.PS_SOLID, 5, color) + self.pen = None + self.size = (128, 128) + self.SetScaleToFitSize(self.size) + self.HookCommand(self.OnFilePrint, afxres.ID_FILE_PRINT) + self.HookCommand(self.OnFilePrintPreview, win32ui.ID_FILE_PRINT_PREVIEW) + return ret + + def OnDraw(self, dc): + oldPen = None + x, y = self.size + delta = 2 + colors = list(self.colors.keys()) + colors.sort() + colors = colors * 2 + for color in colors: + if oldPen is None: + oldPen = dc.SelectObject(self.pens[color]) + else: + dc.SelectObject(self.pens[color]) + dc.MoveTo((delta, delta)) + dc.LineTo((x - delta, delta)) + dc.LineTo((x - delta, y - delta)) + dc.LineTo((delta, y - delta)) + dc.LineTo((delta, delta)) + delta = delta + 4 + if x - delta <= 0 or y - delta <= 0: + break + dc.SelectObject(oldPen) + + def OnPrepareDC(self, dc, pInfo): + if dc.IsPrinting(): + mag = self.prtDlg["mag"] + dc.SetMapMode(win32con.MM_ANISOTROPIC) + dc.SetWindowOrg((0, 0)) + dc.SetWindowExt((1, 1)) + dc.SetViewportOrg((0, 0)) + dc.SetViewportExt((mag, mag)) + + def OnPreparePrinting(self, pInfo): + flags = ( + win32ui.PD_USEDEVMODECOPIES + | win32ui.PD_PAGENUMS + | win32ui.PD_NOPAGENUMS + | win32ui.PD_NOSELECTION + ) + self.prtDlg = ImagePrintDialog(pInfo, PRINTDLGORD, flags) + pInfo.SetPrintDialog(self.prtDlg) + pInfo.SetMinPage(1) + pInfo.SetMaxPage(1) + pInfo.SetFromPage(1) + pInfo.SetToPage(1) + ret = self.DoPreparePrinting(pInfo) + return ret + + def OnBeginPrinting(self, dc, pInfo): + return self._obj_.OnBeginPrinting(dc, pInfo) + + def OnEndPrinting(self, dc, pInfo): + del self.prtDlg + return self._obj_.OnEndPrinting(dc, pInfo) + + def OnFilePrintPreview(self, *arg): + self._obj_.OnFilePrintPreview() + + def OnFilePrint(self, *arg): + self._obj_.OnFilePrint() + + def OnPrint(self, dc, pInfo): + doc = self.GetDocument() + metrics = dc.GetTextMetrics() + cxChar = metrics["tmAveCharWidth"] + cyChar = metrics["tmHeight"] + left, top, right, bottom = pInfo.GetDraw() + dc.TextOut(0, 2 * cyChar, doc.GetTitle()) + top = top + (7 * cyChar) / 2 + dc.MoveTo(left, top) + dc.LineTo(right, top) + top = top + cyChar + # this seems to have not effect... + # get what I want with the dc.SetWindowOrg calls + pInfo.SetDraw((left, top, right, bottom)) + dc.SetWindowOrg((0, -top)) + + self.OnDraw(dc) + dc.SetTextAlign(win32con.TA_LEFT | win32con.TA_BOTTOM) + + rect = self.GetWindowRect() + rect = self.ScreenToClient(rect) + height = rect[3] - rect[1] + dc.SetWindowOrg((0, -(top + height + cyChar))) + dc.MoveTo(left, 0) + dc.LineTo(right, 0) + + x = 0 + y = (3 * cyChar) / 2 + + dc.TextOut(x, y, doc.GetTitle()) + y = y + cyChar + + +class PrintDemoApp(app.CApp): + def __init__(self): + app.CApp.__init__(self) + + def InitInstance(self): + template = PrintDemoTemplate(None, None, None, PrintDemoView) + self.AddDocTemplate(template) + self._obj_.InitMDIInstance() + self.LoadMainFrame() + doc = template.OpenDocumentFile(None) + doc.SetTitle("Custom Print Document") + + +class ImagePrintDialog(dialog.PrintDialog): + sectionPos = "Image Print Demo" + + def __init__(self, pInfo, dlgID, flags=win32ui.PD_USEDEVMODECOPIES): + dialog.PrintDialog.__init__(self, pInfo, dlgID, flags=flags) + mag = win32ui.GetProfileVal(self.sectionPos, "Document Magnification", 0) + if mag <= 0: + mag = 2 + win32ui.WriteProfileVal(self.sectionPos, "Document Magnification", mag) + + self["mag"] = mag + + def OnInitDialog(self): + self.magCtl = self.GetDlgItem(IDC_PRINT_MAG_EDIT) + self.magCtl.SetWindowText(repr(self["mag"])) + return dialog.PrintDialog.OnInitDialog(self) + + def OnOK(self): + dialog.PrintDialog.OnOK(self) + strMag = self.magCtl.GetWindowText() + try: + self["mag"] = int(strMag) + except: + pass + win32ui.WriteProfileVal(self.sectionPos, "Document Magnification", self["mag"]) + + +if __name__ == "__main__": + # Running under Pythonwin + def test(): + template = PrintDemoTemplate(None, None, None, PrintDemoView) + template.OpenDocumentFile(None) + + test() +else: + app = PrintDemoApp() diff --git a/lib/pythonwin/pywin/Demos/app/demoutils.py b/lib/pythonwin/pywin/Demos/app/demoutils.py new file mode 100644 index 00000000..ee1fefcf --- /dev/null +++ b/lib/pythonwin/pywin/Demos/app/demoutils.py @@ -0,0 +1,65 @@ +# Utilities for the demos + +import sys + +import win32api +import win32con +import win32ui + +NotScriptMsg = """\ +This demo program is not designed to be run as a Script, but is +probably used by some other test program. Please try another demo. +""" + +NeedGUIMsg = """\ +This demo program can only be run from inside of Pythonwin + +You must start Pythonwin, and select 'Run' from the toolbar or File menu +""" + + +NeedAppMsg = """\ +This demo program is a 'Pythonwin Application'. + +It is more demo code than an example of Pythonwin's capabilities. + +To run it, you must execute the command: +pythonwin.exe /app "%s" + +Would you like to execute it now? +""" + + +def NotAScript(): + import win32ui + + win32ui.MessageBox(NotScriptMsg, "Demos") + + +def NeedGoodGUI(): + from pywin.framework.app import HaveGoodGUI + + rc = HaveGoodGUI() + if not rc: + win32ui.MessageBox(NeedGUIMsg, "Demos") + return rc + + +def NeedApp(): + import win32ui + + rc = win32ui.MessageBox(NeedAppMsg % sys.argv[0], "Demos", win32con.MB_YESNO) + if rc == win32con.IDYES: + try: + parent = win32ui.GetMainFrame().GetSafeHwnd() + win32api.ShellExecute( + parent, None, "pythonwin.exe", '/app "%s"' % sys.argv[0], None, 1 + ) + except win32api.error as details: + win32ui.MessageBox("Error executing command - %s" % (details), "Demos") + + +if __name__ == "__main__": + import demoutils + + demoutils.NotAScript() diff --git a/lib/pythonwin/pywin/Demos/app/dlgappdemo.py b/lib/pythonwin/pywin/Demos/app/dlgappdemo.py new file mode 100644 index 00000000..38659a62 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/app/dlgappdemo.py @@ -0,0 +1,51 @@ +# dlgappdemo - a demo of a dialog application. +# This is a demonstration of both a custom "application" module, +# and a Python program in a dialog box. +# +# NOTE: You CAN NOT import this module from either PythonWin or Python. +# This module must be specified on the commandline to PythonWin only. +# eg, PythonWin /app dlgappdemo.py + +import sys + +import win32ui +from pywin.framework import app, dlgappcore + + +class TestDialogApp(dlgappcore.DialogApp): + def CreateDialog(self): + return TestAppDialog() + + +class TestAppDialog(dlgappcore.AppDialog): + def __init__(self): + self.edit = None + dlgappcore.AppDialog.__init__(self, win32ui.IDD_LARGE_EDIT) + + def OnInitDialog(self): + self.SetWindowText("Test dialog application") + self.edit = self.GetDlgItem(win32ui.IDC_EDIT1) + print("Hello from Python") + print("args are:", end=" ") + for arg in sys.argv: + print(arg) + return 1 + + def PreDoModal(self): + sys.stdout = sys.stderr = self + + def write(self, str): + if self.edit: + self.edit.SetSel(-2) + # translate \n to \n\r + self.edit.ReplaceSel(str.replace("\n", "\r\n")) + else: + win32ui.OutputDebug("dlgapp - no edit control! >>\n%s\n<<\n" % str) + + +app.AppBuilder = TestDialogApp + +if __name__ == "__main__": + import demoutils + + demoutils.NeedApp() diff --git a/lib/pythonwin/pywin/Demos/app/dojobapp.py b/lib/pythonwin/pywin/Demos/app/dojobapp.py new file mode 100644 index 00000000..d97ce5e2 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/app/dojobapp.py @@ -0,0 +1,72 @@ +# dojobapp - do a job, show the result in a dialog, and exit. +# +# Very simple - faily minimal dialog based app. +# +# This should be run using the command line: +# pythonwin /app demos\dojobapp.py + + +import win32api +import win32con +import win32ui +from pywin.framework import app, dlgappcore + + +class DoJobAppDialog(dlgappcore.AppDialog): + softspace = 1 + + def __init__(self, appName=""): + self.appName = appName + dlgappcore.AppDialog.__init__(self, win32ui.IDD_GENERAL_STATUS) + + def PreDoModal(self): + pass + + def ProcessArgs(self, args): + pass + + def OnInitDialog(self): + self.SetWindowText(self.appName) + butCancel = self.GetDlgItem(win32con.IDCANCEL) + butCancel.ShowWindow(win32con.SW_HIDE) + p1 = self.GetDlgItem(win32ui.IDC_PROMPT1) + p2 = self.GetDlgItem(win32ui.IDC_PROMPT2) + + # Do something here! + + p1.SetWindowText("Hello there") + p2.SetWindowText("from the demo") + + def OnDestroy(self, msg): + pass + + +# def OnOK(self): +# pass +# def OnCancel(self): default behaviour - cancel == close. +# return + + +class DoJobDialogApp(dlgappcore.DialogApp): + def CreateDialog(self): + return DoJobAppDialog("Do Something") + + +class CopyToDialogApp(DoJobDialogApp): + def __init__(self): + DoJobDialogApp.__init__(self) + + +app.AppBuilder = DoJobDialogApp + + +def t(): + t = DoJobAppDialog("Copy To") + t.DoModal() + return t + + +if __name__ == "__main__": + import demoutils + + demoutils.NeedApp() diff --git a/lib/pythonwin/pywin/Demos/app/helloapp.py b/lib/pythonwin/pywin/Demos/app/helloapp.py new file mode 100644 index 00000000..876f16f7 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/app/helloapp.py @@ -0,0 +1,53 @@ +## +## helloapp.py +## +## +## A nice, small 'hello world' Pythonwin application. +## NOT an MDI application - just a single, normal, top-level window. +## +## MUST be run with the command line "pythonwin.exe /app helloapp.py" +## (or if you are really keen, rename "pythonwin.exe" to something else, then +## using MSVC or similar, edit the string section in the .EXE to name this file) +## +## Originally by Willy Heineman + + +import win32con +import win32ui +from pywin.mfc import afxres, dialog, window +from pywin.mfc.thread import WinApp + + +# The main frame. +# Does almost nothing at all - doesnt even create a child window! +class HelloWindow(window.Wnd): + def __init__(self): + # The window.Wnd ctor creates a Window object, and places it in + # self._obj_. Note the window object exists, but the window itself + # does not! + window.Wnd.__init__(self, win32ui.CreateWnd()) + + # Now we ask the window object to create the window itself. + self._obj_.CreateWindowEx( + win32con.WS_EX_CLIENTEDGE, + win32ui.RegisterWndClass(0, 0, win32con.COLOR_WINDOW + 1), + "Hello World!", + win32con.WS_OVERLAPPEDWINDOW, + (100, 100, 400, 300), + None, + 0, + None, + ) + + +# The application object itself. +class HelloApp(WinApp): + def InitInstance(self): + self.frame = HelloWindow() + self.frame.ShowWindow(win32con.SW_SHOWNORMAL) + # We need to tell MFC what our main frame is. + self.SetMainFrame(self.frame) + + +# Now create the application object itself! +app = HelloApp() diff --git a/lib/pythonwin/pywin/Demos/cmdserver.py b/lib/pythonwin/pywin/Demos/cmdserver.py new file mode 100644 index 00000000..7b1c257a --- /dev/null +++ b/lib/pythonwin/pywin/Demos/cmdserver.py @@ -0,0 +1,116 @@ +# cmdserver.py + +# Demo code that is not Pythonwin related, but too good to throw away... + +import _thread +import sys +import traceback + +import win32api +from pywin.framework import winout + + +class ThreadWriter: + "Assign an instance to sys.stdout for per-thread printing objects - Courtesy Guido!" + + def __init__(self): + "Constructor -- initialize the table of writers" + self.writers = {} + self.origStdOut = None + + def register(self, writer): + "Register the writer for the current thread" + self.writers[_thread.get_ident()] = writer + if self.origStdOut is None: + self.origStdOut = sys.stdout + sys.stdout = self + + def unregister(self): + "Remove the writer for the current thread, if any" + try: + del self.writers[_thread.get_ident()] + except KeyError: + pass + if len(self.writers) == 0: + sys.stdout = self.origStdOut + self.origStdOut = None + + def getwriter(self): + "Return the current thread's writer, default sys.stdout" + try: + return self.writers[_thread.get_ident()] + except KeyError: + return self.origStdOut + + def write(self, str): + "Write to the current thread's writer, default sys.stdout" + self.getwriter().write(str) + + +def Test(): + num = 1 + while num < 1000: + print("Hello there no " + str(num)) + win32api.Sleep(50) + num = num + 1 + + +class flags: + SERVER_BEST = 0 + SERVER_IMMEDIATE = 1 + SERVER_THREAD = 2 + SERVER_PROCESS = 3 + + +def StartServer(cmd, title=None, bCloseOnEnd=0, serverFlags=flags.SERVER_BEST): + out = winout.WindowOutput(title, None, winout.flags.WQ_IDLE) + if not title: + title = cmd + out.Create(title) + # ServerThread((out, cmd, title, bCloseOnEnd)) + # out = sys.stdout + _thread.start_new_thread(ServerThread, (out, cmd, title, bCloseOnEnd)) + + +def ServerThread(myout, cmd, title, bCloseOnEnd): + try: + writer.register(myout) + print('Executing "%s"\n' % cmd) + bOK = 1 + try: + import __main__ + + exec(cmd + "\n", __main__.__dict__) + except: + bOK = 0 + if bOK: + print("Command terminated without errors.") + else: + t, v, tb = sys.exc_info() + print(t, ": ", v) + traceback.print_tb(tb) + tb = None # prevent a cycle + print("Command terminated with an unhandled exception") + writer.unregister() + if bOK and bCloseOnEnd: + myout.frame.DestroyWindow() + + # Unhandled exception of any kind in a thread kills the gui! + except: + t, v, tb = sys.exc_info() + print(t, ": ", v) + traceback.print_tb(tb) + tb = None + print("Thread failed") + + +# assist for reloading (when debugging) - use only 1 tracer object, +# else a large chain of tracer objects will exist. +# try: +# writer +# except NameError: +# writer=ThreadWriter() +if __name__ == "__main__": + import demoutils + + demoutils.NotAScript() diff --git a/lib/pythonwin/pywin/Demos/createwin.py b/lib/pythonwin/pywin/Demos/createwin.py new file mode 100644 index 00000000..38f6947e --- /dev/null +++ b/lib/pythonwin/pywin/Demos/createwin.py @@ -0,0 +1,114 @@ +# +# Window creation example +# +# This example creates a minimal "control" that just fills in its +# window with red. To make your own control, subclass Control and +# write your own OnPaint() method. See PyCWnd.HookMessage for what +# the parameters to OnPaint are. +# + +import win32api +import win32con +import win32ui +from pywin.mfc import dialog, window + + +class Control(window.Wnd): + """Generic control class""" + + def __init__(self): + window.Wnd.__init__(self, win32ui.CreateWnd()) + + def OnPaint(self): + dc, paintStruct = self.BeginPaint() + self.DoPaint(dc) + self.EndPaint(paintStruct) + + def DoPaint(self, dc): # Override this! + pass + + +class RedBox(Control): + def DoPaint(self, dc): + dc.FillSolidRect(self.GetClientRect(), win32api.RGB(255, 0, 0)) + + +class RedBoxWithPie(RedBox): + def DoPaint(self, dc): + RedBox.DoPaint(self, dc) + r = self.GetClientRect() + dc.Pie(r[0], r[1], r[2], r[3], 0, 0, r[2], r[3] // 2) + + +def MakeDlgTemplate(): + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + cs = win32con.WS_CHILD | win32con.WS_VISIBLE + + w = 64 + h = 64 + + dlg = [ + ["Red box", (0, 0, w, h), style, None, (8, "MS Sans Serif")], + ] + + s = win32con.WS_TABSTOP | cs + + dlg.append( + [ + 128, + "Cancel", + win32con.IDCANCEL, + (7, h - 18, 50, 14), + s | win32con.BS_PUSHBUTTON, + ] + ) + + return dlg + + +class TestDialog(dialog.Dialog): + def OnInitDialog(self): + rc = dialog.Dialog.OnInitDialog(self) + self.redbox = RedBox() + self.redbox.CreateWindow( + None, + "RedBox", + win32con.WS_CHILD | win32con.WS_VISIBLE, + (5, 5, 90, 68), + self, + 1003, + ) + return rc + + +class TestPieDialog(dialog.Dialog): + def OnInitDialog(self): + rc = dialog.Dialog.OnInitDialog(self) + self.control = RedBoxWithPie() + self.control.CreateWindow( + None, + "RedBox with Pie", + win32con.WS_CHILD | win32con.WS_VISIBLE, + (5, 5, 90, 68), + self, + 1003, + ) + + +def demo(modal=0): + d = TestPieDialog(MakeDlgTemplate()) + if modal: + d.DoModal() + else: + d.CreateWindow() + + +if __name__ == "__main__": + demo(1) diff --git a/lib/pythonwin/pywin/Demos/demoutils.py b/lib/pythonwin/pywin/Demos/demoutils.py new file mode 100644 index 00000000..f6080c46 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/demoutils.py @@ -0,0 +1,67 @@ +# Utilities for the demos + +import sys + +import win32api +import win32con +import win32ui + +NotScriptMsg = """\ +This demo program is not designed to be run as a Script, but is +probably used by some other test program. Please try another demo. +""" + +NeedGUIMsg = """\ +This demo program can only be run from inside of Pythonwin + +You must start Pythonwin, and select 'Run' from the toolbar or File menu +""" + + +NeedAppMsg = """\ +This demo program is a 'Pythonwin Application'. + +It is more demo code than an example of Pythonwin's capabilities. + +To run it, you must execute the command: +pythonwin.exe /app "%s" + +Would you like to execute it now? +""" + + +def NotAScript(): + import win32ui + + win32ui.MessageBox(NotScriptMsg, "Demos") + + +def NeedGoodGUI(): + from pywin.framework.app import HaveGoodGUI + + rc = HaveGoodGUI() + if not rc: + win32ui.MessageBox(NeedGUIMsg, "Demos") + return rc + + +def NeedApp(): + import win32ui + + rc = win32ui.MessageBox(NeedAppMsg % sys.argv[0], "Demos", win32con.MB_YESNO) + if rc == win32con.IDYES: + try: + parent = win32ui.GetMainFrame().GetSafeHwnd() + win32api.ShellExecute( + parent, None, "pythonwin.exe", '/app "%s"' % sys.argv[0], None, 1 + ) + except win32api.error as details: + win32ui.MessageBox("Error executing command - %s" % (details), "Demos") + + +from pywin.framework.app import HaveGoodGUI + +if __name__ == "__main__": + import demoutils + + demoutils.NotAScript() diff --git a/lib/pythonwin/pywin/Demos/dibdemo.py b/lib/pythonwin/pywin/Demos/dibdemo.py new file mode 100644 index 00000000..615227ab --- /dev/null +++ b/lib/pythonwin/pywin/Demos/dibdemo.py @@ -0,0 +1,73 @@ +# A demo which creates a view and a frame which displays a PPM format bitmap +# +# This hasnnt been run in a while, as I dont have many of that format around! + +import win32api +import win32con +import win32ui + + +class DIBView: + def __init__(self, doc, dib): + self.dib = dib + self.view = win32ui.CreateView(doc) + self.width = self.height = 0 + # set up message handlers + # self.view.OnPrepareDC = self.OnPrepareDC + self.view.HookMessage(self.OnSize, win32con.WM_SIZE) + + def OnSize(self, params): + lParam = params[3] + self.width = win32api.LOWORD(lParam) + self.height = win32api.HIWORD(lParam) + + def OnDraw(self, ob, dc): + # set sizes used for "non strecth" mode. + self.view.SetScrollSizes(win32con.MM_TEXT, self.dib.GetSize()) + dibSize = self.dib.GetSize() + dibRect = (0, 0, dibSize[0], dibSize[1]) + # stretch BMP. + # self.dib.Paint(dc, (0,0,self.width, self.height),dibRect) + # non stretch. + self.dib.Paint(dc) + + +class DIBDemo: + def __init__(self, filename, *bPBM): + # init data members + f = open(filename, "rb") + dib = win32ui.CreateDIBitmap() + if len(bPBM) > 0: + magic = f.readline() + if magic != "P6\n": + print("The file is not a PBM format file") + raise ValueError("Failed - The file is not a PBM format file") + # check magic? + rowcollist = f.readline().split() + cols = int(rowcollist[0]) + rows = int(rowcollist[1]) + f.readline() # whats this one? + dib.LoadPBMData(f, (cols, rows)) + else: + dib.LoadWindowsFormatFile(f) + f.close() + # create doc/view + self.doc = win32ui.CreateDoc() + self.dibView = DIBView(self.doc, dib) + self.frame = win32ui.CreateMDIFrame() + self.frame.LoadFrame() # this will force OnCreateClient + self.doc.SetTitle("DIB Demo") + self.frame.ShowWindow() + + # display the sucka + self.frame.ActivateFrame() + + def OnCreateClient(self, createparams, context): + self.dibView.view.CreateWindow(self.frame) + return 1 + + +if __name__ == "__main__": + import demoutils + + demoutils.NotAScript() diff --git a/lib/pythonwin/pywin/Demos/dlgtest.py b/lib/pythonwin/pywin/Demos/dlgtest.py new file mode 100644 index 00000000..8dcb0e5e --- /dev/null +++ b/lib/pythonwin/pywin/Demos/dlgtest.py @@ -0,0 +1,145 @@ +# A Demo of Pythonwin's Dialog and Property Page support. + +################### +# +# First demo - use the built-in to Pythonwin "Tab Stop" dialog, but +# customise it heavily. +# +# ID's for the tabstop dialog - out test. +# +import win32con +import win32ui +from pywin.mfc import dialog +from win32con import IDCANCEL +from win32ui import IDC_EDIT_TABS, IDC_PROMPT_TABS, IDD_SET_TABSTOPS + + +class TestDialog(dialog.Dialog): + def __init__(self, modal=1): + dialog.Dialog.__init__(self, IDD_SET_TABSTOPS) + self.counter = 0 + if modal: + self.DoModal() + else: + self.CreateWindow() + + def OnInitDialog(self): + # Set the caption of the dialog itself. + self.SetWindowText("Used to be Tab Stops!") + # Get a child control, remember it, and change its text. + self.edit = self.GetDlgItem(IDC_EDIT_TABS) # the text box. + self.edit.SetWindowText("Test") + # Hook a Windows message for the dialog. + self.edit.HookMessage(self.KillFocus, win32con.WM_KILLFOCUS) + # Get the prompt control, and change its next. + prompt = self.GetDlgItem(IDC_PROMPT_TABS) # the prompt box. + prompt.SetWindowText("Prompt") + # And the same for the button.. + cancel = self.GetDlgItem(IDCANCEL) # the cancel button + cancel.SetWindowText("&Kill me") + + # And just for demonstration purposes, we hook the notify message for the dialog. + # This allows us to be notified when the Edit Control text changes. + self.HookCommand(self.OnNotify, IDC_EDIT_TABS) + + def OnNotify(self, controlid, code): + if code == win32con.EN_CHANGE: + print("Edit text changed!") + return 1 # I handled this, so no need to call defaults! + + # kill focus for the edit box. + # Simply increment the value in the text box. + def KillFocus(self, msg): + self.counter = self.counter + 1 + if self.edit != None: + self.edit.SetWindowText(str(self.counter)) + + # Called when the dialog box is terminating... + def OnDestroy(self, msg): + del self.edit + del self.counter + + +# A very simply Property Sheet. +# We only make a new class for demonstration purposes. +class TestSheet(dialog.PropertySheet): + def __init__(self, title): + dialog.PropertySheet.__init__(self, title) + self.HookMessage(self.OnActivate, win32con.WM_ACTIVATE) + + def OnActivate(self, msg): + pass + + +# A very simply Property Page, which will be "owned" by the above +# Property Sheet. +# We create a new class, just so we can hook a control notification. +class TestPage(dialog.PropertyPage): + def OnInitDialog(self): + # We use the HookNotify function to allow Python to respond to + # Windows WM_NOTIFY messages. + # In this case, we are interested in BN_CLICKED messages. + self.HookNotify(self.OnNotify, win32con.BN_CLICKED) + + def OnNotify(self, std, extra): + print("OnNotify", std, extra) + + +# Some code that actually uses these objects. +def demo(modal=0): + TestDialog(modal) + + # property sheet/page demo + ps = win32ui.CreatePropertySheet("Property Sheet/Page Demo") + # Create a completely standard PropertyPage. + page1 = win32ui.CreatePropertyPage(win32ui.IDD_PROPDEMO1) + # Create our custom property page. + page2 = TestPage(win32ui.IDD_PROPDEMO2) + ps.AddPage(page1) + ps.AddPage(page2) + if modal: + ps.DoModal() + else: + style = ( + win32con.WS_SYSMENU + | win32con.WS_POPUP + | win32con.WS_CAPTION + | win32con.DS_MODALFRAME + | win32con.WS_VISIBLE + ) + styleex = win32con.WS_EX_DLGMODALFRAME | win32con.WS_EX_PALETTEWINDOW + ps.CreateWindow(win32ui.GetMainFrame(), style, styleex) + + +def test(modal=1): + # dlg=dialog.Dialog(1010) + # dlg.CreateWindow() + # dlg.EndDialog(0) + # del dlg + # return + # property sheet/page demo + ps = TestSheet("Property Sheet/Page Demo") + page1 = win32ui.CreatePropertyPage(win32ui.IDD_PROPDEMO1) + page2 = win32ui.CreatePropertyPage(win32ui.IDD_PROPDEMO2) + ps.AddPage(page1) + ps.AddPage(page2) + del page1 + del page2 + if modal: + ps.DoModal() + else: + ps.CreateWindow(win32ui.GetMainFrame()) + return ps + + +def d(): + dlg = win32ui.CreateDialog(win32ui.IDD_DEBUGGER) + dlg.datalist.append((win32ui.IDC_DBG_RADIOSTACK, "radio")) + print("data list is ", dlg.datalist) + dlg.data["radio"] = 1 + dlg.DoModal() + print(dlg.data["radio"]) + + +if __name__ == "__main__": + demo(1) diff --git a/lib/pythonwin/pywin/Demos/dyndlg.py b/lib/pythonwin/pywin/Demos/dyndlg.py new file mode 100644 index 00000000..46a4e7fc --- /dev/null +++ b/lib/pythonwin/pywin/Demos/dyndlg.py @@ -0,0 +1,104 @@ +# dyndlg.py +# contributed by Curt Hagenlocher + +# Dialog Template params: +# Parameter 0 - Window caption +# Parameter 1 - Bounds (rect tuple) +# Parameter 2 - Window style +# Parameter 3 - Extended style +# Parameter 4 - Font tuple +# Parameter 5 - Menu name +# Parameter 6 - Window class +# Dialog item params: +# Parameter 0 - Window class +# Parameter 1 - Text +# Parameter 2 - ID +# Parameter 3 - Bounds +# Parameter 4 - Style +# Parameter 5 - Extended style +# Parameter 6 - Extra data + + +import win32con +import win32ui +from pywin.mfc import dialog, window + + +def MakeDlgTemplate(): + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + cs = win32con.WS_CHILD | win32con.WS_VISIBLE + dlg = [ + ["Select Warehouse", (0, 0, 177, 93), style, None, (8, "MS Sans Serif")], + ] + dlg.append([130, "Current Warehouse:", -1, (7, 7, 69, 9), cs | win32con.SS_LEFT]) + dlg.append([130, "ASTORIA", 128, (16, 17, 99, 7), cs | win32con.SS_LEFT]) + dlg.append([130, "New &Warehouse:", -1, (7, 29, 69, 9), cs | win32con.SS_LEFT]) + s = win32con.WS_TABSTOP | cs + # dlg.append([131, None, 130, (5, 40, 110, 48), + # s | win32con.LBS_NOTIFY | win32con.LBS_SORT | win32con.LBS_NOINTEGRALHEIGHT | win32con.WS_VSCROLL | win32con.WS_BORDER]) + dlg.append( + [ + "{8E27C92B-1264-101C-8A2F-040224009C02}", + None, + 131, + (5, 40, 110, 48), + win32con.WS_TABSTOP, + ] + ) + + dlg.append( + [128, "OK", win32con.IDOK, (124, 5, 50, 14), s | win32con.BS_DEFPUSHBUTTON] + ) + s = win32con.BS_PUSHBUTTON | s + dlg.append([128, "Cancel", win32con.IDCANCEL, (124, 22, 50, 14), s]) + dlg.append([128, "&Help", 100, (124, 74, 50, 14), s]) + + return dlg + + +def test1(): + win32ui.CreateDialogIndirect(MakeDlgTemplate()).DoModal() + + +def test2(): + dialog.Dialog(MakeDlgTemplate()).DoModal() + + +def test3(): + dlg = win32ui.LoadDialogResource(win32ui.IDD_SET_TABSTOPS) + dlg[0][0] = "New Dialog Title" + dlg[0][1] = (80, 20, 161, 60) + dlg[1][1] = "&Confusion:" + cs = ( + win32con.WS_CHILD + | win32con.WS_VISIBLE + | win32con.WS_TABSTOP + | win32con.BS_PUSHBUTTON + ) + dlg.append([128, "&Help", 100, (111, 41, 40, 14), cs]) + dialog.Dialog(dlg).DoModal() + + +def test4(): + page1 = dialog.PropertyPage(win32ui.LoadDialogResource(win32ui.IDD_PROPDEMO1)) + page2 = dialog.PropertyPage(win32ui.LoadDialogResource(win32ui.IDD_PROPDEMO2)) + ps = dialog.PropertySheet("Property Sheet/Page Demo", None, [page1, page2]) + ps.DoModal() + + +def testall(): + test1() + test2() + test3() + test4() + + +if __name__ == "__main__": + testall() diff --git a/lib/pythonwin/pywin/Demos/fontdemo.py b/lib/pythonwin/pywin/Demos/fontdemo.py new file mode 100644 index 00000000..fc35f4ca --- /dev/null +++ b/lib/pythonwin/pywin/Demos/fontdemo.py @@ -0,0 +1,86 @@ +# Demo of Generic document windows, DC, and Font usage +# by Dave Brennan (brennan@hal.com) + +# usage examples: + +# >>> from fontdemo import * +# >>> d = FontDemo('Hello, Python') +# >>> f1 = { 'name':'Arial', 'height':36, 'weight':win32con.FW_BOLD} +# >>> d.SetFont(f1) +# >>> f2 = {'name':'Courier New', 'height':24, 'italic':1} +# >>> d.SetFont (f2) + +import win32api +import win32con +import win32ui +from pywin.mfc import docview + +# font is a dictionary in which the following elements matter: +# (the best matching font to supplied parameters is returned) +# name string name of the font as known by Windows +# size point size of font in logical units +# weight weight of font (win32con.FW_NORMAL, win32con.FW_BOLD) +# italic boolean; true if set to anything but None +# underline boolean; true if set to anything but None + + +class FontView(docview.ScrollView): + def __init__( + self, doc, text="Python Rules!", font_spec={"name": "Arial", "height": 42} + ): + docview.ScrollView.__init__(self, doc) + self.font = win32ui.CreateFont(font_spec) + self.text = text + self.width = self.height = 0 + # set up message handlers + self.HookMessage(self.OnSize, win32con.WM_SIZE) + + def OnAttachedObjectDeath(self): + docview.ScrollView.OnAttachedObjectDeath(self) + del self.font + + def SetFont(self, new_font): + # Change font on the fly + self.font = win32ui.CreateFont(new_font) + # redraw the entire client window + selfInvalidateRect(None) + + def OnSize(self, params): + lParam = params[3] + self.width = win32api.LOWORD(lParam) + self.height = win32api.HIWORD(lParam) + + def OnPrepareDC(self, dc, printinfo): + # Set up the DC for forthcoming OnDraw call + self.SetScrollSizes(win32con.MM_TEXT, (100, 100)) + dc.SetTextColor(win32api.RGB(0, 0, 255)) + dc.SetBkColor(win32api.GetSysColor(win32con.COLOR_WINDOW)) + dc.SelectObject(self.font) + dc.SetTextAlign(win32con.TA_CENTER | win32con.TA_BASELINE) + + def OnDraw(self, dc): + if self.width == 0 and self.height == 0: + left, top, right, bottom = self.GetClientRect() + self.width = right - left + self.height = bottom - top + x, y = self.width // 2, self.height // 2 + dc.TextOut(x, y, self.text) + + +def FontDemo(): + # create doc/view + template = docview.DocTemplate(win32ui.IDR_PYTHONTYPE, None, None, FontView) + doc = template.OpenDocumentFile(None) + doc.SetTitle("Font Demo") + # print "template is ", template, "obj is", template._obj_ + template.close() + + +# print "closed" +# del template + +if __name__ == "__main__": + import demoutils + + if demoutils.NeedGoodGUI(): + FontDemo() diff --git a/lib/pythonwin/pywin/Demos/guidemo.py b/lib/pythonwin/pywin/Demos/guidemo.py new file mode 100644 index 00000000..b4d88159 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/guidemo.py @@ -0,0 +1,86 @@ +# GUI Demo - just a worker script to invoke all the other demo/test scripts. +import sys + +import __main__ +import regutil +import win32api +import win32ui + +demos = [ # ('Font', 'import fontdemo;fontdemo.FontDemo()'), + ("Open GL Demo", "import openGLDemo;openGLDemo.test()"), + ("Threaded GUI", "import threadedgui;threadedgui.ThreadedDemo()"), + ("Tree View Demo", "import hiertest;hiertest.demoboth()"), + ("3-Way Splitter Window", "import splittst;splittst.demo()"), + ("Custom Toolbars and Tooltips", "import toolbar;toolbar.test()"), + ("Progress Bar", "import progressbar;progressbar.demo()"), + ("Slider Control", "import sliderdemo;sliderdemo.demo()"), + ("Dynamic window creation", "import createwin;createwin.demo()"), + ("Various Dialog demos", "import dlgtest;dlgtest.demo()"), + ("OCX Control Demo", "from ocx import ocxtest;ocxtest.demo()"), + ("OCX Serial Port Demo", "from ocx import ocxserialtest; ocxserialtest.test()"), + ( + "IE4 Control Demo", + 'from ocx import webbrowser; webbrowser.Demo("http://www.python.org")', + ), +] + + +def demo(): + try: + # seeif I can locate the demo files. + import fontdemo + except ImportError: + # else put the demos direectory on the path (if not already) + try: + instPath = regutil.GetRegistryDefaultValue( + regutil.BuildDefaultPythonKey() + "\\InstallPath" + ) + except win32api.error: + print( + "The InstallPath can not be located, and the Demos directory is not on the path" + ) + instPath = "." + + demosDir = win32ui.FullPath(instPath + "\\Demos") + for path in sys.path: + if win32ui.FullPath(path) == demosDir: + break + else: + sys.path.append(demosDir) + import fontdemo + + import sys + + if "/go" in sys.argv: + for name, cmd in demos: + try: + exec(cmd) + except: + print( + "Demo of %s failed - %s:%s" + % (cmd, sys.exc_info()[0], sys.exc_info()[1]) + ) + return + # Otherwise allow the user to select the demo to run + + import pywin.dialogs.list + + while 1: + rc = pywin.dialogs.list.SelectFromLists("Select a Demo", demos, ["Demo Title"]) + if rc is None: + break + title, cmd = demos[rc] + try: + exec(cmd) + except: + print( + "Demo of %s failed - %s:%s" + % (title, sys.exc_info()[0], sys.exc_info()[1]) + ) + + +if __name__ == __main__.__name__: + import demoutils + + if demoutils.NeedGoodGUI(): + demo() diff --git a/lib/pythonwin/pywin/Demos/hiertest.py b/lib/pythonwin/pywin/Demos/hiertest.py new file mode 100644 index 00000000..287b71da --- /dev/null +++ b/lib/pythonwin/pywin/Demos/hiertest.py @@ -0,0 +1,138 @@ +import os + +import commctrl +import win32ui +from pywin.mfc import docview, window +from pywin.tools import hierlist + + +# directory listbox +# This has obvious limitations - doesnt track subdirs, etc. Demonstrates +# simple use of Python code for querying the tree as needed. +# Only use strings, and lists of strings (from curdir()) +class DirHierList(hierlist.HierList): + def __init__(self, root, listBoxID=win32ui.IDC_LIST1): + hierlist.HierList.__init__(self, root, win32ui.IDB_HIERFOLDERS, listBoxID) + + def GetText(self, item): + return os.path.basename(item) + + def GetSubList(self, item): + if os.path.isdir(item): + ret = [os.path.join(item, fname) for fname in os.listdir(item)] + else: + ret = None + return ret + + # if the item is a dir, it is expandable. + def IsExpandable(self, item): + return os.path.isdir(item) + + def GetSelectedBitmapColumn(self, item): + return self.GetBitmapColumn(item) + 6 # Use different color for selection + + +class TestDocument(docview.Document): + def __init__(self, template): + docview.Document.__init__(self, template) + self.hierlist = hierlist.HierListWithItems( + HLIFileDir("\\"), win32ui.IDB_HIERFOLDERS, win32ui.AFX_IDW_PANE_FIRST + ) + + +class HierListView(docview.TreeView): + def OnInitialUpdate(self): + rc = self._obj_.OnInitialUpdate() + self.hierList = self.GetDocument().hierlist + self.hierList.HierInit(self.GetParent()) + self.hierList.SetStyle( + commctrl.TVS_HASLINES | commctrl.TVS_LINESATROOT | commctrl.TVS_HASBUTTONS + ) + return rc + + +class HierListFrame(window.MDIChildWnd): + pass + + +def GetTestRoot(): + tree1 = ("Tree 1", [("Item 1", "Item 1 data"), "Item 2", 3]) + tree2 = ("Tree 2", [("Item 2.1", "Item 2 data"), "Item 2.2", 2.3]) + return ("Root", [tree1, tree2, "Item 3"]) + + +def demoboth(): + template = docview.DocTemplate( + win32ui.IDR_PYTHONTYPE, TestDocument, HierListFrame, HierListView + ) + template.OpenDocumentFile(None).SetTitle("Hierlist demo") + + demomodeless() + + +def demomodeless(): + testList2 = DirHierList("\\") + dlg = hierlist.HierDialog("hier list test", testList2) + dlg.CreateWindow() + + +def demodlg(): + testList2 = DirHierList("\\") + dlg = hierlist.HierDialog("hier list test", testList2) + dlg.DoModal() + + +def demo(): + template = docview.DocTemplate( + win32ui.IDR_PYTHONTYPE, TestDocument, HierListFrame, HierListView + ) + template.OpenDocumentFile(None).SetTitle("Hierlist demo") + + +# +# Demo/Test for HierList items. +# +# Easy to make a better directory program. +# +class HLIFileDir(hierlist.HierListItem): + def __init__(self, filename): + self.filename = filename + hierlist.HierListItem.__init__(self) + + def GetText(self): + try: + return "%-20s %d bytes" % ( + os.path.basename(self.filename), + os.stat(self.filename)[6], + ) + except os.error as details: + return "%-20s - %s" % (self.filename, details[1]) + + def IsExpandable(self): + return os.path.isdir(self.filename) + + def GetSubList(self): + ret = [] + for newname in os.listdir(self.filename): + if newname not in (".", ".."): + ret.append(HLIFileDir(os.path.join(self.filename, newname))) + return ret + + +def demohli(): + template = docview.DocTemplate( + win32ui.IDR_PYTHONTYPE, + TestDocument, + hierlist.HierListFrame, + hierlist.HierListView, + ) + template.OpenDocumentFile(None).SetTitle("Hierlist demo") + + +if __name__ == "__main__": + import demoutils + + if demoutils.HaveGoodGUI(): + demoboth() + else: + demodlg() diff --git a/lib/pythonwin/pywin/Demos/menutest.py b/lib/pythonwin/pywin/Demos/menutest.py new file mode 100644 index 00000000..d2ba65b6 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/menutest.py @@ -0,0 +1,13 @@ +# Run this as a python script, to gray "close" off the edit window system menu. +import win32con +from pywin.framework import interact + +if __name__ == "__main__": + import demoutils + + if demoutils.NeedGoodGUI(): + win = interact.edit.currentView.GetParent() + menu = win.GetSystemMenu() + id = menu.GetMenuItemID(6) + menu.EnableMenuItem(id, win32con.MF_BYCOMMAND | win32con.MF_GRAYED) + print("The interactive window's 'Close' menu item is now disabled.") diff --git a/lib/pythonwin/pywin/Demos/objdoc.py b/lib/pythonwin/pywin/Demos/objdoc.py new file mode 100644 index 00000000..fff79253 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/objdoc.py @@ -0,0 +1,57 @@ +# This is a sample file, and shows the basic framework for using an "Object" based +# document, rather than a "filename" based document. +# This is referenced by the Pythonwin .html documentation. + +# In the example below, the OpenObject() method is used instead of OpenDocumentFile, +# and all the core MFC document open functionality is retained. + +import win32ui +from pywin.mfc import docview + + +class object_template(docview.DocTemplate): + def __init__(self): + docview.DocTemplate.__init__(self, None, None, None, object_view) + + def OpenObject(self, object): # Use this instead of OpenDocumentFile. + # Look for existing open document + for doc in self.GetDocumentList(): + print("document is ", doc) + if doc.object is object: + doc.GetFirstView().ActivateFrame() + return doc + # not found - new one. + doc = object_document(self, object) + frame = self.CreateNewFrame(doc) + doc.OnNewDocument() + doc.SetTitle(str(object)) + self.InitialUpdateFrame(frame, doc) + return doc + + +class object_document(docview.Document): + def __init__(self, template, object): + docview.Document.__init__(self, template) + self.object = object + + def OnOpenDocument(self, name): + raise RuntimeError("Should not be called if template strings set up correctly") + return 0 + + +class object_view(docview.EditView): + def OnInitialUpdate(self): + self.ReplaceSel("Object is %s" % repr(self.GetDocument().object)) + + +def demo(): + t = object_template() + d = t.OpenObject(win32ui) + return (t, d) + + +if __name__ == "__main__": + import demoutils + + if demoutils.NeedGoodGUI(): + demo() diff --git a/lib/pythonwin/pywin/Demos/ocx/__init__.py b/lib/pythonwin/pywin/Demos/ocx/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/pythonwin/pywin/Demos/ocx/demoutils.py b/lib/pythonwin/pywin/Demos/ocx/demoutils.py new file mode 100644 index 00000000..27fa091c --- /dev/null +++ b/lib/pythonwin/pywin/Demos/ocx/demoutils.py @@ -0,0 +1,67 @@ +# Utilities for the demos + +import sys + +import win32api +import win32con +import win32ui + +NotScriptMsg = """\ +This demo program is not designed to be run as a Script, but is +probably used by some other test program. Please try another demo. +""" + +NeedGUIMsg = """\ +This demo program can only be run from inside of Pythonwin + +You must start Pythonwin, and select 'Run' from the toolbar or File menu +""" + + +NeedAppMsg = """\ +This demo program is a 'Pythonwin Application'. + +It is more demo code than an example of Pythonwin's capabilities. + +To run it, you must execute the command: +pythonwin.exe /app "%s" + +Would you like to execute it now? +""" + + +def NotAScript(): + import win32ui + + win32ui.MessageBox(NotScriptMsg, "Demos") + + +def NeedGoodGUI(): + from pywin.framework.app import HaveGoodGUI + + rc = HaveGoodGUI() + if not rc: + win32ui.MessageBox(NeedGUIMsg, "Demos") + return rc + + +def NeedApp(): + import win32ui + + rc = win32ui.MessageBox(NeedAppMsg % sys.argv[0], "Demos", win32con.MB_YESNO) + if rc == win32con.IDYES: + try: + parent = win32ui.GetMainFrame().GetSafeHwnd() + win32api.ShellExecute( + parent, None, "pythonwin.exe", '/app "%s"' % sys.argv[0], None, 1 + ) + except win32api.error as details: + win32ui.MessageBox("Error executing command - %s" % (details), "Demos") + + +from pywin.framework.app import HaveGoodGUI + +if __name__ == "__main__": + from . import demoutils + + demoutils.NotAScript() diff --git a/lib/pythonwin/pywin/Demos/ocx/flash.py b/lib/pythonwin/pywin/Demos/ocx/flash.py new file mode 100644 index 00000000..239240ee --- /dev/null +++ b/lib/pythonwin/pywin/Demos/ocx/flash.py @@ -0,0 +1,95 @@ +# By Bradley Schatz +# simple flash/python application demonstrating bidirectional +# communicaion between flash and python. Click the sphere to see +# behavior. Uses Bounce.swf from FlashBounce.zip, available from +# http://pages.cpsc.ucalgary.ca/~saul/vb_examples/tutorial12/ + +# Update to the path of the .swf file (note it could be a true URL) +flash_url = "c:\\bounce.swf" + +import sys + +import regutil +import win32api +import win32con +import win32ui +from pywin.mfc import activex, window +from win32com.client import gencache + +FlashModule = gencache.EnsureModule("{D27CDB6B-AE6D-11CF-96B8-444553540000}", 0, 1, 0) + +if FlashModule is None: + raise ImportError("Flash does not appear to be installed.") + + +class MyFlashComponent(activex.Control, FlashModule.ShockwaveFlash): + def __init__(self): + activex.Control.__init__(self) + FlashModule.ShockwaveFlash.__init__(self) + self.x = 50 + self.y = 50 + self.angle = 30 + self.started = 0 + + def OnFSCommand(self, command, args): + print("FSCommend", command, args) + self.x = self.x + 20 + self.y = self.y + 20 + self.angle = self.angle + 20 + if self.x > 200 or self.y > 200: + self.x = 0 + self.y = 0 + if self.angle > 360: + self.angle = 0 + self.SetVariable("xVal", self.x) + self.SetVariable("yVal", self.y) + self.SetVariable("angle", self.angle) + self.TPlay("_root.mikeBall") + + def OnProgress(self, percentDone): + print("PercentDone", percentDone) + + def OnReadyStateChange(self, newState): + # 0=Loading, 1=Uninitialized, 2=Loaded, 3=Interactive, 4=Complete + print("State", newState) + + +class BrowserFrame(window.MDIChildWnd): + def __init__(self, url=None): + if url is None: + self.url = regutil.GetRegisteredHelpFile("Main Python Documentation") + else: + self.url = url + pass # Dont call base class doc/view version... + + def Create(self, title, rect=None, parent=None): + style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW + self._obj_ = win32ui.CreateMDIChild() + self._obj_.AttachObject(self) + self._obj_.CreateWindow(None, title, style, rect, parent) + rect = self.GetClientRect() + rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1]) + self.ocx = MyFlashComponent() + self.ocx.CreateControl( + "Flash Player", win32con.WS_VISIBLE | win32con.WS_CHILD, rect, self, 1000 + ) + self.ocx.LoadMovie(0, flash_url) + self.ocx.Play() + self.HookMessage(self.OnSize, win32con.WM_SIZE) + + def OnSize(self, params): + rect = self.GetClientRect() + rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1]) + self.ocx.SetWindowPos(0, rect, 0) + + +def Demo(): + url = None + if len(sys.argv) > 1: + url = win32api.GetFullPathName(sys.argv[1]) + f = BrowserFrame(url) + f.Create("Flash Player") + + +if __name__ == "__main__": + Demo() diff --git a/lib/pythonwin/pywin/Demos/ocx/msoffice.py b/lib/pythonwin/pywin/Demos/ocx/msoffice.py new file mode 100644 index 00000000..be24ead8 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/ocx/msoffice.py @@ -0,0 +1,152 @@ +# This demo uses some of the Microsoft Office components. +# +# It was taken from an MSDN article showing how to embed excel. +# It is not comlpete yet, but it _does_ show an Excel spreadsheet in a frame! +# + +import regutil +import win32con +import win32ui +import win32uiole +from pywin.mfc import activex, docview, object, window +from win32com.client import gencache + +# WordModule = gencache.EnsureModule('{00020905-0000-0000-C000-000000000046}', 1033, 8, 0) +# if WordModule is None: +# raise ImportError, "Microsoft Word version 8 does not appear to be installed." + + +class OleClientItem(object.CmdTarget): + def __init__(self, doc): + object.CmdTarget.__init__(self, win32uiole.CreateOleClientItem(doc)) + + def OnGetItemPosition(self): + # For now return a hard-coded rect. + return (10, 10, 210, 210) + + def OnActivate(self): + # Allow only one inplace activate item per frame + view = self.GetActiveView() + item = self.GetDocument().GetInPlaceActiveItem(view) + if item is not None and item._obj_ != self._obj_: + item.Close() + self._obj_.OnActivate() + + def OnChange(self, oleNotification, dwParam): + self._obj_.OnChange(oleNotification, dwParam) + self.GetDocument().UpdateAllViews(None) + + def OnChangeItemPosition(self, rect): + # During in-place activation CEmbed_ExcelCntrItem::OnChangeItemPosition + # is called by the server to change the position of the in-place + # window. Usually, this is a result of the data in the server + # document changing such that the extent has changed or as a result + # of in-place resizing. + # + # The default here is to call the base class, which will call + # COleClientItem::SetItemRects to move the item + # to the new position. + if not self._obj_.OnChangeItemPosition(self, rect): + return 0 + + # TODO: update any cache you may have of the item's rectangle/extent + return 1 + + +class OleDocument(object.CmdTarget): + def __init__(self, template): + object.CmdTarget.__init__(self, win32uiole.CreateOleDocument(template)) + self.EnableCompoundFile() + + +class ExcelView(docview.ScrollView): + def OnInitialUpdate(self): + self.HookMessage(self.OnSetFocus, win32con.WM_SETFOCUS) + self.HookMessage(self.OnSize, win32con.WM_SIZE) + + self.SetScrollSizes(win32con.MM_TEXT, (100, 100)) + rc = self._obj_.OnInitialUpdate() + self.EmbedExcel() + return rc + + def EmbedExcel(self): + doc = self.GetDocument() + self.clientItem = OleClientItem(doc) + self.clientItem.CreateNewItem("Excel.Sheet") + self.clientItem.DoVerb(-1, self) + doc.UpdateAllViews(None) + + def OnDraw(self, dc): + doc = self.GetDocument() + pos = doc.GetStartPosition() + clientItem, pos = doc.GetNextItem(pos) + clientItem.Draw(dc, (10, 10, 210, 210)) + + # Special handling of OnSetFocus and OnSize are required for a container + # when an object is being edited in-place. + def OnSetFocus(self, msg): + item = self.GetDocument().GetInPlaceActiveItem(self) + if ( + item is not None + and item.GetItemState() == win32uiole.COleClientItem_activeUIState + ): + wnd = item.GetInPlaceWindow() + if wnd is not None: + wnd.SetFocus() + return 0 # Dont get the base version called. + return 1 # Call the base version. + + def OnSize(self, params): + item = self.GetDocument().GetInPlaceActiveItem(self) + if item is not None: + item.SetItemRects() + return 1 # do call the base! + + +class OleTemplate(docview.DocTemplate): + def __init__( + self, resourceId=None, MakeDocument=None, MakeFrame=None, MakeView=None + ): + if MakeDocument is None: + MakeDocument = OleDocument + if MakeView is None: + MakeView = ExcelView + docview.DocTemplate.__init__( + self, resourceId, MakeDocument, MakeFrame, MakeView + ) + + +class WordFrame(window.MDIChildWnd): + def __init__(self, doc=None): + self._obj_ = win32ui.CreateMDIChild() + self._obj_.AttachObject(self) + # Dont call base class doc/view version... + + def Create(self, title, rect=None, parent=None): + style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW + self._obj_.CreateWindow(None, title, style, rect, parent) + + rect = self.GetClientRect() + rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1]) + self.ocx = MyWordControl() + self.ocx.CreateControl( + "Microsoft Word", win32con.WS_VISIBLE | win32con.WS_CHILD, rect, self, 20000 + ) + + +def Demo(): + import sys + + import win32api + + docName = None + if len(sys.argv) > 1: + docName = win32api.GetFullPathName(sys.argv[1]) + OleTemplate().OpenDocumentFile(None) + + +# f = WordFrame(docName) +# f.Create("Microsoft Office") + +if __name__ == "__main__": + Demo() diff --git a/lib/pythonwin/pywin/Demos/ocx/ocxserialtest.py b/lib/pythonwin/pywin/Demos/ocx/ocxserialtest.py new file mode 100644 index 00000000..326d312c --- /dev/null +++ b/lib/pythonwin/pywin/Demos/ocx/ocxserialtest.py @@ -0,0 +1,133 @@ +# ocxserialtest.py +# +# Sample that uses the mscomm OCX to talk to a serial +# device. + +# Very simple - queries a modem for ATI responses + +import pythoncom +import win32con +import win32ui +import win32uiole +from pywin.mfc import activex, dialog +from win32com.client import gencache + +SERIAL_SETTINGS = "19200,n,8,1" +SERIAL_PORT = 2 + +win32ui.DoWaitCursor(1) +serialModule = gencache.EnsureModule("{648A5603-2C6E-101B-82B6-000000000014}", 0, 1, 1) +win32ui.DoWaitCursor(0) +if serialModule is None: + raise ImportError("MS COMM Control does not appear to be installed on the PC") + + +def MakeDlgTemplate(): + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + cs = win32con.WS_CHILD | win32con.WS_VISIBLE + dlg = [ + ["Very Basic Terminal", (0, 0, 350, 180), style, None, (8, "MS Sans Serif")], + ] + s = win32con.WS_TABSTOP | cs + dlg.append( + [ + "RICHEDIT", + None, + 132, + (5, 5, 340, 170), + s + | win32con.ES_WANTRETURN + | win32con.ES_MULTILINE + | win32con.ES_AUTOVSCROLL + | win32con.WS_VSCROLL, + ] + ) + return dlg + + +#################################### +# +# Serial Control +# +class MySerialControl(activex.Control, serialModule.MSComm): + def __init__(self, parent): + activex.Control.__init__(self) + serialModule.MSComm.__init__(self) + self.parent = parent + + def OnComm(self): + self.parent.OnComm() + + +class TestSerDialog(dialog.Dialog): + def __init__(self, *args): + dialog.Dialog.__init__(*(self,) + args) + self.olectl = None + + def OnComm(self): + event = self.olectl.CommEvent + if event == serialModule.OnCommConstants.comEvReceive: + self.editwindow.ReplaceSel(self.olectl.Input) + + def OnKey(self, key): + if self.olectl: + self.olectl.Output = chr(key) + + def OnInitDialog(self): + rc = dialog.Dialog.OnInitDialog(self) + self.editwindow = self.GetDlgItem(132) + self.editwindow.HookAllKeyStrokes(self.OnKey) + + self.olectl = MySerialControl(self) + try: + self.olectl.CreateControl( + "OCX", + win32con.WS_TABSTOP | win32con.WS_VISIBLE, + (7, 43, 500, 300), + self._obj_, + 131, + ) + except win32ui.error: + self.MessageBox("The Serial Control could not be created") + self.olectl = None + self.EndDialog(win32con.IDCANCEL) + if self.olectl: + self.olectl.Settings = SERIAL_SETTINGS + self.olectl.CommPort = SERIAL_PORT + self.olectl.RThreshold = 1 + try: + self.olectl.PortOpen = 1 + except pythoncom.com_error as details: + print( + "Could not open the specified serial port - %s" + % (details.excepinfo[2]) + ) + self.EndDialog(win32con.IDCANCEL) + return rc + + def OnDestroy(self, msg): + if self.olectl: + try: + self.olectl.PortOpen = 0 + except pythoncom.com_error as details: + print("Error closing port - %s" % (details.excepinfo[2])) + return dialog.Dialog.OnDestroy(self, msg) + + +def test(): + d = TestSerDialog(MakeDlgTemplate()) + d.DoModal() + + +if __name__ == "__main__": + from . import demoutils + + if demoutils.NeedGoodGUI(): + test() diff --git a/lib/pythonwin/pywin/Demos/ocx/ocxtest.py b/lib/pythonwin/pywin/Demos/ocx/ocxtest.py new file mode 100644 index 00000000..4a3d7336 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/ocx/ocxtest.py @@ -0,0 +1,250 @@ +# OCX Tester for Pythonwin +# +# This file _is_ ready to run. All that is required is that the OCXs being tested +# are installed on your machine. +# +# The .py files behind the OCXs will be automatically generated and imported. + +import glob +import os + +import win32api +import win32con +import win32ui +import win32uiole +from pywin.mfc import activex, dialog, window +from win32com.client import gencache + + +def MakeDlgTemplate(): + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + cs = win32con.WS_CHILD | win32con.WS_VISIBLE + dlg = [ + ["OCX Demos", (0, 0, 350, 350), style, None, (8, "MS Sans Serif")], + ] + s = win32con.WS_TABSTOP | cs + # dlg.append([131, None, 130, (5, 40, 110, 48), + # s | win32con.LBS_NOTIFY | win32con.LBS_SORT | win32con.LBS_NOINTEGRALHEIGHT | win32con.WS_VSCROLL | win32con.WS_BORDER]) + # dlg.append(["{8E27C92B-1264-101C-8A2F-040224009C02}", None, 131, (5, 40, 110, 48),win32con.WS_TABSTOP]) + + dlg.append( + [128, "About", win32con.IDOK, (124, 5, 50, 14), s | win32con.BS_DEFPUSHBUTTON] + ) + s = win32con.BS_PUSHBUTTON | s + dlg.append([128, "Close", win32con.IDCANCEL, (124, 22, 50, 14), s]) + + return dlg + + +#################################### +# +# Calendar test code +# + + +def GetTestCalendarClass(): + global calendarParentModule + win32ui.DoWaitCursor(1) + calendarParentModule = gencache.EnsureModule( + "{8E27C92E-1264-101C-8A2F-040224009C02}", 0, 7, 0 + ) + win32ui.DoWaitCursor(0) + if calendarParentModule is None: + return None + + class TestCalDialog(dialog.Dialog): + def OnInitDialog(self): + class MyCal(activex.Control, calendarParentModule.Calendar): + def OnAfterUpdate(self): + print("OnAfterUpdate") + + def OnClick(self): + print("OnClick") + + def OnDblClick(self): + print("OnDblClick") + + def OnKeyDown(self, KeyCode, Shift): + print("OnKeyDown", KeyCode, Shift) + + def OnKeyPress(self, KeyAscii): + print("OnKeyPress", KeyAscii) + + def OnKeyUp(self, KeyCode, Shift): + print("OnKeyUp", KeyCode, Shift) + + def OnBeforeUpdate(self, Cancel): + print("OnBeforeUpdate", Cancel) + + def OnNewMonth(self): + print("OnNewMonth") + + def OnNewYear(self): + print("OnNewYear") + + rc = dialog.Dialog.OnInitDialog(self) + self.olectl = MyCal() + try: + self.olectl.CreateControl( + "OCX", + win32con.WS_TABSTOP | win32con.WS_VISIBLE, + (7, 43, 500, 300), + self._obj_, + 131, + ) + except win32ui.error: + self.MessageBox("The Calendar Control could not be created") + self.olectl = None + self.EndDialog(win32con.IDCANCEL) + + return rc + + def OnOK(self): + self.olectl.AboutBox() + + return TestCalDialog + + +#################################### +# +# Video Control +# +def GetTestVideoModule(): + global videoControlModule, videoControlFileName + win32ui.DoWaitCursor(1) + videoControlModule = gencache.EnsureModule( + "{05589FA0-C356-11CE-BF01-00AA0055595A}", 0, 2, 0 + ) + win32ui.DoWaitCursor(0) + if videoControlModule is None: + return None + fnames = glob.glob(os.path.join(win32api.GetWindowsDirectory(), "*.avi")) + if not fnames: + print("No AVI files available in system directory") + return None + videoControlFileName = fnames[0] + return videoControlModule + + +def GetTestVideoDialogClass(): + if GetTestVideoModule() is None: + return None + + class TestVideoDialog(dialog.Dialog): + def OnInitDialog(self): + rc = dialog.Dialog.OnInitDialog(self) + try: + self.olectl = activex.MakeControlInstance( + videoControlModule.ActiveMovie + ) + self.olectl.CreateControl( + "", + win32con.WS_TABSTOP | win32con.WS_VISIBLE, + (7, 43, 500, 300), + self._obj_, + 131, + ) + except win32ui.error: + self.MessageBox("The Video Control could not be created") + self.olectl = None + self.EndDialog(win32con.IDCANCEL) + return + + self.olectl.FileName = videoControlFileName + # self.olectl.Run() + return rc + + def OnOK(self): + self.olectl.AboutBox() + + return TestVideoDialog + + +############### +# +# An OCX in an MDI Frame +# +class OCXFrame(window.MDIChildWnd): + def __init__(self): + pass # Dont call base class doc/view version... + + def Create(self, controlClass, title, rect=None, parent=None): + style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW + self._obj_ = win32ui.CreateMDIChild() + self._obj_.AttachObject(self) + self._obj_.CreateWindow(None, title, style, rect, parent) + + rect = self.GetClientRect() + rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1]) + self.ocx = controlClass() + self.ocx.CreateControl( + "", win32con.WS_VISIBLE | win32con.WS_CHILD, rect, self, 1000 + ) + + +def MDITest(): + calendarParentModule = gencache.EnsureModule( + "{8E27C92E-1264-101C-8A2F-040224009C02}", 0, 7, 0 + ) + + class MyCal(activex.Control, calendarParentModule.Calendar): + def OnAfterUpdate(self): + print("OnAfterUpdate") + + def OnClick(self): + print("OnClick") + + f = OCXFrame() + f.Create(MyCal, "Calendar Test") + + +def test1(): + klass = GetTestCalendarClass() + if klass is None: + print( + "Can not test the MSAccess Calendar control - it does not appear to be installed" + ) + return + + d = klass(MakeDlgTemplate()) + d.DoModal() + + +def test2(): + klass = GetTestVideoDialogClass() + if klass is None: + print("Can not test the Video OCX - it does not appear to be installed,") + print("or no AVI files can be found.") + return + d = klass(MakeDlgTemplate()) + d.DoModal() + d = None + + +def test3(): + d = TestCOMMDialog(MakeDlgTemplate()) + d.DoModal() + d = None + + +def testall(): + test1() + test2() + + +def demo(): + testall() + + +if __name__ == "__main__": + from . import demoutils + + if demoutils.NeedGoodGUI(): + testall() diff --git a/lib/pythonwin/pywin/Demos/ocx/webbrowser.py b/lib/pythonwin/pywin/Demos/ocx/webbrowser.py new file mode 100644 index 00000000..cc17445e --- /dev/null +++ b/lib/pythonwin/pywin/Demos/ocx/webbrowser.py @@ -0,0 +1,72 @@ +# This demo uses the IE4 Web Browser control. + +# It catches an "OnNavigate" event, and updates the frame title. +# (event stuff by Neil Hodgson) + +import sys + +import regutil +import win32api +import win32con +import win32ui +from pywin.mfc import activex, window +from win32com.client import gencache + +WebBrowserModule = gencache.EnsureModule( + "{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1 +) +if WebBrowserModule is None: + raise ImportError("IE4 does not appear to be installed.") + + +class MyWebBrowser(activex.Control, WebBrowserModule.WebBrowser): + def OnBeforeNavigate2( + self, pDisp, URL, Flags, TargetFrameName, PostData, Headers, Cancel + ): + self.GetParent().OnNavigate(URL) + # print "BeforeNavigate2", pDisp, URL, Flags, TargetFrameName, PostData, Headers, Cancel + + +class BrowserFrame(window.MDIChildWnd): + def __init__(self, url=None): + if url is None: + self.url = regutil.GetRegisteredHelpFile("Main Python Documentation") + if self.url is None: + self.url = "http://www.python.org" + else: + self.url = url + pass # Dont call base class doc/view version... + + def Create(self, title, rect=None, parent=None): + style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW + self._obj_ = win32ui.CreateMDIChild() + self._obj_.AttachObject(self) + self._obj_.CreateWindow(None, title, style, rect, parent) + rect = self.GetClientRect() + rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1]) + self.ocx = MyWebBrowser() + self.ocx.CreateControl( + "Web Browser", win32con.WS_VISIBLE | win32con.WS_CHILD, rect, self, 1000 + ) + self.ocx.Navigate(self.url) + self.HookMessage(self.OnSize, win32con.WM_SIZE) + + def OnSize(self, params): + rect = self.GetClientRect() + rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1]) + self.ocx.SetWindowPos(0, rect, 0) + + def OnNavigate(self, url): + title = "Web Browser - %s" % (url,) + self.SetWindowText(title) + + +def Demo(url=None): + if url is None and len(sys.argv) > 1: + url = win32api.GetFullPathName(sys.argv[1]) + f = BrowserFrame(url) + f.Create("Web Browser") + + +if __name__ == "__main__": + Demo() diff --git a/lib/pythonwin/pywin/Demos/openGLDemo.py b/lib/pythonwin/pywin/Demos/openGLDemo.py new file mode 100644 index 00000000..9274949d --- /dev/null +++ b/lib/pythonwin/pywin/Demos/openGLDemo.py @@ -0,0 +1,370 @@ +# Ported from the win32 and MFC OpenGL Samples. + +import sys + +from pywin.mfc import docview + +try: + from OpenGL.GL import * # nopycln: import + from OpenGL.GLU import * # nopycln: import +except ImportError: + print("The OpenGL extensions do not appear to be installed.") + print("This Pythonwin demo can not run") + sys.exit(1) + +import timer +import win32api +import win32con +import win32ui + +PFD_TYPE_RGBA = 0 +PFD_TYPE_COLORINDEX = 1 +PFD_MAIN_PLANE = 0 +PFD_OVERLAY_PLANE = 1 +PFD_UNDERLAY_PLANE = -1 +PFD_DOUBLEBUFFER = 0x00000001 +PFD_STEREO = 0x00000002 +PFD_DRAW_TO_WINDOW = 0x00000004 +PFD_DRAW_TO_BITMAP = 0x00000008 +PFD_SUPPORT_GDI = 0x00000010 +PFD_SUPPORT_OPENGL = 0x00000020 +PFD_GENERIC_FORMAT = 0x00000040 +PFD_NEED_PALETTE = 0x00000080 +PFD_NEED_SYSTEM_PALETTE = 0x00000100 +PFD_SWAP_EXCHANGE = 0x00000200 +PFD_SWAP_COPY = 0x00000400 +PFD_SWAP_LAYER_BUFFERS = 0x00000800 +PFD_GENERIC_ACCELERATED = 0x00001000 +PFD_DEPTH_DONTCARE = 0x20000000 +PFD_DOUBLEBUFFER_DONTCARE = 0x40000000 +PFD_STEREO_DONTCARE = 0x80000000 + + +# threeto8 = [0, 0o111>>1, 0o222>>1, 0o333>>1, 0o444>>1, 0o555>>1, 0o666>>1, 0o377] +threeto8 = [0, 73 >> 1, 146 >> 1, 219 >> 1, 292 >> 1, 365 >> 1, 438 >> 1, 255] +twoto8 = [0, 0x55, 0xAA, 0xFF] +oneto8 = [0, 255] + + +def ComponentFromIndex(i, nbits, shift): + # val = (unsigned char) (i >> shift); + val = (i >> shift) & 0xF + if nbits == 1: + val = val & 0x1 + return oneto8[val] + elif nbits == 2: + val = val & 0x3 + return twoto8[val] + elif nbits == 3: + val = val & 0x7 + return threeto8[val] + else: + return 0 + + +OpenGLViewParent = docview.ScrollView + + +class OpenGLView(OpenGLViewParent): + def PreCreateWindow(self, cc): + self.HookMessage(self.OnSize, win32con.WM_SIZE) + # An OpenGL window must be created with the following flags and must not + # include CS_PARENTDC for the class style. Refer to SetPixelFormat + # documentation in the "Comments" section for further information. + style = cc[5] + style = style | win32con.WS_CLIPSIBLINGS | win32con.WS_CLIPCHILDREN + cc = cc[0], cc[1], cc[2], cc[3], cc[4], style, cc[6], cc[7], cc[8] + cc = self._obj_.PreCreateWindow(cc) + return cc + + def OnSize(self, params): + lParam = params[3] + cx = win32api.LOWORD(lParam) + cy = win32api.HIWORD(lParam) + glViewport(0, 0, cx, cy) + + if self.oldrect[2] > cx or self.oldrect[3] > cy: + self.RedrawWindow() + + self.OnSizeChange(cx, cy) + + self.oldrect = self.oldrect[0], self.oldrect[1], cx, cy + + def OnInitialUpdate(self): + self.SetScaleToFitSize( + (100, 100) + ) # or SetScrollSizes() - A Pythonwin requirement + return self._obj_.OnInitialUpdate() + + # return rc + + def OnCreate(self, cs): + self.oldrect = self.GetClientRect() + self._InitContexts() + self.Init() + + def OnDestroy(self, msg): + self.Term() + self._DestroyContexts() + return OpenGLViewParent.OnDestroy(self, msg) + + def OnDraw(self, dc): + self.DrawScene() + + def OnEraseBkgnd(self, dc): + return 1 + + # The OpenGL helpers + def _SetupPixelFormat(self): + dc = self.dc.GetSafeHdc() + pfd = CreatePIXELFORMATDESCRIPTOR() + pfd.dwFlags = PFD_DRAW_TO_WINDOW | PFD_SUPPORT_OPENGL | PFD_DOUBLEBUFFER + pfd.iPixelType = PFD_TYPE_RGBA + pfd.cColorBits = 24 + pfd.cDepthBits = 32 + pfd.iLayerType = PFD_MAIN_PLANE + pixelformat = ChoosePixelFormat(dc, pfd) + SetPixelFormat(dc, pixelformat, pfd) + self._CreateRGBPalette() + + def _CreateRGBPalette(self): + dc = self.dc.GetSafeHdc() + n = GetPixelFormat(dc) + pfd = DescribePixelFormat(dc, n) + if pfd.dwFlags & PFD_NEED_PALETTE: + n = 1 << pfd.cColorBits + pal = [] + for i in range(n): + this = ( + ComponentFromIndex(i, pfd.cRedBits, pfd.cRedShift), + ComponentFromIndex(i, pfd.cGreenBits, pfd.cGreenShift), + ComponentFromIndex(i, pfd.cBlueBits, pfd.cBlueShift), + 0, + ) + pal.append(this) + hpal = win32ui.CreatePalette(pal) + self.dc.SelectPalette(hpal, 0) + self.dc.RealizePalette() + + def _InitContexts(self): + self.dc = self.GetDC() + self._SetupPixelFormat() + hrc = wglCreateContext(self.dc.GetSafeHdc()) + wglMakeCurrent(self.dc.GetSafeHdc(), hrc) + + def _DestroyContexts(self): + hrc = wglGetCurrentContext() + wglMakeCurrent(0, 0) + if hrc: + wglDeleteContext(hrc) + + # The methods to support OpenGL + def DrawScene(self): + assert 0, "You must override this method" + + def Init(self): + assert 0, "You must override this method" + + def OnSizeChange(self, cx, cy): + pass + + def Term(self): + pass + + +class TestView(OpenGLView): + def OnSizeChange(self, right, bottom): + glClearColor(0.0, 0.0, 0.0, 1.0) + glClearDepth(1.0) + glEnable(GL_DEPTH_TEST) + + glMatrixMode(GL_PROJECTION) + if bottom: + aspect = right / bottom + else: + aspect = 0 # When window created! + glLoadIdentity() + gluPerspective(45.0, aspect, 3.0, 7.0) + glMatrixMode(GL_MODELVIEW) + + near_plane = 3.0 + far_plane = 7.0 + maxObjectSize = 3.0 + self.radius = near_plane + maxObjectSize / 2.0 + + def Init(self): + pass + + def DrawScene(self): + glClearColor(0.0, 0.0, 0.0, 1.0) + glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT) + + glPushMatrix() + glTranslatef(0.0, 0.0, -self.radius) + + self._DrawCone() + + self._DrawPyramid() + + glPopMatrix() + glFinish() + + SwapBuffers(wglGetCurrentDC()) + + def _DrawCone(self): + glColor3f(0.0, 1.0, 0.0) + + glPushMatrix() + glTranslatef(-1.0, 0.0, 0.0) + quadObj = gluNewQuadric() + gluQuadricDrawStyle(quadObj, GLU_FILL) + gluQuadricNormals(quadObj, GLU_SMOOTH) + gluCylinder(quadObj, 1.0, 0.0, 1.0, 20, 10) + # gluDeleteQuadric(quadObj); + glPopMatrix() + + def _DrawPyramid(self): + glPushMatrix() + glTranslatef(1.0, 0.0, 0.0) + glBegin(GL_TRIANGLE_FAN) + glColor3f(1.0, 0.0, 0.0) + glVertex3f(0.0, 1.0, 0.0) + glColor3f(0.0, 1.0, 0.0) + glVertex3f(-1.0, 0.0, 0.0) + glColor3f(0.0, 0.0, 1.0) + glVertex3f(0.0, 0.0, 1.0) + glColor3f(0.0, 1.0, 0.0) + glVertex3f(1.0, 0.0, 0.0) + glEnd() + glPopMatrix() + + +class CubeView(OpenGLView): + def OnSizeChange(self, right, bottom): + glClearColor(0.0, 0.0, 0.0, 1.0) + glClearDepth(1.0) + glEnable(GL_DEPTH_TEST) + + glMatrixMode(GL_PROJECTION) + if bottom: + aspect = right / bottom + else: + aspect = 0 # When window created! + glLoadIdentity() + gluPerspective(45.0, aspect, 3.0, 7.0) + glMatrixMode(GL_MODELVIEW) + + near_plane = 3.0 + far_plane = 7.0 + maxObjectSize = 3.0 + self.radius = near_plane + maxObjectSize / 2.0 + + def Init(self): + self.busy = 0 + self.wAngleY = 10.0 + self.wAngleX = 1.0 + self.wAngleZ = 5.0 + self.timerid = timer.set_timer(150, self.OnTimer) + + def OnTimer(self, id, timeVal): + self.DrawScene() + + def Term(self): + timer.kill_timer(self.timerid) + + def DrawScene(self): + if self.busy: + return + self.busy = 1 + + glClearColor(0.0, 0.0, 0.0, 1.0) + glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT) + + glPushMatrix() + + glTranslatef(0.0, 0.0, -self.radius) + glRotatef(self.wAngleX, 1.0, 0.0, 0.0) + glRotatef(self.wAngleY, 0.0, 1.0, 0.0) + glRotatef(self.wAngleZ, 0.0, 0.0, 1.0) + + self.wAngleX = self.wAngleX + 1.0 + self.wAngleY = self.wAngleY + 10.0 + self.wAngleZ = self.wAngleZ + 5.0 + + glBegin(GL_QUAD_STRIP) + glColor3f(1.0, 0.0, 1.0) + glVertex3f(-0.5, 0.5, 0.5) + + glColor3f(1.0, 0.0, 0.0) + glVertex3f(-0.5, -0.5, 0.5) + + glColor3f(1.0, 1.0, 1.0) + glVertex3f(0.5, 0.5, 0.5) + + glColor3f(1.0, 1.0, 0.0) + glVertex3f(0.5, -0.5, 0.5) + + glColor3f(0.0, 1.0, 1.0) + glVertex3f(0.5, 0.5, -0.5) + + glColor3f(0.0, 1.0, 0.0) + glVertex3f(0.5, -0.5, -0.5) + + glColor3f(0.0, 0.0, 1.0) + glVertex3f(-0.5, 0.5, -0.5) + + glColor3f(0.0, 0.0, 0.0) + glVertex3f(-0.5, -0.5, -0.5) + + glColor3f(1.0, 0.0, 1.0) + glVertex3f(-0.5, 0.5, 0.5) + + glColor3f(1.0, 0.0, 0.0) + glVertex3f(-0.5, -0.5, 0.5) + + glEnd() + + glBegin(GL_QUADS) + glColor3f(1.0, 0.0, 1.0) + glVertex3f(-0.5, 0.5, 0.5) + + glColor3f(1.0, 1.0, 1.0) + glVertex3f(0.5, 0.5, 0.5) + + glColor3f(0.0, 1.0, 1.0) + glVertex3f(0.5, 0.5, -0.5) + + glColor3f(0.0, 0.0, 1.0) + glVertex3f(-0.5, 0.5, -0.5) + glEnd() + + glBegin(GL_QUADS) + glColor3f(1.0, 0.0, 0.0) + glVertex3f(-0.5, -0.5, 0.5) + + glColor3f(1.0, 1.0, 0.0) + glVertex3f(0.5, -0.5, 0.5) + + glColor3f(0.0, 1.0, 0.0) + glVertex3f(0.5, -0.5, -0.5) + + glColor3f(0.0, 0.0, 0.0) + glVertex3f(-0.5, -0.5, -0.5) + glEnd() + + glPopMatrix() + + glFinish() + SwapBuffers(wglGetCurrentDC()) + + self.busy = 0 + + +def test(): + template = docview.DocTemplate(None, None, None, CubeView) + # template = docview.DocTemplate(None, None, None, TestView ) + template.OpenDocumentFile(None) + + +if __name__ == "__main__": + test() diff --git a/lib/pythonwin/pywin/Demos/progressbar.py b/lib/pythonwin/pywin/Demos/progressbar.py new file mode 100644 index 00000000..81cd7e38 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/progressbar.py @@ -0,0 +1,105 @@ +# +# Progress bar control example +# +# PyCProgressCtrl encapsulates the MFC CProgressCtrl class. To use it, +# you: +# +# - Create the control with win32ui.CreateProgressCtrl() +# - Create the control window with PyCProgressCtrl.CreateWindow() +# - Initialize the range if you want it to be other than (0, 100) using +# PyCProgressCtrl.SetRange() +# - Either: +# - Set the step size with PyCProgressCtrl.SetStep(), and +# - Increment using PyCProgressCtrl.StepIt() +# or: +# - Set the amount completed using PyCProgressCtrl.SetPos() +# +# Example and progress bar code courtesy of KDL Technologies, Ltd., Hong Kong SAR, China. +# + +import win32con +import win32ui +from pywin.mfc import dialog + + +def MakeDlgTemplate(): + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + cs = win32con.WS_CHILD | win32con.WS_VISIBLE + + w = 215 + h = 36 + + dlg = [ + [ + "Progress bar control example", + (0, 0, w, h), + style, + None, + (8, "MS Sans Serif"), + ], + ] + + s = win32con.WS_TABSTOP | cs + + dlg.append( + [ + 128, + "Tick", + win32con.IDOK, + (10, h - 18, 50, 14), + s | win32con.BS_DEFPUSHBUTTON, + ] + ) + + dlg.append( + [ + 128, + "Cancel", + win32con.IDCANCEL, + (w - 60, h - 18, 50, 14), + s | win32con.BS_PUSHBUTTON, + ] + ) + + return dlg + + +class TestDialog(dialog.Dialog): + def OnInitDialog(self): + rc = dialog.Dialog.OnInitDialog(self) + self.pbar = win32ui.CreateProgressCtrl() + self.pbar.CreateWindow( + win32con.WS_CHILD | win32con.WS_VISIBLE, (10, 10, 310, 24), self, 1001 + ) + # self.pbar.SetStep (5) + self.progress = 0 + self.pincr = 5 + return rc + + def OnOK(self): + # NB: StepIt wraps at the end if you increment past the upper limit! + # self.pbar.StepIt() + self.progress = self.progress + self.pincr + if self.progress > 100: + self.progress = 100 + if self.progress <= 100: + self.pbar.SetPos(self.progress) + + +def demo(modal=0): + d = TestDialog(MakeDlgTemplate()) + if modal: + d.DoModal() + else: + d.CreateWindow() + + +if __name__ == "__main__": + demo(1) diff --git a/lib/pythonwin/pywin/Demos/sliderdemo.py b/lib/pythonwin/pywin/Demos/sliderdemo.py new file mode 100644 index 00000000..9fc7b570 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/sliderdemo.py @@ -0,0 +1,76 @@ +# sliderdemo.py +# Demo of the slider control courtesy of Mike Fletcher. + +import win32con +import win32ui +from pywin.mfc import dialog + + +class MyDialog(dialog.Dialog): + """ + Example using simple controls + """ + + _dialogstyle = ( + win32con.WS_MINIMIZEBOX + | win32con.WS_DLGFRAME + | win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + _buttonstyle = ( + win32con.BS_PUSHBUTTON + | win32con.WS_TABSTOP + | win32con.WS_CHILD + | win32con.WS_VISIBLE + ) + ### The static template, contains all "normal" dialog items + DIALOGTEMPLATE = [ + # the dialog itself is the first element in the template + ["Example slider", (0, 0, 50, 43), _dialogstyle, None, (8, "MS SansSerif")], + # rest of elements are the controls within the dialog + # standard "Close" button + [128, "Close", win32con.IDCANCEL, (0, 30, 50, 13), _buttonstyle], + ] + ### ID of the control to be created during dialog initialisation + IDC_SLIDER = 9500 + + def __init__(self): + dialog.Dialog.__init__(self, self.DIALOGTEMPLATE) + + def OnInitDialog(self): + rc = dialog.Dialog.OnInitDialog(self) + # now initialise your controls that you want to create + # programmatically, including those which are OLE controls + # those created directly by win32ui.Create* + # and your "custom controls" which are subclasses/whatever + win32ui.EnableControlContainer() + self.slider = win32ui.CreateSliderCtrl() + self.slider.CreateWindow( + win32con.WS_TABSTOP | win32con.WS_VISIBLE, + (0, 0, 100, 30), + self._obj_, + self.IDC_SLIDER, + ) + self.HookMessage(self.OnSliderMove, win32con.WM_HSCROLL) + return rc + + def OnSliderMove(self, params): + print("Slider moved") + + def OnCancel(self): + print("The slider control is at position", self.slider.GetPos()) + self._obj_.OnCancel() + + +### +def demo(): + dia = MyDialog() + dia.DoModal() + + +if __name__ == "__main__": + demo() diff --git a/lib/pythonwin/pywin/Demos/splittst.py b/lib/pythonwin/pywin/Demos/splittst.py new file mode 100644 index 00000000..0114bf09 --- /dev/null +++ b/lib/pythonwin/pywin/Demos/splittst.py @@ -0,0 +1,79 @@ +import commctrl +import fontdemo +import win32ui +from pywin.mfc import docview, window + +# derive from CMDIChild. This does much work for us. + + +class SplitterFrame(window.MDIChildWnd): + def __init__(self): + # call base CreateFrame + self.images = None + window.MDIChildWnd.__init__(self) + + def OnCreateClient(self, cp, context): + splitter = win32ui.CreateSplitter() + doc = context.doc + frame_rect = self.GetWindowRect() + size = ((frame_rect[2] - frame_rect[0]), (frame_rect[3] - frame_rect[1]) // 2) + sub_size = (size[0] // 2, size[1]) + splitter.CreateStatic(self, 2, 1) + self.v1 = win32ui.CreateEditView(doc) + self.v2 = fontdemo.FontView(doc) + # CListControl view + self.v3 = win32ui.CreateListView(doc) + sub_splitter = win32ui.CreateSplitter() + # pass "splitter" so each view knows how to get to the others + sub_splitter.CreateStatic(splitter, 1, 2) + sub_splitter.CreateView(self.v1, 0, 0, (sub_size)) + sub_splitter.CreateView(self.v2, 0, 1, (0, 0)) # size ignored. + splitter.SetRowInfo(0, size[1], 0) + splitter.CreateView(self.v3, 1, 0, (0, 0)) # size ignored. + # Setup items in the imagelist + self.images = win32ui.CreateImageList(32, 32, 1, 5, 5) + self.images.Add(win32ui.GetApp().LoadIcon(win32ui.IDR_MAINFRAME)) + self.images.Add(win32ui.GetApp().LoadIcon(win32ui.IDR_PYTHONCONTYPE)) + self.images.Add(win32ui.GetApp().LoadIcon(win32ui.IDR_TEXTTYPE)) + self.v3.SetImageList(self.images, commctrl.LVSIL_NORMAL) + self.v3.InsertItem(0, "Icon 1", 0) + self.v3.InsertItem(0, "Icon 2", 1) + self.v3.InsertItem(0, "Icon 3", 2) + # self.v3.Arrange(commctrl.LVA_DEFAULT) Hmmm - win95 aligns left always??? + return 1 + + def OnDestroy(self, msg): + window.MDIChildWnd.OnDestroy(self, msg) + if self.images: + self.images.DeleteImageList() + self.images = None + + def InitialUpdateFrame(self, doc, makeVisible): + self.v1.ReplaceSel("Hello from Edit Window 1") + self.v1.SetModifiedFlag(0) + + +class SampleTemplate(docview.DocTemplate): + def __init__(self): + docview.DocTemplate.__init__( + self, win32ui.IDR_PYTHONTYPE, None, SplitterFrame, None + ) + + def InitialUpdateFrame(self, frame, doc, makeVisible): + # print "frame is ", frame, frame._obj_ + # print "doc is ", doc, doc._obj_ + self._obj_.InitialUpdateFrame(frame, doc, makeVisible) # call default handler. + frame.InitialUpdateFrame(doc, makeVisible) + + +def demo(): + template = SampleTemplate() + doc = template.OpenDocumentFile(None) + doc.SetTitle("Splitter Demo") + + +if __name__ == "__main__": + import demoutils + + if demoutils.NeedGoodGUI(): + demo() diff --git a/lib/pythonwin/pywin/Demos/threadedgui.py b/lib/pythonwin/pywin/Demos/threadedgui.py new file mode 100644 index 00000000..bbe1369e --- /dev/null +++ b/lib/pythonwin/pywin/Demos/threadedgui.py @@ -0,0 +1,189 @@ +# Demo of using just windows, without documents and views. + +# Also demo of a GUI thread, pretty much direct from the MFC C++ sample MTMDI. + +import timer +import win32api +import win32con +import win32ui +from pywin.mfc import docview, thread, window +from pywin.mfc.thread import WinThread + +WM_USER_PREPARE_TO_CLOSE = win32con.WM_USER + 32 + +# font is a dictionary in which the following elements matter: +# (the best matching font to supplied parameters is returned) +# name string name of the font as known by Windows +# size point size of font in logical units +# weight weight of font (win32con.FW_NORMAL, win32con.FW_BOLD) +# italic boolean; true if set to anything but None +# underline boolean; true if set to anything but None + + +# This window is a child window of a frame. It is not the frame window itself. +class FontWindow(window.Wnd): + def __init__(self, text="Python Rules!"): + window.Wnd.__init__(self) + self.text = text + self.index = 0 + self.incr = 1 + self.width = self.height = 0 + self.ChangeAttributes() + # set up message handlers + + def Create(self, title, style, rect, parent): + classStyle = win32con.CS_HREDRAW | win32con.CS_VREDRAW + className = win32ui.RegisterWndClass( + classStyle, 0, win32con.COLOR_WINDOW + 1, 0 + ) + self._obj_ = win32ui.CreateWnd() + self._obj_.AttachObject(self) + self._obj_.CreateWindow( + className, title, style, rect, parent, win32ui.AFX_IDW_PANE_FIRST + ) + self.HookMessage(self.OnSize, win32con.WM_SIZE) + self.HookMessage(self.OnPrepareToClose, WM_USER_PREPARE_TO_CLOSE) + self.HookMessage(self.OnDestroy, win32con.WM_DESTROY) + self.timerid = timer.set_timer(100, self.OnTimer) + self.InvalidateRect() + + def OnDestroy(self, msg): + timer.kill_timer(self.timerid) + + def OnTimer(self, id, timeVal): + self.index = self.index + self.incr + if self.index > len(self.text): + self.incr = -1 + self.index = len(self.text) + elif self.index < 0: + self.incr = 1 + self.index = 0 + self.InvalidateRect() + + def OnPaint(self): + # print "Paint message from thread", win32api.GetCurrentThreadId() + dc, paintStruct = self.BeginPaint() + self.OnPrepareDC(dc, None) + + if self.width == 0 and self.height == 0: + left, top, right, bottom = self.GetClientRect() + self.width = right - left + self.height = bottom - top + x, y = self.width // 2, self.height // 2 + dc.TextOut(x, y, self.text[: self.index]) + self.EndPaint(paintStruct) + + def ChangeAttributes(self): + font_spec = {"name": "Arial", "height": 42} + self.font = win32ui.CreateFont(font_spec) + + def OnPrepareToClose(self, params): + self.DestroyWindow() + + def OnSize(self, params): + lParam = params[3] + self.width = win32api.LOWORD(lParam) + self.height = win32api.HIWORD(lParam) + + def OnPrepareDC(self, dc, printinfo): + # Set up the DC for forthcoming OnDraw call + dc.SetTextColor(win32api.RGB(0, 0, 255)) + dc.SetBkColor(win32api.GetSysColor(win32con.COLOR_WINDOW)) + dc.SelectObject(self.font) + dc.SetTextAlign(win32con.TA_CENTER | win32con.TA_BASELINE) + + +class FontFrame(window.MDIChildWnd): + def __init__(self): + pass # Dont call base class doc/view version... + + def Create(self, title, rect=None, parent=None): + style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW + self._obj_ = win32ui.CreateMDIChild() + self._obj_.AttachObject(self) + + self._obj_.CreateWindow(None, title, style, rect, parent) + rect = self.GetClientRect() + rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1]) + self.child = FontWindow("Not threaded") + self.child.Create( + "FontDemo", win32con.WS_CHILD | win32con.WS_VISIBLE, rect, self + ) + + +class TestThread(WinThread): + def __init__(self, parentWindow): + self.parentWindow = parentWindow + self.child = None + WinThread.__init__(self) + + def InitInstance(self): + rect = self.parentWindow.GetClientRect() + rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1]) + + self.child = FontWindow() + self.child.Create( + "FontDemo", win32con.WS_CHILD | win32con.WS_VISIBLE, rect, self.parentWindow + ) + self.SetMainFrame(self.child) + return WinThread.InitInstance(self) + + def ExitInstance(self): + return 0 + + +class ThreadedFontFrame(window.MDIChildWnd): + def __init__(self): + pass # Dont call base class doc/view version... + self.thread = None + + def Create(self, title, rect=None, parent=None): + style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW + self._obj_ = win32ui.CreateMDIChild() + self._obj_.CreateWindow(None, title, style, rect, parent) + self._obj_.HookMessage(self.OnDestroy, win32con.WM_DESTROY) + self._obj_.HookMessage(self.OnSize, win32con.WM_SIZE) + + self.thread = TestThread(self) + self.thread.CreateThread() + + def OnSize(self, msg): + pass + + def OnDestroy(self, msg): + win32ui.OutputDebugString("OnDestroy\n") + if self.thread and self.thread.child: + child = self.thread.child + child.SendMessage(WM_USER_PREPARE_TO_CLOSE, 0, 0) + win32ui.OutputDebugString("Destroyed\n") + + +def Demo(): + f = FontFrame() + f.Create("Font Demo") + + +def ThreadedDemo(): + rect = win32ui.GetMainFrame().GetMDIClient().GetClientRect() + rect = rect[0], int(rect[3] * 3 / 4), int(rect[2] / 4), rect[3] + incr = rect[2] + for i in range(4): + if i == 0: + f = FontFrame() + title = "Not threaded" + else: + f = ThreadedFontFrame() + title = "Threaded GUI Demo" + f.Create(title, rect) + rect = rect[0] + incr, rect[1], rect[2] + incr, rect[3] + # Givem a chance to start + win32api.Sleep(100) + win32ui.PumpWaitingMessages() + + +if __name__ == "__main__": + import demoutils + + if demoutils.NeedGoodGUI(): + ThreadedDemo() +# Demo() diff --git a/lib/pythonwin/pywin/Demos/toolbar.py b/lib/pythonwin/pywin/Demos/toolbar.py new file mode 100644 index 00000000..e56aefef --- /dev/null +++ b/lib/pythonwin/pywin/Demos/toolbar.py @@ -0,0 +1,106 @@ +# Demo of ToolBars + +# Shows the toolbar control. +# Demos how to make custom tooltips, etc. + +import commctrl +import win32api +import win32con +import win32ui +from pywin.mfc import afxres, docview, window + + +class GenericFrame(window.MDIChildWnd): + def OnCreateClient(self, cp, context): + # handlers for toolbar buttons + self.HookCommand(self.OnPrevious, 401) + self.HookCommand(self.OnNext, 402) + # Its not necessary for us to hook both of these - the + # common controls should fall-back all by themselves. + # Indeed, given we hook TTN_NEEDTEXTW, commctrl.TTN_NEEDTEXTA + # will not be called. + self.HookNotify(self.GetTTText, commctrl.TTN_NEEDTEXT) + self.HookNotify(self.GetTTText, commctrl.TTN_NEEDTEXTW) + + # parent = win32ui.GetMainFrame() + parent = self + style = ( + win32con.WS_CHILD + | win32con.WS_VISIBLE + | afxres.CBRS_SIZE_DYNAMIC + | afxres.CBRS_TOP + | afxres.CBRS_TOOLTIPS + | afxres.CBRS_FLYBY + ) + + buttons = (win32ui.ID_APP_ABOUT, win32ui.ID_VIEW_INTERACTIVE) + bitmap = win32ui.IDB_BROWSER_HIER + tbid = 0xE840 + self.toolbar = tb = win32ui.CreateToolBar(parent, style, tbid) + tb.LoadBitmap(bitmap) + tb.SetButtons(buttons) + + tb.EnableDocking(afxres.CBRS_ALIGN_ANY) + tb.SetWindowText("Test") + parent.EnableDocking(afxres.CBRS_ALIGN_ANY) + parent.DockControlBar(tb) + parent.LoadBarState("ToolbarTest") + window.MDIChildWnd.OnCreateClient(self, cp, context) + return 1 + + def OnDestroy(self, msg): + self.SaveBarState("ToolbarTest") + + def GetTTText(self, std, extra): + (hwndFrom, idFrom, code) = std + text, hinst, flags = extra + if flags & commctrl.TTF_IDISHWND: + return # Not handled + if idFrom == win32ui.ID_APP_ABOUT: + # our 'extra' return value needs to be the following + # entries from a NMTTDISPINFO[W] struct: + # (szText, hinst, uFlags). None means 'don't change + # the value' + return 0, ("It works!", None, None) + return None # not handled. + + def GetMessageString(self, id): + if id == win32ui.ID_APP_ABOUT: + return "Dialog Test\nTest" + else: + return self._obj_.GetMessageString(id) + + def OnSize(self, params): + print("OnSize called with ", params) + + def OnNext(self, id, cmd): + print("OnNext called") + + def OnPrevious(self, id, cmd): + print("OnPrevious called") + + +msg = """\ +This toolbar was dynamically created.\r +\r +The first item's tooltips is provided by Python code.\r +\r +(Dont close the window with the toolbar in a floating state - it may not re-appear!)\r +""" + + +def test(): + template = docview.DocTemplate( + win32ui.IDR_PYTHONTYPE, None, GenericFrame, docview.EditView + ) + doc = template.OpenDocumentFile(None) + doc.SetTitle("Toolbar Test") + view = doc.GetFirstView() + view.SetWindowText(msg) + + +if __name__ == "__main__": + import demoutils + + if demoutils.NeedGoodGUI(): + test() diff --git a/lib/pythonwin/pywin/IDLE.cfg b/lib/pythonwin/pywin/IDLE.cfg new file mode 100644 index 00000000..b1987b14 --- /dev/null +++ b/lib/pythonwin/pywin/IDLE.cfg @@ -0,0 +1,29 @@ +[General] +# We base this configuration on the default config. +# You can list "Based On" as many times as you like +Based On = default + +[Keys] +# Only list keys different to default. +# Note you may wish to rebind some of the default +# Pythonwin keys to "Beep" or "DoNothing" + +Alt+L = LocateSelectedFile +Ctrl+Q = AppExit + +# Other non-default Pythonwin keys +Alt+A = EditSelectAll +Alt+M = LocateModule + +# Movement +Ctrl+D = GotoEndOfFile + +# Tabs and other indent features +Alt+T = <> +Ctrl+[ = <> +Ctrl+] = <> + +[Keys:Interactive] +Alt+P = <> +Alt+N = <> + diff --git a/lib/pythonwin/pywin/__init__.py b/lib/pythonwin/pywin/__init__.py new file mode 100644 index 00000000..2e44fba5 --- /dev/null +++ b/lib/pythonwin/pywin/__init__.py @@ -0,0 +1,10 @@ +# is_platform_unicode is an old variable that was never correctly used and +# is no longer referenced in pywin32. It is staying for a few releases incase +# others are looking at it, but it will go away soon! +is_platform_unicode = 0 + +# Ditto default_platform_encoding - not referenced and will die. +default_platform_encoding = "mbcs" + +# This one *is* real and used - but in practice can't be changed. +default_scintilla_encoding = "utf-8" # Scintilla _only_ supports this ATM diff --git a/lib/pythonwin/pywin/default.cfg b/lib/pythonwin/pywin/default.cfg new file mode 100644 index 00000000..55371f6b --- /dev/null +++ b/lib/pythonwin/pywin/default.cfg @@ -0,0 +1,215 @@ +# The default keyboard etc configuration file for Pythonwin. +# +# The format of this file is very similar to a Windows INI file. +# Sections are identified with [Section] lines, but comments +# use the standatd Python # character. Depending on the section, +# lines may not be in the standard "key=value" format. + +# NOTE: You should not need to modify this file. +# Simply create a new .CFG file, and add an entry: +# [General] +# BasedOn = Default +# +# and add your customisations. Then select your new configuration +# from the Pythonwin View/Options/Editor dialog. +# This way you get to add your own customisations, +# but still take advantage of changes to the default +# configuration in new releases. + +# See IDLE.cfg for an example extension configuration. +# +########################################################################## + +[IDLE Extensions] + +# The list of IDLE extensions to load. The extensions +# AutoIndent, AutoFormat and possibly others are +# "built-in", so do not need specifying. + +FormatParagraph +CallTips + + +[Keys] + +# The list of _default_ key definitions. +# See [Keys:Interactive] and [Keys:Editor] below for further defs. + +#Events of the format <> +# are events defined in IDLE extensions. + +Alt+Q = <> + +Ctrl+W = ViewWhitespace +Ctrl+Shift+8 = ViewWhitespace # The MSVC default key def. + +Ctrl+Shift+F = ViewFixedFont + +# Auto-complete, call-tips, etc. +Alt+/ = <> +Ctrl+Space = <> +( = <> +) = <> +Up = <> +Down = <> +Left = <> +Right = <> +. = KeyDot + +# Debugger - These are the MSVC default keys, for want of a better choice. +F9 = DbgBreakpointToggle +F5 = DbgGo +Shift+F5 = DbgClose +F11 = DbgStep +F10 = DbgStepOver +Shift+F11 = DbgStepOut + +Ctrl+F3 = AutoFindNext + + +[Keys:Editor] +# Key bindings specific to the editor +F2 = GotoNextBookmark +Ctrl+F2 = ToggleBookmark +Ctrl+G = GotoLine + +Alt+I = ShowInteractiveWindow +Alt-B = AddBanner # A sample Event defined in this file. + +# Block operations +Alt+3 = <> +Shift+Alt+3 = <> +Alt+4 = <> # IDLE default. +Alt+5 = <> +Alt+6 = <> + +# Tabs and other indent features +Back = <> +Ctrl+T = <> +Alt+U = <> +Enter = EnterKey +Tab = TabKey +Shift-Tab = <> + +# Folding +Add = FoldExpand +Alt+Add = FoldExpandAll +Shift+Add = FoldExpandSecondLevel +Subtract = FoldCollapse +Alt+Subtract = FoldCollapseAll +Shift+Subtract = FoldCollapseSecondLevel +Multiply = FoldTopLevel + +[Keys:Interactive] +# Key bindings specific to the interactive window. +# History for the interactive window +Ctrl+Up = <> +Ctrl+Down = <> +Enter = ProcessEnter +Ctrl+Enter = ProcessEnter +Shift+Enter = ProcessEnter +Esc = ProcessEsc +Alt+I = WindowBack # Toggle back to previous window. +Home = InteractiveHome # A sample Event defined in this file. +Shift+Home = InteractiveHomeExtend # A sample Event defined in this file. + +# When docked, the Ctrl+Tab and Shift+Ctrl+Tab keys dont work as expected. +Ctrl+Tab = MDINext +Ctrl+Shift+Tab = MDIPrev + +[Extensions] +# Python event handlers specific to this config file. +# All functions not starting with an "_" are assumed +# to be events, and take 2 params: +# * editor_window is the same object passed to IDLE +# extensions. editor_window.text is a text widget +# that conforms to the Tk text widget interface. +# * event is the event being fired. Will always be None +# in the current implementation. + +# Simply by defining these functions, they are available as +# events. +# Note that we bind keystrokes to these events in the various +# [Keys] sections. + +# Add a simple file/class/function simple banner +def AddBanner(editor_window, event): + + text = editor_window.text + big_line = "#" * 70 + banner = "%s\n## \n## \n## \n%s\n" % (big_line, big_line) + + # Insert at the start of the current line. + pos = text.index("insert linestart") + + text.undo_block_start() # Allow action to be undone as a single unit. + text.insert(pos, banner) + text.undo_block_stop() + + # Now set the insert point to the middle of the banner. + line, col = [int(s) for s in pos.split(".")] + text.mark_set("insert", "%d.1 lineend" % (line+2, ) ) + + +# Here is a sample event bound to the "Home" key in the +# interactive window +def InteractiveHome(editor_window, event): + return _DoInteractiveHome(editor_window.text, 0) + +def InteractiveHomeExtend(editor_window, event): + return _DoInteractiveHome(editor_window.text, 1) + +def _DoInteractiveHome(text, extend): + import sys + # If Scintilla has an autocomplete window open, then let Scintilla handle it. + if text.edit.SCIAutoCActive(): + return 1 + of_interest = "insert linestart + %d c" % len(sys.ps1) + if not text.compare("insert", "==", of_interest) and \ + text.get("insert linestart", of_interest) in [sys.ps1, sys.ps2]: # Not sys.ps? line + end = of_interest + else: + end = "insert linestart" + + if extend: start = "insert" + else: start = end + text.tag_add("sel", start, end) + +# From Niki Spahie +def AutoFindNext(editor_window, event): + "find selected text or word under cursor" + + from pywin.scintilla import find + from pywin.scintilla import scintillacon + + try: + sci = editor_window.edit + word = sci.GetSelText() + if word: + find.lastSearch.findText = word + find.lastSearch.sel = sci.GetSel() + else: + pos = sci.SendScintilla( scintillacon.SCI_GETCURRENTPOS ) + start = sci.SendScintilla( scintillacon.SCI_WORDSTARTPOSITION, pos, 1 ) + end = sci.SendScintilla( scintillacon.SCI_WORDENDPOSITION, pos, 1 ) + word = sci.GetTextRange( start, end ) + if word: + find.lastSearch.findText = word + find.lastSearch.sel = (start,end) + except Exception: + import traceback + traceback.print_exc() + find.FindNext() + + +# A couple of generic events. +def Beep(editor_window, event): + editor_window.text.beep() + +def DoNothing(editor_window, event): + pass + +def ContinueEvent(editor_window, event): + # Almost an "unbind" - allows Pythonwin/MFC to handle the keystroke + return 1 + diff --git a/lib/pythonwin/pywin/dialogs/__init__.py b/lib/pythonwin/pywin/dialogs/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/pythonwin/pywin/dialogs/ideoptions.py b/lib/pythonwin/pywin/dialogs/ideoptions.py new file mode 100644 index 00000000..f1bae90d --- /dev/null +++ b/lib/pythonwin/pywin/dialogs/ideoptions.py @@ -0,0 +1,139 @@ +# The property page to define generic IDE options for Pythonwin + +import win32con +import win32ui +from pywin.framework import interact +from pywin.mfc import dialog + +buttonControlMap = { + win32ui.IDC_BUTTON1: win32ui.IDC_EDIT1, + win32ui.IDC_BUTTON2: win32ui.IDC_EDIT2, + win32ui.IDC_BUTTON3: win32ui.IDC_EDIT3, +} + + +class OptionsPropPage(dialog.PropertyPage): + def __init__(self): + dialog.PropertyPage.__init__(self, win32ui.IDD_PP_IDE) + self.AddDDX(win32ui.IDC_CHECK1, "bShowAtStartup") + self.AddDDX(win32ui.IDC_CHECK2, "bDocking") + self.AddDDX(win32ui.IDC_EDIT4, "MRUSize", "i") + + def OnInitDialog(self): + edit = self.GetDlgItem(win32ui.IDC_EDIT1) + format = eval( + win32ui.GetProfileVal( + interact.sectionProfile, + interact.STYLE_INTERACTIVE_PROMPT, + str(interact.formatInput), + ) + ) + edit.SetDefaultCharFormat(format) + edit.SetWindowText("Input Text") + + edit = self.GetDlgItem(win32ui.IDC_EDIT2) + format = eval( + win32ui.GetProfileVal( + interact.sectionProfile, + interact.STYLE_INTERACTIVE_OUTPUT, + str(interact.formatOutput), + ) + ) + edit.SetDefaultCharFormat(format) + edit.SetWindowText("Output Text") + + edit = self.GetDlgItem(win32ui.IDC_EDIT3) + format = eval( + win32ui.GetProfileVal( + interact.sectionProfile, + interact.STYLE_INTERACTIVE_ERROR, + str(interact.formatOutputError), + ) + ) + edit.SetDefaultCharFormat(format) + edit.SetWindowText("Error Text") + + self["bShowAtStartup"] = interact.LoadPreference("Show at startup", 1) + self["bDocking"] = interact.LoadPreference("Docking", 0) + self["MRUSize"] = win32ui.GetProfileVal("Settings", "Recent File List Size", 10) + + # Hook the button clicks. + self.HookCommand(self.HandleCharFormatChange, win32ui.IDC_BUTTON1) + self.HookCommand(self.HandleCharFormatChange, win32ui.IDC_BUTTON2) + self.HookCommand(self.HandleCharFormatChange, win32ui.IDC_BUTTON3) + + # Ensure the spin control remains in range. + spinner = self.GetDlgItem(win32ui.IDC_SPIN1) + spinner.SetRange(1, 16) + + return dialog.PropertyPage.OnInitDialog(self) + + # Called to save away the new format tuple for the specified item. + def HandleCharFormatChange(self, id, code): + if code == win32con.BN_CLICKED: + editId = buttonControlMap.get(id) + assert editId is not None, "Format button has no associated edit control" + editControl = self.GetDlgItem(editId) + existingFormat = editControl.GetDefaultCharFormat() + flags = win32con.CF_SCREENFONTS + d = win32ui.CreateFontDialog(existingFormat, flags, None, self) + if d.DoModal() == win32con.IDOK: + cf = d.GetCharFormat() + editControl.SetDefaultCharFormat(cf) + self.SetModified(1) + return 0 # We handled this fully! + + def OnOK(self): + # Handle the edit controls - get all the fonts, put them back into interact, then + # get interact to save its stuff! + controlAttrs = [ + (win32ui.IDC_EDIT1, interact.STYLE_INTERACTIVE_PROMPT), + (win32ui.IDC_EDIT2, interact.STYLE_INTERACTIVE_OUTPUT), + (win32ui.IDC_EDIT3, interact.STYLE_INTERACTIVE_ERROR), + ] + for id, key in controlAttrs: + control = self.GetDlgItem(id) + fmt = control.GetDefaultCharFormat() + win32ui.WriteProfileVal(interact.sectionProfile, key, str(fmt)) + + # Save the other interactive window options. + interact.SavePreference("Show at startup", self["bShowAtStartup"]) + interact.SavePreference("Docking", self["bDocking"]) + + # And the other options. + win32ui.WriteProfileVal("Settings", "Recent File List Size", self["MRUSize"]) + + return 1 + + def ChangeFormat(self, fmtAttribute, fmt): + dlg = win32ui.CreateFontDialog(fmt) + if dlg.DoModal() != win32con.IDOK: + return None + return dlg.GetCharFormat() + + def OnFormatTitle(self, command, code): + fmt = self.GetFormat(interact.formatTitle) + if fmt: + formatTitle = fmt + SaveFontPreferences() + + def OnFormatInput(self, command, code): + global formatInput + fmt = self.GetFormat(formatInput) + if fmt: + formatInput = fmt + SaveFontPreferences() + + def OnFormatOutput(self, command, code): + global formatOutput + fmt = self.GetFormat(formatOutput) + if fmt: + formatOutput = fmt + SaveFontPreferences() + + def OnFormatError(self, command, code): + global formatOutputError + fmt = self.GetFormat(formatOutputError) + if fmt: + formatOutputError = fmt + SaveFontPreferences() diff --git a/lib/pythonwin/pywin/dialogs/list.py b/lib/pythonwin/pywin/dialogs/list.py new file mode 100644 index 00000000..b9934ce7 --- /dev/null +++ b/lib/pythonwin/pywin/dialogs/list.py @@ -0,0 +1,143 @@ +import commctrl +import win32api +import win32con +import win32ui +from pywin.mfc import dialog + + +class ListDialog(dialog.Dialog): + def __init__(self, title, list): + dialog.Dialog.__init__(self, self._maketemplate(title)) + self.HookMessage(self.on_size, win32con.WM_SIZE) + self.HookNotify(self.OnListItemChange, commctrl.LVN_ITEMCHANGED) + self.HookCommand(self.OnListClick, win32ui.IDC_LIST1) + self.items = list + + def _maketemplate(self, title): + style = win32con.WS_DLGFRAME | win32con.WS_SYSMENU | win32con.WS_VISIBLE + ls = ( + win32con.WS_CHILD + | win32con.WS_VISIBLE + | commctrl.LVS_ALIGNLEFT + | commctrl.LVS_REPORT + ) + bs = win32con.WS_CHILD | win32con.WS_VISIBLE + return [ + [title, (0, 0, 200, 200), style, None, (8, "MS Sans Serif")], + ["SysListView32", None, win32ui.IDC_LIST1, (0, 0, 200, 200), ls], + [128, "OK", win32con.IDOK, (10, 0, 50, 14), bs | win32con.BS_DEFPUSHBUTTON], + [128, "Cancel", win32con.IDCANCEL, (0, 0, 50, 14), bs], + ] + + def FillList(self): + size = self.GetWindowRect() + width = size[2] - size[0] - (10) + itemDetails = (commctrl.LVCFMT_LEFT, width, "Item", 0) + self.itemsControl.InsertColumn(0, itemDetails) + index = 0 + for item in self.items: + index = self.itemsControl.InsertItem(index + 1, str(item), 0) + + def OnListClick(self, id, code): + if code == commctrl.NM_DBLCLK: + self.EndDialog(win32con.IDOK) + return 1 + + def OnListItemChange(self, std, extra): + (hwndFrom, idFrom, code), ( + itemNotify, + sub, + newState, + oldState, + change, + point, + lparam, + ) = (std, extra) + oldSel = (oldState & commctrl.LVIS_SELECTED) != 0 + newSel = (newState & commctrl.LVIS_SELECTED) != 0 + if oldSel != newSel: + try: + self.selecteditem = itemNotify + self.butOK.EnableWindow(1) + except win32ui.error: + self.selecteditem = None + + def OnInitDialog(self): + rc = dialog.Dialog.OnInitDialog(self) + self.itemsControl = self.GetDlgItem(win32ui.IDC_LIST1) + self.butOK = self.GetDlgItem(win32con.IDOK) + self.butCancel = self.GetDlgItem(win32con.IDCANCEL) + + self.FillList() + + size = self.GetWindowRect() + self.LayoutControls(size[2] - size[0], size[3] - size[1]) + self.butOK.EnableWindow(0) # wait for first selection + return rc + + def LayoutControls(self, w, h): + self.itemsControl.MoveWindow((0, 0, w, h - 30)) + self.butCancel.MoveWindow((10, h - 24, 60, h - 4)) + self.butOK.MoveWindow((w - 60, h - 24, w - 10, h - 4)) + + def on_size(self, params): + lparam = params[3] + w = win32api.LOWORD(lparam) + h = win32api.HIWORD(lparam) + self.LayoutControls(w, h) + + +class ListsDialog(ListDialog): + def __init__(self, title, list, colHeadings=["Item"]): + ListDialog.__init__(self, title, list) + self.colHeadings = colHeadings + + def FillList(self): + index = 0 + size = self.GetWindowRect() + width = ( + size[2] - size[0] - (10) - win32api.GetSystemMetrics(win32con.SM_CXVSCROLL) + ) + numCols = len(self.colHeadings) + + for col in self.colHeadings: + itemDetails = (commctrl.LVCFMT_LEFT, int(width / numCols), col, 0) + self.itemsControl.InsertColumn(index, itemDetails) + index = index + 1 + index = 0 + for items in self.items: + index = self.itemsControl.InsertItem(index + 1, str(items[0]), 0) + for itemno in range(1, numCols): + item = items[itemno] + self.itemsControl.SetItemText(index, itemno, str(item)) + + +def SelectFromList(title, lst): + dlg = ListDialog(title, lst) + if dlg.DoModal() == win32con.IDOK: + return dlg.selecteditem + else: + return None + + +def SelectFromLists(title, lists, headings): + dlg = ListsDialog(title, lists, headings) + if dlg.DoModal() == win32con.IDOK: + return dlg.selecteditem + else: + return None + + +def test(): + # print SelectFromList('Single list', [1,2,3]) + print( + SelectFromLists( + "Multi-List", + [("1", 1, "a"), ("2", 2, "b"), ("3", 3, "c")], + ["Col 1", "Col 2"], + ) + ) + + +if __name__ == "__main__": + test() diff --git a/lib/pythonwin/pywin/dialogs/login.py b/lib/pythonwin/pywin/dialogs/login.py new file mode 100644 index 00000000..2a329569 --- /dev/null +++ b/lib/pythonwin/pywin/dialogs/login.py @@ -0,0 +1,156 @@ +"""login -- PythonWin user ID and password dialog box + +(Adapted from originally distributed with Mark Hammond's PythonWin - +this now replaces it!) + +login.GetLogin() displays a modal "OK/Cancel" dialog box with input +fields for a user ID and password. The password field input is masked +with *'s. GetLogin takes two optional parameters, a window title, and a +default user ID. If these parameters are omitted, the title defaults to +"Login", and the user ID is left blank. GetLogin returns a (userid, password) +tuple. GetLogin can be called from scripts running on the console - i.e. you +don't need to write a full-blown GUI app to use it. + +login.GetPassword() is similar, except there is no username field. + +Example: +import pywin.dialogs.login +title = "FTP Login" +def_user = "fred" +userid, password = pywin.dialogs.login.GetLogin(title, def_user) + +Jim Eggleston, 28 August 1996 +Merged with dlgpass and moved to pywin.dialogs by Mark Hammond Jan 1998. +""" + +import win32api +import win32con +import win32ui +from pywin.mfc import dialog + + +def MakeLoginDlgTemplate(title): + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + cs = win32con.WS_CHILD | win32con.WS_VISIBLE + + # Window frame and title + dlg = [ + [title, (0, 0, 184, 40), style, None, (8, "MS Sans Serif")], + ] + + # ID label and text box + dlg.append([130, "User ID:", -1, (7, 9, 69, 9), cs | win32con.SS_LEFT]) + s = cs | win32con.WS_TABSTOP | win32con.WS_BORDER + dlg.append(["EDIT", None, win32ui.IDC_EDIT1, (50, 7, 60, 12), s]) + + # Password label and text box + dlg.append([130, "Password:", -1, (7, 22, 69, 9), cs | win32con.SS_LEFT]) + s = cs | win32con.WS_TABSTOP | win32con.WS_BORDER + dlg.append( + ["EDIT", None, win32ui.IDC_EDIT2, (50, 20, 60, 12), s | win32con.ES_PASSWORD] + ) + + # OK/Cancel Buttons + s = cs | win32con.WS_TABSTOP + dlg.append( + [128, "OK", win32con.IDOK, (124, 5, 50, 14), s | win32con.BS_DEFPUSHBUTTON] + ) + s = win32con.BS_PUSHBUTTON | s + dlg.append([128, "Cancel", win32con.IDCANCEL, (124, 20, 50, 14), s]) + return dlg + + +def MakePasswordDlgTemplate(title): + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + cs = win32con.WS_CHILD | win32con.WS_VISIBLE + # Window frame and title + dlg = [ + [title, (0, 0, 177, 45), style, None, (8, "MS Sans Serif")], + ] + + # Password label and text box + dlg.append([130, "Password:", -1, (7, 7, 69, 9), cs | win32con.SS_LEFT]) + s = cs | win32con.WS_TABSTOP | win32con.WS_BORDER + dlg.append( + ["EDIT", None, win32ui.IDC_EDIT1, (50, 7, 60, 12), s | win32con.ES_PASSWORD] + ) + + # OK/Cancel Buttons + s = cs | win32con.WS_TABSTOP | win32con.BS_PUSHBUTTON + dlg.append( + [128, "OK", win32con.IDOK, (124, 5, 50, 14), s | win32con.BS_DEFPUSHBUTTON] + ) + dlg.append([128, "Cancel", win32con.IDCANCEL, (124, 22, 50, 14), s]) + return dlg + + +class LoginDlg(dialog.Dialog): + Cancel = 0 + + def __init__(self, title): + dialog.Dialog.__init__(self, MakeLoginDlgTemplate(title)) + self.AddDDX(win32ui.IDC_EDIT1, "userid") + self.AddDDX(win32ui.IDC_EDIT2, "password") + + +def GetLogin(title="Login", userid="", password=""): + d = LoginDlg(title) + d["userid"] = userid + d["password"] = password + if d.DoModal() != win32con.IDOK: + return (None, None) + else: + return (d["userid"], d["password"]) + + +class PasswordDlg(dialog.Dialog): + def __init__(self, title): + dialog.Dialog.__init__(self, MakePasswordDlgTemplate(title)) + self.AddDDX(win32ui.IDC_EDIT1, "password") + + +def GetPassword(title="Password", password=""): + d = PasswordDlg(title) + d["password"] = password + if d.DoModal() != win32con.IDOK: + return None + return d["password"] + + +if __name__ == "__main__": + import sys + + title = "Login" + def_user = "" + if len(sys.argv) > 1: + title = sys.argv[1] + if len(sys.argv) > 2: + def_userid = sys.argv[2] + userid, password = GetLogin(title, def_user) + if userid == password == None: + print("User pressed Cancel") + else: + print("User ID: ", userid) + print("Password:", password) + newpassword = GetPassword("Reenter just for fun", password) + if newpassword is None: + print("User cancelled") + else: + what = "" + if newpassword != password: + what = "not " + print("The passwords did %smatch" % (what)) diff --git a/lib/pythonwin/pywin/dialogs/status.py b/lib/pythonwin/pywin/dialogs/status.py new file mode 100644 index 00000000..aef33914 --- /dev/null +++ b/lib/pythonwin/pywin/dialogs/status.py @@ -0,0 +1,242 @@ +# No cancel button. + +import threading +import time + +import win32api +import win32con +import win32ui +from pywin.mfc import dialog +from pywin.mfc.thread import WinThread + + +def MakeProgressDlgTemplate(caption, staticText=""): + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + cs = win32con.WS_CHILD | win32con.WS_VISIBLE + + w = 215 + h = 36 # With button + h = 40 + + dlg = [ + [caption, (0, 0, w, h), style, None, (8, "MS Sans Serif")], + ] + + s = win32con.WS_TABSTOP | cs + + dlg.append([130, staticText, 1000, (7, 7, w - 7, h - 32), cs | win32con.SS_LEFT]) + + # dlg.append([128, + # "Cancel", + # win32con.IDCANCEL, + # (w - 60, h - 18, 50, 14), s | win32con.BS_PUSHBUTTON]) + + return dlg + + +class CStatusProgressDialog(dialog.Dialog): + def __init__(self, title, msg="", maxticks=100, tickincr=1): + self.initMsg = msg + templ = MakeProgressDlgTemplate(title, msg) + dialog.Dialog.__init__(self, templ) + self.maxticks = maxticks + self.tickincr = tickincr + self.pbar = None + + def OnInitDialog(self): + rc = dialog.Dialog.OnInitDialog(self) + self.static = self.GetDlgItem(1000) + self.pbar = win32ui.CreateProgressCtrl() + self.pbar.CreateWindow( + win32con.WS_CHILD | win32con.WS_VISIBLE, (10, 30, 310, 44), self, 1001 + ) + self.pbar.SetRange(0, self.maxticks) + self.pbar.SetStep(self.tickincr) + self.progress = 0 + self.pincr = 5 + return rc + + def Close(self): + self.EndDialog(0) + + def SetMaxTicks(self, maxticks): + if self.pbar is not None: + self.pbar.SetRange(0, maxticks) + + def Tick(self): + if self.pbar is not None: + self.pbar.StepIt() + + def SetTitle(self, text): + self.SetWindowText(text) + + def SetText(self, text): + self.SetDlgItemText(1000, text) + + def Set(self, pos, max=None): + if self.pbar is not None: + self.pbar.SetPos(pos) + if max is not None: + self.pbar.SetRange(0, max) + + +# a progress dialog created in a new thread - especially suitable for +# console apps with no message loop. +MYWM_SETTITLE = win32con.WM_USER + 10 +MYWM_SETMSG = win32con.WM_USER + 11 +MYWM_TICK = win32con.WM_USER + 12 +MYWM_SETMAXTICKS = win32con.WM_USER + 13 +MYWM_SET = win32con.WM_USER + 14 + + +class CThreadedStatusProcessDialog(CStatusProgressDialog): + def __init__(self, title, msg="", maxticks=100, tickincr=1): + self.title = title + self.msg = msg + self.threadid = win32api.GetCurrentThreadId() + CStatusProgressDialog.__init__(self, title, msg, maxticks, tickincr) + + def OnInitDialog(self): + rc = CStatusProgressDialog.OnInitDialog(self) + self.HookMessage(self.OnTitle, MYWM_SETTITLE) + self.HookMessage(self.OnMsg, MYWM_SETMSG) + self.HookMessage(self.OnTick, MYWM_TICK) + self.HookMessage(self.OnMaxTicks, MYWM_SETMAXTICKS) + self.HookMessage(self.OnSet, MYWM_SET) + return rc + + def _Send(self, msg): + try: + self.PostMessage(msg) + except win32ui.error: + # the user closed the window - but this does not cancel the + # process - so just ignore it. + pass + + def OnTitle(self, msg): + CStatusProgressDialog.SetTitle(self, self.title) + + def OnMsg(self, msg): + CStatusProgressDialog.SetText(self, self.msg) + + def OnTick(self, msg): + CStatusProgressDialog.Tick(self) + + def OnMaxTicks(self, msg): + CStatusProgressDialog.SetMaxTicks(self, self.maxticks) + + def OnSet(self, msg): + CStatusProgressDialog.Set(self, self.pos, self.max) + + def Close(self): + assert self.threadid, "No thread!" + win32api.PostThreadMessage(self.threadid, win32con.WM_QUIT, 0, 0) + + def SetMaxTicks(self, maxticks): + self.maxticks = maxticks + self._Send(MYWM_SETMAXTICKS) + + def SetTitle(self, title): + self.title = title + self._Send(MYWM_SETTITLE) + + def SetText(self, text): + self.msg = text + self._Send(MYWM_SETMSG) + + def Tick(self): + self._Send(MYWM_TICK) + + def Set(self, pos, max=None): + self.pos = pos + self.max = max + self._Send(MYWM_SET) + + +class ProgressThread(WinThread): + def __init__(self, title, msg="", maxticks=100, tickincr=1): + self.title = title + self.msg = msg + self.maxticks = maxticks + self.tickincr = tickincr + self.dialog = None + WinThread.__init__(self) + self.createdEvent = threading.Event() + + def InitInstance(self): + self.dialog = CThreadedStatusProcessDialog( + self.title, self.msg, self.maxticks, self.tickincr + ) + self.dialog.CreateWindow() + try: + self.dialog.SetForegroundWindow() + except win32ui.error: + pass + self.createdEvent.set() + return WinThread.InitInstance(self) + + def ExitInstance(self): + return 0 + + +def StatusProgressDialog(title, msg="", maxticks=100, parent=None): + d = CStatusProgressDialog(title, msg, maxticks) + d.CreateWindow(parent) + return d + + +def ThreadedStatusProgressDialog(title, msg="", maxticks=100): + t = ProgressThread(title, msg, maxticks) + t.CreateThread() + # Need to run a basic "PumpWaitingMessages" loop just incase we are + # running inside Pythonwin. + # Basic timeout incase things go terribly wrong. Ideally we should use + # win32event.MsgWaitForMultipleObjects(), but we use a threading module + # event - so use a dumb strategy + end_time = time.time() + 10 + while time.time() < end_time: + if t.createdEvent.isSet(): + break + win32ui.PumpWaitingMessages() + time.sleep(0.1) + return t.dialog + + +def demo(): + d = StatusProgressDialog("A Demo", "Doing something...") + import win32api + + for i in range(100): + if i == 50: + d.SetText("Getting there...") + if i == 90: + d.SetText("Nearly done...") + win32api.Sleep(20) + d.Tick() + d.Close() + + +def thread_demo(): + d = ThreadedStatusProgressDialog("A threaded demo", "Doing something") + import win32api + + for i in range(100): + if i == 50: + d.SetText("Getting there...") + if i == 90: + d.SetText("Nearly done...") + win32api.Sleep(20) + d.Tick() + d.Close() + + +if __name__ == "__main__": + thread_demo() + # demo() diff --git a/lib/pythonwin/pywin/docking/DockingBar.py b/lib/pythonwin/pywin/docking/DockingBar.py new file mode 100644 index 00000000..3e51eb70 --- /dev/null +++ b/lib/pythonwin/pywin/docking/DockingBar.py @@ -0,0 +1,679 @@ +# DockingBar.py + +# Ported directly (comments and all) from the samples at www.codeguru.com + +# WARNING: Use at your own risk, as this interface is highly likely to change. +# Currently we support only one child per DockingBar. Later we need to add +# support for multiple children. + +import struct + +import win32api +import win32con +import win32ui +from pywin.mfc import afxres, window + +clrBtnHilight = win32api.GetSysColor(win32con.COLOR_BTNHILIGHT) +clrBtnShadow = win32api.GetSysColor(win32con.COLOR_BTNSHADOW) + + +def CenterPoint(rect): + width = rect[2] - rect[0] + height = rect[3] - rect[1] + return rect[0] + width // 2, rect[1] + height // 2 + + +def OffsetRect(rect, point): + (x, y) = point + return rect[0] + x, rect[1] + y, rect[2] + x, rect[3] + y + + +def DeflateRect(rect, point): + (x, y) = point + return rect[0] + x, rect[1] + y, rect[2] - x, rect[3] - y + + +def PtInRect(rect, pt): + return rect[0] <= pt[0] < rect[2] and rect[1] <= pt[1] < rect[3] + + +class DockingBar(window.Wnd): + def __init__(self, obj=None): + if obj is None: + obj = win32ui.CreateControlBar() + window.Wnd.__init__(self, obj) + self.dialog = None + self.nDockBarID = 0 + self.sizeMin = 32, 32 + self.sizeHorz = 200, 200 + self.sizeVert = 200, 200 + self.sizeFloat = 200, 200 + self.bTracking = 0 + self.bInRecalcNC = 0 + self.cxEdge = 6 + self.cxBorder = 3 + self.cxGripper = 20 + self.brushBkgd = win32ui.CreateBrush() + self.brushBkgd.CreateSolidBrush(win32api.GetSysColor(win32con.COLOR_BTNFACE)) + + # Support for diagonal resizing + self.cyBorder = 3 + self.cCaptionSize = win32api.GetSystemMetrics(win32con.SM_CYSMCAPTION) + self.cMinWidth = win32api.GetSystemMetrics(win32con.SM_CXMIN) + self.cMinHeight = win32api.GetSystemMetrics(win32con.SM_CYMIN) + self.rectUndock = (0, 0, 0, 0) + + def OnUpdateCmdUI(self, target, bDisableIfNoHndler): + return self.UpdateDialogControls(target, bDisableIfNoHndler) + + def CreateWindow( + self, + parent, + childCreator, + title, + id, + style=win32con.WS_CHILD | win32con.WS_VISIBLE | afxres.CBRS_LEFT, + childCreatorArgs=(), + ): + assert not ( + (style & afxres.CBRS_SIZE_FIXED) and (style & afxres.CBRS_SIZE_DYNAMIC) + ), "Invalid style" + self.rectClose = self.rectBorder = self.rectGripper = self.rectTracker = ( + 0, + 0, + 0, + 0, + ) + + # save the style + self._obj_.dwStyle = style & afxres.CBRS_ALL + + cursor = win32api.LoadCursor(0, win32con.IDC_ARROW) + wndClass = win32ui.RegisterWndClass( + win32con.CS_DBLCLKS, cursor, self.brushBkgd.GetSafeHandle(), 0 + ) + + self._obj_.CreateWindow(wndClass, title, style, (0, 0, 0, 0), parent, id) + + # Create the child dialog + self.dialog = childCreator(*(self,) + childCreatorArgs) + + # use the dialog dimensions as default base dimensions + assert self.dialog.IsWindow(), ( + "The childCreator function %s did not create a window!" % childCreator + ) + rect = self.dialog.GetWindowRect() + self.sizeHorz = self.sizeVert = self.sizeFloat = ( + rect[2] - rect[0], + rect[3] - rect[1], + ) + + self.sizeHorz = self.sizeHorz[0], self.sizeHorz[1] + self.cxEdge + self.cxBorder + self.sizeVert = self.sizeVert[0] + self.cxEdge + self.cxBorder, self.sizeVert[1] + self.HookMessages() + + def CalcFixedLayout(self, bStretch, bHorz): + rectTop = self.dockSite.GetControlBar( + afxres.AFX_IDW_DOCKBAR_TOP + ).GetWindowRect() + rectLeft = self.dockSite.GetControlBar( + afxres.AFX_IDW_DOCKBAR_LEFT + ).GetWindowRect() + if bStretch: + nHorzDockBarWidth = 32767 + nVertDockBarHeight = 32767 + else: + nHorzDockBarWidth = rectTop[2] - rectTop[0] + 4 + nVertDockBarHeight = rectLeft[3] - rectLeft[1] + 4 + + if self.IsFloating(): + return self.sizeFloat + if bHorz: + return nHorzDockBarWidth, self.sizeHorz[1] + return self.sizeVert[0], nVertDockBarHeight + + def CalcDynamicLayout(self, length, mode): + # Support for diagonal sizing. + if self.IsFloating(): + self.GetParent().GetParent().ModifyStyle(win32ui.MFS_4THICKFRAME, 0) + if mode & (win32ui.LM_HORZDOCK | win32ui.LM_VERTDOCK): + flags = ( + win32con.SWP_NOSIZE + | win32con.SWP_NOMOVE + | win32con.SWP_NOZORDER + | win32con.SWP_NOACTIVATE + | win32con.SWP_FRAMECHANGED + ) + self.SetWindowPos( + 0, + ( + 0, + 0, + 0, + 0, + ), + flags, + ) + self.dockSite.RecalcLayout() + return self._obj_.CalcDynamicLayout(length, mode) + + if mode & win32ui.LM_MRUWIDTH: + return self.sizeFloat + if mode & win32ui.LM_COMMIT: + self.sizeFloat = length, self.sizeFloat[1] + return self.sizeFloat + # More diagonal sizing. + if self.IsFloating(): + dc = self.dockContext + pt = win32api.GetCursorPos() + windowRect = self.GetParent().GetParent().GetWindowRect() + + hittest = dc.nHitTest + if hittest == win32con.HTTOPLEFT: + cx = max(windowRect[2] - pt[0], self.cMinWidth) - self.cxBorder + cy = max(windowRect[3] - self.cCaptionSize - pt[1], self.cMinHeight) - 1 + self.sizeFloat = cx, cy + + top = ( + min(pt[1], windowRect[3] - self.cCaptionSize - self.cMinHeight) + - self.cyBorder + ) + left = min(pt[0], windowRect[2] - self.cMinWidth) - 1 + dc.rectFrameDragHorz = ( + left, + top, + dc.rectFrameDragHorz[2], + dc.rectFrameDragHorz[3], + ) + return self.sizeFloat + if hittest == win32con.HTTOPRIGHT: + cx = max(pt[0] - windowRect[0], self.cMinWidth) + cy = max(windowRect[3] - self.cCaptionSize - pt[1], self.cMinHeight) - 1 + self.sizeFloat = cx, cy + + top = ( + min(pt[1], windowRect[3] - self.cCaptionSize - self.cMinHeight) + - self.cyBorder + ) + dc.rectFrameDragHorz = ( + dc.rectFrameDragHorz[0], + top, + dc.rectFrameDragHorz[2], + dc.rectFrameDragHorz[3], + ) + return self.sizeFloat + + if hittest == win32con.HTBOTTOMLEFT: + cx = max(windowRect[2] - pt[0], self.cMinWidth) - self.cxBorder + cy = max(pt[1] - windowRect[1] - self.cCaptionSize, self.cMinHeight) + self.sizeFloat = cx, cy + + left = min(pt[0], windowRect[2] - self.cMinWidth) - 1 + dc.rectFrameDragHorz = ( + left, + dc.rectFrameDragHorz[1], + dc.rectFrameDragHorz[2], + dc.rectFrameDragHorz[3], + ) + return self.sizeFloat + + if hittest == win32con.HTBOTTOMRIGHT: + cx = max(pt[0] - windowRect[0], self.cMinWidth) + cy = max(pt[1] - windowRect[1] - self.cCaptionSize, self.cMinHeight) + self.sizeFloat = cx, cy + return self.sizeFloat + + if mode & win32ui.LM_LENGTHY: + self.sizeFloat = self.sizeFloat[0], max(self.sizeMin[1], length) + return self.sizeFloat + else: + return max(self.sizeMin[0], length), self.sizeFloat[1] + + def OnWindowPosChanged(self, msg): + if self.GetSafeHwnd() == 0 or self.dialog is None: + return 0 + lparam = msg[3] + """ LPARAM used with WM_WINDOWPOSCHANGED: + typedef struct { + HWND hwnd; + HWND hwndInsertAfter; + int x; + int y; + int cx; + int cy; + UINT flags;} WINDOWPOS; + """ + format = "PPiiiii" + bytes = win32ui.GetBytes(lparam, struct.calcsize(format)) + hwnd, hwndAfter, x, y, cx, cy, flags = struct.unpack(format, bytes) + + if self.bInRecalcNC: + rc = self.GetClientRect() + self.dialog.MoveWindow(rc) + return 0 + # Find on which side are we docked + nDockBarID = self.GetParent().GetDlgCtrlID() + # Return if dropped at same location + # no docking side change and no size change + if ( + (nDockBarID == self.nDockBarID) + and (flags & win32con.SWP_NOSIZE) + and ( + (self._obj_.dwStyle & afxres.CBRS_BORDER_ANY) != afxres.CBRS_BORDER_ANY + ) + ): + return + self.nDockBarID = nDockBarID + + # Force recalc the non-client area + self.bInRecalcNC = 1 + try: + swpflags = ( + win32con.SWP_NOSIZE + | win32con.SWP_NOMOVE + | win32con.SWP_NOZORDER + | win32con.SWP_FRAMECHANGED + ) + self.SetWindowPos(0, (0, 0, 0, 0), swpflags) + finally: + self.bInRecalcNC = 0 + return 0 + + # This is a virtual and not a message hook. + def OnSetCursor(self, window, nHitTest, wMouseMsg): + if nHitTest != win32con.HTSIZE or self.bTracking: + return self._obj_.OnSetCursor(window, nHitTest, wMouseMsg) + + if self.IsHorz(): + win32api.SetCursor(win32api.LoadCursor(0, win32con.IDC_SIZENS)) + else: + win32api.SetCursor(win32api.LoadCursor(0, win32con.IDC_SIZEWE)) + return 1 + + # Mouse Handling + def OnLButtonUp(self, msg): + if not self.bTracking: + return 1 # pass it on. + self.StopTracking(1) + return 0 # Dont pass on + + def OnLButtonDown(self, msg): + # UINT nFlags, CPoint point) + # only start dragging if clicked in "void" space + if self.dockBar is not None: + # start the drag + pt = msg[5] + pt = self.ClientToScreen(pt) + self.dockContext.StartDrag(pt) + return 0 + return 1 + + def OnNcLButtonDown(self, msg): + if self.bTracking: + return 0 + nHitTest = wparam = msg[2] + pt = msg[5] + + if nHitTest == win32con.HTSYSMENU and not self.IsFloating(): + self.GetDockingFrame().ShowControlBar(self, 0, 0) + elif nHitTest == win32con.HTMINBUTTON and not self.IsFloating(): + self.dockContext.ToggleDocking() + elif ( + nHitTest == win32con.HTCAPTION + and not self.IsFloating() + and self.dockBar is not None + ): + self.dockContext.StartDrag(pt) + elif nHitTest == win32con.HTSIZE and not self.IsFloating(): + self.StartTracking() + else: + return 1 + return 0 + + def OnLButtonDblClk(self, msg): + # only toggle docking if clicked in "void" space + if self.dockBar is not None: + # toggle docking + self.dockContext.ToggleDocking() + return 0 + return 1 + + def OnNcLButtonDblClk(self, msg): + nHitTest = wparam = msg[2] + # UINT nHitTest, CPoint point) + if self.dockBar is not None and nHitTest == win32con.HTCAPTION: + # toggle docking + self.dockContext.ToggleDocking() + return 0 + return 1 + + def OnMouseMove(self, msg): + flags = wparam = msg[2] + lparam = msg[3] + if self.IsFloating() or not self.bTracking: + return 1 + + # Convert unsigned 16 bit to signed 32 bit. + x = win32api.LOWORD(lparam) + if x & 32768: + x = x | -65536 + y = win32api.HIWORD(lparam) + if y & 32768: + y = y | -65536 + pt = x, y + cpt = CenterPoint(self.rectTracker) + pt = self.ClientToWnd(pt) + if self.IsHorz(): + if cpt[1] != pt[1]: + self.OnInvertTracker(self.rectTracker) + self.rectTracker = OffsetRect(self.rectTracker, (0, pt[1] - cpt[1])) + self.OnInvertTracker(self.rectTracker) + else: + if cpt[0] != pt[0]: + self.OnInvertTracker(self.rectTracker) + self.rectTracker = OffsetRect(self.rectTracker, (pt[0] - cpt[0], 0)) + self.OnInvertTracker(self.rectTracker) + + return 0 # Dont pass it on. + + # def OnBarStyleChange(self, old, new): + + def OnNcCalcSize(self, bCalcValid, size_info): + (rc0, rc1, rc2, pos) = size_info + self.rectBorder = self.GetWindowRect() + self.rectBorder = OffsetRect( + self.rectBorder, (-self.rectBorder[0], -self.rectBorder[1]) + ) + + dwBorderStyle = self._obj_.dwStyle | afxres.CBRS_BORDER_ANY + + if self.nDockBarID == afxres.AFX_IDW_DOCKBAR_TOP: + dwBorderStyle = dwBorderStyle & ~afxres.CBRS_BORDER_BOTTOM + rc0.left = rc0.left + self.cxGripper + rc0.bottom = rc0.bottom - self.cxEdge + rc0.top = rc0.top + self.cxBorder + rc0.right = rc0.right - self.cxBorder + self.rectBorder = ( + self.rectBorder[0], + self.rectBorder[3] - self.cxEdge, + self.rectBorder[2], + self.rectBorder[3], + ) + elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_BOTTOM: + dwBorderStyle = dwBorderStyle & ~afxres.CBRS_BORDER_TOP + rc0.left = rc0.left + self.cxGripper + rc0.top = rc0.top + self.cxEdge + rc0.bottom = rc0.bottom - self.cxBorder + rc0.right = rc0.right - self.cxBorder + self.rectBorder = ( + self.rectBorder[0], + self.rectBorder[1], + self.rectBorder[2], + self.rectBorder[1] + self.cxEdge, + ) + elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_LEFT: + dwBorderStyle = dwBorderStyle & ~afxres.CBRS_BORDER_RIGHT + rc0.right = rc0.right - self.cxEdge + rc0.left = rc0.left + self.cxBorder + rc0.bottom = rc0.bottom - self.cxBorder + rc0.top = rc0.top + self.cxGripper + self.rectBorder = ( + self.rectBorder[2] - self.cxEdge, + self.rectBorder[1], + self.rectBorder[2], + self.rectBorder[3], + ) + elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_RIGHT: + dwBorderStyle = dwBorderStyle & ~afxres.CBRS_BORDER_LEFT + rc0.left = rc0.left + self.cxEdge + rc0.right = rc0.right - self.cxBorder + rc0.bottom = rc0.bottom - self.cxBorder + rc0.top = rc0.top + self.cxGripper + self.rectBorder = ( + self.rectBorder[0], + self.rectBorder[1], + self.rectBorder[0] + self.cxEdge, + self.rectBorder[3], + ) + else: + self.rectBorder = 0, 0, 0, 0 + + self.SetBarStyle(dwBorderStyle) + return 0 + + def OnNcPaint(self, msg): + self.EraseNonClient() + dc = self.GetWindowDC() + ctl = win32api.GetSysColor(win32con.COLOR_BTNHIGHLIGHT) + cbr = win32api.GetSysColor(win32con.COLOR_BTNSHADOW) + dc.Draw3dRect(self.rectBorder, ctl, cbr) + + self.DrawGripper(dc) + + rect = self.GetClientRect() + self.InvalidateRect(rect, 1) + return 0 + + def OnNcHitTest(self, pt): # A virtual, not a hooked message. + if self.IsFloating(): + return 1 + + ptOrig = pt + rect = self.GetWindowRect() + pt = pt[0] - rect[0], pt[1] - rect[1] + + if PtInRect(self.rectClose, pt): + return win32con.HTSYSMENU + elif PtInRect(self.rectUndock, pt): + return win32con.HTMINBUTTON + elif PtInRect(self.rectGripper, pt): + return win32con.HTCAPTION + elif PtInRect(self.rectBorder, pt): + return win32con.HTSIZE + else: + return self._obj_.OnNcHitTest(ptOrig) + + def StartTracking(self): + self.SetCapture() + + # make sure no updates are pending + self.RedrawWindow(None, None, win32con.RDW_ALLCHILDREN | win32con.RDW_UPDATENOW) + self.dockSite.LockWindowUpdate() + + self.ptOld = CenterPoint(self.rectBorder) + self.bTracking = 1 + + self.rectTracker = self.rectBorder + if not self.IsHorz(): + l, t, r, b = self.rectTracker + b = b - 4 + self.rectTracker = l, t, r, b + + self.OnInvertTracker(self.rectTracker) + + def OnCaptureChanged(self, msg): + hwnd = lparam = msg[3] + if self.bTracking and hwnd != self.GetSafeHwnd(): + self.StopTracking(0) # cancel tracking + return 1 + + def StopTracking(self, bAccept): + self.OnInvertTracker(self.rectTracker) + self.dockSite.UnlockWindowUpdate() + self.bTracking = 0 + self.ReleaseCapture() + if not bAccept: + return + + rcc = self.dockSite.GetWindowRect() + if self.IsHorz(): + newsize = self.sizeHorz[1] + maxsize = newsize + (rcc[3] - rcc[1]) + minsize = self.sizeMin[1] + else: + newsize = self.sizeVert[0] + maxsize = newsize + (rcc[2] - rcc[0]) + minsize = self.sizeMin[0] + + pt = CenterPoint(self.rectTracker) + if self.nDockBarID == afxres.AFX_IDW_DOCKBAR_TOP: + newsize = newsize + (pt[1] - self.ptOld[1]) + elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_BOTTOM: + newsize = newsize + (-pt[1] + self.ptOld[1]) + elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_LEFT: + newsize = newsize + (pt[0] - self.ptOld[0]) + elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_RIGHT: + newsize = newsize + (-pt[0] + self.ptOld[0]) + newsize = max(minsize, min(maxsize, newsize)) + if self.IsHorz(): + self.sizeHorz = self.sizeHorz[0], newsize + else: + self.sizeVert = newsize, self.sizeVert[1] + self.dockSite.RecalcLayout() + return 0 + + def OnInvertTracker(self, rect): + assert rect[2] - rect[0] > 0 and rect[3] - rect[1] > 0, "rect is empty" + assert self.bTracking + rcc = self.GetWindowRect() + rcf = self.dockSite.GetWindowRect() + + rect = OffsetRect(rect, (rcc[0] - rcf[0], rcc[1] - rcf[1])) + rect = DeflateRect(rect, (1, 1)) + + flags = win32con.DCX_WINDOW | win32con.DCX_CACHE | win32con.DCX_LOCKWINDOWUPDATE + dc = self.dockSite.GetDCEx(None, flags) + try: + brush = win32ui.GetHalftoneBrush() + oldBrush = dc.SelectObject(brush) + + dc.PatBlt( + (rect[0], rect[1]), + (rect[2] - rect[0], rect[3] - rect[1]), + win32con.PATINVERT, + ) + dc.SelectObject(oldBrush) + finally: + self.dockSite.ReleaseDC(dc) + + def IsHorz(self): + return ( + self.nDockBarID == afxres.AFX_IDW_DOCKBAR_TOP + or self.nDockBarID == afxres.AFX_IDW_DOCKBAR_BOTTOM + ) + + def ClientToWnd(self, pt): + x, y = pt + if self.nDockBarID == afxres.AFX_IDW_DOCKBAR_BOTTOM: + y = y + self.cxEdge + elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_RIGHT: + x = x + self.cxEdge + return x, y + + def DrawGripper(self, dc): + # no gripper if floating + if self._obj_.dwStyle & afxres.CBRS_FLOATING: + return + + # -==HACK==- + # in order to calculate the client area properly after docking, + # the client area must be recalculated twice (I have no idea why) + self.dockSite.RecalcLayout() + # -==END HACK==- + + gripper = self.GetWindowRect() + gripper = self.ScreenToClient(gripper) + gripper = OffsetRect(gripper, (-gripper[0], -gripper[1])) + gl, gt, gr, gb = gripper + + if self._obj_.dwStyle & afxres.CBRS_ORIENT_HORZ: + # gripper at left + self.rectGripper = gl, gt + 40, gl + 20, gb + # draw close box + self.rectClose = gl + 7, gt + 10, gl + 19, gt + 22 + dc.DrawFrameControl( + self.rectClose, win32con.DFC_CAPTION, win32con.DFCS_CAPTIONCLOSE + ) + # draw docking toggle box + self.rectUndock = OffsetRect(self.rectClose, (0, 13)) + dc.DrawFrameControl( + self.rectUndock, win32con.DFC_CAPTION, win32con.DFCS_CAPTIONMAX + ) + + gt = gt + 38 + gb = gb - 10 + gl = gl + 10 + gr = gl + 3 + gripper = gl, gt, gr, gb + dc.Draw3dRect(gripper, clrBtnHilight, clrBtnShadow) + dc.Draw3dRect(OffsetRect(gripper, (4, 0)), clrBtnHilight, clrBtnShadow) + else: + # gripper at top + self.rectGripper = gl, gt, gr - 40, gt + 20 + # draw close box + self.rectClose = gr - 21, gt + 7, gr - 10, gt + 18 + dc.DrawFrameControl( + self.rectClose, win32con.DFC_CAPTION, win32con.DFCS_CAPTIONCLOSE + ) + # draw docking toggle box + self.rectUndock = OffsetRect(self.rectClose, (-13, 0)) + dc.DrawFrameControl( + self.rectUndock, win32con.DFC_CAPTION, win32con.DFCS_CAPTIONMAX + ) + gr = gr - 38 + gl = gl + 10 + gt = gt + 10 + gb = gt + 3 + + gripper = gl, gt, gr, gb + dc.Draw3dRect(gripper, clrBtnHilight, clrBtnShadow) + dc.Draw3dRect(OffsetRect(gripper, (0, 4)), clrBtnHilight, clrBtnShadow) + + def HookMessages(self): + self.HookMessage(self.OnLButtonUp, win32con.WM_LBUTTONUP) + self.HookMessage(self.OnLButtonDown, win32con.WM_LBUTTONDOWN) + self.HookMessage(self.OnLButtonDblClk, win32con.WM_LBUTTONDBLCLK) + self.HookMessage(self.OnNcLButtonDown, win32con.WM_NCLBUTTONDOWN) + self.HookMessage(self.OnNcLButtonDblClk, win32con.WM_NCLBUTTONDBLCLK) + self.HookMessage(self.OnMouseMove, win32con.WM_MOUSEMOVE) + self.HookMessage(self.OnNcPaint, win32con.WM_NCPAINT) + self.HookMessage(self.OnCaptureChanged, win32con.WM_CAPTURECHANGED) + self.HookMessage(self.OnWindowPosChanged, win32con.WM_WINDOWPOSCHANGED) + + +# self.HookMessage(self.OnSize, win32con.WM_SIZE) + + +def EditCreator(parent): + d = win32ui.CreateEdit() + es = ( + win32con.WS_CHILD + | win32con.WS_VISIBLE + | win32con.WS_BORDER + | win32con.ES_MULTILINE + | win32con.ES_WANTRETURN + ) + d.CreateWindow(es, (0, 0, 150, 150), parent, 1000) + return d + + +def test(): + import pywin.mfc.dialog + + global bar + bar = DockingBar() + creator = EditCreator + bar.CreateWindow(win32ui.GetMainFrame(), creator, "Coolbar Demo", 0xFFFFF) + # win32ui.GetMainFrame().ShowControlBar(bar, 1, 0) + bar.SetBarStyle( + bar.GetBarStyle() + | afxres.CBRS_TOOLTIPS + | afxres.CBRS_FLYBY + | afxres.CBRS_SIZE_DYNAMIC + ) + bar.EnableDocking(afxres.CBRS_ALIGN_ANY) + win32ui.GetMainFrame().DockControlBar(bar, afxres.AFX_IDW_DOCKBAR_BOTTOM) + + +if __name__ == "__main__": + test() diff --git a/lib/pythonwin/pywin/docking/__init__.py b/lib/pythonwin/pywin/docking/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/pythonwin/pywin/framework/__init__.py b/lib/pythonwin/pywin/framework/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/pythonwin/pywin/framework/app.py b/lib/pythonwin/pywin/framework/app.py new file mode 100644 index 00000000..f994f99f --- /dev/null +++ b/lib/pythonwin/pywin/framework/app.py @@ -0,0 +1,457 @@ +# App.py +# Application stuff. +# The application is responsible for managing the main frame window. +# +# We also grab the FileOpen command, to invoke our Python editor +" The PythonWin application code. Manages most aspects of MDI, etc " +import os +import sys +import traceback + +import regutil +import win32api +import win32con +import win32ui +from pywin.mfc import afxres, dialog, window +from pywin.mfc.thread import WinApp + +from . import scriptutils + +## NOTE: App and AppBuild should NOT be used - instead, you should contruct your +## APP class manually whenever you like (just ensure you leave these 2 params None!) +## Whoever wants the generic "Application" should get it via win32iu.GetApp() + +# These are "legacy" +AppBuilder = None +App = None # default - if used, must end up a CApp derived class. + + +# Helpers that should one day be removed! +def AddIdleHandler(handler): + print( + "app.AddIdleHandler is deprecated - please use win32ui.GetApp().AddIdleHandler() instead." + ) + return win32ui.GetApp().AddIdleHandler(handler) + + +def DeleteIdleHandler(handler): + print( + "app.DeleteIdleHandler is deprecated - please use win32ui.GetApp().DeleteIdleHandler() instead." + ) + return win32ui.GetApp().DeleteIdleHandler(handler) + + +# Helper for writing a Window position by name, and later loading it. +def SaveWindowSize(section, rect, state=""): + """Writes a rectangle to an INI file + Args: section = section name in the applications INI file + rect = a rectangle in a (cy, cx, y, x) tuple + (same format as CREATESTRUCT position tuples).""" + left, top, right, bottom = rect + if state: + state = state + " " + win32ui.WriteProfileVal(section, state + "left", left) + win32ui.WriteProfileVal(section, state + "top", top) + win32ui.WriteProfileVal(section, state + "right", right) + win32ui.WriteProfileVal(section, state + "bottom", bottom) + + +def LoadWindowSize(section, state=""): + """Loads a section from an INI file, and returns a rect in a tuple (see SaveWindowSize)""" + if state: + state = state + " " + left = win32ui.GetProfileVal(section, state + "left", 0) + top = win32ui.GetProfileVal(section, state + "top", 0) + right = win32ui.GetProfileVal(section, state + "right", 0) + bottom = win32ui.GetProfileVal(section, state + "bottom", 0) + return (left, top, right, bottom) + + +def RectToCreateStructRect(rect): + return (rect[3] - rect[1], rect[2] - rect[0], rect[1], rect[0]) + + +# Define FrameWindow and Application objects +# +# The Main Frame of the application. +class MainFrame(window.MDIFrameWnd): + sectionPos = "Main Window" + statusBarIndicators = ( + afxres.ID_SEPARATOR, # // status line indicator + afxres.ID_INDICATOR_CAPS, + afxres.ID_INDICATOR_NUM, + afxres.ID_INDICATOR_SCRL, + win32ui.ID_INDICATOR_LINENUM, + win32ui.ID_INDICATOR_COLNUM, + ) + + def OnCreate(self, cs): + self._CreateStatusBar() + return 0 + + def _CreateStatusBar(self): + self.statusBar = win32ui.CreateStatusBar(self) + self.statusBar.SetIndicators(self.statusBarIndicators) + self.HookCommandUpdate(self.OnUpdatePosIndicator, win32ui.ID_INDICATOR_LINENUM) + self.HookCommandUpdate(self.OnUpdatePosIndicator, win32ui.ID_INDICATOR_COLNUM) + + def OnUpdatePosIndicator(self, cmdui): + editControl = scriptutils.GetActiveEditControl() + value = " " * 5 + if editControl is not None: + try: + startChar, endChar = editControl.GetSel() + lineNo = editControl.LineFromChar(startChar) + colNo = endChar - editControl.LineIndex(lineNo) + + if cmdui.m_nID == win32ui.ID_INDICATOR_LINENUM: + value = "%0*d" % (5, lineNo + 1) + else: + value = "%0*d" % (3, colNo + 1) + except win32ui.error: + pass + cmdui.SetText(value) + cmdui.Enable() + + def PreCreateWindow(self, cc): + cc = self._obj_.PreCreateWindow(cc) + pos = LoadWindowSize(self.sectionPos) + self.startRect = pos + if pos[2] - pos[0]: + rect = RectToCreateStructRect(pos) + cc = cc[0], cc[1], cc[2], cc[3], rect, cc[5], cc[6], cc[7], cc[8] + return cc + + def OnDestroy(self, msg): + # use GetWindowPlacement(), as it works even when min'd or max'd + rectNow = self.GetWindowPlacement()[4] + if rectNow != self.startRect: + SaveWindowSize(self.sectionPos, rectNow) + return 0 + + +class CApp(WinApp): + "A class for the application" + + def __init__(self): + self.oldCallbackCaller = None + WinApp.__init__(self, win32ui.GetApp()) + self.idleHandlers = [] + + def InitInstance(self): + "Called to crank up the app" + HookInput() + numMRU = win32ui.GetProfileVal("Settings", "Recent File List Size", 10) + win32ui.LoadStdProfileSettings(numMRU) + # self._obj_.InitMDIInstance() + if win32api.GetVersionEx()[0] < 4: + win32ui.SetDialogBkColor() + win32ui.Enable3dControls() + + # install a "callback caller" - a manager for the callbacks + # self.oldCallbackCaller = win32ui.InstallCallbackCaller(self.CallbackManager) + self.LoadMainFrame() + self.SetApplicationPaths() + + def ExitInstance(self): + "Called as the app dies - too late to prevent it here!" + win32ui.OutputDebug("Application shutdown\n") + # Restore the callback manager, if any. + try: + win32ui.InstallCallbackCaller(self.oldCallbackCaller) + except AttributeError: + pass + if self.oldCallbackCaller: + del self.oldCallbackCaller + self.frame = None # clean Python references to the now destroyed window object. + self.idleHandlers = [] + # Attempt cleanup if not already done! + if self._obj_: + self._obj_.AttachObject(None) + self._obj_ = None + global App + global AppBuilder + App = None + AppBuilder = None + return 0 + + def HaveIdleHandler(self, handler): + return handler in self.idleHandlers + + def AddIdleHandler(self, handler): + self.idleHandlers.append(handler) + + def DeleteIdleHandler(self, handler): + self.idleHandlers.remove(handler) + + def OnIdle(self, count): + try: + ret = 0 + handlers = self.idleHandlers[:] # copy list, as may be modified during loop + for handler in handlers: + try: + thisRet = handler(handler, count) + except: + print("Idle handler %s failed" % (repr(handler))) + traceback.print_exc() + print("Idle handler removed from list") + try: + self.DeleteIdleHandler(handler) + except ValueError: # Item not in list. + pass + thisRet = 0 + ret = ret or thisRet + return ret + except KeyboardInterrupt: + pass + + def CreateMainFrame(self): + return MainFrame() + + def LoadMainFrame(self): + "Create the main applications frame" + self.frame = self.CreateMainFrame() + self.SetMainFrame(self.frame) + self.frame.LoadFrame(win32ui.IDR_MAINFRAME, win32con.WS_OVERLAPPEDWINDOW) + self.frame.DragAcceptFiles() # we can accept these. + self.frame.ShowWindow(win32ui.GetInitialStateRequest()) + self.frame.UpdateWindow() + self.HookCommands() + + def OnHelp(self, id, code): + try: + if id == win32ui.ID_HELP_GUI_REF: + helpFile = regutil.GetRegisteredHelpFile("Pythonwin Reference") + helpCmd = win32con.HELP_CONTENTS + else: + helpFile = regutil.GetRegisteredHelpFile("Main Python Documentation") + helpCmd = win32con.HELP_FINDER + if helpFile is None: + win32ui.MessageBox("The help file is not registered!") + else: + from . import help + + help.OpenHelpFile(helpFile, helpCmd) + except: + t, v, tb = sys.exc_info() + win32ui.MessageBox( + "Internal error in help file processing\r\n%s: %s" % (t, v) + ) + tb = None # Prevent a cycle + + def DoLoadModules(self, modules): + # XXX - this should go, but the debugger uses it :-( + # dont do much checking! + for module in modules: + __import__(module) + + def HookCommands(self): + self.frame.HookMessage(self.OnDropFiles, win32con.WM_DROPFILES) + self.HookCommand(self.HandleOnFileOpen, win32ui.ID_FILE_OPEN) + self.HookCommand(self.HandleOnFileNew, win32ui.ID_FILE_NEW) + self.HookCommand(self.OnFileMRU, win32ui.ID_FILE_MRU_FILE1) + self.HookCommand(self.OnHelpAbout, win32ui.ID_APP_ABOUT) + self.HookCommand(self.OnHelp, win32ui.ID_HELP_PYTHON) + self.HookCommand(self.OnHelp, win32ui.ID_HELP_GUI_REF) + # Hook for the right-click menu. + self.frame.GetWindow(win32con.GW_CHILD).HookMessage( + self.OnRClick, win32con.WM_RBUTTONDOWN + ) + + def SetApplicationPaths(self): + # Load the users/application paths + new_path = [] + apppath = win32ui.GetProfileVal("Python", "Application Path", "").split(";") + for path in apppath: + if len(path) > 0: + new_path.append(win32ui.FullPath(path)) + for extra_num in range(1, 11): + apppath = win32ui.GetProfileVal( + "Python", "Application Path %d" % extra_num, "" + ).split(";") + if len(apppath) == 0: + break + for path in apppath: + if len(path) > 0: + new_path.append(win32ui.FullPath(path)) + sys.path = new_path + sys.path + + def OnRClick(self, params): + "Handle right click message" + # put up the entire FILE menu! + menu = win32ui.LoadMenu(win32ui.IDR_TEXTTYPE).GetSubMenu(0) + menu.TrackPopupMenu(params[5]) # track at mouse position. + return 0 + + def OnDropFiles(self, msg): + "Handle a file being dropped from file manager" + hDropInfo = msg[2] + self.frame.SetActiveWindow() # active us + nFiles = win32api.DragQueryFile(hDropInfo) + try: + for iFile in range(0, nFiles): + fileName = win32api.DragQueryFile(hDropInfo, iFile) + win32ui.GetApp().OpenDocumentFile(fileName) + finally: + win32api.DragFinish(hDropInfo) + + return 0 + + # No longer used by Pythonwin, as the C++ code has this same basic functionality + # but handles errors slightly better. + # It all still works, tho, so if you need similar functionality, you can use it. + # Therefore I havent deleted this code completely! + # def CallbackManager( self, ob, args = () ): + # """Manage win32 callbacks. Trap exceptions, report on them, then return 'All OK' + # to the frame-work. """ + # import traceback + # try: + # ret = apply(ob, args) + # return ret + # except: + # # take copies of the exception values, else other (handled) exceptions may get + # # copied over by the other fns called. + # win32ui.SetStatusText('An exception occured in a windows command handler.') + # t, v, tb = sys.exc_info() + # traceback.print_exception(t, v, tb.tb_next) + # try: + # sys.stdout.flush() + # except (NameError, AttributeError): + # pass + + # Command handlers. + def OnFileMRU(self, id, code): + "Called when a File 1-n message is recieved" + fileName = win32ui.GetRecentFileList()[id - win32ui.ID_FILE_MRU_FILE1] + win32ui.GetApp().OpenDocumentFile(fileName) + + def HandleOnFileOpen(self, id, code): + "Called when FileOpen message is received" + win32ui.GetApp().OnFileOpen() + + def HandleOnFileNew(self, id, code): + "Called when FileNew message is received" + win32ui.GetApp().OnFileNew() + + def OnHelpAbout(self, id, code): + "Called when HelpAbout message is received. Displays the About dialog." + win32ui.InitRichEdit() + dlg = AboutBox() + dlg.DoModal() + + +def _GetRegistryValue(key, val, default=None): + # val is registry value - None for default val. + try: + hkey = win32api.RegOpenKey(win32con.HKEY_CURRENT_USER, key) + return win32api.RegQueryValueEx(hkey, val)[0] + except win32api.error: + try: + hkey = win32api.RegOpenKey(win32con.HKEY_LOCAL_MACHINE, key) + return win32api.RegQueryValueEx(hkey, val)[0] + except win32api.error: + return default + + +scintilla = "Scintilla is Copyright 1998-2008 Neil Hodgson (http://www.scintilla.org)" +idle = "This program uses IDLE extensions by Guido van Rossum, Tim Peters and others." +contributors = "Thanks to the following people for making significant contributions: Roger Upole, Sidnei da Silva, Sam Rushing, Curt Hagenlocher, Dave Brennan, Roger Burnham, Gordon McMillan, Neil Hodgson, Laramie Leavitt. (let me know if I have forgotten you!)" + + +# The About Box +class AboutBox(dialog.Dialog): + def __init__(self, idd=win32ui.IDD_ABOUTBOX): + dialog.Dialog.__init__(self, idd) + + def OnInitDialog(self): + text = ( + "Pythonwin - Python IDE and GUI Framework for Windows.\n\n%s\n\nPython is %s\n\n%s\n\n%s\n\n%s" + % (win32ui.copyright, sys.copyright, scintilla, idle, contributors) + ) + self.SetDlgItemText(win32ui.IDC_EDIT1, text) + # Get the build number - written by installers. + # For distutils build, read pywin32.version.txt + import sysconfig + + site_packages = sysconfig.get_paths()["platlib"] + try: + build_no = ( + open(os.path.join(site_packages, "pywin32.version.txt")).read().strip() + ) + ver = "pywin32 build %s" % build_no + except EnvironmentError: + ver = None + if ver is None: + # See if we are Part of Active Python + ver = _GetRegistryValue( + "SOFTWARE\\ActiveState\\ActivePython", "CurrentVersion" + ) + if ver is not None: + ver = "ActivePython build %s" % (ver,) + if ver is None: + ver = "" + self.SetDlgItemText(win32ui.IDC_ABOUT_VERSION, ver) + self.HookCommand(self.OnButHomePage, win32ui.IDC_BUTTON1) + + def OnButHomePage(self, id, code): + if code == win32con.BN_CLICKED: + win32api.ShellExecute( + 0, "open", "https://github.com/mhammond/pywin32", None, "", 1 + ) + + +def Win32RawInput(prompt=None): + "Provide raw_input() for gui apps" + # flush stderr/out first. + try: + sys.stdout.flush() + sys.stderr.flush() + except: + pass + if prompt is None: + prompt = "" + ret = dialog.GetSimpleInput(prompt) + if ret == None: + raise KeyboardInterrupt("operation cancelled") + return ret + + +def Win32Input(prompt=None): + "Provide input() for gui apps" + return eval(input(prompt)) + + +def HookInput(): + try: + raw_input + # must be py2x... + sys.modules["__builtin__"].raw_input = Win32RawInput + sys.modules["__builtin__"].input = Win32Input + except NameError: + # must be py3k + import code + + sys.modules["builtins"].input = Win32RawInput + + +def HaveGoodGUI(): + """Returns true if we currently have a good gui available.""" + return "pywin.framework.startup" in sys.modules + + +def CreateDefaultGUI(appClass=None): + """Creates a default GUI environment""" + if appClass is None: + from . import intpyapp # Bring in the default app - could be param'd later. + + appClass = intpyapp.InteractivePythonApp + # Create and init the app. + appClass().InitInstance() + + +def CheckCreateDefaultGUI(): + """Checks and creates if necessary a default GUI environment.""" + rc = HaveGoodGUI() + if not rc: + CreateDefaultGUI() + return rc diff --git a/lib/pythonwin/pywin/framework/bitmap.py b/lib/pythonwin/pywin/framework/bitmap.py new file mode 100644 index 00000000..1501f72d --- /dev/null +++ b/lib/pythonwin/pywin/framework/bitmap.py @@ -0,0 +1,164 @@ +import os + +import win32api +import win32con +import win32ui +from pywin.mfc import docview, window + +from . import app + +bStretch = 1 + + +class BitmapDocument(docview.Document): + "A bitmap document. Holds the bitmap data itself." + + def __init__(self, template): + docview.Document.__init__(self, template) + self.bitmap = None + + def OnNewDocument(self): + # I can not create new bitmaps. + win32ui.MessageBox("Bitmaps can not be created.") + + def OnOpenDocument(self, filename): + self.bitmap = win32ui.CreateBitmap() + # init data members + f = open(filename, "rb") + try: + try: + self.bitmap.LoadBitmapFile(f) + except IOError: + win32ui.MessageBox("Could not load the bitmap from %s" % filename) + return 0 + finally: + f.close() + self.size = self.bitmap.GetSize() + return 1 + + def DeleteContents(self): + self.bitmap = None + + +class BitmapView(docview.ScrollView): + "A view of a bitmap. Obtains data from document." + + def __init__(self, doc): + docview.ScrollView.__init__(self, doc) + self.width = self.height = 0 + # set up message handlers + self.HookMessage(self.OnSize, win32con.WM_SIZE) + + def OnInitialUpdate(self): + doc = self.GetDocument() + if doc.bitmap: + bitmapSize = doc.bitmap.GetSize() + self.SetScrollSizes(win32con.MM_TEXT, bitmapSize) + + def OnSize(self, params): + lParam = params[3] + self.width = win32api.LOWORD(lParam) + self.height = win32api.HIWORD(lParam) + + def OnDraw(self, dc): + # set sizes used for "non stretch" mode. + doc = self.GetDocument() + if doc.bitmap is None: + return + bitmapSize = doc.bitmap.GetSize() + if bStretch: + # stretch BMP. + viewRect = (0, 0, self.width, self.height) + bitmapRect = (0, 0, bitmapSize[0], bitmapSize[1]) + doc.bitmap.Paint(dc, viewRect, bitmapRect) + else: + # non stretch. + doc.bitmap.Paint(dc) + + +class BitmapFrame(window.MDIChildWnd): + def OnCreateClient(self, createparams, context): + borderX = win32api.GetSystemMetrics(win32con.SM_CXFRAME) + borderY = win32api.GetSystemMetrics(win32con.SM_CYFRAME) + titleY = win32api.GetSystemMetrics(win32con.SM_CYCAPTION) # includes border + # try and maintain default window pos, else adjust if cant fit + # get the main client window dimensions. + mdiClient = win32ui.GetMainFrame().GetWindow(win32con.GW_CHILD) + clientWindowRect = mdiClient.ScreenToClient(mdiClient.GetWindowRect()) + clientWindowSize = ( + clientWindowRect[2] - clientWindowRect[0], + clientWindowRect[3] - clientWindowRect[1], + ) + left, top, right, bottom = mdiClient.ScreenToClient(self.GetWindowRect()) + # width, height=context.doc.size[0], context.doc.size[1] + # width = width+borderX*2 + # height= height+titleY+borderY*2-1 + # if (left+width)>clientWindowSize[0]: + # left = clientWindowSize[0] - width + # if left<0: + # left = 0 + # width = clientWindowSize[0] + # if (top+height)>clientWindowSize[1]: + # top = clientWindowSize[1] - height + # if top<0: + # top = 0 + # height = clientWindowSize[1] + # self.frame.MoveWindow((left, top, left+width, top+height),0) + window.MDIChildWnd.OnCreateClient(self, createparams, context) + return 1 + + +class BitmapTemplate(docview.DocTemplate): + def __init__(self): + docview.DocTemplate.__init__( + self, win32ui.IDR_PYTHONTYPE, BitmapDocument, BitmapFrame, BitmapView + ) + + def MatchDocType(self, fileName, fileType): + doc = self.FindOpenDocument(fileName) + if doc: + return doc + ext = os.path.splitext(fileName)[1].lower() + if ext == ".bmp": # removed due to PIL! or ext=='.ppm': + return win32ui.CDocTemplate_Confidence_yesAttemptNative + return win32ui.CDocTemplate_Confidence_maybeAttemptForeign + + +# return win32ui.CDocTemplate_Confidence_noAttempt + +# For debugging purposes, when this module may be reloaded many times. +try: + win32ui.GetApp().RemoveDocTemplate(bitmapTemplate) +except NameError: + pass + +bitmapTemplate = BitmapTemplate() +bitmapTemplate.SetDocStrings( + "\nBitmap\nBitmap\nBitmap (*.bmp)\n.bmp\nPythonBitmapFileType\nPython Bitmap File" +) +win32ui.GetApp().AddDocTemplate(bitmapTemplate) + +# This works, but just didnt make it through the code reorg. +# class PPMBitmap(Bitmap): +# def LoadBitmapFile(self, file ): +# magic=file.readline() +# if magic <> "P6\n": +# raise TypeError, "The file is not a PPM format file" +# rowcollist=string.split(file.readline()) +# cols=string.atoi(rowcollist[0]) +# rows=string.atoi(rowcollist[1]) +# file.readline() # whats this one? +# self.bitmap.LoadPPMFile(file,(cols,rows)) + + +def t(): + bitmapTemplate.OpenDocumentFile("d:\\winnt\\arcade.bmp") + # OpenBMPFile( 'd:\\winnt\\arcade.bmp') + + +def demo(): + import glob + + winDir = win32api.GetWindowsDirectory() + for fileName in glob.glob1(winDir, "*.bmp")[:2]: + bitmapTemplate.OpenDocumentFile(os.path.join(winDir, fileName)) diff --git a/lib/pythonwin/pywin/framework/cmdline.py b/lib/pythonwin/pywin/framework/cmdline.py new file mode 100644 index 00000000..dba31d1a --- /dev/null +++ b/lib/pythonwin/pywin/framework/cmdline.py @@ -0,0 +1,56 @@ +# cmdline - command line utilities. +import string +import sys + +import win32ui + + +def ParseArgs(str): + import string + + ret = [] + pos = 0 + length = len(str) + while pos < length: + try: + while str[pos] in string.whitespace: + pos = pos + 1 + except IndexError: + break + if pos >= length: + break + if str[pos] == '"': + pos = pos + 1 + try: + endPos = str.index('"', pos) - 1 + nextPos = endPos + 2 + except ValueError: + endPos = length + nextPos = endPos + 1 + else: + endPos = pos + while endPos < length and not str[endPos] in string.whitespace: + endPos = endPos + 1 + nextPos = endPos + 1 + ret.append(str[pos : endPos + 1].strip()) + pos = nextPos + return ret + + +def FixArgFileName(fileName): + """Convert a filename on the commandline to something useful. + Given an automatic filename on the commandline, turn it a python module name, + with the path added to sys.path.""" + import os + + path, fname = os.path.split(fileName) + if len(path) == 0: + path = os.curdir + path = os.path.abspath(path) + # must check that the command line arg's path is in sys.path + for syspath in sys.path: + if os.path.abspath(syspath) == path: + break + else: + sys.path.append(path) + return os.path.splitext(fname)[0] diff --git a/lib/pythonwin/pywin/framework/dbgcommands.py b/lib/pythonwin/pywin/framework/dbgcommands.py new file mode 100644 index 00000000..e295926c --- /dev/null +++ b/lib/pythonwin/pywin/framework/dbgcommands.py @@ -0,0 +1,189 @@ +# Command Handlers for the debugger. + +# Not in the debugger package, as I always want these interfaces to be +# available, even if the debugger has not yet been (or can not be) +# imported +import warnings + +import win32ui +from pywin.scintilla.control import CScintillaEditInterface + +from . import scriptutils + +IdToBarNames = { + win32ui.IDC_DBG_STACK: ("Stack", 0), + win32ui.IDC_DBG_BREAKPOINTS: ("Breakpoints", 0), + win32ui.IDC_DBG_WATCH: ("Watch", 1), +} + + +class DebuggerCommandHandler: + def HookCommands(self): + commands = ( + (self.OnStep, None, win32ui.IDC_DBG_STEP), + (self.OnStepOut, self.OnUpdateOnlyBreak, win32ui.IDC_DBG_STEPOUT), + (self.OnStepOver, None, win32ui.IDC_DBG_STEPOVER), + (self.OnGo, None, win32ui.IDC_DBG_GO), + (self.OnClose, self.OnUpdateClose, win32ui.IDC_DBG_CLOSE), + (self.OnAdd, self.OnUpdateAddBreakpoints, win32ui.IDC_DBG_ADD), + (self.OnClearAll, self.OnUpdateClearAllBreakpoints, win32ui.IDC_DBG_CLEAR), + # (self.OnDebuggerToolbar, self.OnUpdateDebuggerToolbar, win32ui.ID_DEBUGGER_TOOLBAR), + ) + + frame = win32ui.GetMainFrame() + + for methHandler, methUpdate, id in commands: + frame.HookCommand(methHandler, id) + if not methUpdate is None: + frame.HookCommandUpdate(methUpdate, id) + + for id in list(IdToBarNames.keys()): + frame.HookCommand(self.OnDebuggerBar, id) + frame.HookCommandUpdate(self.OnUpdateDebuggerBar, id) + + def OnDebuggerToolbar(self, id, code): + if code == 0: + return not win32ui.GetMainFrame().OnBarCheck(id) + + def OnUpdateDebuggerToolbar(self, cmdui): + win32ui.GetMainFrame().OnUpdateControlBarMenu(cmdui) + cmdui.Enable(1) + + def _GetDebugger(self): + try: + import pywin.debugger + + return pywin.debugger.currentDebugger + except ImportError: + return None + + def _DoOrStart(self, doMethod, startFlag): + d = self._GetDebugger() + if d is not None and d.IsDebugging(): + method = getattr(d, doMethod) + method() + else: + scriptutils.RunScript( + defName=None, defArgs=None, bShowDialog=0, debuggingType=startFlag + ) + + def OnStep(self, msg, code): + self._DoOrStart("do_set_step", scriptutils.RS_DEBUGGER_STEP) + + def OnStepOver(self, msg, code): + self._DoOrStart("do_set_next", scriptutils.RS_DEBUGGER_STEP) + + def OnStepOut(self, msg, code): + d = self._GetDebugger() + if d is not None and d.IsDebugging(): + d.do_set_return() + + def OnGo(self, msg, code): + self._DoOrStart("do_set_continue", scriptutils.RS_DEBUGGER_GO) + + def OnClose(self, msg, code): + d = self._GetDebugger() + if d is not None: + if d.IsDebugging(): + d.set_quit() + else: + d.close() + + def OnUpdateClose(self, cmdui): + d = self._GetDebugger() + if d is not None and d.inited: + cmdui.Enable(1) + else: + cmdui.Enable(0) + + def OnAdd(self, msg, code): + doc, view = scriptutils.GetActiveEditorDocument() + if doc is None: + ## Don't do a messagebox, as this could be triggered from the app's + ## idle loop whenever the debug toolbar is visible, giving a never-ending + ## series of dialogs. This can happen when the OnUpdate handler + ## for the toolbar button IDC_DBG_ADD fails, since MFC falls back to + ## sending a normal command if the UI update command fails. + ## win32ui.MessageBox('There is no active window - no breakpoint can be added') + warnings.warn("There is no active window - no breakpoint can be added") + return None + pathName = doc.GetPathName() + lineNo = view.LineFromChar(view.GetSel()[0]) + 1 + # If I have a debugger, then tell it, otherwise just add a marker + d = self._GetDebugger() + if d is None: + import pywin.framework.editor.color.coloreditor + + doc.MarkerToggle( + lineNo, pywin.framework.editor.color.coloreditor.MARKER_BREAKPOINT + ) + else: + if d.get_break(pathName, lineNo): + win32ui.SetStatusText("Clearing breakpoint", 1) + rc = d.clear_break(pathName, lineNo) + else: + win32ui.SetStatusText("Setting breakpoint", 1) + rc = d.set_break(pathName, lineNo) + if rc: + win32ui.MessageBox(rc) + d.GUIRespondDebuggerData() + + def OnClearAll(self, msg, code): + win32ui.SetStatusText("Clearing all breakpoints") + d = self._GetDebugger() + if d is None: + import pywin.framework.editor + import pywin.framework.editor.color.coloreditor + + for doc in pywin.framework.editor.editorTemplate.GetDocumentList(): + doc.MarkerDeleteAll( + pywin.framework.editor.color.coloreditor.MARKER_BREAKPOINT + ) + else: + d.clear_all_breaks() + d.UpdateAllLineStates() + d.GUIRespondDebuggerData() + + def OnUpdateOnlyBreak(self, cmdui): + d = self._GetDebugger() + ok = d is not None and d.IsBreak() + cmdui.Enable(ok) + + def OnUpdateAddBreakpoints(self, cmdui): + doc, view = scriptutils.GetActiveEditorDocument() + if doc is None or not isinstance(view, CScintillaEditInterface): + enabled = 0 + else: + enabled = 1 + lineNo = view.LineFromChar(view.GetSel()[0]) + 1 + import pywin.framework.editor.color.coloreditor + + cmdui.SetCheck( + doc.MarkerAtLine( + lineNo, pywin.framework.editor.color.coloreditor.MARKER_BREAKPOINT + ) + != 0 + ) + cmdui.Enable(enabled) + + def OnUpdateClearAllBreakpoints(self, cmdui): + d = self._GetDebugger() + cmdui.Enable(d is None or len(d.breaks) != 0) + + def OnUpdateDebuggerBar(self, cmdui): + name, always = IdToBarNames.get(cmdui.m_nID) + enabled = always + d = self._GetDebugger() + if d is not None and d.IsDebugging() and name is not None: + enabled = 1 + bar = d.GetDebuggerBar(name) + cmdui.SetCheck(bar.IsWindowVisible()) + cmdui.Enable(enabled) + + def OnDebuggerBar(self, id, code): + name = IdToBarNames.get(id)[0] + d = self._GetDebugger() + if d is not None and name is not None: + bar = d.GetDebuggerBar(name) + newState = not bar.IsWindowVisible() + win32ui.GetMainFrame().ShowControlBar(bar, newState, 1) diff --git a/lib/pythonwin/pywin/framework/dlgappcore.py b/lib/pythonwin/pywin/framework/dlgappcore.py new file mode 100644 index 00000000..4b60cc1c --- /dev/null +++ b/lib/pythonwin/pywin/framework/dlgappcore.py @@ -0,0 +1,75 @@ +# dlgappcore. +# +# base classes for dialog based apps. + + +import win32api +import win32con +import win32ui +from pywin.mfc import dialog + +from . import app + +error = "Dialog Application Error" + + +class AppDialog(dialog.Dialog): + "The dialog box for the application" + + def __init__(self, id, dll=None): + self.iconId = win32ui.IDR_MAINFRAME + dialog.Dialog.__init__(self, id, dll) + + def OnInitDialog(self): + return dialog.Dialog.OnInitDialog(self) + + # Provide support for a dlg app using an icon + def OnPaint(self): + if not self.IsIconic(): + return self._obj_.OnPaint() + self.DefWindowProc(win32con.WM_ICONERASEBKGND, dc.GetHandleOutput(), 0) + left, top, right, bottom = self.GetClientRect() + left = (right - win32api.GetSystemMetrics(win32con.SM_CXICON)) >> 1 + top = (bottom - win32api.GetSystemMetrics(win32con.SM_CYICON)) >> 1 + hIcon = win32ui.GetApp().LoadIcon(self.iconId) + self.GetDC().DrawIcon((left, top), hIcon) + + # Only needed to provide a minimized icon (and this seems + # less important under win95/NT4 + def OnEraseBkgnd(self, dc): + if self.IsIconic(): + return 1 + else: + return self._obj_.OnEraseBkgnd(dc) + + def OnQueryDragIcon(self): + return win32ui.GetApp().LoadIcon(self.iconId) + + def PreDoModal(self): + pass + + +class DialogApp(app.CApp): + "An application class, for an app with main dialog box" + + def InitInstance(self): + # win32ui.SetProfileFileName('dlgapp.ini') + win32ui.LoadStdProfileSettings() + win32ui.EnableControlContainer() + win32ui.Enable3dControls() + self.dlg = self.frame = self.CreateDialog() + + if self.frame is None: + raise error("No dialog was created by CreateDialog()") + return + + self._obj_.InitDlgInstance(self.dlg) + self.PreDoModal() + self.dlg.PreDoModal() + self.dlg.DoModal() + + def CreateDialog(self): + pass + + def PreDoModal(self): + pass diff --git a/lib/pythonwin/pywin/framework/editor/ModuleBrowser.py b/lib/pythonwin/pywin/framework/editor/ModuleBrowser.py new file mode 100644 index 00000000..7fd96532 --- /dev/null +++ b/lib/pythonwin/pywin/framework/editor/ModuleBrowser.py @@ -0,0 +1,235 @@ +# ModuleBrowser.py - A view that provides a module browser for an editor document. +import pyclbr + +import afxres +import commctrl +import pywin.framework.scriptutils +import pywin.mfc.docview +import win32api +import win32con +import win32ui +from pywin.tools import browser, hierlist + + +class HierListCLBRModule(hierlist.HierListItem): + def __init__(self, modName, clbrdata): + self.modName = modName + self.clbrdata = clbrdata + + def GetText(self): + return self.modName + + def GetSubList(self): + ret = [] + for item in self.clbrdata.values(): + if ( + item.__class__ != pyclbr.Class + ): # ie, it is a pyclbr Function instance (only introduced post 1.5.2) + ret.append(HierListCLBRFunction(item)) + else: + ret.append(HierListCLBRClass(item)) + ret.sort() + return ret + + def IsExpandable(self): + return 1 + + +class HierListCLBRItem(hierlist.HierListItem): + def __init__(self, name, file, lineno, suffix=""): + self.name = str(name) + self.file = file + self.lineno = lineno + self.suffix = suffix + + def __lt__(self, other): + return self.name < other.name + + def __eq__(self, other): + return self.name == other.name + + def GetText(self): + return self.name + self.suffix + + def TakeDefaultAction(self): + if self.file: + pywin.framework.scriptutils.JumpToDocument( + self.file, self.lineno, bScrollToTop=1 + ) + else: + win32ui.SetStatusText("Can not locate the source code for this object.") + + def PerformItemSelected(self): + if self.file is None: + msg = "%s - source can not be located." % (self.name,) + else: + msg = "%s defined at line %d of %s" % (self.name, self.lineno, self.file) + win32ui.SetStatusText(msg) + + +class HierListCLBRClass(HierListCLBRItem): + def __init__(self, clbrclass, suffix=""): + try: + name = clbrclass.name + file = clbrclass.file + lineno = clbrclass.lineno + self.super = clbrclass.super + self.methods = clbrclass.methods + except AttributeError: + name = clbrclass + file = lineno = None + self.super = [] + self.methods = {} + HierListCLBRItem.__init__(self, name, file, lineno, suffix) + + def GetSubList(self): + r1 = [] + for c in self.super: + r1.append(HierListCLBRClass(c, " (Parent class)")) + r1.sort() + r2 = [] + for meth, lineno in self.methods.items(): + r2.append(HierListCLBRMethod(meth, self.file, lineno)) + r2.sort() + return r1 + r2 + + def IsExpandable(self): + return len(self.methods) + len(self.super) + + def GetBitmapColumn(self): + return 21 + + +class HierListCLBRFunction(HierListCLBRItem): + def __init__(self, clbrfunc, suffix=""): + name = clbrfunc.name + file = clbrfunc.file + lineno = clbrfunc.lineno + HierListCLBRItem.__init__(self, name, file, lineno, suffix) + + def GetBitmapColumn(self): + return 22 + + +class HierListCLBRMethod(HierListCLBRItem): + def GetBitmapColumn(self): + return 22 + + +class HierListCLBRErrorItem(hierlist.HierListItem): + def __init__(self, text): + self.text = text + + def GetText(self): + return self.text + + def GetSubList(self): + return [HierListCLBRErrorItem(self.text)] + + def IsExpandable(self): + return 0 + + +class HierListCLBRErrorRoot(HierListCLBRErrorItem): + def IsExpandable(self): + return 1 + + +class BrowserView(pywin.mfc.docview.TreeView): + def OnInitialUpdate(self): + self.list = None + rc = self._obj_.OnInitialUpdate() + self.HookMessage(self.OnSize, win32con.WM_SIZE) + self.bDirty = 0 + self.destroying = 0 + return rc + + def DestroyBrowser(self): + self.DestroyList() + + def OnActivateView(self, activate, av, dv): + # print "AV", self.bDirty, activate + if activate: + self.CheckRefreshList() + return self._obj_.OnActivateView(activate, av, dv) + + def _MakeRoot(self): + path = self.GetDocument().GetPathName() + if not path: + return HierListCLBRErrorRoot( + "Error: Can not browse a file until it is saved" + ) + else: + mod, path = pywin.framework.scriptutils.GetPackageModuleName(path) + if self.bDirty: + what = "Refreshing" + # Hack for pyclbr being too smart + try: + del pyclbr._modules[mod] + except (KeyError, AttributeError): + pass + else: + what = "Building" + win32ui.SetStatusText("%s class list - please wait..." % (what,), 1) + win32ui.DoWaitCursor(1) + try: + reader = pyclbr.readmodule_ex # new version post 1.5.2 + except AttributeError: + reader = pyclbr.readmodule + try: + data = reader(mod, [path]) + if data: + return HierListCLBRModule(mod, data) + else: + return HierListCLBRErrorRoot("No Python classes in module.") + + finally: + win32ui.DoWaitCursor(0) + win32ui.SetStatusText(win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE)) + + def DestroyList(self): + self.destroying = 1 + list = getattr( + self, "list", None + ) # If the document was not successfully opened, we may not have a list. + self.list = None + if list is not None: + list.HierTerm() + self.destroying = 0 + + def CheckMadeList(self): + if self.list is not None or self.destroying: + return + self.rootitem = root = self._MakeRoot() + self.list = list = hierlist.HierListWithItems(root, win32ui.IDB_BROWSER_HIER) + list.HierInit(self.GetParentFrame(), self) + list.SetStyle( + commctrl.TVS_HASLINES | commctrl.TVS_LINESATROOT | commctrl.TVS_HASBUTTONS + ) + + def CheckRefreshList(self): + if self.bDirty: + if self.list is None: + self.CheckMadeList() + else: + new_root = self._MakeRoot() + if self.rootitem.__class__ == new_root.__class__ == HierListCLBRModule: + self.rootitem.modName = new_root.modName + self.rootitem.clbrdata = new_root.clbrdata + self.list.Refresh() + else: + self.list.AcceptRoot(self._MakeRoot()) + self.bDirty = 0 + + def OnSize(self, params): + lparam = params[3] + w = win32api.LOWORD(lparam) + h = win32api.HIWORD(lparam) + if w != 0: + self.CheckMadeList() + elif w == 0: + self.DestroyList() + return 1 + + def _UpdateUIForState(self): + self.bDirty = 1 diff --git a/lib/pythonwin/pywin/framework/editor/__init__.py b/lib/pythonwin/pywin/framework/editor/__init__.py new file mode 100644 index 00000000..ce13ece6 --- /dev/null +++ b/lib/pythonwin/pywin/framework/editor/__init__.py @@ -0,0 +1,106 @@ +# __init__ for the Pythonwin editor package. +# +# We used to support optional editors - eg, color or non-color. +# +# This really isnt necessary with Scintilla, and scintilla +# is getting so deeply embedded that it was too much work. + +import sys + +import win32con +import win32ui + +defaultCharacterFormat = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New") + +##def GetDefaultEditorModuleName(): +## import pywin +## # If someone has set pywin.editormodulename, then this is what we use +## try: +## prefModule = pywin.editormodulename +## except AttributeError: +## prefModule = win32ui.GetProfileVal("Editor","Module", "") +## return prefModule +## +##def WriteDefaultEditorModule(module): +## try: +## module = module.__name__ +## except: +## pass +## win32ui.WriteProfileVal("Editor", "Module", module) + + +def LoadDefaultEditor(): + pass + + +## prefModule = GetDefaultEditorModuleName() +## restorePrefModule = None +## mod = None +## if prefModule: +## try: +## mod = __import__(prefModule) +## except 'xx': +## msg = "Importing your preferred editor ('%s') failed.\n\nError %s: %s\n\nAn attempt will be made to load the default editor.\n\nWould you like this editor disabled in the future?" % (prefModule, sys.exc_info()[0], sys.exc_info()[1]) +## rc = win32ui.MessageBox(msg, "Error importing editor", win32con.MB_YESNO) +## if rc == win32con.IDNO: +## restorePrefModule = prefModule +## WriteDefaultEditorModule("") +## del rc +## +## try: +## # Try and load the default one - dont catch errors here. +## if mod is None: +## prefModule = "pywin.framework.editor.color.coloreditor" +## mod = __import__(prefModule) +## +## # Get at the real module. +## mod = sys.modules[prefModule] +## +## # Do a "from mod import *" +## globals().update(mod.__dict__) +## +## finally: +## # Restore the users default editor if it failed and they requested not to disable it. +## if restorePrefModule: +## WriteDefaultEditorModule(restorePrefModule) + + +def GetEditorOption(option, defaultValue, min=None, max=None): + rc = win32ui.GetProfileVal("Editor", option, defaultValue) + if min is not None and rc < min: + rc = defaultValue + if max is not None and rc > max: + rc = defaultValue + return rc + + +def SetEditorOption(option, newValue): + win32ui.WriteProfileVal("Editor", option, newValue) + + +def DeleteEditorOption(option): + try: + win32ui.WriteProfileVal("Editor", option, None) + except win32ui.error: + pass + + +# Load and save font tuples +def GetEditorFontOption(option, default=None): + if default is None: + default = defaultCharacterFormat + fmt = GetEditorOption(option, "") + if fmt == "": + return default + try: + return eval(fmt) + except: + print("WARNING: Invalid font setting in registry - setting ignored") + return default + + +def SetEditorFontOption(option, newValue): + SetEditorOption(option, str(newValue)) + + +from pywin.framework.editor.color.coloreditor import editorTemplate diff --git a/lib/pythonwin/pywin/framework/editor/color/__init__.py b/lib/pythonwin/pywin/framework/editor/color/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/pythonwin/pywin/framework/editor/color/coloreditor.py b/lib/pythonwin/pywin/framework/editor/color/coloreditor.py new file mode 100644 index 00000000..4aacc0ea --- /dev/null +++ b/lib/pythonwin/pywin/framework/editor/color/coloreditor.py @@ -0,0 +1,664 @@ +# Color Editor originally by Neil Hodgson, but restructured by mh to integrate +# even tighter into Pythonwin. + +import pywin.scintilla.keycodes +import win32api +import win32con +import win32ui +from pywin.framework.editor import ( + GetEditorFontOption, + GetEditorOption, + SetEditorFontOption, + SetEditorOption, + defaultCharacterFormat, +) +from pywin.scintilla import bindings + +# from pywin.framework.editor import EditorPropertyPage + +MSG_CHECK_EXTERNAL_FILE = ( + win32con.WM_USER + 1999 +) ## WARNING: Duplicated in document.py and editor.py + +# Define a few common markers +MARKER_BOOKMARK = 0 +MARKER_BREAKPOINT = 1 +MARKER_CURRENT = 2 + +import pywin.scintilla.view +from pywin.debugger import dbgcon +from pywin.framework.editor.document import EditorDocumentBase +from pywin.scintilla import scintillacon # For the marker definitions +from pywin.scintilla.document import CScintillaDocument + + +class SyntEditDocument(EditorDocumentBase): + "A SyntEdit document." + + def OnDebuggerStateChange(self, state): + self._ApplyOptionalToViews("OnDebuggerStateChange", state) + + def HookViewNotifications(self, view): + EditorDocumentBase.HookViewNotifications(self, view) + view.SCISetUndoCollection(1) + + def FinalizeViewCreation(self, view): + EditorDocumentBase.FinalizeViewCreation(self, view) + if view == self.GetFirstView(): + self.GetDocTemplate().CheckIDLEMenus(view.idle) + + +SyntEditViewParent = pywin.scintilla.view.CScintillaView + + +class SyntEditView(SyntEditViewParent): + "A view of a SyntEdit. Obtains data from document." + + def __init__(self, doc): + SyntEditViewParent.__init__(self, doc) + self.bCheckingFile = 0 + + def OnInitialUpdate(self): + SyntEditViewParent.OnInitialUpdate(self) + + self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN) + + for id in ( + win32ui.ID_VIEW_FOLD_COLLAPSE, + win32ui.ID_VIEW_FOLD_COLLAPSE_ALL, + win32ui.ID_VIEW_FOLD_EXPAND, + win32ui.ID_VIEW_FOLD_EXPAND_ALL, + ): + self.HookCommand(self.OnCmdViewFold, id) + self.HookCommandUpdate(self.OnUpdateViewFold, id) + self.HookCommand(self.OnCmdViewFoldTopLevel, win32ui.ID_VIEW_FOLD_TOPLEVEL) + + # Define the markers + # self.SCIMarkerDeleteAll() + self.SCIMarkerDefineAll( + MARKER_BOOKMARK, + scintillacon.SC_MARK_ROUNDRECT, + win32api.RGB(0x0, 0x0, 0x0), + win32api.RGB(0, 0xFF, 0xFF), + ) + + self.SCIMarkerDefine(MARKER_CURRENT, scintillacon.SC_MARK_ARROW) + self.SCIMarkerSetBack(MARKER_CURRENT, win32api.RGB(0xFF, 0xFF, 0x00)) + + # Define the folding markers + if 1: # traditional markers + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDEROPEN, + scintillacon.SC_MARK_MINUS, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDER, + scintillacon.SC_MARK_PLUS, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDERSUB, + scintillacon.SC_MARK_EMPTY, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDERTAIL, + scintillacon.SC_MARK_EMPTY, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDEREND, + scintillacon.SC_MARK_EMPTY, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDEROPENMID, + scintillacon.SC_MARK_EMPTY, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDERMIDTAIL, + scintillacon.SC_MARK_EMPTY, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + else: # curved markers + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDEROPEN, + scintillacon.SC_MARK_CIRCLEMINUS, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDER, + scintillacon.SC_MARK_CIRCLEPLUS, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDERSUB, + scintillacon.SC_MARK_VLINE, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDERTAIL, + scintillacon.SC_MARK_LCORNERCURVE, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDEREND, + scintillacon.SC_MARK_CIRCLEPLUSCONNECTED, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDEROPENMID, + scintillacon.SC_MARK_CIRCLEMINUSCONNECTED, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + self.SCIMarkerDefineAll( + scintillacon.SC_MARKNUM_FOLDERMIDTAIL, + scintillacon.SC_MARK_TCORNERCURVE, + win32api.RGB(0xFF, 0xFF, 0xFF), + win32api.RGB(0, 0, 0), + ) + + self.SCIMarkerDefine(MARKER_BREAKPOINT, scintillacon.SC_MARK_CIRCLE) + # Marker background depends on debugger state + self.SCIMarkerSetFore(MARKER_BREAKPOINT, win32api.RGB(0x0, 0, 0)) + # Get the current debugger state. + try: + import pywin.debugger + + if pywin.debugger.currentDebugger is None: + state = dbgcon.DBGSTATE_NOT_DEBUGGING + else: + state = pywin.debugger.currentDebugger.debuggerState + except ImportError: + state = dbgcon.DBGSTATE_NOT_DEBUGGING + self.OnDebuggerStateChange(state) + + def _GetSubConfigNames(self): + return ["editor"] # Allow [Keys:Editor] sections to be specific to us + + def DoConfigChange(self): + SyntEditViewParent.DoConfigChange(self) + tabSize = GetEditorOption("Tab Size", 4, 2) + indentSize = GetEditorOption("Indent Size", 4, 2) + bUseTabs = GetEditorOption("Use Tabs", 0) + bSmartTabs = GetEditorOption("Smart Tabs", 1) + ext = self.idle.IDLEExtension("AutoIndent") # Required extension. + + self.SCISetViewWS(GetEditorOption("View Whitespace", 0)) + self.SCISetViewEOL(GetEditorOption("View EOL", 0)) + self.SCISetIndentationGuides(GetEditorOption("View Indentation Guides", 0)) + + if GetEditorOption("Right Edge Enabled", 0): + mode = scintillacon.EDGE_BACKGROUND + else: + mode = scintillacon.EDGE_NONE + self.SCISetEdgeMode(mode) + self.SCISetEdgeColumn(GetEditorOption("Right Edge Column", 75)) + self.SCISetEdgeColor( + GetEditorOption("Right Edge Color", win32api.RGB(0xEF, 0xEF, 0xEF)) + ) + + width = GetEditorOption("Marker Margin Width", 16) + self.SCISetMarginWidthN(1, width) + width = GetEditorOption("Fold Margin Width", 12) + self.SCISetMarginWidthN(2, width) + width = GetEditorOption("Line Number Margin Width", 0) + self.SCISetMarginWidthN(0, width) + self.bFolding = GetEditorOption("Enable Folding", 1) + fold_flags = 0 + self.SendScintilla( + scintillacon.SCI_SETMODEVENTMASK, scintillacon.SC_MOD_CHANGEFOLD + ) + if self.bFolding: + if GetEditorOption("Fold Lines", 1): + fold_flags = 16 + + self.SCISetProperty("fold", self.bFolding) + self.SCISetFoldFlags(fold_flags) + + tt_color = GetEditorOption("Tab Timmy Color", win32api.RGB(0xFF, 0, 0)) + self.SendScintilla(scintillacon.SCI_INDICSETFORE, 1, tt_color) + + tt_use = GetEditorOption("Use Tab Timmy", 1) + if tt_use: + self.SCISetProperty("tab.timmy.whinge.level", "1") + + # Auto-indent has very complicated behaviour. In a nutshell, the only + # way to get sensible behaviour from it is to ensure tabwidth != indentsize. + # Further, usetabs will only ever go from 1->0, never 0->1. + # This is _not_ the behaviour Pythonwin wants: + # * Tab width is arbitary, so should have no impact on smarts. + # * bUseTabs setting should reflect how new files are created, and + # if Smart Tabs disabled, existing files are edited + # * If "Smart Tabs" is enabled, bUseTabs should have no bearing + # for existing files (unless of course no context can be determined) + # + # So for smart tabs we configure the widget with completely dummy + # values (ensuring tabwidth != indentwidth), ask it to guess, then + # look at the values it has guessed, and re-configure + if bSmartTabs: + ext.config(usetabs=1, tabwidth=5, indentwidth=4) + ext.set_indentation_params(1) + if ext.indentwidth == 5: + # Either 5 literal spaces, or a single tab character. Assume a tab + usetabs = 1 + indentwidth = tabSize + else: + # Either Indented with spaces, and indent size has been guessed or + # an empty file (or no context found - tough!) + if self.GetTextLength() == 0: # emtpy + usetabs = bUseTabs + indentwidth = indentSize + else: # guessed. + indentwidth = ext.indentwidth + usetabs = 0 + # Tab size can never be guessed - set at user preference. + ext.config(usetabs=usetabs, indentwidth=indentwidth, tabwidth=tabSize) + else: + # Dont want smart-tabs - just set the options! + ext.config(usetabs=bUseTabs, tabwidth=tabSize, indentwidth=indentSize) + self.SCISetIndent(indentSize) + self.SCISetTabWidth(tabSize) + + def OnDebuggerStateChange(self, state): + if state == dbgcon.DBGSTATE_NOT_DEBUGGING: + # Indicate breakpoints arent really usable. + # Not quite white - useful when no marker margin, so set as background color. + self.SCIMarkerSetBack(MARKER_BREAKPOINT, win32api.RGB(0xEF, 0xEF, 0xEF)) + else: + # A light-red, so still readable when no marker margin. + self.SCIMarkerSetBack(MARKER_BREAKPOINT, win32api.RGB(0xFF, 0x80, 0x80)) + + def HookDocumentHandlers(self): + SyntEditViewParent.HookDocumentHandlers(self) + self.HookMessage(self.OnCheckExternalDocumentUpdated, MSG_CHECK_EXTERNAL_FILE) + + def HookHandlers(self): + SyntEditViewParent.HookHandlers(self) + self.HookMessage(self.OnSetFocus, win32con.WM_SETFOCUS) + + def _PrepareUserStateChange(self): + return self.GetSel(), self.GetFirstVisibleLine() + + def _EndUserStateChange(self, info): + scrollOff = info[1] - self.GetFirstVisibleLine() + if scrollOff: + self.LineScroll(scrollOff) + # Make sure we dont reset the cursor beyond the buffer. + max = self.GetTextLength() + newPos = min(info[0][0], max), min(info[0][1], max) + self.SetSel(newPos) + + ####################################### + # The Windows Message or Notify handlers. + ####################################### + def OnMarginClick(self, std, extra): + notify = self.SCIUnpackNotifyMessage(extra) + if notify.margin == 2: # Our fold margin + line_click = self.LineFromChar(notify.position) + # max_line = self.GetLineCount() + if self.SCIGetFoldLevel(line_click) & scintillacon.SC_FOLDLEVELHEADERFLAG: + # If a fold point. + self.SCIToggleFold(line_click) + return 1 + + def OnSetFocus(self, msg): + # Even though we use file change notifications, we should be very sure about it here. + self.OnCheckExternalDocumentUpdated(msg) + return 1 + + def OnCheckExternalDocumentUpdated(self, msg): + if self.bCheckingFile: + return + self.bCheckingFile = 1 + self.GetDocument().CheckExternalDocumentUpdated() + self.bCheckingFile = 0 + + def OnRClick(self, params): + menu = win32ui.CreatePopupMenu() + self.AppendMenu(menu, "&Locate module", "LocateModule") + self.AppendMenu(menu, flags=win32con.MF_SEPARATOR) + self.AppendMenu(menu, "&Undo", "EditUndo") + self.AppendMenu(menu, "&Redo", "EditRedo") + self.AppendMenu(menu, flags=win32con.MF_SEPARATOR) + self.AppendMenu(menu, "Cu&t", "EditCut") + self.AppendMenu(menu, "&Copy", "EditCopy") + self.AppendMenu(menu, "&Paste", "EditPaste") + self.AppendMenu(menu, flags=win32con.MF_SEPARATOR) + self.AppendMenu(menu, "&Select all", "EditSelectAll") + self.AppendMenu( + menu, "View &Whitespace", "ViewWhitespace", checked=self.SCIGetViewWS() + ) + self.AppendMenu( + menu, "&Fixed Font", "ViewFixedFont", checked=self._GetColorizer().bUseFixed + ) + self.AppendMenu(menu, flags=win32con.MF_SEPARATOR) + self.AppendMenu(menu, "&Goto line...", "GotoLine") + + submenu = win32ui.CreatePopupMenu() + newitems = self.idle.GetMenuItems("edit") + for text, event in newitems: + self.AppendMenu(submenu, text, event) + + flags = win32con.MF_STRING | win32con.MF_ENABLED | win32con.MF_POPUP + menu.AppendMenu(flags, submenu.GetHandle(), "&Source code") + + flags = ( + win32con.TPM_LEFTALIGN | win32con.TPM_LEFTBUTTON | win32con.TPM_RIGHTBUTTON + ) + menu.TrackPopupMenu(params[5], flags, self) + return 0 + + def OnCmdViewFold(self, cid, code): # Handle the menu command + if cid == win32ui.ID_VIEW_FOLD_EXPAND_ALL: + self.FoldExpandAllEvent(None) + elif cid == win32ui.ID_VIEW_FOLD_EXPAND: + self.FoldExpandEvent(None) + elif cid == win32ui.ID_VIEW_FOLD_COLLAPSE_ALL: + self.FoldCollapseAllEvent(None) + elif cid == win32ui.ID_VIEW_FOLD_COLLAPSE: + self.FoldCollapseEvent(None) + else: + print("Unknown collapse/expand ID") + + def OnUpdateViewFold(self, cmdui): # Update the tick on the UI. + if not self.bFolding: + cmdui.Enable(0) + return + id = cmdui.m_nID + if id in (win32ui.ID_VIEW_FOLD_EXPAND_ALL, win32ui.ID_VIEW_FOLD_COLLAPSE_ALL): + cmdui.Enable() + else: + enable = 0 + lineno = self.LineFromChar(self.GetSel()[0]) + foldable = ( + self.SCIGetFoldLevel(lineno) & scintillacon.SC_FOLDLEVELHEADERFLAG + ) + is_expanded = self.SCIGetFoldExpanded(lineno) + if id == win32ui.ID_VIEW_FOLD_EXPAND: + if foldable and not is_expanded: + enable = 1 + elif id == win32ui.ID_VIEW_FOLD_COLLAPSE: + if foldable and is_expanded: + enable = 1 + cmdui.Enable(enable) + + def OnCmdViewFoldTopLevel(self, cid, code): # Handle the menu command + self.FoldTopLevelEvent(None) + + ####################################### + # The Events + ####################################### + def ToggleBookmarkEvent(self, event, pos=-1): + """Toggle a bookmark at the specified or current position""" + if pos == -1: + pos, end = self.GetSel() + startLine = self.LineFromChar(pos) + self.GetDocument().MarkerToggle(startLine + 1, MARKER_BOOKMARK) + return 0 + + def GotoNextBookmarkEvent(self, event, fromPos=-1): + """Move to the next bookmark""" + if fromPos == -1: + fromPos, end = self.GetSel() + startLine = self.LineFromChar(fromPos) + 1 # Zero based line to start + nextLine = self.GetDocument().MarkerGetNext(startLine + 1, MARKER_BOOKMARK) - 1 + if nextLine < 0: + nextLine = self.GetDocument().MarkerGetNext(0, MARKER_BOOKMARK) - 1 + if nextLine < 0 or nextLine == startLine - 1: + win32api.MessageBeep() + else: + self.SCIEnsureVisible(nextLine) + self.SCIGotoLine(nextLine) + return 0 + + def TabKeyEvent(self, event): + """Insert an indent. If no selection, a single indent, otherwise a block indent""" + # Handle auto-complete first. + if self.SCIAutoCActive(): + self.SCIAutoCComplete() + return 0 + # Call the IDLE event. + return self.bindings.fire("<>", event) + + def EnterKeyEvent(self, event): + """Handle the enter key with special handling for auto-complete""" + # Handle auto-complete first. + if self.SCIAutoCActive(): + self.SCIAutoCComplete() + self.SCIAutoCCancel() + # Call the IDLE event. + return self.bindings.fire("<>", event) + + def ShowInteractiveWindowEvent(self, event): + import pywin.framework.interact + + pywin.framework.interact.ShowInteractiveWindow() + + def FoldTopLevelEvent(self, event=None): + if not self.bFolding: + return 1 + + win32ui.DoWaitCursor(1) + try: + self.Colorize() + maxLine = self.GetLineCount() + # Find the first line, and check out its state. + for lineSeek in range(maxLine): + if self.SCIGetFoldLevel(lineSeek) & scintillacon.SC_FOLDLEVELHEADERFLAG: + expanding = not self.SCIGetFoldExpanded(lineSeek) + break + else: + # no folds here! + return + for lineSeek in range(lineSeek, maxLine): + level = self.SCIGetFoldLevel(lineSeek) + level_no = ( + level + & scintillacon.SC_FOLDLEVELNUMBERMASK + - scintillacon.SC_FOLDLEVELBASE + ) + is_header = level & scintillacon.SC_FOLDLEVELHEADERFLAG + # print lineSeek, level_no, is_header + if level_no == 0 and is_header: + if (expanding and not self.SCIGetFoldExpanded(lineSeek)) or ( + not expanding and self.SCIGetFoldExpanded(lineSeek) + ): + self.SCIToggleFold(lineSeek) + finally: + win32ui.DoWaitCursor(-1) + + def FoldExpandSecondLevelEvent(self, event): + if not self.bFolding: + return 1 + win32ui.DoWaitCursor(1) + ## I think this is needed since Scintilla may not have + ## already formatted parts of file outside visible window. + self.Colorize() + levels = [scintillacon.SC_FOLDLEVELBASE] + ## Scintilla's level number is based on amount of whitespace indentation + for lineno in range(self.GetLineCount()): + level = self.SCIGetFoldLevel(lineno) + if not level & scintillacon.SC_FOLDLEVELHEADERFLAG: + continue + curr_level = level & scintillacon.SC_FOLDLEVELNUMBERMASK + if curr_level > levels[-1]: + levels.append(curr_level) + try: + level_ind = levels.index(curr_level) + except ValueError: + ## probably syntax error in source file, bail + break + levels = levels[: level_ind + 1] + if level_ind == 1 and not self.SCIGetFoldExpanded(lineno): + self.SCIToggleFold(lineno) + win32ui.DoWaitCursor(-1) + + def FoldCollapseSecondLevelEvent(self, event): + if not self.bFolding: + return 1 + win32ui.DoWaitCursor(1) + ## I think this is needed since Scintilla may not have + ## already formatted parts of file outside visible window. + self.Colorize() + levels = [scintillacon.SC_FOLDLEVELBASE] + ## Scintilla's level number is based on amount of whitespace indentation + for lineno in range(self.GetLineCount()): + level = self.SCIGetFoldLevel(lineno) + if not level & scintillacon.SC_FOLDLEVELHEADERFLAG: + continue + curr_level = level & scintillacon.SC_FOLDLEVELNUMBERMASK + if curr_level > levels[-1]: + levels.append(curr_level) + try: + level_ind = levels.index(curr_level) + except ValueError: + ## probably syntax error in source file, bail + break + levels = levels[: level_ind + 1] + if level_ind == 1 and self.SCIGetFoldExpanded(lineno): + self.SCIToggleFold(lineno) + win32ui.DoWaitCursor(-1) + + def FoldExpandEvent(self, event): + if not self.bFolding: + return 1 + win32ui.DoWaitCursor(1) + lineno = self.LineFromChar(self.GetSel()[0]) + if self.SCIGetFoldLevel( + lineno + ) & scintillacon.SC_FOLDLEVELHEADERFLAG and not self.SCIGetFoldExpanded(lineno): + self.SCIToggleFold(lineno) + win32ui.DoWaitCursor(-1) + + def FoldExpandAllEvent(self, event): + if not self.bFolding: + return 1 + win32ui.DoWaitCursor(1) + for lineno in range(0, self.GetLineCount()): + if self.SCIGetFoldLevel( + lineno + ) & scintillacon.SC_FOLDLEVELHEADERFLAG and not self.SCIGetFoldExpanded( + lineno + ): + self.SCIToggleFold(lineno) + win32ui.DoWaitCursor(-1) + + def FoldCollapseEvent(self, event): + if not self.bFolding: + return 1 + win32ui.DoWaitCursor(1) + lineno = self.LineFromChar(self.GetSel()[0]) + if self.SCIGetFoldLevel( + lineno + ) & scintillacon.SC_FOLDLEVELHEADERFLAG and self.SCIGetFoldExpanded(lineno): + self.SCIToggleFold(lineno) + win32ui.DoWaitCursor(-1) + + def FoldCollapseAllEvent(self, event): + if not self.bFolding: + return 1 + win32ui.DoWaitCursor(1) + self.Colorize() + for lineno in range(0, self.GetLineCount()): + if self.SCIGetFoldLevel( + lineno + ) & scintillacon.SC_FOLDLEVELHEADERFLAG and self.SCIGetFoldExpanded(lineno): + self.SCIToggleFold(lineno) + win32ui.DoWaitCursor(-1) + + +from pywin.framework.editor.frame import EditorFrame + + +class SplitterFrame(EditorFrame): + def OnCreate(self, cs): + self.HookCommand(self.OnWindowSplit, win32ui.ID_WINDOW_SPLIT) + return 1 + + def OnWindowSplit(self, id, code): + self.GetDlgItem(win32ui.AFX_IDW_PANE_FIRST).DoKeyboardSplit() + return 1 + + +from pywin.framework.editor.template import EditorTemplateBase + + +class SyntEditTemplate(EditorTemplateBase): + def __init__( + self, res=win32ui.IDR_TEXTTYPE, makeDoc=None, makeFrame=None, makeView=None + ): + if makeDoc is None: + makeDoc = SyntEditDocument + if makeView is None: + makeView = SyntEditView + if makeFrame is None: + makeFrame = SplitterFrame + self.bSetMenus = 0 + EditorTemplateBase.__init__(self, res, makeDoc, makeFrame, makeView) + + def CheckIDLEMenus(self, idle): + if self.bSetMenus: + return + self.bSetMenus = 1 + + submenu = win32ui.CreatePopupMenu() + newitems = idle.GetMenuItems("edit") + flags = win32con.MF_STRING | win32con.MF_ENABLED + for text, event in newitems: + id = bindings.event_to_commands.get(event) + if id is not None: + keyname = pywin.scintilla.view.configManager.get_key_binding( + event, ["editor"] + ) + if keyname is not None: + text = text + "\t" + keyname + submenu.AppendMenu(flags, id, text) + + mainMenu = self.GetSharedMenu() + editMenu = mainMenu.GetSubMenu(1) + editMenu.AppendMenu(win32con.MF_SEPARATOR, 0, "") + editMenu.AppendMenu( + win32con.MF_STRING | win32con.MF_POPUP | win32con.MF_ENABLED, + submenu.GetHandle(), + "&Source Code", + ) + + def _CreateDocTemplate(self, resourceId): + return win32ui.CreateDocTemplate(resourceId) + + def CreateWin32uiDocument(self): + return self.DoCreateDoc() + + def GetPythonPropertyPages(self): + """Returns a list of property pages""" + from pywin.scintilla import configui + + return EditorTemplateBase.GetPythonPropertyPages(self) + [ + configui.ScintillaFormatPropertyPage() + ] + + +# For debugging purposes, when this module may be reloaded many times. +try: + win32ui.GetApp().RemoveDocTemplate(editorTemplate) +except NameError: + pass + +editorTemplate = SyntEditTemplate() +win32ui.GetApp().AddDocTemplate(editorTemplate) diff --git a/lib/pythonwin/pywin/framework/editor/configui.py b/lib/pythonwin/pywin/framework/editor/configui.py new file mode 100644 index 00000000..903ad66c --- /dev/null +++ b/lib/pythonwin/pywin/framework/editor/configui.py @@ -0,0 +1,308 @@ +import pywin.scintilla.config +import win32api +import win32con +import win32ui +from pywin.framework.editor import ( + DeleteEditorOption, + GetEditorFontOption, + GetEditorOption, + SetEditorFontOption, + SetEditorOption, + defaultCharacterFormat, + editorTemplate, +) +from pywin.mfc import dialog + +from . import document + +# The standard 16 color VGA palette should always be possible +paletteVGA = ( + ("Black", 0, 0, 0), + ("Navy", 0, 0, 128), + ("Green", 0, 128, 0), + ("Cyan", 0, 128, 128), + ("Maroon", 128, 0, 0), + ("Purple", 128, 0, 128), + ("Olive", 128, 128, 0), + ("Gray", 128, 128, 128), + ("Silver", 192, 192, 192), + ("Blue", 0, 0, 255), + ("Lime", 0, 255, 0), + ("Aqua", 0, 255, 255), + ("Red", 255, 0, 0), + ("Fuchsia", 255, 0, 255), + ("Yellow", 255, 255, 0), + ("White", 255, 255, 255), +) + + +###################################################### +# +# Property Page for editor options +# +class EditorPropertyPage(dialog.PropertyPage): + def __init__(self): + dialog.PropertyPage.__init__(self, win32ui.IDD_PP_EDITOR) + self.autooptions = [] + self._AddEditorOption(win32ui.IDC_AUTO_RELOAD, "i", "Auto Reload", 1) + self._AddEditorOption( + win32ui.IDC_COMBO1, "i", "Backup Type", document.BAK_DOT_BAK_BAK_DIR + ) + self._AddEditorOption( + win32ui.IDC_AUTOCOMPLETE, "i", "Autocomplete Attributes", 1 + ) + self._AddEditorOption(win32ui.IDC_CALLTIPS, "i", "Show Call Tips", 1) + self._AddEditorOption( + win32ui.IDC_MARGIN_LINENUMBER, "i", "Line Number Margin Width", 0 + ) + self._AddEditorOption(win32ui.IDC_RADIO1, "i", "MarkersInMargin", None) + self._AddEditorOption( + win32ui.IDC_MARGIN_MARKER, "i", "Marker Margin Width", None + ) + self["Marker Margin Width"] = GetEditorOption("Marker Margin Width", 16) + + # Folding + self._AddEditorOption(win32ui.IDC_MARGIN_FOLD, "i", "Fold Margin Width", 12) + self._AddEditorOption(win32ui.IDC_FOLD_ENABLE, "i", "Enable Folding", 1) + self._AddEditorOption(win32ui.IDC_FOLD_ON_OPEN, "i", "Fold On Open", 0) + self._AddEditorOption(win32ui.IDC_FOLD_SHOW_LINES, "i", "Fold Lines", 1) + + # Right edge. + self._AddEditorOption( + win32ui.IDC_RIGHTEDGE_ENABLE, "i", "Right Edge Enabled", 0 + ) + self._AddEditorOption( + win32ui.IDC_RIGHTEDGE_COLUMN, "i", "Right Edge Column", 75 + ) + + # Source control, etc + self.AddDDX(win32ui.IDC_VSS_INTEGRATE, "bVSS") + self.AddDDX(win32ui.IDC_KEYBOARD_CONFIG, "Configs", "l") + self["Configs"] = pywin.scintilla.config.find_config_files() + + def _AddEditorOption(self, idd, typ, optionName, defaultVal): + self.AddDDX(idd, optionName, typ) + # some options are "derived" - ie, can be implied from others + # (eg, "view markers in background" is implied from "markerMarginWidth==0" + # So we don't actually store these values, but they do still get DDX support. + if defaultVal is not None: + self[optionName] = GetEditorOption(optionName, defaultVal) + self.autooptions.append((optionName, defaultVal)) + + def OnInitDialog(self): + for name, val in self.autooptions: + self[name] = GetEditorOption(name, val) + + # Note that these MUST be in the same order as the BAK constants. + cbo = self.GetDlgItem(win32ui.IDC_COMBO1) + cbo.AddString("None") + cbo.AddString(".BAK File") + cbo.AddString("TEMP dir") + cbo.AddString("Own dir") + + # Source Safe + bVSS = ( + GetEditorOption("Source Control Module", "") == "pywin.framework.editor.vss" + ) + self["bVSS"] = bVSS + + edit = self.GetDlgItem(win32ui.IDC_RIGHTEDGE_SAMPLE) + edit.SetWindowText("Sample Color") + + rc = dialog.PropertyPage.OnInitDialog(self) + + try: + self.GetDlgItem(win32ui.IDC_KEYBOARD_CONFIG).SelectString( + -1, GetEditorOption("Keyboard Config", "default") + ) + except win32ui.error: + import traceback + + traceback.print_exc() + pass + + self.HookCommand(self.OnButSimple, win32ui.IDC_FOLD_ENABLE) + self.HookCommand(self.OnButSimple, win32ui.IDC_RADIO1) + self.HookCommand(self.OnButSimple, win32ui.IDC_RADIO2) + self.HookCommand(self.OnButSimple, win32ui.IDC_RIGHTEDGE_ENABLE) + self.HookCommand(self.OnButEdgeColor, win32ui.IDC_RIGHTEDGE_DEFINE) + + butMarginEnabled = self["Marker Margin Width"] > 0 + self.GetDlgItem(win32ui.IDC_RADIO1).SetCheck(butMarginEnabled) + self.GetDlgItem(win32ui.IDC_RADIO2).SetCheck(not butMarginEnabled) + + self.edgeColor = self.initialEdgeColor = GetEditorOption( + "Right Edge Color", win32api.RGB(0xEF, 0xEF, 0xEF) + ) + for spinner_id in (win32ui.IDC_SPIN1, win32ui.IDC_SPIN2, win32ui.IDC_SPIN3): + spinner = self.GetDlgItem(spinner_id) + spinner.SetRange(0, 100) + self.UpdateUIForState() + + return rc + + def OnButSimple(self, id, code): + if code == win32con.BN_CLICKED: + self.UpdateUIForState() + + def OnButEdgeColor(self, id, code): + if code == win32con.BN_CLICKED: + d = win32ui.CreateColorDialog(self.edgeColor, 0, self) + # Ensure the current color is a custom color (as it may not be in the swatch) + # plus some other nice gray scales. + ccs = [self.edgeColor] + for c in range(0xEF, 0x4F, -0x10): + ccs.append(win32api.RGB(c, c, c)) + d.SetCustomColors(ccs) + if d.DoModal() == win32con.IDOK: + self.edgeColor = d.GetColor() + self.UpdateUIForState() + + def UpdateUIForState(self): + folding = self.GetDlgItem(win32ui.IDC_FOLD_ENABLE).GetCheck() + self.GetDlgItem(win32ui.IDC_FOLD_ON_OPEN).EnableWindow(folding) + self.GetDlgItem(win32ui.IDC_FOLD_SHOW_LINES).EnableWindow(folding) + + widthEnabled = self.GetDlgItem(win32ui.IDC_RADIO1).GetCheck() + self.GetDlgItem(win32ui.IDC_MARGIN_MARKER).EnableWindow(widthEnabled) + self.UpdateData() # Ensure self[] is up to date with the control data. + if widthEnabled and self["Marker Margin Width"] == 0: + self["Marker Margin Width"] = 16 + self.UpdateData(0) # Ensure control up to date with self[] + + # Right edge + edgeEnabled = self.GetDlgItem(win32ui.IDC_RIGHTEDGE_ENABLE).GetCheck() + self.GetDlgItem(win32ui.IDC_RIGHTEDGE_COLUMN).EnableWindow(edgeEnabled) + self.GetDlgItem(win32ui.IDC_RIGHTEDGE_SAMPLE).EnableWindow(edgeEnabled) + self.GetDlgItem(win32ui.IDC_RIGHTEDGE_DEFINE).EnableWindow(edgeEnabled) + + edit = self.GetDlgItem(win32ui.IDC_RIGHTEDGE_SAMPLE) + edit.SetBackgroundColor(0, self.edgeColor) + + def OnOK(self): + for name, defVal in self.autooptions: + SetEditorOption(name, self[name]) + # Margin width gets handled differently. + if self["MarkersInMargin"] == 0: + SetEditorOption("Marker Margin Width", self["Marker Margin Width"]) + else: + SetEditorOption("Marker Margin Width", 0) + if self.edgeColor != self.initialEdgeColor: + SetEditorOption("Right Edge Color", self.edgeColor) + if self["bVSS"]: + SetEditorOption("Source Control Module", "pywin.framework.editor.vss") + else: + if ( + GetEditorOption("Source Control Module", "") + == "pywin.framework.editor.vss" + ): + SetEditorOption("Source Control Module", "") + # Keyboard config + configname = self.GetDlgItem(win32ui.IDC_KEYBOARD_CONFIG).GetWindowText() + if configname: + if configname == "default": + DeleteEditorOption("Keyboard Config") + else: + SetEditorOption("Keyboard Config", configname) + + import pywin.scintilla.view + + pywin.scintilla.view.LoadConfiguration() + + # Now tell all views we have changed. + ## for doc in editorTemplate.GetDocumentList(): + ## for view in doc.GetAllViews(): + ## try: + ## fn = view.OnConfigChange + ## except AttributeError: + ## continue + ## fn() + return 1 + + +class EditorWhitespacePropertyPage(dialog.PropertyPage): + def __init__(self): + dialog.PropertyPage.__init__(self, win32ui.IDD_PP_TABS) + self.autooptions = [] + self._AddEditorOption(win32ui.IDC_TAB_SIZE, "i", "Tab Size", 4) + self._AddEditorOption(win32ui.IDC_INDENT_SIZE, "i", "Indent Size", 4) + self._AddEditorOption(win32ui.IDC_USE_SMART_TABS, "i", "Smart Tabs", 1) + self._AddEditorOption(win32ui.IDC_VIEW_WHITESPACE, "i", "View Whitespace", 0) + self._AddEditorOption(win32ui.IDC_VIEW_EOL, "i", "View EOL", 0) + self._AddEditorOption( + win32ui.IDC_VIEW_INDENTATIONGUIDES, "i", "View Indentation Guides", 0 + ) + + def _AddEditorOption(self, idd, typ, optionName, defaultVal): + self.AddDDX(idd, optionName, typ) + self[optionName] = GetEditorOption(optionName, defaultVal) + self.autooptions.append((optionName, defaultVal)) + + def OnInitDialog(self): + for name, val in self.autooptions: + self[name] = GetEditorOption(name, val) + + rc = dialog.PropertyPage.OnInitDialog(self) + + idc = win32ui.IDC_TABTIMMY_NONE + if GetEditorOption("Use Tab Timmy", 1): + idc = win32ui.IDC_TABTIMMY_IND + self.GetDlgItem(idc).SetCheck(1) + + idc = win32ui.IDC_RADIO1 + if GetEditorOption("Use Tabs", 0): + idc = win32ui.IDC_USE_TABS + self.GetDlgItem(idc).SetCheck(1) + + tt_color = GetEditorOption("Tab Timmy Color", win32api.RGB(0xFF, 0, 0)) + self.cbo = self.GetDlgItem(win32ui.IDC_COMBO1) + for c in paletteVGA: + self.cbo.AddString(c[0]) + sel = 0 + for c in paletteVGA: + if tt_color == win32api.RGB(c[1], c[2], c[3]): + break + sel = sel + 1 + else: + sel = -1 + self.cbo.SetCurSel(sel) + self.HookCommand(self.OnButSimple, win32ui.IDC_TABTIMMY_NONE) + self.HookCommand(self.OnButSimple, win32ui.IDC_TABTIMMY_IND) + self.HookCommand(self.OnButSimple, win32ui.IDC_TABTIMMY_BG) + # Set ranges for the spinners. + for spinner_id in [win32ui.IDC_SPIN1, win32ui.IDC_SPIN2]: + spinner = self.GetDlgItem(spinner_id) + spinner.SetRange(1, 16) + return rc + + def OnButSimple(self, id, code): + if code == win32con.BN_CLICKED: + self.UpdateUIForState() + + def UpdateUIForState(self): + timmy = self.GetDlgItem(win32ui.IDC_TABTIMMY_NONE).GetCheck() + self.GetDlgItem(win32ui.IDC_COMBO1).EnableWindow(not timmy) + + def OnOK(self): + for name, defVal in self.autooptions: + SetEditorOption(name, self[name]) + + SetEditorOption("Use Tabs", self.GetDlgItem(win32ui.IDC_USE_TABS).GetCheck()) + + SetEditorOption( + "Use Tab Timmy", self.GetDlgItem(win32ui.IDC_TABTIMMY_IND).GetCheck() + ) + c = paletteVGA[self.cbo.GetCurSel()] + SetEditorOption("Tab Timmy Color", win32api.RGB(c[1], c[2], c[3])) + + return 1 + + +def testpp(): + ps = dialog.PropertySheet("Editor Options") + ps.AddPage(EditorWhitespacePropertyPage()) + ps.DoModal() + + +if __name__ == "__main__": + testpp() diff --git a/lib/pythonwin/pywin/framework/editor/document.py b/lib/pythonwin/pywin/framework/editor/document.py new file mode 100644 index 00000000..e66947b8 --- /dev/null +++ b/lib/pythonwin/pywin/framework/editor/document.py @@ -0,0 +1,378 @@ +# We no longer support the old, non-colour editor! + +import os +import shutil +import traceback + +import win32api +import win32con +import win32ui +from pywin.framework.editor import GetEditorOption +from pywin.mfc import docview, object + +BAK_NONE = 0 +BAK_DOT_BAK = 1 +BAK_DOT_BAK_TEMP_DIR = 2 +BAK_DOT_BAK_BAK_DIR = 3 + +MSG_CHECK_EXTERNAL_FILE = ( + win32con.WM_USER + 1999 +) ## WARNING: Duplicated in editor.py and coloreditor.py + +import pywin.scintilla.document + +ParentEditorDocument = pywin.scintilla.document.CScintillaDocument + + +class EditorDocumentBase(ParentEditorDocument): + def __init__(self, template): + self.bAutoReload = GetEditorOption("Auto Reload", 1) + self.bDeclinedReload = 0 # Has the user declined to reload. + self.fileStat = None + self.bReportedFileNotFound = 0 + + # what sort of bak file should I create. + # default to write to %temp%/bak/filename.ext + self.bakFileType = GetEditorOption("Backup Type", BAK_DOT_BAK_BAK_DIR) + + self.watcherThread = FileWatchingThread(self) + self.watcherThread.CreateThread() + # Should I try and use VSS integration? + self.scModuleName = GetEditorOption("Source Control Module", "") + self.scModule = None # Loaded when first used. + ParentEditorDocument.__init__(self, template, template.CreateWin32uiDocument()) + + def OnCloseDocument(self): + self.watcherThread.SignalStop() + return self._obj_.OnCloseDocument() + + # def OnOpenDocument(self, name): + # rc = ParentEditorDocument.OnOpenDocument(self, name) + # self.GetFirstView()._SetLoadedText(self.text) + # self._DocumentStateChanged() + # return rc + + def OnSaveDocument(self, fileName): + win32ui.SetStatusText("Saving file...", 1) + # rename to bak if required. + dir, basename = os.path.split(fileName) + if self.bakFileType == BAK_DOT_BAK: + bakFileName = dir + "\\" + os.path.splitext(basename)[0] + ".bak" + elif self.bakFileType == BAK_DOT_BAK_TEMP_DIR: + bakFileName = ( + win32api.GetTempPath() + "\\" + os.path.splitext(basename)[0] + ".bak" + ) + elif self.bakFileType == BAK_DOT_BAK_BAK_DIR: + tempPath = os.path.join(win32api.GetTempPath(), "bak") + try: + os.mkdir(tempPath, 0) + except os.error: + pass + bakFileName = os.path.join(tempPath, basename) + try: + os.unlink(bakFileName) # raise NameError if no bakups wanted. + except (os.error, NameError): + pass + try: + # Do a copy as it might be on different volumes, + # and the file may be a hard-link, causing the link + # to follow the backup. + shutil.copy2(fileName, bakFileName) + except (os.error, NameError, IOError): + pass + try: + self.SaveFile(fileName) + except IOError as details: + win32ui.MessageBox("Error - could not save file\r\n\r\n%s" % details) + return 0 + except (UnicodeEncodeError, LookupError) as details: + rc = win32ui.MessageBox( + "Encoding failed: \r\n%s" % details + + "\r\nPlease add desired source encoding as first line of file, eg \r\n" + + "# -*- coding: mbcs -*-\r\n\r\n" + + "If you continue, the file will be saved as binary and will\r\n" + + "not be valid in the declared encoding.\r\n\r\n" + + "Save the file as binary with an invalid encoding?", + "File save failed", + win32con.MB_YESNO | win32con.MB_DEFBUTTON2, + ) + if rc == win32con.IDYES: + try: + self.SaveFile(fileName, encoding="latin-1") + except IOError as details: + win32ui.MessageBox( + "Error - could not save file\r\n\r\n%s" % details + ) + return 0 + else: + return 0 + self.SetModifiedFlag(0) # No longer dirty + self.bDeclinedReload = 0 # They probably want to know if it changes again! + win32ui.AddToRecentFileList(fileName) + self.SetPathName(fileName) + win32ui.SetStatusText("Ready") + self._DocumentStateChanged() + return 1 + + def FinalizeViewCreation(self, view): + ParentEditorDocument.FinalizeViewCreation(self, view) + if view == self.GetFirstView(): + self._DocumentStateChanged() + if view.bFolding and GetEditorOption("Fold On Open", 0): + view.FoldTopLevelEvent() + + def HookViewNotifications(self, view): + ParentEditorDocument.HookViewNotifications(self, view) + + # Support for reloading the document from disk - presumably after some + # external application has modified it (or possibly source control has + # checked it out. + def ReloadDocument(self): + """Reloads the document from disk. Assumes the file has + been saved and user has been asked if necessary - it just does it! + """ + win32ui.SetStatusText("Reloading document. Please wait...", 1) + self.SetModifiedFlag(0) + # Loop over all views, saving their state, then reload the document + views = self.GetAllViews() + states = [] + for view in views: + try: + info = view._PrepareUserStateChange() + except AttributeError: # Not our editor view? + info = None + states.append(info) + self.OnOpenDocument(self.GetPathName()) + for view, info in zip(views, states): + if info is not None: + view._EndUserStateChange(info) + self._DocumentStateChanged() + win32ui.SetStatusText("Document reloaded.") + + # Reloading the file + def CheckExternalDocumentUpdated(self): + if self.bDeclinedReload or not self.GetPathName(): + return + try: + newstat = os.stat(self.GetPathName()) + except os.error as exc: + if not self.bReportedFileNotFound: + print( + "The file '%s' is open for editing, but\nchecking it for changes caused the error: %s" + % (self.GetPathName(), exc.strerror) + ) + self.bReportedFileNotFound = 1 + return + if self.bReportedFileNotFound: + print( + "The file '%s' has re-appeared - continuing to watch for changes..." + % (self.GetPathName(),) + ) + self.bReportedFileNotFound = ( + 0 # Once found again we want to start complaining. + ) + changed = ( + (self.fileStat is None) + or self.fileStat[0] != newstat[0] + or self.fileStat[6] != newstat[6] + or self.fileStat[8] != newstat[8] + or self.fileStat[9] != newstat[9] + ) + if changed: + question = None + if self.IsModified(): + question = ( + "%s\r\n\r\nThis file has been modified outside of the source editor.\r\nDo you want to reload it and LOSE THE CHANGES in the source editor?" + % self.GetPathName() + ) + mbStyle = win32con.MB_YESNO | win32con.MB_DEFBUTTON2 # Default to "No" + else: + if not self.bAutoReload: + question = ( + "%s\r\n\r\nThis file has been modified outside of the source editor.\r\nDo you want to reload it?" + % self.GetPathName() + ) + mbStyle = win32con.MB_YESNO # Default to "Yes" + if question: + rc = win32ui.MessageBox(question, None, mbStyle) + if rc != win32con.IDYES: + self.bDeclinedReload = 1 + return + self.ReloadDocument() + + def _DocumentStateChanged(self): + """Called whenever the documents state (on disk etc) has been changed + by the editor (eg, as the result of a save operation) + """ + if self.GetPathName(): + try: + self.fileStat = os.stat(self.GetPathName()) + except os.error: + self.fileStat = None + else: + self.fileStat = None + self.watcherThread._DocumentStateChanged() + self._UpdateUIForState() + self._ApplyOptionalToViews("_UpdateUIForState") + self._ApplyOptionalToViews("SetReadOnly", self._IsReadOnly()) + self._ApplyOptionalToViews("SCISetSavePoint") + # Allow the debugger to reset us too. + import pywin.debugger + + if pywin.debugger.currentDebugger is not None: + pywin.debugger.currentDebugger.UpdateDocumentLineStates(self) + + # Read-only document support - make it obvious to the user + # that the file is read-only. + def _IsReadOnly(self): + return self.fileStat is not None and (self.fileStat[0] & 128) == 0 + + def _UpdateUIForState(self): + """Change the title to reflect the state of the document - + eg ReadOnly, Dirty, etc + """ + filename = self.GetPathName() + if not filename: + return # New file - nothing to do + try: + # This seems necessary so the internal state of the window becomes + # "visible". without it, it is still shown, but certain functions + # (such as updating the title) dont immediately work? + self.GetFirstView().ShowWindow(win32con.SW_SHOW) + title = win32ui.GetFileTitle(filename) + except win32ui.error: + title = filename + if self._IsReadOnly(): + title = title + " (read-only)" + self.SetTitle(title) + + def MakeDocumentWritable(self): + pretend_ss = 0 # Set to 1 to test this without source safe :-) + if not self.scModuleName and not pretend_ss: # No Source Control support. + win32ui.SetStatusText( + "Document is read-only, and no source-control system is configured" + ) + win32api.MessageBeep() + return 0 + + # We have source control support - check if the user wants to use it. + msg = "Would you like to check this file out?" + defButton = win32con.MB_YESNO + if self.IsModified(): + msg = msg + "\r\n\r\nALL CHANGES IN THE EDITOR WILL BE LOST" + defButton = win32con.MB_YESNO + if win32ui.MessageBox(msg, None, defButton) != win32con.IDYES: + return 0 + + if pretend_ss: + print("We are only pretending to check it out!") + win32api.SetFileAttributes( + self.GetPathName(), win32con.FILE_ATTRIBUTE_NORMAL + ) + self.ReloadDocument() + return 1 + + # Now call on the module to do it. + if self.scModule is None: + try: + self.scModule = __import__(self.scModuleName) + for part in self.scModuleName.split(".")[1:]: + self.scModule = getattr(self.scModule, part) + except: + traceback.print_exc() + print("Error loading source control module.") + return 0 + + if self.scModule.CheckoutFile(self.GetPathName()): + self.ReloadDocument() + return 1 + return 0 + + def CheckMakeDocumentWritable(self): + if self._IsReadOnly(): + return self.MakeDocumentWritable() + return 1 + + def SaveModified(self): + # Called as the document is closed. If we are about + # to prompt for a save, bring the document to the foreground. + if self.IsModified(): + frame = self.GetFirstView().GetParentFrame() + try: + frame.MDIActivate() + frame.AutoRestore() + except: + print("Could not bring document to foreground") + return self._obj_.SaveModified() + + +# NOTE - I DONT use the standard threading module, +# as this waits for all threads to terminate at shutdown. +# When using the debugger, it is possible shutdown will +# occur without Pythonwin getting a complete shutdown, +# so we deadlock at the end - threading is waiting for +import pywin.mfc.thread +import win32event + + +class FileWatchingThread(pywin.mfc.thread.WinThread): + def __init__(self, doc): + self.doc = doc + self.adminEvent = win32event.CreateEvent(None, 0, 0, None) + self.stopEvent = win32event.CreateEvent(None, 0, 0, None) + self.watchEvent = None + pywin.mfc.thread.WinThread.__init__(self) + + def _DocumentStateChanged(self): + win32event.SetEvent(self.adminEvent) + + def RefreshEvent(self): + self.hwnd = self.doc.GetFirstView().GetSafeHwnd() + if self.watchEvent is not None: + win32api.FindCloseChangeNotification(self.watchEvent) + self.watchEvent = None + path = self.doc.GetPathName() + if path: + path = os.path.dirname(path) + if path: + filter = ( + win32con.FILE_NOTIFY_CHANGE_FILE_NAME + | win32con.FILE_NOTIFY_CHANGE_ATTRIBUTES + | win32con.FILE_NOTIFY_CHANGE_LAST_WRITE + ) + try: + self.watchEvent = win32api.FindFirstChangeNotification(path, 0, filter) + except win32api.error as exc: + print("Can not watch file", path, "for changes -", exc.strerror) + + def SignalStop(self): + win32event.SetEvent(self.stopEvent) + + def Run(self): + while 1: + handles = [self.stopEvent, self.adminEvent] + if self.watchEvent is not None: + handles.append(self.watchEvent) + rc = win32event.WaitForMultipleObjects(handles, 0, win32event.INFINITE) + if rc == win32event.WAIT_OBJECT_0: + break + elif rc == win32event.WAIT_OBJECT_0 + 1: + self.RefreshEvent() + else: + win32api.PostMessage(self.hwnd, MSG_CHECK_EXTERNAL_FILE, 0, 0) + try: + # If the directory has been removed underneath us, we get this error. + win32api.FindNextChangeNotification(self.watchEvent) + except win32api.error as exc: + print( + "Can not watch file", + self.doc.GetPathName(), + "for changes -", + exc.strerror, + ) + break + + # close a circular reference + self.doc = None + if self.watchEvent: + win32api.FindCloseChangeNotification(self.watchEvent) diff --git a/lib/pythonwin/pywin/framework/editor/editor.py b/lib/pythonwin/pywin/framework/editor/editor.py new file mode 100644 index 00000000..aa1f5385 --- /dev/null +++ b/lib/pythonwin/pywin/framework/editor/editor.py @@ -0,0 +1,516 @@ +##################################################################### +# +# editor.py +# +# A general purpose text editor, built on top of the win32ui edit +# type, which is built on an MFC CEditView +# +# +# We now support reloading of externally modified documented +# (eg, presumably by some other process, such as source control or +# another editor. +# We also suport auto-loading of externally modified files. +# - if the current document has not been modified in this +# editor, but has been modified on disk, then the file +# can be automatically reloaded. +# +# Note that it will _always_ prompt you if the file in the editor has been modified. + + +import re + +import regex +import win32api +import win32con +import win32ui +from pywin.framework.editor import ( + GetEditorFontOption, + GetEditorOption, + SetEditorFontOption, + SetEditorOption, + defaultCharacterFormat, +) +from pywin.mfc import afxres, dialog, docview + +patImport = regex.symcomp("import \(.*\)") +patIndent = regex.compile("^\\([ \t]*[~ \t]\\)") + +ID_LOCATE_FILE = 0xE200 +ID_GOTO_LINE = 0xE2001 +MSG_CHECK_EXTERNAL_FILE = ( + win32con.WM_USER + 1999 +) ## WARNING: Duplicated in document.py and coloreditor.py + +# Key Codes that modify the bufffer when Ctrl or Alt are NOT pressed. +MODIFYING_VK_KEYS = [ + win32con.VK_BACK, + win32con.VK_TAB, + win32con.VK_RETURN, + win32con.VK_SPACE, + win32con.VK_DELETE, +] +for k in range(48, 91): + MODIFYING_VK_KEYS.append(k) + +# Key Codes that modify the bufffer when Ctrl is pressed. +MODIFYING_VK_KEYS_CTRL = [ + win32con.VK_BACK, + win32con.VK_RETURN, + win32con.VK_SPACE, + win32con.VK_DELETE, +] + +# Key Codes that modify the bufffer when Alt is pressed. +MODIFYING_VK_KEYS_ALT = [ + win32con.VK_BACK, + win32con.VK_RETURN, + win32con.VK_SPACE, + win32con.VK_DELETE, +] + + +# The editor itself starts here. +# Using the MFC Document/View model, we have an EditorDocument, which is responsible for +# managing the contents of the file, and a view which is responsible for rendering it. +# +# Due to a limitation in the Windows edit controls, we are limited to one view +# per document, although nothing in this code assumes this (I hope!) + +isRichText = 1 # We are using the Rich Text control. This has not been tested with value "0" for quite some time! + +# ParentEditorDocument=docview.Document +from .document import EditorDocumentBase + +ParentEditorDocument = EditorDocumentBase + + +class EditorDocument(ParentEditorDocument): + # + # File loading and saving operations + # + def OnOpenDocument(self, filename): + # + # handle Unix and PC text file format. + # + + # Get the "long name" of the file name, as it may have been translated + # to short names by the shell. + self.SetPathName(filename) # Must set this early! + # Now do the work! + self.BeginWaitCursor() + win32ui.SetStatusText("Loading file...", 1) + try: + f = open(filename, "rb") + except IOError: + win32ui.MessageBox( + filename + + "\nCan not find this file\nPlease verify that the correct path and file name are given" + ) + self.EndWaitCursor() + return 0 + raw = f.read() + f.close() + contents = self.TranslateLoadedData(raw) + rc = 0 + try: + self.GetFirstView().SetWindowText(contents) + rc = 1 + except TypeError: # Null byte in file. + win32ui.MessageBox("This file contains NULL bytes, and can not be edited") + rc = 0 + + self.EndWaitCursor() + self.SetModifiedFlag(0) # No longer dirty + self._DocumentStateChanged() + return rc + + def TranslateLoadedData(self, data): + """Given raw data read from a file, massage it suitable for the edit window""" + # if a CR in the first 250 chars, then perform the expensive translate + if data[:250].find("\r") == -1: + win32ui.SetStatusText( + "Translating from Unix file format - please wait...", 1 + ) + return re.sub("\r*\n", "\r\n", data) + else: + return data + + def SaveFile(self, fileName, encoding=None): + if isRichText: + view = self.GetFirstView() + view.SaveTextFile(fileName, encoding=encoding) + else: # Old style edit view window. + self.GetFirstView().SaveFile(fileName) + try: + # Make sure line cache has updated info about me! + import linecache + + linecache.checkcache() + except: + pass + + # + # Color state stuff + # + def SetAllLineColors(self, color=None): + for view in self.GetAllViews(): + view.SetAllLineColors(color) + + def SetLineColor(self, lineNo, color): + "Color a line of all views" + for view in self.GetAllViews(): + view.SetLineColor(lineNo, color) + + +# def StreamTextOut(self, data): ### This seems unreliable??? +# self.saveFileHandle.write(data) +# return 1 # keep em coming! + +# ParentEditorView=docview.EditView +ParentEditorView = docview.RichEditView + + +class EditorView(ParentEditorView): + def __init__(self, doc): + ParentEditorView.__init__(self, doc) + if isRichText: + self.SetWordWrap(win32ui.CRichEditView_WrapNone) + + self.addToMRU = 1 + self.HookHandlers() + self.bCheckingFile = 0 + + self.defCharFormat = GetEditorFontOption("Default Font", defaultCharacterFormat) + + # Smart tabs override everything else if context can be worked out. + self.bSmartTabs = GetEditorOption("Smart Tabs", 1) + + self.tabSize = GetEditorOption("Tab Size", 8) + self.indentSize = GetEditorOption("Indent Size", 8) + # If next indent is at a tab position, and useTabs is set, a tab will be inserted. + self.bUseTabs = GetEditorOption("Use Tabs", 1) + + def OnInitialUpdate(self): + rc = self._obj_.OnInitialUpdate() + self.SetDefaultCharFormat(self.defCharFormat) + return rc + + def CutCurLine(self): + curLine = self._obj_.LineFromChar() + nextLine = curLine + 1 + start = self._obj_.LineIndex(curLine) + end = self._obj_.LineIndex(nextLine) + if end == 0: # must be last line. + end = start + self.end.GetLineLength(curLine) + self._obj_.SetSel(start, end) + self._obj_.Cut() + + def _PrepareUserStateChange(self): + "Return selection, lineindex, etc info, so it can be restored" + self.SetRedraw(0) + return self.GetModify(), self.GetSel(), self.GetFirstVisibleLine() + + def _EndUserStateChange(self, info): + scrollOff = info[2] - self.GetFirstVisibleLine() + if scrollOff: + self.LineScroll(scrollOff) + self.SetSel(info[1]) + self.SetModify(info[0]) + self.SetRedraw(1) + self.InvalidateRect() + self.UpdateWindow() + + def _UpdateUIForState(self): + self.SetReadOnly(self.GetDocument()._IsReadOnly()) + + def SetAllLineColors(self, color=None): + if isRichText: + info = self._PrepareUserStateChange() + try: + if color is None: + color = self.defCharFormat[4] + self.SetSel(0, -1) + self.SetSelectionCharFormat((win32con.CFM_COLOR, 0, 0, 0, color)) + finally: + self._EndUserStateChange(info) + + def SetLineColor(self, lineNo, color): + "lineNo is the 1 based line number to set. If color is None, default color is used." + if isRichText: + info = self._PrepareUserStateChange() + try: + if color is None: + color = self.defCharFormat[4] + lineNo = lineNo - 1 + startIndex = self.LineIndex(lineNo) + if startIndex != -1: + self.SetSel(startIndex, self.LineIndex(lineNo + 1)) + self.SetSelectionCharFormat((win32con.CFM_COLOR, 0, 0, 0, color)) + finally: + self._EndUserStateChange(info) + + def Indent(self): + """Insert an indent to move the cursor to the next tab position. + + Honors the tab size and 'use tabs' settings. Assumes the cursor is already at the + position to be indented, and the selection is a single character (ie, not a block) + """ + start, end = self._obj_.GetSel() + startLine = self._obj_.LineFromChar(start) + line = self._obj_.GetLine(startLine) + realCol = start - self._obj_.LineIndex(startLine) + # Calulate the next tab stop. + # Expand existing tabs. + curCol = 0 + for ch in line[:realCol]: + if ch == "\t": + curCol = ((curCol / self.tabSize) + 1) * self.tabSize + else: + curCol = curCol + 1 + nextColumn = ((curCol / self.indentSize) + 1) * self.indentSize + # print "curCol is", curCol, "nextColumn is", nextColumn + ins = None + if self.bSmartTabs: + # Look for some context. + if realCol == 0: # Start of the line - see if the line above can tell us + lookLine = startLine - 1 + while lookLine >= 0: + check = self._obj_.GetLine(lookLine)[0:1] + if check in ("\t", " "): + ins = check + break + lookLine = lookLine - 1 + else: # See if the previous char can tell us + check = line[realCol - 1] + if check in ("\t", " "): + ins = check + + # Either smart tabs off, or not smart enough! + # Use the "old style" settings. + if ins is None: + if self.bUseTabs and nextColumn % self.tabSize == 0: + ins = "\t" + else: + ins = " " + + if ins == " ": + # Calc the number of spaces to take us to the next stop + ins = ins * (nextColumn - curCol) + + self._obj_.ReplaceSel(ins) + + def BlockDent(self, isIndent, startLine, endLine): + "Indent/Undent all lines specified" + if not self.GetDocument().CheckMakeDocumentWritable(): + return 0 + tabSize = self.tabSize # hard-code for now! + info = self._PrepareUserStateChange() + try: + for lineNo in range(startLine, endLine): + pos = self._obj_.LineIndex(lineNo) + self._obj_.SetSel(pos, pos) + if isIndent: + self.Indent() + else: + line = self._obj_.GetLine(lineNo) + try: + noToDel = 0 + if line[0] == "\t": + noToDel = 1 + elif line[0] == " ": + for noToDel in range(0, tabSize): + if line[noToDel] != " ": + break + else: + noToDel = tabSize + if noToDel: + self._obj_.SetSel(pos, pos + noToDel) + self._obj_.Clear() + except IndexError: + pass + finally: + self._EndUserStateChange(info) + self.GetDocument().SetModifiedFlag(1) # Now dirty + self._obj_.SetSel(self.LineIndex(startLine), self.LineIndex(endLine)) + + def GotoLine(self, lineNo=None): + try: + if lineNo is None: + lineNo = int(input("Enter Line Number")) + except (ValueError, KeyboardInterrupt): + return 0 + self.GetLineCount() # Seems to be needed when file first opened??? + charNo = self.LineIndex(lineNo - 1) + self.SetSel(charNo) + + def HookHandlers(self): # children can override, but should still call me! + # self.HookAllKeyStrokes(self.OnKey) + self.HookMessage(self.OnCheckExternalDocumentUpdated, MSG_CHECK_EXTERNAL_FILE) + self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN) + self.HookMessage(self.OnSetFocus, win32con.WM_SETFOCUS) + self.HookMessage(self.OnKeyDown, win32con.WM_KEYDOWN) + self.HookKeyStroke(self.OnKeyCtrlY, 25) # ^Y + self.HookKeyStroke(self.OnKeyCtrlG, 7) # ^G + self.HookKeyStroke(self.OnKeyTab, 9) # TAB + self.HookKeyStroke(self.OnKeyEnter, 13) # Enter + self.HookCommand(self.OnCmdLocateFile, ID_LOCATE_FILE) + self.HookCommand(self.OnCmdGotoLine, ID_GOTO_LINE) + self.HookCommand(self.OnEditPaste, afxres.ID_EDIT_PASTE) + self.HookCommand(self.OnEditCut, afxres.ID_EDIT_CUT) + + # Hook Handlers + def OnSetFocus(self, msg): + # Even though we use file change notifications, we should be very sure about it here. + self.OnCheckExternalDocumentUpdated(msg) + + def OnRClick(self, params): + menu = win32ui.CreatePopupMenu() + + # look for a module name + line = self._obj_.GetLine().strip() + flags = win32con.MF_STRING | win32con.MF_ENABLED + if patImport.match(line) == len(line): + menu.AppendMenu( + flags, ID_LOCATE_FILE, "&Locate %s.py" % patImport.group("name") + ) + menu.AppendMenu(win32con.MF_SEPARATOR) + menu.AppendMenu(flags, win32ui.ID_EDIT_UNDO, "&Undo") + menu.AppendMenu(win32con.MF_SEPARATOR) + menu.AppendMenu(flags, win32ui.ID_EDIT_CUT, "Cu&t") + menu.AppendMenu(flags, win32ui.ID_EDIT_COPY, "&Copy") + menu.AppendMenu(flags, win32ui.ID_EDIT_PASTE, "&Paste") + menu.AppendMenu(flags, win32con.MF_SEPARATOR) + menu.AppendMenu(flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all") + menu.AppendMenu(flags, win32con.MF_SEPARATOR) + menu.AppendMenu(flags, ID_GOTO_LINE, "&Goto line...") + menu.TrackPopupMenu(params[5]) + return 0 + + def OnCmdGotoLine(self, cmd, code): + self.GotoLine() + return 0 + + def OnCmdLocateFile(self, cmd, code): + modName = patImport.group("name") + if not modName: + return 0 + import pywin.framework.scriptutils + + fileName = pywin.framework.scriptutils.LocatePythonFile(modName) + if fileName is None: + win32ui.SetStatusText("Can't locate module %s" % modName) + else: + win32ui.GetApp().OpenDocumentFile(fileName) + return 0 + + # Key handlers + def OnKeyEnter(self, key): + if not self.GetDocument().CheckMakeDocumentWritable(): + return 0 + curLine = self._obj_.GetLine() + self._obj_.ReplaceSel("\r\n") # insert the newline + # If the current line indicates the next should be indented, + # then copy the current indentation to this line. + res = patIndent.match(curLine, 0) + if res > 0 and curLine.strip(): + curIndent = patIndent.group(1) + self._obj_.ReplaceSel(curIndent) + return 0 # dont pass on + + def OnKeyCtrlY(self, key): + if not self.GetDocument().CheckMakeDocumentWritable(): + return 0 + self.CutCurLine() + return 0 # dont let him have it! + + def OnKeyCtrlG(self, key): + self.GotoLine() + return 0 # dont let him have it! + + def OnKeyTab(self, key): + if not self.GetDocument().CheckMakeDocumentWritable(): + return 0 + start, end = self._obj_.GetSel() + if start == end: # normal TAB key + self.Indent() + return 0 # we handled this. + + # Otherwise it is a block indent/dedent. + if start > end: + start, end = end, start # swap them. + startLine = self._obj_.LineFromChar(start) + endLine = self._obj_.LineFromChar(end) + + self.BlockDent(win32api.GetKeyState(win32con.VK_SHIFT) >= 0, startLine, endLine) + return 0 + + def OnEditPaste(self, id, code): + # Return 1 if we can make the file editable.(or it already is!) + return self.GetDocument().CheckMakeDocumentWritable() + + def OnEditCut(self, id, code): + # Return 1 if we can make the file editable.(or it already is!) + return self.GetDocument().CheckMakeDocumentWritable() + + def OnKeyDown(self, msg): + key = msg[2] + if win32api.GetKeyState(win32con.VK_CONTROL) & 0x8000: + modList = MODIFYING_VK_KEYS_CTRL + elif win32api.GetKeyState(win32con.VK_MENU) & 0x8000: + modList = MODIFYING_VK_KEYS_ALT + else: + modList = MODIFYING_VK_KEYS + + if key in modList: + # Return 1 if we can make the file editable.(or it already is!) + return self.GetDocument().CheckMakeDocumentWritable() + return 1 # Pass it on OK + + # def OnKey(self, key): + # return self.GetDocument().CheckMakeDocumentWritable() + + def OnCheckExternalDocumentUpdated(self, msg): + if self._obj_ is None or self.bCheckingFile: + return + self.bCheckingFile = 1 + self.GetDocument().CheckExternalDocumentUpdated() + self.bCheckingFile = 0 + + +from .template import EditorTemplateBase + + +class EditorTemplate(EditorTemplateBase): + def __init__( + self, res=win32ui.IDR_TEXTTYPE, makeDoc=None, makeFrame=None, makeView=None + ): + if makeDoc is None: + makeDoc = EditorDocument + if makeView is None: + makeView = EditorView + EditorTemplateBase.__init__(self, res, makeDoc, makeFrame, makeView) + + def _CreateDocTemplate(self, resourceId): + return win32ui.CreateRichEditDocTemplate(resourceId) + + def CreateWin32uiDocument(self): + return self.DoCreateRichEditDoc() + + +def Create(fileName=None, title=None, template=None): + return editorTemplate.OpenDocumentFile(fileName) + + +from pywin.framework.editor import GetDefaultEditorModuleName + +prefModule = GetDefaultEditorModuleName() +# Initialize only if this is the "default" editor. +if __name__ == prefModule: + # For debugging purposes, when this module may be reloaded many times. + try: + win32ui.GetApp().RemoveDocTemplate(editorTemplate) + except (NameError, win32ui.error): + pass + + editorTemplate = EditorTemplate() + win32ui.GetApp().AddDocTemplate(editorTemplate) diff --git a/lib/pythonwin/pywin/framework/editor/frame.py b/lib/pythonwin/pywin/framework/editor/frame.py new file mode 100644 index 00000000..e927d16e --- /dev/null +++ b/lib/pythonwin/pywin/framework/editor/frame.py @@ -0,0 +1,74 @@ +# frame.py - The MDI frame window for an editor. +import pywin.framework.window +import win32con +import win32ui + +from . import ModuleBrowser + + +class EditorFrame(pywin.framework.window.MDIChildWnd): + def OnCreateClient(self, cp, context): + # Create the default view as specified by the template (ie, the editor view) + view = context.template.MakeView(context.doc) + # Create the browser view. + browserView = ModuleBrowser.BrowserView(context.doc) + view2 = context.template.MakeView(context.doc) + + splitter = win32ui.CreateSplitter() + style = win32con.WS_CHILD | win32con.WS_VISIBLE + splitter.CreateStatic(self, 1, 2, style, win32ui.AFX_IDW_PANE_FIRST) + sub_splitter = self.sub_splitter = win32ui.CreateSplitter() + sub_splitter.CreateStatic(splitter, 2, 1, style, win32ui.AFX_IDW_PANE_FIRST + 1) + + # Note we must add the default view first, so that doc.GetFirstView() returns the editor view. + sub_splitter.CreateView(view, 1, 0, (0, 0)) + splitter.CreateView(browserView, 0, 0, (0, 0)) + sub_splitter.CreateView(view2, 0, 0, (0, 0)) + + ## print "First view is", context.doc.GetFirstView() + ## print "Views are", view, view2, browserView + ## print "Parents are", view.GetParent(), view2.GetParent(), browserView.GetParent() + ## print "Splitter is", splitter + ## print "sub splitter is", sub_splitter + ## Old + ## splitter.CreateStatic (self, 1, 2) + ## splitter.CreateView(view, 0, 1, (0,0)) # size ignored. + ## splitter.CreateView (browserView, 0, 0, (0, 0)) + + # Restrict the size of the browser splitter (and we can avoid filling + # it until it is shown) + splitter.SetColumnInfo(0, 10, 20) + # And the active view is our default view (so it gets initial focus) + self.SetActiveView(view) + + def GetEditorView(self): + # In a multi-view (eg, splitter) environment, get + # an editor (ie, scintilla) view + # Look for the splitter opened the most! + if self.sub_splitter is None: + return self.GetDlgItem(win32ui.AFX_IDW_PANE_FIRST) + v1 = self.sub_splitter.GetPane(0, 0) + v2 = self.sub_splitter.GetPane(1, 0) + r1 = v1.GetWindowRect() + r2 = v2.GetWindowRect() + if r1[3] - r1[1] > r2[3] - r2[1]: + return v1 + return v2 + + def GetBrowserView(self): + # XXX - should fix this :-) + return self.GetActiveDocument().GetAllViews()[1] + + def OnClose(self): + doc = self.GetActiveDocument() + if not doc.SaveModified(): + ## Cancel button selected from Save dialog, do not actually close + ## print 'close cancelled' + return 0 + ## So the 'Save' dialog doesn't come up twice + doc._obj_.SetModifiedFlag(False) + + # Must force the module browser to close itself here (OnDestroy for the view itself is too late!) + self.sub_splitter = None # ensure no circles! + self.GetBrowserView().DestroyBrowser() + return self._obj_.OnClose() diff --git a/lib/pythonwin/pywin/framework/editor/template.py b/lib/pythonwin/pywin/framework/editor/template.py new file mode 100644 index 00000000..362a74a6 --- /dev/null +++ b/lib/pythonwin/pywin/framework/editor/template.py @@ -0,0 +1,60 @@ +import os + +import pywin.framework.window +import win32api +import win32ui +from pywin.mfc import docview + +from . import frame + +ParentEditorTemplate = docview.DocTemplate + + +class EditorTemplateBase(ParentEditorTemplate): + def __init__( + self, res=win32ui.IDR_TEXTTYPE, makeDoc=None, makeFrame=None, makeView=None + ): + if makeFrame is None: + makeFrame = frame.EditorFrame + ParentEditorTemplate.__init__(self, res, makeDoc, makeFrame, makeView) + + def _CreateDocTemplate(self, resourceId): + assert 0, "You must override this" + + def CreateWin32uiDocument(self): + assert 0, "You must override this" + + def GetFileExtensions(self): + return ".txt", ".py" + + def MatchDocType(self, fileName, fileType): + doc = self.FindOpenDocument(fileName) + if doc: + return doc + ext = os.path.splitext(fileName)[1].lower() + if ext in self.GetFileExtensions(): + return win32ui.CDocTemplate_Confidence_yesAttemptNative + return win32ui.CDocTemplate_Confidence_maybeAttemptForeign + + def InitialUpdateFrame(self, frame, doc, makeVisible=1): + self._obj_.InitialUpdateFrame(frame, doc, makeVisible) # call default handler. + doc._UpdateUIForState() + + def GetPythonPropertyPages(self): + """Returns a list of property pages""" + from . import configui + + return [configui.EditorPropertyPage(), configui.EditorWhitespacePropertyPage()] + + def OpenDocumentFile(self, filename, bMakeVisible=1): + if filename is not None: + try: + path = os.path.split(filename)[0] + # print "The editor is translating", `filename`,"to", + filename = win32api.FindFiles(filename)[0][8] + filename = os.path.join(path, filename) + # print `filename` + except (win32api.error, IndexError) as details: + pass + # print "Couldnt get the full filename!", details + return self._obj_.OpenDocumentFile(filename, bMakeVisible) diff --git a/lib/pythonwin/pywin/framework/editor/vss.py b/lib/pythonwin/pywin/framework/editor/vss.py new file mode 100644 index 00000000..718f83ee --- /dev/null +++ b/lib/pythonwin/pywin/framework/editor/vss.py @@ -0,0 +1,104 @@ +# vss.py -- Source Control using Microsoft VSS. + +# Provides routines for checking files out of VSS. +# +# Uses an INI file very similar to how VB integrates with VSS - even +# as far as using the same name. + +# The file must be named "Mssccprj.scc", and be in the format of +# an INI file. This file may be in a parent directory, in which +# case the project name will be built from what is specified in the +# ini file, plus the path from the INI file to the file itself. +# +# The INI file should have a [Python] section, and a +# Project=Project Name +# and optionally +# Database=?? + + +import os +import sys +import traceback + +import win32api +import win32ui + +g_iniName = "Mssccprj.scc" # Use the same INI name as VB! + +g_sourceSafe = None + + +def FindVssProjectInfo(fullfname): + """Looks up the file system for an INI file describing the project. + + Looking up the tree is for ni style packages. + + Returns (projectName, pathToFileName) where pathToFileName contains + the path from the ini file to the actual file. + """ + path, fnameonly = os.path.split(fullfname) + origPath = path + project = "" + retPaths = [fnameonly] + while not project: + iniName = os.path.join(path, g_iniName) + database = win32api.GetProfileVal("Python", "Database", "", iniName) + project = win32api.GetProfileVal("Python", "Project", "", iniName) + if project: + break + # No valid INI file in this directory - look up a level. + path, addpath = os.path.split(path) + if not addpath: # Root? + break + retPaths.insert(0, addpath) + if not project: + win32ui.MessageBox( + "%s\r\n\r\nThis directory is not configured for Python/VSS" % origPath + ) + return + return project, "/".join(retPaths), database + + +def CheckoutFile(fileName): + global g_sourceSafe + import pythoncom + + ok = 0 + # Assumes the fileName has a complete path, + # and that the INI file can be found in that path + # (or a parent path if a ni style package) + try: + import win32com.client + import win32com.client.gencache + + mod = win32com.client.gencache.EnsureModule( + "{783CD4E0-9D54-11CF-B8EE-00608CC9A71F}", 0, 5, 0 + ) + if mod is None: + win32ui.MessageBox( + "VSS does not appear to be installed. The TypeInfo can not be created" + ) + return ok + + rc = FindVssProjectInfo(fileName) + if rc is None: + return + project, vssFname, database = rc + if g_sourceSafe is None: + g_sourceSafe = win32com.client.Dispatch("SourceSafe") + # SS seems a bit wierd. It defaults the arguments as empty strings, but + # then complains when they are used - so we pass "Missing" + if not database: + database = pythoncom.Missing + g_sourceSafe.Open(database, pythoncom.Missing, pythoncom.Missing) + item = g_sourceSafe.VSSItem("$/%s/%s" % (project, vssFname)) + item.Checkout(None, fileName) + ok = 1 + except pythoncom.com_error as exc: + win32ui.MessageBox(exc.strerror, "Error checking out file") + except: + typ, val, tb = sys.exc_info() + traceback.print_exc() + win32ui.MessageBox("%s - %s" % (str(typ), str(val)), "Error checking out file") + tb = None # Cleanup a cycle + return ok diff --git a/lib/pythonwin/pywin/framework/help.py b/lib/pythonwin/pywin/framework/help.py new file mode 100644 index 00000000..ab664b4d --- /dev/null +++ b/lib/pythonwin/pywin/framework/help.py @@ -0,0 +1,173 @@ +# help.py - help utilities for PythonWin. +import os + +import regutil +import win32api +import win32con +import win32ui + +htmlhelp_handle = None + +html_help_command_translators = { + win32con.HELP_CONTENTS: 1, # HH_DISPLAY_TOC + win32con.HELP_CONTEXT: 15, # HH_HELP_CONTEXT + win32con.HELP_FINDER: 1, # HH_DISPLAY_TOC +} + + +def FinalizeHelp(): + global htmlhelp_handle + if htmlhelp_handle is not None: + import win32help + + try: + # frame = win32ui.GetMainFrame().GetSafeHwnd() + frame = 0 + win32help.HtmlHelp(frame, None, win32help.HH_UNINITIALIZE, htmlhelp_handle) + except win32help.error: + print("Failed to finalize htmlhelp!") + htmlhelp_handle = None + + +def OpenHelpFile(fileName, helpCmd=None, helpArg=None): + "Open a help file, given a full path" + # default help arg. + win32ui.DoWaitCursor(1) + try: + if helpCmd is None: + helpCmd = win32con.HELP_CONTENTS + ext = os.path.splitext(fileName)[1].lower() + if ext == ".hlp": + win32api.WinHelp( + win32ui.GetMainFrame().GetSafeHwnd(), fileName, helpCmd, helpArg + ) + # XXX - using the htmlhelp API wreaks havoc with keyboard shortcuts + # so we disable it, forcing ShellExecute, which works fine (but + # doesn't close the help file when Pythonwin is closed. + # Tom Heller also points out http://www.microsoft.com/mind/0499/faq/faq0499.asp, + # which may or may not be related. + elif 0 and ext == ".chm": + import win32help + + global htmlhelp_handle + helpCmd = html_help_command_translators.get(helpCmd, helpCmd) + # frame = win32ui.GetMainFrame().GetSafeHwnd() + frame = 0 # Dont want it overlapping ours! + if htmlhelp_handle is None: + htmlhelp_hwnd, htmlhelp_handle = win32help.HtmlHelp( + frame, None, win32help.HH_INITIALIZE + ) + win32help.HtmlHelp(frame, fileName, helpCmd, helpArg) + else: + # Hope that the extension is registered, and we know what to do! + win32api.ShellExecute(0, "open", fileName, None, "", win32con.SW_SHOW) + return fileName + finally: + win32ui.DoWaitCursor(-1) + + +def ListAllHelpFiles(): + ret = [] + ret = _ListAllHelpFilesInRoot(win32con.HKEY_LOCAL_MACHINE) + # Ensure we don't get dups. + for item in _ListAllHelpFilesInRoot(win32con.HKEY_CURRENT_USER): + if item not in ret: + ret.append(item) + return ret + + +def _ListAllHelpFilesInRoot(root): + """Returns a list of (helpDesc, helpFname) for all registered help files""" + import regutil + + retList = [] + try: + key = win32api.RegOpenKey( + root, regutil.BuildDefaultPythonKey() + "\\Help", 0, win32con.KEY_READ + ) + except win32api.error as exc: + import winerror + + if exc.winerror != winerror.ERROR_FILE_NOT_FOUND: + raise + return retList + try: + keyNo = 0 + while 1: + try: + helpDesc = win32api.RegEnumKey(key, keyNo) + helpFile = win32api.RegQueryValue(key, helpDesc) + retList.append((helpDesc, helpFile)) + keyNo = keyNo + 1 + except win32api.error as exc: + import winerror + + if exc.winerror != winerror.ERROR_NO_MORE_ITEMS: + raise + break + finally: + win32api.RegCloseKey(key) + return retList + + +def SelectAndRunHelpFile(): + from pywin.dialogs import list + + helpFiles = ListAllHelpFiles() + if len(helpFiles) == 1: + # only 1 help file registered - probably ours - no point asking + index = 0 + else: + index = list.SelectFromLists("Select Help file", helpFiles, ["Title"]) + if index is not None: + OpenHelpFile(helpFiles[index][1]) + + +helpIDMap = None + + +def SetHelpMenuOtherHelp(mainMenu): + """Modifies the main Help Menu to handle all registered help files. + mainMenu -- The main menu to modify - usually from docTemplate.GetSharedMenu() + """ + + # Load all help files from the registry. + global helpIDMap + if helpIDMap is None: + helpIDMap = {} + cmdID = win32ui.ID_HELP_OTHER + excludeList = ["Main Python Documentation", "Pythonwin Reference"] + firstList = ListAllHelpFiles() + # We actually want to not only exclude these entries, but + # their help file names (as many entries may share the same name) + excludeFnames = [] + for desc, fname in firstList: + if desc in excludeList: + excludeFnames.append(fname) + + helpDescs = [] + for desc, fname in firstList: + if fname not in excludeFnames: + helpIDMap[cmdID] = (desc, fname) + win32ui.GetMainFrame().HookCommand(HandleHelpOtherCommand, cmdID) + cmdID = cmdID + 1 + + helpMenu = mainMenu.GetSubMenu( + mainMenu.GetMenuItemCount() - 1 + ) # Help menu always last. + otherHelpMenuPos = 2 # cant search for ID, as sub-menu has no ID. + otherMenu = helpMenu.GetSubMenu(otherHelpMenuPos) + while otherMenu.GetMenuItemCount(): + otherMenu.DeleteMenu(0, win32con.MF_BYPOSITION) + + if helpIDMap: + for id, (desc, fname) in helpIDMap.items(): + otherMenu.AppendMenu(win32con.MF_ENABLED | win32con.MF_STRING, id, desc) + else: + helpMenu.EnableMenuItem( + otherHelpMenuPos, win32con.MF_BYPOSITION | win32con.MF_GRAYED + ) + + +def HandleHelpOtherCommand(cmd, code): + OpenHelpFile(helpIDMap[cmd][1]) diff --git a/lib/pythonwin/pywin/framework/interact.py b/lib/pythonwin/pywin/framework/interact.py new file mode 100644 index 00000000..5f0b87f2 --- /dev/null +++ b/lib/pythonwin/pywin/framework/interact.py @@ -0,0 +1,985 @@ +################################################################## +## +## Interactive Shell Window +## + +import array +import code +import os +import string +import sys +import traceback + +import __main__ +import afxres +import pywin.framework.app +import pywin.scintilla.control +import pywin.scintilla.formatter +import pywin.scintilla.IDLEenvironment +import win32api +import win32clipboard +import win32con +import win32ui + +## sequential after ID_GOTO_LINE defined in editor.py +ID_EDIT_COPY_CODE = 0xE2002 +ID_EDIT_EXEC_CLIPBOARD = 0x2003 + +trace = pywin.scintilla.formatter.trace + +import re + +from . import winout + +# from IDLE. +_is_block_opener = re.compile(r":\s*(#.*)?$").search +_is_block_closer = re.compile( + r""" + \s* + ( return + | break + | continue + | raise + | pass + ) + \b +""", + re.VERBOSE, +).match + +tracebackHeader = "Traceback (".encode("ascii") + +sectionProfile = "Interactive Window" +valueFormatTitle = "FormatTitle" +valueFormatInput = "FormatInput" +valueFormatOutput = "FormatOutput" +valueFormatOutputError = "FormatOutputError" + +# These are defaults only. Values are read from the registry. +formatTitle = (-536870897, 0, 220, 0, 16711680, 184, 34, "Arial") +formatInput = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New") +formatOutput = (-402653169, 0, 200, 0, 8421376, 0, 49, "Courier New") +formatOutputError = (-402653169, 0, 200, 0, 255, 0, 49, "Courier New") + +try: + sys.ps1 +except AttributeError: + sys.ps1 = ">>> " + sys.ps2 = "... " + + +def LoadPreference(preference, default=""): + return win32ui.GetProfileVal(sectionProfile, preference, default) + + +def SavePreference(prefName, prefValue): + win32ui.WriteProfileVal(sectionProfile, prefName, prefValue) + + +def GetPromptPrefix(line): + ps1 = sys.ps1 + if line[: len(ps1)] == ps1: + return ps1 + ps2 = sys.ps2 + if line[: len(ps2)] == ps2: + return ps2 + + +############################################################# +# +# Colorizer related code. +# +############################################################# +STYLE_INTERACTIVE_EOL = "Interactive EOL" +STYLE_INTERACTIVE_OUTPUT = "Interactive Output" +STYLE_INTERACTIVE_PROMPT = "Interactive Prompt" +STYLE_INTERACTIVE_BANNER = "Interactive Banner" +STYLE_INTERACTIVE_ERROR = "Interactive Error" +STYLE_INTERACTIVE_ERROR_FINALLINE = "Interactive Error (final line)" + +INTERACTIVE_STYLES = [ + STYLE_INTERACTIVE_EOL, + STYLE_INTERACTIVE_OUTPUT, + STYLE_INTERACTIVE_PROMPT, + STYLE_INTERACTIVE_BANNER, + STYLE_INTERACTIVE_ERROR, + STYLE_INTERACTIVE_ERROR_FINALLINE, +] + +FormatterParent = pywin.scintilla.formatter.PythonSourceFormatter + + +class InteractiveFormatter(FormatterParent): + def __init__(self, scintilla): + FormatterParent.__init__(self, scintilla) + self.bannerDisplayed = False + + def SetStyles(self): + FormatterParent.SetStyles(self) + Style = pywin.scintilla.formatter.Style + self.RegisterStyle(Style(STYLE_INTERACTIVE_EOL, STYLE_INTERACTIVE_PROMPT)) + self.RegisterStyle(Style(STYLE_INTERACTIVE_PROMPT, formatInput)) + self.RegisterStyle(Style(STYLE_INTERACTIVE_OUTPUT, formatOutput)) + self.RegisterStyle(Style(STYLE_INTERACTIVE_BANNER, formatTitle)) + self.RegisterStyle(Style(STYLE_INTERACTIVE_ERROR, formatOutputError)) + self.RegisterStyle( + Style(STYLE_INTERACTIVE_ERROR_FINALLINE, STYLE_INTERACTIVE_ERROR) + ) + + def LoadPreference(self, name, default): + rc = win32ui.GetProfileVal("Format", name, default) + if rc == default: + rc = win32ui.GetProfileVal(sectionProfile, name, default) + return rc + + def ColorizeInteractiveCode(self, cdoc, styleStart, stylePyStart): + lengthDoc = len(cdoc) + if lengthDoc == 0: + return + state = styleStart + # As per comments in Colorize(), we work with the raw utf8 + # bytes. To avoid too muych py3k pain, we treat each utf8 byte + # as a latin-1 unicode character - we only use it to compare + # against ascii chars anyway... + chNext = cdoc[0:1].decode("latin-1") + startSeg = 0 + i = 0 + lastState = state # debug only + while i < lengthDoc: + ch = chNext + chNext = cdoc[i + 1 : i + 2].decode("latin-1") + + # trace("ch=%r, i=%d, next=%r, state=%s" % (ch, i, chNext, state)) + if state == STYLE_INTERACTIVE_EOL: + if ch not in "\r\n": + self.ColorSeg(startSeg, i - 1, state) + startSeg = i + if ch in (sys.ps1[0], sys.ps2[0]): + state = STYLE_INTERACTIVE_PROMPT + elif cdoc[i : i + len(tracebackHeader)] == tracebackHeader: + state = STYLE_INTERACTIVE_ERROR + else: + state = STYLE_INTERACTIVE_OUTPUT + elif state == STYLE_INTERACTIVE_PROMPT: + if ch not in sys.ps1 + sys.ps2 + " ": + self.ColorSeg(startSeg, i - 1, state) + startSeg = i + if ch in "\r\n": + state = STYLE_INTERACTIVE_EOL + else: + state = stylePyStart # Start coloring Python code. + elif state in (STYLE_INTERACTIVE_OUTPUT,): + if ch in "\r\n": + self.ColorSeg(startSeg, i - 1, state) + startSeg = i + state = STYLE_INTERACTIVE_EOL + elif state == STYLE_INTERACTIVE_ERROR: + if ch in "\r\n" and chNext and chNext not in string.whitespace: + # Everything including me + self.ColorSeg(startSeg, i, state) + startSeg = i + 1 + state = STYLE_INTERACTIVE_ERROR_FINALLINE + elif i == 0 and ch not in string.whitespace: + # If we are coloring from the start of a line, + # we need this better check for the last line + # Color up to not including me + self.ColorSeg(startSeg, i - 1, state) + startSeg = i + state = STYLE_INTERACTIVE_ERROR_FINALLINE + elif state == STYLE_INTERACTIVE_ERROR_FINALLINE: + if ch in "\r\n": + self.ColorSeg(startSeg, i - 1, state) + startSeg = i + state = STYLE_INTERACTIVE_EOL + elif state == STYLE_INTERACTIVE_BANNER: + if ch in "\r\n" and (chNext == "" or chNext in ">["): + # Everything including me + self.ColorSeg(startSeg, i - 1, state) + startSeg = i + state = STYLE_INTERACTIVE_EOL + else: + # It is a PythonColorizer state - seek past the end of the line + # and ask the Python colorizer to color that. + end = startSeg + while end < lengthDoc and cdoc[end] not in "\r\n".encode("ascii"): + end = end + 1 + self.ColorizePythonCode(cdoc[:end], startSeg, state) + stylePyStart = self.GetStringStyle(end - 1) + if stylePyStart is None: + stylePyStart = pywin.scintilla.formatter.STYLE_DEFAULT + else: + stylePyStart = stylePyStart.name + startSeg = end + i = end - 1 # ready for increment. + chNext = cdoc[end : end + 1].decode("latin-1") + state = STYLE_INTERACTIVE_EOL + if lastState != state: + lastState = state + i = i + 1 + # and the rest + if startSeg < i: + self.ColorSeg(startSeg, i - 1, state) + + def Colorize(self, start=0, end=-1): + # scintilla's formatting is all done in terms of utf, so + # we work with utf8 bytes instead of unicode. This magically + # works as any extended chars found in the utf8 don't change + # the semantics. + stringVal = self.scintilla.GetTextRange(start, end, decode=False) + styleStart = None + stylePyStart = None + if start > 1: + # Likely we are being asked to color from the start of the line. + # We find the last formatted character on the previous line. + # If TQString, we continue it. Otherwise, we reset. + look = start - 1 + while look and self.scintilla.SCIGetCharAt(look) in "\n\r": + look = look - 1 + if look and look < start - 1: # Did we find a char before the \n\r sets? + strstyle = self.GetStringStyle(look) + quote_char = None + if strstyle is not None: + if strstyle.name == pywin.scintilla.formatter.STYLE_TQSSTRING: + quote_char = "'" + elif strstyle.name == pywin.scintilla.formatter.STYLE_TQDSTRING: + quote_char = '"' + if quote_char is not None: + # It is a TQS. If the TQS is not terminated, we + # carry the style through. + if look > 2: + look_str = ( + self.scintilla.SCIGetCharAt(look - 2) + + self.scintilla.SCIGetCharAt(look - 1) + + self.scintilla.SCIGetCharAt(look) + ) + if look_str != quote_char * 3: + stylePyStart = strstyle.name + if stylePyStart is None: + stylePyStart = pywin.scintilla.formatter.STYLE_DEFAULT + + if start > 0: + stylenum = self.scintilla.SCIGetStyleAt(start - 1) + styleStart = self.GetStyleByNum(stylenum).name + elif self.bannerDisplayed: + styleStart = STYLE_INTERACTIVE_EOL + else: + styleStart = STYLE_INTERACTIVE_BANNER + self.bannerDisplayed = True + self.scintilla.SCIStartStyling(start, 31) + self.style_buffer = array.array("b", (0,) * len(stringVal)) + self.ColorizeInteractiveCode(stringVal, styleStart, stylePyStart) + self.scintilla.SCISetStylingEx(self.style_buffer) + self.style_buffer = None + + +############################################################### +# +# This class handles the Python interactive interpreter. +# +# It uses a basic EditWindow, and does all the magic. +# This is triggered by the enter key hander attached by the +# start-up code. It determines if a command is to be executed +# or continued (ie, emit "... ") by snooping around the current +# line, looking for the prompts +# +class PythonwinInteractiveInterpreter(code.InteractiveInterpreter): + def __init__(self, locals=None, globals=None): + if locals is None: + locals = __main__.__dict__ + if globals is None: + globals = locals + self.globals = globals + code.InteractiveInterpreter.__init__(self, locals) + + def showsyntaxerror(self, filename=None): + sys.stderr.write( + tracebackHeader.decode("ascii") + ) # So the color syntaxer recognises it. + code.InteractiveInterpreter.showsyntaxerror(self, filename) + + def runcode(self, code): + try: + exec(code, self.globals, self.locals) + except SystemExit: + raise + except: + self.showtraceback() + + +class InteractiveCore: + def __init__(self, banner=None): + self.banner = banner + + # LoadFontPreferences() + def Init(self): + self.oldStdOut = self.oldStdErr = None + + # self.SetWordWrap(win32ui.CRichEditView_WrapNone) + self.interp = PythonwinInteractiveInterpreter() + + self.OutputGrab() # Release at cleanup. + + if self.GetTextLength() == 0: + if self.banner is None: + suffix = "" + if win32ui.debug: + suffix = ", debug build" + sys.stderr.write( + "PythonWin %s on %s%s.\n" % (sys.version, sys.platform, suffix) + ) + sys.stderr.write( + "Portions %s - see 'Help/About PythonWin' for further copyright information.\n" + % (win32ui.copyright,) + ) + else: + sys.stderr.write(banner) + rcfile = os.environ.get("PYTHONSTARTUP") + if rcfile: + import __main__ + + try: + exec( + compile( + open(rcfile, "rb").read(), rcfile, "exec", dont_inherit=True + ), + __main__.__dict__, + __main__.__dict__, + ) + except: + sys.stderr.write( + ">>> \nError executing PYTHONSTARTUP script %r\n" % (rcfile) + ) + traceback.print_exc(file=sys.stderr) + self.AppendToPrompt([]) + + def SetContext(self, globals, locals, name="Dbg"): + oldPrompt = sys.ps1 + if globals is None: + # Reset + sys.ps1 = ">>> " + sys.ps2 = "... " + locals = globals = __main__.__dict__ + else: + sys.ps1 = "[%s]>>> " % name + sys.ps2 = "[%s]... " % name + self.interp.locals = locals + self.interp.globals = globals + self.AppendToPrompt([], oldPrompt) + + def GetContext(self): + return self.interp.globals, self.interp.locals + + def DoGetLine(self, line=-1): + if line == -1: + line = self.LineFromChar() + line = self.GetLine(line) + while line and line[-1] in ("\r", "\n"): + line = line[:-1] + return line + + def AppendToPrompt(self, bufLines, oldPrompt=None): + "Take a command and stick it at the end of the buffer (with python prompts inserted if required)." + self.flush() + lastLineNo = self.GetLineCount() - 1 + line = self.DoGetLine(lastLineNo) + if oldPrompt and line == oldPrompt: + self.SetSel(self.GetTextLength() - len(oldPrompt), self.GetTextLength()) + self.ReplaceSel(sys.ps1) + elif line != str(sys.ps1): + if len(line) != 0: + self.write("\n") + self.write(sys.ps1) + self.flush() + self.idle.text.mark_set("iomark", "end-1c") + if not bufLines: + return + terms = (["\n" + sys.ps2] * (len(bufLines) - 1)) + [""] + for bufLine, term in zip(bufLines, terms): + if bufLine.strip(): + self.write(bufLine + term) + self.flush() + + def EnsureNoPrompt(self): + # Get ready to write some text NOT at a Python prompt. + self.flush() + lastLineNo = self.GetLineCount() - 1 + line = self.DoGetLine(lastLineNo) + if not line or line in (sys.ps1, sys.ps2): + self.SetSel(self.GetTextLength() - len(line), self.GetTextLength()) + self.ReplaceSel("") + else: + # Just add a new line. + self.write("\n") + + def _GetSubConfigNames(self): + return ["interactive"] # Allow [Keys:Interactive] sections to be specific + + def HookHandlers(self): + # Hook menu command (executed when a menu item with that ID is selected from a menu/toolbar + self.HookCommand(self.OnSelectBlock, win32ui.ID_EDIT_SELECT_BLOCK) + self.HookCommand(self.OnEditCopyCode, ID_EDIT_COPY_CODE) + self.HookCommand(self.OnEditExecClipboard, ID_EDIT_EXEC_CLIPBOARD) + mod = pywin.scintilla.IDLEenvironment.GetIDLEModule("IdleHistory") + if mod is not None: + self.history = mod.History(self.idle.text, "\n" + sys.ps2) + else: + self.history = None + # hack for now for event handling. + + # GetBlockBoundary takes a line number, and will return the + # start and and line numbers of the block, and a flag indicating if the + # block is a Python code block. + # If the line specified has a Python prompt, then the lines are parsed + # backwards and forwards, and the flag is true. + # If the line does not start with a prompt, the block is searched forward + # and backward until a prompt _is_ found, and all lines in between without + # prompts are returned, and the flag is false. + def GetBlockBoundary(self, lineNo): + line = self.DoGetLine(lineNo) + maxLineNo = self.GetLineCount() - 1 + prefix = GetPromptPrefix(line) + if prefix is None: # Non code block + flag = 0 + startLineNo = lineNo + while startLineNo > 0: + if GetPromptPrefix(self.DoGetLine(startLineNo - 1)) is not None: + break # there _is_ a prompt + startLineNo = startLineNo - 1 + endLineNo = lineNo + while endLineNo < maxLineNo: + if GetPromptPrefix(self.DoGetLine(endLineNo + 1)) is not None: + break # there _is_ a prompt + endLineNo = endLineNo + 1 + else: # Code block + flag = 1 + startLineNo = lineNo + while startLineNo > 0 and prefix != str(sys.ps1): + prefix = GetPromptPrefix(self.DoGetLine(startLineNo - 1)) + if prefix is None: + break + # there is no prompt. + startLineNo = startLineNo - 1 + endLineNo = lineNo + while endLineNo < maxLineNo: + prefix = GetPromptPrefix(self.DoGetLine(endLineNo + 1)) + if prefix is None: + break # there is no prompt + if prefix == str(sys.ps1): + break # this is another command + endLineNo = endLineNo + 1 + # continue until end of buffer, or no prompt + return (startLineNo, endLineNo, flag) + + def ExtractCommand(self, lines): + start, end = lines + retList = [] + while end >= start: + thisLine = self.DoGetLine(end) + promptLen = len(GetPromptPrefix(thisLine)) + retList = [thisLine[promptLen:]] + retList + end = end - 1 + return retList + + def OutputGrab(self): + # import win32traceutil; return + self.oldStdOut = sys.stdout + self.oldStdErr = sys.stderr + sys.stdout = self + sys.stderr = self + self.flush() + + def OutputRelease(self): + # a command may have overwritten these - only restore if not. + if self.oldStdOut is not None: + if sys.stdout == self: + sys.stdout = self.oldStdOut + if self.oldStdErr is not None: + if sys.stderr == self: + sys.stderr = self.oldStdErr + self.oldStdOut = None + self.oldStdErr = None + self.flush() + + ################################### + # + # Message/Command/Key Hooks. + # + # Enter key handler + # + def ProcessEnterEvent(self, event): + # If autocompletion has been triggered, complete and do not process event + if self.SCIAutoCActive(): + self.SCIAutoCComplete() + self.SCICancel() + return + + self.SCICancel() + # First, check for an error message + haveGrabbedOutput = 0 + if self.HandleSpecialLine(): + return 0 + + lineNo = self.LineFromChar() + start, end, isCode = self.GetBlockBoundary(lineNo) + # If we are not in a code block just go to the prompt (or create a new one) + if not isCode: + self.AppendToPrompt([]) + win32ui.SetStatusText(win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE)) + return + + lines = self.ExtractCommand((start, end)) + + # If we are in a code-block, but it isnt at the end of the buffer + # then copy it to the end ready for editing and subsequent execution + if end != self.GetLineCount() - 1: + win32ui.SetStatusText("Press ENTER to execute command") + self.AppendToPrompt(lines) + self.SetSel(-2) + return + + # If SHIFT held down, we want new code here and now! + bNeedIndent = ( + win32api.GetKeyState(win32con.VK_SHIFT) < 0 + or win32api.GetKeyState(win32con.VK_CONTROL) < 0 + ) + if bNeedIndent: + self.ReplaceSel("\n") + else: + self.SetSel(-2) + self.ReplaceSel("\n") + source = "\n".join(lines) + while source and source[-1] in "\t ": + source = source[:-1] + self.OutputGrab() # grab the output for the command exec. + try: + if self.interp.runsource( + source, "" + ): # Need more input! + bNeedIndent = 1 + else: + # If the last line isnt empty, append a newline + if self.history is not None: + self.history.history_store(source) + self.AppendToPrompt([]) + win32ui.SetStatusText( + win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE) + ) + # win32ui.SetStatusText('Successfully executed statement') + finally: + self.OutputRelease() + if bNeedIndent: + win32ui.SetStatusText("Ready to continue the command") + # Now attempt correct indentation (should use IDLE?) + curLine = self.DoGetLine(lineNo)[len(sys.ps2) :] + pos = 0 + indent = "" + while len(curLine) > pos and curLine[pos] in string.whitespace: + indent = indent + curLine[pos] + pos = pos + 1 + if _is_block_opener(curLine): + indent = indent + "\t" + elif _is_block_closer(curLine): + indent = indent[:-1] + # use ReplaceSel to ensure it goes at the cursor rather than end of buffer. + self.ReplaceSel(sys.ps2 + indent) + return 0 + + # ESC key handler + def ProcessEscEvent(self, event): + # Implement a cancel. + if self.SCIAutoCActive() or self.SCICallTipActive(): + self.SCICancel() + else: + win32ui.SetStatusText("Cancelled.") + self.AppendToPrompt(("",)) + return 0 + + def OnSelectBlock(self, command, code): + lineNo = self.LineFromChar() + start, end, isCode = self.GetBlockBoundary(lineNo) + startIndex = self.LineIndex(start) + endIndex = self.LineIndex(end + 1) - 2 # skip \r + \n + if endIndex < 0: # must be beyond end of buffer + endIndex = -2 # self.Length() + self.SetSel(startIndex, endIndex) + + def OnEditCopyCode(self, command, code): + """Sanitizes code from interactive window, removing prompts and output, + and inserts it in the clipboard.""" + code = self.GetSelText() + lines = code.splitlines() + out_lines = [] + for line in lines: + if line.startswith(sys.ps1): + line = line[len(sys.ps1) :] + out_lines.append(line) + elif line.startswith(sys.ps2): + line = line[len(sys.ps2) :] + out_lines.append(line) + out_code = os.linesep.join(out_lines) + win32clipboard.OpenClipboard() + try: + win32clipboard.SetClipboardData( + win32clipboard.CF_UNICODETEXT, str(out_code) + ) + finally: + win32clipboard.CloseClipboard() + + def OnEditExecClipboard(self, command, code): + """Executes python code directly from the clipboard.""" + win32clipboard.OpenClipboard() + try: + code = win32clipboard.GetClipboardData(win32clipboard.CF_UNICODETEXT) + finally: + win32clipboard.CloseClipboard() + + code = code.replace("\r\n", "\n") + "\n" + try: + o = compile(code, "", "exec") + exec(o, __main__.__dict__) + except: + traceback.print_exc() + + def GetRightMenuItems(self): + # Just override parents + ret = [] + flags = 0 + ret.append((flags, win32ui.ID_EDIT_UNDO, "&Undo")) + ret.append(win32con.MF_SEPARATOR) + ret.append((flags, win32ui.ID_EDIT_CUT, "Cu&t")) + ret.append((flags, win32ui.ID_EDIT_COPY, "&Copy")) + + start, end = self.GetSel() + if start != end: + ret.append((flags, ID_EDIT_COPY_CODE, "Copy code without prompts")) + if win32clipboard.IsClipboardFormatAvailable(win32clipboard.CF_UNICODETEXT): + ret.append( + (flags, ID_EDIT_EXEC_CLIPBOARD, "Execute python code from clipboard") + ) + + ret.append((flags, win32ui.ID_EDIT_PASTE, "&Paste")) + ret.append(win32con.MF_SEPARATOR) + ret.append((flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all")) + ret.append((flags, win32ui.ID_EDIT_SELECT_BLOCK, "Select &block")) + ret.append((flags, win32ui.ID_VIEW_WHITESPACE, "View &Whitespace")) + return ret + + def MDINextEvent(self, event): + win32ui.GetMainFrame().MDINext(0) + + def MDIPrevEvent(self, event): + win32ui.GetMainFrame().MDINext(0) + + def WindowBackEvent(self, event): + parent = self.GetParentFrame() + if parent == win32ui.GetMainFrame(): + # It is docked. + try: + wnd, isactive = parent.MDIGetActive() + wnd.SetFocus() + except win32ui.error: + # No MDI window active! + pass + else: + # Normal Window + try: + lastActive = self.GetParentFrame().lastActive + # If the window is invalid, reset it. + if lastActive is not None and ( + lastActive._obj_ is None or lastActive.GetSafeHwnd() == 0 + ): + lastActive = self.GetParentFrame().lastActive = None + win32ui.SetStatusText("The last active Window has been closed.") + except AttributeError: + print("Can't find the last active window!") + lastActive = None + if lastActive is not None: + lastActive.MDIActivate() + + +class InteractiveView(InteractiveCore, winout.WindowOutputView): + def __init__(self, doc): + InteractiveCore.__init__(self) + winout.WindowOutputView.__init__(self, doc) + self.encoding = pywin.default_scintilla_encoding + + def _MakeColorizer(self): + return InteractiveFormatter(self) + + def OnInitialUpdate(self): + winout.WindowOutputView.OnInitialUpdate(self) + self.SetWordWrap() + self.Init() + + def HookHandlers(self): + winout.WindowOutputView.HookHandlers(self) + InteractiveCore.HookHandlers(self) + + +class CInteractivePython(winout.WindowOutput): + def __init__(self, makeDoc=None, makeFrame=None): + self.IsFinalDestroy = 0 + winout.WindowOutput.__init__( + self, + sectionProfile, + sectionProfile, + winout.flags.WQ_LINE, + 1, + None, + makeDoc, + makeFrame, + InteractiveView, + ) + self.Create() + + def OnViewDestroy(self, view): + if self.IsFinalDestroy: + view.OutputRelease() + winout.WindowOutput.OnViewDestroy(self, view) + + def Close(self): + self.IsFinalDestroy = 1 + winout.WindowOutput.Close(self) + + +class InteractiveFrame(winout.WindowOutputFrame): + def __init__(self): + self.lastActive = None + winout.WindowOutputFrame.__init__(self) + + def OnMDIActivate(self, bActive, wndActive, wndDeactive): + if bActive: + self.lastActive = wndDeactive + + +###################################################################### +## +## Dockable Window Support +## +###################################################################### +ID_DOCKED_INTERACTIVE_CONTROLBAR = 0xE802 + +DockedInteractiveViewParent = InteractiveView + + +class DockedInteractiveView(DockedInteractiveViewParent): + def HookHandlers(self): + DockedInteractiveViewParent.HookHandlers(self) + self.HookMessage(self.OnSetFocus, win32con.WM_SETFOCUS) + self.HookMessage(self.OnKillFocus, win32con.WM_KILLFOCUS) + + def OnSetFocus(self, msg): + self.GetParentFrame().SetActiveView(self) + return 1 + + def OnKillFocus(self, msg): + # If we are losing focus to another in this app, reset the main frame's active view. + hwnd = wparam = msg[2] + try: + wnd = win32ui.CreateWindowFromHandle(hwnd) + reset = wnd.GetTopLevelFrame() == self.GetTopLevelFrame() + except win32ui.error: + reset = 0 # Not my window + if reset: + self.GetParentFrame().SetActiveView(None) + return 1 + + def OnDestroy(self, msg): + newSize = self.GetWindowPlacement()[4] + pywin.framework.app.SaveWindowSize("Interactive Window", newSize, "docked") + try: + if self.GetParentFrame().GetActiveView == self: + self.GetParentFrame().SetActiveView(None) + except win32ui.error: + pass + try: + if win32ui.GetMainFrame().GetActiveView() == self: + win32ui.GetMainFrame().SetActiveView(None) + except win32ui.error: + pass + return DockedInteractiveViewParent.OnDestroy(self, msg) + + +class CDockedInteractivePython(CInteractivePython): + def __init__(self, dockbar): + self.bFirstCreated = 0 + self.dockbar = dockbar + CInteractivePython.__init__(self) + + def NeedRecreateWindow(self): + if self.bCreating: + return 0 + try: + frame = win32ui.GetMainFrame() + if frame.closing: + return 0 # Dieing! + except (win32ui.error, AttributeError): + return 0 # The app is dieing! + try: + cb = frame.GetControlBar(ID_DOCKED_INTERACTIVE_CONTROLBAR) + return not cb.IsWindowVisible() + except win32ui.error: + return 1 # Control bar does not exist! + + def RecreateWindow(self): + try: + dockbar = win32ui.GetMainFrame().GetControlBar( + ID_DOCKED_INTERACTIVE_CONTROLBAR + ) + win32ui.GetMainFrame().ShowControlBar(dockbar, 1, 1) + except win32ui.error: + CreateDockedInteractiveWindow() + + def Create(self): + self.bCreating = 1 + doc = InteractiveDocument(None, self.DoCreateDoc()) + view = DockedInteractiveView(doc) + defRect = pywin.framework.app.LoadWindowSize("Interactive Window", "docked") + if defRect[2] - defRect[0] == 0: + defRect = 0, 0, 500, 200 + style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_BORDER + id = 1050 # win32ui.AFX_IDW_PANE_FIRST + view.CreateWindow(self.dockbar, id, style, defRect) + view.OnInitialUpdate() + self.bFirstCreated = 1 + + self.currentView = doc.GetFirstView() + self.bCreating = 0 + if self.title: + doc.SetTitle(self.title) + + +# The factory we pass to the dockable window support. +def InteractiveViewCreator(parent): + global edit + edit = CDockedInteractivePython(parent) + return edit.currentView + + +def CreateDockedInteractiveWindow(): + # Later, the DockingBar should be capable of hosting multiple + # children. + from pywin.docking.DockingBar import DockingBar + + bar = DockingBar() + creator = InteractiveViewCreator + bar.CreateWindow( + win32ui.GetMainFrame(), + creator, + "Interactive Window", + ID_DOCKED_INTERACTIVE_CONTROLBAR, + ) + bar.SetBarStyle( + bar.GetBarStyle() + | afxres.CBRS_TOOLTIPS + | afxres.CBRS_FLYBY + | afxres.CBRS_SIZE_DYNAMIC + ) + bar.EnableDocking(afxres.CBRS_ALIGN_ANY) + win32ui.GetMainFrame().DockControlBar(bar, afxres.AFX_IDW_DOCKBAR_BOTTOM) + + +###################################################################### +# +# The public interface to this module. +# +###################################################################### +# No extra functionality now, but maybe later, so +# publicize these names. +InteractiveDocument = winout.WindowOutputDocument + +# We remember our one and only interactive window in the "edit" variable. +edit = None + + +def CreateInteractiveWindowUserPreference(makeDoc=None, makeFrame=None): + """Create some sort of interactive window if the user's preference say we should.""" + bCreate = LoadPreference("Show at startup", 1) + if bCreate: + CreateInteractiveWindow(makeDoc, makeFrame) + + +def CreateInteractiveWindow(makeDoc=None, makeFrame=None): + """Create a standard or docked interactive window unconditionally""" + assert edit is None, "Creating second interactive window!" + bDocking = LoadPreference("Docking", 0) + if bDocking: + CreateDockedInteractiveWindow() + else: + CreateMDIInteractiveWindow(makeDoc, makeFrame) + assert edit is not None, "Created interactive window, but did not set the global!" + edit.currentView.SetFocus() + + +def CreateMDIInteractiveWindow(makeDoc=None, makeFrame=None): + """Create a standard (non-docked) interactive window unconditionally""" + global edit + if makeDoc is None: + makeDoc = InteractiveDocument + if makeFrame is None: + makeFrame = InteractiveFrame + edit = CInteractivePython(makeDoc=makeDoc, makeFrame=makeFrame) + + +def DestroyInteractiveWindow(): + """Destroy the interactive window. + This is different to Closing the window, + which may automatically re-appear. Once destroyed, it can never be recreated, + and a complete new instance must be created (which the various other helper + functions will then do after making this call + """ + global edit + if edit is not None and edit.currentView is not None: + if edit.currentView.GetParentFrame() == win32ui.GetMainFrame(): + # It is docked - do nothing now (this is only called at shutdown!) + pass + else: + # It is a standard window - call Close on the container. + edit.Close() + edit = None + + +def CloseInteractiveWindow(): + """Close the interactive window, allowing it to be re-created on demand.""" + global edit + if edit is not None and edit.currentView is not None: + if edit.currentView.GetParentFrame() == win32ui.GetMainFrame(): + # It is docked, just hide the dock bar. + frame = win32ui.GetMainFrame() + cb = frame.GetControlBar(ID_DOCKED_INTERACTIVE_CONTROLBAR) + frame.ShowControlBar(cb, 0, 1) + else: + # It is a standard window - destroy the frame/view, allowing the object itself to remain. + edit.currentView.GetParentFrame().DestroyWindow() + + +def ToggleInteractiveWindow(): + """If the interactive window is visible, hide it, otherwise show it.""" + if edit is None: + CreateInteractiveWindow() + else: + if edit.NeedRecreateWindow(): + edit.RecreateWindow() + else: + # Close it, allowing a reopen. + CloseInteractiveWindow() + + +def ShowInteractiveWindow(): + """Shows (or creates if necessary) an interactive window""" + if edit is None: + CreateInteractiveWindow() + else: + if edit.NeedRecreateWindow(): + edit.RecreateWindow() + else: + parent = edit.currentView.GetParentFrame() + if parent == win32ui.GetMainFrame(): # It is docked. + edit.currentView.SetFocus() + else: # It is a "normal" window + edit.currentView.GetParentFrame().AutoRestore() + win32ui.GetMainFrame().MDIActivate(edit.currentView.GetParentFrame()) + + +def IsInteractiveWindowVisible(): + return edit is not None and not edit.NeedRecreateWindow() diff --git a/lib/pythonwin/pywin/framework/intpyapp.py b/lib/pythonwin/pywin/framework/intpyapp.py new file mode 100644 index 00000000..48461dba --- /dev/null +++ b/lib/pythonwin/pywin/framework/intpyapp.py @@ -0,0 +1,555 @@ +# intpyapp.py - Interactive Python application class +# +import os +import sys +import traceback + +import __main__ +import commctrl +import win32api +import win32con +import win32ui +from pywin.mfc import afxres, dialog + +from . import app, dbgcommands + +lastLocateFileName = ".py" # used in the "File/Locate" dialog... + + +# todo - _SetupSharedMenu should be moved to a framework class. +def _SetupSharedMenu_(self): + sharedMenu = self.GetSharedMenu() + from pywin.framework import toolmenu + + toolmenu.SetToolsMenu(sharedMenu) + from pywin.framework import help + + help.SetHelpMenuOtherHelp(sharedMenu) + + +from pywin.mfc import docview + +docview.DocTemplate._SetupSharedMenu_ = _SetupSharedMenu_ + + +class MainFrame(app.MainFrame): + def OnCreate(self, createStruct): + self.closing = 0 + if app.MainFrame.OnCreate(self, createStruct) == -1: + return -1 + style = ( + win32con.WS_CHILD + | afxres.CBRS_SIZE_DYNAMIC + | afxres.CBRS_TOP + | afxres.CBRS_TOOLTIPS + | afxres.CBRS_FLYBY + ) + + self.EnableDocking(afxres.CBRS_ALIGN_ANY) + + tb = win32ui.CreateToolBar(self, style | win32con.WS_VISIBLE) + tb.ModifyStyle(0, commctrl.TBSTYLE_FLAT) + tb.LoadToolBar(win32ui.IDR_MAINFRAME) + tb.EnableDocking(afxres.CBRS_ALIGN_ANY) + tb.SetWindowText("Standard") + self.DockControlBar(tb) + # Any other packages which use toolbars + from pywin.debugger.debugger import PrepareControlBars + + PrepareControlBars(self) + # Note "interact" also uses dockable windows, but they already happen + + # And a "Tools" menu on the main frame. + menu = self.GetMenu() + from . import toolmenu + + toolmenu.SetToolsMenu(menu, 2) + # And fix the "Help" menu on the main frame + from pywin.framework import help + + help.SetHelpMenuOtherHelp(menu) + + def OnClose(self): + try: + import pywin.debugger + + if ( + pywin.debugger.currentDebugger is not None + and pywin.debugger.currentDebugger.pumping + ): + try: + pywin.debugger.currentDebugger.close(1) + except: + traceback.print_exc() + return + except win32ui.error: + pass + self.closing = 1 + self.SaveBarState("ToolbarDefault") + self.SetActiveView(None) # Otherwise MFC's OnClose may _not_ prompt for save. + + from pywin.framework import help + + help.FinalizeHelp() + + self.DestroyControlBar(afxres.AFX_IDW_TOOLBAR) + self.DestroyControlBar(win32ui.ID_VIEW_TOOLBAR_DBG) + + return self._obj_.OnClose() + + def DestroyControlBar(self, id): + try: + bar = self.GetControlBar(id) + except win32ui.error: + return + bar.DestroyWindow() + + def OnCommand(self, wparam, lparam): + # By default, the current MDI child frame will process WM_COMMAND + # messages before any docked control bars - even if the control bar + # has focus. This is a problem for the interactive window when docked. + # Therefore, we detect the situation of a view having the main frame + # as its parent, and assume it must be a docked view (which it will in an MDI app) + try: + v = ( + self.GetActiveView() + ) # Raise an exception if none - good - then we want default handling + # Main frame _does_ have a current view (ie, a docking view) - see if it wants it. + if v.OnCommand(wparam, lparam): + return 1 + except (win32ui.error, AttributeError): + pass + return self._obj_.OnCommand(wparam, lparam) + + +class InteractivePythonApp(app.CApp): + # This works if necessary - just we dont need to override the Run method. + # def Run(self): + # return self._obj_.Run() + + def HookCommands(self): + app.CApp.HookCommands(self) + dbgcommands.DebuggerCommandHandler().HookCommands() + self.HookCommand(self.OnViewBrowse, win32ui.ID_VIEW_BROWSE) + self.HookCommand(self.OnFileImport, win32ui.ID_FILE_IMPORT) + self.HookCommand(self.OnFileCheck, win32ui.ID_FILE_CHECK) + self.HookCommandUpdate(self.OnUpdateFileCheck, win32ui.ID_FILE_CHECK) + self.HookCommand(self.OnFileRun, win32ui.ID_FILE_RUN) + self.HookCommand(self.OnFileLocate, win32ui.ID_FILE_LOCATE) + self.HookCommand(self.OnInteractiveWindow, win32ui.ID_VIEW_INTERACTIVE) + self.HookCommandUpdate( + self.OnUpdateInteractiveWindow, win32ui.ID_VIEW_INTERACTIVE + ) + self.HookCommand(self.OnViewOptions, win32ui.ID_VIEW_OPTIONS) + self.HookCommand(self.OnHelpIndex, afxres.ID_HELP_INDEX) + self.HookCommand(self.OnFileSaveAll, win32ui.ID_FILE_SAVE_ALL) + self.HookCommand(self.OnViewToolbarDbg, win32ui.ID_VIEW_TOOLBAR_DBG) + self.HookCommandUpdate(self.OnUpdateViewToolbarDbg, win32ui.ID_VIEW_TOOLBAR_DBG) + + def CreateMainFrame(self): + return MainFrame() + + def MakeExistingDDEConnection(self): + # Use DDE to connect to an existing instance + # Return None if no existing instance + try: + from . import intpydde + except ImportError: + # No dde support! + return None + conv = intpydde.CreateConversation(self.ddeServer) + try: + conv.ConnectTo("Pythonwin", "System") + return conv + except intpydde.error: + return None + + def InitDDE(self): + # Do all the magic DDE handling. + # Returns TRUE if we have pumped the arguments to our + # remote DDE app, and we should terminate. + try: + from . import intpydde + except ImportError: + self.ddeServer = None + intpydde = None + if intpydde is not None: + self.ddeServer = intpydde.DDEServer(self) + self.ddeServer.Create("Pythonwin", intpydde.CBF_FAIL_SELFCONNECTIONS) + try: + # If there is an existing instance, pump the arguments to it. + connection = self.MakeExistingDDEConnection() + if connection is not None: + connection.Exec("self.Activate()") + if self.ProcessArgs(sys.argv, connection) is None: + return 1 + except: + # It is too early to 'print' an exception - we + # don't have stdout setup yet! + win32ui.DisplayTraceback( + sys.exc_info(), " - error in DDE conversation with Pythonwin" + ) + return 1 + + def InitInstance(self): + # Allow "/nodde" and "/new" to optimize this! + if ( + "/nodde" not in sys.argv + and "/new" not in sys.argv + and "-nodde" not in sys.argv + and "-new" not in sys.argv + ): + if self.InitDDE(): + return 1 # A remote DDE client is doing it for us! + else: + self.ddeServer = None + + win32ui.SetRegistryKey( + "Python %s" % (sys.winver,) + ) # MFC automatically puts the main frame caption on! + app.CApp.InitInstance(self) + + # Create the taskbar icon + win32ui.CreateDebuggerThread() + + # Allow Pythonwin to host OCX controls. + win32ui.EnableControlContainer() + + # Display the interactive window if the user wants it. + from . import interact + + interact.CreateInteractiveWindowUserPreference() + + # Load the modules we use internally. + self.LoadSystemModules() + + # Load additional module the user may want. + self.LoadUserModules() + + # Load the ToolBar state near the end of the init process, as + # there may be Toolbar IDs created by the user or other modules. + # By now all these modules should be loaded, so all the toolbar IDs loaded. + try: + self.frame.LoadBarState("ToolbarDefault") + except win32ui.error: + # MFC sucks. It does essentially "GetDlgItem(x)->Something", so if the + # toolbar with ID x does not exist, MFC crashes! Pythonwin has a trap for this + # but I need to investigate more how to prevent it (AFAIK, ensuring all the + # toolbars are created by now _should_ stop it!) + pass + + # Finally process the command line arguments. + try: + self.ProcessArgs(sys.argv) + except: + # too early for printing anything. + win32ui.DisplayTraceback( + sys.exc_info(), " - error processing command line args" + ) + + def ExitInstance(self): + win32ui.DestroyDebuggerThread() + try: + from . import interact + + interact.DestroyInteractiveWindow() + except: + pass + if self.ddeServer is not None: + self.ddeServer.Shutdown() + self.ddeServer = None + return app.CApp.ExitInstance(self) + + def Activate(self): + # Bring to the foreground. Mainly used when another app starts up, it asks + # this one to activate itself, then it terminates. + frame = win32ui.GetMainFrame() + frame.SetForegroundWindow() + if frame.GetWindowPlacement()[1] == win32con.SW_SHOWMINIMIZED: + frame.ShowWindow(win32con.SW_RESTORE) + + def ProcessArgs(self, args, dde=None): + # If we are going to talk to a remote app via DDE, then + # activate it! + if ( + len(args) < 1 or not args[0] + ): # argv[0]=='' when started without args, just like Python.exe! + return + + i = 0 + while i < len(args): + argType = args[i] + i += 1 + if argType.startswith("-"): + # Support dash options. Slash options are misinterpreted by python init + # as path and not finding usually 'C:\\' ends up in sys.path[0] + argType = "/" + argType[1:] + if not argType.startswith("/"): + argType = win32ui.GetProfileVal( + "Python", "Default Arg Type", "/edit" + ).lower() + i -= 1 # arg is /edit's parameter + par = i < len(args) and args[i] or "MISSING" + if argType in ("/nodde", "/new", "-nodde", "-new"): + # Already handled + pass + elif argType.startswith("/goto:"): + gotoline = int(argType[len("/goto:") :]) + if dde: + dde.Exec( + "from pywin.framework import scriptutils\n" + "ed = scriptutils.GetActiveEditControl()\n" + "if ed: ed.SetSel(ed.LineIndex(%s - 1))" % gotoline + ) + else: + from . import scriptutils + + ed = scriptutils.GetActiveEditControl() + if ed: + ed.SetSel(ed.LineIndex(gotoline - 1)) + elif argType == "/edit": + # Load up the default application. + i += 1 + fname = win32api.GetFullPathName(par) + if not os.path.isfile(fname): + # if we don't catch this, OpenDocumentFile() (actually + # PyCDocument.SetPathName() in + # pywin.scintilla.document.CScintillaDocument.OnOpenDocument) + # segfaults Pythonwin on recent PY3 builds (b228) + win32ui.MessageBox( + "No such file: %s\n\nCommand Line: %s" + % (fname, win32api.GetCommandLine()), + "Open file for edit", + win32con.MB_ICONERROR, + ) + continue + if dde: + dde.Exec("win32ui.GetApp().OpenDocumentFile(%s)" % (repr(fname))) + else: + win32ui.GetApp().OpenDocumentFile(par) + elif argType == "/rundlg": + if dde: + dde.Exec( + "from pywin.framework import scriptutils;scriptutils.RunScript(%r, %r, 1)" + % (par, " ".join(args[i + 1 :])) + ) + else: + from . import scriptutils + + scriptutils.RunScript(par, " ".join(args[i + 1 :])) + return + elif argType == "/run": + if dde: + dde.Exec( + "from pywin.framework import scriptutils;scriptutils.RunScript(%r, %r, 0)" + % (par, " ".join(args[i + 1 :])) + ) + else: + from . import scriptutils + + scriptutils.RunScript(par, " ".join(args[i + 1 :]), 0) + return + elif argType == "/app": + raise RuntimeError( + "/app only supported for new instances of Pythonwin.exe" + ) + elif argType == "/dde": # Send arbitary command + if dde is not None: + dde.Exec(par) + else: + win32ui.MessageBox( + "The /dde command can only be used\r\nwhen Pythonwin is already running" + ) + i += 1 + else: + raise ValueError("Command line argument not recognised: %s" % argType) + + def LoadSystemModules(self): + self.DoLoadModules("pywin.framework.editor,pywin.framework.stdin") + + def LoadUserModules(self, moduleNames=None): + # Load the users modules. + if moduleNames is None: + default = "pywin.framework.sgrepmdi,pywin.framework.mdi_pychecker" + moduleNames = win32ui.GetProfileVal("Python", "Startup Modules", default) + self.DoLoadModules(moduleNames) + + def DoLoadModules(self, moduleNames): # ", sep string of module names. + if not moduleNames: + return + modules = moduleNames.split(",") + for module in modules: + try: + __import__(module) + except: # Catch em all, else the app itself dies! 'ImportError: + traceback.print_exc() + msg = 'Startup import of user module "%s" failed' % module + print(msg) + win32ui.MessageBox(msg) + + # + # DDE Callback + # + def OnDDECommand(self, command): + try: + exec(command + "\n") + except: + print("ERROR executing DDE command: ", command) + traceback.print_exc() + raise + + # + # General handlers + # + def OnViewBrowse(self, id, code): + "Called when ViewBrowse message is received" + from pywin.tools import browser + + obName = dialog.GetSimpleInput("Object", "__builtins__", "Browse Python Object") + if obName is None: + return + try: + browser.Browse(eval(obName, __main__.__dict__, __main__.__dict__)) + except NameError: + win32ui.MessageBox("This is no object with this name") + except AttributeError: + win32ui.MessageBox("The object has no attribute of that name") + except: + traceback.print_exc() + win32ui.MessageBox("This object can not be browsed") + + def OnFileImport(self, id, code): + "Called when a FileImport message is received. Import the current or specified file" + from . import scriptutils + + scriptutils.ImportFile() + + def OnFileCheck(self, id, code): + "Called when a FileCheck message is received. Check the current file." + from . import scriptutils + + scriptutils.CheckFile() + + def OnUpdateFileCheck(self, cmdui): + from . import scriptutils + + cmdui.Enable(scriptutils.GetActiveFileName(0) is not None) + + def OnFileRun(self, id, code): + "Called when a FileRun message is received." + from . import scriptutils + + showDlg = win32api.GetKeyState(win32con.VK_SHIFT) >= 0 + scriptutils.RunScript(None, None, showDlg) + + def OnFileLocate(self, id, code): + from . import scriptutils + + global lastLocateFileName # save the new version away for next time... + + name = dialog.GetSimpleInput( + "File name", lastLocateFileName, "Locate Python File" + ) + if name is None: # Cancelled. + return + lastLocateFileName = name + # if ".py" supplied, rip it off! + # should also check for .pys and .pyw + if lastLocateFileName[-3:].lower() == ".py": + lastLocateFileName = lastLocateFileName[:-3] + lastLocateFileName = lastLocateFileName.replace(".", "\\") + newName = scriptutils.LocatePythonFile(lastLocateFileName) + if newName is None: + win32ui.MessageBox("The file '%s' can not be located" % lastLocateFileName) + else: + win32ui.GetApp().OpenDocumentFile(newName) + + # Display all the "options" proprety pages we can find + def OnViewOptions(self, id, code): + win32ui.InitRichEdit() + sheet = dialog.PropertySheet("Pythonwin Options") + # Add property pages we know about that need manual work. + from pywin.dialogs import ideoptions + + sheet.AddPage(ideoptions.OptionsPropPage()) + + from . import toolmenu + + sheet.AddPage(toolmenu.ToolMenuPropPage()) + + # Get other dynamic pages from templates. + pages = [] + for template in self.GetDocTemplateList(): + try: + # Dont actually call the function with the exception handler. + getter = template.GetPythonPropertyPages + except AttributeError: + # Template does not provide property pages! + continue + pages = pages + getter() + + # Debugger template goes at the end + try: + from pywin.debugger import configui + except ImportError: + configui = None + if configui is not None: + pages.append(configui.DebuggerOptionsPropPage()) + # Now simply add the pages, and display the dialog. + for page in pages: + sheet.AddPage(page) + + if sheet.DoModal() == win32con.IDOK: + win32ui.SetStatusText("Applying configuration changes...", 1) + win32ui.DoWaitCursor(1) + # Tell every Window in our app that win.ini has changed! + win32ui.GetMainFrame().SendMessageToDescendants( + win32con.WM_WININICHANGE, 0, 0 + ) + win32ui.DoWaitCursor(0) + + def OnInteractiveWindow(self, id, code): + # toggle the existing state. + from . import interact + + interact.ToggleInteractiveWindow() + + def OnUpdateInteractiveWindow(self, cmdui): + try: + interact = sys.modules["pywin.framework.interact"] + state = interact.IsInteractiveWindowVisible() + except KeyError: # Interactive module hasnt ever been imported. + state = 0 + cmdui.Enable() + cmdui.SetCheck(state) + + def OnFileSaveAll(self, id, code): + # Only attempt to save editor documents. + from pywin.framework.editor import editorTemplate + + num = 0 + for doc in editorTemplate.GetDocumentList(): + if doc.IsModified() and doc.GetPathName(): + num = num = 1 + doc.OnSaveDocument(doc.GetPathName()) + win32ui.SetStatusText("%d documents saved" % num, 1) + + def OnViewToolbarDbg(self, id, code): + if code == 0: + return not win32ui.GetMainFrame().OnBarCheck(id) + + def OnUpdateViewToolbarDbg(self, cmdui): + win32ui.GetMainFrame().OnUpdateControlBarMenu(cmdui) + cmdui.Enable(1) + + def OnHelpIndex(self, id, code): + from . import help + + help.SelectAndRunHelpFile() + + +# As per the comments in app.py, this use is depreciated. +# app.AppBuilder = InteractivePythonApp + +# Now all we do is create the application +thisApp = InteractivePythonApp() diff --git a/lib/pythonwin/pywin/framework/intpydde.py b/lib/pythonwin/pywin/framework/intpydde.py new file mode 100644 index 00000000..1f869b0f --- /dev/null +++ b/lib/pythonwin/pywin/framework/intpydde.py @@ -0,0 +1,60 @@ +# DDE support for Pythonwin +# +# Seems to work fine (in the context that IE4 seems to have broken +# DDE on _all_ NT4 machines I have tried, but only when a "Command Prompt" window +# is open. Strange, but true. If you have problems with this, close all Command Prompts! + + +import sys +import traceback + +import win32api +import win32ui +from dde import * +from pywin.mfc import object + + +class DDESystemTopic(object.Object): + def __init__(self, app): + self.app = app + object.Object.__init__(self, CreateServerSystemTopic()) + + def Exec(self, data): + try: + # print "Executing", cmd + self.app.OnDDECommand(data) + except: + t, v, tb = sys.exc_info() + # The DDE Execution failed. + print("Error executing DDE command.") + traceback.print_exception(t, v, tb) + return 0 + + +class DDEServer(object.Object): + def __init__(self, app): + self.app = app + object.Object.__init__(self, CreateServer()) + self.topic = self.item = None + + def CreateSystemTopic(self): + return DDESystemTopic(self.app) + + def Shutdown(self): + self._obj_.Shutdown() + self._obj_.Destroy() + if self.topic is not None: + self.topic.Destroy() + self.topic = None + if self.item is not None: + self.item.Destroy() + self.item = None + + def OnCreate(self): + return 1 + + def Status(self, msg): + try: + win32ui.SetStatusText(msg) + except win32ui.error: + pass diff --git a/lib/pythonwin/pywin/framework/mdi_pychecker.py b/lib/pythonwin/pywin/framework/mdi_pychecker.py new file mode 100644 index 00000000..c89f33b9 --- /dev/null +++ b/lib/pythonwin/pywin/framework/mdi_pychecker.py @@ -0,0 +1,849 @@ +###################################################################### +## +## The Pychecker MDI Plug-In UserModule for Pythonwin +## +## contributed by Robert Kiendl +## +## Style is similar to (and inherited) from the SGrepMDI UserModule +## +## Usage: +## +## Start Pychecker on current file: Menu/File/New../Pychecker. +## Use it: Jump to Pychecker warning source lines by double-click. +## Auto-add "#$pycheck_no" / "#$pycheck_no=specific-re-pattern" tags +## to source lines by context/right-mouse-click on warning lines. +## +## It requires pychecker installed and the pychecker.bat to be on +## the PATH. Example pychecker.bat: +## +## REM pychecker.bat +## C:\bin\python.exe C:\PYTHON23\Lib\site-packages\pychecker\checker.py %1 %2 %3 %4 %5 %6 %7 %8 %9 +## +## Adding it as default module in PythonWin: +## +## +++ ./intpyapp.py 2006-10-02 17:59:32.974161600 +0200 +## @@ -272,7 +282,7 @@ +## def LoadUserModules(self, moduleNames = None): +## # Load the users modules. +## if moduleNames is None: +## - default = "sgrepmdi" +## + default = "sgrepmdi,mdi_pychecker" +## moduleNames=win32ui.GetProfileVal('Python','Startup Modules',default) +## self.DoLoadModules(moduleNames) +## +###################################################################### + +import glob +import os +import re +import sys +import time + +import win32api +import win32con +import win32ui +from pywin.mfc import dialog, docview, window + +from . import scriptutils + + +def getsubdirs(d): + dlist = [] + flist = glob.glob(d + "\\*") + for f in flist: + if os.path.isdir(f): + dlist.append(f) + dlist = dlist + getsubdirs(f) + return dlist + + +class dirpath: + def __init__(self, str, recurse=0): + dp = str.split(";") + dirs = {} + for d in dp: + if os.path.isdir(d): + d = d.lower() + if d not in dirs: + dirs[d] = None + if recurse: + subdirs = getsubdirs(d) + for sd in subdirs: + sd = sd.lower() + if sd not in dirs: + dirs[sd] = None + elif os.path.isfile(d): + pass + else: + x = None + if d in os.environ: + x = dirpath(os.environ[d]) + elif d[:5] == "HKEY_": + keystr = d.split("\\") + try: + root = eval("win32con." + keystr[0]) + except: + win32ui.MessageBox( + "Can't interpret registry key name '%s'" % keystr[0] + ) + try: + subkey = "\\".join(keystr[1:]) + val = win32api.RegQueryValue(root, subkey) + if val: + x = dirpath(val) + else: + win32ui.MessageBox( + "Registry path '%s' did not return a path entry" % d + ) + except: + win32ui.MessageBox( + "Can't interpret registry key value: %s" % keystr[1:] + ) + else: + win32ui.MessageBox("Directory '%s' not found" % d) + if x: + for xd in x: + if xd not in dirs: + dirs[xd] = None + if recurse: + subdirs = getsubdirs(xd) + for sd in subdirs: + sd = sd.lower() + if sd not in dirs: + dirs[sd] = None + self.dirs = [] + for d in dirs.keys(): + self.dirs.append(d) + + def __getitem__(self, key): + return self.dirs[key] + + def __len__(self): + return len(self.dirs) + + def __setitem__(self, key, value): + self.dirs[key] = value + + def __delitem__(self, key): + del self.dirs[key] + + def __getslice__(self, lo, hi): + return self.dirs[lo:hi] + + def __setslice__(self, lo, hi, seq): + self.dirs[lo:hi] = seq + + def __delslice__(self, lo, hi): + del self.dirs[lo:hi] + + def __add__(self, other): + if type(other) == type(self) or type(other) == type([]): + return self.dirs + other.dirs + + def __radd__(self, other): + if type(other) == type(self) or type(other) == type([]): + return other.dirs + self.dirs + + +# Group(1) is the filename, group(2) is the lineno. +# regexGrepResult=regex.compile("^\\([a-zA-Z]:.*\\)(\\([0-9]+\\))") +# regexGrep=re.compile(r"^([a-zA-Z]:[^(]*)\((\d+)\)") +regexGrep = re.compile(r"^(..[^\(:]+)?[\(:](\d+)[\):]:?\s*(.*)") + +# these are the atom numbers defined by Windows for basic dialog controls + +BUTTON = 0x80 +EDIT = 0x81 +STATIC = 0x82 +LISTBOX = 0x83 +SCROLLBAR = 0x84 +COMBOBOX = 0x85 + + +class TheTemplate(docview.RichEditDocTemplate): + def __init__(self): + docview.RichEditDocTemplate.__init__( + self, win32ui.IDR_TEXTTYPE, TheDocument, TheFrame, TheView + ) + self.SetDocStrings( + "\nPychecker\nPychecker\nPychecker params (*.pychecker)\n.pychecker\n\n\n" + ) + win32ui.GetApp().AddDocTemplate(self) + self.docparams = None + + def MatchDocType(self, fileName, fileType): + doc = self.FindOpenDocument(fileName) + if doc: + return doc + ext = os.path.splitext(fileName)[1].lower() + if ext == ".pychecker": + return win32ui.CDocTemplate_Confidence_yesAttemptNative + return win32ui.CDocTemplate_Confidence_noAttempt + + def setParams(self, params): + self.docparams = params + + def readParams(self): + tmp = self.docparams + self.docparams = None + return tmp + + +class TheFrame(window.MDIChildWnd): + # The template and doc params will one day be removed. + def __init__(self, wnd=None): + window.MDIChildWnd.__init__(self, wnd) + + +class TheDocument(docview.RichEditDoc): + def __init__(self, template): + docview.RichEditDoc.__init__(self, template) + self.dirpattern = "" + self.filpattern = "" + self.greppattern = "" + self.casesensitive = 1 + self.recurse = 1 + self.verbose = 0 + + def OnOpenDocument(self, fnm): + # this bizarre stuff with params is so right clicking in a result window + # and starting a new grep can communicate the default parameters to the + # new grep. + try: + params = open(fnm, "r").read() + except: + params = None + self.setInitParams(params) + return self.OnNewDocument() + + def OnCloseDocument(self): + try: + win32ui.GetApp().DeleteIdleHandler(self.idleHandler) + except: + pass + return self._obj_.OnCloseDocument() + + def saveInitParams(self): + # Only save the flags, not the text boxes. + paramstr = "\t\t\t%d\t%d" % (self.casesensitive, self.recurse) + win32ui.WriteProfileVal("Pychecker", "Params", paramstr) + + def setInitParams(self, paramstr): + if paramstr is None: + paramstr = win32ui.GetProfileVal("Pychecker", "Params", "\t\t\t1\t0\t0") + params = paramstr.split("\t") + if len(params) < 3: + params = params + [""] * (3 - len(params)) + if len(params) < 6: + params = params + [0] * (6 - len(params)) + self.dirpattern = params[0] + self.filpattern = params[1] + self.greppattern = params[2] or "-#1000 --only" + self.casesensitive = int(params[3]) + self.recurse = int(params[4]) + self.verbose = int(params[5]) + # setup some reasonable defaults. + if not self.dirpattern: + try: + editor = win32ui.GetMainFrame().MDIGetActive()[0].GetEditorView() + self.dirpattern = os.path.abspath( + os.path.dirname(editor.GetDocument().GetPathName()) + ) + except (AttributeError, win32ui.error): + self.dirpattern = os.getcwd() + if not self.filpattern: + try: + editor = win32ui.GetMainFrame().MDIGetActive()[0].GetEditorView() + self.filpattern = editor.GetDocument().GetPathName() + except AttributeError: + self.filpattern = "*.py" + + def OnNewDocument(self): + if self.dirpattern == "": + self.setInitParams(greptemplate.readParams()) + d = TheDialog( + self.dirpattern, + self.filpattern, + self.greppattern, + self.casesensitive, + self.recurse, + self.verbose, + ) + if d.DoModal() == win32con.IDOK: + self.dirpattern = d["dirpattern"] + self.filpattern = d["filpattern"] + self.greppattern = d["greppattern"] + # self.casesensitive = d['casesensitive'] + # self.recurse = d['recursive'] + # self.verbose = d['verbose'] + self.doSearch() + self.saveInitParams() + return 1 + return 0 # cancelled - return zero to stop frame creation. + + def doSearch(self): + self.dp = dirpath(self.dirpattern, self.recurse) + self.SetTitle( + "Pychecker Run '%s' (options: %s)" % (self.filpattern, self.greppattern) + ) + # self.text = [] + self.GetFirstView().Append( + "#Pychecker Run in " + self.dirpattern + " %s\n" % time.asctime() + ) + if self.verbose: + self.GetFirstView().Append("# =" + repr(self.dp.dirs) + "\n") + self.GetFirstView().Append("# Files " + self.filpattern + "\n") + self.GetFirstView().Append("# Options " + self.greppattern + "\n") + self.fplist = self.filpattern.split(";") + self.GetFirstView().Append( + "# Running... ( double click on result lines in order to jump to the source code ) \n" + ) + win32ui.SetStatusText("Pychecker running. Please wait...", 0) + self.dpndx = self.fpndx = 0 + self.fndx = -1 + if not self.dp: + self.GetFirstView().Append( + "# ERROR: '%s' does not resolve to any search locations" + % self.dirpattern + ) + self.SetModifiedFlag(0) + else: + ##self.flist = glob.glob(self.dp[0]+'\\'+self.fplist[0]) + import operator + + self.flist = reduce(operator.add, list(map(glob.glob, self.fplist))) + # import pywin.debugger;pywin.debugger.set_trace() + self.startPycheckerRun() + + def idleHandler(self, handler, count): + import time + + time.sleep(0.001) + if self.result != None: + win32ui.GetApp().DeleteIdleHandler(self.idleHandler) + return 0 + return 1 # more + + def startPycheckerRun(self): + self.result = None + old = win32api.SetCursor(win32api.LoadCursor(0, win32con.IDC_APPSTARTING)) + win32ui.GetApp().AddIdleHandler(self.idleHandler) + import _thread + + _thread.start_new(self.threadPycheckerRun, ()) + ##win32api.SetCursor(old) + + def threadPycheckerRun(self): + result = "" + rc = -1 + try: + options = self.greppattern + files = " ".join(self.flist) + # Recently MarkH has failed to run pychecker without it having + # been explicitly installed - so we assume it is and locate it + # from its default location. + # Step1 - get python.exe + py = os.path.join(sys.prefix, "python.exe") + if not os.path.isfile(py): + if "64 bit" in sys.version: + py = os.path.join(sys.prefix, "PCBuild", "amd64", "python.exe") + else: + py = os.path.join(sys.prefix, "PCBuild", "python.exe") + try: + py = win32api.GetShortPathName(py) + except win32api.error: + py = "" + # Find checker.py + import sysconfig + + pychecker = os.path.join( + sysconfig.get_paths()["purelib"], "pychecker", "checker.py" + ) + if not os.path.isfile(py): + result = "Can't find python.exe!\n" + elif not os.path.isfile(pychecker): + result = ( + "Can't find checker.py - please install pychecker " + "(or run 'setup.py install' if you have the source version)\n" + ) + else: + cmd = '%s "%s" %s %s 2>&1' % (py, pychecker, options, files) + ##fin,fout,ferr=os.popen3(cmd) + ##result=ferr.read()+fout.read() + result = os.popen(cmd).read() + ##rc=f.close() + self.GetFirstView().Append(result) + finally: + self.result = result + print("== Pychecker run finished ==") + self.GetFirstView().Append("\n" + "== Pychecker run finished ==") + self.SetModifiedFlag(0) + + def _inactive_idleHandler(self, handler, count): + self.fndx = self.fndx + 1 + if self.fndx < len(self.flist): + f = self.flist[self.fndx] + if self.verbose: + self.GetFirstView().Append("# .." + f + "\n") + win32ui.SetStatusText("Searching " + f, 0) + lines = open(f, "r").readlines() + for i in range(len(lines)): + line = lines[i] + if self.pat.search(line) != None: + self.GetFirstView().Append(f + "(" + repr(i + 1) + ") " + line) + else: + self.fndx = -1 + self.fpndx = self.fpndx + 1 + if self.fpndx < len(self.fplist): + self.flist = glob.glob( + self.dp[self.dpndx] + "\\" + self.fplist[self.fpndx] + ) + else: + self.fpndx = 0 + self.dpndx = self.dpndx + 1 + if self.dpndx < len(self.dp): + self.flist = glob.glob( + self.dp[self.dpndx] + "\\" + self.fplist[self.fpndx] + ) + else: + win32ui.SetStatusText("Search complete.", 0) + self.SetModifiedFlag(0) # default to not modified. + try: + win32ui.GetApp().DeleteIdleHandler(self.idleHandler) + except: + pass + return 0 + return 1 + + def GetParams(self): + return ( + self.dirpattern + + "\t" + + self.filpattern + + "\t" + + self.greppattern + + "\t" + + repr(self.casesensitive) + + "\t" + + repr(self.recurse) + + "\t" + + repr(self.verbose) + ) + + def OnSaveDocument(self, filename): + # print 'OnSaveDocument() filename=',filename + savefile = open(filename, "wb") + txt = self.GetParams() + "\n" + # print 'writing',txt + savefile.write(txt) + savefile.close() + self.SetModifiedFlag(0) + return 1 + + +ID_OPEN_FILE = 0xE500 +ID_PYCHECKER = 0xE501 +ID_SAVERESULTS = 0x502 +ID_TRYAGAIN = 0x503 +ID_ADDCOMMENT = 0x504 +ID_ADDPYCHECKNO2 = 0x505 + + +class TheView(docview.RichEditView): + def __init__(self, doc): + docview.RichEditView.__init__(self, doc) + self.SetWordWrap(win32ui.CRichEditView_WrapNone) + self.HookHandlers() + + def OnInitialUpdate(self): + rc = self._obj_.OnInitialUpdate() + format = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New") + self.SetDefaultCharFormat(format) + return rc + + def HookHandlers(self): + self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN) + self.HookCommand(self.OnCmdOpenFile, ID_OPEN_FILE) + self.HookCommand(self.OnCmdThe, ID_PYCHECKER) + self.HookCommand(self.OnCmdSave, ID_SAVERESULTS) + self.HookCommand(self.OnTryAgain, ID_TRYAGAIN) + self.HookCommand(self.OnAddComment, ID_ADDCOMMENT) + self.HookCommand(self.OnAddComment, ID_ADDPYCHECKNO2) + self.HookMessage(self.OnLDblClick, win32con.WM_LBUTTONDBLCLK) + + def OnLDblClick(self, params): + line = self.GetLine() + regexGrepResult = regexGrep.match(line) + if regexGrepResult: + fname = regexGrepResult.group(1) + line = int(regexGrepResult.group(2)) + scriptutils.JumpToDocument(fname, line) + return 0 # dont pass on + return 1 # pass it on by default. + + def OnRClick(self, params): + menu = win32ui.CreatePopupMenu() + flags = win32con.MF_STRING | win32con.MF_ENABLED + lineno = self._obj_.LineFromChar(-1) # selection or current line + line = self._obj_.GetLine(lineno) + regexGrepResult = regexGrep.match(line) + charstart, charend = self._obj_.GetSel() + if regexGrepResult: + self.fnm = regexGrepResult.group(1) + self.lnnum = int(regexGrepResult.group(2)) + menu.AppendMenu(flags, ID_OPEN_FILE, "&Open " + self.fnm) + menu.AppendMenu( + flags, ID_ADDCOMMENT, "&Add to source: Comment Tag/#$pycheck_no .." + ) + menu.AppendMenu( + flags, + ID_ADDPYCHECKNO2, + "&Add to source: Specific #$pycheck_no=%(errtext)s ..", + ) + menu.AppendMenu(win32con.MF_SEPARATOR) + menu.AppendMenu(flags, ID_TRYAGAIN, "&Try Again") + menu.AppendMenu(flags, win32ui.ID_EDIT_CUT, "Cu&t") + menu.AppendMenu(flags, win32ui.ID_EDIT_COPY, "&Copy") + menu.AppendMenu(flags, win32ui.ID_EDIT_PASTE, "&Paste") + menu.AppendMenu(flags, win32con.MF_SEPARATOR) + menu.AppendMenu(flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all") + menu.AppendMenu(flags, win32con.MF_SEPARATOR) + menu.AppendMenu(flags, ID_SAVERESULTS, "Sa&ve results") + menu.TrackPopupMenu(params[5]) + return 0 + + def OnAddComment(self, cmd, code): + addspecific = cmd == ID_ADDPYCHECKNO2 + _ = list(self.GetSel()) + _.sort() + start, end = _ + line_start, line_end = self.LineFromChar(start), self.LineFromChar(end) + first = 1 + for i in range(line_start, line_end + 1): + line = self.GetLine(i) + m = regexGrep.match(line) + if m: + if first: + first = 0 + cmnt = dialog.GetSimpleInput( + "Add to %s lines" % (line_end - line_start + 1), + addspecific + and " #$pycheck_no=%(errtext)s" + or " #$pycheck_no", + ) + if not cmnt: + return 0 + ##import pywin.debugger;pywin.debugger.set_trace() + fname = m.group(1) + line = int(m.group(2)) + view = scriptutils.JumpToDocument(fname, line) + pos = view.LineIndex(line) - 1 + if view.GetTextRange(pos - 1, pos) in ("\r", "\n"): + pos -= 1 + view.SetSel(pos, pos) + errtext = m.group(3) + if start != end and line_start == line_end: + errtext = self.GetSelText() + errtext = repr(re.escape(errtext).replace("\ ", " ")) + view.ReplaceSel(addspecific and cmnt % locals() or cmnt) + return 0 + + def OnCmdOpenFile(self, cmd, code): + doc = win32ui.GetApp().OpenDocumentFile(self.fnm) + if doc: + vw = doc.GetFirstView() + # hope you have an editor that implements GotoLine()! + try: + vw.GotoLine(int(self.lnnum)) + except: + pass + return 0 + + def OnCmdThe(self, cmd, code): + curparamsstr = self.GetDocument().GetParams() + params = curparamsstr.split("\t") + params[2] = self.sel + greptemplate.setParams("\t".join(params)) + greptemplate.OpenDocumentFile() + return 0 + + def OnTryAgain(self, cmd, code): + greptemplate.setParams(self.GetDocument().GetParams()) + greptemplate.OpenDocumentFile() + return 0 + + def OnCmdSave(self, cmd, code): + flags = win32con.OFN_OVERWRITEPROMPT + dlg = win32ui.CreateFileDialog( + 0, None, None, flags, "Text Files (*.txt)|*.txt||", self + ) + dlg.SetOFNTitle("Save Results As") + if dlg.DoModal() == win32con.IDOK: + pn = dlg.GetPathName() + self._obj_.SaveFile(pn) + return 0 + + def Append(self, strng): + numlines = self.GetLineCount() + endpos = self.LineIndex(numlines - 1) + len(self.GetLine(numlines - 1)) + self.SetSel(endpos, endpos) + self.ReplaceSel(strng) + + +class TheDialog(dialog.Dialog): + def __init__(self, dp, fp, gp, cs, r, v): + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + CS = win32con.WS_CHILD | win32con.WS_VISIBLE + tmp = [ + ["Pychecker Run", (0, 0, 210, 90), style, None, (8, "MS Sans Serif")], + ] + tmp.append([STATIC, "Files:", -1, (7, 7, 50, 9), CS]) + tmp.append( + [ + EDIT, + gp, + 103, + (52, 7, 144, 11), + CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER, + ] + ) + tmp.append([STATIC, "Directories:", -1, (7, 20, 50, 9), CS]) + tmp.append( + [ + EDIT, + dp, + 102, + (52, 20, 128, 11), + CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER, + ] + ) + tmp.append( + [ + BUTTON, + "...", + 110, + (182, 20, 16, 11), + CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + tmp.append([STATIC, "Options:", -1, (7, 33, 50, 9), CS]) + tmp.append( + [ + EDIT, + fp, + 101, + (52, 33, 128, 11), + CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER, + ] + ) + tmp.append( + [ + BUTTON, + "...", + 111, + (182, 33, 16, 11), + CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + # tmp.append([BUTTON,'Case sensitive', 104, (7, 45, 72, 9), CS | win32con.BS_AUTOCHECKBOX | win32con.BS_LEFTTEXT| win32con.WS_TABSTOP]) + # tmp.append([BUTTON,'Subdirectories', 105, (7, 56, 72, 9), CS | win32con.BS_AUTOCHECKBOX | win32con.BS_LEFTTEXT| win32con.WS_TABSTOP]) + # tmp.append([BUTTON,'Verbose', 106, (7, 67, 72, 9), CS | win32con.BS_AUTOCHECKBOX | win32con.BS_LEFTTEXT| win32con.WS_TABSTOP]) + tmp.append( + [ + BUTTON, + "OK", + win32con.IDOK, + (166, 53, 32, 12), + CS | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + tmp.append( + [ + BUTTON, + "Cancel", + win32con.IDCANCEL, + (166, 67, 32, 12), + CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + dialog.Dialog.__init__(self, tmp) + self.AddDDX(101, "greppattern") + self.AddDDX(102, "dirpattern") + self.AddDDX(103, "filpattern") + # self.AddDDX(104,'casesensitive') + # self.AddDDX(105,'recursive') + # self.AddDDX(106,'verbose') + self._obj_.data["greppattern"] = gp + self._obj_.data["dirpattern"] = dp + self._obj_.data["filpattern"] = fp + # self._obj_.data['casesensitive'] = cs + # self._obj_.data['recursive'] = r + # self._obj_.data['verbose'] = v + self.HookCommand(self.OnMoreDirectories, 110) + self.HookCommand(self.OnMoreFiles, 111) + + def OnMoreDirectories(self, cmd, code): + self.getMore("Pychecker\\Directories", "dirpattern") + + def OnMoreFiles(self, cmd, code): + self.getMore("Pychecker\\File Types", "filpattern") + + def getMore(self, section, key): + self.UpdateData(1) + # get the items out of the ini file + ini = win32ui.GetProfileFileName() + secitems = win32api.GetProfileSection(section, ini) + items = [] + for secitem in secitems: + items.append(secitem.split("=")[1]) + dlg = TheParamsDialog(items) + if dlg.DoModal() == win32con.IDOK: + itemstr = ";".join(dlg.getItems()) + self._obj_.data[key] = itemstr + # update the ini file with dlg.getNew() + i = 0 + newitems = dlg.getNew() + if newitems: + items = items + newitems + for item in items: + win32api.WriteProfileVal(section, repr(i), item, ini) + i = i + 1 + self.UpdateData(0) + + def OnOK(self): + self.UpdateData(1) + for id, name in ( + (101, "greppattern"), + (102, "dirpattern"), + (103, "filpattern"), + ): + if not self[name]: + self.GetDlgItem(id).SetFocus() + win32api.MessageBeep() + win32ui.SetStatusText("Please enter a value") + return + self._obj_.OnOK() + + +class TheParamsDialog(dialog.Dialog): + def __init__(self, items): + self.items = items + self.newitems = [] + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + CS = win32con.WS_CHILD | win32con.WS_VISIBLE + tmp = [ + [ + "Pychecker Parameters", + (0, 0, 205, 100), + style, + None, + (8, "MS Sans Serif"), + ], + ] + tmp.append( + [ + LISTBOX, + "", + 107, + (7, 7, 150, 72), + CS + | win32con.LBS_MULTIPLESEL + | win32con.LBS_STANDARD + | win32con.LBS_HASSTRINGS + | win32con.WS_TABSTOP + | win32con.LBS_NOTIFY, + ] + ) + tmp.append( + [ + BUTTON, + "OK", + win32con.IDOK, + (167, 7, 32, 12), + CS | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + tmp.append( + [ + BUTTON, + "Cancel", + win32con.IDCANCEL, + (167, 23, 32, 12), + CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + tmp.append([STATIC, "New:", -1, (2, 83, 15, 12), CS]) + tmp.append( + [ + EDIT, + "", + 108, + (18, 83, 139, 12), + CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER, + ] + ) + tmp.append( + [ + BUTTON, + "Add", + 109, + (167, 83, 32, 12), + CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + dialog.Dialog.__init__(self, tmp) + self.HookCommand(self.OnAddItem, 109) + self.HookCommand(self.OnListDoubleClick, 107) + + def OnInitDialog(self): + lb = self.GetDlgItem(107) + for item in self.items: + lb.AddString(item) + return self._obj_.OnInitDialog() + + def OnAddItem(self, cmd, code): + eb = self.GetDlgItem(108) + item = eb.GetLine(0) + self.newitems.append(item) + lb = self.GetDlgItem(107) + i = lb.AddString(item) + lb.SetSel(i, 1) + return 1 + + def OnListDoubleClick(self, cmd, code): + if code == win32con.LBN_DBLCLK: + self.OnOK() + return 1 + + def OnOK(self): + lb = self.GetDlgItem(107) + self.selections = lb.GetSelTextItems() + self._obj_.OnOK() + + def getItems(self): + return self.selections + + def getNew(self): + return self.newitems + + +try: + win32ui.GetApp().RemoveDocTemplate(greptemplate) +except NameError: + pass + +greptemplate = TheTemplate() diff --git a/lib/pythonwin/pywin/framework/scriptutils.py b/lib/pythonwin/pywin/framework/scriptutils.py new file mode 100644 index 00000000..e5bc57c8 --- /dev/null +++ b/lib/pythonwin/pywin/framework/scriptutils.py @@ -0,0 +1,688 @@ +""" +Various utilities for running/importing a script +""" +import bdb +import linecache +import os +import sys +import traceback + +import __main__ +import win32api +import win32con +import win32ui +from pywin.mfc import dialog +from pywin.mfc.docview import TreeView + +from .cmdline import ParseArgs + +RS_DEBUGGER_NONE = 0 # Dont run under the debugger. +RS_DEBUGGER_STEP = 1 # Start stepping under the debugger +RS_DEBUGGER_GO = 2 # Just run under the debugger, stopping only at break-points. +RS_DEBUGGER_PM = 3 # Dont run under debugger, but do post-mortem analysis on exception. + +debugging_options = """No debugging +Step-through in the debugger +Run in the debugger +Post-Mortem of unhandled exceptions""".split( + "\n" +) + +byte_cr = "\r".encode("ascii") +byte_lf = "\n".encode("ascii") +byte_crlf = "\r\n".encode("ascii") + + +# A dialog box for the "Run Script" command. +class DlgRunScript(dialog.Dialog): + "A class for the 'run script' dialog" + + def __init__(self, bHaveDebugger): + dialog.Dialog.__init__(self, win32ui.IDD_RUN_SCRIPT) + self.AddDDX(win32ui.IDC_EDIT1, "script") + self.AddDDX(win32ui.IDC_EDIT2, "args") + self.AddDDX(win32ui.IDC_COMBO1, "debuggingType", "i") + self.HookCommand(self.OnBrowse, win32ui.IDC_BUTTON2) + self.bHaveDebugger = bHaveDebugger + + def OnInitDialog(self): + rc = dialog.Dialog.OnInitDialog(self) + cbo = self.GetDlgItem(win32ui.IDC_COMBO1) + for o in debugging_options: + cbo.AddString(o) + cbo.SetCurSel(self["debuggingType"]) + if not self.bHaveDebugger: + cbo.EnableWindow(0) + + def OnBrowse(self, id, code): + if code != 0: # BN_CLICKED + return 1 + openFlags = win32con.OFN_OVERWRITEPROMPT | win32con.OFN_FILEMUSTEXIST + dlg = win32ui.CreateFileDialog( + 1, None, None, openFlags, "Python Scripts (*.py)|*.py||", self + ) + dlg.SetOFNTitle("Run Script") + if dlg.DoModal() != win32con.IDOK: + return 0 + self["script"] = dlg.GetPathName() + self.UpdateData(0) + return 0 + + +def GetDebugger(): + """Get the default Python debugger. Returns the debugger, or None. + + It is assumed the debugger has a standard "pdb" defined interface. + Currently always returns the 'pywin.debugger' debugger, or None + (pdb is _not_ returned as it is not effective in this GUI environment) + """ + try: + import pywin.debugger + + return pywin.debugger + except ImportError: + return None + + +def IsOnPythonPath(path): + "Given a path only, see if it is on the Pythonpath. Assumes path is a full path spec." + # must check that the command line arg's path is in sys.path + for syspath in sys.path: + try: + # Python 1.5 and later allows an empty sys.path entry. + if syspath and win32ui.FullPath(syspath) == path: + return 1 + except win32ui.error as details: + print( + "Warning: The sys.path entry '%s' is invalid\n%s" % (syspath, details) + ) + return 0 + + +def GetPackageModuleName(fileName): + """Given a filename, return (module name, new path). + eg - given "c:\a\b\c\my.py", return ("b.c.my",None) if "c:\a" is on sys.path. + If no package found, will return ("my", "c:\a\b\c") + """ + path, fname = os.path.split(fileName) + path = origPath = win32ui.FullPath(path) + fname = os.path.splitext(fname)[0] + modBits = [] + newPathReturn = None + if not IsOnPythonPath(path): + # Module not directly on the search path - see if under a package. + while len(path) > 3: # ie 'C:\' + path, modBit = os.path.split(path) + modBits.append(modBit) + # If on path, _and_ existing package of that name loaded. + if ( + IsOnPythonPath(path) + and modBit in sys.modules + and ( + os.path.exists(os.path.join(path, modBit, "__init__.py")) + or os.path.exists(os.path.join(path, modBit, "__init__.pyc")) + or os.path.exists(os.path.join(path, modBit, "__init__.pyo")) + ) + ): + modBits.reverse() + return ".".join(modBits) + "." + fname, newPathReturn + # Not found - look a level higher + else: + newPathReturn = origPath + + return fname, newPathReturn + + +def GetActiveView(): + """Gets the edit control (eg, EditView) with the focus, or None""" + try: + childFrame, bIsMaximised = win32ui.GetMainFrame().MDIGetActive() + return childFrame.GetActiveView() + except win32ui.error: + return None + + +def GetActiveEditControl(): + view = GetActiveView() + if view is None: + return None + if hasattr(view, "SCIAddText"): # Is it a scintilla control? + return view + try: + return view.GetRichEditCtrl() + except AttributeError: + pass + try: + return view.GetEditCtrl() + except AttributeError: + pass + + +def GetActiveEditorDocument(): + """Returns the active editor document and view, or (None,None) if no + active document or its not an editor document. + """ + view = GetActiveView() + if view is None or isinstance(view, TreeView): + return (None, None) + doc = view.GetDocument() + if hasattr(doc, "MarkerAdd"): # Is it an Editor document? + return doc, view + return (None, None) + + +def GetActiveFileName(bAutoSave=1): + """Gets the file name for the active frame, saving it if necessary. + + Returns None if it cant be found, or raises KeyboardInterrupt. + """ + pathName = None + active = GetActiveView() + if active is None: + return None + try: + doc = active.GetDocument() + pathName = doc.GetPathName() + + if bAutoSave and ( + len(pathName) > 0 + or doc.GetTitle()[:8] == "Untitled" + or doc.GetTitle()[:6] == "Script" + ): # if not a special purpose window + if doc.IsModified(): + try: + doc.OnSaveDocument(pathName) + pathName = doc.GetPathName() + + # clear the linecache buffer + linecache.clearcache() + + except win32ui.error: + raise KeyboardInterrupt + + except (win32ui.error, AttributeError): + pass + if not pathName: + return None + return pathName + + +lastScript = "" +lastArgs = "" +lastDebuggingType = RS_DEBUGGER_NONE + + +def RunScript(defName=None, defArgs=None, bShowDialog=1, debuggingType=None): + global lastScript, lastArgs, lastDebuggingType + _debugger_stop_frame_ = 1 # Magic variable so the debugger will hide me! + + # Get the debugger - may be None! + debugger = GetDebugger() + + if defName is None: + try: + pathName = GetActiveFileName() + except KeyboardInterrupt: + return # User cancelled save. + else: + pathName = defName + if not pathName: + pathName = lastScript + if defArgs is None: + args = "" + if pathName == lastScript: + args = lastArgs + else: + args = defArgs + if debuggingType is None: + debuggingType = lastDebuggingType + + if not pathName or bShowDialog: + dlg = DlgRunScript(debugger is not None) + dlg["script"] = pathName + dlg["args"] = args + dlg["debuggingType"] = debuggingType + if dlg.DoModal() != win32con.IDOK: + return + script = dlg["script"] + args = dlg["args"] + debuggingType = dlg["debuggingType"] + if not script: + return + if debuggingType == RS_DEBUGGER_GO and debugger is not None: + # This may surprise users - they select "Run under debugger", but + # it appears not to! Only warn when they pick from the dialog! + # First - ensure the debugger is activated to pickup any break-points + # set in the editor. + try: + # Create the debugger, but _dont_ init the debugger GUI. + rd = debugger._GetCurrentDebugger() + except AttributeError: + rd = None + if rd is not None and len(rd.breaks) == 0: + msg = "There are no active break-points.\r\n\r\nSelecting this debug option without any\r\nbreak-points is unlikely to have the desired effect\r\nas the debugger is unlikely to be invoked..\r\n\r\nWould you like to step-through in the debugger instead?" + rc = win32ui.MessageBox( + msg, + win32ui.LoadString(win32ui.IDR_DEBUGGER), + win32con.MB_YESNOCANCEL | win32con.MB_ICONINFORMATION, + ) + if rc == win32con.IDCANCEL: + return + if rc == win32con.IDYES: + debuggingType = RS_DEBUGGER_STEP + + lastDebuggingType = debuggingType + lastScript = script + lastArgs = args + else: + script = pathName + + # try and open the script. + if ( + len(os.path.splitext(script)[1]) == 0 + ): # check if no extension supplied, and give one. + script = script + ".py" + # If no path specified, try and locate the file + path, fnameonly = os.path.split(script) + if len(path) == 0: + try: + os.stat(fnameonly) # See if it is OK as is... + script = fnameonly + except os.error: + fullScript = LocatePythonFile(script) + if fullScript is None: + win32ui.MessageBox("The file '%s' can not be located" % script) + return + script = fullScript + else: + path = win32ui.FullPath(path) + if not IsOnPythonPath(path): + sys.path.append(path) + + # py3k fun: If we use text mode to open the file, we get \r\n + # translated so Python allows the syntax (good!), but we get back + # text already decoded from the default encoding (bad!) and Python + # ignores any encoding decls (bad!). If we use binary mode we get + # the raw bytes and Python looks at the encoding (good!) but \r\n + # chars stay in place so Python throws a syntax error (bad!). + # So: so the binary thing and manually normalize \r\n. + try: + f = open(script, "rb") + except IOError as exc: + win32ui.MessageBox( + "The file could not be opened - %s (%d)" % (exc.strerror, exc.errno) + ) + return + + # Get the source-code - as above, normalize \r\n + code = f.read().replace(byte_crlf, byte_lf).replace(byte_cr, byte_lf) + byte_lf + + # Remember and hack sys.argv for the script. + oldArgv = sys.argv + sys.argv = ParseArgs(args) + sys.argv.insert(0, script) + # sys.path[0] is the path of the script + oldPath0 = sys.path[0] + newPath0 = os.path.split(script)[0] + if not oldPath0: # if sys.path[0] is empty + sys.path[0] = newPath0 + insertedPath0 = 0 + else: + sys.path.insert(0, newPath0) + insertedPath0 = 1 + bWorked = 0 + win32ui.DoWaitCursor(1) + base = os.path.split(script)[1] + # Allow windows to repaint before starting. + win32ui.PumpWaitingMessages() + win32ui.SetStatusText("Running script %s..." % base, 1) + exitCode = 0 + from pywin.framework import interact + + # Check the debugger flags + if debugger is None and (debuggingType != RS_DEBUGGER_NONE): + win32ui.MessageBox( + "No debugger is installed. Debugging options have been ignored!" + ) + debuggingType = RS_DEBUGGER_NONE + + # Get a code object - ignore the debugger for this, as it is probably a syntax error + # at this point + try: + codeObject = compile(code, script, "exec") + except: + # Almost certainly a syntax error! + _HandlePythonFailure("run script", script) + # No code object which to run/debug. + return + __main__.__file__ = script + try: + if debuggingType == RS_DEBUGGER_STEP: + debugger.run(codeObject, __main__.__dict__, start_stepping=1) + elif debuggingType == RS_DEBUGGER_GO: + debugger.run(codeObject, __main__.__dict__, start_stepping=0) + else: + # Post mortem or no debugging + exec(codeObject, __main__.__dict__) + bWorked = 1 + except bdb.BdbQuit: + # Dont print tracebacks when the debugger quit, but do print a message. + print("Debugging session cancelled.") + exitCode = 1 + bWorked = 1 + except SystemExit as code: + exitCode = code + bWorked = 1 + except KeyboardInterrupt: + # Consider this successful, as we dont want the debugger. + # (but we do want a traceback!) + if interact.edit and interact.edit.currentView: + interact.edit.currentView.EnsureNoPrompt() + traceback.print_exc() + if interact.edit and interact.edit.currentView: + interact.edit.currentView.AppendToPrompt([]) + bWorked = 1 + except: + if interact.edit and interact.edit.currentView: + interact.edit.currentView.EnsureNoPrompt() + traceback.print_exc() + if interact.edit and interact.edit.currentView: + interact.edit.currentView.AppendToPrompt([]) + if debuggingType == RS_DEBUGGER_PM: + debugger.pm() + del __main__.__file__ + sys.argv = oldArgv + if insertedPath0: + del sys.path[0] + else: + sys.path[0] = oldPath0 + f.close() + if bWorked: + win32ui.SetStatusText("Script '%s' returned exit code %s" % (script, exitCode)) + else: + win32ui.SetStatusText("Exception raised while running script %s" % base) + try: + sys.stdout.flush() + except AttributeError: + pass + + win32ui.DoWaitCursor(0) + + +def ImportFile(): + """This code looks for the current window, and determines if it can be imported. If not, + it will prompt for a file name, and allow it to be imported.""" + try: + pathName = GetActiveFileName() + except KeyboardInterrupt: + pathName = None + + if pathName is not None: + if os.path.splitext(pathName)[1].lower() not in (".py", ".pyw", ".pyx"): + pathName = None + + if pathName is None: + openFlags = win32con.OFN_OVERWRITEPROMPT | win32con.OFN_FILEMUSTEXIST + dlg = win32ui.CreateFileDialog( + 1, None, None, openFlags, "Python Scripts (*.py;*.pyw)|*.py;*.pyw;*.pyx||" + ) + dlg.SetOFNTitle("Import Script") + if dlg.DoModal() != win32con.IDOK: + return 0 + + pathName = dlg.GetPathName() + + # If already imported, dont look for package + path, modName = os.path.split(pathName) + modName, modExt = os.path.splitext(modName) + newPath = None + # note that some packages (*cough* email *cough*) use "lazy importers" + # meaning sys.modules can change as a side-effect of looking at + # module.__file__ - so we must take a copy (ie, items() in py2k, + # list(items()) in py3k) + for key, mod in list(sys.modules.items()): + if getattr(mod, "__file__", None): + fname = mod.__file__ + base, ext = os.path.splitext(fname) + if ext.lower() in (".pyo", ".pyc"): + ext = ".py" + fname = base + ext + if win32ui.ComparePath(fname, pathName): + modName = key + break + else: # for not broken + modName, newPath = GetPackageModuleName(pathName) + if newPath: + sys.path.append(newPath) + + if modName in sys.modules: + bNeedReload = 1 + what = "reload" + else: + what = "import" + bNeedReload = 0 + + win32ui.SetStatusText(what.capitalize() + "ing module...", 1) + win32ui.DoWaitCursor(1) + # win32ui.GetMainFrame().BeginWaitCursor() + + try: + # always do an import, as it is cheap if it's already loaded. This ensures + # it is in our name space. + codeObj = compile("import " + modName, "", "exec") + except SyntaxError: + win32ui.SetStatusText('Invalid filename for import: "' + modName + '"') + return + try: + exec(codeObj, __main__.__dict__) + mod = sys.modules.get(modName) + if bNeedReload: + from importlib import reload + + mod = reload(sys.modules[modName]) + win32ui.SetStatusText( + "Successfully " + + what + + "ed module '" + + modName + + "': %s" % getattr(mod, "__file__", "") + ) + except: + _HandlePythonFailure(what) + win32ui.DoWaitCursor(0) + + +def CheckFile(): + """This code looks for the current window, and gets Python to check it + without actually executing any code (ie, by compiling only) + """ + try: + pathName = GetActiveFileName() + except KeyboardInterrupt: + return + + what = "check" + win32ui.SetStatusText(what.capitalize() + "ing module...", 1) + win32ui.DoWaitCursor(1) + try: + f = open(pathName) + except IOError as details: + print("Cant open file '%s' - %s" % (pathName, details)) + return + try: + code = f.read() + "\n" + finally: + f.close() + try: + codeObj = compile(code, pathName, "exec") + if RunTabNanny(pathName): + win32ui.SetStatusText( + "Python and the TabNanny successfully checked the file '" + + os.path.basename(pathName) + + "'" + ) + except SyntaxError: + _HandlePythonFailure(what, pathName) + except: + traceback.print_exc() + _HandlePythonFailure(what) + win32ui.DoWaitCursor(0) + + +def RunTabNanny(filename): + import io as io + + tabnanny = FindTabNanny() + if tabnanny is None: + win32ui.MessageBox("The TabNanny is not around, so the children can run amok!") + return + + # Capture the tab-nanny output + newout = io.StringIO() + old_out = sys.stderr, sys.stdout + sys.stderr = sys.stdout = newout + try: + tabnanny.check(filename) + finally: + # Restore output + sys.stderr, sys.stdout = old_out + data = newout.getvalue() + if data: + try: + lineno = data.split()[1] + lineno = int(lineno) + _JumpToPosition(filename, lineno) + try: # Try and display whitespace + GetActiveEditControl().SCISetViewWS(1) + except: + pass + win32ui.SetStatusText("The TabNanny found trouble at line %d" % lineno) + except (IndexError, TypeError, ValueError): + print("The tab nanny complained, but I cant see where!") + print(data) + return 0 + return 1 + + +def _JumpToPosition(fileName, lineno, col=1): + JumpToDocument(fileName, lineno, col) + + +def JumpToDocument(fileName, lineno=0, col=1, nChars=0, bScrollToTop=0): + # Jump to the position in a file. + # If lineno is <= 0, dont move the position - just open/restore. + # if nChars > 0, select that many characters. + # if bScrollToTop, the specified line will be moved to the top of the window + # (eg, bScrollToTop should be false when jumping to an error line to retain the + # context, but true when jumping to a method defn, where we want the full body. + # Return the view which is editing the file, or None on error. + doc = win32ui.GetApp().OpenDocumentFile(fileName) + if doc is None: + return None + frame = doc.GetFirstView().GetParentFrame() + try: + view = frame.GetEditorView() + if frame.GetActiveView() != view: + frame.SetActiveView(view) + frame.AutoRestore() + except AttributeError: # Not an editor frame?? + view = doc.GetFirstView() + if lineno > 0: + charNo = view.LineIndex(lineno - 1) + start = charNo + col - 1 + size = view.GetTextLength() + try: + view.EnsureCharsVisible(charNo) + except AttributeError: + print("Doesnt appear to be one of our views?") + view.SetSel(min(start, size), min(start + nChars, size)) + if bScrollToTop: + curTop = view.GetFirstVisibleLine() + nScroll = (lineno - 1) - curTop + view.LineScroll(nScroll, 0) + view.SetFocus() + return view + + +def _HandlePythonFailure(what, syntaxErrorPathName=None): + typ, details, tb = sys.exc_info() + if isinstance(details, SyntaxError): + try: + msg, (fileName, line, col, text) = details + if (not fileName or fileName == "") and syntaxErrorPathName: + fileName = syntaxErrorPathName + _JumpToPosition(fileName, line, col) + except (TypeError, ValueError): + msg = str(details) + win32ui.SetStatusText("Failed to " + what + " - syntax error - %s" % msg) + else: + traceback.print_exc() + win32ui.SetStatusText("Failed to " + what + " - " + str(details)) + tb = None # Clean up a cycle. + + +# Find the Python TabNanny in either the standard library or the Python Tools/Scripts directory. +def FindTabNanny(): + try: + return __import__("tabnanny") + except ImportError: + pass + # OK - not in the standard library - go looking. + filename = "tabnanny.py" + try: + path = win32api.RegQueryValue( + win32con.HKEY_LOCAL_MACHINE, + "SOFTWARE\\Python\\PythonCore\\%s\\InstallPath" % (sys.winver), + ) + except win32api.error: + print("WARNING - The Python registry does not have an 'InstallPath' setting") + print(" The file '%s' can not be located" % (filename)) + return None + fname = os.path.join(path, "Tools\\Scripts\\%s" % filename) + try: + os.stat(fname) + except os.error: + print( + "WARNING - The file '%s' can not be located in path '%s'" % (filename, path) + ) + return None + + tabnannyhome, tabnannybase = os.path.split(fname) + tabnannybase = os.path.splitext(tabnannybase)[0] + # Put tab nanny at the top of the path. + sys.path.insert(0, tabnannyhome) + try: + return __import__(tabnannybase) + finally: + # remove the tab-nanny from the path + del sys.path[0] + + +def LocatePythonFile(fileName, bBrowseIfDir=1): + "Given a file name, return a fully qualified file name, or None" + # first look for the exact file as specified + if not os.path.isfile(fileName): + # Go looking! + baseName = fileName + for path in sys.path: + fileName = os.path.abspath(os.path.join(path, baseName)) + if os.path.isdir(fileName): + if bBrowseIfDir: + d = win32ui.CreateFileDialog( + 1, "*.py", None, 0, "Python Files (*.py)|*.py|All files|*.*" + ) + d.SetOFNInitialDir(fileName) + rc = d.DoModal() + if rc == win32con.IDOK: + fileName = d.GetPathName() + break + else: + return None + else: + fileName = fileName + ".py" + if os.path.isfile(fileName): + break # Found it! + + else: # for not broken out of + return None + return win32ui.FullPath(fileName) diff --git a/lib/pythonwin/pywin/framework/sgrepmdi.py b/lib/pythonwin/pywin/framework/sgrepmdi.py new file mode 100644 index 00000000..b7d938bb --- /dev/null +++ b/lib/pythonwin/pywin/framework/sgrepmdi.py @@ -0,0 +1,758 @@ +# SGrepMDI is by Gordon McMillan (gmcm@hypernet.com) +# It does basically what Find In Files does in MSVC with a couple enhancements. +# - It saves any directories in the app's ini file (if you want to get rid +# of them you'll have to edit the file) +# - "Directories" can be directories, +# - semicolon separated lists of "directories", +# - environment variables that evaluate to "directories", +# - registry path names that evaluate to "directories", +# - all of which is recursive, so you can mix them all up. +# - It is MDI, so you can 'nest' greps and return to earlier ones, +# (ie, have multiple results open at the same time) +# - Like FIF, double clicking a line opens an editor and takes you to the line. +# - You can highlight text, right click and start a new grep with the selected +# text as search pattern and same directories etc as before. +# - You can save grep parameters (so you don't lose your hardearned pattern) +# from File|Save +# - You can save grep results by right clicking in the result window. +# Hats off to Mark Hammond for providing an environment where I could cobble +# something like this together in a couple evenings! + +import glob +import os +import re + +import win32api +import win32con +import win32ui +from pywin.mfc import dialog, docview, window + +from . import scriptutils + + +def getsubdirs(d): + dlist = [] + flist = glob.glob(d + "\\*") + for f in flist: + if os.path.isdir(f): + dlist.append(f) + dlist = dlist + getsubdirs(f) + return dlist + + +class dirpath: + def __init__(self, str, recurse=0): + dp = str.split(";") + dirs = {} + for d in dp: + if os.path.isdir(d): + d = d.lower() + if d not in dirs: + dirs[d] = None + if recurse: + subdirs = getsubdirs(d) + for sd in subdirs: + sd = sd.lower() + if sd not in dirs: + dirs[sd] = None + elif os.path.isfile(d): + pass + else: + x = None + if d in os.environ: + x = dirpath(os.environ[d]) + elif d[:5] == "HKEY_": + keystr = d.split("\\") + try: + root = eval("win32con." + keystr[0]) + except: + win32ui.MessageBox( + "Can't interpret registry key name '%s'" % keystr[0] + ) + try: + subkey = "\\".join(keystr[1:]) + val = win32api.RegQueryValue(root, subkey) + if val: + x = dirpath(val) + else: + win32ui.MessageBox( + "Registry path '%s' did not return a path entry" % d + ) + except: + win32ui.MessageBox( + "Can't interpret registry key value: %s" % keystr[1:] + ) + else: + win32ui.MessageBox("Directory '%s' not found" % d) + if x: + for xd in x: + if xd not in dirs: + dirs[xd] = None + if recurse: + subdirs = getsubdirs(xd) + for sd in subdirs: + sd = sd.lower() + if sd not in dirs: + dirs[sd] = None + self.dirs = [] + for d in list(dirs.keys()): + self.dirs.append(d) + + def __getitem__(self, key): + return self.dirs[key] + + def __len__(self): + return len(self.dirs) + + def __setitem__(self, key, value): + self.dirs[key] = value + + def __delitem__(self, key): + del self.dirs[key] + + def __getslice__(self, lo, hi): + return self.dirs[lo:hi] + + def __setslice__(self, lo, hi, seq): + self.dirs[lo:hi] = seq + + def __delslice__(self, lo, hi): + del self.dirs[lo:hi] + + def __add__(self, other): + if type(other) == type(self) or type(other) == type([]): + return self.dirs + other.dirs + + def __radd__(self, other): + if type(other) == type(self) or type(other) == type([]): + return other.dirs + self.dirs + + +# Group(1) is the filename, group(2) is the lineno. +# regexGrepResult=regex.compile("^\\([a-zA-Z]:.*\\)(\\([0-9]+\\))") + +regexGrep = re.compile(r"^([a-zA-Z]:[^(]*)\(([0-9]+)\)") + +# these are the atom numbers defined by Windows for basic dialog controls + +BUTTON = 0x80 +EDIT = 0x81 +STATIC = 0x82 +LISTBOX = 0x83 +SCROLLBAR = 0x84 +COMBOBOX = 0x85 + + +class GrepTemplate(docview.RichEditDocTemplate): + def __init__(self): + docview.RichEditDocTemplate.__init__( + self, win32ui.IDR_TEXTTYPE, GrepDocument, GrepFrame, GrepView + ) + self.SetDocStrings("\nGrep\nGrep\nGrep params (*.grep)\n.grep\n\n\n") + win32ui.GetApp().AddDocTemplate(self) + self.docparams = None + + def MatchDocType(self, fileName, fileType): + doc = self.FindOpenDocument(fileName) + if doc: + return doc + ext = os.path.splitext(fileName)[1].lower() + if ext == ".grep": + return win32ui.CDocTemplate_Confidence_yesAttemptNative + return win32ui.CDocTemplate_Confidence_noAttempt + + def setParams(self, params): + self.docparams = params + + def readParams(self): + tmp = self.docparams + self.docparams = None + return tmp + + +class GrepFrame(window.MDIChildWnd): + # The template and doc params will one day be removed. + def __init__(self, wnd=None): + window.MDIChildWnd.__init__(self, wnd) + + +class GrepDocument(docview.RichEditDoc): + def __init__(self, template): + docview.RichEditDoc.__init__(self, template) + self.dirpattern = "" + self.filpattern = "" + self.greppattern = "" + self.casesensitive = 1 + self.recurse = 1 + self.verbose = 0 + + def OnOpenDocument(self, fnm): + # this bizarre stuff with params is so right clicking in a result window + # and starting a new grep can communicate the default parameters to the + # new grep. + try: + params = open(fnm, "r").read() + except: + params = None + self.setInitParams(params) + return self.OnNewDocument() + + def OnCloseDocument(self): + try: + win32ui.GetApp().DeleteIdleHandler(self.SearchFile) + except: + pass + return self._obj_.OnCloseDocument() + + def saveInitParams(self): + # Only save the flags, not the text boxes. + paramstr = "\t%s\t\t%d\t%d" % ( + self.filpattern, + self.casesensitive, + self.recurse, + ) + win32ui.WriteProfileVal("Grep", "Params", paramstr) + + def setInitParams(self, paramstr): + if paramstr is None: + paramstr = win32ui.GetProfileVal("Grep", "Params", "\t\t\t1\t0\t0") + params = paramstr.split("\t") + if len(params) < 3: + params = params + [""] * (3 - len(params)) + if len(params) < 6: + params = params + [0] * (6 - len(params)) + self.dirpattern = params[0] + self.filpattern = params[1] + self.greppattern = params[2] + self.casesensitive = int(params[3]) + self.recurse = int(params[4]) + self.verbose = int(params[5]) + # setup some reasonable defaults. + if not self.dirpattern: + try: + editor = win32ui.GetMainFrame().MDIGetActive()[0].GetEditorView() + self.dirpattern = os.path.abspath( + os.path.dirname(editor.GetDocument().GetPathName()) + ) + except (AttributeError, win32ui.error): + self.dirpattern = os.getcwd() + if not self.filpattern: + self.filpattern = "*.py" + + def OnNewDocument(self): + if self.dirpattern == "": + self.setInitParams(greptemplate.readParams()) + d = GrepDialog( + self.dirpattern, + self.filpattern, + self.greppattern, + self.casesensitive, + self.recurse, + self.verbose, + ) + if d.DoModal() == win32con.IDOK: + self.dirpattern = d["dirpattern"] + self.filpattern = d["filpattern"] + self.greppattern = d["greppattern"] + self.casesensitive = d["casesensitive"] + self.recurse = d["recursive"] + self.verbose = d["verbose"] + self.doSearch() + self.saveInitParams() + return 1 + return 0 # cancelled - return zero to stop frame creation. + + def doSearch(self): + self.dp = dirpath(self.dirpattern, self.recurse) + self.SetTitle("Grep for %s in %s" % (self.greppattern, self.filpattern)) + # self.text = [] + self.GetFirstView().Append("#Search " + self.dirpattern + "\n") + if self.verbose: + self.GetFirstView().Append("# =" + repr(self.dp.dirs) + "\n") + self.GetFirstView().Append("# Files " + self.filpattern + "\n") + self.GetFirstView().Append("# For " + self.greppattern + "\n") + self.fplist = self.filpattern.split(";") + if self.casesensitive: + self.pat = re.compile(self.greppattern) + else: + self.pat = re.compile(self.greppattern, re.IGNORECASE) + win32ui.SetStatusText("Searching. Please wait...", 0) + self.dpndx = self.fpndx = 0 + self.fndx = -1 + if not self.dp: + self.GetFirstView().Append( + "# ERROR: '%s' does not resolve to any search locations" + % self.dirpattern + ) + self.SetModifiedFlag(0) + else: + self.flist = glob.glob(self.dp[0] + "\\" + self.fplist[0]) + win32ui.GetApp().AddIdleHandler(self.SearchFile) + + def SearchFile(self, handler, count): + self.fndx = self.fndx + 1 + if self.fndx < len(self.flist): + f = self.flist[self.fndx] + if self.verbose: + self.GetFirstView().Append("# .." + f + "\n") + # Directories may match the file type pattern, and files may be removed + # while grep is running + if os.path.isfile(f): + win32ui.SetStatusText("Searching " + f, 0) + lines = open(f, "r").readlines() + for i in range(len(lines)): + line = lines[i] + if self.pat.search(line) != None: + self.GetFirstView().Append(f + "(" + repr(i + 1) + ") " + line) + else: + self.fndx = -1 + self.fpndx = self.fpndx + 1 + if self.fpndx < len(self.fplist): + self.flist = glob.glob( + self.dp[self.dpndx] + "\\" + self.fplist[self.fpndx] + ) + else: + self.fpndx = 0 + self.dpndx = self.dpndx + 1 + if self.dpndx < len(self.dp): + self.flist = glob.glob( + self.dp[self.dpndx] + "\\" + self.fplist[self.fpndx] + ) + else: + win32ui.SetStatusText("Search complete.", 0) + self.SetModifiedFlag(0) # default to not modified. + try: + win32ui.GetApp().DeleteIdleHandler(self.SearchFile) + except: + pass + return 0 + return 1 + + def GetParams(self): + return ( + self.dirpattern + + "\t" + + self.filpattern + + "\t" + + self.greppattern + + "\t" + + repr(self.casesensitive) + + "\t" + + repr(self.recurse) + + "\t" + + repr(self.verbose) + ) + + def OnSaveDocument(self, filename): + # print 'OnSaveDocument() filename=',filename + savefile = open(filename, "wb") + txt = self.GetParams() + "\n" + # print 'writing',txt + savefile.write(txt) + savefile.close() + self.SetModifiedFlag(0) + return 1 + + +ID_OPEN_FILE = 0xE400 +ID_GREP = 0xE401 +ID_SAVERESULTS = 0x402 +ID_TRYAGAIN = 0x403 + + +class GrepView(docview.RichEditView): + def __init__(self, doc): + docview.RichEditView.__init__(self, doc) + self.SetWordWrap(win32ui.CRichEditView_WrapNone) + self.HookHandlers() + + def OnInitialUpdate(self): + rc = self._obj_.OnInitialUpdate() + format = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New") + self.SetDefaultCharFormat(format) + return rc + + def HookHandlers(self): + self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN) + self.HookCommand(self.OnCmdOpenFile, ID_OPEN_FILE) + self.HookCommand(self.OnCmdGrep, ID_GREP) + self.HookCommand(self.OnCmdSave, ID_SAVERESULTS) + self.HookCommand(self.OnTryAgain, ID_TRYAGAIN) + self.HookMessage(self.OnLDblClick, win32con.WM_LBUTTONDBLCLK) + + def OnLDblClick(self, params): + line = self.GetLine() + regexGrepResult = regexGrep.match(line) + if regexGrepResult: + fname = regexGrepResult.group(1) + line = int(regexGrepResult.group(2)) + scriptutils.JumpToDocument(fname, line) + return 0 # dont pass on + return 1 # pass it on by default. + + def OnRClick(self, params): + menu = win32ui.CreatePopupMenu() + flags = win32con.MF_STRING | win32con.MF_ENABLED + lineno = self._obj_.LineFromChar(-1) # selection or current line + line = self._obj_.GetLine(lineno) + regexGrepResult = regexGrep.match(line) + if regexGrepResult: + self.fnm = regexGrepResult.group(1) + self.lnnum = int(regexGrepResult.group(2)) + menu.AppendMenu(flags, ID_OPEN_FILE, "&Open " + self.fnm) + menu.AppendMenu(win32con.MF_SEPARATOR) + menu.AppendMenu(flags, ID_TRYAGAIN, "&Try Again") + charstart, charend = self._obj_.GetSel() + if charstart != charend: + linestart = self._obj_.LineIndex(lineno) + self.sel = line[charstart - linestart : charend - linestart] + menu.AppendMenu(flags, ID_GREP, "&Grep for " + self.sel) + menu.AppendMenu(win32con.MF_SEPARATOR) + menu.AppendMenu(flags, win32ui.ID_EDIT_CUT, "Cu&t") + menu.AppendMenu(flags, win32ui.ID_EDIT_COPY, "&Copy") + menu.AppendMenu(flags, win32ui.ID_EDIT_PASTE, "&Paste") + menu.AppendMenu(flags, win32con.MF_SEPARATOR) + menu.AppendMenu(flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all") + menu.AppendMenu(flags, win32con.MF_SEPARATOR) + menu.AppendMenu(flags, ID_SAVERESULTS, "Sa&ve results") + menu.TrackPopupMenu(params[5]) + return 0 + + def OnCmdOpenFile(self, cmd, code): + doc = win32ui.GetApp().OpenDocumentFile(self.fnm) + if doc: + vw = doc.GetFirstView() + # hope you have an editor that implements GotoLine()! + try: + vw.GotoLine(int(self.lnnum)) + except: + pass + return 0 + + def OnCmdGrep(self, cmd, code): + if code != 0: + return 1 + curparamsstr = self.GetDocument().GetParams() + params = curparamsstr.split("\t") + params[2] = self.sel + greptemplate.setParams("\t".join(params)) + greptemplate.OpenDocumentFile() + return 0 + + def OnTryAgain(self, cmd, code): + if code != 0: + return 1 + greptemplate.setParams(self.GetDocument().GetParams()) + greptemplate.OpenDocumentFile() + return 0 + + def OnCmdSave(self, cmd, code): + if code != 0: + return 1 + flags = win32con.OFN_OVERWRITEPROMPT + dlg = win32ui.CreateFileDialog( + 0, None, None, flags, "Text Files (*.txt)|*.txt||", self + ) + dlg.SetOFNTitle("Save Results As") + if dlg.DoModal() == win32con.IDOK: + pn = dlg.GetPathName() + self._obj_.SaveTextFile(pn) + return 0 + + def Append(self, strng): + numlines = self.GetLineCount() + endpos = self.LineIndex(numlines - 1) + len(self.GetLine(numlines - 1)) + self.SetSel(endpos, endpos) + self.ReplaceSel(strng) + + +class GrepDialog(dialog.Dialog): + def __init__(self, dp, fp, gp, cs, r, v): + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + CS = win32con.WS_CHILD | win32con.WS_VISIBLE + tmp = [ + ["Grep", (0, 0, 210, 90), style, None, (8, "MS Sans Serif")], + ] + tmp.append([STATIC, "Grep For:", -1, (7, 7, 50, 9), CS]) + tmp.append( + [ + EDIT, + gp, + 101, + (52, 7, 144, 11), + CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER, + ] + ) + tmp.append([STATIC, "Directories:", -1, (7, 20, 50, 9), CS]) + tmp.append( + [ + EDIT, + dp, + 102, + (52, 20, 128, 11), + CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER, + ] + ) + tmp.append( + [ + BUTTON, + "...", + 110, + (182, 20, 16, 11), + CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + tmp.append([STATIC, "File types:", -1, (7, 33, 50, 9), CS]) + tmp.append( + [ + EDIT, + fp, + 103, + (52, 33, 128, 11), + CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER, + ] + ) + tmp.append( + [ + BUTTON, + "...", + 111, + (182, 33, 16, 11), + CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + tmp.append( + [ + BUTTON, + "Case sensitive", + 104, + (7, 45, 72, 9), + CS + | win32con.BS_AUTOCHECKBOX + | win32con.BS_LEFTTEXT + | win32con.WS_TABSTOP, + ] + ) + tmp.append( + [ + BUTTON, + "Subdirectories", + 105, + (7, 56, 72, 9), + CS + | win32con.BS_AUTOCHECKBOX + | win32con.BS_LEFTTEXT + | win32con.WS_TABSTOP, + ] + ) + tmp.append( + [ + BUTTON, + "Verbose", + 106, + (7, 67, 72, 9), + CS + | win32con.BS_AUTOCHECKBOX + | win32con.BS_LEFTTEXT + | win32con.WS_TABSTOP, + ] + ) + tmp.append( + [ + BUTTON, + "OK", + win32con.IDOK, + (166, 53, 32, 12), + CS | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + tmp.append( + [ + BUTTON, + "Cancel", + win32con.IDCANCEL, + (166, 67, 32, 12), + CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + dialog.Dialog.__init__(self, tmp) + self.AddDDX(101, "greppattern") + self.AddDDX(102, "dirpattern") + self.AddDDX(103, "filpattern") + self.AddDDX(104, "casesensitive") + self.AddDDX(105, "recursive") + self.AddDDX(106, "verbose") + self._obj_.data["greppattern"] = gp + self._obj_.data["dirpattern"] = dp + self._obj_.data["filpattern"] = fp + self._obj_.data["casesensitive"] = cs + self._obj_.data["recursive"] = r + self._obj_.data["verbose"] = v + self.HookCommand(self.OnMoreDirectories, 110) + self.HookCommand(self.OnMoreFiles, 111) + + def OnMoreDirectories(self, cmd, code): + if code != 0: + return 1 + self.getMore("Grep\\Directories", "dirpattern") + + def OnMoreFiles(self, cmd, code): + if code != 0: + return 1 + self.getMore("Grep\\File Types", "filpattern") + + def getMore(self, section, key): + self.UpdateData(1) + # get the items out of the ini file + ini = win32ui.GetProfileFileName() + secitems = win32api.GetProfileSection(section, ini) + items = [] + for secitem in secitems: + items.append(secitem.split("=")[1]) + dlg = GrepParamsDialog(items) + if dlg.DoModal() == win32con.IDOK: + itemstr = ";".join(dlg.getItems()) + self._obj_.data[key] = itemstr + # update the ini file with dlg.getNew() + i = 0 + newitems = dlg.getNew() + if newitems: + items = items + newitems + for item in items: + win32api.WriteProfileVal(section, repr(i), item, ini) + i = i + 1 + self.UpdateData(0) + + def OnOK(self): + self.UpdateData(1) + for id, name in ( + (101, "greppattern"), + (102, "dirpattern"), + (103, "filpattern"), + ): + if not self[name]: + self.GetDlgItem(id).SetFocus() + win32api.MessageBeep() + win32ui.SetStatusText("Please enter a value") + return + self._obj_.OnOK() + + +class GrepParamsDialog(dialog.Dialog): + def __init__(self, items): + self.items = items + self.newitems = [] + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + CS = win32con.WS_CHILD | win32con.WS_VISIBLE + tmp = [ + ["Grep Parameters", (0, 0, 205, 100), style, None, (8, "MS Sans Serif")], + ] + tmp.append( + [ + LISTBOX, + "", + 107, + (7, 7, 150, 72), + CS + | win32con.LBS_MULTIPLESEL + | win32con.LBS_STANDARD + | win32con.LBS_HASSTRINGS + | win32con.WS_TABSTOP + | win32con.LBS_NOTIFY, + ] + ) + tmp.append( + [ + BUTTON, + "OK", + win32con.IDOK, + (167, 7, 32, 12), + CS | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + tmp.append( + [ + BUTTON, + "Cancel", + win32con.IDCANCEL, + (167, 23, 32, 12), + CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + tmp.append([STATIC, "New:", -1, (2, 83, 15, 12), CS]) + tmp.append( + [ + EDIT, + "", + 108, + (18, 83, 139, 12), + CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER, + ] + ) + tmp.append( + [ + BUTTON, + "Add", + 109, + (167, 83, 32, 12), + CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP, + ] + ) + dialog.Dialog.__init__(self, tmp) + self.HookCommand(self.OnAddItem, 109) + self.HookCommand(self.OnListDoubleClick, 107) + + def OnInitDialog(self): + lb = self.GetDlgItem(107) + for item in self.items: + lb.AddString(item) + return self._obj_.OnInitDialog() + + def OnAddItem(self, cmd, code): + if code != 0: + return 1 + eb = self.GetDlgItem(108) + item = eb.GetLine(0) + self.newitems.append(item) + lb = self.GetDlgItem(107) + i = lb.AddString(item) + lb.SetSel(i, 1) + return 1 + + def OnListDoubleClick(self, cmd, code): + if code == win32con.LBN_DBLCLK: + self.OnOK() + return 1 + + def OnOK(self): + lb = self.GetDlgItem(107) + self.selections = lb.GetSelTextItems() + self._obj_.OnOK() + + def getItems(self): + return self.selections + + def getNew(self): + return self.newitems + + +try: + win32ui.GetApp().RemoveDocTemplate(greptemplate) +except NameError: + pass + +greptemplate = GrepTemplate() diff --git a/lib/pythonwin/pywin/framework/startup.py b/lib/pythonwin/pywin/framework/startup.py new file mode 100644 index 00000000..4a732322 --- /dev/null +++ b/lib/pythonwin/pywin/framework/startup.py @@ -0,0 +1,80 @@ +# startup.py +# +"The main application startup code for PythonWin." + +# +# This does the basic command line handling. + +# Keep this as short as possible, cos error output is only redirected if +# this runs OK. Errors in imported modules are much better - the messages go somewhere (not any more :-) + +import os +import sys + +import win32api +import win32ui + +if not sys.argv: + # Initialize sys.argv from commandline. When sys.argv is empty list ( + # different from [''] meaning "no cmd line arguments" ), then C + # bootstrapping or another method of invocation failed to initialize + # sys.argv and it will be done here. ( This was a workaround for a bug in + # win32ui but is retained for other situations. ) + argv = win32api.CommandLineToArgv(win32api.GetCommandLine()) + sys.argv = argv[1:] + if os.getcwd() not in sys.path and "." not in sys.path: + sys.path.insert(0, os.getcwd()) + +# You may wish to redirect error output somewhere useful if you have startup errors. +# eg, 'import win32traceutil' will do this for you. +# import win32traceutil # Just uncomment this line to see error output! + +# An old class I used to use - generally only useful if Pythonwin is running under MSVC +# class DebugOutput: +# softspace=1 +# def write(self,message): +# win32ui.OutputDebug(message) +# sys.stderr=sys.stdout=DebugOutput() + +# To fix a problem with Pythonwin when started from the Pythonwin directory, +# we update the pywin path to ensure it is absolute. +# If it is indeed relative, it will be relative to our current directory. +# If its already absolute, then this will have no affect. +import pywin +import pywin.framework + +pywin.__path__[0] = win32ui.FullPath(pywin.__path__[0]) +pywin.framework.__path__[0] = win32ui.FullPath(pywin.framework.__path__[0]) + +# make a few wierd sys values. This is so later we can clobber sys.argv to trick +# scripts when running under a GUI environment. + +moduleName = "pywin.framework.intpyapp" +sys.appargvoffset = 0 +sys.appargv = sys.argv[:] +# Must check for /app param here. +if len(sys.argv) >= 2 and sys.argv[0].lower() in ("/app", "-app"): + from . import cmdline + + moduleName = cmdline.FixArgFileName(sys.argv[1]) + sys.appargvoffset = 2 + newargv = sys.argv[sys.appargvoffset :] + # newargv.insert(0, sys.argv[0]) + sys.argv = newargv + +# Import the application module. +__import__(moduleName) + +try: + win32ui.GetApp()._obj_ + # This worked - an app already exists - do nothing more +except (AttributeError, win32ui.error): + # This means either no app object exists at all, or the one + # that does exist does not have a Python class (ie, was created + # by the host .EXE). In this case, we do the "old style" init... + from . import app + + if app.AppBuilder is None: + raise TypeError("No application object has been registered") + + app.App = app.AppBuilder() diff --git a/lib/pythonwin/pywin/framework/stdin.py b/lib/pythonwin/pywin/framework/stdin.py new file mode 100644 index 00000000..2f3adcb6 --- /dev/null +++ b/lib/pythonwin/pywin/framework/stdin.py @@ -0,0 +1,176 @@ +# Copyright (c) 2000 David Abrahams. Permission to copy, use, modify, sell +# and distribute this software is granted provided this copyright +# notice appears in all copies. This software is provided "as is" without +# express or implied warranty, and with no claim as to its suitability for +# any purpose. +"""Provides a class Stdin which can be used to emulate the regular old +sys.stdin for the PythonWin interactive window. Right now it just pops +up a raw_input() dialog. With luck, someone will integrate it into the +actual PythonWin interactive window someday. + +WARNING: Importing this file automatically replaces sys.stdin with an +instance of Stdin (below). This is useful because you can just open +Stdin.py in PythonWin and hit the import button to get it set up right +if you don't feel like changing PythonWin's source. To put things back +the way they were, simply use this magic incantation: + import sys + sys.stdin = sys.stdin.real_file +""" +import sys + +try: + get_input_line = raw_input # py2x +except NameError: + get_input_line = input # py3k + + +class Stdin: + def __init__(self): + self.real_file = sys.stdin # NOTE: Likely to be None in py3k + self.buffer = "" + self.closed = False + + def __getattr__(self, name): + """Forward most functions to the real sys.stdin for absolute realism.""" + if self.real_file is None: + raise AttributeError(name) + return getattr(self.real_file, name) + + def isatty(self): + """Return 1 if the file is connected to a tty(-like) device, else 0.""" + return 1 + + def read(self, size=-1): + """Read at most size bytes from the file (less if the read + hits EOF or no more data is immediately available on a pipe, + tty or similar device). If the size argument is negative or + omitted, read all data until EOF is reached. The bytes are + returned as a string object. An empty string is returned when + EOF is encountered immediately. (For certain files, like ttys, + it makes sense to continue reading after an EOF is hit.)""" + result_size = self.__get_lines(size) + return self.__extract_from_buffer(result_size) + + def readline(self, size=-1): + """Read one entire line from the file. A trailing newline + character is kept in the string2.6 (but may be absent when a file ends + with an incomplete line). If the size argument is present and + non-negative, it is a maximum byte count (including the trailing + newline) and an incomplete line may be returned. An empty string is + returned when EOF is hit immediately. Note: unlike stdio's fgets(), + the returned string contains null characters ('\0') if they occurred + in the input. + """ + maximum_result_size = self.__get_lines(size, lambda buffer: "\n" in buffer) + + if "\n" in self.buffer[:maximum_result_size]: + result_size = self.buffer.find("\n", 0, maximum_result_size) + 1 + assert result_size > 0 + else: + result_size = maximum_result_size + + return self.__extract_from_buffer(result_size) + + def __extract_from_buffer(self, character_count): + """Remove the first character_count characters from the internal buffer and + return them. + """ + result = self.buffer[:character_count] + self.buffer = self.buffer[character_count:] + return result + + def __get_lines(self, desired_size, done_reading=lambda buffer: False): + """Keep adding lines to our internal buffer until done_reading(self.buffer) + is true or EOF has been reached or we have desired_size bytes in the buffer. + If desired_size < 0, we are never satisfied until we reach EOF. If done_reading + is not supplied, it is not consulted. + + If desired_size < 0, returns the length of the internal buffer. Otherwise, + returns desired_size. + """ + while not done_reading(self.buffer) and ( + desired_size < 0 or len(self.buffer) < desired_size + ): + try: + self.__get_line() + except ( + EOFError, + KeyboardInterrupt, + ): # deal with cancellation of get_input_line dialog + desired_size = len(self.buffer) # Be satisfied! + + if desired_size < 0: + return len(self.buffer) + else: + return desired_size + + def __get_line(self): + """Grab one line from get_input_line() and append it to the buffer.""" + line = get_input_line() + print(">>>", line) # echo input to console + self.buffer = self.buffer + line + "\n" + + def readlines(self, *sizehint): + """Read until EOF using readline() and return a list containing the lines + thus read. If the optional sizehint argument is present, instead of + reading up to EOF, whole lines totalling approximately sizehint bytes + (possibly after rounding up to an internal buffer size) are read. + """ + result = [] + total_read = 0 + while sizehint == () or total_read < sizehint[0]: + line = self.readline() + if line == "": + break + total_read = total_read + len(line) + result.append(line) + return result + + +if __name__ == "__main__": + test_input = r"""this is some test +input that I am hoping +~ +will be very instructive +and when I am done +I will have tested everything. +Twelve and twenty blackbirds +baked in a pie. Patty cake +patty cake so am I. +~ +Thirty-five niggling idiots! +Sell you soul to the devil, baby +""" + + def fake_raw_input(prompt=None): + """Replacement for raw_input() which pulls lines out of global test_input. + For testing only! + """ + global test_input + if "\n" not in test_input: + end_of_line_pos = len(test_input) + else: + end_of_line_pos = test_input.find("\n") + result = test_input[:end_of_line_pos] + test_input = test_input[end_of_line_pos + 1 :] + if len(result) == 0 or result[0] == "~": + raise EOFError() + return result + + get_input_line = fake_raw_input + + # Some completely inadequate tests, just to make sure the code's not totally broken + try: + x = Stdin() + print(x.read()) + print(x.readline()) + print(x.read(12)) + print(x.readline(47)) + print(x.readline(3)) + print(x.readlines()) + finally: + get_input_line = raw_input +else: + import sys + + sys.stdin = Stdin() diff --git a/lib/pythonwin/pywin/framework/toolmenu.py b/lib/pythonwin/pywin/framework/toolmenu.py new file mode 100644 index 00000000..3f739e09 --- /dev/null +++ b/lib/pythonwin/pywin/framework/toolmenu.py @@ -0,0 +1,284 @@ +# toolmenu.py + +import sys + +import win32api +import win32con +import win32ui + +from . import app + +tools = {} +idPos = 100 + +# The default items should no tools menu exist in the INI file. +defaultToolMenuItems = [ + ("Browser", "win32ui.GetApp().OnViewBrowse(0,0)"), + ( + "Browse PythonPath", + "from pywin.tools import browseProjects;browseProjects.Browse()", + ), + ("Edit Python Path", "from pywin.tools import regedit;regedit.EditRegistry()"), + ("COM Makepy utility", "from win32com.client import makepy;makepy.main()"), + ( + "COM Browser", + "from win32com.client import combrowse;combrowse.main(modal=False)", + ), + ( + "Trace Collector Debugging tool", + "from pywin.tools import TraceCollector;TraceCollector.MakeOutputWindow()", + ), +] + + +def LoadToolMenuItems(): + # Load from the registry. + items = [] + lookNo = 1 + while 1: + menu = win32ui.GetProfileVal("Tools Menu\\%s" % lookNo, "", "") + if menu == "": + break + cmd = win32ui.GetProfileVal("Tools Menu\\%s" % lookNo, "Command", "") + items.append((menu, cmd)) + lookNo = lookNo + 1 + + if len(items) == 0: + items = defaultToolMenuItems + return items + + +def WriteToolMenuItems(items): + # Items is a list of (menu, command) + # Delete the entire registry tree. + try: + mainKey = win32ui.GetAppRegistryKey() + toolKey = win32api.RegOpenKey(mainKey, "Tools Menu") + except win32ui.error: + toolKey = None + if toolKey is not None: + while 1: + try: + subkey = win32api.RegEnumKey(toolKey, 0) + except win32api.error: + break + win32api.RegDeleteKey(toolKey, subkey) + # Keys are now removed - write the new ones. + # But first check if we have the defaults - and if so, dont write anything! + if items == defaultToolMenuItems: + return + itemNo = 1 + for menu, cmd in items: + win32ui.WriteProfileVal("Tools Menu\\%s" % itemNo, "", menu) + win32ui.WriteProfileVal("Tools Menu\\%s" % itemNo, "Command", cmd) + itemNo = itemNo + 1 + + +def SetToolsMenu(menu, menuPos=None): + global tools + global idPos + + # todo - check the menu does not already exist. + # Create the new menu + toolsMenu = win32ui.CreatePopupMenu() + + # Load from the ini file. + items = LoadToolMenuItems() + for menuString, cmd in items: + tools[idPos] = (menuString, cmd, menuString) + toolsMenu.AppendMenu( + win32con.MF_ENABLED | win32con.MF_STRING, idPos, menuString + ) + win32ui.GetMainFrame().HookCommand(HandleToolCommand, idPos) + idPos = idPos + 1 + + # Find the correct spot to insert the new tools menu. + if menuPos is None: + menuPos = menu.GetMenuItemCount() - 2 + if menuPos < 0: + menuPos = 0 + + menu.InsertMenu( + menuPos, + win32con.MF_BYPOSITION + | win32con.MF_ENABLED + | win32con.MF_STRING + | win32con.MF_POPUP, + toolsMenu.GetHandle(), + "&Tools", + ) + + +def HandleToolCommand(cmd, code): + import re + import traceback + + global tools + (menuString, pyCmd, desc) = tools[cmd] + win32ui.SetStatusText("Executing tool %s" % desc, 1) + pyCmd = re.sub("\\\\n", "\n", pyCmd) + win32ui.DoWaitCursor(1) + oldFlag = None + try: + oldFlag = sys.stdout.template.writeQueueing + sys.stdout.template.writeQueueing = 0 + except (NameError, AttributeError): + pass + + try: + exec("%s\n" % pyCmd) + worked = 1 + except SystemExit: + # The program raised a SystemExit - ignore it. + worked = 1 + except: + print("Failed to execute command:\n%s" % pyCmd) + traceback.print_exc() + worked = 0 + if oldFlag is not None: + sys.stdout.template.writeQueueing = oldFlag + win32ui.DoWaitCursor(0) + if worked: + text = "Completed successfully." + else: + text = "Error executing %s." % desc + win32ui.SetStatusText(text, 1) + + +# The property page for maintaing the items on the Tools menu. +import commctrl +from pywin.mfc import dialog + +if win32ui.UNICODE: + LVN_ENDLABELEDIT = commctrl.LVN_ENDLABELEDITW +else: + LVN_ENDLABELEDIT = commctrl.LVN_ENDLABELEDITA + + +class ToolMenuPropPage(dialog.PropertyPage): + def __init__(self): + self.bImChangingEditControls = 0 # Am I programatically changing the controls? + dialog.PropertyPage.__init__(self, win32ui.IDD_PP_TOOLMENU) + + def OnInitDialog(self): + self.editMenuCommand = self.GetDlgItem(win32ui.IDC_EDIT2) + self.butNew = self.GetDlgItem(win32ui.IDC_BUTTON3) + + # Now hook the change notification messages for the edit controls. + self.HookCommand(self.OnCommandEditControls, win32ui.IDC_EDIT1) + self.HookCommand(self.OnCommandEditControls, win32ui.IDC_EDIT2) + + self.HookNotify(self.OnNotifyListControl, commctrl.LVN_ITEMCHANGED) + self.HookNotify(self.OnNotifyListControlEndLabelEdit, commctrl.LVN_ENDLABELEDIT) + + # Hook the button clicks. + self.HookCommand(self.OnButtonNew, win32ui.IDC_BUTTON3) # New Item + self.HookCommand(self.OnButtonDelete, win32ui.IDC_BUTTON4) # Delete item + self.HookCommand(self.OnButtonMove, win32ui.IDC_BUTTON1) # Move up + self.HookCommand(self.OnButtonMove, win32ui.IDC_BUTTON2) # Move down + + # Setup the columns in the list control + lc = self.GetDlgItem(win32ui.IDC_LIST1) + rect = lc.GetWindowRect() + cx = rect[2] - rect[0] + colSize = cx / 2 - win32api.GetSystemMetrics(win32con.SM_CXBORDER) - 1 + + item = commctrl.LVCFMT_LEFT, colSize, "Menu Text" + lc.InsertColumn(0, item) + + item = commctrl.LVCFMT_LEFT, colSize, "Python Command" + lc.InsertColumn(1, item) + + # Insert the existing tools menu + itemNo = 0 + for desc, cmd in LoadToolMenuItems(): + lc.InsertItem(itemNo, desc) + lc.SetItemText(itemNo, 1, cmd) + itemNo = itemNo + 1 + + self.listControl = lc + return dialog.PropertyPage.OnInitDialog(self) + + def OnOK(self): + # Write the menu back to the registry. + items = [] + itemLook = 0 + while 1: + try: + text = self.listControl.GetItemText(itemLook, 0) + if not text: + break + items.append((text, self.listControl.GetItemText(itemLook, 1))) + except win32ui.error: + # no more items! + break + itemLook = itemLook + 1 + WriteToolMenuItems(items) + return self._obj_.OnOK() + + def OnCommandEditControls(self, id, cmd): + # print "OnEditControls", id, cmd + if cmd == win32con.EN_CHANGE and not self.bImChangingEditControls: + itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED) + newText = self.editMenuCommand.GetWindowText() + self.listControl.SetItemText(itemNo, 1, newText) + + return 0 + + def OnNotifyListControlEndLabelEdit(self, id, cmd): + newText = self.listControl.GetEditControl().GetWindowText() + itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED) + self.listControl.SetItemText(itemNo, 0, newText) + + def OnNotifyListControl(self, id, cmd): + # print id, cmd + try: + itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED) + except win32ui.error: # No selection! + return + + self.bImChangingEditControls = 1 + try: + item = self.listControl.GetItem(itemNo, 1) + self.editMenuCommand.SetWindowText(item[4]) + finally: + self.bImChangingEditControls = 0 + + return 0 # we have handled this! + + def OnButtonNew(self, id, cmd): + if cmd == win32con.BN_CLICKED: + newIndex = self.listControl.GetItemCount() + self.listControl.InsertItem(newIndex, "Click to edit the text") + self.listControl.EnsureVisible(newIndex, 0) + + def OnButtonMove(self, id, cmd): + if cmd == win32con.BN_CLICKED: + try: + itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED) + except win32ui.error: + return + menu = self.listControl.GetItemText(itemNo, 0) + cmd = self.listControl.GetItemText(itemNo, 1) + if id == win32ui.IDC_BUTTON1: + # Move up + if itemNo > 0: + self.listControl.DeleteItem(itemNo) + # reinsert it. + self.listControl.InsertItem(itemNo - 1, menu) + self.listControl.SetItemText(itemNo - 1, 1, cmd) + else: + # Move down. + if itemNo < self.listControl.GetItemCount() - 1: + self.listControl.DeleteItem(itemNo) + # reinsert it. + self.listControl.InsertItem(itemNo + 1, menu) + self.listControl.SetItemText(itemNo + 1, 1, cmd) + + def OnButtonDelete(self, id, cmd): + if cmd == win32con.BN_CLICKED: + try: + itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED) + except win32ui.error: # No selection! + return + self.listControl.DeleteItem(itemNo) diff --git a/lib/pythonwin/pywin/framework/window.py b/lib/pythonwin/pywin/framework/window.py new file mode 100644 index 00000000..58fd4d95 --- /dev/null +++ b/lib/pythonwin/pywin/framework/window.py @@ -0,0 +1,14 @@ +# Framework Window classes. + +# Most Pythonwin windows should use these classes rather than +# the raw MFC ones if they want Pythonwin specific functionality. +import pywin.mfc.window +import win32con + + +class MDIChildWnd(pywin.mfc.window.MDIChildWnd): + def AutoRestore(self): + "If the window is minimised or maximised, restore it." + p = self.GetWindowPlacement() + if p[1] == win32con.SW_MINIMIZE or p[1] == win32con.SW_SHOWMINIMIZED: + self.SetWindowPlacement(p[0], win32con.SW_RESTORE, p[2], p[3], p[4]) diff --git a/lib/pythonwin/pywin/framework/winout.py b/lib/pythonwin/pywin/framework/winout.py new file mode 100644 index 00000000..e78e959a --- /dev/null +++ b/lib/pythonwin/pywin/framework/winout.py @@ -0,0 +1,594 @@ +# winout.py +# +# generic "output window" +# +# This Window will detect itself closing, and recreate next time output is +# written to it. + +# This has the option of writing output at idle time (by hooking the +# idle message, and queueing output) or writing as each +# write is executed. +# Updating the window directly gives a jerky appearance as many writes +# take place between commands, and the windows scrolls, and updates etc +# Updating at idle-time may defer all output of a long process, giving the +# appearence nothing is happening. +# There is a compromise "line" mode, which will output whenever +# a complete line is available. + +# behaviour depends on self.writeQueueing + +# This module is thread safe - output can originate from any thread. If any thread +# other than the main thread attempts to print, it is always queued until next idle time + +import queue +import re + +import win32api +import win32con +import win32ui +from pywin.framework import app, window +from pywin.mfc import docview + +debug = lambda msg: None + +##debug=win32ui.OutputDebugString +##import win32trace;win32trace.InitWrite() # for debugging - delete me! +##debug = win32trace.write + + +class flags: + # queueing of output. + WQ_NONE = 0 + WQ_LINE = 1 + WQ_IDLE = 2 + + +# WindowOutputDocumentParent=docview.RichEditDoc +# WindowOutputDocumentParent=docview.Document +import pywin.scintilla.document +from pywin import default_scintilla_encoding +from pywin.scintilla import scintillacon + +WindowOutputDocumentParent = pywin.scintilla.document.CScintillaDocument + + +class WindowOutputDocument(WindowOutputDocumentParent): + def SaveModified(self): + return 1 # say it is OK to destroy my document + + def OnSaveDocument(self, fileName): + win32ui.SetStatusText("Saving file...", 1) + try: + self.SaveFile(fileName) + except IOError as details: + win32ui.MessageBox("Error - could not save file\r\n\r\n%s" % details) + return 0 + win32ui.SetStatusText("Ready") + return 1 + + +class WindowOutputFrame(window.MDIChildWnd): + def __init__(self, wnd=None): + window.MDIChildWnd.__init__(self, wnd) + self.HookMessage(self.OnSizeMove, win32con.WM_SIZE) + self.HookMessage(self.OnSizeMove, win32con.WM_MOVE) + + def LoadFrame(self, idResource, style, wndParent, context): + self.template = context.template + return self._obj_.LoadFrame(idResource, style, wndParent, context) + + def PreCreateWindow(self, cc): + cc = self._obj_.PreCreateWindow(cc) + if ( + self.template.defSize + and self.template.defSize[0] != self.template.defSize[1] + ): + rect = app.RectToCreateStructRect(self.template.defSize) + cc = cc[0], cc[1], cc[2], cc[3], rect, cc[5], cc[6], cc[7], cc[8] + return cc + + def OnSizeMove(self, msg): + # so recreate maintains position. + # Need to map coordinates from the + # frame windows first child. + mdiClient = self.GetParent() + self.template.defSize = mdiClient.ScreenToClient(self.GetWindowRect()) + + def OnDestroy(self, message): + self.template.OnFrameDestroy(self) + return 1 + + +class WindowOutputViewImpl: + def __init__(self): + self.patErrorMessage = re.compile('\W*File "(.*)", line ([0-9]+)') + self.template = self.GetDocument().GetDocTemplate() + + def HookHandlers(self): + # Hook for the right-click menu. + self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN) + + def OnDestroy(self, msg): + self.template.OnViewDestroy(self) + + def OnInitialUpdate(self): + self.RestoreKillBuffer() + self.SetSel(-2) # end of buffer + + def GetRightMenuItems(self): + ret = [] + flags = win32con.MF_STRING | win32con.MF_ENABLED + ret.append((flags, win32ui.ID_EDIT_COPY, "&Copy")) + ret.append((flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all")) + return ret + + # + # Windows command handlers, virtuals, etc. + # + def OnRClick(self, params): + paramsList = self.GetRightMenuItems() + menu = win32ui.CreatePopupMenu() + for appendParams in paramsList: + if type(appendParams) != type(()): + appendParams = (appendParams,) + menu.AppendMenu(*appendParams) + menu.TrackPopupMenu(params[5]) # track at mouse position. + return 0 + + # as this is often used as an output window, exeptions will often + # be printed. Therefore, we support this functionality at this level. + # Returns TRUE if the current line is an error message line, and will + # jump to it. FALSE if no error (and no action taken) + def HandleSpecialLine(self): + from . import scriptutils + + line = self.GetLine() + if line[:11] == "com_error: ": + # An OLE Exception - pull apart the exception + # and try and locate a help file. + try: + import win32api + import win32con + + det = eval(line[line.find(":") + 1 :].strip()) + win32ui.SetStatusText("Opening help file on OLE error...") + from . import help + + help.OpenHelpFile(det[2][3], win32con.HELP_CONTEXT, det[2][4]) + return 1 + except win32api.error as details: + win32ui.SetStatusText( + "The help file could not be opened - %s" % details.strerror + ) + return 1 + except: + win32ui.SetStatusText( + "Line is a COM error, but no WinHelp details can be parsed" + ) + # Look for a Python traceback. + matchResult = self.patErrorMessage.match(line) + if matchResult is None: + # No match - try the previous line + lineNo = self.LineFromChar() + if lineNo > 0: + line = self.GetLine(lineNo - 1) + matchResult = self.patErrorMessage.match(line) + if matchResult is not None: + # we have an error line. + fileName = matchResult.group(1) + if fileName[0] == "<": + win32ui.SetStatusText("Can not load this file") + return 1 # still was an error message. + else: + lineNoString = matchResult.group(2) + # Attempt to locate the file (in case it is a relative spec) + fileNameSpec = fileName + fileName = scriptutils.LocatePythonFile(fileName) + if fileName is None: + # Dont force update, so it replaces the idle prompt. + win32ui.SetStatusText( + "Cant locate the file '%s'" % (fileNameSpec), 0 + ) + return 1 + + win32ui.SetStatusText( + "Jumping to line " + lineNoString + " of file " + fileName, 1 + ) + if not scriptutils.JumpToDocument(fileName, int(lineNoString)): + win32ui.SetStatusText("Could not open %s" % fileName) + return 1 # still was an error message. + return 1 + return 0 # not an error line + + def write(self, msg): + return self.template.write(msg) + + def writelines(self, lines): + for line in lines: + self.write(line) + + def flush(self): + self.template.flush() + + +class WindowOutputViewRTF(docview.RichEditView, WindowOutputViewImpl): + def __init__(self, doc): + docview.RichEditView.__init__(self, doc) + WindowOutputViewImpl.__init__(self) + + def OnInitialUpdate(self): + WindowOutputViewImpl.OnInitialUpdate(self) + return docview.RichEditView.OnInitialUpdate(self) + + def OnDestroy(self, msg): + WindowOutputViewImpl.OnDestroy(self, msg) + docview.RichEditView.OnDestroy(self, msg) + + def HookHandlers(self): + WindowOutputViewImpl.HookHandlers(self) + # Hook for finding and locating error messages + self.HookMessage(self.OnLDoubleClick, win32con.WM_LBUTTONDBLCLK) + + # docview.RichEditView.HookHandlers(self) + + def OnLDoubleClick(self, params): + if self.HandleSpecialLine(): + return 0 # dont pass on + return 1 # pass it on by default. + + def RestoreKillBuffer(self): + if len(self.template.killBuffer): + self.StreamIn(win32con.SF_RTF, self._StreamRTFIn) + self.template.killBuffer = [] + + def SaveKillBuffer(self): + self.StreamOut(win32con.SF_RTFNOOBJS, self._StreamRTFOut) + + def _StreamRTFOut(self, data): + self.template.killBuffer.append(data) + return 1 # keep em coming! + + def _StreamRTFIn(self, bytes): + try: + item = self.template.killBuffer[0] + self.template.killBuffer.remove(item) + if bytes < len(item): + print("Warning - output buffer not big enough!") + return item + except IndexError: + return None + + def dowrite(self, str): + self.SetSel(-2) + self.ReplaceSel(str) + + +import pywin.scintilla.view + + +class WindowOutputViewScintilla( + pywin.scintilla.view.CScintillaView, WindowOutputViewImpl +): + def __init__(self, doc): + pywin.scintilla.view.CScintillaView.__init__(self, doc) + WindowOutputViewImpl.__init__(self) + + def OnInitialUpdate(self): + pywin.scintilla.view.CScintillaView.OnInitialUpdate(self) + self.SCISetMarginWidth(3) + WindowOutputViewImpl.OnInitialUpdate(self) + + def OnDestroy(self, msg): + WindowOutputViewImpl.OnDestroy(self, msg) + pywin.scintilla.view.CScintillaView.OnDestroy(self, msg) + + def HookHandlers(self): + WindowOutputViewImpl.HookHandlers(self) + pywin.scintilla.view.CScintillaView.HookHandlers(self) + self.GetParent().HookNotify( + self.OnScintillaDoubleClick, scintillacon.SCN_DOUBLECLICK + ) + + ## self.HookMessage(self.OnLDoubleClick,win32con.WM_LBUTTONDBLCLK) + + def OnScintillaDoubleClick(self, std, extra): + self.HandleSpecialLine() + + ## def OnLDoubleClick(self,params): + ## return 0 # never dont pass on + + def RestoreKillBuffer(self): + assert len(self.template.killBuffer) in (0, 1), "Unexpected killbuffer contents" + if self.template.killBuffer: + self.SCIAddText(self.template.killBuffer[0]) + self.template.killBuffer = [] + + def SaveKillBuffer(self): + self.template.killBuffer = [self.GetTextRange(0, -1)] + + def dowrite(self, str): + end = self.GetTextLength() + atEnd = end == self.GetSel()[0] + self.SCIInsertText(str, end) + if atEnd: + self.SetSel(self.GetTextLength()) + + def SetWordWrap(self, bWrapOn=1): + if bWrapOn: + wrap_mode = scintillacon.SC_WRAP_WORD + else: + wrap_mode = scintillacon.SC_WRAP_NONE + self.SCISetWrapMode(wrap_mode) + + def _MakeColorizer(self): + return None # No colorizer for me! + + +WindowOutputView = WindowOutputViewScintilla + + +# The WindowOutput class is actually an MFC template. This is a conventient way of +# making sure that my state can exist beyond the life of the windows themselves. +# This is primarily to support the functionality of a WindowOutput window automatically +# being recreated if necessary when written to. +class WindowOutput(docview.DocTemplate): + """Looks like a general Output Window - text can be written by the 'write' method. + Will auto-create itself on first write, and also on next write after being closed""" + + softspace = 1 + + def __init__( + self, + title=None, + defSize=None, + queueing=flags.WQ_LINE, + bAutoRestore=1, + style=None, + makeDoc=None, + makeFrame=None, + makeView=None, + ): + """init the output window - + Params + title=None -- What is the title of the window + defSize=None -- What is the default size for the window - if this + is a string, the size will be loaded from the ini file. + queueing = flags.WQ_LINE -- When should output be written + bAutoRestore=1 -- Should a minimized window be restored. + style -- Style for Window, or None for default. + makeDoc, makeFrame, makeView -- Classes for frame, view and window respectively. + """ + if makeDoc is None: + makeDoc = WindowOutputDocument + if makeFrame is None: + makeFrame = WindowOutputFrame + if makeView is None: + makeView = WindowOutputViewScintilla + docview.DocTemplate.__init__( + self, win32ui.IDR_PYTHONTYPE, makeDoc, makeFrame, makeView + ) + self.SetDocStrings("\nOutput\n\nText Documents (*.txt)\n.txt\n\n\n") + win32ui.GetApp().AddDocTemplate(self) + self.writeQueueing = queueing + self.errorCantRecreate = 0 + self.killBuffer = [] + self.style = style + self.bAutoRestore = bAutoRestore + self.title = title + self.bCreating = 0 + self.interruptCount = 0 + if type(defSize) == type(""): # is a string - maintain size pos from ini file. + self.iniSizeSection = defSize + self.defSize = app.LoadWindowSize(defSize) + self.loadedSize = self.defSize + else: + self.iniSizeSection = None + self.defSize = defSize + self.currentView = None + self.outputQueue = queue.Queue(-1) + self.mainThreadId = win32api.GetCurrentThreadId() + self.idleHandlerSet = 0 + self.SetIdleHandler() + + def __del__(self): + self.Close() + + def Create(self, title=None, style=None): + self.bCreating = 1 + if title: + self.title = title + if style: + self.style = style + doc = self.OpenDocumentFile() + if doc is None: + return + self.currentView = doc.GetFirstView() + self.bCreating = 0 + if self.title: + doc.SetTitle(self.title) + + def Close(self): + self.RemoveIdleHandler() + try: + parent = self.currentView.GetParent() + except (AttributeError, win32ui.error): # Already closed + return + parent.DestroyWindow() + + def SetTitle(self, title): + self.title = title + if self.currentView: + self.currentView.GetDocument().SetTitle(self.title) + + def OnViewDestroy(self, view): + self.currentView.SaveKillBuffer() + self.currentView = None + + def OnFrameDestroy(self, frame): + if self.iniSizeSection: + # use GetWindowPlacement(), as it works even when min'd or max'd + newSize = frame.GetWindowPlacement()[4] + if self.loadedSize != newSize: + app.SaveWindowSize(self.iniSizeSection, newSize) + + def SetIdleHandler(self): + if not self.idleHandlerSet: + debug("Idle handler set\n") + win32ui.GetApp().AddIdleHandler(self.QueueIdleHandler) + self.idleHandlerSet = 1 + + def RemoveIdleHandler(self): + if self.idleHandlerSet: + debug("Idle handler reset\n") + if win32ui.GetApp().DeleteIdleHandler(self.QueueIdleHandler) == 0: + debug("Error deleting idle handler\n") + self.idleHandlerSet = 0 + + def RecreateWindow(self): + if self.errorCantRecreate: + debug("Error = not trying again") + return 0 + try: + # This will fail if app shutting down + win32ui.GetMainFrame().GetSafeHwnd() + self.Create() + return 1 + except (win32ui.error, AttributeError): + self.errorCantRecreate = 1 + debug("Winout can not recreate the Window!\n") + return 0 + + # this handles the idle message, and does the printing. + def QueueIdleHandler(self, handler, count): + try: + bEmpty = self.QueueFlush(20) + # If the queue is empty, then we are back to idle and restart interrupt logic. + if bEmpty: + self.interruptCount = 0 + except KeyboardInterrupt: + # First interrupt since idle we just pass on. + # later ones we dump the queue and give up. + self.interruptCount = self.interruptCount + 1 + if self.interruptCount > 1: + # Drop the queue quickly as the user is already annoyed :-) + self.outputQueue = queue.Queue(-1) + print("Interrupted.") + bEmpty = 1 + else: + raise # re-raise the error so the users exception filters up. + return not bEmpty # More to do if not empty. + + # Returns true if the Window needs to be recreated. + def NeedRecreateWindow(self): + try: + if self.currentView is not None and self.currentView.IsWindow(): + return 0 + except ( + win32ui.error, + AttributeError, + ): # Attribute error if the win32ui object has died. + pass + return 1 + + # Returns true if the Window is OK (either cos it was, or because it was recreated + def CheckRecreateWindow(self): + if self.bCreating: + return 1 + if not self.NeedRecreateWindow(): + return 1 + if self.bAutoRestore: + if self.RecreateWindow(): + return 1 + return 0 + + def QueueFlush(self, max=None): + # Returns true if the queue is empty after the flush + # debug("Queueflush - %d, %d\n" % (max, self.outputQueue.qsize())) + if self.bCreating: + return 1 + items = [] + rc = 0 + while max is None or max > 0: + try: + item = self.outputQueue.get_nowait() + items.append(item) + except queue.Empty: + rc = 1 + break + if max is not None: + max = max - 1 + if len(items) != 0: + if not self.CheckRecreateWindow(): + debug(":Recreate failed!\n") + return 1 # In trouble - so say we have nothing to do. + win32ui.PumpWaitingMessages() # Pump paint messages + self.currentView.dowrite("".join(items)) + return rc + + def HandleOutput(self, message): + # debug("QueueOutput on thread %d, flags %d with '%s'...\n" % (win32api.GetCurrentThreadId(), self.writeQueueing, message )) + self.outputQueue.put(message) + if win32api.GetCurrentThreadId() != self.mainThreadId: + pass + # debug("not my thread - ignoring queue options!\n") + elif self.writeQueueing == flags.WQ_LINE: + pos = message.rfind("\n") + if pos >= 0: + # debug("Line queueing - forcing flush\n") + self.QueueFlush() + return + elif self.writeQueueing == flags.WQ_NONE: + # debug("WQ_NONE - flushing!\n") + self.QueueFlush() + return + # Let our idle handler get it - wake it up + try: + win32ui.GetMainFrame().PostMessage( + win32con.WM_USER + ) # Kick main thread off. + except win32ui.error: + # This can happen as the app is shutting down, so we send it to the C++ debugger + win32api.OutputDebugString(message) + + # delegate certain fns to my view. + def writelines(self, lines): + for line in lines: + self.write(line) + + def write(self, message): + self.HandleOutput(message) + + def flush(self): + self.QueueFlush() + + def HandleSpecialLine(self): + self.currentView.HandleSpecialLine() + + +def RTFWindowOutput(*args, **kw): + kw["makeView"] = WindowOutputViewRTF + return WindowOutput(*args, **kw) + + +def thread_test(o): + for i in range(5): + o.write("Hi from thread %d\n" % (win32api.GetCurrentThreadId())) + win32api.Sleep(100) + + +def test(): + w = WindowOutput(queueing=flags.WQ_IDLE) + w.write("First bit of text\n") + import _thread + + for i in range(5): + w.write("Hello from the main thread\n") + _thread.start_new(thread_test, (w,)) + for i in range(2): + w.write("Hello from the main thread\n") + win32api.Sleep(50) + return w + + +if __name__ == "__main__": + test() diff --git a/lib/pythonwin/pywin/idle/AutoExpand.py b/lib/pythonwin/pywin/idle/AutoExpand.py new file mode 100644 index 00000000..3b302ee9 --- /dev/null +++ b/lib/pythonwin/pywin/idle/AutoExpand.py @@ -0,0 +1,95 @@ +import re +import string + +###$ event <> +###$ win +###$ unix + + +class AutoExpand: + keydefs = { + "<>": [""], + } + + unix_keydefs = { + "<>": [""], + } + + menudefs = [ + ( + "edit", + [ + ("E_xpand word", "<>"), + ], + ), + ] + + wordchars = string.ascii_letters + string.digits + "_" + + def __init__(self, editwin): + self.text = editwin.text + self.text.wordlist = None # XXX what is this? + self.state = None + + def expand_word_event(self, event): + curinsert = self.text.index("insert") + curline = self.text.get("insert linestart", "insert lineend") + if not self.state: + words = self.getwords() + index = 0 + else: + words, index, insert, line = self.state + if insert != curinsert or line != curline: + words = self.getwords() + index = 0 + if not words: + self.text.bell() + return "break" + word = self.getprevword() + self.text.delete("insert - %d chars" % len(word), "insert") + newword = words[index] + index = (index + 1) % len(words) + if index == 0: + self.text.bell() # Warn we cycled around + self.text.insert("insert", newword) + curinsert = self.text.index("insert") + curline = self.text.get("insert linestart", "insert lineend") + self.state = words, index, curinsert, curline + return "break" + + def getwords(self): + word = self.getprevword() + if not word: + return [] + before = self.text.get("1.0", "insert wordstart") + wbefore = re.findall(r"\b" + word + r"\w+\b", before) + del before + after = self.text.get("insert wordend", "end") + wafter = re.findall(r"\b" + word + r"\w+\b", after) + del after + if not wbefore and not wafter: + return [] + words = [] + dict = {} + # search backwards through words before + wbefore.reverse() + for w in wbefore: + if dict.get(w): + continue + words.append(w) + dict[w] = w + # search onwards through words after + for w in wafter: + if dict.get(w): + continue + words.append(w) + dict[w] = w + words.append(word) + return words + + def getprevword(self): + line = self.text.get("insert linestart", "insert") + i = len(line) + while i > 0 and line[i - 1] in self.wordchars: + i = i - 1 + return line[i:] diff --git a/lib/pythonwin/pywin/idle/AutoIndent.py b/lib/pythonwin/pywin/idle/AutoIndent.py new file mode 100644 index 00000000..c5adc5f8 --- /dev/null +++ b/lib/pythonwin/pywin/idle/AutoIndent.py @@ -0,0 +1,547 @@ +import sys +import tokenize + +from pywin import default_scintilla_encoding + +from . import PyParse + +if sys.version_info < (3,): + # in py2k, tokenize() takes a 'token eater' callback, while + # generate_tokens is a generator that works with str objects. + token_generator = tokenize.generate_tokens +else: + # in py3k tokenize() is the generator working with 'byte' objects, and + # token_generator is the 'undocumented b/w compat' function that + # theoretically works with str objects - but actually seems to fail) + token_generator = tokenize.tokenize + + +class AutoIndent: + menudefs = [ + ( + "edit", + [ + None, + ("_Indent region", "<>"), + ("_Dedent region", "<>"), + ("Comment _out region", "<>"), + ("U_ncomment region", "<>"), + ("Tabify region", "<>"), + ("Untabify region", "<>"), + ("Toggle tabs", "<>"), + ("New indent width", "<>"), + ], + ), + ] + + keydefs = { + "<>": [""], + "<>": ["", ""], + "<>": [""], + } + + windows_keydefs = { + "<>": [""], + "<>": [""], + "<>": [""], + "<>": [""], + "<>": [""], + "<>": [""], + "<>": [""], + "<>": [""], + } + + unix_keydefs = { + "<>": [ + "", + "", + "", + ], + "<>": [ + "", + "", + "", + ], + "<>": ["", ""], + "<>": ["", ""], + "<>": ["", ""], + "<>": ["", ""], + "<>": [""], + "<>": [""], + } + + # usetabs true -> literal tab characters are used by indent and + # dedent cmds, possibly mixed with spaces if + # indentwidth is not a multiple of tabwidth + # false -> tab characters are converted to spaces by indent + # and dedent cmds, and ditto TAB keystrokes + # indentwidth is the number of characters per logical indent level. + # tabwidth is the display width of a literal tab character. + # CAUTION: telling Tk to use anything other than its default + # tab setting causes it to use an entirely different tabbing algorithm, + # treating tab stops as fixed distances from the left margin. + # Nobody expects this, so for now tabwidth should never be changed. + usetabs = 1 + indentwidth = 4 + tabwidth = 8 # for IDLE use, must remain 8 until Tk is fixed + + # If context_use_ps1 is true, parsing searches back for a ps1 line; + # else searches for a popular (if, def, ...) Python stmt. + context_use_ps1 = 0 + + # When searching backwards for a reliable place to begin parsing, + # first start num_context_lines[0] lines back, then + # num_context_lines[1] lines back if that didn't work, and so on. + # The last value should be huge (larger than the # of lines in a + # conceivable file). + # Making the initial values larger slows things down more often. + num_context_lines = 50, 500, 5000000 + + def __init__(self, editwin): + self.editwin = editwin + self.text = editwin.text + + def config(self, **options): + for key, value in options.items(): + if key == "usetabs": + self.usetabs = value + elif key == "indentwidth": + self.indentwidth = value + elif key == "tabwidth": + self.tabwidth = value + elif key == "context_use_ps1": + self.context_use_ps1 = value + else: + raise KeyError("bad option name: %s" % repr(key)) + + # If ispythonsource and guess are true, guess a good value for + # indentwidth based on file content (if possible), and if + # indentwidth != tabwidth set usetabs false. + # In any case, adjust the Text widget's view of what a tab + # character means. + + def set_indentation_params(self, ispythonsource, guess=1): + if guess and ispythonsource: + i = self.guess_indent() + if 2 <= i <= 8: + self.indentwidth = i + if self.indentwidth != self.tabwidth: + self.usetabs = 0 + + self.editwin.set_tabwidth(self.tabwidth) + + def smart_backspace_event(self, event): + text = self.text + first, last = self.editwin.get_selection_indices() + if first and last: + text.delete(first, last) + text.mark_set("insert", first) + return "break" + # Delete whitespace left, until hitting a real char or closest + # preceding virtual tab stop. + chars = text.get("insert linestart", "insert") + if chars == "": + if text.compare("insert", ">", "1.0"): + # easy: delete preceding newline + text.delete("insert-1c") + else: + text.bell() # at start of buffer + return "break" + if chars[-1] not in " \t": + # easy: delete preceding real char + text.delete("insert-1c") + return "break" + # Ick. It may require *inserting* spaces if we back up over a + # tab character! This is written to be clear, not fast. + have = len(chars.expandtabs(self.tabwidth)) + assert have > 0 + want = int((have - 1) / self.indentwidth) * self.indentwidth + ncharsdeleted = 0 + while 1: + chars = chars[:-1] + ncharsdeleted = ncharsdeleted + 1 + have = len(chars.expandtabs(self.tabwidth)) + if have <= want or chars[-1] not in " \t": + break + text.undo_block_start() + text.delete("insert-%dc" % ncharsdeleted, "insert") + if have < want: + text.insert("insert", " " * (want - have)) + text.undo_block_stop() + return "break" + + def smart_indent_event(self, event): + # if intraline selection: + # delete it + # elif multiline selection: + # do indent-region & return + # indent one level + text = self.text + first, last = self.editwin.get_selection_indices() + text.undo_block_start() + try: + if first and last: + if index2line(first) != index2line(last): + return self.indent_region_event(event) + text.delete(first, last) + text.mark_set("insert", first) + prefix = text.get("insert linestart", "insert") + raw, effective = classifyws(prefix, self.tabwidth) + if raw == len(prefix): + # only whitespace to the left + self.reindent_to(effective + self.indentwidth) + else: + if self.usetabs: + pad = "\t" + else: + effective = len(prefix.expandtabs(self.tabwidth)) + n = self.indentwidth + pad = " " * (n - effective % n) + text.insert("insert", pad) + text.see("insert") + return "break" + finally: + text.undo_block_stop() + + def newline_and_indent_event(self, event): + text = self.text + first, last = self.editwin.get_selection_indices() + text.undo_block_start() + try: + if first and last: + text.delete(first, last) + text.mark_set("insert", first) + line = text.get("insert linestart", "insert") + i, n = 0, len(line) + while i < n and line[i] in " \t": + i = i + 1 + if i == n: + # the cursor is in or at leading indentation; just inject + # an empty line at the start and strip space from current line + text.delete("insert - %d chars" % i, "insert") + text.insert("insert linestart", "\n") + return "break" + indent = line[:i] + # strip whitespace before insert point + i = 0 + while line and line[-1] in " \t": + line = line[:-1] + i = i + 1 + if i: + text.delete("insert - %d chars" % i, "insert") + # strip whitespace after insert point + while text.get("insert") in " \t": + text.delete("insert") + # start new line + text.insert("insert", "\n") + + # adjust indentation for continuations and block + # open/close first need to find the last stmt + lno = index2line(text.index("insert")) + y = PyParse.Parser(self.indentwidth, self.tabwidth) + for context in self.num_context_lines: + startat = max(lno - context, 1) + startatindex = repr(startat) + ".0" + rawtext = text.get(startatindex, "insert") + y.set_str(rawtext) + bod = y.find_good_parse_start( + self.context_use_ps1, self._build_char_in_string_func(startatindex) + ) + if bod is not None or startat == 1: + break + y.set_lo(bod or 0) + c = y.get_continuation_type() + if c != PyParse.C_NONE: + # The current stmt hasn't ended yet. + if c == PyParse.C_STRING: + # inside a string; just mimic the current indent + text.insert("insert", indent) + elif c == PyParse.C_BRACKET: + # line up with the first (if any) element of the + # last open bracket structure; else indent one + # level beyond the indent of the line with the + # last open bracket + self.reindent_to(y.compute_bracket_indent()) + elif c == PyParse.C_BACKSLASH: + # if more than one line in this stmt already, just + # mimic the current indent; else if initial line + # has a start on an assignment stmt, indent to + # beyond leftmost =; else to beyond first chunk of + # non-whitespace on initial line + if y.get_num_lines_in_stmt() > 1: + text.insert("insert", indent) + else: + self.reindent_to(y.compute_backslash_indent()) + else: + assert 0, "bogus continuation type " + repr(c) + return "break" + + # This line starts a brand new stmt; indent relative to + # indentation of initial line of closest preceding + # interesting stmt. + indent = y.get_base_indent_string() + text.insert("insert", indent) + if y.is_block_opener(): + self.smart_indent_event(event) + elif indent and y.is_block_closer(): + self.smart_backspace_event(event) + return "break" + finally: + text.see("insert") + text.undo_block_stop() + + auto_indent = newline_and_indent_event + + # Our editwin provides a is_char_in_string function that works + # with a Tk text index, but PyParse only knows about offsets into + # a string. This builds a function for PyParse that accepts an + # offset. + + def _build_char_in_string_func(self, startindex): + def inner(offset, _startindex=startindex, _icis=self.editwin.is_char_in_string): + return _icis(_startindex + "+%dc" % offset) + + return inner + + def indent_region_event(self, event): + head, tail, chars, lines = self.get_region() + for pos in range(len(lines)): + line = lines[pos] + if line: + raw, effective = classifyws(line, self.tabwidth) + effective = effective + self.indentwidth + lines[pos] = self._make_blanks(effective) + line[raw:] + self.set_region(head, tail, chars, lines) + return "break" + + def dedent_region_event(self, event): + head, tail, chars, lines = self.get_region() + for pos in range(len(lines)): + line = lines[pos] + if line: + raw, effective = classifyws(line, self.tabwidth) + effective = max(effective - self.indentwidth, 0) + lines[pos] = self._make_blanks(effective) + line[raw:] + self.set_region(head, tail, chars, lines) + return "break" + + def comment_region_event(self, event): + head, tail, chars, lines = self.get_region() + for pos in range(len(lines) - 1): + line = lines[pos] + lines[pos] = "##" + line + self.set_region(head, tail, chars, lines) + + def uncomment_region_event(self, event): + head, tail, chars, lines = self.get_region() + for pos in range(len(lines)): + line = lines[pos] + if not line: + continue + if line[:2] == "##": + line = line[2:] + elif line[:1] == "#": + line = line[1:] + lines[pos] = line + self.set_region(head, tail, chars, lines) + + def tabify_region_event(self, event): + head, tail, chars, lines = self.get_region() + tabwidth = self._asktabwidth() + for pos in range(len(lines)): + line = lines[pos] + if line: + raw, effective = classifyws(line, tabwidth) + ntabs, nspaces = divmod(effective, tabwidth) + lines[pos] = "\t" * ntabs + " " * nspaces + line[raw:] + self.set_region(head, tail, chars, lines) + + def untabify_region_event(self, event): + head, tail, chars, lines = self.get_region() + tabwidth = self._asktabwidth() + for pos in range(len(lines)): + lines[pos] = lines[pos].expandtabs(tabwidth) + self.set_region(head, tail, chars, lines) + + def toggle_tabs_event(self, event): + if self.editwin.askyesno( + "Toggle tabs", + "Turn tabs " + ("on", "off")[self.usetabs] + "?", + parent=self.text, + ): + self.usetabs = not self.usetabs + return "break" + + # XXX this isn't bound to anything -- see class tabwidth comments + def change_tabwidth_event(self, event): + new = self._asktabwidth() + if new != self.tabwidth: + self.tabwidth = new + self.set_indentation_params(0, guess=0) + return "break" + + def change_indentwidth_event(self, event): + new = self.editwin.askinteger( + "Indent width", + "New indent width (1-16)", + parent=self.text, + initialvalue=self.indentwidth, + minvalue=1, + maxvalue=16, + ) + if new and new != self.indentwidth: + self.indentwidth = new + return "break" + + def get_region(self): + text = self.text + first, last = self.editwin.get_selection_indices() + if first and last: + head = text.index(first + " linestart") + tail = text.index(last + "-1c lineend +1c") + else: + head = text.index("insert linestart") + tail = text.index("insert lineend +1c") + chars = text.get(head, tail) + lines = chars.split("\n") + return head, tail, chars, lines + + def set_region(self, head, tail, chars, lines): + text = self.text + newchars = "\n".join(lines) + if newchars == chars: + text.bell() + return + text.tag_remove("sel", "1.0", "end") + text.mark_set("insert", head) + text.undo_block_start() + text.delete(head, tail) + text.insert(head, newchars) + text.undo_block_stop() + text.tag_add("sel", head, "insert") + + # Make string that displays as n leading blanks. + + def _make_blanks(self, n): + if self.usetabs: + ntabs, nspaces = divmod(n, self.tabwidth) + return "\t" * ntabs + " " * nspaces + else: + return " " * n + + # Delete from beginning of line to insert point, then reinsert + # column logical (meaning use tabs if appropriate) spaces. + + def reindent_to(self, column): + text = self.text + text.undo_block_start() + if text.compare("insert linestart", "!=", "insert"): + text.delete("insert linestart", "insert") + if column: + text.insert("insert", self._make_blanks(column)) + text.undo_block_stop() + + def _asktabwidth(self): + return ( + self.editwin.askinteger( + "Tab width", + "Spaces per tab?", + parent=self.text, + initialvalue=self.tabwidth, + minvalue=1, + maxvalue=16, + ) + or self.tabwidth + ) + + # Guess indentwidth from text content. + # Return guessed indentwidth. This should not be believed unless + # it's in a reasonable range (e.g., it will be 0 if no indented + # blocks are found). + + def guess_indent(self): + opener, indented = IndentSearcher(self.text, self.tabwidth).run() + if opener and indented: + raw, indentsmall = classifyws(opener, self.tabwidth) + raw, indentlarge = classifyws(indented, self.tabwidth) + else: + indentsmall = indentlarge = 0 + return indentlarge - indentsmall + + +# "line.col" -> line, as an int +def index2line(index): + return int(float(index)) + + +# Look at the leading whitespace in s. +# Return pair (# of leading ws characters, +# effective # of leading blanks after expanding +# tabs to width tabwidth) + + +def classifyws(s, tabwidth): + raw = effective = 0 + for ch in s: + if ch == " ": + raw = raw + 1 + effective = effective + 1 + elif ch == "\t": + raw = raw + 1 + effective = (effective // tabwidth + 1) * tabwidth + else: + break + return raw, effective + + +class IndentSearcher: + # .run() chews over the Text widget, looking for a block opener + # and the stmt following it. Returns a pair, + # (line containing block opener, line containing stmt) + # Either or both may be None. + + def __init__(self, text, tabwidth): + self.text = text + self.tabwidth = tabwidth + self.i = self.finished = 0 + self.blkopenline = self.indentedline = None + + def readline(self): + if self.finished: + val = "" + else: + i = self.i = self.i + 1 + mark = repr(i) + ".0" + if self.text.compare(mark, ">=", "end"): + val = "" + else: + val = self.text.get(mark, mark + " lineend+1c") + # hrm - not sure this is correct in py3k - the source code may have + # an encoding declared, but the data will *always* be in + # default_scintilla_encoding - so if anyone looks at the encoding decl + # in the source they will be wrong. I think. Maybe. Or something... + return val.encode(default_scintilla_encoding) + + def run(self): + OPENERS = ("class", "def", "for", "if", "try", "while") + INDENT = tokenize.INDENT + NAME = tokenize.NAME + + save_tabsize = tokenize.tabsize + tokenize.tabsize = self.tabwidth + try: + try: + for typ, token, start, end, line in token_generator(self.readline): + if typ == NAME and token in OPENERS: + self.blkopenline = line + elif typ == INDENT and self.blkopenline: + self.indentedline = line + break + + except (tokenize.TokenError, IndentationError): + # since we cut off the tokenizer early, we can trigger + # spurious errors + pass + finally: + tokenize.tabsize = save_tabsize + return self.blkopenline, self.indentedline diff --git a/lib/pythonwin/pywin/idle/CallTips.py b/lib/pythonwin/pywin/idle/CallTips.py new file mode 100644 index 00000000..cecc760a --- /dev/null +++ b/lib/pythonwin/pywin/idle/CallTips.py @@ -0,0 +1,219 @@ +# CallTips.py - An IDLE extension that provides "Call Tips" - ie, a floating window that +# displays parameter information as you open parens. + +import inspect +import string +import sys +import traceback + + +class CallTips: + menudefs = [] + + keydefs = { + "<>": [""], + "<>": [""], + "<>": [""], + "<>": ["", ""], + } + + windows_keydefs = {} + + unix_keydefs = {} + + def __init__(self, editwin): + self.editwin = editwin + self.text = editwin.text + self.calltip = None + if hasattr(self.text, "make_calltip_window"): + self._make_calltip_window = self.text.make_calltip_window + else: + self._make_calltip_window = self._make_tk_calltip_window + + def close(self): + self._make_calltip_window = None + + # Makes a Tk based calltip window. Used by IDLE, but not Pythonwin. + # See __init__ above for how this is used. + def _make_tk_calltip_window(self): + import CallTipWindow + + return CallTipWindow.CallTip(self.text) + + def _remove_calltip_window(self): + if self.calltip: + self.calltip.hidetip() + self.calltip = None + + def paren_open_event(self, event): + self._remove_calltip_window() + arg_text = get_arg_text(self.get_object_at_cursor()) + if arg_text: + self.calltip_start = self.text.index("insert") + self.calltip = self._make_calltip_window() + self.calltip.showtip(arg_text) + return "" # so the event is handled normally. + + def paren_close_event(self, event): + # Now just hides, but later we should check if other + # paren'd expressions remain open. + self._remove_calltip_window() + return "" # so the event is handled normally. + + def check_calltip_cancel_event(self, event): + if self.calltip: + # If we have moved before the start of the calltip, + # or off the calltip line, then cancel the tip. + # (Later need to be smarter about multi-line, etc) + if self.text.compare( + "insert", "<=", self.calltip_start + ) or self.text.compare("insert", ">", self.calltip_start + " lineend"): + self._remove_calltip_window() + return "" # so the event is handled normally. + + def calltip_cancel_event(self, event): + self._remove_calltip_window() + return "" # so the event is handled normally. + + def get_object_at_cursor( + self, + wordchars="._" + + string.ascii_uppercase + + string.ascii_lowercase + + string.digits, + ): + # XXX - This needs to be moved to a better place + # so the "." attribute lookup code can also use it. + text = self.text + chars = text.get("insert linestart", "insert") + i = len(chars) + while i and chars[i - 1] in wordchars: + i = i - 1 + word = chars[i:] + if word: + # How is this for a hack! + import __main__ + + namespace = sys.modules.copy() + namespace.update(__main__.__dict__) + try: + return eval(word, namespace) + except: + pass + return None # Can't find an object. + + +def _find_constructor(class_ob): + # Given a class object, return a function object used for the + # constructor (ie, __init__() ) or None if we can't find one. + try: + return class_ob.__init__ + except AttributeError: + for base in class_ob.__bases__: + rc = _find_constructor(base) + if rc is not None: + return rc + return None + + +def get_arg_text(ob): + # Get a string describing the arguments for the given object. + argText = "" + if ob is not None: + if inspect.isclass(ob): + # Look for the highest __init__ in the class chain. + fob = _find_constructor(ob) + if fob is None: + fob = lambda: None + else: + fob = ob + if inspect.isfunction(fob) or inspect.ismethod(fob): + try: + argText = str(inspect.signature(fob)) + except: + print("Failed to format the args") + traceback.print_exc() + # See if we can use the docstring + if hasattr(ob, "__doc__"): + doc = ob.__doc__ + try: + doc = doc.strip() + pos = doc.find("\n") + except AttributeError: + ## New style classes may have __doc__ slot without actually + ## having a string assigned to it + pass + else: + if pos < 0 or pos > 70: + pos = 70 + if argText: + argText = argText + "\n" + argText = argText + doc[:pos] + + return argText + + +################################################# +# +# Test code +# +if __name__ == "__main__": + + def t1(): + "()" + + def t2(a, b=None): + "(a, b=None)" + + def t3(a, *args): + "(a, *args)" + + def t4(*args): + "(*args)" + + def t5(a, *args): + "(a, *args)" + + def t6(a, b=None, *args, **kw): + "(a, b=None, *args, **kw)" + + class TC: + "(self, a=None, *b)" + + def __init__(self, a=None, *b): + "(self, a=None, *b)" + + def t1(self): + "(self)" + + def t2(self, a, b=None): + "(self, a, b=None)" + + def t3(self, a, *args): + "(self, a, *args)" + + def t4(self, *args): + "(self, *args)" + + def t5(self, a, *args): + "(self, a, *args)" + + def t6(self, a, b=None, *args, **kw): + "(self, a, b=None, *args, **kw)" + + def test(tests): + failed = [] + for t in tests: + expected = t.__doc__ + "\n" + t.__doc__ + if get_arg_text(t) != expected: + failed.append(t) + print( + "%s - expected %s, but got %s" + % (t, repr(expected), repr(get_arg_text(t))) + ) + print("%d of %d tests failed" % (len(failed), len(tests))) + + tc = TC() + tests = t1, t2, t3, t4, t5, t6, TC, tc.t1, tc.t2, tc.t3, tc.t4, tc.t5, tc.t6 + + test(tests) diff --git a/lib/pythonwin/pywin/idle/FormatParagraph.py b/lib/pythonwin/pywin/idle/FormatParagraph.py new file mode 100644 index 00000000..143c18ee --- /dev/null +++ b/lib/pythonwin/pywin/idle/FormatParagraph.py @@ -0,0 +1,166 @@ +# Extension to format a paragraph + +# Does basic, standard text formatting, and also understands Python +# comment blocks. Thus, for editing Python source code, this +# extension is really only suitable for reformatting these comment +# blocks or triple-quoted strings. + +# Known problems with comment reformatting: +# * If there is a selection marked, and the first line of the +# selection is not complete, the block will probably not be detected +# as comments, and will have the normal "text formatting" rules +# applied. +# * If a comment block has leading whitespace that mixes tabs and +# spaces, they will not be considered part of the same block. +# * Fancy comments, like this bulleted list, arent handled :-) + +import re + + +class FormatParagraph: + menudefs = [ + ( + "edit", + [ + ("Format Paragraph", "<>"), + ], + ) + ] + + keydefs = { + "<>": [""], + } + + unix_keydefs = { + "<>": [""], + } + + def __init__(self, editwin): + self.editwin = editwin + + def close(self): + self.editwin = None + + def format_paragraph_event(self, event): + text = self.editwin.text + first, last = self.editwin.get_selection_indices() + if first and last: + data = text.get(first, last) + comment_header = "" + else: + first, last, comment_header, data = find_paragraph( + text, text.index("insert") + ) + if comment_header: + # Reformat the comment lines - convert to text sans header. + lines = data.split("\n") + lines = map(lambda st, l=len(comment_header): st[l:], lines) + data = "\n".join(lines) + # Reformat to 70 chars or a 20 char width, whichever is greater. + format_width = max(70 - len(comment_header), 20) + newdata = reformat_paragraph(data, format_width) + # re-split and re-insert the comment header. + newdata = newdata.split("\n") + # If the block ends in a \n, we dont want the comment + # prefix inserted after it. (Im not sure it makes sense to + # reformat a comment block that isnt made of complete + # lines, but whatever!) Can't think of a clean soltution, + # so we hack away + block_suffix = "" + if not newdata[-1]: + block_suffix = "\n" + newdata = newdata[:-1] + builder = lambda item, prefix=comment_header: prefix + item + newdata = "\n".join([builder(d) for d in newdata]) + block_suffix + else: + # Just a normal text format + newdata = reformat_paragraph(data) + text.tag_remove("sel", "1.0", "end") + if newdata != data: + text.mark_set("insert", first) + text.undo_block_start() + text.delete(first, last) + text.insert(first, newdata) + text.undo_block_stop() + else: + text.mark_set("insert", last) + text.see("insert") + + +def find_paragraph(text, mark): + lineno, col = list(map(int, mark.split("."))) + line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno) + while text.compare("%d.0" % lineno, "<", "end") and is_all_white(line): + lineno = lineno + 1 + line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno) + first_lineno = lineno + comment_header = get_comment_header(line) + comment_header_len = len(comment_header) + while get_comment_header(line) == comment_header and not is_all_white( + line[comment_header_len:] + ): + lineno = lineno + 1 + line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno) + last = "%d.0" % lineno + # Search back to beginning of paragraph + lineno = first_lineno - 1 + line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno) + while ( + lineno > 0 + and get_comment_header(line) == comment_header + and not is_all_white(line[comment_header_len:]) + ): + lineno = lineno - 1 + line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno) + first = "%d.0" % (lineno + 1) + return first, last, comment_header, text.get(first, last) + + +def reformat_paragraph(data, limit=70): + lines = data.split("\n") + i = 0 + n = len(lines) + while i < n and is_all_white(lines[i]): + i = i + 1 + if i >= n: + return data + indent1 = get_indent(lines[i]) + if i + 1 < n and not is_all_white(lines[i + 1]): + indent2 = get_indent(lines[i + 1]) + else: + indent2 = indent1 + new = lines[:i] + partial = indent1 + while i < n and not is_all_white(lines[i]): + # XXX Should take double space after period (etc.) into account + words = re.split("(\s+)", lines[i]) + for j in range(0, len(words), 2): + word = words[j] + if not word: + continue # Can happen when line ends in whitespace + if len((partial + word).expandtabs()) > limit and partial != indent1: + new.append(partial.rstrip()) + partial = indent2 + partial = partial + word + " " + if j + 1 < len(words) and words[j + 1] != " ": + partial = partial + " " + i = i + 1 + new.append(partial.rstrip()) + # XXX Should reformat remaining paragraphs as well + new.extend(lines[i:]) + return "\n".join(new) + + +def is_all_white(line): + return re.match(r"^\s*$", line) is not None + + +def get_indent(line): + return re.match(r"^(\s*)", line).group() + + +def get_comment_header(line): + m = re.match(r"^(\s*#*)", line) + if m is None: + return "" + return m.group(1) diff --git a/lib/pythonwin/pywin/idle/IdleHistory.py b/lib/pythonwin/pywin/idle/IdleHistory.py new file mode 100644 index 00000000..24e69240 --- /dev/null +++ b/lib/pythonwin/pywin/idle/IdleHistory.py @@ -0,0 +1,87 @@ +class History: + def __init__(self, text, output_sep="\n"): + self.text = text + self.history = [] + self.history_prefix = None + self.history_pointer = None + self.output_sep = output_sep + text.bind("<>", self.history_prev) + text.bind("<>", self.history_next) + + def history_next(self, event): + self.history_do(0) + return "break" + + def history_prev(self, event): + self.history_do(1) + return "break" + + def _get_source(self, start, end): + # Get source code from start index to end index. Lines in the + # text control may be separated by sys.ps2 . + lines = self.text.get(start, end).split(self.output_sep) + return "\n".join(lines) + + def _put_source(self, where, source): + output = self.output_sep.join(source.split("\n")) + self.text.insert(where, output) + + def history_do(self, reverse): + nhist = len(self.history) + pointer = self.history_pointer + prefix = self.history_prefix + if pointer is not None and prefix is not None: + if ( + self.text.compare("insert", "!=", "end-1c") + or self._get_source("iomark", "end-1c") != self.history[pointer] + ): + pointer = prefix = None + if pointer is None or prefix is None: + prefix = self._get_source("iomark", "end-1c") + if reverse: + pointer = nhist + else: + pointer = -1 + nprefix = len(prefix) + while 1: + if reverse: + pointer = pointer - 1 + else: + pointer = pointer + 1 + if pointer < 0 or pointer >= nhist: + self.text.bell() + if self._get_source("iomark", "end-1c") != prefix: + self.text.delete("iomark", "end-1c") + self._put_source("iomark", prefix) + pointer = prefix = None + break + item = self.history[pointer] + if item[:nprefix] == prefix and len(item) > nprefix: + self.text.delete("iomark", "end-1c") + self._put_source("iomark", item) + break + self.text.mark_set("insert", "end-1c") + self.text.see("insert") + self.text.tag_remove("sel", "1.0", "end") + self.history_pointer = pointer + self.history_prefix = prefix + + def history_store(self, source): + source = source.strip() + if len(source) > 2: + # avoid duplicates + try: + self.history.remove(source) + except ValueError: + pass + self.history.append(source) + self.history_pointer = None + self.history_prefix = None + + def recall(self, s): + s = s.strip() + self.text.tag_remove("sel", "1.0", "end") + self.text.delete("iomark", "end-1c") + self.text.mark_set("insert", "end-1c") + self.text.insert("insert", s) + self.text.see("insert") diff --git a/lib/pythonwin/pywin/idle/PyParse.py b/lib/pythonwin/pywin/idle/PyParse.py new file mode 100644 index 00000000..173336ca --- /dev/null +++ b/lib/pythonwin/pywin/idle/PyParse.py @@ -0,0 +1,591 @@ +import re +import string +import sys + +# Reason last stmt is continued (or C_NONE if it's not). +C_NONE, C_BACKSLASH, C_STRING, C_BRACKET = list(range(4)) + +if 0: # for throwaway debugging output + + def dump(*stuff): + sys.__stdout__.write(" ".join(map(str, stuff)) + "\n") + + +# Find what looks like the start of a popular stmt. + +_synchre = re.compile( + r""" + ^ + [ \t]* + (?: if + | for + | while + | else + | def + | return + | assert + | break + | class + | continue + | elif + | try + | except + | raise + | import + ) + \b +""", + re.VERBOSE | re.MULTILINE, +).search + +# Match blank line or non-indenting comment line. + +_junkre = re.compile( + r""" + [ \t]* + (?: \# \S .* )? + \n +""", + re.VERBOSE, +).match + +# Match any flavor of string; the terminating quote is optional +# so that we're robust in the face of incomplete program text. + +_match_stringre = re.compile( + r""" + \""" [^"\\]* (?: + (?: \\. | "(?!"") ) + [^"\\]* + )* + (?: \""" )? + +| " [^"\\\n]* (?: \\. [^"\\\n]* )* "? + +| ''' [^'\\]* (?: + (?: \\. | '(?!'') ) + [^'\\]* + )* + (?: ''' )? + +| ' [^'\\\n]* (?: \\. [^'\\\n]* )* '? +""", + re.VERBOSE | re.DOTALL, +).match + +# Match a line that starts with something interesting; +# used to find the first item of a bracket structure. + +_itemre = re.compile( + r""" + [ \t]* + [^\s#\\] # if we match, m.end()-1 is the interesting char +""", + re.VERBOSE, +).match + +# Match start of stmts that should be followed by a dedent. + +_closere = re.compile( + r""" + \s* + (?: return + | break + | continue + | raise + | pass + ) + \b +""", + re.VERBOSE, +).match + +# Chew up non-special chars as quickly as possible. If match is +# successful, m.end() less 1 is the index of the last boring char +# matched. If match is unsuccessful, the string starts with an +# interesting char. + +_chew_ordinaryre = re.compile( + r""" + [^[\](){}#'"\\]+ +""", + re.VERBOSE, +).match + +# Build translation table to map uninteresting chars to "x", open +# brackets to "(", and close brackets to ")". + +_tran = ["x"] * 256 +for ch in "({[": + _tran[ord(ch)] = "(" +for ch in ")}]": + _tran[ord(ch)] = ")" +for ch in "\"'\\\n#": + _tran[ord(ch)] = ch +# We are called with unicode strings, and str.translate is one of the few +# py2k functions which can't 'do the right thing' - so take care to ensure +# _tran is full of unicode... +_tran = "".join(_tran) +del ch + + +class Parser: + def __init__(self, indentwidth, tabwidth): + self.indentwidth = indentwidth + self.tabwidth = tabwidth + + def set_str(self, str): + assert len(str) == 0 or str[-1] == "\n", "Oops - have str %r" % (str,) + self.str = str + self.study_level = 0 + + # Return index of a good place to begin parsing, as close to the + # end of the string as possible. This will be the start of some + # popular stmt like "if" or "def". Return None if none found: + # the caller should pass more prior context then, if possible, or + # if not (the entire program text up until the point of interest + # has already been tried) pass 0 to set_lo. + # + # This will be reliable iff given a reliable is_char_in_string + # function, meaning that when it says "no", it's absolutely + # guaranteed that the char is not in a string. + # + # Ack, hack: in the shell window this kills us, because there's + # no way to tell the differences between output, >>> etc and + # user input. Indeed, IDLE's first output line makes the rest + # look like it's in an unclosed paren!: + # Python 1.5.2 (#0, Apr 13 1999, ... + + def find_good_parse_start(self, use_ps1, is_char_in_string=None): + str, pos = self.str, None + if use_ps1: + # shell window + ps1 = "\n" + sys.ps1 + i = str.rfind(ps1) + if i >= 0: + pos = i + len(ps1) + # make it look like there's a newline instead + # of ps1 at the start -- hacking here once avoids + # repeated hackery later + self.str = str[: pos - 1] + "\n" + str[pos:] + return pos + + # File window -- real work. + if not is_char_in_string: + # no clue -- make the caller pass everything + return None + + # Peek back from the end for a good place to start, + # but don't try too often; pos will be left None, or + # bumped to a legitimate synch point. + limit = len(str) + for tries in range(5): + i = str.rfind(":\n", 0, limit) + if i < 0: + break + i = str.rfind("\n", 0, i) + 1 # start of colon line + m = _synchre(str, i, limit) + if m and not is_char_in_string(m.start()): + pos = m.start() + break + limit = i + if pos is None: + # Nothing looks like a block-opener, or stuff does + # but is_char_in_string keeps returning true; most likely + # we're in or near a giant string, the colorizer hasn't + # caught up enough to be helpful, or there simply *aren't* + # any interesting stmts. In any of these cases we're + # going to have to parse the whole thing to be sure, so + # give it one last try from the start, but stop wasting + # time here regardless of the outcome. + m = _synchre(str) + if m and not is_char_in_string(m.start()): + pos = m.start() + return pos + + # Peeking back worked; look forward until _synchre no longer + # matches. + i = pos + 1 + while 1: + m = _synchre(str, i) + if m: + s, i = m.span() + if not is_char_in_string(s): + pos = s + else: + break + return pos + + # Throw away the start of the string. Intended to be called with + # find_good_parse_start's result. + + def set_lo(self, lo): + assert lo == 0 or self.str[lo - 1] == "\n" + if lo > 0: + self.str = self.str[lo:] + + # As quickly as humanly possible , find the line numbers (0- + # based) of the non-continuation lines. + # Creates self.{goodlines, continuation}. + + def _study1(self): + if self.study_level >= 1: + return + self.study_level = 1 + + # Map all uninteresting characters to "x", all open brackets + # to "(", all close brackets to ")", then collapse runs of + # uninteresting characters. This can cut the number of chars + # by a factor of 10-40, and so greatly speed the following loop. + str = self.str + str = str.translate(_tran) + str = str.replace("xxxxxxxx", "x") + str = str.replace("xxxx", "x") + str = str.replace("xx", "x") + str = str.replace("xx", "x") + str = str.replace("\nx", "\n") + # note that replacing x\n with \n would be incorrect, because + # x may be preceded by a backslash + + # March over the squashed version of the program, accumulating + # the line numbers of non-continued stmts, and determining + # whether & why the last stmt is a continuation. + continuation = C_NONE + level = lno = 0 # level is nesting level; lno is line number + self.goodlines = goodlines = [0] + push_good = goodlines.append + i, n = 0, len(str) + while i < n: + ch = str[i] + i = i + 1 + + # cases are checked in decreasing order of frequency + if ch == "x": + continue + + if ch == "\n": + lno = lno + 1 + if level == 0: + push_good(lno) + # else we're in an unclosed bracket structure + continue + + if ch == "(": + level = level + 1 + continue + + if ch == ")": + if level: + level = level - 1 + # else the program is invalid, but we can't complain + continue + + if ch == '"' or ch == "'": + # consume the string + quote = ch + if str[i - 1 : i + 2] == quote * 3: + quote = quote * 3 + w = len(quote) - 1 + i = i + w + while i < n: + ch = str[i] + i = i + 1 + + if ch == "x": + continue + + if str[i - 1 : i + w] == quote: + i = i + w + break + + if ch == "\n": + lno = lno + 1 + if w == 0: + # unterminated single-quoted string + if level == 0: + push_good(lno) + break + continue + + if ch == "\\": + assert i < n + if str[i] == "\n": + lno = lno + 1 + i = i + 1 + continue + + # else comment char or paren inside string + + else: + # didn't break out of the loop, so we're still + # inside a string + continuation = C_STRING + continue # with outer loop + + if ch == "#": + # consume the comment + i = str.find("\n", i) + assert i >= 0 + continue + + assert ch == "\\" + assert i < n + if str[i] == "\n": + lno = lno + 1 + if i + 1 == n: + continuation = C_BACKSLASH + i = i + 1 + + # The last stmt may be continued for all 3 reasons. + # String continuation takes precedence over bracket + # continuation, which beats backslash continuation. + if continuation != C_STRING and level > 0: + continuation = C_BRACKET + self.continuation = continuation + + # Push the final line number as a sentinel value, regardless of + # whether it's continued. + assert (continuation == C_NONE) == (goodlines[-1] == lno) + if goodlines[-1] != lno: + push_good(lno) + + def get_continuation_type(self): + self._study1() + return self.continuation + + # study1 was sufficient to determine the continuation status, + # but doing more requires looking at every character. study2 + # does this for the last interesting statement in the block. + # Creates: + # self.stmt_start, stmt_end + # slice indices of last interesting stmt + # self.lastch + # last non-whitespace character before optional trailing + # comment + # self.lastopenbracketpos + # if continuation is C_BRACKET, index of last open bracket + + def _study2(self): + _ws = string.whitespace + if self.study_level >= 2: + return + self._study1() + self.study_level = 2 + + # Set p and q to slice indices of last interesting stmt. + str, goodlines = self.str, self.goodlines + i = len(goodlines) - 1 + p = len(str) # index of newest line + while i: + assert p + # p is the index of the stmt at line number goodlines[i]. + # Move p back to the stmt at line number goodlines[i-1]. + q = p + for nothing in range(goodlines[i - 1], goodlines[i]): + # tricky: sets p to 0 if no preceding newline + p = str.rfind("\n", 0, p - 1) + 1 + # The stmt str[p:q] isn't a continuation, but may be blank + # or a non-indenting comment line. + if _junkre(str, p): + i = i - 1 + else: + break + if i == 0: + # nothing but junk! + assert p == 0 + q = p + self.stmt_start, self.stmt_end = p, q + + # Analyze this stmt, to find the last open bracket (if any) + # and last interesting character (if any). + lastch = "" + stack = [] # stack of open bracket indices + push_stack = stack.append + while p < q: + # suck up all except ()[]{}'"#\\ + m = _chew_ordinaryre(str, p, q) + if m: + # we skipped at least one boring char + newp = m.end() + # back up over totally boring whitespace + i = newp - 1 # index of last boring char + while i >= p and str[i] in " \t\n": + i = i - 1 + if i >= p: + lastch = str[i] + p = newp + if p >= q: + break + + ch = str[p] + + if ch in "([{": + push_stack(p) + lastch = ch + p = p + 1 + continue + + if ch in ")]}": + if stack: + del stack[-1] + lastch = ch + p = p + 1 + continue + + if ch == '"' or ch == "'": + # consume string + # Note that study1 did this with a Python loop, but + # we use a regexp here; the reason is speed in both + # cases; the string may be huge, but study1 pre-squashed + # strings to a couple of characters per line. study1 + # also needed to keep track of newlines, and we don't + # have to. + lastch = ch + p = _match_stringre(str, p, q).end() + continue + + if ch == "#": + # consume comment and trailing newline + p = str.find("\n", p, q) + 1 + assert p > 0 + continue + + assert ch == "\\" + p = p + 1 # beyond backslash + assert p < q + if str[p] != "\n": + # the program is invalid, but can't complain + lastch = ch + str[p] + p = p + 1 # beyond escaped char + + # end while p < q: + + self.lastch = lastch + if stack: + self.lastopenbracketpos = stack[-1] + + # Assuming continuation is C_BRACKET, return the number + # of spaces the next line should be indented. + + def compute_bracket_indent(self): + self._study2() + assert self.continuation == C_BRACKET + j = self.lastopenbracketpos + str = self.str + n = len(str) + origi = i = str.rfind("\n", 0, j) + 1 + j = j + 1 # one beyond open bracket + # find first list item; set i to start of its line + while j < n: + m = _itemre(str, j) + if m: + j = m.end() - 1 # index of first interesting char + extra = 0 + break + else: + # this line is junk; advance to next line + i = j = str.find("\n", j) + 1 + else: + # nothing interesting follows the bracket; + # reproduce the bracket line's indentation + a level + j = i = origi + while str[j] in " \t": + j = j + 1 + extra = self.indentwidth + return len(str[i:j].expandtabs(self.tabwidth)) + extra + + # Return number of physical lines in last stmt (whether or not + # it's an interesting stmt! this is intended to be called when + # continuation is C_BACKSLASH). + + def get_num_lines_in_stmt(self): + self._study1() + goodlines = self.goodlines + return goodlines[-1] - goodlines[-2] + + # Assuming continuation is C_BACKSLASH, return the number of spaces + # the next line should be indented. Also assuming the new line is + # the first one following the initial line of the stmt. + + def compute_backslash_indent(self): + self._study2() + assert self.continuation == C_BACKSLASH + str = self.str + i = self.stmt_start + while str[i] in " \t": + i = i + 1 + startpos = i + + # See whether the initial line starts an assignment stmt; i.e., + # look for an = operator + endpos = str.find("\n", startpos) + 1 + found = level = 0 + while i < endpos: + ch = str[i] + if ch in "([{": + level = level + 1 + i = i + 1 + elif ch in ")]}": + if level: + level = level - 1 + i = i + 1 + elif ch == '"' or ch == "'": + i = _match_stringre(str, i, endpos).end() + elif ch == "#": + break + elif ( + level == 0 + and ch == "=" + and (i == 0 or str[i - 1] not in "=<>!") + and str[i + 1] != "=" + ): + found = 1 + break + else: + i = i + 1 + + if found: + # found a legit =, but it may be the last interesting + # thing on the line + i = i + 1 # move beyond the = + found = re.match(r"\s*\\", str[i:endpos]) is None + + if not found: + # oh well ... settle for moving beyond the first chunk + # of non-whitespace chars + i = startpos + while str[i] not in " \t\n": + i = i + 1 + + return len(str[self.stmt_start : i].expandtabs(self.tabwidth)) + 1 + + # Return the leading whitespace on the initial line of the last + # interesting stmt. + + def get_base_indent_string(self): + self._study2() + i, n = self.stmt_start, self.stmt_end + j = i + str = self.str + while j < n and str[j] in " \t": + j = j + 1 + return str[i:j] + + # Did the last interesting stmt open a block? + + def is_block_opener(self): + self._study2() + return self.lastch == ":" + + # Did the last interesting stmt close a block? + + def is_block_closer(self): + self._study2() + return _closere(self.str, self.stmt_start) is not None + + # index of last open bracket ({[, or None if none + lastopenbracketpos = None + + def get_last_open_bracket_pos(self): + self._study2() + return self.lastopenbracketpos diff --git a/lib/pythonwin/pywin/idle/__init__.py b/lib/pythonwin/pywin/idle/__init__.py new file mode 100644 index 00000000..b175d755 --- /dev/null +++ b/lib/pythonwin/pywin/idle/__init__.py @@ -0,0 +1 @@ +# This file denotes the directory as a Python package. diff --git a/lib/pythonwin/pywin/mfc/__init__.py b/lib/pythonwin/pywin/mfc/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/pythonwin/pywin/mfc/activex.py b/lib/pythonwin/pywin/mfc/activex.py new file mode 100644 index 00000000..596bbef5 --- /dev/null +++ b/lib/pythonwin/pywin/mfc/activex.py @@ -0,0 +1,86 @@ +"""Support for ActiveX control hosting in Pythonwin. +""" +import win32ui +import win32uiole + +from . import window + +# XXX - we are still "classic style" classes in py2x, so we need can't yet +# use 'type()' everywhere - revisit soon, as py2x will move to new-style too... +try: + from types import ClassType as new_type +except ImportError: + new_type = type # py3k + + +class Control(window.Wnd): + """An ActiveX control base class. A new class must be derived from both + this class and the Events class. See the demos for more details. + """ + + def __init__(self): + self.__dict__["_dispobj_"] = None + window.Wnd.__init__(self) + + def _GetControlCLSID(self): + return self.CLSID + + def _GetDispatchClass(self): + return self.default_interface + + def _GetEventMap(self): + return self.default_source._dispid_to_func_ + + def CreateControl(self, windowTitle, style, rect, parent, id, lic_string=None): + clsid = str(self._GetControlCLSID()) + self.__dict__["_obj_"] = win32ui.CreateControl( + clsid, windowTitle, style, rect, parent, id, None, False, lic_string + ) + klass = self._GetDispatchClass() + dispobj = klass(win32uiole.GetIDispatchForWindow(self._obj_)) + self.HookOleEvents() + self.__dict__["_dispobj_"] = dispobj + + def HookOleEvents(self): + dict = self._GetEventMap() + for dispid, methodName in dict.items(): + if hasattr(self, methodName): + self._obj_.HookOleEvent(getattr(self, methodName), dispid) + + def __getattr__(self, attr): + # Delegate attributes to the windows and the Dispatch object for this class + try: + return window.Wnd.__getattr__(self, attr) + except AttributeError: + pass + return getattr(self._dispobj_, attr) + + def __setattr__(self, attr, value): + if hasattr(self.__dict__, attr): + self.__dict__[attr] = value + return + try: + if self._dispobj_: + self._dispobj_.__setattr__(attr, value) + return + except AttributeError: + pass + self.__dict__[attr] = value + + +def MakeControlClass(controlClass, name=None): + """Given a CoClass in a generated .py file, this function will return a Class + object which can be used as an OCX control. + + This function is used when you do not want to handle any events from the OCX + control. If you need events, then you should derive a class from both the + activex.Control class and the CoClass + """ + if name is None: + name = controlClass.__name__ + return new_type("OCX" + name, (Control, controlClass), {}) + + +def MakeControlInstance(controlClass, name=None): + """As for MakeControlClass(), but returns an instance of the class.""" + return MakeControlClass(controlClass, name)() diff --git a/lib/pythonwin/pywin/mfc/afxres.py b/lib/pythonwin/pywin/mfc/afxres.py new file mode 100644 index 00000000..249211ff --- /dev/null +++ b/lib/pythonwin/pywin/mfc/afxres.py @@ -0,0 +1,501 @@ +# Generated by h2py from stdin +TCS_MULTILINE = 0x0200 +CBRS_ALIGN_LEFT = 0x1000 +CBRS_ALIGN_TOP = 0x2000 +CBRS_ALIGN_RIGHT = 0x4000 +CBRS_ALIGN_BOTTOM = 0x8000 +CBRS_ALIGN_ANY = 0xF000 +CBRS_BORDER_LEFT = 0x0100 +CBRS_BORDER_TOP = 0x0200 +CBRS_BORDER_RIGHT = 0x0400 +CBRS_BORDER_BOTTOM = 0x0800 +CBRS_BORDER_ANY = 0x0F00 +CBRS_TOOLTIPS = 0x0010 +CBRS_FLYBY = 0x0020 +CBRS_FLOAT_MULTI = 0x0040 +CBRS_BORDER_3D = 0x0080 +CBRS_HIDE_INPLACE = 0x0008 +CBRS_SIZE_DYNAMIC = 0x0004 +CBRS_SIZE_FIXED = 0x0002 +CBRS_FLOATING = 0x0001 +CBRS_GRIPPER = 0x00400000 +CBRS_ORIENT_HORZ = CBRS_ALIGN_TOP | CBRS_ALIGN_BOTTOM +CBRS_ORIENT_VERT = CBRS_ALIGN_LEFT | CBRS_ALIGN_RIGHT +CBRS_ORIENT_ANY = CBRS_ORIENT_HORZ | CBRS_ORIENT_VERT +CBRS_ALL = 0xFFFF +CBRS_NOALIGN = 0x00000000 +CBRS_LEFT = CBRS_ALIGN_LEFT | CBRS_BORDER_RIGHT +CBRS_TOP = CBRS_ALIGN_TOP | CBRS_BORDER_BOTTOM +CBRS_RIGHT = CBRS_ALIGN_RIGHT | CBRS_BORDER_LEFT +CBRS_BOTTOM = CBRS_ALIGN_BOTTOM | CBRS_BORDER_TOP +SBPS_NORMAL = 0x0000 +SBPS_NOBORDERS = 0x0100 +SBPS_POPOUT = 0x0200 +SBPS_OWNERDRAW = 0x1000 +SBPS_DISABLED = 0x04000000 +SBPS_STRETCH = 0x08000000 +ID_INDICATOR_EXT = 0xE700 +ID_INDICATOR_CAPS = 0xE701 +ID_INDICATOR_NUM = 0xE702 +ID_INDICATOR_SCRL = 0xE703 +ID_INDICATOR_OVR = 0xE704 +ID_INDICATOR_REC = 0xE705 +ID_INDICATOR_KANA = 0xE706 +ID_SEPARATOR = 0 +AFX_IDW_CONTROLBAR_FIRST = 0xE800 +AFX_IDW_CONTROLBAR_LAST = 0xE8FF +AFX_IDW_TOOLBAR = 0xE800 +AFX_IDW_STATUS_BAR = 0xE801 +AFX_IDW_PREVIEW_BAR = 0xE802 +AFX_IDW_RESIZE_BAR = 0xE803 +AFX_IDW_DOCKBAR_TOP = 0xE81B +AFX_IDW_DOCKBAR_LEFT = 0xE81C +AFX_IDW_DOCKBAR_RIGHT = 0xE81D +AFX_IDW_DOCKBAR_BOTTOM = 0xE81E +AFX_IDW_DOCKBAR_FLOAT = 0xE81F + + +def AFX_CONTROLBAR_MASK(nIDC): + return 1 << (nIDC - AFX_IDW_CONTROLBAR_FIRST) + + +AFX_IDW_PANE_FIRST = 0xE900 +AFX_IDW_PANE_LAST = 0xE9FF +AFX_IDW_HSCROLL_FIRST = 0xEA00 +AFX_IDW_VSCROLL_FIRST = 0xEA10 +AFX_IDW_SIZE_BOX = 0xEA20 +AFX_IDW_PANE_SAVE = 0xEA21 +AFX_IDS_APP_TITLE = 0xE000 +AFX_IDS_IDLEMESSAGE = 0xE001 +AFX_IDS_HELPMODEMESSAGE = 0xE002 +AFX_IDS_APP_TITLE_EMBEDDING = 0xE003 +AFX_IDS_COMPANY_NAME = 0xE004 +AFX_IDS_OBJ_TITLE_INPLACE = 0xE005 +ID_FILE_NEW = 0xE100 +ID_FILE_OPEN = 0xE101 +ID_FILE_CLOSE = 0xE102 +ID_FILE_SAVE = 0xE103 +ID_FILE_SAVE_AS = 0xE104 +ID_FILE_PAGE_SETUP = 0xE105 +ID_FILE_PRINT_SETUP = 0xE106 +ID_FILE_PRINT = 0xE107 +ID_FILE_PRINT_DIRECT = 0xE108 +ID_FILE_PRINT_PREVIEW = 0xE109 +ID_FILE_UPDATE = 0xE10A +ID_FILE_SAVE_COPY_AS = 0xE10B +ID_FILE_SEND_MAIL = 0xE10C +ID_FILE_MRU_FIRST = 0xE110 +ID_FILE_MRU_FILE1 = 0xE110 +ID_FILE_MRU_FILE2 = 0xE111 +ID_FILE_MRU_FILE3 = 0xE112 +ID_FILE_MRU_FILE4 = 0xE113 +ID_FILE_MRU_FILE5 = 0xE114 +ID_FILE_MRU_FILE6 = 0xE115 +ID_FILE_MRU_FILE7 = 0xE116 +ID_FILE_MRU_FILE8 = 0xE117 +ID_FILE_MRU_FILE9 = 0xE118 +ID_FILE_MRU_FILE10 = 0xE119 +ID_FILE_MRU_FILE11 = 0xE11A +ID_FILE_MRU_FILE12 = 0xE11B +ID_FILE_MRU_FILE13 = 0xE11C +ID_FILE_MRU_FILE14 = 0xE11D +ID_FILE_MRU_FILE15 = 0xE11E +ID_FILE_MRU_FILE16 = 0xE11F +ID_FILE_MRU_LAST = 0xE11F +ID_EDIT_CLEAR = 0xE120 +ID_EDIT_CLEAR_ALL = 0xE121 +ID_EDIT_COPY = 0xE122 +ID_EDIT_CUT = 0xE123 +ID_EDIT_FIND = 0xE124 +ID_EDIT_PASTE = 0xE125 +ID_EDIT_PASTE_LINK = 0xE126 +ID_EDIT_PASTE_SPECIAL = 0xE127 +ID_EDIT_REPEAT = 0xE128 +ID_EDIT_REPLACE = 0xE129 +ID_EDIT_SELECT_ALL = 0xE12A +ID_EDIT_UNDO = 0xE12B +ID_EDIT_REDO = 0xE12C +ID_WINDOW_NEW = 0xE130 +ID_WINDOW_ARRANGE = 0xE131 +ID_WINDOW_CASCADE = 0xE132 +ID_WINDOW_TILE_HORZ = 0xE133 +ID_WINDOW_TILE_VERT = 0xE134 +ID_WINDOW_SPLIT = 0xE135 +AFX_IDM_WINDOW_FIRST = 0xE130 +AFX_IDM_WINDOW_LAST = 0xE13F +AFX_IDM_FIRST_MDICHILD = 0xFF00 +ID_APP_ABOUT = 0xE140 +ID_APP_EXIT = 0xE141 +ID_HELP_INDEX = 0xE142 +ID_HELP_FINDER = 0xE143 +ID_HELP_USING = 0xE144 +ID_CONTEXT_HELP = 0xE145 +ID_HELP = 0xE146 +ID_DEFAULT_HELP = 0xE147 +ID_NEXT_PANE = 0xE150 +ID_PREV_PANE = 0xE151 +ID_FORMAT_FONT = 0xE160 +ID_OLE_INSERT_NEW = 0xE200 +ID_OLE_EDIT_LINKS = 0xE201 +ID_OLE_EDIT_CONVERT = 0xE202 +ID_OLE_EDIT_CHANGE_ICON = 0xE203 +ID_OLE_EDIT_PROPERTIES = 0xE204 +ID_OLE_VERB_FIRST = 0xE210 +ID_OLE_VERB_LAST = 0xE21F +AFX_ID_PREVIEW_CLOSE = 0xE300 +AFX_ID_PREVIEW_NUMPAGE = 0xE301 +AFX_ID_PREVIEW_NEXT = 0xE302 +AFX_ID_PREVIEW_PREV = 0xE303 +AFX_ID_PREVIEW_PRINT = 0xE304 +AFX_ID_PREVIEW_ZOOMIN = 0xE305 +AFX_ID_PREVIEW_ZOOMOUT = 0xE306 +ID_VIEW_TOOLBAR = 0xE800 +ID_VIEW_STATUS_BAR = 0xE801 +ID_RECORD_FIRST = 0xE900 +ID_RECORD_LAST = 0xE901 +ID_RECORD_NEXT = 0xE902 +ID_RECORD_PREV = 0xE903 +IDC_STATIC = -1 +AFX_IDS_SCFIRST = 0xEF00 +AFX_IDS_SCSIZE = 0xEF00 +AFX_IDS_SCMOVE = 0xEF01 +AFX_IDS_SCMINIMIZE = 0xEF02 +AFX_IDS_SCMAXIMIZE = 0xEF03 +AFX_IDS_SCNEXTWINDOW = 0xEF04 +AFX_IDS_SCPREVWINDOW = 0xEF05 +AFX_IDS_SCCLOSE = 0xEF06 +AFX_IDS_SCRESTORE = 0xEF12 +AFX_IDS_SCTASKLIST = 0xEF13 +AFX_IDS_MDICHILD = 0xEF1F +AFX_IDS_DESKACCESSORY = 0xEFDA +AFX_IDS_OPENFILE = 0xF000 +AFX_IDS_SAVEFILE = 0xF001 +AFX_IDS_ALLFILTER = 0xF002 +AFX_IDS_UNTITLED = 0xF003 +AFX_IDS_SAVEFILECOPY = 0xF004 +AFX_IDS_PREVIEW_CLOSE = 0xF005 +AFX_IDS_UNNAMED_FILE = 0xF006 +AFX_IDS_ABOUT = 0xF010 +AFX_IDS_HIDE = 0xF011 +AFX_IDP_NO_ERROR_AVAILABLE = 0xF020 +AFX_IDS_NOT_SUPPORTED_EXCEPTION = 0xF021 +AFX_IDS_RESOURCE_EXCEPTION = 0xF022 +AFX_IDS_MEMORY_EXCEPTION = 0xF023 +AFX_IDS_USER_EXCEPTION = 0xF024 +AFX_IDS_PRINTONPORT = 0xF040 +AFX_IDS_ONEPAGE = 0xF041 +AFX_IDS_TWOPAGE = 0xF042 +AFX_IDS_PRINTPAGENUM = 0xF043 +AFX_IDS_PREVIEWPAGEDESC = 0xF044 +AFX_IDS_PRINTDEFAULTEXT = 0xF045 +AFX_IDS_PRINTDEFAULT = 0xF046 +AFX_IDS_PRINTFILTER = 0xF047 +AFX_IDS_PRINTCAPTION = 0xF048 +AFX_IDS_PRINTTOFILE = 0xF049 +AFX_IDS_OBJECT_MENUITEM = 0xF080 +AFX_IDS_EDIT_VERB = 0xF081 +AFX_IDS_ACTIVATE_VERB = 0xF082 +AFX_IDS_CHANGE_LINK = 0xF083 +AFX_IDS_AUTO = 0xF084 +AFX_IDS_MANUAL = 0xF085 +AFX_IDS_FROZEN = 0xF086 +AFX_IDS_ALL_FILES = 0xF087 +AFX_IDS_SAVE_MENU = 0xF088 +AFX_IDS_UPDATE_MENU = 0xF089 +AFX_IDS_SAVE_AS_MENU = 0xF08A +AFX_IDS_SAVE_COPY_AS_MENU = 0xF08B +AFX_IDS_EXIT_MENU = 0xF08C +AFX_IDS_UPDATING_ITEMS = 0xF08D +AFX_IDS_METAFILE_FORMAT = 0xF08E +AFX_IDS_DIB_FORMAT = 0xF08F +AFX_IDS_BITMAP_FORMAT = 0xF090 +AFX_IDS_LINKSOURCE_FORMAT = 0xF091 +AFX_IDS_EMBED_FORMAT = 0xF092 +AFX_IDS_PASTELINKEDTYPE = 0xF094 +AFX_IDS_UNKNOWNTYPE = 0xF095 +AFX_IDS_RTF_FORMAT = 0xF096 +AFX_IDS_TEXT_FORMAT = 0xF097 +AFX_IDS_INVALID_CURRENCY = 0xF098 +AFX_IDS_INVALID_DATETIME = 0xF099 +AFX_IDS_INVALID_DATETIMESPAN = 0xF09A +AFX_IDP_INVALID_FILENAME = 0xF100 +AFX_IDP_FAILED_TO_OPEN_DOC = 0xF101 +AFX_IDP_FAILED_TO_SAVE_DOC = 0xF102 +AFX_IDP_ASK_TO_SAVE = 0xF103 +AFX_IDP_FAILED_TO_CREATE_DOC = 0xF104 +AFX_IDP_FILE_TOO_LARGE = 0xF105 +AFX_IDP_FAILED_TO_START_PRINT = 0xF106 +AFX_IDP_FAILED_TO_LAUNCH_HELP = 0xF107 +AFX_IDP_INTERNAL_FAILURE = 0xF108 +AFX_IDP_COMMAND_FAILURE = 0xF109 +AFX_IDP_FAILED_MEMORY_ALLOC = 0xF10A +AFX_IDP_PARSE_INT = 0xF110 +AFX_IDP_PARSE_REAL = 0xF111 +AFX_IDP_PARSE_INT_RANGE = 0xF112 +AFX_IDP_PARSE_REAL_RANGE = 0xF113 +AFX_IDP_PARSE_STRING_SIZE = 0xF114 +AFX_IDP_PARSE_RADIO_BUTTON = 0xF115 +AFX_IDP_PARSE_BYTE = 0xF116 +AFX_IDP_PARSE_UINT = 0xF117 +AFX_IDP_PARSE_DATETIME = 0xF118 +AFX_IDP_PARSE_CURRENCY = 0xF119 +AFX_IDP_FAILED_INVALID_FORMAT = 0xF120 +AFX_IDP_FAILED_INVALID_PATH = 0xF121 +AFX_IDP_FAILED_DISK_FULL = 0xF122 +AFX_IDP_FAILED_ACCESS_READ = 0xF123 +AFX_IDP_FAILED_ACCESS_WRITE = 0xF124 +AFX_IDP_FAILED_IO_ERROR_READ = 0xF125 +AFX_IDP_FAILED_IO_ERROR_WRITE = 0xF126 +AFX_IDP_STATIC_OBJECT = 0xF180 +AFX_IDP_FAILED_TO_CONNECT = 0xF181 +AFX_IDP_SERVER_BUSY = 0xF182 +AFX_IDP_BAD_VERB = 0xF183 +AFX_IDP_FAILED_TO_NOTIFY = 0xF185 +AFX_IDP_FAILED_TO_LAUNCH = 0xF186 +AFX_IDP_ASK_TO_UPDATE = 0xF187 +AFX_IDP_FAILED_TO_UPDATE = 0xF188 +AFX_IDP_FAILED_TO_REGISTER = 0xF189 +AFX_IDP_FAILED_TO_AUTO_REGISTER = 0xF18A +AFX_IDP_FAILED_TO_CONVERT = 0xF18B +AFX_IDP_GET_NOT_SUPPORTED = 0xF18C +AFX_IDP_SET_NOT_SUPPORTED = 0xF18D +AFX_IDP_ASK_TO_DISCARD = 0xF18E +AFX_IDP_FAILED_TO_CREATE = 0xF18F +AFX_IDP_FAILED_MAPI_LOAD = 0xF190 +AFX_IDP_INVALID_MAPI_DLL = 0xF191 +AFX_IDP_FAILED_MAPI_SEND = 0xF192 +AFX_IDP_FILE_NONE = 0xF1A0 +AFX_IDP_FILE_GENERIC = 0xF1A1 +AFX_IDP_FILE_NOT_FOUND = 0xF1A2 +AFX_IDP_FILE_BAD_PATH = 0xF1A3 +AFX_IDP_FILE_TOO_MANY_OPEN = 0xF1A4 +AFX_IDP_FILE_ACCESS_DENIED = 0xF1A5 +AFX_IDP_FILE_INVALID_FILE = 0xF1A6 +AFX_IDP_FILE_REMOVE_CURRENT = 0xF1A7 +AFX_IDP_FILE_DIR_FULL = 0xF1A8 +AFX_IDP_FILE_BAD_SEEK = 0xF1A9 +AFX_IDP_FILE_HARD_IO = 0xF1AA +AFX_IDP_FILE_SHARING = 0xF1AB +AFX_IDP_FILE_LOCKING = 0xF1AC +AFX_IDP_FILE_DISKFULL = 0xF1AD +AFX_IDP_FILE_EOF = 0xF1AE +AFX_IDP_ARCH_NONE = 0xF1B0 +AFX_IDP_ARCH_GENERIC = 0xF1B1 +AFX_IDP_ARCH_READONLY = 0xF1B2 +AFX_IDP_ARCH_ENDOFFILE = 0xF1B3 +AFX_IDP_ARCH_WRITEONLY = 0xF1B4 +AFX_IDP_ARCH_BADINDEX = 0xF1B5 +AFX_IDP_ARCH_BADCLASS = 0xF1B6 +AFX_IDP_ARCH_BADSCHEMA = 0xF1B7 +AFX_IDS_OCC_SCALEUNITS_PIXELS = 0xF1C0 +AFX_IDS_STATUS_FONT = 0xF230 +AFX_IDS_TOOLTIP_FONT = 0xF231 +AFX_IDS_UNICODE_FONT = 0xF232 +AFX_IDS_MINI_FONT = 0xF233 +AFX_IDP_SQL_FIRST = 0xF280 +AFX_IDP_SQL_CONNECT_FAIL = 0xF281 +AFX_IDP_SQL_RECORDSET_FORWARD_ONLY = 0xF282 +AFX_IDP_SQL_EMPTY_COLUMN_LIST = 0xF283 +AFX_IDP_SQL_FIELD_SCHEMA_MISMATCH = 0xF284 +AFX_IDP_SQL_ILLEGAL_MODE = 0xF285 +AFX_IDP_SQL_MULTIPLE_ROWS_AFFECTED = 0xF286 +AFX_IDP_SQL_NO_CURRENT_RECORD = 0xF287 +AFX_IDP_SQL_NO_ROWS_AFFECTED = 0xF288 +AFX_IDP_SQL_RECORDSET_READONLY = 0xF289 +AFX_IDP_SQL_SQL_NO_TOTAL = 0xF28A +AFX_IDP_SQL_ODBC_LOAD_FAILED = 0xF28B +AFX_IDP_SQL_DYNASET_NOT_SUPPORTED = 0xF28C +AFX_IDP_SQL_SNAPSHOT_NOT_SUPPORTED = 0xF28D +AFX_IDP_SQL_API_CONFORMANCE = 0xF28E +AFX_IDP_SQL_SQL_CONFORMANCE = 0xF28F +AFX_IDP_SQL_NO_DATA_FOUND = 0xF290 +AFX_IDP_SQL_ROW_UPDATE_NOT_SUPPORTED = 0xF291 +AFX_IDP_SQL_ODBC_V2_REQUIRED = 0xF292 +AFX_IDP_SQL_NO_POSITIONED_UPDATES = 0xF293 +AFX_IDP_SQL_LOCK_MODE_NOT_SUPPORTED = 0xF294 +AFX_IDP_SQL_DATA_TRUNCATED = 0xF295 +AFX_IDP_SQL_ROW_FETCH = 0xF296 +AFX_IDP_SQL_INCORRECT_ODBC = 0xF297 +AFX_IDP_SQL_UPDATE_DELETE_FAILED = 0xF298 +AFX_IDP_SQL_DYNAMIC_CURSOR_NOT_SUPPORTED = 0xF299 +AFX_IDP_DAO_FIRST = 0xF2A0 +AFX_IDP_DAO_ENGINE_INITIALIZATION = 0xF2A0 +AFX_IDP_DAO_DFX_BIND = 0xF2A1 +AFX_IDP_DAO_OBJECT_NOT_OPEN = 0xF2A2 +AFX_IDP_DAO_ROWTOOSHORT = 0xF2A3 +AFX_IDP_DAO_BADBINDINFO = 0xF2A4 +AFX_IDP_DAO_COLUMNUNAVAILABLE = 0xF2A5 +AFX_IDC_LISTBOX = 100 +AFX_IDC_CHANGE = 101 +AFX_IDC_PRINT_DOCNAME = 201 +AFX_IDC_PRINT_PRINTERNAME = 202 +AFX_IDC_PRINT_PORTNAME = 203 +AFX_IDC_PRINT_PAGENUM = 204 +ID_APPLY_NOW = 0x3021 +ID_WIZBACK = 0x3023 +ID_WIZNEXT = 0x3024 +ID_WIZFINISH = 0x3025 +AFX_IDC_TAB_CONTROL = 0x3020 +AFX_IDD_FILEOPEN = 28676 +AFX_IDD_FILESAVE = 28677 +AFX_IDD_FONT = 28678 +AFX_IDD_COLOR = 28679 +AFX_IDD_PRINT = 28680 +AFX_IDD_PRINTSETUP = 28681 +AFX_IDD_FIND = 28682 +AFX_IDD_REPLACE = 28683 +AFX_IDD_NEWTYPEDLG = 30721 +AFX_IDD_PRINTDLG = 30722 +AFX_IDD_PREVIEW_TOOLBAR = 30723 +AFX_IDD_PREVIEW_SHORTTOOLBAR = 30731 +AFX_IDD_INSERTOBJECT = 30724 +AFX_IDD_CHANGEICON = 30725 +AFX_IDD_CONVERT = 30726 +AFX_IDD_PASTESPECIAL = 30727 +AFX_IDD_EDITLINKS = 30728 +AFX_IDD_FILEBROWSE = 30729 +AFX_IDD_BUSY = 30730 +AFX_IDD_OBJECTPROPERTIES = 30732 +AFX_IDD_CHANGESOURCE = 30733 +AFX_IDC_CONTEXTHELP = 30977 +AFX_IDC_MAGNIFY = 30978 +AFX_IDC_SMALLARROWS = 30979 +AFX_IDC_HSPLITBAR = 30980 +AFX_IDC_VSPLITBAR = 30981 +AFX_IDC_NODROPCRSR = 30982 +AFX_IDC_TRACKNWSE = 30983 +AFX_IDC_TRACKNESW = 30984 +AFX_IDC_TRACKNS = 30985 +AFX_IDC_TRACKWE = 30986 +AFX_IDC_TRACK4WAY = 30987 +AFX_IDC_MOVE4WAY = 30988 +AFX_IDB_MINIFRAME_MENU = 30994 +AFX_IDB_CHECKLISTBOX_NT = 30995 +AFX_IDB_CHECKLISTBOX_95 = 30996 +AFX_IDR_PREVIEW_ACCEL = 30997 +AFX_IDI_STD_MDIFRAME = 31233 +AFX_IDI_STD_FRAME = 31234 +AFX_IDC_FONTPROP = 1000 +AFX_IDC_FONTNAMES = 1001 +AFX_IDC_FONTSTYLES = 1002 +AFX_IDC_FONTSIZES = 1003 +AFX_IDC_STRIKEOUT = 1004 +AFX_IDC_UNDERLINE = 1005 +AFX_IDC_SAMPLEBOX = 1006 +AFX_IDC_COLOR_BLACK = 1100 +AFX_IDC_COLOR_WHITE = 1101 +AFX_IDC_COLOR_RED = 1102 +AFX_IDC_COLOR_GREEN = 1103 +AFX_IDC_COLOR_BLUE = 1104 +AFX_IDC_COLOR_YELLOW = 1105 +AFX_IDC_COLOR_MAGENTA = 1106 +AFX_IDC_COLOR_CYAN = 1107 +AFX_IDC_COLOR_GRAY = 1108 +AFX_IDC_COLOR_LIGHTGRAY = 1109 +AFX_IDC_COLOR_DARKRED = 1110 +AFX_IDC_COLOR_DARKGREEN = 1111 +AFX_IDC_COLOR_DARKBLUE = 1112 +AFX_IDC_COLOR_LIGHTBROWN = 1113 +AFX_IDC_COLOR_DARKMAGENTA = 1114 +AFX_IDC_COLOR_DARKCYAN = 1115 +AFX_IDC_COLORPROP = 1116 +AFX_IDC_SYSTEMCOLORS = 1117 +AFX_IDC_PROPNAME = 1201 +AFX_IDC_PICTURE = 1202 +AFX_IDC_BROWSE = 1203 +AFX_IDC_CLEAR = 1204 +AFX_IDD_PROPPAGE_COLOR = 32257 +AFX_IDD_PROPPAGE_FONT = 32258 +AFX_IDD_PROPPAGE_PICTURE = 32259 +AFX_IDB_TRUETYPE = 32384 +AFX_IDS_PROPPAGE_UNKNOWN = 0xFE01 +AFX_IDS_COLOR_DESKTOP = 0xFE04 +AFX_IDS_COLOR_APPWORKSPACE = 0xFE05 +AFX_IDS_COLOR_WNDBACKGND = 0xFE06 +AFX_IDS_COLOR_WNDTEXT = 0xFE07 +AFX_IDS_COLOR_MENUBAR = 0xFE08 +AFX_IDS_COLOR_MENUTEXT = 0xFE09 +AFX_IDS_COLOR_ACTIVEBAR = 0xFE0A +AFX_IDS_COLOR_INACTIVEBAR = 0xFE0B +AFX_IDS_COLOR_ACTIVETEXT = 0xFE0C +AFX_IDS_COLOR_INACTIVETEXT = 0xFE0D +AFX_IDS_COLOR_ACTIVEBORDER = 0xFE0E +AFX_IDS_COLOR_INACTIVEBORDER = 0xFE0F +AFX_IDS_COLOR_WNDFRAME = 0xFE10 +AFX_IDS_COLOR_SCROLLBARS = 0xFE11 +AFX_IDS_COLOR_BTNFACE = 0xFE12 +AFX_IDS_COLOR_BTNSHADOW = 0xFE13 +AFX_IDS_COLOR_BTNTEXT = 0xFE14 +AFX_IDS_COLOR_BTNHIGHLIGHT = 0xFE15 +AFX_IDS_COLOR_DISABLEDTEXT = 0xFE16 +AFX_IDS_COLOR_HIGHLIGHT = 0xFE17 +AFX_IDS_COLOR_HIGHLIGHTTEXT = 0xFE18 +AFX_IDS_REGULAR = 0xFE19 +AFX_IDS_BOLD = 0xFE1A +AFX_IDS_ITALIC = 0xFE1B +AFX_IDS_BOLDITALIC = 0xFE1C +AFX_IDS_SAMPLETEXT = 0xFE1D +AFX_IDS_DISPLAYSTRING_FONT = 0xFE1E +AFX_IDS_DISPLAYSTRING_COLOR = 0xFE1F +AFX_IDS_DISPLAYSTRING_PICTURE = 0xFE20 +AFX_IDS_PICTUREFILTER = 0xFE21 +AFX_IDS_PICTYPE_UNKNOWN = 0xFE22 +AFX_IDS_PICTYPE_NONE = 0xFE23 +AFX_IDS_PICTYPE_BITMAP = 0xFE24 +AFX_IDS_PICTYPE_METAFILE = 0xFE25 +AFX_IDS_PICTYPE_ICON = 0xFE26 +AFX_IDS_COLOR_PPG = 0xFE28 +AFX_IDS_COLOR_PPG_CAPTION = 0xFE29 +AFX_IDS_FONT_PPG = 0xFE2A +AFX_IDS_FONT_PPG_CAPTION = 0xFE2B +AFX_IDS_PICTURE_PPG = 0xFE2C +AFX_IDS_PICTURE_PPG_CAPTION = 0xFE2D +AFX_IDS_PICTUREBROWSETITLE = 0xFE30 +AFX_IDS_BORDERSTYLE_0 = 0xFE31 +AFX_IDS_BORDERSTYLE_1 = 0xFE32 +AFX_IDS_VERB_EDIT = 0xFE40 +AFX_IDS_VERB_PROPERTIES = 0xFE41 +AFX_IDP_PICTURECANTOPEN = 0xFE83 +AFX_IDP_PICTURECANTLOAD = 0xFE84 +AFX_IDP_PICTURETOOLARGE = 0xFE85 +AFX_IDP_PICTUREREADFAILED = 0xFE86 +AFX_IDP_E_ILLEGALFUNCTIONCALL = 0xFEA0 +AFX_IDP_E_OVERFLOW = 0xFEA1 +AFX_IDP_E_OUTOFMEMORY = 0xFEA2 +AFX_IDP_E_DIVISIONBYZERO = 0xFEA3 +AFX_IDP_E_OUTOFSTRINGSPACE = 0xFEA4 +AFX_IDP_E_OUTOFSTACKSPACE = 0xFEA5 +AFX_IDP_E_BADFILENAMEORNUMBER = 0xFEA6 +AFX_IDP_E_FILENOTFOUND = 0xFEA7 +AFX_IDP_E_BADFILEMODE = 0xFEA8 +AFX_IDP_E_FILEALREADYOPEN = 0xFEA9 +AFX_IDP_E_DEVICEIOERROR = 0xFEAA +AFX_IDP_E_FILEALREADYEXISTS = 0xFEAB +AFX_IDP_E_BADRECORDLENGTH = 0xFEAC +AFX_IDP_E_DISKFULL = 0xFEAD +AFX_IDP_E_BADRECORDNUMBER = 0xFEAE +AFX_IDP_E_BADFILENAME = 0xFEAF +AFX_IDP_E_TOOMANYFILES = 0xFEB0 +AFX_IDP_E_DEVICEUNAVAILABLE = 0xFEB1 +AFX_IDP_E_PERMISSIONDENIED = 0xFEB2 +AFX_IDP_E_DISKNOTREADY = 0xFEB3 +AFX_IDP_E_PATHFILEACCESSERROR = 0xFEB4 +AFX_IDP_E_PATHNOTFOUND = 0xFEB5 +AFX_IDP_E_INVALIDPATTERNSTRING = 0xFEB6 +AFX_IDP_E_INVALIDUSEOFNULL = 0xFEB7 +AFX_IDP_E_INVALIDFILEFORMAT = 0xFEB8 +AFX_IDP_E_INVALIDPROPERTYVALUE = 0xFEB9 +AFX_IDP_E_INVALIDPROPERTYARRAYINDEX = 0xFEBA +AFX_IDP_E_SETNOTSUPPORTEDATRUNTIME = 0xFEBB +AFX_IDP_E_SETNOTSUPPORTED = 0xFEBC +AFX_IDP_E_NEEDPROPERTYARRAYINDEX = 0xFEBD +AFX_IDP_E_SETNOTPERMITTED = 0xFEBE +AFX_IDP_E_GETNOTSUPPORTEDATRUNTIME = 0xFEBF +AFX_IDP_E_GETNOTSUPPORTED = 0xFEC0 +AFX_IDP_E_PROPERTYNOTFOUND = 0xFEC1 +AFX_IDP_E_INVALIDCLIPBOARDFORMAT = 0xFEC2 +AFX_IDP_E_INVALIDPICTURE = 0xFEC3 +AFX_IDP_E_PRINTERERROR = 0xFEC4 +AFX_IDP_E_CANTSAVEFILETOTEMP = 0xFEC5 +AFX_IDP_E_SEARCHTEXTNOTFOUND = 0xFEC6 +AFX_IDP_E_REPLACEMENTSTOOLONG = 0xFEC7 diff --git a/lib/pythonwin/pywin/mfc/dialog.py b/lib/pythonwin/pywin/mfc/dialog.py new file mode 100644 index 00000000..25fe1363 --- /dev/null +++ b/lib/pythonwin/pywin/mfc/dialog.py @@ -0,0 +1,278 @@ +""" \ +Base class for Dialogs. Also contains a few useful utility functions +""" +# dialog.py +# Python class for Dialog Boxes in PythonWin. + +import win32con +import win32ui + +# sob - 2to3 doesn't see this as a relative import :( +from pywin.mfc import window + + +def dllFromDll(dllid): + "given a 'dll' (maybe a dll, filename, etc), return a DLL object" + if dllid == None: + return None + elif type("") == type(dllid): + return win32ui.LoadLibrary(dllid) + else: + try: + dllid.GetFileName() + except AttributeError: + raise TypeError("DLL parameter must be None, a filename or a dll object") + return dllid + + +class Dialog(window.Wnd): + "Base class for a dialog" + + def __init__(self, id, dllid=None): + """id is the resource ID, or a template + dllid may be None, a dll object, or a string with a dll name""" + # must take a reference to the DLL until InitDialog. + self.dll = dllFromDll(dllid) + if type(id) == type([]): # a template + dlg = win32ui.CreateDialogIndirect(id) + else: + dlg = win32ui.CreateDialog(id, self.dll) + window.Wnd.__init__(self, dlg) + self.HookCommands() + self.bHaveInit = None + + def HookCommands(self): + pass + + def OnAttachedObjectDeath(self): + self.data = self._obj_.data + window.Wnd.OnAttachedObjectDeath(self) + + # provide virtuals. + def OnOK(self): + self._obj_.OnOK() + + def OnCancel(self): + self._obj_.OnCancel() + + def OnInitDialog(self): + self.bHaveInit = 1 + if self._obj_.data: + self._obj_.UpdateData(0) + return 1 # I did NOT set focus to a child window. + + def OnDestroy(self, msg): + self.dll = None # theoretically not needed if object destructs normally. + + # DDX support + def AddDDX(self, *args): + self._obj_.datalist.append(args) + + # Make a dialog object look like a dictionary for the DDX support + def __bool__(self): + return True + + def __len__(self): + return len(self.data) + + def __getitem__(self, key): + return self.data[key] + + def __setitem__(self, key, item): + self._obj_.data[key] = item # self.UpdateData(0) + + def keys(self): + return list(self.data.keys()) + + def items(self): + return list(self.data.items()) + + def values(self): + return list(self.data.values()) + + # XXX - needs py3k work! + def has_key(self, key): + return key in self.data + + +class PrintDialog(Dialog): + "Base class for a print dialog" + + def __init__( + self, + pInfo, + dlgID, + printSetupOnly=0, + flags=( + win32ui.PD_ALLPAGES + | win32ui.PD_USEDEVMODECOPIES + | win32ui.PD_NOPAGENUMS + | win32ui.PD_HIDEPRINTTOFILE + | win32ui.PD_NOSELECTION + ), + parent=None, + dllid=None, + ): + self.dll = dllFromDll(dllid) + if type(dlgID) == type([]): # a template + raise TypeError("dlgID parameter must be an integer resource ID") + dlg = win32ui.CreatePrintDialog(dlgID, printSetupOnly, flags, parent, self.dll) + window.Wnd.__init__(self, dlg) + self.HookCommands() + self.bHaveInit = None + self.pInfo = pInfo + # init values (if PrintSetup is called, values still available) + flags = pInfo.GetFlags() + self["toFile"] = flags & win32ui.PD_PRINTTOFILE != 0 + self["direct"] = pInfo.GetDirect() + self["preview"] = pInfo.GetPreview() + self["continuePrinting"] = pInfo.GetContinuePrinting() + self["curPage"] = pInfo.GetCurPage() + self["numPreviewPages"] = pInfo.GetNumPreviewPages() + self["userData"] = pInfo.GetUserData() + self["draw"] = pInfo.GetDraw() + self["pageDesc"] = pInfo.GetPageDesc() + self["minPage"] = pInfo.GetMinPage() + self["maxPage"] = pInfo.GetMaxPage() + self["offsetPage"] = pInfo.GetOffsetPage() + self["fromPage"] = pInfo.GetFromPage() + self["toPage"] = pInfo.GetToPage() + # these values updated after OnOK + self["copies"] = 0 + self["deviceName"] = "" + self["driverName"] = "" + self["printAll"] = 0 + self["printCollate"] = 0 + self["printRange"] = 0 + self["printSelection"] = 0 + + def OnInitDialog(self): + self.pInfo.CreatePrinterDC() # This also sets the hDC of the pInfo structure. + return self._obj_.OnInitDialog() + + def OnCancel(self): + del self.pInfo + + def OnOK(self): + """DoModal has finished. Can now access the users choices""" + self._obj_.OnOK() + pInfo = self.pInfo + # user values + flags = pInfo.GetFlags() + self["toFile"] = flags & win32ui.PD_PRINTTOFILE != 0 + self["direct"] = pInfo.GetDirect() + self["preview"] = pInfo.GetPreview() + self["continuePrinting"] = pInfo.GetContinuePrinting() + self["curPage"] = pInfo.GetCurPage() + self["numPreviewPages"] = pInfo.GetNumPreviewPages() + self["userData"] = pInfo.GetUserData() + self["draw"] = pInfo.GetDraw() + self["pageDesc"] = pInfo.GetPageDesc() + self["minPage"] = pInfo.GetMinPage() + self["maxPage"] = pInfo.GetMaxPage() + self["offsetPage"] = pInfo.GetOffsetPage() + self["fromPage"] = pInfo.GetFromPage() + self["toPage"] = pInfo.GetToPage() + self["copies"] = pInfo.GetCopies() + self["deviceName"] = pInfo.GetDeviceName() + self["driverName"] = pInfo.GetDriverName() + self["printAll"] = pInfo.PrintAll() + self["printCollate"] = pInfo.PrintCollate() + self["printRange"] = pInfo.PrintRange() + self["printSelection"] = pInfo.PrintSelection() + del self.pInfo + + +class PropertyPage(Dialog): + "Base class for a Property Page" + + def __init__(self, id, dllid=None, caption=0): + """id is the resource ID + dllid may be None, a dll object, or a string with a dll name""" + + self.dll = dllFromDll(dllid) + if self.dll: + oldRes = win32ui.SetResource(self.dll) + if type(id) == type([]): + dlg = win32ui.CreatePropertyPageIndirect(id) + else: + dlg = win32ui.CreatePropertyPage(id, caption) + if self.dll: + win32ui.SetResource(oldRes) + # dont call dialog init! + window.Wnd.__init__(self, dlg) + self.HookCommands() + + +class PropertySheet(window.Wnd): + def __init__(self, caption, dll=None, pageList=None): # parent=None, style,etc): + "Initialize a property sheet. pageList is a list of ID's" + # must take a reference to the DLL until InitDialog. + self.dll = dllFromDll(dll) + self.sheet = win32ui.CreatePropertySheet(caption) + window.Wnd.__init__(self, self.sheet) + if not pageList is None: + self.AddPage(pageList) + + def OnInitDialog(self): + return self._obj_.OnInitDialog() + + def DoModal(self): + if self.dll: + oldRes = win32ui.SetResource(self.dll) + rc = self.sheet.DoModal() + if self.dll: + win32ui.SetResource(oldRes) + return rc + + def AddPage(self, pages): + if self.dll: + oldRes = win32ui.SetResource(self.dll) + try: # try list style access + pages[0] + isSeq = 1 + except (TypeError, KeyError): + isSeq = 0 + if isSeq: + for page in pages: + self.DoAddSinglePage(page) + else: + self.DoAddSinglePage(pages) + if self.dll: + win32ui.SetResource(oldRes) + + def DoAddSinglePage(self, page): + "Page may be page, or int ID. Assumes DLL setup" + if type(page) == type(0): + self.sheet.AddPage(win32ui.CreatePropertyPage(page)) + else: + self.sheet.AddPage(page) + + +# define some app utility functions. +def GetSimpleInput(prompt, defValue="", title=None): + """displays a dialog, and returns a string, or None if cancelled. + args prompt, defValue='', title=main frames title""" + # uses a simple dialog to return a string object. + if title is None: + title = win32ui.GetMainFrame().GetWindowText() + # 2to3 insists on converting 'Dialog.__init__' to 'tkinter.dialog...' + DlgBaseClass = Dialog + + class DlgSimpleInput(DlgBaseClass): + def __init__(self, prompt, defValue, title): + self.title = title + DlgBaseClass.__init__(self, win32ui.IDD_SIMPLE_INPUT) + self.AddDDX(win32ui.IDC_EDIT1, "result") + self.AddDDX(win32ui.IDC_PROMPT1, "prompt") + self._obj_.data["result"] = defValue + self._obj_.data["prompt"] = prompt + + def OnInitDialog(self): + self.SetWindowText(self.title) + return DlgBaseClass.OnInitDialog(self) + + dlg = DlgSimpleInput(prompt, defValue, title) + if dlg.DoModal() != win32con.IDOK: + return None + return dlg["result"] diff --git a/lib/pythonwin/pywin/mfc/docview.py b/lib/pythonwin/pywin/mfc/docview.py new file mode 100644 index 00000000..7da91b46 --- /dev/null +++ b/lib/pythonwin/pywin/mfc/docview.py @@ -0,0 +1,151 @@ +# document and view classes for MFC. +import win32ui + +from . import object, window + + +class View(window.Wnd): + def __init__(self, initobj): + window.Wnd.__init__(self, initobj) + + def OnInitialUpdate(self): + pass + + +# Simple control based views. +class CtrlView(View): + def __init__(self, doc, wndclass, style=0): + View.__init__(self, win32ui.CreateCtrlView(doc, wndclass, style)) + + +class EditView(CtrlView): + def __init__(self, doc): + View.__init__(self, win32ui.CreateEditView(doc)) + + +class RichEditView(CtrlView): + def __init__(self, doc): + View.__init__(self, win32ui.CreateRichEditView(doc)) + + +class ListView(CtrlView): + def __init__(self, doc): + View.__init__(self, win32ui.CreateListView(doc)) + + +class TreeView(CtrlView): + def __init__(self, doc): + View.__init__(self, win32ui.CreateTreeView(doc)) + + +# Other more advanced views. +class ScrollView(View): + def __init__(self, doc): + View.__init__(self, win32ui.CreateView(doc)) + + +class FormView(View): + def __init__(self, doc, id): + View.__init__(self, win32ui.CreateFormView(doc, id)) + + +class Document(object.CmdTarget): + def __init__(self, template, docobj=None): + if docobj is None: + docobj = template.DoCreateDoc() + object.CmdTarget.__init__(self, docobj) + + +class RichEditDoc(object.CmdTarget): + def __init__(self, template): + object.CmdTarget.__init__(self, template.DoCreateRichEditDoc()) + + +class CreateContext: + "A transient base class used as a CreateContext" + + def __init__(self, template, doc=None): + self.template = template + self.doc = doc + + def __del__(self): + self.close() + + def close(self): + self.doc = None + self.template = None + + +class DocTemplate(object.CmdTarget): + def __init__( + self, resourceId=None, MakeDocument=None, MakeFrame=None, MakeView=None + ): + if resourceId is None: + resourceId = win32ui.IDR_PYTHONTYPE + object.CmdTarget.__init__(self, self._CreateDocTemplate(resourceId)) + self.MakeDocument = MakeDocument + self.MakeFrame = MakeFrame + self.MakeView = MakeView + self._SetupSharedMenu_() + + def _SetupSharedMenu_(self): + pass # to be overridden by each "app" + + def _CreateDocTemplate(self, resourceId): + return win32ui.CreateDocTemplate(resourceId) + + def __del__(self): + object.CmdTarget.__del__(self) + + def CreateCreateContext(self, doc=None): + return CreateContext(self, doc) + + def CreateNewFrame(self, doc): + makeFrame = self.MakeFrame + if makeFrame is None: + makeFrame = window.MDIChildWnd + wnd = makeFrame() + context = self.CreateCreateContext(doc) + wnd.LoadFrame( + self.GetResourceID(), -1, None, context + ) # triggers OnCreateClient... + return wnd + + def CreateNewDocument(self): + makeDocument = self.MakeDocument + if makeDocument is None: + makeDocument = Document + return makeDocument(self) + + def CreateView(self, frame, context): + makeView = self.MakeView + if makeView is None: + makeView = EditView + view = makeView(context.doc) + view.CreateWindow(frame) + + +class RichEditDocTemplate(DocTemplate): + def __init__( + self, resourceId=None, MakeDocument=None, MakeFrame=None, MakeView=None + ): + if MakeView is None: + MakeView = RichEditView + if MakeDocument is None: + MakeDocument = RichEditDoc + DocTemplate.__init__(self, resourceId, MakeDocument, MakeFrame, MakeView) + + def _CreateDocTemplate(self, resourceId): + return win32ui.CreateRichEditDocTemplate(resourceId) + + +def t(): + class FormTemplate(DocTemplate): + def CreateView(self, frame, context): + makeView = self.MakeView + # view = FormView(context.doc, win32ui.IDD_PROPDEMO1) + view = ListView(context.doc) + view.CreateWindow(frame) + + t = FormTemplate() + return t.OpenDocumentFile(None) diff --git a/lib/pythonwin/pywin/mfc/object.py b/lib/pythonwin/pywin/mfc/object.py new file mode 100644 index 00000000..70138b6e --- /dev/null +++ b/lib/pythonwin/pywin/mfc/object.py @@ -0,0 +1,66 @@ +# MFC base classes. + +import win32ui + + +class Object: + def __init__(self, initObj=None): + self.__dict__["_obj_"] = initObj + # self._obj_ = initObj + if initObj is not None: + initObj.AttachObject(self) + + def __del__(self): + self.close() + + def __getattr__( + self, attr + ): # Make this object look like the underlying win32ui one. + # During cleanup __dict__ is not available, causing recursive death. + if not attr.startswith("__"): + try: + o = self.__dict__["_obj_"] + if o is not None: + return getattr(o, attr) + # Only raise this error for non "internal" names - + # Python may be calling __len__, __nonzero__, etc, so + # we dont want this exception + if attr[0] != "_" and attr[-1] != "_": + raise win32ui.error("The MFC object has died.") + except KeyError: + # No _obj_ at all - dont report MFC object died when there isnt one! + pass + raise AttributeError(attr) + + def OnAttachedObjectDeath(self): + # print "object", self.__class__.__name__, "dieing" + self._obj_ = None + + def close(self): + if "_obj_" in self.__dict__: + if self._obj_ is not None: + self._obj_.AttachObject(None) + self._obj_ = None + + +class CmdTarget(Object): + def __init__(self, initObj): + Object.__init__(self, initObj) + + def HookNotifyRange(self, handler, firstID, lastID): + oldhandlers = [] + for i in range(firstID, lastID + 1): + oldhandlers.append(self.HookNotify(handler, i)) + return oldhandlers + + def HookCommandRange(self, handler, firstID, lastID): + oldhandlers = [] + for i in range(firstID, lastID + 1): + oldhandlers.append(self.HookCommand(handler, i)) + return oldhandlers + + def HookCommandUpdateRange(self, handler, firstID, lastID): + oldhandlers = [] + for i in range(firstID, lastID + 1): + oldhandlers.append(self.HookCommandUpdate(handler, i)) + return oldhandlers diff --git a/lib/pythonwin/pywin/mfc/thread.py b/lib/pythonwin/pywin/mfc/thread.py new file mode 100644 index 00000000..90a0a762 --- /dev/null +++ b/lib/pythonwin/pywin/mfc/thread.py @@ -0,0 +1,25 @@ +# Thread and application objects + +import win32ui + +from . import object + + +class WinThread(object.CmdTarget): + def __init__(self, initObj=None): + if initObj is None: + initObj = win32ui.CreateThread() + object.CmdTarget.__init__(self, initObj) + + def InitInstance(self): + pass # Default None/0 return indicates success for InitInstance() + + def ExitInstance(self): + pass + + +class WinApp(WinThread): + def __init__(self, initApp=None): + if initApp is None: + initApp = win32ui.GetApp() + WinThread.__init__(self, initApp) diff --git a/lib/pythonwin/pywin/mfc/window.py b/lib/pythonwin/pywin/mfc/window.py new file mode 100644 index 00000000..e52a7c1c --- /dev/null +++ b/lib/pythonwin/pywin/mfc/window.py @@ -0,0 +1,50 @@ +# The MFCish window classes. +import win32con +import win32ui + +from . import object + + +class Wnd(object.CmdTarget): + def __init__(self, initobj=None): + object.CmdTarget.__init__(self, initobj) + if self._obj_: + self._obj_.HookMessage(self.OnDestroy, win32con.WM_DESTROY) + + def OnDestroy(self, msg): + pass + + +# NOTE NOTE - This facility is currently disabled in Pythonwin!!!!! +# Note - to process all messages for your window, add the following method +# to a derived class. This code provides default message handling (ie, is +# identical, except presumably in speed, as if the method did not exist at +# all, so presumably will be modified to test for specific messages to be +# useful! +# def WindowProc(self, msg, wParam, lParam): +# rc, lResult = self._obj_.OnWndMsg(msg, wParam, lParam) +# if not rc: lResult = self._obj_.DefWindowProc(msg, wParam, lParam) +# return lResult + + +class FrameWnd(Wnd): + def __init__(self, wnd): + Wnd.__init__(self, wnd) + + +class MDIChildWnd(FrameWnd): + def __init__(self, wnd=None): + if wnd is None: + wnd = win32ui.CreateMDIChild() + FrameWnd.__init__(self, wnd) + + def OnCreateClient(self, cp, context): + if context is not None and context.template is not None: + context.template.CreateView(self, context) + + +class MDIFrameWnd(FrameWnd): + def __init__(self, wnd=None): + if wnd is None: + wnd = win32ui.CreateMDIFrame() + FrameWnd.__init__(self, wnd) diff --git a/lib/pythonwin/pywin/scintilla/IDLEenvironment.py b/lib/pythonwin/pywin/scintilla/IDLEenvironment.py new file mode 100644 index 00000000..b1db5093 --- /dev/null +++ b/lib/pythonwin/pywin/scintilla/IDLEenvironment.py @@ -0,0 +1,598 @@ +# Code that allows Pythonwin to pretend it is IDLE +# (at least as far as most IDLE extensions are concerned) + +import string +import sys + +import win32api +import win32con +import win32ui +from pywin import default_scintilla_encoding +from pywin.mfc.dialog import GetSimpleInput + +wordchars = string.ascii_uppercase + string.ascii_lowercase + string.digits + + +class TextError(Exception): # When a TclError would normally be raised. + pass + + +class EmptyRange(Exception): # Internally raised. + pass + + +def GetIDLEModule(module): + try: + # First get it from Pythonwin it is exists. + modname = "pywin.idle." + module + __import__(modname) + except ImportError as details: + msg = ( + "The IDLE extension '%s' can not be located.\r\n\r\n" + "Please correct the installation and restart the" + " application.\r\n\r\n%s" % (module, details) + ) + win32ui.MessageBox(msg) + return None + mod = sys.modules[modname] + mod.TclError = TextError # A hack that can go soon! + return mod + + +# A class that is injected into the IDLE auto-indent extension. +# It allows for decent performance when opening a new file, +# as auto-indent uses the tokenizer module to determine indents. +# The default AutoIndent readline method works OK, but it goes through +# this layer of Tk index indirection for every single line. For large files +# without indents (and even small files with indents :-) it was pretty slow! +def fast_readline(self): + if self.finished: + val = "" + else: + if "_scint_lines" not in self.__dict__: + # XXX - note - assumes this is only called once the file is loaded! + self._scint_lines = self.text.edit.GetTextRange().split("\n") + sl = self._scint_lines + i = self.i = self.i + 1 + if i >= len(sl): + val = "" + else: + val = sl[i] + "\n" + return val.encode(default_scintilla_encoding) + + +try: + GetIDLEModule("AutoIndent").IndentSearcher.readline = fast_readline +except AttributeError: # GetIDLEModule may return None + pass + + +# A class that attempts to emulate an IDLE editor window. +# Construct with a Pythonwin view. +class IDLEEditorWindow: + def __init__(self, edit): + self.edit = edit + self.text = TkText(edit) + self.extensions = {} + self.extension_menus = {} + + def close(self): + self.edit = self.text = None + self.extension_menus = None + try: + for ext in self.extensions.values(): + closer = getattr(ext, "close", None) + if closer is not None: + closer() + finally: + self.extensions = {} + + def IDLEExtension(self, extension): + ext = self.extensions.get(extension) + if ext is not None: + return ext + mod = GetIDLEModule(extension) + if mod is None: + return None + klass = getattr(mod, extension) + ext = self.extensions[extension] = klass(self) + # Find and bind all the events defined in the extension. + events = [item for item in dir(klass) if item[-6:] == "_event"] + for event in events: + name = "<<%s>>" % (event[:-6].replace("_", "-"),) + self.edit.bindings.bind(name, getattr(ext, event)) + return ext + + def GetMenuItems(self, menu_name): + # Get all menu items for the menu name (eg, "edit") + bindings = self.edit.bindings + ret = [] + for ext in self.extensions.values(): + menudefs = getattr(ext, "menudefs", []) + for name, items in menudefs: + if name == menu_name: + for text, event in [item for item in items if item is not None]: + text = text.replace("&", "&&") + text = text.replace("_", "&") + ret.append((text, event)) + return ret + + ###################################################################### + # The IDLE "Virtual UI" methods that are exposed to the IDLE extensions. + # + def askinteger( + self, caption, prompt, parent=None, initialvalue=0, minvalue=None, maxvalue=None + ): + while 1: + rc = GetSimpleInput(prompt, str(initialvalue), caption) + if rc is None: + return 0 # Correct "cancel" semantics? + err = None + try: + rc = int(rc) + except ValueError: + err = "Please enter an integer" + if not err and minvalue is not None and rc < minvalue: + err = "Please enter an integer greater then or equal to %s" % ( + minvalue, + ) + if not err and maxvalue is not None and rc > maxvalue: + err = "Please enter an integer less then or equal to %s" % (maxvalue,) + if err: + win32ui.MessageBox(err, caption, win32con.MB_OK) + continue + return rc + + def askyesno(self, caption, prompt, parent=None): + return win32ui.MessageBox(prompt, caption, win32con.MB_YESNO) == win32con.IDYES + + ###################################################################### + # The IDLE "Virtual Text Widget" methods that are exposed to the IDLE extensions. + # + + # Is character at text_index in a Python string? Return 0 for + # "guaranteed no", true for anything else. + def is_char_in_string(self, text_index): + # A helper for the code analyser - we need internal knowledge of + # the colorizer to get this information + # This assumes the colorizer has got to this point! + text_index = self.text._getoffset(text_index) + c = self.text.edit._GetColorizer() + if c and c.GetStringStyle(text_index) is None: + return 0 + return 1 + + # If a selection is defined in the text widget, return + # (start, end) as Tkinter text indices, otherwise return + # (None, None) + def get_selection_indices(self): + try: + first = self.text.index("sel.first") + last = self.text.index("sel.last") + return first, last + except TextError: + return None, None + + def set_tabwidth(self, width): + self.edit.SCISetTabWidth(width) + + def get_tabwidth(self): + return self.edit.GetTabWidth() + + +# A class providing the generic "Call Tips" interface +class CallTips: + def __init__(self, edit): + self.edit = edit + + def showtip(self, tip_text): + self.edit.SCICallTipShow(tip_text) + + def hidetip(self): + self.edit.SCICallTipCancel() + + +######################################## +# +# Helpers for the TkText emulation. +def TkOffsetToIndex(offset, edit): + lineoff = 0 + # May be 1 > actual end if we pretended there was a trailing '\n' + offset = min(offset, edit.GetTextLength()) + line = edit.LineFromChar(offset) + lineIndex = edit.LineIndex(line) + return "%d.%d" % (line + 1, offset - lineIndex) + + +def _NextTok(str, pos): + # Returns (token, endPos) + end = len(str) + if pos >= end: + return None, 0 + while pos < end and str[pos] in string.whitespace: + pos = pos + 1 + # Special case for +- + if str[pos] in "+-": + return str[pos], pos + 1 + # Digits also a special case. + endPos = pos + while endPos < end and str[endPos] in string.digits + ".": + endPos = endPos + 1 + if pos != endPos: + return str[pos:endPos], endPos + endPos = pos + while endPos < end and str[endPos] not in string.whitespace + string.digits + "+-": + endPos = endPos + 1 + if pos != endPos: + return str[pos:endPos], endPos + return None, 0 + + +def TkIndexToOffset(bm, edit, marks): + base, nextTokPos = _NextTok(bm, 0) + if base is None: + raise ValueError("Empty bookmark ID!") + if base.find(".") > 0: + try: + line, col = base.split(".", 2) + if col == "first" or col == "last": + # Tag name + if line != "sel": + raise ValueError("Tags arent here!") + sel = edit.GetSel() + if sel[0] == sel[1]: + raise EmptyRange + if col == "first": + pos = sel[0] + else: + pos = sel[1] + else: + # Lines are 1 based for tkinter + line = int(line) - 1 + if line > edit.GetLineCount(): + pos = edit.GetTextLength() + 1 + else: + pos = edit.LineIndex(line) + if pos == -1: + pos = edit.GetTextLength() + pos = pos + int(col) + except (ValueError, IndexError): + raise ValueError("Unexpected literal in '%s'" % base) + elif base == "insert": + pos = edit.GetSel()[0] + elif base == "end": + pos = edit.GetTextLength() + # Pretend there is a trailing '\n' if necessary + if pos and edit.SCIGetCharAt(pos - 1) != "\n": + pos = pos + 1 + else: + try: + pos = marks[base] + except KeyError: + raise ValueError("Unsupported base offset or undefined mark '%s'" % base) + + while 1: + word, nextTokPos = _NextTok(bm, nextTokPos) + if word is None: + break + if word in ("+", "-"): + num, nextTokPos = _NextTok(bm, nextTokPos) + if num is None: + raise ValueError("+/- operator needs 2 args") + what, nextTokPos = _NextTok(bm, nextTokPos) + if what is None: + raise ValueError("+/- operator needs 2 args") + if what[0] != "c": + raise ValueError("+/- only supports chars") + if word == "+": + pos = pos + int(num) + else: + pos = pos - int(num) + elif word == "wordstart": + while pos > 0 and edit.SCIGetCharAt(pos - 1) in wordchars: + pos = pos - 1 + elif word == "wordend": + end = edit.GetTextLength() + while pos < end and edit.SCIGetCharAt(pos) in wordchars: + pos = pos + 1 + elif word == "linestart": + while pos > 0 and edit.SCIGetCharAt(pos - 1) not in "\n\r": + pos = pos - 1 + elif word == "lineend": + end = edit.GetTextLength() + while pos < end and edit.SCIGetCharAt(pos) not in "\n\r": + pos = pos + 1 + else: + raise ValueError("Unsupported relative offset '%s'" % word) + return max(pos, 0) # Tkinter is tollerant of -ve indexes - we aren't + + +# A class that resembles an IDLE (ie, a Tk) text widget. +# Construct with an edit object (eg, an editor view) +class TkText: + def __init__(self, edit): + self.calltips = None + self.edit = edit + self.marks = {} + + ## def __getattr__(self, attr): + ## if attr=="tk": return self # So text.tk.call works. + ## if attr=="master": return None # ditto! + ## raise AttributeError, attr + ## def __getitem__(self, item): + ## if item=="tabs": + ## size = self.edit.GetTabWidth() + ## if size==8: return "" # Tk default + ## return size # correct semantics? + ## elif item=="font": # Used for measurements we dont need to do! + ## return "Dont know the font" + ## raise IndexError, "Invalid index '%s'" % item + def make_calltip_window(self): + if self.calltips is None: + self.calltips = CallTips(self.edit) + return self.calltips + + def _getoffset(self, index): + return TkIndexToOffset(index, self.edit, self.marks) + + def _getindex(self, off): + return TkOffsetToIndex(off, self.edit) + + def _fix_indexes(self, start, end): + # first some magic to handle skipping over utf8 extended chars. + while start > 0 and ord(self.edit.SCIGetCharAt(start)) & 0xC0 == 0x80: + start -= 1 + while ( + end < self.edit.GetTextLength() + and ord(self.edit.SCIGetCharAt(end)) & 0xC0 == 0x80 + ): + end += 1 + # now handling fixing \r\n->\n disparities... + if ( + start > 0 + and self.edit.SCIGetCharAt(start) == "\n" + and self.edit.SCIGetCharAt(start - 1) == "\r" + ): + start = start - 1 + if ( + end < self.edit.GetTextLength() + and self.edit.SCIGetCharAt(end - 1) == "\r" + and self.edit.SCIGetCharAt(end) == "\n" + ): + end = end + 1 + return start, end + + ## def get_tab_width(self): + ## return self.edit.GetTabWidth() + ## def call(self, *rest): + ## # Crap to support Tk measurement hacks for tab widths + ## if rest[0] != "font" or rest[1] != "measure": + ## raise ValueError, "Unsupport call type" + ## return len(rest[5]) + ## def configure(self, **kw): + ## for name, val in kw.items(): + ## if name=="tabs": + ## self.edit.SCISetTabWidth(int(val)) + ## else: + ## raise ValueError, "Unsupported configuration item %s" % kw + def bind(self, binding, handler): + self.edit.bindings.bind(binding, handler) + + def get(self, start, end=None): + try: + start = self._getoffset(start) + if end is None: + end = start + 1 + else: + end = self._getoffset(end) + except EmptyRange: + return "" + # Simple semantic checks to conform to the Tk text interface + if end <= start: + return "" + max = self.edit.GetTextLength() + checkEnd = 0 + if end > max: + end = max + checkEnd = 1 + start, end = self._fix_indexes(start, end) + ret = self.edit.GetTextRange(start, end) + # pretend a trailing '\n' exists if necessary. + if checkEnd and (not ret or ret[-1] != "\n"): + ret = ret + "\n" + return ret.replace("\r", "") + + def index(self, spec): + try: + return self._getindex(self._getoffset(spec)) + except EmptyRange: + return "" + + def insert(self, pos, text): + try: + pos = self._getoffset(pos) + except EmptyRange: + raise TextError("Empty range") + self.edit.SetSel((pos, pos)) + # IDLE only deals with "\n" - we will be nicer + + bits = text.split("\n") + self.edit.SCIAddText(bits[0]) + for bit in bits[1:]: + self.edit.SCINewline() + self.edit.SCIAddText(bit) + + def delete(self, start, end=None): + try: + start = self._getoffset(start) + if end is not None: + end = self._getoffset(end) + except EmptyRange: + raise TextError("Empty range") + # If end is specified and == start, then we must delete nothing. + if start == end: + return + # If end is not specified, delete one char + if end is None: + end = start + 1 + else: + # Tk says not to delete in this case, but our control would. + if end < start: + return + if start == self.edit.GetTextLength(): + return # Nothing to delete. + old = self.edit.GetSel()[0] # Lose a selection + # Hack for partial '\r\n' and UTF-8 char removal + start, end = self._fix_indexes(start, end) + self.edit.SetSel((start, end)) + self.edit.Clear() + if old >= start and old < end: + old = start + elif old >= end: + old = old - (end - start) + self.edit.SetSel(old) + + def bell(self): + win32api.MessageBeep() + + def see(self, pos): + # Most commands we use in Scintilla actually force the selection + # to be seen, making this unnecessary. + pass + + def mark_set(self, name, pos): + try: + pos = self._getoffset(pos) + except EmptyRange: + raise TextError("Empty range '%s'" % pos) + if name == "insert": + self.edit.SetSel(pos) + else: + self.marks[name] = pos + + def tag_add(self, name, start, end): + if name != "sel": + raise ValueError("Only sel tag is supported") + try: + start = self._getoffset(start) + end = self._getoffset(end) + except EmptyRange: + raise TextError("Empty range") + self.edit.SetSel(start, end) + + def tag_remove(self, name, start, end): + if name != "sel" or start != "1.0" or end != "end": + raise ValueError("Cant remove this tag") + # Turn the sel into a cursor + self.edit.SetSel(self.edit.GetSel()[0]) + + def compare(self, i1, op, i2): + try: + i1 = self._getoffset(i1) + except EmptyRange: + i1 = "" + try: + i2 = self._getoffset(i2) + except EmptyRange: + i2 = "" + return eval("%d%s%d" % (i1, op, i2)) + + def undo_block_start(self): + self.edit.SCIBeginUndoAction() + + def undo_block_stop(self): + self.edit.SCIEndUndoAction() + + +###################################################################### +# +# Test related code. +# +###################################################################### +def TestCheck(index, edit, expected=None): + rc = TkIndexToOffset(index, edit, {}) + if rc != expected: + print("ERROR: Index", index, ", expected", expected, "but got", rc) + + +def TestGet(fr, to, t, expected): + got = t.get(fr, to) + if got != expected: + print( + "ERROR: get(%s, %s) expected %s, but got %s" + % (repr(fr), repr(to), repr(expected), repr(got)) + ) + + +def test(): + import pywin.framework.editor + + d = pywin.framework.editor.editorTemplate.OpenDocumentFile(None) + e = d.GetFirstView() + t = TkText(e) + e.SCIAddText("hi there how\nare you today\r\nI hope you are well") + e.SetSel((4, 4)) + + skip = """ + TestCheck("insert", e, 4) + TestCheck("insert wordstart", e, 3) + TestCheck("insert wordend", e, 8) + TestCheck("insert linestart", e, 0) + TestCheck("insert lineend", e, 12) + TestCheck("insert + 4 chars", e, 8) + TestCheck("insert +4c", e, 8) + TestCheck("insert - 2 chars", e, 2) + TestCheck("insert -2c", e, 2) + TestCheck("insert-2c", e, 2) + TestCheck("insert-2 c", e, 2) + TestCheck("insert- 2c", e, 2) + TestCheck("1.1", e, 1) + TestCheck("1.0", e, 0) + TestCheck("2.0", e, 13) + try: + TestCheck("sel.first", e, 0) + print "*** sel.first worked with an empty selection" + except TextError: + pass + e.SetSel((4,5)) + TestCheck("sel.first- 2c", e, 2) + TestCheck("sel.last- 2c", e, 3) + """ + # Check EOL semantics + e.SetSel((4, 4)) + TestGet("insert lineend", "insert lineend +1c", t, "\n") + e.SetSel((20, 20)) + TestGet("insert lineend", "insert lineend +1c", t, "\n") + e.SetSel((35, 35)) + TestGet("insert lineend", "insert lineend +1c", t, "\n") + + +class IDLEWrapper: + def __init__(self, control): + self.text = control + + +def IDLETest(extension): + import os + import sys + + modname = "pywin.idle." + extension + __import__(modname) + mod = sys.modules[modname] + mod.TclError = TextError + klass = getattr(mod, extension) + + # Create a new Scintilla Window. + import pywin.framework.editor + + d = pywin.framework.editor.editorTemplate.OpenDocumentFile(None) + v = d.GetFirstView() + fname = os.path.splitext(__file__)[0] + ".py" + v.SCIAddText(open(fname).read()) + d.SetModifiedFlag(0) + r = klass(IDLEWrapper(TkText(v))) + return r + + +if __name__ == "__main__": + test() diff --git a/lib/pythonwin/pywin/scintilla/__init__.py b/lib/pythonwin/pywin/scintilla/__init__.py new file mode 100644 index 00000000..0981b622 --- /dev/null +++ b/lib/pythonwin/pywin/scintilla/__init__.py @@ -0,0 +1 @@ +# package init. diff --git a/lib/pythonwin/pywin/scintilla/bindings.py b/lib/pythonwin/pywin/scintilla/bindings.py new file mode 100644 index 00000000..785bd42a --- /dev/null +++ b/lib/pythonwin/pywin/scintilla/bindings.py @@ -0,0 +1,178 @@ +import traceback + +import win32api +import win32con +import win32ui + +from . import IDLEenvironment, keycodes + +HANDLER_ARGS_GUESS = 0 +HANDLER_ARGS_NATIVE = 1 +HANDLER_ARGS_IDLE = 2 +HANDLER_ARGS_EXTENSION = 3 + +next_id = 5000 + +event_to_commands = {} # dict of integer IDs to event names. +command_to_events = {} # dict of event names to int IDs + + +def assign_command_id(event, id=0): + global next_id + if id == 0: + id = event_to_commands.get(event, 0) + if id == 0: + id = next_id + next_id = next_id + 1 + # Only map the ones we allocated - specified ones are assumed to have a handler + command_to_events[id] = event + event_to_commands[event] = id + return id + + +class SendCommandHandler: + def __init__(self, cmd): + self.cmd = cmd + + def __call__(self, *args): + win32ui.GetMainFrame().SendMessage(win32con.WM_COMMAND, self.cmd) + + +class Binding: + def __init__(self, handler, handler_args_type): + self.handler = handler + self.handler_args_type = handler_args_type + + +class BindingsManager: + def __init__(self, parent_view): + self.parent_view = parent_view + self.bindings = {} # dict of Binding instances. + self.keymap = {} + + def prepare_configure(self): + self.keymap = {} + + def complete_configure(self): + for id in command_to_events.keys(): + self.parent_view.HookCommand(self._OnCommand, id) + + def close(self): + self.parent_view = self.bindings = self.keymap = None + + def report_error(self, problem): + try: + win32ui.SetStatusText(problem, 1) + except win32ui.error: + # No status bar! + print(problem) + + def update_keymap(self, keymap): + self.keymap.update(keymap) + + def bind(self, event, handler, handler_args_type=HANDLER_ARGS_GUESS, cid=0): + if handler is None: + handler = SendCommandHandler(cid) + self.bindings[event] = self._new_binding(handler, handler_args_type) + self.bind_command(event, cid) + + def bind_command(self, event, id=0): + "Binds an event to a Windows control/command ID" + id = assign_command_id(event, id) + return id + + def get_command_id(self, event): + id = event_to_commands.get(event) + if id is None: + # See if we even have an event of that name!? + if event not in self.bindings: + return None + id = self.bind_command(event) + return id + + def _OnCommand(self, id, code): + event = command_to_events.get(id) + if event is None: + self.report_error("No event associated with event ID %d" % id) + return 1 + return self.fire(event) + + def _new_binding(self, event, handler_args_type): + return Binding(event, handler_args_type) + + def _get_IDLE_handler(self, ext, handler): + try: + instance = self.parent_view.idle.IDLEExtension(ext) + name = handler.replace("-", "_") + "_event" + return getattr(instance, name) + except (ImportError, AttributeError): + msg = "Can not find event '%s' in IDLE extension '%s'" % (handler, ext) + self.report_error(msg) + return None + + def fire(self, event, event_param=None): + # Fire the specified event. Result is native Pythonwin result + # (ie, 1==pass one, 0 or None==handled) + + # First look up the event directly - if there, we are set. + binding = self.bindings.get(event) + if binding is None: + # If possible, find it! + # A native method name + handler = getattr(self.parent_view, event + "Event", None) + if handler is None: + # Can't decide if I should report an error?? + self.report_error("The event name '%s' can not be found." % event) + # Either way, just let the default handlers grab it. + return 1 + binding = self._new_binding(handler, HANDLER_ARGS_NATIVE) + # Cache it. + self.bindings[event] = binding + + handler_args_type = binding.handler_args_type + # Now actually fire it. + if handler_args_type == HANDLER_ARGS_GUESS: + # Can't be native, as natives are never added with "guess". + # Must be extension or IDLE. + if event[0] == "<": + handler_args_type = HANDLER_ARGS_IDLE + else: + handler_args_type = HANDLER_ARGS_EXTENSION + try: + if handler_args_type == HANDLER_ARGS_EXTENSION: + args = self.parent_view.idle, event_param + else: + args = (event_param,) + rc = binding.handler(*args) + if handler_args_type == HANDLER_ARGS_IDLE: + # Convert to our return code. + if rc in (None, "break"): + rc = 0 + else: + rc = 1 + except: + message = "Firing event '%s' failed." % event + print(message) + traceback.print_exc() + self.report_error(message) + rc = 1 # Let any default handlers have a go! + return rc + + def fire_key_event(self, msg): + key = msg[2] + keyState = 0 + if win32api.GetKeyState(win32con.VK_CONTROL) & 0x8000: + keyState = ( + keyState | win32con.RIGHT_CTRL_PRESSED | win32con.LEFT_CTRL_PRESSED + ) + if win32api.GetKeyState(win32con.VK_SHIFT) & 0x8000: + keyState = keyState | win32con.SHIFT_PRESSED + if win32api.GetKeyState(win32con.VK_MENU) & 0x8000: + keyState = keyState | win32con.LEFT_ALT_PRESSED | win32con.RIGHT_ALT_PRESSED + keyinfo = key, keyState + # Special hacks for the dead-char key on non-US keyboards. + # (XXX - which do not work :-( + event = self.keymap.get(keyinfo) + if event is None: + return 1 + return self.fire(event, None) diff --git a/lib/pythonwin/pywin/scintilla/config.py b/lib/pythonwin/pywin/scintilla/config.py new file mode 100644 index 00000000..9a1b210e --- /dev/null +++ b/lib/pythonwin/pywin/scintilla/config.py @@ -0,0 +1,365 @@ +# config.py - deals with loading configuration information. + +# Loads config data from a .cfg file. Also caches the compiled +# data back into a .cfc file. + +# If you are wondering how to avoid needing .cfg files (eg, +# if you are freezing Pythonwin etc) I suggest you create a +# .py file, and put the config info in a docstring. Then +# pass a CStringIO file (rather than a filename) to the +# config manager. +import glob +import importlib.util +import marshal +import os +import stat +import sys +import traceback +import types + +import pywin +import win32api + +from . import keycodes + +debugging = 0 +if debugging: + import win32traceutil # Some trace statements fire before the interactive window is open. + + def trace(*args): + sys.stderr.write(" ".join(map(str, args)) + "\n") + +else: + trace = lambda *args: None + +compiled_config_version = 3 + + +def split_line(line, lineno): + comment_pos = line.find("#") + if comment_pos >= 0: + line = line[:comment_pos] + sep_pos = line.rfind("=") + if sep_pos == -1: + if line.strip(): + print("Warning: Line %d: %s is an invalid entry" % (lineno, repr(line))) + return None, None + return "", "" + return line[:sep_pos].strip(), line[sep_pos + 1 :].strip() + + +def get_section_header(line): + # Returns the section if the line is a section header, else None + if line[0] == "[": + end = line.find("]") + if end == -1: + end = len(line) + rc = line[1:end].lower() + try: + i = rc.index(":") + return rc[:i], rc[i + 1 :] + except ValueError: + return rc, "" + return None, None + + +def find_config_file(f): + return os.path.join(pywin.__path__[0], f + ".cfg") + + +def find_config_files(): + return [ + os.path.split(x)[1] + for x in [ + os.path.splitext(x)[0] + for x in glob.glob(os.path.join(pywin.__path__[0], "*.cfg")) + ] + ] + + +class ConfigManager: + def __init__(self, f): + self.filename = "unknown" + self.last_error = None + self.key_to_events = {} + b_close = False + if hasattr(f, "readline"): + fp = f + self.filename = "" + compiled_name = None + else: + try: + f = find_config_file(f) + src_stat = os.stat(f) + except os.error: + self.report_error("Config file '%s' not found" % f) + return + self.filename = f + self.basename = os.path.basename(f) + trace("Loading configuration", self.basename) + compiled_name = os.path.splitext(f)[0] + ".cfc" + try: + cf = open(compiled_name, "rb") + try: + ver = marshal.load(cf) + ok = compiled_config_version == ver + if ok: + kblayoutname = marshal.load(cf) + magic = marshal.load(cf) + size = marshal.load(cf) + mtime = marshal.load(cf) + if ( + magic == importlib.util.MAGIC_NUMBER + and win32api.GetKeyboardLayoutName() == kblayoutname + and src_stat[stat.ST_MTIME] == mtime + and src_stat[stat.ST_SIZE] == size + ): + self.cache = marshal.load(cf) + trace("Configuration loaded cached", compiled_name) + return # We are ready to roll! + finally: + cf.close() + except (os.error, IOError, EOFError): + pass + fp = open(f) + b_close = True + self.cache = {} + lineno = 1 + line = fp.readline() + while line: + # Skip to the next section (maybe already there!) + section, subsection = get_section_header(line) + while line and section is None: + line = fp.readline() + if not line: + break + lineno = lineno + 1 + section, subsection = get_section_header(line) + if not line: + break + + if section == "keys": + line, lineno = self._load_keys(subsection, fp, lineno) + elif section == "extensions": + line, lineno = self._load_extensions(subsection, fp, lineno) + elif section == "idle extensions": + line, lineno = self._load_idle_extensions(subsection, fp, lineno) + elif section == "general": + line, lineno = self._load_general(subsection, fp, lineno) + else: + self.report_error( + "Unrecognised section header '%s:%s'" % (section, subsection) + ) + line = fp.readline() + lineno = lineno + 1 + if b_close: + fp.close() + # Check critical data. + if not self.cache.get("keys"): + self.report_error("No keyboard definitions were loaded") + if not self.last_error and compiled_name: + try: + cf = open(compiled_name, "wb") + marshal.dump(compiled_config_version, cf) + marshal.dump(win32api.GetKeyboardLayoutName(), cf) + marshal.dump(importlib.util.MAGIC_NUMBER, cf) + marshal.dump(src_stat[stat.ST_SIZE], cf) + marshal.dump(src_stat[stat.ST_MTIME], cf) + marshal.dump(self.cache, cf) + cf.close() + except (IOError, EOFError): + pass # Ignore errors - may be read only. + + def configure(self, editor, subsections=None): + # Execute the extension code, and find any events. + # First, we "recursively" connect any we are based on. + if subsections is None: + subsections = [] + subsections = [""] + subsections + general = self.get_data("general") + if general: + parents = general.get("based on", []) + for parent in parents: + trace("Configuration based on", parent, "- loading.") + parent = self.__class__(parent) + parent.configure(editor, subsections) + if parent.last_error: + self.report_error(parent.last_error) + + bindings = editor.bindings + codeob = self.get_data("extension code") + if codeob is not None: + ns = {} + try: + exec(codeob, ns) + except: + traceback.print_exc() + self.report_error("Executing extension code failed") + ns = None + if ns: + num = 0 + for name, func in list(ns.items()): + if type(func) == types.FunctionType and name[:1] != "_": + bindings.bind(name, func) + num = num + 1 + trace("Configuration Extension code loaded", num, "events") + # Load the idle extensions + for subsection in subsections: + for ext in self.get_data("idle extensions", {}).get(subsection, []): + try: + editor.idle.IDLEExtension(ext) + trace("Loaded IDLE extension", ext) + except: + self.report_error("Can not load the IDLE extension '%s'" % ext) + + # Now bind up the key-map (remembering a reverse map + subsection_keymap = self.get_data("keys") + num_bound = 0 + for subsection in subsections: + keymap = subsection_keymap.get(subsection, {}) + bindings.update_keymap(keymap) + num_bound = num_bound + len(keymap) + trace("Configuration bound", num_bound, "keys") + + def get_key_binding(self, event, subsections=None): + if subsections is None: + subsections = [] + subsections = [""] + subsections + + subsection_keymap = self.get_data("keys") + for subsection in subsections: + map = self.key_to_events.get(subsection) + if map is None: # Build it + map = {} + keymap = subsection_keymap.get(subsection, {}) + for key_info, map_event in list(keymap.items()): + map[map_event] = key_info + self.key_to_events[subsection] = map + + info = map.get(event) + if info is not None: + return keycodes.make_key_name(info[0], info[1]) + return None + + def report_error(self, msg): + self.last_error = msg + print("Error in %s: %s" % (self.filename, msg)) + + def report_warning(self, msg): + print("Warning in %s: %s" % (self.filename, msg)) + + def _readline(self, fp, lineno, bStripComments=1): + line = fp.readline() + lineno = lineno + 1 + if line: + bBreak = ( + get_section_header(line)[0] is not None + ) # A new section is starting + if bStripComments and not bBreak: + pos = line.find("#") + if pos >= 0: + line = line[:pos] + "\n" + else: + bBreak = 1 + return line, lineno, bBreak + + def get_data(self, name, default=None): + return self.cache.get(name, default) + + def _save_data(self, name, data): + self.cache[name] = data + return data + + def _load_general(self, sub_section, fp, lineno): + map = {} + while 1: + line, lineno, bBreak = self._readline(fp, lineno) + if bBreak: + break + + key, val = split_line(line, lineno) + if not key: + continue + key = key.lower() + l = map.get(key, []) + l.append(val) + map[key] = l + self._save_data("general", map) + return line, lineno + + def _load_keys(self, sub_section, fp, lineno): + # Builds a nested dictionary of + # (scancode, flags) = event_name + main_map = self.get_data("keys", {}) + map = main_map.get(sub_section, {}) + while 1: + line, lineno, bBreak = self._readline(fp, lineno) + if bBreak: + break + + key, event = split_line(line, lineno) + if not event: + continue + sc, flag = keycodes.parse_key_name(key) + if sc is None: + self.report_warning("Line %d: Invalid key name '%s'" % (lineno, key)) + else: + map[sc, flag] = event + main_map[sub_section] = map + self._save_data("keys", main_map) + return line, lineno + + def _load_extensions(self, sub_section, fp, lineno): + start_lineno = lineno + lines = [] + while 1: + line, lineno, bBreak = self._readline(fp, lineno, 0) + if bBreak: + break + lines.append(line) + try: + c = compile( + "\n" * start_lineno + "".join(lines), # produces correct tracebacks + self.filename, + "exec", + ) + self._save_data("extension code", c) + except SyntaxError as details: + errlineno = details.lineno + start_lineno + # Should handle syntax errors better here, and offset the lineno. + self.report_error( + "Compiling extension code failed:\r\nFile: %s\r\nLine %d\r\n%s" + % (details.filename, errlineno, details.msg) + ) + return line, lineno + + def _load_idle_extensions(self, sub_section, fp, lineno): + extension_map = self.get_data("idle extensions") + if extension_map is None: + extension_map = {} + extensions = [] + while 1: + line, lineno, bBreak = self._readline(fp, lineno) + if bBreak: + break + line = line.strip() + if line: + extensions.append(line) + extension_map[sub_section] = extensions + self._save_data("idle extensions", extension_map) + return line, lineno + + +def test(): + import time + + start = time.clock() + f = "default" + cm = ConfigManager(f) + map = cm.get_data("keys") + took = time.clock() - start + print("Loaded %s items in %.4f secs" % (len(map), took)) + + +if __name__ == "__main__": + test() diff --git a/lib/pythonwin/pywin/scintilla/configui.py b/lib/pythonwin/pywin/scintilla/configui.py new file mode 100644 index 00000000..8b6157b6 --- /dev/null +++ b/lib/pythonwin/pywin/scintilla/configui.py @@ -0,0 +1,292 @@ +import win32api +import win32con +import win32ui +from pywin.mfc import dialog + +# Used to indicate that style should use default color +from win32con import CLR_INVALID + +from . import scintillacon + +###################################################### +# Property Page for syntax formatting options + +# The standard 16 color VGA palette should always be possible +paletteVGA = ( + ("Black", win32api.RGB(0, 0, 0)), + ("Navy", win32api.RGB(0, 0, 128)), + ("Green", win32api.RGB(0, 128, 0)), + ("Cyan", win32api.RGB(0, 128, 128)), + ("Maroon", win32api.RGB(128, 0, 0)), + ("Purple", win32api.RGB(128, 0, 128)), + ("Olive", win32api.RGB(128, 128, 0)), + ("Gray", win32api.RGB(128, 128, 128)), + ("Silver", win32api.RGB(192, 192, 192)), + ("Blue", win32api.RGB(0, 0, 255)), + ("Lime", win32api.RGB(0, 255, 0)), + ("Aqua", win32api.RGB(0, 255, 255)), + ("Red", win32api.RGB(255, 0, 0)), + ("Fuchsia", win32api.RGB(255, 0, 255)), + ("Yellow", win32api.RGB(255, 255, 0)), + ("White", win32api.RGB(255, 255, 255)), + # and a few others will generally be possible. + ("DarkGrey", win32api.RGB(64, 64, 64)), + ("PurpleBlue", win32api.RGB(64, 64, 192)), + ("DarkGreen", win32api.RGB(0, 96, 0)), + ("DarkOlive", win32api.RGB(128, 128, 64)), + ("MediumBlue", win32api.RGB(0, 0, 192)), + ("DarkNavy", win32api.RGB(0, 0, 96)), + ("Magenta", win32api.RGB(96, 0, 96)), + ("OffWhite", win32api.RGB(255, 255, 220)), + ("LightPurple", win32api.RGB(220, 220, 255)), + ("", win32con.CLR_INVALID), +) + + +class ScintillaFormatPropertyPage(dialog.PropertyPage): + def __init__(self, scintillaClass=None, caption=0): + self.scintillaClass = scintillaClass + dialog.PropertyPage.__init__(self, win32ui.IDD_PP_FORMAT, caption=caption) + + def OnInitDialog(self): + try: + if self.scintillaClass is None: + from . import control + + sc = control.CScintillaEdit + else: + sc = self.scintillaClass + + self.scintilla = sc() + style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.ES_MULTILINE + # Convert the rect size + rect = self.MapDialogRect((5, 5, 120, 75)) + self.scintilla.CreateWindow(style, rect, self, 111) + self.HookNotify(self.OnBraceMatch, scintillacon.SCN_CHECKBRACE) + self.scintilla.HookKeyStroke(self.OnEsc, 27) + self.scintilla.SCISetViewWS(1) + self.pos_bstart = self.pos_bend = self.pos_bbad = 0 + + colorizer = self.scintilla._GetColorizer() + text = colorizer.GetSampleText() + items = text.split("|", 2) + pos = len(items[0]) + self.scintilla.SCIAddText("".join(items)) + self.scintilla.SetSel(pos, pos) + self.scintilla.ApplyFormattingStyles() + self.styles = self.scintilla._GetColorizer().styles + + self.cbo = self.GetDlgItem(win32ui.IDC_COMBO1) + for c in paletteVGA: + self.cbo.AddString(c[0]) + + self.cboBoldItalic = self.GetDlgItem(win32ui.IDC_COMBO2) + for item in ("Bold Italic", "Bold", "Italic", "Regular"): + self.cboBoldItalic.InsertString(0, item) + + self.butIsDefault = self.GetDlgItem(win32ui.IDC_CHECK1) + self.butIsDefaultBackground = self.GetDlgItem(win32ui.IDC_CHECK2) + self.listbox = self.GetDlgItem(win32ui.IDC_LIST1) + self.HookCommand(self.OnListCommand, win32ui.IDC_LIST1) + names = list(self.styles.keys()) + names.sort() + for name in names: + if self.styles[name].aliased is None: + self.listbox.AddString(name) + self.listbox.SetCurSel(0) + + idc = win32ui.IDC_RADIO1 + if not self.scintilla._GetColorizer().bUseFixed: + idc = win32ui.IDC_RADIO2 + self.GetDlgItem(idc).SetCheck(1) + self.UpdateUIForStyle(self.styles[names[0]]) + + self.scintilla.HookFormatter(self) + self.HookCommand(self.OnButDefaultFixedFont, win32ui.IDC_BUTTON1) + self.HookCommand(self.OnButDefaultPropFont, win32ui.IDC_BUTTON2) + self.HookCommand(self.OnButThisFont, win32ui.IDC_BUTTON3) + self.HookCommand(self.OnButUseDefaultFont, win32ui.IDC_CHECK1) + self.HookCommand(self.OnButThisBackground, win32ui.IDC_BUTTON4) + self.HookCommand(self.OnButUseDefaultBackground, win32ui.IDC_CHECK2) + self.HookCommand(self.OnStyleUIChanged, win32ui.IDC_COMBO1) + self.HookCommand(self.OnStyleUIChanged, win32ui.IDC_COMBO2) + self.HookCommand(self.OnButFixedOrDefault, win32ui.IDC_RADIO1) + self.HookCommand(self.OnButFixedOrDefault, win32ui.IDC_RADIO2) + except: + import traceback + + traceback.print_exc() + + def OnEsc(self, ch): + self.GetParent().EndDialog(win32con.IDCANCEL) + + def OnBraceMatch(self, std, extra): + import pywin.scintilla.view + + pywin.scintilla.view.DoBraceMatch(self.scintilla) + + def GetSelectedStyle(self): + return self.styles[self.listbox.GetText(self.listbox.GetCurSel())] + + def _DoButDefaultFont(self, extra_flags, attr): + baseFormat = getattr(self.scintilla._GetColorizer(), attr) + flags = ( + extra_flags + | win32con.CF_SCREENFONTS + | win32con.CF_EFFECTS + | win32con.CF_FORCEFONTEXIST + ) + d = win32ui.CreateFontDialog(baseFormat, flags, None, self) + if d.DoModal() == win32con.IDOK: + setattr(self.scintilla._GetColorizer(), attr, d.GetCharFormat()) + self.OnStyleUIChanged(0, win32con.BN_CLICKED) + + def OnButDefaultFixedFont(self, id, code): + if code == win32con.BN_CLICKED: + self._DoButDefaultFont(win32con.CF_FIXEDPITCHONLY, "baseFormatFixed") + return 1 + + def OnButDefaultPropFont(self, id, code): + if code == win32con.BN_CLICKED: + self._DoButDefaultFont(win32con.CF_SCALABLEONLY, "baseFormatProp") + return 1 + + def OnButFixedOrDefault(self, id, code): + if code == win32con.BN_CLICKED: + bUseFixed = id == win32ui.IDC_RADIO1 + self.GetDlgItem(win32ui.IDC_RADIO1).GetCheck() != 0 + self.scintilla._GetColorizer().bUseFixed = bUseFixed + self.scintilla.ApplyFormattingStyles(0) + return 1 + + def OnButThisFont(self, id, code): + if code == win32con.BN_CLICKED: + flags = ( + win32con.CF_SCREENFONTS + | win32con.CF_EFFECTS + | win32con.CF_FORCEFONTEXIST + ) + style = self.GetSelectedStyle() + # If the selected style is based on the default, we need to apply + # the default to it. + def_format = self.scintilla._GetColorizer().GetDefaultFormat() + format = style.GetCompleteFormat(def_format) + d = win32ui.CreateFontDialog(format, flags, None, self) + if d.DoModal() == win32con.IDOK: + style.format = d.GetCharFormat() + self.scintilla.ApplyFormattingStyles(0) + return 1 + + def OnButUseDefaultFont(self, id, code): + if code == win32con.BN_CLICKED: + isDef = self.butIsDefault.GetCheck() + self.GetDlgItem(win32ui.IDC_BUTTON3).EnableWindow(not isDef) + if isDef: # Being reset to the default font. + style = self.GetSelectedStyle() + style.ForceAgainstDefault() + self.UpdateUIForStyle(style) + self.scintilla.ApplyFormattingStyles(0) + else: + # User wants to override default - + # do nothing! + pass + + def OnButThisBackground(self, id, code): + if code == win32con.BN_CLICKED: + style = self.GetSelectedStyle() + bg = win32api.RGB(0xFF, 0xFF, 0xFF) + if style.background != CLR_INVALID: + bg = style.background + d = win32ui.CreateColorDialog(bg, 0, self) + if d.DoModal() == win32con.IDOK: + style.background = d.GetColor() + self.scintilla.ApplyFormattingStyles(0) + return 1 + + def OnButUseDefaultBackground(self, id, code): + if code == win32con.BN_CLICKED: + isDef = self.butIsDefaultBackground.GetCheck() + self.GetDlgItem(win32ui.IDC_BUTTON4).EnableWindow(not isDef) + if isDef: # Being reset to the default color + style = self.GetSelectedStyle() + style.background = style.default_background + self.UpdateUIForStyle(style) + self.scintilla.ApplyFormattingStyles(0) + else: + # User wants to override default - + # do nothing! + pass + + def OnListCommand(self, id, code): + if code == win32con.LBN_SELCHANGE: + style = self.GetSelectedStyle() + self.UpdateUIForStyle(style) + return 1 + + def UpdateUIForStyle(self, style): + format = style.format + sel = 0 + for c in paletteVGA: + if format[4] == c[1]: + # print "Style", style.name, "is", c[0] + break + sel = sel + 1 + else: + sel = -1 + self.cbo.SetCurSel(sel) + self.butIsDefault.SetCheck(style.IsBasedOnDefault()) + self.GetDlgItem(win32ui.IDC_BUTTON3).EnableWindow(not style.IsBasedOnDefault()) + + self.butIsDefaultBackground.SetCheck( + style.background == style.default_background + ) + self.GetDlgItem(win32ui.IDC_BUTTON4).EnableWindow( + style.background != style.default_background + ) + + bold = format[1] & win32con.CFE_BOLD != 0 + italic = format[1] & win32con.CFE_ITALIC != 0 + self.cboBoldItalic.SetCurSel(bold * 2 + italic) + + def OnStyleUIChanged(self, id, code): + if code in [win32con.BN_CLICKED, win32con.CBN_SELCHANGE]: + style = self.GetSelectedStyle() + self.ApplyUIFormatToStyle(style) + self.scintilla.ApplyFormattingStyles(0) + return 0 + return 1 + + def ApplyUIFormatToStyle(self, style): + format = style.format + color = paletteVGA[self.cbo.GetCurSel()] + effect = 0 + sel = self.cboBoldItalic.GetCurSel() + if sel == 0: + effect = 0 + elif sel == 1: + effect = win32con.CFE_ITALIC + elif sel == 2: + effect = win32con.CFE_BOLD + else: + effect = win32con.CFE_BOLD | win32con.CFE_ITALIC + maskFlags = ( + format[0] | win32con.CFM_COLOR | win32con.CFM_BOLD | win32con.CFM_ITALIC + ) + style.format = ( + maskFlags, + effect, + style.format[2], + style.format[3], + color[1], + ) + style.format[5:] + + def OnOK(self): + self.scintilla._GetColorizer().SavePreferences() + return 1 + + +def test(): + page = ColorEditorPropertyPage() + sheet = pywin.mfc.dialog.PropertySheet("Test") + sheet.AddPage(page) + sheet.CreateWindow() diff --git a/lib/pythonwin/pywin/scintilla/control.py b/lib/pythonwin/pywin/scintilla/control.py new file mode 100644 index 00000000..460b1686 --- /dev/null +++ b/lib/pythonwin/pywin/scintilla/control.py @@ -0,0 +1,569 @@ +# An Python interface to the Scintilla control. +# +# Exposes Python classes that allow you to use Scintilla as +# a "standard" MFC edit control (eg, control.GetTextLength(), control.GetSel() +# plus many Scintilla specific features (eg control.SCIAddStyledText()) + +import array +import os +import struct + +import win32api +import win32con +import win32ui +from pywin import default_scintilla_encoding +from pywin.mfc import window + +from . import scintillacon + +# Load Scintilla.dll to get access to the control. +# We expect to find this in the same directory as win32ui.pyd +dllid = None +if win32ui.debug: # If running _d version of Pythonwin... + try: + dllid = win32api.LoadLibrary( + os.path.join(os.path.split(win32ui.__file__)[0], "Scintilla_d.DLL") + ) + except ( + win32api.error + ): # Not there - we dont _need_ a debug ver, so ignore this error. + pass +if dllid is None: + try: + dllid = win32api.LoadLibrary( + os.path.join(os.path.split(win32ui.__file__)[0], "Scintilla.DLL") + ) + except win32api.error: + pass +if dllid is None: + # Still not there - lets see if Windows can find it by searching? + dllid = win32api.LoadLibrary("Scintilla.DLL") + +# null_byte is str in py2k, bytes on py3k +null_byte = "\0".encode("ascii") + +## These are from Richedit.h - need to add to win32con or commctrl +EM_GETTEXTRANGE = 1099 +EM_EXLINEFROMCHAR = 1078 +EM_FINDTEXTEX = 1103 +EM_GETSELTEXT = 1086 +EM_EXSETSEL = win32con.WM_USER + 55 + + +class ScintillaNotification: + def __init__(self, **args): + self.__dict__.update(args) + + +class ScintillaControlInterface: + def SCIUnpackNotifyMessage(self, msg): + format = "iiiiPiiiPPiiii" + bytes = win32ui.GetBytes(msg, struct.calcsize(format)) + ( + position, + ch, + modifiers, + modificationType, + text_ptr, + length, + linesAdded, + msg, + wParam, + lParam, + line, + foldLevelNow, + foldLevelPrev, + margin, + ) = struct.unpack(format, bytes) + return ScintillaNotification( + position=position, + ch=ch, + modifiers=modifiers, + modificationType=modificationType, + text_ptr=text_ptr, + length=length, + linesAdded=linesAdded, + msg=msg, + wParam=wParam, + lParam=lParam, + line=line, + foldLevelNow=foldLevelNow, + foldLevelPrev=foldLevelPrev, + margin=margin, + ) + + def SCIAddText(self, text): + self.SendMessage( + scintillacon.SCI_ADDTEXT, text.encode(default_scintilla_encoding) + ) + + def SCIAddStyledText(self, text, style=None): + # If style is None, text is assumed to be a "native" Scintilla buffer. + # If style is specified, text is a normal string, and the style is + # assumed to apply to the entire string. + if style is not None: + text = list(map(lambda char, style=style: char + chr(style), text)) + text = "".join(text) + self.SendMessage( + scintillacon.SCI_ADDSTYLEDTEXT, text.encode(default_scintilla_encoding) + ) + + def SCIInsertText(self, text, pos=-1): + # SCIInsertText allows unicode or bytes - but if they are bytes, + # the caller must ensure it is encoded correctly. + if isinstance(text, str): + text = text.encode(default_scintilla_encoding) + self.SendScintilla(scintillacon.SCI_INSERTTEXT, pos, text + null_byte) + + def SCISetSavePoint(self): + self.SendScintilla(scintillacon.SCI_SETSAVEPOINT) + + def SCISetUndoCollection(self, collectFlag): + self.SendScintilla(scintillacon.SCI_SETUNDOCOLLECTION, collectFlag) + + def SCIBeginUndoAction(self): + self.SendScintilla(scintillacon.SCI_BEGINUNDOACTION) + + def SCIEndUndoAction(self): + self.SendScintilla(scintillacon.SCI_ENDUNDOACTION) + + def SCIGetCurrentPos(self): + return self.SendScintilla(scintillacon.SCI_GETCURRENTPOS) + + def SCIGetCharAt(self, pos): + # Must ensure char is unsigned! + return chr(self.SendScintilla(scintillacon.SCI_GETCHARAT, pos) & 0xFF) + + def SCIGotoLine(self, line): + self.SendScintilla(scintillacon.SCI_GOTOLINE, line) + + def SCIBraceMatch(self, pos, maxReStyle): + return self.SendScintilla(scintillacon.SCI_BRACEMATCH, pos, maxReStyle) + + def SCIBraceHighlight(self, pos, posOpposite): + return self.SendScintilla(scintillacon.SCI_BRACEHIGHLIGHT, pos, posOpposite) + + def SCIBraceBadHighlight(self, pos): + return self.SendScintilla(scintillacon.SCI_BRACEBADLIGHT, pos) + + #################################### + # Styling + # def SCIColourise(self, start=0, end=-1): + # NOTE - dependent on of we use builtin lexer, so handled below. + def SCIGetEndStyled(self): + return self.SendScintilla(scintillacon.SCI_GETENDSTYLED) + + def SCIStyleSetFore(self, num, v): + return self.SendScintilla(scintillacon.SCI_STYLESETFORE, num, v) + + def SCIStyleSetBack(self, num, v): + return self.SendScintilla(scintillacon.SCI_STYLESETBACK, num, v) + + def SCIStyleSetEOLFilled(self, num, v): + return self.SendScintilla(scintillacon.SCI_STYLESETEOLFILLED, num, v) + + def SCIStyleSetFont(self, num, name, characterset=0): + buff = (name + "\0").encode(default_scintilla_encoding) + self.SendScintilla(scintillacon.SCI_STYLESETFONT, num, buff) + self.SendScintilla(scintillacon.SCI_STYLESETCHARACTERSET, num, characterset) + + def SCIStyleSetBold(self, num, bBold): + self.SendScintilla(scintillacon.SCI_STYLESETBOLD, num, bBold) + + def SCIStyleSetItalic(self, num, bItalic): + self.SendScintilla(scintillacon.SCI_STYLESETITALIC, num, bItalic) + + def SCIStyleSetSize(self, num, size): + self.SendScintilla(scintillacon.SCI_STYLESETSIZE, num, size) + + def SCIGetViewWS(self): + return self.SendScintilla(scintillacon.SCI_GETVIEWWS) + + def SCISetViewWS(self, val): + self.SendScintilla(scintillacon.SCI_SETVIEWWS, not (val == 0)) + self.InvalidateRect() + + def SCISetIndentationGuides(self, val): + self.SendScintilla(scintillacon.SCI_SETINDENTATIONGUIDES, val) + + def SCIGetIndentationGuides(self): + return self.SendScintilla(scintillacon.SCI_GETINDENTATIONGUIDES) + + def SCISetIndent(self, val): + self.SendScintilla(scintillacon.SCI_SETINDENT, val) + + def SCIGetIndent(self, val): + return self.SendScintilla(scintillacon.SCI_GETINDENT) + + def SCIGetViewEOL(self): + return self.SendScintilla(scintillacon.SCI_GETVIEWEOL) + + def SCISetViewEOL(self, val): + self.SendScintilla(scintillacon.SCI_SETVIEWEOL, not (val == 0)) + self.InvalidateRect() + + def SCISetTabWidth(self, width): + self.SendScintilla(scintillacon.SCI_SETTABWIDTH, width, 0) + + def SCIStartStyling(self, pos, mask): + self.SendScintilla(scintillacon.SCI_STARTSTYLING, pos, mask) + + def SCISetStyling(self, pos, attr): + self.SendScintilla(scintillacon.SCI_SETSTYLING, pos, attr) + + def SCISetStylingEx(self, ray): # ray is an array. + address, length = ray.buffer_info() + self.SendScintilla(scintillacon.SCI_SETSTYLINGEX, length, address) + + def SCIGetStyleAt(self, pos): + return self.SendScintilla(scintillacon.SCI_GETSTYLEAT, pos) + + def SCISetMarginWidth(self, width): + self.SendScintilla(scintillacon.SCI_SETMARGINWIDTHN, 1, width) + + def SCISetMarginWidthN(self, n, width): + self.SendScintilla(scintillacon.SCI_SETMARGINWIDTHN, n, width) + + def SCISetFoldFlags(self, flags): + self.SendScintilla(scintillacon.SCI_SETFOLDFLAGS, flags) + + # Markers + def SCIMarkerDefineAll(self, markerNum, markerType, fore, back): + self.SCIMarkerDefine(markerNum, markerType) + self.SCIMarkerSetFore(markerNum, fore) + self.SCIMarkerSetBack(markerNum, back) + + def SCIMarkerDefine(self, markerNum, markerType): + self.SendScintilla(scintillacon.SCI_MARKERDEFINE, markerNum, markerType) + + def SCIMarkerSetFore(self, markerNum, fore): + self.SendScintilla(scintillacon.SCI_MARKERSETFORE, markerNum, fore) + + def SCIMarkerSetBack(self, markerNum, back): + self.SendScintilla(scintillacon.SCI_MARKERSETBACK, markerNum, back) + + def SCIMarkerAdd(self, lineNo, markerNum): + self.SendScintilla(scintillacon.SCI_MARKERADD, lineNo, markerNum) + + def SCIMarkerDelete(self, lineNo, markerNum): + self.SendScintilla(scintillacon.SCI_MARKERDELETE, lineNo, markerNum) + + def SCIMarkerDeleteAll(self, markerNum=-1): + self.SendScintilla(scintillacon.SCI_MARKERDELETEALL, markerNum) + + def SCIMarkerGet(self, lineNo): + return self.SendScintilla(scintillacon.SCI_MARKERGET, lineNo) + + def SCIMarkerNext(self, lineNo, markerNum): + return self.SendScintilla(scintillacon.SCI_MARKERNEXT, lineNo, markerNum) + + def SCICancel(self): + self.SendScintilla(scintillacon.SCI_CANCEL) + + # AutoComplete + def SCIAutoCShow(self, text): + if type(text) in [type([]), type(())]: + text = " ".join(text) + buff = (text + "\0").encode(default_scintilla_encoding) + return self.SendScintilla(scintillacon.SCI_AUTOCSHOW, 0, buff) + + def SCIAutoCCancel(self): + self.SendScintilla(scintillacon.SCI_AUTOCCANCEL) + + def SCIAutoCActive(self): + return self.SendScintilla(scintillacon.SCI_AUTOCACTIVE) + + def SCIAutoCComplete(self): + return self.SendScintilla(scintillacon.SCI_AUTOCCOMPLETE) + + def SCIAutoCStops(self, stops): + buff = (stops + "\0").encode(default_scintilla_encoding) + self.SendScintilla(scintillacon.SCI_AUTOCSTOPS, 0, buff) + + def SCIAutoCSetAutoHide(self, hide): + self.SendScintilla(scintillacon.SCI_AUTOCSETAUTOHIDE, hide) + + def SCIAutoCSetFillups(self, fillups): + self.SendScintilla(scintillacon.SCI_AUTOCSETFILLUPS, fillups) + + # Call tips + def SCICallTipShow(self, text, pos=-1): + if pos == -1: + pos = self.GetSel()[0] + buff = (text + "\0").encode(default_scintilla_encoding) + self.SendScintilla(scintillacon.SCI_CALLTIPSHOW, pos, buff) + + def SCICallTipCancel(self): + self.SendScintilla(scintillacon.SCI_CALLTIPCANCEL) + + def SCICallTipActive(self): + return self.SendScintilla(scintillacon.SCI_CALLTIPACTIVE) + + def SCICallTipPosStart(self): + return self.SendScintilla(scintillacon.SCI_CALLTIPPOSSTART) + + def SCINewline(self): + self.SendScintilla(scintillacon.SCI_NEWLINE) + + # Lexer etc + def SCISetKeywords(self, keywords, kw_list_no=0): + buff = (keywords + "\0").encode(default_scintilla_encoding) + self.SendScintilla(scintillacon.SCI_SETKEYWORDS, kw_list_no, buff) + + def SCISetProperty(self, name, value): + name_buff = array.array("b", (name + "\0").encode(default_scintilla_encoding)) + val_buff = array.array( + "b", (str(value) + "\0").encode(default_scintilla_encoding) + ) + address_name_buffer = name_buff.buffer_info()[0] + address_val_buffer = val_buff.buffer_info()[0] + self.SendScintilla( + scintillacon.SCI_SETPROPERTY, address_name_buffer, address_val_buffer + ) + + def SCISetStyleBits(self, nbits): + self.SendScintilla(scintillacon.SCI_SETSTYLEBITS, nbits) + + # Folding + def SCIGetFoldLevel(self, lineno): + return self.SendScintilla(scintillacon.SCI_GETFOLDLEVEL, lineno) + + def SCIToggleFold(self, lineno): + return self.SendScintilla(scintillacon.SCI_TOGGLEFOLD, lineno) + + def SCIEnsureVisible(self, lineno): + self.SendScintilla(scintillacon.SCI_ENSUREVISIBLE, lineno) + + def SCIGetFoldExpanded(self, lineno): + return self.SendScintilla(scintillacon.SCI_GETFOLDEXPANDED, lineno) + + # right edge + def SCISetEdgeColumn(self, edge): + self.SendScintilla(scintillacon.SCI_SETEDGECOLUMN, edge) + + def SCIGetEdgeColumn(self): + return self.SendScintilla(scintillacon.SCI_GETEDGECOLUMN) + + def SCISetEdgeMode(self, mode): + self.SendScintilla(scintillacon.SCI_SETEDGEMODE, mode) + + def SCIGetEdgeMode(self): + return self.SendScintilla(scintillacon.SCI_GETEDGEMODE) + + def SCISetEdgeColor(self, color): + self.SendScintilla(scintillacon.SCI_SETEDGECOLOUR, color) + + def SCIGetEdgeColor(self): + return self.SendScintilla(scintillacon.SCI_GETEDGECOLOR) + + # Multi-doc + def SCIGetDocPointer(self): + return self.SendScintilla(scintillacon.SCI_GETDOCPOINTER) + + def SCISetDocPointer(self, p): + return self.SendScintilla(scintillacon.SCI_SETDOCPOINTER, 0, p) + + def SCISetWrapMode(self, mode): + return self.SendScintilla(scintillacon.SCI_SETWRAPMODE, mode) + + def SCIGetWrapMode(self): + return self.SendScintilla(scintillacon.SCI_GETWRAPMODE) + + +class CScintillaEditInterface(ScintillaControlInterface): + def close(self): + self.colorizer = None + + def Clear(self): + self.SendScintilla(win32con.WM_CLEAR) + + def FindText(self, flags, range, findText): + """LPARAM for EM_FINDTEXTEX: + typedef struct _findtextex { + CHARRANGE chrg; + LPCTSTR lpstrText; + CHARRANGE chrgText;} FINDTEXTEX; + typedef struct _charrange { + LONG cpMin; + LONG cpMax;} CHARRANGE; + """ + findtextex_fmt = "llPll" + ## Scintilla does not handle unicode in EM_FINDTEXT msg (FINDTEXTEX struct) + txt_buff = (findText + "\0").encode(default_scintilla_encoding) + txt_array = array.array("b", txt_buff) + ft_buff = struct.pack( + findtextex_fmt, range[0], range[1], txt_array.buffer_info()[0], 0, 0 + ) + ft_array = array.array("b", ft_buff) + rc = self.SendScintilla(EM_FINDTEXTEX, flags, ft_array.buffer_info()[0]) + ftUnpacked = struct.unpack(findtextex_fmt, ft_array) + return rc, (ftUnpacked[3], ftUnpacked[4]) + + def GetSel(self): + currentPos = self.SendScintilla(scintillacon.SCI_GETCURRENTPOS) + anchorPos = self.SendScintilla(scintillacon.SCI_GETANCHOR) + if currentPos < anchorPos: + return (currentPos, anchorPos) + else: + return (anchorPos, currentPos) + return currentPos + + def GetSelText(self): + start, end = self.GetSel() + txtBuf = array.array("b", null_byte * (end - start + 1)) + addressTxtBuf = txtBuf.buffer_info()[0] + # EM_GETSELTEXT is documented as returning the number of chars + # not including the NULL, but scintilla includes the NULL. A + # quick glance at the scintilla impl doesn't make this + # obvious - the NULL is included in the 'selection' object + # and reflected in the length of that 'selection' object. + # I expect that is a bug in scintilla and may be fixed by now, + # but we just blindly assume that the last char is \0 and + # strip it. + self.SendScintilla(EM_GETSELTEXT, 0, addressTxtBuf) + return txtBuf.tobytes()[:-1].decode(default_scintilla_encoding) + + def SetSel(self, start=0, end=None): + if type(start) == type(()): + assert ( + end is None + ), "If you pass a point in the first param, the second must be None" + start, end = start + elif end is None: + end = start + if start < 0: + start = self.GetTextLength() + if end < 0: + end = self.GetTextLength() + assert start <= self.GetTextLength(), "The start postion is invalid (%d/%d)" % ( + start, + self.GetTextLength(), + ) + assert end <= self.GetTextLength(), "The end postion is invalid (%d/%d)" % ( + end, + self.GetTextLength(), + ) + cr = struct.pack("ll", start, end) + crBuff = array.array("b", cr) + addressCrBuff = crBuff.buffer_info()[0] + rc = self.SendScintilla(EM_EXSETSEL, 0, addressCrBuff) + + def GetLineCount(self): + return self.SendScintilla(win32con.EM_GETLINECOUNT) + + def LineFromChar(self, charPos=-1): + if charPos == -1: + charPos = self.GetSel()[0] + assert ( + charPos >= 0 and charPos <= self.GetTextLength() + ), "The charPos postion (%s) is invalid (max=%s)" % ( + charPos, + self.GetTextLength(), + ) + # return self.SendScintilla(EM_EXLINEFROMCHAR, charPos) + # EM_EXLINEFROMCHAR puts charPos in lParam, not wParam + return self.SendScintilla(EM_EXLINEFROMCHAR, 0, charPos) + + def LineIndex(self, line): + return self.SendScintilla(win32con.EM_LINEINDEX, line) + + def ScrollCaret(self): + return self.SendScintilla(win32con.EM_SCROLLCARET) + + def GetCurLineNumber(self): + return self.LineFromChar(self.SCIGetCurrentPos()) + + def GetTextLength(self): + return self.SendScintilla(scintillacon.SCI_GETTEXTLENGTH) + + def GetTextRange(self, start=0, end=-1, decode=True): + if end == -1: + end = self.SendScintilla(scintillacon.SCI_GETTEXTLENGTH) + assert end >= start, "Negative index requested (%d/%d)" % (start, end) + assert ( + start >= 0 and start <= self.GetTextLength() + ), "The start postion is invalid" + assert end >= 0 and end <= self.GetTextLength(), "The end postion is invalid" + initer = null_byte * (end - start + 1) + buff = array.array("b", initer) + addressBuffer = buff.buffer_info()[0] + tr = struct.pack("llP", start, end, addressBuffer) + trBuff = array.array("b", tr) + addressTrBuff = trBuff.buffer_info()[0] + num_bytes = self.SendScintilla(EM_GETTEXTRANGE, 0, addressTrBuff) + ret = buff.tobytes()[:num_bytes] + if decode: + ret = ret.decode(default_scintilla_encoding) + return ret + + def ReplaceSel(self, str): + buff = (str + "\0").encode(default_scintilla_encoding) + self.SendScintilla(scintillacon.SCI_REPLACESEL, 0, buff) + + def GetLine(self, line=-1): + if line == -1: + line = self.GetCurLineNumber() + start = self.LineIndex(line) + end = self.LineIndex(line + 1) + return self.GetTextRange(start, end) + + def SetReadOnly(self, flag=1): + return self.SendScintilla(win32con.EM_SETREADONLY, flag) + + def LineScroll(self, lines, cols=0): + return self.SendScintilla(win32con.EM_LINESCROLL, cols, lines) + + def GetFirstVisibleLine(self): + return self.SendScintilla(win32con.EM_GETFIRSTVISIBLELINE) + + def SetWordWrap(self, mode): + if mode != win32ui.CRichEditView_WrapNone: + raise ValueError("We dont support word-wrap (I dont think :-)") + + +class CScintillaColorEditInterface(CScintillaEditInterface): + ################################ + # Plug-in colorizer support + def _GetColorizer(self): + if not hasattr(self, "colorizer"): + self.colorizer = self._MakeColorizer() + return self.colorizer + + def _MakeColorizer(self): + # Give parent a chance to hook. + parent_func = getattr(self.GetParentFrame(), "_MakeColorizer", None) + if parent_func is not None: + return parent_func() + from . import formatter + + ## return formatter.PythonSourceFormatter(self) + return formatter.BuiltinPythonSourceFormatter(self) + + def Colorize(self, start=0, end=-1): + c = self._GetColorizer() + if c is not None: + c.Colorize(start, end) + + def ApplyFormattingStyles(self, bReload=1): + c = self._GetColorizer() + if c is not None: + c.ApplyFormattingStyles(bReload) + + # The Parent window will normally hook + def HookFormatter(self, parent=None): + c = self._GetColorizer() + if c is not None: # No need if we have no color! + c.HookFormatter(parent) + + +class CScintillaEdit(window.Wnd, CScintillaColorEditInterface): + def __init__(self, wnd=None): + if wnd is None: + wnd = win32ui.CreateWnd() + window.Wnd.__init__(self, wnd) + + def SendScintilla(self, msg, w=0, l=0): + return self.SendMessage(msg, w, l) + + def CreateWindow(self, style, rect, parent, id): + self._obj_.CreateWindow("Scintilla", "Scintilla", style, rect, parent, id, None) diff --git a/lib/pythonwin/pywin/scintilla/document.py b/lib/pythonwin/pywin/scintilla/document.py new file mode 100644 index 00000000..cddb442c --- /dev/null +++ b/lib/pythonwin/pywin/scintilla/document.py @@ -0,0 +1,312 @@ +import codecs +import re +import string + +import win32con +import win32ui +from pywin import default_scintilla_encoding +from pywin.mfc import docview + +from . import scintillacon + +crlf_bytes = "\r\n".encode("ascii") +lf_bytes = "\n".encode("ascii") + +# re from pep263 - but we use it both on bytes and strings. +re_encoding_bytes = re.compile("coding[:=]\s*([-\w.]+)".encode("ascii")) +re_encoding_text = re.compile("coding[:=]\s*([-\w.]+)") + +ParentScintillaDocument = docview.Document + + +class CScintillaDocument(ParentScintillaDocument): + "A SyntEdit document." + + def __init__(self, *args): + self.bom = None # the BOM, if any, read from the file. + # the encoding we detected from the source. Might have + # detected via the BOM or an encoding decl. Note that in + # the latter case (ie, while self.bom is None), it can't be + # trusted - the user may have edited the encoding decl between + # open and save. + self.source_encoding = None + ParentScintillaDocument.__init__(self, *args) + + def DeleteContents(self): + pass + + def OnOpenDocument(self, filename): + # init data members + # print "Opening", filename + self.SetPathName(filename) # Must set this early! + try: + # load the text as binary we can get smart + # about detecting any existing EOL conventions. + f = open(filename, "rb") + try: + self._LoadTextFromFile(f) + finally: + f.close() + except IOError: + rc = win32ui.MessageBox( + "Could not load the file from %s\n\nDo you want to create a new file?" + % filename, + "Pythonwin", + win32con.MB_YESNO | win32con.MB_ICONWARNING, + ) + if rc == win32con.IDNO: + return 0 + assert rc == win32con.IDYES, rc + try: + f = open(filename, "wb+") + try: + self._LoadTextFromFile(f) + finally: + f.close() + except IOError as e: + rc = win32ui.MessageBox("Cannot create the file %s" % filename) + return 1 + + def SaveFile(self, fileName, encoding=None): + view = self.GetFirstView() + ok = view.SaveTextFile(fileName, encoding=encoding) + if ok: + view.SCISetSavePoint() + return ok + + def ApplyFormattingStyles(self): + self._ApplyOptionalToViews("ApplyFormattingStyles") + + # ##################### + # File related functions + # Helper to transfer text from the MFC document to the control. + def _LoadTextFromFile(self, f): + # detect EOL mode - we don't support \r only - so find the + # first '\n' and guess based on the char before. + l = f.readline() + l2 = f.readline() + # If line ends with \r\n or has no line ending, use CRLF. + if l.endswith(crlf_bytes) or not l.endswith(lf_bytes): + eol_mode = scintillacon.SC_EOL_CRLF + else: + eol_mode = scintillacon.SC_EOL_LF + + # Detect the encoding - first look for a BOM, and if not found, + # look for a pep263 encoding declaration. + for bom, encoding in ( + (codecs.BOM_UTF8, "utf8"), + (codecs.BOM_UTF16_LE, "utf_16_le"), + (codecs.BOM_UTF16_BE, "utf_16_be"), + ): + if l.startswith(bom): + self.bom = bom + self.source_encoding = encoding + l = l[len(bom) :] # remove it. + break + else: + # no bom detected - look for pep263 encoding decl. + for look in (l, l2): + # Note we are looking at raw bytes here: so + # both the re itself uses bytes and the result + # is bytes - but we need the result as a string. + match = re_encoding_bytes.search(look) + if match is not None: + self.source_encoding = match.group(1).decode("ascii") + break + + # reading by lines would be too slow? Maybe we can use the + # incremental encoders? For now just stick with loading the + # entire file in memory. + text = l + l2 + f.read() + + # Translate from source encoding to UTF-8 bytes for Scintilla + source_encoding = self.source_encoding + # If we don't know an encoding, try utf-8 - if that fails we will + # fallback to latin-1 to treat it as bytes... + if source_encoding is None: + source_encoding = "utf-8" + # we could optimize this by avoiding utf8 to-ing and from-ing, + # but then we would lose the ability to handle invalid utf8 + # (and even then, the use of encoding aliases makes this tricky) + # To create an invalid utf8 file: + # >>> open(filename, "wb").write(codecs.BOM_UTF8+"bad \xa9har\r\n") + try: + dec = text.decode(source_encoding) + except UnicodeError: + print( + "WARNING: Failed to decode bytes from '%s' encoding - treating as latin1" + % source_encoding + ) + dec = text.decode("latin1") + except LookupError: + print( + "WARNING: Invalid encoding '%s' specified - treating as latin1" + % source_encoding + ) + dec = text.decode("latin1") + # and put it back as utf8 - this shouldn't fail. + text = dec.encode(default_scintilla_encoding) + + view = self.GetFirstView() + if view.IsWindow(): + # Turn off undo collection while loading + view.SendScintilla(scintillacon.SCI_SETUNDOCOLLECTION, 0, 0) + # Make sure the control isnt read-only + view.SetReadOnly(0) + view.SendScintilla(scintillacon.SCI_CLEARALL) + view.SendMessage(scintillacon.SCI_ADDTEXT, text) + view.SendScintilla(scintillacon.SCI_SETUNDOCOLLECTION, 1, 0) + view.SendScintilla(win32con.EM_EMPTYUNDOBUFFER, 0, 0) + # set EOL mode + view.SendScintilla(scintillacon.SCI_SETEOLMODE, eol_mode) + + def _SaveTextToFile(self, view, filename, encoding=None): + s = view.GetTextRange() # already decoded from scintilla's encoding + source_encoding = encoding + if source_encoding is None: + if self.bom: + source_encoding = self.source_encoding + else: + # no BOM - look for an encoding. + bits = re.split("[\r\n]+", s, 3) + for look in bits[:-1]: + match = re_encoding_text.search(look) + if match is not None: + source_encoding = match.group(1) + self.source_encoding = source_encoding + break + + if source_encoding is None: + source_encoding = "utf-8" + + ## encode data before opening file so script is not lost if encoding fails + file_contents = s.encode(source_encoding) + # Open in binary mode as scintilla itself ensures the + # line endings are already appropriate + f = open(filename, "wb") + try: + if self.bom: + f.write(self.bom) + f.write(file_contents) + finally: + f.close() + self.SetModifiedFlag(0) + + def FinalizeViewCreation(self, view): + pass + + def HookViewNotifications(self, view): + parent = view.GetParentFrame() + parent.HookNotify( + ViewNotifyDelegate(self, "OnBraceMatch"), scintillacon.SCN_CHECKBRACE + ) + parent.HookNotify( + ViewNotifyDelegate(self, "OnMarginClick"), scintillacon.SCN_MARGINCLICK + ) + parent.HookNotify( + ViewNotifyDelegate(self, "OnNeedShown"), scintillacon.SCN_NEEDSHOWN + ) + + parent.HookNotify( + DocumentNotifyDelegate(self, "OnSavePointReached"), + scintillacon.SCN_SAVEPOINTREACHED, + ) + parent.HookNotify( + DocumentNotifyDelegate(self, "OnSavePointLeft"), + scintillacon.SCN_SAVEPOINTLEFT, + ) + parent.HookNotify( + DocumentNotifyDelegate(self, "OnModifyAttemptRO"), + scintillacon.SCN_MODIFYATTEMPTRO, + ) + # Tell scintilla what characters should abort auto-complete. + view.SCIAutoCStops(string.whitespace + "()[]:;+-/*=\\?'!#@$%^&,<>\"'|") + + if view != self.GetFirstView(): + view.SCISetDocPointer(self.GetFirstView().SCIGetDocPointer()) + + def OnSavePointReached(self, std, extra): + self.SetModifiedFlag(0) + + def OnSavePointLeft(self, std, extra): + self.SetModifiedFlag(1) + + def OnModifyAttemptRO(self, std, extra): + self.MakeDocumentWritable() + + # All Marker functions are 1 based. + def MarkerAdd(self, lineNo, marker): + self.GetEditorView().SCIMarkerAdd(lineNo - 1, marker) + + def MarkerCheck(self, lineNo, marker): + v = self.GetEditorView() + lineNo = lineNo - 1 # Make 0 based + markerState = v.SCIMarkerGet(lineNo) + return markerState & (1 << marker) != 0 + + def MarkerToggle(self, lineNo, marker): + v = self.GetEditorView() + if self.MarkerCheck(lineNo, marker): + v.SCIMarkerDelete(lineNo - 1, marker) + else: + v.SCIMarkerAdd(lineNo - 1, marker) + + def MarkerDelete(self, lineNo, marker): + self.GetEditorView().SCIMarkerDelete(lineNo - 1, marker) + + def MarkerDeleteAll(self, marker): + self.GetEditorView().SCIMarkerDeleteAll(marker) + + def MarkerGetNext(self, lineNo, marker): + return self.GetEditorView().SCIMarkerNext(lineNo - 1, 1 << marker) + 1 + + def MarkerAtLine(self, lineNo, marker): + markerState = self.GetEditorView().SCIMarkerGet(lineNo - 1) + return markerState & (1 << marker) + + # Helper for reflecting functions to views. + def _ApplyToViews(self, funcName, *args): + for view in self.GetAllViews(): + func = getattr(view, funcName) + func(*args) + + def _ApplyOptionalToViews(self, funcName, *args): + for view in self.GetAllViews(): + func = getattr(view, funcName, None) + if func is not None: + func(*args) + + def GetEditorView(self): + # Find the first frame with a view, + # then ask it to give the editor view + # as it knows which one is "active" + try: + frame_gev = self.GetFirstView().GetParentFrame().GetEditorView + except AttributeError: + return self.GetFirstView() + return frame_gev() + + +# Delegate to the correct view, based on the control that sent it. +class ViewNotifyDelegate: + def __init__(self, doc, name): + self.doc = doc + self.name = name + + def __call__(self, std, extra): + (hwndFrom, idFrom, code) = std + for v in self.doc.GetAllViews(): + if v.GetSafeHwnd() == hwndFrom: + return getattr(v, self.name)(*(std, extra)) + + +# Delegate to the document, but only from a single view (as each view sends it seperately) +class DocumentNotifyDelegate: + def __init__(self, doc, name): + self.doc = doc + self.delegate = getattr(doc, name) + + def __call__(self, std, extra): + (hwndFrom, idFrom, code) = std + if hwndFrom == self.doc.GetEditorView().GetSafeHwnd(): + self.delegate(*(std, extra)) diff --git a/lib/pythonwin/pywin/scintilla/find.py b/lib/pythonwin/pywin/scintilla/find.py new file mode 100644 index 00000000..e1d21a5b --- /dev/null +++ b/lib/pythonwin/pywin/scintilla/find.py @@ -0,0 +1,510 @@ +# find.py - Find and Replace +import afxres +import win32api +import win32con +import win32ui +from pywin.framework import scriptutils +from pywin.mfc import dialog + +FOUND_NOTHING = 0 +FOUND_NORMAL = 1 +FOUND_LOOPED_BACK = 2 +FOUND_NEXT_FILE = 3 + + +class SearchParams: + def __init__(self, other=None): + if other is None: + self.__dict__["findText"] = "" + self.__dict__["replaceText"] = "" + self.__dict__["matchCase"] = 0 + self.__dict__["matchWords"] = 0 + self.__dict__["acrossFiles"] = 0 + self.__dict__["remember"] = 1 + self.__dict__["sel"] = (-1, -1) + self.__dict__["keepDialogOpen"] = 0 + else: + self.__dict__.update(other.__dict__) + + # Helper so we cant misspell attributes :-) + def __setattr__(self, attr, val): + if not hasattr(self, attr): + raise AttributeError(attr) + self.__dict__[attr] = val + + +curDialog = None +lastSearch = defaultSearch = SearchParams() +searchHistory = [] + + +def ShowFindDialog(): + _ShowDialog(FindDialog) + + +def ShowReplaceDialog(): + _ShowDialog(ReplaceDialog) + + +def _ShowDialog(dlgClass): + global curDialog + if curDialog is not None: + if curDialog.__class__ != dlgClass: + curDialog.DestroyWindow() + curDialog = None + else: + curDialog.SetFocus() + if curDialog is None: + curDialog = dlgClass() + curDialog.CreateWindow() + + +def FindNext(): + params = SearchParams(lastSearch) + params.sel = (-1, -1) + if not params.findText: + ShowFindDialog() + else: + return _FindIt(None, params) + + +def _GetControl(control=None): + if control is None: + control = scriptutils.GetActiveEditControl() + return control + + +def _FindIt(control, searchParams): + global lastSearch, defaultSearch + control = _GetControl(control) + if control is None: + return FOUND_NOTHING + + # Move to the next char, so we find the next one. + flags = 0 + if searchParams.matchWords: + flags = flags | win32con.FR_WHOLEWORD + if searchParams.matchCase: + flags = flags | win32con.FR_MATCHCASE + if searchParams.sel == (-1, -1): + sel = control.GetSel() + # If the position is the same as we found last time, + # then we assume it is a "FindNext" + if sel == lastSearch.sel: + sel = sel[0] + 1, sel[0] + 1 + else: + sel = searchParams.sel + + if sel[0] == sel[1]: + sel = sel[0], control.GetTextLength() + + rc = FOUND_NOTHING + # (Old edit control will fail here!) + posFind, foundSel = control.FindText(flags, sel, searchParams.findText) + lastSearch = SearchParams(searchParams) + if posFind >= 0: + rc = FOUND_NORMAL + lineno = control.LineFromChar(posFind) + control.SCIEnsureVisible(lineno) + control.SetSel(foundSel) + control.SetFocus() + win32ui.SetStatusText(win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE)) + if rc == FOUND_NOTHING and lastSearch.acrossFiles: + # Loop around all documents. First find this document. + try: + try: + doc = control.GetDocument() + except AttributeError: + try: + doc = control.GetParent().GetDocument() + except AttributeError: + print("Cant find a document for the control!") + doc = None + if doc is not None: + template = doc.GetDocTemplate() + alldocs = template.GetDocumentList() + mypos = lookpos = alldocs.index(doc) + while 1: + lookpos = (lookpos + 1) % len(alldocs) + if lookpos == mypos: + break + view = alldocs[lookpos].GetFirstView() + posFind, foundSel = view.FindText( + flags, (0, view.GetTextLength()), searchParams.findText + ) + if posFind >= 0: + nChars = foundSel[1] - foundSel[0] + lineNo = view.LineFromChar(posFind) # zero based. + lineStart = view.LineIndex(lineNo) + colNo = posFind - lineStart # zero based. + scriptutils.JumpToDocument( + alldocs[lookpos].GetPathName(), + lineNo + 1, + colNo + 1, + nChars, + ) + rc = FOUND_NEXT_FILE + break + except win32ui.error: + pass + if rc == FOUND_NOTHING: + # Loop around this control - attempt to find from the start of the control. + posFind, foundSel = control.FindText( + flags, (0, sel[0] - 1), searchParams.findText + ) + if posFind >= 0: + control.SCIEnsureVisible(control.LineFromChar(foundSel[0])) + control.SetSel(foundSel) + control.SetFocus() + win32ui.SetStatusText("Not found! Searching from the top of the file.") + rc = FOUND_LOOPED_BACK + else: + lastSearch.sel = -1, -1 + win32ui.SetStatusText("Can not find '%s'" % searchParams.findText) + + if rc != FOUND_NOTHING: + lastSearch.sel = foundSel + + if lastSearch.remember: + defaultSearch = lastSearch + + # track search history + try: + ix = searchHistory.index(searchParams.findText) + except ValueError: + if len(searchHistory) > 50: + searchHistory[50:] = [] + else: + del searchHistory[ix] + searchHistory.insert(0, searchParams.findText) + + return rc + + +def _ReplaceIt(control): + control = _GetControl(control) + statusText = "Can not find '%s'." % lastSearch.findText + rc = FOUND_NOTHING + if control is not None and lastSearch.sel != (-1, -1): + control.ReplaceSel(lastSearch.replaceText) + rc = FindNext() + if rc != FOUND_NOTHING: + statusText = win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE) + win32ui.SetStatusText(statusText) + return rc + + +class FindReplaceDialog(dialog.Dialog): + def __init__(self): + dialog.Dialog.__init__(self, self._GetDialogTemplate()) + self.HookCommand(self.OnFindNext, 109) + + def OnInitDialog(self): + self.editFindText = self.GetDlgItem(102) + self.butMatchWords = self.GetDlgItem(105) + self.butMatchCase = self.GetDlgItem(107) + self.butKeepDialogOpen = self.GetDlgItem(115) + self.butAcrossFiles = self.GetDlgItem(116) + self.butRemember = self.GetDlgItem(117) + + self.editFindText.SetWindowText(defaultSearch.findText) + control = _GetControl() + # _GetControl only gets normal MDI windows; if the interactive + # window is docked and no document open, we get None. + if control: + # If we have a selection, default to that. + sel = control.GetSelText() + if len(sel) != 0: + self.editFindText.SetWindowText(sel) + if defaultSearch.remember: + defaultSearch.findText = sel + for hist in searchHistory: + self.editFindText.AddString(hist) + + if hasattr(self.editFindText, "SetEditSel"): + self.editFindText.SetEditSel(0, -1) + else: + self.editFindText.SetSel(0, -1) + self.butMatchWords.SetCheck(defaultSearch.matchWords) + self.butMatchCase.SetCheck(defaultSearch.matchCase) + self.butKeepDialogOpen.SetCheck(defaultSearch.keepDialogOpen) + self.butAcrossFiles.SetCheck(defaultSearch.acrossFiles) + self.butRemember.SetCheck(defaultSearch.remember) + return dialog.Dialog.OnInitDialog(self) + + def OnDestroy(self, msg): + global curDialog + curDialog = None + return dialog.Dialog.OnDestroy(self, msg) + + def DoFindNext(self): + params = SearchParams() + params.findText = self.editFindText.GetWindowText() + params.matchCase = self.butMatchCase.GetCheck() + params.matchWords = self.butMatchWords.GetCheck() + params.acrossFiles = self.butAcrossFiles.GetCheck() + params.remember = self.butRemember.GetCheck() + return _FindIt(None, params) + + def OnFindNext(self, id, code): + if code != 0: # BN_CLICKED + # 3d controls (python.exe + start_pythonwin.pyw) send + # other notification codes + return 1 # + if not self.editFindText.GetWindowText(): + win32api.MessageBeep() + return 1 + if self.DoFindNext() != FOUND_NOTHING: + if not self.butKeepDialogOpen.GetCheck(): + self.DestroyWindow() + + +class FindDialog(FindReplaceDialog): + def _GetDialogTemplate(self): + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + visible = win32con.WS_CHILD | win32con.WS_VISIBLE + dt = [ + ["Find", (0, 2, 240, 75), style, None, (8, "MS Sans Serif")], + ["Static", "Fi&nd What:", 101, (5, 8, 40, 10), visible], + [ + "ComboBox", + "", + 102, + (50, 7, 120, 120), + visible + | win32con.WS_BORDER + | win32con.WS_TABSTOP + | win32con.WS_VSCROLL + | win32con.CBS_DROPDOWN + | win32con.CBS_AUTOHSCROLL, + ], + [ + "Button", + "Match &whole word only", + 105, + (5, 23, 100, 10), + visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP, + ], + [ + "Button", + "Match &case", + 107, + (5, 33, 100, 10), + visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP, + ], + [ + "Button", + "Keep &dialog open", + 115, + (5, 43, 100, 10), + visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP, + ], + [ + "Button", + "Across &open files", + 116, + (5, 52, 100, 10), + visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP, + ], + [ + "Button", + "&Remember as default search", + 117, + (5, 61, 150, 10), + visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP, + ], + [ + "Button", + "&Find Next", + 109, + (185, 5, 50, 14), + visible | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP, + ], + [ + "Button", + "Cancel", + win32con.IDCANCEL, + (185, 23, 50, 14), + visible | win32con.WS_TABSTOP, + ], + ] + return dt + + +class ReplaceDialog(FindReplaceDialog): + def _GetDialogTemplate(self): + style = ( + win32con.DS_MODALFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + ) + visible = win32con.WS_CHILD | win32con.WS_VISIBLE + dt = [ + ["Replace", (0, 2, 240, 95), style, 0, (8, "MS Sans Serif")], + ["Static", "Fi&nd What:", 101, (5, 8, 40, 10), visible], + [ + "ComboBox", + "", + 102, + (60, 7, 110, 120), + visible + | win32con.WS_BORDER + | win32con.WS_TABSTOP + | win32con.WS_VSCROLL + | win32con.CBS_DROPDOWN + | win32con.CBS_AUTOHSCROLL, + ], + ["Static", "Re&place with:", 103, (5, 25, 50, 10), visible], + [ + "ComboBox", + "", + 104, + (60, 24, 110, 120), + visible + | win32con.WS_BORDER + | win32con.WS_TABSTOP + | win32con.WS_VSCROLL + | win32con.CBS_DROPDOWN + | win32con.CBS_AUTOHSCROLL, + ], + [ + "Button", + "Match &whole word only", + 105, + (5, 42, 100, 10), + visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP, + ], + [ + "Button", + "Match &case", + 107, + (5, 52, 100, 10), + visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP, + ], + [ + "Button", + "Keep &dialog open", + 115, + (5, 62, 100, 10), + visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP, + ], + [ + "Button", + "Across &open files", + 116, + (5, 72, 100, 10), + visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP, + ], + [ + "Button", + "&Remember as default search", + 117, + (5, 81, 150, 10), + visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP, + ], + [ + "Button", + "&Find Next", + 109, + (185, 5, 50, 14), + visible | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP, + ], + [ + "Button", + "&Replace", + 110, + (185, 23, 50, 14), + visible | win32con.WS_TABSTOP, + ], + [ + "Button", + "Replace &All", + 111, + (185, 41, 50, 14), + visible | win32con.WS_TABSTOP, + ], + [ + "Button", + "Cancel", + win32con.IDCANCEL, + (185, 59, 50, 14), + visible | win32con.WS_TABSTOP, + ], + ] + return dt + + def OnInitDialog(self): + rc = FindReplaceDialog.OnInitDialog(self) + self.HookCommand(self.OnReplace, 110) + self.HookCommand(self.OnReplaceAll, 111) + self.HookMessage(self.OnActivate, win32con.WM_ACTIVATE) + self.editReplaceText = self.GetDlgItem(104) + self.editReplaceText.SetWindowText(lastSearch.replaceText) + if hasattr(self.editReplaceText, "SetEditSel"): + self.editReplaceText.SetEditSel(0, -1) + else: + self.editReplaceText.SetSel(0, -1) + self.butReplace = self.GetDlgItem(110) + self.butReplaceAll = self.GetDlgItem(111) + self.CheckButtonStates() + return rc # 0 when focus set + + def CheckButtonStates(self): + # We can do a "Replace" or "Replace All" if the current selection + # is the same as the search text. + ft = self.editFindText.GetWindowText() + control = _GetControl() + # bCanReplace = len(ft)>0 and control.GetSelText() == ft + bCanReplace = control is not None and lastSearch.sel == control.GetSel() + self.butReplace.EnableWindow(bCanReplace) + + # self.butReplaceAll.EnableWindow(bCanReplace) + + def OnActivate(self, msg): + wparam = msg[2] + fActive = win32api.LOWORD(wparam) + if fActive != win32con.WA_INACTIVE: + self.CheckButtonStates() + + def OnFindNext(self, id, code): + if code != 0: + return 1 + self.DoFindNext() + self.CheckButtonStates() + + def OnReplace(self, id, code): + if code != 0: + return 1 + lastSearch.replaceText = self.editReplaceText.GetWindowText() + _ReplaceIt(None) + + def OnReplaceAll(self, id, code): + if code != 0: + return 1 + control = _GetControl(None) + if control is not None: + control.SetSel(0) + num = 0 + if self.DoFindNext() == FOUND_NORMAL: + num = 1 + lastSearch.replaceText = self.editReplaceText.GetWindowText() + while _ReplaceIt(control) == FOUND_NORMAL: + num = num + 1 + + win32ui.SetStatusText("Replaced %d occurrences" % num) + if num > 0 and not self.butKeepDialogOpen.GetCheck(): + self.DestroyWindow() + + +if __name__ == "__main__": + ShowFindDialog() diff --git a/lib/pythonwin/pywin/scintilla/formatter.py b/lib/pythonwin/pywin/scintilla/formatter.py new file mode 100644 index 00000000..56100ccf --- /dev/null +++ b/lib/pythonwin/pywin/scintilla/formatter.py @@ -0,0 +1,695 @@ +# Does Python source formatting for Scintilla controls. +import array +import string + +import win32api +import win32con +import win32ui + +from . import scintillacon + +WM_KICKIDLE = 0x036A + +# Used to indicate that style should use default color +from win32con import CLR_INVALID + +debugging = 0 +if debugging: + # Output must go to another process else the result of + # the printing itself will trigger again trigger a trace. + + import win32trace + import win32traceutil + + def trace(*args): + win32trace.write(" ".join(map(str, args)) + "\n") + +else: + trace = lambda *args: None + + +class Style: + """Represents a single format""" + + def __init__(self, name, format, background=CLR_INVALID): + self.name = name # Name the format representes eg, "String", "Class" + # Default background for each style is only used when there are no + # saved settings (generally on first startup) + self.background = self.default_background = background + if type(format) == type(""): + self.aliased = format + self.format = None + else: + self.format = format + self.aliased = None + self.stylenum = None # Not yet registered. + + def IsBasedOnDefault(self): + return len(self.format) == 5 + + # If the currently extended font defintion matches the + # default format, restore the format to the "simple" format. + def NormalizeAgainstDefault(self, defaultFormat): + if self.IsBasedOnDefault(): + return 0 # No more to do, and not changed. + bIsDefault = ( + self.format[7] == defaultFormat[7] and self.format[2] == defaultFormat[2] + ) + if bIsDefault: + self.ForceAgainstDefault() + return bIsDefault + + def ForceAgainstDefault(self): + self.format = self.format[:5] + + def GetCompleteFormat(self, defaultFormat): + # Get the complete style after applying any relevant defaults. + if len(self.format) == 5: # It is a default one + fmt = self.format + defaultFormat[5:] + else: + fmt = self.format + flags = ( + win32con.CFM_BOLD + | win32con.CFM_CHARSET + | win32con.CFM_COLOR + | win32con.CFM_FACE + | win32con.CFM_ITALIC + | win32con.CFM_SIZE + ) + return (flags,) + fmt[1:] + + +# The Formatter interface +# used primarily when the actual formatting is done by Scintilla! +class FormatterBase: + def __init__(self, scintilla): + self.scintilla = scintilla + self.baseFormatFixed = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New") + self.baseFormatProp = (-402653169, 0, 200, 0, 0, 0, 49, "Arial") + self.bUseFixed = 1 + self.styles = {} # Indexed by name + self.styles_by_id = {} # Indexed by allocated ID. + self.SetStyles() + + def HookFormatter(self, parent=None): + raise NotImplementedError() + + # Used by the IDLE extensions to quickly determine if a character is a string. + def GetStringStyle(self, pos): + try: + style = self.styles_by_id[self.scintilla.SCIGetStyleAt(pos)] + except KeyError: + # A style we dont know about - probably not even a .py file - can't be a string + return None + if style.name in self.string_style_names: + return style + return None + + def RegisterStyle(self, style, stylenum): + assert stylenum is not None, "We must have a style number" + assert style.stylenum is None, "Style has already been registered" + assert stylenum not in self.styles, "We are reusing a style number!" + style.stylenum = stylenum + self.styles[style.name] = style + self.styles_by_id[stylenum] = style + + def SetStyles(self): + raise NotImplementedError() + + def GetSampleText(self): + return "Sample Text for the Format Dialog" + + def GetDefaultFormat(self): + if self.bUseFixed: + return self.baseFormatFixed + return self.baseFormatProp + + # Update the control with the new style format. + def _ReformatStyle(self, style): + ## Selection (background only for now) + ## Passing False for WPARAM to SCI_SETSELBACK is documented as resetting to scintilla default, + ## but does not work - selection background is not visible at all. + ## Default value in SPECIAL_STYLES taken from scintilla source. + if style.name == STYLE_SELECTION: + clr = style.background + self.scintilla.SendScintilla(scintillacon.SCI_SETSELBACK, True, clr) + + ## Can't change font for selection, but could set color + ## However, the font color dropbox has no option for default, and thus would + ## always override syntax coloring + ## clr = style.format[4] + ## self.scintilla.SendScintilla(scintillacon.SCI_SETSELFORE, clr != CLR_INVALID, clr) + return + + assert style.stylenum is not None, "Unregistered style." + # print "Reformat style", style.name, style.stylenum + scintilla = self.scintilla + stylenum = style.stylenum + # Now we have the style number, indirect for the actual style. + if style.aliased is not None: + style = self.styles[style.aliased] + f = style.format + if style.IsBasedOnDefault(): + baseFormat = self.GetDefaultFormat() + else: + baseFormat = f + scintilla.SCIStyleSetFore(stylenum, f[4]) + scintilla.SCIStyleSetFont(stylenum, baseFormat[7], baseFormat[5]) + if f[1] & 1: + scintilla.SCIStyleSetBold(stylenum, 1) + else: + scintilla.SCIStyleSetBold(stylenum, 0) + if f[1] & 2: + scintilla.SCIStyleSetItalic(stylenum, 1) + else: + scintilla.SCIStyleSetItalic(stylenum, 0) + scintilla.SCIStyleSetSize(stylenum, int(baseFormat[2] / 20)) + scintilla.SCIStyleSetEOLFilled(stylenum, 1) # Only needed for unclosed strings. + + ## Default style background to whitespace background if set, + ## otherwise use system window color + bg = style.background + if bg == CLR_INVALID: + bg = self.styles[STYLE_DEFAULT].background + if bg == CLR_INVALID: + bg = win32api.GetSysColor(win32con.COLOR_WINDOW) + scintilla.SCIStyleSetBack(stylenum, bg) + + def GetStyleByNum(self, stylenum): + return self.styles_by_id[stylenum] + + def ApplyFormattingStyles(self, bReload=1): + if bReload: + self.LoadPreferences() + baseFormat = self.GetDefaultFormat() + defaultStyle = Style("default", baseFormat) + defaultStyle.stylenum = scintillacon.STYLE_DEFAULT + self._ReformatStyle(defaultStyle) + for style in list(self.styles.values()): + if style.aliased is None: + style.NormalizeAgainstDefault(baseFormat) + self._ReformatStyle(style) + self.scintilla.InvalidateRect() + + # Some functions for loading and saving preferences. By default + # an INI file (well, MFC maps this to the registry) is used. + def LoadPreferences(self): + self.baseFormatFixed = eval( + self.LoadPreference("Base Format Fixed", str(self.baseFormatFixed)) + ) + self.baseFormatProp = eval( + self.LoadPreference("Base Format Proportional", str(self.baseFormatProp)) + ) + self.bUseFixed = int(self.LoadPreference("Use Fixed", 1)) + + for style in list(self.styles.values()): + new = self.LoadPreference(style.name, str(style.format)) + try: + style.format = eval(new) + except: + print("Error loading style data for", style.name) + # Use "vanilla" background hardcoded in PYTHON_STYLES if no settings in registry + style.background = int( + self.LoadPreference( + style.name + " background", style.default_background + ) + ) + + def LoadPreference(self, name, default): + return win32ui.GetProfileVal("Format", name, default) + + def SavePreferences(self): + self.SavePreference("Base Format Fixed", str(self.baseFormatFixed)) + self.SavePreference("Base Format Proportional", str(self.baseFormatProp)) + self.SavePreference("Use Fixed", self.bUseFixed) + for style in list(self.styles.values()): + if style.aliased is None: + self.SavePreference(style.name, str(style.format)) + bg_name = style.name + " background" + self.SavePreference(bg_name, style.background) + + def SavePreference(self, name, value): + win32ui.WriteProfileVal("Format", name, value) + + +# An abstract formatter +# For all formatters we actually implement here. +# (as opposed to those formatters built in to Scintilla) +class Formatter(FormatterBase): + def __init__(self, scintilla): + self.bCompleteWhileIdle = 0 + self.bHaveIdleHandler = 0 # Dont currently have an idle handle + self.nextstylenum = 0 + FormatterBase.__init__(self, scintilla) + + def HookFormatter(self, parent=None): + if parent is None: + parent = self.scintilla.GetParent() # was GetParentFrame()!? + parent.HookNotify(self.OnStyleNeeded, scintillacon.SCN_STYLENEEDED) + + def OnStyleNeeded(self, std, extra): + notify = self.scintilla.SCIUnpackNotifyMessage(extra) + endStyledChar = self.scintilla.SendScintilla(scintillacon.SCI_GETENDSTYLED) + lineEndStyled = self.scintilla.LineFromChar(endStyledChar) + endStyled = self.scintilla.LineIndex(lineEndStyled) + # print "enPosPaint %d endStyledChar %d lineEndStyled %d endStyled %d" % (endPosPaint, endStyledChar, lineEndStyled, endStyled) + self.Colorize(endStyled, notify.position) + + def ColorSeg(self, start, end, styleName): + end = end + 1 + # assert end-start>=0, "Can't have negative styling" + stylenum = self.styles[styleName].stylenum + while start < end: + self.style_buffer[start] = stylenum + start = start + 1 + # self.scintilla.SCISetStyling(end - start + 1, stylenum) + + def RegisterStyle(self, style, stylenum=None): + if stylenum is None: + stylenum = self.nextstylenum + self.nextstylenum = self.nextstylenum + 1 + FormatterBase.RegisterStyle(self, style, stylenum) + + def ColorizeString(self, str, charStart, styleStart): + raise RuntimeError("You must override this method") + + def Colorize(self, start=0, end=-1): + scintilla = self.scintilla + # scintilla's formatting is all done in terms of utf, so + # we work with utf8 bytes instead of unicode. This magically + # works as any extended chars found in the utf8 don't change + # the semantics. + stringVal = scintilla.GetTextRange(start, end, decode=False) + if start > 0: + stylenum = scintilla.SCIGetStyleAt(start - 1) + styleStart = self.GetStyleByNum(stylenum).name + else: + styleStart = None + # trace("Coloring", start, end, end-start, len(stringVal), styleStart, self.scintilla.SCIGetCharAt(start)) + scintilla.SCIStartStyling(start, 31) + self.style_buffer = array.array("b", (0,) * len(stringVal)) + self.ColorizeString(stringVal, styleStart) + scintilla.SCISetStylingEx(self.style_buffer) + self.style_buffer = None + # trace("After styling, end styled is", self.scintilla.SCIGetEndStyled()) + if ( + self.bCompleteWhileIdle + and not self.bHaveIdleHandler + and end != -1 + and end < scintilla.GetTextLength() + ): + self.bHaveIdleHandler = 1 + win32ui.GetApp().AddIdleHandler(self.DoMoreColoring) + # Kicking idle makes the app seem slower when initially repainting! + + # win32ui.GetMainFrame().PostMessage(WM_KICKIDLE, 0, 0) + + def DoMoreColoring(self, handler, count): + try: + scintilla = self.scintilla + endStyled = scintilla.SCIGetEndStyled() + lineStartStyled = scintilla.LineFromChar(endStyled) + start = scintilla.LineIndex(lineStartStyled) + end = scintilla.LineIndex(lineStartStyled + 1) + textlen = scintilla.GetTextLength() + if end < 0: + end = textlen + + finished = end >= textlen + self.Colorize(start, end) + except (win32ui.error, AttributeError): + # Window may have closed before we finished - no big deal! + finished = 1 + + if finished: + self.bHaveIdleHandler = 0 + win32ui.GetApp().DeleteIdleHandler(handler) + return not finished + + +# A Formatter that knows how to format Python source +from keyword import iskeyword, kwlist + +wordstarts = "_0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" +wordchars = "._0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" +operators = "%^&*()-+=|{}[]:;<>,/?!.~" + +STYLE_DEFAULT = "Whitespace" +STYLE_COMMENT = "Comment" +STYLE_COMMENT_BLOCK = "Comment Blocks" +STYLE_NUMBER = "Number" +STYLE_STRING = "String" +STYLE_SQSTRING = "SQ String" +STYLE_TQSSTRING = "TQS String" +STYLE_TQDSTRING = "TQD String" +STYLE_KEYWORD = "Keyword" +STYLE_CLASS = "Class" +STYLE_METHOD = "Method" +STYLE_OPERATOR = "Operator" +STYLE_IDENTIFIER = "Identifier" +STYLE_BRACE = "Brace/Paren - matching" +STYLE_BRACEBAD = "Brace/Paren - unmatched" +STYLE_STRINGEOL = "String with no terminator" +STYLE_LINENUMBER = "Line numbers" +STYLE_INDENTGUIDE = "Indent guide" +STYLE_SELECTION = "Selection" + +STRING_STYLES = [ + STYLE_STRING, + STYLE_SQSTRING, + STYLE_TQSSTRING, + STYLE_TQDSTRING, + STYLE_STRINGEOL, +] + +# These styles can have any ID - they are not special to scintilla itself. +# However, if we use the built-in lexer, then we must use its style numbers +# so in that case, they _are_ special. +# (name, format, background, scintilla id) +PYTHON_STYLES = [ + (STYLE_DEFAULT, (0, 0, 200, 0, 0x808080), CLR_INVALID, scintillacon.SCE_P_DEFAULT), + ( + STYLE_COMMENT, + (0, 2, 200, 0, 0x008000), + CLR_INVALID, + scintillacon.SCE_P_COMMENTLINE, + ), + ( + STYLE_COMMENT_BLOCK, + (0, 2, 200, 0, 0x808080), + CLR_INVALID, + scintillacon.SCE_P_COMMENTBLOCK, + ), + (STYLE_NUMBER, (0, 0, 200, 0, 0x808000), CLR_INVALID, scintillacon.SCE_P_NUMBER), + (STYLE_STRING, (0, 0, 200, 0, 0x008080), CLR_INVALID, scintillacon.SCE_P_STRING), + (STYLE_SQSTRING, STYLE_STRING, CLR_INVALID, scintillacon.SCE_P_CHARACTER), + (STYLE_TQSSTRING, STYLE_STRING, CLR_INVALID, scintillacon.SCE_P_TRIPLE), + (STYLE_TQDSTRING, STYLE_STRING, CLR_INVALID, scintillacon.SCE_P_TRIPLEDOUBLE), + (STYLE_STRINGEOL, (0, 0, 200, 0, 0x000000), 0x008080, scintillacon.SCE_P_STRINGEOL), + (STYLE_KEYWORD, (0, 1, 200, 0, 0x800000), CLR_INVALID, scintillacon.SCE_P_WORD), + (STYLE_CLASS, (0, 1, 200, 0, 0xFF0000), CLR_INVALID, scintillacon.SCE_P_CLASSNAME), + (STYLE_METHOD, (0, 1, 200, 0, 0x808000), CLR_INVALID, scintillacon.SCE_P_DEFNAME), + ( + STYLE_OPERATOR, + (0, 0, 200, 0, 0x000000), + CLR_INVALID, + scintillacon.SCE_P_OPERATOR, + ), + ( + STYLE_IDENTIFIER, + (0, 0, 200, 0, 0x000000), + CLR_INVALID, + scintillacon.SCE_P_IDENTIFIER, + ), +] + +# These styles _always_ have this specific style number, regardless of +# internal or external formatter. +SPECIAL_STYLES = [ + (STYLE_BRACE, (0, 0, 200, 0, 0x000000), 0xFFFF80, scintillacon.STYLE_BRACELIGHT), + (STYLE_BRACEBAD, (0, 0, 200, 0, 0x000000), 0x8EA5F2, scintillacon.STYLE_BRACEBAD), + ( + STYLE_LINENUMBER, + (0, 0, 200, 0, 0x000000), + win32api.GetSysColor(win32con.COLOR_3DFACE), + scintillacon.STYLE_LINENUMBER, + ), + ( + STYLE_INDENTGUIDE, + (0, 0, 200, 0, 0x000000), + CLR_INVALID, + scintillacon.STYLE_INDENTGUIDE, + ), + ## Not actually a style; requires special handling to send appropriate messages to scintilla + ( + STYLE_SELECTION, + (0, 0, 200, 0, CLR_INVALID), + win32api.RGB(0xC0, 0xC0, 0xC0), + 999999, + ), +] + +PythonSampleCode = """\ +# Some Python +class Sample(Super): + def Fn(self): +\tself.v = 1024 +dest = 'dest.html' +x = func(a + 1)|) +s = "I forget... +## A large +## comment block""" + + +class PythonSourceFormatter(Formatter): + string_style_names = STRING_STYLES + + def GetSampleText(self): + return PythonSampleCode + + def LoadStyles(self): + pass + + def SetStyles(self): + for name, format, bg, ignore in PYTHON_STYLES: + self.RegisterStyle(Style(name, format, bg)) + for name, format, bg, sc_id in SPECIAL_STYLES: + self.RegisterStyle(Style(name, format, bg), sc_id) + + def ClassifyWord(self, cdoc, start, end, prevWord): + word = cdoc[start : end + 1].decode("latin-1") + attr = STYLE_IDENTIFIER + if prevWord == "class": + attr = STYLE_CLASS + elif prevWord == "def": + attr = STYLE_METHOD + elif word[0] in string.digits: + attr = STYLE_NUMBER + elif iskeyword(word): + attr = STYLE_KEYWORD + self.ColorSeg(start, end, attr) + return word + + def ColorizeString(self, str, styleStart): + if styleStart is None: + styleStart = STYLE_DEFAULT + return self.ColorizePythonCode(str, 0, styleStart) + + def ColorizePythonCode(self, cdoc, charStart, styleStart): + # Straight translation of C++, should do better + lengthDoc = len(cdoc) + if lengthDoc <= charStart: + return + prevWord = "" + state = styleStart + chPrev = chPrev2 = chPrev3 = " " + chNext2 = chNext = cdoc[charStart : charStart + 1].decode("latin-1") + startSeg = i = charStart + while i < lengthDoc: + ch = chNext + chNext = " " + if i + 1 < lengthDoc: + chNext = cdoc[i + 1 : i + 2].decode("latin-1") + chNext2 = " " + if i + 2 < lengthDoc: + chNext2 = cdoc[i + 2 : i + 3].decode("latin-1") + if state == STYLE_DEFAULT: + if ch in wordstarts: + self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT) + state = STYLE_KEYWORD + startSeg = i + elif ch == "#": + self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT) + if chNext == "#": + state = STYLE_COMMENT_BLOCK + else: + state = STYLE_COMMENT + startSeg = i + elif ch == '"': + self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT) + startSeg = i + state = STYLE_COMMENT + if chNext == '"' and chNext2 == '"': + i = i + 2 + state = STYLE_TQDSTRING + ch = " " + chPrev = " " + chNext = " " + if i + 1 < lengthDoc: + chNext = cdoc[i + 1] + else: + state = STYLE_STRING + elif ch == "'": + self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT) + startSeg = i + state = STYLE_COMMENT + if chNext == "'" and chNext2 == "'": + i = i + 2 + state = STYLE_TQSSTRING + ch = " " + chPrev = " " + chNext = " " + if i + 1 < lengthDoc: + chNext = cdoc[i + 1] + else: + state = STYLE_SQSTRING + elif ch in operators: + self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT) + self.ColorSeg(i, i, STYLE_OPERATOR) + startSeg = i + 1 + elif state == STYLE_KEYWORD: + if ch not in wordchars: + prevWord = self.ClassifyWord(cdoc, startSeg, i - 1, prevWord) + state = STYLE_DEFAULT + startSeg = i + if ch == "#": + if chNext == "#": + state = STYLE_COMMENT_BLOCK + else: + state = STYLE_COMMENT + elif ch == '"': + if chNext == '"' and chNext2 == '"': + i = i + 2 + state = STYLE_TQDSTRING + ch = " " + chPrev = " " + chNext = " " + if i + 1 < lengthDoc: + chNext = cdoc[i + 1] + else: + state = STYLE_STRING + elif ch == "'": + if chNext == "'" and chNext2 == "'": + i = i + 2 + state = STYLE_TQSSTRING + ch = " " + chPrev = " " + chNext = " " + if i + 1 < lengthDoc: + chNext = cdoc[i + 1] + else: + state = STYLE_SQSTRING + elif ch in operators: + self.ColorSeg(startSeg, i, STYLE_OPERATOR) + startSeg = i + 1 + elif state == STYLE_COMMENT or state == STYLE_COMMENT_BLOCK: + if ch == "\r" or ch == "\n": + self.ColorSeg(startSeg, i - 1, state) + state = STYLE_DEFAULT + startSeg = i + elif state == STYLE_STRING: + if ch == "\\": + if chNext == '"' or chNext == "'" or chNext == "\\": + i = i + 1 + ch = chNext + chNext = " " + if i + 1 < lengthDoc: + chNext = cdoc[i + 1] + elif ch == '"': + self.ColorSeg(startSeg, i, STYLE_STRING) + state = STYLE_DEFAULT + startSeg = i + 1 + elif state == STYLE_SQSTRING: + if ch == "\\": + if chNext == '"' or chNext == "'" or chNext == "\\": + i = i + 1 + ch = chNext + chNext = " " + if i + 1 < lengthDoc: + chNext = cdoc[i + 1] + elif ch == "'": + self.ColorSeg(startSeg, i, STYLE_SQSTRING) + state = STYLE_DEFAULT + startSeg = i + 1 + elif state == STYLE_TQSSTRING: + if ch == "'" and chPrev == "'" and chPrev2 == "'" and chPrev3 != "\\": + self.ColorSeg(startSeg, i, STYLE_TQSSTRING) + state = STYLE_DEFAULT + startSeg = i + 1 + elif ( + state == STYLE_TQDSTRING + and ch == '"' + and chPrev == '"' + and chPrev2 == '"' + and chPrev3 != "\\" + ): + self.ColorSeg(startSeg, i, STYLE_TQDSTRING) + state = STYLE_DEFAULT + startSeg = i + 1 + chPrev3 = chPrev2 + chPrev2 = chPrev + chPrev = ch + i = i + 1 + if startSeg < lengthDoc: + if state == STYLE_KEYWORD: + self.ClassifyWord(cdoc, startSeg, lengthDoc - 1, prevWord) + else: + self.ColorSeg(startSeg, lengthDoc - 1, state) + + +# These taken from the SciTE properties file. +source_formatter_extensions = [ + (".py .pys .pyw".split(), scintillacon.SCLEX_PYTHON), + (".html .htm .asp .shtml".split(), scintillacon.SCLEX_HTML), + ( + "c .cc .cpp .cxx .h .hh .hpp .hxx .idl .odl .php3 .phtml .inc .js".split(), + scintillacon.SCLEX_CPP, + ), + (".vbs .frm .ctl .cls".split(), scintillacon.SCLEX_VB), + (".pl .pm .cgi .pod".split(), scintillacon.SCLEX_PERL), + (".sql .spec .body .sps .spb .sf .sp".split(), scintillacon.SCLEX_SQL), + (".tex .sty".split(), scintillacon.SCLEX_LATEX), + (".xml .xul".split(), scintillacon.SCLEX_XML), + (".err".split(), scintillacon.SCLEX_ERRORLIST), + (".mak".split(), scintillacon.SCLEX_MAKEFILE), + (".bat .cmd".split(), scintillacon.SCLEX_BATCH), +] + + +class BuiltinSourceFormatter(FormatterBase): + # A class that represents a formatter built-in to Scintilla + def __init__(self, scintilla, ext): + self.ext = ext + FormatterBase.__init__(self, scintilla) + + def Colorize(self, start=0, end=-1): + self.scintilla.SendScintilla(scintillacon.SCI_COLOURISE, start, end) + + def RegisterStyle(self, style, stylenum=None): + assert style.stylenum is None, "Style has already been registered" + if stylenum is None: + stylenum = self.nextstylenum + self.nextstylenum = self.nextstylenum + 1 + assert self.styles.get(stylenum) is None, "We are reusing a style number!" + style.stylenum = stylenum + self.styles[style.name] = style + self.styles_by_id[stylenum] = style + + def HookFormatter(self, parent=None): + sc = self.scintilla + for exts, formatter in source_formatter_extensions: + if self.ext in exts: + formatter_use = formatter + break + else: + formatter_use = scintillacon.SCLEX_PYTHON + sc.SendScintilla(scintillacon.SCI_SETLEXER, formatter_use) + keywords = " ".join(kwlist) + sc.SCISetKeywords(keywords) + + +class BuiltinPythonSourceFormatter(BuiltinSourceFormatter): + sci_lexer_name = scintillacon.SCLEX_PYTHON + string_style_names = STRING_STYLES + + def __init__(self, sc, ext=".py"): + BuiltinSourceFormatter.__init__(self, sc, ext) + + def SetStyles(self): + for name, format, bg, sc_id in PYTHON_STYLES: + self.RegisterStyle(Style(name, format, bg), sc_id) + for name, format, bg, sc_id in SPECIAL_STYLES: + self.RegisterStyle(Style(name, format, bg), sc_id) + + def GetSampleText(self): + return PythonSampleCode diff --git a/lib/pythonwin/pywin/scintilla/keycodes.py b/lib/pythonwin/pywin/scintilla/keycodes.py new file mode 100644 index 00000000..badcef3e --- /dev/null +++ b/lib/pythonwin/pywin/scintilla/keycodes.py @@ -0,0 +1,190 @@ +import win32api +import win32con +import win32ui + +MAPVK_VK_TO_CHAR = 2 + +key_name_to_vk = {} +key_code_to_name = {} + +_better_names = { + "escape": "esc", + "return": "enter", + "back": "pgup", + "next": "pgdn", +} + + +def _fillvkmap(): + # Pull the VK_names from win32con + names = [entry for entry in win32con.__dict__ if entry.startswith("VK_")] + for name in names: + code = getattr(win32con, name) + n = name[3:].lower() + key_name_to_vk[n] = code + if n in _better_names: + n = _better_names[n] + key_name_to_vk[n] = code + key_code_to_name[code] = n + + +_fillvkmap() + + +def get_vk(chardesc): + if len(chardesc) == 1: + # it is a character. + info = win32api.VkKeyScan(chardesc) + if info == -1: + # Note: returning None, None causes an error when keyboard layout is non-English, see the report below + # https://stackoverflow.com/questions/45138084/pythonwin-occasionally-gives-an-error-on-opening + return 0, 0 + vk = win32api.LOBYTE(info) + state = win32api.HIBYTE(info) + modifiers = 0 + if state & 0x1: + modifiers |= win32con.SHIFT_PRESSED + if state & 0x2: + modifiers |= win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED + if state & 0x4: + modifiers |= win32con.LEFT_ALT_PRESSED | win32con.RIGHT_ALT_PRESSED + return vk, modifiers + # must be a 'key name' + return key_name_to_vk.get(chardesc.lower()), 0 + + +modifiers = { + "alt": win32con.LEFT_ALT_PRESSED | win32con.RIGHT_ALT_PRESSED, + "lalt": win32con.LEFT_ALT_PRESSED, + "ralt": win32con.RIGHT_ALT_PRESSED, + "ctrl": win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED, + "ctl": win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED, + "control": win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED, + "lctrl": win32con.LEFT_CTRL_PRESSED, + "lctl": win32con.LEFT_CTRL_PRESSED, + "rctrl": win32con.RIGHT_CTRL_PRESSED, + "rctl": win32con.RIGHT_CTRL_PRESSED, + "shift": win32con.SHIFT_PRESSED, + "key": 0, # ignore key tag. +} + + +def parse_key_name(name): + name = name + "-" # Add a sentinal + start = pos = 0 + max = len(name) + toks = [] + while pos < max: + if name[pos] in "+-": + tok = name[start:pos] + # use the ascii lower() version of tok, so ascii chars require + # an explicit shift modifier - ie 'Ctrl+G' should be treated as + # 'ctrl+g' - 'ctrl+shift+g' would be needed if desired. + # This is mainly to avoid changing all the old keystroke defs + toks.append(tok.lower()) + pos += 1 # skip the sep + start = pos + pos += 1 + flags = 0 + # do the modifiers + for tok in toks[:-1]: + mod = modifiers.get(tok.lower()) + if mod is not None: + flags |= mod + # the key name + vk, this_flags = get_vk(toks[-1]) + return vk, flags | this_flags + + +_checks = [ + [ # Shift + ("Shift", win32con.SHIFT_PRESSED), + ], + [ # Ctrl key + ("Ctrl", win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED), + ("LCtrl", win32con.LEFT_CTRL_PRESSED), + ("RCtrl", win32con.RIGHT_CTRL_PRESSED), + ], + [ # Alt key + ("Alt", win32con.LEFT_ALT_PRESSED | win32con.RIGHT_ALT_PRESSED), + ("LAlt", win32con.LEFT_ALT_PRESSED), + ("RAlt", win32con.RIGHT_ALT_PRESSED), + ], +] + + +def make_key_name(vk, flags): + # Check alt keys. + flags_done = 0 + parts = [] + for moddata in _checks: + for name, checkflag in moddata: + if flags & checkflag: + parts.append(name) + flags_done = flags_done & checkflag + break + if flags_done & flags: + parts.append(hex(flags & ~flags_done)) + # Now the key name. + if vk is None: + parts.append("") + else: + try: + parts.append(key_code_to_name[vk]) + except KeyError: + # Not in our virtual key map - ask Windows what character this + # key corresponds to. + scancode = win32api.MapVirtualKey(vk, MAPVK_VK_TO_CHAR) + parts.append(chr(scancode)) + sep = "+" + if sep in parts: + sep = "-" + return sep.join([p.capitalize() for p in parts]) + + +def _psc(char): + sc, mods = get_vk(char) + print("Char %s -> %d -> %s" % (repr(char), sc, key_code_to_name.get(sc))) + + +def test1(): + for ch in """aA0/?[{}];:'"`~_-+=\\|,<.>/?""": + _psc(ch) + for code in ["Home", "End", "Left", "Right", "Up", "Down", "Menu", "Next"]: + _psc(code) + + +def _pkn(n): + vk, flags = parse_key_name(n) + print("%s -> %s,%s -> %s" % (n, vk, flags, make_key_name(vk, flags))) + + +def test2(): + _pkn("ctrl+alt-shift+x") + _pkn("ctrl-home") + _pkn("Shift-+") + _pkn("Shift--") + _pkn("Shift+-") + _pkn("Shift++") + _pkn("LShift-+") + _pkn("ctl+home") + _pkn("ctl+enter") + _pkn("alt+return") + _pkn("Alt+/") + _pkn("Alt+BadKeyName") + _pkn("A") # an ascii char - should be seen as 'a' + _pkn("a") + _pkn("Shift-A") + _pkn("Shift-a") + _pkn("a") + _pkn("(") + _pkn("Ctrl+(") + _pkn("Ctrl+Shift-8") + _pkn("Ctrl+*") + _pkn("{") + _pkn("!") + _pkn(".") + + +if __name__ == "__main__": + test2() diff --git a/lib/pythonwin/pywin/scintilla/scintillacon.py b/lib/pythonwin/pywin/scintilla/scintillacon.py new file mode 100644 index 00000000..e7657dc7 --- /dev/null +++ b/lib/pythonwin/pywin/scintilla/scintillacon.py @@ -0,0 +1,2001 @@ +# Generated by h2py from Include\scintilla.h + + +# Included from BaseTsd.h +def HandleToUlong(h): + return HandleToULong(h) + + +def UlongToHandle(ul): + return ULongToHandle(ul) + + +def UlongToPtr(ul): + return ULongToPtr(ul) + + +def UintToPtr(ui): + return UIntToPtr(ui) + + +INVALID_POSITION = -1 +SCI_START = 2000 +SCI_OPTIONAL_START = 3000 +SCI_LEXER_START = 4000 +SCI_ADDTEXT = 2001 +SCI_ADDSTYLEDTEXT = 2002 +SCI_INSERTTEXT = 2003 +SCI_CLEARALL = 2004 +SCI_CLEARDOCUMENTSTYLE = 2005 +SCI_GETLENGTH = 2006 +SCI_GETCHARAT = 2007 +SCI_GETCURRENTPOS = 2008 +SCI_GETANCHOR = 2009 +SCI_GETSTYLEAT = 2010 +SCI_REDO = 2011 +SCI_SETUNDOCOLLECTION = 2012 +SCI_SELECTALL = 2013 +SCI_SETSAVEPOINT = 2014 +SCI_GETSTYLEDTEXT = 2015 +SCI_CANREDO = 2016 +SCI_MARKERLINEFROMHANDLE = 2017 +SCI_MARKERDELETEHANDLE = 2018 +SCI_GETUNDOCOLLECTION = 2019 +SCWS_INVISIBLE = 0 +SCWS_VISIBLEALWAYS = 1 +SCWS_VISIBLEAFTERINDENT = 2 +SCI_GETVIEWWS = 2020 +SCI_SETVIEWWS = 2021 +SCI_POSITIONFROMPOINT = 2022 +SCI_POSITIONFROMPOINTCLOSE = 2023 +SCI_GOTOLINE = 2024 +SCI_GOTOPOS = 2025 +SCI_SETANCHOR = 2026 +SCI_GETCURLINE = 2027 +SCI_GETENDSTYLED = 2028 +SC_EOL_CRLF = 0 +SC_EOL_CR = 1 +SC_EOL_LF = 2 +SCI_CONVERTEOLS = 2029 +SCI_GETEOLMODE = 2030 +SCI_SETEOLMODE = 2031 +SCI_STARTSTYLING = 2032 +SCI_SETSTYLING = 2033 +SCI_GETBUFFEREDDRAW = 2034 +SCI_SETBUFFEREDDRAW = 2035 +SCI_SETTABWIDTH = 2036 +SCI_GETTABWIDTH = 2121 +SC_CP_UTF8 = 65001 +SC_CP_DBCS = 1 +SCI_SETCODEPAGE = 2037 +SCI_SETUSEPALETTE = 2039 +MARKER_MAX = 31 +SC_MARK_CIRCLE = 0 +SC_MARK_ROUNDRECT = 1 +SC_MARK_ARROW = 2 +SC_MARK_SMALLRECT = 3 +SC_MARK_SHORTARROW = 4 +SC_MARK_EMPTY = 5 +SC_MARK_ARROWDOWN = 6 +SC_MARK_MINUS = 7 +SC_MARK_PLUS = 8 +SC_MARK_VLINE = 9 +SC_MARK_LCORNER = 10 +SC_MARK_TCORNER = 11 +SC_MARK_BOXPLUS = 12 +SC_MARK_BOXPLUSCONNECTED = 13 +SC_MARK_BOXMINUS = 14 +SC_MARK_BOXMINUSCONNECTED = 15 +SC_MARK_LCORNERCURVE = 16 +SC_MARK_TCORNERCURVE = 17 +SC_MARK_CIRCLEPLUS = 18 +SC_MARK_CIRCLEPLUSCONNECTED = 19 +SC_MARK_CIRCLEMINUS = 20 +SC_MARK_CIRCLEMINUSCONNECTED = 21 +SC_MARK_BACKGROUND = 22 +SC_MARK_DOTDOTDOT = 23 +SC_MARK_ARROWS = 24 +SC_MARK_PIXMAP = 25 +SC_MARK_FULLRECT = 26 +SC_MARK_LEFTRECT = 27 +SC_MARK_CHARACTER = 10000 +SC_MARKNUM_FOLDEREND = 25 +SC_MARKNUM_FOLDEROPENMID = 26 +SC_MARKNUM_FOLDERMIDTAIL = 27 +SC_MARKNUM_FOLDERTAIL = 28 +SC_MARKNUM_FOLDERSUB = 29 +SC_MARKNUM_FOLDER = 30 +SC_MARKNUM_FOLDEROPEN = 31 +SC_MASK_FOLDERS = -33554432 +SCI_MARKERDEFINE = 2040 +SCI_MARKERSETFORE = 2041 +SCI_MARKERSETBACK = 2042 +SCI_MARKERADD = 2043 +SCI_MARKERDELETE = 2044 +SCI_MARKERDELETEALL = 2045 +SCI_MARKERGET = 2046 +SCI_MARKERNEXT = 2047 +SCI_MARKERPREVIOUS = 2048 +SCI_MARKERDEFINEPIXMAP = 2049 +SCI_MARKERADDSET = 2466 +SCI_MARKERSETALPHA = 2476 +SC_MARGIN_SYMBOL = 0 +SC_MARGIN_NUMBER = 1 +SC_MARGIN_BACK = 2 +SC_MARGIN_FORE = 3 +SCI_SETMARGINTYPEN = 2240 +SCI_GETMARGINTYPEN = 2241 +SCI_SETMARGINWIDTHN = 2242 +SCI_GETMARGINWIDTHN = 2243 +SCI_SETMARGINMASKN = 2244 +SCI_GETMARGINMASKN = 2245 +SCI_SETMARGINSENSITIVEN = 2246 +SCI_GETMARGINSENSITIVEN = 2247 +STYLE_DEFAULT = 32 +STYLE_LINENUMBER = 33 +STYLE_BRACELIGHT = 34 +STYLE_BRACEBAD = 35 +STYLE_CONTROLCHAR = 36 +STYLE_INDENTGUIDE = 37 +STYLE_CALLTIP = 38 +STYLE_LASTPREDEFINED = 39 +STYLE_MAX = 255 +SC_CHARSET_ANSI = 0 +SC_CHARSET_DEFAULT = 1 +SC_CHARSET_BALTIC = 186 +SC_CHARSET_CHINESEBIG5 = 136 +SC_CHARSET_EASTEUROPE = 238 +SC_CHARSET_GB2312 = 134 +SC_CHARSET_GREEK = 161 +SC_CHARSET_HANGUL = 129 +SC_CHARSET_MAC = 77 +SC_CHARSET_OEM = 255 +SC_CHARSET_RUSSIAN = 204 +SC_CHARSET_CYRILLIC = 1251 +SC_CHARSET_SHIFTJIS = 128 +SC_CHARSET_SYMBOL = 2 +SC_CHARSET_TURKISH = 162 +SC_CHARSET_JOHAB = 130 +SC_CHARSET_HEBREW = 177 +SC_CHARSET_ARABIC = 178 +SC_CHARSET_VIETNAMESE = 163 +SC_CHARSET_THAI = 222 +SC_CHARSET_8859_15 = 1000 +SCI_STYLECLEARALL = 2050 +SCI_STYLESETFORE = 2051 +SCI_STYLESETBACK = 2052 +SCI_STYLESETBOLD = 2053 +SCI_STYLESETITALIC = 2054 +SCI_STYLESETSIZE = 2055 +SCI_STYLESETFONT = 2056 +SCI_STYLESETEOLFILLED = 2057 +SCI_STYLERESETDEFAULT = 2058 +SCI_STYLESETUNDERLINE = 2059 +SC_CASE_MIXED = 0 +SC_CASE_UPPER = 1 +SC_CASE_LOWER = 2 +SCI_STYLEGETFORE = 2481 +SCI_STYLEGETBACK = 2482 +SCI_STYLEGETBOLD = 2483 +SCI_STYLEGETITALIC = 2484 +SCI_STYLEGETSIZE = 2485 +SCI_STYLEGETFONT = 2486 +SCI_STYLEGETEOLFILLED = 2487 +SCI_STYLEGETUNDERLINE = 2488 +SCI_STYLEGETCASE = 2489 +SCI_STYLEGETCHARACTERSET = 2490 +SCI_STYLEGETVISIBLE = 2491 +SCI_STYLEGETCHANGEABLE = 2492 +SCI_STYLEGETHOTSPOT = 2493 +SCI_STYLESETCASE = 2060 +SCI_STYLESETCHARACTERSET = 2066 +SCI_STYLESETHOTSPOT = 2409 +SCI_SETSELFORE = 2067 +SCI_SETSELBACK = 2068 +SCI_GETSELALPHA = 2477 +SCI_SETSELALPHA = 2478 +SCI_GETSELEOLFILLED = 2479 +SCI_SETSELEOLFILLED = 2480 +SCI_SETCARETFORE = 2069 +SCI_ASSIGNCMDKEY = 2070 +SCI_CLEARCMDKEY = 2071 +SCI_CLEARALLCMDKEYS = 2072 +SCI_SETSTYLINGEX = 2073 +SCI_STYLESETVISIBLE = 2074 +SCI_GETCARETPERIOD = 2075 +SCI_SETCARETPERIOD = 2076 +SCI_SETWORDCHARS = 2077 +SCI_BEGINUNDOACTION = 2078 +SCI_ENDUNDOACTION = 2079 +INDIC_PLAIN = 0 +INDIC_SQUIGGLE = 1 +INDIC_TT = 2 +INDIC_DIAGONAL = 3 +INDIC_STRIKE = 4 +INDIC_HIDDEN = 5 +INDIC_BOX = 6 +INDIC_ROUNDBOX = 7 +INDIC_MAX = 31 +INDIC_CONTAINER = 8 +INDIC0_MASK = 0x20 +INDIC1_MASK = 0x40 +INDIC2_MASK = 0x80 +INDICS_MASK = 0xE0 +SCI_INDICSETSTYLE = 2080 +SCI_INDICGETSTYLE = 2081 +SCI_INDICSETFORE = 2082 +SCI_INDICGETFORE = 2083 +SCI_INDICSETUNDER = 2510 +SCI_INDICGETUNDER = 2511 +SCI_SETWHITESPACEFORE = 2084 +SCI_SETWHITESPACEBACK = 2085 +SCI_SETSTYLEBITS = 2090 +SCI_GETSTYLEBITS = 2091 +SCI_SETLINESTATE = 2092 +SCI_GETLINESTATE = 2093 +SCI_GETMAXLINESTATE = 2094 +SCI_GETCARETLINEVISIBLE = 2095 +SCI_SETCARETLINEVISIBLE = 2096 +SCI_GETCARETLINEBACK = 2097 +SCI_SETCARETLINEBACK = 2098 +SCI_STYLESETCHANGEABLE = 2099 +SCI_AUTOCSHOW = 2100 +SCI_AUTOCCANCEL = 2101 +SCI_AUTOCACTIVE = 2102 +SCI_AUTOCPOSSTART = 2103 +SCI_AUTOCCOMPLETE = 2104 +SCI_AUTOCSTOPS = 2105 +SCI_AUTOCSETSEPARATOR = 2106 +SCI_AUTOCGETSEPARATOR = 2107 +SCI_AUTOCSELECT = 2108 +SCI_AUTOCSETCANCELATSTART = 2110 +SCI_AUTOCGETCANCELATSTART = 2111 +SCI_AUTOCSETFILLUPS = 2112 +SCI_AUTOCSETCHOOSESINGLE = 2113 +SCI_AUTOCGETCHOOSESINGLE = 2114 +SCI_AUTOCSETIGNORECASE = 2115 +SCI_AUTOCGETIGNORECASE = 2116 +SCI_USERLISTSHOW = 2117 +SCI_AUTOCSETAUTOHIDE = 2118 +SCI_AUTOCGETAUTOHIDE = 2119 +SCI_AUTOCSETDROPRESTOFWORD = 2270 +SCI_AUTOCGETDROPRESTOFWORD = 2271 +SCI_REGISTERIMAGE = 2405 +SCI_CLEARREGISTEREDIMAGES = 2408 +SCI_AUTOCGETTYPESEPARATOR = 2285 +SCI_AUTOCSETTYPESEPARATOR = 2286 +SCI_AUTOCSETMAXWIDTH = 2208 +SCI_AUTOCGETMAXWIDTH = 2209 +SCI_AUTOCSETMAXHEIGHT = 2210 +SCI_AUTOCGETMAXHEIGHT = 2211 +SCI_SETINDENT = 2122 +SCI_GETINDENT = 2123 +SCI_SETUSETABS = 2124 +SCI_GETUSETABS = 2125 +SCI_SETLINEINDENTATION = 2126 +SCI_GETLINEINDENTATION = 2127 +SCI_GETLINEINDENTPOSITION = 2128 +SCI_GETCOLUMN = 2129 +SCI_SETHSCROLLBAR = 2130 +SCI_GETHSCROLLBAR = 2131 +SC_IV_NONE = 0 +SC_IV_REAL = 1 +SC_IV_LOOKFORWARD = 2 +SC_IV_LOOKBOTH = 3 +SCI_SETINDENTATIONGUIDES = 2132 +SCI_GETINDENTATIONGUIDES = 2133 +SCI_SETHIGHLIGHTGUIDE = 2134 +SCI_GETHIGHLIGHTGUIDE = 2135 +SCI_GETLINEENDPOSITION = 2136 +SCI_GETCODEPAGE = 2137 +SCI_GETCARETFORE = 2138 +SCI_GETUSEPALETTE = 2139 +SCI_GETREADONLY = 2140 +SCI_SETCURRENTPOS = 2141 +SCI_SETSELECTIONSTART = 2142 +SCI_GETSELECTIONSTART = 2143 +SCI_SETSELECTIONEND = 2144 +SCI_GETSELECTIONEND = 2145 +SCI_SETPRINTMAGNIFICATION = 2146 +SCI_GETPRINTMAGNIFICATION = 2147 +SC_PRINT_NORMAL = 0 +SC_PRINT_INVERTLIGHT = 1 +SC_PRINT_BLACKONWHITE = 2 +SC_PRINT_COLOURONWHITE = 3 +SC_PRINT_COLOURONWHITEDEFAULTBG = 4 +SCI_SETPRINTCOLOURMODE = 2148 +SCI_GETPRINTCOLOURMODE = 2149 +SCFIND_WHOLEWORD = 2 +SCFIND_MATCHCASE = 4 +SCFIND_WORDSTART = 0x00100000 +SCFIND_REGEXP = 0x00200000 +SCFIND_POSIX = 0x00400000 +SCI_FINDTEXT = 2150 +SCI_FORMATRANGE = 2151 +SCI_GETFIRSTVISIBLELINE = 2152 +SCI_GETLINE = 2153 +SCI_GETLINECOUNT = 2154 +SCI_SETMARGINLEFT = 2155 +SCI_GETMARGINLEFT = 2156 +SCI_SETMARGINRIGHT = 2157 +SCI_GETMARGINRIGHT = 2158 +SCI_GETMODIFY = 2159 +SCI_SETSEL = 2160 +SCI_GETSELTEXT = 2161 +SCI_GETTEXTRANGE = 2162 +SCI_HIDESELECTION = 2163 +SCI_POINTXFROMPOSITION = 2164 +SCI_POINTYFROMPOSITION = 2165 +SCI_LINEFROMPOSITION = 2166 +SCI_POSITIONFROMLINE = 2167 +SCI_LINESCROLL = 2168 +SCI_SCROLLCARET = 2169 +SCI_REPLACESEL = 2170 +SCI_SETREADONLY = 2171 +SCI_NULL = 2172 +SCI_CANPASTE = 2173 +SCI_CANUNDO = 2174 +SCI_EMPTYUNDOBUFFER = 2175 +SCI_UNDO = 2176 +SCI_CUT = 2177 +SCI_COPY = 2178 +SCI_PASTE = 2179 +SCI_CLEAR = 2180 +SCI_SETTEXT = 2181 +SCI_GETTEXT = 2182 +SCI_GETTEXTLENGTH = 2183 +SCI_GETDIRECTFUNCTION = 2184 +SCI_GETDIRECTPOINTER = 2185 +SCI_SETOVERTYPE = 2186 +SCI_GETOVERTYPE = 2187 +SCI_SETCARETWIDTH = 2188 +SCI_GETCARETWIDTH = 2189 +SCI_SETTARGETSTART = 2190 +SCI_GETTARGETSTART = 2191 +SCI_SETTARGETEND = 2192 +SCI_GETTARGETEND = 2193 +SCI_REPLACETARGET = 2194 +SCI_REPLACETARGETRE = 2195 +SCI_SEARCHINTARGET = 2197 +SCI_SETSEARCHFLAGS = 2198 +SCI_GETSEARCHFLAGS = 2199 +SCI_CALLTIPSHOW = 2200 +SCI_CALLTIPCANCEL = 2201 +SCI_CALLTIPACTIVE = 2202 +SCI_CALLTIPPOSSTART = 2203 +SCI_CALLTIPSETHLT = 2204 +SCI_CALLTIPSETBACK = 2205 +SCI_CALLTIPSETFORE = 2206 +SCI_CALLTIPSETFOREHLT = 2207 +SCI_CALLTIPUSESTYLE = 2212 +SCI_VISIBLEFROMDOCLINE = 2220 +SCI_DOCLINEFROMVISIBLE = 2221 +SCI_WRAPCOUNT = 2235 +SC_FOLDLEVELBASE = 0x400 +SC_FOLDLEVELWHITEFLAG = 0x1000 +SC_FOLDLEVELHEADERFLAG = 0x2000 +SC_FOLDLEVELBOXHEADERFLAG = 0x4000 +SC_FOLDLEVELBOXFOOTERFLAG = 0x8000 +SC_FOLDLEVELCONTRACTED = 0x10000 +SC_FOLDLEVELUNINDENT = 0x20000 +SC_FOLDLEVELNUMBERMASK = 0x0FFF +SCI_SETFOLDLEVEL = 2222 +SCI_GETFOLDLEVEL = 2223 +SCI_GETLASTCHILD = 2224 +SCI_GETFOLDPARENT = 2225 +SCI_SHOWLINES = 2226 +SCI_HIDELINES = 2227 +SCI_GETLINEVISIBLE = 2228 +SCI_SETFOLDEXPANDED = 2229 +SCI_GETFOLDEXPANDED = 2230 +SCI_TOGGLEFOLD = 2231 +SCI_ENSUREVISIBLE = 2232 +SC_FOLDFLAG_LINEBEFORE_EXPANDED = 0x0002 +SC_FOLDFLAG_LINEBEFORE_CONTRACTED = 0x0004 +SC_FOLDFLAG_LINEAFTER_EXPANDED = 0x0008 +SC_FOLDFLAG_LINEAFTER_CONTRACTED = 0x0010 +SC_FOLDFLAG_LEVELNUMBERS = 0x0040 +SC_FOLDFLAG_BOX = 0x0001 +SCI_SETFOLDFLAGS = 2233 +SCI_ENSUREVISIBLEENFORCEPOLICY = 2234 +SCI_SETTABINDENTS = 2260 +SCI_GETTABINDENTS = 2261 +SCI_SETBACKSPACEUNINDENTS = 2262 +SCI_GETBACKSPACEUNINDENTS = 2263 +SC_TIME_FOREVER = 10000000 +SCI_SETMOUSEDWELLTIME = 2264 +SCI_GETMOUSEDWELLTIME = 2265 +SCI_WORDSTARTPOSITION = 2266 +SCI_WORDENDPOSITION = 2267 +SC_WRAP_NONE = 0 +SC_WRAP_WORD = 1 +SC_WRAP_CHAR = 2 +SCI_SETWRAPMODE = 2268 +SCI_GETWRAPMODE = 2269 +SC_WRAPVISUALFLAG_NONE = 0x0000 +SC_WRAPVISUALFLAG_END = 0x0001 +SC_WRAPVISUALFLAG_START = 0x0002 +SCI_SETWRAPVISUALFLAGS = 2460 +SCI_GETWRAPVISUALFLAGS = 2461 +SC_WRAPVISUALFLAGLOC_DEFAULT = 0x0000 +SC_WRAPVISUALFLAGLOC_END_BY_TEXT = 0x0001 +SC_WRAPVISUALFLAGLOC_START_BY_TEXT = 0x0002 +SCI_SETWRAPVISUALFLAGSLOCATION = 2462 +SCI_GETWRAPVISUALFLAGSLOCATION = 2463 +SCI_SETWRAPSTARTINDENT = 2464 +SCI_GETWRAPSTARTINDENT = 2465 +SC_CACHE_NONE = 0 +SC_CACHE_CARET = 1 +SC_CACHE_PAGE = 2 +SC_CACHE_DOCUMENT = 3 +SCI_SETLAYOUTCACHE = 2272 +SCI_GETLAYOUTCACHE = 2273 +SCI_SETSCROLLWIDTH = 2274 +SCI_GETSCROLLWIDTH = 2275 +SCI_SETSCROLLWIDTHTRACKING = 2516 +SCI_GETSCROLLWIDTHTRACKING = 2517 +SCI_TEXTWIDTH = 2276 +SCI_SETENDATLASTLINE = 2277 +SCI_GETENDATLASTLINE = 2278 +SCI_TEXTHEIGHT = 2279 +SCI_SETVSCROLLBAR = 2280 +SCI_GETVSCROLLBAR = 2281 +SCI_APPENDTEXT = 2282 +SCI_GETTWOPHASEDRAW = 2283 +SCI_SETTWOPHASEDRAW = 2284 +SCI_TARGETFROMSELECTION = 2287 +SCI_LINESJOIN = 2288 +SCI_LINESSPLIT = 2289 +SCI_SETFOLDMARGINCOLOUR = 2290 +SCI_SETFOLDMARGINHICOLOUR = 2291 +SCI_LINEDOWN = 2300 +SCI_LINEDOWNEXTEND = 2301 +SCI_LINEUP = 2302 +SCI_LINEUPEXTEND = 2303 +SCI_CHARLEFT = 2304 +SCI_CHARLEFTEXTEND = 2305 +SCI_CHARRIGHT = 2306 +SCI_CHARRIGHTEXTEND = 2307 +SCI_WORDLEFT = 2308 +SCI_WORDLEFTEXTEND = 2309 +SCI_WORDRIGHT = 2310 +SCI_WORDRIGHTEXTEND = 2311 +SCI_HOME = 2312 +SCI_HOMEEXTEND = 2313 +SCI_LINEEND = 2314 +SCI_LINEENDEXTEND = 2315 +SCI_DOCUMENTSTART = 2316 +SCI_DOCUMENTSTARTEXTEND = 2317 +SCI_DOCUMENTEND = 2318 +SCI_DOCUMENTENDEXTEND = 2319 +SCI_PAGEUP = 2320 +SCI_PAGEUPEXTEND = 2321 +SCI_PAGEDOWN = 2322 +SCI_PAGEDOWNEXTEND = 2323 +SCI_EDITTOGGLEOVERTYPE = 2324 +SCI_CANCEL = 2325 +SCI_DELETEBACK = 2326 +SCI_TAB = 2327 +SCI_BACKTAB = 2328 +SCI_NEWLINE = 2329 +SCI_FORMFEED = 2330 +SCI_VCHOME = 2331 +SCI_VCHOMEEXTEND = 2332 +SCI_ZOOMIN = 2333 +SCI_ZOOMOUT = 2334 +SCI_DELWORDLEFT = 2335 +SCI_DELWORDRIGHT = 2336 +SCI_DELWORDRIGHTEND = 2518 +SCI_LINECUT = 2337 +SCI_LINEDELETE = 2338 +SCI_LINETRANSPOSE = 2339 +SCI_LINEDUPLICATE = 2404 +SCI_LOWERCASE = 2340 +SCI_UPPERCASE = 2341 +SCI_LINESCROLLDOWN = 2342 +SCI_LINESCROLLUP = 2343 +SCI_DELETEBACKNOTLINE = 2344 +SCI_HOMEDISPLAY = 2345 +SCI_HOMEDISPLAYEXTEND = 2346 +SCI_LINEENDDISPLAY = 2347 +SCI_LINEENDDISPLAYEXTEND = 2348 +SCI_HOMEWRAP = 2349 +SCI_HOMEWRAPEXTEND = 2450 +SCI_LINEENDWRAP = 2451 +SCI_LINEENDWRAPEXTEND = 2452 +SCI_VCHOMEWRAP = 2453 +SCI_VCHOMEWRAPEXTEND = 2454 +SCI_LINECOPY = 2455 +SCI_MOVECARETINSIDEVIEW = 2401 +SCI_LINELENGTH = 2350 +SCI_BRACEHIGHLIGHT = 2351 +SCI_BRACEBADLIGHT = 2352 +SCI_BRACEMATCH = 2353 +SCI_GETVIEWEOL = 2355 +SCI_SETVIEWEOL = 2356 +SCI_GETDOCPOINTER = 2357 +SCI_SETDOCPOINTER = 2358 +SCI_SETMODEVENTMASK = 2359 +EDGE_NONE = 0 +EDGE_LINE = 1 +EDGE_BACKGROUND = 2 +SCI_GETEDGECOLUMN = 2360 +SCI_SETEDGECOLUMN = 2361 +SCI_GETEDGEMODE = 2362 +SCI_SETEDGEMODE = 2363 +SCI_GETEDGECOLOUR = 2364 +SCI_SETEDGECOLOUR = 2365 +SCI_SEARCHANCHOR = 2366 +SCI_SEARCHNEXT = 2367 +SCI_SEARCHPREV = 2368 +SCI_LINESONSCREEN = 2370 +SCI_USEPOPUP = 2371 +SCI_SELECTIONISRECTANGLE = 2372 +SCI_SETZOOM = 2373 +SCI_GETZOOM = 2374 +SCI_CREATEDOCUMENT = 2375 +SCI_ADDREFDOCUMENT = 2376 +SCI_RELEASEDOCUMENT = 2377 +SCI_GETMODEVENTMASK = 2378 +SCI_SETFOCUS = 2380 +SCI_GETFOCUS = 2381 +SCI_SETSTATUS = 2382 +SCI_GETSTATUS = 2383 +SCI_SETMOUSEDOWNCAPTURES = 2384 +SCI_GETMOUSEDOWNCAPTURES = 2385 +SC_CURSORNORMAL = -1 +SC_CURSORWAIT = 4 +SCI_SETCURSOR = 2386 +SCI_GETCURSOR = 2387 +SCI_SETCONTROLCHARSYMBOL = 2388 +SCI_GETCONTROLCHARSYMBOL = 2389 +SCI_WORDPARTLEFT = 2390 +SCI_WORDPARTLEFTEXTEND = 2391 +SCI_WORDPARTRIGHT = 2392 +SCI_WORDPARTRIGHTEXTEND = 2393 +VISIBLE_SLOP = 0x01 +VISIBLE_STRICT = 0x04 +SCI_SETVISIBLEPOLICY = 2394 +SCI_DELLINELEFT = 2395 +SCI_DELLINERIGHT = 2396 +SCI_SETXOFFSET = 2397 +SCI_GETXOFFSET = 2398 +SCI_CHOOSECARETX = 2399 +SCI_GRABFOCUS = 2400 +CARET_SLOP = 0x01 +CARET_STRICT = 0x04 +CARET_JUMPS = 0x10 +CARET_EVEN = 0x08 +SCI_SETXCARETPOLICY = 2402 +SCI_SETYCARETPOLICY = 2403 +SCI_SETPRINTWRAPMODE = 2406 +SCI_GETPRINTWRAPMODE = 2407 +SCI_SETHOTSPOTACTIVEFORE = 2410 +SCI_GETHOTSPOTACTIVEFORE = 2494 +SCI_SETHOTSPOTACTIVEBACK = 2411 +SCI_GETHOTSPOTACTIVEBACK = 2495 +SCI_SETHOTSPOTACTIVEUNDERLINE = 2412 +SCI_GETHOTSPOTACTIVEUNDERLINE = 2496 +SCI_SETHOTSPOTSINGLELINE = 2421 +SCI_GETHOTSPOTSINGLELINE = 2497 +SCI_PARADOWN = 2413 +SCI_PARADOWNEXTEND = 2414 +SCI_PARAUP = 2415 +SCI_PARAUPEXTEND = 2416 +SCI_POSITIONBEFORE = 2417 +SCI_POSITIONAFTER = 2418 +SCI_COPYRANGE = 2419 +SCI_COPYTEXT = 2420 +SC_SEL_STREAM = 0 +SC_SEL_RECTANGLE = 1 +SC_SEL_LINES = 2 +SCI_SETSELECTIONMODE = 2422 +SCI_GETSELECTIONMODE = 2423 +SCI_GETLINESELSTARTPOSITION = 2424 +SCI_GETLINESELENDPOSITION = 2425 +SCI_LINEDOWNRECTEXTEND = 2426 +SCI_LINEUPRECTEXTEND = 2427 +SCI_CHARLEFTRECTEXTEND = 2428 +SCI_CHARRIGHTRECTEXTEND = 2429 +SCI_HOMERECTEXTEND = 2430 +SCI_VCHOMERECTEXTEND = 2431 +SCI_LINEENDRECTEXTEND = 2432 +SCI_PAGEUPRECTEXTEND = 2433 +SCI_PAGEDOWNRECTEXTEND = 2434 +SCI_STUTTEREDPAGEUP = 2435 +SCI_STUTTEREDPAGEUPEXTEND = 2436 +SCI_STUTTEREDPAGEDOWN = 2437 +SCI_STUTTEREDPAGEDOWNEXTEND = 2438 +SCI_WORDLEFTEND = 2439 +SCI_WORDLEFTENDEXTEND = 2440 +SCI_WORDRIGHTEND = 2441 +SCI_WORDRIGHTENDEXTEND = 2442 +SCI_SETWHITESPACECHARS = 2443 +SCI_SETCHARSDEFAULT = 2444 +SCI_AUTOCGETCURRENT = 2445 +SCI_ALLOCATE = 2446 +SCI_TARGETASUTF8 = 2447 +SCI_SETLENGTHFORENCODE = 2448 +SCI_ENCODEDFROMUTF8 = 2449 +SCI_FINDCOLUMN = 2456 +SCI_GETCARETSTICKY = 2457 +SCI_SETCARETSTICKY = 2458 +SCI_TOGGLECARETSTICKY = 2459 +SCI_SETPASTECONVERTENDINGS = 2467 +SCI_GETPASTECONVERTENDINGS = 2468 +SCI_SELECTIONDUPLICATE = 2469 +SC_ALPHA_TRANSPARENT = 0 +SC_ALPHA_OPAQUE = 255 +SC_ALPHA_NOALPHA = 256 +SCI_SETCARETLINEBACKALPHA = 2470 +SCI_GETCARETLINEBACKALPHA = 2471 +CARETSTYLE_INVISIBLE = 0 +CARETSTYLE_LINE = 1 +CARETSTYLE_BLOCK = 2 +SCI_SETCARETSTYLE = 2512 +SCI_GETCARETSTYLE = 2513 +SCI_SETINDICATORCURRENT = 2500 +SCI_GETINDICATORCURRENT = 2501 +SCI_SETINDICATORVALUE = 2502 +SCI_GETINDICATORVALUE = 2503 +SCI_INDICATORFILLRANGE = 2504 +SCI_INDICATORCLEARRANGE = 2505 +SCI_INDICATORALLONFOR = 2506 +SCI_INDICATORVALUEAT = 2507 +SCI_INDICATORSTART = 2508 +SCI_INDICATOREND = 2509 +SCI_SETPOSITIONCACHE = 2514 +SCI_GETPOSITIONCACHE = 2515 +SCI_COPYALLOWLINE = 2519 +SCI_GETCHARACTERPOINTER = 2520 +SCI_SETKEYSUNICODE = 2521 +SCI_GETKEYSUNICODE = 2522 +SCI_STARTRECORD = 3001 +SCI_STOPRECORD = 3002 +SCI_SETLEXER = 4001 +SCI_GETLEXER = 4002 +SCI_COLOURISE = 4003 +SCI_SETPROPERTY = 4004 +KEYWORDSET_MAX = 8 +SCI_SETKEYWORDS = 4005 +SCI_SETLEXERLANGUAGE = 4006 +SCI_LOADLEXERLIBRARY = 4007 +SCI_GETPROPERTY = 4008 +SCI_GETPROPERTYEXPANDED = 4009 +SCI_GETPROPERTYINT = 4010 +SCI_GETSTYLEBITSNEEDED = 4011 +SC_MOD_INSERTTEXT = 0x1 +SC_MOD_DELETETEXT = 0x2 +SC_MOD_CHANGESTYLE = 0x4 +SC_MOD_CHANGEFOLD = 0x8 +SC_PERFORMED_USER = 0x10 +SC_PERFORMED_UNDO = 0x20 +SC_PERFORMED_REDO = 0x40 +SC_MULTISTEPUNDOREDO = 0x80 +SC_LASTSTEPINUNDOREDO = 0x100 +SC_MOD_CHANGEMARKER = 0x200 +SC_MOD_BEFOREINSERT = 0x400 +SC_MOD_BEFOREDELETE = 0x800 +SC_MULTILINEUNDOREDO = 0x1000 +SC_STARTACTION = 0x2000 +SC_MOD_CHANGEINDICATOR = 0x4000 +SC_MOD_CHANGELINESTATE = 0x8000 +SC_MODEVENTMASKALL = 0xFFFF +SCEN_CHANGE = 768 +SCEN_SETFOCUS = 512 +SCEN_KILLFOCUS = 256 +SCK_DOWN = 300 +SCK_UP = 301 +SCK_LEFT = 302 +SCK_RIGHT = 303 +SCK_HOME = 304 +SCK_END = 305 +SCK_PRIOR = 306 +SCK_NEXT = 307 +SCK_DELETE = 308 +SCK_INSERT = 309 +SCK_ESCAPE = 7 +SCK_BACK = 8 +SCK_TAB = 9 +SCK_RETURN = 13 +SCK_ADD = 310 +SCK_SUBTRACT = 311 +SCK_DIVIDE = 312 +SCK_WIN = 313 +SCK_RWIN = 314 +SCK_MENU = 315 +SCMOD_NORM = 0 +SCMOD_SHIFT = 1 +SCMOD_CTRL = 2 +SCMOD_ALT = 4 +SCN_STYLENEEDED = 2000 +SCN_CHARADDED = 2001 +SCN_SAVEPOINTREACHED = 2002 +SCN_SAVEPOINTLEFT = 2003 +SCN_MODIFYATTEMPTRO = 2004 +SCN_KEY = 2005 +SCN_DOUBLECLICK = 2006 +SCN_UPDATEUI = 2007 +SCN_MODIFIED = 2008 +SCN_MACRORECORD = 2009 +SCN_MARGINCLICK = 2010 +SCN_NEEDSHOWN = 2011 +SCN_PAINTED = 2013 +SCN_USERLISTSELECTION = 2014 +SCN_URIDROPPED = 2015 +SCN_DWELLSTART = 2016 +SCN_DWELLEND = 2017 +SCN_ZOOM = 2018 +SCN_HOTSPOTCLICK = 2019 +SCN_HOTSPOTDOUBLECLICK = 2020 +SCN_CALLTIPCLICK = 2021 +SCN_AUTOCSELECTION = 2022 +SCN_INDICATORCLICK = 2023 +SCN_INDICATORRELEASE = 2024 +SCN_AUTOCCANCELLED = 2025 +SCI_SETCARETPOLICY = 2369 +CARET_CENTER = 0x02 +CARET_XEVEN = 0x08 +CARET_XJUMPS = 0x10 +SCN_POSCHANGED = 2012 +SCN_CHECKBRACE = 2007 +# Generated by h2py from Include\scilexer.h +SCLEX_CONTAINER = 0 +SCLEX_NULL = 1 +SCLEX_PYTHON = 2 +SCLEX_CPP = 3 +SCLEX_HTML = 4 +SCLEX_XML = 5 +SCLEX_PERL = 6 +SCLEX_SQL = 7 +SCLEX_VB = 8 +SCLEX_PROPERTIES = 9 +SCLEX_ERRORLIST = 10 +SCLEX_MAKEFILE = 11 +SCLEX_BATCH = 12 +SCLEX_XCODE = 13 +SCLEX_LATEX = 14 +SCLEX_LUA = 15 +SCLEX_DIFF = 16 +SCLEX_CONF = 17 +SCLEX_PASCAL = 18 +SCLEX_AVE = 19 +SCLEX_ADA = 20 +SCLEX_LISP = 21 +SCLEX_RUBY = 22 +SCLEX_EIFFEL = 23 +SCLEX_EIFFELKW = 24 +SCLEX_TCL = 25 +SCLEX_NNCRONTAB = 26 +SCLEX_BULLANT = 27 +SCLEX_VBSCRIPT = 28 +SCLEX_BAAN = 31 +SCLEX_MATLAB = 32 +SCLEX_SCRIPTOL = 33 +SCLEX_ASM = 34 +SCLEX_CPPNOCASE = 35 +SCLEX_FORTRAN = 36 +SCLEX_F77 = 37 +SCLEX_CSS = 38 +SCLEX_POV = 39 +SCLEX_LOUT = 40 +SCLEX_ESCRIPT = 41 +SCLEX_PS = 42 +SCLEX_NSIS = 43 +SCLEX_MMIXAL = 44 +SCLEX_CLW = 45 +SCLEX_CLWNOCASE = 46 +SCLEX_LOT = 47 +SCLEX_YAML = 48 +SCLEX_TEX = 49 +SCLEX_METAPOST = 50 +SCLEX_POWERBASIC = 51 +SCLEX_FORTH = 52 +SCLEX_ERLANG = 53 +SCLEX_OCTAVE = 54 +SCLEX_MSSQL = 55 +SCLEX_VERILOG = 56 +SCLEX_KIX = 57 +SCLEX_GUI4CLI = 58 +SCLEX_SPECMAN = 59 +SCLEX_AU3 = 60 +SCLEX_APDL = 61 +SCLEX_BASH = 62 +SCLEX_ASN1 = 63 +SCLEX_VHDL = 64 +SCLEX_CAML = 65 +SCLEX_BLITZBASIC = 66 +SCLEX_PUREBASIC = 67 +SCLEX_HASKELL = 68 +SCLEX_PHPSCRIPT = 69 +SCLEX_TADS3 = 70 +SCLEX_REBOL = 71 +SCLEX_SMALLTALK = 72 +SCLEX_FLAGSHIP = 73 +SCLEX_CSOUND = 74 +SCLEX_FREEBASIC = 75 +SCLEX_INNOSETUP = 76 +SCLEX_OPAL = 77 +SCLEX_SPICE = 78 +SCLEX_D = 79 +SCLEX_CMAKE = 80 +SCLEX_GAP = 81 +SCLEX_PLM = 82 +SCLEX_PROGRESS = 83 +SCLEX_ABAQUS = 84 +SCLEX_ASYMPTOTE = 85 +SCLEX_R = 86 +SCLEX_MAGIK = 87 +SCLEX_POWERSHELL = 88 +SCLEX_MYSQL = 89 +SCLEX_PO = 90 +SCLEX_AUTOMATIC = 1000 +SCE_P_DEFAULT = 0 +SCE_P_COMMENTLINE = 1 +SCE_P_NUMBER = 2 +SCE_P_STRING = 3 +SCE_P_CHARACTER = 4 +SCE_P_WORD = 5 +SCE_P_TRIPLE = 6 +SCE_P_TRIPLEDOUBLE = 7 +SCE_P_CLASSNAME = 8 +SCE_P_DEFNAME = 9 +SCE_P_OPERATOR = 10 +SCE_P_IDENTIFIER = 11 +SCE_P_COMMENTBLOCK = 12 +SCE_P_STRINGEOL = 13 +SCE_P_WORD2 = 14 +SCE_P_DECORATOR = 15 +SCE_C_DEFAULT = 0 +SCE_C_COMMENT = 1 +SCE_C_COMMENTLINE = 2 +SCE_C_COMMENTDOC = 3 +SCE_C_NUMBER = 4 +SCE_C_WORD = 5 +SCE_C_STRING = 6 +SCE_C_CHARACTER = 7 +SCE_C_UUID = 8 +SCE_C_PREPROCESSOR = 9 +SCE_C_OPERATOR = 10 +SCE_C_IDENTIFIER = 11 +SCE_C_STRINGEOL = 12 +SCE_C_VERBATIM = 13 +SCE_C_REGEX = 14 +SCE_C_COMMENTLINEDOC = 15 +SCE_C_WORD2 = 16 +SCE_C_COMMENTDOCKEYWORD = 17 +SCE_C_COMMENTDOCKEYWORDERROR = 18 +SCE_C_GLOBALCLASS = 19 +SCE_D_DEFAULT = 0 +SCE_D_COMMENT = 1 +SCE_D_COMMENTLINE = 2 +SCE_D_COMMENTDOC = 3 +SCE_D_COMMENTNESTED = 4 +SCE_D_NUMBER = 5 +SCE_D_WORD = 6 +SCE_D_WORD2 = 7 +SCE_D_WORD3 = 8 +SCE_D_TYPEDEF = 9 +SCE_D_STRING = 10 +SCE_D_STRINGEOL = 11 +SCE_D_CHARACTER = 12 +SCE_D_OPERATOR = 13 +SCE_D_IDENTIFIER = 14 +SCE_D_COMMENTLINEDOC = 15 +SCE_D_COMMENTDOCKEYWORD = 16 +SCE_D_COMMENTDOCKEYWORDERROR = 17 +SCE_TCL_DEFAULT = 0 +SCE_TCL_COMMENT = 1 +SCE_TCL_COMMENTLINE = 2 +SCE_TCL_NUMBER = 3 +SCE_TCL_WORD_IN_QUOTE = 4 +SCE_TCL_IN_QUOTE = 5 +SCE_TCL_OPERATOR = 6 +SCE_TCL_IDENTIFIER = 7 +SCE_TCL_SUBSTITUTION = 8 +SCE_TCL_SUB_BRACE = 9 +SCE_TCL_MODIFIER = 10 +SCE_TCL_EXPAND = 11 +SCE_TCL_WORD = 12 +SCE_TCL_WORD2 = 13 +SCE_TCL_WORD3 = 14 +SCE_TCL_WORD4 = 15 +SCE_TCL_WORD5 = 16 +SCE_TCL_WORD6 = 17 +SCE_TCL_WORD7 = 18 +SCE_TCL_WORD8 = 19 +SCE_TCL_COMMENT_BOX = 20 +SCE_TCL_BLOCK_COMMENT = 21 +SCE_H_DEFAULT = 0 +SCE_H_TAG = 1 +SCE_H_TAGUNKNOWN = 2 +SCE_H_ATTRIBUTE = 3 +SCE_H_ATTRIBUTEUNKNOWN = 4 +SCE_H_NUMBER = 5 +SCE_H_DOUBLESTRING = 6 +SCE_H_SINGLESTRING = 7 +SCE_H_OTHER = 8 +SCE_H_COMMENT = 9 +SCE_H_ENTITY = 10 +SCE_H_TAGEND = 11 +SCE_H_XMLSTART = 12 +SCE_H_XMLEND = 13 +SCE_H_SCRIPT = 14 +SCE_H_ASP = 15 +SCE_H_ASPAT = 16 +SCE_H_CDATA = 17 +SCE_H_QUESTION = 18 +SCE_H_VALUE = 19 +SCE_H_XCCOMMENT = 20 +SCE_H_SGML_DEFAULT = 21 +SCE_H_SGML_COMMAND = 22 +SCE_H_SGML_1ST_PARAM = 23 +SCE_H_SGML_DOUBLESTRING = 24 +SCE_H_SGML_SIMPLESTRING = 25 +SCE_H_SGML_ERROR = 26 +SCE_H_SGML_SPECIAL = 27 +SCE_H_SGML_ENTITY = 28 +SCE_H_SGML_COMMENT = 29 +SCE_H_SGML_1ST_PARAM_COMMENT = 30 +SCE_H_SGML_BLOCK_DEFAULT = 31 +SCE_HJ_START = 40 +SCE_HJ_DEFAULT = 41 +SCE_HJ_COMMENT = 42 +SCE_HJ_COMMENTLINE = 43 +SCE_HJ_COMMENTDOC = 44 +SCE_HJ_NUMBER = 45 +SCE_HJ_WORD = 46 +SCE_HJ_KEYWORD = 47 +SCE_HJ_DOUBLESTRING = 48 +SCE_HJ_SINGLESTRING = 49 +SCE_HJ_SYMBOLS = 50 +SCE_HJ_STRINGEOL = 51 +SCE_HJ_REGEX = 52 +SCE_HJA_START = 55 +SCE_HJA_DEFAULT = 56 +SCE_HJA_COMMENT = 57 +SCE_HJA_COMMENTLINE = 58 +SCE_HJA_COMMENTDOC = 59 +SCE_HJA_NUMBER = 60 +SCE_HJA_WORD = 61 +SCE_HJA_KEYWORD = 62 +SCE_HJA_DOUBLESTRING = 63 +SCE_HJA_SINGLESTRING = 64 +SCE_HJA_SYMBOLS = 65 +SCE_HJA_STRINGEOL = 66 +SCE_HJA_REGEX = 67 +SCE_HB_START = 70 +SCE_HB_DEFAULT = 71 +SCE_HB_COMMENTLINE = 72 +SCE_HB_NUMBER = 73 +SCE_HB_WORD = 74 +SCE_HB_STRING = 75 +SCE_HB_IDENTIFIER = 76 +SCE_HB_STRINGEOL = 77 +SCE_HBA_START = 80 +SCE_HBA_DEFAULT = 81 +SCE_HBA_COMMENTLINE = 82 +SCE_HBA_NUMBER = 83 +SCE_HBA_WORD = 84 +SCE_HBA_STRING = 85 +SCE_HBA_IDENTIFIER = 86 +SCE_HBA_STRINGEOL = 87 +SCE_HP_START = 90 +SCE_HP_DEFAULT = 91 +SCE_HP_COMMENTLINE = 92 +SCE_HP_NUMBER = 93 +SCE_HP_STRING = 94 +SCE_HP_CHARACTER = 95 +SCE_HP_WORD = 96 +SCE_HP_TRIPLE = 97 +SCE_HP_TRIPLEDOUBLE = 98 +SCE_HP_CLASSNAME = 99 +SCE_HP_DEFNAME = 100 +SCE_HP_OPERATOR = 101 +SCE_HP_IDENTIFIER = 102 +SCE_HPHP_COMPLEX_VARIABLE = 104 +SCE_HPA_START = 105 +SCE_HPA_DEFAULT = 106 +SCE_HPA_COMMENTLINE = 107 +SCE_HPA_NUMBER = 108 +SCE_HPA_STRING = 109 +SCE_HPA_CHARACTER = 110 +SCE_HPA_WORD = 111 +SCE_HPA_TRIPLE = 112 +SCE_HPA_TRIPLEDOUBLE = 113 +SCE_HPA_CLASSNAME = 114 +SCE_HPA_DEFNAME = 115 +SCE_HPA_OPERATOR = 116 +SCE_HPA_IDENTIFIER = 117 +SCE_HPHP_DEFAULT = 118 +SCE_HPHP_HSTRING = 119 +SCE_HPHP_SIMPLESTRING = 120 +SCE_HPHP_WORD = 121 +SCE_HPHP_NUMBER = 122 +SCE_HPHP_VARIABLE = 123 +SCE_HPHP_COMMENT = 124 +SCE_HPHP_COMMENTLINE = 125 +SCE_HPHP_HSTRING_VARIABLE = 126 +SCE_HPHP_OPERATOR = 127 +SCE_PL_DEFAULT = 0 +SCE_PL_ERROR = 1 +SCE_PL_COMMENTLINE = 2 +SCE_PL_POD = 3 +SCE_PL_NUMBER = 4 +SCE_PL_WORD = 5 +SCE_PL_STRING = 6 +SCE_PL_CHARACTER = 7 +SCE_PL_PUNCTUATION = 8 +SCE_PL_PREPROCESSOR = 9 +SCE_PL_OPERATOR = 10 +SCE_PL_IDENTIFIER = 11 +SCE_PL_SCALAR = 12 +SCE_PL_ARRAY = 13 +SCE_PL_HASH = 14 +SCE_PL_SYMBOLTABLE = 15 +SCE_PL_VARIABLE_INDEXER = 16 +SCE_PL_REGEX = 17 +SCE_PL_REGSUBST = 18 +SCE_PL_LONGQUOTE = 19 +SCE_PL_BACKTICKS = 20 +SCE_PL_DATASECTION = 21 +SCE_PL_HERE_DELIM = 22 +SCE_PL_HERE_Q = 23 +SCE_PL_HERE_QQ = 24 +SCE_PL_HERE_QX = 25 +SCE_PL_STRING_Q = 26 +SCE_PL_STRING_QQ = 27 +SCE_PL_STRING_QX = 28 +SCE_PL_STRING_QR = 29 +SCE_PL_STRING_QW = 30 +SCE_PL_POD_VERB = 31 +SCE_PL_SUB_PROTOTYPE = 40 +SCE_PL_FORMAT_IDENT = 41 +SCE_PL_FORMAT = 42 +SCE_RB_DEFAULT = 0 +SCE_RB_ERROR = 1 +SCE_RB_COMMENTLINE = 2 +SCE_RB_POD = 3 +SCE_RB_NUMBER = 4 +SCE_RB_WORD = 5 +SCE_RB_STRING = 6 +SCE_RB_CHARACTER = 7 +SCE_RB_CLASSNAME = 8 +SCE_RB_DEFNAME = 9 +SCE_RB_OPERATOR = 10 +SCE_RB_IDENTIFIER = 11 +SCE_RB_REGEX = 12 +SCE_RB_GLOBAL = 13 +SCE_RB_SYMBOL = 14 +SCE_RB_MODULE_NAME = 15 +SCE_RB_INSTANCE_VAR = 16 +SCE_RB_CLASS_VAR = 17 +SCE_RB_BACKTICKS = 18 +SCE_RB_DATASECTION = 19 +SCE_RB_HERE_DELIM = 20 +SCE_RB_HERE_Q = 21 +SCE_RB_HERE_QQ = 22 +SCE_RB_HERE_QX = 23 +SCE_RB_STRING_Q = 24 +SCE_RB_STRING_QQ = 25 +SCE_RB_STRING_QX = 26 +SCE_RB_STRING_QR = 27 +SCE_RB_STRING_QW = 28 +SCE_RB_WORD_DEMOTED = 29 +SCE_RB_STDIN = 30 +SCE_RB_STDOUT = 31 +SCE_RB_STDERR = 40 +SCE_RB_UPPER_BOUND = 41 +SCE_B_DEFAULT = 0 +SCE_B_COMMENT = 1 +SCE_B_NUMBER = 2 +SCE_B_KEYWORD = 3 +SCE_B_STRING = 4 +SCE_B_PREPROCESSOR = 5 +SCE_B_OPERATOR = 6 +SCE_B_IDENTIFIER = 7 +SCE_B_DATE = 8 +SCE_B_STRINGEOL = 9 +SCE_B_KEYWORD2 = 10 +SCE_B_KEYWORD3 = 11 +SCE_B_KEYWORD4 = 12 +SCE_B_CONSTANT = 13 +SCE_B_ASM = 14 +SCE_B_LABEL = 15 +SCE_B_ERROR = 16 +SCE_B_HEXNUMBER = 17 +SCE_B_BINNUMBER = 18 +SCE_PROPS_DEFAULT = 0 +SCE_PROPS_COMMENT = 1 +SCE_PROPS_SECTION = 2 +SCE_PROPS_ASSIGNMENT = 3 +SCE_PROPS_DEFVAL = 4 +SCE_PROPS_KEY = 5 +SCE_L_DEFAULT = 0 +SCE_L_COMMAND = 1 +SCE_L_TAG = 2 +SCE_L_MATH = 3 +SCE_L_COMMENT = 4 +SCE_LUA_DEFAULT = 0 +SCE_LUA_COMMENT = 1 +SCE_LUA_COMMENTLINE = 2 +SCE_LUA_COMMENTDOC = 3 +SCE_LUA_NUMBER = 4 +SCE_LUA_WORD = 5 +SCE_LUA_STRING = 6 +SCE_LUA_CHARACTER = 7 +SCE_LUA_LITERALSTRING = 8 +SCE_LUA_PREPROCESSOR = 9 +SCE_LUA_OPERATOR = 10 +SCE_LUA_IDENTIFIER = 11 +SCE_LUA_STRINGEOL = 12 +SCE_LUA_WORD2 = 13 +SCE_LUA_WORD3 = 14 +SCE_LUA_WORD4 = 15 +SCE_LUA_WORD5 = 16 +SCE_LUA_WORD6 = 17 +SCE_LUA_WORD7 = 18 +SCE_LUA_WORD8 = 19 +SCE_ERR_DEFAULT = 0 +SCE_ERR_PYTHON = 1 +SCE_ERR_GCC = 2 +SCE_ERR_MS = 3 +SCE_ERR_CMD = 4 +SCE_ERR_BORLAND = 5 +SCE_ERR_PERL = 6 +SCE_ERR_NET = 7 +SCE_ERR_LUA = 8 +SCE_ERR_CTAG = 9 +SCE_ERR_DIFF_CHANGED = 10 +SCE_ERR_DIFF_ADDITION = 11 +SCE_ERR_DIFF_DELETION = 12 +SCE_ERR_DIFF_MESSAGE = 13 +SCE_ERR_PHP = 14 +SCE_ERR_ELF = 15 +SCE_ERR_IFC = 16 +SCE_ERR_IFORT = 17 +SCE_ERR_ABSF = 18 +SCE_ERR_TIDY = 19 +SCE_ERR_JAVA_STACK = 20 +SCE_ERR_VALUE = 21 +SCE_BAT_DEFAULT = 0 +SCE_BAT_COMMENT = 1 +SCE_BAT_WORD = 2 +SCE_BAT_LABEL = 3 +SCE_BAT_HIDE = 4 +SCE_BAT_COMMAND = 5 +SCE_BAT_IDENTIFIER = 6 +SCE_BAT_OPERATOR = 7 +SCE_MAKE_DEFAULT = 0 +SCE_MAKE_COMMENT = 1 +SCE_MAKE_PREPROCESSOR = 2 +SCE_MAKE_IDENTIFIER = 3 +SCE_MAKE_OPERATOR = 4 +SCE_MAKE_TARGET = 5 +SCE_MAKE_IDEOL = 9 +SCE_DIFF_DEFAULT = 0 +SCE_DIFF_COMMENT = 1 +SCE_DIFF_COMMAND = 2 +SCE_DIFF_HEADER = 3 +SCE_DIFF_POSITION = 4 +SCE_DIFF_DELETED = 5 +SCE_DIFF_ADDED = 6 +SCE_DIFF_CHANGED = 7 +SCE_CONF_DEFAULT = 0 +SCE_CONF_COMMENT = 1 +SCE_CONF_NUMBER = 2 +SCE_CONF_IDENTIFIER = 3 +SCE_CONF_EXTENSION = 4 +SCE_CONF_PARAMETER = 5 +SCE_CONF_STRING = 6 +SCE_CONF_OPERATOR = 7 +SCE_CONF_IP = 8 +SCE_CONF_DIRECTIVE = 9 +SCE_AVE_DEFAULT = 0 +SCE_AVE_COMMENT = 1 +SCE_AVE_NUMBER = 2 +SCE_AVE_WORD = 3 +SCE_AVE_STRING = 6 +SCE_AVE_ENUM = 7 +SCE_AVE_STRINGEOL = 8 +SCE_AVE_IDENTIFIER = 9 +SCE_AVE_OPERATOR = 10 +SCE_AVE_WORD1 = 11 +SCE_AVE_WORD2 = 12 +SCE_AVE_WORD3 = 13 +SCE_AVE_WORD4 = 14 +SCE_AVE_WORD5 = 15 +SCE_AVE_WORD6 = 16 +SCE_ADA_DEFAULT = 0 +SCE_ADA_WORD = 1 +SCE_ADA_IDENTIFIER = 2 +SCE_ADA_NUMBER = 3 +SCE_ADA_DELIMITER = 4 +SCE_ADA_CHARACTER = 5 +SCE_ADA_CHARACTEREOL = 6 +SCE_ADA_STRING = 7 +SCE_ADA_STRINGEOL = 8 +SCE_ADA_LABEL = 9 +SCE_ADA_COMMENTLINE = 10 +SCE_ADA_ILLEGAL = 11 +SCE_BAAN_DEFAULT = 0 +SCE_BAAN_COMMENT = 1 +SCE_BAAN_COMMENTDOC = 2 +SCE_BAAN_NUMBER = 3 +SCE_BAAN_WORD = 4 +SCE_BAAN_STRING = 5 +SCE_BAAN_PREPROCESSOR = 6 +SCE_BAAN_OPERATOR = 7 +SCE_BAAN_IDENTIFIER = 8 +SCE_BAAN_STRINGEOL = 9 +SCE_BAAN_WORD2 = 10 +SCE_LISP_DEFAULT = 0 +SCE_LISP_COMMENT = 1 +SCE_LISP_NUMBER = 2 +SCE_LISP_KEYWORD = 3 +SCE_LISP_KEYWORD_KW = 4 +SCE_LISP_SYMBOL = 5 +SCE_LISP_STRING = 6 +SCE_LISP_STRINGEOL = 8 +SCE_LISP_IDENTIFIER = 9 +SCE_LISP_OPERATOR = 10 +SCE_LISP_SPECIAL = 11 +SCE_LISP_MULTI_COMMENT = 12 +SCE_EIFFEL_DEFAULT = 0 +SCE_EIFFEL_COMMENTLINE = 1 +SCE_EIFFEL_NUMBER = 2 +SCE_EIFFEL_WORD = 3 +SCE_EIFFEL_STRING = 4 +SCE_EIFFEL_CHARACTER = 5 +SCE_EIFFEL_OPERATOR = 6 +SCE_EIFFEL_IDENTIFIER = 7 +SCE_EIFFEL_STRINGEOL = 8 +SCE_NNCRONTAB_DEFAULT = 0 +SCE_NNCRONTAB_COMMENT = 1 +SCE_NNCRONTAB_TASK = 2 +SCE_NNCRONTAB_SECTION = 3 +SCE_NNCRONTAB_KEYWORD = 4 +SCE_NNCRONTAB_MODIFIER = 5 +SCE_NNCRONTAB_ASTERISK = 6 +SCE_NNCRONTAB_NUMBER = 7 +SCE_NNCRONTAB_STRING = 8 +SCE_NNCRONTAB_ENVIRONMENT = 9 +SCE_NNCRONTAB_IDENTIFIER = 10 +SCE_FORTH_DEFAULT = 0 +SCE_FORTH_COMMENT = 1 +SCE_FORTH_COMMENT_ML = 2 +SCE_FORTH_IDENTIFIER = 3 +SCE_FORTH_CONTROL = 4 +SCE_FORTH_KEYWORD = 5 +SCE_FORTH_DEFWORD = 6 +SCE_FORTH_PREWORD1 = 7 +SCE_FORTH_PREWORD2 = 8 +SCE_FORTH_NUMBER = 9 +SCE_FORTH_STRING = 10 +SCE_FORTH_LOCALE = 11 +SCE_MATLAB_DEFAULT = 0 +SCE_MATLAB_COMMENT = 1 +SCE_MATLAB_COMMAND = 2 +SCE_MATLAB_NUMBER = 3 +SCE_MATLAB_KEYWORD = 4 +SCE_MATLAB_STRING = 5 +SCE_MATLAB_OPERATOR = 6 +SCE_MATLAB_IDENTIFIER = 7 +SCE_MATLAB_DOUBLEQUOTESTRING = 8 +SCE_SCRIPTOL_DEFAULT = 0 +SCE_SCRIPTOL_WHITE = 1 +SCE_SCRIPTOL_COMMENTLINE = 2 +SCE_SCRIPTOL_PERSISTENT = 3 +SCE_SCRIPTOL_CSTYLE = 4 +SCE_SCRIPTOL_COMMENTBLOCK = 5 +SCE_SCRIPTOL_NUMBER = 6 +SCE_SCRIPTOL_STRING = 7 +SCE_SCRIPTOL_CHARACTER = 8 +SCE_SCRIPTOL_STRINGEOL = 9 +SCE_SCRIPTOL_KEYWORD = 10 +SCE_SCRIPTOL_OPERATOR = 11 +SCE_SCRIPTOL_IDENTIFIER = 12 +SCE_SCRIPTOL_TRIPLE = 13 +SCE_SCRIPTOL_CLASSNAME = 14 +SCE_SCRIPTOL_PREPROCESSOR = 15 +SCE_ASM_DEFAULT = 0 +SCE_ASM_COMMENT = 1 +SCE_ASM_NUMBER = 2 +SCE_ASM_STRING = 3 +SCE_ASM_OPERATOR = 4 +SCE_ASM_IDENTIFIER = 5 +SCE_ASM_CPUINSTRUCTION = 6 +SCE_ASM_MATHINSTRUCTION = 7 +SCE_ASM_REGISTER = 8 +SCE_ASM_DIRECTIVE = 9 +SCE_ASM_DIRECTIVEOPERAND = 10 +SCE_ASM_COMMENTBLOCK = 11 +SCE_ASM_CHARACTER = 12 +SCE_ASM_STRINGEOL = 13 +SCE_ASM_EXTINSTRUCTION = 14 +SCE_F_DEFAULT = 0 +SCE_F_COMMENT = 1 +SCE_F_NUMBER = 2 +SCE_F_STRING1 = 3 +SCE_F_STRING2 = 4 +SCE_F_STRINGEOL = 5 +SCE_F_OPERATOR = 6 +SCE_F_IDENTIFIER = 7 +SCE_F_WORD = 8 +SCE_F_WORD2 = 9 +SCE_F_WORD3 = 10 +SCE_F_PREPROCESSOR = 11 +SCE_F_OPERATOR2 = 12 +SCE_F_LABEL = 13 +SCE_F_CONTINUATION = 14 +SCE_CSS_DEFAULT = 0 +SCE_CSS_TAG = 1 +SCE_CSS_CLASS = 2 +SCE_CSS_PSEUDOCLASS = 3 +SCE_CSS_UNKNOWN_PSEUDOCLASS = 4 +SCE_CSS_OPERATOR = 5 +SCE_CSS_IDENTIFIER = 6 +SCE_CSS_UNKNOWN_IDENTIFIER = 7 +SCE_CSS_VALUE = 8 +SCE_CSS_COMMENT = 9 +SCE_CSS_ID = 10 +SCE_CSS_IMPORTANT = 11 +SCE_CSS_DIRECTIVE = 12 +SCE_CSS_DOUBLESTRING = 13 +SCE_CSS_SINGLESTRING = 14 +SCE_CSS_IDENTIFIER2 = 15 +SCE_CSS_ATTRIBUTE = 16 +SCE_CSS_IDENTIFIER3 = 17 +SCE_CSS_PSEUDOELEMENT = 18 +SCE_CSS_EXTENDED_IDENTIFIER = 19 +SCE_CSS_EXTENDED_PSEUDOCLASS = 20 +SCE_CSS_EXTENDED_PSEUDOELEMENT = 21 +SCE_POV_DEFAULT = 0 +SCE_POV_COMMENT = 1 +SCE_POV_COMMENTLINE = 2 +SCE_POV_NUMBER = 3 +SCE_POV_OPERATOR = 4 +SCE_POV_IDENTIFIER = 5 +SCE_POV_STRING = 6 +SCE_POV_STRINGEOL = 7 +SCE_POV_DIRECTIVE = 8 +SCE_POV_BADDIRECTIVE = 9 +SCE_POV_WORD2 = 10 +SCE_POV_WORD3 = 11 +SCE_POV_WORD4 = 12 +SCE_POV_WORD5 = 13 +SCE_POV_WORD6 = 14 +SCE_POV_WORD7 = 15 +SCE_POV_WORD8 = 16 +SCE_LOUT_DEFAULT = 0 +SCE_LOUT_COMMENT = 1 +SCE_LOUT_NUMBER = 2 +SCE_LOUT_WORD = 3 +SCE_LOUT_WORD2 = 4 +SCE_LOUT_WORD3 = 5 +SCE_LOUT_WORD4 = 6 +SCE_LOUT_STRING = 7 +SCE_LOUT_OPERATOR = 8 +SCE_LOUT_IDENTIFIER = 9 +SCE_LOUT_STRINGEOL = 10 +SCE_ESCRIPT_DEFAULT = 0 +SCE_ESCRIPT_COMMENT = 1 +SCE_ESCRIPT_COMMENTLINE = 2 +SCE_ESCRIPT_COMMENTDOC = 3 +SCE_ESCRIPT_NUMBER = 4 +SCE_ESCRIPT_WORD = 5 +SCE_ESCRIPT_STRING = 6 +SCE_ESCRIPT_OPERATOR = 7 +SCE_ESCRIPT_IDENTIFIER = 8 +SCE_ESCRIPT_BRACE = 9 +SCE_ESCRIPT_WORD2 = 10 +SCE_ESCRIPT_WORD3 = 11 +SCE_PS_DEFAULT = 0 +SCE_PS_COMMENT = 1 +SCE_PS_DSC_COMMENT = 2 +SCE_PS_DSC_VALUE = 3 +SCE_PS_NUMBER = 4 +SCE_PS_NAME = 5 +SCE_PS_KEYWORD = 6 +SCE_PS_LITERAL = 7 +SCE_PS_IMMEVAL = 8 +SCE_PS_PAREN_ARRAY = 9 +SCE_PS_PAREN_DICT = 10 +SCE_PS_PAREN_PROC = 11 +SCE_PS_TEXT = 12 +SCE_PS_HEXSTRING = 13 +SCE_PS_BASE85STRING = 14 +SCE_PS_BADSTRINGCHAR = 15 +SCE_NSIS_DEFAULT = 0 +SCE_NSIS_COMMENT = 1 +SCE_NSIS_STRINGDQ = 2 +SCE_NSIS_STRINGLQ = 3 +SCE_NSIS_STRINGRQ = 4 +SCE_NSIS_FUNCTION = 5 +SCE_NSIS_VARIABLE = 6 +SCE_NSIS_LABEL = 7 +SCE_NSIS_USERDEFINED = 8 +SCE_NSIS_SECTIONDEF = 9 +SCE_NSIS_SUBSECTIONDEF = 10 +SCE_NSIS_IFDEFINEDEF = 11 +SCE_NSIS_MACRODEF = 12 +SCE_NSIS_STRINGVAR = 13 +SCE_NSIS_NUMBER = 14 +SCE_NSIS_SECTIONGROUP = 15 +SCE_NSIS_PAGEEX = 16 +SCE_NSIS_FUNCTIONDEF = 17 +SCE_NSIS_COMMENTBOX = 18 +SCE_MMIXAL_LEADWS = 0 +SCE_MMIXAL_COMMENT = 1 +SCE_MMIXAL_LABEL = 2 +SCE_MMIXAL_OPCODE = 3 +SCE_MMIXAL_OPCODE_PRE = 4 +SCE_MMIXAL_OPCODE_VALID = 5 +SCE_MMIXAL_OPCODE_UNKNOWN = 6 +SCE_MMIXAL_OPCODE_POST = 7 +SCE_MMIXAL_OPERANDS = 8 +SCE_MMIXAL_NUMBER = 9 +SCE_MMIXAL_REF = 10 +SCE_MMIXAL_CHAR = 11 +SCE_MMIXAL_STRING = 12 +SCE_MMIXAL_REGISTER = 13 +SCE_MMIXAL_HEX = 14 +SCE_MMIXAL_OPERATOR = 15 +SCE_MMIXAL_SYMBOL = 16 +SCE_MMIXAL_INCLUDE = 17 +SCE_CLW_DEFAULT = 0 +SCE_CLW_LABEL = 1 +SCE_CLW_COMMENT = 2 +SCE_CLW_STRING = 3 +SCE_CLW_USER_IDENTIFIER = 4 +SCE_CLW_INTEGER_CONSTANT = 5 +SCE_CLW_REAL_CONSTANT = 6 +SCE_CLW_PICTURE_STRING = 7 +SCE_CLW_KEYWORD = 8 +SCE_CLW_COMPILER_DIRECTIVE = 9 +SCE_CLW_RUNTIME_EXPRESSIONS = 10 +SCE_CLW_BUILTIN_PROCEDURES_FUNCTION = 11 +SCE_CLW_STRUCTURE_DATA_TYPE = 12 +SCE_CLW_ATTRIBUTE = 13 +SCE_CLW_STANDARD_EQUATE = 14 +SCE_CLW_ERROR = 15 +SCE_CLW_DEPRECATED = 16 +SCE_LOT_DEFAULT = 0 +SCE_LOT_HEADER = 1 +SCE_LOT_BREAK = 2 +SCE_LOT_SET = 3 +SCE_LOT_PASS = 4 +SCE_LOT_FAIL = 5 +SCE_LOT_ABORT = 6 +SCE_YAML_DEFAULT = 0 +SCE_YAML_COMMENT = 1 +SCE_YAML_IDENTIFIER = 2 +SCE_YAML_KEYWORD = 3 +SCE_YAML_NUMBER = 4 +SCE_YAML_REFERENCE = 5 +SCE_YAML_DOCUMENT = 6 +SCE_YAML_TEXT = 7 +SCE_YAML_ERROR = 8 +SCE_YAML_OPERATOR = 9 +SCE_TEX_DEFAULT = 0 +SCE_TEX_SPECIAL = 1 +SCE_TEX_GROUP = 2 +SCE_TEX_SYMBOL = 3 +SCE_TEX_COMMAND = 4 +SCE_TEX_TEXT = 5 +SCE_METAPOST_DEFAULT = 0 +SCE_METAPOST_SPECIAL = 1 +SCE_METAPOST_GROUP = 2 +SCE_METAPOST_SYMBOL = 3 +SCE_METAPOST_COMMAND = 4 +SCE_METAPOST_TEXT = 5 +SCE_METAPOST_EXTRA = 6 +SCE_ERLANG_DEFAULT = 0 +SCE_ERLANG_COMMENT = 1 +SCE_ERLANG_VARIABLE = 2 +SCE_ERLANG_NUMBER = 3 +SCE_ERLANG_KEYWORD = 4 +SCE_ERLANG_STRING = 5 +SCE_ERLANG_OPERATOR = 6 +SCE_ERLANG_ATOM = 7 +SCE_ERLANG_FUNCTION_NAME = 8 +SCE_ERLANG_CHARACTER = 9 +SCE_ERLANG_MACRO = 10 +SCE_ERLANG_RECORD = 11 +SCE_ERLANG_SEPARATOR = 12 +SCE_ERLANG_NODE_NAME = 13 +SCE_ERLANG_UNKNOWN = 31 +SCE_MSSQL_DEFAULT = 0 +SCE_MSSQL_COMMENT = 1 +SCE_MSSQL_LINE_COMMENT = 2 +SCE_MSSQL_NUMBER = 3 +SCE_MSSQL_STRING = 4 +SCE_MSSQL_OPERATOR = 5 +SCE_MSSQL_IDENTIFIER = 6 +SCE_MSSQL_VARIABLE = 7 +SCE_MSSQL_COLUMN_NAME = 8 +SCE_MSSQL_STATEMENT = 9 +SCE_MSSQL_DATATYPE = 10 +SCE_MSSQL_SYSTABLE = 11 +SCE_MSSQL_GLOBAL_VARIABLE = 12 +SCE_MSSQL_FUNCTION = 13 +SCE_MSSQL_STORED_PROCEDURE = 14 +SCE_MSSQL_DEFAULT_PREF_DATATYPE = 15 +SCE_MSSQL_COLUMN_NAME_2 = 16 +SCE_V_DEFAULT = 0 +SCE_V_COMMENT = 1 +SCE_V_COMMENTLINE = 2 +SCE_V_COMMENTLINEBANG = 3 +SCE_V_NUMBER = 4 +SCE_V_WORD = 5 +SCE_V_STRING = 6 +SCE_V_WORD2 = 7 +SCE_V_WORD3 = 8 +SCE_V_PREPROCESSOR = 9 +SCE_V_OPERATOR = 10 +SCE_V_IDENTIFIER = 11 +SCE_V_STRINGEOL = 12 +SCE_V_USER = 19 +SCE_KIX_DEFAULT = 0 +SCE_KIX_COMMENT = 1 +SCE_KIX_STRING1 = 2 +SCE_KIX_STRING2 = 3 +SCE_KIX_NUMBER = 4 +SCE_KIX_VAR = 5 +SCE_KIX_MACRO = 6 +SCE_KIX_KEYWORD = 7 +SCE_KIX_FUNCTIONS = 8 +SCE_KIX_OPERATOR = 9 +SCE_KIX_IDENTIFIER = 31 +SCE_GC_DEFAULT = 0 +SCE_GC_COMMENTLINE = 1 +SCE_GC_COMMENTBLOCK = 2 +SCE_GC_GLOBAL = 3 +SCE_GC_EVENT = 4 +SCE_GC_ATTRIBUTE = 5 +SCE_GC_CONTROL = 6 +SCE_GC_COMMAND = 7 +SCE_GC_STRING = 8 +SCE_GC_OPERATOR = 9 +SCE_SN_DEFAULT = 0 +SCE_SN_CODE = 1 +SCE_SN_COMMENTLINE = 2 +SCE_SN_COMMENTLINEBANG = 3 +SCE_SN_NUMBER = 4 +SCE_SN_WORD = 5 +SCE_SN_STRING = 6 +SCE_SN_WORD2 = 7 +SCE_SN_WORD3 = 8 +SCE_SN_PREPROCESSOR = 9 +SCE_SN_OPERATOR = 10 +SCE_SN_IDENTIFIER = 11 +SCE_SN_STRINGEOL = 12 +SCE_SN_REGEXTAG = 13 +SCE_SN_SIGNAL = 14 +SCE_SN_USER = 19 +SCE_AU3_DEFAULT = 0 +SCE_AU3_COMMENT = 1 +SCE_AU3_COMMENTBLOCK = 2 +SCE_AU3_NUMBER = 3 +SCE_AU3_FUNCTION = 4 +SCE_AU3_KEYWORD = 5 +SCE_AU3_MACRO = 6 +SCE_AU3_STRING = 7 +SCE_AU3_OPERATOR = 8 +SCE_AU3_VARIABLE = 9 +SCE_AU3_SENT = 10 +SCE_AU3_PREPROCESSOR = 11 +SCE_AU3_SPECIAL = 12 +SCE_AU3_EXPAND = 13 +SCE_AU3_COMOBJ = 14 +SCE_AU3_UDF = 15 +SCE_APDL_DEFAULT = 0 +SCE_APDL_COMMENT = 1 +SCE_APDL_COMMENTBLOCK = 2 +SCE_APDL_NUMBER = 3 +SCE_APDL_STRING = 4 +SCE_APDL_OPERATOR = 5 +SCE_APDL_WORD = 6 +SCE_APDL_PROCESSOR = 7 +SCE_APDL_COMMAND = 8 +SCE_APDL_SLASHCOMMAND = 9 +SCE_APDL_STARCOMMAND = 10 +SCE_APDL_ARGUMENT = 11 +SCE_APDL_FUNCTION = 12 +SCE_SH_DEFAULT = 0 +SCE_SH_ERROR = 1 +SCE_SH_COMMENTLINE = 2 +SCE_SH_NUMBER = 3 +SCE_SH_WORD = 4 +SCE_SH_STRING = 5 +SCE_SH_CHARACTER = 6 +SCE_SH_OPERATOR = 7 +SCE_SH_IDENTIFIER = 8 +SCE_SH_SCALAR = 9 +SCE_SH_PARAM = 10 +SCE_SH_BACKTICKS = 11 +SCE_SH_HERE_DELIM = 12 +SCE_SH_HERE_Q = 13 +SCE_ASN1_DEFAULT = 0 +SCE_ASN1_COMMENT = 1 +SCE_ASN1_IDENTIFIER = 2 +SCE_ASN1_STRING = 3 +SCE_ASN1_OID = 4 +SCE_ASN1_SCALAR = 5 +SCE_ASN1_KEYWORD = 6 +SCE_ASN1_ATTRIBUTE = 7 +SCE_ASN1_DESCRIPTOR = 8 +SCE_ASN1_TYPE = 9 +SCE_ASN1_OPERATOR = 10 +SCE_VHDL_DEFAULT = 0 +SCE_VHDL_COMMENT = 1 +SCE_VHDL_COMMENTLINEBANG = 2 +SCE_VHDL_NUMBER = 3 +SCE_VHDL_STRING = 4 +SCE_VHDL_OPERATOR = 5 +SCE_VHDL_IDENTIFIER = 6 +SCE_VHDL_STRINGEOL = 7 +SCE_VHDL_KEYWORD = 8 +SCE_VHDL_STDOPERATOR = 9 +SCE_VHDL_ATTRIBUTE = 10 +SCE_VHDL_STDFUNCTION = 11 +SCE_VHDL_STDPACKAGE = 12 +SCE_VHDL_STDTYPE = 13 +SCE_VHDL_USERWORD = 14 +SCE_CAML_DEFAULT = 0 +SCE_CAML_IDENTIFIER = 1 +SCE_CAML_TAGNAME = 2 +SCE_CAML_KEYWORD = 3 +SCE_CAML_KEYWORD2 = 4 +SCE_CAML_KEYWORD3 = 5 +SCE_CAML_LINENUM = 6 +SCE_CAML_OPERATOR = 7 +SCE_CAML_NUMBER = 8 +SCE_CAML_CHAR = 9 +SCE_CAML_STRING = 11 +SCE_CAML_COMMENT = 12 +SCE_CAML_COMMENT1 = 13 +SCE_CAML_COMMENT2 = 14 +SCE_CAML_COMMENT3 = 15 +SCE_HA_DEFAULT = 0 +SCE_HA_IDENTIFIER = 1 +SCE_HA_KEYWORD = 2 +SCE_HA_NUMBER = 3 +SCE_HA_STRING = 4 +SCE_HA_CHARACTER = 5 +SCE_HA_CLASS = 6 +SCE_HA_MODULE = 7 +SCE_HA_CAPITAL = 8 +SCE_HA_DATA = 9 +SCE_HA_IMPORT = 10 +SCE_HA_OPERATOR = 11 +SCE_HA_INSTANCE = 12 +SCE_HA_COMMENTLINE = 13 +SCE_HA_COMMENTBLOCK = 14 +SCE_HA_COMMENTBLOCK2 = 15 +SCE_HA_COMMENTBLOCK3 = 16 +SCE_T3_DEFAULT = 0 +SCE_T3_X_DEFAULT = 1 +SCE_T3_PREPROCESSOR = 2 +SCE_T3_BLOCK_COMMENT = 3 +SCE_T3_LINE_COMMENT = 4 +SCE_T3_OPERATOR = 5 +SCE_T3_KEYWORD = 6 +SCE_T3_NUMBER = 7 +SCE_T3_IDENTIFIER = 8 +SCE_T3_S_STRING = 9 +SCE_T3_D_STRING = 10 +SCE_T3_X_STRING = 11 +SCE_T3_LIB_DIRECTIVE = 12 +SCE_T3_MSG_PARAM = 13 +SCE_T3_HTML_TAG = 14 +SCE_T3_HTML_DEFAULT = 15 +SCE_T3_HTML_STRING = 16 +SCE_T3_USER1 = 17 +SCE_T3_USER2 = 18 +SCE_T3_USER3 = 19 +SCE_T3_BRACE = 20 +SCE_REBOL_DEFAULT = 0 +SCE_REBOL_COMMENTLINE = 1 +SCE_REBOL_COMMENTBLOCK = 2 +SCE_REBOL_PREFACE = 3 +SCE_REBOL_OPERATOR = 4 +SCE_REBOL_CHARACTER = 5 +SCE_REBOL_QUOTEDSTRING = 6 +SCE_REBOL_BRACEDSTRING = 7 +SCE_REBOL_NUMBER = 8 +SCE_REBOL_PAIR = 9 +SCE_REBOL_TUPLE = 10 +SCE_REBOL_BINARY = 11 +SCE_REBOL_MONEY = 12 +SCE_REBOL_ISSUE = 13 +SCE_REBOL_TAG = 14 +SCE_REBOL_FILE = 15 +SCE_REBOL_EMAIL = 16 +SCE_REBOL_URL = 17 +SCE_REBOL_DATE = 18 +SCE_REBOL_TIME = 19 +SCE_REBOL_IDENTIFIER = 20 +SCE_REBOL_WORD = 21 +SCE_REBOL_WORD2 = 22 +SCE_REBOL_WORD3 = 23 +SCE_REBOL_WORD4 = 24 +SCE_REBOL_WORD5 = 25 +SCE_REBOL_WORD6 = 26 +SCE_REBOL_WORD7 = 27 +SCE_REBOL_WORD8 = 28 +SCE_SQL_DEFAULT = 0 +SCE_SQL_COMMENT = 1 +SCE_SQL_COMMENTLINE = 2 +SCE_SQL_COMMENTDOC = 3 +SCE_SQL_NUMBER = 4 +SCE_SQL_WORD = 5 +SCE_SQL_STRING = 6 +SCE_SQL_CHARACTER = 7 +SCE_SQL_SQLPLUS = 8 +SCE_SQL_SQLPLUS_PROMPT = 9 +SCE_SQL_OPERATOR = 10 +SCE_SQL_IDENTIFIER = 11 +SCE_SQL_SQLPLUS_COMMENT = 13 +SCE_SQL_COMMENTLINEDOC = 15 +SCE_SQL_WORD2 = 16 +SCE_SQL_COMMENTDOCKEYWORD = 17 +SCE_SQL_COMMENTDOCKEYWORDERROR = 18 +SCE_SQL_USER1 = 19 +SCE_SQL_USER2 = 20 +SCE_SQL_USER3 = 21 +SCE_SQL_USER4 = 22 +SCE_SQL_QUOTEDIDENTIFIER = 23 +SCE_ST_DEFAULT = 0 +SCE_ST_STRING = 1 +SCE_ST_NUMBER = 2 +SCE_ST_COMMENT = 3 +SCE_ST_SYMBOL = 4 +SCE_ST_BINARY = 5 +SCE_ST_BOOL = 6 +SCE_ST_SELF = 7 +SCE_ST_SUPER = 8 +SCE_ST_NIL = 9 +SCE_ST_GLOBAL = 10 +SCE_ST_RETURN = 11 +SCE_ST_SPECIAL = 12 +SCE_ST_KWSEND = 13 +SCE_ST_ASSIGN = 14 +SCE_ST_CHARACTER = 15 +SCE_ST_SPEC_SEL = 16 +SCE_FS_DEFAULT = 0 +SCE_FS_COMMENT = 1 +SCE_FS_COMMENTLINE = 2 +SCE_FS_COMMENTDOC = 3 +SCE_FS_COMMENTLINEDOC = 4 +SCE_FS_COMMENTDOCKEYWORD = 5 +SCE_FS_COMMENTDOCKEYWORDERROR = 6 +SCE_FS_KEYWORD = 7 +SCE_FS_KEYWORD2 = 8 +SCE_FS_KEYWORD3 = 9 +SCE_FS_KEYWORD4 = 10 +SCE_FS_NUMBER = 11 +SCE_FS_STRING = 12 +SCE_FS_PREPROCESSOR = 13 +SCE_FS_OPERATOR = 14 +SCE_FS_IDENTIFIER = 15 +SCE_FS_DATE = 16 +SCE_FS_STRINGEOL = 17 +SCE_FS_CONSTANT = 18 +SCE_FS_ASM = 19 +SCE_FS_LABEL = 20 +SCE_FS_ERROR = 21 +SCE_FS_HEXNUMBER = 22 +SCE_FS_BINNUMBER = 23 +SCE_CSOUND_DEFAULT = 0 +SCE_CSOUND_COMMENT = 1 +SCE_CSOUND_NUMBER = 2 +SCE_CSOUND_OPERATOR = 3 +SCE_CSOUND_INSTR = 4 +SCE_CSOUND_IDENTIFIER = 5 +SCE_CSOUND_OPCODE = 6 +SCE_CSOUND_HEADERSTMT = 7 +SCE_CSOUND_USERKEYWORD = 8 +SCE_CSOUND_COMMENTBLOCK = 9 +SCE_CSOUND_PARAM = 10 +SCE_CSOUND_ARATE_VAR = 11 +SCE_CSOUND_KRATE_VAR = 12 +SCE_CSOUND_IRATE_VAR = 13 +SCE_CSOUND_GLOBAL_VAR = 14 +SCE_CSOUND_STRINGEOL = 15 +SCE_INNO_DEFAULT = 0 +SCE_INNO_COMMENT = 1 +SCE_INNO_KEYWORD = 2 +SCE_INNO_PARAMETER = 3 +SCE_INNO_SECTION = 4 +SCE_INNO_PREPROC = 5 +SCE_INNO_PREPROC_INLINE = 6 +SCE_INNO_COMMENT_PASCAL = 7 +SCE_INNO_KEYWORD_PASCAL = 8 +SCE_INNO_KEYWORD_USER = 9 +SCE_INNO_STRING_DOUBLE = 10 +SCE_INNO_STRING_SINGLE = 11 +SCE_INNO_IDENTIFIER = 12 +SCE_OPAL_SPACE = 0 +SCE_OPAL_COMMENT_BLOCK = 1 +SCE_OPAL_COMMENT_LINE = 2 +SCE_OPAL_INTEGER = 3 +SCE_OPAL_KEYWORD = 4 +SCE_OPAL_SORT = 5 +SCE_OPAL_STRING = 6 +SCE_OPAL_PAR = 7 +SCE_OPAL_BOOL_CONST = 8 +SCE_OPAL_DEFAULT = 32 +SCE_SPICE_DEFAULT = 0 +SCE_SPICE_IDENTIFIER = 1 +SCE_SPICE_KEYWORD = 2 +SCE_SPICE_KEYWORD2 = 3 +SCE_SPICE_KEYWORD3 = 4 +SCE_SPICE_NUMBER = 5 +SCE_SPICE_DELIMITER = 6 +SCE_SPICE_VALUE = 7 +SCE_SPICE_COMMENTLINE = 8 +SCE_CMAKE_DEFAULT = 0 +SCE_CMAKE_COMMENT = 1 +SCE_CMAKE_STRINGDQ = 2 +SCE_CMAKE_STRINGLQ = 3 +SCE_CMAKE_STRINGRQ = 4 +SCE_CMAKE_COMMANDS = 5 +SCE_CMAKE_PARAMETERS = 6 +SCE_CMAKE_VARIABLE = 7 +SCE_CMAKE_USERDEFINED = 8 +SCE_CMAKE_WHILEDEF = 9 +SCE_CMAKE_FOREACHDEF = 10 +SCE_CMAKE_IFDEFINEDEF = 11 +SCE_CMAKE_MACRODEF = 12 +SCE_CMAKE_STRINGVAR = 13 +SCE_CMAKE_NUMBER = 14 +SCE_GAP_DEFAULT = 0 +SCE_GAP_IDENTIFIER = 1 +SCE_GAP_KEYWORD = 2 +SCE_GAP_KEYWORD2 = 3 +SCE_GAP_KEYWORD3 = 4 +SCE_GAP_KEYWORD4 = 5 +SCE_GAP_STRING = 6 +SCE_GAP_CHAR = 7 +SCE_GAP_OPERATOR = 8 +SCE_GAP_COMMENT = 9 +SCE_GAP_NUMBER = 10 +SCE_GAP_STRINGEOL = 11 +SCE_PLM_DEFAULT = 0 +SCE_PLM_COMMENT = 1 +SCE_PLM_STRING = 2 +SCE_PLM_NUMBER = 3 +SCE_PLM_IDENTIFIER = 4 +SCE_PLM_OPERATOR = 5 +SCE_PLM_CONTROL = 6 +SCE_PLM_KEYWORD = 7 +SCE_4GL_DEFAULT = 0 +SCE_4GL_NUMBER = 1 +SCE_4GL_WORD = 2 +SCE_4GL_STRING = 3 +SCE_4GL_CHARACTER = 4 +SCE_4GL_PREPROCESSOR = 5 +SCE_4GL_OPERATOR = 6 +SCE_4GL_IDENTIFIER = 7 +SCE_4GL_BLOCK = 8 +SCE_4GL_END = 9 +SCE_4GL_COMMENT1 = 10 +SCE_4GL_COMMENT2 = 11 +SCE_4GL_COMMENT3 = 12 +SCE_4GL_COMMENT4 = 13 +SCE_4GL_COMMENT5 = 14 +SCE_4GL_COMMENT6 = 15 +SCE_4GL_DEFAULT_ = 16 +SCE_4GL_NUMBER_ = 17 +SCE_4GL_WORD_ = 18 +SCE_4GL_STRING_ = 19 +SCE_4GL_CHARACTER_ = 20 +SCE_4GL_PREPROCESSOR_ = 21 +SCE_4GL_OPERATOR_ = 22 +SCE_4GL_IDENTIFIER_ = 23 +SCE_4GL_BLOCK_ = 24 +SCE_4GL_END_ = 25 +SCE_4GL_COMMENT1_ = 26 +SCE_4GL_COMMENT2_ = 27 +SCE_4GL_COMMENT3_ = 28 +SCE_4GL_COMMENT4_ = 29 +SCE_4GL_COMMENT5_ = 30 +SCE_4GL_COMMENT6_ = 31 +SCE_ABAQUS_DEFAULT = 0 +SCE_ABAQUS_COMMENT = 1 +SCE_ABAQUS_COMMENTBLOCK = 2 +SCE_ABAQUS_NUMBER = 3 +SCE_ABAQUS_STRING = 4 +SCE_ABAQUS_OPERATOR = 5 +SCE_ABAQUS_WORD = 6 +SCE_ABAQUS_PROCESSOR = 7 +SCE_ABAQUS_COMMAND = 8 +SCE_ABAQUS_SLASHCOMMAND = 9 +SCE_ABAQUS_STARCOMMAND = 10 +SCE_ABAQUS_ARGUMENT = 11 +SCE_ABAQUS_FUNCTION = 12 +SCE_ASY_DEFAULT = 0 +SCE_ASY_COMMENT = 1 +SCE_ASY_COMMENTLINE = 2 +SCE_ASY_NUMBER = 3 +SCE_ASY_WORD = 4 +SCE_ASY_STRING = 5 +SCE_ASY_CHARACTER = 6 +SCE_ASY_OPERATOR = 7 +SCE_ASY_IDENTIFIER = 8 +SCE_ASY_STRINGEOL = 9 +SCE_ASY_COMMENTLINEDOC = 10 +SCE_ASY_WORD2 = 11 +SCE_R_DEFAULT = 0 +SCE_R_COMMENT = 1 +SCE_R_KWORD = 2 +SCE_R_BASEKWORD = 3 +SCE_R_OTHERKWORD = 4 +SCE_R_NUMBER = 5 +SCE_R_STRING = 6 +SCE_R_STRING2 = 7 +SCE_R_OPERATOR = 8 +SCE_R_IDENTIFIER = 9 +SCE_R_INFIX = 10 +SCE_R_INFIXEOL = 11 +SCE_MAGIK_DEFAULT = 0 +SCE_MAGIK_COMMENT = 1 +SCE_MAGIK_HYPER_COMMENT = 16 +SCE_MAGIK_STRING = 2 +SCE_MAGIK_CHARACTER = 3 +SCE_MAGIK_NUMBER = 4 +SCE_MAGIK_IDENTIFIER = 5 +SCE_MAGIK_OPERATOR = 6 +SCE_MAGIK_FLOW = 7 +SCE_MAGIK_CONTAINER = 8 +SCE_MAGIK_BRACKET_BLOCK = 9 +SCE_MAGIK_BRACE_BLOCK = 10 +SCE_MAGIK_SQBRACKET_BLOCK = 11 +SCE_MAGIK_UNKNOWN_KEYWORD = 12 +SCE_MAGIK_KEYWORD = 13 +SCE_MAGIK_PRAGMA = 14 +SCE_MAGIK_SYMBOL = 15 +SCE_POWERSHELL_DEFAULT = 0 +SCE_POWERSHELL_COMMENT = 1 +SCE_POWERSHELL_STRING = 2 +SCE_POWERSHELL_CHARACTER = 3 +SCE_POWERSHELL_NUMBER = 4 +SCE_POWERSHELL_VARIABLE = 5 +SCE_POWERSHELL_OPERATOR = 6 +SCE_POWERSHELL_IDENTIFIER = 7 +SCE_POWERSHELL_KEYWORD = 8 +SCE_POWERSHELL_CMDLET = 9 +SCE_POWERSHELL_ALIAS = 10 +SCE_MYSQL_DEFAULT = 0 +SCE_MYSQL_COMMENT = 1 +SCE_MYSQL_COMMENTLINE = 2 +SCE_MYSQL_VARIABLE = 3 +SCE_MYSQL_SYSTEMVARIABLE = 4 +SCE_MYSQL_KNOWNSYSTEMVARIABLE = 5 +SCE_MYSQL_NUMBER = 6 +SCE_MYSQL_MAJORKEYWORD = 7 +SCE_MYSQL_KEYWORD = 8 +SCE_MYSQL_DATABASEOBJECT = 9 +SCE_MYSQL_PROCEDUREKEYWORD = 10 +SCE_MYSQL_STRING = 11 +SCE_MYSQL_SQSTRING = 12 +SCE_MYSQL_DQSTRING = 13 +SCE_MYSQL_OPERATOR = 14 +SCE_MYSQL_FUNCTION = 15 +SCE_MYSQL_IDENTIFIER = 16 +SCE_MYSQL_QUOTEDIDENTIFIER = 17 +SCE_MYSQL_USER1 = 18 +SCE_MYSQL_USER2 = 19 +SCE_MYSQL_USER3 = 20 +SCE_PO_DEFAULT = 0 +SCE_PO_COMMENT = 1 +SCE_PO_MSGID = 2 +SCE_PO_MSGID_TEXT = 3 +SCE_PO_MSGSTR = 4 +SCE_PO_MSGSTR_TEXT = 5 +SCE_PO_MSGCTXT = 6 +SCE_PO_MSGCTXT_TEXT = 7 +SCE_PO_FUZZY = 8 +SCLEX_ASP = 29 +SCLEX_PHP = 30 diff --git a/lib/pythonwin/pywin/scintilla/view.py b/lib/pythonwin/pywin/scintilla/view.py new file mode 100644 index 00000000..3783666f --- /dev/null +++ b/lib/pythonwin/pywin/scintilla/view.py @@ -0,0 +1,832 @@ +# A general purpose MFC CCtrlView view that uses Scintilla. + +import array +import os +import re +import string +import struct +import sys + +import __main__ # for attribute lookup +import afxres +import win32con +import win32ui +from pywin.mfc import dialog, docview + +from . import IDLEenvironment # IDLE emulation. +from . import bindings, control, keycodes, scintillacon + +PRINTDLGORD = 1538 +IDC_PRINT_MAG_EDIT = 1010 +EM_FORMATRANGE = win32con.WM_USER + 57 + +wordbreaks = "._" + string.ascii_uppercase + string.ascii_lowercase + string.digits + +patImport = re.compile("import (?P.*)") + +_event_commands = [ + # File menu + "win32ui.ID_FILE_LOCATE", + "win32ui.ID_FILE_CHECK", + "afxres.ID_FILE_CLOSE", + "afxres.ID_FILE_NEW", + "afxres.ID_FILE_OPEN", + "afxres.ID_FILE_SAVE", + "afxres.ID_FILE_SAVE_AS", + "win32ui.ID_FILE_SAVE_ALL", + # Edit menu + "afxres.ID_EDIT_UNDO", + "afxres.ID_EDIT_REDO", + "afxres.ID_EDIT_CUT", + "afxres.ID_EDIT_COPY", + "afxres.ID_EDIT_PASTE", + "afxres.ID_EDIT_SELECT_ALL", + "afxres.ID_EDIT_FIND", + "afxres.ID_EDIT_REPEAT", + "afxres.ID_EDIT_REPLACE", + # View menu + "win32ui.ID_VIEW_WHITESPACE", + "win32ui.ID_VIEW_FIXED_FONT", + "win32ui.ID_VIEW_BROWSE", + "win32ui.ID_VIEW_INTERACTIVE", + # Window menu + "afxres.ID_WINDOW_ARRANGE", + "afxres.ID_WINDOW_CASCADE", + "afxres.ID_WINDOW_NEW", + "afxres.ID_WINDOW_SPLIT", + "afxres.ID_WINDOW_TILE_HORZ", + "afxres.ID_WINDOW_TILE_VERT", + # Others + "afxres.ID_APP_EXIT", + "afxres.ID_APP_ABOUT", +] + +_extra_event_commands = [ + ("EditDelete", afxres.ID_EDIT_CLEAR), + ("LocateModule", win32ui.ID_FILE_LOCATE), + ("GotoLine", win32ui.ID_EDIT_GOTO_LINE), + ("DbgBreakpointToggle", win32ui.IDC_DBG_ADD), + ("DbgGo", win32ui.IDC_DBG_GO), + ("DbgStepOver", win32ui.IDC_DBG_STEPOVER), + ("DbgStep", win32ui.IDC_DBG_STEP), + ("DbgStepOut", win32ui.IDC_DBG_STEPOUT), + ("DbgBreakpointClearAll", win32ui.IDC_DBG_CLEAR), + ("DbgClose", win32ui.IDC_DBG_CLOSE), +] + +event_commands = [] + + +def _CreateEvents(): + for name in _event_commands: + val = eval(name) + name_parts = name.split("_")[1:] + name_parts = [p.capitalize() for p in name_parts] + event = "".join(name_parts) + event_commands.append((event, val)) + for name, id in _extra_event_commands: + event_commands.append((name, id)) + + +_CreateEvents() +del _event_commands +del _extra_event_commands + +command_reflectors = [ + (win32ui.ID_EDIT_UNDO, win32con.WM_UNDO), + (win32ui.ID_EDIT_REDO, scintillacon.SCI_REDO), + (win32ui.ID_EDIT_CUT, win32con.WM_CUT), + (win32ui.ID_EDIT_COPY, win32con.WM_COPY), + (win32ui.ID_EDIT_PASTE, win32con.WM_PASTE), + (win32ui.ID_EDIT_CLEAR, win32con.WM_CLEAR), + (win32ui.ID_EDIT_SELECT_ALL, scintillacon.SCI_SELECTALL), +] + + +def DoBraceMatch(control): + curPos = control.SCIGetCurrentPos() + charBefore = " " + if curPos: + charBefore = control.SCIGetCharAt(curPos - 1) + charAt = control.SCIGetCharAt(curPos) + braceAtPos = braceOpposite = -1 + if charBefore in "[](){}": + braceAtPos = curPos - 1 + if braceAtPos == -1: + if charAt in "[](){}": + braceAtPos = curPos + if braceAtPos != -1: + braceOpposite = control.SCIBraceMatch(braceAtPos, 0) + if braceAtPos != -1 and braceOpposite == -1: + control.SCIBraceBadHighlight(braceAtPos) + else: + # either clear them both or set them both. + control.SCIBraceHighlight(braceAtPos, braceOpposite) + + +def _get_class_attributes(ob): + # Recurse into base classes looking for attributes + items = [] + try: + items = items + dir(ob) + for i in ob.__bases__: + for item in _get_class_attributes(i): + if item not in items: + items.append(item) + except AttributeError: + pass + return items + + +# Supposed to look like an MFC CEditView, but +# also supports IDLE extensions and other source code generic features. +class CScintillaView(docview.CtrlView, control.CScintillaColorEditInterface): + def __init__(self, doc): + docview.CtrlView.__init__( + self, + doc, + "Scintilla", + win32con.WS_CHILD + | win32con.WS_VSCROLL + | win32con.WS_HSCROLL + | win32con.WS_CLIPCHILDREN + | win32con.WS_VISIBLE, + ) + self._tabWidth = ( + 8 # Mirror of what we send to Scintilla - never change this directly + ) + self.bAutoCompleteAttributes = 1 + self.bShowCallTips = 1 + self.bMatchBraces = 0 # Editor option will default this to true later! + self.bindings = bindings.BindingsManager(self) + + self.idle = IDLEenvironment.IDLEEditorWindow(self) + self.idle.IDLEExtension("AutoExpand") + # SendScintilla is called so frequently it is worth optimizing. + self.SendScintilla = self._obj_.SendMessage + + def _MakeColorizer(self): + ext = os.path.splitext(self.GetDocument().GetPathName())[1] + from . import formatter + + return formatter.BuiltinPythonSourceFormatter(self, ext) + + # def SendScintilla(self, msg, w=0, l=0): + # return self._obj_.SendMessage(msg, w, l) + + def SCISetTabWidth(self, width): + # I need to remember the tab-width for the AutoIndent extension. This may go. + self._tabWidth = width + control.CScintillaEditInterface.SCISetTabWidth(self, width) + + def GetTabWidth(self): + return self._tabWidth + + def HookHandlers(self): + # Create events for all the menu names. + for name, val in event_commands: + # handler = lambda id, code, tosend=val, parent=parent: parent.OnCommand(tosend, 0) and 0 + self.bindings.bind(name, None, cid=val) + + # Hook commands that do nothing other than send Scintilla messages. + for command, reflection in command_reflectors: + handler = ( + lambda id, code, ss=self.SendScintilla, tosend=reflection: ss(tosend) + and 0 + ) + self.HookCommand(handler, command) + + self.HookCommand(self.OnCmdViewWS, win32ui.ID_VIEW_WHITESPACE) + self.HookCommandUpdate(self.OnUpdateViewWS, win32ui.ID_VIEW_WHITESPACE) + self.HookCommand( + self.OnCmdViewIndentationGuides, win32ui.ID_VIEW_INDENTATIONGUIDES + ) + self.HookCommandUpdate( + self.OnUpdateViewIndentationGuides, win32ui.ID_VIEW_INDENTATIONGUIDES + ) + self.HookCommand(self.OnCmdViewRightEdge, win32ui.ID_VIEW_RIGHT_EDGE) + self.HookCommandUpdate(self.OnUpdateViewRightEdge, win32ui.ID_VIEW_RIGHT_EDGE) + self.HookCommand(self.OnCmdViewEOL, win32ui.ID_VIEW_EOL) + self.HookCommandUpdate(self.OnUpdateViewEOL, win32ui.ID_VIEW_EOL) + self.HookCommand(self.OnCmdViewFixedFont, win32ui.ID_VIEW_FIXED_FONT) + self.HookCommandUpdate(self.OnUpdateViewFixedFont, win32ui.ID_VIEW_FIXED_FONT) + self.HookCommand(self.OnCmdFileLocate, win32ui.ID_FILE_LOCATE) + self.HookCommand(self.OnCmdEditFind, win32ui.ID_EDIT_FIND) + self.HookCommand(self.OnCmdEditRepeat, win32ui.ID_EDIT_REPEAT) + self.HookCommand(self.OnCmdEditReplace, win32ui.ID_EDIT_REPLACE) + self.HookCommand(self.OnCmdGotoLine, win32ui.ID_EDIT_GOTO_LINE) + self.HookCommand(self.OnFilePrint, afxres.ID_FILE_PRINT) + self.HookCommand(self.OnFilePrint, afxres.ID_FILE_PRINT_DIRECT) + self.HookCommand(self.OnFilePrintPreview, win32ui.ID_FILE_PRINT_PREVIEW) + # Key bindings. + self.HookMessage(self.OnKeyDown, win32con.WM_KEYDOWN) + self.HookMessage(self.OnKeyDown, win32con.WM_SYSKEYDOWN) + # Hook wheeley mouse events + # self.HookMessage(self.OnMouseWheel, win32con.WM_MOUSEWHEEL) + self.HookFormatter() + + def OnInitialUpdate(self): + doc = self.GetDocument() + + # Enable Unicode + self.SendScintilla(scintillacon.SCI_SETCODEPAGE, scintillacon.SC_CP_UTF8, 0) + self.SendScintilla(scintillacon.SCI_SETKEYSUNICODE, 1, 0) + + # Create margins + self.SendScintilla( + scintillacon.SCI_SETMARGINTYPEN, 1, scintillacon.SC_MARGIN_SYMBOL + ) + self.SendScintilla(scintillacon.SCI_SETMARGINMASKN, 1, 0xF) + self.SendScintilla( + scintillacon.SCI_SETMARGINTYPEN, 2, scintillacon.SC_MARGIN_SYMBOL + ) + self.SendScintilla( + scintillacon.SCI_SETMARGINMASKN, 2, scintillacon.SC_MASK_FOLDERS + ) + self.SendScintilla(scintillacon.SCI_SETMARGINSENSITIVEN, 2, 1) + + self.GetDocument().HookViewNotifications( + self + ) # is there an MFC way to grab this? + self.HookHandlers() + + # Load the configuration information. + self.OnWinIniChange(None) + + self.SetSel() + + self.GetDocument().FinalizeViewCreation( + self + ) # is there an MFC way to grab this? + + def _GetSubConfigNames(self): + return None # By default we use only sections without sub-sections. + + def OnWinIniChange(self, section=None): + self.bindings.prepare_configure() + try: + self.DoConfigChange() + finally: + self.bindings.complete_configure() + + def DoConfigChange(self): + # Bit of a hack I dont kow what to do about - these should be "editor options" + from pywin.framework.editor import GetEditorOption + + self.bAutoCompleteAttributes = GetEditorOption("Autocomplete Attributes", 1) + self.bShowCallTips = GetEditorOption("Show Call Tips", 1) + # Update the key map and extension data. + configManager.configure(self, self._GetSubConfigNames()) + if configManager.last_error: + win32ui.MessageBox(configManager.last_error, "Configuration Error") + self.bMatchBraces = GetEditorOption("Match Braces", 1) + self.ApplyFormattingStyles(1) + + def OnDestroy(self, msg): + self.bindings.close() + self.bindings = None + self.idle.close() + self.idle = None + control.CScintillaColorEditInterface.close(self) + return docview.CtrlView.OnDestroy(self, msg) + + def OnMouseWheel(self, msg): + zDelta = msg[2] >> 16 + vpos = self.GetScrollPos(win32con.SB_VERT) + vpos = vpos - zDelta / 40 # 3 lines per notch + self.SetScrollPos(win32con.SB_VERT, vpos) + self.SendScintilla( + win32con.WM_VSCROLL, (vpos << 16) | win32con.SB_THUMBPOSITION, 0 + ) + + def OnBraceMatch(self, std, extra): + if not self.bMatchBraces: + return + DoBraceMatch(self) + + def OnNeedShown(self, std, extra): + notify = self.SCIUnpackNotifyMessage(extra) + # OnNeedShown is called before an edit operation when + # text is folded (as it is possible the text insertion will happen + # in a folded region.) As this happens _before_ the insert, + # we ignore the length (if we are at EOF, pos + length may + # actually be beyond the end of buffer) + self.EnsureCharsVisible(notify.position) + + def EnsureCharsVisible(self, start, end=None): + if end is None: + end = start + lineStart = self.LineFromChar(min(start, end)) + lineEnd = self.LineFromChar(max(start, end)) + while lineStart <= lineEnd: + self.SCIEnsureVisible(lineStart) + lineStart = lineStart + 1 + + # Helper to add an event to a menu. + def AppendMenu(self, menu, text="", event=None, flags=None, checked=0): + if event is None: + assert flags is not None, "No event or custom flags!" + cmdid = 0 + else: + cmdid = self.bindings.get_command_id(event) + if cmdid is None: + # No event of that name - no point displaying it. + print( + 'View.AppendMenu(): Unknown event "%s" specified for menu text "%s" - ignored' + % (event, text) + ) + return + keyname = configManager.get_key_binding(event, self._GetSubConfigNames()) + if keyname is not None: + text = text + "\t" + keyname + if flags is None: + flags = win32con.MF_STRING | win32con.MF_ENABLED + if checked: + flags = flags | win32con.MF_CHECKED + menu.AppendMenu(flags, cmdid, text) + + def OnKeyDown(self, msg): + return self.bindings.fire_key_event(msg) + + def GotoEndOfFileEvent(self, event): + self.SetSel(-1) + + def KeyDotEvent(self, event): + ## Don't trigger autocomplete if any text is selected + s, e = self.GetSel() + if s != e: + return 1 + self.SCIAddText(".") + if self.bAutoCompleteAttributes: + self._AutoComplete() + + # View Whitespace/EOL/Indentation UI. + + def OnCmdViewWS(self, cmd, code): # Handle the menu command + viewWS = self.SCIGetViewWS() + self.SCISetViewWS(not viewWS) + + def OnUpdateViewWS(self, cmdui): # Update the tick on the UI. + cmdui.SetCheck(self.SCIGetViewWS()) + cmdui.Enable() + + def OnCmdViewIndentationGuides(self, cmd, code): # Handle the menu command + viewIG = self.SCIGetIndentationGuides() + self.SCISetIndentationGuides(not viewIG) + + def OnUpdateViewIndentationGuides(self, cmdui): # Update the tick on the UI. + cmdui.SetCheck(self.SCIGetIndentationGuides()) + cmdui.Enable() + + def OnCmdViewRightEdge(self, cmd, code): # Handle the menu command + if self.SCIGetEdgeMode() == scintillacon.EDGE_NONE: + mode = scintillacon.EDGE_BACKGROUND + else: + mode = scintillacon.EDGE_NONE + self.SCISetEdgeMode(mode) + + def OnUpdateViewRightEdge(self, cmdui): # Update the tick on the UI. + cmdui.SetCheck(self.SCIGetEdgeMode() != scintillacon.EDGE_NONE) + cmdui.Enable() + + def OnCmdViewEOL(self, cmd, code): # Handle the menu command + viewEOL = self.SCIGetViewEOL() + self.SCISetViewEOL(not viewEOL) + + def OnUpdateViewEOL(self, cmdui): # Update the tick on the UI. + cmdui.SetCheck(self.SCIGetViewEOL()) + cmdui.Enable() + + def OnCmdViewFixedFont(self, cmd, code): # Handle the menu command + self._GetColorizer().bUseFixed = not self._GetColorizer().bUseFixed + self.ApplyFormattingStyles(0) + # Ensure the selection is visible! + self.ScrollCaret() + + def OnUpdateViewFixedFont(self, cmdui): # Update the tick on the UI. + c = self._GetColorizer() + if c is not None: + cmdui.SetCheck(c.bUseFixed) + cmdui.Enable(c is not None) + + def OnCmdEditFind(self, cmd, code): + from . import find + + find.ShowFindDialog() + + def OnCmdEditRepeat(self, cmd, code): + from . import find + + find.FindNext() + + def OnCmdEditReplace(self, cmd, code): + from . import find + + find.ShowReplaceDialog() + + def OnCmdFileLocate(self, cmd, id): + line = self.GetLine().strip() + import pywin.framework.scriptutils + + m = patImport.match(line) + if m: + # Module name on this line - locate that! + modName = m.group("name") + fileName = pywin.framework.scriptutils.LocatePythonFile(modName) + if fileName is None: + win32ui.SetStatusText("Can't locate module %s" % modName) + return 1 # Let the default get it. + else: + win32ui.GetApp().OpenDocumentFile(fileName) + else: + # Just to a "normal" locate - let the default handler get it. + return 1 + return 0 + + def OnCmdGotoLine(self, cmd, id): + try: + lineNo = int(input("Enter Line Number")) - 1 + except (ValueError, KeyboardInterrupt): + return 0 + self.SCIEnsureVisible(lineNo) + self.SCIGotoLine(lineNo) + return 0 + + def SaveTextFile(self, filename, encoding=None): + doc = self.GetDocument() + doc._SaveTextToFile(self, filename, encoding=encoding) + doc.SetModifiedFlag(0) + return 1 + + def _AutoComplete(self): + def list2dict(l): + ret = {} + for i in l: + ret[i] = None + return ret + + self.SCIAutoCCancel() # Cancel old auto-complete lists. + # First try and get an object without evaluating calls + ob = self._GetObjectAtPos(bAllowCalls=0) + # If that failed, try and process call or indexing to get the object. + if ob is None: + ob = self._GetObjectAtPos(bAllowCalls=1) + items_dict = {} + if ob is not None: + try: # Catch unexpected errors when fetching attribute names from the object + # extra attributes of win32ui objects + if hasattr(ob, "_obj_"): + try: + items_dict.update(list2dict(dir(ob._obj_))) + except AttributeError: + pass # object has no __dict__ + + # normal attributes + try: + items_dict.update(list2dict(dir(ob))) + except AttributeError: + pass # object has no __dict__ + if hasattr(ob, "__class__"): + items_dict.update(list2dict(_get_class_attributes(ob.__class__))) + # The object may be a COM object with typelib support - lets see if we can get its props. + # (contributed by Stefan Migowsky) + try: + # Get the automation attributes + items_dict.update(ob.__class__._prop_map_get_) + # See if there is an write only property + # could be optimized + items_dict.update(ob.__class__._prop_map_put_) + # append to the already evaluated list + except AttributeError: + pass + # The object might be a pure COM dynamic dispatch with typelib support - lets see if we can get its props. + if hasattr(ob, "_oleobj_"): + try: + for iTI in range(0, ob._oleobj_.GetTypeInfoCount()): + typeInfo = ob._oleobj_.GetTypeInfo(iTI) + self._UpdateWithITypeInfo(items_dict, typeInfo) + except: + pass + except: + win32ui.SetStatusText( + "Error attempting to get object attributes - %s" + % (repr(sys.exc_info()[0]),) + ) + + # ensure all keys are strings. + items = [str(k) for k in items_dict.keys()] + # All names that start with "_" go! + items = [k for k in items if not k.startswith("_")] + + if not items: + # Heuristics a-la AutoExpand + # The idea is to find other usages of the current binding + # and assume, that it refers to the same object (or at least, + # to an object of the same type) + # Contributed by Vadim Chugunov [vadimch@yahoo.com] + left, right = self._GetWordSplit() + if left == "": # Ignore standalone dots + return None + # We limit our search to the current class, if that + # information is available + minline, maxline, curclass = self._GetClassInfoFromBrowser() + endpos = self.LineIndex(maxline) + text = self.GetTextRange(self.LineIndex(minline), endpos) + try: + l = re.findall(r"\b" + left + "\.\w+", text) + except re.error: + # parens etc may make an invalid RE, but this code wouldnt + # benefit even if the RE did work :-) + l = [] + prefix = len(left) + 1 + unique = {} + for li in l: + unique[li[prefix:]] = 1 + # Assuming traditional usage of self... + if curclass and left == "self": + self._UpdateWithClassMethods(unique, curclass) + + items = [ + word for word in unique.keys() if word[:2] != "__" or word[-2:] != "__" + ] + # Ignore the word currently to the right of the dot - probably a red-herring. + try: + items.remove(right[1:]) + except ValueError: + pass + if items: + items.sort() + self.SCIAutoCSetAutoHide(0) + self.SCIAutoCShow(items) + + def _UpdateWithITypeInfo(self, items_dict, typeInfo): + import pythoncom + + typeInfos = [typeInfo] + # suppress IDispatch and IUnknown methods + inspectedIIDs = {pythoncom.IID_IDispatch: None} + + while len(typeInfos) > 0: + typeInfo = typeInfos.pop() + typeAttr = typeInfo.GetTypeAttr() + + if typeAttr.iid not in inspectedIIDs: + inspectedIIDs[typeAttr.iid] = None + for iFun in range(0, typeAttr.cFuncs): + funDesc = typeInfo.GetFuncDesc(iFun) + funName = typeInfo.GetNames(funDesc.memid)[0] + if funName not in items_dict: + items_dict[funName] = None + + # Inspect the type info of all implemented types + # E.g. IShellDispatch5 implements IShellDispatch4 which implements IShellDispatch3 ... + for iImplType in range(0, typeAttr.cImplTypes): + iRefType = typeInfo.GetRefTypeOfImplType(iImplType) + refTypeInfo = typeInfo.GetRefTypeInfo(iRefType) + typeInfos.append(refTypeInfo) + + # TODO: This is kinda slow. Probably need some kind of cache + # here that is flushed upon file save + # Or maybe we don't need the superclass methods at all ? + def _UpdateWithClassMethods(self, dict, classinfo): + if not hasattr(classinfo, "methods"): + # No 'methods' - probably not what we think it is. + return + dict.update(classinfo.methods) + for super in classinfo.super: + if hasattr(super, "methods"): + self._UpdateWithClassMethods(dict, super) + + # Find which class definition caret is currently in and return + # indexes of the the first and the last lines of that class definition + # Data is obtained from module browser (if enabled) + def _GetClassInfoFromBrowser(self, pos=-1): + minline = 0 + maxline = self.GetLineCount() - 1 + doc = self.GetParentFrame().GetActiveDocument() + browser = None + try: + if doc is not None: + browser = doc.GetAllViews()[1] + except IndexError: + pass + if browser is None: + return (minline, maxline, None) # Current window has no browser + if not browser.list: + return (minline, maxline, None) # Not initialized + path = self.GetDocument().GetPathName() + if not path: + return (minline, maxline, None) # No current path + + import pywin.framework.scriptutils + + curmodule, path = pywin.framework.scriptutils.GetPackageModuleName(path) + try: + clbrdata = browser.list.root.clbrdata + except AttributeError: + return (minline, maxline, None) # No class data for this module. + curline = self.LineFromChar(pos) + curclass = None + # Find out which class we are in + for item in clbrdata.values(): + if item.module == curmodule: + item_lineno = ( + item.lineno - 1 + ) # Scintilla counts lines from 0, whereas pyclbr - from 1 + if minline < item_lineno <= curline: + minline = item_lineno + curclass = item + if curline < item_lineno < maxline: + maxline = item_lineno + return (minline, maxline, curclass) + + def _GetObjectAtPos(self, pos=-1, bAllowCalls=0): + left, right = self._GetWordSplit(pos, bAllowCalls) + if left: # It is an attribute lookup + # How is this for a hack! + namespace = sys.modules.copy() + namespace.update(__main__.__dict__) + # Get the debugger's context. + try: + from pywin.framework import interact + + if interact.edit is not None and interact.edit.currentView is not None: + globs, locs = interact.edit.currentView.GetContext()[:2] + if globs: + namespace.update(globs) + if locs: + namespace.update(locs) + except ImportError: + pass + try: + return eval(left, namespace) + except: + pass + return None + + def _GetWordSplit(self, pos=-1, bAllowCalls=0): + if pos == -1: + pos = self.GetSel()[0] - 1 # Character before current one + limit = self.GetTextLength() + before = [] + after = [] + index = pos - 1 + wordbreaks_use = wordbreaks + if bAllowCalls: + wordbreaks_use = wordbreaks_use + "()[]" + while index >= 0: + char = self.SCIGetCharAt(index) + if char not in wordbreaks_use: + break + before.insert(0, char) + index = index - 1 + index = pos + while index <= limit: + char = self.SCIGetCharAt(index) + if char not in wordbreaks_use: + break + after.append(char) + index = index + 1 + return "".join(before), "".join(after) + + def OnPrepareDC(self, dc, pInfo): + # print "OnPrepareDC for page", pInfo.GetCurPage(), "of", pInfo.GetFromPage(), "to", pInfo.GetToPage(), ", starts=", self.starts + if dc.IsPrinting(): + # Check if we are beyond the end. + # (only do this when actually printing, else messes up print preview!) + if not pInfo.GetPreview() and self.starts is not None: + prevPage = pInfo.GetCurPage() - 1 + if prevPage > 0 and self.starts[prevPage] >= self.GetTextLength(): + # All finished. + pInfo.SetContinuePrinting(0) + return + dc.SetMapMode(win32con.MM_TEXT) + + def OnPreparePrinting(self, pInfo): + flags = ( + win32ui.PD_USEDEVMODECOPIES | win32ui.PD_ALLPAGES | win32ui.PD_NOSELECTION + ) # Dont support printing just a selection. + # NOTE: Custom print dialogs are stopping the user's values from coming back :-( + # self.prtDlg = PrintDialog(pInfo, PRINTDLGORD, flags) + # pInfo.SetPrintDialog(self.prtDlg) + pInfo.SetMinPage(1) + # max page remains undefined for now. + pInfo.SetFromPage(1) + pInfo.SetToPage(1) + ret = self.DoPreparePrinting(pInfo) + return ret + + def OnBeginPrinting(self, dc, pInfo): + self.starts = None + return self._obj_.OnBeginPrinting(dc, pInfo) + + def CalculatePageRanges(self, dc, pInfo): + # Calculate page ranges and max page + self.starts = {0: 0} + metrics = dc.GetTextMetrics() + left, top, right, bottom = pInfo.GetDraw() + # Leave space at the top for the header. + rc = (left, top + int((9 * metrics["tmHeight"]) / 2), right, bottom) + pageStart = 0 + maxPage = 0 + textLen = self.GetTextLength() + while pageStart < textLen: + pageStart = self.FormatRange(dc, pageStart, textLen, rc, 0) + maxPage = maxPage + 1 + self.starts[maxPage] = pageStart + # And a sentinal for one page past the end + self.starts[maxPage + 1] = textLen + # When actually printing, maxPage doesnt have any effect at this late state. + # but is needed to make the Print Preview work correctly. + pInfo.SetMaxPage(maxPage) + + def OnFilePrintPreview(self, *arg): + self._obj_.OnFilePrintPreview() + + def OnFilePrint(self, *arg): + self._obj_.OnFilePrint() + + def FormatRange(self, dc, pageStart, lengthDoc, rc, draw): + """ + typedef struct _formatrange { + HDC hdc; + HDC hdcTarget; + RECT rc; + RECT rcPage; + CHARRANGE chrg;} FORMATRANGE; + """ + fmt = "PPIIIIIIIIll" + hdcRender = dc.GetHandleOutput() + hdcFormat = dc.GetHandleAttrib() + fr = struct.pack( + fmt, + hdcRender, + hdcFormat, + rc[0], + rc[1], + rc[2], + rc[3], + rc[0], + rc[1], + rc[2], + rc[3], + pageStart, + lengthDoc, + ) + nextPageStart = self.SendScintilla(EM_FORMATRANGE, draw, fr) + return nextPageStart + + def OnPrint(self, dc, pInfo): + metrics = dc.GetTextMetrics() + # print "dev", w, h, l, metrics['tmAscent'], metrics['tmDescent'] + if self.starts is None: + self.CalculatePageRanges(dc, pInfo) + pageNum = pInfo.GetCurPage() - 1 + # Setup the header of the page - docname on left, pagenum on right. + doc = self.GetDocument() + cxChar = metrics["tmAveCharWidth"] + cyChar = metrics["tmHeight"] + left, top, right, bottom = pInfo.GetDraw() + dc.TextOut(0, 2 * cyChar, doc.GetTitle()) + pagenum_str = win32ui.LoadString(afxres.AFX_IDS_PRINTPAGENUM) % (pageNum + 1,) + dc.SetTextAlign(win32con.TA_RIGHT) + dc.TextOut(right, 2 * cyChar, pagenum_str) + dc.SetTextAlign(win32con.TA_LEFT) + top = top + int((7 * cyChar) / 2) + dc.MoveTo(left, top) + dc.LineTo(right, top) + top = top + cyChar + rc = (left, top, right, bottom) + nextPageStart = self.FormatRange( + dc, self.starts[pageNum], self.starts[pageNum + 1], rc, 1 + ) + + +def LoadConfiguration(): + global configManager + # Bit of a hack I dont kow what to do about? + from .config import ConfigManager + + configName = rc = win32ui.GetProfileVal("Editor", "Keyboard Config", "default") + configManager = ConfigManager(configName) + if configManager.last_error: + bTryDefault = 0 + msg = "Error loading configuration '%s'\n\n%s" % ( + configName, + configManager.last_error, + ) + if configName != "default": + msg = msg + "\n\nThe default configuration will be loaded." + bTryDefault = 1 + win32ui.MessageBox(msg) + if bTryDefault: + configManager = ConfigManager("default") + if configManager.last_error: + win32ui.MessageBox( + "Error loading configuration 'default'\n\n%s" + % (configManager.last_error) + ) + + +configManager = None +LoadConfiguration() diff --git a/lib/pythonwin/pywin/tools/TraceCollector.py b/lib/pythonwin/pywin/tools/TraceCollector.py new file mode 100644 index 00000000..5800488b --- /dev/null +++ b/lib/pythonwin/pywin/tools/TraceCollector.py @@ -0,0 +1,79 @@ +# win32traceutil like utility for Pythonwin +import _thread + +import win32api +import win32event +import win32trace +from pywin.framework import winout + +outputWindow = None + + +def CollectorThread(stopEvent, file): + win32trace.InitRead() + handle = win32trace.GetHandle() + # Run this thread at a lower priority to the main message-loop (and printing output) + # thread can keep up + import win32process + + win32process.SetThreadPriority( + win32api.GetCurrentThread(), win32process.THREAD_PRIORITY_BELOW_NORMAL + ) + + try: + while 1: + rc = win32event.WaitForMultipleObjects( + (handle, stopEvent), 0, win32event.INFINITE + ) + if rc == win32event.WAIT_OBJECT_0: + # About the only char we can't live with is \0! + file.write(win32trace.read().replace("\0", "")) + else: + # Stop event + break + finally: + win32trace.TermRead() + print("Thread dieing") + + +class WindowOutput(winout.WindowOutput): + def __init__(self, *args): + winout.WindowOutput.__init__(*(self,) + args) + self.hStopThread = win32event.CreateEvent(None, 0, 0, None) + _thread.start_new(CollectorThread, (self.hStopThread, self)) + + def _StopThread(self): + win32event.SetEvent(self.hStopThread) + self.hStopThread = None + + def Close(self): + self._StopThread() + winout.WindowOutput.Close(self) + # def OnViewDestroy(self, frame): + # return winout.WindowOutput.OnViewDestroy(self, frame) + # def Create(self, title=None, style = None): + # rc = winout.WindowOutput.Create(self, title, style) + return rc + + +def MakeOutputWindow(): + # Note that it will not show until the first string written or + # you pass bShow = 1 + global outputWindow + if outputWindow is None: + title = "Python Trace Collector" + # queueingFlag doesnt matter, as all output will come from new thread + outputWindow = WindowOutput(title, title) + # Let people know what this does! + msg = """\ +# This window will display output from any programs that import win32traceutil +# win32com servers registered with '--debug' are in this category. +""" + outputWindow.write(msg) + # force existing window open + outputWindow.write("") + return outputWindow + + +if __name__ == "__main__": + MakeOutputWindow() diff --git a/lib/pythonwin/pywin/tools/__init__.py b/lib/pythonwin/pywin/tools/__init__.py new file mode 100644 index 00000000..8b137891 --- /dev/null +++ b/lib/pythonwin/pywin/tools/__init__.py @@ -0,0 +1 @@ + diff --git a/lib/pythonwin/pywin/tools/browseProjects.py b/lib/pythonwin/pywin/tools/browseProjects.py new file mode 100644 index 00000000..e3255579 --- /dev/null +++ b/lib/pythonwin/pywin/tools/browseProjects.py @@ -0,0 +1,324 @@ +import glob +import os +import pyclbr + +import afxres +import commctrl +import pywin.framework.scriptutils +import regutil +import win32api +import win32con +import win32ui +from pywin.mfc import dialog + +from . import hierlist + + +class HLIErrorItem(hierlist.HierListItem): + def __init__(self, text): + self.text = text + hierlist.HierListItem.__init__(self) + + def GetText(self): + return self.text + + +class HLICLBRItem(hierlist.HierListItem): + def __init__(self, name, file, lineno, suffix=""): + # If the 'name' object itself has a .name, use it. Not sure + # how this happens, but seems pyclbr related. + # See PyWin32 bug 817035 + self.name = getattr(name, "name", name) + self.file = file + self.lineno = lineno + self.suffix = suffix + + def __lt__(self, other): + return self.name < other.name + + def __eq__(self, other): + return self.name == other.name + + def GetText(self): + return self.name + self.suffix + + def TakeDefaultAction(self): + if self.file: + pywin.framework.scriptutils.JumpToDocument( + self.file, self.lineno, bScrollToTop=1 + ) + else: + win32ui.SetStatusText("The source of this object is unknown") + + def PerformItemSelected(self): + if self.file is None: + msg = "%s - source can not be located." % (self.name,) + else: + msg = "%s defined at line %d of %s" % (self.name, self.lineno, self.file) + win32ui.SetStatusText(msg) + + +class HLICLBRClass(HLICLBRItem): + def __init__(self, clbrclass, suffix=""): + try: + name = clbrclass.name + file = clbrclass.file + lineno = clbrclass.lineno + self.super = clbrclass.super + self.methods = clbrclass.methods + except AttributeError: + name = clbrclass + file = lineno = None + self.super = [] + self.methods = {} + HLICLBRItem.__init__(self, name, file, lineno, suffix) + + def GetSubList(self): + ret = [] + for c in self.super: + ret.append(HLICLBRClass(c, " (Parent class)")) + for meth, lineno in self.methods.items(): + ret.append(HLICLBRMethod(meth, self.file, lineno, " (method)")) + return ret + + def IsExpandable(self): + return len(self.methods) + len(self.super) + + def GetBitmapColumn(self): + return 21 + + +class HLICLBRFunction(HLICLBRClass): + def GetBitmapColumn(self): + return 22 + + +class HLICLBRMethod(HLICLBRItem): + def GetBitmapColumn(self): + return 22 + + +class HLIModuleItem(hierlist.HierListItem): + def __init__(self, path): + hierlist.HierListItem.__init__(self) + self.path = path + + def GetText(self): + return os.path.split(self.path)[1] + " (module)" + + def IsExpandable(self): + return 1 + + def TakeDefaultAction(self): + win32ui.GetApp().OpenDocumentFile(self.path) + + def GetBitmapColumn(self): + col = 4 # Default + try: + if win32api.GetFileAttributes(self.path) & win32con.FILE_ATTRIBUTE_READONLY: + col = 5 + except win32api.error: + pass + return col + + def GetSubList(self): + mod, path = pywin.framework.scriptutils.GetPackageModuleName(self.path) + win32ui.SetStatusText("Building class list - please wait...", 1) + win32ui.DoWaitCursor(1) + try: + try: + reader = pyclbr.readmodule_ex # Post 1.5.2 interface. + extra_msg = " or functions" + except AttributeError: + reader = pyclbr.readmodule + extra_msg = "" + data = reader(mod, [path]) + if data: + ret = [] + for item in data.values(): + if ( + item.__class__ != pyclbr.Class + ): # ie, it is a pyclbr Function instance (only introduced post 1.5.2) + ret.append(HLICLBRFunction(item, " (function)")) + else: + ret.append(HLICLBRClass(item, " (class)")) + ret.sort() + return ret + else: + return [HLIErrorItem("No Python classes%s in module." % (extra_msg,))] + finally: + win32ui.DoWaitCursor(0) + win32ui.SetStatusText(win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE)) + + +def MakePathSubList(path): + ret = [] + for filename in glob.glob(os.path.join(path, "*")): + if os.path.isdir(filename) and os.path.isfile( + os.path.join(filename, "__init__.py") + ): + ret.append(HLIDirectoryItem(filename, os.path.split(filename)[1])) + else: + if os.path.splitext(filename)[1].lower() in [".py", ".pyw"]: + ret.append(HLIModuleItem(filename)) + return ret + + +class HLIDirectoryItem(hierlist.HierListItem): + def __init__(self, path, displayName=None, bSubDirs=0): + hierlist.HierListItem.__init__(self) + self.path = path + self.bSubDirs = bSubDirs + if displayName: + self.displayName = displayName + else: + self.displayName = path + + def IsExpandable(self): + return 1 + + def GetText(self): + return self.displayName + + def GetSubList(self): + ret = MakePathSubList(self.path) + if ( + os.path.split(self.path)[1] == "win32com" + ): # Complete and utter hack for win32com. + try: + path = win32api.GetFullPathName( + os.path.join(self.path, "..\\win32comext") + ) + ret = ret + MakePathSubList(path) + except win32ui.error: + pass + return ret + + +class HLIProjectRoot(hierlist.HierListItem): + def __init__(self, projectName, displayName=None): + hierlist.HierListItem.__init__(self) + self.projectName = projectName + self.displayName = displayName or projectName + + def GetText(self): + return self.displayName + + def IsExpandable(self): + return 1 + + def GetSubList(self): + paths = regutil.GetRegisteredNamedPath(self.projectName) + pathList = paths.split(";") + if len(pathList) == 1: # Single dir - dont bother putting the dir in + ret = MakePathSubList(pathList[0]) + else: + ret = list(map(HLIDirectoryItem, pathList)) + return ret + + +class HLIRoot(hierlist.HierListItem): + def __init__(self): + hierlist.HierListItem.__init__(self) + + def IsExpandable(self): + return 1 + + def GetSubList(self): + keyStr = regutil.BuildDefaultPythonKey() + "\\PythonPath" + hKey = win32api.RegOpenKey(regutil.GetRootKey(), keyStr) + try: + ret = [] + ret.append(HLIProjectRoot("", "Standard Python Library")) # The core path. + index = 0 + while 1: + try: + ret.append(HLIProjectRoot(win32api.RegEnumKey(hKey, index))) + index = index + 1 + except win32api.error: + break + return ret + finally: + win32api.RegCloseKey(hKey) + + +class dynamic_browser(dialog.Dialog): + style = win32con.WS_OVERLAPPEDWINDOW | win32con.WS_VISIBLE + cs = ( + win32con.WS_CHILD + | win32con.WS_VISIBLE + | commctrl.TVS_HASLINES + | commctrl.TVS_LINESATROOT + | commctrl.TVS_HASBUTTONS + ) + + dt = [ + ["Python Projects", (0, 0, 200, 200), style, None, (8, "MS Sans Serif")], + ["SysTreeView32", None, win32ui.IDC_LIST1, (0, 0, 200, 200), cs], + ] + + def __init__(self, hli_root): + dialog.Dialog.__init__(self, self.dt) + self.hier_list = hierlist.HierListWithItems(hli_root, win32ui.IDB_BROWSER_HIER) + self.HookMessage(self.on_size, win32con.WM_SIZE) + + def OnInitDialog(self): + self.hier_list.HierInit(self) + return dialog.Dialog.OnInitDialog(self) + + def on_size(self, params): + lparam = params[3] + w = win32api.LOWORD(lparam) + h = win32api.HIWORD(lparam) + self.GetDlgItem(win32ui.IDC_LIST1).MoveWindow((0, 0, w, h)) + + +def BrowseDialog(): + root = HLIRoot() + if not root.IsExpandable(): + raise TypeError( + "Browse() argument must have __dict__ attribute, or be a Browser supported type" + ) + + dlg = dynamic_browser(root) + dlg.CreateWindow() + + +def DockableBrowserCreator(parent): + root = HLIRoot() + hl = hierlist.HierListWithItems(root, win32ui.IDB_BROWSER_HIER) + + style = ( + win32con.WS_CHILD + | win32con.WS_VISIBLE + | win32con.WS_BORDER + | commctrl.TVS_HASLINES + | commctrl.TVS_LINESATROOT + | commctrl.TVS_HASBUTTONS + ) + + control = win32ui.CreateTreeCtrl() + control.CreateWindow(style, (0, 0, 150, 300), parent, win32ui.IDC_LIST1) + list = hl.HierInit(parent, control) + return control + + +def DockablePathBrowser(): + import pywin.docking.DockingBar + + bar = pywin.docking.DockingBar.DockingBar() + bar.CreateWindow( + win32ui.GetMainFrame(), DockableBrowserCreator, "Path Browser", 0x8E0A + ) + bar.SetBarStyle( + bar.GetBarStyle() + | afxres.CBRS_TOOLTIPS + | afxres.CBRS_FLYBY + | afxres.CBRS_SIZE_DYNAMIC + ) + bar.EnableDocking(afxres.CBRS_ALIGN_ANY) + win32ui.GetMainFrame().DockControlBar(bar) + + +# The "default" entry point +Browse = DockablePathBrowser diff --git a/lib/pythonwin/pywin/tools/browser.py b/lib/pythonwin/pywin/tools/browser.py new file mode 100644 index 00000000..9d9a193d --- /dev/null +++ b/lib/pythonwin/pywin/tools/browser.py @@ -0,0 +1,517 @@ +# basic module browser. + +# usage: +# >>> import browser +# >>> browser.Browse() +# or +# >>> browser.Browse(your_module) +import sys +import types + +import __main__ +import win32ui +from pywin.mfc import dialog + +from . import hierlist + +special_names = ["__doc__", "__name__", "__self__"] + + +# +# HierList items +class HLIPythonObject(hierlist.HierListItem): + def __init__(self, myobject=None, name=None): + hierlist.HierListItem.__init__(self) + self.myobject = myobject + self.knownExpandable = None + if name: + self.name = name + else: + try: + self.name = myobject.__name__ + except (AttributeError, TypeError): + try: + r = repr(myobject) + if len(r) > 20: + r = r[:20] + "..." + self.name = r + except (AttributeError, TypeError): + self.name = "???" + + def __lt__(self, other): + return self.name < other.name + + def __eq__(self, other): + return self.name == other.name + + def __repr__(self): + try: + type = self.GetHLIType() + except: + type = "Generic" + return ( + "HLIPythonObject(" + + type + + ") - name: " + + self.name + + " object: " + + repr(self.myobject) + ) + + def GetText(self): + try: + return str(self.name) + " (" + self.GetHLIType() + ")" + except AttributeError: + return str(self.name) + " = " + repr(self.myobject) + + def InsertDocString(self, lst): + ob = None + try: + ob = self.myobject.__doc__ + except (AttributeError, TypeError): + pass + # I don't quite grok descriptors enough to know how to + # best hook them up. Eg: + # >>> object.__getattribute__.__class__.__doc__ + # + if ob and isinstance(ob, str): + lst.insert(0, HLIDocString(ob, "Doc")) + + def GetSubList(self): + ret = [] + try: + for key, ob in self.myobject.__dict__.items(): + if key not in special_names: + ret.append(MakeHLI(ob, key)) + except (AttributeError, TypeError): + pass + try: + for name in self.myobject.__methods__: + ret.append(HLIMethod(name)) # no MakeHLI, as cant auto detect + except (AttributeError, TypeError): + pass + try: + for member in self.myobject.__members__: + if not member in special_names: + ret.append(MakeHLI(getattr(self.myobject, member), member)) + except (AttributeError, TypeError): + pass + ret.sort() + self.InsertDocString(ret) + return ret + + # if the has a dict, it is expandable. + def IsExpandable(self): + if self.knownExpandable is None: + self.knownExpandable = self.CalculateIsExpandable() + return self.knownExpandable + + def CalculateIsExpandable(self): + if hasattr(self.myobject, "__doc__"): + return 1 + try: + for key in self.myobject.__dict__.keys(): + if key not in special_names: + return 1 + except (AttributeError, TypeError): + pass + try: + self.myobject.__methods__ + return 1 + except (AttributeError, TypeError): + pass + try: + for item in self.myobject.__members__: + if item not in special_names: + return 1 + except (AttributeError, TypeError): + pass + return 0 + + def GetBitmapColumn(self): + if self.IsExpandable(): + return 0 + else: + return 4 + + def TakeDefaultAction(self): + ShowObject(self.myobject, self.name) + + +class HLIDocString(HLIPythonObject): + def GetHLIType(self): + return "DocString" + + def GetText(self): + return self.myobject.strip() + + def IsExpandable(self): + return 0 + + def GetBitmapColumn(self): + return 6 + + +class HLIModule(HLIPythonObject): + def GetHLIType(self): + return "Module" + + +class HLIFrame(HLIPythonObject): + def GetHLIType(self): + return "Stack Frame" + + +class HLITraceback(HLIPythonObject): + def GetHLIType(self): + return "Traceback" + + +class HLIClass(HLIPythonObject): + def GetHLIType(self): + return "Class" + + def GetSubList(self): + ret = [] + for base in self.myobject.__bases__: + ret.append(MakeHLI(base, "Base class: " + base.__name__)) + ret = ret + HLIPythonObject.GetSubList(self) + return ret + + +class HLIMethod(HLIPythonObject): + # myobject is just a string for methods. + def GetHLIType(self): + return "Method" + + def GetText(self): + return "Method: " + self.myobject + "()" + + +class HLICode(HLIPythonObject): + def GetHLIType(self): + return "Code" + + def IsExpandable(self): + return self.myobject + + def GetSubList(self): + ret = [] + ret.append(MakeHLI(self.myobject.co_consts, "Constants (co_consts)")) + ret.append(MakeHLI(self.myobject.co_names, "Names (co_names)")) + ret.append(MakeHLI(self.myobject.co_filename, "Filename (co_filename)")) + ret.append(MakeHLI(self.myobject.co_argcount, "Number of args (co_argcount)")) + ret.append(MakeHLI(self.myobject.co_varnames, "Param names (co_varnames)")) + + return ret + + +class HLIInstance(HLIPythonObject): + def GetHLIType(self): + return "Instance" + + def GetText(self): + return ( + str(self.name) + + " (Instance of class " + + str(self.myobject.__class__.__name__) + + ")" + ) + + def IsExpandable(self): + return 1 + + def GetSubList(self): + ret = [] + ret.append(MakeHLI(self.myobject.__class__)) + ret = ret + HLIPythonObject.GetSubList(self) + return ret + + +class HLIBuiltinFunction(HLIPythonObject): + def GetHLIType(self): + return "Builtin Function" + + +class HLIFunction(HLIPythonObject): + def GetHLIType(self): + return "Function" + + def IsExpandable(self): + return 1 + + def GetSubList(self): + ret = [] + # ret.append( MakeHLI( self.myobject.func_argcount, "Arg Count" )) + try: + ret.append(MakeHLI(self.myobject.func_argdefs, "Arg Defs")) + except AttributeError: + pass + try: + code = self.myobject.__code__ + globs = self.myobject.__globals__ + except AttributeError: + # must be py2.5 or earlier... + code = self.myobject.func_code + globs = self.myobject.func_globals + ret.append(MakeHLI(code, "Code")) + ret.append(MakeHLI(globs, "Globals")) + self.InsertDocString(ret) + return ret + + +class HLISeq(HLIPythonObject): + def GetHLIType(self): + return "Sequence (abstract!)" + + def IsExpandable(self): + return len(self.myobject) > 0 + + def GetSubList(self): + ret = [] + pos = 0 + for item in self.myobject: + ret.append(MakeHLI(item, "[" + str(pos) + "]")) + pos = pos + 1 + self.InsertDocString(ret) + return ret + + +class HLIList(HLISeq): + def GetHLIType(self): + return "List" + + +class HLITuple(HLISeq): + def GetHLIType(self): + return "Tuple" + + +class HLIDict(HLIPythonObject): + def GetHLIType(self): + return "Dict" + + def IsExpandable(self): + try: + self.myobject.__doc__ + return 1 + except (AttributeError, TypeError): + return len(self.myobject) > 0 + + def GetSubList(self): + ret = [] + keys = list(self.myobject.keys()) + keys.sort() + for key in keys: + ob = self.myobject[key] + ret.append(MakeHLI(ob, str(key))) + self.InsertDocString(ret) + return ret + + +# In Python 1.6, strings and Unicode have builtin methods, but we dont really want to see these +class HLIString(HLIPythonObject): + def IsExpandable(self): + return 0 + + +TypeMap = { + type: HLIClass, + types.FunctionType: HLIFunction, + tuple: HLITuple, + dict: HLIDict, + list: HLIList, + types.ModuleType: HLIModule, + types.CodeType: HLICode, + types.BuiltinFunctionType: HLIBuiltinFunction, + types.FrameType: HLIFrame, + types.TracebackType: HLITraceback, + str: HLIString, + int: HLIPythonObject, + bool: HLIPythonObject, + float: HLIPythonObject, +} + + +def MakeHLI(ob, name=None): + try: + cls = TypeMap[type(ob)] + except KeyError: + # hrmph - this check gets more and more bogus as Python + # improves. Its possible we should just *always* use + # HLIInstance? + if hasattr(ob, "__class__"): # 'new style' class + cls = HLIInstance + else: + cls = HLIPythonObject + return cls(ob, name) + + +######################################### +# +# Dialog related. + + +class DialogShowObject(dialog.Dialog): + def __init__(self, object, title): + self.object = object + self.title = title + dialog.Dialog.__init__(self, win32ui.IDD_LARGE_EDIT) + + def OnInitDialog(self): + import re + + self.SetWindowText(self.title) + self.edit = self.GetDlgItem(win32ui.IDC_EDIT1) + try: + strval = str(self.object) + except: + t, v, tb = sys.exc_info() + strval = "Exception getting object value\n\n%s:%s" % (t, v) + tb = None + strval = re.sub("\n", "\r\n", strval) + self.edit.ReplaceSel(strval) + + +def ShowObject(object, title): + dlg = DialogShowObject(object, title) + dlg.DoModal() + + +# And some mods for a sizable dialog from Sam Rushing! +import commctrl +import win32api +import win32con + + +class dynamic_browser(dialog.Dialog): + style = win32con.WS_OVERLAPPEDWINDOW | win32con.WS_VISIBLE + cs = ( + win32con.WS_CHILD + | win32con.WS_VISIBLE + | commctrl.TVS_HASLINES + | commctrl.TVS_LINESATROOT + | commctrl.TVS_HASBUTTONS + ) + + dt = [ + ["Python Object Browser", (0, 0, 200, 200), style, None, (8, "MS Sans Serif")], + ["SysTreeView32", None, win32ui.IDC_LIST1, (0, 0, 200, 200), cs], + ] + + def __init__(self, hli_root): + dialog.Dialog.__init__(self, self.dt) + self.hier_list = hierlist.HierListWithItems(hli_root, win32ui.IDB_BROWSER_HIER) + self.HookMessage(self.on_size, win32con.WM_SIZE) + + def OnInitDialog(self): + self.hier_list.HierInit(self) + return dialog.Dialog.OnInitDialog(self) + + def OnOK(self): + self.hier_list.HierTerm() + self.hier_list = None + return self._obj_.OnOK() + + def OnCancel(self): + self.hier_list.HierTerm() + self.hier_list = None + return self._obj_.OnCancel() + + def on_size(self, params): + lparam = params[3] + w = win32api.LOWORD(lparam) + h = win32api.HIWORD(lparam) + self.GetDlgItem(win32ui.IDC_LIST1).MoveWindow((0, 0, w, h)) + + +def Browse(ob=__main__): + "Browse the argument, or the main dictionary" + root = MakeHLI(ob, "root") + if not root.IsExpandable(): + raise TypeError( + "Browse() argument must have __dict__ attribute, or be a Browser supported type" + ) + + dlg = dynamic_browser(root) + dlg.CreateWindow() + return dlg + + +# +# +# Classes for using the browser in an MDI window, rather than a dialog +# +from pywin.mfc import docview + + +class BrowserTemplate(docview.DocTemplate): + def __init__(self): + docview.DocTemplate.__init__( + self, win32ui.IDR_PYTHONTYPE, BrowserDocument, None, BrowserView + ) + + def OpenObject(self, root): # Use this instead of OpenDocumentFile. + # Look for existing open document + for doc in self.GetDocumentList(): + if doc.root == root: + doc.GetFirstView().ActivateFrame() + return doc + # not found - new one. + doc = BrowserDocument(self, root) + frame = self.CreateNewFrame(doc) + doc.OnNewDocument() + self.InitialUpdateFrame(frame, doc, 1) + return doc + + +class BrowserDocument(docview.Document): + def __init__(self, template, root): + docview.Document.__init__(self, template) + self.root = root + self.SetTitle("Browser: " + root.name) + + def OnOpenDocument(self, name): + raise TypeError("This template can not open files") + return 0 + + +class BrowserView(docview.TreeView): + def OnInitialUpdate(self): + import commctrl + + rc = self._obj_.OnInitialUpdate() + list = hierlist.HierListWithItems( + self.GetDocument().root, + win32ui.IDB_BROWSER_HIER, + win32ui.AFX_IDW_PANE_FIRST, + ) + list.HierInit(self.GetParent()) + list.SetStyle( + commctrl.TVS_HASLINES | commctrl.TVS_LINESATROOT | commctrl.TVS_HASBUTTONS + ) + return rc + + +template = None + + +def MakeTemplate(): + global template + if template is None: + template = ( + BrowserTemplate() + ) # win32ui.IDR_PYTHONTYPE, BrowserDocument, None, BrowserView) + + +def BrowseMDI(ob=__main__): + """Browse an object using an MDI window.""" + + MakeTemplate() + root = MakeHLI(ob, repr(ob)) + if not root.IsExpandable(): + raise TypeError( + "Browse() argument must have __dict__ attribute, or be a Browser supported type" + ) + + template.OpenObject(root) diff --git a/lib/pythonwin/pywin/tools/hierlist.py b/lib/pythonwin/pywin/tools/hierlist.py new file mode 100644 index 00000000..a60b7324 --- /dev/null +++ b/lib/pythonwin/pywin/tools/hierlist.py @@ -0,0 +1,367 @@ +# hierlist +# +# IMPORTANT - Please read before using. + +# This module exposes an API for a Hierarchical Tree Control. +# Previously, a custom tree control was included in Pythonwin which +# has an API very similar to this. + +# The current control used is the common "Tree Control". This module exists now +# to provide an API similar to the old control, but for the new Tree control. + +# If you need to use the Tree Control, you may still find this API a reasonable +# choice. However, you should investigate using the tree control directly +# to provide maximum flexibility (but with extra work). + +import sys + +import commctrl +import win32api +import win32con +import win32ui +from pywin.mfc import dialog, docview, object, window +from win32api import RGB + + +# helper to get the text of an arbitary item +def GetItemText(item): + if type(item) == type(()) or type(item) == type([]): + use = item[0] + else: + use = item + if type(use) == type(""): + return use + else: + return repr(item) + + +class HierDialog(dialog.Dialog): + def __init__( + self, + title, + hierList, + bitmapID=win32ui.IDB_HIERFOLDERS, + dlgID=win32ui.IDD_TREE, + dll=None, + childListBoxID=win32ui.IDC_LIST1, + ): + dialog.Dialog.__init__(self, dlgID, dll) # reuse this dialog. + self.hierList = hierList + self.dlgID = dlgID + self.title = title + + # self.childListBoxID = childListBoxID + def OnInitDialog(self): + self.SetWindowText(self.title) + self.hierList.HierInit(self) + return dialog.Dialog.OnInitDialog(self) + + +class HierList(object.Object): + def __init__( + self, root, bitmapID=win32ui.IDB_HIERFOLDERS, listBoxId=None, bitmapMask=None + ): # used to create object. + self.listControl = None + self.bitmapID = bitmapID + self.root = root + self.listBoxId = listBoxId + self.itemHandleMap = {} + self.filledItemHandlesMap = {} + self.bitmapMask = bitmapMask + + def __getattr__(self, attr): + try: + return getattr(self.listControl, attr) + except AttributeError: + return object.Object.__getattr__(self, attr) + + def ItemFromHandle(self, handle): + return self.itemHandleMap[handle] + + def SetStyle(self, newStyle): + hwnd = self.listControl.GetSafeHwnd() + style = win32api.GetWindowLong(hwnd, win32con.GWL_STYLE) + win32api.SetWindowLong(hwnd, win32con.GWL_STYLE, (style | newStyle)) + + def HierInit(self, parent, listControl=None): # Used when window first exists. + # this also calls "Create" on the listbox. + # params - id of listbbox, ID of bitmap, size of bitmaps + if self.bitmapMask is None: + bitmapMask = RGB(0, 0, 255) + else: + bitmapMask = self.bitmapMask + self.imageList = win32ui.CreateImageList(self.bitmapID, 16, 0, bitmapMask) + if listControl is None: + if self.listBoxId is None: + self.listBoxId = win32ui.IDC_LIST1 + self.listControl = parent.GetDlgItem(self.listBoxId) + else: + self.listControl = listControl + lbid = listControl.GetDlgCtrlID() + assert self.listBoxId is None or self.listBoxId == lbid, ( + "An invalid listbox control ID has been specified (specified as %s, but exists as %s)" + % (self.listBoxId, lbid) + ) + self.listBoxId = lbid + self.listControl.SetImageList(self.imageList, commctrl.LVSIL_NORMAL) + # self.list.AttachObject(self) + + ## ??? Need a better way to do this - either some way to detect if it's compiled with UNICODE + ## defined, and/or a way to switch the constants based on UNICODE ??? + if sys.version_info[0] < 3: + parent.HookNotify(self.OnTreeItemExpanding, commctrl.TVN_ITEMEXPANDINGA) + parent.HookNotify(self.OnTreeItemSelChanged, commctrl.TVN_SELCHANGEDA) + else: + parent.HookNotify(self.OnTreeItemExpanding, commctrl.TVN_ITEMEXPANDINGW) + parent.HookNotify(self.OnTreeItemSelChanged, commctrl.TVN_SELCHANGEDW) + parent.HookNotify(self.OnTreeItemDoubleClick, commctrl.NM_DBLCLK) + self.notify_parent = parent + + if self.root: + self.AcceptRoot(self.root) + + def DeleteAllItems(self): + self.listControl.DeleteAllItems() + self.root = None + self.itemHandleMap = {} + self.filledItemHandlesMap = {} + + def HierTerm(self): + # Dont want notifies as we kill the list. + parent = self.notify_parent # GetParentFrame() + if sys.version_info[0] < 3: + parent.HookNotify(None, commctrl.TVN_ITEMEXPANDINGA) + parent.HookNotify(None, commctrl.TVN_SELCHANGEDA) + else: + parent.HookNotify(None, commctrl.TVN_ITEMEXPANDINGW) + parent.HookNotify(None, commctrl.TVN_SELCHANGEDW) + parent.HookNotify(None, commctrl.NM_DBLCLK) + + self.DeleteAllItems() + self.listControl = None + self.notify_parent = None # Break a possible cycle + + def OnTreeItemDoubleClick(self, info, extra): + (hwndFrom, idFrom, code) = info + if idFrom != self.listBoxId: + return None + item = self.itemHandleMap[self.listControl.GetSelectedItem()] + self.TakeDefaultAction(item) + return 1 + + def OnTreeItemExpanding(self, info, extra): + (hwndFrom, idFrom, code) = info + if idFrom != self.listBoxId: + return None + action, itemOld, itemNew, pt = extra + itemHandle = itemNew[0] + if itemHandle not in self.filledItemHandlesMap: + item = self.itemHandleMap[itemHandle] + self.AddSubList(itemHandle, self.GetSubList(item)) + self.filledItemHandlesMap[itemHandle] = None + return 0 + + def OnTreeItemSelChanged(self, info, extra): + (hwndFrom, idFrom, code) = info + if idFrom != self.listBoxId: + return None + action, itemOld, itemNew, pt = extra + itemHandle = itemNew[0] + item = self.itemHandleMap[itemHandle] + self.PerformItemSelected(item) + return 1 + + def AddSubList(self, parentHandle, subItems): + for item in subItems: + self.AddItem(parentHandle, item) + + def AddItem(self, parentHandle, item, hInsertAfter=commctrl.TVI_LAST): + text = self.GetText(item) + if self.IsExpandable(item): + cItems = 1 # Trick it !! + else: + cItems = 0 + bitmapCol = self.GetBitmapColumn(item) + bitmapSel = self.GetSelectedBitmapColumn(item) + if bitmapSel is None: + bitmapSel = bitmapCol + ## if type(text) is str: + ## text = text.encode("mbcs") + hitem = self.listControl.InsertItem( + parentHandle, + hInsertAfter, + (None, None, None, text, bitmapCol, bitmapSel, cItems, 0), + ) + self.itemHandleMap[hitem] = item + return hitem + + def _GetChildHandles(self, handle): + ret = [] + try: + handle = self.listControl.GetChildItem(handle) + while 1: + ret.append(handle) + handle = self.listControl.GetNextItem(handle, commctrl.TVGN_NEXT) + except win32ui.error: + # out of children + pass + return ret + + def Refresh(self, hparent=None): + # Attempt to refresh the given item's sub-entries, but maintain the tree state + # (ie, the selected item, expanded items, etc) + if hparent is None: + hparent = commctrl.TVI_ROOT + if hparent not in self.filledItemHandlesMap: + # This item has never been expanded, so no refresh can possibly be required. + return + root_item = self.itemHandleMap[hparent] + old_handles = self._GetChildHandles(hparent) + old_items = list(map(self.ItemFromHandle, old_handles)) + new_items = self.GetSubList(root_item) + # Now an inefficient technique for synching the items. + inew = 0 + hAfter = commctrl.TVI_FIRST + for iold in range(len(old_items)): + inewlook = inew + matched = 0 + while inewlook < len(new_items): + if old_items[iold] == new_items[inewlook]: + matched = 1 + break + inewlook = inewlook + 1 + if matched: + # Insert the new items. + # print "Inserting after", old_items[iold], old_handles[iold] + for i in range(inew, inewlook): + # print "Inserting index %d (%s)" % (i, new_items[i]) + hAfter = self.AddItem(hparent, new_items[i], hAfter) + + inew = inewlook + 1 + # And recursively refresh iold + hold = old_handles[iold] + if hold in self.filledItemHandlesMap: + self.Refresh(hold) + else: + # Remove the deleted items. + # print "Deleting %d (%s)" % (iold, old_items[iold]) + hdelete = old_handles[iold] + # First recurse and remove the children from the map. + for hchild in self._GetChildHandles(hdelete): + del self.itemHandleMap[hchild] + if hchild in self.filledItemHandlesMap: + del self.filledItemHandlesMap[hchild] + self.listControl.DeleteItem(hdelete) + hAfter = old_handles[iold] + # Fill any remaining new items: + for newItem in new_items[inew:]: + # print "Inserting new item", newItem + self.AddItem(hparent, newItem) + + def AcceptRoot(self, root): + self.listControl.DeleteAllItems() + self.itemHandleMap = {commctrl.TVI_ROOT: root} + self.filledItemHandlesMap = {commctrl.TVI_ROOT: root} + subItems = self.GetSubList(root) + self.AddSubList(0, subItems) + + def GetBitmapColumn(self, item): + if self.IsExpandable(item): + return 0 + else: + return 4 + + def GetSelectedBitmapColumn(self, item): + return 0 + + def CheckChangedChildren(self): + return self.listControl.CheckChangedChildren() + + def GetText(self, item): + return GetItemText(item) + + def PerformItemSelected(self, item): + try: + win32ui.SetStatusText("Selected " + self.GetText(item)) + except win32ui.error: # No status bar! + pass + + def TakeDefaultAction(self, item): + win32ui.MessageBox("Got item " + self.GetText(item)) + + +########################################################################## +# +# Classes for use with seperate HierListItems. +# +# +class HierListWithItems(HierList): + def __init__( + self, root, bitmapID=win32ui.IDB_HIERFOLDERS, listBoxID=None, bitmapMask=None + ): # used to create object. + HierList.__init__(self, root, bitmapID, listBoxID, bitmapMask) + + def DelegateCall(self, fn): + return fn() + + def GetBitmapColumn(self, item): + rc = self.DelegateCall(item.GetBitmapColumn) + if rc is None: + rc = HierList.GetBitmapColumn(self, item) + return rc + + def GetSelectedBitmapColumn(self, item): + return self.DelegateCall(item.GetSelectedBitmapColumn) + + def IsExpandable(self, item): + return self.DelegateCall(item.IsExpandable) + + def GetText(self, item): + return self.DelegateCall(item.GetText) + + def GetSubList(self, item): + return self.DelegateCall(item.GetSubList) + + def PerformItemSelected(self, item): + func = getattr(item, "PerformItemSelected", None) + if func is None: + return HierList.PerformItemSelected(self, item) + else: + return self.DelegateCall(func) + + def TakeDefaultAction(self, item): + func = getattr(item, "TakeDefaultAction", None) + if func is None: + return HierList.TakeDefaultAction(self, item) + else: + return self.DelegateCall(func) + + +# A hier list item - for use with a HierListWithItems +class HierListItem: + def __init__(self): + pass + + def GetText(self): + pass + + def GetSubList(self): + pass + + def IsExpandable(self): + pass + + def GetBitmapColumn(self): + return None # indicate he should do it. + + def GetSelectedBitmapColumn(self): + return None # same as other + + # for py3k/rich-comp sorting compatibility. + def __lt__(self, other): + # we want unrelated items to be sortable... + return id(self) < id(other) + + # for py3k/rich-comp equality compatibility. + def __eq__(self, other): + return False diff --git a/lib/pythonwin/pywin/tools/regedit.py b/lib/pythonwin/pywin/tools/regedit.py new file mode 100644 index 00000000..b94d3050 --- /dev/null +++ b/lib/pythonwin/pywin/tools/regedit.py @@ -0,0 +1,386 @@ +# Regedit - a Registry Editor for Python + +import commctrl +import regutil +import win32api +import win32con +import win32ui +from pywin.mfc import dialog, docview, window + +from . import hierlist + + +def SafeApply(fn, args, err_desc=""): + try: + fn(*args) + return 1 + except win32api.error as exc: + msg = "Error " + err_desc + "\r\n\r\n" + exc.strerror + win32ui.MessageBox(msg) + return 0 + + +class SplitterFrame(window.MDIChildWnd): + def __init__(self): + # call base CreateFrame + self.images = None + window.MDIChildWnd.__init__(self) + + def OnCreateClient(self, cp, context): + splitter = win32ui.CreateSplitter() + doc = context.doc + frame_rect = self.GetWindowRect() + size = ((frame_rect[2] - frame_rect[0]), (frame_rect[3] - frame_rect[1]) // 2) + sub_size = (size[0] // 3, size[1]) + splitter.CreateStatic(self, 1, 2) + # CTreeControl view + self.keysview = RegistryTreeView(doc) + # CListControl view + self.valuesview = RegistryValueView(doc) + + splitter.CreatePane(self.keysview, 0, 0, (sub_size)) + splitter.CreatePane(self.valuesview, 0, 1, (0, 0)) # size ignored. + splitter.SetRowInfo(0, size[1], 0) + # Setup items in the imagelist + + return 1 + + def OnItemDoubleClick(self, info, extra): + (hwndFrom, idFrom, code) = info + if idFrom == win32ui.AFX_IDW_PANE_FIRST: + # Tree control + return None + elif idFrom == win32ui.AFX_IDW_PANE_FIRST + 1: + item = self.keysview.SelectedItem() + self.valuesview.EditValue(item) + return 0 + # List control + else: + return None # Pass it on + + def PerformItemSelected(self, item): + return self.valuesview.UpdateForRegItem(item) + + def OnDestroy(self, msg): + window.MDIChildWnd.OnDestroy(self, msg) + if self.images: + self.images.DeleteImageList() + self.images = None + + +class RegistryTreeView(docview.TreeView): + def OnInitialUpdate(self): + rc = self._obj_.OnInitialUpdate() + self.frame = self.GetParent().GetParent() + self.hierList = hierlist.HierListWithItems( + self.GetHLIRoot(), win32ui.IDB_HIERFOLDERS, win32ui.AFX_IDW_PANE_FIRST + ) + self.hierList.HierInit(self.frame, self.GetTreeCtrl()) + self.hierList.SetStyle( + commctrl.TVS_HASLINES | commctrl.TVS_LINESATROOT | commctrl.TVS_HASBUTTONS + ) + self.hierList.PerformItemSelected = self.PerformItemSelected + + self.frame.HookNotify(self.frame.OnItemDoubleClick, commctrl.NM_DBLCLK) + self.frame.HookNotify(self.OnItemRightClick, commctrl.NM_RCLICK) + + # self.HookMessage(self.OnItemRightClick, win32con.WM_RBUTTONUP) + + def GetHLIRoot(self): + doc = self.GetDocument() + regroot = doc.root + subkey = doc.subkey + return HLIRegistryKey(regroot, subkey, "Root") + + def OnItemRightClick(self, notify_data, extra): + # First select the item we right-clicked on. + pt = self.ScreenToClient(win32api.GetCursorPos()) + flags, hItem = self.HitTest(pt) + if hItem == 0 or commctrl.TVHT_ONITEM & flags == 0: + return None + self.Select(hItem, commctrl.TVGN_CARET) + + menu = win32ui.CreatePopupMenu() + menu.AppendMenu(win32con.MF_STRING | win32con.MF_ENABLED, 1000, "Add Key") + menu.AppendMenu(win32con.MF_STRING | win32con.MF_ENABLED, 1001, "Add Value") + menu.AppendMenu(win32con.MF_STRING | win32con.MF_ENABLED, 1002, "Delete Key") + self.HookCommand(self.OnAddKey, 1000) + self.HookCommand(self.OnAddValue, 1001) + self.HookCommand(self.OnDeleteKey, 1002) + menu.TrackPopupMenu(win32api.GetCursorPos()) # track at mouse position. + return None + + def OnDeleteKey(self, command, code): + hitem = self.hierList.GetSelectedItem() + item = self.hierList.ItemFromHandle(hitem) + msg = "Are you sure you wish to delete the key '%s'?" % (item.keyName,) + id = win32ui.MessageBox(msg, None, win32con.MB_YESNO) + if id != win32con.IDYES: + return + if SafeApply( + win32api.RegDeleteKey, (item.keyRoot, item.keyName), "deleting registry key" + ): + # Get the items parent. + try: + hparent = self.GetParentItem(hitem) + except win32ui.error: + hparent = None + self.hierList.Refresh(hparent) + + def OnAddKey(self, command, code): + from pywin.mfc import dialog + + val = dialog.GetSimpleInput("New key name", "", "Add new key") + if val is None: + return # cancelled. + hitem = self.hierList.GetSelectedItem() + item = self.hierList.ItemFromHandle(hitem) + if SafeApply(win32api.RegCreateKey, (item.keyRoot, item.keyName + "\\" + val)): + self.hierList.Refresh(hitem) + + def OnAddValue(self, command, code): + from pywin.mfc import dialog + + val = dialog.GetSimpleInput("New value", "", "Add new value") + if val is None: + return # cancelled. + hitem = self.hierList.GetSelectedItem() + item = self.hierList.ItemFromHandle(hitem) + if SafeApply( + win32api.RegSetValue, (item.keyRoot, item.keyName, win32con.REG_SZ, val) + ): + # Simply re-select the current item to refresh the right spitter. + self.PerformItemSelected(item) + + # self.Select(hitem, commctrl.TVGN_CARET) + + def PerformItemSelected(self, item): + return self.frame.PerformItemSelected(item) + + def SelectedItem(self): + return self.hierList.ItemFromHandle(self.hierList.GetSelectedItem()) + + def SearchSelectedItem(self): + handle = self.hierList.GetChildItem(0) + while 1: + # print "State is", self.hierList.GetItemState(handle, -1) + if self.hierList.GetItemState(handle, commctrl.TVIS_SELECTED): + # print "Item is ", self.hierList.ItemFromHandle(handle) + return self.hierList.ItemFromHandle(handle) + handle = self.hierList.GetNextSiblingItem(handle) + + +class RegistryValueView(docview.ListView): + def OnInitialUpdate(self): + hwnd = self._obj_.GetSafeHwnd() + style = win32api.GetWindowLong(hwnd, win32con.GWL_STYLE) + win32api.SetWindowLong( + hwnd, + win32con.GWL_STYLE, + (style & ~commctrl.LVS_TYPEMASK) | commctrl.LVS_REPORT, + ) + + itemDetails = (commctrl.LVCFMT_LEFT, 100, "Name", 0) + self.InsertColumn(0, itemDetails) + itemDetails = (commctrl.LVCFMT_LEFT, 500, "Data", 0) + self.InsertColumn(1, itemDetails) + + def UpdateForRegItem(self, item): + self.DeleteAllItems() + hkey = win32api.RegOpenKey(item.keyRoot, item.keyName) + try: + valNum = 0 + ret = [] + while 1: + try: + res = win32api.RegEnumValue(hkey, valNum) + except win32api.error: + break + name = res[0] + if not name: + name = "(Default)" + self.InsertItem(valNum, name) + self.SetItemText(valNum, 1, str(res[1])) + valNum = valNum + 1 + finally: + win32api.RegCloseKey(hkey) + + def EditValue(self, item): + # Edit the current value + class EditDialog(dialog.Dialog): + def __init__(self, item): + self.item = item + dialog.Dialog.__init__(self, win32ui.IDD_LARGE_EDIT) + + def OnInitDialog(self): + self.SetWindowText("Enter new value") + self.GetDlgItem(win32con.IDCANCEL).ShowWindow(win32con.SW_SHOW) + self.edit = self.GetDlgItem(win32ui.IDC_EDIT1) + # Modify the edit windows style + style = win32api.GetWindowLong( + self.edit.GetSafeHwnd(), win32con.GWL_STYLE + ) + style = style & (~win32con.ES_WANTRETURN) + win32api.SetWindowLong( + self.edit.GetSafeHwnd(), win32con.GWL_STYLE, style + ) + self.edit.SetWindowText(str(self.item)) + self.edit.SetSel(-1) + return dialog.Dialog.OnInitDialog(self) + + def OnDestroy(self, msg): + self.newvalue = self.edit.GetWindowText() + + try: + index = self.GetNextItem(-1, commctrl.LVNI_SELECTED) + except win32ui.error: + return # No item selected. + + if index == 0: + keyVal = "" + else: + keyVal = self.GetItemText(index, 0) + # Query for a new value. + try: + newVal = self.GetItemsCurrentValue(item, keyVal) + except TypeError as details: + win32ui.MessageBox(details) + return + + d = EditDialog(newVal) + if d.DoModal() == win32con.IDOK: + try: + self.SetItemsCurrentValue(item, keyVal, d.newvalue) + except win32api.error as exc: + win32ui.MessageBox("Error setting value\r\n\n%s" % exc.strerror) + self.UpdateForRegItem(item) + + def GetItemsCurrentValue(self, item, valueName): + hkey = win32api.RegOpenKey(item.keyRoot, item.keyName) + try: + val, type = win32api.RegQueryValueEx(hkey, valueName) + if type != win32con.REG_SZ: + raise TypeError("Only strings can be edited") + return val + finally: + win32api.RegCloseKey(hkey) + + def SetItemsCurrentValue(self, item, valueName, value): + # ** Assumes already checked is a string. + hkey = win32api.RegOpenKey( + item.keyRoot, item.keyName, 0, win32con.KEY_SET_VALUE + ) + try: + win32api.RegSetValueEx(hkey, valueName, 0, win32con.REG_SZ, value) + finally: + win32api.RegCloseKey(hkey) + + +class RegTemplate(docview.DocTemplate): + def __init__(self): + docview.DocTemplate.__init__( + self, win32ui.IDR_PYTHONTYPE, None, SplitterFrame, None + ) + + # def InitialUpdateFrame(self, frame, doc, makeVisible=1): + # self._obj_.InitialUpdateFrame(frame, doc, makeVisible) # call default handler. + # frame.InitialUpdateFrame(doc, makeVisible) + + def OpenRegistryKey( + self, root=None, subkey=None + ): # Use this instead of OpenDocumentFile. + # Look for existing open document + if root is None: + root = regutil.GetRootKey() + if subkey is None: + subkey = regutil.BuildDefaultPythonKey() + for doc in self.GetDocumentList(): + if doc.root == root and doc.subkey == subkey: + doc.GetFirstView().ActivateFrame() + return doc + # not found - new one. + doc = RegDocument(self, root, subkey) + frame = self.CreateNewFrame(doc) + doc.OnNewDocument() + self.InitialUpdateFrame(frame, doc, 1) + return doc + + +class RegDocument(docview.Document): + def __init__(self, template, root, subkey): + docview.Document.__init__(self, template) + self.root = root + self.subkey = subkey + self.SetTitle("Registry Editor: " + subkey) + + def OnOpenDocument(self, name): + raise TypeError("This template can not open files") + return 0 + + +class HLIRegistryKey(hierlist.HierListItem): + def __init__(self, keyRoot, keyName, userName): + self.keyRoot = keyRoot + self.keyName = keyName + self.userName = userName + hierlist.HierListItem.__init__(self) + + def __lt__(self, other): + return self.name < other.name + + def __eq__(self, other): + return ( + self.keyRoot == other.keyRoot + and self.keyName == other.keyName + and self.userName == other.userName + ) + + def __repr__(self): + return "<%s with root=%s, key=%s>" % ( + self.__class__.__name__, + self.keyRoot, + self.keyName, + ) + + def GetText(self): + return self.userName + + def IsExpandable(self): + # All keys are expandable, even if they currently have zero children. + return 1 + + ## hkey = win32api.RegOpenKey(self.keyRoot, self.keyName) + ## try: + ## keys, vals, dt = win32api.RegQueryInfoKey(hkey) + ## return (keys>0) + ## finally: + ## win32api.RegCloseKey(hkey) + + def GetSubList(self): + hkey = win32api.RegOpenKey(self.keyRoot, self.keyName) + win32ui.DoWaitCursor(1) + try: + keyNum = 0 + ret = [] + while 1: + try: + key = win32api.RegEnumKey(hkey, keyNum) + except win32api.error: + break + ret.append(HLIRegistryKey(self.keyRoot, self.keyName + "\\" + key, key)) + keyNum = keyNum + 1 + finally: + win32api.RegCloseKey(hkey) + win32ui.DoWaitCursor(0) + return ret + + +template = RegTemplate() + + +def EditRegistry(root=None, key=None): + doc = template.OpenRegistryKey(root, key) + + +if __name__ == "__main__": + EditRegistry() diff --git a/lib/pythonwin/pywin/tools/regpy.py b/lib/pythonwin/pywin/tools/regpy.py new file mode 100644 index 00000000..11ad63af --- /dev/null +++ b/lib/pythonwin/pywin/tools/regpy.py @@ -0,0 +1,81 @@ +# (sort-of) Registry editor +import commctrl +import dialog +import win32con +import win32ui + + +class RegistryControl: + def __init__(self, key): + self.key = key + + +class RegEditPropertyPage(dialog.PropertyPage): + IDC_LISTVIEW = 1000 + + def GetTemplate(self): + "Return the template used to create this dialog" + + w = 152 # Dialog width + h = 122 # Dialog height + SS_STD = win32con.WS_CHILD | win32con.WS_VISIBLE + FRAMEDLG_STD = win32con.WS_CAPTION | win32con.WS_SYSMENU + style = ( + FRAMEDLG_STD + | win32con.WS_VISIBLE + | win32con.DS_SETFONT + | win32con.WS_MINIMIZEBOX + ) + template = [ + [self.caption, (0, 0, w, h), style, None, (8, "Helv")], + ] + lvStyle = ( + SS_STD + | commctrl.LVS_EDITLABELS + | commctrl.LVS_REPORT + | commctrl.LVS_AUTOARRANGE + | commctrl.LVS_ALIGNLEFT + | win32con.WS_BORDER + | win32con.WS_TABSTOP + ) + template.append( + ["SysListView32", "", self.IDC_LISTVIEW, (10, 10, 185, 100), lvStyle] + ) + return template + + +class RegistryPage(RegEditPropertyPage): + def __init__(self): + self.caption = "Path" + RegEditPropertyPage.__init__(self, self.GetTemplate()) + + def OnInitDialog(self): + self.listview = self.GetDlgItem(self.IDC_LISTVIEW) + RegEditPropertyPage.OnInitDialog(self) + # Setup the listview columns + itemDetails = (commctrl.LVCFMT_LEFT, 100, "App", 0) + self.listview.InsertColumn(0, itemDetails) + itemDetails = (commctrl.LVCFMT_LEFT, 1024, "Paths", 0) + self.listview.InsertColumn(1, itemDetails) + + index = self.listview.InsertItem(0, "App") + self.listview.SetItemText(index, 1, "Path") + + +class RegistrySheet(dialog.PropertySheet): + def __init__(self, title): + dialog.PropertySheet.__init__(self, title) + self.HookMessage(self.OnActivate, win32con.WM_ACTIVATE) + + def OnActivate(self, msg): + print("OnAcivate") + + +def t(): + ps = RegistrySheet("Registry Settings") + ps.AddPage(RegistryPage()) + ps.DoModal() + + +if __name__ == "__main__": + t() diff --git a/lib/pythonwin/start_pythonwin.pyw b/lib/pythonwin/start_pythonwin.pyw new file mode 100644 index 00000000..0a1b2e60 --- /dev/null +++ b/lib/pythonwin/start_pythonwin.pyw @@ -0,0 +1,19 @@ +# A Python file that can be used to start Pythonwin, instead of using +# pythonwin.exe +import os +import sys + +import win32ui + +import pywin.framework.intpyapp # InteractivePythonApp() + +assert pywin.framework.intpyapp # not unused +# Pretend this script doesn't exist, or pythonwin tries to edit it +sys.argv[:] = sys.argv[1:] or [""] # like PySys_SetArgv(Ex) +if sys.path[0] not in ("", ".", os.getcwd()): + sys.path.insert(0, os.getcwd()) +# And bootstrap the app. +app = win32ui.GetApp() +if not app.InitInstance(): + # Run when not already handled by DDE + app.Run() diff --git a/lib/pywin32.version.txt b/lib/pywin32.version.txt new file mode 100644 index 00000000..cd307095 --- /dev/null +++ b/lib/pywin32.version.txt @@ -0,0 +1 @@ +306 diff --git a/lib/tempora/timing.py b/lib/tempora/timing.py index aed0d336..e74b8962 100644 --- a/lib/tempora/timing.py +++ b/lib/tempora/timing.py @@ -1,22 +1,21 @@ +import collections.abc +import contextlib import datetime import functools import numbers import time -import collections.abc -import contextlib import jaraco.functools class Stopwatch: """ - A simple stopwatch which starts automatically. + A simple stopwatch that starts automatically. >>> w = Stopwatch() >>> _1_sec = datetime.timedelta(seconds=1) >>> w.split() < _1_sec True - >>> import time >>> time.sleep(1.0) >>> w.split() >= _1_sec True @@ -27,13 +26,13 @@ class Stopwatch: >>> w.split() < _1_sec True - It should be possible to launch the Stopwatch in a context: + Launch the Stopwatch in a context: >>> with Stopwatch() as watch: ... assert isinstance(watch.split(), datetime.timedelta) - In that case, the watch is stopped when the context is exited, - so to read the elapsed time: + After exiting the context, the watch is stopped; read the + elapsed time directly: >>> watch.elapsed datetime.timedelta(...) diff --git a/lib/typing_extensions.py b/lib/typing_extensions.py index ef42417c..f3132ea4 100644 --- a/lib/typing_extensions.py +++ b/lib/typing_extensions.py @@ -2,11 +2,12 @@ import abc import collections import collections.abc import functools +import inspect import operator import sys import types as _types import typing - +import warnings __all__ = [ # Super-special typing primitives. @@ -31,6 +32,7 @@ __all__ = [ 'Coroutine', 'AsyncGenerator', 'AsyncContextManager', + 'Buffer', 'ChainMap', # Concrete collection types. @@ -43,7 +45,13 @@ __all__ = [ 'TypedDict', # Structural checks, a.k.a. protocols. + 'SupportsAbs', + 'SupportsBytes', + 'SupportsComplex', + 'SupportsFloat', 'SupportsIndex', + 'SupportsInt', + 'SupportsRound', # One-off things. 'Annotated', @@ -51,12 +59,17 @@ __all__ = [ 'assert_type', 'clear_overloads', 'dataclass_transform', + 'deprecated', + 'Doc', 'get_overloads', 'final', 'get_args', 'get_origin', + 'get_original_bases', + 'get_protocol_members', 'get_type_hints', 'IntVar', + 'is_protocol', 'is_typeddict', 'Literal', 'NewType', @@ -68,12 +81,54 @@ __all__ = [ 'runtime_checkable', 'Text', 'TypeAlias', + 'TypeAliasType', 'TypeGuard', + 'TypeIs', 'TYPE_CHECKING', 'Never', 'NoReturn', + 'ReadOnly', 'Required', 'NotRequired', + + # Pure aliases, have always been in typing + 'AbstractSet', + 'AnyStr', + 'BinaryIO', + 'Callable', + 'Collection', + 'Container', + 'Dict', + 'ForwardRef', + 'FrozenSet', + 'Generator', + 'Generic', + 'Hashable', + 'IO', + 'ItemsView', + 'Iterable', + 'Iterator', + 'KeysView', + 'List', + 'Mapping', + 'MappingView', + 'Match', + 'MutableMapping', + 'MutableSequence', + 'MutableSet', + 'Optional', + 'Pattern', + 'Reversible', + 'Sequence', + 'Set', + 'Sized', + 'TextIO', + 'Tuple', + 'Union', + 'ValuesView', + 'cast', + 'no_type_check', + 'no_type_check_decorator', ] # for backward compatibility @@ -83,7 +138,13 @@ GenericMeta = type # The functions below are modified copies of typing internal helpers. # They are needed by _ProtocolMeta and they provide support for PEP 646. -_marker = object() + +class _Sentinel: + def __repr__(self): + return "" + + +_marker = _Sentinel() def _check_generic(cls, parameters, elen=_marker): @@ -184,36 +245,13 @@ else: ClassVar = typing.ClassVar -# On older versions of typing there is an internal class named "Final". -# 3.8+ -if hasattr(typing, 'Final') and sys.version_info[:2] >= (3, 7): - Final = typing.Final -# 3.7 -else: - class _FinalForm(typing._SpecialForm, _root=True): - def __repr__(self): - return 'typing_extensions.' + self._name +class _ExtensionsSpecialForm(typing._SpecialForm, _root=True): + def __repr__(self): + return 'typing_extensions.' + self._name - def __getitem__(self, parameters): - item = typing._type_check(parameters, - f'{self._name} accepts only a single type.') - return typing._GenericAlias(self, (item,)) - Final = _FinalForm('Final', - doc="""A special typing construct to indicate that a name - cannot be re-assigned or overridden in a subclass. - For example: - - MAX_SIZE: Final = 9000 - MAX_SIZE += 1 # Error reported by type checker - - class Connection: - TIMEOUT: Final[int] = 10 - class FastConnector(Connection): - TIMEOUT = 1 # Error reported by type checker - - There is no runtime checking of these properties.""") +Final = typing.Final if sys.version_info >= (3, 11): final = typing.final @@ -257,21 +295,67 @@ def IntVar(name): return typing.TypeVar(name) -# 3.8+: -if hasattr(typing, 'Literal'): +# A Literal bug was fixed in 3.11.0, 3.10.1 and 3.9.8 +if sys.version_info >= (3, 10, 1): Literal = typing.Literal -# 3.7: else: - class _LiteralForm(typing._SpecialForm, _root=True): + def _flatten_literal_params(parameters): + """An internal helper for Literal creation: flatten Literals among parameters""" + params = [] + for p in parameters: + if isinstance(p, _LiteralGenericAlias): + params.extend(p.__args__) + else: + params.append(p) + return tuple(params) - def __repr__(self): - return 'typing_extensions.' + self._name + def _value_and_type_iter(params): + for p in params: + yield p, type(p) + + class _LiteralGenericAlias(typing._GenericAlias, _root=True): + def __eq__(self, other): + if not isinstance(other, _LiteralGenericAlias): + return NotImplemented + these_args_deduped = set(_value_and_type_iter(self.__args__)) + other_args_deduped = set(_value_and_type_iter(other.__args__)) + return these_args_deduped == other_args_deduped + + def __hash__(self): + return hash(frozenset(_value_and_type_iter(self.__args__))) + + class _LiteralForm(_ExtensionsSpecialForm, _root=True): + def __init__(self, doc: str): + self._name = 'Literal' + self._doc = self.__doc__ = doc def __getitem__(self, parameters): - return typing._GenericAlias(self, parameters) + if not isinstance(parameters, tuple): + parameters = (parameters,) - Literal = _LiteralForm('Literal', - doc="""A type that can be used to indicate to type checkers + parameters = _flatten_literal_params(parameters) + + val_type_pairs = list(_value_and_type_iter(parameters)) + try: + deduped_pairs = set(val_type_pairs) + except TypeError: + # unhashable parameters + pass + else: + # similar logic to typing._deduplicate on Python 3.9+ + if len(deduped_pairs) < len(val_type_pairs): + new_parameters = [] + for pair in val_type_pairs: + if pair in deduped_pairs: + new_parameters.append(pair[0]) + deduped_pairs.remove(pair) + assert not deduped_pairs, deduped_pairs + parameters = tuple(new_parameters) + + return _LiteralGenericAlias(self, parameters) + + Literal = _LiteralForm(doc="""\ + A type that can be used to indicate to type checkers that the corresponding value has a value literally equivalent to the provided parameter. For example: @@ -285,7 +369,7 @@ else: instead of a type.""") -_overload_dummy = typing._overload_dummy # noqa +_overload_dummy = typing._overload_dummy if hasattr(typing, "get_overloads"): # 3.11+ @@ -359,8 +443,6 @@ Type = typing.Type # Various ABCs mimicking those in collections.abc. # A few are simply re-exported for completeness. - - Awaitable = typing.Awaitable Coroutine = typing.Coroutine AsyncIterable = typing.AsyncIterable @@ -369,278 +451,343 @@ Deque = typing.Deque ContextManager = typing.ContextManager AsyncContextManager = typing.AsyncContextManager DefaultDict = typing.DefaultDict - -# 3.7.2+ -if hasattr(typing, 'OrderedDict'): - OrderedDict = typing.OrderedDict -# 3.7.0-3.7.2 -else: - OrderedDict = typing._alias(collections.OrderedDict, (KT, VT)) - +OrderedDict = typing.OrderedDict Counter = typing.Counter ChainMap = typing.ChainMap AsyncGenerator = typing.AsyncGenerator -NewType = typing.NewType Text = typing.Text TYPE_CHECKING = typing.TYPE_CHECKING -_PROTO_WHITELIST = ['Callable', 'Awaitable', - 'Iterable', 'Iterator', 'AsyncIterable', 'AsyncIterator', - 'Hashable', 'Sized', 'Container', 'Collection', 'Reversible', - 'ContextManager', 'AsyncContextManager'] +_PROTO_ALLOWLIST = { + 'collections.abc': [ + 'Callable', 'Awaitable', 'Iterable', 'Iterator', 'AsyncIterable', + 'Hashable', 'Sized', 'Container', 'Collection', 'Reversible', 'Buffer', + ], + 'contextlib': ['AbstractContextManager', 'AbstractAsyncContextManager'], + 'typing_extensions': ['Buffer'], +} + + +_EXCLUDED_ATTRS = { + "__abstractmethods__", "__annotations__", "__weakref__", "_is_protocol", + "_is_runtime_protocol", "__dict__", "__slots__", "__parameters__", + "__orig_bases__", "__module__", "_MutableMapping__marker", "__doc__", + "__subclasshook__", "__orig_class__", "__init__", "__new__", + "__protocol_attrs__", "__non_callable_proto_members__", + "__match_args__", +} + +if sys.version_info >= (3, 9): + _EXCLUDED_ATTRS.add("__class_getitem__") + +if sys.version_info >= (3, 12): + _EXCLUDED_ATTRS.add("__type_params__") + +_EXCLUDED_ATTRS = frozenset(_EXCLUDED_ATTRS) def _get_protocol_attrs(cls): attrs = set() for base in cls.__mro__[:-1]: # without object - if base.__name__ in ('Protocol', 'Generic'): + if base.__name__ in {'Protocol', 'Generic'}: continue annotations = getattr(base, '__annotations__', {}) - for attr in list(base.__dict__.keys()) + list(annotations.keys()): - if (not attr.startswith('_abc_') and attr not in ( - '__abstractmethods__', '__annotations__', '__weakref__', - '_is_protocol', '_is_runtime_protocol', '__dict__', - '__args__', '__slots__', - '__next_in_mro__', '__parameters__', '__origin__', - '__orig_bases__', '__extra__', '__tree_hash__', - '__doc__', '__subclasshook__', '__init__', '__new__', - '__module__', '_MutableMapping__marker', '_gorg')): + for attr in (*base.__dict__, *annotations): + if (not attr.startswith('_abc_') and attr not in _EXCLUDED_ATTRS): attrs.add(attr) return attrs -def _is_callable_members_only(cls): - return all(callable(getattr(cls, attr, None)) for attr in _get_protocol_attrs(cls)) +def _caller(depth=2): + try: + return sys._getframe(depth).f_globals.get('__name__', '__main__') + except (AttributeError, ValueError): # For platforms without _getframe() + return None -def _maybe_adjust_parameters(cls): - """Helper function used in Protocol.__init_subclass__ and _TypedDictMeta.__new__. - - The contents of this function are very similar - to logic found in typing.Generic.__init_subclass__ - on the CPython main branch. - """ - tvars = [] - if '__orig_bases__' in cls.__dict__: - tvars = typing._collect_type_vars(cls.__orig_bases__) - # Look for Generic[T1, ..., Tn] or Protocol[T1, ..., Tn]. - # If found, tvars must be a subset of it. - # If not found, tvars is it. - # Also check for and reject plain Generic, - # and reject multiple Generic[...] and/or Protocol[...]. - gvars = None - for base in cls.__orig_bases__: - if (isinstance(base, typing._GenericAlias) and - base.__origin__ in (typing.Generic, Protocol)): - # for error messages - the_base = base.__origin__.__name__ - if gvars is not None: - raise TypeError( - "Cannot inherit from Generic[...]" - " and/or Protocol[...] multiple types.") - gvars = base.__parameters__ - if gvars is None: - gvars = tvars - else: - tvarset = set(tvars) - gvarset = set(gvars) - if not tvarset <= gvarset: - s_vars = ', '.join(str(t) for t in tvars if t not in gvarset) - s_args = ', '.join(str(g) for g in gvars) - raise TypeError(f"Some type variables ({s_vars}) are" - f" not listed in {the_base}[{s_args}]") - tvars = gvars - cls.__parameters__ = tuple(tvars) - - -# 3.8+ -if hasattr(typing, 'Protocol'): +# `__match_args__` attribute was removed from protocol members in 3.13, +# we want to backport this change to older Python versions. +if sys.version_info >= (3, 13): Protocol = typing.Protocol -# 3.7 else: + def _allow_reckless_class_checks(depth=3): + """Allow instance and class checks for special stdlib modules. + The abc and functools modules indiscriminately call isinstance() and + issubclass() on the whole MRO of a user class, which may contain protocols. + """ + return _caller(depth) in {'abc', 'functools', None} def _no_init(self, *args, **kwargs): if type(self)._is_protocol: raise TypeError('Protocols cannot be instantiated') - class _ProtocolMeta(abc.ABCMeta): # noqa: B024 - # This metaclass is a bit unfortunate and exists only because of the lack - # of __instancehook__. + def _type_check_issubclass_arg_1(arg): + """Raise TypeError if `arg` is not an instance of `type` + in `issubclass(arg, )`. + + In most cases, this is verified by type.__subclasscheck__. + Checking it again unnecessarily would slow down issubclass() checks, + so, we don't perform this check unless we absolutely have to. + + For various error paths, however, + we want to ensure that *this* error message is shown to the user + where relevant, rather than a typing.py-specific error message. + """ + if not isinstance(arg, type): + # Same error message as for issubclass(1, int). + raise TypeError('issubclass() arg 1 must be a class') + + # Inheriting from typing._ProtocolMeta isn't actually desirable, + # but is necessary to allow typing.Protocol and typing_extensions.Protocol + # to mix without getting TypeErrors about "metaclass conflict" + class _ProtocolMeta(type(typing.Protocol)): + # This metaclass is somewhat unfortunate, + # but is necessary for several reasons... + # + # NOTE: DO NOT call super() in any methods in this class + # That would call the methods on typing._ProtocolMeta on Python 3.8-3.11 + # and those are slow + def __new__(mcls, name, bases, namespace, **kwargs): + if name == "Protocol" and len(bases) < 2: + pass + elif {Protocol, typing.Protocol} & set(bases): + for base in bases: + if not ( + base in {object, typing.Generic, Protocol, typing.Protocol} + or base.__name__ in _PROTO_ALLOWLIST.get(base.__module__, []) + or is_protocol(base) + ): + raise TypeError( + f"Protocols can only inherit from other protocols, " + f"got {base!r}" + ) + return abc.ABCMeta.__new__(mcls, name, bases, namespace, **kwargs) + + def __init__(cls, *args, **kwargs): + abc.ABCMeta.__init__(cls, *args, **kwargs) + if getattr(cls, "_is_protocol", False): + cls.__protocol_attrs__ = _get_protocol_attrs(cls) + + def __subclasscheck__(cls, other): + if cls is Protocol: + return type.__subclasscheck__(cls, other) + if ( + getattr(cls, '_is_protocol', False) + and not _allow_reckless_class_checks() + ): + if not getattr(cls, '_is_runtime_protocol', False): + _type_check_issubclass_arg_1(other) + raise TypeError( + "Instance and class checks can only be used with " + "@runtime_checkable protocols" + ) + if ( + # this attribute is set by @runtime_checkable: + cls.__non_callable_proto_members__ + and cls.__dict__.get("__subclasshook__") is _proto_hook + ): + _type_check_issubclass_arg_1(other) + non_method_attrs = sorted(cls.__non_callable_proto_members__) + raise TypeError( + "Protocols with non-method members don't support issubclass()." + f" Non-method members: {str(non_method_attrs)[1:-1]}." + ) + return abc.ABCMeta.__subclasscheck__(cls, other) + def __instancecheck__(cls, instance): # We need this method for situations where attributes are # assigned in __init__. - if ((not getattr(cls, '_is_protocol', False) or - _is_callable_members_only(cls)) and - issubclass(instance.__class__, cls)): + if cls is Protocol: + return type.__instancecheck__(cls, instance) + if not getattr(cls, "_is_protocol", False): + # i.e., it's a concrete subclass of a protocol + return abc.ABCMeta.__instancecheck__(cls, instance) + + if ( + not getattr(cls, '_is_runtime_protocol', False) and + not _allow_reckless_class_checks() + ): + raise TypeError("Instance and class checks can only be used with" + " @runtime_checkable protocols") + + if abc.ABCMeta.__instancecheck__(cls, instance): return True - if cls._is_protocol: - if all(hasattr(instance, attr) and - (not callable(getattr(cls, attr, None)) or - getattr(instance, attr) is not None) - for attr in _get_protocol_attrs(cls)): - return True - return super().__instancecheck__(instance) - class Protocol(metaclass=_ProtocolMeta): - # There is quite a lot of overlapping code with typing.Generic. - # Unfortunately it is hard to avoid this while these live in two different - # modules. The duplicated code will be removed when Protocol is moved to typing. - """Base class for protocol classes. Protocol classes are defined as:: + for attr in cls.__protocol_attrs__: + try: + val = inspect.getattr_static(instance, attr) + except AttributeError: + break + # this attribute is set by @runtime_checkable: + if val is None and attr not in cls.__non_callable_proto_members__: + break + else: + return True - class Proto(Protocol): - def meth(self) -> int: - ... + return False - Such classes are primarily used with static type checkers that recognize - structural subtyping (static duck-typing), for example:: + def __eq__(cls, other): + # Hack so that typing.Generic.__class_getitem__ + # treats typing_extensions.Protocol + # as equivalent to typing.Protocol + if abc.ABCMeta.__eq__(cls, other) is True: + return True + return cls is Protocol and other is typing.Protocol - class C: - def meth(self) -> int: - return 0 + # This has to be defined, or the abc-module cache + # complains about classes with this metaclass being unhashable, + # if we define only __eq__! + def __hash__(cls) -> int: + return type.__hash__(cls) - def func(x: Proto) -> int: - return x.meth() + @classmethod + def _proto_hook(cls, other): + if not cls.__dict__.get('_is_protocol', False): + return NotImplemented - func(C()) # Passes static type check + for attr in cls.__protocol_attrs__: + for base in other.__mro__: + # Check if the members appears in the class dictionary... + if attr in base.__dict__: + if base.__dict__[attr] is None: + return NotImplemented + break - See PEP 544 for details. Protocol classes decorated with - @typing_extensions.runtime act as simple-minded runtime protocol that checks - only the presence of given attributes, ignoring their type signatures. + # ...or in annotations, if it is a sub-protocol. + annotations = getattr(base, '__annotations__', {}) + if ( + isinstance(annotations, collections.abc.Mapping) + and attr in annotations + and is_protocol(other) + ): + break + else: + return NotImplemented + return True - Protocol classes can be generic, they are defined as:: - - class GenProto(Protocol[T]): - def meth(self) -> T: - ... - """ + class Protocol(typing.Generic, metaclass=_ProtocolMeta): + __doc__ = typing.Protocol.__doc__ __slots__ = () _is_protocol = True - - def __new__(cls, *args, **kwds): - if cls is Protocol: - raise TypeError("Type Protocol cannot be instantiated; " - "it can only be used as a base class") - return super().__new__(cls) - - @typing._tp_cache - def __class_getitem__(cls, params): - if not isinstance(params, tuple): - params = (params,) - if not params and cls is not typing.Tuple: - raise TypeError( - f"Parameter list to {cls.__qualname__}[...] cannot be empty") - msg = "Parameters to generic types must be types." - params = tuple(typing._type_check(p, msg) for p in params) # noqa - if cls is Protocol: - # Generic can only be subscripted with unique type variables. - if not all(isinstance(p, typing.TypeVar) for p in params): - i = 0 - while isinstance(params[i], typing.TypeVar): - i += 1 - raise TypeError( - "Parameters to Protocol[...] must all be type variables." - f" Parameter {i + 1} is {params[i]}") - if len(set(params)) != len(params): - raise TypeError( - "Parameters to Protocol[...] must all be unique") - else: - # Subscripting a regular Generic subclass. - _check_generic(cls, params, len(cls.__parameters__)) - return typing._GenericAlias(cls, params) + _is_runtime_protocol = False def __init_subclass__(cls, *args, **kwargs): - if '__orig_bases__' in cls.__dict__: - error = typing.Generic in cls.__orig_bases__ - else: - error = typing.Generic in cls.__bases__ - if error: - raise TypeError("Cannot inherit from plain Generic") - _maybe_adjust_parameters(cls) + super().__init_subclass__(*args, **kwargs) # Determine if this is a protocol or a concrete subclass. - if not cls.__dict__.get('_is_protocol', None): + if not cls.__dict__.get('_is_protocol', False): cls._is_protocol = any(b is Protocol for b in cls.__bases__) # Set (or override) the protocol subclass hook. - def _proto_hook(other): - if not cls.__dict__.get('_is_protocol', None): - return NotImplemented - if not getattr(cls, '_is_runtime_protocol', False): - if sys._getframe(2).f_globals['__name__'] in ['abc', 'functools']: - return NotImplemented - raise TypeError("Instance and class checks can only be used with" - " @runtime protocols") - if not _is_callable_members_only(cls): - if sys._getframe(2).f_globals['__name__'] in ['abc', 'functools']: - return NotImplemented - raise TypeError("Protocols with non-method members" - " don't support issubclass()") - if not isinstance(other, type): - # Same error as for issubclass(1, int) - raise TypeError('issubclass() arg 1 must be a class') - for attr in _get_protocol_attrs(cls): - for base in other.__mro__: - if attr in base.__dict__: - if base.__dict__[attr] is None: - return NotImplemented - break - annotations = getattr(base, '__annotations__', {}) - if (isinstance(annotations, typing.Mapping) and - attr in annotations and - isinstance(other, _ProtocolMeta) and - other._is_protocol): - break - else: - return NotImplemented - return True if '__subclasshook__' not in cls.__dict__: cls.__subclasshook__ = _proto_hook - # We have nothing more to do for non-protocols. - if not cls._is_protocol: - return - - # Check consistency of bases. - for base in cls.__bases__: - if not (base in (object, typing.Generic) or - base.__module__ == 'collections.abc' and - base.__name__ in _PROTO_WHITELIST or - isinstance(base, _ProtocolMeta) and base._is_protocol): - raise TypeError('Protocols can only inherit from other' - f' protocols, got {repr(base)}') - cls.__init__ = _no_init + # Prohibit instantiation for protocol classes + if cls._is_protocol and cls.__init__ is Protocol.__init__: + cls.__init__ = _no_init -# 3.8+ -if hasattr(typing, 'runtime_checkable'): +if sys.version_info >= (3, 13): runtime_checkable = typing.runtime_checkable -# 3.7 else: def runtime_checkable(cls): - """Mark a protocol class as a runtime protocol, so that it - can be used with isinstance() and issubclass(). Raise TypeError - if applied to a non-protocol class. + """Mark a protocol class as a runtime protocol. - This allows a simple-minded structural check very similar to the - one-offs in collections.abc such as Hashable. + Such protocol can be used with isinstance() and issubclass(). + Raise TypeError if applied to a non-protocol class. + This allows a simple-minded structural check very similar to + one trick ponies in collections.abc such as Iterable. + + For example:: + + @runtime_checkable + class Closable(Protocol): + def close(self): ... + + assert isinstance(open('/some/file'), Closable) + + Warning: this will check only the presence of the required methods, + not their type signatures! """ - if not isinstance(cls, _ProtocolMeta) or not cls._is_protocol: + if not issubclass(cls, typing.Generic) or not getattr(cls, '_is_protocol', False): raise TypeError('@runtime_checkable can be only applied to protocol classes,' - f' got {cls!r}') + ' got %r' % cls) cls._is_runtime_protocol = True + + # Only execute the following block if it's a typing_extensions.Protocol class. + # typing.Protocol classes don't need it. + if isinstance(cls, _ProtocolMeta): + # PEP 544 prohibits using issubclass() + # with protocols that have non-method members. + # See gh-113320 for why we compute this attribute here, + # rather than in `_ProtocolMeta.__init__` + cls.__non_callable_proto_members__ = set() + for attr in cls.__protocol_attrs__: + try: + is_callable = callable(getattr(cls, attr, None)) + except Exception as e: + raise TypeError( + f"Failed to determine whether protocol member {attr!r} " + "is a method member" + ) from e + else: + if not is_callable: + cls.__non_callable_proto_members__.add(attr) + return cls -# Exists for backwards compatibility. +# The "runtime" alias exists for backwards compatibility. runtime = runtime_checkable -# 3.8+ -if hasattr(typing, 'SupportsIndex'): +# Our version of runtime-checkable protocols is faster on Python 3.8-3.11 +if sys.version_info >= (3, 12): + SupportsInt = typing.SupportsInt + SupportsFloat = typing.SupportsFloat + SupportsComplex = typing.SupportsComplex + SupportsBytes = typing.SupportsBytes SupportsIndex = typing.SupportsIndex -# 3.7 + SupportsAbs = typing.SupportsAbs + SupportsRound = typing.SupportsRound else: + @runtime_checkable + class SupportsInt(Protocol): + """An ABC with one abstract method __int__.""" + __slots__ = () + + @abc.abstractmethod + def __int__(self) -> int: + pass + + @runtime_checkable + class SupportsFloat(Protocol): + """An ABC with one abstract method __float__.""" + __slots__ = () + + @abc.abstractmethod + def __float__(self) -> float: + pass + + @runtime_checkable + class SupportsComplex(Protocol): + """An ABC with one abstract method __complex__.""" + __slots__ = () + + @abc.abstractmethod + def __complex__(self) -> complex: + pass + + @runtime_checkable + class SupportsBytes(Protocol): + """An ABC with one abstract method __bytes__.""" + __slots__ = () + + @abc.abstractmethod + def __bytes__(self) -> bytes: + pass + @runtime_checkable class SupportsIndex(Protocol): __slots__ = () @@ -649,8 +796,45 @@ else: def __index__(self) -> int: pass + @runtime_checkable + class SupportsAbs(Protocol[T_co]): + """ + An ABC with one abstract method __abs__ that is covariant in its return type. + """ + __slots__ = () -if hasattr(typing, "Required"): + @abc.abstractmethod + def __abs__(self) -> T_co: + pass + + @runtime_checkable + class SupportsRound(Protocol[T_co]): + """ + An ABC with one abstract method __round__ that is covariant in its return type. + """ + __slots__ = () + + @abc.abstractmethod + def __round__(self, ndigits: int = 0) -> T_co: + pass + + +def _ensure_subclassable(mro_entries): + def inner(func): + if sys.implementation.name == "pypy" and sys.version_info < (3, 9): + cls_dict = { + "__call__": staticmethod(func), + "__mro_entries__": staticmethod(mro_entries) + } + t = type(func.__name__, (), cls_dict) + return functools.update_wrapper(t(), func) + else: + func.__mro_entries__ = mro_entries + return func + return inner + + +if hasattr(typing, "ReadOnly"): # The standard library TypedDict in Python 3.8 does not store runtime information # about which (if any) keys are optional. See https://bugs.python.org/issue38834 # The standard library TypedDict in Python 3.9.0/1 does not honour the "total" @@ -658,148 +842,164 @@ if hasattr(typing, "Required"): # The standard library TypedDict below Python 3.11 does not store runtime # information about optional and required keys when using Required or NotRequired. # Generic TypedDicts are also impossible using typing.TypedDict on Python <3.11. + # Aaaand on 3.12 we add __orig_bases__ to TypedDict + # to enable better runtime introspection. + # On 3.13 we deprecate some odd ways of creating TypedDicts. + # PEP 705 proposes adding the ReadOnly[] qualifier. TypedDict = typing.TypedDict _TypedDictMeta = typing._TypedDictMeta is_typeddict = typing.is_typeddict else: - def _check_fails(cls, other): - try: - if sys._getframe(1).f_globals['__name__'] not in ['abc', - 'functools', - 'typing']: - # Typed dicts are only for static structural subtyping. - raise TypeError('TypedDict does not support instance and class checks') - except (AttributeError, ValueError): - pass - return False + # 3.10.0 and later + _TAKES_MODULE = "module" in inspect.signature(typing._type_check).parameters - def _dict_new(*args, **kwargs): - if not args: - raise TypeError('TypedDict.__new__(): not enough arguments') - _, args = args[0], args[1:] # allow the "cls" keyword be passed - return dict(*args, **kwargs) - - _dict_new.__text_signature__ = '($cls, _typename, _fields=None, /, **kwargs)' - - def _typeddict_new(*args, total=True, **kwargs): - if not args: - raise TypeError('TypedDict.__new__(): not enough arguments') - _, args = args[0], args[1:] # allow the "cls" keyword be passed - if args: - typename, args = args[0], args[1:] # allow the "_typename" keyword be passed - elif '_typename' in kwargs: - typename = kwargs.pop('_typename') - import warnings - warnings.warn("Passing '_typename' as keyword argument is deprecated", - DeprecationWarning, stacklevel=2) - else: - raise TypeError("TypedDict.__new__() missing 1 required positional " - "argument: '_typename'") - if args: - try: - fields, = args # allow the "_fields" keyword be passed - except ValueError: - raise TypeError('TypedDict.__new__() takes from 2 to 3 ' - f'positional arguments but {len(args) + 2} ' - 'were given') - elif '_fields' in kwargs and len(kwargs) == 1: - fields = kwargs.pop('_fields') - import warnings - warnings.warn("Passing '_fields' as keyword argument is deprecated", - DeprecationWarning, stacklevel=2) - else: - fields = None - - if fields is None: - fields = kwargs - elif kwargs: - raise TypeError("TypedDict takes either a dict or keyword arguments," - " but not both") - - ns = {'__annotations__': dict(fields)} - try: - # Setting correct module is necessary to make typed dict classes pickleable. - ns['__module__'] = sys._getframe(1).f_globals.get('__name__', '__main__') - except (AttributeError, ValueError): - pass - - return _TypedDictMeta(typename, (), ns, total=total) - - _typeddict_new.__text_signature__ = ('($cls, _typename, _fields=None,' - ' /, *, total=True, **kwargs)') + def _get_typeddict_qualifiers(annotation_type): + while True: + annotation_origin = get_origin(annotation_type) + if annotation_origin is Annotated: + annotation_args = get_args(annotation_type) + if annotation_args: + annotation_type = annotation_args[0] + else: + break + elif annotation_origin is Required: + yield Required + annotation_type, = get_args(annotation_type) + elif annotation_origin is NotRequired: + yield NotRequired + annotation_type, = get_args(annotation_type) + elif annotation_origin is ReadOnly: + yield ReadOnly + annotation_type, = get_args(annotation_type) + else: + break class _TypedDictMeta(type): - def __init__(cls, name, bases, ns, total=True): - super().__init__(name, bases, ns) + def __new__(cls, name, bases, ns, *, total=True, closed=False): + """Create new typed dict class object. - def __new__(cls, name, bases, ns, total=True): - # Create new typed dict class object. - # This method is called directly when TypedDict is subclassed, - # or via _typeddict_new when TypedDict is instantiated. This way - # TypedDict supports all three syntaxes described in its docstring. - # Subclasses and instances of TypedDict return actual dictionaries - # via _dict_new. - ns['__new__'] = _typeddict_new if name == 'TypedDict' else _dict_new - # Don't insert typing.Generic into __bases__ here, - # or Generic.__init_subclass__ will raise TypeError - # in the super().__new__() call. - # Instead, monkey-patch __bases__ onto the class after it's been created. - tp_dict = super().__new__(cls, name, (dict,), ns) + This method is called when TypedDict is subclassed, + or when TypedDict is instantiated. This way + TypedDict supports all three syntax forms described in its docstring. + Subclasses and instances of TypedDict return actual dictionaries. + """ + for base in bases: + if type(base) is not _TypedDictMeta and base is not typing.Generic: + raise TypeError('cannot inherit from both a TypedDict type ' + 'and a non-TypedDict base class') - if any(issubclass(base, typing.Generic) for base in bases): - tp_dict.__bases__ = (typing.Generic, dict) - _maybe_adjust_parameters(tp_dict) + if any(issubclass(b, typing.Generic) for b in bases): + generic_base = (typing.Generic,) + else: + generic_base = () + + # typing.py generally doesn't let you inherit from plain Generic, unless + # the name of the class happens to be "Protocol" + tp_dict = type.__new__(_TypedDictMeta, "Protocol", (*generic_base, dict), ns) + tp_dict.__name__ = name + if tp_dict.__qualname__ == "Protocol": + tp_dict.__qualname__ = name + + if not hasattr(tp_dict, '__orig_bases__'): + tp_dict.__orig_bases__ = bases annotations = {} own_annotations = ns.get('__annotations__', {}) msg = "TypedDict('Name', {f0: t0, f1: t1, ...}); each t must be a type" - own_annotations = { - n: typing._type_check(tp, msg) for n, tp in own_annotations.items() - } + if _TAKES_MODULE: + own_annotations = { + n: typing._type_check(tp, msg, module=tp_dict.__module__) + for n, tp in own_annotations.items() + } + else: + own_annotations = { + n: typing._type_check(tp, msg) + for n, tp in own_annotations.items() + } required_keys = set() optional_keys = set() + readonly_keys = set() + mutable_keys = set() + extra_items_type = None for base in bases: - annotations.update(base.__dict__.get('__annotations__', {})) - required_keys.update(base.__dict__.get('__required_keys__', ())) - optional_keys.update(base.__dict__.get('__optional_keys__', ())) + base_dict = base.__dict__ + + annotations.update(base_dict.get('__annotations__', {})) + required_keys.update(base_dict.get('__required_keys__', ())) + optional_keys.update(base_dict.get('__optional_keys__', ())) + readonly_keys.update(base_dict.get('__readonly_keys__', ())) + mutable_keys.update(base_dict.get('__mutable_keys__', ())) + base_extra_items_type = base_dict.get('__extra_items__', None) + if base_extra_items_type is not None: + extra_items_type = base_extra_items_type + + if closed and extra_items_type is None: + extra_items_type = Never + if closed and "__extra_items__" in own_annotations: + annotation_type = own_annotations.pop("__extra_items__") + qualifiers = set(_get_typeddict_qualifiers(annotation_type)) + if Required in qualifiers: + raise TypeError( + "Special key __extra_items__ does not support " + "Required" + ) + if NotRequired in qualifiers: + raise TypeError( + "Special key __extra_items__ does not support " + "NotRequired" + ) + extra_items_type = annotation_type annotations.update(own_annotations) for annotation_key, annotation_type in own_annotations.items(): - annotation_origin = get_origin(annotation_type) - if annotation_origin is Annotated: - annotation_args = get_args(annotation_type) - if annotation_args: - annotation_type = annotation_args[0] - annotation_origin = get_origin(annotation_type) + qualifiers = set(_get_typeddict_qualifiers(annotation_type)) - if annotation_origin is Required: + if Required in qualifiers: required_keys.add(annotation_key) - elif annotation_origin is NotRequired: + elif NotRequired in qualifiers: optional_keys.add(annotation_key) elif total: required_keys.add(annotation_key) else: optional_keys.add(annotation_key) + if ReadOnly in qualifiers: + mutable_keys.discard(annotation_key) + readonly_keys.add(annotation_key) + else: + mutable_keys.add(annotation_key) + readonly_keys.discard(annotation_key) tp_dict.__annotations__ = annotations tp_dict.__required_keys__ = frozenset(required_keys) tp_dict.__optional_keys__ = frozenset(optional_keys) + tp_dict.__readonly_keys__ = frozenset(readonly_keys) + tp_dict.__mutable_keys__ = frozenset(mutable_keys) if not hasattr(tp_dict, '__total__'): tp_dict.__total__ = total + tp_dict.__closed__ = closed + tp_dict.__extra_items__ = extra_items_type return tp_dict - __instancecheck__ = __subclasscheck__ = _check_fails + __call__ = dict # static method - TypedDict = _TypedDictMeta('TypedDict', (dict,), {}) - TypedDict.__module__ = __name__ - TypedDict.__doc__ = \ - """A simple typed name space. At runtime it is equivalent to a plain dict. + def __subclasscheck__(cls, other): + # Typed dicts are only for static structural subtyping. + raise TypeError('TypedDict does not support instance and class checks') - TypedDict creates a dictionary type that expects all of its - instances to have a certain set of keys, with each key + __instancecheck__ = __subclasscheck__ + + _TypedDict = type.__new__(_TypedDictMeta, 'TypedDict', (), {}) + + @_ensure_subclassable(lambda bases: (_TypedDict,)) + def TypedDict(typename, fields=_marker, /, *, total=True, closed=False, **kwargs): + """A simple typed namespace. At runtime it is equivalent to a plain dict. + + TypedDict creates a dictionary type such that a type checker will expect all + instances to have a certain set of keys, where each key is associated with a value of a consistent type. This expectation - is not checked at runtime but is only enforced by type checkers. + is not checked at runtime. + Usage:: class Point2D(TypedDict): @@ -814,14 +1014,71 @@ else: The type info can be accessed via the Point2D.__annotations__ dict, and the Point2D.__required_keys__ and Point2D.__optional_keys__ frozensets. - TypedDict supports two additional equivalent forms:: + TypedDict supports an additional equivalent form:: - Point2D = TypedDict('Point2D', x=int, y=int, label=str) Point2D = TypedDict('Point2D', {'x': int, 'y': int, 'label': str}) - The class syntax is only supported in Python 3.6+, while two other - syntax forms work for Python 2.7 and 3.2+ + By default, all keys must be present in a TypedDict. It is possible + to override this by specifying totality:: + + class Point2D(TypedDict, total=False): + x: int + y: int + + This means that a Point2D TypedDict can have any of the keys omitted. A type + checker is only expected to support a literal False or True as the value of + the total argument. True is the default, and makes all items defined in the + class body be required. + + The Required and NotRequired special forms can also be used to mark + individual keys as being required or not required:: + + class Point2D(TypedDict): + x: int # the "x" key must always be present (Required is the default) + y: NotRequired[int] # the "y" key can be omitted + + See PEP 655 for more details on Required and NotRequired. """ + if fields is _marker or fields is None: + if fields is _marker: + deprecated_thing = "Failing to pass a value for the 'fields' parameter" + else: + deprecated_thing = "Passing `None` as the 'fields' parameter" + + example = f"`{typename} = TypedDict({typename!r}, {{}})`" + deprecation_msg = ( + f"{deprecated_thing} is deprecated and will be disallowed in " + "Python 3.15. To create a TypedDict class with 0 fields " + "using the functional syntax, pass an empty dictionary, e.g. " + ) + example + "." + warnings.warn(deprecation_msg, DeprecationWarning, stacklevel=2) + if closed is not False and closed is not True: + kwargs["closed"] = closed + closed = False + fields = kwargs + elif kwargs: + raise TypeError("TypedDict takes either a dict or keyword arguments," + " but not both") + if kwargs: + if sys.version_info >= (3, 13): + raise TypeError("TypedDict takes no keyword arguments") + warnings.warn( + "The kwargs-based syntax for TypedDict definitions is deprecated " + "in Python 3.11, will be removed in Python 3.13, and may not be " + "understood by third-party type checkers.", + DeprecationWarning, + stacklevel=2, + ) + + ns = {'__annotations__': dict(fields)} + module = _caller() + if module is not None: + # Setting correct module is necessary to make typed dict classes pickleable. + ns['__module__'] = module + + td = _TypedDictMeta(typename, (), ns, total=total, closed=closed) + td.__orig_bases__ = (TypedDict,) + return td if hasattr(typing, "_TypedDictMeta"): _TYPEDDICT_TYPES = (typing._TypedDictMeta, _TypedDictMeta) @@ -839,14 +1096,17 @@ else: is_typeddict(Film) # => True is_typeddict(Union[list, str]) # => False """ - return isinstance(tp, tuple(_TYPEDDICT_TYPES)) + # On 3.8, this would otherwise return True + if hasattr(typing, "TypedDict") and tp is typing.TypedDict: + return False + return isinstance(tp, _TYPEDDICT_TYPES) if hasattr(typing, "assert_type"): assert_type = typing.assert_type else: - def assert_type(__val, __typ): + def assert_type(val, typ, /): """Assert (to the type checker) that the value is of the given type. When the type checker encounters a call to assert_type(), it @@ -859,15 +1119,12 @@ else: At runtime this returns the first argument unchanged and otherwise does nothing. """ - return __val + return val -if hasattr(typing, "Required"): +if hasattr(typing, "Required"): # 3.11+ get_type_hints = typing.get_type_hints -else: - import functools - import types - +else: # <=3.10 # replaces _strip_annotations() def _strip_extras(t): """Strips Annotated, Required and NotRequired from a given type.""" @@ -880,12 +1137,12 @@ else: if stripped_args == t.__args__: return t return t.copy_with(stripped_args) - if hasattr(types, "GenericAlias") and isinstance(t, types.GenericAlias): + if hasattr(_types, "GenericAlias") and isinstance(t, _types.GenericAlias): stripped_args = tuple(_strip_extras(a) for a in t.__args__) if stripped_args == t.__args__: return t - return types.GenericAlias(t.__origin__, stripped_args) - if hasattr(types, "UnionType") and isinstance(t, types.UnionType): + return _types.GenericAlias(t.__origin__, stripped_args) + if hasattr(_types, "UnionType") and isinstance(t, _types.UnionType): stripped_args = tuple(_strip_extras(a) for a in t.__args__) if stripped_args == t.__args__: return t @@ -925,11 +1182,11 @@ else: - If two dict arguments are passed, they specify globals and locals, respectively. """ - if hasattr(typing, "Annotated"): + if hasattr(typing, "Annotated"): # 3.9+ hint = typing.get_type_hints( obj, globalns=globalns, localns=localns, include_extras=True ) - else: + else: # 3.8 hint = typing.get_type_hints(obj, globalns=globalns, localns=localns) if include_extras: return hint @@ -942,7 +1199,7 @@ if hasattr(typing, 'Annotated'): # Not exported and not a public API, but needed for get_origin() and get_args() # to work. _AnnotatedAlias = typing._AnnotatedAlias -# 3.7-3.8 +# 3.8 else: class _AnnotatedAlias(typing._GenericAlias, _root=True): """Runtime representation of an annotated type. @@ -1047,7 +1304,7 @@ else: if sys.version_info[:2] >= (3, 10): get_origin = typing.get_origin get_args = typing.get_args -# 3.7-3.9 +# 3.8-3.9 else: try: # 3.9+ @@ -1112,11 +1369,7 @@ if hasattr(typing, 'TypeAlias'): TypeAlias = typing.TypeAlias # 3.9 elif sys.version_info[:2] >= (3, 9): - class _TypeAliasForm(typing._SpecialForm, _root=True): - def __repr__(self): - return 'typing_extensions.' + self._name - - @_TypeAliasForm + @_ExtensionsSpecialForm def TypeAlias(self, parameters): """Special marker indicating that an assignment should be recognized as a proper type alias definition by type @@ -1129,68 +1382,89 @@ elif sys.version_info[:2] >= (3, 9): It's invalid when used anywhere except as in the example above. """ raise TypeError(f"{self} is not subscriptable") -# 3.7-3.8 +# 3.8 else: - class _TypeAliasForm(typing._SpecialForm, _root=True): - def __repr__(self): - return 'typing_extensions.' + self._name + TypeAlias = _ExtensionsSpecialForm( + 'TypeAlias', + doc="""Special marker indicating that an assignment should + be recognized as a proper type alias definition by type + checkers. - TypeAlias = _TypeAliasForm('TypeAlias', - doc="""Special marker indicating that an assignment should - be recognized as a proper type alias definition by type - checkers. + For example:: - For example:: + Predicate: TypeAlias = Callable[..., bool] - Predicate: TypeAlias = Callable[..., bool] + It's invalid when used anywhere except as in the example + above.""" + ) - It's invalid when used anywhere except as in the example - above.""") + +def _set_default(type_param, default): + if isinstance(default, (tuple, list)): + type_param.__default__ = tuple((typing._type_check(d, "Default must be a type") + for d in default)) + elif default != _marker: + if isinstance(type_param, ParamSpec) and default is ...: # ... not valid <3.11 + type_param.__default__ = default + else: + type_param.__default__ = typing._type_check(default, "Default must be a type") + else: + type_param.__default__ = None + + +def _set_module(typevarlike): + # for pickling: + def_mod = _caller(depth=3) + if def_mod != 'typing_extensions': + typevarlike.__module__ = def_mod class _DefaultMixin: """Mixin for TypeVarLike defaults.""" __slots__ = () + __init__ = _set_default - def __init__(self, default): - if isinstance(default, (tuple, list)): - self.__default__ = tuple((typing._type_check(d, "Default must be a type") - for d in default)) - elif default: - self.__default__ = typing._type_check(default, "Default must be a type") - else: - self.__default__ = None + +# Classes using this metaclass must provide a _backported_typevarlike ClassVar +class _TypeVarLikeMeta(type): + def __instancecheck__(cls, __instance: Any) -> bool: + return isinstance(__instance, cls._backported_typevarlike) # Add default and infer_variance parameters from PEP 696 and 695 -class TypeVar(typing.TypeVar, _DefaultMixin, _root=True): +class TypeVar(metaclass=_TypeVarLikeMeta): """Type variable.""" - __module__ = 'typing' + _backported_typevarlike = typing.TypeVar - def __init__(self, name, *constraints, bound=None, - covariant=False, contravariant=False, - default=None, infer_variance=False): - super().__init__(name, *constraints, bound=bound, covariant=covariant, - contravariant=contravariant) - _DefaultMixin.__init__(self, default) - self.__infer_variance__ = infer_variance + def __new__(cls, name, *constraints, bound=None, + covariant=False, contravariant=False, + default=_marker, infer_variance=False): + if hasattr(typing, "TypeAliasType"): + # PEP 695 implemented (3.12+), can pass infer_variance to typing.TypeVar + typevar = typing.TypeVar(name, *constraints, bound=bound, + covariant=covariant, contravariant=contravariant, + infer_variance=infer_variance) + else: + typevar = typing.TypeVar(name, *constraints, bound=bound, + covariant=covariant, contravariant=contravariant) + if infer_variance and (covariant or contravariant): + raise ValueError("Variance cannot be specified with infer_variance.") + typevar.__infer_variance__ = infer_variance + _set_default(typevar, default) + _set_module(typevar) + return typevar - # for pickling: - try: - def_mod = sys._getframe(1).f_globals.get('__name__', '__main__') - except (AttributeError, ValueError): - def_mod = None - if def_mod != 'typing_extensions': - self.__module__ = def_mod + def __init_subclass__(cls) -> None: + raise TypeError(f"type '{__name__}.TypeVar' is not an acceptable base type") # Python 3.10+ has PEP 612 if hasattr(typing, 'ParamSpecArgs'): ParamSpecArgs = typing.ParamSpecArgs ParamSpecKwargs = typing.ParamSpecKwargs -# 3.7-3.9 +# 3.8-3.9 else: class _Immutable: """Mixin to indicate that object should not be copied.""" @@ -1251,27 +1525,35 @@ else: # 3.10+ if hasattr(typing, 'ParamSpec'): - # Add default Parameter - PEP 696 - class ParamSpec(typing.ParamSpec, _DefaultMixin, _root=True): - """Parameter specification variable.""" + # Add default parameter - PEP 696 + class ParamSpec(metaclass=_TypeVarLikeMeta): + """Parameter specification.""" - __module__ = 'typing' + _backported_typevarlike = typing.ParamSpec - def __init__(self, name, *, bound=None, covariant=False, contravariant=False, - default=None): - super().__init__(name, bound=bound, covariant=covariant, - contravariant=contravariant) - _DefaultMixin.__init__(self, default) + def __new__(cls, name, *, bound=None, + covariant=False, contravariant=False, + infer_variance=False, default=_marker): + if hasattr(typing, "TypeAliasType"): + # PEP 695 implemented, can pass infer_variance to typing.TypeVar + paramspec = typing.ParamSpec(name, bound=bound, + covariant=covariant, + contravariant=contravariant, + infer_variance=infer_variance) + else: + paramspec = typing.ParamSpec(name, bound=bound, + covariant=covariant, + contravariant=contravariant) + paramspec.__infer_variance__ = infer_variance - # for pickling: - try: - def_mod = sys._getframe(1).f_globals.get('__name__', '__main__') - except (AttributeError, ValueError): - def_mod = None - if def_mod != 'typing_extensions': - self.__module__ = def_mod + _set_default(paramspec, default) + _set_module(paramspec) + return paramspec -# 3.7-3.9 + def __init_subclass__(cls) -> None: + raise TypeError(f"type '{__name__}.ParamSpec' is not an acceptable base type") + +# 3.8-3.9 else: # Inherits from list as a workaround for Callable checks in Python < 3.9.2. @@ -1334,11 +1616,12 @@ else: return ParamSpecKwargs(self) def __init__(self, name, *, bound=None, covariant=False, contravariant=False, - default=None): + infer_variance=False, default=_marker): super().__init__([self]) self.__name__ = name self.__covariant__ = bool(covariant) self.__contravariant__ = bool(contravariant) + self.__infer_variance__ = bool(infer_variance) if bound: self.__bound__ = typing._type_check(bound, 'Bound must be a type.') else: @@ -1346,15 +1629,14 @@ else: _DefaultMixin.__init__(self, default) # for pickling: - try: - def_mod = sys._getframe(1).f_globals.get('__name__', '__main__') - except (AttributeError, ValueError): - def_mod = None + def_mod = _caller() if def_mod != 'typing_extensions': self.__module__ = def_mod def __repr__(self): - if self.__covariant__: + if self.__infer_variance__: + prefix = '' + elif self.__covariant__: prefix = '+' elif self.__contravariant__: prefix = '-' @@ -1376,7 +1658,7 @@ else: pass -# 3.7-3.9 +# 3.8-3.9 if not hasattr(typing, 'Concatenate'): # Inherits from list as a workaround for Callable checks in Python < 3.9.2. class _ConcatenateGenericAlias(list): @@ -1411,7 +1693,7 @@ if not hasattr(typing, 'Concatenate'): ) -# 3.7-3.9 +# 3.8-3.9 @typing._tp_cache def _concatenate_getitem(self, parameters): if parameters == (): @@ -1429,10 +1711,10 @@ def _concatenate_getitem(self, parameters): # 3.10+ if hasattr(typing, 'Concatenate'): Concatenate = typing.Concatenate - _ConcatenateGenericAlias = typing._ConcatenateGenericAlias # noqa + _ConcatenateGenericAlias = typing._ConcatenateGenericAlias # noqa: F811 # 3.9 elif sys.version_info[:2] >= (3, 9): - @_TypeAliasForm + @_ExtensionsSpecialForm def Concatenate(self, parameters): """Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a higher order function which adds, removes or transforms parameters of a @@ -1445,12 +1727,9 @@ elif sys.version_info[:2] >= (3, 9): See PEP 612 for detailed information. """ return _concatenate_getitem(self, parameters) -# 3.7-8 +# 3.8 else: - class _ConcatenateForm(typing._SpecialForm, _root=True): - def __repr__(self): - return 'typing_extensions.' + self._name - + class _ConcatenateForm(_ExtensionsSpecialForm, _root=True): def __getitem__(self, parameters): return _concatenate_getitem(self, parameters) @@ -1472,11 +1751,7 @@ if hasattr(typing, 'TypeGuard'): TypeGuard = typing.TypeGuard # 3.9 elif sys.version_info[:2] >= (3, 9): - class _TypeGuardForm(typing._SpecialForm, _root=True): - def __repr__(self): - return 'typing_extensions.' + self._name - - @_TypeGuardForm + @_ExtensionsSpecialForm def TypeGuard(self, parameters): """Special typing form used to annotate the return type of a user-defined type guard function. ``TypeGuard`` only accepts a single type argument. @@ -1522,13 +1797,9 @@ elif sys.version_info[:2] >= (3, 9): """ item = typing._type_check(parameters, f'{self} accepts only a single type.') return typing._GenericAlias(self, (item,)) -# 3.7-3.8 +# 3.8 else: - class _TypeGuardForm(typing._SpecialForm, _root=True): - - def __repr__(self): - return 'typing_extensions.' + self._name - + class _TypeGuardForm(_ExtensionsSpecialForm, _root=True): def __getitem__(self, parameters): item = typing._type_check(parameters, f'{self._name} accepts only a single type') @@ -1579,6 +1850,98 @@ else: PEP 647 (User-Defined Type Guards). """) +# 3.13+ +if hasattr(typing, 'TypeIs'): + TypeIs = typing.TypeIs +# 3.9 +elif sys.version_info[:2] >= (3, 9): + @_ExtensionsSpecialForm + def TypeIs(self, parameters): + """Special typing form used to annotate the return type of a user-defined + type narrower function. ``TypeIs`` only accepts a single type argument. + At runtime, functions marked this way should return a boolean. + + ``TypeIs`` aims to benefit *type narrowing* -- a technique used by static + type checkers to determine a more precise type of an expression within a + program's code flow. Usually type narrowing is done by analyzing + conditional code flow and applying the narrowing to a block of code. The + conditional expression here is sometimes referred to as a "type guard". + + Sometimes it would be convenient to use a user-defined boolean function + as a type guard. Such a function should use ``TypeIs[...]`` as its + return type to alert static type checkers to this intention. + + Using ``-> TypeIs`` tells the static type checker that for a given + function: + + 1. The return value is a boolean. + 2. If the return value is ``True``, the type of its argument + is the intersection of the type inside ``TypeGuard`` and the argument's + previously known type. + + For example:: + + def is_awaitable(val: object) -> TypeIs[Awaitable[Any]]: + return hasattr(val, '__await__') + + def f(val: Union[int, Awaitable[int]]) -> int: + if is_awaitable(val): + assert_type(val, Awaitable[int]) + else: + assert_type(val, int) + + ``TypeIs`` also works with type variables. For more information, see + PEP 742 (Narrowing types with TypeIs). + """ + item = typing._type_check(parameters, f'{self} accepts only a single type.') + return typing._GenericAlias(self, (item,)) +# 3.8 +else: + class _TypeIsForm(_ExtensionsSpecialForm, _root=True): + def __getitem__(self, parameters): + item = typing._type_check(parameters, + f'{self._name} accepts only a single type') + return typing._GenericAlias(self, (item,)) + + TypeIs = _TypeIsForm( + 'TypeIs', + doc="""Special typing form used to annotate the return type of a user-defined + type narrower function. ``TypeIs`` only accepts a single type argument. + At runtime, functions marked this way should return a boolean. + + ``TypeIs`` aims to benefit *type narrowing* -- a technique used by static + type checkers to determine a more precise type of an expression within a + program's code flow. Usually type narrowing is done by analyzing + conditional code flow and applying the narrowing to a block of code. The + conditional expression here is sometimes referred to as a "type guard". + + Sometimes it would be convenient to use a user-defined boolean function + as a type guard. Such a function should use ``TypeIs[...]`` as its + return type to alert static type checkers to this intention. + + Using ``-> TypeIs`` tells the static type checker that for a given + function: + + 1. The return value is a boolean. + 2. If the return value is ``True``, the type of its argument + is the intersection of the type inside ``TypeGuard`` and the argument's + previously known type. + + For example:: + + def is_awaitable(val: object) -> TypeIs[Awaitable[Any]]: + return hasattr(val, '__await__') + + def f(val: Union[int, Awaitable[int]]) -> int: + if is_awaitable(val): + assert_type(val, Awaitable[int]) + else: + assert_type(val, int) + + ``TypeIs`` also works with type variables. For more information, see + PEP 742 (Narrowing types with TypeIs). + """) + # Vendored from cpython typing._SpecialFrom class _SpecialForm(typing._Final, _root=True): @@ -1624,7 +1987,7 @@ class _SpecialForm(typing._Final, _root=True): return self._getitem(self, parameters) -if hasattr(typing, "LiteralString"): +if hasattr(typing, "LiteralString"): # 3.11+ LiteralString = typing.LiteralString else: @_SpecialForm @@ -1647,7 +2010,7 @@ else: raise TypeError(f"{self} is not subscriptable") -if hasattr(typing, "Self"): +if hasattr(typing, "Self"): # 3.11+ Self = typing.Self else: @_SpecialForm @@ -1668,7 +2031,7 @@ else: raise TypeError(f"{self} is not subscriptable") -if hasattr(typing, "Never"): +if hasattr(typing, "Never"): # 3.11+ Never = typing.Never else: @_SpecialForm @@ -1698,14 +2061,10 @@ else: raise TypeError(f"{self} is not subscriptable") -if hasattr(typing, 'Required'): +if hasattr(typing, 'Required'): # 3.11+ Required = typing.Required NotRequired = typing.NotRequired -elif sys.version_info[:2] >= (3, 9): - class _ExtensionsSpecialForm(typing._SpecialForm, _root=True): - def __repr__(self): - return 'typing_extensions.' + self._name - +elif sys.version_info[:2] >= (3, 9): # 3.9-3.10 @_ExtensionsSpecialForm def Required(self, parameters): """A special typing construct to mark a key of a total=False TypedDict @@ -1743,11 +2102,8 @@ elif sys.version_info[:2] >= (3, 9): item = typing._type_check(parameters, f'{self._name} accepts only a single type.') return typing._GenericAlias(self, (item,)) -else: - class _RequiredForm(typing._SpecialForm, _root=True): - def __repr__(self): - return 'typing_extensions.' + self._name - +else: # 3.8 + class _RequiredForm(_ExtensionsSpecialForm, _root=True): def __getitem__(self, parameters): item = typing._type_check(parameters, f'{self._name} accepts only a single type.') @@ -1786,59 +2142,129 @@ else: """) -if hasattr(typing, "Unpack"): # 3.11+ +if hasattr(typing, 'ReadOnly'): + ReadOnly = typing.ReadOnly +elif sys.version_info[:2] >= (3, 9): # 3.9-3.12 + @_ExtensionsSpecialForm + def ReadOnly(self, parameters): + """A special typing construct to mark an item of a TypedDict as read-only. + + For example: + + class Movie(TypedDict): + title: ReadOnly[str] + year: int + + def mutate_movie(m: Movie) -> None: + m["year"] = 1992 # allowed + m["title"] = "The Matrix" # typechecker error + + There is no runtime checking for this property. + """ + item = typing._type_check(parameters, f'{self._name} accepts only a single type.') + return typing._GenericAlias(self, (item,)) + +else: # 3.8 + class _ReadOnlyForm(_ExtensionsSpecialForm, _root=True): + def __getitem__(self, parameters): + item = typing._type_check(parameters, + f'{self._name} accepts only a single type.') + return typing._GenericAlias(self, (item,)) + + ReadOnly = _ReadOnlyForm( + 'ReadOnly', + doc="""A special typing construct to mark a key of a TypedDict as read-only. + + For example: + + class Movie(TypedDict): + title: ReadOnly[str] + year: int + + def mutate_movie(m: Movie) -> None: + m["year"] = 1992 # allowed + m["title"] = "The Matrix" # typechecker error + + There is no runtime checking for this propery. + """) + + +_UNPACK_DOC = """\ +Type unpack operator. + +The type unpack operator takes the child types from some container type, +such as `tuple[int, str]` or a `TypeVarTuple`, and 'pulls them out'. For +example: + + # For some generic class `Foo`: + Foo[Unpack[tuple[int, str]]] # Equivalent to Foo[int, str] + + Ts = TypeVarTuple('Ts') + # Specifies that `Bar` is generic in an arbitrary number of types. + # (Think of `Ts` as a tuple of an arbitrary number of individual + # `TypeVar`s, which the `Unpack` is 'pulling out' directly into the + # `Generic[]`.) + class Bar(Generic[Unpack[Ts]]): ... + Bar[int] # Valid + Bar[int, str] # Also valid + +From Python 3.11, this can also be done using the `*` operator: + + Foo[*tuple[int, str]] + class Bar(Generic[*Ts]): ... + +The operator can also be used along with a `TypedDict` to annotate +`**kwargs` in a function signature. For instance: + + class Movie(TypedDict): + name: str + year: int + + # This function expects two keyword arguments - *name* of type `str` and + # *year* of type `int`. + def foo(**kwargs: Unpack[Movie]): ... + +Note that there is only some runtime checking of this operator. Not +everything the runtime allows may be accepted by static type checkers. + +For more information, see PEP 646 and PEP 692. +""" + + +if sys.version_info >= (3, 12): # PEP 692 changed the repr of Unpack[] Unpack = typing.Unpack -elif sys.version_info[:2] >= (3, 9): - class _UnpackSpecialForm(typing._SpecialForm, _root=True): - def __repr__(self): - return 'typing_extensions.' + self._name + + def _is_unpack(obj): + return get_origin(obj) is Unpack + +elif sys.version_info[:2] >= (3, 9): # 3.9+ + class _UnpackSpecialForm(_ExtensionsSpecialForm, _root=True): + def __init__(self, getitem): + super().__init__(getitem) + self.__doc__ = _UNPACK_DOC class _UnpackAlias(typing._GenericAlias, _root=True): __class__ = typing.TypeVar @_UnpackSpecialForm def Unpack(self, parameters): - """A special typing construct to unpack a variadic type. For example: - - Shape = TypeVarTuple('Shape') - Batch = NewType('Batch', int) - - def add_batch_axis( - x: Array[Unpack[Shape]] - ) -> Array[Batch, Unpack[Shape]]: ... - - """ item = typing._type_check(parameters, f'{self._name} accepts only a single type.') return _UnpackAlias(self, (item,)) def _is_unpack(obj): return isinstance(obj, _UnpackAlias) -else: +else: # 3.8 class _UnpackAlias(typing._GenericAlias, _root=True): __class__ = typing.TypeVar - class _UnpackForm(typing._SpecialForm, _root=True): - def __repr__(self): - return 'typing_extensions.' + self._name - + class _UnpackForm(_ExtensionsSpecialForm, _root=True): def __getitem__(self, parameters): item = typing._type_check(parameters, f'{self._name} accepts only a single type.') return _UnpackAlias(self, (item,)) - Unpack = _UnpackForm( - 'Unpack', - doc="""A special typing construct to unpack a variadic type. For example: - - Shape = TypeVarTuple('Shape') - Batch = NewType('Batch', int) - - def add_batch_axis( - x: Array[Unpack[Shape]] - ) -> Array[Batch, Unpack[Shape]]: ... - - """) + Unpack = _UnpackForm('Unpack', doc=_UNPACK_DOC) def _is_unpack(obj): return isinstance(obj, _UnpackAlias) @@ -1846,23 +2272,22 @@ else: if hasattr(typing, "TypeVarTuple"): # 3.11+ - # Add default Parameter - PEP 696 - class TypeVarTuple(typing.TypeVarTuple, _DefaultMixin, _root=True): + # Add default parameter - PEP 696 + class TypeVarTuple(metaclass=_TypeVarLikeMeta): """Type variable tuple.""" - def __init__(self, name, *, default=None): - super().__init__(name) - _DefaultMixin.__init__(self, default) + _backported_typevarlike = typing.TypeVarTuple - # for pickling: - try: - def_mod = sys._getframe(1).f_globals.get('__name__', '__main__') - except (AttributeError, ValueError): - def_mod = None - if def_mod != 'typing_extensions': - self.__module__ = def_mod + def __new__(cls, name, *, default=_marker): + tvt = typing.TypeVarTuple(name) + _set_default(tvt, default) + _set_module(tvt) + return tvt -else: + def __init_subclass__(self, *args, **kwds): + raise TypeError("Cannot subclass special typing classes") + +else: # <=3.10 class TypeVarTuple(_DefaultMixin): """Type variable tuple. @@ -1913,15 +2338,12 @@ else: def __iter__(self): yield self.__unpacked__ - def __init__(self, name, *, default=None): + def __init__(self, name, *, default=_marker): self.__name__ = name _DefaultMixin.__init__(self, default) # for pickling: - try: - def_mod = sys._getframe(1).f_globals.get('__name__', '__main__') - except (AttributeError, ValueError): - def_mod = None + def_mod = _caller() if def_mod != 'typing_extensions': self.__module__ = def_mod @@ -1944,10 +2366,10 @@ else: raise TypeError("Cannot subclass special typing classes") -if hasattr(typing, "reveal_type"): +if hasattr(typing, "reveal_type"): # 3.11+ reveal_type = typing.reveal_type -else: - def reveal_type(__obj: T) -> T: +else: # <=3.10 + def reveal_type(obj: T, /) -> T: """Reveal the inferred type of a variable. When a static type checker encounters a call to ``reveal_type()``, @@ -1963,14 +2385,14 @@ else: argument and returns it unchanged. """ - print(f"Runtime type is {type(__obj).__name__!r}", file=sys.stderr) - return __obj + print(f"Runtime type is {type(obj).__name__!r}", file=sys.stderr) + return obj -if hasattr(typing, "assert_never"): +if hasattr(typing, "assert_never"): # 3.11+ assert_never = typing.assert_never -else: - def assert_never(__arg: Never) -> Never: +else: # <=3.10 + def assert_never(arg: Never, /) -> Never: """Assert to the type checker that a line of code is unreachable. Example:: @@ -1993,14 +2415,16 @@ else: raise AssertionError("Expected code to be unreachable") -if hasattr(typing, 'dataclass_transform'): +if sys.version_info >= (3, 12): # 3.12+ + # dataclass_transform exists in 3.11 but lacks the frozen_default parameter dataclass_transform = typing.dataclass_transform -else: +else: # <=3.11 def dataclass_transform( *, eq_default: bool = True, order_default: bool = False, kw_only_default: bool = False, + frozen_default: bool = False, field_specifiers: typing.Tuple[ typing.Union[typing.Type[typing.Any], typing.Callable[..., typing.Any]], ... @@ -2057,6 +2481,8 @@ else: assumed to be True or False if it is omitted by the caller. - ``kw_only_default`` indicates whether the ``kw_only`` parameter is assumed to be True or False if it is omitted by the caller. + - ``frozen_default`` indicates whether the ``frozen`` parameter is + assumed to be True or False if it is omitted by the caller. - ``field_specifiers`` specifies a static list of supported classes or functions that describe fields, similar to ``dataclasses.field()``. @@ -2071,6 +2497,7 @@ else: "eq_default": eq_default, "order_default": order_default, "kw_only_default": kw_only_default, + "frozen_default": frozen_default, "field_specifiers": field_specifiers, "kwargs": kwargs, } @@ -2078,18 +2505,18 @@ else: return decorator -if hasattr(typing, "override"): +if hasattr(typing, "override"): # 3.12+ override = typing.override -else: +else: # <=3.11 _F = typing.TypeVar("_F", bound=typing.Callable[..., typing.Any]) - def override(__arg: _F) -> _F: + def override(arg: _F, /) -> _F: """Indicate that a method is intended to override a method in a base class. Usage: class Base: - def method(self) -> None: ... + def method(self) -> None: pass class Child(Base): @@ -2102,10 +2529,156 @@ else: This helps prevent bugs that may occur when a base class is changed without an equivalent change to a child class. + There is no runtime checking of these properties. The decorator + sets the ``__override__`` attribute to ``True`` on the decorated object + to allow runtime introspection. + See PEP 698 for details. """ - return __arg + try: + arg.__override__ = True + except (AttributeError, TypeError): + # Skip the attribute silently if it is not writable. + # AttributeError happens if the object has __slots__ or a + # read-only property, TypeError if it's a builtin class. + pass + return arg + + +if hasattr(warnings, "deprecated"): + deprecated = warnings.deprecated +else: + _T = typing.TypeVar("_T") + + class deprecated: + """Indicate that a class, function or overload is deprecated. + + When this decorator is applied to an object, the type checker + will generate a diagnostic on usage of the deprecated object. + + Usage: + + @deprecated("Use B instead") + class A: + pass + + @deprecated("Use g instead") + def f(): + pass + + @overload + @deprecated("int support is deprecated") + def g(x: int) -> int: ... + @overload + def g(x: str) -> int: ... + + The warning specified by *category* will be emitted at runtime + on use of deprecated objects. For functions, that happens on calls; + for classes, on instantiation and on creation of subclasses. + If the *category* is ``None``, no warning is emitted at runtime. + The *stacklevel* determines where the + warning is emitted. If it is ``1`` (the default), the warning + is emitted at the direct caller of the deprecated object; if it + is higher, it is emitted further up the stack. + Static type checker behavior is not affected by the *category* + and *stacklevel* arguments. + + The deprecation message passed to the decorator is saved in the + ``__deprecated__`` attribute on the decorated object. + If applied to an overload, the decorator + must be after the ``@overload`` decorator for the attribute to + exist on the overload as returned by ``get_overloads()``. + + See PEP 702 for details. + + """ + def __init__( + self, + message: str, + /, + *, + category: typing.Optional[typing.Type[Warning]] = DeprecationWarning, + stacklevel: int = 1, + ) -> None: + if not isinstance(message, str): + raise TypeError( + "Expected an object of type str for 'message', not " + f"{type(message).__name__!r}" + ) + self.message = message + self.category = category + self.stacklevel = stacklevel + + def __call__(self, arg: _T, /) -> _T: + # Make sure the inner functions created below don't + # retain a reference to self. + msg = self.message + category = self.category + stacklevel = self.stacklevel + if category is None: + arg.__deprecated__ = msg + return arg + elif isinstance(arg, type): + import functools + from types import MethodType + + original_new = arg.__new__ + + @functools.wraps(original_new) + def __new__(cls, *args, **kwargs): + if cls is arg: + warnings.warn(msg, category=category, stacklevel=stacklevel + 1) + if original_new is not object.__new__: + return original_new(cls, *args, **kwargs) + # Mirrors a similar check in object.__new__. + elif cls.__init__ is object.__init__ and (args or kwargs): + raise TypeError(f"{cls.__name__}() takes no arguments") + else: + return original_new(cls) + + arg.__new__ = staticmethod(__new__) + + original_init_subclass = arg.__init_subclass__ + # We need slightly different behavior if __init_subclass__ + # is a bound method (likely if it was implemented in Python) + if isinstance(original_init_subclass, MethodType): + original_init_subclass = original_init_subclass.__func__ + + @functools.wraps(original_init_subclass) + def __init_subclass__(*args, **kwargs): + warnings.warn(msg, category=category, stacklevel=stacklevel + 1) + return original_init_subclass(*args, **kwargs) + + arg.__init_subclass__ = classmethod(__init_subclass__) + # Or otherwise, which likely means it's a builtin such as + # object's implementation of __init_subclass__. + else: + @functools.wraps(original_init_subclass) + def __init_subclass__(*args, **kwargs): + warnings.warn(msg, category=category, stacklevel=stacklevel + 1) + return original_init_subclass(*args, **kwargs) + + arg.__init_subclass__ = __init_subclass__ + + arg.__deprecated__ = __new__.__deprecated__ = msg + __init_subclass__.__deprecated__ = msg + return arg + elif callable(arg): + import functools + + @functools.wraps(arg) + def wrapper(*args, **kwargs): + warnings.warn(msg, category=category, stacklevel=stacklevel + 1) + return arg(*args, **kwargs) + + arg.__deprecated__ = wrapper.__deprecated__ = msg + return wrapper + else: + raise TypeError( + "@deprecated decorator with non-None category must be applied to " + f"a class or callable, not {arg!r}" + ) # We have to do some monkey patching to deal with the dual nature of @@ -2120,18 +2693,14 @@ if not hasattr(typing, "TypeVarTuple"): typing._check_generic = _check_generic -# Backport typing.NamedTuple as it exists in Python 3.11. +# Backport typing.NamedTuple as it exists in Python 3.13. # In 3.11, the ability to define generic `NamedTuple`s was supported. # This was explicitly disallowed in 3.9-3.10, and only half-worked in <=3.8. -if sys.version_info >= (3, 11): +# On 3.12, we added __orig_bases__ to call-based NamedTuples +# On 3.13, we deprecated kwargs-based NamedTuples +if sys.version_info >= (3, 13): NamedTuple = typing.NamedTuple else: - def _caller(): - try: - return sys._getframe(2).f_globals.get('__name__', '__main__') - except (AttributeError, ValueError): # For platforms without _getframe() - return None - def _make_nmtuple(name, types, module, defaults=()): fields = [n for n, t in types] annotations = {n: typing._type_check(t, f"field {n} annotation must be a type") @@ -2173,37 +2742,486 @@ else: ) nm_tpl.__bases__ = bases if typing.Generic in bases: - class_getitem = typing.Generic.__class_getitem__.__func__ - nm_tpl.__class_getitem__ = classmethod(class_getitem) + if hasattr(typing, '_generic_class_getitem'): # 3.12+ + nm_tpl.__class_getitem__ = classmethod(typing._generic_class_getitem) + else: + class_getitem = typing.Generic.__class_getitem__.__func__ + nm_tpl.__class_getitem__ = classmethod(class_getitem) # update from user namespace without overriding special namedtuple attributes - for key in ns: + for key, val in ns.items(): if key in _prohibited_namedtuple_fields: raise AttributeError("Cannot overwrite NamedTuple attribute " + key) - elif key not in _special_namedtuple_fields and key not in nm_tpl._fields: - setattr(nm_tpl, key, ns[key]) + elif key not in _special_namedtuple_fields: + if key not in nm_tpl._fields: + setattr(nm_tpl, key, ns[key]) + try: + set_name = type(val).__set_name__ + except AttributeError: + pass + else: + try: + set_name(val, nm_tpl, key) + except BaseException as e: + msg = ( + f"Error calling __set_name__ on {type(val).__name__!r} " + f"instance {key!r} in {typename!r}" + ) + # BaseException.add_note() existed on py311, + # but the __set_name__ machinery didn't start + # using add_note() until py312. + # Making sure exceptions are raised in the same way + # as in "normal" classes seems most important here. + if sys.version_info >= (3, 12): + e.add_note(msg) + raise + else: + raise RuntimeError(msg) from e + if typing.Generic in bases: nm_tpl.__init_subclass__() return nm_tpl - def NamedTuple(__typename, __fields=None, **kwargs): - if __fields is None: - __fields = kwargs.items() - elif kwargs: - raise TypeError("Either list of fields or keywords" - " can be provided to NamedTuple, not both") - return _make_nmtuple(__typename, __fields, module=_caller()) - - NamedTuple.__doc__ = typing.NamedTuple.__doc__ _NamedTuple = type.__new__(_NamedTupleMeta, 'NamedTuple', (), {}) - # On 3.8+, alter the signature so that it matches typing.NamedTuple. - # The signature of typing.NamedTuple on >=3.8 is invalid syntax in Python 3.7, - # so just leave the signature as it is on 3.7. - if sys.version_info >= (3, 8): - NamedTuple.__text_signature__ = '(typename, fields=None, /, **kwargs)' - def _namedtuple_mro_entries(bases): assert NamedTuple in bases return (_NamedTuple,) - NamedTuple.__mro_entries__ = _namedtuple_mro_entries + @_ensure_subclassable(_namedtuple_mro_entries) + def NamedTuple(typename, fields=_marker, /, **kwargs): + """Typed version of namedtuple. + + Usage:: + + class Employee(NamedTuple): + name: str + id: int + + This is equivalent to:: + + Employee = collections.namedtuple('Employee', ['name', 'id']) + + The resulting class has an extra __annotations__ attribute, giving a + dict that maps field names to types. (The field names are also in + the _fields attribute, which is part of the namedtuple API.) + An alternative equivalent functional syntax is also accepted:: + + Employee = NamedTuple('Employee', [('name', str), ('id', int)]) + """ + if fields is _marker: + if kwargs: + deprecated_thing = "Creating NamedTuple classes using keyword arguments" + deprecation_msg = ( + "{name} is deprecated and will be disallowed in Python {remove}. " + "Use the class-based or functional syntax instead." + ) + else: + deprecated_thing = "Failing to pass a value for the 'fields' parameter" + example = f"`{typename} = NamedTuple({typename!r}, [])`" + deprecation_msg = ( + "{name} is deprecated and will be disallowed in Python {remove}. " + "To create a NamedTuple class with 0 fields " + "using the functional syntax, " + "pass an empty list, e.g. " + ) + example + "." + elif fields is None: + if kwargs: + raise TypeError( + "Cannot pass `None` as the 'fields' parameter " + "and also specify fields using keyword arguments" + ) + else: + deprecated_thing = "Passing `None` as the 'fields' parameter" + example = f"`{typename} = NamedTuple({typename!r}, [])`" + deprecation_msg = ( + "{name} is deprecated and will be disallowed in Python {remove}. " + "To create a NamedTuple class with 0 fields " + "using the functional syntax, " + "pass an empty list, e.g. " + ) + example + "." + elif kwargs: + raise TypeError("Either list of fields or keywords" + " can be provided to NamedTuple, not both") + if fields is _marker or fields is None: + warnings.warn( + deprecation_msg.format(name=deprecated_thing, remove="3.15"), + DeprecationWarning, + stacklevel=2, + ) + fields = kwargs.items() + nt = _make_nmtuple(typename, fields, module=_caller()) + nt.__orig_bases__ = (NamedTuple,) + return nt + + +if hasattr(collections.abc, "Buffer"): + Buffer = collections.abc.Buffer +else: + class Buffer(abc.ABC): + """Base class for classes that implement the buffer protocol. + + The buffer protocol allows Python objects to expose a low-level + memory buffer interface. Before Python 3.12, it is not possible + to implement the buffer protocol in pure Python code, or even + to check whether a class implements the buffer protocol. In + Python 3.12 and higher, the ``__buffer__`` method allows access + to the buffer protocol from Python code, and the + ``collections.abc.Buffer`` ABC allows checking whether a class + implements the buffer protocol. + + To indicate support for the buffer protocol in earlier versions, + inherit from this ABC, either in a stub file or at runtime, + or use ABC registration. This ABC provides no methods, because + there is no Python-accessible methods shared by pre-3.12 buffer + classes. It is useful primarily for static checks. + + """ + + # As a courtesy, register the most common stdlib buffer classes. + Buffer.register(memoryview) + Buffer.register(bytearray) + Buffer.register(bytes) + + +# Backport of types.get_original_bases, available on 3.12+ in CPython +if hasattr(_types, "get_original_bases"): + get_original_bases = _types.get_original_bases +else: + def get_original_bases(cls, /): + """Return the class's "original" bases prior to modification by `__mro_entries__`. + + Examples:: + + from typing import TypeVar, Generic + from typing_extensions import NamedTuple, TypedDict + + T = TypeVar("T") + class Foo(Generic[T]): ... + class Bar(Foo[int], float): ... + class Baz(list[str]): ... + Eggs = NamedTuple("Eggs", [("a", int), ("b", str)]) + Spam = TypedDict("Spam", {"a": int, "b": str}) + + assert get_original_bases(Bar) == (Foo[int], float) + assert get_original_bases(Baz) == (list[str],) + assert get_original_bases(Eggs) == (NamedTuple,) + assert get_original_bases(Spam) == (TypedDict,) + assert get_original_bases(int) == (object,) + """ + try: + return cls.__dict__.get("__orig_bases__", cls.__bases__) + except AttributeError: + raise TypeError( + f'Expected an instance of type, not {type(cls).__name__!r}' + ) from None + + +# NewType is a class on Python 3.10+, making it pickleable +# The error message for subclassing instances of NewType was improved on 3.11+ +if sys.version_info >= (3, 11): + NewType = typing.NewType +else: + class NewType: + """NewType creates simple unique types with almost zero + runtime overhead. NewType(name, tp) is considered a subtype of tp + by static type checkers. At runtime, NewType(name, tp) returns + a dummy callable that simply returns its argument. Usage:: + UserId = NewType('UserId', int) + def name_by_id(user_id: UserId) -> str: + ... + UserId('user') # Fails type check + name_by_id(42) # Fails type check + name_by_id(UserId(42)) # OK + num = UserId(5) + 1 # type: int + """ + + def __call__(self, obj, /): + return obj + + def __init__(self, name, tp): + self.__qualname__ = name + if '.' in name: + name = name.rpartition('.')[-1] + self.__name__ = name + self.__supertype__ = tp + def_mod = _caller() + if def_mod != 'typing_extensions': + self.__module__ = def_mod + + def __mro_entries__(self, bases): + # We defined __mro_entries__ to get a better error message + # if a user attempts to subclass a NewType instance. bpo-46170 + supercls_name = self.__name__ + + class Dummy: + def __init_subclass__(cls): + subcls_name = cls.__name__ + raise TypeError( + f"Cannot subclass an instance of NewType. " + f"Perhaps you were looking for: " + f"`{subcls_name} = NewType({subcls_name!r}, {supercls_name})`" + ) + + return (Dummy,) + + def __repr__(self): + return f'{self.__module__}.{self.__qualname__}' + + def __reduce__(self): + return self.__qualname__ + + if sys.version_info >= (3, 10): + # PEP 604 methods + # It doesn't make sense to have these methods on Python <3.10 + + def __or__(self, other): + return typing.Union[self, other] + + def __ror__(self, other): + return typing.Union[other, self] + + +if hasattr(typing, "TypeAliasType"): + TypeAliasType = typing.TypeAliasType +else: + def _is_unionable(obj): + """Corresponds to is_unionable() in unionobject.c in CPython.""" + return obj is None or isinstance(obj, ( + type, + _types.GenericAlias, + _types.UnionType, + TypeAliasType, + )) + + class TypeAliasType: + """Create named, parameterized type aliases. + + This provides a backport of the new `type` statement in Python 3.12: + + type ListOrSet[T] = list[T] | set[T] + + is equivalent to: + + T = TypeVar("T") + ListOrSet = TypeAliasType("ListOrSet", list[T] | set[T], type_params=(T,)) + + The name ListOrSet can then be used as an alias for the type it refers to. + + The type_params argument should contain all the type parameters used + in the value of the type alias. If the alias is not generic, this + argument is omitted. + + Static type checkers should only support type aliases declared using + TypeAliasType that follow these rules: + + - The first argument (the name) must be a string literal. + - The TypeAliasType instance must be immediately assigned to a variable + of the same name. (For example, 'X = TypeAliasType("Y", int)' is invalid, + as is 'X, Y = TypeAliasType("X", int), TypeAliasType("Y", int)'). + + """ + + def __init__(self, name: str, value, *, type_params=()): + if not isinstance(name, str): + raise TypeError("TypeAliasType name must be a string") + self.__value__ = value + self.__type_params__ = type_params + + parameters = [] + for type_param in type_params: + if isinstance(type_param, TypeVarTuple): + parameters.extend(type_param) + else: + parameters.append(type_param) + self.__parameters__ = tuple(parameters) + def_mod = _caller() + if def_mod != 'typing_extensions': + self.__module__ = def_mod + # Setting this attribute closes the TypeAliasType from further modification + self.__name__ = name + + def __setattr__(self, name: str, value: object, /) -> None: + if hasattr(self, "__name__"): + self._raise_attribute_error(name) + super().__setattr__(name, value) + + def __delattr__(self, name: str, /) -> Never: + self._raise_attribute_error(name) + + def _raise_attribute_error(self, name: str) -> Never: + # Match the Python 3.12 error messages exactly + if name == "__name__": + raise AttributeError("readonly attribute") + elif name in {"__value__", "__type_params__", "__parameters__", "__module__"}: + raise AttributeError( + f"attribute '{name}' of 'typing.TypeAliasType' objects " + "is not writable" + ) + else: + raise AttributeError( + f"'typing.TypeAliasType' object has no attribute '{name}'" + ) + + def __repr__(self) -> str: + return self.__name__ + + def __getitem__(self, parameters): + if not isinstance(parameters, tuple): + parameters = (parameters,) + parameters = [ + typing._type_check( + item, f'Subscripting {self.__name__} requires a type.' + ) + for item in parameters + ] + return typing._GenericAlias(self, tuple(parameters)) + + def __reduce__(self): + return self.__name__ + + def __init_subclass__(cls, *args, **kwargs): + raise TypeError( + "type 'typing_extensions.TypeAliasType' is not an acceptable base type" + ) + + # The presence of this method convinces typing._type_check + # that TypeAliasTypes are types. + def __call__(self): + raise TypeError("Type alias is not callable") + + if sys.version_info >= (3, 10): + def __or__(self, right): + # For forward compatibility with 3.12, reject Unions + # that are not accepted by the built-in Union. + if not _is_unionable(right): + return NotImplemented + return typing.Union[self, right] + + def __ror__(self, left): + if not _is_unionable(left): + return NotImplemented + return typing.Union[left, self] + + +if hasattr(typing, "is_protocol"): + is_protocol = typing.is_protocol + get_protocol_members = typing.get_protocol_members +else: + def is_protocol(tp: type, /) -> bool: + """Return True if the given type is a Protocol. + + Example:: + + >>> from typing_extensions import Protocol, is_protocol + >>> class P(Protocol): + ... def a(self) -> str: ... + ... b: int + >>> is_protocol(P) + True + >>> is_protocol(int) + False + """ + return ( + isinstance(tp, type) + and getattr(tp, '_is_protocol', False) + and tp is not Protocol + and tp is not typing.Protocol + ) + + def get_protocol_members(tp: type, /) -> typing.FrozenSet[str]: + """Return the set of members defined in a Protocol. + + Example:: + + >>> from typing_extensions import Protocol, get_protocol_members + >>> class P(Protocol): + ... def a(self) -> str: ... + ... b: int + >>> get_protocol_members(P) + frozenset({'a', 'b'}) + + Raise a TypeError for arguments that are not Protocols. + """ + if not is_protocol(tp): + raise TypeError(f'{tp!r} is not a Protocol') + if hasattr(tp, '__protocol_attrs__'): + return frozenset(tp.__protocol_attrs__) + return frozenset(_get_protocol_attrs(tp)) + + +if hasattr(typing, "Doc"): + Doc = typing.Doc +else: + class Doc: + """Define the documentation of a type annotation using ``Annotated``, to be + used in class attributes, function and method parameters, return values, + and variables. + + The value should be a positional-only string literal to allow static tools + like editors and documentation generators to use it. + + This complements docstrings. + + The string value passed is available in the attribute ``documentation``. + + Example:: + + >>> from typing_extensions import Annotated, Doc + >>> def hi(to: Annotated[str, Doc("Who to say hi to")]) -> None: ... + """ + def __init__(self, documentation: str, /) -> None: + self.documentation = documentation + + def __repr__(self) -> str: + return f"Doc({self.documentation!r})" + + def __hash__(self) -> int: + return hash(self.documentation) + + def __eq__(self, other: object) -> bool: + if not isinstance(other, Doc): + return NotImplemented + return self.documentation == other.documentation + + +# Aliases for items that have always been in typing. +# Explicitly assign these (rather than using `from typing import *` at the top), +# so that we get a CI error if one of these is deleted from typing.py +# in a future version of Python +AbstractSet = typing.AbstractSet +AnyStr = typing.AnyStr +BinaryIO = typing.BinaryIO +Callable = typing.Callable +Collection = typing.Collection +Container = typing.Container +Dict = typing.Dict +ForwardRef = typing.ForwardRef +FrozenSet = typing.FrozenSet +Generator = typing.Generator +Generic = typing.Generic +Hashable = typing.Hashable +IO = typing.IO +ItemsView = typing.ItemsView +Iterable = typing.Iterable +Iterator = typing.Iterator +KeysView = typing.KeysView +List = typing.List +Mapping = typing.Mapping +MappingView = typing.MappingView +Match = typing.Match +MutableMapping = typing.MutableMapping +MutableSequence = typing.MutableSequence +MutableSet = typing.MutableSet +Optional = typing.Optional +Pattern = typing.Pattern +Reversible = typing.Reversible +Sequence = typing.Sequence +Set = typing.Set +Sized = typing.Sized +TextIO = typing.TextIO +Tuple = typing.Tuple +Union = typing.Union +ValuesView = typing.ValuesView +cast = typing.cast +no_type_check = typing.no_type_check +no_type_check_decorator = typing.no_type_check_decorator diff --git a/lib/win32/Demos/BackupRead_BackupWrite.py b/lib/win32/Demos/BackupRead_BackupWrite.py new file mode 100644 index 00000000..0e9fc9f9 --- /dev/null +++ b/lib/win32/Demos/BackupRead_BackupWrite.py @@ -0,0 +1,121 @@ +## demonstrates using BackupRead and BackupWrite to copy all of a file's data streams + + +import ntsecuritycon +import pythoncom +import pywintypes +import win32api +import win32con +import win32file +import win32security +from pywin32_testutil import ob2memory, str2bytes +from win32com import storagecon + +all_sd_info = ( + win32security.DACL_SECURITY_INFORMATION + | win32security.DACL_SECURITY_INFORMATION + | win32security.OWNER_SECURITY_INFORMATION + | win32security.GROUP_SECURITY_INFORMATION +) + +tempdir = win32api.GetTempPath() +tempfile = win32api.GetTempFileName(tempdir, "bkr")[0] +outfile = win32api.GetTempFileName(tempdir, "out")[0] +print("Filename:", tempfile, "Output file:", outfile) + +f = open(tempfile, "w") +f.write("some random junk" + "x" * 100) +f.close() + +## add a couple of alternate data streams +f = open(tempfile + ":streamdata", "w") +f.write("data written to alternate stream" + "y" * 100) +f.close() + +f = open(tempfile + ":anotherstream", "w") +f.write("z" * 100) +f.close() + +## add Summary Information, which is stored as a separate stream +m = storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE | storagecon.STGM_DIRECT +pss = pythoncom.StgOpenStorageEx( + tempfile, m, storagecon.STGFMT_FILE, 0, pythoncom.IID_IPropertySetStorage, None +) +ps = pss.Create( + pythoncom.FMTID_SummaryInformation, + pythoncom.IID_IPropertyStorage, + 0, + storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE, +) +ps.WriteMultiple( + (storagecon.PIDSI_KEYWORDS, storagecon.PIDSI_COMMENTS), ("keywords", "comments") +) +ps = None +pss = None + +## add a custom security descriptor to make sure we don't +## get a default that would always be the same for both files in temp dir +new_sd = pywintypes.SECURITY_DESCRIPTOR() +sid = win32security.LookupAccountName("", "EveryOne")[0] +acl = pywintypes.ACL() +acl.AddAccessAllowedAce(1, win32con.GENERIC_READ, sid) +acl.AddAccessAllowedAce(1, ntsecuritycon.FILE_APPEND_DATA, sid) +acl.AddAccessAllowedAce(1, win32con.GENERIC_WRITE, sid) +acl.AddAccessAllowedAce(1, ntsecuritycon.FILE_ALL_ACCESS, sid) + +new_sd.SetSecurityDescriptorDacl(True, acl, False) +win32security.SetFileSecurity(tempfile, win32security.DACL_SECURITY_INFORMATION, new_sd) + + +sa = pywintypes.SECURITY_ATTRIBUTES() +sa.bInheritHandle = True +h = win32file.CreateFile( + tempfile, + win32con.GENERIC_ALL, + win32con.FILE_SHARE_READ, + sa, + win32con.OPEN_EXISTING, + win32file.FILE_FLAG_BACKUP_SEMANTICS, + None, +) + +outh = win32file.CreateFile( + outfile, + win32con.GENERIC_ALL, + win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE, + sa, + win32con.OPEN_EXISTING, + win32file.FILE_FLAG_BACKUP_SEMANTICS, + None, +) + +ctxt = 0 +outctxt = 0 +buf = None +readsize = 100 + +while 1: + bytes_read, buf, ctxt = win32file.BackupRead(h, readsize, buf, False, True, ctxt) + if bytes_read == 0: + break + bytes_written, outctxt = win32file.BackupWrite( + outh, bytes_read, buf, False, True, outctxt + ) + print("Written:", bytes_written, "Context:", outctxt) +win32file.BackupRead(h, 0, buf, True, True, ctxt) +win32file.BackupWrite(outh, 0, str2bytes(""), True, True, outctxt) +win32file.CloseHandle(h) +win32file.CloseHandle(outh) + +assert open(tempfile).read() == open(outfile).read(), "File contents differ !" +assert ( + open(tempfile + ":streamdata").read() == open(outfile + ":streamdata").read() +), "streamdata contents differ !" +assert ( + open(tempfile + ":anotherstream").read() == open(outfile + ":anotherstream").read() +), "anotherstream contents differ !" +assert ( + ob2memory(win32security.GetFileSecurity(tempfile, all_sd_info))[:] + == ob2memory(win32security.GetFileSecurity(outfile, all_sd_info))[:] +), "Security descriptors are different !" +## also should check Summary Info programatically diff --git a/lib/win32/Demos/BackupSeek_streamheaders.py b/lib/win32/Demos/BackupSeek_streamheaders.py new file mode 100644 index 00000000..8b828d1d --- /dev/null +++ b/lib/win32/Demos/BackupSeek_streamheaders.py @@ -0,0 +1,137 @@ +## demonstrates using BackupSeek to enumerate data streams for a file +import struct + +import pythoncom +import pywintypes +import win32api +import win32con +import win32file +from win32com import storagecon + +stream_types = { + win32con.BACKUP_DATA: "Standard data", + win32con.BACKUP_EA_DATA: "Extended attribute data", + win32con.BACKUP_SECURITY_DATA: "Security descriptor data", + win32con.BACKUP_ALTERNATE_DATA: "Alternative data streams", + win32con.BACKUP_LINK: "Hard link information", + win32con.BACKUP_PROPERTY_DATA: "Property data", + win32con.BACKUP_OBJECT_ID: "Objects identifiers", + win32con.BACKUP_REPARSE_DATA: "Reparse points", + win32con.BACKUP_SPARSE_BLOCK: "Sparse file", +} + +tempdir = win32api.GetTempPath() +tempfile = win32api.GetTempFileName(tempdir, "bkr")[0] +print("Filename:", tempfile) + +f = open(tempfile, "w") +f.write("some random junk" + "x" * 100) +f.close() + +f = open(tempfile + ":streamdata", "w") +f.write("data written to alternate stream" + "y" * 100) +f.close() + +f = open(tempfile + ":anotherstream", "w") +f.write("z" * 200) +f.close() + +## add Summary Information, which is stored as a separate stream +m = storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE | storagecon.STGM_DIRECT +pss = pythoncom.StgOpenStorageEx( + tempfile, m, storagecon.STGFMT_FILE, 0, pythoncom.IID_IPropertySetStorage, None +) +ps = pss.Create( + pythoncom.FMTID_SummaryInformation, + pythoncom.IID_IPropertyStorage, + 0, + storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE, +) +ps.WriteMultiple( + (storagecon.PIDSI_KEYWORDS, storagecon.PIDSI_COMMENTS), ("keywords", "comments") +) +ps = None +pss = None + +sa = pywintypes.SECURITY_ATTRIBUTES() +sa.bInheritHandle = False +h = win32file.CreateFile( + tempfile, + win32con.GENERIC_ALL, + win32con.FILE_SHARE_READ, + sa, + win32con.OPEN_EXISTING, + win32file.FILE_FLAG_BACKUP_SEMANTICS, + None, +) + + +""" stream header: +typedef struct _WIN32_STREAM_ID { + DWORD dwStreamId; DWORD dwStreamAttributes; LARGE_INTEGER Size; + DWORD dwStreamNameSize; WCHAR cStreamName[ANYSIZE_ARRAY]; +} +""" + +win32_stream_id_format = "LLQL" +win32_stream_id_size = struct.calcsize(win32_stream_id_format) + + +def parse_stream_header(h, ctxt, data): + stream_type, stream_attributes, stream_size, stream_name_size = struct.unpack( + win32_stream_id_format, data + ) + print( + "\nType:", + stream_type, + stream_types[stream_type], + "Attributes:", + stream_attributes, + "Size:", + stream_size, + "Name len:", + stream_name_size, + ) + if stream_name_size > 0: + ## ??? sdk says this size is in characters, but it appears to be number of bytes ??? + bytes_read, stream_name_buf, ctxt = win32file.BackupRead( + h, stream_name_size, None, False, True, ctxt + ) + stream_name = pywintypes.UnicodeFromRaw(stream_name_buf[:]) + else: + stream_name = "Unnamed" + print("Name:" + stream_name) + return ( + ctxt, + stream_type, + stream_attributes, + stream_size, + stream_name_size, + stream_name, + ) + + +ctxt = 0 +win32_stream_id_buf = ( + None ## gets rebound to a writable buffer on first call and reused +) +while 1: + bytes_read, win32_stream_id_buf, ctxt = win32file.BackupRead( + h, win32_stream_id_size, win32_stream_id_buf, False, True, ctxt + ) + if bytes_read == 0: + break + ( + ctxt, + stream_type, + stream_attributes, + stream_size, + stream_name_size, + stream_name, + ) = parse_stream_header(h, ctxt, win32_stream_id_buf[:]) + if stream_size > 0: + bytes_moved = win32file.BackupSeek(h, stream_size, ctxt) + print("Moved: ", bytes_moved) + +win32file.BackupRead(h, win32_stream_id_size, win32_stream_id_buf, True, True, ctxt) +win32file.CloseHandle(h) diff --git a/lib/win32/Demos/CopyFileEx.py b/lib/win32/Demos/CopyFileEx.py new file mode 100644 index 00000000..cdac78e5 --- /dev/null +++ b/lib/win32/Demos/CopyFileEx.py @@ -0,0 +1,57 @@ +import win32api +import win32file + + +def ProgressRoutine( + TotalFileSize, + TotalBytesTransferred, + StreamSize, + StreamBytesTransferred, + StreamNumber, + CallbackReason, + SourceFile, + DestinationFile, + Data, +): + print(Data) + print( + TotalFileSize, + TotalBytesTransferred, + StreamSize, + StreamBytesTransferred, + StreamNumber, + CallbackReason, + SourceFile, + DestinationFile, + ) + ##if TotalBytesTransferred > 100000: + ## return win32file.PROGRESS_STOP + return win32file.PROGRESS_CONTINUE + + +temp_dir = win32api.GetTempPath() +fsrc = win32api.GetTempFileName(temp_dir, "cfe")[0] +fdst = win32api.GetTempFileName(temp_dir, "cfe")[0] +print(fsrc, fdst) + +f = open(fsrc, "w") +f.write("xxxxxxxxxxxxxxxx\n" * 32768) +f.close() +## add a couple of extra data streams +f = open(fsrc + ":stream_y", "w") +f.write("yyyyyyyyyyyyyyyy\n" * 32768) +f.close() +f = open(fsrc + ":stream_z", "w") +f.write("zzzzzzzzzzzzzzzz\n" * 32768) +f.close() + +operation_desc = "Copying " + fsrc + " to " + fdst +win32file.CopyFileEx( + fsrc, + fdst, + ProgressRoutine, + Data=operation_desc, + Cancel=False, + CopyFlags=win32file.COPY_FILE_RESTARTABLE, + Transaction=None, +) diff --git a/lib/win32/Demos/CreateFileTransacted_MiniVersion.py b/lib/win32/Demos/CreateFileTransacted_MiniVersion.py new file mode 100644 index 00000000..fd600b59 --- /dev/null +++ b/lib/win32/Demos/CreateFileTransacted_MiniVersion.py @@ -0,0 +1,123 @@ +""" +This demonstrates the creation of miniversions of a file during a transaction. +The FSCTL_TXFS_CREATE_MINIVERSION control code saves any changes to a new +miniversion (effectively a savepoint within a transaction). +""" + +import os +import struct + +import win32api +import win32con +import win32file +import win32transaction +import winerror +import winioctlcon +from pywin32_testutil import str2bytes # py3k-friendly helper + + +def demo(): + """ + Definition of buffer used with FSCTL_TXFS_CREATE_MINIVERSION: + typedef struct _TXFS_CREATE_MINIVERSION_INFO{ + USHORT StructureVersion; + USHORT StructureLength; + ULONG BaseVersion; + USHORT MiniVersion;} + """ + buf_fmt = "HHLH0L" ## buffer size must include struct padding + buf_size = struct.calcsize(buf_fmt) + + tempdir = win32api.GetTempPath() + tempfile = win32api.GetTempFileName(tempdir, "cft")[0] + print("Demonstrating transactions on tempfile", tempfile) + f = open(tempfile, "w") + f.write("This is original file.\n") + f.close() + + trans = win32transaction.CreateTransaction( + Description="Test creating miniversions of a file" + ) + hfile = win32file.CreateFileW( + tempfile, + win32con.GENERIC_READ | win32con.GENERIC_WRITE, + win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE, + None, + win32con.OPEN_EXISTING, + 0, + None, + Transaction=trans, + ) + + win32file.WriteFile(hfile, str2bytes("This is first miniversion.\n")) + buf = win32file.DeviceIoControl( + hfile, winioctlcon.FSCTL_TXFS_CREATE_MINIVERSION, None, buf_size, None + ) + struct_ver, struct_len, base_ver, ver_1 = struct.unpack(buf_fmt, buf) + + win32file.SetFilePointer(hfile, 0, win32con.FILE_BEGIN) + win32file.WriteFile(hfile, str2bytes("This is second miniversion!\n")) + buf = win32file.DeviceIoControl( + hfile, winioctlcon.FSCTL_TXFS_CREATE_MINIVERSION, None, buf_size, None + ) + struct_ver, struct_len, base_ver, ver_2 = struct.unpack(buf_fmt, buf) + hfile.Close() + + ## miniversions can't be opened with write access + hfile_0 = win32file.CreateFileW( + tempfile, + win32con.GENERIC_READ, + win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE, + None, + win32con.OPEN_EXISTING, + 0, + None, + Transaction=trans, + MiniVersion=base_ver, + ) + print("version:", base_ver, win32file.ReadFile(hfile_0, 100)) + hfile_0.Close() + + hfile_1 = win32file.CreateFileW( + tempfile, + win32con.GENERIC_READ, + win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE, + None, + win32con.OPEN_EXISTING, + 0, + None, + Transaction=trans, + MiniVersion=ver_1, + ) + print("version:", ver_1, win32file.ReadFile(hfile_1, 100)) + hfile_1.Close() + + hfile_2 = win32file.CreateFileW( + tempfile, + win32con.GENERIC_READ, + win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE, + None, + win32con.OPEN_EXISTING, + 0, + None, + Transaction=trans, + MiniVersion=ver_2, + ) + print("version:", ver_2, win32file.ReadFile(hfile_2, 100)) + hfile_2.Close() + + ## MiniVersions are destroyed when transaction is committed or rolled back + win32transaction.CommitTransaction(trans) + + os.unlink(tempfile) + + +if __name__ == "__main__": + # When run on CI, this fails with NOT_SUPPORTED, so don't have that cause "failure" + try: + demo() + except win32file.error as e: + if e.winerror == winerror.ERROR_NOT_SUPPORTED: + print("These features are not supported by this filesystem.") + else: + raise diff --git a/lib/win32/Demos/EvtFormatMessage.py b/lib/win32/Demos/EvtFormatMessage.py new file mode 100644 index 00000000..12543869 --- /dev/null +++ b/lib/win32/Demos/EvtFormatMessage.py @@ -0,0 +1,83 @@ +import sys + +import win32evtlog + + +def main(): + path = "System" + num_events = 5 + if len(sys.argv) > 2: + path = sys.argv[1] + num_events = int(sys.argv[2]) + elif len(sys.argv) > 1: + path = sys.argv[1] + + query = win32evtlog.EvtQuery(path, win32evtlog.EvtQueryForwardDirection) + events = win32evtlog.EvtNext(query, num_events) + context = win32evtlog.EvtCreateRenderContext(win32evtlog.EvtRenderContextSystem) + + for i, event in enumerate(events, 1): + result = win32evtlog.EvtRender( + event, win32evtlog.EvtRenderEventValues, Context=context + ) + + print("Event {}".format(i)) + + level_value, level_variant = result[win32evtlog.EvtSystemLevel] + if level_variant != win32evtlog.EvtVarTypeNull: + if level_value == 1: + print(" Level: CRITICAL") + elif level_value == 2: + print(" Level: ERROR") + elif level_value == 3: + print(" Level: WARNING") + elif level_value == 4: + print(" Level: INFO") + elif level_value == 5: + print(" Level: VERBOSE") + else: + print(" Level: UNKNOWN") + + time_created_value, time_created_variant = result[ + win32evtlog.EvtSystemTimeCreated + ] + if time_created_variant != win32evtlog.EvtVarTypeNull: + print(" Timestamp: {}".format(time_created_value.isoformat())) + + computer_value, computer_variant = result[win32evtlog.EvtSystemComputer] + if computer_variant != win32evtlog.EvtVarTypeNull: + print(" FQDN: {}".format(computer_value)) + + provider_name_value, provider_name_variant = result[ + win32evtlog.EvtSystemProviderName + ] + if provider_name_variant != win32evtlog.EvtVarTypeNull: + print(" Provider: {}".format(provider_name_value)) + + try: + metadata = win32evtlog.EvtOpenPublisherMetadata(provider_name_value) + # pywintypes.error: (2, 'EvtOpenPublisherMetadata', 'The system cannot find the file specified.') + except Exception: + pass + else: + try: + message = win32evtlog.EvtFormatMessage( + metadata, event, win32evtlog.EvtFormatMessageEvent + ) + # pywintypes.error: (15027, 'EvtFormatMessage: allocated 0, need buffer of size 0', 'The message resource is present but the message was not found in the message table.') + except Exception: + pass + else: + try: + print(" Message: {}".format(message)) + except UnicodeEncodeError: + # Obscure error when run under subprocess.Popen(), presumably due to + # not knowing the correct encoding for the console. + # > UnicodeEncodeError: \'charmap\' codec can\'t encode character \'\\u200e\' in position 57: character maps to \r\n' + # Can't reproduce when running manually, so it seems more a subprocess.Popen() + # than ours: + print(" Failed to decode:", repr(message)) + + +if __name__ == "__main__": + main() diff --git a/lib/win32/Demos/EvtSubscribe_pull.py b/lib/win32/Demos/EvtSubscribe_pull.py new file mode 100644 index 00000000..f4059796 --- /dev/null +++ b/lib/win32/Demos/EvtSubscribe_pull.py @@ -0,0 +1,28 @@ +## Demonstrates how to create a "pull" subscription +import win32con +import win32event +import win32evtlog + +query_text = '*[System[Provider[@Name="Microsoft-Windows-Winlogon"]]]' + +h = win32event.CreateEvent(None, 0, 0, None) +s = win32evtlog.EvtSubscribe( + "System", + win32evtlog.EvtSubscribeStartAtOldestRecord, + SignalEvent=h, + Query=query_text, +) + +while 1: + while 1: + events = win32evtlog.EvtNext(s, 10) + if len(events) == 0: + break + ##for event in events: + ## print(win32evtlog.EvtRender(event, win32evtlog.EvtRenderEventXml)) + print("retrieved %s events" % len(events)) + while 1: + print("waiting...") + w = win32event.WaitForSingleObjectEx(h, 2000, True) + if w == win32con.WAIT_OBJECT_0: + break diff --git a/lib/win32/Demos/EvtSubscribe_push.py b/lib/win32/Demos/EvtSubscribe_push.py new file mode 100644 index 00000000..519ef0d7 --- /dev/null +++ b/lib/win32/Demos/EvtSubscribe_push.py @@ -0,0 +1,25 @@ +## Demonstrates a "push" subscription with a callback function +import win32evtlog + +query_text = '*[System[Provider[@Name="Microsoft-Windows-Winlogon"]]]' + + +def c(reason, context, evt): + if reason == win32evtlog.EvtSubscribeActionError: + print("EvtSubscribeActionError") + elif reason == win32evtlog.EvtSubscribeActionDeliver: + print("EvtSubscribeActionDeliver") + else: + print("??? Unknown action ???", reason) + context.append(win32evtlog.EvtRender(evt, win32evtlog.EvtRenderEventXml)) + return 0 + + +evttext = [] +s = win32evtlog.EvtSubscribe( + "System", + win32evtlog.EvtSubscribeStartAtOldestRecord, + Query="*", + Callback=c, + Context=evttext, +) diff --git a/lib/win32/Demos/FileSecurityTest.py b/lib/win32/Demos/FileSecurityTest.py new file mode 100644 index 00000000..90c45483 --- /dev/null +++ b/lib/win32/Demos/FileSecurityTest.py @@ -0,0 +1,137 @@ +# Contributed by Kelly Kranabetter. +import os +import sys + +import ntsecuritycon +import pywintypes +import win32security +import winerror + +# get security information +# name=r"c:\autoexec.bat" +# name= r"g:\!workgrp\lim" +name = sys.argv[0] + +if not os.path.exists(name): + print(name, "does not exist!") + sys.exit() + +print("On file ", name, "\n") + +# get owner SID +print("OWNER") +try: + sd = win32security.GetFileSecurity(name, win32security.OWNER_SECURITY_INFORMATION) + sid = sd.GetSecurityDescriptorOwner() + print(" ", win32security.LookupAccountSid(None, sid)) +except pywintypes.error as exc: + # in automation and network shares we see: + # pywintypes.error: (1332, 'LookupAccountName', 'No mapping between account names and security IDs was done.') + if exc.winerror != winerror.ERROR_NONE_MAPPED: + raise + print("No owner information is available") + +# get group SID +try: + print("GROUP") + sd = win32security.GetFileSecurity(name, win32security.GROUP_SECURITY_INFORMATION) + sid = sd.GetSecurityDescriptorGroup() + print(" ", win32security.LookupAccountSid(None, sid)) +except pywintypes.error as exc: + if exc.winerror != winerror.ERROR_NONE_MAPPED: + raise + print("No group information is available") + +# get ACEs +sd = win32security.GetFileSecurity(name, win32security.DACL_SECURITY_INFORMATION) +dacl = sd.GetSecurityDescriptorDacl() +if dacl == None: + print("No Discretionary ACL") +else: + for ace_no in range(0, dacl.GetAceCount()): + ace = dacl.GetAce(ace_no) + print("ACE", ace_no) + + print(" -Type") + for i in ( + "ACCESS_ALLOWED_ACE_TYPE", + "ACCESS_DENIED_ACE_TYPE", + "SYSTEM_AUDIT_ACE_TYPE", + "SYSTEM_ALARM_ACE_TYPE", + ): + if getattr(ntsecuritycon, i) == ace[0][0]: + print(" ", i) + + print(" -Flags", hex(ace[0][1])) + for i in ( + "OBJECT_INHERIT_ACE", + "CONTAINER_INHERIT_ACE", + "NO_PROPAGATE_INHERIT_ACE", + "INHERIT_ONLY_ACE", + "SUCCESSFUL_ACCESS_ACE_FLAG", + "FAILED_ACCESS_ACE_FLAG", + ): + if getattr(ntsecuritycon, i) & ace[0][1] == getattr(ntsecuritycon, i): + print(" ", i) + + print(" -mask", hex(ace[1])) + + # files and directories do permissions differently + permissions_file = ( + "DELETE", + "READ_CONTROL", + "WRITE_DAC", + "WRITE_OWNER", + "SYNCHRONIZE", + "FILE_GENERIC_READ", + "FILE_GENERIC_WRITE", + "FILE_GENERIC_EXECUTE", + "FILE_DELETE_CHILD", + ) + permissions_dir = ( + "DELETE", + "READ_CONTROL", + "WRITE_DAC", + "WRITE_OWNER", + "SYNCHRONIZE", + "FILE_ADD_SUBDIRECTORY", + "FILE_ADD_FILE", + "FILE_DELETE_CHILD", + "FILE_LIST_DIRECTORY", + "FILE_TRAVERSE", + "FILE_READ_ATTRIBUTES", + "FILE_WRITE_ATTRIBUTES", + "FILE_READ_EA", + "FILE_WRITE_EA", + ) + permissions_dir_inherit = ( + "DELETE", + "READ_CONTROL", + "WRITE_DAC", + "WRITE_OWNER", + "SYNCHRONIZE", + "GENERIC_READ", + "GENERIC_WRITE", + "GENERIC_EXECUTE", + "GENERIC_ALL", + ) + if os.path.isfile(name): + permissions = permissions_file + else: + permissions = permissions_dir + # directories also contain an ACE that is inherited by children (files) within them + if ( + ace[0][1] & ntsecuritycon.OBJECT_INHERIT_ACE + == ntsecuritycon.OBJECT_INHERIT_ACE + and ace[0][1] & ntsecuritycon.INHERIT_ONLY_ACE + == ntsecuritycon.INHERIT_ONLY_ACE + ): + permissions = permissions_dir_inherit + + calc_mask = 0 # calculate the mask so we can see if we are printing all of the permissions + for i in permissions: + if getattr(ntsecuritycon, i) & ace[1] == getattr(ntsecuritycon, i): + calc_mask = calc_mask | getattr(ntsecuritycon, i) + print(" ", i) + print(" ", "Calculated Check Mask=", hex(calc_mask)) + print(" -SID\n ", win32security.LookupAccountSid(None, ace[2])) diff --git a/lib/win32/Demos/GetSaveFileName.py b/lib/win32/Demos/GetSaveFileName.py new file mode 100644 index 00000000..28587505 --- /dev/null +++ b/lib/win32/Demos/GetSaveFileName.py @@ -0,0 +1,43 @@ +import os + +import win32con +import win32gui + +filter = "Python Scripts\0*.py;*.pyw;*.pys\0Text files\0*.txt\0" +customfilter = "Other file types\0*.*\0" + +fname, customfilter, flags = win32gui.GetSaveFileNameW( + InitialDir=os.environ["temp"], + Flags=win32con.OFN_ALLOWMULTISELECT | win32con.OFN_EXPLORER, + File="somefilename", + DefExt="py", + Title="GetSaveFileNameW", + Filter=filter, + CustomFilter=customfilter, + FilterIndex=1, +) + +print("save file names:", repr(fname)) +print("filter used:", repr(customfilter)) +print("Flags:", flags) +for k, v in list(win32con.__dict__.items()): + if k.startswith("OFN_") and flags & v: + print("\t" + k) + +fname, customfilter, flags = win32gui.GetOpenFileNameW( + InitialDir=os.environ["temp"], + Flags=win32con.OFN_ALLOWMULTISELECT | win32con.OFN_EXPLORER, + File="somefilename", + DefExt="py", + Title="GetOpenFileNameW", + Filter=filter, + CustomFilter=customfilter, + FilterIndex=0, +) + +print("open file names:", repr(fname)) +print("filter used:", repr(customfilter)) +print("Flags:", flags) +for k, v in list(win32con.__dict__.items()): + if k.startswith("OFN_") and flags & v: + print("\t" + k) diff --git a/lib/win32/Demos/NetValidatePasswordPolicy.py b/lib/win32/Demos/NetValidatePasswordPolicy.py new file mode 100644 index 00000000..86c3bc40 --- /dev/null +++ b/lib/win32/Demos/NetValidatePasswordPolicy.py @@ -0,0 +1,127 @@ +"""A demo of using win32net.NetValidatePasswordPolicy. + +Example usage: + +% NetValidatePasswordPolicy.py --password=foo change +which might return: + +> Result of 'change' validation is 0: The operation completed successfully. + +or depending on the policy: + +> Result of 'change' validation is 2245: The password does not meet the +> password policy requirements. Check the minimum password length, +> password complexity and password history requirements. + +Adding --user doesn't seem to change the output (even the PasswordLastSet seen +when '-f' is used doesn't depend on the username), but theoretically it will +also check the password history for the specified user. + +% NetValidatePasswordPolicy.py auth + +which always (with and without '-m') seems to return: + +> Result of 'auth' validation is 2701: Password must change at next logon +""" + +import optparse +import sys +from pprint import pprint + +import win32api +import win32net +import win32netcon + + +def main(): + parser = optparse.OptionParser( + "%prog [options] auth|change ...", + description="A win32net.NetValidatePasswordPolicy demo.", + ) + + parser.add_option( + "-u", + "--username", + action="store", + help="The username to pass to the function (only for the " "change command", + ) + + parser.add_option( + "-p", + "--password", + action="store", + help="The clear-text password to pass to the function " + "(only for the 'change' command)", + ) + + parser.add_option( + "-m", + "--password-matched", + action="store_false", + default=True, + help="Used to specify the password does NOT match (ie, " + "uses False for the PasswordMatch/PasswordMatched " + "arg, both 'auth' and 'change' commands)", + ) + + parser.add_option( + "-s", + "--server", + action="store", + help="The name of the server to execute the command on", + ) + + parser.add_option( + "-f", + "--show_fields", + action="store_true", + default=False, + help="Print the NET_VALIDATE_PERSISTED_FIELDS returned", + ) + + options, args = parser.parse_args() + + if not args: + args = ["auth"] + + for arg in args: + if arg == "auth": + input = { + "PasswordMatched": options.password_matched, + } + val_type = win32netcon.NetValidateAuthentication + elif arg == "change": + input = { + "ClearPassword": options.password, + "PasswordMatch": options.password_matched, + "UserAccountName": options.username, + } + val_type = win32netcon.NetValidatePasswordChange + else: + parser.error("Invalid arg - must be 'auth' or 'change'") + + try: + fields, status = win32net.NetValidatePasswordPolicy( + options.server, None, val_type, input + ) + except NotImplementedError: + print("NetValidatePasswordPolicy not implemented on this platform.") + return 1 + except win32net.error as exc: + print("NetValidatePasswordPolicy failed: ", exc) + return 1 + + if options.show_fields: + print("NET_VALIDATE_PERSISTED_FIELDS fields:") + pprint(fields) + + print( + "Result of %r validation is %d: %s" + % (arg, status, win32api.FormatMessage(status).strip()) + ) + + return 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/lib/win32/Demos/OpenEncryptedFileRaw.py b/lib/win32/Demos/OpenEncryptedFileRaw.py new file mode 100644 index 00000000..aa0f2a7c --- /dev/null +++ b/lib/win32/Demos/OpenEncryptedFileRaw.py @@ -0,0 +1,67 @@ +import os + +import win32api +import win32file +import winerror + + +def ReadCallback(input_buffer, data, buflen): + fnamein, fnameout, f = data + ## print fnamein, fnameout, buflen + f.write(input_buffer) + ## python 2.3 throws an error if return value is a plain int + return winerror.ERROR_SUCCESS + + +def WriteCallback(output_buffer, data, buflen): + fnamebackup, fnameout, f = data + file_data = f.read(buflen) + ## returning 0 as len terminates WriteEncryptedFileRaw + output_len = len(file_data) + output_buffer[:output_len] = file_data + return winerror.ERROR_SUCCESS, output_len + + +tmp_dir = win32api.GetTempPath() +dst_dir = win32api.GetTempFileName(tmp_dir, "oef")[0] +os.remove(dst_dir) +os.mkdir(dst_dir) +print("Destination dir:", dst_dir) + +## create an encrypted file +fname = win32api.GetTempFileName(dst_dir, "ref")[0] +print("orig file:", fname) +f = open(fname, "w") +f.write("xxxxxxxxxxxxxxxx\n" * 32768) +f.close() +## add a couple of extra data streams +f = open(fname + ":stream_y", "w") +f.write("yyyyyyyyyyyyyyyy\n" * 32768) +f.close() +f = open(fname + ":stream_z", "w") +f.write("zzzzzzzzzzzzzzzz\n" * 32768) +f.close() +win32file.EncryptFile(fname) + +## backup raw data of encrypted file +bkup_fname = win32api.GetTempFileName(dst_dir, "bef")[0] +print("backup file:", bkup_fname) +f = open(bkup_fname, "wb") +ctxt = win32file.OpenEncryptedFileRaw(fname, 0) +try: + win32file.ReadEncryptedFileRaw(ReadCallback, (fname, bkup_fname, f), ctxt) +finally: + ## if context is not closed, file remains locked even if calling process is killed + win32file.CloseEncryptedFileRaw(ctxt) + f.close() + +## restore data from backup to new encrypted file +dst_fname = win32api.GetTempFileName(dst_dir, "wef")[0] +print("restored file:", dst_fname) +f = open(bkup_fname, "rb") +ctxtout = win32file.OpenEncryptedFileRaw(dst_fname, win32file.CREATE_FOR_IMPORT) +try: + win32file.WriteEncryptedFileRaw(WriteCallback, (bkup_fname, dst_fname, f), ctxtout) +finally: + win32file.CloseEncryptedFileRaw(ctxtout) + f.close() diff --git a/lib/win32/Demos/RegCreateKeyTransacted.py b/lib/win32/Demos/RegCreateKeyTransacted.py new file mode 100644 index 00000000..687f07ae --- /dev/null +++ b/lib/win32/Demos/RegCreateKeyTransacted.py @@ -0,0 +1,60 @@ +import win32api +import win32con +import win32transaction + +keyname = "Pywin32 test transacted registry functions" +subkeyname = "test transacted subkey" +classname = "Transacted Class" + +trans = win32transaction.CreateTransaction(Description="test RegCreateKeyTransacted") +key, disp = win32api.RegCreateKeyEx( + win32con.HKEY_CURRENT_USER, + keyname, + samDesired=win32con.KEY_ALL_ACCESS, + Class=classname, +) +## clean up any existing keys +for subk in win32api.RegEnumKeyExW(key): + win32api.RegDeleteKey(key, subk[0]) + +## reopen key in transacted mode +transacted_key = win32api.RegOpenKeyTransacted( + Key=win32con.HKEY_CURRENT_USER, + SubKey=keyname, + Transaction=trans, + samDesired=win32con.KEY_ALL_ACCESS, +) +subkey, disp = win32api.RegCreateKeyEx( + transacted_key, + subkeyname, + Transaction=trans, + samDesired=win32con.KEY_ALL_ACCESS, + Class=classname, +) + +## Newly created key should not be visible from non-transacted handle +subkeys = [s[0] for s in win32api.RegEnumKeyExW(key)] +assert subkeyname not in subkeys + +transacted_subkeys = [s[0] for s in win32api.RegEnumKeyExW(transacted_key)] +assert subkeyname in transacted_subkeys + +## Key should be visible to non-transacted handle after commit +win32transaction.CommitTransaction(trans) +subkeys = [s[0] for s in win32api.RegEnumKeyExW(key)] +assert subkeyname in subkeys + +## test transacted delete +del_trans = win32transaction.CreateTransaction( + Description="test RegDeleteKeyTransacted" +) +win32api.RegDeleteKeyEx(key, subkeyname, Transaction=del_trans) +## subkey should still show up for non-transacted handle +subkeys = [s[0] for s in win32api.RegEnumKeyExW(key)] +assert subkeyname in subkeys +## ... and should be gone after commit +win32transaction.CommitTransaction(del_trans) +subkeys = [s[0] for s in win32api.RegEnumKeyExW(key)] +assert subkeyname not in subkeys + +win32api.RegDeleteKey(win32con.HKEY_CURRENT_USER, keyname) diff --git a/lib/win32/Demos/RegRestoreKey.py b/lib/win32/Demos/RegRestoreKey.py new file mode 100644 index 00000000..69ce32ea --- /dev/null +++ b/lib/win32/Demos/RegRestoreKey.py @@ -0,0 +1,71 @@ +import os + +import ntsecuritycon +import win32api +import win32con +import win32security +import winnt + +temp_dir = win32api.GetTempPath() +fname = win32api.GetTempFileName(temp_dir, "rsk")[0] +print(fname) +## file can't exist +os.remove(fname) + +## enable backup and restore privs +required_privs = ( + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_BACKUP_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), +) +ph = win32api.GetCurrentProcess() +th = win32security.OpenProcessToken( + ph, win32con.TOKEN_READ | win32con.TOKEN_ADJUST_PRIVILEGES +) +adjusted_privs = win32security.AdjustTokenPrivileges(th, 0, required_privs) + +try: + sa = win32security.SECURITY_ATTRIBUTES() + my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0] + sa.SECURITY_DESCRIPTOR.SetSecurityDescriptorOwner(my_sid, 0) + + k, disp = win32api.RegCreateKeyEx( + win32con.HKEY_CURRENT_USER, + "Python test key", + SecurityAttributes=sa, + samDesired=win32con.KEY_ALL_ACCESS, + Class="some class", + Options=0, + ) + win32api.RegSetValue(k, None, win32con.REG_SZ, "Default value for python test key") + + subk, disp = win32api.RegCreateKeyEx( + k, + "python test subkey", + SecurityAttributes=sa, + samDesired=win32con.KEY_ALL_ACCESS, + Class="some other class", + Options=0, + ) + win32api.RegSetValue(subk, None, win32con.REG_SZ, "Default value for subkey") + + win32api.RegSaveKeyEx( + k, fname, Flags=winnt.REG_STANDARD_FORMAT, SecurityAttributes=sa + ) + + restored_key, disp = win32api.RegCreateKeyEx( + win32con.HKEY_CURRENT_USER, + "Python test key(restored)", + SecurityAttributes=sa, + samDesired=win32con.KEY_ALL_ACCESS, + Class="restored class", + Options=0, + ) + win32api.RegRestoreKey(restored_key, fname) +finally: + win32security.AdjustTokenPrivileges(th, 0, adjusted_privs) diff --git a/lib/win32/Demos/SystemParametersInfo.py b/lib/win32/Demos/SystemParametersInfo.py new file mode 100644 index 00000000..55a331e6 --- /dev/null +++ b/lib/win32/Demos/SystemParametersInfo.py @@ -0,0 +1,210 @@ +import glob +import os +import time + +import win32api +import win32con +import win32gui + +## some of these tests will fail for systems prior to XP + +for pname in ( + ## Set actions all take an unsigned int in pvParam + "SPI_GETMOUSESPEED", + "SPI_GETACTIVEWNDTRKTIMEOUT", + "SPI_GETCARETWIDTH", + "SPI_GETFOREGROUNDFLASHCOUNT", + "SPI_GETFOREGROUNDLOCKTIMEOUT", + ## Set actions all take an unsigned int in uiParam + "SPI_GETWHEELSCROLLLINES", + "SPI_GETKEYBOARDDELAY", + "SPI_GETKEYBOARDSPEED", + "SPI_GETMOUSEHOVERHEIGHT", + "SPI_GETMOUSEHOVERWIDTH", + "SPI_GETMOUSEHOVERTIME", + "SPI_GETSCREENSAVETIMEOUT", + "SPI_GETMENUSHOWDELAY", + "SPI_GETLOWPOWERTIMEOUT", + "SPI_GETPOWEROFFTIMEOUT", + "SPI_GETBORDER", + ## below are winxp only: + "SPI_GETFONTSMOOTHINGCONTRAST", + "SPI_GETFONTSMOOTHINGTYPE", + "SPI_GETFOCUSBORDERHEIGHT", + "SPI_GETFOCUSBORDERWIDTH", + "SPI_GETMOUSECLICKLOCKTIME", +): + print(pname) + cget = getattr(win32con, pname) + cset = getattr(win32con, pname.replace("_GET", "_SET")) + orig_value = win32gui.SystemParametersInfo(cget) + print("\toriginal setting:", orig_value) + win32gui.SystemParametersInfo(cset, orig_value + 1) + new_value = win32gui.SystemParametersInfo(cget) + print("\tnew value:", new_value) + # On Vista, some of these values seem to be ignored. So only "fail" if + # the new value isn't what we set or the original + if new_value != orig_value + 1: + assert new_value == orig_value + print("Strange - setting %s seems to have been ignored" % (pname,)) + win32gui.SystemParametersInfo(cset, orig_value) + assert win32gui.SystemParametersInfo(cget) == orig_value + + +# these take a boolean value in pvParam +# change to opposite, check that it was changed and change back +for pname in ( + "SPI_GETFLATMENU", + "SPI_GETDROPSHADOW", + "SPI_GETKEYBOARDCUES", + "SPI_GETMENUFADE", + "SPI_GETCOMBOBOXANIMATION", + "SPI_GETCURSORSHADOW", + "SPI_GETGRADIENTCAPTIONS", + "SPI_GETHOTTRACKING", + "SPI_GETLISTBOXSMOOTHSCROLLING", + "SPI_GETMENUANIMATION", + "SPI_GETSELECTIONFADE", + "SPI_GETTOOLTIPANIMATION", + "SPI_GETTOOLTIPFADE", + "SPI_GETUIEFFECTS", + "SPI_GETACTIVEWINDOWTRACKING", + "SPI_GETACTIVEWNDTRKZORDER", +): + print(pname) + cget = getattr(win32con, pname) + cset = getattr(win32con, pname.replace("_GET", "_SET")) + orig_value = win32gui.SystemParametersInfo(cget) + print(orig_value) + win32gui.SystemParametersInfo(cset, not orig_value) + new_value = win32gui.SystemParametersInfo(cget) + print(new_value) + assert orig_value != new_value + win32gui.SystemParametersInfo(cset, orig_value) + assert win32gui.SystemParametersInfo(cget) == orig_value + + +# these take a boolean in uiParam +# could combine with above section now that SystemParametersInfo only takes a single parameter +for pname in ( + "SPI_GETFONTSMOOTHING", + "SPI_GETICONTITLEWRAP", + "SPI_GETBEEP", + "SPI_GETBLOCKSENDINPUTRESETS", + "SPI_GETKEYBOARDPREF", + "SPI_GETSCREENSAVEACTIVE", + "SPI_GETMENUDROPALIGNMENT", + "SPI_GETDRAGFULLWINDOWS", + "SPI_GETSHOWIMEUI", +): + cget = getattr(win32con, pname) + cset = getattr(win32con, pname.replace("_GET", "_SET")) + orig_value = win32gui.SystemParametersInfo(cget) + win32gui.SystemParametersInfo(cset, not orig_value) + new_value = win32gui.SystemParametersInfo(cget) + # Some of these also can't be changed (eg, SPI_GETSCREENSAVEACTIVE) so + # don't actually get upset. + if orig_value != new_value: + print("successfully toggled", pname, "from", orig_value, "to", new_value) + else: + print("couldn't toggle", pname, "from", orig_value) + win32gui.SystemParametersInfo(cset, orig_value) + assert win32gui.SystemParametersInfo(cget) == orig_value + + +print("SPI_GETICONTITLELOGFONT") +lf = win32gui.SystemParametersInfo(win32con.SPI_GETICONTITLELOGFONT) +orig_height = lf.lfHeight +orig_italic = lf.lfItalic +print("Height:", orig_height, "Italic:", orig_italic) +lf.lfHeight += 2 +lf.lfItalic = not lf.lfItalic +win32gui.SystemParametersInfo(win32con.SPI_SETICONTITLELOGFONT, lf) +new_lf = win32gui.SystemParametersInfo(win32con.SPI_GETICONTITLELOGFONT) +print("New Height:", new_lf.lfHeight, "New Italic:", new_lf.lfItalic) +assert new_lf.lfHeight == orig_height + 2 +assert new_lf.lfItalic != orig_italic + +lf.lfHeight = orig_height +lf.lfItalic = orig_italic +win32gui.SystemParametersInfo(win32con.SPI_SETICONTITLELOGFONT, lf) +new_lf = win32gui.SystemParametersInfo(win32con.SPI_GETICONTITLELOGFONT) +assert new_lf.lfHeight == orig_height +assert new_lf.lfItalic == orig_italic + + +print("SPI_GETMOUSEHOVERWIDTH, SPI_GETMOUSEHOVERHEIGHT, SPI_GETMOUSEHOVERTIME") +w = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERWIDTH) +h = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERHEIGHT) +t = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERTIME) +print("w,h,t:", w, h, t) + +win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERWIDTH, w + 1) +win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERHEIGHT, h + 2) +win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERTIME, t + 3) +new_w = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERWIDTH) +new_h = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERHEIGHT) +new_t = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERTIME) +print("new w,h,t:", new_w, new_h, new_t) +assert new_w == w + 1 +assert new_h == h + 2 +assert new_t == t + 3 + +win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERWIDTH, w) +win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERHEIGHT, h) +win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERTIME, t) +new_w = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERWIDTH) +new_h = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERHEIGHT) +new_t = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERTIME) +assert new_w == w +assert new_h == h +assert new_t == t + + +print("SPI_SETDOUBLECLKWIDTH, SPI_SETDOUBLECLKHEIGHT") +x = win32api.GetSystemMetrics(win32con.SM_CXDOUBLECLK) +y = win32api.GetSystemMetrics(win32con.SM_CYDOUBLECLK) +print("x,y:", x, y) +win32gui.SystemParametersInfo(win32con.SPI_SETDOUBLECLKWIDTH, x + 1) +win32gui.SystemParametersInfo(win32con.SPI_SETDOUBLECLKHEIGHT, y + 2) +new_x = win32api.GetSystemMetrics(win32con.SM_CXDOUBLECLK) +new_y = win32api.GetSystemMetrics(win32con.SM_CYDOUBLECLK) +print("new x,y:", new_x, new_y) +assert new_x == x + 1 +assert new_y == y + 2 +win32gui.SystemParametersInfo(win32con.SPI_SETDOUBLECLKWIDTH, x) +win32gui.SystemParametersInfo(win32con.SPI_SETDOUBLECLKHEIGHT, y) +new_x = win32api.GetSystemMetrics(win32con.SM_CXDOUBLECLK) +new_y = win32api.GetSystemMetrics(win32con.SM_CYDOUBLECLK) +assert new_x == x +assert new_y == y + + +print("SPI_SETDRAGWIDTH, SPI_SETDRAGHEIGHT") +dw = win32api.GetSystemMetrics(win32con.SM_CXDRAG) +dh = win32api.GetSystemMetrics(win32con.SM_CYDRAG) +print("dw,dh:", dw, dh) +win32gui.SystemParametersInfo(win32con.SPI_SETDRAGWIDTH, dw + 1) +win32gui.SystemParametersInfo(win32con.SPI_SETDRAGHEIGHT, dh + 2) +new_dw = win32api.GetSystemMetrics(win32con.SM_CXDRAG) +new_dh = win32api.GetSystemMetrics(win32con.SM_CYDRAG) +print("new dw,dh:", new_dw, new_dh) +assert new_dw == dw + 1 +assert new_dh == dh + 2 +win32gui.SystemParametersInfo(win32con.SPI_SETDRAGWIDTH, dw) +win32gui.SystemParametersInfo(win32con.SPI_SETDRAGHEIGHT, dh) +new_dw = win32api.GetSystemMetrics(win32con.SM_CXDRAG) +new_dh = win32api.GetSystemMetrics(win32con.SM_CYDRAG) +assert new_dw == dw +assert new_dh == dh + + +orig_wallpaper = win32gui.SystemParametersInfo(Action=win32con.SPI_GETDESKWALLPAPER) +print("Original: ", orig_wallpaper) +for bmp in glob.glob(os.path.join(os.environ["windir"], "*.bmp")): + print(bmp) + win32gui.SystemParametersInfo(win32con.SPI_SETDESKWALLPAPER, Param=bmp) + print(win32gui.SystemParametersInfo(Action=win32con.SPI_GETDESKWALLPAPER)) + time.sleep(1) + +win32gui.SystemParametersInfo(win32con.SPI_SETDESKWALLPAPER, Param=orig_wallpaper) diff --git a/lib/win32/Demos/c_extension/setup.py b/lib/win32/Demos/c_extension/setup.py new file mode 100644 index 00000000..6f5cb417 --- /dev/null +++ b/lib/win32/Demos/c_extension/setup.py @@ -0,0 +1,26 @@ +# A sample distutils script to show to build your own +# extension module which extends pywintypes or pythoncom. +# +# Use 'python setup.py build' to build this extension. +import os +from distutils.core import Extension, setup +from sysconfig import get_paths + +sources = ["win32_extension.cpp"] +lib_dir = get_paths()["platlib"] + +# Specify the directory where the PyWin32 .h and .lib files are installed. +# If you are doing a win32com extension, you will also need to add +# win32com\Include and win32com\Libs. +ext = Extension( + "win32_extension", + sources, + include_dirs=[os.path.join(lib_dir, "win32", "include")], + library_dirs=[os.path.join(lib_dir, "win32", "libs")], +) + +setup( + name="win32 extension sample", + version="0.1", + ext_modules=[ext], +) diff --git a/lib/win32/Demos/cerapi.py b/lib/win32/Demos/cerapi.py new file mode 100644 index 00000000..c5d93166 --- /dev/null +++ b/lib/win32/Demos/cerapi.py @@ -0,0 +1,254 @@ +# A demo of the Windows CE Remote API +# +# This connects to a CE device, and interacts with it. + +import getopt +import os +import sys + +import win32api +import win32con +import win32event +import wincerapi + + +def DumpPythonRegistry(): + try: + h = wincerapi.CeRegOpenKeyEx( + win32con.HKEY_LOCAL_MACHINE, + "Software\\Python\\PythonCore\\%s\\PythonPath" % sys.winver, + ) + except win32api.error: + print("The remote device does not appear to have Python installed") + return 0 + path, typ = wincerapi.CeRegQueryValueEx(h, None) + print("The remote PythonPath is '%s'" % (str(path),)) + h.Close() + return 1 + + +def DumpRegistry(root, level=0): + # A recursive dump of the remote registry to test most functions. + h = wincerapi.CeRegOpenKeyEx(win32con.HKEY_LOCAL_MACHINE, None) + level_prefix = " " * level + index = 0 + # Enumerate values. + while 1: + try: + name, data, typ = wincerapi.CeRegEnumValue(root, index) + except win32api.error: + break + print("%s%s=%s" % (level_prefix, name, repr(str(data)))) + index = index + 1 + # Now enumerate all keys. + index = 0 + while 1: + try: + name, klass = wincerapi.CeRegEnumKeyEx(root, index) + except win32api.error: + break + print("%s%s\\" % (level_prefix, name)) + subkey = wincerapi.CeRegOpenKeyEx(root, name) + DumpRegistry(subkey, level + 1) + index = index + 1 + + +def DemoCopyFile(): + # Create a file on the device, and write a string. + cefile = wincerapi.CeCreateFile( + "TestPython", win32con.GENERIC_WRITE, 0, None, win32con.OPEN_ALWAYS, 0, None + ) + wincerapi.CeWriteFile(cefile, "Hello from Python") + cefile.Close() + # reopen the file and check the data. + cefile = wincerapi.CeCreateFile( + "TestPython", win32con.GENERIC_READ, 0, None, win32con.OPEN_EXISTING, 0, None + ) + if wincerapi.CeReadFile(cefile, 100) != "Hello from Python": + print("Couldnt read the data from the device!") + cefile.Close() + # Delete the test file + wincerapi.CeDeleteFile("TestPython") + print("Created, wrote to, read from and deleted a test file!") + + +def DemoCreateProcess(): + try: + hp, ht, pid, tid = wincerapi.CeCreateProcess( + "Windows\\Python.exe", "", None, None, 0, 0, None, "", None + ) + + # Not necessary, except to see if handle closing raises an exception + # (if auto-closed, the error is suppressed) + hp.Close() + ht.Close() + print("Python is running on the remote device!") + except win32api.error as xxx_todo_changeme1: + (hr, fn, msg) = xxx_todo_changeme1.args + print("Couldnt execute remote process -", msg) + + +def DumpRemoteMachineStatus(): + ( + ACLineStatus, + BatteryFlag, + BatteryLifePercent, + BatteryLifeTime, + BatteryFullLifeTime, + BackupBatteryFlag, + BackupBatteryLifePercent, + BackupBatteryLifeTime, + BackupBatteryLifeTime, + ) = wincerapi.CeGetSystemPowerStatusEx() + if ACLineStatus: + power = "AC" + else: + power = "battery" + if BatteryLifePercent == 255: + batPerc = "unknown" + else: + batPerc = BatteryLifePercent + print( + "The batteries are at %s%%, and is currently being powered by %s" + % (batPerc, power) + ) + + ( + memLoad, + totalPhys, + availPhys, + totalPage, + availPage, + totalVirt, + availVirt, + ) = wincerapi.CeGlobalMemoryStatus() + + print("The memory is %d%% utilized." % (memLoad)) + print("%-20s%-10s%-10s" % ("", "Total", "Avail")) + print("%-20s%-10s%-10s" % ("Physical Memory", totalPhys, availPhys)) + print("%-20s%-10s%-10s" % ("Virtual Memory", totalVirt, availVirt)) + print("%-20s%-10s%-10s" % ("Paging file", totalPage, availPage)) + + storeSize, freeSize = wincerapi.CeGetStoreInformation() + print("%-20s%-10s%-10s" % ("File store", storeSize, freeSize)) + + print("The CE temp path is", wincerapi.CeGetTempPath()) + print("The system info for the device is", wincerapi.CeGetSystemInfo()) + + +def DumpRemoteFolders(): + # Dump all special folders possible. + for name, val in list(wincerapi.__dict__.items()): + if name[:6] == "CSIDL_": + try: + loc = str(wincerapi.CeGetSpecialFolderPath(val)) + print("Folder %s is at %s" % (name, loc)) + except win32api.error as details: + pass + + # Get the shortcut targets for the "Start Menu" + print("Dumping start menu shortcuts...") + try: + startMenu = str(wincerapi.CeGetSpecialFolderPath(wincerapi.CSIDL_STARTMENU)) + except win32api.error as details: + print("This device has no start menu!", details) + startMenu = None + + if startMenu: + for fileAttr in wincerapi.CeFindFiles(os.path.join(startMenu, "*")): + fileName = fileAttr[8] + fullPath = os.path.join(startMenu, str(fileName)) + try: + resolved = wincerapi.CeSHGetShortcutTarget(fullPath) + except win32api.error as xxx_todo_changeme: + (rc, fn, msg) = xxx_todo_changeme.args + resolved = "#Error - %s" % msg + print("%s->%s" % (fileName, resolved)) + + # print "The start menu is at", + # print wincerapi.CeSHGetShortcutTarget("\\Windows\\Start Menu\\Shortcut to Python.exe.lnk") + + +def usage(): + print("Options:") + print("-a - Execute all demos") + print("-p - Execute Python process on remote device") + print("-r - Dump the remote registry") + print("-f - Dump all remote special folder locations") + print("-s - Dont dump machine status") + print("-y - Perform asynch init of CE connection") + + +def main(): + async_init = bStartPython = bDumpRegistry = bDumpFolders = 0 + bDumpStatus = 1 + try: + opts, args = getopt.getopt(sys.argv[1:], "apr") + except getopt.error as why: + print("Invalid usage:", why) + usage() + return + + for o, v in opts: + if o == "-a": + bStartPython = bDumpRegistry = bDumpStatus = bDumpFolders = asynch_init = 1 + if o == "-p": + bStartPython = 1 + if o == "-r": + bDumpRegistry = 1 + if o == "-s": + bDumpStatus = 0 + if o == "-f": + bDumpFolders = 1 + if o == "-y": + print("Doing asynch init of CE connection") + async_init = 1 + + if async_init: + event, rc = wincerapi.CeRapiInitEx() + while 1: + rc = win32event.WaitForSingleObject(event, 500) + if rc == win32event.WAIT_OBJECT_0: + # We connected. + break + else: + print( + "Waiting for Initialize to complete (picture a Cancel button here :)" + ) + else: + wincerapi.CeRapiInit() + print("Connected to remote CE device.") + try: + verinfo = wincerapi.CeGetVersionEx() + print( + "The device is running windows CE version %d.%d - %s" + % (verinfo[0], verinfo[1], verinfo[4]) + ) + + if bDumpStatus: + print("Dumping remote machine status") + DumpRemoteMachineStatus() + + if bDumpRegistry: + print("Dumping remote registry...") + DumpRegistry(win32con.HKEY_LOCAL_MACHINE) + + if bDumpFolders: + print("Dumping remote folder information") + DumpRemoteFolders() + + DemoCopyFile() + if bStartPython: + print("Starting remote Python process") + if DumpPythonRegistry(): + DemoCreateProcess() + else: + print("Not trying to start Python, as it's not installed") + + finally: + wincerapi.CeRapiUninit() + print("Disconnected") + + +if __name__ == "__main__": + main() diff --git a/lib/win32/Demos/dde/ddeclient.py b/lib/win32/Demos/dde/ddeclient.py new file mode 100644 index 00000000..32af3130 --- /dev/null +++ b/lib/win32/Demos/dde/ddeclient.py @@ -0,0 +1,18 @@ +# 'Request' example added jjk 11/20/98 + +import dde +import win32ui + +server = dde.CreateServer() +server.Create("TestClient") + +conversation = dde.CreateConversation(server) + +conversation.ConnectTo("RunAny", "RunAnyCommand") +conversation.Exec("DoSomething") +conversation.Exec("DoSomethingElse") + +conversation.ConnectTo("RunAny", "ComputeStringLength") +s = "abcdefghi" +sl = conversation.Request(s) +print('length of "%s" is %s' % (s, sl)) diff --git a/lib/win32/Demos/dde/ddeserver.py b/lib/win32/Demos/dde/ddeserver.py new file mode 100644 index 00000000..0374827f --- /dev/null +++ b/lib/win32/Demos/dde/ddeserver.py @@ -0,0 +1,42 @@ +# 'Request' example added jjk 11/20/98 + +import dde +import win32ui +from pywin.mfc import object + + +class MySystemTopic(object.Object): + def __init__(self): + object.Object.__init__(self, dde.CreateServerSystemTopic()) + + def Exec(self, cmd): + print("System Topic asked to exec", cmd) + + +class MyOtherTopic(object.Object): + def __init__(self, topicName): + object.Object.__init__(self, dde.CreateTopic(topicName)) + + def Exec(self, cmd): + print("Other Topic asked to exec", cmd) + + +class MyRequestTopic(object.Object): + def __init__(self, topicName): + topic = dde.CreateTopic(topicName) + topic.AddItem(dde.CreateStringItem("")) + object.Object.__init__(self, topic) + + def Request(self, aString): + print("Request Topic asked to compute length of:", aString) + return str(len(aString)) + + +server = dde.CreateServer() +server.AddTopic(MySystemTopic()) +server.AddTopic(MyOtherTopic("RunAnyCommand")) +server.AddTopic(MyRequestTopic("ComputeStringLength")) +server.Create("RunAny") + +while 1: + win32ui.PumpWaitingMessages(0, -1) diff --git a/lib/win32/Demos/desktopmanager.py b/lib/win32/Demos/desktopmanager.py new file mode 100644 index 00000000..6ffaf2a9 --- /dev/null +++ b/lib/win32/Demos/desktopmanager.py @@ -0,0 +1,246 @@ +# Demonstrates using a taskbar icon to create and navigate between desktops + +import _thread +import io +import time +import traceback + +import pywintypes +import win32api +import win32con +import win32gui +import win32process +import win32service + +## "Shell_TrayWnd" is class of system tray window, broadcasts "TaskbarCreated" when initialized + + +def desktop_name_dlgproc(hwnd, msg, wparam, lparam): + """Handles messages from the desktop name dialog box""" + if msg in (win32con.WM_CLOSE, win32con.WM_DESTROY): + win32gui.DestroyWindow(hwnd) + elif msg == win32con.WM_COMMAND: + if wparam == win32con.IDOK: + desktop_name = win32gui.GetDlgItemText(hwnd, 72) + print("new desktop name: ", desktop_name) + win32gui.DestroyWindow(hwnd) + create_desktop(desktop_name) + + elif wparam == win32con.IDCANCEL: + win32gui.DestroyWindow(hwnd) + + +def get_new_desktop_name(parent_hwnd): + """Create a dialog box to ask the user for name of desktop to be created""" + msgs = { + win32con.WM_COMMAND: desktop_name_dlgproc, + win32con.WM_CLOSE: desktop_name_dlgproc, + win32con.WM_DESTROY: desktop_name_dlgproc, + } + # dlg item [type, caption, id, (x,y,cx,cy), style, ex style + style = ( + win32con.WS_BORDER + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + ) ## |win32con.DS_SYSMODAL + h = win32gui.CreateDialogIndirect( + win32api.GetModuleHandle(None), + [ + ["One ugly dialog box !", (100, 100, 200, 100), style, 0], + [ + "Button", + "Create", + win32con.IDOK, + (10, 10, 30, 20), + win32con.WS_VISIBLE + | win32con.WS_TABSTOP + | win32con.BS_HOLLOW + | win32con.BS_DEFPUSHBUTTON, + ], + [ + "Button", + "Never mind", + win32con.IDCANCEL, + (45, 10, 50, 20), + win32con.WS_VISIBLE | win32con.WS_TABSTOP | win32con.BS_HOLLOW, + ], + ["Static", "Desktop name:", 71, (10, 40, 70, 10), win32con.WS_VISIBLE], + ["Edit", "", 72, (75, 40, 90, 10), win32con.WS_VISIBLE], + ], + parent_hwnd, + msgs, + ) ## parent_hwnd, msgs) + + win32gui.EnableWindow(h, True) + hcontrol = win32gui.GetDlgItem(h, 72) + win32gui.EnableWindow(hcontrol, True) + win32gui.SetFocus(hcontrol) + + +def new_icon(hdesk, desktop_name): + """Runs as a thread on each desktop to create a new tray icon and handle its messages""" + global id + id = id + 1 + hdesk.SetThreadDesktop() + ## apparently the threads can't use same hinst, so each needs its own window class + windowclassname = "PythonDesktopManager" + desktop_name + wc = win32gui.WNDCLASS() + wc.hInstance = win32api.GetModuleHandle(None) + wc.lpszClassName = windowclassname + wc.style = win32con.CS_VREDRAW | win32con.CS_HREDRAW | win32con.CS_GLOBALCLASS + wc.hCursor = win32gui.LoadCursor(0, win32con.IDC_ARROW) + wc.hbrBackground = win32con.COLOR_WINDOW + wc.lpfnWndProc = icon_wndproc + windowclass = win32gui.RegisterClass(wc) + style = win32con.WS_OVERLAPPED | win32con.WS_SYSMENU + hwnd = win32gui.CreateWindow( + windowclass, + "dm_" + desktop_name, + win32con.WS_SYSMENU, + 0, + 0, + win32con.CW_USEDEFAULT, + win32con.CW_USEDEFAULT, + 0, + 0, + wc.hInstance, + None, + ) + win32gui.UpdateWindow(hwnd) + flags = win32gui.NIF_ICON | win32gui.NIF_MESSAGE | win32gui.NIF_TIP + notify_info = ( + hwnd, + id, + flags, + win32con.WM_USER + 20, + hicon, + "Desktop Manager (%s)" % desktop_name, + ) + window_info[hwnd] = notify_info + ## wait for explorer to initialize system tray for new desktop + tray_found = 0 + while not tray_found: + try: + tray_found = win32gui.FindWindow("Shell_TrayWnd", None) + except win32gui.error: + traceback.print_exc + time.sleep(0.5) + win32gui.Shell_NotifyIcon(win32gui.NIM_ADD, notify_info) + win32gui.PumpMessages() + + +def create_desktop(desktop_name, start_explorer=1): + """Creates a new desktop and spawns a thread running on it + Will also start a new icon thread on an existing desktop + """ + sa = pywintypes.SECURITY_ATTRIBUTES() + sa.bInheritHandle = 1 + + try: + hdesk = win32service.CreateDesktop( + desktop_name, 0, win32con.MAXIMUM_ALLOWED, sa + ) + except win32service.error: + traceback.print_exc() + errbuf = io.StringIO() + traceback.print_exc(None, errbuf) + win32api.MessageBox(0, errbuf.getvalue(), "Desktop creation failed") + return + if start_explorer: + s = win32process.STARTUPINFO() + s.lpDesktop = desktop_name + prc_info = win32process.CreateProcess( + None, + "Explorer.exe", + None, + None, + True, + win32con.CREATE_NEW_CONSOLE, + None, + "c:\\", + s, + ) + + th = _thread.start_new_thread(new_icon, (hdesk, desktop_name)) + hdesk.SwitchDesktop() + + +def icon_wndproc(hwnd, msg, wp, lp): + """Window proc for the tray icons""" + if lp == win32con.WM_LBUTTONDOWN: + ## popup menu won't disappear if you don't do this + win32gui.SetForegroundWindow(hwnd) + + curr_desktop = win32service.OpenInputDesktop(0, True, win32con.MAXIMUM_ALLOWED) + curr_desktop_name = win32service.GetUserObjectInformation( + curr_desktop, win32con.UOI_NAME + ) + winsta = win32service.GetProcessWindowStation() + desktops = winsta.EnumDesktops() + m = win32gui.CreatePopupMenu() + desktop_cnt = len(desktops) + ## *don't* create an item 0 + for d in range(1, desktop_cnt + 1): + mf_flags = win32con.MF_STRING + ## if you switch to winlogon yourself, there's nothing there and you're stuck + if desktops[d - 1].lower() in ("winlogon", "disconnect"): + mf_flags = mf_flags | win32con.MF_GRAYED | win32con.MF_DISABLED + if desktops[d - 1] == curr_desktop_name: + mf_flags = mf_flags | win32con.MF_CHECKED + win32gui.AppendMenu(m, mf_flags, d, desktops[d - 1]) + win32gui.AppendMenu(m, win32con.MF_STRING, desktop_cnt + 1, "Create new ...") + win32gui.AppendMenu(m, win32con.MF_STRING, desktop_cnt + 2, "Exit") + + x, y = win32gui.GetCursorPos() + d = win32gui.TrackPopupMenu( + m, + win32con.TPM_LEFTBUTTON | win32con.TPM_RETURNCMD | win32con.TPM_NONOTIFY, + x, + y, + 0, + hwnd, + None, + ) + win32gui.PumpWaitingMessages() + win32gui.DestroyMenu(m) + if d == desktop_cnt + 1: ## Create new + get_new_desktop_name(hwnd) + elif d == desktop_cnt + 2: ## Exit + win32gui.PostQuitMessage(0) + win32gui.Shell_NotifyIcon(win32gui.NIM_DELETE, window_info[hwnd]) + del window_info[hwnd] + origin_desktop.SwitchDesktop() + elif d > 0: + hdesk = win32service.OpenDesktop( + desktops[d - 1], 0, 0, win32con.MAXIMUM_ALLOWED + ) + hdesk.SwitchDesktop() + return 0 + else: + return win32gui.DefWindowProc(hwnd, msg, wp, lp) + + +window_info = {} +origin_desktop = win32service.OpenInputDesktop(0, True, win32con.MAXIMUM_ALLOWED) +origin_desktop_name = win32service.GetUserObjectInformation( + origin_desktop, win32service.UOI_NAME +) + +hinst = win32api.GetModuleHandle(None) +try: + hicon = win32gui.LoadIcon(hinst, 1) ## python.exe and pythonw.exe +except win32gui.error: + hicon = win32gui.LoadIcon(hinst, 135) ## pythonwin's icon +id = 0 + +create_desktop(str(origin_desktop_name), 0) + +## wait for first thread to initialize its icon +while not window_info: + time.sleep(1) + +## exit when last tray icon goes away +while window_info: + win32gui.PumpWaitingMessages() + time.sleep(3) diff --git a/lib/win32/Demos/eventLogDemo.py b/lib/win32/Demos/eventLogDemo.py new file mode 100644 index 00000000..8d4220b0 --- /dev/null +++ b/lib/win32/Demos/eventLogDemo.py @@ -0,0 +1,142 @@ +import win32api # To translate NT Sids to account names. +import win32con +import win32evtlog +import win32evtlogutil +import win32security + + +def ReadLog(computer, logType="Application", dumpEachRecord=0): + # read the entire log back. + h = win32evtlog.OpenEventLog(computer, logType) + numRecords = win32evtlog.GetNumberOfEventLogRecords(h) + # print "There are %d records" % numRecords + + num = 0 + while 1: + objects = win32evtlog.ReadEventLog( + h, + win32evtlog.EVENTLOG_BACKWARDS_READ | win32evtlog.EVENTLOG_SEQUENTIAL_READ, + 0, + ) + if not objects: + break + for object in objects: + # get it for testing purposes, but dont print it. + msg = win32evtlogutil.SafeFormatMessage(object, logType) + if object.Sid is not None: + try: + domain, user, typ = win32security.LookupAccountSid( + computer, object.Sid + ) + sidDesc = "%s/%s" % (domain, user) + except win32security.error: + sidDesc = str(object.Sid) + user_desc = "Event associated with user %s" % (sidDesc,) + else: + user_desc = None + if dumpEachRecord: + print( + "Event record from %r generated at %s" + % (object.SourceName, object.TimeGenerated.Format()) + ) + if user_desc: + print(user_desc) + try: + print(msg) + except UnicodeError: + print("(unicode error printing message: repr() follows...)") + print(repr(msg)) + + num = num + len(objects) + + if numRecords == num: + print("Successfully read all", numRecords, "records") + else: + print( + "Couldn't get all records - reported %d, but found %d" % (numRecords, num) + ) + print( + "(Note that some other app may have written records while we were running!)" + ) + win32evtlog.CloseEventLog(h) + + +def usage(): + print("Writes an event to the event log.") + print("-w : Dont write any test records.") + print("-r : Dont read the event log") + print("-c : computerName : Process the log on the specified computer") + print("-v : Verbose") + print("-t : LogType - Use the specified log - default = 'Application'") + + +def test(): + # check if running on Windows NT, if not, display notice and terminate + if win32api.GetVersion() & 0x80000000: + print("This sample only runs on NT") + return + + import getopt + import sys + + opts, args = getopt.getopt(sys.argv[1:], "rwh?c:t:v") + computer = None + do_read = do_write = 1 + + logType = "Application" + verbose = 0 + + if len(args) > 0: + print("Invalid args") + usage() + return 1 + for opt, val in opts: + if opt == "-t": + logType = val + if opt == "-c": + computer = val + if opt in ["-h", "-?"]: + usage() + return + if opt == "-r": + do_read = 0 + if opt == "-w": + do_write = 0 + if opt == "-v": + verbose = verbose + 1 + if do_write: + ph = win32api.GetCurrentProcess() + th = win32security.OpenProcessToken(ph, win32con.TOKEN_READ) + my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0] + + win32evtlogutil.ReportEvent( + logType, + 2, + strings=["The message text for event 2", "Another insert"], + data="Raw\0Data".encode("ascii"), + sid=my_sid, + ) + win32evtlogutil.ReportEvent( + logType, + 1, + eventType=win32evtlog.EVENTLOG_WARNING_TYPE, + strings=["A warning", "An even more dire warning"], + data="Raw\0Data".encode("ascii"), + sid=my_sid, + ) + win32evtlogutil.ReportEvent( + logType, + 1, + eventType=win32evtlog.EVENTLOG_INFORMATION_TYPE, + strings=["An info", "Too much info"], + data="Raw\0Data".encode("ascii"), + sid=my_sid, + ) + print("Successfully wrote 3 records to the log") + + if do_read: + ReadLog(computer, logType, verbose > 0) + + +if __name__ == "__main__": + test() diff --git a/lib/win32/Demos/getfilever.py b/lib/win32/Demos/getfilever.py new file mode 100644 index 00000000..721e72f3 --- /dev/null +++ b/lib/win32/Demos/getfilever.py @@ -0,0 +1,33 @@ +import os + +import win32api + +ver_strings = ( + "Comments", + "InternalName", + "ProductName", + "CompanyName", + "LegalCopyright", + "ProductVersion", + "FileDescription", + "LegalTrademarks", + "PrivateBuild", + "FileVersion", + "OriginalFilename", + "SpecialBuild", +) +fname = os.environ["comspec"] +d = win32api.GetFileVersionInfo(fname, "\\") +## backslash as parm returns dictionary of numeric info corresponding to VS_FIXEDFILEINFO struc +for n, v in d.items(): + print(n, v) + +pairs = win32api.GetFileVersionInfo(fname, "\\VarFileInfo\\Translation") +## \VarFileInfo\Translation returns list of available (language, codepage) pairs that can be used to retreive string info +## any other must be of the form \StringfileInfo\%04X%04X\parm_name, middle two are language/codepage pair returned from above +for lang, codepage in pairs: + print("lang: ", lang, "codepage:", codepage) + for ver_string in ver_strings: + str_info = "\\StringFileInfo\\%04X%04X\\%s" % (lang, codepage, ver_string) + ## print str_info + print(ver_string, repr(win32api.GetFileVersionInfo(fname, str_info))) diff --git a/lib/win32/Demos/images/frowny.bmp b/lib/win32/Demos/images/frowny.bmp new file mode 100644 index 0000000000000000000000000000000000000000..43e7621e2e081bc6200523f459f6d803d3133eaa GIT binary patch literal 3126 zcmds(J8#oa7>3`t#z~xu5<3kk2}&SQ1*JkPv}?r1z><}fm6e&5m6es1l|R5gsDy;7 zs^YGyR9sYXSM~AQUvzXrY!e)@U_G&%i=Ov<=X~cV*KTZ85no%pU*KyneHGB*6R+v_ z`bO{XcAotA0Og2EI|6mmLqNu8k>$((7k;1>!Ox? z#rc=}qvw0;`@8Wv4-jsU#cQ$s_2W+&5r69+`Xl0;oSgdkqxk)s|Mg4t^Ko_rtGKxL z?9%R2V3lN7p?-+uh{*PPXppW*AW{~|7r`nV_+-8c^^ZiBj7akr(I%HgOhgZB1m$i7 zYB5cq3BMhI3faVf%yg7Dgg2ZYzxuaDOvK`TyJ;!^&0lpwG7-5hG8SP(1%0ykL;>q$ zri!>atwQ}bMNEYH%|!iixz#^Yh2;l4a!bUHFcak?AR$Ubo7P1@fD%dDdSS6kbo}bS zEs_{v`?YCpf7;fw{SI7mMc1)HOa z1H|^jamhWA#0dC3Vw%?M?p2gX+8KpHolNIH_TLvtj8MN>Zqu~tPdf%@{N) zk=viBKVKD#_@{H_uE1Rh;gRf)g4-i5d}5C?`{HWH&z`+E>zgZ8xUwSkf;_XyQ^1t8q$K0|L+h*avwtt35^J~~ z3pLRU#zg%(fxqAb6Hb!3DZISk`58}7cznde1Mcr}cZb_s+}z;$I$t(B_|0aPg)!*m zsx*e?MQF9~@qzbuyuIP|71>~O?no(v`e~mQW%Bd1CeNlY+L9e|DZB%lrFGQ1pHmHZK2cK2i5&X=>i*t z;TKU7?UB~P%SCq!?;92H_sM=*7(R+6(E-^{i$V>Bn%*DfACmpFu>8shDkDdvXQ4^c z+P)W>3p*NqY3Be@vVX@vCOr#F2-9sx!;iV;tIIOVBDK)9Hr?7|qv+t<{|h&uOj|2o zqtLZB-P&WL=-}H|FNKfE3DF4|9@LNCi$#oz?9R2V{8RFm7HRy%#YLCTLQgE*x$V(8 z`J(8BpF~j_fXEf^(t5c-X(pB{cAwep82-i2PIo@Ob&t0;h*iX@qbx#HjrGGlTc&Lb HJU9On!KEHb literal 0 HcmV?d00001 diff --git a/lib/win32/Demos/mmapfile_demo.py b/lib/win32/Demos/mmapfile_demo.py new file mode 100644 index 00000000..9068ce72 --- /dev/null +++ b/lib/win32/Demos/mmapfile_demo.py @@ -0,0 +1,102 @@ +import os +import tempfile + +import mmapfile +import win32api +import winerror +from pywin32_testutil import str2bytes + +system_info = win32api.GetSystemInfo() +page_size = system_info[1] +alloc_size = system_info[7] + +fname = tempfile.mktemp() +mapping_name = os.path.split(fname)[1] +fsize = 8 * page_size +print(fname, fsize, mapping_name) + +m1 = mmapfile.mmapfile(File=fname, Name=mapping_name, MaximumSize=fsize) +m1.seek(100) +m1.write_byte(str2bytes("?")) +m1.seek(-1, 1) +assert m1.read_byte() == str2bytes("?") + +## A reopened named mapping should have exact same size as original mapping +m2 = mmapfile.mmapfile(Name=mapping_name, File=None, MaximumSize=fsize * 2) +assert m2.size() == m1.size() +m1.seek(0, 0) +m1.write(fsize * str2bytes("s")) +assert m2.read(fsize) == fsize * str2bytes("s") + +move_src = 100 +move_dest = 500 +move_size = 150 + +m2.seek(move_src, 0) +assert m2.tell() == move_src +m2.write(str2bytes("m") * move_size) +m2.move(move_dest, move_src, move_size) +m2.seek(move_dest, 0) +assert m2.read(move_size) == str2bytes("m") * move_size +## m2.write('x'* (fsize+1)) + +m2.close() +m1.resize(fsize * 2) +assert m1.size() == fsize * 2 +m1.seek(fsize) +m1.write(str2bytes("w") * fsize) +m1.flush() +m1.close() +os.remove(fname) + + +## Test a file with size larger than 32 bits +## need 10 GB free on drive where your temp folder lives +fname_large = tempfile.mktemp() +mapping_name = "Pywin32_large_mmap" +offsetdata = str2bytes("This is start of offset") + +## Deliberately use odd numbers to test rounding logic +fsize = (1024 * 1024 * 1024 * 10) + 333 +offset = (1024 * 1024 * 32) + 42 +view_size = (1024 * 1024 * 16) + 111 + +## round mapping size and view size up to multiple of system page size +if fsize % page_size: + fsize += page_size - (fsize % page_size) +if view_size % page_size: + view_size += page_size - (view_size % page_size) +## round offset down to multiple of allocation granularity +offset -= offset % alloc_size + +m1 = None +m2 = None +try: + try: + m1 = mmapfile.mmapfile(fname_large, mapping_name, fsize, 0, offset * 2) + except mmapfile.error as exc: + # if we don't have enough disk-space, that's OK. + if exc.winerror != winerror.ERROR_DISK_FULL: + raise + print("skipping large file test - need", fsize, "available bytes.") + else: + m1.seek(offset) + m1.write(offsetdata) + + ## When reopening an existing mapping without passing a file handle, you have + ## to specify a positive size even though it's ignored + m2 = mmapfile.mmapfile( + File=None, + Name=mapping_name, + MaximumSize=1, + FileOffset=offset, + NumberOfBytesToMap=view_size, + ) + assert m2.read(len(offsetdata)) == offsetdata +finally: + if m1 is not None: + m1.close() + if m2 is not None: + m2.close() + if os.path.exists(fname_large): + os.remove(fname_large) diff --git a/lib/win32/Demos/pipes/cat.py b/lib/win32/Demos/pipes/cat.py new file mode 100644 index 00000000..13b6400a --- /dev/null +++ b/lib/win32/Demos/pipes/cat.py @@ -0,0 +1,17 @@ +"""cat.py +a version of unix cat, tweaked to show off runproc.py +""" + +import sys + +data = sys.stdin.read(1) +sys.stdout.write(data) +sys.stdout.flush() +while data: + data = sys.stdin.read(1) + sys.stdout.write(data) + sys.stdout.flush() +# Just here to have something to read from stderr. +sys.stderr.write("Blah...") + +# end of cat.py diff --git a/lib/win32/Demos/pipes/runproc.py b/lib/win32/Demos/pipes/runproc.py new file mode 100644 index 00000000..2ed02dd3 --- /dev/null +++ b/lib/win32/Demos/pipes/runproc.py @@ -0,0 +1,114 @@ +"""runproc.py + +start a process with three inherited pipes. +Try to write to and read from those. +""" + +import msvcrt +import os + +import win32api +import win32con +import win32file +import win32pipe +import win32process +import win32security + + +class Process: + def run(self, cmdline): + # security attributes for pipes + sAttrs = win32security.SECURITY_ATTRIBUTES() + sAttrs.bInheritHandle = 1 + + # create pipes + hStdin_r, self.hStdin_w = win32pipe.CreatePipe(sAttrs, 0) + self.hStdout_r, hStdout_w = win32pipe.CreatePipe(sAttrs, 0) + self.hStderr_r, hStderr_w = win32pipe.CreatePipe(sAttrs, 0) + + # set the info structure for the new process. + StartupInfo = win32process.STARTUPINFO() + StartupInfo.hStdInput = hStdin_r + StartupInfo.hStdOutput = hStdout_w + StartupInfo.hStdError = hStderr_w + StartupInfo.dwFlags = win32process.STARTF_USESTDHANDLES + # Mark doesn't support wShowWindow yet. + # StartupInfo.dwFlags = StartupInfo.dwFlags | win32process.STARTF_USESHOWWINDOW + # StartupInfo.wShowWindow = win32con.SW_HIDE + + # Create new output read handles and the input write handle. Set + # the inheritance properties to FALSE. Otherwise, the child inherits + # the these handles; resulting in non-closeable handles to the pipes + # being created. + pid = win32api.GetCurrentProcess() + + tmp = win32api.DuplicateHandle( + pid, + self.hStdin_w, + pid, + 0, + 0, # non-inheritable!! + win32con.DUPLICATE_SAME_ACCESS, + ) + # Close the inhertible version of the handle + win32file.CloseHandle(self.hStdin_w) + self.hStdin_w = tmp + tmp = win32api.DuplicateHandle( + pid, + self.hStdout_r, + pid, + 0, + 0, # non-inheritable! + win32con.DUPLICATE_SAME_ACCESS, + ) + # Close the inhertible version of the handle + win32file.CloseHandle(self.hStdout_r) + self.hStdout_r = tmp + + # start the process. + hProcess, hThread, dwPid, dwTid = win32process.CreateProcess( + None, # program + cmdline, # command line + None, # process security attributes + None, # thread attributes + 1, # inherit handles, or USESTDHANDLES won't work. + # creation flags. Don't access the console. + 0, # Don't need anything here. + # If you're in a GUI app, you should use + # CREATE_NEW_CONSOLE here, or any subprocesses + # might fall victim to the problem described in: + # KB article: Q156755, cmd.exe requires + # an NT console in order to perform redirection.. + None, # no new environment + None, # current directory (stay where we are) + StartupInfo, + ) + # normally, we would save the pid etc. here... + + # Child is launched. Close the parents copy of those pipe handles + # that only the child should have open. + # You need to make sure that no handles to the write end of the + # output pipe are maintained in this process or else the pipe will + # not close when the child process exits and the ReadFile will hang. + win32file.CloseHandle(hStderr_w) + win32file.CloseHandle(hStdout_w) + win32file.CloseHandle(hStdin_r) + + self.stdin = os.fdopen(msvcrt.open_osfhandle(self.hStdin_w, 0), "wb") + self.stdin.write("hmmmmm\r\n") + self.stdin.flush() + self.stdin.close() + + self.stdout = os.fdopen(msvcrt.open_osfhandle(self.hStdout_r, 0), "rb") + print("Read on stdout: ", repr(self.stdout.read())) + + self.stderr = os.fdopen(msvcrt.open_osfhandle(self.hStderr_r, 0), "rb") + print("Read on stderr: ", repr(self.stderr.read())) + + +if __name__ == "__main__": + p = Process() + exe = win32api.GetModuleFileName(0) + p.run(exe + " cat.py") + +# end of runproc.py diff --git a/lib/win32/Demos/print_desktop.py b/lib/win32/Demos/print_desktop.py new file mode 100644 index 00000000..d06504e2 --- /dev/null +++ b/lib/win32/Demos/print_desktop.py @@ -0,0 +1,113 @@ +import pywintypes +import win32api +import win32con +import win32gui +import win32print + +pname = win32print.GetDefaultPrinter() +print(pname) +p = win32print.OpenPrinter(pname) +print("Printer handle: ", p) +print_processor = win32print.GetPrinter(p, 2)["pPrintProcessor"] +## call with last parm set to 0 to get total size needed for printer's DEVMODE +dmsize = win32print.DocumentProperties(0, p, pname, None, None, 0) +## dmDriverExtra should be total size - fixed size +driverextra = ( + dmsize - pywintypes.DEVMODEType().Size +) ## need a better way to get DEVMODE.dmSize +dm = pywintypes.DEVMODEType(driverextra) +dm.Fields = dm.Fields | win32con.DM_ORIENTATION | win32con.DM_COPIES +dm.Orientation = win32con.DMORIENT_LANDSCAPE +dm.Copies = 2 +win32print.DocumentProperties( + 0, p, pname, dm, dm, win32con.DM_IN_BUFFER | win32con.DM_OUT_BUFFER +) + +pDC = win32gui.CreateDC(print_processor, pname, dm) +printerwidth = win32print.GetDeviceCaps(pDC, win32con.PHYSICALWIDTH) +printerheight = win32print.GetDeviceCaps(pDC, win32con.PHYSICALHEIGHT) + +hwnd = win32gui.GetDesktopWindow() +l, t, r, b = win32gui.GetWindowRect(hwnd) +desktopheight = b - t +desktopwidth = r - l +dDC = win32gui.GetWindowDC(hwnd) + +dcDC = win32gui.CreateCompatibleDC(dDC) +dcBM = win32gui.CreateCompatibleBitmap(dDC, desktopwidth, desktopheight) +win32gui.SelectObject(dcDC, dcBM) +win32gui.StretchBlt( + dcDC, + 0, + 0, + desktopwidth, + desktopheight, + dDC, + 0, + 0, + desktopwidth, + desktopheight, + win32con.SRCCOPY, +) + +pcDC = win32gui.CreateCompatibleDC(pDC) +pcBM = win32gui.CreateCompatibleBitmap(pDC, printerwidth, printerheight) +win32gui.SelectObject(pcDC, pcBM) +win32gui.StretchBlt( + pcDC, + 0, + 0, + printerwidth, + printerheight, + dcDC, + 0, + 0, + desktopwidth, + desktopheight, + win32con.SRCCOPY, +) + +win32print.StartDoc(pDC, ("desktop.bmp", None, None, 0)) +win32print.StartPage(pDC) +win32gui.StretchBlt( + pDC, + 0, + 0, + int(printerwidth * 0.9), + int(printerheight * 0.9), + pcDC, + 0, + 0, + printerwidth, + printerheight, + win32con.SRCCOPY, +) + +font = win32gui.LOGFONT() +font.lfHeight = int(printerheight / 20) +font.lfWidth = font.lfHeight +font.lfWeight = 150 +font.lfItalic = 1 +font.lfUnderline = 1 +hf = win32gui.CreateFontIndirect(font) +win32gui.SelectObject(pDC, hf) +win32gui.SetBkMode(pDC, win32con.TRANSPARENT) +win32gui.SetTextColor(pDC, win32api.RGB(0, 255, 0)) +win32gui.DrawText( + pDC, + "Printed by Python!", + -1, + (0, 0, int(printerwidth * 0.9), int(printerheight * 0.9)), + win32con.DT_RIGHT | win32con.DT_BOTTOM | win32con.DT_SINGLELINE, +) +win32print.EndPage(pDC) +win32print.EndDoc(pDC) + +win32print.ClosePrinter(p) +win32gui.DeleteObject(dcBM) +win32gui.DeleteObject(pcBM) +win32gui.DeleteObject(hf) +win32gui.DeleteDC(dDC) +win32gui.DeleteDC(dcDC) +win32gui.DeleteDC(pDC) +win32gui.DeleteDC(pcDC) diff --git a/lib/win32/Demos/rastest.py b/lib/win32/Demos/rastest.py new file mode 100644 index 00000000..669a2a80 --- /dev/null +++ b/lib/win32/Demos/rastest.py @@ -0,0 +1,168 @@ +# rastest.py - test/demonstrate the win32ras module. +# Much of the code here contributed by Jethro Wright. + +import os +import sys + +import win32ras + +# Build a little dictionary of RAS states to decent strings. +# eg win32ras.RASCS_OpenPort -> "OpenPort" +stateMap = {} +for name, val in list(win32ras.__dict__.items()): + if name[:6] == "RASCS_": + stateMap[val] = name[6:] + +# Use a lock so the callback can tell the main thread when it is finished. +import win32event + +callbackEvent = win32event.CreateEvent(None, 0, 0, None) + + +def Callback(hras, msg, state, error, exterror): + # print "Callback called with ", hras, msg, state, error, exterror + stateName = stateMap.get(state, "Unknown state?") + print("Status is %s (%04lx), error code is %d" % (stateName, state, error)) + finished = state in [win32ras.RASCS_Connected] + if finished: + win32event.SetEvent(callbackEvent) + if error != 0 or int(state) == win32ras.RASCS_Disconnected: + # we know for sure this is a good place to hangup.... + print("Detected call failure: %s" % win32ras.GetErrorString(error)) + HangUp(hras) + win32event.SetEvent(callbackEvent) + + +def ShowConnections(): + print("All phone-book entries:") + for (name,) in win32ras.EnumEntries(): + print(" ", name) + print("Current Connections:") + for con in win32ras.EnumConnections(): + print(" ", con) + + +def EditEntry(entryName): + try: + win32ras.EditPhonebookEntry(0, None, entryName) + except win32ras.error as xxx_todo_changeme: + (rc, function, msg) = xxx_todo_changeme.args + print("Can not edit/find the RAS entry -", msg) + + +def HangUp(hras): + # trap potential, irrelevant errors from win32ras.... + try: + win32ras.HangUp(hras) + except: + print("Tried to hang up gracefully on error, but didn't work....") + return None + + +def Connect(entryName, bUseCallback): + if bUseCallback: + theCallback = Callback + win32event.ResetEvent(callbackEvent) + else: + theCallback = None + # in order to *use* the username/password of a particular dun entry, one must + # explicitly get those params under win95.... + try: + dp, b = win32ras.GetEntryDialParams(None, entryName) + except: + print("Couldn't find DUN entry: %s" % entryName) + else: + hras, rc = win32ras.Dial( + None, None, (entryName, "", "", dp[3], dp[4], ""), theCallback + ) + # hras, rc = win32ras.Dial(None, None, (entryName, ),theCallback) + # print hras, rc + if not bUseCallback and rc != 0: + print("Could not dial the RAS connection:", win32ras.GetErrorString(rc)) + hras = HangUp(hras) + # don't wait here if there's no need to.... + elif ( + bUseCallback + and win32event.WaitForSingleObject(callbackEvent, 60000) + != win32event.WAIT_OBJECT_0 + ): + print("Gave up waiting for the process to complete!") + # sdk docs state one must explcitly hangup, even if there's an error.... + try: + cs = win32ras.GetConnectStatus(hras) + except: + # on error, attempt a hang up anyway.... + hras = HangUp(hras) + else: + if int(cs[0]) == win32ras.RASCS_Disconnected: + hras = HangUp(hras) + return hras, rc + + +def Disconnect(rasEntry): + # Need to find the entry + name = rasEntry.lower() + for hcon, entryName, devName, devType in win32ras.EnumConnections(): + if entryName.lower() == name: + win32ras.HangUp(hcon) + print("Disconnected from", rasEntry) + break + else: + print("Could not find an open connection to", entryName) + + +usage = """ +Usage: %s [-s] [-l] [-c connection] [-d connection] +-l : List phone-book entries and current connections. +-s : Show status while connecting/disconnecting (uses callbacks) +-c : Connect to the specified phonebook name. +-d : Disconnect from the specified phonebook name. +-e : Edit the specified phonebook entry. +""" + + +def main(): + import getopt + + try: + opts, args = getopt.getopt(sys.argv[1:], "slc:d:e:") + except getopt.error as why: + print(why) + print( + usage + % ( + os.path.basename( + sys.argv[0], + ) + ) + ) + return + + bCallback = 0 + if args or not opts: + print( + usage + % ( + os.path.basename( + sys.argv[0], + ) + ) + ) + return + for opt, val in opts: + if opt == "-s": + bCallback = 1 + if opt == "-l": + ShowConnections() + if opt == "-c": + hras, rc = Connect(val, bCallback) + if hras != None: + print("hras: 0x%8lx, rc: 0x%04x" % (hras, rc)) + if opt == "-d": + Disconnect(val) + if opt == "-e": + EditEntry(val) + + +if __name__ == "__main__": + main() diff --git a/lib/win32/Demos/security/GetTokenInformation.py b/lib/win32/Demos/security/GetTokenInformation.py new file mode 100644 index 00000000..192c549e --- /dev/null +++ b/lib/win32/Demos/security/GetTokenInformation.py @@ -0,0 +1,110 @@ +""" Lists various types of information about current user's access token, + including UAC status on Vista +""" + +import pywintypes +import win32api +import win32con +import win32security +import winerror +from security_enums import ( + SECURITY_IMPERSONATION_LEVEL, + TOKEN_ELEVATION_TYPE, + TOKEN_GROUP_ATTRIBUTES, + TOKEN_PRIVILEGE_ATTRIBUTES, + TOKEN_TYPE, +) + + +def dump_token(th): + token_type = win32security.GetTokenInformation(th, win32security.TokenType) + print("TokenType:", token_type, TOKEN_TYPE.lookup_name(token_type)) + if token_type == win32security.TokenImpersonation: + imp_lvl = win32security.GetTokenInformation( + th, win32security.TokenImpersonationLevel + ) + print( + "TokenImpersonationLevel:", + imp_lvl, + SECURITY_IMPERSONATION_LEVEL.lookup_name(imp_lvl), + ) + + print( + "TokenSessionId:", + win32security.GetTokenInformation(th, win32security.TokenSessionId), + ) + + privs = win32security.GetTokenInformation(th, win32security.TokenPrivileges) + print("TokenPrivileges:") + for priv_luid, priv_flags in privs: + flag_names, unk = TOKEN_PRIVILEGE_ATTRIBUTES.lookup_flags(priv_flags) + flag_desc = " ".join(flag_names) + if unk: + flag_desc += "(" + str(unk) + ")" + + priv_name = win32security.LookupPrivilegeName("", priv_luid) + priv_desc = win32security.LookupPrivilegeDisplayName("", priv_name) + print("\t", priv_name, priv_desc, priv_flags, flag_desc) + + print("TokenGroups:") + groups = win32security.GetTokenInformation(th, win32security.TokenGroups) + for group_sid, group_attr in groups: + flag_names, unk = TOKEN_GROUP_ATTRIBUTES.lookup_flags(group_attr) + flag_desc = " ".join(flag_names) + if unk: + flag_desc += "(" + str(unk) + ")" + if group_attr & TOKEN_GROUP_ATTRIBUTES.SE_GROUP_LOGON_ID: + sid_desc = "Logon sid" + else: + sid_desc = win32security.LookupAccountSid("", group_sid) + print("\t", group_sid, sid_desc, group_attr, flag_desc) + + ## Vista token information types, will throw (87, 'GetTokenInformation', 'The parameter is incorrect.') on earier OS + try: + is_elevated = win32security.GetTokenInformation( + th, win32security.TokenElevation + ) + print("TokenElevation:", is_elevated) + except pywintypes.error as details: + if details.winerror != winerror.ERROR_INVALID_PARAMETER: + raise + return None + print( + "TokenHasRestrictions:", + win32security.GetTokenInformation(th, win32security.TokenHasRestrictions), + ) + print( + "TokenMandatoryPolicy", + win32security.GetTokenInformation(th, win32security.TokenMandatoryPolicy), + ) + print( + "TokenVirtualizationAllowed:", + win32security.GetTokenInformation(th, win32security.TokenVirtualizationAllowed), + ) + print( + "TokenVirtualizationEnabled:", + win32security.GetTokenInformation(th, win32security.TokenVirtualizationEnabled), + ) + + elevation_type = win32security.GetTokenInformation( + th, win32security.TokenElevationType + ) + print( + "TokenElevationType:", + elevation_type, + TOKEN_ELEVATION_TYPE.lookup_name(elevation_type), + ) + if elevation_type != win32security.TokenElevationTypeDefault: + lt = win32security.GetTokenInformation(th, win32security.TokenLinkedToken) + print("TokenLinkedToken:", lt) + else: + lt = None + return lt + + +ph = win32api.GetCurrentProcess() +th = win32security.OpenProcessToken(ph, win32con.MAXIMUM_ALLOWED) +lt = dump_token(th) +if lt: + print("\n\nlinked token info:") + dump_token(lt) diff --git a/lib/win32/Demos/security/account_rights.py b/lib/win32/Demos/security/account_rights.py new file mode 100644 index 00000000..357b789a --- /dev/null +++ b/lib/win32/Demos/security/account_rights.py @@ -0,0 +1,51 @@ +import ntsecuritycon +import win32api +import win32con +import win32file +import win32security +from security_enums import ACCESS_MODE, ACE_FLAGS, TRUSTEE_FORM, TRUSTEE_TYPE + +new_privs = ( + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_CREATE_PERMANENT_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", "SeEnableDelegationPrivilege"), + win32con.SE_PRIVILEGE_ENABLED, + ), ##doesn't seem to be in ntsecuritycon.py ? +) + +ph = win32api.GetCurrentProcess() +th = win32security.OpenProcessToken( + ph, win32security.TOKEN_ALL_ACCESS +) ##win32con.TOKEN_ADJUST_PRIVILEGES) +win32security.AdjustTokenPrivileges(th, 0, new_privs) + +policy_handle = win32security.GetPolicyHandle("", win32security.POLICY_ALL_ACCESS) +tmp_sid = win32security.LookupAccountName("", "tmp")[0] + +privs = [ + ntsecuritycon.SE_DEBUG_NAME, + ntsecuritycon.SE_TCB_NAME, + ntsecuritycon.SE_RESTORE_NAME, + ntsecuritycon.SE_REMOTE_SHUTDOWN_NAME, +] +win32security.LsaAddAccountRights(policy_handle, tmp_sid, privs) + +privlist = win32security.LsaEnumerateAccountRights(policy_handle, tmp_sid) +for priv in privlist: + print(priv) + +privs = [ntsecuritycon.SE_DEBUG_NAME, ntsecuritycon.SE_TCB_NAME] +win32security.LsaRemoveAccountRights(policy_handle, tmp_sid, 0, privs) + +privlist = win32security.LsaEnumerateAccountRights(policy_handle, tmp_sid) +for priv in privlist: + print(priv) + +win32security.LsaClose(policy_handle) diff --git a/lib/win32/Demos/security/explicit_entries.py b/lib/win32/Demos/security/explicit_entries.py new file mode 100644 index 00000000..b04f4517 --- /dev/null +++ b/lib/win32/Demos/security/explicit_entries.py @@ -0,0 +1,171 @@ +import os + +import ntsecuritycon +import win32api +import win32con +import win32file +import win32security +from security_enums import ACCESS_MODE, ACE_FLAGS, TRUSTEE_FORM, TRUSTEE_TYPE + +fname = os.path.join(win32api.GetTempPath(), "win32security_test.txt") +f = open(fname, "w") +f.write("Hello from Python\n") +f.close() +print("Testing on file", fname) + +new_privs = ( + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SHUTDOWN_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TAKE_OWNERSHIP_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_CREATE_PERMANENT_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", "SeEnableDelegationPrivilege"), + win32con.SE_PRIVILEGE_ENABLED, + ), ##doesn't seem to be in ntsecuritycon.py ? +) + +ph = win32api.GetCurrentProcess() +th = win32security.OpenProcessToken( + ph, win32security.TOKEN_ALL_ACCESS +) ##win32con.TOKEN_ADJUST_PRIVILEGES) +win32security.AdjustTokenPrivileges(th, 0, new_privs) + +all_security_info = ( + win32security.OWNER_SECURITY_INFORMATION + | win32security.GROUP_SECURITY_INFORMATION + | win32security.DACL_SECURITY_INFORMATION + | win32security.SACL_SECURITY_INFORMATION +) + +sd = win32security.GetFileSecurity(fname, all_security_info) + +old_sacl = sd.GetSecurityDescriptorSacl() +if old_sacl == None: + old_sacl = win32security.ACL() +old_dacl = sd.GetSecurityDescriptorDacl() +if old_dacl == None: + old_dacl = win32security.ACL() + +my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0] +tmp_sid = win32security.LookupAccountName("", "tmp")[0] +pwr_sid = win32security.LookupAccountName("", "Power Users")[0] + + +## MultipleTrustee,MultipleTrusteeOperation,TrusteeForm,TrusteeType,Identifier +## first two are ignored +my_trustee = {} +my_trustee["MultipleTrustee"] = None +my_trustee["MultipleTrusteeOperation"] = 0 +my_trustee["TrusteeForm"] = TRUSTEE_FORM.TRUSTEE_IS_SID +my_trustee["TrusteeType"] = TRUSTEE_TYPE.TRUSTEE_IS_USER +my_trustee["Identifier"] = my_sid + +tmp_trustee = {} +tmp_trustee["MultipleTrustee"] = None +tmp_trustee["MultipleTrusteeOperation"] = 0 +tmp_trustee["TrusteeForm"] = TRUSTEE_FORM.TRUSTEE_IS_NAME +tmp_trustee["TrusteeType"] = TRUSTEE_TYPE.TRUSTEE_IS_USER +tmp_trustee["Identifier"] = "rupole\\tmp" + +pwr_trustee = {} +pwr_trustee["MultipleTrustee"] = None +pwr_trustee["MultipleTrusteeOperation"] = 0 +pwr_trustee["TrusteeForm"] = TRUSTEE_FORM.TRUSTEE_IS_SID +pwr_trustee["TrusteeType"] = TRUSTEE_TYPE.TRUSTEE_IS_USER +pwr_trustee["Identifier"] = pwr_sid + +expl_list = [] +expl_list.append( + { + "Trustee": my_trustee, + "Inheritance": ACE_FLAGS.NO_INHERITANCE, + "AccessMode": ACCESS_MODE.SET_AUDIT_SUCCESS, ##|ACCESS_MODE.SET_AUDIT_FAILURE, + "AccessPermissions": win32con.GENERIC_ALL, + } +) + +expl_list.append( + { + "Trustee": my_trustee, + "Inheritance": ACE_FLAGS.NO_INHERITANCE, + "AccessMode": ACCESS_MODE.SET_AUDIT_FAILURE, + "AccessPermissions": win32con.GENERIC_ALL, + } +) + +expl_list.append( + { + "Trustee": tmp_trustee, + "Inheritance": ACE_FLAGS.NO_INHERITANCE, + "AccessMode": ACCESS_MODE.SET_AUDIT_SUCCESS, + "AccessPermissions": win32con.GENERIC_ALL, + } +) + +expl_list.append( + { + "Trustee": tmp_trustee, + "Inheritance": ACE_FLAGS.NO_INHERITANCE, + "AccessMode": ACCESS_MODE.SET_AUDIT_FAILURE, + "AccessPermissions": win32con.GENERIC_ALL, + } +) +old_sacl.SetEntriesInAcl(expl_list) + +expl_list = [] +expl_list.append( + { + "Trustee": tmp_trustee, + "Inheritance": ACE_FLAGS.NO_INHERITANCE, + "AccessMode": ACCESS_MODE.DENY_ACCESS, + "AccessPermissions": win32con.DELETE, + } +) + +expl_list.append( + { + "Trustee": tmp_trustee, + "Inheritance": ACE_FLAGS.NO_INHERITANCE, + "AccessMode": ACCESS_MODE.GRANT_ACCESS, + "AccessPermissions": win32con.WRITE_OWNER, + } +) +expl_list.append( + { + "Trustee": pwr_trustee, + "Inheritance": ACE_FLAGS.NO_INHERITANCE, + "AccessMode": ACCESS_MODE.GRANT_ACCESS, + "AccessPermissions": win32con.GENERIC_READ, + } +) +expl_list.append( + { + "Trustee": my_trustee, + "Inheritance": ACE_FLAGS.NO_INHERITANCE, + "AccessMode": ACCESS_MODE.GRANT_ACCESS, + "AccessPermissions": win32con.GENERIC_ALL, + } +) + +old_dacl.SetEntriesInAcl(expl_list) +sd.SetSecurityDescriptorSacl(1, old_sacl, 1) +sd.SetSecurityDescriptorDacl(1, old_dacl, 1) +sd.SetSecurityDescriptorOwner(pwr_sid, 1) + +win32security.SetFileSecurity(fname, all_security_info, sd) diff --git a/lib/win32/Demos/security/get_policy_info.py b/lib/win32/Demos/security/get_policy_info.py new file mode 100644 index 00000000..1eba9cd0 --- /dev/null +++ b/lib/win32/Demos/security/get_policy_info.py @@ -0,0 +1,42 @@ +import ntsecuritycon +import win32api +import win32file +import win32security + +policy_handle = win32security.GetPolicyHandle("rupole", win32security.POLICY_ALL_ACCESS) + +## mod_nbr, mod_time = win32security.LsaQueryInformationPolicy(policy_handle,win32security.PolicyModificationInformation) +## print mod_nbr, mod_time + +( + domain_name, + dns_domain_name, + dns_forest_name, + domain_guid, + domain_sid, +) = win32security.LsaQueryInformationPolicy( + policy_handle, win32security.PolicyDnsDomainInformation +) +print(domain_name, dns_domain_name, dns_forest_name, domain_guid, domain_sid) + +event_audit_info = win32security.LsaQueryInformationPolicy( + policy_handle, win32security.PolicyAuditEventsInformation +) +print(event_audit_info) + +domain_name, sid = win32security.LsaQueryInformationPolicy( + policy_handle, win32security.PolicyPrimaryDomainInformation +) +print(domain_name, sid) + +domain_name, sid = win32security.LsaQueryInformationPolicy( + policy_handle, win32security.PolicyAccountDomainInformation +) +print(domain_name, sid) + +server_role = win32security.LsaQueryInformationPolicy( + policy_handle, win32security.PolicyLsaServerRoleInformation +) +print("server role: ", server_role) + +win32security.LsaClose(policy_handle) diff --git a/lib/win32/Demos/security/list_rights.py b/lib/win32/Demos/security/list_rights.py new file mode 100644 index 00000000..780008a2 --- /dev/null +++ b/lib/win32/Demos/security/list_rights.py @@ -0,0 +1,37 @@ +import ntsecuritycon +import win32api +import win32con +import win32file +import win32security +from security_enums import ACCESS_MODE, ACE_FLAGS, TRUSTEE_FORM, TRUSTEE_TYPE + +new_privs = ( + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_CREATE_PERMANENT_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", "SeEnableDelegationPrivilege"), + win32con.SE_PRIVILEGE_ENABLED, + ), ##doesn't seem to be in ntsecuritycon.py ? +) + +ph = win32api.GetCurrentProcess() +th = win32security.OpenProcessToken( + ph, win32security.TOKEN_ALL_ACCESS +) ##win32con.TOKEN_ADJUST_PRIVILEGES) +win32security.AdjustTokenPrivileges(th, 0, new_privs) + +policy_handle = win32security.GetPolicyHandle("", win32security.POLICY_ALL_ACCESS) + +sidlist = win32security.LsaEnumerateAccountsWithUserRight( + policy_handle, ntsecuritycon.SE_RESTORE_NAME +) +for sid in sidlist: + print(win32security.LookupAccountSid("", sid)) + +win32security.LsaClose(policy_handle) diff --git a/lib/win32/Demos/security/localized_names.py b/lib/win32/Demos/security/localized_names.py new file mode 100644 index 00000000..30a0bde6 --- /dev/null +++ b/lib/win32/Demos/security/localized_names.py @@ -0,0 +1,65 @@ +# A Python port of the MS knowledge base article Q157234 +# "How to deal with localized and renamed user and group names" +# http://support.microsoft.com/default.aspx?kbid=157234 + +import sys + +import pywintypes +from ntsecuritycon import * +from win32net import NetUserModalsGet +from win32security import LookupAccountSid + + +def LookupAliasFromRid(TargetComputer, Rid): + # Sid is the same regardless of machine, since the well-known + # BUILTIN domain is referenced. + sid = pywintypes.SID() + sid.Initialize(SECURITY_NT_AUTHORITY, 2) + + for i, r in enumerate((SECURITY_BUILTIN_DOMAIN_RID, Rid)): + sid.SetSubAuthority(i, r) + + name, domain, typ = LookupAccountSid(TargetComputer, sid) + return name + + +def LookupUserGroupFromRid(TargetComputer, Rid): + # get the account domain Sid on the target machine + # note: if you were looking up multiple sids based on the same + # account domain, only need to call this once. + umi2 = NetUserModalsGet(TargetComputer, 2) + domain_sid = umi2["domain_id"] + + SubAuthorityCount = domain_sid.GetSubAuthorityCount() + + # create and init new sid with acct domain Sid + acct Rid + sid = pywintypes.SID() + sid.Initialize(domain_sid.GetSidIdentifierAuthority(), SubAuthorityCount + 1) + + # copy existing subauthorities from account domain Sid into + # new Sid + for i in range(SubAuthorityCount): + sid.SetSubAuthority(i, domain_sid.GetSubAuthority(i)) + + # append Rid to new Sid + sid.SetSubAuthority(SubAuthorityCount, Rid) + + name, domain, typ = LookupAccountSid(TargetComputer, sid) + return name + + +def main(): + if len(sys.argv) == 2: + targetComputer = sys.argv[1] + else: + targetComputer = None + + name = LookupUserGroupFromRid(targetComputer, DOMAIN_USER_RID_ADMIN) + print("'Administrator' user name = %s" % (name,)) + + name = LookupAliasFromRid(targetComputer, DOMAIN_ALIAS_RID_ADMINS) + print("'Administrators' local group/alias name = %s" % (name,)) + + +if __name__ == "__main__": + main() diff --git a/lib/win32/Demos/security/lsaregevent.py b/lib/win32/Demos/security/lsaregevent.py new file mode 100644 index 00000000..38e7adc9 --- /dev/null +++ b/lib/win32/Demos/security/lsaregevent.py @@ -0,0 +1,14 @@ +import win32event +import win32security + +evt = win32event.CreateEvent(None, 0, 0, None) +win32security.LsaRegisterPolicyChangeNotification( + win32security.PolicyNotifyAuditEventsInformation, evt +) +print("Waiting for you change Audit policy in Management console ...") +ret_code = win32event.WaitForSingleObject(evt, 1000000000) +## should come back when you change Audit policy in Management console ... +print(ret_code) +win32security.LsaUnregisterPolicyChangeNotification( + win32security.PolicyNotifyAuditEventsInformation, evt +) diff --git a/lib/win32/Demos/security/lsastore.py b/lib/win32/Demos/security/lsastore.py new file mode 100644 index 00000000..dd9ff384 --- /dev/null +++ b/lib/win32/Demos/security/lsastore.py @@ -0,0 +1,12 @@ +import win32security + +policy_handle = win32security.GetPolicyHandle("", win32security.POLICY_ALL_ACCESS) +privatedata = "some sensitive data" +keyname = "tmp" +win32security.LsaStorePrivateData(policy_handle, keyname, privatedata) +retrieveddata = win32security.LsaRetrievePrivateData(policy_handle, keyname) +assert retrieveddata == privatedata + +## passing None deletes key +win32security.LsaStorePrivateData(policy_handle, keyname, None) +win32security.LsaClose(policy_handle) diff --git a/lib/win32/Demos/security/query_information.py b/lib/win32/Demos/security/query_information.py new file mode 100644 index 00000000..9fa3e4a9 --- /dev/null +++ b/lib/win32/Demos/security/query_information.py @@ -0,0 +1,25 @@ +import win32api +import win32security +import winerror +from ntsecuritycon import * + + +# This is a Python implementation of win32api.GetDomainName() +def GetDomainName(): + try: + tok = win32security.OpenThreadToken(win32api.GetCurrentThread(), TOKEN_QUERY, 1) + except win32api.error as details: + if details[0] != winerror.ERROR_NO_TOKEN: + raise + # attempt to open the process token, since no thread token + # exists + tok = win32security.OpenProcessToken(win32api.GetCurrentProcess(), TOKEN_QUERY) + sid, attr = win32security.GetTokenInformation(tok, TokenUser) + win32api.CloseHandle(tok) + + name, dom, typ = win32security.LookupAccountSid(None, sid) + return dom + + +if __name__ == "__main__": + print("Domain name is", GetDomainName()) diff --git a/lib/win32/Demos/security/regsave_sa.py b/lib/win32/Demos/security/regsave_sa.py new file mode 100644 index 00000000..29a6ac10 --- /dev/null +++ b/lib/win32/Demos/security/regsave_sa.py @@ -0,0 +1,61 @@ +fname = "h:\\tmp.reg" + +import os + +import ntsecuritycon +import pywintypes +import win32api +import win32con +import win32security + +## regsave will not overwrite a file +if os.path.isfile(fname): + os.remove(fname) + +new_privs = ( + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TCB_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_BACKUP_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), +) +ph = win32api.GetCurrentProcess() +th = win32security.OpenProcessToken( + ph, win32security.TOKEN_ALL_ACCESS | win32con.TOKEN_ADJUST_PRIVILEGES +) +win32security.AdjustTokenPrivileges(th, 0, new_privs) +my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0] + +hklm = win32api.RegOpenKey( + win32con.HKEY_LOCAL_MACHINE, None, 0, win32con.KEY_ALL_ACCESS +) +skey = win32api.RegOpenKey(hklm, "SYSTEM", 0, win32con.KEY_ALL_ACCESS) + +sa = pywintypes.SECURITY_ATTRIBUTES() +sd = pywintypes.SECURITY_DESCRIPTOR() +sa.SECURITY_DESCRIPTOR = sd +acl = pywintypes.ACL() + +pwr_sid = win32security.LookupAccountName("", "Power Users")[0] +acl.AddAccessAllowedAce( + win32con.ACL_REVISION, + win32con.GENERIC_READ | win32con.ACCESS_SYSTEM_SECURITY, + my_sid, +) +sd.SetSecurityDescriptorDacl(1, acl, 0) +sd.SetSecurityDescriptorOwner(pwr_sid, 0) +sa.bInheritHandle = 1 +assert sa.SECURITY_DESCRIPTOR is sd + +win32api.RegSaveKey(skey, fname, sa) diff --git a/lib/win32/Demos/security/regsecurity.py b/lib/win32/Demos/security/regsecurity.py new file mode 100644 index 00000000..3bac65c0 --- /dev/null +++ b/lib/win32/Demos/security/regsecurity.py @@ -0,0 +1,36 @@ +import ntsecuritycon +import win32api +import win32con +import win32security + +new_privs = ( + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TCB_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), +) +ph = win32api.GetCurrentProcess() +th = win32security.OpenProcessToken( + ph, win32security.TOKEN_ALL_ACCESS | win32con.TOKEN_ADJUST_PRIVILEGES +) + +win32security.AdjustTokenPrivileges(th, 0, new_privs) +hkey = win32api.RegOpenKey( + win32con.HKEY_LOCAL_MACHINE, None, 0, win32con.KEY_ALL_ACCESS +) +win32api.RegCreateKey(hkey, "SYSTEM\\NOTMP") +notmpkey = win32api.RegOpenKey( + hkey, "SYSTEM\\notmp", 0, win32con.ACCESS_SYSTEM_SECURITY +) + +tmp_sid = win32security.LookupAccountName("", "tmp")[0] +sacl = win32security.ACL() +sacl.AddAuditAccessAce(win32security.ACL_REVISION, win32con.GENERIC_ALL, tmp_sid, 1, 1) + +sd = win32security.SECURITY_DESCRIPTOR() +sd.SetSecurityDescriptorSacl(1, sacl, 1) +win32api.RegSetKeySecurity(notmpkey, win32con.SACL_SECURITY_INFORMATION, sd) diff --git a/lib/win32/Demos/security/sa_inherit.py b/lib/win32/Demos/security/sa_inherit.py new file mode 100644 index 00000000..a2855e50 --- /dev/null +++ b/lib/win32/Demos/security/sa_inherit.py @@ -0,0 +1,8 @@ +import pywintypes +import win32security + +sa = pywintypes.SECURITY_ATTRIBUTES() +tmp_sid = win32security.LookupAccountName("", "tmp")[0] +sa.SetSecurityDescriptorOwner(tmp_sid, 0) +sid = sa.SECURITY_DESCRIPTOR.GetSecurityDescriptorOwner() +print(win32security.LookupAccountSid("", sid)) diff --git a/lib/win32/Demos/security/security_enums.py b/lib/win32/Demos/security/security_enums.py new file mode 100644 index 00000000..ab3cc6d3 --- /dev/null +++ b/lib/win32/Demos/security/security_enums.py @@ -0,0 +1,336 @@ +import ntsecuritycon +import win32security +import winnt + + +class Enum: + def __init__(self, *const_names): + """Accepts variable number of constant names that can be found in either + win32security, ntsecuritycon, or winnt.""" + for const_name in const_names: + try: + const_val = getattr(win32security, const_name) + except AttributeError: + try: + const_val = getattr(ntsecuritycon, const_name) + except AttributeError: + try: + const_val = getattr(winnt, const_name) + except AttributeError: + raise AttributeError( + 'Constant "%s" not found in win32security, ntsecuritycon, or winnt.' + % const_name + ) + setattr(self, const_name, const_val) + + def lookup_name(self, const_val): + """Looks up the name of a particular value.""" + for k, v in self.__dict__.items(): + if v == const_val: + return k + raise AttributeError("Value %s not found in enum" % const_val) + + def lookup_flags(self, flags): + """Returns the names of all recognized flags in input, and any flags not found in the enum.""" + flag_names = [] + unknown_flags = flags + for k, v in self.__dict__.items(): + if flags & v == v: + flag_names.append(k) + unknown_flags = unknown_flags & ~v + return flag_names, unknown_flags + + +TOKEN_INFORMATION_CLASS = Enum( + "TokenUser", + "TokenGroups", + "TokenPrivileges", + "TokenOwner", + "TokenPrimaryGroup", + "TokenDefaultDacl", + "TokenSource", + "TokenType", + "TokenImpersonationLevel", + "TokenStatistics", + "TokenRestrictedSids", + "TokenSessionId", + "TokenGroupsAndPrivileges", + "TokenSessionReference", + "TokenSandBoxInert", + "TokenAuditPolicy", + "TokenOrigin", + "TokenElevationType", + "TokenLinkedToken", + "TokenElevation", + "TokenHasRestrictions", + "TokenAccessInformation", + "TokenVirtualizationAllowed", + "TokenVirtualizationEnabled", + "TokenIntegrityLevel", + "TokenUIAccess", + "TokenMandatoryPolicy", + "TokenLogonSid", +) + +TOKEN_TYPE = Enum("TokenPrimary", "TokenImpersonation") + +TOKEN_ELEVATION_TYPE = Enum( + "TokenElevationTypeDefault", "TokenElevationTypeFull", "TokenElevationTypeLimited" +) + +POLICY_AUDIT_EVENT_TYPE = Enum( + "AuditCategorySystem", + "AuditCategoryLogon", + "AuditCategoryObjectAccess", + "AuditCategoryPrivilegeUse", + "AuditCategoryDetailedTracking", + "AuditCategoryPolicyChange", + "AuditCategoryAccountManagement", + "AuditCategoryDirectoryServiceAccess", + "AuditCategoryAccountLogon", +) + +POLICY_INFORMATION_CLASS = Enum( + "PolicyAuditLogInformation", + "PolicyAuditEventsInformation", + "PolicyPrimaryDomainInformation", + "PolicyPdAccountInformation", + "PolicyAccountDomainInformation", + "PolicyLsaServerRoleInformation", + "PolicyReplicaSourceInformation", + "PolicyDefaultQuotaInformation", + "PolicyModificationInformation", + "PolicyAuditFullSetInformation", + "PolicyAuditFullQueryInformation", + "PolicyDnsDomainInformation", +) + +POLICY_LSA_SERVER_ROLE = Enum("PolicyServerRoleBackup", "PolicyServerRolePrimary") + +## access modes for opening a policy handle - this is not a real enum +POLICY_ACCESS_MODES = Enum( + "POLICY_VIEW_LOCAL_INFORMATION", + "POLICY_VIEW_AUDIT_INFORMATION", + "POLICY_GET_PRIVATE_INFORMATION", + "POLICY_TRUST_ADMIN", + "POLICY_CREATE_ACCOUNT", + "POLICY_CREATE_SECRET", + "POLICY_CREATE_PRIVILEGE", + "POLICY_SET_DEFAULT_QUOTA_LIMITS", + "POLICY_SET_AUDIT_REQUIREMENTS", + "POLICY_AUDIT_LOG_ADMIN", + "POLICY_SERVER_ADMIN", + "POLICY_LOOKUP_NAMES", + "POLICY_NOTIFICATION", + "POLICY_ALL_ACCESS", + "POLICY_READ", + "POLICY_WRITE", + "POLICY_EXECUTE", +) + +## EventAuditingOptions flags - not a real enum +POLICY_AUDIT_EVENT_OPTIONS_FLAGS = Enum( + "POLICY_AUDIT_EVENT_UNCHANGED", + "POLICY_AUDIT_EVENT_SUCCESS", + "POLICY_AUDIT_EVENT_FAILURE", + "POLICY_AUDIT_EVENT_NONE", +) + +# AceType in ACE_HEADER - not a real enum +ACE_TYPE = Enum( + "ACCESS_MIN_MS_ACE_TYPE", + "ACCESS_ALLOWED_ACE_TYPE", + "ACCESS_DENIED_ACE_TYPE", + "SYSTEM_AUDIT_ACE_TYPE", + "SYSTEM_ALARM_ACE_TYPE", + "ACCESS_MAX_MS_V2_ACE_TYPE", + "ACCESS_ALLOWED_COMPOUND_ACE_TYPE", + "ACCESS_MAX_MS_V3_ACE_TYPE", + "ACCESS_MIN_MS_OBJECT_ACE_TYPE", + "ACCESS_ALLOWED_OBJECT_ACE_TYPE", + "ACCESS_DENIED_OBJECT_ACE_TYPE", + "SYSTEM_AUDIT_OBJECT_ACE_TYPE", + "SYSTEM_ALARM_OBJECT_ACE_TYPE", + "ACCESS_MAX_MS_OBJECT_ACE_TYPE", + "ACCESS_MAX_MS_V4_ACE_TYPE", + "ACCESS_MAX_MS_ACE_TYPE", + "ACCESS_ALLOWED_CALLBACK_ACE_TYPE", + "ACCESS_DENIED_CALLBACK_ACE_TYPE", + "ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE", + "ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE", + "SYSTEM_AUDIT_CALLBACK_ACE_TYPE", + "SYSTEM_ALARM_CALLBACK_ACE_TYPE", + "SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE", + "SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE", + "SYSTEM_MANDATORY_LABEL_ACE_TYPE", + "ACCESS_MAX_MS_V5_ACE_TYPE", +) + +# bit flags for AceFlags - not a real enum +ACE_FLAGS = Enum( + "CONTAINER_INHERIT_ACE", + "FAILED_ACCESS_ACE_FLAG", + "INHERIT_ONLY_ACE", + "INHERITED_ACE", + "NO_PROPAGATE_INHERIT_ACE", + "OBJECT_INHERIT_ACE", + "SUCCESSFUL_ACCESS_ACE_FLAG", + "NO_INHERITANCE", + "SUB_CONTAINERS_AND_OBJECTS_INHERIT", + "SUB_CONTAINERS_ONLY_INHERIT", + "SUB_OBJECTS_ONLY_INHERIT", +) + +# used in SetEntriesInAcl - very similar to ACE_TYPE +ACCESS_MODE = Enum( + "NOT_USED_ACCESS", + "GRANT_ACCESS", + "SET_ACCESS", + "DENY_ACCESS", + "REVOKE_ACCESS", + "SET_AUDIT_SUCCESS", + "SET_AUDIT_FAILURE", +) + +# Bit flags in PSECURITY_DESCRIPTOR->Control - not a real enum +SECURITY_DESCRIPTOR_CONTROL_FLAGS = Enum( + "SE_DACL_AUTO_INHERITED", ## win2k and up + "SE_SACL_AUTO_INHERITED", ## win2k and up + "SE_DACL_PROTECTED", ## win2k and up + "SE_SACL_PROTECTED", ## win2k and up + "SE_DACL_DEFAULTED", + "SE_DACL_PRESENT", + "SE_GROUP_DEFAULTED", + "SE_OWNER_DEFAULTED", + "SE_SACL_PRESENT", + "SE_SELF_RELATIVE", + "SE_SACL_DEFAULTED", +) + +# types of SID +SID_NAME_USE = Enum( + "SidTypeUser", + "SidTypeGroup", + "SidTypeDomain", + "SidTypeAlias", + "SidTypeWellKnownGroup", + "SidTypeDeletedAccount", + "SidTypeInvalid", + "SidTypeUnknown", + "SidTypeComputer", + "SidTypeLabel", +) + +## bit flags, not a real enum +TOKEN_ACCESS_PRIVILEGES = Enum( + "TOKEN_ADJUST_DEFAULT", + "TOKEN_ADJUST_GROUPS", + "TOKEN_ADJUST_PRIVILEGES", + "TOKEN_ALL_ACCESS", + "TOKEN_ASSIGN_PRIMARY", + "TOKEN_DUPLICATE", + "TOKEN_EXECUTE", + "TOKEN_IMPERSONATE", + "TOKEN_QUERY", + "TOKEN_QUERY_SOURCE", + "TOKEN_READ", + "TOKEN_WRITE", +) + +SECURITY_IMPERSONATION_LEVEL = Enum( + "SecurityAnonymous", + "SecurityIdentification", + "SecurityImpersonation", + "SecurityDelegation", +) + +POLICY_SERVER_ENABLE_STATE = Enum("PolicyServerEnabled", "PolicyServerDisabled") + +POLICY_NOTIFICATION_INFORMATION_CLASS = Enum( + "PolicyNotifyAuditEventsInformation", + "PolicyNotifyAccountDomainInformation", + "PolicyNotifyServerRoleInformation", + "PolicyNotifyDnsDomainInformation", + "PolicyNotifyDomainEfsInformation", + "PolicyNotifyDomainKerberosTicketInformation", + "PolicyNotifyMachineAccountPasswordInformation", +) + +TRUSTED_INFORMATION_CLASS = Enum( + "TrustedDomainNameInformation", + "TrustedControllersInformation", + "TrustedPosixOffsetInformation", + "TrustedPasswordInformation", + "TrustedDomainInformationBasic", + "TrustedDomainInformationEx", + "TrustedDomainAuthInformation", + "TrustedDomainFullInformation", + "TrustedDomainAuthInformationInternal", + "TrustedDomainFullInformationInternal", + "TrustedDomainInformationEx2Internal", + "TrustedDomainFullInformation2Internal", +) + +TRUSTEE_FORM = Enum( + "TRUSTEE_IS_SID", + "TRUSTEE_IS_NAME", + "TRUSTEE_BAD_FORM", + "TRUSTEE_IS_OBJECTS_AND_SID", + "TRUSTEE_IS_OBJECTS_AND_NAME", +) + +TRUSTEE_TYPE = Enum( + "TRUSTEE_IS_UNKNOWN", + "TRUSTEE_IS_USER", + "TRUSTEE_IS_GROUP", + "TRUSTEE_IS_DOMAIN", + "TRUSTEE_IS_ALIAS", + "TRUSTEE_IS_WELL_KNOWN_GROUP", + "TRUSTEE_IS_DELETED", + "TRUSTEE_IS_INVALID", + "TRUSTEE_IS_COMPUTER", +) + +## SE_OBJECT_TYPE - securable objects +SE_OBJECT_TYPE = Enum( + "SE_UNKNOWN_OBJECT_TYPE", + "SE_FILE_OBJECT", + "SE_SERVICE", + "SE_PRINTER", + "SE_REGISTRY_KEY", + "SE_LMSHARE", + "SE_KERNEL_OBJECT", + "SE_WINDOW_OBJECT", + "SE_DS_OBJECT", + "SE_DS_OBJECT_ALL", + "SE_PROVIDER_DEFINED_OBJECT", + "SE_WMIGUID_OBJECT", + "SE_REGISTRY_WOW64_32KEY", +) + +PRIVILEGE_FLAGS = Enum( + "SE_PRIVILEGE_ENABLED_BY_DEFAULT", + "SE_PRIVILEGE_ENABLED", + "SE_PRIVILEGE_USED_FOR_ACCESS", +) + +# Group flags used with TokenGroups +TOKEN_GROUP_ATTRIBUTES = Enum( + "SE_GROUP_MANDATORY", + "SE_GROUP_ENABLED_BY_DEFAULT", + "SE_GROUP_ENABLED", + "SE_GROUP_OWNER", + "SE_GROUP_USE_FOR_DENY_ONLY", + "SE_GROUP_INTEGRITY", + "SE_GROUP_INTEGRITY_ENABLED", + "SE_GROUP_LOGON_ID", + "SE_GROUP_RESOURCE", +) + +# Privilege flags returned by TokenPrivileges +TOKEN_PRIVILEGE_ATTRIBUTES = Enum( + "SE_PRIVILEGE_ENABLED_BY_DEFAULT", + "SE_PRIVILEGE_ENABLED", + "SE_PRIVILEGE_REMOVED", + "SE_PRIVILEGE_USED_FOR_ACCESS", +) diff --git a/lib/win32/Demos/security/set_file_audit.py b/lib/win32/Demos/security/set_file_audit.py new file mode 100644 index 00000000..324d7274 --- /dev/null +++ b/lib/win32/Demos/security/set_file_audit.py @@ -0,0 +1,107 @@ +import os + +import ntsecuritycon +import win32api +import win32con +import win32file +import win32security +from win32security import ( + ACL_REVISION_DS, + CONTAINER_INHERIT_ACE, + DACL_SECURITY_INFORMATION, + GROUP_SECURITY_INFORMATION, + OBJECT_INHERIT_ACE, + OWNER_SECURITY_INFORMATION, + PROTECTED_DACL_SECURITY_INFORMATION, + SACL_SECURITY_INFORMATION, + SE_FILE_OBJECT, +) + +## SE_SECURITY_NAME needed to access SACL, SE_RESTORE_NAME needed to change owner to someone other than yourself +new_privs = ( + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), +) +ph = win32api.GetCurrentProcess() +th = win32security.OpenProcessToken( + ph, win32security.TOKEN_ALL_ACCESS | win32con.TOKEN_ADJUST_PRIVILEGES +) +modified_privs = win32security.AdjustTokenPrivileges(th, 0, new_privs) + +## look up a few sids that should be available on most systems +my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0] +pwr_sid = win32security.LookupAccountName("", "Power Users")[0] +admin_sid = win32security.LookupAccountName("", "Administrators")[0] +everyone_sid = win32security.LookupAccountName("", "EveryOne")[0] + +## create a dir and set security so Everyone has read permissions, and all files and subdirs inherit its ACLs +temp_dir = win32api.GetTempPath() +dir_name = win32api.GetTempFileName(temp_dir, "sfa")[0] +os.remove(dir_name) +os.mkdir(dir_name) +dir_dacl = win32security.ACL() +dir_dacl.AddAccessAllowedAceEx( + ACL_REVISION_DS, + CONTAINER_INHERIT_ACE | OBJECT_INHERIT_ACE, + win32con.GENERIC_READ, + everyone_sid, +) +## make sure current user has permissions on dir +dir_dacl.AddAccessAllowedAceEx( + ACL_REVISION_DS, + CONTAINER_INHERIT_ACE | OBJECT_INHERIT_ACE, + win32con.GENERIC_ALL, + my_sid, +) +## keep dir from inheriting any permissions so it only has ACEs explicitely set here +win32security.SetNamedSecurityInfo( + dir_name, + SE_FILE_OBJECT, + OWNER_SECURITY_INFORMATION + | GROUP_SECURITY_INFORMATION + | DACL_SECURITY_INFORMATION + | PROTECTED_DACL_SECURITY_INFORMATION, + pwr_sid, + pwr_sid, + dir_dacl, + None, +) + +## Create a file in the dir and add some specific permissions to it +fname = win32api.GetTempFileName(dir_name, "sfa")[0] +print(fname) +file_sd = win32security.GetNamedSecurityInfo( + fname, SE_FILE_OBJECT, DACL_SECURITY_INFORMATION | SACL_SECURITY_INFORMATION +) +file_dacl = file_sd.GetSecurityDescriptorDacl() +file_sacl = file_sd.GetSecurityDescriptorSacl() + +if file_dacl is None: + file_dacl = win32security.ACL() +if file_sacl is None: + file_sacl = win32security.ACL() + +file_dacl.AddAccessDeniedAce(file_dacl.GetAclRevision(), win32con.DELETE, admin_sid) +file_dacl.AddAccessDeniedAce(file_dacl.GetAclRevision(), win32con.DELETE, my_sid) +file_dacl.AddAccessAllowedAce(file_dacl.GetAclRevision(), win32con.GENERIC_ALL, pwr_sid) +file_sacl.AddAuditAccessAce( + file_dacl.GetAclRevision(), win32con.GENERIC_ALL, my_sid, True, True +) + +win32security.SetNamedSecurityInfo( + fname, + SE_FILE_OBJECT, + DACL_SECURITY_INFORMATION | SACL_SECURITY_INFORMATION, + None, + None, + file_dacl, + file_sacl, +) + +win32security.AdjustTokenPrivileges(th, 0, modified_privs) diff --git a/lib/win32/Demos/security/set_file_owner.py b/lib/win32/Demos/security/set_file_owner.py new file mode 100644 index 00000000..5a384da0 --- /dev/null +++ b/lib/win32/Demos/security/set_file_owner.py @@ -0,0 +1,74 @@ +fname = r"h:\tmp.txt" + +import ntsecuritycon +import win32api +import win32con +import win32file +import win32security + +new_privs = ( + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SHUTDOWN_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TCB_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TAKE_OWNERSHIP_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", ntsecuritycon.SE_CREATE_PERMANENT_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", "SeEnableDelegationPrivilege"), + win32con.SE_PRIVILEGE_ENABLED, + ), ##doesn't seem to be in ntsecuritycon.py ? +) + +ph = win32api.GetCurrentProcess() +th = win32security.OpenProcessToken( + ph, win32security.TOKEN_ALL_ACCESS | win32con.TOKEN_ADJUST_PRIVILEGES +) +win32security.AdjustTokenPrivileges(th, 0, new_privs) + +all_security_info = ( + win32security.OWNER_SECURITY_INFORMATION + | win32security.GROUP_SECURITY_INFORMATION + | win32security.DACL_SECURITY_INFORMATION + | win32security.SACL_SECURITY_INFORMATION +) + +sd = win32security.GetFileSecurity(fname, all_security_info) +old_dacl = sd.GetSecurityDescriptorDacl() +old_sacl = sd.GetSecurityDescriptorSacl() +old_group = sd.GetSecurityDescriptorGroup() + +new_sd = win32security.SECURITY_DESCRIPTOR() +print( + "relative, valid, size: ", + new_sd.IsSelfRelative(), + new_sd.IsValid(), + new_sd.GetLength(), +) + +my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0] +tmp_sid = win32security.LookupAccountName("", "tmp")[0] + +new_sd.SetSecurityDescriptorSacl(1, old_sacl, 1) +new_sd.SetSecurityDescriptorDacl(1, old_dacl, 1) +new_sd.SetSecurityDescriptorOwner(tmp_sid, 0) +new_sd.SetSecurityDescriptorGroup(old_group, 0) + +win32security.SetFileSecurity(fname, all_security_info, new_sd) diff --git a/lib/win32/Demos/security/set_policy_info.py b/lib/win32/Demos/security/set_policy_info.py new file mode 100644 index 00000000..5dd3cf81 --- /dev/null +++ b/lib/win32/Demos/security/set_policy_info.py @@ -0,0 +1,28 @@ +import ntsecuritycon +import win32api +import win32file +import win32security + +policy_handle = win32security.GetPolicyHandle("rupole", win32security.POLICY_ALL_ACCESS) + +event_audit_info = win32security.LsaQueryInformationPolicy( + policy_handle, win32security.PolicyAuditEventsInformation +) +print(event_audit_info) + +new_audit_info = list(event_audit_info[1]) +new_audit_info[win32security.AuditCategoryPolicyChange] = ( + win32security.POLICY_AUDIT_EVENT_SUCCESS | win32security.POLICY_AUDIT_EVENT_FAILURE +) +new_audit_info[win32security.AuditCategoryAccountLogon] = ( + win32security.POLICY_AUDIT_EVENT_SUCCESS | win32security.POLICY_AUDIT_EVENT_FAILURE +) +new_audit_info[win32security.AuditCategoryLogon] = ( + win32security.POLICY_AUDIT_EVENT_SUCCESS | win32security.POLICY_AUDIT_EVENT_FAILURE +) + +win32security.LsaSetInformationPolicy( + policy_handle, win32security.PolicyAuditEventsInformation, (1, new_audit_info) +) + +win32security.LsaClose(policy_handle) diff --git a/lib/win32/Demos/security/setkernelobjectsecurity.py b/lib/win32/Demos/security/setkernelobjectsecurity.py new file mode 100644 index 00000000..34c8f446 --- /dev/null +++ b/lib/win32/Demos/security/setkernelobjectsecurity.py @@ -0,0 +1,135 @@ +import win32api +import win32con +import win32process +import win32security + +## You need SE_RESTORE_NAME to be able to set the owner of a security descriptor to anybody +## other than yourself or your primary group. Most admin logins don't have it by default, so +## enabling it may fail +new_privs = ( + ( + win32security.LookupPrivilegeValue("", win32security.SE_SECURITY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_TCB_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_SHUTDOWN_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_RESTORE_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_TAKE_OWNERSHIP_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_CREATE_PERMANENT_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_ENABLE_DELEGATION_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_CHANGE_NOTIFY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_DEBUG_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue( + "", win32security.SE_PROF_SINGLE_PROCESS_NAME + ), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_SYSTEM_PROFILE_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_LOCK_MEMORY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), +) + +all_info = ( + win32security.OWNER_SECURITY_INFORMATION + | win32security.GROUP_SECURITY_INFORMATION + | win32security.DACL_SECURITY_INFORMATION + | win32security.SACL_SECURITY_INFORMATION +) + +pid = win32api.GetCurrentProcessId() +ph = win32api.OpenProcess(win32con.PROCESS_ALL_ACCESS, 0, pid) +## PROCESS_ALL_ACCESS does not contain ACCESS_SYSTEM_SECURITY (neccessy to do SACLs) +th = win32security.OpenProcessToken( + ph, win32security.TOKEN_ALL_ACCESS +) ##win32con.TOKEN_ADJUST_PRIVILEGES) +old_privs = win32security.GetTokenInformation(th, win32security.TokenPrivileges) +desired_privs = tuple((e[0], win32con.SE_PRIVILEGE_ENABLED) for e in old_privs) +modified_privs = win32security.AdjustTokenPrivileges( + th, 0, desired_privs +) # Will (partially) fail for new_privs (unless they are a subset of current ones) +gle = win32api.GetLastError() +if gle != 0: + print("AdjustTokenPrivileges error:", gle) +# print(modified_privs) +my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0] +pwr_sid = win32security.LookupAccountName("", "Power Users")[0] +## reopen process with ACCESS_SYSTEM_SECURITY now that sufficent privs are enabled +ph = win32api.OpenProcess( + win32con.PROCESS_ALL_ACCESS | win32con.ACCESS_SYSTEM_SECURITY, 0, pid +) + +sd = win32security.GetKernelObjectSecurity(ph, all_info) +dacl = sd.GetSecurityDescriptorDacl() +if dacl is None: + dacl = win32security.ACL() +sacl = sd.GetSecurityDescriptorSacl() +if sacl is None: + sacl = win32security.ACL() + +dacl_ace_cnt = dacl.GetAceCount() +sacl_ace_cnt = sacl.GetAceCount() + +dacl.AddAccessAllowedAce( + dacl.GetAclRevision(), win32con.ACCESS_SYSTEM_SECURITY | win32con.WRITE_DAC, my_sid +) +sacl.AddAuditAccessAce(sacl.GetAclRevision(), win32con.GENERIC_ALL, my_sid, 1, 1) +sd.SetSecurityDescriptorDacl(1, dacl, 0) +sd.SetSecurityDescriptorSacl(1, sacl, 0) +sd.SetSecurityDescriptorGroup(pwr_sid, 0) +sd.SetSecurityDescriptorOwner(pwr_sid, 0) + +win32security.SetKernelObjectSecurity(ph, all_info, sd) +new_sd = win32security.GetKernelObjectSecurity(ph, all_info) + +if new_sd.GetSecurityDescriptorDacl().GetAceCount() != dacl_ace_cnt + 1: + print("New dacl doesn" "t contain extra ace ????") +if new_sd.GetSecurityDescriptorSacl().GetAceCount() != sacl_ace_cnt + 1: + print("New Sacl doesn" "t contain extra ace ????") +if ( + win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorOwner())[0] + != "Power Users" +): + print("Owner not successfully set to Power Users !!!!!") +if ( + win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorGroup())[0] + != "Power Users" +): + print("Group not successfully set to Power Users !!!!!") + +sd.SetSecurityDescriptorSacl(0, None, 0) +win32security.SetKernelObjectSecurity(ph, win32security.SACL_SECURITY_INFORMATION, sd) +new_sd_1 = win32security.GetKernelObjectSecurity( + ph, win32security.SACL_SECURITY_INFORMATION +) +if new_sd_1.GetSecurityDescriptorSacl() is not None: + print("Unable to set Sacl to NULL !!!!!!!!") diff --git a/lib/win32/Demos/security/setnamedsecurityinfo.py b/lib/win32/Demos/security/setnamedsecurityinfo.py new file mode 100644 index 00000000..8915a0df --- /dev/null +++ b/lib/win32/Demos/security/setnamedsecurityinfo.py @@ -0,0 +1,131 @@ +import win32api +import win32con +import win32process +import win32security + +fname, tmp = win32api.GetTempFileName(win32api.GetTempPath(), "tmp") +print(fname) +## You need SE_RESTORE_NAME to be able to set the owner of a security descriptor to anybody +## other than yourself or your primary group. Most admin logins don't have it by default, so +## enabling it may fail +new_privs = ( + ( + win32security.LookupPrivilegeValue("", win32security.SE_SECURITY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_TCB_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_SHUTDOWN_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_RESTORE_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_TAKE_OWNERSHIP_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_CREATE_PERMANENT_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_ENABLE_DELEGATION_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_CHANGE_NOTIFY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_DEBUG_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue( + "", win32security.SE_PROF_SINGLE_PROCESS_NAME + ), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_SYSTEM_PROFILE_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_LOCK_MEMORY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), +) + +all_info = ( + win32security.OWNER_SECURITY_INFORMATION + | win32security.GROUP_SECURITY_INFORMATION + | win32security.DACL_SECURITY_INFORMATION + | win32security.SACL_SECURITY_INFORMATION +) + +ph = win32process.GetCurrentProcess() +th = win32security.OpenProcessToken( + ph, win32security.TOKEN_ALL_ACCESS +) ##win32con.TOKEN_ADJUST_PRIVILEGES) +win32security.AdjustTokenPrivileges(th, 0, new_privs) +my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0] +pwr_sid = win32security.LookupAccountName("", "Power Users")[0] + +sd = win32security.GetNamedSecurityInfo(fname, win32security.SE_FILE_OBJECT, all_info) +dacl = sd.GetSecurityDescriptorDacl() +if dacl is None: + dacl = win32security.ACL() +sacl = sd.GetSecurityDescriptorSacl() +if sacl is None: + sacl = win32security.ACL() + +dacl_ace_cnt = dacl.GetAceCount() +sacl_ace_cnt = sacl.GetAceCount() + +dacl.AddAccessAllowedAce( + dacl.GetAclRevision(), win32con.ACCESS_SYSTEM_SECURITY | win32con.WRITE_DAC, my_sid +) +sacl.AddAuditAccessAce(sacl.GetAclRevision(), win32con.GENERIC_ALL, my_sid, 1, 1) + +win32security.SetNamedSecurityInfo( + fname, win32security.SE_FILE_OBJECT, all_info, pwr_sid, pwr_sid, dacl, sacl +) +new_sd = win32security.GetNamedSecurityInfo( + fname, win32security.SE_FILE_OBJECT, all_info +) + +## could do additional checking to make sure added ACE contains expected info +if new_sd.GetSecurityDescriptorDacl().GetAceCount() != dacl_ace_cnt + 1: + print("New dacl doesn" "t contain extra ace ????") +if new_sd.GetSecurityDescriptorSacl().GetAceCount() != sacl_ace_cnt + 1: + print("New Sacl doesn" "t contain extra ace ????") +if ( + win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorOwner())[0] + != "Power Users" +): + print("Owner not successfully set to Power Users !!!!!") +if ( + win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorGroup())[0] + != "Power Users" +): + print("Group not successfully set to Power Users !!!!!") + +win32security.SetNamedSecurityInfo( + fname, + win32security.SE_FILE_OBJECT, + win32security.SACL_SECURITY_INFORMATION, + None, + None, + None, + None, +) +new_sd_1 = win32security.GetNamedSecurityInfo( + fname, win32security.SE_FILE_OBJECT, win32security.SACL_SECURITY_INFORMATION +) +if new_sd_1.GetSecurityDescriptorSacl() is not None: + print("Unable to set Sacl to NULL !!!!!!!!") diff --git a/lib/win32/Demos/security/setsecurityinfo.py b/lib/win32/Demos/security/setsecurityinfo.py new file mode 100644 index 00000000..d784d950 --- /dev/null +++ b/lib/win32/Demos/security/setsecurityinfo.py @@ -0,0 +1,132 @@ +import win32api +import win32con +import win32process +import win32security + +## You need SE_RESTORE_NAME to be able to set the owner of a security descriptor to anybody +## other than yourself or your primary group. Most admin logins don't have it by default, so +## enabling it may fail +new_privs = ( + ( + win32security.LookupPrivilegeValue("", win32security.SE_SECURITY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_TCB_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_SHUTDOWN_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_RESTORE_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_TAKE_OWNERSHIP_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_CREATE_PERMANENT_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_ENABLE_DELEGATION_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_CHANGE_NOTIFY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_DEBUG_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue( + "", win32security.SE_PROF_SINGLE_PROCESS_NAME + ), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_SYSTEM_PROFILE_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_LOCK_MEMORY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), +) + +all_info = ( + win32security.OWNER_SECURITY_INFORMATION + | win32security.GROUP_SECURITY_INFORMATION + | win32security.DACL_SECURITY_INFORMATION + | win32security.SACL_SECURITY_INFORMATION +) + +pid = win32api.GetCurrentProcessId() +ph = win32api.OpenProcess(win32con.PROCESS_ALL_ACCESS, 0, pid) +## PROCESS_ALL_ACCESS does not contain ACCESS_SYSTEM_SECURITY (neccessy to do SACLs) +th = win32security.OpenProcessToken( + ph, win32security.TOKEN_ALL_ACCESS +) ##win32con.TOKEN_ADJUST_PRIVILEGES) +old_privs = win32security.AdjustTokenPrivileges(th, 0, new_privs) +my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0] +pwr_sid = win32security.LookupAccountName("", "Power Users")[0] +## reopen process with ACCESS_SYSTEM_SECURITY now that sufficent privs are enabled +ph = win32api.OpenProcess( + win32con.PROCESS_ALL_ACCESS | win32con.ACCESS_SYSTEM_SECURITY, 0, pid +) + +sd = win32security.GetSecurityInfo(ph, win32security.SE_KERNEL_OBJECT, all_info) +dacl = sd.GetSecurityDescriptorDacl() +if dacl is None: + dacl = win32security.ACL() +sacl = sd.GetSecurityDescriptorSacl() +if sacl is None: + sacl = win32security.ACL() + +dacl_ace_cnt = dacl.GetAceCount() +sacl_ace_cnt = sacl.GetAceCount() + +dacl.AddAccessAllowedAce( + dacl.GetAclRevision(), win32con.ACCESS_SYSTEM_SECURITY | win32con.WRITE_DAC, my_sid +) +sacl.AddAuditAccessAce(sacl.GetAclRevision(), win32con.GENERIC_ALL, my_sid, 1, 1) + +win32security.SetSecurityInfo( + ph, win32security.SE_KERNEL_OBJECT, all_info, pwr_sid, pwr_sid, dacl, sacl +) +new_sd = win32security.GetSecurityInfo(ph, win32security.SE_KERNEL_OBJECT, all_info) + +if new_sd.GetSecurityDescriptorDacl().GetAceCount() != dacl_ace_cnt + 1: + print("New dacl doesn" "t contain extra ace ????") +if new_sd.GetSecurityDescriptorSacl().GetAceCount() != sacl_ace_cnt + 1: + print("New Sacl doesn" "t contain extra ace ????") +if ( + win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorOwner())[0] + != "Power Users" +): + print("Owner not successfully set to Power Users !!!!!") +if ( + win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorGroup())[0] + != "Power Users" +): + print("Group not successfully set to Power Users !!!!!") + +win32security.SetSecurityInfo( + ph, + win32security.SE_KERNEL_OBJECT, + win32security.SACL_SECURITY_INFORMATION, + None, + None, + None, + None, +) +new_sd_1 = win32security.GetSecurityInfo( + ph, win32security.SE_KERNEL_OBJECT, win32security.SACL_SECURITY_INFORMATION +) +if new_sd_1.GetSecurityDescriptorSacl() is not None: + print("Unable to set Sacl to NULL !!!!!!!!") diff --git a/lib/win32/Demos/security/setuserobjectsecurity.py b/lib/win32/Demos/security/setuserobjectsecurity.py new file mode 100644 index 00000000..668571f6 --- /dev/null +++ b/lib/win32/Demos/security/setuserobjectsecurity.py @@ -0,0 +1,103 @@ +import win32api +import win32con +import win32process +import win32security + +new_privs = ( + ( + win32security.LookupPrivilegeValue("", win32security.SE_SECURITY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_TCB_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_SHUTDOWN_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_RESTORE_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_TAKE_OWNERSHIP_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_CREATE_PERMANENT_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_ENABLE_DELEGATION_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_CHANGE_NOTIFY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_DEBUG_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue( + "", win32security.SE_PROF_SINGLE_PROCESS_NAME + ), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_SYSTEM_PROFILE_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), + ( + win32security.LookupPrivilegeValue("", win32security.SE_LOCK_MEMORY_NAME), + win32con.SE_PRIVILEGE_ENABLED, + ), +) + +all_info = ( + win32security.OWNER_SECURITY_INFORMATION + | win32security.GROUP_SECURITY_INFORMATION + | win32security.DACL_SECURITY_INFORMATION + | win32security.SACL_SECURITY_INFORMATION +) +info = ( + win32security.OWNER_SECURITY_INFORMATION + | win32security.GROUP_SECURITY_INFORMATION + | win32security.DACL_SECURITY_INFORMATION +) + +ph = win32process.GetCurrentProcess() +th = win32security.OpenProcessToken( + ph, win32security.TOKEN_ALL_ACCESS +) ##win32con.TOKEN_ADJUST_PRIVILEGES) +win32security.AdjustTokenPrivileges(th, 0, new_privs) +my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0] +pwr_sid = win32security.LookupAccountName("", "Power Users")[0] + +h = win32process.GetProcessWindowStation() +sd = win32security.GetUserObjectSecurity(h, info) +dacl = sd.GetSecurityDescriptorDacl() +ace_cnt = dacl.GetAceCount() + +dacl.AddAccessAllowedAce( + dacl.GetAclRevision(), win32con.ACCESS_SYSTEM_SECURITY | win32con.WRITE_DAC, my_sid +) +sd.SetSecurityDescriptorDacl(1, dacl, 0) +sd.SetSecurityDescriptorGroup(pwr_sid, 0) +sd.SetSecurityDescriptorOwner(pwr_sid, 0) + +win32security.SetUserObjectSecurity(h, info, sd) +new_sd = win32security.GetUserObjectSecurity(h, info) +assert ( + new_sd.GetSecurityDescriptorDacl().GetAceCount() == ace_cnt + 1 +), "Did not add an ace to the Dacl !!!!!!" +assert ( + win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorOwner())[0] + == "Power Users" +), "Owner not successfully set to Power Users !!!!!" +assert ( + win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorGroup())[0] + == "Power Users" +), "Group not successfully set to Power Users !!!!!" diff --git a/lib/win32/Demos/security/sspi/fetch_url.py b/lib/win32/Demos/security/sspi/fetch_url.py new file mode 100644 index 00000000..3b43b7e4 --- /dev/null +++ b/lib/win32/Demos/security/sspi/fetch_url.py @@ -0,0 +1,160 @@ +""" +Fetches a URL from a web-server supporting NTLM authentication +eg, IIS. + +If no arguments are specified, a default of http://localhost/localstart.asp +is used. This script does follow simple 302 redirections, so pointing at the +root of an IIS server is should work. +""" + +import http.client # sorry, this demo needs 2.3+ +import optparse +import urllib.error +import urllib.parse +import urllib.request +from base64 import decodestring, encodestring + +from sspi import ClientAuth + +options = None # set to optparse options object + + +def open_url(host, url): + h = http.client.HTTPConnection(host) + # h.set_debuglevel(9) + h.putrequest("GET", url) + h.endheaders() + resp = h.getresponse() + print("Initial response is", resp.status, resp.reason) + body = resp.read() + if resp.status == 302: # object moved + url = "/" + resp.msg["location"] + resp.close() + h.putrequest("GET", url) + h.endheaders() + resp = h.getresponse() + print("After redirect response is", resp.status, resp.reason) + if options.show_headers: + print("Initial response headers:") + for name, val in list(resp.msg.items()): + print(" %s: %s" % (name, val)) + if options.show_body: + print(body) + if resp.status == 401: + # 401: Unauthorized - here is where the real work starts + auth_info = None + if options.user or options.domain or options.password: + auth_info = options.user, options.domain, options.password + ca = ClientAuth("NTLM", auth_info=auth_info) + auth_scheme = ca.pkg_info["Name"] + data = None + while 1: + err, out_buf = ca.authorize(data) + data = out_buf[0].Buffer + # Encode it as base64 as required by HTTP + auth = encodestring(data).replace("\012", "") + h.putrequest("GET", url) + h.putheader("Authorization", auth_scheme + " " + auth) + h.putheader("Content-Length", "0") + h.endheaders() + resp = h.getresponse() + if options.show_headers: + print("Token dance headers:") + for name, val in list(resp.msg.items()): + print(" %s: %s" % (name, val)) + + if err == 0: + break + else: + if resp.status != 401: + print("Eeek - got response", resp.status) + cl = resp.msg.get("content-length") + if cl: + print(repr(resp.read(int(cl)))) + else: + print("no content!") + + assert resp.status == 401, resp.status + + assert not resp.will_close, "NTLM is per-connection - must not close" + schemes = [ + s.strip() for s in resp.msg.get("WWW-Authenticate", "").split(",") + ] + for scheme in schemes: + if scheme.startswith(auth_scheme): + data = decodestring(scheme[len(auth_scheme) + 1 :]) + break + else: + print( + "Could not find scheme '%s' in schemes %r" % (auth_scheme, schemes) + ) + break + + resp.read() + print("Final response status is", resp.status, resp.reason) + if resp.status == 200: + # Worked! + # Check we can read it again without re-authenticating. + if resp.will_close: + print( + "EEEK - response will close, but NTLM is per connection - it must stay open" + ) + body = resp.read() + if options.show_body: + print("Final response body:") + print(body) + h.putrequest("GET", url) + h.endheaders() + resp = h.getresponse() + print("Second fetch response is", resp.status, resp.reason) + if options.show_headers: + print("Second response headers:") + for name, val in list(resp.msg.items()): + print(" %s: %s" % (name, val)) + + resp.read(int(resp.msg.get("content-length", 0))) + elif resp.status == 500: + print("Error text") + print(resp.read()) + else: + if options.show_body: + cl = resp.msg.get("content-length") + print(resp.read(int(cl))) + + +if __name__ == "__main__": + parser = optparse.OptionParser(description=__doc__) + + parser.add_option( + "", + "--show-body", + action="store_true", + help="print the body of each response as it is received", + ) + + parser.add_option( + "", + "--show-headers", + action="store_true", + help="print the headers of each response as it is received", + ) + + parser.add_option("", "--user", action="store", help="The username to login with") + + parser.add_option( + "", "--password", action="store", help="The password to login with" + ) + + parser.add_option("", "--domain", action="store", help="The domain to login to") + + options, args = parser.parse_args() + if not args: + print("Run with --help for usage details") + args = ["http://localhost/localstart.asp"] + for url in args: + scheme, netloc, path, params, query, fragment = urllib.parse.urlparse(url) + if (scheme != "http") or params or query or fragment: + parser.error("Scheme must be http, URL must be simple") + + print("Opening '%s' from '%s'" % (path, netloc)) + r = open_url(netloc, path) diff --git a/lib/win32/Demos/security/sspi/simple_auth.py b/lib/win32/Demos/security/sspi/simple_auth.py new file mode 100644 index 00000000..cc0ce5cf --- /dev/null +++ b/lib/win32/Demos/security/sspi/simple_auth.py @@ -0,0 +1,72 @@ +# A demo of basic SSPI authentication. +# There is a 'client' context and a 'server' context - typically these will +# be on different machines (here they are in the same process, but the same +# concepts apply) +import sspi +import sspicon +import win32api +import win32security + + +def lookup_ret_code(err): + for k, v in list(sspicon.__dict__.items()): + if k[0:6] in ("SEC_I_", "SEC_E_") and v == err: + return k + + +""" +pkg_name='Kerberos' +sspiclient=SSPIClient(pkg_name, win32api.GetUserName(), ## target spn is ourself + None, None, ## use none for client name and authentication information for current context + ## u'username', (u'username',u'domain.com',u'passwd'), + sspicon.ISC_REQ_INTEGRITY|sspicon.ISC_REQ_SEQUENCE_DETECT|sspicon.ISC_REQ_REPLAY_DETECT| \ + sspicon.ISC_REQ_DELEGATE|sspicon.ISC_REQ_CONFIDENTIALITY|sspicon.ISC_REQ_USE_SESSION_KEY) +sspiserver=SSPIServer(pkg_name, None, + sspicon.ASC_REQ_INTEGRITY|sspicon.ASC_REQ_SEQUENCE_DETECT|sspicon.ASC_REQ_REPLAY_DETECT| \ + sspicon.ASC_REQ_DELEGATE|sspicon.ASC_REQ_CONFIDENTIALITY|sspicon.ASC_REQ_STREAM|sspicon.ASC_REQ_USE_SESSION_KEY) +""" + +pkg_name = "NTLM" + +# Setup the 2 contexts. +sspiclient = sspi.ClientAuth(pkg_name) +sspiserver = sspi.ServerAuth(pkg_name) + +# Perform the authentication dance, each loop exchanging more information +# on the way to completing authentication. +sec_buffer = None +while 1: + err, sec_buffer = sspiclient.authorize(sec_buffer) + err, sec_buffer = sspiserver.authorize(sec_buffer) + if err == 0: + break + +# The server can now impersonate the client. In this demo the 2 users will +# always be the same. +sspiserver.ctxt.ImpersonateSecurityContext() +print("Impersonated user: ", win32api.GetUserNameEx(win32api.NameSamCompatible)) +sspiserver.ctxt.RevertSecurityContext() +print("Reverted to self: ", win32api.GetUserName()) + +pkg_size_info = sspiclient.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_SIZES) +# Now sign some data +msg = "some data to be encrypted ......" + +sigsize = pkg_size_info["MaxSignature"] +sigbuf = win32security.PySecBufferDescType() +sigbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA)) +sigbuf.append(win32security.PySecBufferType(sigsize, sspicon.SECBUFFER_TOKEN)) +sigbuf[0].Buffer = msg +sspiclient.ctxt.MakeSignature(0, sigbuf, 1) +sspiserver.ctxt.VerifySignature(sigbuf, 1) + +# And finally encrypt some. +trailersize = pkg_size_info["SecurityTrailer"] +encbuf = win32security.PySecBufferDescType() +encbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA)) +encbuf.append(win32security.PySecBufferType(trailersize, sspicon.SECBUFFER_TOKEN)) +encbuf[0].Buffer = msg +sspiclient.ctxt.EncryptMessage(0, encbuf, 1) +print("Encrypted data:", repr(encbuf[0].Buffer)) +sspiserver.ctxt.DecryptMessage(encbuf, 1) +print("Unencrypted data:", encbuf[0].Buffer) diff --git a/lib/win32/Demos/security/sspi/socket_server.py b/lib/win32/Demos/security/sspi/socket_server.py new file mode 100644 index 00000000..4d606bb8 --- /dev/null +++ b/lib/win32/Demos/security/sspi/socket_server.py @@ -0,0 +1,201 @@ +"""A sample socket server and client using SSPI authentication and encryption. + +You must run with either 'client' or 'server' as arguments. A server must be +running before a client can connect. + +To use with Kerberos you should include in the client options +--target-spn=username, where 'username' is the user under which the server is +being run. + +Running either the client or server as a different user can be informative. +A command-line such as the following may be useful: +`runas /user:{user} {fqp}\python.exe {fqp}\socket_server.py --wait client|server` + +{fqp} should specify the relevant fully-qualified path names. + +To use 'runas' with Kerberos, the client program will need to +specify --target-spn with the username under which the *server* is running. + +See the SSPI documentation for more details. +""" + + +import http.client # sorry, this demo needs 2.3+ +import optparse +import socketserver +import struct +import traceback + +import sspi +import win32api +import win32security + +options = None # set to optparse object. + + +def GetUserName(): + try: + return win32api.GetUserName() + except win32api.error as details: + # Seeing 'access denied' errors here for non-local users (presumably + # without permission to login locally). Get the fully-qualified + # username, although a side-effect of these permission-denied errors + # is a lack of Python codecs - so printing the Unicode value fails. + # So just return the repr(), and avoid codecs completely. + return repr(win32api.GetUserNameEx(win32api.NameSamCompatible)) + + +# Send a simple "message" over a socket - send the number of bytes first, +# then the string. Ditto for receive. +def _send_msg(s, m): + s.send(struct.pack("i", len(m))) + s.send(m) + + +def _get_msg(s): + size_data = s.recv(struct.calcsize("i")) + if not size_data: + return None + cb = struct.unpack("i", size_data)[0] + return s.recv(cb) + + +class SSPISocketServer(socketserver.TCPServer): + def __init__(self, *args, **kw): + socketserver.TCPServer.__init__(self, *args, **kw) + self.sa = sspi.ServerAuth(options.package) + + def verify_request(self, sock, ca): + # Do the sspi auth dance + self.sa.reset() + while 1: + data = _get_msg(sock) + if data is None: + return False + try: + err, sec_buffer = self.sa.authorize(data) + except sspi.error as details: + print("FAILED to authorize client:", details) + return False + + if err == 0: + break + _send_msg(sock, sec_buffer[0].Buffer) + return True + + def process_request(self, request, client_address): + # An example using the connection once it is established. + print("The server is running as user", GetUserName()) + self.sa.ctxt.ImpersonateSecurityContext() + try: + print("Having conversation with client as user", GetUserName()) + while 1: + # we need to grab 2 bits of data - the encrypted data, and the + # 'key' + data = _get_msg(request) + key = _get_msg(request) + if data is None or key is None: + break + data = self.sa.decrypt(data, key) + print("Client sent:", repr(data)) + finally: + self.sa.ctxt.RevertSecurityContext() + self.close_request(request) + print("The server is back to user", GetUserName()) + + +def serve(): + s = SSPISocketServer(("localhost", options.port), None) + print("Running test server...") + s.serve_forever() + + +def sspi_client(): + c = http.client.HTTPConnection("localhost", options.port) + c.connect() + # Do the auth dance. + ca = sspi.ClientAuth(options.package, targetspn=options.target_spn) + data = None + while 1: + err, out_buf = ca.authorize(data) + _send_msg(c.sock, out_buf[0].Buffer) + if err == 0: + break + data = _get_msg(c.sock) + print("Auth dance complete - sending a few encryted messages") + # Assume out data is sensitive - encrypt the message. + for data in "Hello from the client".split(): + blob, key = ca.encrypt(data) + _send_msg(c.sock, blob) + _send_msg(c.sock, key) + c.sock.close() + print("Client completed.") + + +if __name__ == "__main__": + parser = optparse.OptionParser("%prog [options] client|server", description=__doc__) + + parser.add_option( + "", + "--package", + action="store", + default="NTLM", + help="The SSPI package to use (eg, Kerberos) - default is NTLM", + ) + + parser.add_option( + "", + "--target-spn", + action="store", + help="""The target security provider name to use. The + string contents are security-package specific. For + example, 'Kerberos' or 'Negotiate' require the server + principal name (SPN) (ie, the username) of the remote + process. For NTLM this must be blank.""", + ) + + parser.add_option( + "", + "--port", + action="store", + default="8181", + help="The port number to use (default=8181)", + ) + + parser.add_option( + "", + "--wait", + action="store_true", + help="""Cause the program to wait for input just before + terminating. Useful when using via runas to see + any error messages before termination. + """, + ) + + options, args = parser.parse_args() + try: + options.port = int(options.port) + except (ValueError, TypeError): + parser.error("--port must be an integer") + + try: + try: + if not args: + args = [""] + if args[0] == "client": + sspi_client() + elif args[0] == "server": + serve() + else: + parser.error( + "You must supply 'client' or 'server' - " "use --help for details" + ) + except KeyboardInterrupt: + pass + except SystemExit: + pass + except: + traceback.print_exc() + finally: + if options.wait: + input("Press enter to continue") diff --git a/lib/win32/Demos/security/sspi/validate_password.py b/lib/win32/Demos/security/sspi/validate_password.py new file mode 100644 index 00000000..40b6ad5b --- /dev/null +++ b/lib/win32/Demos/security/sspi/validate_password.py @@ -0,0 +1,41 @@ +# Demonstrates how to validate a password. +# See also MSKB article Q180548 +# +# To use with Kerberos you need to jump through the 'targetspn' hoops. + +import sys + +import win32security +from sspi import ClientAuth, ServerAuth + + +def validate(username, password, domain=""): + auth_info = username, domain, password + ca = ClientAuth("NTLM", auth_info=auth_info) + sa = ServerAuth("NTLM") + + data = err = None + while err != 0: + err, data = ca.authorize(data) + err, data = sa.authorize(data) + # If we get here without exception, we worked! + + +if __name__ == "__main__": + if len(sys.argv) not in [2, 3, 4]: + print("Usage: %s username [password [domain]]" % (__file__,)) + sys.exit(1) + + # password and domain are optional! + password = None + if len(sys.argv) >= 3: + password = sys.argv[2] + domain = "" + if len(sys.argv) >= 4: + domain = sys.argv[3] + try: + validate(sys.argv[1], password, domain) + print("Validated OK") + except win32security.error as details: + hr, func, msg = details + print("Validation failed: %s (%d)" % (msg, hr)) diff --git a/lib/win32/Demos/service/nativePipeTestService.py b/lib/win32/Demos/service/nativePipeTestService.py new file mode 100644 index 00000000..4ac05eba --- /dev/null +++ b/lib/win32/Demos/service/nativePipeTestService.py @@ -0,0 +1,63 @@ +# This is an example of a service hosted by python.exe rather than +# pythonservice.exe. + +# Note that it is very rare that using python.exe is a better option +# than the default pythonservice.exe - the latter has better error handling +# so that if Python itself can't be initialized or there are very early +# import errors, you will get error details written to the event log. When +# using python.exe instead, you are forced to wait for the interpreter startup +# and imports to succeed before you are able to effectively setup your own +# error handling. + +# So in short, please make sure you *really* want to do this, otherwise just +# stick with the default. + +import os +import sys + +import servicemanager +import win32serviceutil +from pipeTestService import TestPipeService + + +class NativeTestPipeService(TestPipeService): + _svc_name_ = "PyNativePipeTestService" + _svc_display_name_ = "Python Native Pipe Test Service" + _svc_description_ = "Tests Python.exe hosted services" + # tell win32serviceutil we have a custom executable and custom args + # so registration does the right thing. + _exe_name_ = sys.executable + _exe_args_ = '"' + os.path.abspath(sys.argv[0]) + '"' + + +def main(): + if len(sys.argv) == 1: + # service must be starting... + print("service is starting...") + print("(execute this script with '--help' if that isn't what you want)") + + # for the sake of debugging etc, we use win32traceutil to see + # any unhandled exceptions and print statements. + import win32traceutil + + print("service is still starting...") + + servicemanager.Initialize() + servicemanager.PrepareToHostSingle(NativeTestPipeService) + # Now ask the service manager to fire things up for us... + servicemanager.StartServiceCtrlDispatcher() + print("service done!") + else: + win32serviceutil.HandleCommandLine(NativeTestPipeService) + + +if __name__ == "__main__": + try: + main() + except (SystemExit, KeyboardInterrupt): + raise + except: + print("Something went bad!") + import traceback + + traceback.print_exc() diff --git a/lib/win32/Demos/service/pipeTestService.py b/lib/win32/Demos/service/pipeTestService.py new file mode 100644 index 00000000..2efda606 --- /dev/null +++ b/lib/win32/Demos/service/pipeTestService.py @@ -0,0 +1,184 @@ +# A Demo of services and named pipes. + +# A multi-threaded service that simply echos back its input. + +# * Install as a service using "pipeTestService.py install" +# * Use Control Panel to change the user name of the service +# to a real user name (ie, NOT the SystemAccount) +# * Start the service. +# * Run the "pipeTestServiceClient.py" program as the client pipe side. + +import _thread +import traceback + +# Old versions of the service framework would not let you import this +# module at the top-level. Now you can, and can check 'Debugging()' and +# 'RunningAsService()' to check your context. +import pywintypes +import servicemanager +import win32con +import win32service +import win32serviceutil +import winerror +from ntsecuritycon import * +from win32api import * + +# Use "import *" to keep this looking as much as a "normal" service +# as possible. Real code shouldn't do this. +from win32event import * +from win32file import * +from win32pipe import * + + +def ApplyIgnoreError(fn, args): + try: + return fn(*args) + except error: # Ignore win32api errors. + return None + + +class TestPipeService(win32serviceutil.ServiceFramework): + _svc_name_ = "PyPipeTestService" + _svc_display_name_ = "Python Pipe Test Service" + _svc_description_ = "Tests Python service framework by receiving and echoing messages over a named pipe" + + def __init__(self, args): + win32serviceutil.ServiceFramework.__init__(self, args) + self.hWaitStop = CreateEvent(None, 0, 0, None) + self.overlapped = pywintypes.OVERLAPPED() + self.overlapped.hEvent = CreateEvent(None, 0, 0, None) + self.thread_handles = [] + + def CreatePipeSecurityObject(self): + # Create a security object giving World read/write access, + # but only "Owner" modify access. + sa = pywintypes.SECURITY_ATTRIBUTES() + sidEveryone = pywintypes.SID() + sidEveryone.Initialize(SECURITY_WORLD_SID_AUTHORITY, 1) + sidEveryone.SetSubAuthority(0, SECURITY_WORLD_RID) + sidCreator = pywintypes.SID() + sidCreator.Initialize(SECURITY_CREATOR_SID_AUTHORITY, 1) + sidCreator.SetSubAuthority(0, SECURITY_CREATOR_OWNER_RID) + + acl = pywintypes.ACL() + acl.AddAccessAllowedAce(FILE_GENERIC_READ | FILE_GENERIC_WRITE, sidEveryone) + acl.AddAccessAllowedAce(FILE_ALL_ACCESS, sidCreator) + + sa.SetSecurityDescriptorDacl(1, acl, 0) + return sa + + # The functions executed in their own thread to process a client request. + def DoProcessClient(self, pipeHandle, tid): + try: + try: + # Create a loop, reading large data. If we knew the data stream was + # was small, a simple ReadFile would do. + d = "".encode("ascii") # ensure bytes on py2k and py3k... + hr = winerror.ERROR_MORE_DATA + while hr == winerror.ERROR_MORE_DATA: + hr, thisd = ReadFile(pipeHandle, 256) + d = d + thisd + print("Read", d) + ok = 1 + except error: + # Client disconnection - do nothing + ok = 0 + + # A secure service would handle (and ignore!) errors writing to the + # pipe, but for the sake of this demo we dont (if only to see what errors + # we can get when our clients break at strange times :-) + if ok: + msg = ( + "%s (on thread %d) sent me %s" + % (GetNamedPipeHandleState(pipeHandle, False, True)[4], tid, d) + ).encode("ascii") + WriteFile(pipeHandle, msg) + finally: + ApplyIgnoreError(DisconnectNamedPipe, (pipeHandle,)) + ApplyIgnoreError(CloseHandle, (pipeHandle,)) + + def ProcessClient(self, pipeHandle): + try: + procHandle = GetCurrentProcess() + th = DuplicateHandle( + procHandle, + GetCurrentThread(), + procHandle, + 0, + 0, + win32con.DUPLICATE_SAME_ACCESS, + ) + try: + self.thread_handles.append(th) + try: + return self.DoProcessClient(pipeHandle, th) + except: + traceback.print_exc() + finally: + self.thread_handles.remove(th) + except: + traceback.print_exc() + + def SvcStop(self): + self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING) + SetEvent(self.hWaitStop) + + def SvcDoRun(self): + # Write an event log record - in debug mode we will also + # see this message printed. + servicemanager.LogMsg( + servicemanager.EVENTLOG_INFORMATION_TYPE, + servicemanager.PYS_SERVICE_STARTED, + (self._svc_name_, ""), + ) + + num_connections = 0 + while 1: + pipeHandle = CreateNamedPipe( + "\\\\.\\pipe\\PyPipeTest", + PIPE_ACCESS_DUPLEX | FILE_FLAG_OVERLAPPED, + PIPE_TYPE_MESSAGE | PIPE_READMODE_BYTE, + PIPE_UNLIMITED_INSTANCES, # max instances + 0, + 0, + 6000, + self.CreatePipeSecurityObject(), + ) + try: + hr = ConnectNamedPipe(pipeHandle, self.overlapped) + except error as details: + print("Error connecting pipe!", details) + CloseHandle(pipeHandle) + break + if hr == winerror.ERROR_PIPE_CONNECTED: + # Client is already connected - signal event + SetEvent(self.overlapped.hEvent) + rc = WaitForMultipleObjects( + (self.hWaitStop, self.overlapped.hEvent), 0, INFINITE + ) + if rc == WAIT_OBJECT_0: + # Stop event + break + else: + # Pipe event - spawn thread to deal with it. + _thread.start_new_thread(self.ProcessClient, (pipeHandle,)) + num_connections = num_connections + 1 + + # Sleep to ensure that any new threads are in the list, and then + # wait for all current threads to finish. + # What is a better way? + Sleep(500) + while self.thread_handles: + self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING, 5000) + print("Waiting for %d threads to finish..." % (len(self.thread_handles))) + WaitForMultipleObjects(self.thread_handles, 1, 3000) + # Write another event log record. + servicemanager.LogMsg( + servicemanager.EVENTLOG_INFORMATION_TYPE, + servicemanager.PYS_SERVICE_STOPPED, + (self._svc_name_, " after processing %d connections" % (num_connections,)), + ) + + +if __name__ == "__main__": + win32serviceutil.HandleCommandLine(TestPipeService) diff --git a/lib/win32/Demos/service/pipeTestServiceClient.py b/lib/win32/Demos/service/pipeTestServiceClient.py new file mode 100644 index 00000000..98fdb3c9 --- /dev/null +++ b/lib/win32/Demos/service/pipeTestServiceClient.py @@ -0,0 +1,156 @@ +# A Test Program for pipeTestService.py +# +# Install and start the Pipe Test service, then run this test +# either from the same machine, or from another using the "-s" param. +# +# Eg: pipeTestServiceClient.py -s server_name Hi There +# Should work. + +import os +import sys +import traceback + +import pywintypes +import win32api +import winerror +from win32event import * +from win32file import * +from win32pipe import * + +verbose = 0 + +# def ReadFromPipe(pipeName): +# Could (Should?) use CallNamedPipe, but this technique allows variable size +# messages (whereas you must supply a buffer size for CallNamedPipe! +# hPipe = CreateFile(pipeName, GENERIC_WRITE, 0, None, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, 0) +# more = 1 +# while more: +# hr = ReadFile(hPipe, 256) +# if hr==0: +# more = 0 +# except win32api.error (hr, fn, desc): +# if hr==winerror.ERROR_MORE_DATA: +# data = dat +# + + +def CallPipe(fn, args): + ret = None + retryCount = 0 + while retryCount < 8: # Keep looping until user cancels. + retryCount = retryCount + 1 + try: + return fn(*args) + except win32api.error as exc: + if exc.winerror == winerror.ERROR_PIPE_BUSY: + win32api.Sleep(5000) + continue + else: + raise + + raise RuntimeError("Could not make a connection to the server") + + +def testClient(server, msg): + if verbose: + print("Sending", msg) + data = CallPipe( + CallNamedPipe, + ("\\\\%s\\pipe\\PyPipeTest" % server, msg, 256, NMPWAIT_WAIT_FOREVER), + ) + if verbose: + print("Server sent back '%s'" % data) + print("Sent and received a message!") + + +def testLargeMessage(server, size=4096): + if verbose: + print("Sending message of size %d" % (size)) + msg = "*" * size + data = CallPipe( + CallNamedPipe, + ("\\\\%s\\pipe\\PyPipeTest" % server, msg, 512, NMPWAIT_WAIT_FOREVER), + ) + if len(data) - size: + print("Sizes are all wrong - send %d, got back %d" % (size, len(data))) + + +def stressThread(server, numMessages, wait): + try: + try: + for i in range(numMessages): + r = CallPipe( + CallNamedPipe, + ( + "\\\\%s\\pipe\\PyPipeTest" % server, + "#" * 512, + 1024, + NMPWAIT_WAIT_FOREVER, + ), + ) + except: + traceback.print_exc() + print("Failed after %d messages" % i) + finally: + SetEvent(wait) + + +def stressTestClient(server, numThreads, numMessages): + import _thread + + thread_waits = [] + for t_num in range(numThreads): + # Note I could just wait on thread handles (after calling DuplicateHandle) + # See the service itself for an example of waiting for the clients... + wait = CreateEvent(None, 0, 0, None) + thread_waits.append(wait) + _thread.start_new_thread(stressThread, (server, numMessages, wait)) + # Wait for all threads to finish. + WaitForMultipleObjects(thread_waits, 1, INFINITE) + + +def main(): + import getopt + import sys + + server = "." + thread_count = 0 + msg_count = 500 + try: + opts, args = getopt.getopt(sys.argv[1:], "s:t:m:vl") + for o, a in opts: + if o == "-s": + server = a + if o == "-m": + msg_count = int(a) + if o == "-t": + thread_count = int(a) + if o == "-v": + global verbose + verbose = 1 + if o == "-l": + testLargeMessage(server) + msg = " ".join(args).encode("mbcs") + except getopt.error as msg: + print(msg) + my_name = os.path.split(sys.argv[0])[1] + print( + "Usage: %s [-v] [-s server] [-t thread_count=0] [-m msg_count=500] msg ..." + % my_name + ) + print(" -v = verbose") + print( + " Specifying a value for -t will stress test using that many threads." + ) + return + testClient(server, msg) + if thread_count > 0: + print( + "Spawning %d threads each sending %d messages..." + % (thread_count, msg_count) + ) + stressTestClient(server, thread_count, msg_count) + + +if __name__ == "__main__": + main() diff --git a/lib/win32/Demos/service/serviceEvents.py b/lib/win32/Demos/service/serviceEvents.py new file mode 100644 index 00000000..a62784f9 --- /dev/null +++ b/lib/win32/Demos/service/serviceEvents.py @@ -0,0 +1,98 @@ +# A Demo of a service that takes advantage of the additional notifications +# available in later Windows versions. + +# Note that all output is written as event log entries - so you must install +# and start the service, then look at the event log for messages as events +# are generated. + +# Events are generated for USB device insertion and removal, power state +# changes and hardware profile events - so try putting your computer to +# sleep and waking it, inserting a memory stick, etc then check the event log + +# Most event notification support lives around win32gui +import servicemanager +import win32con +import win32event +import win32gui +import win32gui_struct +import win32service +import win32serviceutil + +GUID_DEVINTERFACE_USB_DEVICE = "{A5DCBF10-6530-11D2-901F-00C04FB951ED}" + + +class EventDemoService(win32serviceutil.ServiceFramework): + _svc_name_ = "PyServiceEventDemo" + _svc_display_name_ = "Python Service Event Demo" + _svc_description_ = ( + "Demonstrates a Python service which takes advantage of the extra notifications" + ) + + def __init__(self, args): + win32serviceutil.ServiceFramework.__init__(self, args) + self.hWaitStop = win32event.CreateEvent(None, 0, 0, None) + # register for a device notification - we pass our service handle + # instead of a window handle. + filter = win32gui_struct.PackDEV_BROADCAST_DEVICEINTERFACE( + GUID_DEVINTERFACE_USB_DEVICE + ) + self.hdn = win32gui.RegisterDeviceNotification( + self.ssh, filter, win32con.DEVICE_NOTIFY_SERVICE_HANDLE + ) + + # Override the base class so we can accept additional events. + def GetAcceptedControls(self): + # say we accept them all. + rc = win32serviceutil.ServiceFramework.GetAcceptedControls(self) + rc |= ( + win32service.SERVICE_ACCEPT_PARAMCHANGE + | win32service.SERVICE_ACCEPT_NETBINDCHANGE + | win32service.SERVICE_CONTROL_DEVICEEVENT + | win32service.SERVICE_ACCEPT_HARDWAREPROFILECHANGE + | win32service.SERVICE_ACCEPT_POWEREVENT + | win32service.SERVICE_ACCEPT_SESSIONCHANGE + ) + return rc + + # All extra events are sent via SvcOtherEx (SvcOther remains as a + # function taking only the first args for backwards compat) + def SvcOtherEx(self, control, event_type, data): + # This is only showing a few of the extra events - see the MSDN + # docs for "HandlerEx callback" for more info. + if control == win32service.SERVICE_CONTROL_DEVICEEVENT: + info = win32gui_struct.UnpackDEV_BROADCAST(data) + msg = "A device event occurred: %x - %s" % (event_type, info) + elif control == win32service.SERVICE_CONTROL_HARDWAREPROFILECHANGE: + msg = "A hardware profile changed: type=%s, data=%s" % (event_type, data) + elif control == win32service.SERVICE_CONTROL_POWEREVENT: + msg = "A power event: setting %s" % data + elif control == win32service.SERVICE_CONTROL_SESSIONCHANGE: + # data is a single elt tuple, but this could potentially grow + # in the future if the win32 struct does + msg = "Session event: type=%s, data=%s" % (event_type, data) + else: + msg = "Other event: code=%d, type=%s, data=%s" % (control, event_type, data) + + servicemanager.LogMsg( + servicemanager.EVENTLOG_INFORMATION_TYPE, + 0xF000, # generic message + (msg, ""), + ) + + def SvcStop(self): + self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING) + win32event.SetEvent(self.hWaitStop) + + def SvcDoRun(self): + # do nothing at all - just wait to be stopped + win32event.WaitForSingleObject(self.hWaitStop, win32event.INFINITE) + # Write a stop message. + servicemanager.LogMsg( + servicemanager.EVENTLOG_INFORMATION_TYPE, + servicemanager.PYS_SERVICE_STOPPED, + (self._svc_name_, ""), + ) + + +if __name__ == "__main__": + win32serviceutil.HandleCommandLine(EventDemoService) diff --git a/lib/win32/Demos/timer_demo.py b/lib/win32/Demos/timer_demo.py new file mode 100644 index 00000000..61115f06 --- /dev/null +++ b/lib/win32/Demos/timer_demo.py @@ -0,0 +1,72 @@ +# -*- Mode: Python; tab-width: 4 -*- +# + +# This module, and the timer.pyd core timer support, were written by +# Sam Rushing (rushing@nightmare.com) + +import time + +# Timers are based on Windows messages. So we need +# to do the event-loop thing! +import timer +import win32event +import win32gui + +# glork holds a simple counter for us. + + +class glork: + def __init__(self, delay=1000, max=10): + self.x = 0 + self.max = max + self.id = timer.set_timer(delay, self.increment) + # Could use the threading module, but this is + # a win32 extension test after all! :-) + self.event = win32event.CreateEvent(None, 0, 0, None) + + def increment(self, id, time): + print("x = %d" % self.x) + self.x = self.x + 1 + # if we've reached the max count, + # kill off the timer. + if self.x > self.max: + # we could have used 'self.id' here, too + timer.kill_timer(id) + win32event.SetEvent(self.event) + + +# create a counter that will count from '1' thru '10', incrementing +# once a second, and then stop. + + +def demo(delay=1000, stop=10): + g = glork(delay, stop) + # Timers are message based - so we need + # To run a message loop while waiting for our timers + # to expire. + start_time = time.time() + while 1: + # We can't simply give a timeout of 30 seconds, as + # we may continouusly be recieving other input messages, + # and therefore never expire. + rc = win32event.MsgWaitForMultipleObjects( + (g.event,), # list of objects + 0, # wait all + 500, # timeout + win32event.QS_ALLEVENTS, # type of input + ) + if rc == win32event.WAIT_OBJECT_0: + # Event signalled. + break + elif rc == win32event.WAIT_OBJECT_0 + 1: + # Message waiting. + if win32gui.PumpWaitingMessages(): + raise RuntimeError("We got an unexpected WM_QUIT message!") + else: + # This wait timed-out. + if time.time() - start_time > 30: + raise RuntimeError("We timed out waiting for the timers to expire!") + + +if __name__ == "__main__": + demo() diff --git a/lib/win32/Demos/win32clipboardDemo.py b/lib/win32/Demos/win32clipboardDemo.py new file mode 100644 index 00000000..1252ff7d --- /dev/null +++ b/lib/win32/Demos/win32clipboardDemo.py @@ -0,0 +1,145 @@ +# win32clipboardDemo.py +# +# Demo/test of the win32clipboard module. + +import win32con +from pywin32_testutil import str2bytes # py3k-friendly helper +from win32clipboard import * + +if not __debug__: + print("WARNING: The test code in this module uses assert") + print("This instance of Python has asserts disabled, so many tests will be skipped") + +cf_names = {} +# Build map of CF_* constants to names. +for name, val in list(win32con.__dict__.items()): + if name[:3] == "CF_" and name != "CF_SCREENFONTS": # CF_SCREEN_FONTS==CF_TEXT!?!? + cf_names[val] = name + + +def TestEmptyClipboard(): + OpenClipboard() + try: + EmptyClipboard() + assert ( + EnumClipboardFormats(0) == 0 + ), "Clipboard formats were available after emptying it!" + finally: + CloseClipboard() + + +def TestText(): + OpenClipboard() + try: + text = "Hello from Python" + text_bytes = str2bytes(text) + SetClipboardText(text) + got = GetClipboardData(win32con.CF_TEXT) + # CF_TEXT always gives us 'bytes' back . + assert got == text_bytes, "Didnt get the correct result back - '%r'." % (got,) + finally: + CloseClipboard() + + OpenClipboard() + try: + # CF_UNICODE text always gives unicode objects back. + got = GetClipboardData(win32con.CF_UNICODETEXT) + assert got == text, "Didnt get the correct result back - '%r'." % (got,) + assert type(got) == str, "Didnt get the correct result back - '%r'." % (got,) + + # CF_OEMTEXT is a bytes-based format. + got = GetClipboardData(win32con.CF_OEMTEXT) + assert got == text_bytes, "Didnt get the correct result back - '%r'." % (got,) + + # Unicode tests + EmptyClipboard() + text = "Hello from Python unicode" + text_bytes = str2bytes(text) + # Now set the Unicode value + SetClipboardData(win32con.CF_UNICODETEXT, text) + # Get it in Unicode. + got = GetClipboardData(win32con.CF_UNICODETEXT) + assert got == text, "Didnt get the correct result back - '%r'." % (got,) + assert type(got) == str, "Didnt get the correct result back - '%r'." % (got,) + + # Close and open the clipboard to ensure auto-conversions take place. + finally: + CloseClipboard() + + OpenClipboard() + try: + # Make sure I can still get the text as bytes + got = GetClipboardData(win32con.CF_TEXT) + assert got == text_bytes, "Didnt get the correct result back - '%r'." % (got,) + # Make sure we get back the correct types. + got = GetClipboardData(win32con.CF_UNICODETEXT) + assert type(got) == str, "Didnt get the correct result back - '%r'." % (got,) + got = GetClipboardData(win32con.CF_OEMTEXT) + assert got == text_bytes, "Didnt get the correct result back - '%r'." % (got,) + print("Clipboard text tests worked correctly") + finally: + CloseClipboard() + + +def TestClipboardEnum(): + OpenClipboard() + try: + # Enumerate over the clipboard types + enum = 0 + while 1: + enum = EnumClipboardFormats(enum) + if enum == 0: + break + assert IsClipboardFormatAvailable( + enum + ), "Have format, but clipboard says it is not available!" + n = cf_names.get(enum, "") + if not n: + try: + n = GetClipboardFormatName(enum) + except error: + n = "unknown (%s)" % (enum,) + + print("Have format", n) + print("Clipboard enumerator tests worked correctly") + finally: + CloseClipboard() + + +class Foo: + def __init__(self, **kw): + self.__dict__.update(kw) + + def __cmp__(self, other): + return cmp(self.__dict__, other.__dict__) + + def __eq__(self, other): + return self.__dict__ == other.__dict__ + + +def TestCustomFormat(): + OpenClipboard() + try: + # Just for the fun of it pickle Python objects through the clipboard + fmt = RegisterClipboardFormat("Python Pickle Format") + import pickle + + pickled_object = Foo(a=1, b=2, Hi=3) + SetClipboardData(fmt, pickle.dumps(pickled_object)) + # Now read it back. + data = GetClipboardData(fmt) + loaded_object = pickle.loads(data) + assert pickle.loads(data) == pickled_object, "Didnt get the correct data!" + + print("Clipboard custom format tests worked correctly") + finally: + CloseClipboard() + + +if __name__ == "__main__": + TestEmptyClipboard() + TestText() + TestCustomFormat() + TestClipboardEnum() + # And leave it empty at the end! + TestEmptyClipboard() diff --git a/lib/win32/Demos/win32clipboard_bitmapdemo.py b/lib/win32/Demos/win32clipboard_bitmapdemo.py new file mode 100644 index 00000000..7d453025 --- /dev/null +++ b/lib/win32/Demos/win32clipboard_bitmapdemo.py @@ -0,0 +1,117 @@ +import win32api +import win32clipboard +import win32con +import win32gui + + +class ViewerWindow: + def __init__(self): + self.hwndNextViewer = None + + def OnPaint(self, hwnd, msg, wp, lp): + dc, ps = win32gui.BeginPaint(hwnd) + wndrect = win32gui.GetClientRect(hwnd) + wndwidth = wndrect[2] - wndrect[0] + wndheight = wndrect[3] - wndrect[1] + win32clipboard.OpenClipboard() + try: + try: + hbitmap = win32clipboard.GetClipboardData(win32clipboard.CF_BITMAP) + except TypeError: + font = win32gui.LOGFONT() + font.lfHeight = 15 # int(wndheight/20) + font.lfWidth = 15 # font.lfHeight + # font.lfWeight=150 + hf = win32gui.CreateFontIndirect(font) + win32gui.SelectObject(dc, hf) + win32gui.SetBkMode(dc, win32con.TRANSPARENT) + win32gui.SetTextColor(dc, win32api.RGB(0, 0, 0)) + win32gui.DrawText( + dc, + "No bitmaps are in the clipboard\n(try pressing the PrtScn button)", + -1, + (0, 0, wndwidth, wndheight), + win32con.DT_CENTER, + ) + else: + bminfo = win32gui.GetObject(hbitmap) + dcDC = win32gui.CreateCompatibleDC(None) + win32gui.SelectObject(dcDC, hbitmap) + win32gui.StretchBlt( + dc, + 0, + 0, + wndwidth, + wndheight, + dcDC, + 0, + 0, + bminfo.bmWidth, + bminfo.bmHeight, + win32con.SRCCOPY, + ) + win32gui.DeleteDC(dcDC) + win32gui.EndPaint(hwnd, ps) + finally: + win32clipboard.CloseClipboard() + return 0 + + def OnDrawClipboard(self, hwnd, msg, wp, lp): + win32gui.InvalidateRect(hwnd, None, True) + + def OnChangeCBChain(self, hwnd, msg, wp, lp): + # If the next window is closing, repair the chain. + if wp == self.hwndNextViewer: + self.hwndNextViewer = lp + # Otherwise, pass the message to the next link. + elif self.hwndNextViewer: + win32gui.SendMessage(self.hwndNextViewer, msg, wp, lp) + + def OnCreate(self, hwnd, msg, wp, lp): + self.hwndNextViewer = win32gui.SetClipboardViewer(hwnd) + + def OnClose(self, hwnd, msg, wp, lp): + win32clipboard.ChangeClipboardChain(hwnd, self.hwndNextViewer) + win32gui.DestroyWindow(hwnd) + win32gui.PostQuitMessage(0) + + def go(self): + wndproc = { + win32con.WM_PAINT: self.OnPaint, + win32con.WM_CLOSE: self.OnClose, + win32con.WM_CREATE: self.OnCreate, + win32con.WM_DRAWCLIPBOARD: self.OnDrawClipboard, + win32con.WM_CHANGECBCHAIN: self.OnChangeCBChain, + } + + wc = win32gui.WNDCLASS() + wc.lpszClassName = "test_win32clipboard_bmp" + wc.style = win32con.CS_GLOBALCLASS | win32con.CS_VREDRAW | win32con.CS_HREDRAW + wc.hbrBackground = win32con.COLOR_WINDOW + 1 + wc.lpfnWndProc = wndproc + class_atom = win32gui.RegisterClass(wc) + hwnd = win32gui.CreateWindowEx( + 0, + class_atom, + "ClipboardViewer", + win32con.WS_CAPTION + | win32con.WS_VISIBLE + | win32con.WS_THICKFRAME + | win32con.WS_SYSMENU, + 100, + 100, + 900, + 900, + 0, + 0, + 0, + None, + ) + win32clipboard.SetClipboardViewer(hwnd) + win32gui.PumpMessages() + win32gui.UnregisterClass(class_atom, None) + + +if __name__ == "__main__": + w = ViewerWindow() + w.go() diff --git a/lib/win32/Demos/win32comport_demo.py b/lib/win32/Demos/win32comport_demo.py new file mode 100644 index 00000000..c0be2391 --- /dev/null +++ b/lib/win32/Demos/win32comport_demo.py @@ -0,0 +1,144 @@ +# This is a simple serial port terminal demo. +# +# Its primary purpose is to demonstrate the native serial port access offered via +# win32file. + +# It uses 3 threads: +# - The main thread, which cranks up the other 2 threads, then simply waits for them to exit. +# - The user-input thread - blocks waiting for a keyboard character, and when found sends it +# out the COM port. If the character is Ctrl+C, it stops, signalling the COM port thread to stop. +# - The COM port thread is simply listening for input on the COM port, and prints it to the screen. + +# This demo uses userlapped IO, so that none of the read or write operations actually block (however, +# in this sample, the very next thing we do _is_ block - so it shows off the concepts even though it +# doesnt exploit them. + +import msvcrt # For the getch() function. +import sys +import threading + +import win32con # constants. +from win32event import * # We use events and the WaitFor[Multiple]Objects functions. +from win32file import * # The base COM port and file IO functions. + + +def FindModem(): + # Snoop over the comports, seeing if it is likely we have a modem. + for i in range(1, 5): + port = "COM%d" % (i,) + try: + handle = CreateFile( + port, + win32con.GENERIC_READ | win32con.GENERIC_WRITE, + 0, # exclusive access + None, # no security + win32con.OPEN_EXISTING, + win32con.FILE_ATTRIBUTE_NORMAL, + None, + ) + # It appears that an available COM port will always success here, + # just return 0 for the status flags. We only care that it has _any_ status + # flags (and therefore probably a real modem) + if GetCommModemStatus(handle) != 0: + return port + except error: + pass # No port, or modem status failed. + return None + + +# A basic synchronous COM port file-like object +class SerialTTY: + def __init__(self, port): + if type(port) == type(0): + port = "COM%d" % (port,) + self.handle = CreateFile( + port, + win32con.GENERIC_READ | win32con.GENERIC_WRITE, + 0, # exclusive access + None, # no security + win32con.OPEN_EXISTING, + win32con.FILE_ATTRIBUTE_NORMAL | win32con.FILE_FLAG_OVERLAPPED, + None, + ) + # Tell the port we want a notification on each char. + SetCommMask(self.handle, EV_RXCHAR) + # Setup a 4k buffer + SetupComm(self.handle, 4096, 4096) + # Remove anything that was there + PurgeComm( + self.handle, PURGE_TXABORT | PURGE_RXABORT | PURGE_TXCLEAR | PURGE_RXCLEAR + ) + # Setup for overlapped IO. + timeouts = 0xFFFFFFFF, 0, 1000, 0, 1000 + SetCommTimeouts(self.handle, timeouts) + # Setup the connection info. + dcb = GetCommState(self.handle) + dcb.BaudRate = CBR_115200 + dcb.ByteSize = 8 + dcb.Parity = NOPARITY + dcb.StopBits = ONESTOPBIT + SetCommState(self.handle, dcb) + print("Connected to %s at %s baud" % (port, dcb.BaudRate)) + + def _UserInputReaderThread(self): + overlapped = OVERLAPPED() + overlapped.hEvent = CreateEvent(None, 1, 0, None) + try: + while 1: + ch = msvcrt.getch() + if ord(ch) == 3: + break + WriteFile(self.handle, ch, overlapped) + # Wait for the write to complete. + WaitForSingleObject(overlapped.hEvent, INFINITE) + finally: + SetEvent(self.eventStop) + + def _ComPortThread(self): + overlapped = OVERLAPPED() + overlapped.hEvent = CreateEvent(None, 1, 0, None) + while 1: + # XXX - note we could _probably_ just use overlapped IO on the win32file.ReadFile() statement + # XXX but this tests the COM stuff! + rc, mask = WaitCommEvent(self.handle, overlapped) + if rc == 0: # Character already ready! + SetEvent(overlapped.hEvent) + rc = WaitForMultipleObjects( + [overlapped.hEvent, self.eventStop], 0, INFINITE + ) + if rc == WAIT_OBJECT_0: + # Some input - read and print it + flags, comstat = ClearCommError(self.handle) + rc, data = ReadFile(self.handle, comstat.cbInQue, overlapped) + WaitForSingleObject(overlapped.hEvent, INFINITE) + sys.stdout.write(data) + else: + # Stop the thread! + # Just incase the user input thread uis still going, close it + sys.stdout.close() + break + + def Run(self): + self.eventStop = CreateEvent(None, 0, 0, None) + # Start the reader and writer threads. + user_thread = threading.Thread(target=self._UserInputReaderThread) + user_thread.start() + com_thread = threading.Thread(target=self._ComPortThread) + com_thread.start() + user_thread.join() + com_thread.join() + + +if __name__ == "__main__": + print("Serial port terminal demo - press Ctrl+C to exit") + if len(sys.argv) <= 1: + port = FindModem() + if port is None: + print("No COM port specified, and no modem could be found") + print("Please re-run this script with the name of a COM port (eg COM3)") + sys.exit(1) + else: + port = sys.argv[1] + + tty = SerialTTY(port) + tty.Run() diff --git a/lib/win32/Demos/win32console_demo.py b/lib/win32/Demos/win32console_demo.py new file mode 100644 index 00000000..bb9162bf --- /dev/null +++ b/lib/win32/Demos/win32console_demo.py @@ -0,0 +1,135 @@ +import time + +import win32con +import win32console + +virtual_keys = {} +for k, v in list(win32con.__dict__.items()): + if k.startswith("VK_"): + virtual_keys[v] = k + +free_console = True +try: + win32console.AllocConsole() +except win32console.error as exc: + if exc.winerror != 5: + raise + ## only free console if one was created successfully + free_console = False + +stdout = win32console.GetStdHandle(win32console.STD_OUTPUT_HANDLE) +stdin = win32console.GetStdHandle(win32console.STD_INPUT_HANDLE) +newbuffer = win32console.CreateConsoleScreenBuffer() +newbuffer.SetConsoleActiveScreenBuffer() +newbuffer.SetConsoleTextAttribute( + win32console.FOREGROUND_RED + | win32console.FOREGROUND_INTENSITY + | win32console.BACKGROUND_GREEN + | win32console.BACKGROUND_INTENSITY +) +newbuffer.WriteConsole("This is a new screen buffer\n") + +## test setting screen buffer and window size +## screen buffer size cannot be smaller than window size +window_size = newbuffer.GetConsoleScreenBufferInfo()["Window"] +coord = win32console.PyCOORDType(X=window_size.Right + 20, Y=window_size.Bottom + 20) +newbuffer.SetConsoleScreenBufferSize(coord) + +window_size.Right += 10 +window_size.Bottom += 10 +newbuffer.SetConsoleWindowInfo(Absolute=True, ConsoleWindow=window_size) + +## write some records to the input queue +x = win32console.PyINPUT_RECORDType(win32console.KEY_EVENT) +x.Char = "X" +x.KeyDown = True +x.RepeatCount = 1 +x.VirtualKeyCode = 0x58 +x.ControlKeyState = win32con.SHIFT_PRESSED + +z = win32console.PyINPUT_RECORDType(win32console.KEY_EVENT) +z.Char = "Z" +z.KeyDown = True +z.RepeatCount = 1 +z.VirtualKeyCode = 0x5A +z.ControlKeyState = win32con.SHIFT_PRESSED + +stdin.WriteConsoleInput([x, z, x]) + +newbuffer.SetConsoleTextAttribute( + win32console.FOREGROUND_RED + | win32console.FOREGROUND_INTENSITY + | win32console.BACKGROUND_GREEN + | win32console.BACKGROUND_INTENSITY +) +newbuffer.WriteConsole("Press some keys, click some characters with the mouse\n") + +newbuffer.SetConsoleTextAttribute( + win32console.FOREGROUND_BLUE + | win32console.FOREGROUND_INTENSITY + | win32console.BACKGROUND_RED + | win32console.BACKGROUND_INTENSITY +) +newbuffer.WriteConsole('Hit "End" key to quit\n') + +breakout = False +while not breakout: + input_records = stdin.ReadConsoleInput(10) + for input_record in input_records: + if input_record.EventType == win32console.KEY_EVENT: + if input_record.KeyDown: + if input_record.Char == "\0": + newbuffer.WriteConsole( + virtual_keys.get( + input_record.VirtualKeyCode, + "VirtualKeyCode: %s" % input_record.VirtualKeyCode, + ) + ) + else: + newbuffer.WriteConsole(input_record.Char) + if input_record.VirtualKeyCode == win32con.VK_END: + breakout = True + break + elif input_record.EventType == win32console.MOUSE_EVENT: + if input_record.EventFlags == 0: ## 0 indicates a button event + if input_record.ButtonState != 0: ## exclude button releases + pos = input_record.MousePosition + # switch the foreground and background colors of the character that was clicked + attr = newbuffer.ReadConsoleOutputAttribute( + Length=1, ReadCoord=pos + )[0] + new_attr = attr + if attr & win32console.FOREGROUND_BLUE: + new_attr = ( + new_attr & ~win32console.FOREGROUND_BLUE + ) | win32console.BACKGROUND_BLUE + if attr & win32console.FOREGROUND_RED: + new_attr = ( + new_attr & ~win32console.FOREGROUND_RED + ) | win32console.BACKGROUND_RED + if attr & win32console.FOREGROUND_GREEN: + new_attr = ( + new_attr & ~win32console.FOREGROUND_GREEN + ) | win32console.BACKGROUND_GREEN + + if attr & win32console.BACKGROUND_BLUE: + new_attr = ( + new_attr & ~win32console.BACKGROUND_BLUE + ) | win32console.FOREGROUND_BLUE + if attr & win32console.BACKGROUND_RED: + new_attr = ( + new_attr & ~win32console.BACKGROUND_RED + ) | win32console.FOREGROUND_RED + if attr & win32console.BACKGROUND_GREEN: + new_attr = ( + new_attr & ~win32console.BACKGROUND_GREEN + ) | win32console.FOREGROUND_GREEN + newbuffer.WriteConsoleOutputAttribute((new_attr,), pos) + else: + newbuffer.WriteConsole(str(input_record)) + time.sleep(0.1) + +stdout.SetConsoleActiveScreenBuffer() +newbuffer.Close() +if free_console: + win32console.FreeConsole() diff --git a/lib/win32/Demos/win32cred_demo.py b/lib/win32/Demos/win32cred_demo.py new file mode 100644 index 00000000..3b49ca7c --- /dev/null +++ b/lib/win32/Demos/win32cred_demo.py @@ -0,0 +1,82 @@ +""" +Demonstrates prompting for credentials, saving, and loggging on with marshalled credential. +Also shows how to load user's profile +""" + +import win32api +import win32con +import win32cred +import win32net +import win32profile +import win32security + +## Prompt for a username/pwd for local computer +uiinfo = { + "MessageText": "Enter credentials for local machine", + "CaptionText": "win32cred_demo.py", +} +target, pwd, save = win32cred.CredUIPromptForCredentials( + TargetName=win32api.GetComputerName(), + AuthError=0, + Flags=win32cred.CREDUI_FLAGS_DO_NOT_PERSIST + | win32cred.CREDUI_FLAGS_SHOW_SAVE_CHECK_BOX, + Save=False, + UiInfo=uiinfo, +) + +attrs = [ + {"Keyword": "attr1", "Flags": 0, "Value": "unicode data"}, + {"Keyword": "attr2", "Flags": 0, "Value": b"character data"}, +] +cred = { + "Comment": "Created by win32cred_demo.py", + "UserName": target, + "TargetAlias": None, + "TargetName": target, + "CredentialBlob": pwd, + "Flags": win32cred.CRED_FLAGS_USERNAME_TARGET, + "Persist": win32cred.CRED_PERSIST_ENTERPRISE, + "Type": win32cred.CRED_TYPE_DOMAIN_PASSWORD, + "Attributes": attrs, +} +win32cred.CredWrite(cred) +pwd = None +print(win32cred.CredRead(target, win32cred.CRED_TYPE_DOMAIN_PASSWORD)) + +## Marshal saved credential and use it to log on +mc = win32cred.CredMarshalCredential(win32cred.UsernameTargetCredential, target) + +# As of pywin32 301 this no longer works for markh and unclear when it stopped, or +# even if it ever did! # Fails in Python 2.7 too, so not a 3.x regression. +try: + th = win32security.LogonUser( + mc, + None, + "", + win32con.LOGON32_LOGON_INTERACTIVE, + win32con.LOGON32_PROVIDER_DEFAULT, + ) + win32security.ImpersonateLoggedOnUser(th) + print("GetUserName:", win32api.GetUserName()) + win32security.RevertToSelf() + + ## Load user's profile. (first check if user has a roaming profile) + username, domain = win32cred.CredUIParseUserName(target) + user_info_4 = win32net.NetUserGetInfo(None, username, 4) + profilepath = user_info_4["profile"] + ## LoadUserProfile apparently doesn't like an empty string + if not profilepath: + profilepath = None + + ## leave Flags in since 2.3 still chokes on some types of optional keyword args + hk = win32profile.LoadUserProfile( + th, {"UserName": username, "Flags": 0, "ProfilePath": profilepath} + ) + ## Get user's environment variables in a form that can be passed to win32process.CreateProcessAsUser + env = win32profile.CreateEnvironmentBlock(th, False) + + ## Cleanup should probably be in a finally block + win32profile.UnloadUserProfile(th, hk) + th.Close() +except win32security.error as exc: + print("Failed to login for some reason", exc) diff --git a/lib/win32/Demos/win32fileDemo.py b/lib/win32/Demos/win32fileDemo.py new file mode 100644 index 00000000..a8099925 --- /dev/null +++ b/lib/win32/Demos/win32fileDemo.py @@ -0,0 +1,41 @@ +# This is a "demo" of win32file - it used to be more a test case than a +# demo, so has been moved to the test directory. + +import os + +# Please contribute your favourite simple little demo. +import win32api +import win32con +import win32file + + +# A very simple demo - note that this does no more than you can do with +# builtin Python file objects, so for something as simple as this, you +# generally *should* use builtin Python objects. Only use win32file etc +# when you need win32 specific features not available in Python. +def SimpleFileDemo(): + testName = os.path.join(win32api.GetTempPath(), "win32file_demo_test_file") + if os.path.exists(testName): + os.unlink(testName) + # Open the file for writing. + handle = win32file.CreateFile( + testName, win32file.GENERIC_WRITE, 0, None, win32con.CREATE_NEW, 0, None + ) + test_data = "Hello\0there".encode("ascii") + win32file.WriteFile(handle, test_data) + handle.Close() + # Open it for reading. + handle = win32file.CreateFile( + testName, win32file.GENERIC_READ, 0, None, win32con.OPEN_EXISTING, 0, None + ) + rc, data = win32file.ReadFile(handle, 1024) + handle.Close() + if data == test_data: + print("Successfully wrote and read a file") + else: + raise Exception("Got different data back???") + os.unlink(testName) + + +if __name__ == "__main__": + SimpleFileDemo() diff --git a/lib/win32/Demos/win32gui_demo.py b/lib/win32/Demos/win32gui_demo.py new file mode 100644 index 00000000..41844a92 --- /dev/null +++ b/lib/win32/Demos/win32gui_demo.py @@ -0,0 +1,177 @@ +# The start of a win32gui generic demo. +# Feel free to contribute more demos back ;-) + +import math +import random +import time + +import win32api +import win32con +import win32gui + + +def _MyCallback(hwnd, extra): + hwnds, classes = extra + hwnds.append(hwnd) + classes[win32gui.GetClassName(hwnd)] = 1 + + +def TestEnumWindows(): + windows = [] + classes = {} + win32gui.EnumWindows(_MyCallback, (windows, classes)) + print( + "Enumerated a total of %d windows with %d classes" + % (len(windows), len(classes)) + ) + if "tooltips_class32" not in classes: + print("Hrmmmm - I'm very surprised to not find a 'tooltips_class32' class.") + + +def OnPaint_1(hwnd, msg, wp, lp): + dc, ps = win32gui.BeginPaint(hwnd) + win32gui.SetGraphicsMode(dc, win32con.GM_ADVANCED) + br = win32gui.CreateSolidBrush(win32api.RGB(255, 0, 0)) + win32gui.SelectObject(dc, br) + angle = win32gui.GetWindowLong(hwnd, win32con.GWL_USERDATA) + win32gui.SetWindowLong(hwnd, win32con.GWL_USERDATA, angle + 2) + r_angle = angle * (math.pi / 180) + win32gui.SetWorldTransform( + dc, + { + "M11": math.cos(r_angle), + "M12": math.sin(r_angle), + "M21": math.sin(r_angle) * -1, + "M22": math.cos(r_angle), + "Dx": 250, + "Dy": 250, + }, + ) + win32gui.MoveToEx(dc, 250, 250) + win32gui.BeginPath(dc) + win32gui.Pie(dc, 10, 70, 200, 200, 350, 350, 75, 10) + win32gui.Chord(dc, 200, 200, 850, 0, 350, 350, 75, 10) + win32gui.LineTo(dc, 300, 300) + win32gui.LineTo(dc, 100, 20) + win32gui.LineTo(dc, 20, 100) + win32gui.LineTo(dc, 400, 0) + win32gui.LineTo(dc, 0, 400) + win32gui.EndPath(dc) + win32gui.StrokeAndFillPath(dc) + win32gui.EndPaint(hwnd, ps) + return 0 + + +wndproc_1 = {win32con.WM_PAINT: OnPaint_1} + + +def OnPaint_2(hwnd, msg, wp, lp): + dc, ps = win32gui.BeginPaint(hwnd) + win32gui.SetGraphicsMode(dc, win32con.GM_ADVANCED) + l, t, r, b = win32gui.GetClientRect(hwnd) + + for x in range(25): + vertices = ( + { + "x": int(random.random() * r), + "y": int(random.random() * b), + "Red": int(random.random() * 0xFF00), + "Green": 0, + "Blue": 0, + "Alpha": 0, + }, + { + "x": int(random.random() * r), + "y": int(random.random() * b), + "Red": 0, + "Green": int(random.random() * 0xFF00), + "Blue": 0, + "Alpha": 0, + }, + { + "x": int(random.random() * r), + "y": int(random.random() * b), + "Red": 0, + "Green": 0, + "Blue": int(random.random() * 0xFF00), + "Alpha": 0, + }, + ) + mesh = ((0, 1, 2),) + win32gui.GradientFill(dc, vertices, mesh, win32con.GRADIENT_FILL_TRIANGLE) + win32gui.EndPaint(hwnd, ps) + return 0 + + +wndproc_2 = {win32con.WM_PAINT: OnPaint_2} + + +def TestSetWorldTransform(): + wc = win32gui.WNDCLASS() + wc.lpszClassName = "test_win32gui_1" + wc.style = win32con.CS_GLOBALCLASS | win32con.CS_VREDRAW | win32con.CS_HREDRAW + wc.hbrBackground = win32con.COLOR_WINDOW + 1 + wc.lpfnWndProc = wndproc_1 + class_atom = win32gui.RegisterClass(wc) + hwnd = win32gui.CreateWindow( + wc.lpszClassName, + "Spin the Lobster!", + win32con.WS_CAPTION | win32con.WS_VISIBLE, + 100, + 100, + 900, + 900, + 0, + 0, + 0, + None, + ) + for x in range(500): + win32gui.InvalidateRect(hwnd, None, True) + win32gui.PumpWaitingMessages() + time.sleep(0.01) + win32gui.DestroyWindow(hwnd) + win32gui.UnregisterClass(wc.lpszClassName, None) + + +def TestGradientFill(): + wc = win32gui.WNDCLASS() + wc.lpszClassName = "test_win32gui_2" + wc.style = win32con.CS_GLOBALCLASS | win32con.CS_VREDRAW | win32con.CS_HREDRAW + wc.hbrBackground = win32con.COLOR_WINDOW + 1 + wc.lpfnWndProc = wndproc_2 + class_atom = win32gui.RegisterClass(wc) + hwnd = win32gui.CreateWindowEx( + 0, + class_atom, + "Kaleidoscope", + win32con.WS_CAPTION + | win32con.WS_VISIBLE + | win32con.WS_THICKFRAME + | win32con.WS_SYSMENU, + 100, + 100, + 900, + 900, + 0, + 0, + 0, + None, + ) + s = win32gui.GetWindowLong(hwnd, win32con.GWL_EXSTYLE) + win32gui.SetWindowLong(hwnd, win32con.GWL_EXSTYLE, s | win32con.WS_EX_LAYERED) + win32gui.SetLayeredWindowAttributes(hwnd, 0, 175, win32con.LWA_ALPHA) + for x in range(30): + win32gui.InvalidateRect(hwnd, None, True) + win32gui.PumpWaitingMessages() + time.sleep(0.3) + win32gui.DestroyWindow(hwnd) + win32gui.UnregisterClass(class_atom, None) + + +print("Enumerating all windows...") +TestEnumWindows() +print("Testing drawing functions ...") +TestSetWorldTransform() +TestGradientFill() +print("All tests done!") diff --git a/lib/win32/Demos/win32gui_devicenotify.py b/lib/win32/Demos/win32gui_devicenotify.py new file mode 100644 index 00000000..34ad8a25 --- /dev/null +++ b/lib/win32/Demos/win32gui_devicenotify.py @@ -0,0 +1,107 @@ +# Demo RegisterDeviceNotification etc. Creates a hidden window to receive +# notifications. See serviceEvents.py for an example of a service doing +# that. +import sys +import time + +import win32api +import win32con +import win32file +import win32gui +import win32gui_struct +import winnt + +# These device GUIDs are from Ioevent.h in the Windows SDK. Ideally they +# could be collected somewhere for pywin32... +GUID_DEVINTERFACE_USB_DEVICE = "{A5DCBF10-6530-11D2-901F-00C04FB951ED}" + + +# WM_DEVICECHANGE message handler. +def OnDeviceChange(hwnd, msg, wp, lp): + # Unpack the 'lp' into the appropriate DEV_BROADCAST_* structure, + # using the self-identifying data inside the DEV_BROADCAST_HDR. + info = win32gui_struct.UnpackDEV_BROADCAST(lp) + print("Device change notification:", wp, str(info)) + if ( + wp == win32con.DBT_DEVICEQUERYREMOVE + and info.devicetype == win32con.DBT_DEVTYP_HANDLE + ): + # Our handle is stored away in the structure - just close it + print("Device being removed - closing handle") + win32file.CloseHandle(info.handle) + # and cancel our notifications - if it gets plugged back in we get + # the same notification and try and close the same handle... + win32gui.UnregisterDeviceNotification(info.hdevnotify) + return True + + +def TestDeviceNotifications(dir_names): + wc = win32gui.WNDCLASS() + wc.lpszClassName = "test_devicenotify" + wc.style = win32con.CS_GLOBALCLASS | win32con.CS_VREDRAW | win32con.CS_HREDRAW + wc.hbrBackground = win32con.COLOR_WINDOW + 1 + wc.lpfnWndProc = {win32con.WM_DEVICECHANGE: OnDeviceChange} + class_atom = win32gui.RegisterClass(wc) + hwnd = win32gui.CreateWindow( + wc.lpszClassName, + "Testing some devices", + # no need for it to be visible. + win32con.WS_CAPTION, + 100, + 100, + 900, + 900, + 0, + 0, + 0, + None, + ) + + hdevs = [] + # Watch for all USB device notifications + filter = win32gui_struct.PackDEV_BROADCAST_DEVICEINTERFACE( + GUID_DEVINTERFACE_USB_DEVICE + ) + hdev = win32gui.RegisterDeviceNotification( + hwnd, filter, win32con.DEVICE_NOTIFY_WINDOW_HANDLE + ) + hdevs.append(hdev) + # and create handles for all specified directories + for d in dir_names: + hdir = win32file.CreateFile( + d, + winnt.FILE_LIST_DIRECTORY, + winnt.FILE_SHARE_READ | winnt.FILE_SHARE_WRITE | winnt.FILE_SHARE_DELETE, + None, # security attributes + win32con.OPEN_EXISTING, + win32con.FILE_FLAG_BACKUP_SEMANTICS + | win32con.FILE_FLAG_OVERLAPPED, # required privileges: SE_BACKUP_NAME and SE_RESTORE_NAME. + None, + ) + + filter = win32gui_struct.PackDEV_BROADCAST_HANDLE(hdir) + hdev = win32gui.RegisterDeviceNotification( + hwnd, filter, win32con.DEVICE_NOTIFY_WINDOW_HANDLE + ) + hdevs.append(hdev) + + # now start a message pump and wait for messages to be delivered. + print("Watching", len(hdevs), "handles - press Ctrl+C to terminate, or") + print("add and remove some USB devices...") + if not dir_names: + print("(Note you can also pass paths to watch on the command-line - eg,") + print("pass the root of an inserted USB stick to see events specific to") + print("that volume)") + while 1: + win32gui.PumpWaitingMessages() + time.sleep(0.01) + win32gui.DestroyWindow(hwnd) + win32gui.UnregisterClass(wc.lpszClassName, None) + + +if __name__ == "__main__": + # optionally pass device/directory names to watch for notifications. + # Eg, plug in a USB device - assume it connects as E: - then execute: + # % win32gui_devicenotify.py E: + # Then remove and insert the device. + TestDeviceNotifications(sys.argv[1:]) diff --git a/lib/win32/Demos/win32gui_dialog.py b/lib/win32/Demos/win32gui_dialog.py new file mode 100644 index 00000000..e3b89ba9 --- /dev/null +++ b/lib/win32/Demos/win32gui_dialog.py @@ -0,0 +1,458 @@ +# A demo of a fairly complex dialog. +# +# Features: +# * Uses a "dynamic dialog resource" to build the dialog. +# * Uses a ListView control. +# * Dynamically resizes content. +# * Uses a second worker thread to fill the list. +# * Demostrates support for windows XP themes. + +# If you are on Windows XP, and specify a '--noxp' argument, you will see: +# * alpha-blend issues with icons +# * The buttons are "old" style, rather than based on the XP theme. +# Hence, using: +# import winxpgui as win32gui +# is recommended. +# Please report any problems. +import sys + +if "--noxp" in sys.argv: + import win32gui +else: + import winxpgui as win32gui + +import array +import os +import queue +import struct + +import commctrl +import win32api +import win32con +import win32gui_struct +import winerror + +IDC_SEARCHTEXT = 1024 +IDC_BUTTON_SEARCH = 1025 +IDC_BUTTON_DISPLAY = 1026 +IDC_LISTBOX = 1027 + +WM_SEARCH_RESULT = win32con.WM_USER + 512 +WM_SEARCH_FINISHED = win32con.WM_USER + 513 + + +class _WIN32MASKEDSTRUCT: + def __init__(self, **kw): + full_fmt = "" + for name, fmt, default, mask in self._struct_items_: + self.__dict__[name] = None + if fmt == "z": + full_fmt += "pi" + else: + full_fmt += fmt + for name, val in kw.items(): + if name not in self.__dict__: + raise ValueError("LVITEM structures do not have an item '%s'" % (name,)) + self.__dict__[name] = val + + def __setattr__(self, attr, val): + if not attr.startswith("_") and attr not in self.__dict__: + raise AttributeError(attr) + self.__dict__[attr] = val + + def toparam(self): + self._buffs = [] + full_fmt = "" + vals = [] + mask = 0 + # calc the mask + for name, fmt, default, this_mask in self._struct_items_: + if this_mask is not None and self.__dict__.get(name) is not None: + mask |= this_mask + self.mask = mask + for name, fmt, default, this_mask in self._struct_items_: + val = self.__dict__[name] + if fmt == "z": + fmt = "Pi" + if val is None: + vals.append(0) + vals.append(0) + else: + # Note this demo still works with byte strings. An + # alternate strategy would be to use unicode natively + # and use the 'W' version of the messages - eg, + # LVM_SETITEMW etc. + val = val + "\0" + if isinstance(val, str): + val = val.encode("mbcs") + str_buf = array.array("b", val) + vals.append(str_buf.buffer_info()[0]) + vals.append(len(val)) + self._buffs.append(str_buf) # keep alive during the call. + else: + if val is None: + val = default + vals.append(val) + full_fmt += fmt + return struct.pack(*(full_fmt,) + tuple(vals)) + + +# NOTE: See the win32gui_struct module for an alternative way of dealing +# with these structures +class LVITEM(_WIN32MASKEDSTRUCT): + _struct_items_ = [ + ("mask", "I", 0, None), + ("iItem", "i", 0, None), + ("iSubItem", "i", 0, None), + ("state", "I", 0, commctrl.LVIF_STATE), + ("stateMask", "I", 0, None), + ("text", "z", None, commctrl.LVIF_TEXT), + ("iImage", "i", 0, commctrl.LVIF_IMAGE), + ("lParam", "i", 0, commctrl.LVIF_PARAM), + ("iIdent", "i", 0, None), + ] + + +class LVCOLUMN(_WIN32MASKEDSTRUCT): + _struct_items_ = [ + ("mask", "I", 0, None), + ("fmt", "i", 0, commctrl.LVCF_FMT), + ("cx", "i", 0, commctrl.LVCF_WIDTH), + ("text", "z", None, commctrl.LVCF_TEXT), + ("iSubItem", "i", 0, commctrl.LVCF_SUBITEM), + ("iImage", "i", 0, commctrl.LVCF_IMAGE), + ("iOrder", "i", 0, commctrl.LVCF_ORDER), + ] + + +class DemoWindowBase: + def __init__(self): + win32gui.InitCommonControls() + self.hinst = win32gui.dllhandle + self.list_data = {} + + def _RegisterWndClass(self): + className = "PythonDocSearch" + message_map = {} + wc = win32gui.WNDCLASS() + wc.SetDialogProc() # Make it a dialog class. + wc.hInstance = self.hinst + wc.lpszClassName = className + wc.style = win32con.CS_VREDRAW | win32con.CS_HREDRAW + wc.hCursor = win32gui.LoadCursor(0, win32con.IDC_ARROW) + wc.hbrBackground = win32con.COLOR_WINDOW + 1 + wc.lpfnWndProc = message_map # could also specify a wndproc. + # C code: wc.cbWndExtra = DLGWINDOWEXTRA + sizeof(HBRUSH) + (sizeof(COLORREF)); + wc.cbWndExtra = win32con.DLGWINDOWEXTRA + struct.calcsize("Pi") + icon_flags = win32con.LR_LOADFROMFILE | win32con.LR_DEFAULTSIZE + + ## py.ico went away in python 2.5, load from executable instead + this_app = win32api.GetModuleHandle(None) + try: + wc.hIcon = win32gui.LoadIcon(this_app, 1) ## python.exe and pythonw.exe + except win32gui.error: + wc.hIcon = win32gui.LoadIcon(this_app, 135) ## pythonwin's icon + try: + classAtom = win32gui.RegisterClass(wc) + except win32gui.error as err_info: + if err_info.winerror != winerror.ERROR_CLASS_ALREADY_EXISTS: + raise + return className + + def _GetDialogTemplate(self, dlgClassName): + style = ( + win32con.WS_THICKFRAME + | win32con.WS_POPUP + | win32con.WS_VISIBLE + | win32con.WS_CAPTION + | win32con.WS_SYSMENU + | win32con.DS_SETFONT + | win32con.WS_MINIMIZEBOX + ) + cs = win32con.WS_CHILD | win32con.WS_VISIBLE + title = "Dynamic Dialog Demo" + + # Window frame and title + dlg = [ + [ + title, + (0, 0, 210, 250), + style, + None, + (8, "MS Sans Serif"), + None, + dlgClassName, + ], + ] + + # ID label and text box + dlg.append([130, "Enter something", -1, (5, 5, 200, 9), cs | win32con.SS_LEFT]) + s = cs | win32con.WS_TABSTOP | win32con.WS_BORDER + dlg.append(["EDIT", None, IDC_SEARCHTEXT, (5, 15, 200, 12), s]) + + # Search/Display Buttons + # (x positions don't matter here) + s = cs | win32con.WS_TABSTOP + dlg.append( + [ + 128, + "Fill List", + IDC_BUTTON_SEARCH, + (5, 35, 50, 14), + s | win32con.BS_DEFPUSHBUTTON, + ] + ) + s = win32con.BS_PUSHBUTTON | s + dlg.append([128, "Display", IDC_BUTTON_DISPLAY, (100, 35, 50, 14), s]) + + # List control. + # Can't make this work :( + ## s = cs | win32con.WS_TABSTOP + ## dlg.append(['SysListView32', "Title", IDC_LISTBOX, (5, 505, 200, 200), s]) + + return dlg + + def _DoCreate(self, fn): + message_map = { + win32con.WM_SIZE: self.OnSize, + win32con.WM_COMMAND: self.OnCommand, + win32con.WM_NOTIFY: self.OnNotify, + win32con.WM_INITDIALOG: self.OnInitDialog, + win32con.WM_CLOSE: self.OnClose, + win32con.WM_DESTROY: self.OnDestroy, + WM_SEARCH_RESULT: self.OnSearchResult, + WM_SEARCH_FINISHED: self.OnSearchFinished, + } + dlgClassName = self._RegisterWndClass() + template = self._GetDialogTemplate(dlgClassName) + return fn(self.hinst, template, 0, message_map) + + def _SetupList(self): + child_style = ( + win32con.WS_CHILD + | win32con.WS_VISIBLE + | win32con.WS_BORDER + | win32con.WS_HSCROLL + | win32con.WS_VSCROLL + ) + child_style |= ( + commctrl.LVS_SINGLESEL | commctrl.LVS_SHOWSELALWAYS | commctrl.LVS_REPORT + ) + self.hwndList = win32gui.CreateWindow( + "SysListView32", + None, + child_style, + 0, + 0, + 100, + 100, + self.hwnd, + IDC_LISTBOX, + self.hinst, + None, + ) + + child_ex_style = win32gui.SendMessage( + self.hwndList, commctrl.LVM_GETEXTENDEDLISTVIEWSTYLE, 0, 0 + ) + child_ex_style |= commctrl.LVS_EX_FULLROWSELECT + win32gui.SendMessage( + self.hwndList, commctrl.LVM_SETEXTENDEDLISTVIEWSTYLE, 0, child_ex_style + ) + + # Add an image list - use the builtin shell folder icon - this + # demonstrates the problem with alpha-blending of icons on XP if + # winxpgui is not used in place of win32gui. + il = win32gui.ImageList_Create( + win32api.GetSystemMetrics(win32con.SM_CXSMICON), + win32api.GetSystemMetrics(win32con.SM_CYSMICON), + commctrl.ILC_COLOR32 | commctrl.ILC_MASK, + 1, # initial size + 0, + ) # cGrow + + shell_dll = os.path.join(win32api.GetSystemDirectory(), "shell32.dll") + large, small = win32gui.ExtractIconEx(shell_dll, 4, 1) + win32gui.ImageList_ReplaceIcon(il, -1, small[0]) + win32gui.DestroyIcon(small[0]) + win32gui.DestroyIcon(large[0]) + win32gui.SendMessage( + self.hwndList, commctrl.LVM_SETIMAGELIST, commctrl.LVSIL_SMALL, il + ) + + # Setup the list control columns. + lvc = LVCOLUMN( + mask=commctrl.LVCF_FMT + | commctrl.LVCF_WIDTH + | commctrl.LVCF_TEXT + | commctrl.LVCF_SUBITEM + ) + lvc.fmt = commctrl.LVCFMT_LEFT + lvc.iSubItem = 1 + lvc.text = "Title" + lvc.cx = 200 + win32gui.SendMessage(self.hwndList, commctrl.LVM_INSERTCOLUMN, 0, lvc.toparam()) + lvc.iSubItem = 0 + lvc.text = "Order" + lvc.cx = 50 + win32gui.SendMessage(self.hwndList, commctrl.LVM_INSERTCOLUMN, 0, lvc.toparam()) + + win32gui.UpdateWindow(self.hwnd) + + def ClearListItems(self): + win32gui.SendMessage(self.hwndList, commctrl.LVM_DELETEALLITEMS) + self.list_data = {} + + def AddListItem(self, data, *columns): + num_items = win32gui.SendMessage(self.hwndList, commctrl.LVM_GETITEMCOUNT) + item = LVITEM(text=columns[0], iItem=num_items) + new_index = win32gui.SendMessage( + self.hwndList, commctrl.LVM_INSERTITEM, 0, item.toparam() + ) + col_no = 1 + for col in columns[1:]: + item = LVITEM(text=col, iItem=new_index, iSubItem=col_no) + win32gui.SendMessage(self.hwndList, commctrl.LVM_SETITEM, 0, item.toparam()) + col_no += 1 + self.list_data[new_index] = data + + def OnInitDialog(self, hwnd, msg, wparam, lparam): + self.hwnd = hwnd + # centre the dialog + desktop = win32gui.GetDesktopWindow() + l, t, r, b = win32gui.GetWindowRect(self.hwnd) + dt_l, dt_t, dt_r, dt_b = win32gui.GetWindowRect(desktop) + centre_x, centre_y = win32gui.ClientToScreen( + desktop, ((dt_r - dt_l) // 2, (dt_b - dt_t) // 2) + ) + win32gui.MoveWindow( + hwnd, centre_x - (r // 2), centre_y - (b // 2), r - l, b - t, 0 + ) + self._SetupList() + l, t, r, b = win32gui.GetClientRect(self.hwnd) + self._DoSize(r - l, b - t, 1) + + def _DoSize(self, cx, cy, repaint=1): + # right-justify the textbox. + ctrl = win32gui.GetDlgItem(self.hwnd, IDC_SEARCHTEXT) + l, t, r, b = win32gui.GetWindowRect(ctrl) + l, t = win32gui.ScreenToClient(self.hwnd, (l, t)) + r, b = win32gui.ScreenToClient(self.hwnd, (r, b)) + win32gui.MoveWindow(ctrl, l, t, cx - l - 5, b - t, repaint) + # The button. + ctrl = win32gui.GetDlgItem(self.hwnd, IDC_BUTTON_DISPLAY) + l, t, r, b = win32gui.GetWindowRect(ctrl) + l, t = win32gui.ScreenToClient(self.hwnd, (l, t)) + r, b = win32gui.ScreenToClient(self.hwnd, (r, b)) + list_y = b + 10 + w = r - l + win32gui.MoveWindow(ctrl, cx - 5 - w, t, w, b - t, repaint) + + # The list control + win32gui.MoveWindow(self.hwndList, 0, list_y, cx, cy - list_y, repaint) + # The last column of the list control. + new_width = cx - win32gui.SendMessage( + self.hwndList, commctrl.LVM_GETCOLUMNWIDTH, 0 + ) + win32gui.SendMessage(self.hwndList, commctrl.LVM_SETCOLUMNWIDTH, 1, new_width) + + def OnSize(self, hwnd, msg, wparam, lparam): + x = win32api.LOWORD(lparam) + y = win32api.HIWORD(lparam) + self._DoSize(x, y) + return 1 + + def OnSearchResult(self, hwnd, msg, wparam, lparam): + try: + while 1: + params = self.result_queue.get(0) + self.AddListItem(*params) + except queue.Empty: + pass + + def OnSearchFinished(self, hwnd, msg, wparam, lparam): + print("OnSearchFinished") + + def OnNotify(self, hwnd, msg, wparam, lparam): + info = win32gui_struct.UnpackNMITEMACTIVATE(lparam) + if info.code == commctrl.NM_DBLCLK: + print("Double click on item", info.iItem + 1) + return 1 + + def OnCommand(self, hwnd, msg, wparam, lparam): + id = win32api.LOWORD(wparam) + if id == IDC_BUTTON_SEARCH: + self.ClearListItems() + + def fill_slowly(q, hwnd): + import time + + for i in range(20): + q.put(("whatever", str(i + 1), "Search result " + str(i))) + win32gui.PostMessage(hwnd, WM_SEARCH_RESULT, 0, 0) + time.sleep(0.25) + win32gui.PostMessage(hwnd, WM_SEARCH_FINISHED, 0, 0) + + import threading + + self.result_queue = queue.Queue() + thread = threading.Thread( + target=fill_slowly, args=(self.result_queue, self.hwnd) + ) + thread.start() + elif id == IDC_BUTTON_DISPLAY: + print("Display button selected") + sel = win32gui.SendMessage( + self.hwndList, commctrl.LVM_GETNEXTITEM, -1, commctrl.LVNI_SELECTED + ) + print("The selected item is", sel + 1) + + # These function differ based on how the window is used, so may be overridden + def OnClose(self, hwnd, msg, wparam, lparam): + raise NotImplementedError + + def OnDestroy(self, hwnd, msg, wparam, lparam): + pass + + +# An implementation suitable for use with the Win32 Window functions (ie, not +# a true dialog) +class DemoWindow(DemoWindowBase): + def CreateWindow(self): + # Create the window via CreateDialogBoxIndirect - it can then + # work as a "normal" window, once a message loop is established. + self._DoCreate(win32gui.CreateDialogIndirect) + + def OnClose(self, hwnd, msg, wparam, lparam): + win32gui.DestroyWindow(hwnd) + + # We need to arrange to a WM_QUIT message to be sent to our + # PumpMessages() loop. + def OnDestroy(self, hwnd, msg, wparam, lparam): + win32gui.PostQuitMessage(0) # Terminate the app. + + +# An implementation suitable for use with the Win32 Dialog functions. +class DemoDialog(DemoWindowBase): + def DoModal(self): + return self._DoCreate(win32gui.DialogBoxIndirect) + + def OnClose(self, hwnd, msg, wparam, lparam): + win32gui.EndDialog(hwnd, 0) + + +def DemoModal(): + w = DemoDialog() + w.DoModal() + + +def DemoCreateWindow(): + w = DemoWindow() + w.CreateWindow() + # PumpMessages runs until PostQuitMessage() is called by someone. + win32gui.PumpMessages() + + +if __name__ == "__main__": + DemoModal() + DemoCreateWindow() diff --git a/lib/win32/Demos/win32gui_menu.py b/lib/win32/Demos/win32gui_menu.py new file mode 100644 index 00000000..c462b062 --- /dev/null +++ b/lib/win32/Demos/win32gui_menu.py @@ -0,0 +1,420 @@ +# Demonstrates some advanced menu concepts using win32gui. +# This creates a taskbar icon which has some fancy menus (but note that +# selecting the menu items does nothing useful - see win32gui_taskbar.py +# for examples of this. + +# NOTE: This is a work in progress. Todo: +# * The "Checked" menu items don't work correctly - I'm not sure why. +# * No support for GetMenuItemInfo. + +# Based on Andy McKay's demo code. +from win32api import * + +# Try and use XP features, so we get alpha-blending etc. +try: + from winxpgui import * +except ImportError: + from win32gui import * + +import array +import os +import struct +import sys + +import win32con +from win32gui_struct import * + +this_dir = os.path.split(sys.argv[0])[0] + + +class MainWindow: + def __init__(self): + message_map = { + win32con.WM_DESTROY: self.OnDestroy, + win32con.WM_COMMAND: self.OnCommand, + win32con.WM_USER + 20: self.OnTaskbarNotify, + # owner-draw related handlers. + win32con.WM_MEASUREITEM: self.OnMeasureItem, + win32con.WM_DRAWITEM: self.OnDrawItem, + } + # Register the Window class. + wc = WNDCLASS() + hinst = wc.hInstance = GetModuleHandle(None) + wc.lpszClassName = "PythonTaskbarDemo" + wc.lpfnWndProc = message_map # could also specify a wndproc. + classAtom = RegisterClass(wc) + # Create the Window. + style = win32con.WS_OVERLAPPED | win32con.WS_SYSMENU + self.hwnd = CreateWindow( + classAtom, + "Taskbar Demo", + style, + 0, + 0, + win32con.CW_USEDEFAULT, + win32con.CW_USEDEFAULT, + 0, + 0, + hinst, + None, + ) + UpdateWindow(self.hwnd) + iconPathName = os.path.abspath(os.path.join(sys.prefix, "pyc.ico")) + # py2.5 includes the .ico files in the DLLs dir for some reason. + if not os.path.isfile(iconPathName): + iconPathName = os.path.abspath( + os.path.join(os.path.split(sys.executable)[0], "DLLs", "pyc.ico") + ) + if not os.path.isfile(iconPathName): + # Look in the source tree. + iconPathName = os.path.abspath( + os.path.join(os.path.split(sys.executable)[0], "..\\PC\\pyc.ico") + ) + if os.path.isfile(iconPathName): + icon_flags = win32con.LR_LOADFROMFILE | win32con.LR_DEFAULTSIZE + hicon = LoadImage( + hinst, iconPathName, win32con.IMAGE_ICON, 0, 0, icon_flags + ) + else: + iconPathName = None + print("Can't find a Python icon file - using default") + hicon = LoadIcon(0, win32con.IDI_APPLICATION) + self.iconPathName = iconPathName + + # Load up some information about menus needed by our owner-draw code. + # The font to use on the menu. + ncm = SystemParametersInfo(win32con.SPI_GETNONCLIENTMETRICS) + self.font_menu = CreateFontIndirect(ncm["lfMenuFont"]) + # spacing for our ownerdraw menus - not sure exactly what constants + # should be used (and if you owner-draw all items on the menu, it + # doesn't matter!) + self.menu_icon_height = GetSystemMetrics(win32con.SM_CYMENU) - 4 + self.menu_icon_width = self.menu_icon_height + self.icon_x_pad = 8 # space from end of icon to start of text. + # A map we use to stash away data we need for ownerdraw. Keyed + # by integer ID - that ID will be set in dwTypeData of the menu item. + self.menu_item_map = {} + + # Finally, create the menu + self.createMenu() + + flags = NIF_ICON | NIF_MESSAGE | NIF_TIP + nid = (self.hwnd, 0, flags, win32con.WM_USER + 20, hicon, "Python Demo") + Shell_NotifyIcon(NIM_ADD, nid) + print("Please right-click on the Python icon in the taskbar") + + def createMenu(self): + self.hmenu = menu = CreatePopupMenu() + # Create our 'Exit' item with the standard, ugly 'close' icon. + item, extras = PackMENUITEMINFO( + text="Exit", hbmpItem=win32con.HBMMENU_MBAR_CLOSE, wID=1000 + ) + InsertMenuItem(menu, 0, 1, item) + # Create a 'text only' menu via InsertMenuItem rather then + # AppendMenu, just to prove we can! + item, extras = PackMENUITEMINFO(text="Text only item", wID=1001) + InsertMenuItem(menu, 0, 1, item) + + load_bmp_flags = win32con.LR_LOADFROMFILE | win32con.LR_LOADTRANSPARENT + # These images are "over sized", so we load them scaled. + hbmp = LoadImage( + 0, + os.path.join(this_dir, "images/smiley.bmp"), + win32con.IMAGE_BITMAP, + 20, + 20, + load_bmp_flags, + ) + + # Create a top-level menu with a bitmap + item, extras = PackMENUITEMINFO( + text="Menu with bitmap", hbmpItem=hbmp, wID=1002 + ) + InsertMenuItem(menu, 0, 1, item) + + # Owner-draw menus mainly from: + # http://windowssdk.msdn.microsoft.com/en-us/library/ms647558.aspx + # and: + # http://www.codeguru.com/cpp/controls/menu/bitmappedmenus/article.php/c165 + + # Create one with an icon - this is *lots* more work - we do it + # owner-draw! The primary reason is to handle transparency better - + # converting to a bitmap causes the background to be incorrect when + # the menu item is selected. I can't see a simpler way. + # First, load the icon we want to use. + ico_x = GetSystemMetrics(win32con.SM_CXSMICON) + ico_y = GetSystemMetrics(win32con.SM_CYSMICON) + if self.iconPathName: + hicon = LoadImage( + 0, + self.iconPathName, + win32con.IMAGE_ICON, + ico_x, + ico_y, + win32con.LR_LOADFROMFILE, + ) + else: + shell_dll = os.path.join(GetSystemDirectory(), "shell32.dll") + large, small = win32gui.ExtractIconEx(shell_dll, 4, 1) + hicon = small[0] + DestroyIcon(large[0]) + + # Stash away the text and hicon in our map, and add the owner-draw + # item to the menu. + index = 0 + self.menu_item_map[index] = (hicon, "Menu with owner-draw icon") + item, extras = PackMENUITEMINFO( + fType=win32con.MFT_OWNERDRAW, dwItemData=index, wID=1009 + ) + InsertMenuItem(menu, 0, 1, item) + + # Add another icon-based icon - but this time using HBMMENU_CALLBACK + # in the hbmpItem elt, so we only need to draw the icon (ie, not the + # text or checkmark) + index = 1 + self.menu_item_map[index] = (hicon, None) + item, extras = PackMENUITEMINFO( + text="Menu with o-d icon 2", + dwItemData=index, + hbmpItem=win32con.HBMMENU_CALLBACK, + wID=1010, + ) + InsertMenuItem(menu, 0, 1, item) + + # Add another icon-based icon - this time by converting + # via bitmap. Note the icon background when selected is ugly :( + hdcBitmap = CreateCompatibleDC(0) + hdcScreen = GetDC(0) + hbm = CreateCompatibleBitmap(hdcScreen, ico_x, ico_y) + hbmOld = SelectObject(hdcBitmap, hbm) + SetBkMode(hdcBitmap, win32con.TRANSPARENT) + # Fill the background. + brush = GetSysColorBrush(win32con.COLOR_MENU) + FillRect(hdcBitmap, (0, 0, 16, 16), brush) + # unclear if brush needs to be freed. Best clue I can find is: + # "GetSysColorBrush returns a cached brush instead of allocating a new + # one." - implies no DeleteObject. + # draw the icon + DrawIconEx(hdcBitmap, 0, 0, hicon, ico_x, ico_y, 0, 0, win32con.DI_NORMAL) + SelectObject(hdcBitmap, hbmOld) + DeleteDC(hdcBitmap) + item, extras = PackMENUITEMINFO( + text="Menu with icon", hbmpItem=hbm.Detach(), wID=1011 + ) + InsertMenuItem(menu, 0, 1, item) + + # Create a sub-menu, and put a few funky ones there. + self.sub_menu = sub_menu = CreatePopupMenu() + # A 'checkbox' menu. + item, extras = PackMENUITEMINFO( + fState=win32con.MFS_CHECKED, text="Checkbox menu", hbmpItem=hbmp, wID=1003 + ) + InsertMenuItem(sub_menu, 0, 1, item) + # A 'radio' menu. + InsertMenu(sub_menu, 0, win32con.MF_BYPOSITION, win32con.MF_SEPARATOR, None) + item, extras = PackMENUITEMINFO( + fType=win32con.MFT_RADIOCHECK, + fState=win32con.MFS_CHECKED, + text="Checkbox menu - bullet 1", + hbmpItem=hbmp, + wID=1004, + ) + InsertMenuItem(sub_menu, 0, 1, item) + item, extras = PackMENUITEMINFO( + fType=win32con.MFT_RADIOCHECK, + fState=win32con.MFS_UNCHECKED, + text="Checkbox menu - bullet 2", + hbmpItem=hbmp, + wID=1005, + ) + InsertMenuItem(sub_menu, 0, 1, item) + # And add the sub-menu to the top-level menu. + item, extras = PackMENUITEMINFO(text="Sub-Menu", hSubMenu=sub_menu) + InsertMenuItem(menu, 0, 1, item) + + # Set 'Exit' as the default option. + SetMenuDefaultItem(menu, 1000, 0) + + def OnDestroy(self, hwnd, msg, wparam, lparam): + nid = (self.hwnd, 0) + Shell_NotifyIcon(NIM_DELETE, nid) + PostQuitMessage(0) # Terminate the app. + + def OnTaskbarNotify(self, hwnd, msg, wparam, lparam): + if lparam == win32con.WM_RBUTTONUP: + print("You right clicked me.") + # display the menu at the cursor pos. + pos = GetCursorPos() + SetForegroundWindow(self.hwnd) + TrackPopupMenu( + self.hmenu, win32con.TPM_LEFTALIGN, pos[0], pos[1], 0, self.hwnd, None + ) + PostMessage(self.hwnd, win32con.WM_NULL, 0, 0) + elif lparam == win32con.WM_LBUTTONDBLCLK: + print("You double-clicked me") + # find the default menu item and fire it. + cmd = GetMenuDefaultItem(self.hmenu, False, 0) + if cmd == -1: + print("Can't find a default!") + # and just pretend it came from the menu + self.OnCommand(hwnd, win32con.WM_COMMAND, cmd, 0) + return 1 + + def OnCommand(self, hwnd, msg, wparam, lparam): + id = LOWORD(wparam) + if id == 1000: + print("Goodbye") + DestroyWindow(self.hwnd) + elif id in (1003, 1004, 1005): + # Our 'checkbox' and 'radio' items + state = GetMenuState(self.sub_menu, id, win32con.MF_BYCOMMAND) + if state == -1: + raise RuntimeError("No item found") + if state & win32con.MF_CHECKED: + check_flags = win32con.MF_UNCHECKED + print("Menu was checked - unchecking") + else: + check_flags = win32con.MF_CHECKED + print("Menu was unchecked - checking") + + if id == 1003: + # simple checkbox + rc = CheckMenuItem( + self.sub_menu, id, win32con.MF_BYCOMMAND | check_flags + ) + else: + # radio button - must pass the first and last IDs in the + # "group", and the ID in the group that is to be selected. + rc = CheckMenuRadioItem( + self.sub_menu, 1004, 1005, id, win32con.MF_BYCOMMAND + ) + # Get and check the new state - first the simple way... + new_state = GetMenuState(self.sub_menu, id, win32con.MF_BYCOMMAND) + if new_state & win32con.MF_CHECKED != check_flags: + raise RuntimeError("The new item didn't get the new checked state!") + # Now the long-winded way via GetMenuItemInfo... + buf, extras = EmptyMENUITEMINFO() + win32gui.GetMenuItemInfo(self.sub_menu, id, False, buf) + ( + fType, + fState, + wID, + hSubMenu, + hbmpChecked, + hbmpUnchecked, + dwItemData, + text, + hbmpItem, + ) = UnpackMENUITEMINFO(buf) + + if fState & win32con.MF_CHECKED != check_flags: + raise RuntimeError("The new item didn't get the new checked state!") + else: + print("OnCommand for ID", id) + + # Owner-draw related functions. We only have 1 owner-draw item, but + # we pretend we have more than that :) + def OnMeasureItem(self, hwnd, msg, wparam, lparam): + ## Last item of MEASUREITEMSTRUCT is a ULONG_PTR + fmt = "5iP" + buf = PyMakeBuffer(struct.calcsize(fmt), lparam) + data = struct.unpack(fmt, buf) + ctlType, ctlID, itemID, itemWidth, itemHeight, itemData = data + + hicon, text = self.menu_item_map[itemData] + if text is None: + # Only drawing icon due to HBMMENU_CALLBACK + cx = self.menu_icon_width + cy = self.menu_icon_height + else: + # drawing the lot! + dc = GetDC(hwnd) + oldFont = SelectObject(dc, self.font_menu) + cx, cy = GetTextExtentPoint32(dc, text) + SelectObject(dc, oldFont) + ReleaseDC(hwnd, dc) + + cx += GetSystemMetrics(win32con.SM_CXMENUCHECK) + cx += self.menu_icon_width + self.icon_x_pad + + cy = GetSystemMetrics(win32con.SM_CYMENU) + + new_data = struct.pack(fmt, ctlType, ctlID, itemID, cx, cy, itemData) + PySetMemory(lparam, new_data) + return True + + def OnDrawItem(self, hwnd, msg, wparam, lparam): + ## lparam is a DRAWITEMSTRUCT + fmt = "5i2P4iP" + data = struct.unpack(fmt, PyGetMemory(lparam, struct.calcsize(fmt))) + ( + ctlType, + ctlID, + itemID, + itemAction, + itemState, + hwndItem, + hDC, + left, + top, + right, + bot, + itemData, + ) = data + + rect = left, top, right, bot + hicon, text = self.menu_item_map[itemData] + + if text is None: + # This means the menu-item had HBMMENU_CALLBACK - so all we + # draw is the icon. rect is the entire area we should use. + DrawIconEx( + hDC, left, top, hicon, right - left, bot - top, 0, 0, win32con.DI_NORMAL + ) + else: + # If the user has selected the item, use the selected + # text and background colors to display the item. + selected = itemState & win32con.ODS_SELECTED + if selected: + crText = SetTextColor(hDC, GetSysColor(win32con.COLOR_HIGHLIGHTTEXT)) + crBkgnd = SetBkColor(hDC, GetSysColor(win32con.COLOR_HIGHLIGHT)) + + each_pad = self.icon_x_pad // 2 + x_icon = left + GetSystemMetrics(win32con.SM_CXMENUCHECK) + each_pad + x_text = x_icon + self.menu_icon_width + each_pad + + # Draw text first, specifying a complete rect to fill - this sets + # up the background (but overwrites anything else already there!) + # Select the font, draw it, and restore the previous font. + hfontOld = SelectObject(hDC, self.font_menu) + ExtTextOut(hDC, x_text, top + 2, win32con.ETO_OPAQUE, rect, text) + SelectObject(hDC, hfontOld) + + # Icon image next. Icons are transparent - no need to handle + # selection specially. + DrawIconEx( + hDC, + x_icon, + top + 2, + hicon, + self.menu_icon_width, + self.menu_icon_height, + 0, + 0, + win32con.DI_NORMAL, + ) + + # Return the text and background colors to their + # normal state (not selected). + if selected: + SetTextColor(hDC, crText) + SetBkColor(hDC, crBkgnd) + + +def main(): + w = MainWindow() + PumpMessages() + + +if __name__ == "__main__": + main() diff --git a/lib/win32/Demos/win32gui_taskbar.py b/lib/win32/Demos/win32gui_taskbar.py new file mode 100644 index 00000000..84d642a9 --- /dev/null +++ b/lib/win32/Demos/win32gui_taskbar.py @@ -0,0 +1,141 @@ +# Creates a task-bar icon. Run from Python.exe to see the +# messages printed. +import os +import sys + +import win32api +import win32con +import win32gui +import winerror + + +class MainWindow: + def __init__(self): + msg_TaskbarRestart = win32gui.RegisterWindowMessage("TaskbarCreated") + message_map = { + msg_TaskbarRestart: self.OnRestart, + win32con.WM_DESTROY: self.OnDestroy, + win32con.WM_COMMAND: self.OnCommand, + win32con.WM_USER + 20: self.OnTaskbarNotify, + } + # Register the Window class. + wc = win32gui.WNDCLASS() + hinst = wc.hInstance = win32api.GetModuleHandle(None) + wc.lpszClassName = "PythonTaskbarDemo" + wc.style = win32con.CS_VREDRAW | win32con.CS_HREDRAW + wc.hCursor = win32api.LoadCursor(0, win32con.IDC_ARROW) + wc.hbrBackground = win32con.COLOR_WINDOW + wc.lpfnWndProc = message_map # could also specify a wndproc. + + # Don't blow up if class already registered to make testing easier + try: + classAtom = win32gui.RegisterClass(wc) + except win32gui.error as err_info: + if err_info.winerror != winerror.ERROR_CLASS_ALREADY_EXISTS: + raise + + # Create the Window. + style = win32con.WS_OVERLAPPED | win32con.WS_SYSMENU + self.hwnd = win32gui.CreateWindow( + wc.lpszClassName, + "Taskbar Demo", + style, + 0, + 0, + win32con.CW_USEDEFAULT, + win32con.CW_USEDEFAULT, + 0, + 0, + hinst, + None, + ) + win32gui.UpdateWindow(self.hwnd) + self._DoCreateIcons() + + def _DoCreateIcons(self): + # Try and find a custom icon + hinst = win32api.GetModuleHandle(None) + iconPathName = os.path.abspath( + os.path.join(os.path.split(sys.executable)[0], "pyc.ico") + ) + if not os.path.isfile(iconPathName): + # Look in DLLs dir, a-la py 2.5 + iconPathName = os.path.abspath( + os.path.join(os.path.split(sys.executable)[0], "DLLs", "pyc.ico") + ) + if not os.path.isfile(iconPathName): + # Look in the source tree. + iconPathName = os.path.abspath( + os.path.join(os.path.split(sys.executable)[0], "..\\PC\\pyc.ico") + ) + if os.path.isfile(iconPathName): + icon_flags = win32con.LR_LOADFROMFILE | win32con.LR_DEFAULTSIZE + hicon = win32gui.LoadImage( + hinst, iconPathName, win32con.IMAGE_ICON, 0, 0, icon_flags + ) + else: + print("Can't find a Python icon file - using default") + hicon = win32gui.LoadIcon(0, win32con.IDI_APPLICATION) + + flags = win32gui.NIF_ICON | win32gui.NIF_MESSAGE | win32gui.NIF_TIP + nid = (self.hwnd, 0, flags, win32con.WM_USER + 20, hicon, "Python Demo") + try: + win32gui.Shell_NotifyIcon(win32gui.NIM_ADD, nid) + except win32gui.error: + # This is common when windows is starting, and this code is hit + # before the taskbar has been created. + print("Failed to add the taskbar icon - is explorer running?") + # but keep running anyway - when explorer starts, we get the + # TaskbarCreated message. + + def OnRestart(self, hwnd, msg, wparam, lparam): + self._DoCreateIcons() + + def OnDestroy(self, hwnd, msg, wparam, lparam): + nid = (self.hwnd, 0) + win32gui.Shell_NotifyIcon(win32gui.NIM_DELETE, nid) + win32gui.PostQuitMessage(0) # Terminate the app. + + def OnTaskbarNotify(self, hwnd, msg, wparam, lparam): + if lparam == win32con.WM_LBUTTONUP: + print("You clicked me.") + elif lparam == win32con.WM_LBUTTONDBLCLK: + print("You double-clicked me - goodbye") + win32gui.DestroyWindow(self.hwnd) + elif lparam == win32con.WM_RBUTTONUP: + print("You right clicked me.") + menu = win32gui.CreatePopupMenu() + win32gui.AppendMenu(menu, win32con.MF_STRING, 1023, "Display Dialog") + win32gui.AppendMenu(menu, win32con.MF_STRING, 1024, "Say Hello") + win32gui.AppendMenu(menu, win32con.MF_STRING, 1025, "Exit program") + pos = win32gui.GetCursorPos() + # See http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winui/menus_0hdi.asp + win32gui.SetForegroundWindow(self.hwnd) + win32gui.TrackPopupMenu( + menu, win32con.TPM_LEFTALIGN, pos[0], pos[1], 0, self.hwnd, None + ) + win32gui.PostMessage(self.hwnd, win32con.WM_NULL, 0, 0) + return 1 + + def OnCommand(self, hwnd, msg, wparam, lparam): + id = win32api.LOWORD(wparam) + if id == 1023: + import win32gui_dialog + + win32gui_dialog.DemoModal() + elif id == 1024: + print("Hello") + elif id == 1025: + print("Goodbye") + win32gui.DestroyWindow(self.hwnd) + else: + print("Unknown command -", id) + + +def main(): + w = MainWindow() + win32gui.PumpMessages() + + +if __name__ == "__main__": + main() diff --git a/lib/win32/Demos/win32netdemo.py b/lib/win32/Demos/win32netdemo.py new file mode 100644 index 00000000..36c49542 --- /dev/null +++ b/lib/win32/Demos/win32netdemo.py @@ -0,0 +1,274 @@ +import getopt +import sys +import traceback + +import win32api +import win32net +import win32netcon +import win32security + +verbose_level = 0 + +server = None # Run on local machine. + + +def verbose(msg): + if verbose_level: + print(msg) + + +def CreateUser(): + "Creates a new test user, then deletes the user" + testName = "PyNetTestUser" + try: + win32net.NetUserDel(server, testName) + print("Warning - deleted user before creating it!") + except win32net.error: + pass + + d = {} + d["name"] = testName + d["password"] = "deleteme" + d["priv"] = win32netcon.USER_PRIV_USER + d["comment"] = "Delete me - created by Python test code" + d["flags"] = win32netcon.UF_NORMAL_ACCOUNT | win32netcon.UF_SCRIPT + win32net.NetUserAdd(server, 1, d) + try: + try: + win32net.NetUserChangePassword(server, testName, "wrong", "new") + print("ERROR: NetUserChangePassword worked with a wrong password!") + except win32net.error: + pass + win32net.NetUserChangePassword(server, testName, "deleteme", "new") + finally: + win32net.NetUserDel(server, testName) + print("Created a user, changed their password, and deleted them!") + + +def UserEnum(): + "Enumerates all the local users" + resume = 0 + nuser = 0 + while 1: + data, total, resume = win32net.NetUserEnum( + server, 3, win32netcon.FILTER_NORMAL_ACCOUNT, resume + ) + verbose( + "Call to NetUserEnum obtained %d entries of %d total" % (len(data), total) + ) + for user in data: + verbose("Found user %s" % user["name"]) + nuser = nuser + 1 + if not resume: + break + assert nuser, "Could not find any users!" + print("Enumerated all the local users") + + +def GroupEnum(): + "Enumerates all the domain groups" + nmembers = 0 + resume = 0 + while 1: + data, total, resume = win32net.NetGroupEnum(server, 1, resume) + # print "Call to NetGroupEnum obtained %d entries of %d total" % (len(data), total) + for group in data: + verbose("Found group %(name)s:%(comment)s " % group) + memberresume = 0 + while 1: + memberdata, total, memberresume = win32net.NetGroupGetUsers( + server, group["name"], 0, resume + ) + for member in memberdata: + verbose(" Member %(name)s" % member) + nmembers = nmembers + 1 + if memberresume == 0: + break + if not resume: + break + assert nmembers, "Couldnt find a single member in a single group!" + print("Enumerated all the groups") + + +def LocalGroupEnum(): + "Enumerates all the local groups" + resume = 0 + nmembers = 0 + while 1: + data, total, resume = win32net.NetLocalGroupEnum(server, 1, resume) + for group in data: + verbose("Found group %(name)s:%(comment)s " % group) + memberresume = 0 + while 1: + memberdata, total, memberresume = win32net.NetLocalGroupGetMembers( + server, group["name"], 2, resume + ) + for member in memberdata: + # Just for the sake of it, we convert the SID to a username + username, domain, type = win32security.LookupAccountSid( + server, member["sid"] + ) + nmembers = nmembers + 1 + verbose(" Member %s (%s)" % (username, member["domainandname"])) + if memberresume == 0: + break + if not resume: + break + assert nmembers, "Couldnt find a single member in a single group!" + print("Enumerated all the local groups") + + +def ServerEnum(): + "Enumerates all servers on the network" + resume = 0 + while 1: + data, total, resume = win32net.NetServerEnum( + server, 100, win32netcon.SV_TYPE_ALL, None, resume + ) + for s in data: + verbose("Found server %s" % s["name"]) + # Now loop over the shares. + shareresume = 0 + while 1: + sharedata, total, shareresume = win32net.NetShareEnum( + server, 2, shareresume + ) + for share in sharedata: + verbose( + " %(netname)s (%(path)s):%(remark)s - in use by %(current_uses)d users" + % share + ) + if not shareresume: + break + if not resume: + break + print("Enumerated all the servers on the network") + + +def LocalGroup(uname=None): + "Creates a local group, adds some members, deletes them, then removes the group" + level = 3 + if uname is None: + uname = win32api.GetUserName() + if uname.find("\\") < 0: + uname = win32api.GetDomainName() + "\\" + uname + group = "python_test_group" + # delete the group if it already exists + try: + win32net.NetLocalGroupDel(server, group) + print("WARNING: existing local group '%s' has been deleted.") + except win32net.error: + pass + group_data = {"name": group} + win32net.NetLocalGroupAdd(server, 1, group_data) + try: + u = {"domainandname": uname} + win32net.NetLocalGroupAddMembers(server, group, level, [u]) + mem, tot, res = win32net.NetLocalGroupGetMembers(server, group, level) + print("members are", mem) + if mem[0]["domainandname"] != uname: + print("ERROR: LocalGroup just added %s, but members are %r" % (uname, mem)) + # Convert the list of dicts to a list of strings. + win32net.NetLocalGroupDelMembers( + server, group, [m["domainandname"] for m in mem] + ) + finally: + win32net.NetLocalGroupDel(server, group) + print("Created a local group, added and removed members, then deleted the group") + + +def GetInfo(userName=None): + "Dumps level 3 information about the current user" + if userName is None: + userName = win32api.GetUserName() + print("Dumping level 3 information about user") + info = win32net.NetUserGetInfo(server, userName, 3) + for key, val in list(info.items()): + verbose("%s=%s" % (key, val)) + + +def SetInfo(userName=None): + "Attempts to change the current users comment, then set it back" + if userName is None: + userName = win32api.GetUserName() + oldData = win32net.NetUserGetInfo(server, userName, 3) + try: + d = oldData.copy() + d["usr_comment"] = "Test comment" + win32net.NetUserSetInfo(server, userName, 3, d) + new = win32net.NetUserGetInfo(server, userName, 3)["usr_comment"] + if str(new) != "Test comment": + raise RuntimeError("Could not read the same comment back - got %s" % new) + print("Changed the data for the user") + finally: + win32net.NetUserSetInfo(server, userName, 3, oldData) + + +def SetComputerInfo(): + "Doesnt actually change anything, just make sure we could ;-)" + info = win32net.NetWkstaGetInfo(None, 502) + # *sob* - but we can't! Why not!!! + # win32net.NetWkstaSetInfo(None, 502, info) + + +def usage(tests): + import os + + print("Usage: %s [-s server ] [-v] [Test ...]" % os.path.basename(sys.argv[0])) + print(" -v : Verbose - print more information") + print(" -s : server - execute the tests against the named server") + print(" -c : include the CreateUser test by default") + print("where Test is one of:") + for t in tests: + print(t.__name__, ":", t.__doc__) + print() + print("If not tests are specified, all tests are run") + sys.exit(1) + + +def main(): + tests = [] + for ob in list(globals().values()): + if type(ob) == type(main) and ob.__doc__: + tests.append(ob) + opts, args = getopt.getopt(sys.argv[1:], "s:hvc") + create_user = False + for opt, val in opts: + if opt == "-s": + global server + server = val + if opt == "-h": + usage(tests) + if opt == "-v": + global verbose_level + verbose_level = verbose_level + 1 + if opt == "-c": + create_user = True + + if len(args) == 0: + print("Running all tests - use '-h' to see command-line options...") + dotests = tests + if not create_user: + dotests.remove(CreateUser) + else: + dotests = [] + for arg in args: + for t in tests: + if t.__name__ == arg: + dotests.append(t) + break + else: + print("Test '%s' unknown - skipping" % arg) + if not len(dotests): + print("Nothing to do!") + usage(tests) + for test in dotests: + try: + test() + except: + print("Test %s failed" % test.__name__) + traceback.print_exc() + + +if __name__ == "__main__": + main() diff --git a/lib/win32/Demos/win32rcparser_demo.py b/lib/win32/Demos/win32rcparser_demo.py new file mode 100644 index 00000000..6a41d453 --- /dev/null +++ b/lib/win32/Demos/win32rcparser_demo.py @@ -0,0 +1,86 @@ +# A demo of the win32rcparser module and using win32gui + +import os + +import commctrl +import win32api +import win32con +import win32gui +import win32rcparser + +this_dir = os.path.abspath(os.path.dirname(__file__)) +g_rcname = os.path.abspath( + os.path.join(this_dir, "..", "test", "win32rcparser", "test.rc") +) + +if not os.path.isfile(g_rcname): + raise RuntimeError("Can't locate test.rc (should be at '%s')" % (g_rcname,)) + + +class DemoWindow: + def __init__(self, dlg_template): + self.dlg_template = dlg_template + + def CreateWindow(self): + self._DoCreate(win32gui.CreateDialogIndirect) + + def DoModal(self): + return self._DoCreate(win32gui.DialogBoxIndirect) + + def _DoCreate(self, fn): + message_map = { + win32con.WM_INITDIALOG: self.OnInitDialog, + win32con.WM_CLOSE: self.OnClose, + win32con.WM_DESTROY: self.OnDestroy, + win32con.WM_COMMAND: self.OnCommand, + } + return fn(0, self.dlg_template, 0, message_map) + + def OnInitDialog(self, hwnd, msg, wparam, lparam): + self.hwnd = hwnd + # centre the dialog + desktop = win32gui.GetDesktopWindow() + l, t, r, b = win32gui.GetWindowRect(self.hwnd) + dt_l, dt_t, dt_r, dt_b = win32gui.GetWindowRect(desktop) + centre_x, centre_y = win32gui.ClientToScreen( + desktop, ((dt_r - dt_l) // 2, (dt_b - dt_t) // 2) + ) + win32gui.MoveWindow( + hwnd, centre_x - (r // 2), centre_y - (b // 2), r - l, b - t, 0 + ) + + def OnCommand(self, hwnd, msg, wparam, lparam): + # Needed to make OK/Cancel work - no other controls are handled. + id = win32api.LOWORD(wparam) + if id in [win32con.IDOK, win32con.IDCANCEL]: + win32gui.EndDialog(hwnd, id) + + def OnClose(self, hwnd, msg, wparam, lparam): + win32gui.EndDialog(hwnd, 0) + + def OnDestroy(self, hwnd, msg, wparam, lparam): + pass + + +def DemoModal(): + # Load the .rc file. + resources = win32rcparser.Parse(g_rcname) + for id, ddef in resources.dialogs.items(): + print("Displaying dialog", id) + w = DemoWindow(ddef) + w.DoModal() + + +if __name__ == "__main__": + flags = 0 + for flag in """ICC_DATE_CLASSES ICC_ANIMATE_CLASS ICC_ANIMATE_CLASS + ICC_BAR_CLASSES ICC_COOL_CLASSES ICC_DATE_CLASSES + ICC_HOTKEY_CLASS ICC_INTERNET_CLASSES ICC_LISTVIEW_CLASSES + ICC_PAGESCROLLER_CLASS ICC_PROGRESS_CLASS ICC_TAB_CLASSES + ICC_TREEVIEW_CLASSES ICC_UPDOWN_CLASS ICC_USEREX_CLASSES + ICC_WIN95_CLASSES """.split(): + flags |= getattr(commctrl, flag) + win32gui.InitCommonControlsEx(flags) + # Need to do this go get rich-edit working. + win32api.LoadLibrary("riched20.dll") + DemoModal() diff --git a/lib/win32/Demos/win32servicedemo.py b/lib/win32/Demos/win32servicedemo.py new file mode 100644 index 00000000..75967ef3 --- /dev/null +++ b/lib/win32/Demos/win32servicedemo.py @@ -0,0 +1,23 @@ +import win32con +import win32service + + +def EnumServices(): + resume = 0 + accessSCM = win32con.GENERIC_READ + accessSrv = win32service.SC_MANAGER_ALL_ACCESS + + # Open Service Control Manager + hscm = win32service.OpenSCManager(None, None, accessSCM) + + # Enumerate Service Control Manager DB + + typeFilter = win32service.SERVICE_WIN32 + stateFilter = win32service.SERVICE_STATE_ALL + + statuses = win32service.EnumServicesStatus(hscm, typeFilter, stateFilter) + for short_name, desc, status in statuses: + print(short_name, desc, status) + + +EnumServices() diff --git a/lib/win32/Demos/win32ts_logoff_disconnected.py b/lib/win32/Demos/win32ts_logoff_disconnected.py new file mode 100644 index 00000000..be61e5d1 --- /dev/null +++ b/lib/win32/Demos/win32ts_logoff_disconnected.py @@ -0,0 +1,24 @@ +""" Finds any disconnected terminal service sessions and logs them off""" +import pywintypes +import win32ts +import winerror + +sessions = win32ts.WTSEnumerateSessions(win32ts.WTS_CURRENT_SERVER_HANDLE) +for session in sessions: + """ + WTS_CONNECTSTATE_CLASS: WTSActive,WTSConnected,WTSConnectQuery,WTSShadow,WTSDisconnected, + WTSIdle,WTSListen,WTSReset,WTSDown,WTSInit + """ + if session["State"] == win32ts.WTSDisconnected: + sessionid = session["SessionId"] + username = win32ts.WTSQuerySessionInformation( + win32ts.WTS_CURRENT_SERVER_HANDLE, sessionid, win32ts.WTSUserName + ) + print("Logging off disconnected user:", username) + try: + win32ts.WTSLogoffSession(win32ts.WTS_CURRENT_SERVER_HANDLE, sessionid, True) + except pywintypes.error as e: + if e.winerror == winerror.ERROR_ACCESS_DENIED: + print("Can't kill that session:", e.strerror) + else: + raise diff --git a/lib/win32/Demos/win32wnet/testwnet.py b/lib/win32/Demos/win32wnet/testwnet.py new file mode 100644 index 00000000..3b21ac29 --- /dev/null +++ b/lib/win32/Demos/win32wnet/testwnet.py @@ -0,0 +1,125 @@ +import os + +import win32api +import win32wnet +from winnetwk import * + +possible_shares = [] + + +def _doDumpHandle(handle, level=0): + indent = " " * level + while 1: + items = win32wnet.WNetEnumResource(handle, 0) + if len(items) == 0: + break + for item in items: + try: + if item.dwDisplayType == RESOURCEDISPLAYTYPE_SHARE: + print(indent + "Have share with name:", item.lpRemoteName) + possible_shares.append(item) + elif item.dwDisplayType == RESOURCEDISPLAYTYPE_GENERIC: + print( + indent + "Have generic resource with name:", item.lpRemoteName + ) + else: + # Try generic! + print(indent + "Enumerating " + item.lpRemoteName, end=" ") + k = win32wnet.WNetOpenEnum( + RESOURCE_GLOBALNET, RESOURCETYPE_ANY, 0, item + ) + print() + _doDumpHandle(k, level + 1) + win32wnet.WNetCloseEnum( + k + ) # could do k.Close(), but this is a good test! + except win32wnet.error as details: + print(indent + "Couldn't enumerate this resource: " + details.strerror) + + +def TestOpenEnum(): + print("Enumerating all resources on the network - this may take some time...") + handle = win32wnet.WNetOpenEnum(RESOURCE_GLOBALNET, RESOURCETYPE_ANY, 0, None) + + try: + _doDumpHandle(handle) + finally: + handle.Close() + print("Finished dumping all resources.") + + +def findUnusedDriveLetter(): + existing = [ + x[0].lower() for x in win32api.GetLogicalDriveStrings().split("\0") if x + ] + handle = win32wnet.WNetOpenEnum(RESOURCE_REMEMBERED, RESOURCETYPE_DISK, 0, None) + try: + while 1: + items = win32wnet.WNetEnumResource(handle, 0) + if len(items) == 0: + break + xtra = [i.lpLocalName[0].lower() for i in items if i.lpLocalName] + existing.extend(xtra) + finally: + handle.Close() + for maybe in "defghijklmnopqrstuvwxyz": + if maybe not in existing: + return maybe + raise RuntimeError("All drive mappings are taken?") + + +def TestConnection(): + if len(possible_shares) == 0: + print("Couldn't find any potential shares to connect to") + return + localName = findUnusedDriveLetter() + ":" + for share in possible_shares: + print("Attempting connection of", localName, "to", share.lpRemoteName) + try: + win32wnet.WNetAddConnection2(share.dwType, localName, share.lpRemoteName) + except win32wnet.error as details: + print("Couldn't connect: " + details.strerror) + continue + # Have a connection. + try: + fname = os.path.join(localName + "\\", os.listdir(localName + "\\")[0]) + try: + print( + "Universal name of '%s' is '%s'" + % (fname, win32wnet.WNetGetUniversalName(fname)) + ) + except win32wnet.error as details: + print( + "Couldn't get universal name of '%s': %s" + % (fname, details.strerror) + ) + print("User name for this connection is", win32wnet.WNetGetUser(localName)) + finally: + win32wnet.WNetCancelConnection2(localName, 0, 0) + # and do it again, but this time by using the more modern + # NETRESOURCE way. + nr = win32wnet.NETRESOURCE() + nr.dwType = share.dwType + nr.lpLocalName = localName + nr.lpRemoteName = share.lpRemoteName + win32wnet.WNetAddConnection2(nr) + win32wnet.WNetCancelConnection2(localName, 0, 0) + + # and one more time using WNetAddConnection3 + win32wnet.WNetAddConnection3(0, nr) + win32wnet.WNetCancelConnection2(localName, 0, 0) + + # Only do the first share that succeeds. + break + + +def TestGetUser(): + u = win32wnet.WNetGetUser() + print("Current global user is", repr(u)) + if u != win32wnet.WNetGetUser(None): + raise RuntimeError("Default value didnt seem to work!") + + +TestGetUser() +TestOpenEnum() +TestConnection() diff --git a/lib/win32/Demos/win32wnet/winnetwk.py b/lib/win32/Demos/win32wnet/winnetwk.py new file mode 100644 index 00000000..036e2ebf --- /dev/null +++ b/lib/win32/Demos/win32wnet/winnetwk.py @@ -0,0 +1,100 @@ +# Generated by h2py from d:\mssdk\include\winnetwk.h +WNNC_NET_MSNET = 0x00010000 +WNNC_NET_LANMAN = 0x00020000 +WNNC_NET_NETWARE = 0x00030000 +WNNC_NET_VINES = 0x00040000 +WNNC_NET_10NET = 0x00050000 +WNNC_NET_LOCUS = 0x00060000 +WNNC_NET_SUN_PC_NFS = 0x00070000 +WNNC_NET_LANSTEP = 0x00080000 +WNNC_NET_9TILES = 0x00090000 +WNNC_NET_LANTASTIC = 0x000A0000 +WNNC_NET_AS400 = 0x000B0000 +WNNC_NET_FTP_NFS = 0x000C0000 +WNNC_NET_PATHWORKS = 0x000D0000 +WNNC_NET_LIFENET = 0x000E0000 +WNNC_NET_POWERLAN = 0x000F0000 +WNNC_NET_BWNFS = 0x00100000 +WNNC_NET_COGENT = 0x00110000 +WNNC_NET_FARALLON = 0x00120000 +WNNC_NET_APPLETALK = 0x00130000 +WNNC_NET_INTERGRAPH = 0x00140000 +WNNC_NET_SYMFONET = 0x00150000 +WNNC_NET_CLEARCASE = 0x00160000 +WNNC_NET_FRONTIER = 0x00170000 +WNNC_NET_BMC = 0x00180000 +WNNC_NET_DCE = 0x00190000 +WNNC_NET_DECORB = 0x00200000 +WNNC_NET_PROTSTOR = 0x00210000 +WNNC_NET_FJ_REDIR = 0x00220000 +WNNC_NET_DISTINCT = 0x00230000 +WNNC_NET_TWINS = 0x00240000 +WNNC_NET_RDR2SAMPLE = 0x00250000 +RESOURCE_CONNECTED = 0x00000001 +RESOURCE_GLOBALNET = 0x00000002 +RESOURCE_REMEMBERED = 0x00000003 +RESOURCE_RECENT = 0x00000004 +RESOURCE_CONTEXT = 0x00000005 +RESOURCETYPE_ANY = 0x00000000 +RESOURCETYPE_DISK = 0x00000001 +RESOURCETYPE_PRINT = 0x00000002 +RESOURCETYPE_RESERVED = 0x00000008 +RESOURCETYPE_UNKNOWN = 0xFFFFFFFF +RESOURCEUSAGE_CONNECTABLE = 0x00000001 +RESOURCEUSAGE_CONTAINER = 0x00000002 +RESOURCEUSAGE_NOLOCALDEVICE = 0x00000004 +RESOURCEUSAGE_SIBLING = 0x00000008 +RESOURCEUSAGE_ATTACHED = 0x00000010 +RESOURCEUSAGE_ALL = ( + RESOURCEUSAGE_CONNECTABLE | RESOURCEUSAGE_CONTAINER | RESOURCEUSAGE_ATTACHED +) +RESOURCEUSAGE_RESERVED = 0x80000000 +RESOURCEDISPLAYTYPE_GENERIC = 0x00000000 +RESOURCEDISPLAYTYPE_DOMAIN = 0x00000001 +RESOURCEDISPLAYTYPE_SERVER = 0x00000002 +RESOURCEDISPLAYTYPE_SHARE = 0x00000003 +RESOURCEDISPLAYTYPE_FILE = 0x00000004 +RESOURCEDISPLAYTYPE_GROUP = 0x00000005 +RESOURCEDISPLAYTYPE_NETWORK = 0x00000006 +RESOURCEDISPLAYTYPE_ROOT = 0x00000007 +RESOURCEDISPLAYTYPE_SHAREADMIN = 0x00000008 +RESOURCEDISPLAYTYPE_DIRECTORY = 0x00000009 +RESOURCEDISPLAYTYPE_TREE = 0x0000000A +RESOURCEDISPLAYTYPE_NDSCONTAINER = 0x0000000B +NETPROPERTY_PERSISTENT = 1 +CONNECT_UPDATE_PROFILE = 0x00000001 +CONNECT_UPDATE_RECENT = 0x00000002 +CONNECT_TEMPORARY = 0x00000004 +CONNECT_INTERACTIVE = 0x00000008 +CONNECT_PROMPT = 0x00000010 +CONNECT_NEED_DRIVE = 0x00000020 +CONNECT_REFCOUNT = 0x00000040 +CONNECT_REDIRECT = 0x00000080 +CONNECT_LOCALDRIVE = 0x00000100 +CONNECT_CURRENT_MEDIA = 0x00000200 +CONNECT_DEFERRED = 0x00000400 +CONNECT_RESERVED = 0xFF000000 +CONNDLG_RO_PATH = 0x00000001 +CONNDLG_CONN_POINT = 0x00000002 +CONNDLG_USE_MRU = 0x00000004 +CONNDLG_HIDE_BOX = 0x00000008 +CONNDLG_PERSIST = 0x00000010 +CONNDLG_NOT_PERSIST = 0x00000020 +DISC_UPDATE_PROFILE = 0x00000001 +DISC_NO_FORCE = 0x00000040 +UNIVERSAL_NAME_INFO_LEVEL = 0x00000001 +REMOTE_NAME_INFO_LEVEL = 0x00000002 +WNFMT_MULTILINE = 0x01 +WNFMT_ABBREVIATED = 0x02 +WNFMT_INENUM = 0x10 +WNFMT_CONNECTION = 0x20 +NETINFO_DLL16 = 0x00000001 +NETINFO_DISKRED = 0x00000004 +NETINFO_PRINTERRED = 0x00000008 +RP_LOGON = 0x01 +RP_INIFILE = 0x02 +PP_DISPLAYERRORS = 0x01 +WNCON_FORNETCARD = 0x00000001 +WNCON_NOTROUTED = 0x00000002 +WNCON_SLOWLINK = 0x00000004 +WNCON_DYNAMIC = 0x00000008 diff --git a/lib/win32/Demos/winprocess.py b/lib/win32/Demos/winprocess.py new file mode 100644 index 00000000..48f6fe71 --- /dev/null +++ b/lib/win32/Demos/winprocess.py @@ -0,0 +1,230 @@ +""" +Windows Process Control + +winprocess.run launches a child process and returns the exit code. +Optionally, it can: + redirect stdin, stdout & stderr to files + run the command as another user + limit the process's running time + control the process window (location, size, window state, desktop) +Works on Windows NT, 2000 & XP. Requires Mark Hammond's win32 +extensions. + +This code is free for any purpose, with no warranty of any kind. +-- John B. Dell'Aquila +""" + +import msvcrt +import os + +import win32api +import win32con +import win32event +import win32gui +import win32process +import win32security + + +def logonUser(loginString): + """ + Login as specified user and return handle. + loginString: 'Domain\nUser\nPassword'; for local + login use . or empty string as domain + e.g. '.\nadministrator\nsecret_password' + """ + domain, user, passwd = loginString.split("\n") + return win32security.LogonUser( + user, + domain, + passwd, + win32con.LOGON32_LOGON_INTERACTIVE, + win32con.LOGON32_PROVIDER_DEFAULT, + ) + + +class Process: + """ + A Windows process. + """ + + def __init__( + self, + cmd, + login=None, + hStdin=None, + hStdout=None, + hStderr=None, + show=1, + xy=None, + xySize=None, + desktop=None, + ): + """ + Create a Windows process. + cmd: command to run + login: run as user 'Domain\nUser\nPassword' + hStdin, hStdout, hStderr: + handles for process I/O; default is caller's stdin, + stdout & stderr + show: wShowWindow (0=SW_HIDE, 1=SW_NORMAL, ...) + xy: window offset (x, y) of upper left corner in pixels + xySize: window size (width, height) in pixels + desktop: lpDesktop - name of desktop e.g. 'winsta0\\default' + None = inherit current desktop + '' = create new desktop if necessary + + User calling login requires additional privileges: + Act as part of the operating system [not needed on Windows XP] + Increase quotas + Replace a process level token + Login string must EITHER be an administrator's account + (ordinary user can't access current desktop - see Microsoft + Q165194) OR use desktop='' to run another desktop invisibly + (may be very slow to startup & finalize). + """ + si = win32process.STARTUPINFO() + si.dwFlags = win32con.STARTF_USESTDHANDLES ^ win32con.STARTF_USESHOWWINDOW + if hStdin is None: + si.hStdInput = win32api.GetStdHandle(win32api.STD_INPUT_HANDLE) + else: + si.hStdInput = hStdin + if hStdout is None: + si.hStdOutput = win32api.GetStdHandle(win32api.STD_OUTPUT_HANDLE) + else: + si.hStdOutput = hStdout + if hStderr is None: + si.hStdError = win32api.GetStdHandle(win32api.STD_ERROR_HANDLE) + else: + si.hStdError = hStderr + si.wShowWindow = show + if xy is not None: + si.dwX, si.dwY = xy + si.dwFlags ^= win32con.STARTF_USEPOSITION + if xySize is not None: + si.dwXSize, si.dwYSize = xySize + si.dwFlags ^= win32con.STARTF_USESIZE + if desktop is not None: + si.lpDesktop = desktop + procArgs = ( + None, # appName + cmd, # commandLine + None, # processAttributes + None, # threadAttributes + 1, # bInheritHandles + win32process.CREATE_NEW_CONSOLE, # dwCreationFlags + None, # newEnvironment + None, # currentDirectory + si, + ) # startupinfo + if login is not None: + hUser = logonUser(login) + win32security.ImpersonateLoggedOnUser(hUser) + procHandles = win32process.CreateProcessAsUser(hUser, *procArgs) + win32security.RevertToSelf() + else: + procHandles = win32process.CreateProcess(*procArgs) + self.hProcess, self.hThread, self.PId, self.TId = procHandles + + def wait(self, mSec=None): + """ + Wait for process to finish or for specified number of + milliseconds to elapse. + """ + if mSec is None: + mSec = win32event.INFINITE + return win32event.WaitForSingleObject(self.hProcess, mSec) + + def kill(self, gracePeriod=5000): + """ + Kill process. Try for an orderly shutdown via WM_CLOSE. If + still running after gracePeriod (5 sec. default), terminate. + """ + win32gui.EnumWindows(self.__close__, 0) + if self.wait(gracePeriod) != win32event.WAIT_OBJECT_0: + win32process.TerminateProcess(self.hProcess, 0) + win32api.Sleep(100) # wait for resources to be released + + def __close__(self, hwnd, dummy): + """ + EnumWindows callback - sends WM_CLOSE to any window + owned by this process. + """ + TId, PId = win32process.GetWindowThreadProcessId(hwnd) + if PId == self.PId: + win32gui.PostMessage(hwnd, win32con.WM_CLOSE, 0, 0) + + def exitCode(self): + """ + Return process exit code. + """ + return win32process.GetExitCodeProcess(self.hProcess) + + +def run(cmd, mSec=None, stdin=None, stdout=None, stderr=None, **kw): + """ + Run cmd as a child process and return exit code. + mSec: terminate cmd after specified number of milliseconds + stdin, stdout, stderr: + file objects for child I/O (use hStdin etc. to attach + handles instead of files); default is caller's stdin, + stdout & stderr; + kw: see Process.__init__ for more keyword options + """ + if stdin is not None: + kw["hStdin"] = msvcrt.get_osfhandle(stdin.fileno()) + if stdout is not None: + kw["hStdout"] = msvcrt.get_osfhandle(stdout.fileno()) + if stderr is not None: + kw["hStderr"] = msvcrt.get_osfhandle(stderr.fileno()) + child = Process(cmd, **kw) + if child.wait(mSec) != win32event.WAIT_OBJECT_0: + child.kill() + raise WindowsError("process timeout exceeded") + return child.exitCode() + + +if __name__ == "__main__": + # Pipe commands to a shell and display the output in notepad + print("Testing winprocess.py...") + + import tempfile + + timeoutSeconds = 15 + cmdString = ( + """\ +REM Test of winprocess.py piping commands to a shell.\r +REM This 'notepad' process will terminate in %d seconds.\r +vol\r +net user\r +_this_is_a_test_of_stderr_\r +""" + % timeoutSeconds + ) + + cmd_name = tempfile.mktemp() + out_name = cmd_name + ".txt" + try: + cmd = open(cmd_name, "w+b") + out = open(out_name, "w+b") + cmd.write(cmdString.encode("mbcs")) + cmd.seek(0) + print( + "CMD.EXE exit code:", + run("cmd.exe", show=0, stdin=cmd, stdout=out, stderr=out), + ) + cmd.close() + print( + "NOTEPAD exit code:", + run( + "notepad.exe %s" % out.name, + show=win32con.SW_MAXIMIZE, + mSec=timeoutSeconds * 1000, + ), + ) + out.close() + finally: + for n in (cmd_name, out_name): + try: + os.unlink(cmd_name) + except os.error: + pass diff --git a/lib/win32/include/PyWinTypes.h b/lib/win32/include/PyWinTypes.h new file mode 100644 index 00000000..edfdb0b6 --- /dev/null +++ b/lib/win32/include/PyWinTypes.h @@ -0,0 +1,727 @@ + +#ifndef __PYWINTYPES_H__ +#define __PYWINTYPES_H__ + +// If building under a GCC, tweak what we need. +#if defined(__GNUC__) && defined(_POSIX_C_SOURCE) +// python.h complains if _POSIX_C_SOURCE is already defined +#undef _POSIX_C_SOURCE +#endif + +// windows rpc.h defines "small" as "char" which breaks Python's accu.h, +// so we undefine it before including python. +#ifdef small +#undef small +#endif + +#include "Python.h" +#include "structmember.h" +#include "windows.h" + +// Helpers for our modules. +// Some macros to help the pywin32 modules co-exist in py2x and py3k. +// Creates and initializes local variables called 'module' and 'dict'. + +// Maybe these should all be removed - they existed to help in the py2->3 +// transition. +// On one hand: the code would be cleaner if they were all just re-inlined? +// On the other: high confidence everything uses the exact same patterns? +// (Regardless, *some*, eg, PYWIN_MODULE_INIT_RETURN_* should be re-inlined!) + +// Use to define the function itself (ie, its name, linkage, params) +#define PYWIN_MODULE_INIT_FUNC(module_name) extern "C" __declspec(dllexport) PyObject *PyInit_##module_name(void) + +// If the module needs to early-exit on an error condition. +#define PYWIN_MODULE_INIT_RETURN_ERROR return NULL; + +// When the module has successfully initialized. +#define PYWIN_MODULE_INIT_RETURN_SUCCESS return module; + +// To setup the module object itself and the module's dictionary. +#define PYWIN_MODULE_INIT_PREPARE(module_name, functions, docstring) \ + PyObject *dict, *module; \ + static PyModuleDef module_name##_def = {PyModuleDef_HEAD_INIT, #module_name, docstring, -1, functions}; \ + if (PyWinGlobals_Ensure() == -1) \ + return NULL; \ + if (!(module = PyModule_Create(&module_name##_def))) \ + return NULL; \ + if (!(dict = PyModule_GetDict(module))) \ + return NULL; + +// Helpers for our types. +// Macro to handle PyObject layout changes in Py3k +#define PYWIN_OBJECT_HEAD PyVarObject_HEAD_INIT(NULL, 0) + +/* Attribute names are passed as Unicode in Py3k, so use a macro to + switch between string and unicode conversion. This function is not + documented, but is used extensively in the Python codebase itself, + so it's reasonable to assume it won't disappear anytime soon. +*/ +#define PYWIN_ATTR_CONVERT (char *)_PyUnicode_AsString + +typedef Py_ssize_t Py_hash_t; + +// This only enables runtime checks in debug builds - so we use +// our own so we can enable it always should we desire... +#define PyWin_SAFE_DOWNCAST Py_SAFE_DOWNCAST + +// Lars: for WAVEFORMATEX +#include "mmsystem.h" + +#ifdef BUILD_PYWINTYPES +/* We are building pywintypesxx.dll */ +#define PYWINTYPES_EXPORT __declspec(dllexport) +#else +/* This module uses pywintypesxx.dll */ +#define PYWINTYPES_EXPORT __declspec(dllimport) +#if defined(_MSC_VER) +#if defined(DEBUG) || defined(_DEBUG) +#pragma comment(lib, "pywintypes_d.lib") +#else +#pragma comment(lib, "pywintypes.lib") +#endif // DEBUG/_DEBUG +#endif // _MSC_VER +#endif // BUILD_PYWINTYPES + +// Py3k uses memoryview object in place of buffer, and we don't yet. +extern PYWINTYPES_EXPORT PyObject *PyBuffer_New(Py_ssize_t size); +extern PYWINTYPES_EXPORT PyObject *PyBuffer_FromMemory(void *buf, Py_ssize_t size); + +// Formats a python traceback into a character string - result must be free()ed +PYWINTYPES_EXPORT WCHAR *GetPythonTraceback(PyObject *exc_type, PyObject *exc_value, PyObject *exc_tb); + +#include +/* +** Error/Exception handling +*/ +extern PYWINTYPES_EXPORT PyObject *PyWinExc_ApiError; +// Register a Windows DLL that contains the messages in the specified range. +extern PYWINTYPES_EXPORT BOOL PyWin_RegisterErrorMessageModule(DWORD first, DWORD last, HINSTANCE hmod); +// Get the previously registered hmodule for an error code. +extern PYWINTYPES_EXPORT HINSTANCE PyWin_GetErrorMessageModule(DWORD err); + +/* A global function that sets an API style error (ie, (code, fn, errTest)) */ +PYWINTYPES_EXPORT PyObject *PyWin_SetAPIError(char *fnName, long err = 0); + +/* Basic COM Exception handling. The main COM exception object + is actually defined here. However, the most useful functions + for raising the exception are still in the COM package. Therefore, + you can use the fn below to raise a basic COM exception - no fancy error + messages available, just the HRESULT. It will, however, _be_ a COM + exception, and therefore trappable like any other COM exception +*/ +extern PYWINTYPES_EXPORT PyObject *PyWinExc_COMError; +PYWINTYPES_EXPORT PyObject *PyWin_SetBasicCOMError(HRESULT hr); + +// ************* +// strings, which are a bit of a mess! +// +// This has gone from 2.x ascii-only, to 2.x+3.x ascii-or-unicode, to 3.x unicode-only, +// - this baggage means some strange APIs which convert to and from "char *" in various ways. +// +// A sizes/lengths are reported as a `DWORD` rather than a `Py_ssize_t`, that's what the callers +// need. `Py_ssize_t` used as the "in" type. +// (We also use this for UINT and ULONG, all of which are 32bit unsigned ints.) + +// Sometimes we need to downcast from a ssize_t to a DWORD +inline bool PyWin_is_ssize_dword(Py_ssize_t val) { + return val <= MAXDWORD; +} + +#define PYWIN_CHECK_SSIZE_DWORD(val, failResult) \ + if (!PyWin_is_ssize_dword(val)) { \ + PyErr_SetString(PyExc_ValueError, "value is larger than a DWORD"); \ + return failResult; \ + } + +// Almost all of these are roughly identical! But start with BSTR +// Given a PyObject (string, Unicode, etc) create a "BSTR" with the value +PYWINTYPES_EXPORT BOOL PyWinObject_AsBstr(PyObject *stringObject, BSTR *pResult, BOOL bNoneOK = FALSE, + DWORD *pResultLen = NULL); +// And free it when finished. +PYWINTYPES_EXPORT void PyWinObject_FreeBstr(BSTR pResult); + +PYWINTYPES_EXPORT PyObject *PyWinObject_FromBstr(const BSTR bstr, BOOL takeOwnership = FALSE); + +// Given a string or Unicode object, get WCHAR characters. +PYWINTYPES_EXPORT BOOL PyWinObject_AsWCHAR(PyObject *stringObject, WCHAR **pResult, BOOL bNoneOK = FALSE, + DWORD *pResultLen = NULL); +// And free it when finished. +PYWINTYPES_EXPORT void PyWinObject_FreeWCHAR(WCHAR *pResult); + +inline BOOL PyWinObject_AsWCHAR(PyObject *stringObject, unsigned short **pResult, BOOL bNoneOK = FALSE, + DWORD *pResultLen = NULL) +{ + return PyWinObject_AsWCHAR(stringObject, (WCHAR **)pResult, bNoneOK, pResultLen); +} +inline void PyWinObject_FreeWCHAR(unsigned short *pResult) { PyWinObject_FreeWCHAR((WCHAR *)pResult); } + +// A bit unfortunate, but used when we logically want a "string" but only have +// a "char *" to put it in. +// * accepts bytes but boesn't try to accept buffer-like objects. +// * accepts unicode objects and converts via the code-page. +PYWINTYPES_EXPORT BOOL PyWinObject_AsChars(PyObject *stringObject, char **pResult, BOOL bNoneOK = FALSE, + DWORD *pResultLen = NULL); +// And free it when finished. +PYWINTYPES_EXPORT void PyWinObject_FreeChars(char *pResult); + +// Automatically freed WCHAR that can be used anywhere WCHAR * is required +class TmpWCHAR { + public: + WCHAR *tmp; // (NULL after conversion error) + Py_ssize_t length; // only set after successful auto-conversion; w/o trailing \0 + PyObject *u; // auxiliary slot for u2w() + + TmpWCHAR() { tmp = NULL; } + TmpWCHAR(WCHAR *t) { tmp = t; } + TmpWCHAR(PyObject *ob) : tmp(NULL) { *this = ob; } + WCHAR *u2w() { return *this = u; } + WCHAR *operator=(PyObject *ob) { + if (tmp) + PyMem_Free(tmp); + if (ob == NULL) + tmp = NULL; // (exception already has been set in this case) + else + tmp = PyUnicode_AsWideCharString(ob, &length); + return tmp; + } + WCHAR *operator=(WCHAR *t) + { + if (tmp) + PyMem_Free(tmp); + tmp = t; + return t; + } + WCHAR **operator&() { return &tmp; } + boolean operator==(WCHAR *t) { return tmp == t; } + operator WCHAR *() { return tmp; } + ~TmpWCHAR() { if (tmp) PyMem_Free(tmp); } + private: + // Block unwanted copy construction + TmpWCHAR(const TmpWCHAR& o); // = delete; + const TmpWCHAR& operator=(const TmpWCHAR& o); // = delete; +}; + +// More string helpers - how many do we need? +// A couple which should die or be modernized and have some `char *` vs `wchar_t *` confusion. +PYWINTYPES_EXPORT PyObject *PyWinCoreString_FromString(const char *str, Py_ssize_t len = (Py_ssize_t)-1); +PYWINTYPES_EXPORT PyObject *PyWinCoreString_FromString(const WCHAR *str, Py_ssize_t len = (Py_ssize_t)-1); + +#define PyWinObject_FromWCHAR PyWinObject_FromOLECHAR + +PYWINTYPES_EXPORT PyObject *PyWinObject_FromOLECHAR(const OLECHAR *str); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromOLECHAR(const OLECHAR *str, Py_ssize_t numChars); + +#define PyWinObject_AsTCHAR PyWinObject_AsWCHAR +#define PyWinObject_FreeTCHAR PyWinObject_FreeWCHAR +#define PyWinObject_FromTCHAR PyWinObject_FromOLECHAR + +// String support for buffers allocated via CoTaskMemAlloc and CoTaskMemFree +PYWINTYPES_EXPORT BOOL PyWinObject_AsTaskAllocatedWCHAR(PyObject *stringObject, WCHAR **ppResult, BOOL bNoneOK = FALSE); +PYWINTYPES_EXPORT void PyWinObject_FreeTaskAllocatedWCHAR(WCHAR *str); + +// Copy null terminated string with same allocator as PyWinObject_AsWCHAR, etc +// ? wot? +PYWINTYPES_EXPORT WCHAR *PyWin_CopyString(const WCHAR *input); +PYWINTYPES_EXPORT char *PyWin_CopyString(const char *input); + +// Some helpers for arrays of strings. +// +// Converts a series of consecutive null terminated strings into a list +// ??? wot? +PYWINTYPES_EXPORT PyObject *PyWinObject_FromMultipleString(WCHAR *multistring); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromMultipleString(char *multistring); +// Converts a sequence of str/unicode objects into a series of consecutive null-terminated +// wide character strings with extra terminating null +PYWINTYPES_EXPORT BOOL PyWinObject_AsMultipleString(PyObject *ob, WCHAR **pmultistring, BOOL bNoneOK = TRUE, + DWORD *chars_returned = NULL); +PYWINTYPES_EXPORT void PyWinObject_FreeMultipleString(WCHAR *pmultistring); + +// Convert a sequence of strings to an array of WCHAR pointers +PYWINTYPES_EXPORT void PyWinObject_FreeWCHARArray(LPWSTR *wchars, DWORD str_cnt); +PYWINTYPES_EXPORT BOOL PyWinObject_AsWCHARArray(PyObject *str_seq, LPWSTR **wchars, DWORD *str_cnt, + BOOL bNoneOK = FALSE); + +// Convert a sequence of string or unicode objects to an array of char * +PYWINTYPES_EXPORT void PyWinObject_FreeCharArray(char **pchars, DWORD str_cnt); +PYWINTYPES_EXPORT BOOL PyWinObject_AsCharArray(PyObject *str_seq, char ***pchars, DWORD *str_cnt, BOOL bNoneOK = FALSE); + +// Bytes/Buffer helpers. +// replacement for PyWinObject_AsReadBuffer and PyWinObject_AsWriteBuffer +class PYWINTYPES_EXPORT PyWinBufferView +{ +public: + PyWinBufferView() { m_view.obj = NULL; } + PyWinBufferView(PyObject *ob, bool bWrite = false, bool bNoneOk = false) { + m_view.obj = NULL; + init(ob, bWrite, bNoneOk); + } + ~PyWinBufferView() { release(); } + bool init(PyObject *ob, bool bWrite = false, bool bNoneOk = false); + void release() { + if (m_view.obj != NULL && m_view.obj != Py_None) { + PyBuffer_Release(&m_view); // sets view->obj = NULL + } + } + bool ok() { return m_view.obj != NULL; } + void* ptr() { return m_view.buf; } + DWORD len() { return static_cast(m_view.len); } + +private: + Py_buffer m_view; + + // don't copy objects and don't use C++ >= 11 -> not implemented private + // copy ctor and assignment operator + PyWinBufferView(const PyWinBufferView& src); + PyWinBufferView& operator=(PyWinBufferView const &); +}; + + +// For 64-bit python compatibility, convert sequence to tuple and check length fits in a DWORD +PYWINTYPES_EXPORT PyObject *PyWinSequence_Tuple(PyObject *obseq, DWORD *len); + +// Pointers. +// Substitute for Python's inconsistent PyLong_AsVoidPtr +PYWINTYPES_EXPORT BOOL PyWinLong_AsVoidPtr(PyObject *ob, void **pptr); +PYWINTYPES_EXPORT PyObject *PyWinLong_FromVoidPtr(const void *ptr); + +/* +** LARGE_INTEGER objects +*/ +// AsLARGE_INTEGER takes either int or long +PYWINTYPES_EXPORT BOOL PyWinObject_AsLARGE_INTEGER(PyObject *ob, LARGE_INTEGER *pResult); +PYWINTYPES_EXPORT BOOL PyWinObject_AsULARGE_INTEGER(PyObject *ob, ULARGE_INTEGER *pResult); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromLARGE_INTEGER(const LARGE_INTEGER &val); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromULARGE_INTEGER(const ULARGE_INTEGER &val); +// Helpers that take a Py_LONG_LONG, but (a) have pywin32 consistent signatures +// and (b) handle int *and* long (where Python only starts doing that in the +// PyLong_* APIs post 2.4) +// We also happen to know a LARGE_INTEGER is an __int64, so do it the easy way +#define PyWinObject_AsPY_LONG_LONG(ob, pResult) PyWinObject_AsLARGE_INTEGER((ob), (LARGE_INTEGER *)(pResult)) +#define PyWinObject_AsUPY_LONG_LONG(ob, pResult) PyWinObject_AsULARGE_INTEGER((ob), (ULARGE_INTEGER *)(pResult)) +#define PyWinObject_FromPY_LONG_LONG(val) PyWinObject_FromLARGE_INTEGER((LARGE_INTEGER)val) +#define PyWinObject_FromUPY_LONG_LONG(val) PyWinObject_FromULARGE_INTEGER((ULARGE_INTEGER)val) + +// A DWORD_PTR and ULONG_PTR appear to mean "integer long enough to hold a pointer" +// It is *not* actually a pointer (but is the same size as a pointer) +inline PyObject *PyWinObject_FromULONG_PTR(ULONG_PTR v) { return PyWinLong_FromVoidPtr((void *)v); } +inline BOOL PyWinLong_AsULONG_PTR(PyObject *ob, ULONG_PTR *r) { return PyWinLong_AsVoidPtr(ob, (void **)r); } + +inline PyObject *PyWinObject_FromDWORD_PTR(DWORD_PTR v) { return PyLong_FromVoidPtr((void *)v); } +inline BOOL PyWinLong_AsDWORD_PTR(PyObject *ob, DWORD_PTR *r) { return PyWinLong_AsVoidPtr(ob, (void **)r); } + +/* +** OVERLAPPED Object and API +*/ +class PyOVERLAPPED; // forward declare +extern PYWINTYPES_EXPORT PyTypeObject PyOVERLAPPEDType; // the Type for PyOVERLAPPED +#define PyOVERLAPPED_Check(ob) ((ob)->ob_type == &PyOVERLAPPEDType) +PYWINTYPES_EXPORT BOOL PyWinObject_AsOVERLAPPED(PyObject *ob, OVERLAPPED **ppOverlapped, BOOL bNoneOK = TRUE); +PYWINTYPES_EXPORT BOOL PyWinObject_AsPyOVERLAPPED(PyObject *ob, PyOVERLAPPED **ppOverlapped, BOOL bNoneOK = TRUE); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromOVERLAPPED(const OVERLAPPED *pOverlapped); + +// A global function that can work as a module method for making an OVERLAPPED object. +PYWINTYPES_EXPORT PyObject *PyWinMethod_NewOVERLAPPED(PyObject *self, PyObject *args); + +#ifndef NO_PYWINTYPES_IID +/* +** IID/GUID support +*/ + +extern PYWINTYPES_EXPORT PyTypeObject PyIIDType; // the Type for PyIID +#define PyIID_Check(ob) ((ob)->ob_type == &PyIIDType) + +// Given an object repring a CLSID (either PyIID or string), fill the CLSID. +PYWINTYPES_EXPORT BOOL PyWinObject_AsIID(PyObject *obCLSID, CLSID *clsid); + +// return a native PyIID object representing an IID +PYWINTYPES_EXPORT PyObject *PyWinObject_FromIID(const IID &riid); + +// return a string/Unicode object representing an IID +PYWINTYPES_EXPORT PyObject *PyWinCoreString_FromIID(const IID &riid); + +// A global function that can work as a module method for making an IID object. +PYWINTYPES_EXPORT PyObject *PyWinMethod_NewIID(PyObject *self, PyObject *args); +#endif /*NO_PYWINTYPES_IID */ + +/* +** TIME support +** +** We use a subclass of the builtin datetime. +*/ + +PYWINTYPES_EXPORT PyObject *PyWinObject_FromSYSTEMTIME(const SYSTEMTIME &t); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromFILETIME(const FILETIME &t); + +// Converts a TimeStamp, which is in 100 nanosecond units like a FILETIME +// TimeStamp is actually defined as a LARGE_INTEGER, so this function will also +// accept Windows security "TimeStamp" objects directly - however, we use a +// LARGE_INTEGER prototype to avoid pulling in the windows security headers. +PYWINTYPES_EXPORT PyObject *PyWinObject_FromTimeStamp(const LARGE_INTEGER &t); +PYWINTYPES_EXPORT PyObject *PyWinTimeObject_Fromtime_t(time_t t); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromDATE(DATE t); + +PYWINTYPES_EXPORT BOOL PyWinObject_AsDATE(PyObject *ob, DATE *pDate); +PYWINTYPES_EXPORT BOOL PyWinObject_AsFILETIME(PyObject *ob, FILETIME *pDate); +PYWINTYPES_EXPORT BOOL PyWinObject_AsSYSTEMTIME(PyObject *ob, SYSTEMTIME *pDate); + +// A global function that can work as a module method for making a time object. +PYWINTYPES_EXPORT PyObject *PyWinMethod_NewTime(PyObject *self, PyObject *args); +PYWINTYPES_EXPORT PyObject *PyWinMethod_NewTimeStamp(PyObject *self, PyObject *args); + +PYWINTYPES_EXPORT BOOL PyWinTime_Check(PyObject *ob); + +// functions to return WIN32_FIND_DATA tuples, used in shell, win32api, and win32file +PYWINTYPES_EXPORT PyObject *PyObject_FromWIN32_FIND_DATAW(WIN32_FIND_DATAW *pData); +#define PyObject_FromWIN32_FIND_DATA PyObject_FromWIN32_FIND_DATAW + +// POINT tuple, used in win32api_display.cpp and win32gui.i +PYWINTYPES_EXPORT BOOL PyWinObject_AsPOINT(PyObject *obpoint, LPPOINT ppoint); + +// IO_COUNTERS dict, used in win32process and win32job +PYWINTYPES_EXPORT PyObject *PyWinObject_FromIO_COUNTERS(PIO_COUNTERS pioc); + +// Make an array of DWORD's from a sequence of Python ints +PYWINTYPES_EXPORT BOOL PyWinObject_AsDWORDArray(PyObject *obdwords, DWORD **pdwords, DWORD *item_cnt, + BOOL bNoneOk = TRUE); + +// Conversion for resource id/name and class atom +PYWINTYPES_EXPORT BOOL PyWinObject_AsResourceIdA(PyObject *ob, char **presource_id, BOOL bNoneOK = FALSE); +PYWINTYPES_EXPORT void PyWinObject_FreeResourceIdA(char *resource_id); + +PYWINTYPES_EXPORT BOOL PyWinObject_AsResourceId(PyObject *ob, WCHAR **presource_id, BOOL bNoneOK = FALSE); +PYWINTYPES_EXPORT void PyWinObject_FreeResourceId(WCHAR *resource_id); + +// WPARAM and LPARAM conversion. +// Auto-freed WPARAM / LPARAM which ensure any memory referenced remains valid when a String or +// Buffer object is used. Make sure the destructor is called with the GIL held. +class PyWin_PARAMHolder { + protected: + WPARAM _pa; + // Holds *either* a PyWinBufferView (which will auto-free) *or* a "void *" that we + // will auto-free. + void *_pymem; + void _free() { + if (_pymem) { + PyMem_Free(_pymem); + _pymem = NULL; + } + } + public: + PyWinBufferView bufferView; + + PyWin_PARAMHolder(WPARAM t=0):_pa(t),_pymem(NULL) {} + ~PyWin_PARAMHolder() { + _free(); + } + WCHAR *set_allocated(WCHAR *t) { + assert(!bufferView.ok()); // should be one or the other. + _free(); + _pymem = t; + _pa = (WPARAM)t; + return t; + } + // When init_buffer() fails, an appropriate Python error has been set too + bool init_buffer(PyObject *ob) { + assert(!_pymem); // should be one or the other! + _free(); + if (!bufferView.init(ob)) { + return false; + } + _pa = (WPARAM)bufferView.ptr(); + return true; + } + + WPARAM operator=(WPARAM t) { + return _pa = t; + } + operator WPARAM() { return _pa; } + operator LPARAM() { return (LPARAM)_pa; } +}; + +PYWINTYPES_EXPORT BOOL PyWinObject_AsPARAM(PyObject *ob, PyWin_PARAMHolder *pparam); +inline PyObject *PyWinObject_FromPARAM(WPARAM param) { return PyWinObject_FromULONG_PTR(param); } +inline PyObject *PyWinObject_FromPARAM(LPARAM param) { return PyWinObject_FromULONG_PTR(param); } + +PYWINTYPES_EXPORT BOOL PyWinObject_AsSimplePARAM(PyObject *ob, WPARAM *pparam); +inline BOOL PyWinObject_AsSimplePARAM(PyObject *ob, LPARAM *pparam) { return PyWinObject_AsSimplePARAM(ob, (WPARAM *)pparam); } + +// RECT conversions +// @object PyRECT|Tuple of 4 ints defining a rectangle: (left, top, right, bottom) +PYWINTYPES_EXPORT BOOL PyWinObject_AsRECT(PyObject *obrect, LPRECT prect); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromRECT(LPRECT prect); + +/* +** SECURITY_ATTRIBUTES support +*/ +extern PYWINTYPES_EXPORT PyTypeObject PySECURITY_ATTRIBUTESType; +#define PySECURITY_ATTRIBUTES_Check(ob) ((ob)->ob_type == &PySECURITY_ATTRIBUTESType) +extern PYWINTYPES_EXPORT PyTypeObject PyDEVMODEWType; + +PYWINTYPES_EXPORT PyObject *PyWinMethod_NewSECURITY_ATTRIBUTES(PyObject *self, PyObject *args); +PYWINTYPES_EXPORT BOOL PyWinObject_AsSECURITY_ATTRIBUTES(PyObject *ob, SECURITY_ATTRIBUTES **ppSECURITY_ATTRIBUTES, + BOOL bNoneOK = TRUE); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromSECURITY_ATTRIBUTES(const SECURITY_ATTRIBUTES &sa); +PYWINTYPES_EXPORT BOOL PyWinObject_AsDEVMODE(PyObject *ob, PDEVMODEW *ppDEVMODE, BOOL bNoneOK); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromDEVMODE(PDEVMODEW); + +/* +** WAVEFORMATEX support +*/ + +PYWINTYPES_EXPORT PyObject *PyWinMethod_NewWAVEFORMATEX(PyObject *self, PyObject *args); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromWAVEFROMATEX(const WAVEFORMATEX &wfx); +PYWINTYPES_EXPORT BOOL PyWinObject_AsWAVEFORMATEX(PyObject *ob, WAVEFORMATEX **ppWAVEFORMATEX, BOOL bNoneOK = TRUE); +extern PYWINTYPES_EXPORT PyTypeObject PyWAVEFORMATEXType; +#define PyWAVEFORMATEX_Check(ob) ((ob)->ob_type == &PyWAVEFORMATEXType) + +/* +** SECURITY_DESCRIPTOR support +*/ +extern PYWINTYPES_EXPORT PyTypeObject PySECURITY_DESCRIPTORType; +#define PySECURITY_DESCRIPTOR_Check(ob) ((ob)->ob_type == &PySECURITY_DESCRIPTORType) + +PYWINTYPES_EXPORT PyObject *PyWinMethod_NewSECURITY_DESCRIPTOR(PyObject *self, PyObject *args); +PYWINTYPES_EXPORT BOOL PyWinObject_AsSECURITY_DESCRIPTOR(PyObject *ob, PSECURITY_DESCRIPTOR *ppSECURITY_DESCRIPTOR, + BOOL bNoneOK = TRUE); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromSECURITY_DESCRIPTOR(PSECURITY_DESCRIPTOR psd); + +PYWINTYPES_EXPORT BOOL _MakeAbsoluteSD(PSECURITY_DESCRIPTOR psd_relative, PSECURITY_DESCRIPTOR *ppsd_absolute); +PYWINTYPES_EXPORT void FreeAbsoluteSD(PSECURITY_DESCRIPTOR psd); + +/* +** SID support +*/ +extern PYWINTYPES_EXPORT PyTypeObject PySIDType; +#define PySID_Check(ob) ((ob)->ob_type == &PySIDType) + +PYWINTYPES_EXPORT PyObject *PyWinMethod_NewSID(PyObject *self, PyObject *args); +PYWINTYPES_EXPORT BOOL PyWinObject_AsSID(PyObject *ob, PSID *ppSID, BOOL bNoneOK = FALSE); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromSID(PSID pSID); + +/* +** ACL support +*/ +extern PYWINTYPES_EXPORT PyTypeObject PyACLType; +#define PyACL_Check(ob) ((ob)->ob_type == &PyACLType) + +PYWINTYPES_EXPORT PyObject *PyWinMethod_NewACL(PyObject *self, PyObject *args); +PYWINTYPES_EXPORT BOOL PyWinObject_AsACL(PyObject *ob, PACL *ppACL, BOOL bNoneOK = FALSE); + +/* +** Win32 HANDLE wrapper - any handle closable by "CloseHandle()" +*/ +extern PYWINTYPES_EXPORT PyTypeObject PyHANDLEType; // the Type for PyHANDLE +#define PyHANDLE_Check(ob) ((ob)->ob_type == &PyHANDLEType) + +// Convert an object to a HANDLE - None is always OK, as are ints, etc. +PYWINTYPES_EXPORT BOOL PyWinObject_AsHANDLE(PyObject *ob, HANDLE *pRes); +// For handles that use PyHANDLE. +PYWINTYPES_EXPORT PyObject *PyWinObject_FromHANDLE(HANDLE h); +// For handles that aren't returned as PyHANDLE or a subclass thereof (HDC, HWND, etc). +// Return as python ints or longs +PYWINTYPES_EXPORT PyObject *PyWinLong_FromHANDLE(HANDLE h); + +// A global function that can work as a module method for making a HANDLE object. +PYWINTYPES_EXPORT PyObject *PyWinMethod_NewHANDLE(PyObject *self, PyObject *args); + +// A global function that does the right thing wrt closing a "handle". +// The object can be either a PyHANDLE or an integer. +// If result is FALSE, a Python error is all setup (cf PyHANDLE::Close(), which doesnt set the Python error) +PYWINTYPES_EXPORT BOOL PyWinObject_CloseHANDLE(PyObject *obHandle); + +PYWINTYPES_EXPORT BOOL PyWinObject_AsHKEY(PyObject *ob, HKEY *pRes); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromHKEY(HKEY h); +PYWINTYPES_EXPORT BOOL PyWinObject_CloseHKEY(PyObject *obHandle); + +// MSG structure keeps coming up... +PYWINTYPES_EXPORT BOOL PyWinObject_AsMSG(PyObject *ob, MSG *pMsg); +PYWINTYPES_EXPORT PyObject *PyWinObject_FromMSG(const MSG *pMsg); + +#include "winsock.h" +/* +** SOCKET support. +*/ +PYWINTYPES_EXPORT +BOOL PySocket_AsSOCKET + //------------------------------------------------------------------------- + // Helper function for dealing with socket arguments. + (PyObject *obSocket, + // [in] Python object being converted into a SOCKET handle. + SOCKET *ps + // [out] Returned socket handle + ); + +/* +** Other Utilities +*/ +// ---------------------------------------------------------------------- +// WARNING - NEVER EVER USE new() ON THIS CLASS +// This class can be used as a local variable, typically in a Python/C +// function, and can be passed whereever a TCHAR/WCHAR is expected. +// Typical Usage: +// PyWin_AutoFreeBstr arg; +// PyArg_ParseTuple("O", &obStr); +// PyWinObject_AsAutoFreeBstr(obStr, &arg); +// CallTheFunction(arg); // Will correctly pass BSTR/OLECHAR +// -- when the function goes out of scope, the string owned by "arg" will +// -- automatically be freed. +// ---------------------------------------------------------------------- +class PYWINTYPES_EXPORT PyWin_AutoFreeBstr { + public: + PyWin_AutoFreeBstr(BSTR bstr = NULL); + ~PyWin_AutoFreeBstr(); + void SetBstr(BSTR bstr); + operator BSTR() { return m_bstr; } + + private: + BSTR m_bstr; +}; + +inline BOOL PyWinObject_AsAutoFreeBstr(PyObject *stringObject, PyWin_AutoFreeBstr *pResult, BOOL bNoneOK = FALSE) +{ + if (bNoneOK && stringObject == Py_None) { + pResult->SetBstr(NULL); + return TRUE; + } + BSTR bs; + if (!PyWinObject_AsBstr(stringObject, &bs, bNoneOK)) + return FALSE; + pResult->SetBstr(bs); + return TRUE; +} + +// ---------------------------------------------------------------------- +// +// THREAD MANAGEMENT +// + +// ### need to rename the PYCOM_ stuff soon... + +// We have 2 discrete locks in use (when no free-threaded is used, anyway). +// The first type of lock is the global Python lock. This is the standard lock +// in use by Python, and must be used as documented by Python. Specifically, no +// 2 threads may _ever_ call _any_ Python code (including INCREF/DECREF) without +// first having this thread lock. +// +// The second type of lock is a "global framework lock". This lock is simply a +// critical section, and used whenever 2 threads of C code need access to global +// data. This is different than the Python lock - this lock is used when no Python +// code can ever be called by the threads, but the C code still needs thread-safety. + +// We also supply helper classes which make the usage of these locks a one-liner. + +// The "framework" lock, implemented as a critical section. +PYWINTYPES_EXPORT void PyWin_AcquireGlobalLock(void); +PYWINTYPES_EXPORT void PyWin_ReleaseGlobalLock(void); + +// Helper class for the DLL global lock. +// +// This class magically waits for the Win32/COM framework global lock, and releases it +// when finished. +// NEVER new one of these objects - only use on the stack! +class CEnterLeaveFramework { + public: + CEnterLeaveFramework() { PyWin_AcquireGlobalLock(); } + ~CEnterLeaveFramework() { PyWin_ReleaseGlobalLock(); } +}; + +// Python thread-lock stuff. Free-threading patches use different semantics, but +// these are abstracted away here... +#ifndef FORCE_NO_FREE_THREAD +#ifdef WITH_FREE_THREAD +#define PYCOM_USE_FREE_THREAD +#endif +#endif +#ifdef PYCOM_USE_FREE_THREAD +#include +#else +#include +#endif + +// Helper class for Enter/Leave Python +// +// This class magically waits for the Python global lock, and releases it +// when finished. + +// Nested invocations will deadlock, so be careful. + +// NEVER new one of these objects - only use on the stack! +#ifndef PYCOM_USE_FREE_THREAD +extern PYWINTYPES_EXPORT PyInterpreterState *PyWin_InterpreterState; +extern PYWINTYPES_EXPORT BOOL PyWinThreadState_Ensure(); +extern PYWINTYPES_EXPORT void PyWinThreadState_Free(); +extern PYWINTYPES_EXPORT void PyWinThreadState_Clear(); +extern PYWINTYPES_EXPORT void PyWinInterpreterLock_Acquire(); +extern PYWINTYPES_EXPORT void PyWinInterpreterLock_Release(); + +extern PYWINTYPES_EXPORT int PyWinGlobals_Ensure(); +extern PYWINTYPES_EXPORT void PyWinGlobals_Free(); +#else +#define PyWinThreadState_Ensure PyThreadState_Ensure +#define PyWinThreadState_Free PyThreadState_Free +#define PyWinThreadState_Clear PyThreadState_ClearExc + +#endif + +extern PYWINTYPES_EXPORT void PyWin_MakePendingCalls(); + +class CEnterLeavePython { + public: + CEnterLeavePython() : released(TRUE) { acquire(); } + void acquire(void) + { + if (!released) + return; + state = PyGILState_Ensure(); + released = FALSE; + } + ~CEnterLeavePython() { release(); } + void release(void) + { + if (!released) { + PyGILState_Release(state); + released = TRUE; + } + } + + private: + PyGILState_STATE state; + BOOL released; +}; + +// A helper for simple exception handling. +// try/__try +#if defined(__MINGW32__) || defined(MAINWIN) +#define PYWINTYPES_TRY try +#else +#define PYWINTYPES_TRY __try +#endif /* MAINWIN */ + +// catch/__except +#if defined(__MINGW32__) || defined(MAINWIN) +#define PYWINTYPES_EXCEPT catch (...) +#else +#define PYWINTYPES_EXCEPT __except (EXCEPTION_EXECUTE_HANDLER) +#endif +// End of exception helper macros. + +// Class to hold a temporary reference that decrements itself +class TmpPyObject { + public: + PyObject *tmp; + TmpPyObject() { tmp = NULL; } + TmpPyObject(PyObject *ob) { tmp = ob; } + PyObject *operator=(PyObject *ob) + { + Py_XDECREF(tmp); + tmp = ob; + return tmp; + } + + boolean operator==(PyObject *ob) { return tmp == ob; } + operator PyObject *() { return tmp; } + ~TmpPyObject() { Py_XDECREF(tmp); } +}; + +#endif // __PYWINTYPES_H__ diff --git a/lib/win32/lib/afxres.py b/lib/win32/lib/afxres.py new file mode 100644 index 00000000..249211ff --- /dev/null +++ b/lib/win32/lib/afxres.py @@ -0,0 +1,501 @@ +# Generated by h2py from stdin +TCS_MULTILINE = 0x0200 +CBRS_ALIGN_LEFT = 0x1000 +CBRS_ALIGN_TOP = 0x2000 +CBRS_ALIGN_RIGHT = 0x4000 +CBRS_ALIGN_BOTTOM = 0x8000 +CBRS_ALIGN_ANY = 0xF000 +CBRS_BORDER_LEFT = 0x0100 +CBRS_BORDER_TOP = 0x0200 +CBRS_BORDER_RIGHT = 0x0400 +CBRS_BORDER_BOTTOM = 0x0800 +CBRS_BORDER_ANY = 0x0F00 +CBRS_TOOLTIPS = 0x0010 +CBRS_FLYBY = 0x0020 +CBRS_FLOAT_MULTI = 0x0040 +CBRS_BORDER_3D = 0x0080 +CBRS_HIDE_INPLACE = 0x0008 +CBRS_SIZE_DYNAMIC = 0x0004 +CBRS_SIZE_FIXED = 0x0002 +CBRS_FLOATING = 0x0001 +CBRS_GRIPPER = 0x00400000 +CBRS_ORIENT_HORZ = CBRS_ALIGN_TOP | CBRS_ALIGN_BOTTOM +CBRS_ORIENT_VERT = CBRS_ALIGN_LEFT | CBRS_ALIGN_RIGHT +CBRS_ORIENT_ANY = CBRS_ORIENT_HORZ | CBRS_ORIENT_VERT +CBRS_ALL = 0xFFFF +CBRS_NOALIGN = 0x00000000 +CBRS_LEFT = CBRS_ALIGN_LEFT | CBRS_BORDER_RIGHT +CBRS_TOP = CBRS_ALIGN_TOP | CBRS_BORDER_BOTTOM +CBRS_RIGHT = CBRS_ALIGN_RIGHT | CBRS_BORDER_LEFT +CBRS_BOTTOM = CBRS_ALIGN_BOTTOM | CBRS_BORDER_TOP +SBPS_NORMAL = 0x0000 +SBPS_NOBORDERS = 0x0100 +SBPS_POPOUT = 0x0200 +SBPS_OWNERDRAW = 0x1000 +SBPS_DISABLED = 0x04000000 +SBPS_STRETCH = 0x08000000 +ID_INDICATOR_EXT = 0xE700 +ID_INDICATOR_CAPS = 0xE701 +ID_INDICATOR_NUM = 0xE702 +ID_INDICATOR_SCRL = 0xE703 +ID_INDICATOR_OVR = 0xE704 +ID_INDICATOR_REC = 0xE705 +ID_INDICATOR_KANA = 0xE706 +ID_SEPARATOR = 0 +AFX_IDW_CONTROLBAR_FIRST = 0xE800 +AFX_IDW_CONTROLBAR_LAST = 0xE8FF +AFX_IDW_TOOLBAR = 0xE800 +AFX_IDW_STATUS_BAR = 0xE801 +AFX_IDW_PREVIEW_BAR = 0xE802 +AFX_IDW_RESIZE_BAR = 0xE803 +AFX_IDW_DOCKBAR_TOP = 0xE81B +AFX_IDW_DOCKBAR_LEFT = 0xE81C +AFX_IDW_DOCKBAR_RIGHT = 0xE81D +AFX_IDW_DOCKBAR_BOTTOM = 0xE81E +AFX_IDW_DOCKBAR_FLOAT = 0xE81F + + +def AFX_CONTROLBAR_MASK(nIDC): + return 1 << (nIDC - AFX_IDW_CONTROLBAR_FIRST) + + +AFX_IDW_PANE_FIRST = 0xE900 +AFX_IDW_PANE_LAST = 0xE9FF +AFX_IDW_HSCROLL_FIRST = 0xEA00 +AFX_IDW_VSCROLL_FIRST = 0xEA10 +AFX_IDW_SIZE_BOX = 0xEA20 +AFX_IDW_PANE_SAVE = 0xEA21 +AFX_IDS_APP_TITLE = 0xE000 +AFX_IDS_IDLEMESSAGE = 0xE001 +AFX_IDS_HELPMODEMESSAGE = 0xE002 +AFX_IDS_APP_TITLE_EMBEDDING = 0xE003 +AFX_IDS_COMPANY_NAME = 0xE004 +AFX_IDS_OBJ_TITLE_INPLACE = 0xE005 +ID_FILE_NEW = 0xE100 +ID_FILE_OPEN = 0xE101 +ID_FILE_CLOSE = 0xE102 +ID_FILE_SAVE = 0xE103 +ID_FILE_SAVE_AS = 0xE104 +ID_FILE_PAGE_SETUP = 0xE105 +ID_FILE_PRINT_SETUP = 0xE106 +ID_FILE_PRINT = 0xE107 +ID_FILE_PRINT_DIRECT = 0xE108 +ID_FILE_PRINT_PREVIEW = 0xE109 +ID_FILE_UPDATE = 0xE10A +ID_FILE_SAVE_COPY_AS = 0xE10B +ID_FILE_SEND_MAIL = 0xE10C +ID_FILE_MRU_FIRST = 0xE110 +ID_FILE_MRU_FILE1 = 0xE110 +ID_FILE_MRU_FILE2 = 0xE111 +ID_FILE_MRU_FILE3 = 0xE112 +ID_FILE_MRU_FILE4 = 0xE113 +ID_FILE_MRU_FILE5 = 0xE114 +ID_FILE_MRU_FILE6 = 0xE115 +ID_FILE_MRU_FILE7 = 0xE116 +ID_FILE_MRU_FILE8 = 0xE117 +ID_FILE_MRU_FILE9 = 0xE118 +ID_FILE_MRU_FILE10 = 0xE119 +ID_FILE_MRU_FILE11 = 0xE11A +ID_FILE_MRU_FILE12 = 0xE11B +ID_FILE_MRU_FILE13 = 0xE11C +ID_FILE_MRU_FILE14 = 0xE11D +ID_FILE_MRU_FILE15 = 0xE11E +ID_FILE_MRU_FILE16 = 0xE11F +ID_FILE_MRU_LAST = 0xE11F +ID_EDIT_CLEAR = 0xE120 +ID_EDIT_CLEAR_ALL = 0xE121 +ID_EDIT_COPY = 0xE122 +ID_EDIT_CUT = 0xE123 +ID_EDIT_FIND = 0xE124 +ID_EDIT_PASTE = 0xE125 +ID_EDIT_PASTE_LINK = 0xE126 +ID_EDIT_PASTE_SPECIAL = 0xE127 +ID_EDIT_REPEAT = 0xE128 +ID_EDIT_REPLACE = 0xE129 +ID_EDIT_SELECT_ALL = 0xE12A +ID_EDIT_UNDO = 0xE12B +ID_EDIT_REDO = 0xE12C +ID_WINDOW_NEW = 0xE130 +ID_WINDOW_ARRANGE = 0xE131 +ID_WINDOW_CASCADE = 0xE132 +ID_WINDOW_TILE_HORZ = 0xE133 +ID_WINDOW_TILE_VERT = 0xE134 +ID_WINDOW_SPLIT = 0xE135 +AFX_IDM_WINDOW_FIRST = 0xE130 +AFX_IDM_WINDOW_LAST = 0xE13F +AFX_IDM_FIRST_MDICHILD = 0xFF00 +ID_APP_ABOUT = 0xE140 +ID_APP_EXIT = 0xE141 +ID_HELP_INDEX = 0xE142 +ID_HELP_FINDER = 0xE143 +ID_HELP_USING = 0xE144 +ID_CONTEXT_HELP = 0xE145 +ID_HELP = 0xE146 +ID_DEFAULT_HELP = 0xE147 +ID_NEXT_PANE = 0xE150 +ID_PREV_PANE = 0xE151 +ID_FORMAT_FONT = 0xE160 +ID_OLE_INSERT_NEW = 0xE200 +ID_OLE_EDIT_LINKS = 0xE201 +ID_OLE_EDIT_CONVERT = 0xE202 +ID_OLE_EDIT_CHANGE_ICON = 0xE203 +ID_OLE_EDIT_PROPERTIES = 0xE204 +ID_OLE_VERB_FIRST = 0xE210 +ID_OLE_VERB_LAST = 0xE21F +AFX_ID_PREVIEW_CLOSE = 0xE300 +AFX_ID_PREVIEW_NUMPAGE = 0xE301 +AFX_ID_PREVIEW_NEXT = 0xE302 +AFX_ID_PREVIEW_PREV = 0xE303 +AFX_ID_PREVIEW_PRINT = 0xE304 +AFX_ID_PREVIEW_ZOOMIN = 0xE305 +AFX_ID_PREVIEW_ZOOMOUT = 0xE306 +ID_VIEW_TOOLBAR = 0xE800 +ID_VIEW_STATUS_BAR = 0xE801 +ID_RECORD_FIRST = 0xE900 +ID_RECORD_LAST = 0xE901 +ID_RECORD_NEXT = 0xE902 +ID_RECORD_PREV = 0xE903 +IDC_STATIC = -1 +AFX_IDS_SCFIRST = 0xEF00 +AFX_IDS_SCSIZE = 0xEF00 +AFX_IDS_SCMOVE = 0xEF01 +AFX_IDS_SCMINIMIZE = 0xEF02 +AFX_IDS_SCMAXIMIZE = 0xEF03 +AFX_IDS_SCNEXTWINDOW = 0xEF04 +AFX_IDS_SCPREVWINDOW = 0xEF05 +AFX_IDS_SCCLOSE = 0xEF06 +AFX_IDS_SCRESTORE = 0xEF12 +AFX_IDS_SCTASKLIST = 0xEF13 +AFX_IDS_MDICHILD = 0xEF1F +AFX_IDS_DESKACCESSORY = 0xEFDA +AFX_IDS_OPENFILE = 0xF000 +AFX_IDS_SAVEFILE = 0xF001 +AFX_IDS_ALLFILTER = 0xF002 +AFX_IDS_UNTITLED = 0xF003 +AFX_IDS_SAVEFILECOPY = 0xF004 +AFX_IDS_PREVIEW_CLOSE = 0xF005 +AFX_IDS_UNNAMED_FILE = 0xF006 +AFX_IDS_ABOUT = 0xF010 +AFX_IDS_HIDE = 0xF011 +AFX_IDP_NO_ERROR_AVAILABLE = 0xF020 +AFX_IDS_NOT_SUPPORTED_EXCEPTION = 0xF021 +AFX_IDS_RESOURCE_EXCEPTION = 0xF022 +AFX_IDS_MEMORY_EXCEPTION = 0xF023 +AFX_IDS_USER_EXCEPTION = 0xF024 +AFX_IDS_PRINTONPORT = 0xF040 +AFX_IDS_ONEPAGE = 0xF041 +AFX_IDS_TWOPAGE = 0xF042 +AFX_IDS_PRINTPAGENUM = 0xF043 +AFX_IDS_PREVIEWPAGEDESC = 0xF044 +AFX_IDS_PRINTDEFAULTEXT = 0xF045 +AFX_IDS_PRINTDEFAULT = 0xF046 +AFX_IDS_PRINTFILTER = 0xF047 +AFX_IDS_PRINTCAPTION = 0xF048 +AFX_IDS_PRINTTOFILE = 0xF049 +AFX_IDS_OBJECT_MENUITEM = 0xF080 +AFX_IDS_EDIT_VERB = 0xF081 +AFX_IDS_ACTIVATE_VERB = 0xF082 +AFX_IDS_CHANGE_LINK = 0xF083 +AFX_IDS_AUTO = 0xF084 +AFX_IDS_MANUAL = 0xF085 +AFX_IDS_FROZEN = 0xF086 +AFX_IDS_ALL_FILES = 0xF087 +AFX_IDS_SAVE_MENU = 0xF088 +AFX_IDS_UPDATE_MENU = 0xF089 +AFX_IDS_SAVE_AS_MENU = 0xF08A +AFX_IDS_SAVE_COPY_AS_MENU = 0xF08B +AFX_IDS_EXIT_MENU = 0xF08C +AFX_IDS_UPDATING_ITEMS = 0xF08D +AFX_IDS_METAFILE_FORMAT = 0xF08E +AFX_IDS_DIB_FORMAT = 0xF08F +AFX_IDS_BITMAP_FORMAT = 0xF090 +AFX_IDS_LINKSOURCE_FORMAT = 0xF091 +AFX_IDS_EMBED_FORMAT = 0xF092 +AFX_IDS_PASTELINKEDTYPE = 0xF094 +AFX_IDS_UNKNOWNTYPE = 0xF095 +AFX_IDS_RTF_FORMAT = 0xF096 +AFX_IDS_TEXT_FORMAT = 0xF097 +AFX_IDS_INVALID_CURRENCY = 0xF098 +AFX_IDS_INVALID_DATETIME = 0xF099 +AFX_IDS_INVALID_DATETIMESPAN = 0xF09A +AFX_IDP_INVALID_FILENAME = 0xF100 +AFX_IDP_FAILED_TO_OPEN_DOC = 0xF101 +AFX_IDP_FAILED_TO_SAVE_DOC = 0xF102 +AFX_IDP_ASK_TO_SAVE = 0xF103 +AFX_IDP_FAILED_TO_CREATE_DOC = 0xF104 +AFX_IDP_FILE_TOO_LARGE = 0xF105 +AFX_IDP_FAILED_TO_START_PRINT = 0xF106 +AFX_IDP_FAILED_TO_LAUNCH_HELP = 0xF107 +AFX_IDP_INTERNAL_FAILURE = 0xF108 +AFX_IDP_COMMAND_FAILURE = 0xF109 +AFX_IDP_FAILED_MEMORY_ALLOC = 0xF10A +AFX_IDP_PARSE_INT = 0xF110 +AFX_IDP_PARSE_REAL = 0xF111 +AFX_IDP_PARSE_INT_RANGE = 0xF112 +AFX_IDP_PARSE_REAL_RANGE = 0xF113 +AFX_IDP_PARSE_STRING_SIZE = 0xF114 +AFX_IDP_PARSE_RADIO_BUTTON = 0xF115 +AFX_IDP_PARSE_BYTE = 0xF116 +AFX_IDP_PARSE_UINT = 0xF117 +AFX_IDP_PARSE_DATETIME = 0xF118 +AFX_IDP_PARSE_CURRENCY = 0xF119 +AFX_IDP_FAILED_INVALID_FORMAT = 0xF120 +AFX_IDP_FAILED_INVALID_PATH = 0xF121 +AFX_IDP_FAILED_DISK_FULL = 0xF122 +AFX_IDP_FAILED_ACCESS_READ = 0xF123 +AFX_IDP_FAILED_ACCESS_WRITE = 0xF124 +AFX_IDP_FAILED_IO_ERROR_READ = 0xF125 +AFX_IDP_FAILED_IO_ERROR_WRITE = 0xF126 +AFX_IDP_STATIC_OBJECT = 0xF180 +AFX_IDP_FAILED_TO_CONNECT = 0xF181 +AFX_IDP_SERVER_BUSY = 0xF182 +AFX_IDP_BAD_VERB = 0xF183 +AFX_IDP_FAILED_TO_NOTIFY = 0xF185 +AFX_IDP_FAILED_TO_LAUNCH = 0xF186 +AFX_IDP_ASK_TO_UPDATE = 0xF187 +AFX_IDP_FAILED_TO_UPDATE = 0xF188 +AFX_IDP_FAILED_TO_REGISTER = 0xF189 +AFX_IDP_FAILED_TO_AUTO_REGISTER = 0xF18A +AFX_IDP_FAILED_TO_CONVERT = 0xF18B +AFX_IDP_GET_NOT_SUPPORTED = 0xF18C +AFX_IDP_SET_NOT_SUPPORTED = 0xF18D +AFX_IDP_ASK_TO_DISCARD = 0xF18E +AFX_IDP_FAILED_TO_CREATE = 0xF18F +AFX_IDP_FAILED_MAPI_LOAD = 0xF190 +AFX_IDP_INVALID_MAPI_DLL = 0xF191 +AFX_IDP_FAILED_MAPI_SEND = 0xF192 +AFX_IDP_FILE_NONE = 0xF1A0 +AFX_IDP_FILE_GENERIC = 0xF1A1 +AFX_IDP_FILE_NOT_FOUND = 0xF1A2 +AFX_IDP_FILE_BAD_PATH = 0xF1A3 +AFX_IDP_FILE_TOO_MANY_OPEN = 0xF1A4 +AFX_IDP_FILE_ACCESS_DENIED = 0xF1A5 +AFX_IDP_FILE_INVALID_FILE = 0xF1A6 +AFX_IDP_FILE_REMOVE_CURRENT = 0xF1A7 +AFX_IDP_FILE_DIR_FULL = 0xF1A8 +AFX_IDP_FILE_BAD_SEEK = 0xF1A9 +AFX_IDP_FILE_HARD_IO = 0xF1AA +AFX_IDP_FILE_SHARING = 0xF1AB +AFX_IDP_FILE_LOCKING = 0xF1AC +AFX_IDP_FILE_DISKFULL = 0xF1AD +AFX_IDP_FILE_EOF = 0xF1AE +AFX_IDP_ARCH_NONE = 0xF1B0 +AFX_IDP_ARCH_GENERIC = 0xF1B1 +AFX_IDP_ARCH_READONLY = 0xF1B2 +AFX_IDP_ARCH_ENDOFFILE = 0xF1B3 +AFX_IDP_ARCH_WRITEONLY = 0xF1B4 +AFX_IDP_ARCH_BADINDEX = 0xF1B5 +AFX_IDP_ARCH_BADCLASS = 0xF1B6 +AFX_IDP_ARCH_BADSCHEMA = 0xF1B7 +AFX_IDS_OCC_SCALEUNITS_PIXELS = 0xF1C0 +AFX_IDS_STATUS_FONT = 0xF230 +AFX_IDS_TOOLTIP_FONT = 0xF231 +AFX_IDS_UNICODE_FONT = 0xF232 +AFX_IDS_MINI_FONT = 0xF233 +AFX_IDP_SQL_FIRST = 0xF280 +AFX_IDP_SQL_CONNECT_FAIL = 0xF281 +AFX_IDP_SQL_RECORDSET_FORWARD_ONLY = 0xF282 +AFX_IDP_SQL_EMPTY_COLUMN_LIST = 0xF283 +AFX_IDP_SQL_FIELD_SCHEMA_MISMATCH = 0xF284 +AFX_IDP_SQL_ILLEGAL_MODE = 0xF285 +AFX_IDP_SQL_MULTIPLE_ROWS_AFFECTED = 0xF286 +AFX_IDP_SQL_NO_CURRENT_RECORD = 0xF287 +AFX_IDP_SQL_NO_ROWS_AFFECTED = 0xF288 +AFX_IDP_SQL_RECORDSET_READONLY = 0xF289 +AFX_IDP_SQL_SQL_NO_TOTAL = 0xF28A +AFX_IDP_SQL_ODBC_LOAD_FAILED = 0xF28B +AFX_IDP_SQL_DYNASET_NOT_SUPPORTED = 0xF28C +AFX_IDP_SQL_SNAPSHOT_NOT_SUPPORTED = 0xF28D +AFX_IDP_SQL_API_CONFORMANCE = 0xF28E +AFX_IDP_SQL_SQL_CONFORMANCE = 0xF28F +AFX_IDP_SQL_NO_DATA_FOUND = 0xF290 +AFX_IDP_SQL_ROW_UPDATE_NOT_SUPPORTED = 0xF291 +AFX_IDP_SQL_ODBC_V2_REQUIRED = 0xF292 +AFX_IDP_SQL_NO_POSITIONED_UPDATES = 0xF293 +AFX_IDP_SQL_LOCK_MODE_NOT_SUPPORTED = 0xF294 +AFX_IDP_SQL_DATA_TRUNCATED = 0xF295 +AFX_IDP_SQL_ROW_FETCH = 0xF296 +AFX_IDP_SQL_INCORRECT_ODBC = 0xF297 +AFX_IDP_SQL_UPDATE_DELETE_FAILED = 0xF298 +AFX_IDP_SQL_DYNAMIC_CURSOR_NOT_SUPPORTED = 0xF299 +AFX_IDP_DAO_FIRST = 0xF2A0 +AFX_IDP_DAO_ENGINE_INITIALIZATION = 0xF2A0 +AFX_IDP_DAO_DFX_BIND = 0xF2A1 +AFX_IDP_DAO_OBJECT_NOT_OPEN = 0xF2A2 +AFX_IDP_DAO_ROWTOOSHORT = 0xF2A3 +AFX_IDP_DAO_BADBINDINFO = 0xF2A4 +AFX_IDP_DAO_COLUMNUNAVAILABLE = 0xF2A5 +AFX_IDC_LISTBOX = 100 +AFX_IDC_CHANGE = 101 +AFX_IDC_PRINT_DOCNAME = 201 +AFX_IDC_PRINT_PRINTERNAME = 202 +AFX_IDC_PRINT_PORTNAME = 203 +AFX_IDC_PRINT_PAGENUM = 204 +ID_APPLY_NOW = 0x3021 +ID_WIZBACK = 0x3023 +ID_WIZNEXT = 0x3024 +ID_WIZFINISH = 0x3025 +AFX_IDC_TAB_CONTROL = 0x3020 +AFX_IDD_FILEOPEN = 28676 +AFX_IDD_FILESAVE = 28677 +AFX_IDD_FONT = 28678 +AFX_IDD_COLOR = 28679 +AFX_IDD_PRINT = 28680 +AFX_IDD_PRINTSETUP = 28681 +AFX_IDD_FIND = 28682 +AFX_IDD_REPLACE = 28683 +AFX_IDD_NEWTYPEDLG = 30721 +AFX_IDD_PRINTDLG = 30722 +AFX_IDD_PREVIEW_TOOLBAR = 30723 +AFX_IDD_PREVIEW_SHORTTOOLBAR = 30731 +AFX_IDD_INSERTOBJECT = 30724 +AFX_IDD_CHANGEICON = 30725 +AFX_IDD_CONVERT = 30726 +AFX_IDD_PASTESPECIAL = 30727 +AFX_IDD_EDITLINKS = 30728 +AFX_IDD_FILEBROWSE = 30729 +AFX_IDD_BUSY = 30730 +AFX_IDD_OBJECTPROPERTIES = 30732 +AFX_IDD_CHANGESOURCE = 30733 +AFX_IDC_CONTEXTHELP = 30977 +AFX_IDC_MAGNIFY = 30978 +AFX_IDC_SMALLARROWS = 30979 +AFX_IDC_HSPLITBAR = 30980 +AFX_IDC_VSPLITBAR = 30981 +AFX_IDC_NODROPCRSR = 30982 +AFX_IDC_TRACKNWSE = 30983 +AFX_IDC_TRACKNESW = 30984 +AFX_IDC_TRACKNS = 30985 +AFX_IDC_TRACKWE = 30986 +AFX_IDC_TRACK4WAY = 30987 +AFX_IDC_MOVE4WAY = 30988 +AFX_IDB_MINIFRAME_MENU = 30994 +AFX_IDB_CHECKLISTBOX_NT = 30995 +AFX_IDB_CHECKLISTBOX_95 = 30996 +AFX_IDR_PREVIEW_ACCEL = 30997 +AFX_IDI_STD_MDIFRAME = 31233 +AFX_IDI_STD_FRAME = 31234 +AFX_IDC_FONTPROP = 1000 +AFX_IDC_FONTNAMES = 1001 +AFX_IDC_FONTSTYLES = 1002 +AFX_IDC_FONTSIZES = 1003 +AFX_IDC_STRIKEOUT = 1004 +AFX_IDC_UNDERLINE = 1005 +AFX_IDC_SAMPLEBOX = 1006 +AFX_IDC_COLOR_BLACK = 1100 +AFX_IDC_COLOR_WHITE = 1101 +AFX_IDC_COLOR_RED = 1102 +AFX_IDC_COLOR_GREEN = 1103 +AFX_IDC_COLOR_BLUE = 1104 +AFX_IDC_COLOR_YELLOW = 1105 +AFX_IDC_COLOR_MAGENTA = 1106 +AFX_IDC_COLOR_CYAN = 1107 +AFX_IDC_COLOR_GRAY = 1108 +AFX_IDC_COLOR_LIGHTGRAY = 1109 +AFX_IDC_COLOR_DARKRED = 1110 +AFX_IDC_COLOR_DARKGREEN = 1111 +AFX_IDC_COLOR_DARKBLUE = 1112 +AFX_IDC_COLOR_LIGHTBROWN = 1113 +AFX_IDC_COLOR_DARKMAGENTA = 1114 +AFX_IDC_COLOR_DARKCYAN = 1115 +AFX_IDC_COLORPROP = 1116 +AFX_IDC_SYSTEMCOLORS = 1117 +AFX_IDC_PROPNAME = 1201 +AFX_IDC_PICTURE = 1202 +AFX_IDC_BROWSE = 1203 +AFX_IDC_CLEAR = 1204 +AFX_IDD_PROPPAGE_COLOR = 32257 +AFX_IDD_PROPPAGE_FONT = 32258 +AFX_IDD_PROPPAGE_PICTURE = 32259 +AFX_IDB_TRUETYPE = 32384 +AFX_IDS_PROPPAGE_UNKNOWN = 0xFE01 +AFX_IDS_COLOR_DESKTOP = 0xFE04 +AFX_IDS_COLOR_APPWORKSPACE = 0xFE05 +AFX_IDS_COLOR_WNDBACKGND = 0xFE06 +AFX_IDS_COLOR_WNDTEXT = 0xFE07 +AFX_IDS_COLOR_MENUBAR = 0xFE08 +AFX_IDS_COLOR_MENUTEXT = 0xFE09 +AFX_IDS_COLOR_ACTIVEBAR = 0xFE0A +AFX_IDS_COLOR_INACTIVEBAR = 0xFE0B +AFX_IDS_COLOR_ACTIVETEXT = 0xFE0C +AFX_IDS_COLOR_INACTIVETEXT = 0xFE0D +AFX_IDS_COLOR_ACTIVEBORDER = 0xFE0E +AFX_IDS_COLOR_INACTIVEBORDER = 0xFE0F +AFX_IDS_COLOR_WNDFRAME = 0xFE10 +AFX_IDS_COLOR_SCROLLBARS = 0xFE11 +AFX_IDS_COLOR_BTNFACE = 0xFE12 +AFX_IDS_COLOR_BTNSHADOW = 0xFE13 +AFX_IDS_COLOR_BTNTEXT = 0xFE14 +AFX_IDS_COLOR_BTNHIGHLIGHT = 0xFE15 +AFX_IDS_COLOR_DISABLEDTEXT = 0xFE16 +AFX_IDS_COLOR_HIGHLIGHT = 0xFE17 +AFX_IDS_COLOR_HIGHLIGHTTEXT = 0xFE18 +AFX_IDS_REGULAR = 0xFE19 +AFX_IDS_BOLD = 0xFE1A +AFX_IDS_ITALIC = 0xFE1B +AFX_IDS_BOLDITALIC = 0xFE1C +AFX_IDS_SAMPLETEXT = 0xFE1D +AFX_IDS_DISPLAYSTRING_FONT = 0xFE1E +AFX_IDS_DISPLAYSTRING_COLOR = 0xFE1F +AFX_IDS_DISPLAYSTRING_PICTURE = 0xFE20 +AFX_IDS_PICTUREFILTER = 0xFE21 +AFX_IDS_PICTYPE_UNKNOWN = 0xFE22 +AFX_IDS_PICTYPE_NONE = 0xFE23 +AFX_IDS_PICTYPE_BITMAP = 0xFE24 +AFX_IDS_PICTYPE_METAFILE = 0xFE25 +AFX_IDS_PICTYPE_ICON = 0xFE26 +AFX_IDS_COLOR_PPG = 0xFE28 +AFX_IDS_COLOR_PPG_CAPTION = 0xFE29 +AFX_IDS_FONT_PPG = 0xFE2A +AFX_IDS_FONT_PPG_CAPTION = 0xFE2B +AFX_IDS_PICTURE_PPG = 0xFE2C +AFX_IDS_PICTURE_PPG_CAPTION = 0xFE2D +AFX_IDS_PICTUREBROWSETITLE = 0xFE30 +AFX_IDS_BORDERSTYLE_0 = 0xFE31 +AFX_IDS_BORDERSTYLE_1 = 0xFE32 +AFX_IDS_VERB_EDIT = 0xFE40 +AFX_IDS_VERB_PROPERTIES = 0xFE41 +AFX_IDP_PICTURECANTOPEN = 0xFE83 +AFX_IDP_PICTURECANTLOAD = 0xFE84 +AFX_IDP_PICTURETOOLARGE = 0xFE85 +AFX_IDP_PICTUREREADFAILED = 0xFE86 +AFX_IDP_E_ILLEGALFUNCTIONCALL = 0xFEA0 +AFX_IDP_E_OVERFLOW = 0xFEA1 +AFX_IDP_E_OUTOFMEMORY = 0xFEA2 +AFX_IDP_E_DIVISIONBYZERO = 0xFEA3 +AFX_IDP_E_OUTOFSTRINGSPACE = 0xFEA4 +AFX_IDP_E_OUTOFSTACKSPACE = 0xFEA5 +AFX_IDP_E_BADFILENAMEORNUMBER = 0xFEA6 +AFX_IDP_E_FILENOTFOUND = 0xFEA7 +AFX_IDP_E_BADFILEMODE = 0xFEA8 +AFX_IDP_E_FILEALREADYOPEN = 0xFEA9 +AFX_IDP_E_DEVICEIOERROR = 0xFEAA +AFX_IDP_E_FILEALREADYEXISTS = 0xFEAB +AFX_IDP_E_BADRECORDLENGTH = 0xFEAC +AFX_IDP_E_DISKFULL = 0xFEAD +AFX_IDP_E_BADRECORDNUMBER = 0xFEAE +AFX_IDP_E_BADFILENAME = 0xFEAF +AFX_IDP_E_TOOMANYFILES = 0xFEB0 +AFX_IDP_E_DEVICEUNAVAILABLE = 0xFEB1 +AFX_IDP_E_PERMISSIONDENIED = 0xFEB2 +AFX_IDP_E_DISKNOTREADY = 0xFEB3 +AFX_IDP_E_PATHFILEACCESSERROR = 0xFEB4 +AFX_IDP_E_PATHNOTFOUND = 0xFEB5 +AFX_IDP_E_INVALIDPATTERNSTRING = 0xFEB6 +AFX_IDP_E_INVALIDUSEOFNULL = 0xFEB7 +AFX_IDP_E_INVALIDFILEFORMAT = 0xFEB8 +AFX_IDP_E_INVALIDPROPERTYVALUE = 0xFEB9 +AFX_IDP_E_INVALIDPROPERTYARRAYINDEX = 0xFEBA +AFX_IDP_E_SETNOTSUPPORTEDATRUNTIME = 0xFEBB +AFX_IDP_E_SETNOTSUPPORTED = 0xFEBC +AFX_IDP_E_NEEDPROPERTYARRAYINDEX = 0xFEBD +AFX_IDP_E_SETNOTPERMITTED = 0xFEBE +AFX_IDP_E_GETNOTSUPPORTEDATRUNTIME = 0xFEBF +AFX_IDP_E_GETNOTSUPPORTED = 0xFEC0 +AFX_IDP_E_PROPERTYNOTFOUND = 0xFEC1 +AFX_IDP_E_INVALIDCLIPBOARDFORMAT = 0xFEC2 +AFX_IDP_E_INVALIDPICTURE = 0xFEC3 +AFX_IDP_E_PRINTERERROR = 0xFEC4 +AFX_IDP_E_CANTSAVEFILETOTEMP = 0xFEC5 +AFX_IDP_E_SEARCHTEXTNOTFOUND = 0xFEC6 +AFX_IDP_E_REPLACEMENTSTOOLONG = 0xFEC7 diff --git a/lib/win32/lib/commctrl.py b/lib/win32/lib/commctrl.py new file mode 100644 index 00000000..26641e84 --- /dev/null +++ b/lib/win32/lib/commctrl.py @@ -0,0 +1,1551 @@ +# Generated by h2py from COMMCTRL.H +WM_USER = 1024 +ICC_LISTVIEW_CLASSES = 1 # listview, header +ICC_TREEVIEW_CLASSES = 2 # treeview, tooltips +ICC_BAR_CLASSES = 4 # toolbar, statusbar, trackbar, tooltips +ICC_TAB_CLASSES = 8 # tab, tooltips +ICC_UPDOWN_CLASS = 16 # updown +ICC_PROGRESS_CLASS = 32 # progress +ICC_HOTKEY_CLASS = 64 # hotkey +ICC_ANIMATE_CLASS = 128 # animate +ICC_WIN95_CLASSES = 255 +ICC_DATE_CLASSES = 256 # month picker, date picker, time picker, updown +ICC_USEREX_CLASSES = 512 # comboex +ICC_COOL_CLASSES = 1024 # rebar (coolbar) control +ICC_INTERNET_CLASSES = 2048 +ICC_PAGESCROLLER_CLASS = 4096 # page scroller +ICC_NATIVEFNTCTL_CLASS = 8192 # native font control +ODT_HEADER = 100 +ODT_TAB = 101 +ODT_LISTVIEW = 102 +PY_0U = 0 +NM_FIRST = PY_0U # generic to all controls +NM_LAST = PY_0U - 99 +LVN_FIRST = PY_0U - 100 # listview +LVN_LAST = PY_0U - 199 +HDN_FIRST = PY_0U - 300 # header +HDN_LAST = PY_0U - 399 +TVN_FIRST = PY_0U - 400 # treeview +TVN_LAST = PY_0U - 499 +TTN_FIRST = PY_0U - 520 # tooltips +TTN_LAST = PY_0U - 549 +TCN_FIRST = PY_0U - 550 # tab control +TCN_LAST = PY_0U - 580 +CDN_FIRST = PY_0U - 601 # common dialog (new) +CDN_LAST = PY_0U - 699 +TBN_FIRST = PY_0U - 700 # toolbar +TBN_LAST = PY_0U - 720 +UDN_FIRST = PY_0U - 721 # updown +UDN_LAST = PY_0U - 740 +MCN_FIRST = PY_0U - 750 # monthcal +MCN_LAST = PY_0U - 759 +DTN_FIRST = PY_0U - 760 # datetimepick +DTN_LAST = PY_0U - 799 +CBEN_FIRST = PY_0U - 800 # combo box ex +CBEN_LAST = PY_0U - 830 +RBN_FIRST = PY_0U - 831 # rebar +RBN_LAST = PY_0U - 859 +IPN_FIRST = PY_0U - 860 # internet address +IPN_LAST = PY_0U - 879 # internet address +SBN_FIRST = PY_0U - 880 # status bar +SBN_LAST = PY_0U - 899 +PGN_FIRST = PY_0U - 900 # Pager Control +PGN_LAST = PY_0U - 950 +LVM_FIRST = 4096 # ListView messages +TV_FIRST = 4352 # TreeView messages +HDM_FIRST = 4608 # Header messages +TCM_FIRST = 4864 # Tab control messages +PGM_FIRST = 5120 # Pager control messages +CCM_FIRST = 8192 # Common control shared messages +CCM_SETBKCOLOR = CCM_FIRST + 1 # lParam is bkColor +CCM_SETCOLORSCHEME = CCM_FIRST + 2 # lParam is color scheme +CCM_GETCOLORSCHEME = CCM_FIRST + 3 # fills in COLORSCHEME pointed to by lParam +CCM_GETDROPTARGET = CCM_FIRST + 4 +CCM_SETUNICODEFORMAT = CCM_FIRST + 5 +CCM_GETUNICODEFORMAT = CCM_FIRST + 6 +INFOTIPSIZE = 1024 +NM_OUTOFMEMORY = NM_FIRST - 1 +NM_CLICK = NM_FIRST - 2 # uses NMCLICK struct +NM_DBLCLK = NM_FIRST - 3 +NM_RETURN = NM_FIRST - 4 +NM_RCLICK = NM_FIRST - 5 # uses NMCLICK struct +NM_RDBLCLK = NM_FIRST - 6 +NM_SETFOCUS = NM_FIRST - 7 +NM_KILLFOCUS = NM_FIRST - 8 +NM_CUSTOMDRAW = NM_FIRST - 12 +NM_HOVER = NM_FIRST - 13 +NM_NCHITTEST = NM_FIRST - 14 # uses NMMOUSE struct +NM_KEYDOWN = NM_FIRST - 15 # uses NMKEY struct +NM_RELEASEDCAPTURE = NM_FIRST - 16 +NM_SETCURSOR = NM_FIRST - 17 # uses NMMOUSE struct +NM_CHAR = NM_FIRST - 18 # uses NMCHAR struct +MSGF_COMMCTRL_BEGINDRAG = 16896 +MSGF_COMMCTRL_SIZEHEADER = 16897 +MSGF_COMMCTRL_DRAGSELECT = 16898 +MSGF_COMMCTRL_TOOLBARCUST = 16899 +CDRF_DODEFAULT = 0 +CDRF_NEWFONT = 2 +CDRF_SKIPDEFAULT = 4 +CDRF_NOTIFYPOSTPAINT = 16 +CDRF_NOTIFYITEMDRAW = 32 +CDRF_NOTIFYSUBITEMDRAW = 32 # flags are the same, we can distinguish by context +CDRF_NOTIFYPOSTERASE = 64 +CDDS_PREPAINT = 1 +CDDS_POSTPAINT = 2 +CDDS_PREERASE = 3 +CDDS_POSTERASE = 4 +CDDS_ITEM = 65536 +CDDS_ITEMPREPAINT = CDDS_ITEM | CDDS_PREPAINT +CDDS_ITEMPOSTPAINT = CDDS_ITEM | CDDS_POSTPAINT +CDDS_ITEMPREERASE = CDDS_ITEM | CDDS_PREERASE +CDDS_ITEMPOSTERASE = CDDS_ITEM | CDDS_POSTERASE +CDDS_SUBITEM = 131072 +CDIS_SELECTED = 1 +CDIS_GRAYED = 2 +CDIS_DISABLED = 4 +CDIS_CHECKED = 8 +CDIS_FOCUS = 16 +CDIS_DEFAULT = 32 +CDIS_HOT = 64 +CDIS_MARKED = 128 +CDIS_INDETERMINATE = 256 +CLR_NONE = -1 # 0xFFFFFFFFL +CLR_DEFAULT = -16777216 # 0xFF000000L +ILC_MASK = 1 +ILC_COLOR = 0 +ILC_COLORDDB = 254 +ILC_COLOR4 = 4 +ILC_COLOR8 = 8 +ILC_COLOR16 = 16 +ILC_COLOR24 = 24 +ILC_COLOR32 = 32 +ILC_PALETTE = 2048 # (not implemented) +ILD_NORMAL = 0 +ILD_TRANSPARENT = 1 +ILD_MASK = 16 +ILD_IMAGE = 32 +ILD_ROP = 64 +ILD_BLEND25 = 2 +ILD_BLEND50 = 4 +ILD_OVERLAYMASK = 3840 +ILD_SELECTED = ILD_BLEND50 +ILD_FOCUS = ILD_BLEND25 +ILD_BLEND = ILD_BLEND50 +CLR_HILIGHT = CLR_DEFAULT +ILCF_MOVE = 0 +ILCF_SWAP = 1 +WC_HEADERA = "SysHeader32" +WC_HEADER = WC_HEADERA +HDS_HORZ = 0 +HDS_BUTTONS = 2 +HDS_HOTTRACK = 4 +HDS_HIDDEN = 8 +HDS_DRAGDROP = 64 +HDS_FULLDRAG = 128 +HDI_WIDTH = 1 +HDI_HEIGHT = HDI_WIDTH +HDI_TEXT = 2 +HDI_FORMAT = 4 +HDI_LPARAM = 8 +HDI_BITMAP = 16 +HDI_IMAGE = 32 +HDI_DI_SETITEM = 64 +HDI_ORDER = 128 +HDF_LEFT = 0 +HDF_RIGHT = 1 +HDF_CENTER = 2 +HDF_JUSTIFYMASK = 3 +HDF_RTLREADING = 4 +HDF_OWNERDRAW = 32768 +HDF_STRING = 16384 +HDF_BITMAP = 8192 +HDF_BITMAP_ON_RIGHT = 4096 +HDF_IMAGE = 2048 +HDM_GETITEMCOUNT = HDM_FIRST + 0 +HDM_INSERTITEMA = HDM_FIRST + 1 +HDM_INSERTITEMW = HDM_FIRST + 10 +HDM_INSERTITEM = HDM_INSERTITEMA +HDM_DELETEITEM = HDM_FIRST + 2 +HDM_GETITEMA = HDM_FIRST + 3 +HDM_GETITEMW = HDM_FIRST + 11 +HDM_GETITEM = HDM_GETITEMA +HDM_SETITEMA = HDM_FIRST + 4 +HDM_SETITEMW = HDM_FIRST + 12 +HDM_SETITEM = HDM_SETITEMA +HDM_LAYOUT = HDM_FIRST + 5 +HHT_NOWHERE = 1 +HHT_ONHEADER = 2 +HHT_ONDIVIDER = 4 +HHT_ONDIVOPEN = 8 +HHT_ABOVE = 256 +HHT_BELOW = 512 +HHT_TORIGHT = 1024 +HHT_TOLEFT = 2048 +HDM_HITTEST = HDM_FIRST + 6 +HDM_GETITEMRECT = HDM_FIRST + 7 +HDM_SETIMAGELIST = HDM_FIRST + 8 +HDM_GETIMAGELIST = HDM_FIRST + 9 +HDM_ORDERTOINDEX = HDM_FIRST + 15 +HDM_CREATEDRAGIMAGE = HDM_FIRST + 16 # wparam = which item (by index) +HDM_GETORDERARRAY = HDM_FIRST + 17 +HDM_SETORDERARRAY = HDM_FIRST + 18 +HDM_SETHOTDIVIDER = HDM_FIRST + 19 +HDM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT +HDM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT +HDN_ITEMCHANGINGA = HDN_FIRST - 0 +HDN_ITEMCHANGINGW = HDN_FIRST - 20 +HDN_ITEMCHANGEDA = HDN_FIRST - 1 +HDN_ITEMCHANGEDW = HDN_FIRST - 21 +HDN_ITEMCLICKA = HDN_FIRST - 2 +HDN_ITEMCLICKW = HDN_FIRST - 22 +HDN_ITEMDBLCLICKA = HDN_FIRST - 3 +HDN_ITEMDBLCLICKW = HDN_FIRST - 23 +HDN_DIVIDERDBLCLICKA = HDN_FIRST - 5 +HDN_DIVIDERDBLCLICKW = HDN_FIRST - 25 +HDN_BEGINTRACKA = HDN_FIRST - 6 +HDN_BEGINTRACKW = HDN_FIRST - 26 +HDN_ENDTRACKA = HDN_FIRST - 7 +HDN_ENDTRACKW = HDN_FIRST - 27 +HDN_TRACKA = HDN_FIRST - 8 +HDN_TRACKW = HDN_FIRST - 28 +HDN_GETDISPINFOA = HDN_FIRST - 9 +HDN_GETDISPINFOW = HDN_FIRST - 29 +HDN_BEGINDRAG = HDN_FIRST - 10 +HDN_ENDDRAG = HDN_FIRST - 11 +HDN_ITEMCHANGING = HDN_ITEMCHANGINGA +HDN_ITEMCHANGED = HDN_ITEMCHANGEDA +HDN_ITEMCLICK = HDN_ITEMCLICKA +HDN_ITEMDBLCLICK = HDN_ITEMDBLCLICKA +HDN_DIVIDERDBLCLICK = HDN_DIVIDERDBLCLICKA +HDN_BEGINTRACK = HDN_BEGINTRACKA +HDN_ENDTRACK = HDN_ENDTRACKA +HDN_TRACK = HDN_TRACKA +HDN_GETDISPINFO = HDN_GETDISPINFOA +TOOLBARCLASSNAMEA = "ToolbarWindow32" +TOOLBARCLASSNAME = TOOLBARCLASSNAMEA +CMB_MASKED = 2 +TBSTATE_CHECKED = 1 +TBSTATE_PRESSED = 2 +TBSTATE_ENABLED = 4 +TBSTATE_HIDDEN = 8 +TBSTATE_INDETERMINATE = 16 +TBSTATE_WRAP = 32 +TBSTATE_ELLIPSES = 64 +TBSTATE_MARKED = 128 +TBSTYLE_BUTTON = 0 +TBSTYLE_SEP = 1 +TBSTYLE_CHECK = 2 +TBSTYLE_GROUP = 4 +TBSTYLE_CHECKGROUP = TBSTYLE_GROUP | TBSTYLE_CHECK +TBSTYLE_DROPDOWN = 8 +TBSTYLE_AUTOSIZE = 16 # automatically calculate the cx of the button +TBSTYLE_NOPREFIX = 32 # if this button should not have accel prefix +TBSTYLE_TOOLTIPS = 256 +TBSTYLE_WRAPABLE = 512 +TBSTYLE_ALTDRAG = 1024 +TBSTYLE_FLAT = 2048 +TBSTYLE_LIST = 4096 +TBSTYLE_CUSTOMERASE = 8192 +TBSTYLE_REGISTERDROP = 16384 +TBSTYLE_TRANSPARENT = 32768 +TBSTYLE_EX_DRAWDDARROWS = 1 +BTNS_BUTTON = TBSTYLE_BUTTON +BTNS_SEP = TBSTYLE_SEP # 0x0001 +BTNS_CHECK = TBSTYLE_CHECK # 0x0002 +BTNS_GROUP = TBSTYLE_GROUP # 0x0004 +BTNS_CHECKGROUP = TBSTYLE_CHECKGROUP # (TBSTYLE_GROUP | TBSTYLE_CHECK) +BTNS_DROPDOWN = TBSTYLE_DROPDOWN # 0x0008 +BTNS_AUTOSIZE = TBSTYLE_AUTOSIZE # 0x0010; automatically calculate the cx of the button +BTNS_NOPREFIX = TBSTYLE_NOPREFIX # 0x0020; this button should not have accel prefix +BTNS_SHOWTEXT = ( + 64 # 0x0040 // ignored unless TBSTYLE_EX_MIXEDBUTTONS is set +) +BTNS_WHOLEDROPDOWN = ( + 128 # 0x0080 // draw drop-down arrow, but without split arrow section +) +TBCDRF_NOEDGES = 65536 # Don't draw button edges +TBCDRF_HILITEHOTTRACK = 131072 # Use color of the button bk when hottracked +TBCDRF_NOOFFSET = 262144 # Don't offset button if pressed +TBCDRF_NOMARK = 524288 # Don't draw default highlight of image/text for TBSTATE_MARKED +TBCDRF_NOETCHEDEFFECT = 1048576 # Don't draw etched effect for disabled items +TB_ENABLEBUTTON = WM_USER + 1 +TB_CHECKBUTTON = WM_USER + 2 +TB_PRESSBUTTON = WM_USER + 3 +TB_HIDEBUTTON = WM_USER + 4 +TB_INDETERMINATE = WM_USER + 5 +TB_MARKBUTTON = WM_USER + 6 +TB_ISBUTTONENABLED = WM_USER + 9 +TB_ISBUTTONCHECKED = WM_USER + 10 +TB_ISBUTTONPRESSED = WM_USER + 11 +TB_ISBUTTONHIDDEN = WM_USER + 12 +TB_ISBUTTONINDETERMINATE = WM_USER + 13 +TB_ISBUTTONHIGHLIGHTED = WM_USER + 14 +TB_SETSTATE = WM_USER + 17 +TB_GETSTATE = WM_USER + 18 +TB_ADDBITMAP = WM_USER + 19 +HINST_COMMCTRL = -1 +IDB_STD_SMALL_COLOR = 0 +IDB_STD_LARGE_COLOR = 1 +IDB_VIEW_SMALL_COLOR = 4 +IDB_VIEW_LARGE_COLOR = 5 +IDB_HIST_SMALL_COLOR = 8 +IDB_HIST_LARGE_COLOR = 9 +STD_CUT = 0 +STD_COPY = 1 +STD_PASTE = 2 +STD_UNDO = 3 +STD_REDOW = 4 +STD_DELETE = 5 +STD_FILENEW = 6 +STD_FILEOPEN = 7 +STD_FILESAVE = 8 +STD_PRINTPRE = 9 +STD_PROPERTIES = 10 +STD_HELP = 11 +STD_FIND = 12 +STD_REPLACE = 13 +STD_PRINT = 14 +VIEW_LARGEICONS = 0 +VIEW_SMALLICONS = 1 +VIEW_LIST = 2 +VIEW_DETAILS = 3 +VIEW_SORTNAME = 4 +VIEW_SORTSIZE = 5 +VIEW_SORTDATE = 6 +VIEW_SORTTYPE = 7 +VIEW_PARENTFOLDER = 8 +VIEW_NETCONNECT = 9 +VIEW_NETDISCONNECT = 10 +VIEW_NEWFOLDER = 11 +VIEW_VIEWMENU = 12 +HIST_BACK = 0 +HIST_FORWARD = 1 +HIST_FAVORITES = 2 +HIST_ADDTOFAVORITES = 3 +HIST_VIEWTREE = 4 +TB_ADDBUTTONSA = WM_USER + 20 +TB_INSERTBUTTONA = WM_USER + 21 +TB_ADDBUTTONS = WM_USER + 20 +TB_INSERTBUTTON = WM_USER + 21 +TB_DELETEBUTTON = WM_USER + 22 +TB_GETBUTTON = WM_USER + 23 +TB_BUTTONCOUNT = WM_USER + 24 +TB_COMMANDTOINDEX = WM_USER + 25 +TB_SAVERESTOREA = WM_USER + 26 +TB_SAVERESTOREW = WM_USER + 76 +TB_CUSTOMIZE = WM_USER + 27 +TB_ADDSTRINGA = WM_USER + 28 +TB_ADDSTRINGW = WM_USER + 77 +TB_GETITEMRECT = WM_USER + 29 +TB_BUTTONSTRUCTSIZE = WM_USER + 30 +TB_SETBUTTONSIZE = WM_USER + 31 +TB_SETBITMAPSIZE = WM_USER + 32 +TB_AUTOSIZE = WM_USER + 33 +TB_GETTOOLTIPS = WM_USER + 35 +TB_SETTOOLTIPS = WM_USER + 36 +TB_SETPARENT = WM_USER + 37 +TB_SETROWS = WM_USER + 39 +TB_GETROWS = WM_USER + 40 +TB_SETCMDID = WM_USER + 42 +TB_CHANGEBITMAP = WM_USER + 43 +TB_GETBITMAP = WM_USER + 44 +TB_GETBUTTONTEXTA = WM_USER + 45 +TB_GETBUTTONTEXTW = WM_USER + 75 +TB_REPLACEBITMAP = WM_USER + 46 +TB_SETINDENT = WM_USER + 47 +TB_SETIMAGELIST = WM_USER + 48 +TB_GETIMAGELIST = WM_USER + 49 +TB_LOADIMAGES = WM_USER + 50 +TB_GETRECT = WM_USER + 51 # wParam is the Cmd instead of index +TB_SETHOTIMAGELIST = WM_USER + 52 +TB_GETHOTIMAGELIST = WM_USER + 53 +TB_SETDISABLEDIMAGELIST = WM_USER + 54 +TB_GETDISABLEDIMAGELIST = WM_USER + 55 +TB_SETSTYLE = WM_USER + 56 +TB_GETSTYLE = WM_USER + 57 +TB_GETBUTTONSIZE = WM_USER + 58 +TB_SETBUTTONWIDTH = WM_USER + 59 +TB_SETMAXTEXTROWS = WM_USER + 60 +TB_GETTEXTROWS = WM_USER + 61 +TB_GETBUTTONTEXT = TB_GETBUTTONTEXTA +TB_SAVERESTORE = TB_SAVERESTOREA +TB_ADDSTRING = TB_ADDSTRINGA +TB_GETOBJECT = WM_USER + 62 # wParam == IID, lParam void **ppv +TB_GETHOTITEM = WM_USER + 71 +TB_SETHOTITEM = WM_USER + 72 # wParam == iHotItem +TB_SETANCHORHIGHLIGHT = WM_USER + 73 # wParam == TRUE/FALSE +TB_GETANCHORHIGHLIGHT = WM_USER + 74 +TB_MAPACCELERATORA = WM_USER + 78 # wParam == ch, lParam int * pidBtn +TBIMHT_AFTER = 1 # TRUE = insert After iButton, otherwise before +TBIMHT_BACKGROUND = 2 # TRUE iff missed buttons completely +TB_GETINSERTMARK = WM_USER + 79 # lParam == LPTBINSERTMARK +TB_SETINSERTMARK = WM_USER + 80 # lParam == LPTBINSERTMARK +TB_INSERTMARKHITTEST = WM_USER + 81 # wParam == LPPOINT lParam == LPTBINSERTMARK +TB_MOVEBUTTON = WM_USER + 82 +TB_GETMAXSIZE = WM_USER + 83 # lParam == LPSIZE +TB_SETEXTENDEDSTYLE = WM_USER + 84 # For TBSTYLE_EX_* +TB_GETEXTENDEDSTYLE = WM_USER + 85 # For TBSTYLE_EX_* +TB_GETPADDING = WM_USER + 86 +TB_SETPADDING = WM_USER + 87 +TB_SETINSERTMARKCOLOR = WM_USER + 88 +TB_GETINSERTMARKCOLOR = WM_USER + 89 +TB_SETCOLORSCHEME = CCM_SETCOLORSCHEME # lParam is color scheme +TB_GETCOLORSCHEME = CCM_GETCOLORSCHEME # fills in COLORSCHEME pointed to by lParam +TB_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT +TB_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT +TB_MAPACCELERATORW = WM_USER + 90 # wParam == ch, lParam int * pidBtn +TB_MAPACCELERATOR = TB_MAPACCELERATORA +TBBF_LARGE = 1 +TB_GETBITMAPFLAGS = WM_USER + 41 +TBIF_IMAGE = 1 +TBIF_TEXT = 2 +TBIF_STATE = 4 +TBIF_STYLE = 8 +TBIF_LPARAM = 16 +TBIF_COMMAND = 32 +TBIF_SIZE = 64 +TB_GETBUTTONINFOW = WM_USER + 63 +TB_SETBUTTONINFOW = WM_USER + 64 +TB_GETBUTTONINFOA = WM_USER + 65 +TB_SETBUTTONINFOA = WM_USER + 66 +TB_INSERTBUTTONW = WM_USER + 67 +TB_ADDBUTTONSW = WM_USER + 68 +TB_HITTEST = WM_USER + 69 +TB_SETDRAWTEXTFLAGS = WM_USER + 70 # wParam == mask lParam == bit values +TBN_GETBUTTONINFOA = TBN_FIRST - 0 +TBN_GETBUTTONINFOW = TBN_FIRST - 20 +TBN_BEGINDRAG = TBN_FIRST - 1 +TBN_ENDDRAG = TBN_FIRST - 2 +TBN_BEGINADJUST = TBN_FIRST - 3 +TBN_ENDADJUST = TBN_FIRST - 4 +TBN_RESET = TBN_FIRST - 5 +TBN_QUERYINSERT = TBN_FIRST - 6 +TBN_QUERYDELETE = TBN_FIRST - 7 +TBN_TOOLBARCHANGE = TBN_FIRST - 8 +TBN_CUSTHELP = TBN_FIRST - 9 +TBN_DROPDOWN = TBN_FIRST - 10 +TBN_GETOBJECT = TBN_FIRST - 12 +HICF_OTHER = 0 +HICF_MOUSE = 1 # Triggered by mouse +HICF_ARROWKEYS = 2 # Triggered by arrow keys +HICF_ACCELERATOR = 4 # Triggered by accelerator +HICF_DUPACCEL = 8 # This accelerator is not unique +HICF_ENTERING = 16 # idOld is invalid +HICF_LEAVING = 32 # idNew is invalid +HICF_RESELECT = 64 # hot item reselected +TBN_HOTITEMCHANGE = TBN_FIRST - 13 +TBN_DRAGOUT = ( + TBN_FIRST - 14 +) # this is sent when the user clicks down on a button then drags off the button +TBN_DELETINGBUTTON = TBN_FIRST - 15 # uses TBNOTIFY +TBN_GETDISPINFOA = ( + TBN_FIRST - 16 +) # This is sent when the toolbar needs some display information +TBN_GETDISPINFOW = ( + TBN_FIRST - 17 +) # This is sent when the toolbar needs some display information +TBN_GETINFOTIPA = TBN_FIRST - 18 +TBN_GETINFOTIPW = TBN_FIRST - 19 +TBN_GETINFOTIP = TBN_GETINFOTIPA +TBNF_IMAGE = 1 +TBNF_TEXT = 2 +TBNF_DI_SETITEM = 268435456 +TBN_GETDISPINFO = TBN_GETDISPINFOA +TBDDRET_DEFAULT = 0 +TBDDRET_NODEFAULT = 1 +TBDDRET_TREATPRESSED = 2 # Treat as a standard press button +TBN_GETBUTTONINFO = TBN_GETBUTTONINFOA +REBARCLASSNAMEA = "ReBarWindow32" +REBARCLASSNAME = REBARCLASSNAMEA +RBIM_IMAGELIST = 1 +RBS_TOOLTIPS = 256 +RBS_VARHEIGHT = 512 +RBS_BANDBORDERS = 1024 +RBS_FIXEDORDER = 2048 +RBS_REGISTERDROP = 4096 +RBS_AUTOSIZE = 8192 +RBS_VERTICALGRIPPER = ( + 16384 # this always has the vertical gripper (default for horizontal mode) +) +RBS_DBLCLKTOGGLE = 32768 +RBBS_BREAK = 1 # break to new line +RBBS_FIXEDSIZE = 2 # band can't be sized +RBBS_CHILDEDGE = 4 # edge around top & bottom of child window +RBBS_HIDDEN = 8 # don't show +RBBS_NOVERT = 16 # don't show when vertical +RBBS_FIXEDBMP = 32 # bitmap doesn't move during band resize +RBBS_VARIABLEHEIGHT = 64 # allow autosizing of this child vertically +RBBS_GRIPPERALWAYS = 128 # always show the gripper +RBBS_NOGRIPPER = 256 # never show the gripper +RBBIM_STYLE = 1 +RBBIM_COLORS = 2 +RBBIM_TEXT = 4 +RBBIM_IMAGE = 8 +RBBIM_CHILD = 16 +RBBIM_CHILDSIZE = 32 +RBBIM_SIZE = 64 +RBBIM_BACKGROUND = 128 +RBBIM_ID = 256 +RBBIM_IDEALSIZE = 512 +RBBIM_LPARAM = 1024 +RB_INSERTBANDA = WM_USER + 1 +RB_DELETEBAND = WM_USER + 2 +RB_GETBARINFO = WM_USER + 3 +RB_SETBARINFO = WM_USER + 4 +RB_SETBANDINFOA = WM_USER + 6 +RB_SETPARENT = WM_USER + 7 +RB_HITTEST = WM_USER + 8 +RB_GETRECT = WM_USER + 9 +RB_INSERTBANDW = WM_USER + 10 +RB_SETBANDINFOW = WM_USER + 11 +RB_GETBANDCOUNT = WM_USER + 12 +RB_GETROWCOUNT = WM_USER + 13 +RB_GETROWHEIGHT = WM_USER + 14 +RB_IDTOINDEX = WM_USER + 16 # wParam == id +RB_GETTOOLTIPS = WM_USER + 17 +RB_SETTOOLTIPS = WM_USER + 18 +RB_SETBKCOLOR = WM_USER + 19 # sets the default BK color +RB_GETBKCOLOR = WM_USER + 20 # defaults to CLR_NONE +RB_SETTEXTCOLOR = WM_USER + 21 +RB_GETTEXTCOLOR = WM_USER + 22 # defaults to 0x00000000 +RB_SIZETORECT = ( + WM_USER + 23 +) # resize the rebar/break bands and such to this rect (lparam) +RB_SETCOLORSCHEME = CCM_SETCOLORSCHEME # lParam is color scheme +RB_GETCOLORSCHEME = CCM_GETCOLORSCHEME # fills in COLORSCHEME pointed to by lParam +RB_INSERTBAND = RB_INSERTBANDA +RB_SETBANDINFO = RB_SETBANDINFOA +RB_BEGINDRAG = WM_USER + 24 +RB_ENDDRAG = WM_USER + 25 +RB_DRAGMOVE = WM_USER + 26 +RB_GETBARHEIGHT = WM_USER + 27 +RB_GETBANDINFOW = WM_USER + 28 +RB_GETBANDINFOA = WM_USER + 29 +RB_GETBANDINFO = RB_GETBANDINFOA +RB_MINIMIZEBAND = WM_USER + 30 +RB_MAXIMIZEBAND = WM_USER + 31 +RB_GETDROPTARGET = CCM_GETDROPTARGET +RB_GETBANDBORDERS = ( + WM_USER + 34 +) # returns in lparam = lprc the amount of edges added to band wparam +RB_SHOWBAND = WM_USER + 35 # show/hide band +RB_SETPALETTE = WM_USER + 37 +RB_GETPALETTE = WM_USER + 38 +RB_MOVEBAND = WM_USER + 39 +RB_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT +RB_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT +RBN_HEIGHTCHANGE = RBN_FIRST - 0 +RBN_GETOBJECT = RBN_FIRST - 1 +RBN_LAYOUTCHANGED = RBN_FIRST - 2 +RBN_AUTOSIZE = RBN_FIRST - 3 +RBN_BEGINDRAG = RBN_FIRST - 4 +RBN_ENDDRAG = RBN_FIRST - 5 +RBN_DELETINGBAND = RBN_FIRST - 6 # Uses NMREBAR +RBN_DELETEDBAND = RBN_FIRST - 7 # Uses NMREBAR +RBN_CHILDSIZE = RBN_FIRST - 8 +RBNM_ID = 1 +RBNM_STYLE = 2 +RBNM_LPARAM = 4 +RBHT_NOWHERE = 1 +RBHT_CAPTION = 2 +RBHT_CLIENT = 3 +RBHT_GRABBER = 4 +TOOLTIPS_CLASSA = "tooltips_class32" +TOOLTIPS_CLASS = TOOLTIPS_CLASSA +TTS_ALWAYSTIP = 1 +TTS_NOPREFIX = 2 +TTF_IDISHWND = 1 +TTF_CENTERTIP = 2 +TTF_RTLREADING = 4 +TTF_SUBCLASS = 16 +TTF_TRACK = 32 +TTF_ABSOLUTE = 128 +TTF_TRANSPARENT = 256 +TTF_DI_SETITEM = 32768 # valid only on the TTN_NEEDTEXT callback +TTDT_AUTOMATIC = 0 +TTDT_RESHOW = 1 +TTDT_AUTOPOP = 2 +TTDT_INITIAL = 3 +TTM_ACTIVATE = WM_USER + 1 +TTM_SETDELAYTIME = WM_USER + 3 +TTM_ADDTOOLA = WM_USER + 4 +TTM_ADDTOOLW = WM_USER + 50 +TTM_DELTOOLA = WM_USER + 5 +TTM_DELTOOLW = WM_USER + 51 +TTM_NEWTOOLRECTA = WM_USER + 6 +TTM_NEWTOOLRECTW = WM_USER + 52 +TTM_RELAYEVENT = WM_USER + 7 +TTM_GETTOOLINFOA = WM_USER + 8 +TTM_GETTOOLINFOW = WM_USER + 53 +TTM_SETTOOLINFOA = WM_USER + 9 +TTM_SETTOOLINFOW = WM_USER + 54 +TTM_HITTESTA = WM_USER + 10 +TTM_HITTESTW = WM_USER + 55 +TTM_GETTEXTA = WM_USER + 11 +TTM_GETTEXTW = WM_USER + 56 +TTM_UPDATETIPTEXTA = WM_USER + 12 +TTM_UPDATETIPTEXTW = WM_USER + 57 +TTM_GETTOOLCOUNT = WM_USER + 13 +TTM_ENUMTOOLSA = WM_USER + 14 +TTM_ENUMTOOLSW = WM_USER + 58 +TTM_GETCURRENTTOOLA = WM_USER + 15 +TTM_GETCURRENTTOOLW = WM_USER + 59 +TTM_WINDOWFROMPOINT = WM_USER + 16 +TTM_TRACKACTIVATE = WM_USER + 17 # wParam = TRUE/FALSE start end lparam = LPTOOLINFO +TTM_TRACKPOSITION = WM_USER + 18 # lParam = dwPos +TTM_SETTIPBKCOLOR = WM_USER + 19 +TTM_SETTIPTEXTCOLOR = WM_USER + 20 +TTM_GETDELAYTIME = WM_USER + 21 +TTM_GETTIPBKCOLOR = WM_USER + 22 +TTM_GETTIPTEXTCOLOR = WM_USER + 23 +TTM_SETMAXTIPWIDTH = WM_USER + 24 +TTM_GETMAXTIPWIDTH = WM_USER + 25 +TTM_SETMARGIN = WM_USER + 26 # lParam = lprc +TTM_GETMARGIN = WM_USER + 27 # lParam = lprc +TTM_POP = WM_USER + 28 +TTM_UPDATE = WM_USER + 29 +TTM_ADDTOOL = TTM_ADDTOOLA +TTM_DELTOOL = TTM_DELTOOLA +TTM_NEWTOOLRECT = TTM_NEWTOOLRECTA +TTM_GETTOOLINFO = TTM_GETTOOLINFOA +TTM_SETTOOLINFO = TTM_SETTOOLINFOA +TTM_HITTEST = TTM_HITTESTA +TTM_GETTEXT = TTM_GETTEXTA +TTM_UPDATETIPTEXT = TTM_UPDATETIPTEXTA +TTM_ENUMTOOLS = TTM_ENUMTOOLSA +TTM_GETCURRENTTOOL = TTM_GETCURRENTTOOLA +TTN_GETDISPINFOA = TTN_FIRST - 0 +TTN_GETDISPINFOW = TTN_FIRST - 10 +TTN_SHOW = TTN_FIRST - 1 +TTN_POP = TTN_FIRST - 2 +TTN_GETDISPINFO = TTN_GETDISPINFOA +TTN_NEEDTEXT = TTN_GETDISPINFO +TTN_NEEDTEXTA = TTN_GETDISPINFOA +TTN_NEEDTEXTW = TTN_GETDISPINFOW +SBARS_SIZEGRIP = 256 +SBARS_TOOLTIPS = 2048 +STATUSCLASSNAMEA = "msctls_statusbar32" +STATUSCLASSNAME = STATUSCLASSNAMEA +SB_SETTEXTA = WM_USER + 1 +SB_SETTEXTW = WM_USER + 11 +SB_GETTEXTA = WM_USER + 2 +SB_GETTEXTW = WM_USER + 13 +SB_GETTEXTLENGTHA = WM_USER + 3 +SB_GETTEXTLENGTHW = WM_USER + 12 +SB_GETTEXT = SB_GETTEXTA +SB_SETTEXT = SB_SETTEXTA +SB_GETTEXTLENGTH = SB_GETTEXTLENGTHA +SB_SETPARTS = WM_USER + 4 +SB_GETPARTS = WM_USER + 6 +SB_GETBORDERS = WM_USER + 7 +SB_SETMINHEIGHT = WM_USER + 8 +SB_SIMPLE = WM_USER + 9 +SB_GETRECT = WM_USER + 10 +SB_ISSIMPLE = WM_USER + 14 +SB_SETICON = WM_USER + 15 +SB_SETTIPTEXTA = WM_USER + 16 +SB_SETTIPTEXTW = WM_USER + 17 +SB_GETTIPTEXTA = WM_USER + 18 +SB_GETTIPTEXTW = WM_USER + 19 +SB_GETICON = WM_USER + 20 +SB_SETTIPTEXT = SB_SETTIPTEXTA +SB_GETTIPTEXT = SB_GETTIPTEXTA +SB_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT +SB_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT +SBT_OWNERDRAW = 4096 +SBT_NOBORDERS = 256 +SBT_POPOUT = 512 +SBT_RTLREADING = 1024 +SBT_NOTABPARSING = 2048 +SBT_TOOLTIPS = 2048 +SB_SETBKCOLOR = CCM_SETBKCOLOR # lParam = bkColor +SBN_SIMPLEMODECHANGE = SBN_FIRST - 0 +TRACKBAR_CLASSA = "msctls_trackbar32" +TRACKBAR_CLASS = TRACKBAR_CLASSA +TBS_AUTOTICKS = 1 +TBS_VERT = 2 +TBS_HORZ = 0 +TBS_TOP = 4 +TBS_BOTTOM = 0 +TBS_LEFT = 4 +TBS_RIGHT = 0 +TBS_BOTH = 8 +TBS_NOTICKS = 16 +TBS_ENABLESELRANGE = 32 +TBS_FIXEDLENGTH = 64 +TBS_NOTHUMB = 128 +TBS_TOOLTIPS = 256 +TBM_GETPOS = WM_USER +TBM_GETRANGEMIN = WM_USER + 1 +TBM_GETRANGEMAX = WM_USER + 2 +TBM_GETTIC = WM_USER + 3 +TBM_SETTIC = WM_USER + 4 +TBM_SETPOS = WM_USER + 5 +TBM_SETRANGE = WM_USER + 6 +TBM_SETRANGEMIN = WM_USER + 7 +TBM_SETRANGEMAX = WM_USER + 8 +TBM_CLEARTICS = WM_USER + 9 +TBM_SETSEL = WM_USER + 10 +TBM_SETSELSTART = WM_USER + 11 +TBM_SETSELEND = WM_USER + 12 +TBM_GETPTICS = WM_USER + 14 +TBM_GETTICPOS = WM_USER + 15 +TBM_GETNUMTICS = WM_USER + 16 +TBM_GETSELSTART = WM_USER + 17 +TBM_GETSELEND = WM_USER + 18 +TBM_CLEARSEL = WM_USER + 19 +TBM_SETTICFREQ = WM_USER + 20 +TBM_SETPAGESIZE = WM_USER + 21 +TBM_GETPAGESIZE = WM_USER + 22 +TBM_SETLINESIZE = WM_USER + 23 +TBM_GETLINESIZE = WM_USER + 24 +TBM_GETTHUMBRECT = WM_USER + 25 +TBM_GETCHANNELRECT = WM_USER + 26 +TBM_SETTHUMBLENGTH = WM_USER + 27 +TBM_GETTHUMBLENGTH = WM_USER + 28 +TBM_SETTOOLTIPS = WM_USER + 29 +TBM_GETTOOLTIPS = WM_USER + 30 +TBM_SETTIPSIDE = WM_USER + 31 +TBTS_TOP = 0 +TBTS_LEFT = 1 +TBTS_BOTTOM = 2 +TBTS_RIGHT = 3 +TBM_SETBUDDY = WM_USER + 32 # wparam = BOOL fLeft; (or right) +TBM_GETBUDDY = WM_USER + 33 # wparam = BOOL fLeft; (or right) +TBM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT +TBM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT +TB_LINEUP = 0 +TB_LINEDOWN = 1 +TB_PAGEUP = 2 +TB_PAGEDOWN = 3 +TB_THUMBPOSITION = 4 +TB_THUMBTRACK = 5 +TB_TOP = 6 +TB_BOTTOM = 7 +TB_ENDTRACK = 8 +TBCD_TICS = 1 +TBCD_THUMB = 2 +TBCD_CHANNEL = 3 +DL_BEGINDRAG = WM_USER + 133 +DL_DRAGGING = WM_USER + 134 +DL_DROPPED = WM_USER + 135 +DL_CANCELDRAG = WM_USER + 136 +DL_CURSORSET = 0 +DL_STOPCURSOR = 1 +DL_COPYCURSOR = 2 +DL_MOVECURSOR = 3 +DRAGLISTMSGSTRING = "commctrl_DragListMsg" +UPDOWN_CLASSA = "msctls_updown32" +UPDOWN_CLASS = UPDOWN_CLASSA +UD_MAXVAL = 32767 +UD_MINVAL = -UD_MAXVAL +UDS_WRAP = 1 +UDS_SETBUDDYINT = 2 +UDS_ALIGNRIGHT = 4 +UDS_ALIGNLEFT = 8 +UDS_AUTOBUDDY = 16 +UDS_ARROWKEYS = 32 +UDS_HORZ = 64 +UDS_NOTHOUSANDS = 128 +UDS_HOTTRACK = 256 +UDM_SETRANGE = WM_USER + 101 +UDM_GETRANGE = WM_USER + 102 +UDM_SETPOS = WM_USER + 103 +UDM_GETPOS = WM_USER + 104 +UDM_SETBUDDY = WM_USER + 105 +UDM_GETBUDDY = WM_USER + 106 +UDM_SETACCEL = WM_USER + 107 +UDM_GETACCEL = WM_USER + 108 +UDM_SETBASE = WM_USER + 109 +UDM_GETBASE = WM_USER + 110 +UDM_SETRANGE32 = WM_USER + 111 +UDM_GETRANGE32 = WM_USER + 112 # wParam & lParam are LPINT +UDM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT +UDM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT +UDN_DELTAPOS = UDN_FIRST - 1 +PROGRESS_CLASSA = "msctls_progress32" +PROGRESS_CLASS = PROGRESS_CLASSA +PBS_SMOOTH = 1 +PBS_VERTICAL = 4 +PBM_SETRANGE = WM_USER + 1 +PBM_SETPOS = WM_USER + 2 +PBM_DELTAPOS = WM_USER + 3 +PBM_SETSTEP = WM_USER + 4 +PBM_STEPIT = WM_USER + 5 +PBM_SETRANGE32 = WM_USER + 6 # lParam = high, wParam = low +PBM_GETRANGE = ( + WM_USER + 7 +) # wParam = return (TRUE ? low : high). lParam = PPBRANGE or NULL +PBM_GETPOS = WM_USER + 8 +PBM_SETBARCOLOR = WM_USER + 9 # lParam = bar color +PBM_SETBKCOLOR = CCM_SETBKCOLOR # lParam = bkColor +HOTKEYF_SHIFT = 1 +HOTKEYF_CONTROL = 2 +HOTKEYF_ALT = 4 +HOTKEYF_EXT = 8 +HKCOMB_NONE = 1 +HKCOMB_S = 2 +HKCOMB_C = 4 +HKCOMB_A = 8 +HKCOMB_SC = 16 +HKCOMB_SA = 32 +HKCOMB_CA = 64 +HKCOMB_SCA = 128 +HKM_SETHOTKEY = WM_USER + 1 +HKM_GETHOTKEY = WM_USER + 2 +HKM_SETRULES = WM_USER + 3 +HOTKEY_CLASSA = "msctls_hotkey32" +HOTKEY_CLASS = HOTKEY_CLASSA +CCS_TOP = 0x00000001 +CCS_NOMOVEY = 0x00000002 +CCS_BOTTOM = 0x00000003 +CCS_NORESIZE = 0x00000004 +CCS_NOPARENTALIGN = 0x00000008 +CCS_ADJUSTABLE = 0x00000020 +CCS_NODIVIDER = 0x00000040 +CCS_VERT = 0x00000080 +CCS_LEFT = CCS_VERT | CCS_TOP +CCS_RIGHT = CCS_VERT | CCS_BOTTOM +CCS_NOMOVEX = CCS_VERT | CCS_NOMOVEY +WC_LISTVIEWA = "SysListView32" +WC_LISTVIEW = WC_LISTVIEWA +LVS_ICON = 0 +LVS_REPORT = 1 +LVS_SMALLICON = 2 +LVS_LIST = 3 +LVS_TYPEMASK = 3 +LVS_SINGLESEL = 4 +LVS_SHOWSELALWAYS = 8 +LVS_SORTASCENDING = 16 +LVS_SORTDESCENDING = 32 +LVS_SHAREIMAGELISTS = 64 +LVS_NOLABELWRAP = 128 +LVS_AUTOARRANGE = 256 +LVS_EDITLABELS = 512 +LVS_OWNERDATA = 4096 +LVS_NOSCROLL = 8192 +LVS_TYPESTYLEMASK = 64512 +LVS_ALIGNTOP = 0 +LVS_ALIGNLEFT = 2048 +LVS_ALIGNMASK = 3072 +LVS_OWNERDRAWFIXED = 1024 +LVS_NOCOLUMNHEADER = 16384 +LVS_NOSORTHEADER = 32768 +LVM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT +LVM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT +LVM_GETBKCOLOR = LVM_FIRST + 0 +LVM_SETBKCOLOR = LVM_FIRST + 1 +LVM_GETIMAGELIST = LVM_FIRST + 2 +LVSIL_NORMAL = 0 +LVSIL_SMALL = 1 +LVSIL_STATE = 2 +LVM_SETIMAGELIST = LVM_FIRST + 3 +LVM_GETITEMCOUNT = LVM_FIRST + 4 +LVIF_TEXT = 1 +LVIF_IMAGE = 2 +LVIF_PARAM = 4 +LVIF_STATE = 8 +LVIF_INDENT = 16 +LVIF_NORECOMPUTE = 2048 +LVIS_FOCUSED = 1 +LVIS_SELECTED = 2 +LVIS_CUT = 4 +LVIS_DROPHILITED = 8 +LVIS_ACTIVATING = 32 +LVIS_OVERLAYMASK = 3840 +LVIS_STATEIMAGEMASK = 61440 +I_INDENTCALLBACK = -1 +LPSTR_TEXTCALLBACKA = -1 +LPSTR_TEXTCALLBACK = LPSTR_TEXTCALLBACKA +I_IMAGECALLBACK = -1 +LVM_GETITEMA = LVM_FIRST + 5 +LVM_GETITEMW = LVM_FIRST + 75 +LVM_GETITEM = LVM_GETITEMA +LVM_SETITEMA = LVM_FIRST + 6 +LVM_SETITEMW = LVM_FIRST + 76 +LVM_SETITEM = LVM_SETITEMA +LVM_INSERTITEMA = LVM_FIRST + 7 +LVM_INSERTITEMW = LVM_FIRST + 77 +LVM_INSERTITEM = LVM_INSERTITEMA +LVM_DELETEITEM = LVM_FIRST + 8 +LVM_DELETEALLITEMS = LVM_FIRST + 9 +LVM_GETCALLBACKMASK = LVM_FIRST + 10 +LVM_SETCALLBACKMASK = LVM_FIRST + 11 +LVNI_ALL = 0 +LVNI_FOCUSED = 1 +LVNI_SELECTED = 2 +LVNI_CUT = 4 +LVNI_DROPHILITED = 8 +LVNI_ABOVE = 256 +LVNI_BELOW = 512 +LVNI_TOLEFT = 1024 +LVNI_TORIGHT = 2048 +LVM_GETNEXTITEM = LVM_FIRST + 12 +LVFI_PARAM = 1 +LVFI_STRING = 2 +LVFI_PARTIAL = 8 +LVFI_WRAP = 32 +LVFI_NEARESTXY = 64 +LVM_FINDITEMA = LVM_FIRST + 13 +LVM_FINDITEMW = LVM_FIRST + 83 +LVM_FINDITEM = LVM_FINDITEMA +LVIR_BOUNDS = 0 +LVIR_ICON = 1 +LVIR_LABEL = 2 +LVIR_SELECTBOUNDS = 3 +LVM_GETITEMRECT = LVM_FIRST + 14 +LVM_SETITEMPOSITION = LVM_FIRST + 15 +LVM_GETITEMPOSITION = LVM_FIRST + 16 +LVM_GETSTRINGWIDTHA = LVM_FIRST + 17 +LVM_GETSTRINGWIDTHW = LVM_FIRST + 87 +LVM_GETSTRINGWIDTH = LVM_GETSTRINGWIDTHA +LVHT_NOWHERE = 1 +LVHT_ONITEMICON = 2 +LVHT_ONITEMLABEL = 4 +LVHT_ONITEMSTATEICON = 8 +LVHT_ONITEM = LVHT_ONITEMICON | LVHT_ONITEMLABEL | LVHT_ONITEMSTATEICON +LVHT_ABOVE = 8 +LVHT_BELOW = 16 +LVHT_TORIGHT = 32 +LVHT_TOLEFT = 64 +LVM_HITTEST = LVM_FIRST + 18 +LVM_ENSUREVISIBLE = LVM_FIRST + 19 +LVM_SCROLL = LVM_FIRST + 20 +LVM_REDRAWITEMS = LVM_FIRST + 21 +LVA_DEFAULT = 0 +LVA_ALIGNLEFT = 1 +LVA_ALIGNTOP = 2 +LVA_SNAPTOGRID = 5 +LVM_ARRANGE = LVM_FIRST + 22 +LVM_EDITLABELA = LVM_FIRST + 23 +LVM_EDITLABELW = LVM_FIRST + 118 +LVM_EDITLABEL = LVM_EDITLABELA +LVM_GETEDITCONTROL = LVM_FIRST + 24 +LVCF_FMT = 1 +LVCF_WIDTH = 2 +LVCF_TEXT = 4 +LVCF_SUBITEM = 8 +LVCF_IMAGE = 16 +LVCF_ORDER = 32 +LVCFMT_LEFT = 0 +LVCFMT_RIGHT = 1 +LVCFMT_CENTER = 2 +LVCFMT_JUSTIFYMASK = 3 +LVCFMT_IMAGE = 2048 +LVCFMT_BITMAP_ON_RIGHT = 4096 +LVCFMT_COL_HAS_IMAGES = 32768 +LVM_GETCOLUMNA = LVM_FIRST + 25 +LVM_GETCOLUMNW = LVM_FIRST + 95 +LVM_GETCOLUMN = LVM_GETCOLUMNA +LVM_SETCOLUMNA = LVM_FIRST + 26 +LVM_SETCOLUMNW = LVM_FIRST + 96 +LVM_SETCOLUMN = LVM_SETCOLUMNA +LVM_INSERTCOLUMNA = LVM_FIRST + 27 +LVM_INSERTCOLUMNW = LVM_FIRST + 97 +LVM_INSERTCOLUMN = LVM_INSERTCOLUMNA +LVM_DELETECOLUMN = LVM_FIRST + 28 +LVM_GETCOLUMNWIDTH = LVM_FIRST + 29 +LVSCW_AUTOSIZE = -1 +LVSCW_AUTOSIZE_USEHEADER = -2 +LVM_SETCOLUMNWIDTH = LVM_FIRST + 30 +LVM_GETHEADER = LVM_FIRST + 31 +LVM_CREATEDRAGIMAGE = LVM_FIRST + 33 +LVM_GETVIEWRECT = LVM_FIRST + 34 +LVM_GETTEXTCOLOR = LVM_FIRST + 35 +LVM_SETTEXTCOLOR = LVM_FIRST + 36 +LVM_GETTEXTBKCOLOR = LVM_FIRST + 37 +LVM_SETTEXTBKCOLOR = LVM_FIRST + 38 +LVM_GETTOPINDEX = LVM_FIRST + 39 +LVM_GETCOUNTPERPAGE = LVM_FIRST + 40 +LVM_GETORIGIN = LVM_FIRST + 41 +LVM_UPDATE = LVM_FIRST + 42 +LVM_SETITEMSTATE = LVM_FIRST + 43 +LVM_GETITEMSTATE = LVM_FIRST + 44 +LVM_GETITEMTEXTA = LVM_FIRST + 45 +LVM_GETITEMTEXTW = LVM_FIRST + 115 +LVM_GETITEMTEXT = LVM_GETITEMTEXTA +LVM_SETITEMTEXTA = LVM_FIRST + 46 +LVM_SETITEMTEXTW = LVM_FIRST + 116 +LVM_SETITEMTEXT = LVM_SETITEMTEXTA +LVSICF_NOINVALIDATEALL = 1 +LVSICF_NOSCROLL = 2 +LVM_SETITEMCOUNT = LVM_FIRST + 47 +LVM_SORTITEMS = LVM_FIRST + 48 +LVM_SETITEMPOSITION32 = LVM_FIRST + 49 +LVM_GETSELECTEDCOUNT = LVM_FIRST + 50 +LVM_GETITEMSPACING = LVM_FIRST + 51 +LVM_GETISEARCHSTRINGA = LVM_FIRST + 52 +LVM_GETISEARCHSTRINGW = LVM_FIRST + 117 +LVM_GETISEARCHSTRING = LVM_GETISEARCHSTRINGA +LVM_SETICONSPACING = LVM_FIRST + 53 +LVM_SETEXTENDEDLISTVIEWSTYLE = LVM_FIRST + 54 # optional wParam == mask +LVM_GETEXTENDEDLISTVIEWSTYLE = LVM_FIRST + 55 +LVS_EX_GRIDLINES = 1 +LVS_EX_SUBITEMIMAGES = 2 +LVS_EX_CHECKBOXES = 4 +LVS_EX_TRACKSELECT = 8 +LVS_EX_HEADERDRAGDROP = 16 +LVS_EX_FULLROWSELECT = 32 # applies to report mode only +LVS_EX_ONECLICKACTIVATE = 64 +LVS_EX_TWOCLICKACTIVATE = 128 +LVS_EX_FLATSB = 256 +LVS_EX_REGIONAL = 512 +LVS_EX_INFOTIP = 1024 # listview does InfoTips for you +LVS_EX_UNDERLINEHOT = 2048 +LVS_EX_UNDERLINECOLD = 4096 +LVS_EX_MULTIWORKAREAS = 8192 +LVM_GETSUBITEMRECT = LVM_FIRST + 56 +LVM_SUBITEMHITTEST = LVM_FIRST + 57 +LVM_SETCOLUMNORDERARRAY = LVM_FIRST + 58 +LVM_GETCOLUMNORDERARRAY = LVM_FIRST + 59 +LVM_SETHOTITEM = LVM_FIRST + 60 +LVM_GETHOTITEM = LVM_FIRST + 61 +LVM_SETHOTCURSOR = LVM_FIRST + 62 +LVM_GETHOTCURSOR = LVM_FIRST + 63 +LVM_APPROXIMATEVIEWRECT = LVM_FIRST + 64 +LV_MAX_WORKAREAS = 16 +LVM_SETWORKAREAS = LVM_FIRST + 65 +LVM_GETWORKAREAS = LVM_FIRST + 70 +LVM_GETNUMBEROFWORKAREAS = LVM_FIRST + 73 +LVM_GETSELECTIONMARK = LVM_FIRST + 66 +LVM_SETSELECTIONMARK = LVM_FIRST + 67 +LVM_SETHOVERTIME = LVM_FIRST + 71 +LVM_GETHOVERTIME = LVM_FIRST + 72 +LVM_SETTOOLTIPS = LVM_FIRST + 74 +LVM_GETTOOLTIPS = LVM_FIRST + 78 +LVBKIF_SOURCE_NONE = 0 +LVBKIF_SOURCE_HBITMAP = 1 +LVBKIF_SOURCE_URL = 2 +LVBKIF_SOURCE_MASK = 3 +LVBKIF_STYLE_NORMAL = 0 +LVBKIF_STYLE_TILE = 16 +LVBKIF_STYLE_MASK = 16 +LVM_SETBKIMAGEA = LVM_FIRST + 68 +LVM_SETBKIMAGEW = LVM_FIRST + 138 +LVM_GETBKIMAGEA = LVM_FIRST + 69 +LVM_GETBKIMAGEW = LVM_FIRST + 139 +LVKF_ALT = 1 +LVKF_CONTROL = 2 +LVKF_SHIFT = 4 +LVN_ITEMCHANGING = LVN_FIRST - 0 +LVN_ITEMCHANGED = LVN_FIRST - 1 +LVN_INSERTITEM = LVN_FIRST - 2 +LVN_DELETEITEM = LVN_FIRST - 3 +LVN_DELETEALLITEMS = LVN_FIRST - 4 +LVN_BEGINLABELEDITA = LVN_FIRST - 5 +LVN_BEGINLABELEDITW = LVN_FIRST - 75 +LVN_ENDLABELEDITA = LVN_FIRST - 6 +LVN_ENDLABELEDITW = LVN_FIRST - 76 +LVN_COLUMNCLICK = LVN_FIRST - 8 +LVN_BEGINDRAG = LVN_FIRST - 9 +LVN_BEGINRDRAG = LVN_FIRST - 11 +LVN_ODCACHEHINT = LVN_FIRST - 13 +LVN_ODFINDITEMA = LVN_FIRST - 52 +LVN_ODFINDITEMW = LVN_FIRST - 79 +LVN_ITEMACTIVATE = LVN_FIRST - 14 +LVN_ODSTATECHANGED = LVN_FIRST - 15 +LVN_ODFINDITEM = LVN_ODFINDITEMA +LVN_HOTTRACK = LVN_FIRST - 21 +LVN_GETDISPINFOA = LVN_FIRST - 50 +LVN_GETDISPINFOW = LVN_FIRST - 77 +LVN_SETDISPINFOA = LVN_FIRST - 51 +LVN_SETDISPINFOW = LVN_FIRST - 78 +LVN_BEGINLABELEDIT = LVN_BEGINLABELEDITA +LVN_ENDLABELEDIT = LVN_ENDLABELEDITA +LVN_GETDISPINFO = LVN_GETDISPINFOA +LVN_SETDISPINFO = LVN_SETDISPINFOA +LVIF_DI_SETITEM = 4096 +LVN_KEYDOWN = LVN_FIRST - 55 +LVN_MARQUEEBEGIN = LVN_FIRST - 56 +LVGIT_UNFOLDED = 1 +LVN_GETINFOTIPA = LVN_FIRST - 57 +LVN_GETINFOTIPW = LVN_FIRST - 58 +LVN_GETINFOTIP = LVN_GETINFOTIPA +WC_TREEVIEWA = "SysTreeView32" +WC_TREEVIEW = WC_TREEVIEWA +TVS_HASBUTTONS = 1 +TVS_HASLINES = 2 +TVS_LINESATROOT = 4 +TVS_EDITLABELS = 8 +TVS_DISABLEDRAGDROP = 16 +TVS_SHOWSELALWAYS = 32 +TVS_RTLREADING = 64 +TVS_NOTOOLTIPS = 128 +TVS_CHECKBOXES = 256 +TVS_TRACKSELECT = 512 +TVS_SINGLEEXPAND = 1024 +TVS_INFOTIP = 2048 +TVS_FULLROWSELECT = 4096 +TVS_NOSCROLL = 8192 +TVS_NONEVENHEIGHT = 16384 +TVIF_TEXT = 1 +TVIF_IMAGE = 2 +TVIF_PARAM = 4 +TVIF_STATE = 8 +TVIF_HANDLE = 16 +TVIF_SELECTEDIMAGE = 32 +TVIF_CHILDREN = 64 +TVIF_INTEGRAL = 128 +TVIS_SELECTED = 2 +TVIS_CUT = 4 +TVIS_DROPHILITED = 8 +TVIS_BOLD = 16 +TVIS_EXPANDED = 32 +TVIS_EXPANDEDONCE = 64 +TVIS_EXPANDPARTIAL = 128 +TVIS_OVERLAYMASK = 3840 +TVIS_STATEIMAGEMASK = 61440 +TVIS_USERMASK = 61440 +I_CHILDRENCALLBACK = -1 +TVI_ROOT = -65536 +TVI_FIRST = -65535 +TVI_LAST = -65534 +TVI_SORT = -65533 +TVM_INSERTITEMA = TV_FIRST + 0 +TVM_INSERTITEMW = TV_FIRST + 50 +TVM_INSERTITEM = TVM_INSERTITEMA +TVM_DELETEITEM = TV_FIRST + 1 +TVM_EXPAND = TV_FIRST + 2 +TVE_COLLAPSE = 1 +TVE_EXPAND = 2 +TVE_TOGGLE = 3 +TVE_EXPANDPARTIAL = 16384 +TVE_COLLAPSERESET = 32768 +TVM_GETITEMRECT = TV_FIRST + 4 +TVM_GETCOUNT = TV_FIRST + 5 +TVM_GETINDENT = TV_FIRST + 6 +TVM_SETINDENT = TV_FIRST + 7 +TVM_GETIMAGELIST = TV_FIRST + 8 +TVSIL_NORMAL = 0 +TVSIL_STATE = 2 +TVM_SETIMAGELIST = TV_FIRST + 9 +TVM_GETNEXTITEM = TV_FIRST + 10 +TVGN_ROOT = 0 +TVGN_NEXT = 1 +TVGN_PREVIOUS = 2 +TVGN_PARENT = 3 +TVGN_CHILD = 4 +TVGN_FIRSTVISIBLE = 5 +TVGN_NEXTVISIBLE = 6 +TVGN_PREVIOUSVISIBLE = 7 +TVGN_DROPHILITE = 8 +TVGN_CARET = 9 +TVGN_LASTVISIBLE = 10 +TVM_SELECTITEM = TV_FIRST + 11 +TVM_GETITEMA = TV_FIRST + 12 +TVM_GETITEMW = TV_FIRST + 62 +TVM_GETITEM = TVM_GETITEMA +TVM_SETITEMA = TV_FIRST + 13 +TVM_SETITEMW = TV_FIRST + 63 +TVM_SETITEM = TVM_SETITEMA +TVM_EDITLABELA = TV_FIRST + 14 +TVM_EDITLABELW = TV_FIRST + 65 +TVM_EDITLABEL = TVM_EDITLABELA +TVM_GETEDITCONTROL = TV_FIRST + 15 +TVM_GETVISIBLECOUNT = TV_FIRST + 16 +TVM_HITTEST = TV_FIRST + 17 +TVHT_NOWHERE = 1 +TVHT_ONITEMICON = 2 +TVHT_ONITEMLABEL = 4 +TVHT_ONITEMINDENT = 8 +TVHT_ONITEMBUTTON = 16 +TVHT_ONITEMRIGHT = 32 +TVHT_ONITEMSTATEICON = 64 +TVHT_ABOVE = 256 +TVHT_BELOW = 512 +TVHT_TORIGHT = 1024 +TVHT_TOLEFT = 2048 +TVHT_ONITEM = TVHT_ONITEMICON | TVHT_ONITEMLABEL | TVHT_ONITEMSTATEICON +TVM_CREATEDRAGIMAGE = TV_FIRST + 18 +TVM_SORTCHILDREN = TV_FIRST + 19 +TVM_ENSUREVISIBLE = TV_FIRST + 20 +TVM_SORTCHILDRENCB = TV_FIRST + 21 +TVM_ENDEDITLABELNOW = TV_FIRST + 22 +TVM_GETISEARCHSTRINGA = TV_FIRST + 23 +TVM_GETISEARCHSTRINGW = TV_FIRST + 64 +TVM_GETISEARCHSTRING = TVM_GETISEARCHSTRINGA +TVM_SETTOOLTIPS = TV_FIRST + 24 +TVM_GETTOOLTIPS = TV_FIRST + 25 +TVM_SETINSERTMARK = TV_FIRST + 26 +TVM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT +TVM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT +TVM_SETITEMHEIGHT = TV_FIRST + 27 +TVM_GETITEMHEIGHT = TV_FIRST + 28 +TVM_SETBKCOLOR = TV_FIRST + 29 +TVM_SETTEXTCOLOR = TV_FIRST + 30 +TVM_GETBKCOLOR = TV_FIRST + 31 +TVM_GETTEXTCOLOR = TV_FIRST + 32 +TVM_SETSCROLLTIME = TV_FIRST + 33 +TVM_GETSCROLLTIME = TV_FIRST + 34 +TVM_SETINSERTMARKCOLOR = TV_FIRST + 37 +TVM_GETINSERTMARKCOLOR = TV_FIRST + 38 +TVN_SELCHANGINGA = TVN_FIRST - 1 +TVN_SELCHANGINGW = TVN_FIRST - 50 +TVN_SELCHANGEDA = TVN_FIRST - 2 +TVN_SELCHANGEDW = TVN_FIRST - 51 +TVC_UNKNOWN = 0 +TVC_BYMOUSE = 1 +TVC_BYKEYBOARD = 2 +TVN_GETDISPINFOA = TVN_FIRST - 3 +TVN_GETDISPINFOW = TVN_FIRST - 52 +TVN_SETDISPINFOA = TVN_FIRST - 4 +TVN_SETDISPINFOW = TVN_FIRST - 53 +TVIF_DI_SETITEM = 4096 +TVN_ITEMEXPANDINGA = TVN_FIRST - 5 +TVN_ITEMEXPANDINGW = TVN_FIRST - 54 +TVN_ITEMEXPANDEDA = TVN_FIRST - 6 +TVN_ITEMEXPANDEDW = TVN_FIRST - 55 +TVN_BEGINDRAGA = TVN_FIRST - 7 +TVN_BEGINDRAGW = TVN_FIRST - 56 +TVN_BEGINRDRAGA = TVN_FIRST - 8 +TVN_BEGINRDRAGW = TVN_FIRST - 57 +TVN_DELETEITEMA = TVN_FIRST - 9 +TVN_DELETEITEMW = TVN_FIRST - 58 +TVN_BEGINLABELEDITA = TVN_FIRST - 10 +TVN_BEGINLABELEDITW = TVN_FIRST - 59 +TVN_ENDLABELEDITA = TVN_FIRST - 11 +TVN_ENDLABELEDITW = TVN_FIRST - 60 +TVN_KEYDOWN = TVN_FIRST - 12 +TVN_GETINFOTIPA = TVN_FIRST - 13 +TVN_GETINFOTIPW = TVN_FIRST - 14 +TVN_SINGLEEXPAND = TVN_FIRST - 15 +TVN_SELCHANGING = TVN_SELCHANGINGA +TVN_SELCHANGED = TVN_SELCHANGEDA +TVN_GETDISPINFO = TVN_GETDISPINFOA +TVN_SETDISPINFO = TVN_SETDISPINFOA +TVN_ITEMEXPANDING = TVN_ITEMEXPANDINGA +TVN_ITEMEXPANDED = TVN_ITEMEXPANDEDA +TVN_BEGINDRAG = TVN_BEGINDRAGA +TVN_BEGINRDRAG = TVN_BEGINRDRAGA +TVN_DELETEITEM = TVN_DELETEITEMA +TVN_BEGINLABELEDIT = TVN_BEGINLABELEDITA +TVN_ENDLABELEDIT = TVN_ENDLABELEDITA +TVN_GETINFOTIP = TVN_GETINFOTIPA +TVCDRF_NOIMAGES = 65536 +WC_COMBOBOXEXA = "ComboBoxEx32" +WC_COMBOBOXEX = WC_COMBOBOXEXA +CBEIF_TEXT = 1 +CBEIF_IMAGE = 2 +CBEIF_SELECTEDIMAGE = 4 +CBEIF_OVERLAY = 8 +CBEIF_INDENT = 16 +CBEIF_LPARAM = 32 +CBEIF_DI_SETITEM = 268435456 +CBEM_INSERTITEMA = WM_USER + 1 +CBEM_SETIMAGELIST = WM_USER + 2 +CBEM_GETIMAGELIST = WM_USER + 3 +CBEM_GETITEMA = WM_USER + 4 +CBEM_SETITEMA = WM_USER + 5 +# CBEM_DELETEITEM = CB_DELETESTRING +CBEM_GETCOMBOCONTROL = WM_USER + 6 +CBEM_GETEDITCONTROL = WM_USER + 7 +CBEM_SETEXSTYLE = WM_USER + 8 # use SETEXTENDEDSTYLE instead +CBEM_SETEXTENDEDSTYLE = WM_USER + 14 # lparam == new style, wParam (optional) == mask +CBEM_GETEXSTYLE = WM_USER + 9 # use GETEXTENDEDSTYLE instead +CBEM_GETEXTENDEDSTYLE = WM_USER + 9 +CBEM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT +CBEM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT +CBEM_HASEDITCHANGED = WM_USER + 10 +CBEM_INSERTITEMW = WM_USER + 11 +CBEM_SETITEMW = WM_USER + 12 +CBEM_GETITEMW = WM_USER + 13 +CBEM_INSERTITEM = CBEM_INSERTITEMA +CBEM_SETITEM = CBEM_SETITEMA +CBEM_GETITEM = CBEM_GETITEMA +CBES_EX_NOEDITIMAGE = 1 +CBES_EX_NOEDITIMAGEINDENT = 2 +CBES_EX_PATHWORDBREAKPROC = 4 +CBES_EX_NOSIZELIMIT = 8 +CBES_EX_CASESENSITIVE = 16 +CBEN_GETDISPINFO = CBEN_FIRST - 0 +CBEN_GETDISPINFOA = CBEN_FIRST - 0 +CBEN_INSERTITEM = CBEN_FIRST - 1 +CBEN_DELETEITEM = CBEN_FIRST - 2 +CBEN_BEGINEDIT = CBEN_FIRST - 4 +CBEN_ENDEDITA = CBEN_FIRST - 5 +CBEN_ENDEDITW = CBEN_FIRST - 6 +CBEN_GETDISPINFOW = CBEN_FIRST - 7 +CBEN_DRAGBEGINA = CBEN_FIRST - 8 +CBEN_DRAGBEGINW = CBEN_FIRST - 9 +CBEN_DRAGBEGIN = CBEN_DRAGBEGINA +CBEN_ENDEDIT = CBEN_ENDEDITA +CBENF_KILLFOCUS = 1 +CBENF_RETURN = 2 +CBENF_ESCAPE = 3 +CBENF_DROPDOWN = 4 +CBEMAXSTRLEN = 260 +WC_TABCONTROLA = "SysTabControl32" +WC_TABCONTROL = WC_TABCONTROLA +TCS_SCROLLOPPOSITE = 1 # assumes multiline tab +TCS_BOTTOM = 2 +TCS_RIGHT = 2 +TCS_MULTISELECT = 4 # allow multi-select in button mode +TCS_FLATBUTTONS = 8 +TCS_FORCEICONLEFT = 16 +TCS_FORCELABELLEFT = 32 +TCS_HOTTRACK = 64 +TCS_VERTICAL = 128 +TCS_TABS = 0 +TCS_BUTTONS = 256 +TCS_SINGLELINE = 0 +TCS_MULTILINE = 512 +TCS_RIGHTJUSTIFY = 0 +TCS_FIXEDWIDTH = 1024 +TCS_RAGGEDRIGHT = 2048 +TCS_FOCUSONBUTTONDOWN = 4096 +TCS_OWNERDRAWFIXED = 8192 +TCS_TOOLTIPS = 16384 +TCS_FOCUSNEVER = 32768 +TCS_EX_FLATSEPARATORS = 1 +TCS_EX_REGISTERDROP = 2 +TCM_GETIMAGELIST = TCM_FIRST + 2 +TCM_SETIMAGELIST = TCM_FIRST + 3 +TCM_GETITEMCOUNT = TCM_FIRST + 4 +TCIF_TEXT = 1 +TCIF_IMAGE = 2 +TCIF_RTLREADING = 4 +TCIF_PARAM = 8 +TCIF_STATE = 16 +TCIS_BUTTONPRESSED = 1 +TCIS_HIGHLIGHTED = 2 +TCM_GETITEMA = TCM_FIRST + 5 +TCM_GETITEMW = TCM_FIRST + 60 +TCM_GETITEM = TCM_GETITEMA +TCM_SETITEMA = TCM_FIRST + 6 +TCM_SETITEMW = TCM_FIRST + 61 +TCM_SETITEM = TCM_SETITEMA +TCM_INSERTITEMA = TCM_FIRST + 7 +TCM_INSERTITEMW = TCM_FIRST + 62 +TCM_INSERTITEM = TCM_INSERTITEMA +TCM_DELETEITEM = TCM_FIRST + 8 +TCM_DELETEALLITEMS = TCM_FIRST + 9 +TCM_GETITEMRECT = TCM_FIRST + 10 +TCM_GETCURSEL = TCM_FIRST + 11 +TCM_SETCURSEL = TCM_FIRST + 12 +TCHT_NOWHERE = 1 +TCHT_ONITEMICON = 2 +TCHT_ONITEMLABEL = 4 +TCHT_ONITEM = TCHT_ONITEMICON | TCHT_ONITEMLABEL +TCM_HITTEST = TCM_FIRST + 13 +TCM_SETITEMEXTRA = TCM_FIRST + 14 +TCM_ADJUSTRECT = TCM_FIRST + 40 +TCM_SETITEMSIZE = TCM_FIRST + 41 +TCM_REMOVEIMAGE = TCM_FIRST + 42 +TCM_SETPADDING = TCM_FIRST + 43 +TCM_GETROWCOUNT = TCM_FIRST + 44 +TCM_GETTOOLTIPS = TCM_FIRST + 45 +TCM_SETTOOLTIPS = TCM_FIRST + 46 +TCM_GETCURFOCUS = TCM_FIRST + 47 +TCM_SETCURFOCUS = TCM_FIRST + 48 +TCM_SETMINTABWIDTH = TCM_FIRST + 49 +TCM_DESELECTALL = TCM_FIRST + 50 +TCM_HIGHLIGHTITEM = TCM_FIRST + 51 +TCM_SETEXTENDEDSTYLE = TCM_FIRST + 52 # optional wParam == mask +TCM_GETEXTENDEDSTYLE = TCM_FIRST + 53 +TCM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT +TCM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT +TCN_KEYDOWN = TCN_FIRST - 0 +ANIMATE_CLASSA = "SysAnimate32" +ANIMATE_CLASS = ANIMATE_CLASSA +ACS_CENTER = 1 +ACS_TRANSPARENT = 2 +ACS_AUTOPLAY = 4 +ACS_TIMER = 8 # don't use threads... use timers +ACM_OPENA = WM_USER + 100 +ACM_OPENW = WM_USER + 103 +ACM_OPEN = ACM_OPENA +ACM_PLAY = WM_USER + 101 +ACM_STOP = WM_USER + 102 +ACN_START = 1 +ACN_STOP = 2 +MONTHCAL_CLASSA = "SysMonthCal32" +MONTHCAL_CLASS = MONTHCAL_CLASSA +MCM_FIRST = 4096 +MCM_GETCURSEL = MCM_FIRST + 1 +MCM_SETCURSEL = MCM_FIRST + 2 +MCM_GETMAXSELCOUNT = MCM_FIRST + 3 +MCM_SETMAXSELCOUNT = MCM_FIRST + 4 +MCM_GETSELRANGE = MCM_FIRST + 5 +MCM_SETSELRANGE = MCM_FIRST + 6 +MCM_GETMONTHRANGE = MCM_FIRST + 7 +MCM_SETDAYSTATE = MCM_FIRST + 8 +MCM_GETMINREQRECT = MCM_FIRST + 9 +MCM_SETCOLOR = MCM_FIRST + 10 +MCM_GETCOLOR = MCM_FIRST + 11 +MCSC_BACKGROUND = 0 # the background color (between months) +MCSC_TEXT = 1 # the dates +MCSC_TITLEBK = 2 # background of the title +MCSC_TITLETEXT = 3 +MCSC_MONTHBK = 4 # background within the month cal +MCSC_TRAILINGTEXT = 5 # the text color of header & trailing days +MCM_SETTODAY = MCM_FIRST + 12 +MCM_GETTODAY = MCM_FIRST + 13 +MCM_HITTEST = MCM_FIRST + 14 +MCHT_TITLE = 65536 +MCHT_CALENDAR = 131072 +MCHT_TODAYLINK = 196608 +MCHT_NEXT = 16777216 # these indicate that hitting +MCHT_PREV = 33554432 # here will go to the next/prev month +MCHT_NOWHERE = 0 +MCHT_TITLEBK = MCHT_TITLE +MCHT_TITLEMONTH = MCHT_TITLE | 1 +MCHT_TITLEYEAR = MCHT_TITLE | 2 +MCHT_TITLEBTNNEXT = MCHT_TITLE | MCHT_NEXT | 3 +MCHT_TITLEBTNPREV = MCHT_TITLE | MCHT_PREV | 3 +MCHT_CALENDARBK = MCHT_CALENDAR +MCHT_CALENDARDATE = MCHT_CALENDAR | 1 +MCHT_CALENDARDATENEXT = MCHT_CALENDARDATE | MCHT_NEXT +MCHT_CALENDARDATEPREV = MCHT_CALENDARDATE | MCHT_PREV +MCHT_CALENDARDAY = MCHT_CALENDAR | 2 +MCHT_CALENDARWEEKNUM = MCHT_CALENDAR | 3 +MCM_SETFIRSTDAYOFWEEK = MCM_FIRST + 15 +MCM_GETFIRSTDAYOFWEEK = MCM_FIRST + 16 +MCM_GETRANGE = MCM_FIRST + 17 +MCM_SETRANGE = MCM_FIRST + 18 +MCM_GETMONTHDELTA = MCM_FIRST + 19 +MCM_SETMONTHDELTA = MCM_FIRST + 20 +MCM_GETMAXTODAYWIDTH = MCM_FIRST + 21 +MCM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT +MCM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT +MCN_SELCHANGE = MCN_FIRST + 1 +MCN_GETDAYSTATE = MCN_FIRST + 3 +MCN_SELECT = MCN_FIRST + 4 +MCS_DAYSTATE = 1 +MCS_MULTISELECT = 2 +MCS_WEEKNUMBERS = 4 +MCS_NOTODAYCIRCLE = 8 +MCS_NOTODAY = 8 +GMR_VISIBLE = 0 # visible portion of display +GMR_DAYSTATE = 1 # above plus the grayed out parts of +DATETIMEPICK_CLASSA = "SysDateTimePick32" +DATETIMEPICK_CLASS = DATETIMEPICK_CLASSA +DTM_FIRST = 4096 +DTM_GETSYSTEMTIME = DTM_FIRST + 1 +DTM_SETSYSTEMTIME = DTM_FIRST + 2 +DTM_GETRANGE = DTM_FIRST + 3 +DTM_SETRANGE = DTM_FIRST + 4 +DTM_SETFORMATA = DTM_FIRST + 5 +DTM_SETFORMATW = DTM_FIRST + 50 +DTM_SETFORMAT = DTM_SETFORMATA +DTM_SETMCCOLOR = DTM_FIRST + 6 +DTM_GETMCCOLOR = DTM_FIRST + 7 +DTM_GETMONTHCAL = DTM_FIRST + 8 +DTM_SETMCFONT = DTM_FIRST + 9 +DTM_GETMCFONT = DTM_FIRST + 10 +DTS_UPDOWN = 1 # use UPDOWN instead of MONTHCAL +DTS_SHOWNONE = 2 # allow a NONE selection +DTS_SHORTDATEFORMAT = ( + 0 # use the short date format (app must forward WM_WININICHANGE messages) +) +DTS_LONGDATEFORMAT = ( + 4 # use the long date format (app must forward WM_WININICHANGE messages) +) +DTS_TIMEFORMAT = 9 # use the time format (app must forward WM_WININICHANGE messages) +DTS_APPCANPARSE = 16 # allow user entered strings (app MUST respond to DTN_USERSTRING) +DTS_RIGHTALIGN = 32 # right-align popup instead of left-align it +DTN_DATETIMECHANGE = DTN_FIRST + 1 # the systemtime has changed +DTN_USERSTRINGA = DTN_FIRST + 2 # the user has entered a string +DTN_USERSTRINGW = DTN_FIRST + 15 +DTN_USERSTRING = DTN_USERSTRINGW +DTN_WMKEYDOWNA = DTN_FIRST + 3 # modify keydown on app format field (X) +DTN_WMKEYDOWNW = DTN_FIRST + 16 +DTN_WMKEYDOWN = DTN_WMKEYDOWNA +DTN_FORMATA = DTN_FIRST + 4 # query display for app format field (X) +DTN_FORMATW = DTN_FIRST + 17 +DTN_FORMAT = DTN_FORMATA +DTN_FORMATQUERYA = DTN_FIRST + 5 # query formatting info for app format field (X) +DTN_FORMATQUERYW = DTN_FIRST + 18 +DTN_FORMATQUERY = DTN_FORMATQUERYA +DTN_DROPDOWN = DTN_FIRST + 6 # MonthCal has dropped down +DTN_CLOSEUP = DTN_FIRST + 7 # MonthCal is popping up +GDTR_MIN = 1 +GDTR_MAX = 2 +GDT_ERROR = -1 +GDT_VALID = 0 +GDT_NONE = 1 +IPM_CLEARADDRESS = WM_USER + 100 # no parameters +IPM_SETADDRESS = WM_USER + 101 # lparam = TCP/IP address +IPM_GETADDRESS = ( + WM_USER + 102 +) # lresult = # of non black fields. lparam = LPDWORD for TCP/IP address +IPM_SETRANGE = WM_USER + 103 # wparam = field, lparam = range +IPM_SETFOCUS = WM_USER + 104 # wparam = field +IPM_ISBLANK = WM_USER + 105 # no parameters +WC_IPADDRESSA = "SysIPAddress32" +WC_IPADDRESS = WC_IPADDRESSA +IPN_FIELDCHANGED = IPN_FIRST - 0 +WC_PAGESCROLLERA = "SysPager" +WC_PAGESCROLLER = WC_PAGESCROLLERA +PGS_VERT = 0 +PGS_HORZ = 1 +PGS_AUTOSCROLL = 2 +PGS_DRAGNDROP = 4 +PGF_INVISIBLE = 0 # Scroll button is not visible +PGF_NORMAL = 1 # Scroll button is in normal state +PGF_GRAYED = 2 # Scroll button is in grayed state +PGF_DEPRESSED = 4 # Scroll button is in depressed state +PGF_HOT = 8 # Scroll button is in hot state +PGB_TOPORLEFT = 0 +PGB_BOTTOMORRIGHT = 1 +PGM_SETCHILD = PGM_FIRST + 1 # lParam == hwnd +PGM_RECALCSIZE = PGM_FIRST + 2 +PGM_FORWARDMOUSE = PGM_FIRST + 3 +PGM_SETBKCOLOR = PGM_FIRST + 4 +PGM_GETBKCOLOR = PGM_FIRST + 5 +PGM_SETBORDER = PGM_FIRST + 6 +PGM_GETBORDER = PGM_FIRST + 7 +PGM_SETPOS = PGM_FIRST + 8 +PGM_GETPOS = PGM_FIRST + 9 +PGM_SETBUTTONSIZE = PGM_FIRST + 10 +PGM_GETBUTTONSIZE = PGM_FIRST + 11 +PGM_GETBUTTONSTATE = PGM_FIRST + 12 +PGM_GETDROPTARGET = CCM_GETDROPTARGET +PGN_SCROLL = PGN_FIRST - 1 +PGF_SCROLLUP = 1 +PGF_SCROLLDOWN = 2 +PGF_SCROLLLEFT = 4 +PGF_SCROLLRIGHT = 8 +PGK_SHIFT = 1 +PGK_CONTROL = 2 +PGK_MENU = 4 +PGN_CALCSIZE = PGN_FIRST - 2 +PGF_CALCWIDTH = 1 +PGF_CALCHEIGHT = 2 +WC_NATIVEFONTCTLA = "NativeFontCtl" +WC_NATIVEFONTCTL = WC_NATIVEFONTCTLA +NFS_EDIT = 1 +NFS_STATIC = 2 +NFS_LISTCOMBO = 4 +NFS_BUTTON = 8 +NFS_ALL = 16 +WM_MOUSEHOVER = 673 +WM_MOUSELEAVE = 675 +TME_HOVER = 1 +TME_LEAVE = 2 +TME_QUERY = 1073741824 +TME_CANCEL = -2147483648 +HOVER_DEFAULT = -1 +WSB_PROP_CYVSCROLL = 0x00000001 +WSB_PROP_CXHSCROLL = 0x00000002 +WSB_PROP_CYHSCROLL = 0x00000004 +WSB_PROP_CXVSCROLL = 0x00000008 +WSB_PROP_CXHTHUMB = 0x00000010 +WSB_PROP_CYVTHUMB = 0x00000020 +WSB_PROP_VBKGCOLOR = 0x00000040 +WSB_PROP_HBKGCOLOR = 0x00000080 +WSB_PROP_VSTYLE = 0x00000100 +WSB_PROP_HSTYLE = 0x00000200 +WSB_PROP_WINSTYLE = 0x00000400 +WSB_PROP_PALETTE = 0x00000800 +WSB_PROP_MASK = 0x00000FFF +FSB_FLAT_MODE = 2 +FSB_ENCARTA_MODE = 1 +FSB_REGULAR_MODE = 0 + + +def INDEXTOOVERLAYMASK(i): + return i << 8 + + +def INDEXTOSTATEIMAGEMASK(i): + return i << 12 diff --git a/lib/win32/lib/dbi.py b/lib/win32/lib/dbi.py new file mode 100644 index 00000000..c33d6721 --- /dev/null +++ b/lib/win32/lib/dbi.py @@ -0,0 +1,27 @@ +""" +Skeleton replacement for removed dbi module. +Use of objects created by this module should be replaced with native Python objects. +Dates are now returned as datetime.datetime objects, but will still accept PyTime +objects also. +Raw data for binary fields should be passed as buffer objects for Python 2.x, +and memoryview objects in Py3k. +""" + +import warnings + +warnings.warn( + "dbi module is obsolete, code should now use native python datetime and buffer/memoryview objects", + DeprecationWarning, +) + +import datetime + +dbDate = dbiDate = datetime.datetime + +try: + dbRaw = dbiRaw = buffer +except NameError: + dbRaw = dbiRaw = memoryview + +# type names are still exported by odbc module +from odbc import * diff --git a/lib/win32/lib/mmsystem.py b/lib/win32/lib/mmsystem.py new file mode 100644 index 00000000..4d36b5ef --- /dev/null +++ b/lib/win32/lib/mmsystem.py @@ -0,0 +1,954 @@ +# Generated by h2py from d:/msdev/include/mmsystem.h +MAXPNAMELEN = 32 +MAXERRORLENGTH = 256 +MAX_JOYSTICKOEMVXDNAME = 260 +MM_MICROSOFT = 1 +MM_MIDI_MAPPER = 1 +MM_WAVE_MAPPER = 2 +MM_SNDBLST_MIDIOUT = 3 +MM_SNDBLST_MIDIIN = 4 +MM_SNDBLST_SYNTH = 5 +MM_SNDBLST_WAVEOUT = 6 +MM_SNDBLST_WAVEIN = 7 +MM_ADLIB = 9 +MM_MPU401_MIDIOUT = 10 +MM_MPU401_MIDIIN = 11 +MM_PC_JOYSTICK = 12 +TIME_MS = 0x0001 +TIME_SAMPLES = 0x0002 +TIME_BYTES = 0x0004 +TIME_SMPTE = 0x0008 +TIME_MIDI = 0x0010 +TIME_TICKS = 0x0020 +MM_JOY1MOVE = 0x3A0 +MM_JOY2MOVE = 0x3A1 +MM_JOY1ZMOVE = 0x3A2 +MM_JOY2ZMOVE = 0x3A3 +MM_JOY1BUTTONDOWN = 0x3B5 +MM_JOY2BUTTONDOWN = 0x3B6 +MM_JOY1BUTTONUP = 0x3B7 +MM_JOY2BUTTONUP = 0x3B8 +MM_MCINOTIFY = 0x3B9 +MM_WOM_OPEN = 0x3BB +MM_WOM_CLOSE = 0x3BC +MM_WOM_DONE = 0x3BD +MM_WIM_OPEN = 0x3BE +MM_WIM_CLOSE = 0x3BF +MM_WIM_DATA = 0x3C0 +MM_MIM_OPEN = 0x3C1 +MM_MIM_CLOSE = 0x3C2 +MM_MIM_DATA = 0x3C3 +MM_MIM_LONGDATA = 0x3C4 +MM_MIM_ERROR = 0x3C5 +MM_MIM_LONGERROR = 0x3C6 +MM_MOM_OPEN = 0x3C7 +MM_MOM_CLOSE = 0x3C8 +MM_MOM_DONE = 0x3C9 +MM_STREAM_OPEN = 0x3D4 +MM_STREAM_CLOSE = 0x3D5 +MM_STREAM_DONE = 0x3D6 +MM_STREAM_ERROR = 0x3D7 +MM_MOM_POSITIONCB = 0x3CA +MM_MIM_MOREDATA = 0x3CC +MM_MIXM_LINE_CHANGE = 0x3D0 +MM_MIXM_CONTROL_CHANGE = 0x3D1 +MMSYSERR_BASE = 0 +WAVERR_BASE = 32 +MIDIERR_BASE = 64 +TIMERR_BASE = 96 +JOYERR_BASE = 160 +MCIERR_BASE = 256 +MIXERR_BASE = 1024 +MCI_STRING_OFFSET = 512 +MCI_VD_OFFSET = 1024 +MCI_CD_OFFSET = 1088 +MCI_WAVE_OFFSET = 1152 +MCI_SEQ_OFFSET = 1216 +MMSYSERR_NOERROR = 0 +MMSYSERR_ERROR = MMSYSERR_BASE + 1 +MMSYSERR_BADDEVICEID = MMSYSERR_BASE + 2 +MMSYSERR_NOTENABLED = MMSYSERR_BASE + 3 +MMSYSERR_ALLOCATED = MMSYSERR_BASE + 4 +MMSYSERR_INVALHANDLE = MMSYSERR_BASE + 5 +MMSYSERR_NODRIVER = MMSYSERR_BASE + 6 +MMSYSERR_NOMEM = MMSYSERR_BASE + 7 +MMSYSERR_NOTSUPPORTED = MMSYSERR_BASE + 8 +MMSYSERR_BADERRNUM = MMSYSERR_BASE + 9 +MMSYSERR_INVALFLAG = MMSYSERR_BASE + 10 +MMSYSERR_INVALPARAM = MMSYSERR_BASE + 11 +MMSYSERR_HANDLEBUSY = MMSYSERR_BASE + 12 +MMSYSERR_INVALIDALIAS = MMSYSERR_BASE + 13 +MMSYSERR_BADDB = MMSYSERR_BASE + 14 +MMSYSERR_KEYNOTFOUND = MMSYSERR_BASE + 15 +MMSYSERR_READERROR = MMSYSERR_BASE + 16 +MMSYSERR_WRITEERROR = MMSYSERR_BASE + 17 +MMSYSERR_DELETEERROR = MMSYSERR_BASE + 18 +MMSYSERR_VALNOTFOUND = MMSYSERR_BASE + 19 +MMSYSERR_NODRIVERCB = MMSYSERR_BASE + 20 +MMSYSERR_LASTERROR = MMSYSERR_BASE + 20 +DRV_LOAD = 0x0001 +DRV_ENABLE = 0x0002 +DRV_OPEN = 0x0003 +DRV_CLOSE = 0x0004 +DRV_DISABLE = 0x0005 +DRV_FREE = 0x0006 +DRV_CONFIGURE = 0x0007 +DRV_QUERYCONFIGURE = 0x0008 +DRV_INSTALL = 0x0009 +DRV_REMOVE = 0x000A +DRV_EXITSESSION = 0x000B +DRV_POWER = 0x000F +DRV_RESERVED = 0x0800 +DRV_USER = 0x4000 +DRVCNF_CANCEL = 0x0000 +DRVCNF_OK = 0x0001 +DRVCNF_RESTART = 0x0002 +DRV_CANCEL = DRVCNF_CANCEL +DRV_OK = DRVCNF_OK +DRV_RESTART = DRVCNF_RESTART +DRV_MCI_FIRST = DRV_RESERVED +DRV_MCI_LAST = DRV_RESERVED + 0xFFF +CALLBACK_TYPEMASK = 0x00070000 +CALLBACK_NULL = 0x00000000 +CALLBACK_WINDOW = 0x00010000 +CALLBACK_TASK = 0x00020000 +CALLBACK_FUNCTION = 0x00030000 +CALLBACK_THREAD = CALLBACK_TASK +CALLBACK_EVENT = 0x00050000 +SND_SYNC = 0x0000 +SND_ASYNC = 0x0001 +SND_NODEFAULT = 0x0002 +SND_MEMORY = 0x0004 +SND_LOOP = 0x0008 +SND_NOSTOP = 0x0010 +SND_NOWAIT = 0x00002000 +SND_ALIAS = 0x00010000 +SND_ALIAS_ID = 0x00110000 +SND_FILENAME = 0x00020000 +SND_RESOURCE = 0x00040004 +SND_PURGE = 0x0040 +SND_APPLICATION = 0x0080 +SND_ALIAS_START = 0 +WAVERR_BADFORMAT = WAVERR_BASE + 0 +WAVERR_STILLPLAYING = WAVERR_BASE + 1 +WAVERR_UNPREPARED = WAVERR_BASE + 2 +WAVERR_SYNC = WAVERR_BASE + 3 +WAVERR_LASTERROR = WAVERR_BASE + 3 +WOM_OPEN = MM_WOM_OPEN +WOM_CLOSE = MM_WOM_CLOSE +WOM_DONE = MM_WOM_DONE +WIM_OPEN = MM_WIM_OPEN +WIM_CLOSE = MM_WIM_CLOSE +WIM_DATA = MM_WIM_DATA +WAVE_MAPPER = -1 # 0xFFFFFFFF +WAVE_FORMAT_QUERY = 0x0001 +WAVE_ALLOWSYNC = 0x0002 +WAVE_MAPPED = 0x0004 +WAVE_FORMAT_DIRECT = 0x0008 +WAVE_FORMAT_DIRECT_QUERY = WAVE_FORMAT_QUERY | WAVE_FORMAT_DIRECT +WHDR_DONE = 0x00000001 +WHDR_PREPARED = 0x00000002 +WHDR_BEGINLOOP = 0x00000004 +WHDR_ENDLOOP = 0x00000008 +WHDR_INQUEUE = 0x00000010 +WAVECAPS_PITCH = 0x0001 +WAVECAPS_PLAYBACKRATE = 0x0002 +WAVECAPS_VOLUME = 0x0004 +WAVECAPS_LRVOLUME = 0x0008 +WAVECAPS_SYNC = 0x0010 +WAVECAPS_SAMPLEACCURATE = 0x0020 +WAVECAPS_DIRECTSOUND = 0x0040 +WAVE_INVALIDFORMAT = 0x00000000 +WAVE_FORMAT_1M08 = 0x00000001 +WAVE_FORMAT_1S08 = 0x00000002 +WAVE_FORMAT_1M16 = 0x00000004 +WAVE_FORMAT_1S16 = 0x00000008 +WAVE_FORMAT_2M08 = 0x00000010 +WAVE_FORMAT_2S08 = 0x00000020 +WAVE_FORMAT_2M16 = 0x00000040 +WAVE_FORMAT_2S16 = 0x00000080 +WAVE_FORMAT_4M08 = 0x00000100 +WAVE_FORMAT_4S08 = 0x00000200 +WAVE_FORMAT_4M16 = 0x00000400 +WAVE_FORMAT_4S16 = 0x00000800 +WAVE_FORMAT_PCM = 1 +WAVE_FORMAT_IEEE_FLOAT = 3 +MIDIERR_UNPREPARED = MIDIERR_BASE + 0 +MIDIERR_STILLPLAYING = MIDIERR_BASE + 1 +MIDIERR_NOMAP = MIDIERR_BASE + 2 +MIDIERR_NOTREADY = MIDIERR_BASE + 3 +MIDIERR_NODEVICE = MIDIERR_BASE + 4 +MIDIERR_INVALIDSETUP = MIDIERR_BASE + 5 +MIDIERR_BADOPENMODE = MIDIERR_BASE + 6 +MIDIERR_DONT_CONTINUE = MIDIERR_BASE + 7 +MIDIERR_LASTERROR = MIDIERR_BASE + 7 +MIDIPATCHSIZE = 128 +MIM_OPEN = MM_MIM_OPEN +MIM_CLOSE = MM_MIM_CLOSE +MIM_DATA = MM_MIM_DATA +MIM_LONGDATA = MM_MIM_LONGDATA +MIM_ERROR = MM_MIM_ERROR +MIM_LONGERROR = MM_MIM_LONGERROR +MOM_OPEN = MM_MOM_OPEN +MOM_CLOSE = MM_MOM_CLOSE +MOM_DONE = MM_MOM_DONE +MIM_MOREDATA = MM_MIM_MOREDATA +MOM_POSITIONCB = MM_MOM_POSITIONCB +MIDI_IO_STATUS = 0x00000020 +MIDI_CACHE_ALL = 1 +MIDI_CACHE_BESTFIT = 2 +MIDI_CACHE_QUERY = 3 +MIDI_UNCACHE = 4 +MOD_MIDIPORT = 1 +MOD_SYNTH = 2 +MOD_SQSYNTH = 3 +MOD_FMSYNTH = 4 +MOD_MAPPER = 5 +MIDICAPS_VOLUME = 0x0001 +MIDICAPS_LRVOLUME = 0x0002 +MIDICAPS_CACHE = 0x0004 +MIDICAPS_STREAM = 0x0008 +MHDR_DONE = 0x00000001 +MHDR_PREPARED = 0x00000002 +MHDR_INQUEUE = 0x00000004 +MHDR_ISSTRM = 0x00000008 +MEVT_F_SHORT = 0x00000000 +MEVT_F_LONG = -2147483648 # 0x80000000 +MEVT_F_CALLBACK = 0x40000000 + + +def MEVT_EVENTTYPE(x): + return (BYTE)(((x) >> 24) & 0xFF) + + +def MEVT_EVENTPARM(x): + return (DWORD)((x) & 0x00FFFFFF) + + +MIDISTRM_ERROR = -2 +MIDIPROP_SET = -2147483648 # 0x80000000 +MIDIPROP_GET = 0x40000000 +MIDIPROP_TIMEDIV = 0x00000001 +MIDIPROP_TEMPO = 0x00000002 +AUXCAPS_CDAUDIO = 1 +AUXCAPS_AUXIN = 2 +AUXCAPS_VOLUME = 0x0001 +AUXCAPS_LRVOLUME = 0x0002 +MIXER_SHORT_NAME_CHARS = 16 +MIXER_LONG_NAME_CHARS = 64 +MIXERR_INVALLINE = MIXERR_BASE + 0 +MIXERR_INVALCONTROL = MIXERR_BASE + 1 +MIXERR_INVALVALUE = MIXERR_BASE + 2 +MIXERR_LASTERROR = MIXERR_BASE + 2 +MIXER_OBJECTF_HANDLE = -2147483648 # 0x80000000 +MIXER_OBJECTF_MIXER = 0x00000000 +MIXER_OBJECTF_HMIXER = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_MIXER +MIXER_OBJECTF_WAVEOUT = 0x10000000 +MIXER_OBJECTF_HWAVEOUT = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_WAVEOUT +MIXER_OBJECTF_WAVEIN = 0x20000000 +MIXER_OBJECTF_HWAVEIN = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_WAVEIN +MIXER_OBJECTF_MIDIOUT = 0x30000000 +MIXER_OBJECTF_HMIDIOUT = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_MIDIOUT +MIXER_OBJECTF_MIDIIN = 0x40000000 +MIXER_OBJECTF_HMIDIIN = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_MIDIIN +MIXER_OBJECTF_AUX = 0x50000000 +MIXERLINE_LINEF_ACTIVE = 0x00000001 +MIXERLINE_LINEF_DISCONNECTED = 0x00008000 +MIXERLINE_LINEF_SOURCE = -2147483648 # 0x80000000 +MIXERLINE_COMPONENTTYPE_DST_FIRST = 0x00000000 +MIXERLINE_COMPONENTTYPE_DST_UNDEFINED = MIXERLINE_COMPONENTTYPE_DST_FIRST + 0 +MIXERLINE_COMPONENTTYPE_DST_DIGITAL = MIXERLINE_COMPONENTTYPE_DST_FIRST + 1 +MIXERLINE_COMPONENTTYPE_DST_LINE = MIXERLINE_COMPONENTTYPE_DST_FIRST + 2 +MIXERLINE_COMPONENTTYPE_DST_MONITOR = MIXERLINE_COMPONENTTYPE_DST_FIRST + 3 +MIXERLINE_COMPONENTTYPE_DST_SPEAKERS = MIXERLINE_COMPONENTTYPE_DST_FIRST + 4 +MIXERLINE_COMPONENTTYPE_DST_HEADPHONES = MIXERLINE_COMPONENTTYPE_DST_FIRST + 5 +MIXERLINE_COMPONENTTYPE_DST_TELEPHONE = MIXERLINE_COMPONENTTYPE_DST_FIRST + 6 +MIXERLINE_COMPONENTTYPE_DST_WAVEIN = MIXERLINE_COMPONENTTYPE_DST_FIRST + 7 +MIXERLINE_COMPONENTTYPE_DST_VOICEIN = MIXERLINE_COMPONENTTYPE_DST_FIRST + 8 +MIXERLINE_COMPONENTTYPE_DST_LAST = MIXERLINE_COMPONENTTYPE_DST_FIRST + 8 +MIXERLINE_COMPONENTTYPE_SRC_FIRST = 0x00001000 +MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 0 +MIXERLINE_COMPONENTTYPE_SRC_DIGITAL = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 1 +MIXERLINE_COMPONENTTYPE_SRC_LINE = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 2 +MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 3 +MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 4 +MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 5 +MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 6 +MIXERLINE_COMPONENTTYPE_SRC_PCSPEAKER = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 7 +MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 8 +MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 9 +MIXERLINE_COMPONENTTYPE_SRC_ANALOG = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 10 +MIXERLINE_COMPONENTTYPE_SRC_LAST = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 10 +MIXERLINE_TARGETTYPE_UNDEFINED = 0 +MIXERLINE_TARGETTYPE_WAVEOUT = 1 +MIXERLINE_TARGETTYPE_WAVEIN = 2 +MIXERLINE_TARGETTYPE_MIDIOUT = 3 +MIXERLINE_TARGETTYPE_MIDIIN = 4 +MIXERLINE_TARGETTYPE_AUX = 5 +MIXER_GETLINEINFOF_DESTINATION = 0x00000000 +MIXER_GETLINEINFOF_SOURCE = 0x00000001 +MIXER_GETLINEINFOF_LINEID = 0x00000002 +MIXER_GETLINEINFOF_COMPONENTTYPE = 0x00000003 +MIXER_GETLINEINFOF_TARGETTYPE = 0x00000004 +MIXER_GETLINEINFOF_QUERYMASK = 0x0000000F +MIXERCONTROL_CONTROLF_UNIFORM = 0x00000001 +MIXERCONTROL_CONTROLF_MULTIPLE = 0x00000002 +MIXERCONTROL_CONTROLF_DISABLED = -2147483648 # 0x80000000 +MIXERCONTROL_CT_CLASS_MASK = -268435456 # 0xF0000000 +MIXERCONTROL_CT_CLASS_CUSTOM = 0x00000000 +MIXERCONTROL_CT_CLASS_METER = 0x10000000 +MIXERCONTROL_CT_CLASS_SWITCH = 0x20000000 +MIXERCONTROL_CT_CLASS_NUMBER = 0x30000000 +MIXERCONTROL_CT_CLASS_SLIDER = 0x40000000 +MIXERCONTROL_CT_CLASS_FADER = 0x50000000 +MIXERCONTROL_CT_CLASS_TIME = 0x60000000 +MIXERCONTROL_CT_CLASS_LIST = 0x70000000 +MIXERCONTROL_CT_SUBCLASS_MASK = 0x0F000000 +MIXERCONTROL_CT_SC_SWITCH_BOOLEAN = 0x00000000 +MIXERCONTROL_CT_SC_SWITCH_BUTTON = 0x01000000 +MIXERCONTROL_CT_SC_METER_POLLED = 0x00000000 +MIXERCONTROL_CT_SC_TIME_MICROSECS = 0x00000000 +MIXERCONTROL_CT_SC_TIME_MILLISECS = 0x01000000 +MIXERCONTROL_CT_SC_LIST_SINGLE = 0x00000000 +MIXERCONTROL_CT_SC_LIST_MULTIPLE = 0x01000000 +MIXERCONTROL_CT_UNITS_MASK = 0x00FF0000 +MIXERCONTROL_CT_UNITS_CUSTOM = 0x00000000 +MIXERCONTROL_CT_UNITS_BOOLEAN = 0x00010000 +MIXERCONTROL_CT_UNITS_SIGNED = 0x00020000 +MIXERCONTROL_CT_UNITS_UNSIGNED = 0x00030000 +MIXERCONTROL_CT_UNITS_DECIBELS = 0x00040000 +MIXERCONTROL_CT_UNITS_PERCENT = 0x00050000 +MIXERCONTROL_CONTROLTYPE_CUSTOM = ( + MIXERCONTROL_CT_CLASS_CUSTOM | MIXERCONTROL_CT_UNITS_CUSTOM +) +MIXERCONTROL_CONTROLTYPE_BOOLEANMETER = ( + MIXERCONTROL_CT_CLASS_METER + | MIXERCONTROL_CT_SC_METER_POLLED + | MIXERCONTROL_CT_UNITS_BOOLEAN +) +MIXERCONTROL_CONTROLTYPE_SIGNEDMETER = ( + MIXERCONTROL_CT_CLASS_METER + | MIXERCONTROL_CT_SC_METER_POLLED + | MIXERCONTROL_CT_UNITS_SIGNED +) +MIXERCONTROL_CONTROLTYPE_PEAKMETER = MIXERCONTROL_CONTROLTYPE_SIGNEDMETER + 1 +MIXERCONTROL_CONTROLTYPE_UNSIGNEDMETER = ( + MIXERCONTROL_CT_CLASS_METER + | MIXERCONTROL_CT_SC_METER_POLLED + | MIXERCONTROL_CT_UNITS_UNSIGNED +) +MIXERCONTROL_CONTROLTYPE_BOOLEAN = ( + MIXERCONTROL_CT_CLASS_SWITCH + | MIXERCONTROL_CT_SC_SWITCH_BOOLEAN + | MIXERCONTROL_CT_UNITS_BOOLEAN +) +MIXERCONTROL_CONTROLTYPE_ONOFF = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 1 +MIXERCONTROL_CONTROLTYPE_MUTE = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 2 +MIXERCONTROL_CONTROLTYPE_MONO = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 3 +MIXERCONTROL_CONTROLTYPE_LOUDNESS = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 4 +MIXERCONTROL_CONTROLTYPE_STEREOENH = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 5 +MIXERCONTROL_CONTROLTYPE_BUTTON = ( + MIXERCONTROL_CT_CLASS_SWITCH + | MIXERCONTROL_CT_SC_SWITCH_BUTTON + | MIXERCONTROL_CT_UNITS_BOOLEAN +) +MIXERCONTROL_CONTROLTYPE_DECIBELS = ( + MIXERCONTROL_CT_CLASS_NUMBER | MIXERCONTROL_CT_UNITS_DECIBELS +) +MIXERCONTROL_CONTROLTYPE_SIGNED = ( + MIXERCONTROL_CT_CLASS_NUMBER | MIXERCONTROL_CT_UNITS_SIGNED +) +MIXERCONTROL_CONTROLTYPE_UNSIGNED = ( + MIXERCONTROL_CT_CLASS_NUMBER | MIXERCONTROL_CT_UNITS_UNSIGNED +) +MIXERCONTROL_CONTROLTYPE_PERCENT = ( + MIXERCONTROL_CT_CLASS_NUMBER | MIXERCONTROL_CT_UNITS_PERCENT +) +MIXERCONTROL_CONTROLTYPE_SLIDER = ( + MIXERCONTROL_CT_CLASS_SLIDER | MIXERCONTROL_CT_UNITS_SIGNED +) +MIXERCONTROL_CONTROLTYPE_PAN = MIXERCONTROL_CONTROLTYPE_SLIDER + 1 +MIXERCONTROL_CONTROLTYPE_QSOUNDPAN = MIXERCONTROL_CONTROLTYPE_SLIDER + 2 +MIXERCONTROL_CONTROLTYPE_FADER = ( + MIXERCONTROL_CT_CLASS_FADER | MIXERCONTROL_CT_UNITS_UNSIGNED +) +MIXERCONTROL_CONTROLTYPE_VOLUME = MIXERCONTROL_CONTROLTYPE_FADER + 1 +MIXERCONTROL_CONTROLTYPE_BASS = MIXERCONTROL_CONTROLTYPE_FADER + 2 +MIXERCONTROL_CONTROLTYPE_TREBLE = MIXERCONTROL_CONTROLTYPE_FADER + 3 +MIXERCONTROL_CONTROLTYPE_EQUALIZER = MIXERCONTROL_CONTROLTYPE_FADER + 4 +MIXERCONTROL_CONTROLTYPE_SINGLESELECT = ( + MIXERCONTROL_CT_CLASS_LIST + | MIXERCONTROL_CT_SC_LIST_SINGLE + | MIXERCONTROL_CT_UNITS_BOOLEAN +) +MIXERCONTROL_CONTROLTYPE_MUX = MIXERCONTROL_CONTROLTYPE_SINGLESELECT + 1 +MIXERCONTROL_CONTROLTYPE_MULTIPLESELECT = ( + MIXERCONTROL_CT_CLASS_LIST + | MIXERCONTROL_CT_SC_LIST_MULTIPLE + | MIXERCONTROL_CT_UNITS_BOOLEAN +) +MIXERCONTROL_CONTROLTYPE_MIXER = MIXERCONTROL_CONTROLTYPE_MULTIPLESELECT + 1 +MIXERCONTROL_CONTROLTYPE_MICROTIME = ( + MIXERCONTROL_CT_CLASS_TIME + | MIXERCONTROL_CT_SC_TIME_MICROSECS + | MIXERCONTROL_CT_UNITS_UNSIGNED +) +MIXERCONTROL_CONTROLTYPE_MILLITIME = ( + MIXERCONTROL_CT_CLASS_TIME + | MIXERCONTROL_CT_SC_TIME_MILLISECS + | MIXERCONTROL_CT_UNITS_UNSIGNED +) +MIXER_GETLINECONTROLSF_ALL = 0x00000000 +MIXER_GETLINECONTROLSF_ONEBYID = 0x00000001 +MIXER_GETLINECONTROLSF_ONEBYTYPE = 0x00000002 +MIXER_GETLINECONTROLSF_QUERYMASK = 0x0000000F +MIXER_GETCONTROLDETAILSF_VALUE = 0x00000000 +MIXER_GETCONTROLDETAILSF_LISTTEXT = 0x00000001 +MIXER_GETCONTROLDETAILSF_QUERYMASK = 0x0000000F +MIXER_SETCONTROLDETAILSF_VALUE = 0x00000000 +MIXER_SETCONTROLDETAILSF_CUSTOM = 0x00000001 +MIXER_SETCONTROLDETAILSF_QUERYMASK = 0x0000000F +TIMERR_NOERROR = 0 +TIMERR_NOCANDO = TIMERR_BASE + 1 +TIMERR_STRUCT = TIMERR_BASE + 33 +TIME_ONESHOT = 0x0000 +TIME_PERIODIC = 0x0001 +TIME_CALLBACK_FUNCTION = 0x0000 +TIME_CALLBACK_EVENT_SET = 0x0010 +TIME_CALLBACK_EVENT_PULSE = 0x0020 +JOYERR_NOERROR = 0 +JOYERR_PARMS = JOYERR_BASE + 5 +JOYERR_NOCANDO = JOYERR_BASE + 6 +JOYERR_UNPLUGGED = JOYERR_BASE + 7 +JOY_BUTTON1 = 0x0001 +JOY_BUTTON2 = 0x0002 +JOY_BUTTON3 = 0x0004 +JOY_BUTTON4 = 0x0008 +JOY_BUTTON1CHG = 0x0100 +JOY_BUTTON2CHG = 0x0200 +JOY_BUTTON3CHG = 0x0400 +JOY_BUTTON4CHG = 0x0800 +JOY_BUTTON5 = 0x00000010 +JOY_BUTTON6 = 0x00000020 +JOY_BUTTON7 = 0x00000040 +JOY_BUTTON8 = 0x00000080 +JOY_BUTTON9 = 0x00000100 +JOY_BUTTON10 = 0x00000200 +JOY_BUTTON11 = 0x00000400 +JOY_BUTTON12 = 0x00000800 +JOY_BUTTON13 = 0x00001000 +JOY_BUTTON14 = 0x00002000 +JOY_BUTTON15 = 0x00004000 +JOY_BUTTON16 = 0x00008000 +JOY_BUTTON17 = 0x00010000 +JOY_BUTTON18 = 0x00020000 +JOY_BUTTON19 = 0x00040000 +JOY_BUTTON20 = 0x00080000 +JOY_BUTTON21 = 0x00100000 +JOY_BUTTON22 = 0x00200000 +JOY_BUTTON23 = 0x00400000 +JOY_BUTTON24 = 0x00800000 +JOY_BUTTON25 = 0x01000000 +JOY_BUTTON26 = 0x02000000 +JOY_BUTTON27 = 0x04000000 +JOY_BUTTON28 = 0x08000000 +JOY_BUTTON29 = 0x10000000 +JOY_BUTTON30 = 0x20000000 +JOY_BUTTON31 = 0x40000000 +JOY_BUTTON32 = -2147483648 # 0x80000000 +JOY_POVFORWARD = 0 +JOY_POVRIGHT = 9000 +JOY_POVBACKWARD = 18000 +JOY_POVLEFT = 27000 +JOY_RETURNX = 0x00000001 +JOY_RETURNY = 0x00000002 +JOY_RETURNZ = 0x00000004 +JOY_RETURNR = 0x00000008 +JOY_RETURNU = 0x00000010 +JOY_RETURNV = 0x00000020 +JOY_RETURNPOV = 0x00000040 +JOY_RETURNBUTTONS = 0x00000080 +JOY_RETURNRAWDATA = 0x00000100 +JOY_RETURNPOVCTS = 0x00000200 +JOY_RETURNCENTERED = 0x00000400 +JOY_USEDEADZONE = 0x00000800 +JOY_RETURNALL = ( + JOY_RETURNX + | JOY_RETURNY + | JOY_RETURNZ + | JOY_RETURNR + | JOY_RETURNU + | JOY_RETURNV + | JOY_RETURNPOV + | JOY_RETURNBUTTONS +) +JOY_CAL_READALWAYS = 0x00010000 +JOY_CAL_READXYONLY = 0x00020000 +JOY_CAL_READ3 = 0x00040000 +JOY_CAL_READ4 = 0x00080000 +JOY_CAL_READXONLY = 0x00100000 +JOY_CAL_READYONLY = 0x00200000 +JOY_CAL_READ5 = 0x00400000 +JOY_CAL_READ6 = 0x00800000 +JOY_CAL_READZONLY = 0x01000000 +JOY_CAL_READRONLY = 0x02000000 +JOY_CAL_READUONLY = 0x04000000 +JOY_CAL_READVONLY = 0x08000000 +JOYSTICKID1 = 0 +JOYSTICKID2 = 1 +JOYCAPS_HASZ = 0x0001 +JOYCAPS_HASR = 0x0002 +JOYCAPS_HASU = 0x0004 +JOYCAPS_HASV = 0x0008 +JOYCAPS_HASPOV = 0x0010 +JOYCAPS_POV4DIR = 0x0020 +JOYCAPS_POVCTS = 0x0040 +MMIOERR_BASE = 256 +MMIOERR_FILENOTFOUND = MMIOERR_BASE + 1 +MMIOERR_OUTOFMEMORY = MMIOERR_BASE + 2 +MMIOERR_CANNOTOPEN = MMIOERR_BASE + 3 +MMIOERR_CANNOTCLOSE = MMIOERR_BASE + 4 +MMIOERR_CANNOTREAD = MMIOERR_BASE + 5 +MMIOERR_CANNOTWRITE = MMIOERR_BASE + 6 +MMIOERR_CANNOTSEEK = MMIOERR_BASE + 7 +MMIOERR_CANNOTEXPAND = MMIOERR_BASE + 8 +MMIOERR_CHUNKNOTFOUND = MMIOERR_BASE + 9 +MMIOERR_UNBUFFERED = MMIOERR_BASE + 10 +MMIOERR_PATHNOTFOUND = MMIOERR_BASE + 11 +MMIOERR_ACCESSDENIED = MMIOERR_BASE + 12 +MMIOERR_SHARINGVIOLATION = MMIOERR_BASE + 13 +MMIOERR_NETWORKERROR = MMIOERR_BASE + 14 +MMIOERR_TOOMANYOPENFILES = MMIOERR_BASE + 15 +MMIOERR_INVALIDFILE = MMIOERR_BASE + 16 +CFSEPCHAR = ord("+") +MMIO_RWMODE = 0x00000003 +MMIO_SHAREMODE = 0x00000070 +MMIO_CREATE = 0x00001000 +MMIO_PARSE = 0x00000100 +MMIO_DELETE = 0x00000200 +MMIO_EXIST = 0x00004000 +MMIO_ALLOCBUF = 0x00010000 +MMIO_GETTEMP = 0x00020000 +MMIO_DIRTY = 0x10000000 +MMIO_READ = 0x00000000 +MMIO_WRITE = 0x00000001 +MMIO_READWRITE = 0x00000002 +MMIO_COMPAT = 0x00000000 +MMIO_EXCLUSIVE = 0x00000010 +MMIO_DENYWRITE = 0x00000020 +MMIO_DENYREAD = 0x00000030 +MMIO_DENYNONE = 0x00000040 +MMIO_FHOPEN = 0x0010 +MMIO_EMPTYBUF = 0x0010 +MMIO_TOUPPER = 0x0010 +MMIO_INSTALLPROC = 0x00010000 +MMIO_GLOBALPROC = 0x10000000 +MMIO_REMOVEPROC = 0x00020000 +MMIO_UNICODEPROC = 0x01000000 +MMIO_FINDPROC = 0x00040000 +MMIO_FINDCHUNK = 0x0010 +MMIO_FINDRIFF = 0x0020 +MMIO_FINDLIST = 0x0040 +MMIO_CREATERIFF = 0x0020 +MMIO_CREATELIST = 0x0040 +MMIOM_READ = MMIO_READ +MMIOM_WRITE = MMIO_WRITE +MMIOM_SEEK = 2 +MMIOM_OPEN = 3 +MMIOM_CLOSE = 4 +MMIOM_WRITEFLUSH = 5 +MMIOM_RENAME = 6 +MMIOM_USER = 0x8000 +SEEK_SET = 0 +SEEK_CUR = 1 +SEEK_END = 2 +MMIO_DEFAULTBUFFER = 8192 +MCIERR_INVALID_DEVICE_ID = MCIERR_BASE + 1 +MCIERR_UNRECOGNIZED_KEYWORD = MCIERR_BASE + 3 +MCIERR_UNRECOGNIZED_COMMAND = MCIERR_BASE + 5 +MCIERR_HARDWARE = MCIERR_BASE + 6 +MCIERR_INVALID_DEVICE_NAME = MCIERR_BASE + 7 +MCIERR_OUT_OF_MEMORY = MCIERR_BASE + 8 +MCIERR_DEVICE_OPEN = MCIERR_BASE + 9 +MCIERR_CANNOT_LOAD_DRIVER = MCIERR_BASE + 10 +MCIERR_MISSING_COMMAND_STRING = MCIERR_BASE + 11 +MCIERR_PARAM_OVERFLOW = MCIERR_BASE + 12 +MCIERR_MISSING_STRING_ARGUMENT = MCIERR_BASE + 13 +MCIERR_BAD_INTEGER = MCIERR_BASE + 14 +MCIERR_PARSER_INTERNAL = MCIERR_BASE + 15 +MCIERR_DRIVER_INTERNAL = MCIERR_BASE + 16 +MCIERR_MISSING_PARAMETER = MCIERR_BASE + 17 +MCIERR_UNSUPPORTED_FUNCTION = MCIERR_BASE + 18 +MCIERR_FILE_NOT_FOUND = MCIERR_BASE + 19 +MCIERR_DEVICE_NOT_READY = MCIERR_BASE + 20 +MCIERR_INTERNAL = MCIERR_BASE + 21 +MCIERR_DRIVER = MCIERR_BASE + 22 +MCIERR_CANNOT_USE_ALL = MCIERR_BASE + 23 +MCIERR_MULTIPLE = MCIERR_BASE + 24 +MCIERR_EXTENSION_NOT_FOUND = MCIERR_BASE + 25 +MCIERR_OUTOFRANGE = MCIERR_BASE + 26 +MCIERR_FLAGS_NOT_COMPATIBLE = MCIERR_BASE + 28 +MCIERR_FILE_NOT_SAVED = MCIERR_BASE + 30 +MCIERR_DEVICE_TYPE_REQUIRED = MCIERR_BASE + 31 +MCIERR_DEVICE_LOCKED = MCIERR_BASE + 32 +MCIERR_DUPLICATE_ALIAS = MCIERR_BASE + 33 +MCIERR_BAD_CONSTANT = MCIERR_BASE + 34 +MCIERR_MUST_USE_SHAREABLE = MCIERR_BASE + 35 +MCIERR_MISSING_DEVICE_NAME = MCIERR_BASE + 36 +MCIERR_BAD_TIME_FORMAT = MCIERR_BASE + 37 +MCIERR_NO_CLOSING_QUOTE = MCIERR_BASE + 38 +MCIERR_DUPLICATE_FLAGS = MCIERR_BASE + 39 +MCIERR_INVALID_FILE = MCIERR_BASE + 40 +MCIERR_NULL_PARAMETER_BLOCK = MCIERR_BASE + 41 +MCIERR_UNNAMED_RESOURCE = MCIERR_BASE + 42 +MCIERR_NEW_REQUIRES_ALIAS = MCIERR_BASE + 43 +MCIERR_NOTIFY_ON_AUTO_OPEN = MCIERR_BASE + 44 +MCIERR_NO_ELEMENT_ALLOWED = MCIERR_BASE + 45 +MCIERR_NONAPPLICABLE_FUNCTION = MCIERR_BASE + 46 +MCIERR_ILLEGAL_FOR_AUTO_OPEN = MCIERR_BASE + 47 +MCIERR_FILENAME_REQUIRED = MCIERR_BASE + 48 +MCIERR_EXTRA_CHARACTERS = MCIERR_BASE + 49 +MCIERR_DEVICE_NOT_INSTALLED = MCIERR_BASE + 50 +MCIERR_GET_CD = MCIERR_BASE + 51 +MCIERR_SET_CD = MCIERR_BASE + 52 +MCIERR_SET_DRIVE = MCIERR_BASE + 53 +MCIERR_DEVICE_LENGTH = MCIERR_BASE + 54 +MCIERR_DEVICE_ORD_LENGTH = MCIERR_BASE + 55 +MCIERR_NO_INTEGER = MCIERR_BASE + 56 +MCIERR_WAVE_OUTPUTSINUSE = MCIERR_BASE + 64 +MCIERR_WAVE_SETOUTPUTINUSE = MCIERR_BASE + 65 +MCIERR_WAVE_INPUTSINUSE = MCIERR_BASE + 66 +MCIERR_WAVE_SETINPUTINUSE = MCIERR_BASE + 67 +MCIERR_WAVE_OUTPUTUNSPECIFIED = MCIERR_BASE + 68 +MCIERR_WAVE_INPUTUNSPECIFIED = MCIERR_BASE + 69 +MCIERR_WAVE_OUTPUTSUNSUITABLE = MCIERR_BASE + 70 +MCIERR_WAVE_SETOUTPUTUNSUITABLE = MCIERR_BASE + 71 +MCIERR_WAVE_INPUTSUNSUITABLE = MCIERR_BASE + 72 +MCIERR_WAVE_SETINPUTUNSUITABLE = MCIERR_BASE + 73 +MCIERR_SEQ_DIV_INCOMPATIBLE = MCIERR_BASE + 80 +MCIERR_SEQ_PORT_INUSE = MCIERR_BASE + 81 +MCIERR_SEQ_PORT_NONEXISTENT = MCIERR_BASE + 82 +MCIERR_SEQ_PORT_MAPNODEVICE = MCIERR_BASE + 83 +MCIERR_SEQ_PORT_MISCERROR = MCIERR_BASE + 84 +MCIERR_SEQ_TIMER = MCIERR_BASE + 85 +MCIERR_SEQ_PORTUNSPECIFIED = MCIERR_BASE + 86 +MCIERR_SEQ_NOMIDIPRESENT = MCIERR_BASE + 87 +MCIERR_NO_WINDOW = MCIERR_BASE + 90 +MCIERR_CREATEWINDOW = MCIERR_BASE + 91 +MCIERR_FILE_READ = MCIERR_BASE + 92 +MCIERR_FILE_WRITE = MCIERR_BASE + 93 +MCIERR_NO_IDENTITY = MCIERR_BASE + 94 +MCIERR_CUSTOM_DRIVER_BASE = MCIERR_BASE + 256 +MCI_FIRST = DRV_MCI_FIRST +MCI_OPEN = 0x0803 +MCI_CLOSE = 0x0804 +MCI_ESCAPE = 0x0805 +MCI_PLAY = 0x0806 +MCI_SEEK = 0x0807 +MCI_STOP = 0x0808 +MCI_PAUSE = 0x0809 +MCI_INFO = 0x080A +MCI_GETDEVCAPS = 0x080B +MCI_SPIN = 0x080C +MCI_SET = 0x080D +MCI_STEP = 0x080E +MCI_RECORD = 0x080F +MCI_SYSINFO = 0x0810 +MCI_BREAK = 0x0811 +MCI_SAVE = 0x0813 +MCI_STATUS = 0x0814 +MCI_CUE = 0x0830 +MCI_REALIZE = 0x0840 +MCI_WINDOW = 0x0841 +MCI_PUT = 0x0842 +MCI_WHERE = 0x0843 +MCI_FREEZE = 0x0844 +MCI_UNFREEZE = 0x0845 +MCI_LOAD = 0x0850 +MCI_CUT = 0x0851 +MCI_COPY = 0x0852 +MCI_PASTE = 0x0853 +MCI_UPDATE = 0x0854 +MCI_RESUME = 0x0855 +MCI_DELETE = 0x0856 +MCI_USER_MESSAGES = DRV_MCI_FIRST + 0x400 +MCI_LAST = 0x0FFF +MCI_DEVTYPE_VCR = 513 +MCI_DEVTYPE_VIDEODISC = 514 +MCI_DEVTYPE_OVERLAY = 515 +MCI_DEVTYPE_CD_AUDIO = 516 +MCI_DEVTYPE_DAT = 517 +MCI_DEVTYPE_SCANNER = 518 +MCI_DEVTYPE_ANIMATION = 519 +MCI_DEVTYPE_DIGITAL_VIDEO = 520 +MCI_DEVTYPE_OTHER = 521 +MCI_DEVTYPE_WAVEFORM_AUDIO = 522 +MCI_DEVTYPE_SEQUENCER = 523 +MCI_DEVTYPE_FIRST = MCI_DEVTYPE_VCR +MCI_DEVTYPE_LAST = MCI_DEVTYPE_SEQUENCER +MCI_DEVTYPE_FIRST_USER = 0x1000 +MCI_MODE_NOT_READY = MCI_STRING_OFFSET + 12 +MCI_MODE_STOP = MCI_STRING_OFFSET + 13 +MCI_MODE_PLAY = MCI_STRING_OFFSET + 14 +MCI_MODE_RECORD = MCI_STRING_OFFSET + 15 +MCI_MODE_SEEK = MCI_STRING_OFFSET + 16 +MCI_MODE_PAUSE = MCI_STRING_OFFSET + 17 +MCI_MODE_OPEN = MCI_STRING_OFFSET + 18 +MCI_FORMAT_MILLISECONDS = 0 +MCI_FORMAT_HMS = 1 +MCI_FORMAT_MSF = 2 +MCI_FORMAT_FRAMES = 3 +MCI_FORMAT_SMPTE_24 = 4 +MCI_FORMAT_SMPTE_25 = 5 +MCI_FORMAT_SMPTE_30 = 6 +MCI_FORMAT_SMPTE_30DROP = 7 +MCI_FORMAT_BYTES = 8 +MCI_FORMAT_SAMPLES = 9 +MCI_FORMAT_TMSF = 10 + + +def MCI_MSF_MINUTE(msf): + return (BYTE)(msf) + + +def MCI_MSF_SECOND(msf): + return (BYTE)(((WORD)(msf)) >> 8) + + +def MCI_MSF_FRAME(msf): + return (BYTE)((msf) >> 16) + + +def MCI_TMSF_TRACK(tmsf): + return (BYTE)(tmsf) + + +def MCI_TMSF_MINUTE(tmsf): + return (BYTE)(((WORD)(tmsf)) >> 8) + + +def MCI_TMSF_SECOND(tmsf): + return (BYTE)((tmsf) >> 16) + + +def MCI_TMSF_FRAME(tmsf): + return (BYTE)((tmsf) >> 24) + + +def MCI_HMS_HOUR(hms): + return (BYTE)(hms) + + +def MCI_HMS_MINUTE(hms): + return (BYTE)(((WORD)(hms)) >> 8) + + +def MCI_HMS_SECOND(hms): + return (BYTE)((hms) >> 16) + + +MCI_NOTIFY_SUCCESSFUL = 0x0001 +MCI_NOTIFY_SUPERSEDED = 0x0002 +MCI_NOTIFY_ABORTED = 0x0004 +MCI_NOTIFY_FAILURE = 0x0008 +MCI_NOTIFY = 0x00000001 +MCI_WAIT = 0x00000002 +MCI_FROM = 0x00000004 +MCI_TO = 0x00000008 +MCI_TRACK = 0x00000010 +MCI_OPEN_SHAREABLE = 0x00000100 +MCI_OPEN_ELEMENT = 0x00000200 +MCI_OPEN_ALIAS = 0x00000400 +MCI_OPEN_ELEMENT_ID = 0x00000800 +MCI_OPEN_TYPE_ID = 0x00001000 +MCI_OPEN_TYPE = 0x00002000 +MCI_SEEK_TO_START = 0x00000100 +MCI_SEEK_TO_END = 0x00000200 +MCI_STATUS_ITEM = 0x00000100 +MCI_STATUS_START = 0x00000200 +MCI_STATUS_LENGTH = 0x00000001 +MCI_STATUS_POSITION = 0x00000002 +MCI_STATUS_NUMBER_OF_TRACKS = 0x00000003 +MCI_STATUS_MODE = 0x00000004 +MCI_STATUS_MEDIA_PRESENT = 0x00000005 +MCI_STATUS_TIME_FORMAT = 0x00000006 +MCI_STATUS_READY = 0x00000007 +MCI_STATUS_CURRENT_TRACK = 0x00000008 +MCI_INFO_PRODUCT = 0x00000100 +MCI_INFO_FILE = 0x00000200 +MCI_INFO_MEDIA_UPC = 0x00000400 +MCI_INFO_MEDIA_IDENTITY = 0x00000800 +MCI_INFO_NAME = 0x00001000 +MCI_INFO_COPYRIGHT = 0x00002000 +MCI_GETDEVCAPS_ITEM = 0x00000100 +MCI_GETDEVCAPS_CAN_RECORD = 0x00000001 +MCI_GETDEVCAPS_HAS_AUDIO = 0x00000002 +MCI_GETDEVCAPS_HAS_VIDEO = 0x00000003 +MCI_GETDEVCAPS_DEVICE_TYPE = 0x00000004 +MCI_GETDEVCAPS_USES_FILES = 0x00000005 +MCI_GETDEVCAPS_COMPOUND_DEVICE = 0x00000006 +MCI_GETDEVCAPS_CAN_EJECT = 0x00000007 +MCI_GETDEVCAPS_CAN_PLAY = 0x00000008 +MCI_GETDEVCAPS_CAN_SAVE = 0x00000009 +MCI_SYSINFO_QUANTITY = 0x00000100 +MCI_SYSINFO_OPEN = 0x00000200 +MCI_SYSINFO_NAME = 0x00000400 +MCI_SYSINFO_INSTALLNAME = 0x00000800 +MCI_SET_DOOR_OPEN = 0x00000100 +MCI_SET_DOOR_CLOSED = 0x00000200 +MCI_SET_TIME_FORMAT = 0x00000400 +MCI_SET_AUDIO = 0x00000800 +MCI_SET_VIDEO = 0x00001000 +MCI_SET_ON = 0x00002000 +MCI_SET_OFF = 0x00004000 +MCI_SET_AUDIO_ALL = 0x00000000 +MCI_SET_AUDIO_LEFT = 0x00000001 +MCI_SET_AUDIO_RIGHT = 0x00000002 +MCI_BREAK_KEY = 0x00000100 +MCI_BREAK_HWND = 0x00000200 +MCI_BREAK_OFF = 0x00000400 +MCI_RECORD_INSERT = 0x00000100 +MCI_RECORD_OVERWRITE = 0x00000200 +MCI_SAVE_FILE = 0x00000100 +MCI_LOAD_FILE = 0x00000100 +MCI_VD_MODE_PARK = MCI_VD_OFFSET + 1 +MCI_VD_MEDIA_CLV = MCI_VD_OFFSET + 2 +MCI_VD_MEDIA_CAV = MCI_VD_OFFSET + 3 +MCI_VD_MEDIA_OTHER = MCI_VD_OFFSET + 4 +MCI_VD_FORMAT_TRACK = 0x4001 +MCI_VD_PLAY_REVERSE = 0x00010000 +MCI_VD_PLAY_FAST = 0x00020000 +MCI_VD_PLAY_SPEED = 0x00040000 +MCI_VD_PLAY_SCAN = 0x00080000 +MCI_VD_PLAY_SLOW = 0x00100000 +MCI_VD_SEEK_REVERSE = 0x00010000 +MCI_VD_STATUS_SPEED = 0x00004002 +MCI_VD_STATUS_FORWARD = 0x00004003 +MCI_VD_STATUS_MEDIA_TYPE = 0x00004004 +MCI_VD_STATUS_SIDE = 0x00004005 +MCI_VD_STATUS_DISC_SIZE = 0x00004006 +MCI_VD_GETDEVCAPS_CLV = 0x00010000 +MCI_VD_GETDEVCAPS_CAV = 0x00020000 +MCI_VD_SPIN_UP = 0x00010000 +MCI_VD_SPIN_DOWN = 0x00020000 +MCI_VD_GETDEVCAPS_CAN_REVERSE = 0x00004002 +MCI_VD_GETDEVCAPS_FAST_RATE = 0x00004003 +MCI_VD_GETDEVCAPS_SLOW_RATE = 0x00004004 +MCI_VD_GETDEVCAPS_NORMAL_RATE = 0x00004005 +MCI_VD_STEP_FRAMES = 0x00010000 +MCI_VD_STEP_REVERSE = 0x00020000 +MCI_VD_ESCAPE_STRING = 0x00000100 +MCI_CDA_STATUS_TYPE_TRACK = 0x00004001 +MCI_CDA_TRACK_AUDIO = MCI_CD_OFFSET + 0 +MCI_CDA_TRACK_OTHER = MCI_CD_OFFSET + 1 +MCI_WAVE_PCM = MCI_WAVE_OFFSET + 0 +MCI_WAVE_MAPPER = MCI_WAVE_OFFSET + 1 +MCI_WAVE_OPEN_BUFFER = 0x00010000 +MCI_WAVE_SET_FORMATTAG = 0x00010000 +MCI_WAVE_SET_CHANNELS = 0x00020000 +MCI_WAVE_SET_SAMPLESPERSEC = 0x00040000 +MCI_WAVE_SET_AVGBYTESPERSEC = 0x00080000 +MCI_WAVE_SET_BLOCKALIGN = 0x00100000 +MCI_WAVE_SET_BITSPERSAMPLE = 0x00200000 +MCI_WAVE_INPUT = 0x00400000 +MCI_WAVE_OUTPUT = 0x00800000 +MCI_WAVE_STATUS_FORMATTAG = 0x00004001 +MCI_WAVE_STATUS_CHANNELS = 0x00004002 +MCI_WAVE_STATUS_SAMPLESPERSEC = 0x00004003 +MCI_WAVE_STATUS_AVGBYTESPERSEC = 0x00004004 +MCI_WAVE_STATUS_BLOCKALIGN = 0x00004005 +MCI_WAVE_STATUS_BITSPERSAMPLE = 0x00004006 +MCI_WAVE_STATUS_LEVEL = 0x00004007 +MCI_WAVE_SET_ANYINPUT = 0x04000000 +MCI_WAVE_SET_ANYOUTPUT = 0x08000000 +MCI_WAVE_GETDEVCAPS_INPUTS = 0x00004001 +MCI_WAVE_GETDEVCAPS_OUTPUTS = 0x00004002 +MCI_SEQ_DIV_PPQN = 0 + MCI_SEQ_OFFSET +MCI_SEQ_DIV_SMPTE_24 = 1 + MCI_SEQ_OFFSET +MCI_SEQ_DIV_SMPTE_25 = 2 + MCI_SEQ_OFFSET +MCI_SEQ_DIV_SMPTE_30DROP = 3 + MCI_SEQ_OFFSET +MCI_SEQ_DIV_SMPTE_30 = 4 + MCI_SEQ_OFFSET +MCI_SEQ_FORMAT_SONGPTR = 0x4001 +MCI_SEQ_FILE = 0x4002 +MCI_SEQ_MIDI = 0x4003 +MCI_SEQ_SMPTE = 0x4004 +MCI_SEQ_NONE = 65533 +MCI_SEQ_MAPPER = 65535 +MCI_SEQ_STATUS_TEMPO = 0x00004002 +MCI_SEQ_STATUS_PORT = 0x00004003 +MCI_SEQ_STATUS_SLAVE = 0x00004007 +MCI_SEQ_STATUS_MASTER = 0x00004008 +MCI_SEQ_STATUS_OFFSET = 0x00004009 +MCI_SEQ_STATUS_DIVTYPE = 0x0000400A +MCI_SEQ_STATUS_NAME = 0x0000400B +MCI_SEQ_STATUS_COPYRIGHT = 0x0000400C +MCI_SEQ_SET_TEMPO = 0x00010000 +MCI_SEQ_SET_PORT = 0x00020000 +MCI_SEQ_SET_SLAVE = 0x00040000 +MCI_SEQ_SET_MASTER = 0x00080000 +MCI_SEQ_SET_OFFSET = 0x01000000 +MCI_ANIM_OPEN_WS = 0x00010000 +MCI_ANIM_OPEN_PARENT = 0x00020000 +MCI_ANIM_OPEN_NOSTATIC = 0x00040000 +MCI_ANIM_PLAY_SPEED = 0x00010000 +MCI_ANIM_PLAY_REVERSE = 0x00020000 +MCI_ANIM_PLAY_FAST = 0x00040000 +MCI_ANIM_PLAY_SLOW = 0x00080000 +MCI_ANIM_PLAY_SCAN = 0x00100000 +MCI_ANIM_STEP_REVERSE = 0x00010000 +MCI_ANIM_STEP_FRAMES = 0x00020000 +MCI_ANIM_STATUS_SPEED = 0x00004001 +MCI_ANIM_STATUS_FORWARD = 0x00004002 +MCI_ANIM_STATUS_HWND = 0x00004003 +MCI_ANIM_STATUS_HPAL = 0x00004004 +MCI_ANIM_STATUS_STRETCH = 0x00004005 +MCI_ANIM_INFO_TEXT = 0x00010000 +MCI_ANIM_GETDEVCAPS_CAN_REVERSE = 0x00004001 +MCI_ANIM_GETDEVCAPS_FAST_RATE = 0x00004002 +MCI_ANIM_GETDEVCAPS_SLOW_RATE = 0x00004003 +MCI_ANIM_GETDEVCAPS_NORMAL_RATE = 0x00004004 +MCI_ANIM_GETDEVCAPS_PALETTES = 0x00004006 +MCI_ANIM_GETDEVCAPS_CAN_STRETCH = 0x00004007 +MCI_ANIM_GETDEVCAPS_MAX_WINDOWS = 0x00004008 +MCI_ANIM_REALIZE_NORM = 0x00010000 +MCI_ANIM_REALIZE_BKGD = 0x00020000 +MCI_ANIM_WINDOW_HWND = 0x00010000 +MCI_ANIM_WINDOW_STATE = 0x00040000 +MCI_ANIM_WINDOW_TEXT = 0x00080000 +MCI_ANIM_WINDOW_ENABLE_STRETCH = 0x00100000 +MCI_ANIM_WINDOW_DISABLE_STRETCH = 0x00200000 +MCI_ANIM_WINDOW_DEFAULT = 0x00000000 +MCI_ANIM_RECT = 0x00010000 +MCI_ANIM_PUT_SOURCE = 0x00020000 +MCI_ANIM_PUT_DESTINATION = 0x00040000 +MCI_ANIM_WHERE_SOURCE = 0x00020000 +MCI_ANIM_WHERE_DESTINATION = 0x00040000 +MCI_ANIM_UPDATE_HDC = 0x00020000 +MCI_OVLY_OPEN_WS = 0x00010000 +MCI_OVLY_OPEN_PARENT = 0x00020000 +MCI_OVLY_STATUS_HWND = 0x00004001 +MCI_OVLY_STATUS_STRETCH = 0x00004002 +MCI_OVLY_INFO_TEXT = 0x00010000 +MCI_OVLY_GETDEVCAPS_CAN_STRETCH = 0x00004001 +MCI_OVLY_GETDEVCAPS_CAN_FREEZE = 0x00004002 +MCI_OVLY_GETDEVCAPS_MAX_WINDOWS = 0x00004003 +MCI_OVLY_WINDOW_HWND = 0x00010000 +MCI_OVLY_WINDOW_STATE = 0x00040000 +MCI_OVLY_WINDOW_TEXT = 0x00080000 +MCI_OVLY_WINDOW_ENABLE_STRETCH = 0x00100000 +MCI_OVLY_WINDOW_DISABLE_STRETCH = 0x00200000 +MCI_OVLY_WINDOW_DEFAULT = 0x00000000 +MCI_OVLY_RECT = 0x00010000 +MCI_OVLY_PUT_SOURCE = 0x00020000 +MCI_OVLY_PUT_DESTINATION = 0x00040000 +MCI_OVLY_PUT_FRAME = 0x00080000 +MCI_OVLY_PUT_VIDEO = 0x00100000 +MCI_OVLY_WHERE_SOURCE = 0x00020000 +MCI_OVLY_WHERE_DESTINATION = 0x00040000 +MCI_OVLY_WHERE_FRAME = 0x00080000 +MCI_OVLY_WHERE_VIDEO = 0x00100000 +SELECTDIB = 41 + + +def DIBINDEX(n): + return MAKELONG((n), 0x10FF) diff --git a/lib/win32/lib/netbios.py b/lib/win32/lib/netbios.py new file mode 100644 index 00000000..dca4dee6 --- /dev/null +++ b/lib/win32/lib/netbios.py @@ -0,0 +1,304 @@ +import struct +import sys + +import win32wnet + +# Constants generated by h2py from nb30.h +NCBNAMSZ = 16 +MAX_LANA = 254 +NAME_FLAGS_MASK = 0x87 +GROUP_NAME = 0x80 +UNIQUE_NAME = 0x00 +REGISTERING = 0x00 +REGISTERED = 0x04 +DEREGISTERED = 0x05 +DUPLICATE = 0x06 +DUPLICATE_DEREG = 0x07 +LISTEN_OUTSTANDING = 0x01 +CALL_PENDING = 0x02 +SESSION_ESTABLISHED = 0x03 +HANGUP_PENDING = 0x04 +HANGUP_COMPLETE = 0x05 +SESSION_ABORTED = 0x06 +ALL_TRANSPORTS = "M\0\0\0" +MS_NBF = "MNBF" +NCBCALL = 0x10 +NCBLISTEN = 0x11 +NCBHANGUP = 0x12 +NCBSEND = 0x14 +NCBRECV = 0x15 +NCBRECVANY = 0x16 +NCBCHAINSEND = 0x17 +NCBDGSEND = 0x20 +NCBDGRECV = 0x21 +NCBDGSENDBC = 0x22 +NCBDGRECVBC = 0x23 +NCBADDNAME = 0x30 +NCBDELNAME = 0x31 +NCBRESET = 0x32 +NCBASTAT = 0x33 +NCBSSTAT = 0x34 +NCBCANCEL = 0x35 +NCBADDGRNAME = 0x36 +NCBENUM = 0x37 +NCBUNLINK = 0x70 +NCBSENDNA = 0x71 +NCBCHAINSENDNA = 0x72 +NCBLANSTALERT = 0x73 +NCBACTION = 0x77 +NCBFINDNAME = 0x78 +NCBTRACE = 0x79 +ASYNCH = 0x80 +NRC_GOODRET = 0x00 +NRC_BUFLEN = 0x01 +NRC_ILLCMD = 0x03 +NRC_CMDTMO = 0x05 +NRC_INCOMP = 0x06 +NRC_BADDR = 0x07 +NRC_SNUMOUT = 0x08 +NRC_NORES = 0x09 +NRC_SCLOSED = 0x0A +NRC_CMDCAN = 0x0B +NRC_DUPNAME = 0x0D +NRC_NAMTFUL = 0x0E +NRC_ACTSES = 0x0F +NRC_LOCTFUL = 0x11 +NRC_REMTFUL = 0x12 +NRC_ILLNN = 0x13 +NRC_NOCALL = 0x14 +NRC_NOWILD = 0x15 +NRC_INUSE = 0x16 +NRC_NAMERR = 0x17 +NRC_SABORT = 0x18 +NRC_NAMCONF = 0x19 +NRC_IFBUSY = 0x21 +NRC_TOOMANY = 0x22 +NRC_BRIDGE = 0x23 +NRC_CANOCCR = 0x24 +NRC_CANCEL = 0x26 +NRC_DUPENV = 0x30 +NRC_ENVNOTDEF = 0x34 +NRC_OSRESNOTAV = 0x35 +NRC_MAXAPPS = 0x36 +NRC_NOSAPS = 0x37 +NRC_NORESOURCES = 0x38 +NRC_INVADDRESS = 0x39 +NRC_INVDDID = 0x3B +NRC_LOCKFAIL = 0x3C +NRC_OPENERR = 0x3F +NRC_SYSTEM = 0x40 +NRC_PENDING = 0xFF + + +UCHAR = "B" +WORD = "H" +DWORD = "I" +USHORT = "H" +ULONG = "I" + +ADAPTER_STATUS_ITEMS = [ + ("6s", "adapter_address"), + (UCHAR, "rev_major"), + (UCHAR, "reserved0"), + (UCHAR, "adapter_type"), + (UCHAR, "rev_minor"), + (WORD, "duration"), + (WORD, "frmr_recv"), + (WORD, "frmr_xmit"), + (WORD, "iframe_recv_err"), + (WORD, "xmit_aborts"), + (DWORD, "xmit_success"), + (DWORD, "recv_success"), + (WORD, "iframe_xmit_err"), + (WORD, "recv_buff_unavail"), + (WORD, "t1_timeouts"), + (WORD, "ti_timeouts"), + (DWORD, "reserved1"), + (WORD, "free_ncbs"), + (WORD, "max_cfg_ncbs"), + (WORD, "max_ncbs"), + (WORD, "xmit_buf_unavail"), + (WORD, "max_dgram_size"), + (WORD, "pending_sess"), + (WORD, "max_cfg_sess"), + (WORD, "max_sess"), + (WORD, "max_sess_pkt_size"), + (WORD, "name_count"), +] + +NAME_BUFFER_ITEMS = [ + (str(NCBNAMSZ) + "s", "name"), + (UCHAR, "name_num"), + (UCHAR, "name_flags"), +] + +SESSION_HEADER_ITEMS = [ + (UCHAR, "sess_name"), + (UCHAR, "num_sess"), + (UCHAR, "rcv_dg_outstanding"), + (UCHAR, "rcv_any_outstanding"), +] + +SESSION_BUFFER_ITEMS = [ + (UCHAR, "lsn"), + (UCHAR, "state"), + (str(NCBNAMSZ) + "s", "local_name"), + (str(NCBNAMSZ) + "s", "remote_name"), + (UCHAR, "rcvs_outstanding"), + (UCHAR, "sends_outstanding"), +] + +LANA_ENUM_ITEMS = [ + ("B", "length"), # Number of valid entries in lana[] + (str(MAX_LANA + 1) + "s", "lana"), +] + +FIND_NAME_HEADER_ITEMS = [ + (WORD, "node_count"), + (UCHAR, "reserved"), + (UCHAR, "unique_group"), +] + +FIND_NAME_BUFFER_ITEMS = [ + (UCHAR, "length"), + (UCHAR, "access_control"), + (UCHAR, "frame_control"), + ("6s", "destination_addr"), + ("6s", "source_addr"), + ("18s", "routing_info"), +] + +ACTION_HEADER_ITEMS = [ + (ULONG, "transport_id"), + (USHORT, "action_code"), + (USHORT, "reserved"), +] + +del UCHAR, WORD, DWORD, USHORT, ULONG + +NCB = win32wnet.NCB + + +def Netbios(ncb): + ob = ncb.Buffer + is_ours = hasattr(ob, "_pack") + if is_ours: + ob._pack() + try: + return win32wnet.Netbios(ncb) + finally: + if is_ours: + ob._unpack() + + +class NCBStruct: + def __init__(self, items): + self._format = "".join([item[0] for item in items]) + self._items = items + self._buffer_ = win32wnet.NCBBuffer(struct.calcsize(self._format)) + + for format, name in self._items: + if len(format) == 1: + if format == "c": + val = "\0" + else: + val = 0 + else: + l = int(format[:-1]) + val = "\0" * l + self.__dict__[name] = val + + def _pack(self): + vals = [] + for format, name in self._items: + try: + vals.append(self.__dict__[name]) + except KeyError: + vals.append(None) + + self._buffer_[:] = struct.pack(*(self._format,) + tuple(vals)) + + def _unpack(self): + items = struct.unpack(self._format, self._buffer_) + assert len(items) == len(self._items), "unexpected number of items to unpack!" + for (format, name), val in zip(self._items, items): + self.__dict__[name] = val + + def __setattr__(self, attr, val): + if attr not in self.__dict__ and attr[0] != "_": + for format, attr_name in self._items: + if attr == attr_name: + break + else: + raise AttributeError(attr) + self.__dict__[attr] = val + + +def ADAPTER_STATUS(): + return NCBStruct(ADAPTER_STATUS_ITEMS) + + +def NAME_BUFFER(): + return NCBStruct(NAME_BUFFER_ITEMS) + + +def SESSION_HEADER(): + return NCBStruct(SESSION_HEADER_ITEMS) + + +def SESSION_BUFFER(): + return NCBStruct(SESSION_BUFFER_ITEMS) + + +def LANA_ENUM(): + return NCBStruct(LANA_ENUM_ITEMS) + + +def FIND_NAME_HEADER(): + return NCBStruct(FIND_NAME_HEADER_ITEMS) + + +def FIND_NAME_BUFFER(): + return NCBStruct(FIND_NAME_BUFFER_ITEMS) + + +def ACTION_HEADER(): + return NCBStruct(ACTION_HEADER_ITEMS) + + +def byte_to_int(b): + """Given an element in a binary buffer, return its integer value""" + if sys.version_info >= (3, 0): + # a byte is already an int in py3k + return b + return ord(b) # its a char from a string in py2k. + + +if __name__ == "__main__": + # code ported from "HOWTO: Get the MAC Address for an Ethernet Adapter" + # MS KB ID: Q118623 + ncb = NCB() + ncb.Command = NCBENUM + la_enum = LANA_ENUM() + ncb.Buffer = la_enum + rc = Netbios(ncb) + if rc != 0: + raise RuntimeError("Unexpected result %d" % (rc,)) + for i in range(la_enum.length): + ncb.Reset() + ncb.Command = NCBRESET + ncb.Lana_num = byte_to_int(la_enum.lana[i]) + rc = Netbios(ncb) + if rc != 0: + raise RuntimeError("Unexpected result %d" % (rc,)) + ncb.Reset() + ncb.Command = NCBASTAT + ncb.Lana_num = byte_to_int(la_enum.lana[i]) + ncb.Callname = "* ".encode("ascii") # ensure bytes on py2x and 3k + adapter = ADAPTER_STATUS() + ncb.Buffer = adapter + Netbios(ncb) + print("Adapter address:", end=" ") + for ch in adapter.adapter_address: + print("%02x" % (byte_to_int(ch),), end=" ") + print() diff --git a/lib/win32/lib/ntsecuritycon.py b/lib/win32/lib/ntsecuritycon.py new file mode 100644 index 00000000..4d5b2ed5 --- /dev/null +++ b/lib/win32/lib/ntsecuritycon.py @@ -0,0 +1,731 @@ +# Hacked from winnt.h + +DELETE = 65536 +READ_CONTROL = 131072 +WRITE_DAC = 262144 +WRITE_OWNER = 524288 +SYNCHRONIZE = 1048576 +STANDARD_RIGHTS_REQUIRED = 983040 +STANDARD_RIGHTS_READ = READ_CONTROL +STANDARD_RIGHTS_WRITE = READ_CONTROL +STANDARD_RIGHTS_EXECUTE = READ_CONTROL +STANDARD_RIGHTS_ALL = 2031616 +SPECIFIC_RIGHTS_ALL = 65535 +ACCESS_SYSTEM_SECURITY = 16777216 +MAXIMUM_ALLOWED = 33554432 +GENERIC_READ = -2147483648 +GENERIC_WRITE = 1073741824 +GENERIC_EXECUTE = 536870912 +GENERIC_ALL = 268435456 + +# file security permissions +FILE_READ_DATA = 1 +FILE_LIST_DIRECTORY = 1 +FILE_WRITE_DATA = 2 +FILE_ADD_FILE = 2 +FILE_APPEND_DATA = 4 +FILE_ADD_SUBDIRECTORY = 4 +FILE_CREATE_PIPE_INSTANCE = 4 +FILE_READ_EA = 8 +FILE_WRITE_EA = 16 +FILE_EXECUTE = 32 +FILE_TRAVERSE = 32 +FILE_DELETE_CHILD = 64 +FILE_READ_ATTRIBUTES = 128 +FILE_WRITE_ATTRIBUTES = 256 +FILE_ALL_ACCESS = STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 511 +FILE_GENERIC_READ = ( + STANDARD_RIGHTS_READ + | FILE_READ_DATA + | FILE_READ_ATTRIBUTES + | FILE_READ_EA + | SYNCHRONIZE +) +FILE_GENERIC_WRITE = ( + STANDARD_RIGHTS_WRITE + | FILE_WRITE_DATA + | FILE_WRITE_ATTRIBUTES + | FILE_WRITE_EA + | FILE_APPEND_DATA + | SYNCHRONIZE +) +FILE_GENERIC_EXECUTE = ( + STANDARD_RIGHTS_EXECUTE | FILE_READ_ATTRIBUTES | FILE_EXECUTE | SYNCHRONIZE +) + + +SECURITY_NULL_SID_AUTHORITY = (0, 0, 0, 0, 0, 0) +SECURITY_WORLD_SID_AUTHORITY = (0, 0, 0, 0, 0, 1) +SECURITY_LOCAL_SID_AUTHORITY = (0, 0, 0, 0, 0, 2) +SECURITY_CREATOR_SID_AUTHORITY = (0, 0, 0, 0, 0, 3) +SECURITY_NON_UNIQUE_AUTHORITY = (0, 0, 0, 0, 0, 4) +SECURITY_RESOURCE_MANAGER_AUTHORITY = (0, 0, 0, 0, 0, 9) + +SECURITY_NULL_RID = 0 +SECURITY_WORLD_RID = 0 +SECURITY_LOCAL_RID = 0x00000000 + +SECURITY_CREATOR_OWNER_RID = 0 +SECURITY_CREATOR_GROUP_RID = 1 + +SECURITY_CREATOR_OWNER_SERVER_RID = 2 +SECURITY_CREATOR_GROUP_SERVER_RID = 3 +SECURITY_CREATOR_OWNER_RIGHTS_RID = 4 + +# NT well-known SIDs +SECURITY_NT_AUTHORITY = (0, 0, 0, 0, 0, 5) + +SECURITY_DIALUP_RID = 1 +SECURITY_NETWORK_RID = 2 +SECURITY_BATCH_RID = 3 +SECURITY_INTERACTIVE_RID = 4 +SECURITY_SERVICE_RID = 6 +SECURITY_ANONYMOUS_LOGON_RID = 7 +SECURITY_PROXY_RID = 8 +SECURITY_SERVER_LOGON_RID = 9 + +SECURITY_LOGON_IDS_RID = 5 +SECURITY_LOGON_IDS_RID_COUNT = 3 + +SECURITY_LOCAL_SYSTEM_RID = 18 + +SECURITY_NT_NON_UNIQUE = 21 + +SECURITY_BUILTIN_DOMAIN_RID = 32 + +# well-known domain relative sub-authority values (RIDs)... +DOMAIN_USER_RID_ADMIN = 500 +DOMAIN_USER_RID_GUEST = 501 +DOMAIN_USER_RID_KRBTGT = 502 +DOMAIN_USER_RID_MAX = 999 + +# well-known groups ... +DOMAIN_GROUP_RID_ADMINS = 512 +DOMAIN_GROUP_RID_USERS = 513 +DOMAIN_GROUP_RID_GUESTS = 514 +DOMAIN_GROUP_RID_COMPUTERS = 515 +DOMAIN_GROUP_RID_CONTROLLERS = 516 +DOMAIN_GROUP_RID_CERT_ADMINS = 517 +DOMAIN_GROUP_RID_SCHEMA_ADMINS = 518 +DOMAIN_GROUP_RID_ENTERPRISE_ADMINS = 519 +DOMAIN_GROUP_RID_POLICY_ADMINS = 520 +DOMAIN_GROUP_RID_READONLY_CONTROLLERS = 521 + +# well-known aliases ... +DOMAIN_ALIAS_RID_ADMINS = 544 +DOMAIN_ALIAS_RID_USERS = 545 +DOMAIN_ALIAS_RID_GUESTS = 546 +DOMAIN_ALIAS_RID_POWER_USERS = 547 +DOMAIN_ALIAS_RID_ACCOUNT_OPS = 548 +DOMAIN_ALIAS_RID_SYSTEM_OPS = 549 +DOMAIN_ALIAS_RID_PRINT_OPS = 550 +DOMAIN_ALIAS_RID_BACKUP_OPS = 551 +DOMAIN_ALIAS_RID_REPLICATOR = 552 +DOMAIN_ALIAS_RID_RAS_SERVERS = 553 +DOMAIN_ALIAS_RID_PREW2KCOMPACCESS = 554 +DOMAIN_ALIAS_RID_REMOTE_DESKTOP_USERS = 555 +DOMAIN_ALIAS_RID_NETWORK_CONFIGURATION_OPS = 556 +DOMAIN_ALIAS_RID_INCOMING_FOREST_TRUST_BUILDERS = 557 +DOMAIN_ALIAS_RID_MONITORING_USERS = 558 +DOMAIN_ALIAS_RID_LOGGING_USERS = 559 +DOMAIN_ALIAS_RID_AUTHORIZATIONACCESS = 560 +DOMAIN_ALIAS_RID_TS_LICENSE_SERVERS = 561 +DOMAIN_ALIAS_RID_DCOM_USERS = 562 +DOMAIN_ALIAS_RID_IUSERS = 568 +DOMAIN_ALIAS_RID_CRYPTO_OPERATORS = 569 +DOMAIN_ALIAS_RID_CACHEABLE_PRINCIPALS_GROUP = 571 +DOMAIN_ALIAS_RID_NON_CACHEABLE_PRINCIPALS_GROUP = 572 +DOMAIN_ALIAS_RID_EVENT_LOG_READERS_GROUP = 573 + +SECURITY_MANDATORY_LABEL_AUTHORITY = (0, 0, 0, 0, 0, 16) +SECURITY_MANDATORY_UNTRUSTED_RID = 0x00000000 +SECURITY_MANDATORY_LOW_RID = 0x00001000 +SECURITY_MANDATORY_MEDIUM_RID = 0x00002000 +SECURITY_MANDATORY_HIGH_RID = 0x00003000 +SECURITY_MANDATORY_SYSTEM_RID = 0x00004000 +SECURITY_MANDATORY_PROTECTED_PROCESS_RID = 0x00005000 +SECURITY_MANDATORY_MAXIMUM_USER_RID = SECURITY_MANDATORY_SYSTEM_RID + +SYSTEM_LUID = (999, 0) +ANONYMOUS_LOGON_LUID = (998, 0) +LOCALSERVICE_LUID = (997, 0) +NETWORKSERVICE_LUID = (996, 0) +IUSER_LUID = (995, 0) + +# Group attributes + +SE_GROUP_MANDATORY = 1 +SE_GROUP_ENABLED_BY_DEFAULT = 2 +SE_GROUP_ENABLED = 4 +SE_GROUP_OWNER = 8 +SE_GROUP_USE_FOR_DENY_ONLY = 16 +SE_GROUP_INTEGRITY = 32 +SE_GROUP_INTEGRITY_ENABLED = 64 +SE_GROUP_RESOURCE = 536870912 +SE_GROUP_LOGON_ID = -1073741824 + + +# User attributes +# (None yet defined.) + +# ACE types +ACCESS_MIN_MS_ACE_TYPE = 0 +ACCESS_ALLOWED_ACE_TYPE = 0 +ACCESS_DENIED_ACE_TYPE = 1 +SYSTEM_AUDIT_ACE_TYPE = 2 +SYSTEM_ALARM_ACE_TYPE = 3 +ACCESS_MAX_MS_V2_ACE_TYPE = 3 +ACCESS_ALLOWED_COMPOUND_ACE_TYPE = 4 +ACCESS_MAX_MS_V3_ACE_TYPE = 4 +ACCESS_MIN_MS_OBJECT_ACE_TYPE = 5 +ACCESS_ALLOWED_OBJECT_ACE_TYPE = 5 +ACCESS_DENIED_OBJECT_ACE_TYPE = 6 +SYSTEM_AUDIT_OBJECT_ACE_TYPE = 7 +SYSTEM_ALARM_OBJECT_ACE_TYPE = 8 +ACCESS_MAX_MS_OBJECT_ACE_TYPE = 8 +ACCESS_MAX_MS_V4_ACE_TYPE = 8 +ACCESS_MAX_MS_ACE_TYPE = 8 +ACCESS_ALLOWED_CALLBACK_ACE_TYPE = 9 +ACCESS_DENIED_CALLBACK_ACE_TYPE = 10 +ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE = 11 +ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE = 12 +SYSTEM_AUDIT_CALLBACK_ACE_TYPE = 13 +SYSTEM_ALARM_CALLBACK_ACE_TYPE = 14 +SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE = 15 +SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE = 16 +SYSTEM_MANDATORY_LABEL_ACE_TYPE = 17 +ACCESS_MAX_MS_V5_ACE_TYPE = 17 + +# The following are the inherit flags that go into the AceFlags field +# of an Ace header. + +OBJECT_INHERIT_ACE = 1 +CONTAINER_INHERIT_ACE = 2 +NO_PROPAGATE_INHERIT_ACE = 4 +INHERIT_ONLY_ACE = 8 +VALID_INHERIT_FLAGS = 15 + + +SUCCESSFUL_ACCESS_ACE_FLAG = 64 +FAILED_ACCESS_ACE_FLAG = 128 + +SE_OWNER_DEFAULTED = 1 +SE_GROUP_DEFAULTED = 2 +SE_DACL_PRESENT = 4 +SE_DACL_DEFAULTED = 8 +SE_SACL_PRESENT = 16 +SE_SACL_DEFAULTED = 32 +SE_SELF_RELATIVE = 32768 + + +SE_PRIVILEGE_ENABLED_BY_DEFAULT = 1 +SE_PRIVILEGE_ENABLED = 2 +SE_PRIVILEGE_USED_FOR_ACCESS = -2147483648 + +PRIVILEGE_SET_ALL_NECESSARY = 1 + +# NT Defined Privileges + +SE_CREATE_TOKEN_NAME = "SeCreateTokenPrivilege" +SE_ASSIGNPRIMARYTOKEN_NAME = "SeAssignPrimaryTokenPrivilege" +SE_LOCK_MEMORY_NAME = "SeLockMemoryPrivilege" +SE_INCREASE_QUOTA_NAME = "SeIncreaseQuotaPrivilege" +SE_UNSOLICITED_INPUT_NAME = "SeUnsolicitedInputPrivilege" +SE_MACHINE_ACCOUNT_NAME = "SeMachineAccountPrivilege" +SE_TCB_NAME = "SeTcbPrivilege" +SE_SECURITY_NAME = "SeSecurityPrivilege" +SE_TAKE_OWNERSHIP_NAME = "SeTakeOwnershipPrivilege" +SE_LOAD_DRIVER_NAME = "SeLoadDriverPrivilege" +SE_SYSTEM_PROFILE_NAME = "SeSystemProfilePrivilege" +SE_SYSTEMTIME_NAME = "SeSystemtimePrivilege" +SE_PROF_SINGLE_PROCESS_NAME = "SeProfileSingleProcessPrivilege" +SE_INC_BASE_PRIORITY_NAME = "SeIncreaseBasePriorityPrivilege" +SE_CREATE_PAGEFILE_NAME = "SeCreatePagefilePrivilege" +SE_CREATE_PERMANENT_NAME = "SeCreatePermanentPrivilege" +SE_BACKUP_NAME = "SeBackupPrivilege" +SE_RESTORE_NAME = "SeRestorePrivilege" +SE_SHUTDOWN_NAME = "SeShutdownPrivilege" +SE_DEBUG_NAME = "SeDebugPrivilege" +SE_AUDIT_NAME = "SeAuditPrivilege" +SE_SYSTEM_ENVIRONMENT_NAME = "SeSystemEnvironmentPrivilege" +SE_CHANGE_NOTIFY_NAME = "SeChangeNotifyPrivilege" +SE_REMOTE_SHUTDOWN_NAME = "SeRemoteShutdownPrivilege" + + +# Enum SECURITY_IMPERSONATION_LEVEL: +SecurityAnonymous = 0 +SecurityIdentification = 1 +SecurityImpersonation = 2 +SecurityDelegation = 3 + +SECURITY_MAX_IMPERSONATION_LEVEL = SecurityDelegation + +DEFAULT_IMPERSONATION_LEVEL = SecurityImpersonation + +TOKEN_ASSIGN_PRIMARY = 1 +TOKEN_DUPLICATE = 2 +TOKEN_IMPERSONATE = 4 +TOKEN_QUERY = 8 +TOKEN_QUERY_SOURCE = 16 +TOKEN_ADJUST_PRIVILEGES = 32 +TOKEN_ADJUST_GROUPS = 64 +TOKEN_ADJUST_DEFAULT = 128 + +TOKEN_ALL_ACCESS = ( + STANDARD_RIGHTS_REQUIRED + | TOKEN_ASSIGN_PRIMARY + | TOKEN_DUPLICATE + | TOKEN_IMPERSONATE + | TOKEN_QUERY + | TOKEN_QUERY_SOURCE + | TOKEN_ADJUST_PRIVILEGES + | TOKEN_ADJUST_GROUPS + | TOKEN_ADJUST_DEFAULT +) + + +TOKEN_READ = STANDARD_RIGHTS_READ | TOKEN_QUERY + + +TOKEN_WRITE = ( + STANDARD_RIGHTS_WRITE + | TOKEN_ADJUST_PRIVILEGES + | TOKEN_ADJUST_GROUPS + | TOKEN_ADJUST_DEFAULT +) + +TOKEN_EXECUTE = STANDARD_RIGHTS_EXECUTE + +SidTypeUser = 1 +SidTypeGroup = 2 +SidTypeDomain = 3 +SidTypeAlias = 4 +SidTypeWellKnownGroup = 5 +SidTypeDeletedAccount = 6 +SidTypeInvalid = 7 +SidTypeUnknown = 8 +SidTypeComputer = 9 +SidTypeLabel = 10 + +# Token types +TokenPrimary = 1 +TokenImpersonation = 2 + +# TOKEN_INFORMATION_CLASS, used with Get/SetTokenInformation +TokenUser = 1 +TokenGroups = 2 +TokenPrivileges = 3 +TokenOwner = 4 +TokenPrimaryGroup = 5 +TokenDefaultDacl = 6 +TokenSource = 7 +TokenType = 8 +TokenImpersonationLevel = 9 +TokenStatistics = 10 +TokenRestrictedSids = 11 +TokenSessionId = 12 +TokenGroupsAndPrivileges = 13 +TokenSessionReference = 14 +TokenSandBoxInert = 15 +TokenAuditPolicy = 16 +TokenOrigin = 17 +TokenElevationType = 18 +TokenLinkedToken = 19 +TokenElevation = 20 +TokenHasRestrictions = 21 +TokenAccessInformation = 22 +TokenVirtualizationAllowed = 23 +TokenVirtualizationEnabled = 24 +TokenIntegrityLevel = 25 +TokenUIAccess = 26 +TokenMandatoryPolicy = 27 +TokenLogonSid = 28 + +# DirectoryService related constants. +# Generated by h2py from NtDsAPI.h +DS_BEHAVIOR_WIN2000 = 0 +DS_BEHAVIOR_WIN2003_WITH_MIXED_DOMAINS = 1 +DS_BEHAVIOR_WIN2003 = 2 +DS_SYNCED_EVENT_NAME = "NTDSInitialSyncsCompleted" +ACTRL_DS_OPEN = 0x00000000 +ACTRL_DS_CREATE_CHILD = 0x00000001 +ACTRL_DS_DELETE_CHILD = 0x00000002 +ACTRL_DS_LIST = 0x00000004 +ACTRL_DS_SELF = 0x00000008 +ACTRL_DS_READ_PROP = 0x00000010 +ACTRL_DS_WRITE_PROP = 0x00000020 +ACTRL_DS_DELETE_TREE = 0x00000040 +ACTRL_DS_LIST_OBJECT = 0x00000080 +ACTRL_DS_CONTROL_ACCESS = 0x00000100 +NTDSAPI_BIND_ALLOW_DELEGATION = 0x00000001 +DS_REPSYNC_ASYNCHRONOUS_OPERATION = 0x00000001 +DS_REPSYNC_WRITEABLE = 0x00000002 +DS_REPSYNC_PERIODIC = 0x00000004 +DS_REPSYNC_INTERSITE_MESSAGING = 0x00000008 +DS_REPSYNC_ALL_SOURCES = 0x00000010 +DS_REPSYNC_FULL = 0x00000020 +DS_REPSYNC_URGENT = 0x00000040 +DS_REPSYNC_NO_DISCARD = 0x00000080 +DS_REPSYNC_FORCE = 0x00000100 +DS_REPSYNC_ADD_REFERENCE = 0x00000200 +DS_REPSYNC_NEVER_COMPLETED = 0x00000400 +DS_REPSYNC_TWO_WAY = 0x00000800 +DS_REPSYNC_NEVER_NOTIFY = 0x00001000 +DS_REPSYNC_INITIAL = 0x00002000 +DS_REPSYNC_USE_COMPRESSION = 0x00004000 +DS_REPSYNC_ABANDONED = 0x00008000 +DS_REPSYNC_INITIAL_IN_PROGRESS = 0x00010000 +DS_REPSYNC_PARTIAL_ATTRIBUTE_SET = 0x00020000 +DS_REPSYNC_REQUEUE = 0x00040000 +DS_REPSYNC_NOTIFICATION = 0x00080000 +DS_REPSYNC_ASYNCHRONOUS_REPLICA = 0x00100000 +DS_REPSYNC_CRITICAL = 0x00200000 +DS_REPSYNC_FULL_IN_PROGRESS = 0x00400000 +DS_REPSYNC_PREEMPTED = 0x00800000 +DS_REPADD_ASYNCHRONOUS_OPERATION = 0x00000001 +DS_REPADD_WRITEABLE = 0x00000002 +DS_REPADD_INITIAL = 0x00000004 +DS_REPADD_PERIODIC = 0x00000008 +DS_REPADD_INTERSITE_MESSAGING = 0x00000010 +DS_REPADD_ASYNCHRONOUS_REPLICA = 0x00000020 +DS_REPADD_DISABLE_NOTIFICATION = 0x00000040 +DS_REPADD_DISABLE_PERIODIC = 0x00000080 +DS_REPADD_USE_COMPRESSION = 0x00000100 +DS_REPADD_NEVER_NOTIFY = 0x00000200 +DS_REPADD_TWO_WAY = 0x00000400 +DS_REPADD_CRITICAL = 0x00000800 +DS_REPDEL_ASYNCHRONOUS_OPERATION = 0x00000001 +DS_REPDEL_WRITEABLE = 0x00000002 +DS_REPDEL_INTERSITE_MESSAGING = 0x00000004 +DS_REPDEL_IGNORE_ERRORS = 0x00000008 +DS_REPDEL_LOCAL_ONLY = 0x00000010 +DS_REPDEL_NO_SOURCE = 0x00000020 +DS_REPDEL_REF_OK = 0x00000040 +DS_REPMOD_ASYNCHRONOUS_OPERATION = 0x00000001 +DS_REPMOD_WRITEABLE = 0x00000002 +DS_REPMOD_UPDATE_FLAGS = 0x00000001 +DS_REPMOD_UPDATE_ADDRESS = 0x00000002 +DS_REPMOD_UPDATE_SCHEDULE = 0x00000004 +DS_REPMOD_UPDATE_RESULT = 0x00000008 +DS_REPMOD_UPDATE_TRANSPORT = 0x00000010 +DS_REPUPD_ASYNCHRONOUS_OPERATION = 0x00000001 +DS_REPUPD_WRITEABLE = 0x00000002 +DS_REPUPD_ADD_REFERENCE = 0x00000004 +DS_REPUPD_DELETE_REFERENCE = 0x00000008 +DS_INSTANCETYPE_IS_NC_HEAD = 0x00000001 +DS_INSTANCETYPE_NC_IS_WRITEABLE = 0x00000004 +DS_INSTANCETYPE_NC_COMING = 0x00000010 +DS_INSTANCETYPE_NC_GOING = 0x00000020 +NTDSDSA_OPT_IS_GC = 1 << 0 +NTDSDSA_OPT_DISABLE_INBOUND_REPL = 1 << 1 +NTDSDSA_OPT_DISABLE_OUTBOUND_REPL = 1 << 2 +NTDSDSA_OPT_DISABLE_NTDSCONN_XLATE = 1 << 3 +NTDSCONN_OPT_IS_GENERATED = 1 << 0 +NTDSCONN_OPT_TWOWAY_SYNC = 1 << 1 +NTDSCONN_OPT_OVERRIDE_NOTIFY_DEFAULT = 1 << 2 +NTDSCONN_OPT_USE_NOTIFY = 1 << 3 +NTDSCONN_OPT_DISABLE_INTERSITE_COMPRESSION = 1 << 4 +NTDSCONN_OPT_USER_OWNED_SCHEDULE = 1 << 5 +NTDSCONN_KCC_NO_REASON = 0 +NTDSCONN_KCC_GC_TOPOLOGY = 1 << 0 +NTDSCONN_KCC_RING_TOPOLOGY = 1 << 1 +NTDSCONN_KCC_MINIMIZE_HOPS_TOPOLOGY = 1 << 2 +NTDSCONN_KCC_STALE_SERVERS_TOPOLOGY = 1 << 3 +NTDSCONN_KCC_OSCILLATING_CONNECTION_TOPOLOGY = 1 << 4 +NTDSCONN_KCC_INTERSITE_GC_TOPOLOGY = 1 << 5 +NTDSCONN_KCC_INTERSITE_TOPOLOGY = 1 << 6 +NTDSCONN_KCC_SERVER_FAILOVER_TOPOLOGY = 1 << 7 +NTDSCONN_KCC_SITE_FAILOVER_TOPOLOGY = 1 << 8 +NTDSCONN_KCC_REDUNDANT_SERVER_TOPOLOGY = 1 << 9 +FRSCONN_PRIORITY_MASK = 0x70000000 +FRSCONN_MAX_PRIORITY = 0x8 +NTDSCONN_OPT_IGNORE_SCHEDULE_MASK = -2147483648 + +NTDSSETTINGS_OPT_IS_AUTO_TOPOLOGY_DISABLED = 1 << 0 +NTDSSETTINGS_OPT_IS_TOPL_CLEANUP_DISABLED = 1 << 1 +NTDSSETTINGS_OPT_IS_TOPL_MIN_HOPS_DISABLED = 1 << 2 +NTDSSETTINGS_OPT_IS_TOPL_DETECT_STALE_DISABLED = 1 << 3 +NTDSSETTINGS_OPT_IS_INTER_SITE_AUTO_TOPOLOGY_DISABLED = 1 << 4 +NTDSSETTINGS_OPT_IS_GROUP_CACHING_ENABLED = 1 << 5 +NTDSSETTINGS_OPT_FORCE_KCC_WHISTLER_BEHAVIOR = 1 << 6 +NTDSSETTINGS_OPT_FORCE_KCC_W2K_ELECTION = 1 << 7 +NTDSSETTINGS_OPT_IS_RAND_BH_SELECTION_DISABLED = 1 << 8 +NTDSSETTINGS_OPT_IS_SCHEDULE_HASHING_ENABLED = 1 << 9 +NTDSSETTINGS_OPT_IS_REDUNDANT_SERVER_TOPOLOGY_ENABLED = 1 << 10 +NTDSSETTINGS_DEFAULT_SERVER_REDUNDANCY = 2 +NTDSTRANSPORT_OPT_IGNORE_SCHEDULES = 1 << 0 +NTDSTRANSPORT_OPT_BRIDGES_REQUIRED = 1 << 1 +NTDSSITECONN_OPT_USE_NOTIFY = 1 << 0 +NTDSSITECONN_OPT_TWOWAY_SYNC = 1 << 1 +NTDSSITECONN_OPT_DISABLE_COMPRESSION = 1 << 2 +NTDSSITELINK_OPT_USE_NOTIFY = 1 << 0 +NTDSSITELINK_OPT_TWOWAY_SYNC = 1 << 1 +NTDSSITELINK_OPT_DISABLE_COMPRESSION = 1 << 2 +GUID_USERS_CONTAINER_A = "a9d1ca15768811d1aded00c04fd8d5cd" +GUID_COMPUTRS_CONTAINER_A = "aa312825768811d1aded00c04fd8d5cd" +GUID_SYSTEMS_CONTAINER_A = "ab1d30f3768811d1aded00c04fd8d5cd" +GUID_DOMAIN_CONTROLLERS_CONTAINER_A = "a361b2ffffd211d1aa4b00c04fd7d83a" +GUID_INFRASTRUCTURE_CONTAINER_A = "2fbac1870ade11d297c400c04fd8d5cd" +GUID_DELETED_OBJECTS_CONTAINER_A = "18e2ea80684f11d2b9aa00c04f79f805" +GUID_LOSTANDFOUND_CONTAINER_A = "ab8153b7768811d1aded00c04fd8d5cd" +GUID_FOREIGNSECURITYPRINCIPALS_CONTAINER_A = "22b70c67d56e4efb91e9300fca3dc1aa" +GUID_PROGRAM_DATA_CONTAINER_A = "09460c08ae1e4a4ea0f64aee7daa1e5a" +GUID_MICROSOFT_PROGRAM_DATA_CONTAINER_A = "f4be92a4c777485e878e9421d53087db" +GUID_NTDS_QUOTAS_CONTAINER_A = "6227f0af1fc2410d8e3bb10615bb5b0f" +GUID_USERS_CONTAINER_BYTE = ( + "\xa9\xd1\xca\x15\x76\x88\x11\xd1\xad\xed\x00\xc0\x4f\xd8\xd5\xcd" +) +GUID_COMPUTRS_CONTAINER_BYTE = ( + "\xaa\x31\x28\x25\x76\x88\x11\xd1\xad\xed\x00\xc0\x4f\xd8\xd5\xcd" +) +GUID_SYSTEMS_CONTAINER_BYTE = ( + "\xab\x1d\x30\xf3\x76\x88\x11\xd1\xad\xed\x00\xc0\x4f\xd8\xd5\xcd" +) +GUID_DOMAIN_CONTROLLERS_CONTAINER_BYTE = ( + "\xa3\x61\xb2\xff\xff\xd2\x11\xd1\xaa\x4b\x00\xc0\x4f\xd7\xd8\x3a" +) +GUID_INFRASTRUCTURE_CONTAINER_BYTE = ( + "\x2f\xba\xc1\x87\x0a\xde\x11\xd2\x97\xc4\x00\xc0\x4f\xd8\xd5\xcd" +) +GUID_DELETED_OBJECTS_CONTAINER_BYTE = ( + "\x18\xe2\xea\x80\x68\x4f\x11\xd2\xb9\xaa\x00\xc0\x4f\x79\xf8\x05" +) +GUID_LOSTANDFOUND_CONTAINER_BYTE = ( + "\xab\x81\x53\xb7\x76\x88\x11\xd1\xad\xed\x00\xc0\x4f\xd8\xd5\xcd" +) +GUID_FOREIGNSECURITYPRINCIPALS_CONTAINER_BYTE = ( + "\x22\xb7\x0c\x67\xd5\x6e\x4e\xfb\x91\xe9\x30\x0f\xca\x3d\xc1\xaa" +) +GUID_PROGRAM_DATA_CONTAINER_BYTE = ( + "\x09\x46\x0c\x08\xae\x1e\x4a\x4e\xa0\xf6\x4a\xee\x7d\xaa\x1e\x5a" +) +GUID_MICROSOFT_PROGRAM_DATA_CONTAINER_BYTE = ( + "\xf4\xbe\x92\xa4\xc7\x77\x48\x5e\x87\x8e\x94\x21\xd5\x30\x87\xdb" +) +GUID_NTDS_QUOTAS_CONTAINER_BYTE = ( + "\x62\x27\xf0\xaf\x1f\xc2\x41\x0d\x8e\x3b\xb1\x06\x15\xbb\x5b\x0f" +) +DS_REPSYNCALL_NO_OPTIONS = 0x00000000 +DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE = 0x00000001 +DS_REPSYNCALL_SYNC_ADJACENT_SERVERS_ONLY = 0x00000002 +DS_REPSYNCALL_ID_SERVERS_BY_DN = 0x00000004 +DS_REPSYNCALL_DO_NOT_SYNC = 0x00000008 +DS_REPSYNCALL_SKIP_INITIAL_CHECK = 0x00000010 +DS_REPSYNCALL_PUSH_CHANGES_OUTWARD = 0x00000020 +DS_REPSYNCALL_CROSS_SITE_BOUNDARIES = 0x00000040 +DS_LIST_DSA_OBJECT_FOR_SERVER = 0 +DS_LIST_DNS_HOST_NAME_FOR_SERVER = 1 +DS_LIST_ACCOUNT_OBJECT_FOR_SERVER = 2 +DS_ROLE_SCHEMA_OWNER = 0 +DS_ROLE_DOMAIN_OWNER = 1 +DS_ROLE_PDC_OWNER = 2 +DS_ROLE_RID_OWNER = 3 +DS_ROLE_INFRASTRUCTURE_OWNER = 4 +DS_SCHEMA_GUID_NOT_FOUND = 0 +DS_SCHEMA_GUID_ATTR = 1 +DS_SCHEMA_GUID_ATTR_SET = 2 +DS_SCHEMA_GUID_CLASS = 3 +DS_SCHEMA_GUID_CONTROL_RIGHT = 4 +DS_KCC_FLAG_ASYNC_OP = 1 << 0 +DS_KCC_FLAG_DAMPED = 1 << 1 +DS_EXIST_ADVISORY_MODE = 0x1 +DS_REPL_INFO_FLAG_IMPROVE_LINKED_ATTRS = 0x00000001 +DS_REPL_NBR_WRITEABLE = 0x00000010 +DS_REPL_NBR_SYNC_ON_STARTUP = 0x00000020 +DS_REPL_NBR_DO_SCHEDULED_SYNCS = 0x00000040 +DS_REPL_NBR_USE_ASYNC_INTERSITE_TRANSPORT = 0x00000080 +DS_REPL_NBR_TWO_WAY_SYNC = 0x00000200 +DS_REPL_NBR_RETURN_OBJECT_PARENTS = 0x00000800 +DS_REPL_NBR_FULL_SYNC_IN_PROGRESS = 0x00010000 +DS_REPL_NBR_FULL_SYNC_NEXT_PACKET = 0x00020000 +DS_REPL_NBR_NEVER_SYNCED = 0x00200000 +DS_REPL_NBR_PREEMPTED = 0x01000000 +DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS = 0x04000000 +DS_REPL_NBR_DISABLE_SCHEDULED_SYNC = 0x08000000 +DS_REPL_NBR_COMPRESS_CHANGES = 0x10000000 +DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS = 0x20000000 +DS_REPL_NBR_PARTIAL_ATTRIBUTE_SET = 0x40000000 +DS_REPL_NBR_MODIFIABLE_MASK = ( + DS_REPL_NBR_SYNC_ON_STARTUP + | DS_REPL_NBR_DO_SCHEDULED_SYNCS + | DS_REPL_NBR_TWO_WAY_SYNC + | DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS + | DS_REPL_NBR_DISABLE_SCHEDULED_SYNC + | DS_REPL_NBR_COMPRESS_CHANGES + | DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS +) + +# from enum DS_NAME_FORMAT +DS_UNKNOWN_NAME = 0 +DS_FQDN_1779_NAME = 1 +DS_NT4_ACCOUNT_NAME = 2 +DS_DISPLAY_NAME = 3 +DS_UNIQUE_ID_NAME = 6 +DS_CANONICAL_NAME = 7 +DS_USER_PRINCIPAL_NAME = 8 +DS_CANONICAL_NAME_EX = 9 +DS_SERVICE_PRINCIPAL_NAME = 10 +DS_SID_OR_SID_HISTORY_NAME = 11 +DS_DNS_DOMAIN_NAME = 12 + +DS_DOMAIN_SIMPLE_NAME = DS_USER_PRINCIPAL_NAME +DS_ENTERPRISE_SIMPLE_NAME = DS_USER_PRINCIPAL_NAME + +# from enum DS_NAME_FLAGS +DS_NAME_NO_FLAGS = 0x0 +DS_NAME_FLAG_SYNTACTICAL_ONLY = 0x1 +DS_NAME_FLAG_EVAL_AT_DC = 0x2 +DS_NAME_FLAG_GCVERIFY = 0x4 +DS_NAME_FLAG_TRUST_REFERRAL = 0x8 + +# from enum DS_NAME_ERROR +DS_NAME_NO_ERROR = 0 +DS_NAME_ERROR_RESOLVING = 1 +DS_NAME_ERROR_NOT_FOUND = 2 +DS_NAME_ERROR_NOT_UNIQUE = 3 +DS_NAME_ERROR_NO_MAPPING = 4 +DS_NAME_ERROR_DOMAIN_ONLY = 5 +DS_NAME_ERROR_NO_SYNTACTICAL_MAPPING = 6 +DS_NAME_ERROR_TRUST_REFERRAL = 7 + + +# from enum DS_SPN_NAME_TYPE +DS_SPN_DNS_HOST = 0 +DS_SPN_DN_HOST = 1 +DS_SPN_NB_HOST = 2 +DS_SPN_DOMAIN = 3 +DS_SPN_NB_DOMAIN = 4 +DS_SPN_SERVICE = 5 + +# from enum DS_SPN_WRITE_OP +DS_SPN_ADD_SPN_OP = 0 +DS_SPN_REPLACE_SPN_OP = 1 +DS_SPN_DELETE_SPN_OP = 2 + +# Generated by h2py from DsGetDC.h +DS_FORCE_REDISCOVERY = 0x00000001 +DS_DIRECTORY_SERVICE_REQUIRED = 0x00000010 +DS_DIRECTORY_SERVICE_PREFERRED = 0x00000020 +DS_GC_SERVER_REQUIRED = 0x00000040 +DS_PDC_REQUIRED = 0x00000080 +DS_BACKGROUND_ONLY = 0x00000100 +DS_IP_REQUIRED = 0x00000200 +DS_KDC_REQUIRED = 0x00000400 +DS_TIMESERV_REQUIRED = 0x00000800 +DS_WRITABLE_REQUIRED = 0x00001000 +DS_GOOD_TIMESERV_PREFERRED = 0x00002000 +DS_AVOID_SELF = 0x00004000 +DS_ONLY_LDAP_NEEDED = 0x00008000 +DS_IS_FLAT_NAME = 0x00010000 +DS_IS_DNS_NAME = 0x00020000 +DS_RETURN_DNS_NAME = 0x40000000 +DS_RETURN_FLAT_NAME = -2147483648 +DSGETDC_VALID_FLAGS = ( + DS_FORCE_REDISCOVERY + | DS_DIRECTORY_SERVICE_REQUIRED + | DS_DIRECTORY_SERVICE_PREFERRED + | DS_GC_SERVER_REQUIRED + | DS_PDC_REQUIRED + | DS_BACKGROUND_ONLY + | DS_IP_REQUIRED + | DS_KDC_REQUIRED + | DS_TIMESERV_REQUIRED + | DS_WRITABLE_REQUIRED + | DS_GOOD_TIMESERV_PREFERRED + | DS_AVOID_SELF + | DS_ONLY_LDAP_NEEDED + | DS_IS_FLAT_NAME + | DS_IS_DNS_NAME + | DS_RETURN_FLAT_NAME + | DS_RETURN_DNS_NAME +) +DS_INET_ADDRESS = 1 +DS_NETBIOS_ADDRESS = 2 +DS_PDC_FLAG = 0x00000001 +DS_GC_FLAG = 0x00000004 +DS_LDAP_FLAG = 0x00000008 +DS_DS_FLAG = 0x00000010 +DS_KDC_FLAG = 0x00000020 +DS_TIMESERV_FLAG = 0x00000040 +DS_CLOSEST_FLAG = 0x00000080 +DS_WRITABLE_FLAG = 0x00000100 +DS_GOOD_TIMESERV_FLAG = 0x00000200 +DS_NDNC_FLAG = 0x00000400 +DS_PING_FLAGS = 0x0000FFFF +DS_DNS_CONTROLLER_FLAG = 0x20000000 +DS_DNS_DOMAIN_FLAG = 0x40000000 +DS_DNS_FOREST_FLAG = -2147483648 +DS_DOMAIN_IN_FOREST = 0x0001 +DS_DOMAIN_DIRECT_OUTBOUND = 0x0002 +DS_DOMAIN_TREE_ROOT = 0x0004 +DS_DOMAIN_PRIMARY = 0x0008 +DS_DOMAIN_NATIVE_MODE = 0x0010 +DS_DOMAIN_DIRECT_INBOUND = 0x0020 +DS_DOMAIN_VALID_FLAGS = ( + DS_DOMAIN_IN_FOREST + | DS_DOMAIN_DIRECT_OUTBOUND + | DS_DOMAIN_TREE_ROOT + | DS_DOMAIN_PRIMARY + | DS_DOMAIN_NATIVE_MODE + | DS_DOMAIN_DIRECT_INBOUND +) +DS_GFTI_UPDATE_TDO = 0x1 +DS_GFTI_VALID_FLAGS = 0x1 +DS_ONLY_DO_SITE_NAME = 0x01 +DS_NOTIFY_AFTER_SITE_RECORDS = 0x02 +DS_OPEN_VALID_OPTION_FLAGS = DS_ONLY_DO_SITE_NAME | DS_NOTIFY_AFTER_SITE_RECORDS +DS_OPEN_VALID_FLAGS = ( + DS_FORCE_REDISCOVERY + | DS_ONLY_LDAP_NEEDED + | DS_KDC_REQUIRED + | DS_PDC_REQUIRED + | DS_GC_SERVER_REQUIRED + | DS_WRITABLE_REQUIRED +) + +## from aclui.h +# SI_OBJECT_INFO.dwFlags +SI_EDIT_PERMS = 0x00000000 +SI_EDIT_OWNER = 0x00000001 +SI_EDIT_AUDITS = 0x00000002 +SI_CONTAINER = 0x00000004 +SI_READONLY = 0x00000008 +SI_ADVANCED = 0x00000010 +SI_RESET = 0x00000020 +SI_OWNER_READONLY = 0x00000040 +SI_EDIT_PROPERTIES = 0x00000080 +SI_OWNER_RECURSE = 0x00000100 +SI_NO_ACL_PROTECT = 0x00000200 +SI_NO_TREE_APPLY = 0x00000400 +SI_PAGE_TITLE = 0x00000800 +SI_SERVER_IS_DC = 0x00001000 +SI_RESET_DACL_TREE = 0x00004000 +SI_RESET_SACL_TREE = 0x00008000 +SI_OBJECT_GUID = 0x00010000 +SI_EDIT_EFFECTIVE = 0x00020000 +SI_RESET_DACL = 0x00040000 +SI_RESET_SACL = 0x00080000 +SI_RESET_OWNER = 0x00100000 +SI_NO_ADDITIONAL_PERMISSION = 0x00200000 +SI_MAY_WRITE = 0x10000000 +SI_EDIT_ALL = SI_EDIT_PERMS | SI_EDIT_OWNER | SI_EDIT_AUDITS +SI_AUDITS_ELEVATION_REQUIRED = 0x02000000 +SI_VIEW_ONLY = 0x00400000 +SI_OWNER_ELEVATION_REQUIRED = 0x04000000 +SI_PERMS_ELEVATION_REQUIRED = 0x01000000 + +# SI_ACCESS.dwFlags +SI_ACCESS_SPECIFIC = 0x00010000 +SI_ACCESS_GENERAL = 0x00020000 +SI_ACCESS_CONTAINER = 0x00040000 +SI_ACCESS_PROPERTY = 0x00080000 + +# SI_PAGE_TYPE enum +SI_PAGE_PERM = 0 +SI_PAGE_ADVPERM = 1 +SI_PAGE_AUDIT = 2 +SI_PAGE_OWNER = 3 +SI_PAGE_EFFECTIVE = 4 + +CFSTR_ACLUI_SID_INFO_LIST = "CFSTR_ACLUI_SID_INFO_LIST" +PSPCB_SI_INITDIALOG = 1025 ## WM_USER+1 diff --git a/lib/win32/lib/pywin32_bootstrap.py b/lib/win32/lib/pywin32_bootstrap.py new file mode 100644 index 00000000..fbc4f7be --- /dev/null +++ b/lib/win32/lib/pywin32_bootstrap.py @@ -0,0 +1,29 @@ +# Imported by pywin32.pth to bootstrap the pywin32 environment in "portable" +# environments or any other case where the post-install script isn't run. +# +# In short, there's a directory installed by pywin32 named 'pywin32_system32' +# with some important DLLs which need to be found by Python when some pywin32 +# modules are imported. +# If Python has `os.add_dll_directory()`, we need to call it with this path. +# Otherwise, we add this path to PATH. + + +try: + import pywin32_system32 +except ImportError: # Python ≥3.6: replace ImportError with ModuleNotFoundError + pass +else: + import os + + # We're guaranteed only that __path__: Iterable[str] + # https://docs.python.org/3/reference/import.html#__path__ + for path in pywin32_system32.__path__: + if os.path.isdir(path): + if hasattr(os, "add_dll_directory"): + os.add_dll_directory(path) + # This is to ensure the pywin32 path is in the beginning to find the + # pywin32 DLLs first and prevent other PATH entries to shadow them + elif not os.environ["PATH"].startswith(path): + os.environ["PATH"] = os.environ["PATH"].replace(os.pathsep + path, "") + os.environ["PATH"] = path + os.pathsep + os.environ["PATH"] + break diff --git a/lib/win32/lib/pywin32_testutil.py b/lib/win32/lib/pywin32_testutil.py new file mode 100644 index 00000000..41566a8e --- /dev/null +++ b/lib/win32/lib/pywin32_testutil.py @@ -0,0 +1,327 @@ +# Utilities for the pywin32 tests +import gc +import os +import site +import sys +import unittest + +import winerror + +## +## General purpose utilities for the test suite. +## + + +# The test suite has lots of string constants containing binary data, but +# the strings are used in various "bytes" contexts. +def str2bytes(sval): + if sys.version_info < (3, 0) and isinstance(sval, str): + sval = sval.decode("latin1") + return sval.encode("latin1") + + +# Sometimes we want to pass a string that should explicitly be treated as +# a memory blob. +def str2memory(sval): + if sys.version_info < (3, 0): + return buffer(sval) + # py3k. + return memoryview(sval.encode("latin1")) + + +# Sometimes we want to pass an object that exposes its memory +def ob2memory(ob): + if sys.version_info < (3, 0): + return buffer(ob) + # py3k. + return memoryview(ob) + + +## +## unittest related stuff +## + + +# This is a specialized TestCase adaptor which wraps a real test. +class LeakTestCase(unittest.TestCase): + """An 'adaptor' which takes another test. In debug builds we execute the + test once to remove one-off side-effects, then capture the total + reference count, then execute the test a few times. If the total + refcount at the end is greater than we first captured, we have a leak! + + In release builds the test is executed just once, as normal. + + Generally used automatically by the test runner - you can safely + ignore this. + """ + + def __init__(self, real_test): + unittest.TestCase.__init__(self) + self.real_test = real_test + self.num_test_cases = 1 + self.num_leak_iters = 2 # seems to be enough! + if hasattr(sys, "gettotalrefcount"): + self.num_test_cases = self.num_test_cases + self.num_leak_iters + + def countTestCases(self): + return self.num_test_cases + + def __call__(self, result=None): + # For the COM suite's sake, always ensure we don't leak + # gateways/interfaces + from pythoncom import _GetGatewayCount, _GetInterfaceCount + + gc.collect() + ni = _GetInterfaceCount() + ng = _GetGatewayCount() + self.real_test(result) + # Failed - no point checking anything else + if result.shouldStop or not result.wasSuccessful(): + return + self._do_leak_tests(result) + gc.collect() + lost_i = _GetInterfaceCount() - ni + lost_g = _GetGatewayCount() - ng + if lost_i or lost_g: + msg = "%d interface objects and %d gateway objects leaked" % ( + lost_i, + lost_g, + ) + exc = AssertionError(msg) + result.addFailure(self.real_test, (exc.__class__, exc, None)) + + def runTest(self): + assert 0, "not used" + + def _do_leak_tests(self, result=None): + try: + gtrc = sys.gettotalrefcount + except AttributeError: + return # can't do leak tests in this build + # Assume already called once, to prime any caches etc + gc.collect() + trc = gtrc() + for i in range(self.num_leak_iters): + self.real_test(result) + if result.shouldStop: + break + del i # created after we remembered the refcount! + # int division here means one or 2 stray references won't force + # failure, but one per loop + gc.collect() + lost = (gtrc() - trc) // self.num_leak_iters + if lost < 0: + msg = "LeakTest: %s appeared to gain %d references!!" % ( + self.real_test, + -lost, + ) + result.addFailure(self.real_test, (AssertionError, msg, None)) + if lost > 0: + msg = "LeakTest: %s lost %d references" % (self.real_test, lost) + exc = AssertionError(msg) + result.addFailure(self.real_test, (exc.__class__, exc, None)) + + +class TestLoader(unittest.TestLoader): + def loadTestsFromTestCase(self, testCaseClass): + """Return a suite of all tests cases contained in testCaseClass""" + leak_tests = [] + for name in self.getTestCaseNames(testCaseClass): + real_test = testCaseClass(name) + leak_test = self._getTestWrapper(real_test) + leak_tests.append(leak_test) + return self.suiteClass(leak_tests) + + def fixupTestsForLeakTests(self, test): + if isinstance(test, unittest.TestSuite): + test._tests = [self.fixupTestsForLeakTests(t) for t in test._tests] + return test + else: + # just a normal test case. + return self._getTestWrapper(test) + + def _getTestWrapper(self, test): + # one or 2 tests in the COM test suite set this... + no_leak_tests = getattr(test, "no_leak_tests", False) + if no_leak_tests: + print("Test says it doesn't want leak tests!") + return test + return LeakTestCase(test) + + def loadTestsFromModule(self, mod): + if hasattr(mod, "suite"): + tests = mod.suite() + else: + tests = unittest.TestLoader.loadTestsFromModule(self, mod) + return self.fixupTestsForLeakTests(tests) + + def loadTestsFromName(self, name, module=None): + test = unittest.TestLoader.loadTestsFromName(self, name, module) + if isinstance(test, unittest.TestSuite): + pass # hmmm? print "Don't wrap suites yet!", test._tests + elif isinstance(test, unittest.TestCase): + test = self._getTestWrapper(test) + else: + print("XXX - what is", test) + return test + + +# Lots of classes necessary to support one simple feature: we want a 3rd +# test result state - "SKIPPED" - to indicate that the test wasn't able +# to be executed for various reasons. Inspired by bzr's tests, but it +# has other concepts, such as "Expected Failure", which we don't bother +# with. + +# win32 error codes that probably mean we need to be elevated (ie, if we +# aren't elevated, we treat these error codes as 'skipped') +non_admin_error_codes = [ + winerror.ERROR_ACCESS_DENIED, + winerror.ERROR_PRIVILEGE_NOT_HELD, +] + +_is_admin = None + + +def check_is_admin(): + global _is_admin + if _is_admin is None: + import pythoncom + from win32com.shell.shell import IsUserAnAdmin + + try: + _is_admin = IsUserAnAdmin() + except pythoncom.com_error as exc: + if exc.hresult != winerror.E_NOTIMPL: + raise + # not impl on this platform - must be old - assume is admin + _is_admin = True + return _is_admin + + +# Find a test "fixture" (eg, binary test file) expected to be very close to +# the test being run. +# If the tests are being run from the "installed" version, then these fixtures +# probably don't exist - the test is "skipped". +# But it's fatal if we think we might be running from a pywin32 source tree. +def find_test_fixture(basename, extra_dir="."): + # look for the test file in various places + candidates = [ + os.path.dirname(sys.argv[0]), + extra_dir, + ".", + ] + for candidate in candidates: + fname = os.path.join(candidate, basename) + if os.path.isfile(fname): + return fname + else: + # Can't find it - see if this is expected or not. + # This module is typically always in the installed dir, so use argv[0] + this_file = os.path.normcase(os.path.abspath(sys.argv[0])) + dirs_to_check = site.getsitepackages()[:] + if site.USER_SITE: + dirs_to_check.append(site.USER_SITE) + + for d in dirs_to_check: + d = os.path.normcase(d) + if os.path.commonprefix([this_file, d]) == d: + # looks like we are in an installed Python, so skip the text. + raise TestSkipped(f"Can't find test fixture '{fname}'") + # Looks like we are running from source, so this is fatal. + raise RuntimeError(f"Can't find test fixture '{fname}'") + + +# If this exception is raised by a test, the test is reported as a 'skip' +class TestSkipped(Exception): + pass + + +# This appears to have been "upgraded" to non-private in 3.11 +try: + TextTestResult = unittest._TextTestResult +except AttributeError: + TextTestResult = unittest.TextTestResult + + +# The 'TestResult' subclass that records the failures and has the special +# handling for the TestSkipped exception. +class TestResult(TextTestResult): + def __init__(self, *args, **kw): + super(TestResult, self).__init__(*args, **kw) + self.skips = {} # count of skips for each reason. + + def addError(self, test, err): + """Called when an error has occurred. 'err' is a tuple of values as + returned by sys.exc_info(). + """ + # translate a couple of 'well-known' exceptions into 'skipped' + import pywintypes + + exc_val = err[1] + # translate ERROR_ACCESS_DENIED for non-admin users to be skipped. + # (access denied errors for an admin user aren't expected.) + if ( + isinstance(exc_val, pywintypes.error) + and exc_val.winerror in non_admin_error_codes + and not check_is_admin() + ): + exc_val = TestSkipped(exc_val) + # and COM errors due to objects not being registered (the com test + # suite will attempt to catch this and handle it itself if the user + # is admin) + elif isinstance(exc_val, pywintypes.com_error) and exc_val.hresult in [ + winerror.CO_E_CLASSSTRING, + winerror.REGDB_E_CLASSNOTREG, + winerror.TYPE_E_LIBNOTREGISTERED, + ]: + exc_val = TestSkipped(exc_val) + # NotImplemented generally means the platform doesn't support the + # functionality. + elif isinstance(exc_val, NotImplementedError): + exc_val = TestSkipped(NotImplementedError) + + if isinstance(exc_val, TestSkipped): + reason = exc_val.args[0] + # if the reason itself is another exception, get its args. + try: + reason = tuple(reason.args) + except (AttributeError, TypeError): + pass + self.skips.setdefault(reason, 0) + self.skips[reason] += 1 + if self.showAll: + self.stream.writeln("SKIP (%s)" % (reason,)) + elif self.dots: + self.stream.write("S") + self.stream.flush() + return + super(TestResult, self).addError(test, err) + + def printErrors(self): + super(TestResult, self).printErrors() + for reason, num_skipped in self.skips.items(): + self.stream.writeln("SKIPPED: %d tests - %s" % (num_skipped, reason)) + + +# TestRunner subclass necessary just to get our TestResult hooked up. +class TestRunner(unittest.TextTestRunner): + def _makeResult(self): + return TestResult(self.stream, self.descriptions, self.verbosity) + + +# TestProgream subclass necessary just to get our TestRunner hooked up, +# which is necessary to get our TestResult hooked up *sob* +class TestProgram(unittest.TestProgram): + def runTests(self): + # clobber existing runner - *sob* - it shouldn't be this hard + self.testRunner = TestRunner(verbosity=self.verbosity) + unittest.TestProgram.runTests(self) + + +# A convenient entry-point - if used, 'SKIPPED' exceptions will be supressed. +def testmain(*args, **kw): + new_kw = kw.copy() + if "testLoader" not in new_kw: + new_kw["testLoader"] = TestLoader() + program_class = new_kw.get("testProgram", TestProgram) + program_class(*args, **new_kw) diff --git a/lib/win32/lib/pywintypes.py b/lib/win32/lib/pywintypes.py new file mode 100644 index 00000000..115c4f82 --- /dev/null +++ b/lib/win32/lib/pywintypes.py @@ -0,0 +1,126 @@ +# Magic utility that "redirects" to pywintypesxx.dll +import importlib.machinery +import importlib.util +import os +import sys + + +def __import_pywin32_system_module__(modname, globs): + # This has been through a number of iterations. The problem: how to + # locate pywintypesXX.dll when it may be in a number of places, and how + # to avoid ever loading it twice. This problem is compounded by the + # fact that the "right" way to do this requires win32api, but this + # itself requires pywintypesXX. + # And the killer problem is that someone may have done 'import win32api' + # before this code is called. In that case Windows will have already + # loaded pywintypesXX as part of loading win32api - but by the time + # we get here, we may locate a different one. This appears to work, but + # then starts raising bizarre TypeErrors complaining that something + # is not a pywintypes type when it clearly is! + + # So in what we hope is the last major iteration of this, we now + # rely on a _win32sysloader module, implemented in C but not relying + # on pywintypesXX.dll. It then can check if the DLL we are looking for + # lib is already loaded. + # See if this is a debug build. + suffix = "_d" if "_d.pyd" in importlib.machinery.EXTENSION_SUFFIXES else "" + filename = "%s%d%d%s.dll" % ( + modname, + sys.version_info[0], + sys.version_info[1], + suffix, + ) + if hasattr(sys, "frozen"): + # If we are running from a frozen program (py2exe, McMillan, freeze) + # then we try and load the DLL from our sys.path + # XXX - This path may also benefit from _win32sysloader? However, + # MarkH has never seen the DLL load problem with py2exe programs... + for look in sys.path: + # If the sys.path entry is a (presumably) .zip file, use the + # directory + if os.path.isfile(look): + look = os.path.dirname(look) + found = os.path.join(look, filename) + if os.path.isfile(found): + break + else: + raise ImportError( + "Module '%s' isn't in frozen sys.path %s" % (modname, sys.path) + ) + else: + # First see if it already in our process - if so, we must use that. + import _win32sysloader + + found = _win32sysloader.GetModuleFilename(filename) + if found is None: + # We ask Windows to load it next. This is in an attempt to + # get the exact same module loaded should pywintypes be imported + # first (which is how we are here) or if, eg, win32api was imported + # first thereby implicitly loading the DLL. + + # Sadly though, it doesn't quite work - if pywintypesxx.dll + # is in system32 *and* the executable's directory, on XP SP2, an + # import of win32api will cause Windows to load pywintypes + # from system32, where LoadLibrary for that name will + # load the one in the exe's dir. + # That shouldn't really matter though, so long as we only ever + # get one loaded. + found = _win32sysloader.LoadModule(filename) + if found is None: + # Windows can't find it - which although isn't relevent here, + # means that we *must* be the first win32 import, as an attempt + # to import win32api etc would fail when Windows attempts to + # locate the DLL. + # This is most likely to happen for "non-admin" installs, where + # we can't put the files anywhere else on the global path. + + # If there is a version in our Python directory, use that + if os.path.isfile(os.path.join(sys.prefix, filename)): + found = os.path.join(sys.prefix, filename) + if found is None: + # Not in the Python directory? Maybe we were installed via + # easy_install... + if os.path.isfile(os.path.join(os.path.dirname(__file__), filename)): + found = os.path.join(os.path.dirname(__file__), filename) + + # There are 2 site-packages directories - one "global" and one "user". + # We could be in either, or both (but with different versions!). Factors include + # virtualenvs, post-install script being run or not, `setup.py install` flags, etc. + + # In a worst-case, it means, say 'python -c "import win32api"' + # will not work but 'python -c "import pywintypes, win32api"' will, + # but it's better than nothing. + + # We use the same logic as pywin32_bootstrap to find potential location for the dll + # Simply import pywin32_system32 and look in the paths in pywin32_system32.__path__ + + if found is None: + import pywin32_system32 + + for path in pywin32_system32.__path__: + maybe = os.path.join(path, filename) + if os.path.isfile(maybe): + found = maybe + break + + if found is None: + # give up in disgust. + raise ImportError("No system module '%s' (%s)" % (modname, filename)) + # After importing the module, sys.modules is updated to the DLL we just + # loaded - which isn't what we want. So we update sys.modules to refer to + # this module, and update our globals from it. + old_mod = sys.modules[modname] + # Load the DLL. + loader = importlib.machinery.ExtensionFileLoader(modname, found) + spec = importlib.machinery.ModuleSpec(name=modname, loader=loader, origin=found) + mod = importlib.util.module_from_spec(spec) + spec.loader.exec_module(mod) + + # Check the sys.modules[] behaviour we describe above is true... + assert sys.modules[modname] is mod + # as above - re-reset to the *old* module object then update globs. + sys.modules[modname] = old_mod + globs.update(mod.__dict__) + + +__import_pywin32_system_module__("pywintypes", globals()) diff --git a/lib/win32/lib/rasutil.py b/lib/win32/lib/rasutil.py new file mode 100644 index 00000000..fb71b4fc --- /dev/null +++ b/lib/win32/lib/rasutil.py @@ -0,0 +1,40 @@ +import win32ras + +stateStrings = { + win32ras.RASCS_OpenPort: "OpenPort", + win32ras.RASCS_PortOpened: "PortOpened", + win32ras.RASCS_ConnectDevice: "ConnectDevice", + win32ras.RASCS_DeviceConnected: "DeviceConnected", + win32ras.RASCS_AllDevicesConnected: "AllDevicesConnected", + win32ras.RASCS_Authenticate: "Authenticate", + win32ras.RASCS_AuthNotify: "AuthNotify", + win32ras.RASCS_AuthRetry: "AuthRetry", + win32ras.RASCS_AuthCallback: "AuthCallback", + win32ras.RASCS_AuthChangePassword: "AuthChangePassword", + win32ras.RASCS_AuthProject: "AuthProject", + win32ras.RASCS_AuthLinkSpeed: "AuthLinkSpeed", + win32ras.RASCS_AuthAck: "AuthAck", + win32ras.RASCS_ReAuthenticate: "ReAuthenticate", + win32ras.RASCS_Authenticated: "Authenticated", + win32ras.RASCS_PrepareForCallback: "PrepareForCallback", + win32ras.RASCS_WaitForModemReset: "WaitForModemReset", + win32ras.RASCS_WaitForCallback: "WaitForCallback", + win32ras.RASCS_Projected: "Projected", + win32ras.RASCS_StartAuthentication: "StartAuthentication", + win32ras.RASCS_CallbackComplete: "CallbackComplete", + win32ras.RASCS_LogonNetwork: "LogonNetwork", + win32ras.RASCS_Interactive: "Interactive", + win32ras.RASCS_RetryAuthentication: "RetryAuthentication", + win32ras.RASCS_CallbackSetByCaller: "CallbackSetByCaller", + win32ras.RASCS_PasswordExpired: "PasswordExpired", + win32ras.RASCS_Connected: "Connected", + win32ras.RASCS_Disconnected: "Disconnected", +} + + +def TestCallback(hras, msg, state, error, exterror): + print("Callback called with ", hras, msg, stateStrings[state], error, exterror) + + +def test(rasName="_ Divert Off"): + return win32ras.Dial(None, None, (rasName,), TestCallback) diff --git a/lib/win32/lib/regcheck.py b/lib/win32/lib/regcheck.py new file mode 100644 index 00000000..c07b77b7 --- /dev/null +++ b/lib/win32/lib/regcheck.py @@ -0,0 +1,162 @@ +# This module is very old and useless in this day and age! It will be +# removed in a few years (ie, 2009 or so...) + +import warnings + +warnings.warn( + "The regcheck module has been pending deprecation since build 210", + category=PendingDeprecationWarning, +) + +import os +import sys + +import regutil +import win32api +import win32con + + +def CheckRegisteredExe(exename): + try: + os.stat( + win32api.RegQueryValue( + regutil.GetRootKey(), regutil.GetAppPathsKey() + "\\" + exename + ) + ) + # except SystemError: + except (os.error, win32api.error): + print("Registration of %s - Not registered correctly" % exename) + + +def CheckPathString(pathString): + for path in pathString.split(";"): + if not os.path.isdir(path): + return "'%s' is not a valid directory!" % path + return None + + +def CheckPythonPaths(verbose): + if verbose: + print("Python Paths:") + # Check the core path + if verbose: + print("\tCore Path:", end=" ") + try: + appPath = win32api.RegQueryValue( + regutil.GetRootKey(), regutil.BuildDefaultPythonKey() + "\\PythonPath" + ) + except win32api.error as exc: + print("** does not exist - ", exc.strerror) + problem = CheckPathString(appPath) + if problem: + print(problem) + else: + if verbose: + print(appPath) + + key = win32api.RegOpenKey( + regutil.GetRootKey(), + regutil.BuildDefaultPythonKey() + "\\PythonPath", + 0, + win32con.KEY_READ, + ) + try: + keyNo = 0 + while 1: + try: + appName = win32api.RegEnumKey(key, keyNo) + appPath = win32api.RegQueryValue(key, appName) + if verbose: + print("\t" + appName + ":", end=" ") + if appPath: + problem = CheckPathString(appPath) + if problem: + print(problem) + else: + if verbose: + print(appPath) + else: + if verbose: + print("(empty)") + keyNo = keyNo + 1 + except win32api.error: + break + finally: + win32api.RegCloseKey(key) + + +def CheckHelpFiles(verbose): + if verbose: + print("Help Files:") + try: + key = win32api.RegOpenKey( + regutil.GetRootKey(), + regutil.BuildDefaultPythonKey() + "\\Help", + 0, + win32con.KEY_READ, + ) + except win32api.error as exc: + import winerror + + if exc.winerror != winerror.ERROR_FILE_NOT_FOUND: + raise + return + + try: + keyNo = 0 + while 1: + try: + helpDesc = win32api.RegEnumKey(key, keyNo) + helpFile = win32api.RegQueryValue(key, helpDesc) + if verbose: + print("\t" + helpDesc + ":", end=" ") + # query the os section. + try: + os.stat(helpFile) + if verbose: + print(helpFile) + except os.error: + print("** Help file %s does not exist" % helpFile) + keyNo = keyNo + 1 + except win32api.error as exc: + import winerror + + if exc.winerror != winerror.ERROR_NO_MORE_ITEMS: + raise + break + finally: + win32api.RegCloseKey(key) + + +def CheckRegisteredModules(verbose): + # Check out all registered modules. + k = regutil.BuildDefaultPythonKey() + "\\Modules" + try: + keyhandle = win32api.RegOpenKey(regutil.GetRootKey(), k) + print("WARNING: 'Modules' registry entry is deprectated and evil!") + except win32api.error as exc: + import winerror + + if exc.winerror != winerror.ERROR_FILE_NOT_FOUND: + raise + return + + +def CheckRegistry(verbose=0): + # check the registered modules + if verbose and "pythonpath" in os.environ: + print("Warning - PythonPath in environment - please check it!") + # Check out all paths on sys.path + + CheckPythonPaths(verbose) + CheckHelpFiles(verbose) + CheckRegisteredModules(verbose) + CheckRegisteredExe("Python.exe") + + +if __name__ == "__main__": + if len(sys.argv) > 1 and sys.argv[1] == "-q": + verbose = 0 + else: + verbose = 1 + CheckRegistry(verbose) diff --git a/lib/win32/lib/regutil.py b/lib/win32/lib/regutil.py new file mode 100644 index 00000000..1abdd551 --- /dev/null +++ b/lib/win32/lib/regutil.py @@ -0,0 +1,397 @@ +# Some registry helpers. +import os +import sys + +import win32api +import win32con + +error = "Registry utility error" + +# A .py file has a CLSID associated with it (why? - dunno!) +CLSIDPyFile = "{b51df050-06ae-11cf-ad3b-524153480001}" + +RegistryIDPyFile = "Python.File" # The registry "file type" of a .py file +RegistryIDPycFile = "Python.CompiledFile" # The registry "file type" of a .pyc file + + +def BuildDefaultPythonKey(): + """Builds a string containing the path to the current registry key. + + The Python registry key contains the Python version. This function + uses the version of the DLL used by the current process to get the + registry key currently in use. + """ + return "Software\\Python\\PythonCore\\" + sys.winver + + +def GetRootKey(): + """Retrieves the Registry root in use by Python.""" + keyname = BuildDefaultPythonKey() + try: + k = win32api.RegOpenKey(win32con.HKEY_CURRENT_USER, keyname) + k.close() + return win32con.HKEY_CURRENT_USER + except win32api.error: + return win32con.HKEY_LOCAL_MACHINE + + +def GetRegistryDefaultValue(subkey, rootkey=None): + """A helper to return the default value for a key in the registry.""" + if rootkey is None: + rootkey = GetRootKey() + return win32api.RegQueryValue(rootkey, subkey) + + +def SetRegistryDefaultValue(subKey, value, rootkey=None): + """A helper to set the default value for a key in the registry""" + if rootkey is None: + rootkey = GetRootKey() + if type(value) == str: + typeId = win32con.REG_SZ + elif type(value) == int: + typeId = win32con.REG_DWORD + else: + raise TypeError("Value must be string or integer - was passed " + repr(value)) + + win32api.RegSetValue(rootkey, subKey, typeId, value) + + +def GetAppPathsKey(): + return "Software\\Microsoft\\Windows\\CurrentVersion\\App Paths" + + +def RegisterPythonExe(exeFullPath, exeAlias=None, exeAppPath=None): + """Register a .exe file that uses Python. + + Registers the .exe with the OS. This allows the specified .exe to + be run from the command-line or start button without using the full path, + and also to setup application specific path (ie, os.environ['PATH']). + + Currently the exeAppPath is not supported, so this function is general + purpose, and not specific to Python at all. Later, exeAppPath may provide + a reasonable default that is used. + + exeFullPath -- The full path to the .exe + exeAlias = None -- An alias for the exe - if none, the base portion + of the filename is used. + exeAppPath -- Not supported. + """ + # Note - Dont work on win32s (but we dont care anymore!) + if exeAppPath: + raise error("Do not support exeAppPath argument currently") + if exeAlias is None: + exeAlias = os.path.basename(exeFullPath) + win32api.RegSetValue( + GetRootKey(), GetAppPathsKey() + "\\" + exeAlias, win32con.REG_SZ, exeFullPath + ) + + +def GetRegisteredExe(exeAlias): + """Get a registered .exe""" + return win32api.RegQueryValue(GetRootKey(), GetAppPathsKey() + "\\" + exeAlias) + + +def UnregisterPythonExe(exeAlias): + """Unregister a .exe file that uses Python.""" + try: + win32api.RegDeleteKey(GetRootKey(), GetAppPathsKey() + "\\" + exeAlias) + except win32api.error as exc: + import winerror + + if exc.winerror != winerror.ERROR_FILE_NOT_FOUND: + raise + return + + +def RegisterNamedPath(name, path): + """Register a named path - ie, a named PythonPath entry.""" + keyStr = BuildDefaultPythonKey() + "\\PythonPath" + if name: + keyStr = keyStr + "\\" + name + win32api.RegSetValue(GetRootKey(), keyStr, win32con.REG_SZ, path) + + +def UnregisterNamedPath(name): + """Unregister a named path - ie, a named PythonPath entry.""" + keyStr = BuildDefaultPythonKey() + "\\PythonPath\\" + name + try: + win32api.RegDeleteKey(GetRootKey(), keyStr) + except win32api.error as exc: + import winerror + + if exc.winerror != winerror.ERROR_FILE_NOT_FOUND: + raise + return + + +def GetRegisteredNamedPath(name): + """Get a registered named path, or None if it doesnt exist.""" + keyStr = BuildDefaultPythonKey() + "\\PythonPath" + if name: + keyStr = keyStr + "\\" + name + try: + return win32api.RegQueryValue(GetRootKey(), keyStr) + except win32api.error as exc: + import winerror + + if exc.winerror != winerror.ERROR_FILE_NOT_FOUND: + raise + return None + + +def RegisterModule(modName, modPath): + """Register an explicit module in the registry. This forces the Python import + mechanism to locate this module directly, without a sys.path search. Thus + a registered module need not appear in sys.path at all. + + modName -- The name of the module, as used by import. + modPath -- The full path and file name of the module. + """ + try: + import os + + os.stat(modPath) + except os.error: + print("Warning: Registering non-existant module %s" % modPath) + win32api.RegSetValue( + GetRootKey(), + BuildDefaultPythonKey() + "\\Modules\\%s" % modName, + win32con.REG_SZ, + modPath, + ) + + +def UnregisterModule(modName): + """Unregister an explicit module in the registry. + + modName -- The name of the module, as used by import. + """ + try: + win32api.RegDeleteKey( + GetRootKey(), BuildDefaultPythonKey() + "\\Modules\\%s" % modName + ) + except win32api.error as exc: + import winerror + + if exc.winerror != winerror.ERROR_FILE_NOT_FOUND: + raise + + +def GetRegisteredHelpFile(helpDesc): + """Given a description, return the registered entry.""" + try: + return GetRegistryDefaultValue(BuildDefaultPythonKey() + "\\Help\\" + helpDesc) + except win32api.error: + try: + return GetRegistryDefaultValue( + BuildDefaultPythonKey() + "\\Help\\" + helpDesc, + win32con.HKEY_CURRENT_USER, + ) + except win32api.error: + pass + return None + + +def RegisterHelpFile(helpFile, helpPath, helpDesc=None, bCheckFile=1): + """Register a help file in the registry. + + Note that this used to support writing to the Windows Help + key, however this is no longer done, as it seems to be incompatible. + + helpFile -- the base name of the help file. + helpPath -- the path to the help file + helpDesc -- A description for the help file. If None, the helpFile param is used. + bCheckFile -- A flag indicating if the file existence should be checked. + """ + if helpDesc is None: + helpDesc = helpFile + fullHelpFile = os.path.join(helpPath, helpFile) + try: + if bCheckFile: + os.stat(fullHelpFile) + except os.error: + raise ValueError("Help file does not exist") + # Now register with Python itself. + win32api.RegSetValue( + GetRootKey(), + BuildDefaultPythonKey() + "\\Help\\%s" % helpDesc, + win32con.REG_SZ, + fullHelpFile, + ) + + +def UnregisterHelpFile(helpFile, helpDesc=None): + """Unregister a help file in the registry. + + helpFile -- the base name of the help file. + helpDesc -- A description for the help file. If None, the helpFile param is used. + """ + key = win32api.RegOpenKey( + win32con.HKEY_LOCAL_MACHINE, + "Software\\Microsoft\\Windows\\Help", + 0, + win32con.KEY_ALL_ACCESS, + ) + try: + try: + win32api.RegDeleteValue(key, helpFile) + except win32api.error as exc: + import winerror + + if exc.winerror != winerror.ERROR_FILE_NOT_FOUND: + raise + finally: + win32api.RegCloseKey(key) + + # Now de-register with Python itself. + if helpDesc is None: + helpDesc = helpFile + try: + win32api.RegDeleteKey( + GetRootKey(), BuildDefaultPythonKey() + "\\Help\\%s" % helpDesc + ) + except win32api.error as exc: + import winerror + + if exc.winerror != winerror.ERROR_FILE_NOT_FOUND: + raise + + +def RegisterCoreDLL(coredllName=None): + """Registers the core DLL in the registry. + + If no params are passed, the name of the Python DLL used in + the current process is used and registered. + """ + if coredllName is None: + coredllName = win32api.GetModuleFileName(sys.dllhandle) + # must exist! + else: + try: + os.stat(coredllName) + except os.error: + print("Warning: Registering non-existant core DLL %s" % coredllName) + + hKey = win32api.RegCreateKey(GetRootKey(), BuildDefaultPythonKey()) + try: + win32api.RegSetValue(hKey, "Dll", win32con.REG_SZ, coredllName) + finally: + win32api.RegCloseKey(hKey) + # Lastly, setup the current version to point to me. + win32api.RegSetValue( + GetRootKey(), + "Software\\Python\\PythonCore\\CurrentVersion", + win32con.REG_SZ, + sys.winver, + ) + + +def RegisterFileExtensions(defPyIcon, defPycIcon, runCommand): + """Register the core Python file extensions. + + defPyIcon -- The default icon to use for .py files, in 'fname,offset' format. + defPycIcon -- The default icon to use for .pyc files, in 'fname,offset' format. + runCommand -- The command line to use for running .py files + """ + # Register the file extensions. + pythonFileId = RegistryIDPyFile + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, ".py", win32con.REG_SZ, pythonFileId + ) + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, pythonFileId, win32con.REG_SZ, "Python File" + ) + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, + "%s\\CLSID" % pythonFileId, + win32con.REG_SZ, + CLSIDPyFile, + ) + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, + "%s\\DefaultIcon" % pythonFileId, + win32con.REG_SZ, + defPyIcon, + ) + base = "%s\\Shell" % RegistryIDPyFile + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, base + "\\Open", win32con.REG_SZ, "Run" + ) + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, + base + "\\Open\\Command", + win32con.REG_SZ, + runCommand, + ) + + # Register the .PYC. + pythonFileId = RegistryIDPycFile + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, ".pyc", win32con.REG_SZ, pythonFileId + ) + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, + pythonFileId, + win32con.REG_SZ, + "Compiled Python File", + ) + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, + "%s\\DefaultIcon" % pythonFileId, + win32con.REG_SZ, + defPycIcon, + ) + base = "%s\\Shell" % pythonFileId + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, base + "\\Open", win32con.REG_SZ, "Run" + ) + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, + base + "\\Open\\Command", + win32con.REG_SZ, + runCommand, + ) + + +def RegisterShellCommand(shellCommand, exeCommand, shellUserCommand=None): + # Last param for "Open" - for a .py file to be executed by the command line + # or shell execute (eg, just entering "foo.py"), the Command must be "Open", + # but you may associate a different name for the right-click menu. + # In our case, normally we have "Open=Run" + base = "%s\\Shell" % RegistryIDPyFile + if shellUserCommand: + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, + base + "\\%s" % (shellCommand), + win32con.REG_SZ, + shellUserCommand, + ) + + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, + base + "\\%s\\Command" % (shellCommand), + win32con.REG_SZ, + exeCommand, + ) + + +def RegisterDDECommand(shellCommand, ddeApp, ddeTopic, ddeCommand): + base = "%s\\Shell" % RegistryIDPyFile + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, + base + "\\%s\\ddeexec" % (shellCommand), + win32con.REG_SZ, + ddeCommand, + ) + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, + base + "\\%s\\ddeexec\\Application" % (shellCommand), + win32con.REG_SZ, + ddeApp, + ) + win32api.RegSetValue( + win32con.HKEY_CLASSES_ROOT, + base + "\\%s\\ddeexec\\Topic" % (shellCommand), + win32con.REG_SZ, + ddeTopic, + ) diff --git a/lib/win32/lib/sspi.py b/lib/win32/lib/sspi.py new file mode 100644 index 00000000..22c0e4a0 --- /dev/null +++ b/lib/win32/lib/sspi.py @@ -0,0 +1,412 @@ +""" +Helper classes for SSPI authentication via the win32security module. + +SSPI authentication involves a token-exchange "dance", the exact details +of which depends on the authentication provider used. There are also +a number of complex flags and constants that need to be used - in most +cases, there are reasonable defaults. + +These classes attempt to hide these details from you until you really need +to know. They are not designed to handle all cases, just the common ones. +If you need finer control than offered here, just use the win32security +functions directly. +""" +# Based on Roger Upole's sspi demos. +# $Id$ +import sspicon +import win32security + +error = win32security.error + + +class _BaseAuth(object): + def __init__(self): + self.reset() + + def reset(self): + """Reset everything to an unauthorized state""" + self.ctxt = None + self.authenticated = False + self.initiator_name = None + self.service_name = None + + # The next seq_num for an encrypt/sign operation + self.next_seq_num = 0 + + def _get_next_seq_num(self): + """Get the next sequence number for a transmission. Default + implementation is to increment a counter + """ + ret = self.next_seq_num + self.next_seq_num = self.next_seq_num + 1 + return ret + + def encrypt(self, data): + """Encrypt a string, returning a tuple of (encrypted_data, trailer). + These can be passed to decrypt to get back the original string. + """ + pkg_size_info = self.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_SIZES) + trailersize = pkg_size_info["SecurityTrailer"] + + encbuf = win32security.PySecBufferDescType() + encbuf.append(win32security.PySecBufferType(len(data), sspicon.SECBUFFER_DATA)) + encbuf.append( + win32security.PySecBufferType(trailersize, sspicon.SECBUFFER_TOKEN) + ) + encbuf[0].Buffer = data + self.ctxt.EncryptMessage(0, encbuf, self._get_next_seq_num()) + return encbuf[0].Buffer, encbuf[1].Buffer + + def decrypt(self, data, trailer): + """Decrypt a previously encrypted string, returning the orignal data""" + encbuf = win32security.PySecBufferDescType() + encbuf.append(win32security.PySecBufferType(len(data), sspicon.SECBUFFER_DATA)) + encbuf.append( + win32security.PySecBufferType(len(trailer), sspicon.SECBUFFER_TOKEN) + ) + encbuf[0].Buffer = data + encbuf[1].Buffer = trailer + self.ctxt.DecryptMessage(encbuf, self._get_next_seq_num()) + return encbuf[0].Buffer + + def sign(self, data): + """sign a string suitable for transmission, returning the signature. + Passing the data and signature to verify will determine if the data + is unchanged. + """ + pkg_size_info = self.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_SIZES) + sigsize = pkg_size_info["MaxSignature"] + sigbuf = win32security.PySecBufferDescType() + sigbuf.append(win32security.PySecBufferType(len(data), sspicon.SECBUFFER_DATA)) + sigbuf.append(win32security.PySecBufferType(sigsize, sspicon.SECBUFFER_TOKEN)) + sigbuf[0].Buffer = data + + self.ctxt.MakeSignature(0, sigbuf, self._get_next_seq_num()) + return sigbuf[1].Buffer + + def verify(self, data, sig): + """Verifies data and its signature. If verification fails, an sspi.error + will be raised. + """ + sigbuf = win32security.PySecBufferDescType() + sigbuf.append(win32security.PySecBufferType(len(data), sspicon.SECBUFFER_DATA)) + sigbuf.append(win32security.PySecBufferType(len(sig), sspicon.SECBUFFER_TOKEN)) + + sigbuf[0].Buffer = data + sigbuf[1].Buffer = sig + self.ctxt.VerifySignature(sigbuf, self._get_next_seq_num()) + + def unwrap(self, token): + """ + GSSAPI's unwrap with SSPI. + https://docs.microsoft.com/en-us/windows/win32/secauthn/sspi-kerberos-interoperability-with-gssapi + + Usable mainly with Kerberos SSPI package, but this is not enforced. + + Return the clear text, and a boolean that is True if the token was encrypted. + """ + buffer = win32security.PySecBufferDescType() + # This buffer will contain a "stream", which is the token coming from the other side + buffer.append( + win32security.PySecBufferType(len(token), sspicon.SECBUFFER_STREAM) + ) + buffer[0].Buffer = token + + # This buffer will receive the clear, or just unwrapped text if no encryption was used. + # Will be resized by the lib. + buffer.append(win32security.PySecBufferType(0, sspicon.SECBUFFER_DATA)) + + pfQOP = self.ctxt.DecryptMessage(buffer, self._get_next_seq_num()) + + r = buffer[1].Buffer + return r, not (pfQOP == sspicon.SECQOP_WRAP_NO_ENCRYPT) + + def wrap(self, msg, encrypt=False): + """ + GSSAPI's wrap with SSPI. + https://docs.microsoft.com/en-us/windows/win32/secauthn/sspi-kerberos-interoperability-with-gssapi + + Usable mainly with Kerberos SSPI package, but this is not enforced. + + Wrap a message to be sent to the other side. Encrypted if encrypt is True. + """ + + size_info = self.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_SIZES) + trailer_size = size_info["SecurityTrailer"] + block_size = size_info["BlockSize"] + + buffer = win32security.PySecBufferDescType() + + # This buffer will contain unencrypted data to wrap, and maybe encrypt. + buffer.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA)) + buffer[0].Buffer = msg + + # Will receive the token that forms the beginning of the msg + buffer.append( + win32security.PySecBufferType(trailer_size, sspicon.SECBUFFER_TOKEN) + ) + + # The trailer is needed in case of block encryption + buffer.append( + win32security.PySecBufferType(block_size, sspicon.SECBUFFER_PADDING) + ) + + fQOP = 0 if encrypt else sspicon.SECQOP_WRAP_NO_ENCRYPT + self.ctxt.EncryptMessage(fQOP, buffer, self._get_next_seq_num()) + + # Sec token, then data, then padding + r = buffer[1].Buffer + buffer[0].Buffer + buffer[2].Buffer + return r + + def _amend_ctx_name(self): + """Adds initiator and service names in the security context for ease of use""" + if not self.authenticated: + raise ValueError("Sec context is not completely authenticated") + + try: + names = self.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_NATIVE_NAMES) + except error: + # The SSP doesn't provide these attributes. + pass + else: + self.initiator_name, self.service_name = names + + +class ClientAuth(_BaseAuth): + """Manages the client side of an SSPI authentication handshake""" + + def __init__( + self, + pkg_name, # Name of the package to used. + client_name=None, # User for whom credentials are used. + auth_info=None, # or a tuple of (username, domain, password) + targetspn=None, # Target security context provider name. + scflags=None, # security context flags + datarep=sspicon.SECURITY_NETWORK_DREP, + ): + if scflags is None: + scflags = ( + sspicon.ISC_REQ_INTEGRITY + | sspicon.ISC_REQ_SEQUENCE_DETECT + | sspicon.ISC_REQ_REPLAY_DETECT + | sspicon.ISC_REQ_CONFIDENTIALITY + ) + self.scflags = scflags + self.datarep = datarep + self.targetspn = targetspn + self.pkg_info = win32security.QuerySecurityPackageInfo(pkg_name) + ( + self.credentials, + self.credentials_expiry, + ) = win32security.AcquireCredentialsHandle( + client_name, + self.pkg_info["Name"], + sspicon.SECPKG_CRED_OUTBOUND, + None, + auth_info, + ) + _BaseAuth.__init__(self) + + def authorize(self, sec_buffer_in): + """Perform *one* step of the client authentication process. Pass None for the first round""" + if ( + sec_buffer_in is not None + and type(sec_buffer_in) != win32security.PySecBufferDescType + ): + # User passed us the raw data - wrap it into a SecBufferDesc + sec_buffer_new = win32security.PySecBufferDescType() + tokenbuf = win32security.PySecBufferType( + self.pkg_info["MaxToken"], sspicon.SECBUFFER_TOKEN + ) + tokenbuf.Buffer = sec_buffer_in + sec_buffer_new.append(tokenbuf) + sec_buffer_in = sec_buffer_new + sec_buffer_out = win32security.PySecBufferDescType() + tokenbuf = win32security.PySecBufferType( + self.pkg_info["MaxToken"], sspicon.SECBUFFER_TOKEN + ) + sec_buffer_out.append(tokenbuf) + ## input context handle should be NULL on first call + ctxtin = self.ctxt + if self.ctxt is None: + self.ctxt = win32security.PyCtxtHandleType() + err, attr, exp = win32security.InitializeSecurityContext( + self.credentials, + ctxtin, + self.targetspn, + self.scflags, + self.datarep, + sec_buffer_in, + self.ctxt, + sec_buffer_out, + ) + # Stash these away incase someone needs to know the state from the + # final call. + self.ctxt_attr = attr + self.ctxt_expiry = exp + + if err in (sspicon.SEC_I_COMPLETE_NEEDED, sspicon.SEC_I_COMPLETE_AND_CONTINUE): + self.ctxt.CompleteAuthToken(sec_buffer_out) + + self.authenticated = err == 0 + if self.authenticated: + self._amend_ctx_name() + + return err, sec_buffer_out + + +class ServerAuth(_BaseAuth): + """Manages the server side of an SSPI authentication handshake""" + + def __init__( + self, pkg_name, spn=None, scflags=None, datarep=sspicon.SECURITY_NETWORK_DREP + ): + self.spn = spn + self.datarep = datarep + + if scflags is None: + scflags = ( + sspicon.ASC_REQ_INTEGRITY + | sspicon.ASC_REQ_SEQUENCE_DETECT + | sspicon.ASC_REQ_REPLAY_DETECT + | sspicon.ASC_REQ_CONFIDENTIALITY + ) + # Should we default to sspicon.KerbAddExtraCredentialsMessage + # if pkg_name=='Kerberos'? + self.scflags = scflags + + self.pkg_info = win32security.QuerySecurityPackageInfo(pkg_name) + + ( + self.credentials, + self.credentials_expiry, + ) = win32security.AcquireCredentialsHandle( + spn, self.pkg_info["Name"], sspicon.SECPKG_CRED_INBOUND, None, None + ) + _BaseAuth.__init__(self) + + def authorize(self, sec_buffer_in): + """Perform *one* step of the server authentication process.""" + if ( + sec_buffer_in is not None + and type(sec_buffer_in) != win32security.PySecBufferDescType + ): + # User passed us the raw data - wrap it into a SecBufferDesc + sec_buffer_new = win32security.PySecBufferDescType() + tokenbuf = win32security.PySecBufferType( + self.pkg_info["MaxToken"], sspicon.SECBUFFER_TOKEN + ) + tokenbuf.Buffer = sec_buffer_in + sec_buffer_new.append(tokenbuf) + sec_buffer_in = sec_buffer_new + + sec_buffer_out = win32security.PySecBufferDescType() + tokenbuf = win32security.PySecBufferType( + self.pkg_info["MaxToken"], sspicon.SECBUFFER_TOKEN + ) + sec_buffer_out.append(tokenbuf) + ## input context handle is None initially, then handle returned from last call thereafter + ctxtin = self.ctxt + if self.ctxt is None: + self.ctxt = win32security.PyCtxtHandleType() + err, attr, exp = win32security.AcceptSecurityContext( + self.credentials, + ctxtin, + sec_buffer_in, + self.scflags, + self.datarep, + self.ctxt, + sec_buffer_out, + ) + + # Stash these away incase someone needs to know the state from the + # final call. + self.ctxt_attr = attr + self.ctxt_expiry = exp + + if err in (sspicon.SEC_I_COMPLETE_NEEDED, sspicon.SEC_I_COMPLETE_AND_CONTINUE): + self.ctxt.CompleteAuthToken(sec_buffer_out) + + self.authenticated = err == 0 + if self.authenticated: + self._amend_ctx_name() + + return err, sec_buffer_out + + +if __name__ == "__main__": + # This is the security package (the security support provider / the security backend) + # we want to use for this example. + ssp = "Kerberos" # or "NTLM" or "Negotiate" which enable negotiation between + # Kerberos (prefered) and NTLM (if not supported on the other side). + + flags = ( + sspicon.ISC_REQ_MUTUAL_AUTH + | sspicon.ISC_REQ_INTEGRITY # mutual authentication + | sspicon.ISC_REQ_SEQUENCE_DETECT # check for integrity + | sspicon.ISC_REQ_CONFIDENTIALITY # enable out-of-order messages + | sspicon.ISC_REQ_REPLAY_DETECT # request confidentiality # request replay detection + ) + + # Get our identity, mandatory for the Kerberos case *for this example* + # Kerberos cannot be used if we don't tell it the target we want + # to authenticate to. + cred_handle, exp = win32security.AcquireCredentialsHandle( + None, ssp, sspicon.SECPKG_CRED_INBOUND, None, None + ) + cred = cred_handle.QueryCredentialsAttributes(sspicon.SECPKG_CRED_ATTR_NAMES) + print("We are:", cred) + + # Setup the 2 contexts. In real life, only one is needed: the other one is + # created in the process we want to communicate with. + sspiclient = ClientAuth(ssp, scflags=flags, targetspn=cred) + sspiserver = ServerAuth(ssp, scflags=flags) + + print( + "SSP : %s (%s)" % (sspiclient.pkg_info["Name"], sspiclient.pkg_info["Comment"]) + ) + + # Perform the authentication dance, each loop exchanging more information + # on the way to completing authentication. + sec_buffer = None + client_step = 0 + server_step = 0 + while not (sspiclient.authenticated) or len(sec_buffer[0].Buffer): + client_step += 1 + err, sec_buffer = sspiclient.authorize(sec_buffer) + print("Client step %s" % client_step) + if sspiserver.authenticated and len(sec_buffer[0].Buffer) == 0: + break + + server_step += 1 + err, sec_buffer = sspiserver.authorize(sec_buffer) + print("Server step %s" % server_step) + + # Authentication process is finished. + print("Initiator name from the service side:", sspiserver.initiator_name) + print("Service name from the client side: ", sspiclient.service_name) + + data = "hello".encode("ascii") # py3k-friendly + + # Simple signature, not compatible with GSSAPI. + sig = sspiclient.sign(data) + sspiserver.verify(data, sig) + + # Encryption + encrypted, sig = sspiclient.encrypt(data) + decrypted = sspiserver.decrypt(encrypted, sig) + assert decrypted == data + + # GSSAPI wrapping, no encryption (NTLM always encrypts) + wrapped = sspiclient.wrap(data) + unwrapped, was_encrypted = sspiserver.unwrap(wrapped) + print("encrypted ?", was_encrypted) + assert data == unwrapped + + # GSSAPI wrapping, with encryption + wrapped = sspiserver.wrap(data, encrypt=True) + unwrapped, was_encrypted = sspiclient.unwrap(wrapped) + print("encrypted ?", was_encrypted) + assert data == unwrapped + + print("cool!") diff --git a/lib/win32/lib/sspicon.py b/lib/win32/lib/sspicon.py new file mode 100644 index 00000000..12f7482d --- /dev/null +++ b/lib/win32/lib/sspicon.py @@ -0,0 +1,477 @@ +# Generated by h2py from c:\microsoft sdk\include\sspi.h +ISSP_LEVEL = 32 +ISSP_MODE = 1 + + +def SEC_SUCCESS(Status): + return (Status) >= 0 + + +SECPKG_FLAG_INTEGRITY = 1 +SECPKG_FLAG_PRIVACY = 2 +SECPKG_FLAG_TOKEN_ONLY = 4 +SECPKG_FLAG_DATAGRAM = 8 +SECPKG_FLAG_CONNECTION = 16 +SECPKG_FLAG_MULTI_REQUIRED = 32 +SECPKG_FLAG_CLIENT_ONLY = 64 +SECPKG_FLAG_EXTENDED_ERROR = 128 +SECPKG_FLAG_IMPERSONATION = 256 +SECPKG_FLAG_ACCEPT_WIN32_NAME = 512 +SECPKG_FLAG_STREAM = 1024 +SECPKG_FLAG_NEGOTIABLE = 2048 +SECPKG_FLAG_GSS_COMPATIBLE = 4096 +SECPKG_FLAG_LOGON = 8192 +SECPKG_FLAG_ASCII_BUFFERS = 16384 +SECPKG_FLAG_FRAGMENT = 32768 +SECPKG_FLAG_MUTUAL_AUTH = 65536 +SECPKG_FLAG_DELEGATION = 131072 +SECPKG_FLAG_READONLY_WITH_CHECKSUM = 262144 +SECPKG_ID_NONE = 65535 + +SECBUFFER_VERSION = 0 +SECBUFFER_EMPTY = 0 +SECBUFFER_DATA = 1 +SECBUFFER_TOKEN = 2 +SECBUFFER_PKG_PARAMS = 3 +SECBUFFER_MISSING = 4 +SECBUFFER_EXTRA = 5 +SECBUFFER_STREAM_TRAILER = 6 +SECBUFFER_STREAM_HEADER = 7 +SECBUFFER_NEGOTIATION_INFO = 8 +SECBUFFER_PADDING = 9 +SECBUFFER_STREAM = 10 +SECBUFFER_MECHLIST = 11 +SECBUFFER_MECHLIST_SIGNATURE = 12 +SECBUFFER_TARGET = 13 +SECBUFFER_CHANNEL_BINDINGS = 14 +SECBUFFER_ATTRMASK = -268435456 +SECBUFFER_READONLY = -2147483648 +SECBUFFER_READONLY_WITH_CHECKSUM = 268435456 +SECBUFFER_RESERVED = 1610612736 + +SECURITY_NATIVE_DREP = 16 +SECURITY_NETWORK_DREP = 0 + +SECPKG_CRED_INBOUND = 1 +SECPKG_CRED_OUTBOUND = 2 +SECPKG_CRED_BOTH = 3 +SECPKG_CRED_DEFAULT = 4 +SECPKG_CRED_RESERVED = -268435456 + +ISC_REQ_DELEGATE = 1 +ISC_REQ_MUTUAL_AUTH = 2 +ISC_REQ_REPLAY_DETECT = 4 +ISC_REQ_SEQUENCE_DETECT = 8 +ISC_REQ_CONFIDENTIALITY = 16 +ISC_REQ_USE_SESSION_KEY = 32 +ISC_REQ_PROMPT_FOR_CREDS = 64 +ISC_REQ_USE_SUPPLIED_CREDS = 128 +ISC_REQ_ALLOCATE_MEMORY = 256 +ISC_REQ_USE_DCE_STYLE = 512 +ISC_REQ_DATAGRAM = 1024 +ISC_REQ_CONNECTION = 2048 +ISC_REQ_CALL_LEVEL = 4096 +ISC_REQ_FRAGMENT_SUPPLIED = 8192 +ISC_REQ_EXTENDED_ERROR = 16384 +ISC_REQ_STREAM = 32768 +ISC_REQ_INTEGRITY = 65536 +ISC_REQ_IDENTIFY = 131072 +ISC_REQ_NULL_SESSION = 262144 +ISC_REQ_MANUAL_CRED_VALIDATION = 524288 +ISC_REQ_RESERVED1 = 1048576 +ISC_REQ_FRAGMENT_TO_FIT = 2097152 +ISC_REQ_HTTP = 0x10000000 +ISC_RET_DELEGATE = 1 +ISC_RET_MUTUAL_AUTH = 2 +ISC_RET_REPLAY_DETECT = 4 +ISC_RET_SEQUENCE_DETECT = 8 +ISC_RET_CONFIDENTIALITY = 16 +ISC_RET_USE_SESSION_KEY = 32 +ISC_RET_USED_COLLECTED_CREDS = 64 +ISC_RET_USED_SUPPLIED_CREDS = 128 +ISC_RET_ALLOCATED_MEMORY = 256 +ISC_RET_USED_DCE_STYLE = 512 +ISC_RET_DATAGRAM = 1024 +ISC_RET_CONNECTION = 2048 +ISC_RET_INTERMEDIATE_RETURN = 4096 +ISC_RET_CALL_LEVEL = 8192 +ISC_RET_EXTENDED_ERROR = 16384 +ISC_RET_STREAM = 32768 +ISC_RET_INTEGRITY = 65536 +ISC_RET_IDENTIFY = 131072 +ISC_RET_NULL_SESSION = 262144 +ISC_RET_MANUAL_CRED_VALIDATION = 524288 +ISC_RET_RESERVED1 = 1048576 +ISC_RET_FRAGMENT_ONLY = 2097152 + +ASC_REQ_DELEGATE = 1 +ASC_REQ_MUTUAL_AUTH = 2 +ASC_REQ_REPLAY_DETECT = 4 +ASC_REQ_SEQUENCE_DETECT = 8 +ASC_REQ_CONFIDENTIALITY = 16 +ASC_REQ_USE_SESSION_KEY = 32 +ASC_REQ_ALLOCATE_MEMORY = 256 +ASC_REQ_USE_DCE_STYLE = 512 +ASC_REQ_DATAGRAM = 1024 +ASC_REQ_CONNECTION = 2048 +ASC_REQ_CALL_LEVEL = 4096 +ASC_REQ_EXTENDED_ERROR = 32768 +ASC_REQ_STREAM = 65536 +ASC_REQ_INTEGRITY = 131072 +ASC_REQ_LICENSING = 262144 +ASC_REQ_IDENTIFY = 524288 +ASC_REQ_ALLOW_NULL_SESSION = 1048576 +ASC_REQ_ALLOW_NON_USER_LOGONS = 2097152 +ASC_REQ_ALLOW_CONTEXT_REPLAY = 4194304 +ASC_REQ_FRAGMENT_TO_FIT = 8388608 +ASC_REQ_FRAGMENT_SUPPLIED = 8192 +ASC_REQ_NO_TOKEN = 16777216 +ASC_RET_DELEGATE = 1 +ASC_RET_MUTUAL_AUTH = 2 +ASC_RET_REPLAY_DETECT = 4 +ASC_RET_SEQUENCE_DETECT = 8 +ASC_RET_CONFIDENTIALITY = 16 +ASC_RET_USE_SESSION_KEY = 32 +ASC_RET_ALLOCATED_MEMORY = 256 +ASC_RET_USED_DCE_STYLE = 512 +ASC_RET_DATAGRAM = 1024 +ASC_RET_CONNECTION = 2048 +ASC_RET_CALL_LEVEL = 8192 +ASC_RET_THIRD_LEG_FAILED = 16384 +ASC_RET_EXTENDED_ERROR = 32768 +ASC_RET_STREAM = 65536 +ASC_RET_INTEGRITY = 131072 +ASC_RET_LICENSING = 262144 +ASC_RET_IDENTIFY = 524288 +ASC_RET_NULL_SESSION = 1048576 +ASC_RET_ALLOW_NON_USER_LOGONS = 2097152 +ASC_RET_ALLOW_CONTEXT_REPLAY = 4194304 +ASC_RET_FRAGMENT_ONLY = 8388608 + +SECPKG_CRED_ATTR_NAMES = 1 +SECPKG_ATTR_SIZES = 0 +SECPKG_ATTR_NAMES = 1 +SECPKG_ATTR_LIFESPAN = 2 +SECPKG_ATTR_DCE_INFO = 3 +SECPKG_ATTR_STREAM_SIZES = 4 +SECPKG_ATTR_KEY_INFO = 5 +SECPKG_ATTR_AUTHORITY = 6 +SECPKG_ATTR_PROTO_INFO = 7 +SECPKG_ATTR_PASSWORD_EXPIRY = 8 +SECPKG_ATTR_SESSION_KEY = 9 +SECPKG_ATTR_PACKAGE_INFO = 10 +SECPKG_ATTR_USER_FLAGS = 11 +SECPKG_ATTR_NEGOTIATION_INFO = 12 +SECPKG_ATTR_NATIVE_NAMES = 13 +SECPKG_ATTR_FLAGS = 14 +SECPKG_ATTR_USE_VALIDATED = 15 +SECPKG_ATTR_CREDENTIAL_NAME = 16 +SECPKG_ATTR_TARGET_INFORMATION = 17 +SECPKG_ATTR_ACCESS_TOKEN = 18 +SECPKG_ATTR_TARGET = 19 +SECPKG_ATTR_AUTHENTICATION_ID = 20 + +## attributes from schannel.h +SECPKG_ATTR_REMOTE_CERT_CONTEXT = 83 +SECPKG_ATTR_LOCAL_CERT_CONTEXT = 84 +SECPKG_ATTR_ROOT_STORE = 85 +SECPKG_ATTR_SUPPORTED_ALGS = 86 +SECPKG_ATTR_CIPHER_STRENGTHS = 87 +SECPKG_ATTR_SUPPORTED_PROTOCOLS = 88 +SECPKG_ATTR_ISSUER_LIST_EX = 89 +SECPKG_ATTR_CONNECTION_INFO = 90 +SECPKG_ATTR_EAP_KEY_BLOCK = 91 +SECPKG_ATTR_MAPPED_CRED_ATTR = 92 +SECPKG_ATTR_SESSION_INFO = 93 +SECPKG_ATTR_APP_DATA = 94 + +SECPKG_NEGOTIATION_COMPLETE = 0 +SECPKG_NEGOTIATION_OPTIMISTIC = 1 +SECPKG_NEGOTIATION_IN_PROGRESS = 2 +SECPKG_NEGOTIATION_DIRECT = 3 +SECPKG_NEGOTIATION_TRY_MULTICRED = 4 +SECPKG_CONTEXT_EXPORT_RESET_NEW = 1 +SECPKG_CONTEXT_EXPORT_DELETE_OLD = 2 +SECQOP_WRAP_NO_ENCRYPT = -2147483647 +SECURITY_ENTRYPOINT_ANSIW = "InitSecurityInterfaceW" +SECURITY_ENTRYPOINT_ANSIA = "InitSecurityInterfaceA" +SECURITY_ENTRYPOINT16 = "INITSECURITYINTERFACEA" +SECURITY_ENTRYPOINT = SECURITY_ENTRYPOINT16 +SECURITY_ENTRYPOINT_ANSI = SECURITY_ENTRYPOINT16 +SECURITY_SUPPORT_PROVIDER_INTERFACE_VERSION = 1 +SECURITY_SUPPORT_PROVIDER_INTERFACE_VERSION_2 = 2 +SASL_OPTION_SEND_SIZE = 1 +SASL_OPTION_RECV_SIZE = 2 +SASL_OPTION_AUTHZ_STRING = 3 +SASL_OPTION_AUTHZ_PROCESSING = 4 +SEC_WINNT_AUTH_IDENTITY_ANSI = 1 +SEC_WINNT_AUTH_IDENTITY_UNICODE = 2 +SEC_WINNT_AUTH_IDENTITY_VERSION = 512 +SEC_WINNT_AUTH_IDENTITY_MARSHALLED = 4 +SEC_WINNT_AUTH_IDENTITY_ONLY = 8 +SECPKG_OPTIONS_TYPE_UNKNOWN = 0 +SECPKG_OPTIONS_TYPE_LSA = 1 +SECPKG_OPTIONS_TYPE_SSPI = 2 +SECPKG_OPTIONS_PERMANENT = 1 + +SEC_E_INSUFFICIENT_MEMORY = -2146893056 +SEC_E_INVALID_HANDLE = -2146893055 +SEC_E_UNSUPPORTED_FUNCTION = -2146893054 +SEC_E_TARGET_UNKNOWN = -2146893053 +SEC_E_INTERNAL_ERROR = -2146893052 +SEC_E_SECPKG_NOT_FOUND = -2146893051 +SEC_E_NOT_OWNER = -2146893050 +SEC_E_CANNOT_INSTALL = -2146893049 +SEC_E_INVALID_TOKEN = -2146893048 +SEC_E_CANNOT_PACK = -2146893047 +SEC_E_QOP_NOT_SUPPORTED = -2146893046 +SEC_E_NO_IMPERSONATION = -2146893045 +SEC_E_LOGON_DENIED = -2146893044 +SEC_E_UNKNOWN_CREDENTIALS = -2146893043 +SEC_E_NO_CREDENTIALS = -2146893042 +SEC_E_MESSAGE_ALTERED = -2146893041 +SEC_E_OUT_OF_SEQUENCE = -2146893040 +SEC_E_NO_AUTHENTICATING_AUTHORITY = -2146893039 +SEC_I_CONTINUE_NEEDED = 590610 +SEC_I_COMPLETE_NEEDED = 590611 +SEC_I_COMPLETE_AND_CONTINUE = 590612 +SEC_I_LOCAL_LOGON = 590613 +SEC_E_BAD_PKGID = -2146893034 +SEC_E_CONTEXT_EXPIRED = -2146893033 +SEC_I_CONTEXT_EXPIRED = 590615 +SEC_E_INCOMPLETE_MESSAGE = -2146893032 +SEC_E_INCOMPLETE_CREDENTIALS = -2146893024 +SEC_E_BUFFER_TOO_SMALL = -2146893023 +SEC_I_INCOMPLETE_CREDENTIALS = 590624 +SEC_I_RENEGOTIATE = 590625 +SEC_E_WRONG_PRINCIPAL = -2146893022 +SEC_I_NO_LSA_CONTEXT = 590627 +SEC_E_TIME_SKEW = -2146893020 +SEC_E_UNTRUSTED_ROOT = -2146893019 +SEC_E_ILLEGAL_MESSAGE = -2146893018 +SEC_E_CERT_UNKNOWN = -2146893017 +SEC_E_CERT_EXPIRED = -2146893016 +SEC_E_ENCRYPT_FAILURE = -2146893015 +SEC_E_DECRYPT_FAILURE = -2146893008 +SEC_E_ALGORITHM_MISMATCH = -2146893007 +SEC_E_SECURITY_QOS_FAILED = -2146893006 +SEC_E_UNFINISHED_CONTEXT_DELETED = -2146893005 +SEC_E_NO_TGT_REPLY = -2146893004 +SEC_E_NO_IP_ADDRESSES = -2146893003 +SEC_E_WRONG_CREDENTIAL_HANDLE = -2146893002 +SEC_E_CRYPTO_SYSTEM_INVALID = -2146893001 +SEC_E_MAX_REFERRALS_EXCEEDED = -2146893000 +SEC_E_MUST_BE_KDC = -2146892999 +SEC_E_STRONG_CRYPTO_NOT_SUPPORTED = -2146892998 +SEC_E_TOO_MANY_PRINCIPALS = -2146892997 +SEC_E_NO_PA_DATA = -2146892996 +SEC_E_PKINIT_NAME_MISMATCH = -2146892995 +SEC_E_SMARTCARD_LOGON_REQUIRED = -2146892994 +SEC_E_SHUTDOWN_IN_PROGRESS = -2146892993 +SEC_E_KDC_INVALID_REQUEST = -2146892992 +SEC_E_KDC_UNABLE_TO_REFER = -2146892991 +SEC_E_KDC_UNKNOWN_ETYPE = -2146892990 +SEC_E_UNSUPPORTED_PREAUTH = -2146892989 +SEC_E_DELEGATION_REQUIRED = -2146892987 +SEC_E_BAD_BINDINGS = -2146892986 +SEC_E_MULTIPLE_ACCOUNTS = -2146892985 +SEC_E_NO_KERB_KEY = -2146892984 + +ERROR_IPSEC_QM_POLICY_EXISTS = 13000 +ERROR_IPSEC_QM_POLICY_NOT_FOUND = 13001 +ERROR_IPSEC_QM_POLICY_IN_USE = 13002 +ERROR_IPSEC_MM_POLICY_EXISTS = 13003 +ERROR_IPSEC_MM_POLICY_NOT_FOUND = 13004 +ERROR_IPSEC_MM_POLICY_IN_USE = 13005 +ERROR_IPSEC_MM_FILTER_EXISTS = 13006 +ERROR_IPSEC_MM_FILTER_NOT_FOUND = 13007 +ERROR_IPSEC_TRANSPORT_FILTER_EXISTS = 13008 +ERROR_IPSEC_TRANSPORT_FILTER_NOT_FOUND = 13009 +ERROR_IPSEC_MM_AUTH_EXISTS = 13010 +ERROR_IPSEC_MM_AUTH_NOT_FOUND = 13011 +ERROR_IPSEC_MM_AUTH_IN_USE = 13012 +ERROR_IPSEC_DEFAULT_MM_POLICY_NOT_FOUND = 13013 +ERROR_IPSEC_DEFAULT_MM_AUTH_NOT_FOUND = 13014 +ERROR_IPSEC_DEFAULT_QM_POLICY_NOT_FOUND = 13015 +ERROR_IPSEC_TUNNEL_FILTER_EXISTS = 13016 +ERROR_IPSEC_TUNNEL_FILTER_NOT_FOUND = 13017 +ERROR_IPSEC_MM_FILTER_PENDING_DELETION = 13018 +ERROR_IPSEC_TRANSPORT_FILTER_PENDING_DELETION = 13019 +ERROR_IPSEC_TUNNEL_FILTER_PENDING_DELETION = 13020 +ERROR_IPSEC_MM_POLICY_PENDING_DELETION = 13021 +ERROR_IPSEC_MM_AUTH_PENDING_DELETION = 13022 +ERROR_IPSEC_QM_POLICY_PENDING_DELETION = 13023 +WARNING_IPSEC_MM_POLICY_PRUNED = 13024 +WARNING_IPSEC_QM_POLICY_PRUNED = 13025 +ERROR_IPSEC_IKE_NEG_STATUS_BEGIN = 13800 +ERROR_IPSEC_IKE_AUTH_FAIL = 13801 +ERROR_IPSEC_IKE_ATTRIB_FAIL = 13802 +ERROR_IPSEC_IKE_NEGOTIATION_PENDING = 13803 +ERROR_IPSEC_IKE_GENERAL_PROCESSING_ERROR = 13804 +ERROR_IPSEC_IKE_TIMED_OUT = 13805 +ERROR_IPSEC_IKE_NO_CERT = 13806 +ERROR_IPSEC_IKE_SA_DELETED = 13807 +ERROR_IPSEC_IKE_SA_REAPED = 13808 +ERROR_IPSEC_IKE_MM_ACQUIRE_DROP = 13809 +ERROR_IPSEC_IKE_QM_ACQUIRE_DROP = 13810 +ERROR_IPSEC_IKE_QUEUE_DROP_MM = 13811 +ERROR_IPSEC_IKE_QUEUE_DROP_NO_MM = 13812 +ERROR_IPSEC_IKE_DROP_NO_RESPONSE = 13813 +ERROR_IPSEC_IKE_MM_DELAY_DROP = 13814 +ERROR_IPSEC_IKE_QM_DELAY_DROP = 13815 +ERROR_IPSEC_IKE_ERROR = 13816 +ERROR_IPSEC_IKE_CRL_FAILED = 13817 +ERROR_IPSEC_IKE_INVALID_KEY_USAGE = 13818 +ERROR_IPSEC_IKE_INVALID_CERT_TYPE = 13819 +ERROR_IPSEC_IKE_NO_PRIVATE_KEY = 13820 +ERROR_IPSEC_IKE_DH_FAIL = 13822 +ERROR_IPSEC_IKE_INVALID_HEADER = 13824 +ERROR_IPSEC_IKE_NO_POLICY = 13825 +ERROR_IPSEC_IKE_INVALID_SIGNATURE = 13826 +ERROR_IPSEC_IKE_KERBEROS_ERROR = 13827 +ERROR_IPSEC_IKE_NO_PUBLIC_KEY = 13828 +ERROR_IPSEC_IKE_PROCESS_ERR = 13829 +ERROR_IPSEC_IKE_PROCESS_ERR_SA = 13830 +ERROR_IPSEC_IKE_PROCESS_ERR_PROP = 13831 +ERROR_IPSEC_IKE_PROCESS_ERR_TRANS = 13832 +ERROR_IPSEC_IKE_PROCESS_ERR_KE = 13833 +ERROR_IPSEC_IKE_PROCESS_ERR_ID = 13834 +ERROR_IPSEC_IKE_PROCESS_ERR_CERT = 13835 +ERROR_IPSEC_IKE_PROCESS_ERR_CERT_REQ = 13836 +ERROR_IPSEC_IKE_PROCESS_ERR_HASH = 13837 +ERROR_IPSEC_IKE_PROCESS_ERR_SIG = 13838 +ERROR_IPSEC_IKE_PROCESS_ERR_NONCE = 13839 +ERROR_IPSEC_IKE_PROCESS_ERR_NOTIFY = 13840 +ERROR_IPSEC_IKE_PROCESS_ERR_DELETE = 13841 +ERROR_IPSEC_IKE_PROCESS_ERR_VENDOR = 13842 +ERROR_IPSEC_IKE_INVALID_PAYLOAD = 13843 +ERROR_IPSEC_IKE_LOAD_SOFT_SA = 13844 +ERROR_IPSEC_IKE_SOFT_SA_TORN_DOWN = 13845 +ERROR_IPSEC_IKE_INVALID_COOKIE = 13846 +ERROR_IPSEC_IKE_NO_PEER_CERT = 13847 +ERROR_IPSEC_IKE_PEER_CRL_FAILED = 13848 +ERROR_IPSEC_IKE_POLICY_CHANGE = 13849 +ERROR_IPSEC_IKE_NO_MM_POLICY = 13850 +ERROR_IPSEC_IKE_NOTCBPRIV = 13851 +ERROR_IPSEC_IKE_SECLOADFAIL = 13852 +ERROR_IPSEC_IKE_FAILSSPINIT = 13853 +ERROR_IPSEC_IKE_FAILQUERYSSP = 13854 +ERROR_IPSEC_IKE_SRVACQFAIL = 13855 +ERROR_IPSEC_IKE_SRVQUERYCRED = 13856 +ERROR_IPSEC_IKE_GETSPIFAIL = 13857 +ERROR_IPSEC_IKE_INVALID_FILTER = 13858 +ERROR_IPSEC_IKE_OUT_OF_MEMORY = 13859 +ERROR_IPSEC_IKE_ADD_UPDATE_KEY_FAILED = 13860 +ERROR_IPSEC_IKE_INVALID_POLICY = 13861 +ERROR_IPSEC_IKE_UNKNOWN_DOI = 13862 +ERROR_IPSEC_IKE_INVALID_SITUATION = 13863 +ERROR_IPSEC_IKE_DH_FAILURE = 13864 +ERROR_IPSEC_IKE_INVALID_GROUP = 13865 +ERROR_IPSEC_IKE_ENCRYPT = 13866 +ERROR_IPSEC_IKE_DECRYPT = 13867 +ERROR_IPSEC_IKE_POLICY_MATCH = 13868 +ERROR_IPSEC_IKE_UNSUPPORTED_ID = 13869 +ERROR_IPSEC_IKE_INVALID_HASH = 13870 +ERROR_IPSEC_IKE_INVALID_HASH_ALG = 13871 +ERROR_IPSEC_IKE_INVALID_HASH_SIZE = 13872 +ERROR_IPSEC_IKE_INVALID_ENCRYPT_ALG = 13873 +ERROR_IPSEC_IKE_INVALID_AUTH_ALG = 13874 +ERROR_IPSEC_IKE_INVALID_SIG = 13875 +ERROR_IPSEC_IKE_LOAD_FAILED = 13876 +ERROR_IPSEC_IKE_RPC_DELETE = 13877 +ERROR_IPSEC_IKE_BENIGN_REINIT = 13878 +ERROR_IPSEC_IKE_INVALID_RESPONDER_LIFETIME_NOTIFY = 13879 +ERROR_IPSEC_IKE_INVALID_CERT_KEYLEN = 13881 +ERROR_IPSEC_IKE_MM_LIMIT = 13882 +ERROR_IPSEC_IKE_NEGOTIATION_DISABLED = 13883 +ERROR_IPSEC_IKE_NEG_STATUS_END = 13884 +CRYPT_E_MSG_ERROR = -2146889727 +CRYPT_E_UNKNOWN_ALGO = -2146889726 +CRYPT_E_OID_FORMAT = -2146889725 +CRYPT_E_INVALID_MSG_TYPE = -2146889724 +CRYPT_E_UNEXPECTED_ENCODING = -2146889723 +CRYPT_E_AUTH_ATTR_MISSING = -2146889722 +CRYPT_E_HASH_VALUE = -2146889721 +CRYPT_E_INVALID_INDEX = -2146889720 +CRYPT_E_ALREADY_DECRYPTED = -2146889719 +CRYPT_E_NOT_DECRYPTED = -2146889718 +CRYPT_E_RECIPIENT_NOT_FOUND = -2146889717 +CRYPT_E_CONTROL_TYPE = -2146889716 +CRYPT_E_ISSUER_SERIALNUMBER = -2146889715 +CRYPT_E_SIGNER_NOT_FOUND = -2146889714 +CRYPT_E_ATTRIBUTES_MISSING = -2146889713 +CRYPT_E_STREAM_MSG_NOT_READY = -2146889712 +CRYPT_E_STREAM_INSUFFICIENT_DATA = -2146889711 +CRYPT_I_NEW_PROTECTION_REQUIRED = 593938 +CRYPT_E_BAD_LEN = -2146885631 +CRYPT_E_BAD_ENCODE = -2146885630 +CRYPT_E_FILE_ERROR = -2146885629 +CRYPT_E_NOT_FOUND = -2146885628 +CRYPT_E_EXISTS = -2146885627 +CRYPT_E_NO_PROVIDER = -2146885626 +CRYPT_E_SELF_SIGNED = -2146885625 +CRYPT_E_DELETED_PREV = -2146885624 +CRYPT_E_NO_MATCH = -2146885623 +CRYPT_E_UNEXPECTED_MSG_TYPE = -2146885622 +CRYPT_E_NO_KEY_PROPERTY = -2146885621 +CRYPT_E_NO_DECRYPT_CERT = -2146885620 +CRYPT_E_BAD_MSG = -2146885619 +CRYPT_E_NO_SIGNER = -2146885618 +CRYPT_E_PENDING_CLOSE = -2146885617 +CRYPT_E_REVOKED = -2146885616 +CRYPT_E_NO_REVOCATION_DLL = -2146885615 +CRYPT_E_NO_REVOCATION_CHECK = -2146885614 +CRYPT_E_REVOCATION_OFFLINE = -2146885613 +CRYPT_E_NOT_IN_REVOCATION_DATABASE = -2146885612 +CRYPT_E_INVALID_NUMERIC_STRING = -2146885600 +CRYPT_E_INVALID_PRINTABLE_STRING = -2146885599 +CRYPT_E_INVALID_IA5_STRING = -2146885598 +CRYPT_E_INVALID_X500_STRING = -2146885597 +CRYPT_E_NOT_CHAR_STRING = -2146885596 +CRYPT_E_FILERESIZED = -2146885595 +CRYPT_E_SECURITY_SETTINGS = -2146885594 +CRYPT_E_NO_VERIFY_USAGE_DLL = -2146885593 +CRYPT_E_NO_VERIFY_USAGE_CHECK = -2146885592 +CRYPT_E_VERIFY_USAGE_OFFLINE = -2146885591 +CRYPT_E_NOT_IN_CTL = -2146885590 +CRYPT_E_NO_TRUSTED_SIGNER = -2146885589 +CRYPT_E_MISSING_PUBKEY_PARA = -2146885588 +CRYPT_E_OSS_ERROR = -2146881536 + +## Kerberos message types for LsaCallAuthenticationPackage (from ntsecapi.h) +KerbDebugRequestMessage = 0 +KerbQueryTicketCacheMessage = 1 +KerbChangeMachinePasswordMessage = 2 +KerbVerifyPacMessage = 3 +KerbRetrieveTicketMessage = 4 +KerbUpdateAddressesMessage = 5 +KerbPurgeTicketCacheMessage = 6 +KerbChangePasswordMessage = 7 +KerbRetrieveEncodedTicketMessage = 8 +KerbDecryptDataMessage = 9 +KerbAddBindingCacheEntryMessage = 10 +KerbSetPasswordMessage = 11 +KerbSetPasswordExMessage = 12 +KerbVerifyCredentialsMessage = 13 +KerbQueryTicketCacheExMessage = 14 +KerbPurgeTicketCacheExMessage = 15 +KerbRefreshSmartcardCredentialsMessage = 16 +KerbAddExtraCredentialsMessage = 17 +KerbQuerySupplementalCredentialsMessage = 18 + +## messages used with msv1_0 from ntsecapi.h +MsV1_0Lm20ChallengeRequest = 0 +MsV1_0Lm20GetChallengeResponse = 1 +MsV1_0EnumerateUsers = 2 +MsV1_0GetUserInfo = 3 +MsV1_0ReLogonUsers = 4 +MsV1_0ChangePassword = 5 +MsV1_0ChangeCachedPassword = 6 +MsV1_0GenericPassthrough = 7 +MsV1_0CacheLogon = 8 +MsV1_0SubAuth = 9 +MsV1_0DeriveCredential = 10 +MsV1_0CacheLookup = 11 +MsV1_0SetProcessOption = 12 + +SEC_E_OK = 0 diff --git a/lib/win32/lib/win2kras.py b/lib/win32/lib/win2kras.py new file mode 100644 index 00000000..f1c18b3a --- /dev/null +++ b/lib/win32/lib/win2kras.py @@ -0,0 +1,7 @@ +# win2kras used to be an extension module with wrapped the "new" RAS functions +# in Windows 2000, so win32ras could still be used on NT/etc. +# I think in 2021 we can be confident pywin32 is not used on earlier OSs, so +# that functionality is now in win32ras. +# +# This exists just to avoid breaking old scripts. +from win32ras import * diff --git a/lib/win32/lib/win32con.py b/lib/win32/lib/win32con.py new file mode 100644 index 00000000..9916ba4a --- /dev/null +++ b/lib/win32/lib/win32con.py @@ -0,0 +1,5083 @@ +# Generated by h2py from commdlg.h (plus modifications 4jan98) +WINVER = 1280 +WM_USER = 1024 +PY_0U = 0 +OFN_READONLY = 1 +OFN_OVERWRITEPROMPT = 2 +OFN_HIDEREADONLY = 4 +OFN_NOCHANGEDIR = 8 +OFN_SHOWHELP = 16 +OFN_ENABLEHOOK = 32 +OFN_ENABLETEMPLATE = 64 +OFN_ENABLETEMPLATEHANDLE = 128 +OFN_NOVALIDATE = 256 +OFN_ALLOWMULTISELECT = 512 +OFN_EXTENSIONDIFFERENT = 1024 +OFN_PATHMUSTEXIST = 2048 +OFN_FILEMUSTEXIST = 4096 +OFN_CREATEPROMPT = 8192 +OFN_SHAREAWARE = 16384 +OFN_NOREADONLYRETURN = 32768 +OFN_NOTESTFILECREATE = 65536 +OFN_NONETWORKBUTTON = 131072 +OFN_NOLONGNAMES = 262144 +OFN_EXPLORER = 524288 # new look commdlg +OFN_NODEREFERENCELINKS = 1048576 +OFN_LONGNAMES = 2097152 # force long names for 3.x modules +OFN_ENABLEINCLUDENOTIFY = 4194304 # send include message to callback +OFN_ENABLESIZING = 8388608 +OFN_DONTADDTORECENT = 33554432 +OFN_FORCESHOWHIDDEN = 268435456 # Show All files including System and hidden files +OFN_EX_NOPLACESBAR = 1 +OFN_SHAREFALLTHROUGH = 2 +OFN_SHARENOWARN = 1 +OFN_SHAREWARN = 0 +CDN_FIRST = PY_0U - 601 +CDN_LAST = PY_0U - 699 +CDN_INITDONE = CDN_FIRST - 0 +CDN_SELCHANGE = CDN_FIRST - 1 +CDN_FOLDERCHANGE = CDN_FIRST - 2 +CDN_SHAREVIOLATION = CDN_FIRST - 3 +CDN_HELP = CDN_FIRST - 4 +CDN_FILEOK = CDN_FIRST - 5 +CDN_TYPECHANGE = CDN_FIRST - 6 +CDN_INCLUDEITEM = CDN_FIRST - 7 +CDM_FIRST = WM_USER + 100 +CDM_LAST = WM_USER + 200 +CDM_GETSPEC = CDM_FIRST + 0 +CDM_GETFILEPATH = CDM_FIRST + 1 +CDM_GETFOLDERPATH = CDM_FIRST + 2 +CDM_GETFOLDERIDLIST = CDM_FIRST + 3 +CDM_SETCONTROLTEXT = CDM_FIRST + 4 +CDM_HIDECONTROL = CDM_FIRST + 5 +CDM_SETDEFEXT = CDM_FIRST + 6 +CC_RGBINIT = 1 +CC_FULLOPEN = 2 +CC_PREVENTFULLOPEN = 4 +CC_SHOWHELP = 8 +CC_ENABLEHOOK = 16 +CC_ENABLETEMPLATE = 32 +CC_ENABLETEMPLATEHANDLE = 64 +CC_SOLIDCOLOR = 128 +CC_ANYCOLOR = 256 +FR_DOWN = 1 +FR_WHOLEWORD = 2 +FR_MATCHCASE = 4 +FR_FINDNEXT = 8 +FR_REPLACE = 16 +FR_REPLACEALL = 32 +FR_DIALOGTERM = 64 +FR_SHOWHELP = 128 +FR_ENABLEHOOK = 256 +FR_ENABLETEMPLATE = 512 +FR_NOUPDOWN = 1024 +FR_NOMATCHCASE = 2048 +FR_NOWHOLEWORD = 4096 +FR_ENABLETEMPLATEHANDLE = 8192 +FR_HIDEUPDOWN = 16384 +FR_HIDEMATCHCASE = 32768 +FR_HIDEWHOLEWORD = 65536 +CF_SCREENFONTS = 1 +CF_PRINTERFONTS = 2 +CF_BOTH = CF_SCREENFONTS | CF_PRINTERFONTS +CF_SHOWHELP = 4 +CF_ENABLEHOOK = 8 +CF_ENABLETEMPLATE = 16 +CF_ENABLETEMPLATEHANDLE = 32 +CF_INITTOLOGFONTSTRUCT = 64 +CF_USESTYLE = 128 +CF_EFFECTS = 256 +CF_APPLY = 512 +CF_ANSIONLY = 1024 +CF_SCRIPTSONLY = CF_ANSIONLY +CF_NOVECTORFONTS = 2048 +CF_NOOEMFONTS = CF_NOVECTORFONTS +CF_NOSIMULATIONS = 4096 +CF_LIMITSIZE = 8192 +CF_FIXEDPITCHONLY = 16384 +CF_WYSIWYG = 32768 # must also have CF_SCREENFONTS & CF_PRINTERFONTS +CF_FORCEFONTEXIST = 65536 +CF_SCALABLEONLY = 131072 +CF_TTONLY = 262144 +CF_NOFACESEL = 524288 +CF_NOSTYLESEL = 1048576 +CF_NOSIZESEL = 2097152 +CF_SELECTSCRIPT = 4194304 +CF_NOSCRIPTSEL = 8388608 +CF_NOVERTFONTS = 16777216 +SIMULATED_FONTTYPE = 32768 +PRINTER_FONTTYPE = 16384 +SCREEN_FONTTYPE = 8192 +BOLD_FONTTYPE = 256 +ITALIC_FONTTYPE = 512 +REGULAR_FONTTYPE = 1024 +OPENTYPE_FONTTYPE = 65536 +TYPE1_FONTTYPE = 131072 +DSIG_FONTTYPE = 262144 +WM_CHOOSEFONT_GETLOGFONT = WM_USER + 1 +WM_CHOOSEFONT_SETLOGFONT = WM_USER + 101 +WM_CHOOSEFONT_SETFLAGS = WM_USER + 102 +LBSELCHSTRINGA = "commdlg_LBSelChangedNotify" +SHAREVISTRINGA = "commdlg_ShareViolation" +FILEOKSTRINGA = "commdlg_FileNameOK" +COLOROKSTRINGA = "commdlg_ColorOK" +SETRGBSTRINGA = "commdlg_SetRGBColor" +HELPMSGSTRINGA = "commdlg_help" +FINDMSGSTRINGA = "commdlg_FindReplace" +LBSELCHSTRING = LBSELCHSTRINGA +SHAREVISTRING = SHAREVISTRINGA +FILEOKSTRING = FILEOKSTRINGA +COLOROKSTRING = COLOROKSTRINGA +SETRGBSTRING = SETRGBSTRINGA +HELPMSGSTRING = HELPMSGSTRINGA +FINDMSGSTRING = FINDMSGSTRINGA +CD_LBSELNOITEMS = -1 +CD_LBSELCHANGE = 0 +CD_LBSELSUB = 1 +CD_LBSELADD = 2 +PD_ALLPAGES = 0 +PD_SELECTION = 1 +PD_PAGENUMS = 2 +PD_NOSELECTION = 4 +PD_NOPAGENUMS = 8 +PD_COLLATE = 16 +PD_PRINTTOFILE = 32 +PD_PRINTSETUP = 64 +PD_NOWARNING = 128 +PD_RETURNDC = 256 +PD_RETURNIC = 512 +PD_RETURNDEFAULT = 1024 +PD_SHOWHELP = 2048 +PD_ENABLEPRINTHOOK = 4096 +PD_ENABLESETUPHOOK = 8192 +PD_ENABLEPRINTTEMPLATE = 16384 +PD_ENABLESETUPTEMPLATE = 32768 +PD_ENABLEPRINTTEMPLATEHANDLE = 65536 +PD_ENABLESETUPTEMPLATEHANDLE = 131072 +PD_USEDEVMODECOPIES = 262144 +PD_DISABLEPRINTTOFILE = 524288 +PD_HIDEPRINTTOFILE = 1048576 +PD_NONETWORKBUTTON = 2097152 +DN_DEFAULTPRN = 1 +WM_PSD_PAGESETUPDLG = WM_USER +WM_PSD_FULLPAGERECT = WM_USER + 1 +WM_PSD_MINMARGINRECT = WM_USER + 2 +WM_PSD_MARGINRECT = WM_USER + 3 +WM_PSD_GREEKTEXTRECT = WM_USER + 4 +WM_PSD_ENVSTAMPRECT = WM_USER + 5 +WM_PSD_YAFULLPAGERECT = WM_USER + 6 +PSD_DEFAULTMINMARGINS = 0 # default (printer's) +PSD_INWININIINTLMEASURE = 0 # 1st of 4 possible +PSD_MINMARGINS = 1 # use caller's +PSD_MARGINS = 2 # use caller's +PSD_INTHOUSANDTHSOFINCHES = 4 # 2nd of 4 possible +PSD_INHUNDREDTHSOFMILLIMETERS = 8 # 3rd of 4 possible +PSD_DISABLEMARGINS = 16 +PSD_DISABLEPRINTER = 32 +PSD_NOWARNING = 128 # must be same as PD_* +PSD_DISABLEORIENTATION = 256 +PSD_RETURNDEFAULT = 1024 # must be same as PD_* +PSD_DISABLEPAPER = 512 +PSD_SHOWHELP = 2048 # must be same as PD_* +PSD_ENABLEPAGESETUPHOOK = 8192 # must be same as PD_* +PSD_ENABLEPAGESETUPTEMPLATE = 32768 # must be same as PD_* +PSD_ENABLEPAGESETUPTEMPLATEHANDLE = 131072 # must be same as PD_* +PSD_ENABLEPAGEPAINTHOOK = 262144 +PSD_DISABLEPAGEPAINTING = 524288 +PSD_NONETWORKBUTTON = 2097152 # must be same as PD_* + +# Generated by h2py from winreg.h +HKEY_CLASSES_ROOT = -2147483648 +HKEY_CURRENT_USER = -2147483647 +HKEY_LOCAL_MACHINE = -2147483646 +HKEY_USERS = -2147483645 +HKEY_PERFORMANCE_DATA = -2147483644 +HKEY_CURRENT_CONFIG = -2147483643 +HKEY_DYN_DATA = -2147483642 +HKEY_PERFORMANCE_TEXT = -2147483568 # ?? 4Jan98 +HKEY_PERFORMANCE_NLSTEXT = -2147483552 # ?? 4Jan98 + +# Generated by h2py from winuser.h +HWND_BROADCAST = 65535 +HWND_DESKTOP = 0 +HWND_TOP = 0 +HWND_BOTTOM = 1 +HWND_TOPMOST = -1 +HWND_NOTOPMOST = -2 +HWND_MESSAGE = -3 + +# winuser.h line 4601 +SM_CXSCREEN = 0 +SM_CYSCREEN = 1 +SM_CXVSCROLL = 2 +SM_CYHSCROLL = 3 +SM_CYCAPTION = 4 +SM_CXBORDER = 5 +SM_CYBORDER = 6 +SM_CXDLGFRAME = 7 +SM_CYDLGFRAME = 8 +SM_CYVTHUMB = 9 +SM_CXHTHUMB = 10 +SM_CXICON = 11 +SM_CYICON = 12 +SM_CXCURSOR = 13 +SM_CYCURSOR = 14 +SM_CYMENU = 15 +SM_CXFULLSCREEN = 16 +SM_CYFULLSCREEN = 17 +SM_CYKANJIWINDOW = 18 +SM_MOUSEPRESENT = 19 +SM_CYVSCROLL = 20 +SM_CXHSCROLL = 21 +SM_DEBUG = 22 +SM_SWAPBUTTON = 23 +SM_RESERVED1 = 24 +SM_RESERVED2 = 25 +SM_RESERVED3 = 26 +SM_RESERVED4 = 27 +SM_CXMIN = 28 +SM_CYMIN = 29 +SM_CXSIZE = 30 +SM_CYSIZE = 31 +SM_CXFRAME = 32 +SM_CYFRAME = 33 +SM_CXMINTRACK = 34 +SM_CYMINTRACK = 35 +SM_CXDOUBLECLK = 36 +SM_CYDOUBLECLK = 37 +SM_CXICONSPACING = 38 +SM_CYICONSPACING = 39 +SM_MENUDROPALIGNMENT = 40 +SM_PENWINDOWS = 41 +SM_DBCSENABLED = 42 +SM_CMOUSEBUTTONS = 43 +SM_CXFIXEDFRAME = SM_CXDLGFRAME +SM_CYFIXEDFRAME = SM_CYDLGFRAME +SM_CXSIZEFRAME = SM_CXFRAME +SM_CYSIZEFRAME = SM_CYFRAME +SM_SECURE = 44 +SM_CXEDGE = 45 +SM_CYEDGE = 46 +SM_CXMINSPACING = 47 +SM_CYMINSPACING = 48 +SM_CXSMICON = 49 +SM_CYSMICON = 50 +SM_CYSMCAPTION = 51 +SM_CXSMSIZE = 52 +SM_CYSMSIZE = 53 +SM_CXMENUSIZE = 54 +SM_CYMENUSIZE = 55 +SM_ARRANGE = 56 +SM_CXMINIMIZED = 57 +SM_CYMINIMIZED = 58 +SM_CXMAXTRACK = 59 +SM_CYMAXTRACK = 60 +SM_CXMAXIMIZED = 61 +SM_CYMAXIMIZED = 62 +SM_NETWORK = 63 +SM_CLEANBOOT = 67 +SM_CXDRAG = 68 +SM_CYDRAG = 69 +SM_SHOWSOUNDS = 70 +SM_CXMENUCHECK = 71 +SM_CYMENUCHECK = 72 +SM_SLOWMACHINE = 73 +SM_MIDEASTENABLED = 74 +SM_MOUSEWHEELPRESENT = 75 +SM_XVIRTUALSCREEN = 76 +SM_YVIRTUALSCREEN = 77 +SM_CXVIRTUALSCREEN = 78 +SM_CYVIRTUALSCREEN = 79 +SM_CMONITORS = 80 +SM_SAMEDISPLAYFORMAT = 81 +SM_CMETRICS = 83 +MNC_IGNORE = 0 +MNC_CLOSE = 1 +MNC_EXECUTE = 2 +MNC_SELECT = 3 +MNS_NOCHECK = -2147483648 +MNS_MODELESS = 1073741824 +MNS_DRAGDROP = 536870912 +MNS_AUTODISMISS = 268435456 +MNS_NOTIFYBYPOS = 134217728 +MNS_CHECKORBMP = 67108864 +MIM_MAXHEIGHT = 1 +MIM_BACKGROUND = 2 +MIM_HELPID = 4 +MIM_MENUDATA = 8 +MIM_STYLE = 16 +MIM_APPLYTOSUBMENUS = -2147483648 +MND_CONTINUE = 0 +MND_ENDMENU = 1 +MNGOF_GAP = 3 +MNGO_NOINTERFACE = 0 +MNGO_NOERROR = 1 +MIIM_STATE = 1 +MIIM_ID = 2 +MIIM_SUBMENU = 4 +MIIM_CHECKMARKS = 8 +MIIM_TYPE = 16 +MIIM_DATA = 32 +MIIM_STRING = 64 +MIIM_BITMAP = 128 +MIIM_FTYPE = 256 +HBMMENU_CALLBACK = -1 +HBMMENU_SYSTEM = 1 +HBMMENU_MBAR_RESTORE = 2 +HBMMENU_MBAR_MINIMIZE = 3 +HBMMENU_MBAR_CLOSE = 5 +HBMMENU_MBAR_CLOSE_D = 6 +HBMMENU_MBAR_MINIMIZE_D = 7 +HBMMENU_POPUP_CLOSE = 8 +HBMMENU_POPUP_RESTORE = 9 +HBMMENU_POPUP_MAXIMIZE = 10 +HBMMENU_POPUP_MINIMIZE = 11 +GMDI_USEDISABLED = 1 +GMDI_GOINTOPOPUPS = 2 +TPM_LEFTBUTTON = 0 +TPM_RIGHTBUTTON = 2 +TPM_LEFTALIGN = 0 +TPM_CENTERALIGN = 4 +TPM_RIGHTALIGN = 8 +TPM_TOPALIGN = 0 +TPM_VCENTERALIGN = 16 +TPM_BOTTOMALIGN = 32 +TPM_HORIZONTAL = 0 +TPM_VERTICAL = 64 +TPM_NONOTIFY = 128 +TPM_RETURNCMD = 256 +TPM_RECURSE = 1 +DOF_EXECUTABLE = 32769 +DOF_DOCUMENT = 32770 +DOF_DIRECTORY = 32771 +DOF_MULTIPLE = 32772 +DOF_PROGMAN = 1 +DOF_SHELLDATA = 2 +DO_DROPFILE = 1162627398 +DO_PRINTFILE = 1414419024 +DT_TOP = 0 +DT_LEFT = 0 +DT_CENTER = 1 +DT_RIGHT = 2 +DT_VCENTER = 4 +DT_BOTTOM = 8 +DT_WORDBREAK = 16 +DT_SINGLELINE = 32 +DT_EXPANDTABS = 64 +DT_TABSTOP = 128 +DT_NOCLIP = 256 +DT_EXTERNALLEADING = 512 +DT_CALCRECT = 1024 +DT_NOPREFIX = 2048 +DT_INTERNAL = 4096 +DT_EDITCONTROL = 8192 +DT_PATH_ELLIPSIS = 16384 +DT_END_ELLIPSIS = 32768 +DT_MODIFYSTRING = 65536 +DT_RTLREADING = 131072 +DT_WORD_ELLIPSIS = 262144 +DST_COMPLEX = 0 +DST_TEXT = 1 +DST_PREFIXTEXT = 2 +DST_ICON = 3 +DST_BITMAP = 4 +DSS_NORMAL = 0 +DSS_UNION = 16 +DSS_DISABLED = 32 +DSS_MONO = 128 +DSS_RIGHT = 32768 +DCX_WINDOW = 1 +DCX_CACHE = 2 +DCX_NORESETATTRS = 4 +DCX_CLIPCHILDREN = 8 +DCX_CLIPSIBLINGS = 16 +DCX_PARENTCLIP = 32 +DCX_EXCLUDERGN = 64 +DCX_INTERSECTRGN = 128 +DCX_EXCLUDEUPDATE = 256 +DCX_INTERSECTUPDATE = 512 +DCX_LOCKWINDOWUPDATE = 1024 +DCX_VALIDATE = 2097152 +CUDR_NORMAL = 0 +CUDR_NOSNAPTOGRID = 1 +CUDR_NORESOLVEPOSITIONS = 2 +CUDR_NOCLOSEGAPS = 4 +CUDR_NEGATIVECOORDS = 8 +CUDR_NOPRIMARY = 16 +RDW_INVALIDATE = 1 +RDW_INTERNALPAINT = 2 +RDW_ERASE = 4 +RDW_VALIDATE = 8 +RDW_NOINTERNALPAINT = 16 +RDW_NOERASE = 32 +RDW_NOCHILDREN = 64 +RDW_ALLCHILDREN = 128 +RDW_UPDATENOW = 256 +RDW_ERASENOW = 512 +RDW_FRAME = 1024 +RDW_NOFRAME = 2048 +SW_SCROLLCHILDREN = 1 +SW_INVALIDATE = 2 +SW_ERASE = 4 +SW_SMOOTHSCROLL = 16 # Use smooth scrolling +ESB_ENABLE_BOTH = 0 +ESB_DISABLE_BOTH = 3 +ESB_DISABLE_LEFT = 1 +ESB_DISABLE_RIGHT = 2 +ESB_DISABLE_UP = 1 +ESB_DISABLE_DOWN = 2 +ESB_DISABLE_LTUP = ESB_DISABLE_LEFT +ESB_DISABLE_RTDN = ESB_DISABLE_RIGHT +HELPINFO_WINDOW = 1 +HELPINFO_MENUITEM = 2 +MB_OK = 0 +MB_OKCANCEL = 1 +MB_ABORTRETRYIGNORE = 2 +MB_YESNOCANCEL = 3 +MB_YESNO = 4 +MB_RETRYCANCEL = 5 +MB_ICONHAND = 16 +MB_ICONQUESTION = 32 +MB_ICONEXCLAMATION = 48 +MB_ICONASTERISK = 64 +MB_ICONWARNING = MB_ICONEXCLAMATION +MB_ICONERROR = MB_ICONHAND +MB_ICONINFORMATION = MB_ICONASTERISK +MB_ICONSTOP = MB_ICONHAND +MB_DEFBUTTON1 = 0 +MB_DEFBUTTON2 = 256 +MB_DEFBUTTON3 = 512 +MB_DEFBUTTON4 = 768 +MB_APPLMODAL = 0 +MB_SYSTEMMODAL = 4096 +MB_TASKMODAL = 8192 +MB_HELP = 16384 +MB_NOFOCUS = 32768 +MB_SETFOREGROUND = 65536 +MB_DEFAULT_DESKTOP_ONLY = 131072 +MB_TOPMOST = 262144 +MB_RIGHT = 524288 +MB_RTLREADING = 1048576 +MB_SERVICE_NOTIFICATION = 2097152 +MB_TYPEMASK = 15 +MB_USERICON = 128 +MB_ICONMASK = 240 +MB_DEFMASK = 3840 +MB_MODEMASK = 12288 +MB_MISCMASK = 49152 +# winuser.h line 6373 +CWP_ALL = 0 +CWP_SKIPINVISIBLE = 1 +CWP_SKIPDISABLED = 2 +CWP_SKIPTRANSPARENT = 4 +CTLCOLOR_MSGBOX = 0 +CTLCOLOR_EDIT = 1 +CTLCOLOR_LISTBOX = 2 +CTLCOLOR_BTN = 3 +CTLCOLOR_DLG = 4 +CTLCOLOR_SCROLLBAR = 5 +CTLCOLOR_STATIC = 6 +CTLCOLOR_MAX = 7 +COLOR_SCROLLBAR = 0 +COLOR_BACKGROUND = 1 +COLOR_ACTIVECAPTION = 2 +COLOR_INACTIVECAPTION = 3 +COLOR_MENU = 4 +COLOR_WINDOW = 5 +COLOR_WINDOWFRAME = 6 +COLOR_MENUTEXT = 7 +COLOR_WINDOWTEXT = 8 +COLOR_CAPTIONTEXT = 9 +COLOR_ACTIVEBORDER = 10 +COLOR_INACTIVEBORDER = 11 +COLOR_APPWORKSPACE = 12 +COLOR_HIGHLIGHT = 13 +COLOR_HIGHLIGHTTEXT = 14 +COLOR_BTNFACE = 15 +COLOR_BTNSHADOW = 16 +COLOR_GRAYTEXT = 17 +COLOR_BTNTEXT = 18 +COLOR_INACTIVECAPTIONTEXT = 19 +COLOR_BTNHIGHLIGHT = 20 +COLOR_3DDKSHADOW = 21 +COLOR_3DLIGHT = 22 +COLOR_INFOTEXT = 23 +COLOR_INFOBK = 24 +COLOR_HOTLIGHT = 26 +COLOR_GRADIENTACTIVECAPTION = 27 +COLOR_GRADIENTINACTIVECAPTION = 28 +COLOR_DESKTOP = COLOR_BACKGROUND +COLOR_3DFACE = COLOR_BTNFACE +COLOR_3DSHADOW = COLOR_BTNSHADOW +COLOR_3DHIGHLIGHT = COLOR_BTNHIGHLIGHT +COLOR_3DHILIGHT = COLOR_BTNHIGHLIGHT +COLOR_BTNHILIGHT = COLOR_BTNHIGHLIGHT +GW_HWNDFIRST = 0 +GW_HWNDLAST = 1 +GW_HWNDNEXT = 2 +GW_HWNDPREV = 3 +GW_OWNER = 4 +GW_CHILD = 5 +GW_ENABLEDPOPUP = 6 +GW_MAX = 6 +MF_INSERT = 0 +MF_CHANGE = 128 +MF_APPEND = 256 +MF_DELETE = 512 +MF_REMOVE = 4096 +MF_BYCOMMAND = 0 +MF_BYPOSITION = 1024 +MF_SEPARATOR = 2048 +MF_ENABLED = 0 +MF_GRAYED = 1 +MF_DISABLED = 2 +MF_UNCHECKED = 0 +MF_CHECKED = 8 +MF_USECHECKBITMAPS = 512 +MF_STRING = 0 +MF_BITMAP = 4 +MF_OWNERDRAW = 256 +MF_POPUP = 16 +MF_MENUBARBREAK = 32 +MF_MENUBREAK = 64 +MF_UNHILITE = 0 +MF_HILITE = 128 +MF_DEFAULT = 4096 +MF_SYSMENU = 8192 +MF_HELP = 16384 +MF_RIGHTJUSTIFY = 16384 +MF_MOUSESELECT = 32768 +MF_END = 128 +MFT_STRING = MF_STRING +MFT_BITMAP = MF_BITMAP +MFT_MENUBARBREAK = MF_MENUBARBREAK +MFT_MENUBREAK = MF_MENUBREAK +MFT_OWNERDRAW = MF_OWNERDRAW +MFT_RADIOCHECK = 512 +MFT_SEPARATOR = MF_SEPARATOR +MFT_RIGHTORDER = 8192 +MFT_RIGHTJUSTIFY = MF_RIGHTJUSTIFY +MFS_GRAYED = 3 +MFS_DISABLED = MFS_GRAYED +MFS_CHECKED = MF_CHECKED +MFS_HILITE = MF_HILITE +MFS_ENABLED = MF_ENABLED +MFS_UNCHECKED = MF_UNCHECKED +MFS_UNHILITE = MF_UNHILITE +MFS_DEFAULT = MF_DEFAULT +MFS_MASK = 4235 +MFS_HOTTRACKDRAWN = 268435456 +MFS_CACHEDBMP = 536870912 +MFS_BOTTOMGAPDROP = 1073741824 +MFS_TOPGAPDROP = -2147483648 +MFS_GAPDROP = -1073741824 +SC_SIZE = 61440 +SC_MOVE = 61456 +SC_MINIMIZE = 61472 +SC_MAXIMIZE = 61488 +SC_NEXTWINDOW = 61504 +SC_PREVWINDOW = 61520 +SC_CLOSE = 61536 +SC_VSCROLL = 61552 +SC_HSCROLL = 61568 +SC_MOUSEMENU = 61584 +SC_KEYMENU = 61696 +SC_ARRANGE = 61712 +SC_RESTORE = 61728 +SC_TASKLIST = 61744 +SC_SCREENSAVE = 61760 +SC_HOTKEY = 61776 +SC_DEFAULT = 61792 +SC_MONITORPOWER = 61808 +SC_CONTEXTHELP = 61824 +SC_SEPARATOR = 61455 +SC_ICON = SC_MINIMIZE +SC_ZOOM = SC_MAXIMIZE +IDC_ARROW = 32512 +IDC_IBEAM = 32513 +IDC_WAIT = 32514 +IDC_CROSS = 32515 +IDC_UPARROW = 32516 +IDC_SIZE = 32640 # OBSOLETE: use IDC_SIZEALL +IDC_ICON = 32641 # OBSOLETE: use IDC_ARROW +IDC_SIZENWSE = 32642 +IDC_SIZENESW = 32643 +IDC_SIZEWE = 32644 +IDC_SIZENS = 32645 +IDC_SIZEALL = 32646 +IDC_NO = 32648 +IDC_HAND = 32649 +IDC_APPSTARTING = 32650 +IDC_HELP = 32651 +IMAGE_BITMAP = 0 +IMAGE_ICON = 1 +IMAGE_CURSOR = 2 +IMAGE_ENHMETAFILE = 3 +LR_DEFAULTCOLOR = 0 +LR_MONOCHROME = 1 +LR_COLOR = 2 +LR_COPYRETURNORG = 4 +LR_COPYDELETEORG = 8 +LR_LOADFROMFILE = 16 +LR_LOADTRANSPARENT = 32 +LR_DEFAULTSIZE = 64 +LR_LOADREALSIZE = 128 +LR_LOADMAP3DCOLORS = 4096 +LR_CREATEDIBSECTION = 8192 +LR_COPYFROMRESOURCE = 16384 +LR_SHARED = 32768 +DI_MASK = 1 +DI_IMAGE = 2 +DI_NORMAL = 3 +DI_COMPAT = 4 +DI_DEFAULTSIZE = 8 +RES_ICON = 1 +RES_CURSOR = 2 +OBM_CLOSE = 32754 +OBM_UPARROW = 32753 +OBM_DNARROW = 32752 +OBM_RGARROW = 32751 +OBM_LFARROW = 32750 +OBM_REDUCE = 32749 +OBM_ZOOM = 32748 +OBM_RESTORE = 32747 +OBM_REDUCED = 32746 +OBM_ZOOMD = 32745 +OBM_RESTORED = 32744 +OBM_UPARROWD = 32743 +OBM_DNARROWD = 32742 +OBM_RGARROWD = 32741 +OBM_LFARROWD = 32740 +OBM_MNARROW = 32739 +OBM_COMBO = 32738 +OBM_UPARROWI = 32737 +OBM_DNARROWI = 32736 +OBM_RGARROWI = 32735 +OBM_LFARROWI = 32734 +OBM_OLD_CLOSE = 32767 +OBM_SIZE = 32766 +OBM_OLD_UPARROW = 32765 +OBM_OLD_DNARROW = 32764 +OBM_OLD_RGARROW = 32763 +OBM_OLD_LFARROW = 32762 +OBM_BTSIZE = 32761 +OBM_CHECK = 32760 +OBM_CHECKBOXES = 32759 +OBM_BTNCORNERS = 32758 +OBM_OLD_REDUCE = 32757 +OBM_OLD_ZOOM = 32756 +OBM_OLD_RESTORE = 32755 +OCR_NORMAL = 32512 +OCR_IBEAM = 32513 +OCR_WAIT = 32514 +OCR_CROSS = 32515 +OCR_UP = 32516 +OCR_SIZE = 32640 +OCR_ICON = 32641 +OCR_SIZENWSE = 32642 +OCR_SIZENESW = 32643 +OCR_SIZEWE = 32644 +OCR_SIZENS = 32645 +OCR_SIZEALL = 32646 +OCR_ICOCUR = 32647 +OCR_NO = 32648 +OCR_HAND = 32649 +OCR_APPSTARTING = 32650 +# winuser.h line 7455 +OIC_SAMPLE = 32512 +OIC_HAND = 32513 +OIC_QUES = 32514 +OIC_BANG = 32515 +OIC_NOTE = 32516 +OIC_WINLOGO = 32517 +OIC_WARNING = OIC_BANG +OIC_ERROR = OIC_HAND +OIC_INFORMATION = OIC_NOTE +ORD_LANGDRIVER = 1 +IDI_APPLICATION = 32512 +IDI_HAND = 32513 +IDI_QUESTION = 32514 +IDI_EXCLAMATION = 32515 +IDI_ASTERISK = 32516 +IDI_WINLOGO = 32517 +IDI_WARNING = IDI_EXCLAMATION +IDI_ERROR = IDI_HAND +IDI_INFORMATION = IDI_ASTERISK +IDOK = 1 +IDCANCEL = 2 +IDABORT = 3 +IDRETRY = 4 +IDIGNORE = 5 +IDYES = 6 +IDNO = 7 +IDCLOSE = 8 +IDHELP = 9 +ES_LEFT = 0 +ES_CENTER = 1 +ES_RIGHT = 2 +ES_MULTILINE = 4 +ES_UPPERCASE = 8 +ES_LOWERCASE = 16 +ES_PASSWORD = 32 +ES_AUTOVSCROLL = 64 +ES_AUTOHSCROLL = 128 +ES_NOHIDESEL = 256 +ES_OEMCONVERT = 1024 +ES_READONLY = 2048 +ES_WANTRETURN = 4096 +ES_NUMBER = 8192 +EN_SETFOCUS = 256 +EN_KILLFOCUS = 512 +EN_CHANGE = 768 +EN_UPDATE = 1024 +EN_ERRSPACE = 1280 +EN_MAXTEXT = 1281 +EN_HSCROLL = 1537 +EN_VSCROLL = 1538 +EC_LEFTMARGIN = 1 +EC_RIGHTMARGIN = 2 +EC_USEFONTINFO = 65535 +EMSIS_COMPOSITIONSTRING = 1 +EIMES_GETCOMPSTRATONCE = 1 +EIMES_CANCELCOMPSTRINFOCUS = 2 +EIMES_COMPLETECOMPSTRKILLFOCUS = 4 +EM_GETSEL = 176 +EM_SETSEL = 177 +EM_GETRECT = 178 +EM_SETRECT = 179 +EM_SETRECTNP = 180 +EM_SCROLL = 181 +EM_LINESCROLL = 182 +EM_SCROLLCARET = 183 +EM_GETMODIFY = 184 +EM_SETMODIFY = 185 +EM_GETLINECOUNT = 186 +EM_LINEINDEX = 187 +EM_SETHANDLE = 188 +EM_GETHANDLE = 189 +EM_GETTHUMB = 190 +EM_LINELENGTH = 193 +EM_REPLACESEL = 194 +EM_GETLINE = 196 +EM_LIMITTEXT = 197 +EM_CANUNDO = 198 +EM_UNDO = 199 +EM_FMTLINES = 200 +EM_LINEFROMCHAR = 201 +EM_SETTABSTOPS = 203 +EM_SETPASSWORDCHAR = 204 +EM_EMPTYUNDOBUFFER = 205 +EM_GETFIRSTVISIBLELINE = 206 +EM_SETREADONLY = 207 +EM_SETWORDBREAKPROC = 208 +EM_GETWORDBREAKPROC = 209 +EM_GETPASSWORDCHAR = 210 +EM_SETMARGINS = 211 +EM_GETMARGINS = 212 +EM_SETLIMITTEXT = EM_LIMITTEXT +EM_GETLIMITTEXT = 213 +EM_POSFROMCHAR = 214 +EM_CHARFROMPOS = 215 +EM_SETIMESTATUS = 216 +EM_GETIMESTATUS = 217 +WB_LEFT = 0 +WB_RIGHT = 1 +WB_ISDELIMITER = 2 +BS_PUSHBUTTON = 0 +BS_DEFPUSHBUTTON = 1 +BS_CHECKBOX = 2 +BS_AUTOCHECKBOX = 3 +BS_RADIOBUTTON = 4 +BS_3STATE = 5 +BS_AUTO3STATE = 6 +BS_GROUPBOX = 7 +BS_USERBUTTON = 8 +BS_AUTORADIOBUTTON = 9 +BS_OWNERDRAW = 11 +BS_LEFTTEXT = 32 +BS_TEXT = 0 +BS_ICON = 64 +BS_BITMAP = 128 +BS_LEFT = 256 +BS_RIGHT = 512 +BS_CENTER = 768 +BS_TOP = 1024 +BS_BOTTOM = 2048 +BS_VCENTER = 3072 +BS_PUSHLIKE = 4096 +BS_MULTILINE = 8192 +BS_NOTIFY = 16384 +BS_FLAT = 32768 +BS_RIGHTBUTTON = BS_LEFTTEXT +BN_CLICKED = 0 +BN_PAINT = 1 +BN_HILITE = 2 +BN_UNHILITE = 3 +BN_DISABLE = 4 +BN_DOUBLECLICKED = 5 +BN_PUSHED = BN_HILITE +BN_UNPUSHED = BN_UNHILITE +BN_DBLCLK = BN_DOUBLECLICKED +BN_SETFOCUS = 6 +BN_KILLFOCUS = 7 +BM_GETCHECK = 240 +BM_SETCHECK = 241 +BM_GETSTATE = 242 +BM_SETSTATE = 243 +BM_SETSTYLE = 244 +BM_CLICK = 245 +BM_GETIMAGE = 246 +BM_SETIMAGE = 247 +BST_UNCHECKED = 0 +BST_CHECKED = 1 +BST_INDETERMINATE = 2 +BST_PUSHED = 4 +BST_FOCUS = 8 +SS_LEFT = 0 +SS_CENTER = 1 +SS_RIGHT = 2 +SS_ICON = 3 +SS_BLACKRECT = 4 +SS_GRAYRECT = 5 +SS_WHITERECT = 6 +SS_BLACKFRAME = 7 +SS_GRAYFRAME = 8 +SS_WHITEFRAME = 9 +SS_USERITEM = 10 +SS_SIMPLE = 11 +SS_LEFTNOWORDWRAP = 12 +SS_BITMAP = 14 +SS_OWNERDRAW = 13 +SS_ENHMETAFILE = 15 +SS_ETCHEDHORZ = 16 +SS_ETCHEDVERT = 17 +SS_ETCHEDFRAME = 18 +SS_TYPEMASK = 31 +SS_NOPREFIX = 128 +SS_NOTIFY = 256 +SS_CENTERIMAGE = 512 +SS_RIGHTJUST = 1024 +SS_REALSIZEIMAGE = 2048 +SS_SUNKEN = 4096 +SS_ENDELLIPSIS = 16384 +SS_PATHELLIPSIS = 32768 +SS_WORDELLIPSIS = 49152 +SS_ELLIPSISMASK = 49152 +STM_SETICON = 368 +STM_GETICON = 369 +STM_SETIMAGE = 370 +STM_GETIMAGE = 371 +STN_CLICKED = 0 +STN_DBLCLK = 1 +STN_ENABLE = 2 +STN_DISABLE = 3 +STM_MSGMAX = 372 +DWL_MSGRESULT = 0 +DWL_DLGPROC = 4 +DWL_USER = 8 +DDL_READWRITE = 0 +DDL_READONLY = 1 +DDL_HIDDEN = 2 +DDL_SYSTEM = 4 +DDL_DIRECTORY = 16 +DDL_ARCHIVE = 32 +DDL_POSTMSGS = 8192 +DDL_DRIVES = 16384 +DDL_EXCLUSIVE = 32768 + +# from winuser.h line 153 +RT_CURSOR = 1 +RT_BITMAP = 2 +RT_ICON = 3 +RT_MENU = 4 +RT_DIALOG = 5 +RT_STRING = 6 +RT_FONTDIR = 7 +RT_FONT = 8 +RT_ACCELERATOR = 9 +RT_RCDATA = 10 +RT_MESSAGETABLE = 11 +DIFFERENCE = 11 +RT_GROUP_CURSOR = RT_CURSOR + DIFFERENCE +RT_GROUP_ICON = RT_ICON + DIFFERENCE +RT_VERSION = 16 +RT_DLGINCLUDE = 17 +RT_PLUGPLAY = 19 +RT_VXD = 20 +RT_ANICURSOR = 21 +RT_ANIICON = 22 +RT_HTML = 23 +# from winuser.h line 218 +SB_HORZ = 0 +SB_VERT = 1 +SB_CTL = 2 +SB_BOTH = 3 +SB_LINEUP = 0 +SB_LINELEFT = 0 +SB_LINEDOWN = 1 +SB_LINERIGHT = 1 +SB_PAGEUP = 2 +SB_PAGELEFT = 2 +SB_PAGEDOWN = 3 +SB_PAGERIGHT = 3 +SB_THUMBPOSITION = 4 +SB_THUMBTRACK = 5 +SB_TOP = 6 +SB_LEFT = 6 +SB_BOTTOM = 7 +SB_RIGHT = 7 +SB_ENDSCROLL = 8 +SW_HIDE = 0 +SW_SHOWNORMAL = 1 +SW_NORMAL = 1 +SW_SHOWMINIMIZED = 2 +SW_SHOWMAXIMIZED = 3 +SW_MAXIMIZE = 3 +SW_SHOWNOACTIVATE = 4 +SW_SHOW = 5 +SW_MINIMIZE = 6 +SW_SHOWMINNOACTIVE = 7 +SW_SHOWNA = 8 +SW_RESTORE = 9 +SW_SHOWDEFAULT = 10 +SW_FORCEMINIMIZE = 11 +SW_MAX = 11 +HIDE_WINDOW = 0 +SHOW_OPENWINDOW = 1 +SHOW_ICONWINDOW = 2 +SHOW_FULLSCREEN = 3 +SHOW_OPENNOACTIVATE = 4 +SW_PARENTCLOSING = 1 +SW_OTHERZOOM = 2 +SW_PARENTOPENING = 3 +SW_OTHERUNZOOM = 4 +AW_HOR_POSITIVE = 1 +AW_HOR_NEGATIVE = 2 +AW_VER_POSITIVE = 4 +AW_VER_NEGATIVE = 8 +AW_CENTER = 16 +AW_HIDE = 65536 +AW_ACTIVATE = 131072 +AW_SLIDE = 262144 +AW_BLEND = 524288 +KF_EXTENDED = 256 +KF_DLGMODE = 2048 +KF_MENUMODE = 4096 +KF_ALTDOWN = 8192 +KF_REPEAT = 16384 +KF_UP = 32768 +VK_LBUTTON = 1 +VK_RBUTTON = 2 +VK_CANCEL = 3 +VK_MBUTTON = 4 +VK_BACK = 8 +VK_TAB = 9 +VK_CLEAR = 12 +VK_RETURN = 13 +VK_SHIFT = 16 +VK_CONTROL = 17 +VK_MENU = 18 +VK_PAUSE = 19 +VK_CAPITAL = 20 +VK_KANA = 21 +VK_HANGEUL = 21 # old name - should be here for compatibility +VK_HANGUL = 21 +VK_JUNJA = 23 +VK_FINAL = 24 +VK_HANJA = 25 +VK_KANJI = 25 +VK_ESCAPE = 27 +VK_CONVERT = 28 +VK_NONCONVERT = 29 +VK_ACCEPT = 30 +VK_MODECHANGE = 31 +VK_SPACE = 32 +VK_PRIOR = 33 +VK_NEXT = 34 +VK_END = 35 +VK_HOME = 36 +VK_LEFT = 37 +VK_UP = 38 +VK_RIGHT = 39 +VK_DOWN = 40 +VK_SELECT = 41 +VK_PRINT = 42 +VK_EXECUTE = 43 +VK_SNAPSHOT = 44 +VK_INSERT = 45 +VK_DELETE = 46 +VK_HELP = 47 +VK_LWIN = 91 +VK_RWIN = 92 +VK_APPS = 93 +VK_NUMPAD0 = 96 +VK_NUMPAD1 = 97 +VK_NUMPAD2 = 98 +VK_NUMPAD3 = 99 +VK_NUMPAD4 = 100 +VK_NUMPAD5 = 101 +VK_NUMPAD6 = 102 +VK_NUMPAD7 = 103 +VK_NUMPAD8 = 104 +VK_NUMPAD9 = 105 +VK_MULTIPLY = 106 +VK_ADD = 107 +VK_SEPARATOR = 108 +VK_SUBTRACT = 109 +VK_DECIMAL = 110 +VK_DIVIDE = 111 +VK_F1 = 112 +VK_F2 = 113 +VK_F3 = 114 +VK_F4 = 115 +VK_F5 = 116 +VK_F6 = 117 +VK_F7 = 118 +VK_F8 = 119 +VK_F9 = 120 +VK_F10 = 121 +VK_F11 = 122 +VK_F12 = 123 +VK_F13 = 124 +VK_F14 = 125 +VK_F15 = 126 +VK_F16 = 127 +VK_F17 = 128 +VK_F18 = 129 +VK_F19 = 130 +VK_F20 = 131 +VK_F21 = 132 +VK_F22 = 133 +VK_F23 = 134 +VK_F24 = 135 +VK_NUMLOCK = 144 +VK_SCROLL = 145 +VK_LSHIFT = 160 +VK_RSHIFT = 161 +VK_LCONTROL = 162 +VK_RCONTROL = 163 +VK_LMENU = 164 +VK_RMENU = 165 +VK_PROCESSKEY = 229 +VK_ATTN = 246 +VK_CRSEL = 247 +VK_EXSEL = 248 +VK_EREOF = 249 +VK_PLAY = 250 +VK_ZOOM = 251 +VK_NONAME = 252 +VK_PA1 = 253 +VK_OEM_CLEAR = 254 +# multi-media related "keys" +MOUSEEVENTF_XDOWN = 0x0080 +MOUSEEVENTF_XUP = 0x0100 +MOUSEEVENTF_WHEEL = 0x0800 +VK_XBUTTON1 = 0x05 +VK_XBUTTON2 = 0x06 +VK_VOLUME_MUTE = 0xAD +VK_VOLUME_DOWN = 0xAE +VK_VOLUME_UP = 0xAF +VK_MEDIA_NEXT_TRACK = 0xB0 +VK_MEDIA_PREV_TRACK = 0xB1 +VK_MEDIA_PLAY_PAUSE = 0xB3 +VK_BROWSER_BACK = 0xA6 +VK_BROWSER_FORWARD = 0xA7 +WH_MIN = -1 +WH_MSGFILTER = -1 +WH_JOURNALRECORD = 0 +WH_JOURNALPLAYBACK = 1 +WH_KEYBOARD = 2 +WH_GETMESSAGE = 3 +WH_CALLWNDPROC = 4 +WH_CBT = 5 +WH_SYSMSGFILTER = 6 +WH_MOUSE = 7 +WH_HARDWARE = 8 +WH_DEBUG = 9 +WH_SHELL = 10 +WH_FOREGROUNDIDLE = 11 +WH_CALLWNDPROCRET = 12 +WH_KEYBOARD_LL = 13 +WH_MOUSE_LL = 14 +WH_MAX = 14 +WH_MINHOOK = WH_MIN +WH_MAXHOOK = WH_MAX +HC_ACTION = 0 +HC_GETNEXT = 1 +HC_SKIP = 2 +HC_NOREMOVE = 3 +HC_NOREM = HC_NOREMOVE +HC_SYSMODALON = 4 +HC_SYSMODALOFF = 5 +HCBT_MOVESIZE = 0 +HCBT_MINMAX = 1 +HCBT_QS = 2 +HCBT_CREATEWND = 3 +HCBT_DESTROYWND = 4 +HCBT_ACTIVATE = 5 +HCBT_CLICKSKIPPED = 6 +HCBT_KEYSKIPPED = 7 +HCBT_SYSCOMMAND = 8 +HCBT_SETFOCUS = 9 +MSGF_DIALOGBOX = 0 +MSGF_MESSAGEBOX = 1 +MSGF_MENU = 2 +# MSGF_MOVE = 3 +# MSGF_SIZE = 4 +MSGF_SCROLLBAR = 5 +MSGF_NEXTWINDOW = 6 +# MSGF_MAINLOOP = 8 +MSGF_MAX = 8 +MSGF_USER = 4096 +HSHELL_WINDOWCREATED = 1 +HSHELL_WINDOWDESTROYED = 2 +HSHELL_ACTIVATESHELLWINDOW = 3 +HSHELL_WINDOWACTIVATED = 4 +HSHELL_GETMINRECT = 5 +HSHELL_REDRAW = 6 +HSHELL_TASKMAN = 7 +HSHELL_LANGUAGE = 8 +HSHELL_ACCESSIBILITYSTATE = 11 +ACCESS_STICKYKEYS = 1 +ACCESS_FILTERKEYS = 2 +ACCESS_MOUSEKEYS = 3 +# winuser.h line 624 +LLKHF_EXTENDED = 1 +LLKHF_INJECTED = 16 +LLKHF_ALTDOWN = 32 +LLKHF_UP = 128 +LLKHF_LOWER_IL_INJECTED = 2 +LLMHF_INJECTED = 1 +LLMHF_LOWER_IL_INJECTED = 2 +# line 692 +HKL_PREV = 0 +HKL_NEXT = 1 +KLF_ACTIVATE = 1 +KLF_SUBSTITUTE_OK = 2 +KLF_UNLOADPREVIOUS = 4 +KLF_REORDER = 8 +KLF_REPLACELANG = 16 +KLF_NOTELLSHELL = 128 +KLF_SETFORPROCESS = 256 +KL_NAMELENGTH = 9 +DESKTOP_READOBJECTS = 1 +DESKTOP_CREATEWINDOW = 2 +DESKTOP_CREATEMENU = 4 +DESKTOP_HOOKCONTROL = 8 +DESKTOP_JOURNALRECORD = 16 +DESKTOP_JOURNALPLAYBACK = 32 +DESKTOP_ENUMERATE = 64 +DESKTOP_WRITEOBJECTS = 128 +DESKTOP_SWITCHDESKTOP = 256 +DF_ALLOWOTHERACCOUNTHOOK = 1 +WINSTA_ENUMDESKTOPS = 1 +WINSTA_READATTRIBUTES = 2 +WINSTA_ACCESSCLIPBOARD = 4 +WINSTA_CREATEDESKTOP = 8 +WINSTA_WRITEATTRIBUTES = 16 +WINSTA_ACCESSGLOBALATOMS = 32 +WINSTA_EXITWINDOWS = 64 +WINSTA_ENUMERATE = 256 +WINSTA_READSCREEN = 512 +WSF_VISIBLE = 1 +UOI_FLAGS = 1 +UOI_NAME = 2 +UOI_TYPE = 3 +UOI_USER_SID = 4 +GWL_WNDPROC = -4 +GWL_HINSTANCE = -6 +GWL_HWNDPARENT = -8 +GWL_STYLE = -16 +GWL_EXSTYLE = -20 +GWL_USERDATA = -21 +GWL_ID = -12 +GCL_MENUNAME = -8 +GCL_HBRBACKGROUND = -10 +GCL_HCURSOR = -12 +GCL_HICON = -14 +GCL_HMODULE = -16 +GCL_CBWNDEXTRA = -18 +GCL_CBCLSEXTRA = -20 +GCL_WNDPROC = -24 +GCL_STYLE = -26 +GCW_ATOM = -32 +GCL_HICONSM = -34 +# line 1291 +WM_NULL = 0 +WM_CREATE = 1 +WM_DESTROY = 2 +WM_MOVE = 3 +WM_SIZE = 5 +WM_ACTIVATE = 6 +WA_INACTIVE = 0 +WA_ACTIVE = 1 +WA_CLICKACTIVE = 2 +WM_SETFOCUS = 7 +WM_KILLFOCUS = 8 +WM_ENABLE = 10 +WM_SETREDRAW = 11 +WM_SETTEXT = 12 +WM_GETTEXT = 13 +WM_GETTEXTLENGTH = 14 +WM_PAINT = 15 +WM_CLOSE = 16 +WM_QUERYENDSESSION = 17 +WM_QUIT = 18 +WM_QUERYOPEN = 19 +WM_ERASEBKGND = 20 +WM_SYSCOLORCHANGE = 21 +WM_ENDSESSION = 22 +WM_SHOWWINDOW = 24 +WM_WININICHANGE = 26 +WM_SETTINGCHANGE = WM_WININICHANGE +WM_DEVMODECHANGE = 27 +WM_ACTIVATEAPP = 28 +WM_FONTCHANGE = 29 +WM_TIMECHANGE = 30 +WM_CANCELMODE = 31 +WM_SETCURSOR = 32 +WM_MOUSEACTIVATE = 33 +WM_CHILDACTIVATE = 34 +WM_QUEUESYNC = 35 +WM_GETMINMAXINFO = 36 +WM_PAINTICON = 38 +WM_ICONERASEBKGND = 39 +WM_NEXTDLGCTL = 40 +WM_SPOOLERSTATUS = 42 +WM_DRAWITEM = 43 +WM_MEASUREITEM = 44 +WM_DELETEITEM = 45 +WM_VKEYTOITEM = 46 +WM_CHARTOITEM = 47 +WM_SETFONT = 48 +WM_GETFONT = 49 +WM_SETHOTKEY = 50 +WM_GETHOTKEY = 51 +WM_QUERYDRAGICON = 55 +WM_COMPAREITEM = 57 +WM_GETOBJECT = 61 +WM_COMPACTING = 65 +WM_COMMNOTIFY = 68 +WM_WINDOWPOSCHANGING = 70 +WM_WINDOWPOSCHANGED = 71 +WM_POWER = 72 +PWR_OK = 1 +PWR_FAIL = -1 +PWR_SUSPENDREQUEST = 1 +PWR_SUSPENDRESUME = 2 +PWR_CRITICALRESUME = 3 +WM_COPYDATA = 74 +WM_CANCELJOURNAL = 75 +WM_NOTIFY = 78 +WM_INPUTLANGCHANGEREQUEST = 80 +WM_INPUTLANGCHANGE = 81 +WM_TCARD = 82 +WM_HELP = 83 +WM_USERCHANGED = 84 +WM_NOTIFYFORMAT = 85 +NFR_ANSI = 1 +NFR_UNICODE = 2 +NF_QUERY = 3 +NF_REQUERY = 4 +WM_CONTEXTMENU = 123 +WM_STYLECHANGING = 124 +WM_STYLECHANGED = 125 +WM_DISPLAYCHANGE = 126 +WM_GETICON = 127 +WM_SETICON = 128 +WM_NCCREATE = 129 +WM_NCDESTROY = 130 +WM_NCCALCSIZE = 131 +WM_NCHITTEST = 132 +WM_NCPAINT = 133 +WM_NCACTIVATE = 134 +WM_GETDLGCODE = 135 +WM_SYNCPAINT = 136 +WM_NCMOUSEMOVE = 160 +WM_NCLBUTTONDOWN = 161 +WM_NCLBUTTONUP = 162 +WM_NCLBUTTONDBLCLK = 163 +WM_NCRBUTTONDOWN = 164 +WM_NCRBUTTONUP = 165 +WM_NCRBUTTONDBLCLK = 166 +WM_NCMBUTTONDOWN = 167 +WM_NCMBUTTONUP = 168 +WM_NCMBUTTONDBLCLK = 169 +WM_KEYFIRST = 256 +WM_KEYDOWN = 256 +WM_KEYUP = 257 +WM_CHAR = 258 +WM_DEADCHAR = 259 +WM_SYSKEYDOWN = 260 +WM_SYSKEYUP = 261 +WM_SYSCHAR = 262 +WM_SYSDEADCHAR = 263 +WM_KEYLAST = 264 +WM_IME_STARTCOMPOSITION = 269 +WM_IME_ENDCOMPOSITION = 270 +WM_IME_COMPOSITION = 271 +WM_IME_KEYLAST = 271 +WM_INITDIALOG = 272 +WM_COMMAND = 273 +WM_SYSCOMMAND = 274 +WM_TIMER = 275 +WM_HSCROLL = 276 +WM_VSCROLL = 277 +WM_INITMENU = 278 +WM_INITMENUPOPUP = 279 +WM_MENUSELECT = 287 +WM_MENUCHAR = 288 +WM_ENTERIDLE = 289 +WM_MENURBUTTONUP = 290 +WM_MENUDRAG = 291 +WM_MENUGETOBJECT = 292 +WM_UNINITMENUPOPUP = 293 +WM_MENUCOMMAND = 294 +WM_CTLCOLORMSGBOX = 306 +WM_CTLCOLOREDIT = 307 +WM_CTLCOLORLISTBOX = 308 +WM_CTLCOLORBTN = 309 +WM_CTLCOLORDLG = 310 +WM_CTLCOLORSCROLLBAR = 311 +WM_CTLCOLORSTATIC = 312 +WM_MOUSEFIRST = 512 +WM_MOUSEMOVE = 512 +WM_LBUTTONDOWN = 513 +WM_LBUTTONUP = 514 +WM_LBUTTONDBLCLK = 515 +WM_RBUTTONDOWN = 516 +WM_RBUTTONUP = 517 +WM_RBUTTONDBLCLK = 518 +WM_MBUTTONDOWN = 519 +WM_MBUTTONUP = 520 +WM_MBUTTONDBLCLK = 521 +WM_MOUSEWHEEL = 522 +WM_MOUSELAST = 522 +WHEEL_DELTA = 120 # Value for rolling one detent +WHEEL_PAGESCROLL = -1 # Scroll one page +WM_PARENTNOTIFY = 528 +MENULOOP_WINDOW = 0 +MENULOOP_POPUP = 1 +WM_ENTERMENULOOP = 529 +WM_EXITMENULOOP = 530 +WM_NEXTMENU = 531 +WM_SIZING = 532 +WM_CAPTURECHANGED = 533 +WM_MOVING = 534 +WM_POWERBROADCAST = 536 +PBT_APMQUERYSUSPEND = 0 +PBT_APMQUERYSTANDBY = 1 +PBT_APMQUERYSUSPENDFAILED = 2 +PBT_APMQUERYSTANDBYFAILED = 3 +PBT_APMSUSPEND = 4 +PBT_APMSTANDBY = 5 +PBT_APMRESUMECRITICAL = 6 +PBT_APMRESUMESUSPEND = 7 +PBT_APMRESUMESTANDBY = 8 +PBTF_APMRESUMEFROMFAILURE = 1 +PBT_APMBATTERYLOW = 9 +PBT_APMPOWERSTATUSCHANGE = 10 +PBT_APMOEMEVENT = 11 +PBT_APMRESUMEAUTOMATIC = 18 +WM_DEVICECHANGE = 537 +WM_MDICREATE = 544 +WM_MDIDESTROY = 545 +WM_MDIACTIVATE = 546 +WM_MDIRESTORE = 547 +WM_MDINEXT = 548 +WM_MDIMAXIMIZE = 549 +WM_MDITILE = 550 +WM_MDICASCADE = 551 +WM_MDIICONARRANGE = 552 +WM_MDIGETACTIVE = 553 +WM_MDISETMENU = 560 +WM_ENTERSIZEMOVE = 561 +WM_EXITSIZEMOVE = 562 +WM_DROPFILES = 563 +WM_MDIREFRESHMENU = 564 +WM_IME_SETCONTEXT = 641 +WM_IME_NOTIFY = 642 +WM_IME_CONTROL = 643 +WM_IME_COMPOSITIONFULL = 644 +WM_IME_SELECT = 645 +WM_IME_CHAR = 646 +WM_IME_REQUEST = 648 +WM_IME_KEYDOWN = 656 +WM_IME_KEYUP = 657 +WM_MOUSEHOVER = 673 +WM_MOUSELEAVE = 675 +WM_CUT = 768 +WM_COPY = 769 +WM_PASTE = 770 +WM_CLEAR = 771 +WM_UNDO = 772 +WM_RENDERFORMAT = 773 +WM_RENDERALLFORMATS = 774 +WM_DESTROYCLIPBOARD = 775 +WM_DRAWCLIPBOARD = 776 +WM_PAINTCLIPBOARD = 777 +WM_VSCROLLCLIPBOARD = 778 +WM_SIZECLIPBOARD = 779 +WM_ASKCBFORMATNAME = 780 +WM_CHANGECBCHAIN = 781 +WM_HSCROLLCLIPBOARD = 782 +WM_QUERYNEWPALETTE = 783 +WM_PALETTEISCHANGING = 784 +WM_PALETTECHANGED = 785 +WM_HOTKEY = 786 +WM_PRINT = 791 +WM_PRINTCLIENT = 792 +WM_HANDHELDFIRST = 856 +WM_HANDHELDLAST = 863 +WM_AFXFIRST = 864 +WM_AFXLAST = 895 +WM_PENWINFIRST = 896 +WM_PENWINLAST = 911 +WM_APP = 32768 +WMSZ_LEFT = 1 +WMSZ_RIGHT = 2 +WMSZ_TOP = 3 +WMSZ_TOPLEFT = 4 +WMSZ_TOPRIGHT = 5 +WMSZ_BOTTOM = 6 +WMSZ_BOTTOMLEFT = 7 +WMSZ_BOTTOMRIGHT = 8 +# ST_BEGINSWP = 0 +# ST_ENDSWP = 1 +HTERROR = -2 +HTTRANSPARENT = -1 +HTNOWHERE = 0 +HTCLIENT = 1 +HTCAPTION = 2 +HTSYSMENU = 3 +HTGROWBOX = 4 +HTSIZE = HTGROWBOX +HTMENU = 5 +HTHSCROLL = 6 +HTVSCROLL = 7 +HTMINBUTTON = 8 +HTMAXBUTTON = 9 +HTLEFT = 10 +HTRIGHT = 11 +HTTOP = 12 +HTTOPLEFT = 13 +HTTOPRIGHT = 14 +HTBOTTOM = 15 +HTBOTTOMLEFT = 16 +HTBOTTOMRIGHT = 17 +HTBORDER = 18 +HTREDUCE = HTMINBUTTON +HTZOOM = HTMAXBUTTON +HTSIZEFIRST = HTLEFT +HTSIZELAST = HTBOTTOMRIGHT +HTOBJECT = 19 +HTCLOSE = 20 +HTHELP = 21 +SMTO_NORMAL = 0 +SMTO_BLOCK = 1 +SMTO_ABORTIFHUNG = 2 +SMTO_NOTIMEOUTIFNOTHUNG = 8 +MA_ACTIVATE = 1 +MA_ACTIVATEANDEAT = 2 +MA_NOACTIVATE = 3 +MA_NOACTIVATEANDEAT = 4 +ICON_SMALL = 0 +ICON_BIG = 1 +SIZE_RESTORED = 0 +SIZE_MINIMIZED = 1 +SIZE_MAXIMIZED = 2 +SIZE_MAXSHOW = 3 +SIZE_MAXHIDE = 4 +SIZENORMAL = SIZE_RESTORED +SIZEICONIC = SIZE_MINIMIZED +SIZEFULLSCREEN = SIZE_MAXIMIZED +SIZEZOOMSHOW = SIZE_MAXSHOW +SIZEZOOMHIDE = SIZE_MAXHIDE +WVR_ALIGNTOP = 16 +WVR_ALIGNLEFT = 32 +WVR_ALIGNBOTTOM = 64 +WVR_ALIGNRIGHT = 128 +WVR_HREDRAW = 256 +WVR_VREDRAW = 512 +WVR_REDRAW = WVR_HREDRAW | WVR_VREDRAW +WVR_VALIDRECTS = 1024 +MK_LBUTTON = 1 +MK_RBUTTON = 2 +MK_SHIFT = 4 +MK_CONTROL = 8 +MK_MBUTTON = 16 +TME_HOVER = 1 +TME_LEAVE = 2 +TME_QUERY = 1073741824 +TME_CANCEL = -2147483648 +HOVER_DEFAULT = -1 +WS_OVERLAPPED = 0 +WS_POPUP = -2147483648 +WS_CHILD = 1073741824 +WS_MINIMIZE = 536870912 +WS_VISIBLE = 268435456 +WS_DISABLED = 134217728 +WS_CLIPSIBLINGS = 67108864 +WS_CLIPCHILDREN = 33554432 +WS_MAXIMIZE = 16777216 +WS_CAPTION = 12582912 +WS_BORDER = 8388608 +WS_DLGFRAME = 4194304 +WS_VSCROLL = 2097152 +WS_HSCROLL = 1048576 +WS_SYSMENU = 524288 +WS_THICKFRAME = 262144 +WS_GROUP = 131072 +WS_TABSTOP = 65536 +WS_MINIMIZEBOX = 131072 +WS_MAXIMIZEBOX = 65536 +WS_TILED = WS_OVERLAPPED +WS_ICONIC = WS_MINIMIZE +WS_SIZEBOX = WS_THICKFRAME +WS_OVERLAPPEDWINDOW = ( + WS_OVERLAPPED + | WS_CAPTION + | WS_SYSMENU + | WS_THICKFRAME + | WS_MINIMIZEBOX + | WS_MAXIMIZEBOX +) +WS_POPUPWINDOW = WS_POPUP | WS_BORDER | WS_SYSMENU +WS_CHILDWINDOW = WS_CHILD +WS_TILEDWINDOW = WS_OVERLAPPEDWINDOW +WS_EX_DLGMODALFRAME = 1 +WS_EX_NOPARENTNOTIFY = 4 +WS_EX_TOPMOST = 8 +WS_EX_ACCEPTFILES = 16 +WS_EX_TRANSPARENT = 32 +WS_EX_MDICHILD = 64 +WS_EX_TOOLWINDOW = 128 +WS_EX_WINDOWEDGE = 256 +WS_EX_CLIENTEDGE = 512 +WS_EX_CONTEXTHELP = 1024 +WS_EX_RIGHT = 4096 +WS_EX_LEFT = 0 +WS_EX_RTLREADING = 8192 +WS_EX_LTRREADING = 0 +WS_EX_LEFTSCROLLBAR = 16384 +WS_EX_RIGHTSCROLLBAR = 0 +WS_EX_CONTROLPARENT = 65536 +WS_EX_STATICEDGE = 131072 +WS_EX_APPWINDOW = 262144 +WS_EX_OVERLAPPEDWINDOW = WS_EX_WINDOWEDGE | WS_EX_CLIENTEDGE +WS_EX_PALETTEWINDOW = WS_EX_WINDOWEDGE | WS_EX_TOOLWINDOW | WS_EX_TOPMOST +WS_EX_LAYERED = 0x00080000 +WS_EX_NOINHERITLAYOUT = 0x00100000 +WS_EX_LAYOUTRTL = 0x00400000 +WS_EX_COMPOSITED = 0x02000000 +WS_EX_NOACTIVATE = 0x08000000 + +CS_VREDRAW = 1 +CS_HREDRAW = 2 +# CS_KEYCVTWINDOW = 0x0004 +CS_DBLCLKS = 8 +CS_OWNDC = 32 +CS_CLASSDC = 64 +CS_PARENTDC = 128 +# CS_NOKEYCVT = 0x0100 +CS_NOCLOSE = 512 +CS_SAVEBITS = 2048 +CS_BYTEALIGNCLIENT = 4096 +CS_BYTEALIGNWINDOW = 8192 +CS_GLOBALCLASS = 16384 +CS_IME = 65536 +PRF_CHECKVISIBLE = 1 +PRF_NONCLIENT = 2 +PRF_CLIENT = 4 +PRF_ERASEBKGND = 8 +PRF_CHILDREN = 16 +PRF_OWNED = 32 +BDR_RAISEDOUTER = 1 +BDR_SUNKENOUTER = 2 +BDR_RAISEDINNER = 4 +BDR_SUNKENINNER = 8 +BDR_OUTER = 3 +BDR_INNER = 12 +# BDR_RAISED = 0x0005 +# BDR_SUNKEN = 0x000a +EDGE_RAISED = BDR_RAISEDOUTER | BDR_RAISEDINNER +EDGE_SUNKEN = BDR_SUNKENOUTER | BDR_SUNKENINNER +EDGE_ETCHED = BDR_SUNKENOUTER | BDR_RAISEDINNER +EDGE_BUMP = BDR_RAISEDOUTER | BDR_SUNKENINNER + +# winuser.h line 2879 +ISMEX_NOSEND = 0 +ISMEX_SEND = 1 +ISMEX_NOTIFY = 2 +ISMEX_CALLBACK = 4 +ISMEX_REPLIED = 8 +CW_USEDEFAULT = -2147483648 +FLASHW_STOP = 0 +FLASHW_CAPTION = 1 +FLASHW_TRAY = 2 +FLASHW_ALL = FLASHW_CAPTION | FLASHW_TRAY +FLASHW_TIMER = 4 +FLASHW_TIMERNOFG = 12 + +# winuser.h line 7963 +DS_ABSALIGN = 1 +DS_SYSMODAL = 2 +DS_LOCALEDIT = 32 +DS_SETFONT = 64 +DS_MODALFRAME = 128 +DS_NOIDLEMSG = 256 +DS_SETFOREGROUND = 512 +DS_3DLOOK = 4 +DS_FIXEDSYS = 8 +DS_NOFAILCREATE = 16 +DS_CONTROL = 1024 +DS_CENTER = 2048 +DS_CENTERMOUSE = 4096 +DS_CONTEXTHELP = 8192 +DM_GETDEFID = WM_USER + 0 +DM_SETDEFID = WM_USER + 1 +DM_REPOSITION = WM_USER + 2 +# PSM_PAGEINFO = (WM_USER+100) +# PSM_SHEETINFO = (WM_USER+101) +# PSI_SETACTIVE = 0x0001 +# PSI_KILLACTIVE = 0x0002 +# PSI_APPLY = 0x0003 +# PSI_RESET = 0x0004 +# PSI_HASHELP = 0x0005 +# PSI_HELP = 0x0006 +# PSI_CHANGED = 0x0001 +# PSI_GUISTART = 0x0002 +# PSI_REBOOT = 0x0003 +# PSI_GETSIBLINGS = 0x0004 +DC_HASDEFID = 21323 +DLGC_WANTARROWS = 1 +DLGC_WANTTAB = 2 +DLGC_WANTALLKEYS = 4 +DLGC_WANTMESSAGE = 4 +DLGC_HASSETSEL = 8 +DLGC_DEFPUSHBUTTON = 16 +DLGC_UNDEFPUSHBUTTON = 32 +DLGC_RADIOBUTTON = 64 +DLGC_WANTCHARS = 128 +DLGC_STATIC = 256 +DLGC_BUTTON = 8192 +LB_CTLCODE = 0 +LB_OKAY = 0 +LB_ERR = -1 +LB_ERRSPACE = -2 +LBN_ERRSPACE = -2 +LBN_SELCHANGE = 1 +LBN_DBLCLK = 2 +LBN_SELCANCEL = 3 +LBN_SETFOCUS = 4 +LBN_KILLFOCUS = 5 +LB_ADDSTRING = 384 +LB_INSERTSTRING = 385 +LB_DELETESTRING = 386 +LB_SELITEMRANGEEX = 387 +LB_RESETCONTENT = 388 +LB_SETSEL = 389 +LB_SETCURSEL = 390 +LB_GETSEL = 391 +LB_GETCURSEL = 392 +LB_GETTEXT = 393 +LB_GETTEXTLEN = 394 +LB_GETCOUNT = 395 +LB_SELECTSTRING = 396 +LB_DIR = 397 +LB_GETTOPINDEX = 398 +LB_FINDSTRING = 399 +LB_GETSELCOUNT = 400 +LB_GETSELITEMS = 401 +LB_SETTABSTOPS = 402 +LB_GETHORIZONTALEXTENT = 403 +LB_SETHORIZONTALEXTENT = 404 +LB_SETCOLUMNWIDTH = 405 +LB_ADDFILE = 406 +LB_SETTOPINDEX = 407 +LB_GETITEMRECT = 408 +LB_GETITEMDATA = 409 +LB_SETITEMDATA = 410 +LB_SELITEMRANGE = 411 +LB_SETANCHORINDEX = 412 +LB_GETANCHORINDEX = 413 +LB_SETCARETINDEX = 414 +LB_GETCARETINDEX = 415 +LB_SETITEMHEIGHT = 416 +LB_GETITEMHEIGHT = 417 +LB_FINDSTRINGEXACT = 418 +LB_SETLOCALE = 421 +LB_GETLOCALE = 422 +LB_SETCOUNT = 423 +LB_INITSTORAGE = 424 +LB_ITEMFROMPOINT = 425 +LB_MSGMAX = 432 +LBS_NOTIFY = 1 +LBS_SORT = 2 +LBS_NOREDRAW = 4 +LBS_MULTIPLESEL = 8 +LBS_OWNERDRAWFIXED = 16 +LBS_OWNERDRAWVARIABLE = 32 +LBS_HASSTRINGS = 64 +LBS_USETABSTOPS = 128 +LBS_NOINTEGRALHEIGHT = 256 +LBS_MULTICOLUMN = 512 +LBS_WANTKEYBOARDINPUT = 1024 +LBS_EXTENDEDSEL = 2048 +LBS_DISABLENOSCROLL = 4096 +LBS_NODATA = 8192 +LBS_NOSEL = 16384 +LBS_STANDARD = LBS_NOTIFY | LBS_SORT | WS_VSCROLL | WS_BORDER +CB_OKAY = 0 +CB_ERR = -1 +CB_ERRSPACE = -2 +CBN_ERRSPACE = -1 +CBN_SELCHANGE = 1 +CBN_DBLCLK = 2 +CBN_SETFOCUS = 3 +CBN_KILLFOCUS = 4 +CBN_EDITCHANGE = 5 +CBN_EDITUPDATE = 6 +CBN_DROPDOWN = 7 +CBN_CLOSEUP = 8 +CBN_SELENDOK = 9 +CBN_SELENDCANCEL = 10 +CBS_SIMPLE = 1 +CBS_DROPDOWN = 2 +CBS_DROPDOWNLIST = 3 +CBS_OWNERDRAWFIXED = 16 +CBS_OWNERDRAWVARIABLE = 32 +CBS_AUTOHSCROLL = 64 +CBS_OEMCONVERT = 128 +CBS_SORT = 256 +CBS_HASSTRINGS = 512 +CBS_NOINTEGRALHEIGHT = 1024 +CBS_DISABLENOSCROLL = 2048 +CBS_UPPERCASE = 8192 +CBS_LOWERCASE = 16384 +CB_GETEDITSEL = 320 +CB_LIMITTEXT = 321 +CB_SETEDITSEL = 322 +CB_ADDSTRING = 323 +CB_DELETESTRING = 324 +CB_DIR = 325 +CB_GETCOUNT = 326 +CB_GETCURSEL = 327 +CB_GETLBTEXT = 328 +CB_GETLBTEXTLEN = 329 +CB_INSERTSTRING = 330 +CB_RESETCONTENT = 331 +CB_FINDSTRING = 332 +CB_SELECTSTRING = 333 +CB_SETCURSEL = 334 +CB_SHOWDROPDOWN = 335 +CB_GETITEMDATA = 336 +CB_SETITEMDATA = 337 +CB_GETDROPPEDCONTROLRECT = 338 +CB_SETITEMHEIGHT = 339 +CB_GETITEMHEIGHT = 340 +CB_SETEXTENDEDUI = 341 +CB_GETEXTENDEDUI = 342 +CB_GETDROPPEDSTATE = 343 +CB_FINDSTRINGEXACT = 344 +CB_SETLOCALE = 345 +CB_GETLOCALE = 346 +CB_GETTOPINDEX = 347 +CB_SETTOPINDEX = 348 +CB_GETHORIZONTALEXTENT = 349 +CB_SETHORIZONTALEXTENT = 350 +CB_GETDROPPEDWIDTH = 351 +CB_SETDROPPEDWIDTH = 352 +CB_INITSTORAGE = 353 +CB_MSGMAX = 354 +SBS_HORZ = 0 +SBS_VERT = 1 +SBS_TOPALIGN = 2 +SBS_LEFTALIGN = 2 +SBS_BOTTOMALIGN = 4 +SBS_RIGHTALIGN = 4 +SBS_SIZEBOXTOPLEFTALIGN = 2 +SBS_SIZEBOXBOTTOMRIGHTALIGN = 4 +SBS_SIZEBOX = 8 +SBS_SIZEGRIP = 16 +SBM_SETPOS = 224 +SBM_GETPOS = 225 +SBM_SETRANGE = 226 +SBM_SETRANGEREDRAW = 230 +SBM_GETRANGE = 227 +SBM_ENABLE_ARROWS = 228 +SBM_SETSCROLLINFO = 233 +SBM_GETSCROLLINFO = 234 +SIF_RANGE = 1 +SIF_PAGE = 2 +SIF_POS = 4 +SIF_DISABLENOSCROLL = 8 +SIF_TRACKPOS = 16 +SIF_ALL = SIF_RANGE | SIF_PAGE | SIF_POS | SIF_TRACKPOS +MDIS_ALLCHILDSTYLES = 1 +MDITILE_VERTICAL = 0 +MDITILE_HORIZONTAL = 1 +MDITILE_SKIPDISABLED = 2 +MDITILE_ZORDER = 4 + +IMC_GETCANDIDATEPOS = 7 +IMC_SETCANDIDATEPOS = 8 +IMC_GETCOMPOSITIONFONT = 9 +IMC_SETCOMPOSITIONFONT = 10 +IMC_GETCOMPOSITIONWINDOW = 11 +IMC_SETCOMPOSITIONWINDOW = 12 +IMC_GETSTATUSWINDOWPOS = 15 +IMC_SETSTATUSWINDOWPOS = 16 +IMC_CLOSESTATUSWINDOW = 33 +IMC_OPENSTATUSWINDOW = 34 +# Generated by h2py from \msvc20\include\winnt.h +# hacked and split by mhammond. +DELETE = 65536 +READ_CONTROL = 131072 +WRITE_DAC = 262144 +WRITE_OWNER = 524288 +SYNCHRONIZE = 1048576 +STANDARD_RIGHTS_REQUIRED = 983040 +STANDARD_RIGHTS_READ = READ_CONTROL +STANDARD_RIGHTS_WRITE = READ_CONTROL +STANDARD_RIGHTS_EXECUTE = READ_CONTROL +STANDARD_RIGHTS_ALL = 2031616 +SPECIFIC_RIGHTS_ALL = 65535 +ACCESS_SYSTEM_SECURITY = 16777216 +MAXIMUM_ALLOWED = 33554432 +GENERIC_READ = -2147483648 +GENERIC_WRITE = 1073741824 +GENERIC_EXECUTE = 536870912 +GENERIC_ALL = 268435456 + +SERVICE_KERNEL_DRIVER = 1 +SERVICE_FILE_SYSTEM_DRIVER = 2 +SERVICE_ADAPTER = 4 +SERVICE_RECOGNIZER_DRIVER = 8 +SERVICE_DRIVER = ( + SERVICE_KERNEL_DRIVER | SERVICE_FILE_SYSTEM_DRIVER | SERVICE_RECOGNIZER_DRIVER +) +SERVICE_WIN32_OWN_PROCESS = 16 +SERVICE_WIN32_SHARE_PROCESS = 32 +SERVICE_WIN32 = SERVICE_WIN32_OWN_PROCESS | SERVICE_WIN32_SHARE_PROCESS +SERVICE_INTERACTIVE_PROCESS = 256 +SERVICE_TYPE_ALL = ( + SERVICE_WIN32 | SERVICE_ADAPTER | SERVICE_DRIVER | SERVICE_INTERACTIVE_PROCESS +) +SERVICE_BOOT_START = 0 +SERVICE_SYSTEM_START = 1 +SERVICE_AUTO_START = 2 +SERVICE_DEMAND_START = 3 +SERVICE_DISABLED = 4 +SERVICE_ERROR_IGNORE = 0 +SERVICE_ERROR_NORMAL = 1 +SERVICE_ERROR_SEVERE = 2 +SERVICE_ERROR_CRITICAL = 3 +TAPE_ERASE_SHORT = 0 +TAPE_ERASE_LONG = 1 +TAPE_LOAD = 0 +TAPE_UNLOAD = 1 +TAPE_TENSION = 2 +TAPE_LOCK = 3 +TAPE_UNLOCK = 4 +TAPE_FORMAT = 5 +TAPE_SETMARKS = 0 +TAPE_FILEMARKS = 1 +TAPE_SHORT_FILEMARKS = 2 +TAPE_LONG_FILEMARKS = 3 +TAPE_ABSOLUTE_POSITION = 0 +TAPE_LOGICAL_POSITION = 1 +TAPE_PSEUDO_LOGICAL_POSITION = 2 +TAPE_REWIND = 0 +TAPE_ABSOLUTE_BLOCK = 1 +TAPE_LOGICAL_BLOCK = 2 +TAPE_PSEUDO_LOGICAL_BLOCK = 3 +TAPE_SPACE_END_OF_DATA = 4 +TAPE_SPACE_RELATIVE_BLOCKS = 5 +TAPE_SPACE_FILEMARKS = 6 +TAPE_SPACE_SEQUENTIAL_FMKS = 7 +TAPE_SPACE_SETMARKS = 8 +TAPE_SPACE_SEQUENTIAL_SMKS = 9 +TAPE_DRIVE_FIXED = 1 +TAPE_DRIVE_SELECT = 2 +TAPE_DRIVE_INITIATOR = 4 +TAPE_DRIVE_ERASE_SHORT = 16 +TAPE_DRIVE_ERASE_LONG = 32 +TAPE_DRIVE_ERASE_BOP_ONLY = 64 +TAPE_DRIVE_ERASE_IMMEDIATE = 128 +TAPE_DRIVE_TAPE_CAPACITY = 256 +TAPE_DRIVE_TAPE_REMAINING = 512 +TAPE_DRIVE_FIXED_BLOCK = 1024 +TAPE_DRIVE_VARIABLE_BLOCK = 2048 +TAPE_DRIVE_WRITE_PROTECT = 4096 +TAPE_DRIVE_EOT_WZ_SIZE = 8192 +TAPE_DRIVE_ECC = 65536 +TAPE_DRIVE_COMPRESSION = 131072 +TAPE_DRIVE_PADDING = 262144 +TAPE_DRIVE_REPORT_SMKS = 524288 +TAPE_DRIVE_GET_ABSOLUTE_BLK = 1048576 +TAPE_DRIVE_GET_LOGICAL_BLK = 2097152 +TAPE_DRIVE_SET_EOT_WZ_SIZE = 4194304 +TAPE_DRIVE_LOAD_UNLOAD = -2147483647 +TAPE_DRIVE_TENSION = -2147483646 +TAPE_DRIVE_LOCK_UNLOCK = -2147483644 +TAPE_DRIVE_REWIND_IMMEDIATE = -2147483640 +TAPE_DRIVE_SET_BLOCK_SIZE = -2147483632 +TAPE_DRIVE_LOAD_UNLD_IMMED = -2147483616 +TAPE_DRIVE_TENSION_IMMED = -2147483584 +TAPE_DRIVE_LOCK_UNLK_IMMED = -2147483520 +TAPE_DRIVE_SET_ECC = -2147483392 +TAPE_DRIVE_SET_COMPRESSION = -2147483136 +TAPE_DRIVE_SET_PADDING = -2147482624 +TAPE_DRIVE_SET_REPORT_SMKS = -2147481600 +TAPE_DRIVE_ABSOLUTE_BLK = -2147479552 +TAPE_DRIVE_ABS_BLK_IMMED = -2147475456 +TAPE_DRIVE_LOGICAL_BLK = -2147467264 +TAPE_DRIVE_LOG_BLK_IMMED = -2147450880 +TAPE_DRIVE_END_OF_DATA = -2147418112 +TAPE_DRIVE_RELATIVE_BLKS = -2147352576 +TAPE_DRIVE_FILEMARKS = -2147221504 +TAPE_DRIVE_SEQUENTIAL_FMKS = -2146959360 +TAPE_DRIVE_SETMARKS = -2146435072 +TAPE_DRIVE_SEQUENTIAL_SMKS = -2145386496 +TAPE_DRIVE_REVERSE_POSITION = -2143289344 +TAPE_DRIVE_SPACE_IMMEDIATE = -2139095040 +TAPE_DRIVE_WRITE_SETMARKS = -2130706432 +TAPE_DRIVE_WRITE_FILEMARKS = -2113929216 +TAPE_DRIVE_WRITE_SHORT_FMKS = -2080374784 +TAPE_DRIVE_WRITE_LONG_FMKS = -2013265920 +TAPE_DRIVE_WRITE_MARK_IMMED = -1879048192 +TAPE_DRIVE_FORMAT = -1610612736 +TAPE_DRIVE_FORMAT_IMMEDIATE = -1073741824 +TAPE_FIXED_PARTITIONS = 0 +TAPE_SELECT_PARTITIONS = 1 +TAPE_INITIATOR_PARTITIONS = 2 +# Generated by h2py from \msvc20\include\winnt.h +# hacked and split by mhammond. + +APPLICATION_ERROR_MASK = 536870912 +ERROR_SEVERITY_SUCCESS = 0 +ERROR_SEVERITY_INFORMATIONAL = 1073741824 +ERROR_SEVERITY_WARNING = -2147483648 +ERROR_SEVERITY_ERROR = -1073741824 +MINCHAR = 128 +MAXCHAR = 127 +MINSHORT = 32768 +MAXSHORT = 32767 +MINLONG = -2147483648 +MAXLONG = 2147483647 +MAXBYTE = 255 +MAXWORD = 65535 +MAXDWORD = -1 +LANG_NEUTRAL = 0 +LANG_BULGARIAN = 2 +LANG_CHINESE = 4 +LANG_CROATIAN = 26 +LANG_CZECH = 5 +LANG_DANISH = 6 +LANG_DUTCH = 19 +LANG_ENGLISH = 9 +LANG_FINNISH = 11 +LANG_FRENCH = 12 +LANG_GERMAN = 7 +LANG_GREEK = 8 +LANG_HUNGARIAN = 14 +LANG_ICELANDIC = 15 +LANG_ITALIAN = 16 +LANG_JAPANESE = 17 +LANG_KOREAN = 18 +LANG_NORWEGIAN = 20 +LANG_POLISH = 21 +LANG_PORTUGUESE = 22 +LANG_ROMANIAN = 24 +LANG_RUSSIAN = 25 +LANG_SLOVAK = 27 +LANG_SLOVENIAN = 36 +LANG_SPANISH = 10 +LANG_SWEDISH = 29 +LANG_TURKISH = 31 +SUBLANG_NEUTRAL = 0 +SUBLANG_DEFAULT = 1 +SUBLANG_SYS_DEFAULT = 2 +SUBLANG_CHINESE_TRADITIONAL = 1 +SUBLANG_CHINESE_SIMPLIFIED = 2 +SUBLANG_CHINESE_HONGKONG = 3 +SUBLANG_CHINESE_SINGAPORE = 4 +SUBLANG_DUTCH = 1 +SUBLANG_DUTCH_BELGIAN = 2 +SUBLANG_ENGLISH_US = 1 +SUBLANG_ENGLISH_UK = 2 +SUBLANG_ENGLISH_AUS = 3 +SUBLANG_ENGLISH_CAN = 4 +SUBLANG_ENGLISH_NZ = 5 +SUBLANG_ENGLISH_EIRE = 6 +SUBLANG_FRENCH = 1 +SUBLANG_FRENCH_BELGIAN = 2 +SUBLANG_FRENCH_CANADIAN = 3 +SUBLANG_FRENCH_SWISS = 4 +SUBLANG_GERMAN = 1 +SUBLANG_GERMAN_SWISS = 2 +SUBLANG_GERMAN_AUSTRIAN = 3 +SUBLANG_ITALIAN = 1 +SUBLANG_ITALIAN_SWISS = 2 +SUBLANG_NORWEGIAN_BOKMAL = 1 +SUBLANG_NORWEGIAN_NYNORSK = 2 +SUBLANG_PORTUGUESE = 2 +SUBLANG_PORTUGUESE_BRAZILIAN = 1 +SUBLANG_SPANISH = 1 +SUBLANG_SPANISH_MEXICAN = 2 +SUBLANG_SPANISH_MODERN = 3 +SORT_DEFAULT = 0 +SORT_JAPANESE_XJIS = 0 +SORT_JAPANESE_UNICODE = 1 +SORT_CHINESE_BIG5 = 0 +SORT_CHINESE_UNICODE = 1 +SORT_KOREAN_KSC = 0 +SORT_KOREAN_UNICODE = 1 + + +def PRIMARYLANGID(lgid): + return (lgid) & 1023 + + +def SUBLANGID(lgid): + return (lgid) >> 10 + + +NLS_VALID_LOCALE_MASK = 1048575 +CONTEXT_PORTABLE_32BIT = 1048576 +CONTEXT_ALPHA = 131072 +CONTEXT_CONTROL = CONTEXT_ALPHA | 1 +CONTEXT_FLOATING_POINT = CONTEXT_ALPHA | 2 +CONTEXT_INTEGER = CONTEXT_ALPHA | 4 +CONTEXT_FULL = CONTEXT_CONTROL | CONTEXT_FLOATING_POINT | CONTEXT_INTEGER +SIZE_OF_80387_REGISTERS = 80 +CONTEXT_FULL = CONTEXT_CONTROL | CONTEXT_FLOATING_POINT | CONTEXT_INTEGER +CONTEXT_CONTROL = 1 +CONTEXT_FLOATING_POINT = 2 +CONTEXT_INTEGER = 4 +CONTEXT_FULL = CONTEXT_CONTROL | CONTEXT_FLOATING_POINT | CONTEXT_INTEGER +PROCESS_TERMINATE = 1 +PROCESS_CREATE_THREAD = 2 +PROCESS_VM_OPERATION = 8 +PROCESS_VM_READ = 16 +PROCESS_VM_WRITE = 32 +PROCESS_DUP_HANDLE = 64 +PROCESS_CREATE_PROCESS = 128 +PROCESS_SET_QUOTA = 256 +PROCESS_SET_INFORMATION = 512 +PROCESS_QUERY_INFORMATION = 1024 +PROCESS_SUSPEND_RESUME = 2048 +PROCESS_QUERY_LIMITED_INFORMATION = 4096 +PROCESS_SET_LIMITED_INFORMATION = 8192 +PROCESS_ALL_ACCESS = STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 4095 +THREAD_TERMINATE = 1 +THREAD_SUSPEND_RESUME = 2 +THREAD_GET_CONTEXT = 8 +THREAD_SET_CONTEXT = 16 +THREAD_SET_INFORMATION = 32 +THREAD_QUERY_INFORMATION = 64 +THREAD_SET_THREAD_TOKEN = 128 +THREAD_IMPERSONATE = 256 +THREAD_DIRECT_IMPERSONATION = 512 +THREAD_SET_LIMITED_INFORMATION = 1024 +THREAD_QUERY_LIMITED_INFORMATION = 2048 +THREAD_RESUME = 4096 +TLS_MINIMUM_AVAILABLE = 64 +EVENT_MODIFY_STATE = 2 +MUTANT_QUERY_STATE = 1 +SEMAPHORE_MODIFY_STATE = 2 +TIME_ZONE_ID_UNKNOWN = 0 +TIME_ZONE_ID_STANDARD = 1 +TIME_ZONE_ID_DAYLIGHT = 2 +PROCESSOR_INTEL_386 = 386 +PROCESSOR_INTEL_486 = 486 +PROCESSOR_INTEL_PENTIUM = 586 +PROCESSOR_INTEL_860 = 860 +PROCESSOR_MIPS_R2000 = 2000 +PROCESSOR_MIPS_R3000 = 3000 +PROCESSOR_MIPS_R4000 = 4000 +PROCESSOR_ALPHA_21064 = 21064 +PROCESSOR_PPC_601 = 601 +PROCESSOR_PPC_603 = 603 +PROCESSOR_PPC_604 = 604 +PROCESSOR_PPC_620 = 620 +SECTION_QUERY = 1 +SECTION_MAP_WRITE = 2 +SECTION_MAP_READ = 4 +SECTION_MAP_EXECUTE = 8 +SECTION_EXTEND_SIZE = 16 +PAGE_NOACCESS = 1 +PAGE_READONLY = 2 +PAGE_READWRITE = 4 +PAGE_WRITECOPY = 8 +PAGE_EXECUTE = 16 +PAGE_EXECUTE_READ = 32 +PAGE_EXECUTE_READWRITE = 64 +PAGE_EXECUTE_WRITECOPY = 128 +PAGE_GUARD = 256 +PAGE_NOCACHE = 512 +MEM_COMMIT = 4096 +MEM_RESERVE = 8192 +MEM_DECOMMIT = 16384 +MEM_RELEASE = 32768 +MEM_FREE = 65536 +MEM_PRIVATE = 131072 +MEM_MAPPED = 262144 +MEM_TOP_DOWN = 1048576 + +# Generated by h2py from \msvc20\include\winnt.h +# hacked and split by mhammond. +SEC_FILE = 8388608 +SEC_IMAGE = 16777216 +SEC_RESERVE = 67108864 +SEC_COMMIT = 134217728 +SEC_NOCACHE = 268435456 +MEM_IMAGE = SEC_IMAGE +FILE_SHARE_READ = 1 +FILE_SHARE_WRITE = 2 +FILE_SHARE_DELETE = 4 +FILE_ATTRIBUTE_READONLY = 1 +FILE_ATTRIBUTE_HIDDEN = 2 +FILE_ATTRIBUTE_SYSTEM = 4 +FILE_ATTRIBUTE_DIRECTORY = 16 +FILE_ATTRIBUTE_ARCHIVE = 32 +FILE_ATTRIBUTE_DEVICE = 64 +FILE_ATTRIBUTE_NORMAL = 128 +FILE_ATTRIBUTE_TEMPORARY = 256 +FILE_ATTRIBUTE_SPARSE_FILE = 512 +FILE_ATTRIBUTE_REPARSE_POINT = 1024 +FILE_ATTRIBUTE_COMPRESSED = 2048 +FILE_ATTRIBUTE_OFFLINE = 4096 +FILE_ATTRIBUTE_NOT_CONTENT_INDEXED = 8192 +FILE_ATTRIBUTE_ENCRYPTED = 16384 +FILE_ATTRIBUTE_VIRTUAL = 65536 +# These FILE_ATTRIBUTE_* flags are apparently old definitions from Windows 95 +# and conflict with current values above - but they live on for b/w compat... +FILE_ATTRIBUTE_ATOMIC_WRITE = 512 +FILE_ATTRIBUTE_XACTION_WRITE = 1024 + +FILE_NOTIFY_CHANGE_FILE_NAME = 1 +FILE_NOTIFY_CHANGE_DIR_NAME = 2 +FILE_NOTIFY_CHANGE_ATTRIBUTES = 4 +FILE_NOTIFY_CHANGE_SIZE = 8 +FILE_NOTIFY_CHANGE_LAST_WRITE = 16 +FILE_NOTIFY_CHANGE_SECURITY = 256 +FILE_CASE_SENSITIVE_SEARCH = 1 +FILE_CASE_PRESERVED_NAMES = 2 +FILE_UNICODE_ON_DISK = 4 +FILE_PERSISTENT_ACLS = 8 +FILE_FILE_COMPRESSION = 16 +FILE_NAMED_STREAMS = 262144 +FILE_PERSISTENT_ACLS = 0x00000008 +FILE_READ_ONLY_VOLUME = 0x00080000 +FILE_SEQUENTIAL_WRITE_ONCE = 0x00100000 +FILE_SUPPORTS_ENCRYPTION = 0x00020000 +FILE_SUPPORTS_EXTENDED_ATTRIBUTES = 0x00800000 +FILE_SUPPORTS_HARD_LINKS = 0x00400000 +FILE_SUPPORTS_OBJECT_IDS = 0x00010000 +FILE_SUPPORTS_OPEN_BY_FILE_ID = 0x01000000 +FILE_SUPPORTS_REPARSE_POINTS = 0x00000080 +FILE_SUPPORTS_SPARSE_FILES = 0x00000040 +FILE_SUPPORTS_TRANSACTIONS = 0x00200000 +FILE_SUPPORTS_USN_JOURNAL = 0x02000000 +FILE_UNICODE_ON_DISK = 0x00000004 +FILE_VOLUME_IS_COMPRESSED = 0x00008000 +FILE_VOLUME_QUOTAS = 0x00000020 +FILE_VOLUME_IS_COMPRESSED = 32768 +IO_COMPLETION_MODIFY_STATE = 2 +DUPLICATE_CLOSE_SOURCE = 1 +DUPLICATE_SAME_ACCESS = 2 +SID_MAX_SUB_AUTHORITIES = 15 +SECURITY_NULL_RID = 0 +SECURITY_WORLD_RID = 0 +SECURITY_LOCAL_RID = 0x00000000 +SECURITY_CREATOR_OWNER_RID = 0 +SECURITY_CREATOR_GROUP_RID = 1 +SECURITY_DIALUP_RID = 1 +SECURITY_NETWORK_RID = 2 +SECURITY_BATCH_RID = 3 +SECURITY_INTERACTIVE_RID = 4 +SECURITY_SERVICE_RID = 6 +SECURITY_ANONYMOUS_LOGON_RID = 7 +SECURITY_LOGON_IDS_RID = 5 +SECURITY_LOGON_IDS_RID_COUNT = 3 +SECURITY_LOCAL_SYSTEM_RID = 18 +SECURITY_NT_NON_UNIQUE = 21 +SECURITY_BUILTIN_DOMAIN_RID = 32 +DOMAIN_USER_RID_ADMIN = 500 +DOMAIN_USER_RID_GUEST = 501 +DOMAIN_GROUP_RID_ADMINS = 512 +DOMAIN_GROUP_RID_USERS = 513 +DOMAIN_GROUP_RID_GUESTS = 514 +DOMAIN_ALIAS_RID_ADMINS = 544 +DOMAIN_ALIAS_RID_USERS = 545 +DOMAIN_ALIAS_RID_GUESTS = 546 +DOMAIN_ALIAS_RID_POWER_USERS = 547 +DOMAIN_ALIAS_RID_ACCOUNT_OPS = 548 +DOMAIN_ALIAS_RID_SYSTEM_OPS = 549 +DOMAIN_ALIAS_RID_PRINT_OPS = 550 +DOMAIN_ALIAS_RID_BACKUP_OPS = 551 +DOMAIN_ALIAS_RID_REPLICATOR = 552 +SE_GROUP_MANDATORY = 1 +SE_GROUP_ENABLED_BY_DEFAULT = 2 +SE_GROUP_ENABLED = 4 +SE_GROUP_OWNER = 8 +SE_GROUP_LOGON_ID = -1073741824 +ACL_REVISION = 2 +ACL_REVISION1 = 1 +ACL_REVISION2 = 2 +ACCESS_ALLOWED_ACE_TYPE = 0 +ACCESS_DENIED_ACE_TYPE = 1 +SYSTEM_AUDIT_ACE_TYPE = 2 +SYSTEM_ALARM_ACE_TYPE = 3 +OBJECT_INHERIT_ACE = 1 +CONTAINER_INHERIT_ACE = 2 +NO_PROPAGATE_INHERIT_ACE = 4 +INHERIT_ONLY_ACE = 8 +VALID_INHERIT_FLAGS = 15 +SUCCESSFUL_ACCESS_ACE_FLAG = 64 +FAILED_ACCESS_ACE_FLAG = 128 +SECURITY_DESCRIPTOR_REVISION = 1 +SECURITY_DESCRIPTOR_REVISION1 = 1 +SECURITY_DESCRIPTOR_MIN_LENGTH = 20 +SE_OWNER_DEFAULTED = 1 +SE_GROUP_DEFAULTED = 2 +SE_DACL_PRESENT = 4 +SE_DACL_DEFAULTED = 8 +SE_SACL_PRESENT = 16 +SE_SACL_DEFAULTED = 32 +SE_SELF_RELATIVE = 32768 +SE_PRIVILEGE_ENABLED_BY_DEFAULT = 1 +SE_PRIVILEGE_ENABLED = 2 +SE_PRIVILEGE_USED_FOR_ACCESS = -2147483648 +PRIVILEGE_SET_ALL_NECESSARY = 1 +SE_CREATE_TOKEN_NAME = "SeCreateTokenPrivilege" +SE_ASSIGNPRIMARYTOKEN_NAME = "SeAssignPrimaryTokenPrivilege" +SE_LOCK_MEMORY_NAME = "SeLockMemoryPrivilege" +SE_INCREASE_QUOTA_NAME = "SeIncreaseQuotaPrivilege" +SE_UNSOLICITED_INPUT_NAME = "SeUnsolicitedInputPrivilege" +SE_MACHINE_ACCOUNT_NAME = "SeMachineAccountPrivilege" +SE_TCB_NAME = "SeTcbPrivilege" +SE_SECURITY_NAME = "SeSecurityPrivilege" +SE_TAKE_OWNERSHIP_NAME = "SeTakeOwnershipPrivilege" +SE_LOAD_DRIVER_NAME = "SeLoadDriverPrivilege" +SE_SYSTEM_PROFILE_NAME = "SeSystemProfilePrivilege" +SE_SYSTEMTIME_NAME = "SeSystemtimePrivilege" +SE_PROF_SINGLE_PROCESS_NAME = "SeProfileSingleProcessPrivilege" +SE_INC_BASE_PRIORITY_NAME = "SeIncreaseBasePriorityPrivilege" +SE_CREATE_PAGEFILE_NAME = "SeCreatePagefilePrivilege" +SE_CREATE_PERMANENT_NAME = "SeCreatePermanentPrivilege" +SE_BACKUP_NAME = "SeBackupPrivilege" +SE_RESTORE_NAME = "SeRestorePrivilege" +SE_SHUTDOWN_NAME = "SeShutdownPrivilege" +SE_DEBUG_NAME = "SeDebugPrivilege" +SE_AUDIT_NAME = "SeAuditPrivilege" +SE_SYSTEM_ENVIRONMENT_NAME = "SeSystemEnvironmentPrivilege" +SE_CHANGE_NOTIFY_NAME = "SeChangeNotifyPrivilege" +SE_REMOTE_SHUTDOWN_NAME = "SeRemoteShutdownPrivilege" + +TOKEN_ASSIGN_PRIMARY = 1 +TOKEN_DUPLICATE = 2 +TOKEN_IMPERSONATE = 4 +TOKEN_QUERY = 8 +TOKEN_QUERY_SOURCE = 16 +TOKEN_ADJUST_PRIVILEGES = 32 +TOKEN_ADJUST_GROUPS = 64 +TOKEN_ADJUST_DEFAULT = 128 +TOKEN_ADJUST_SESSIONID = 256 +TOKEN_ALL_ACCESS = ( + STANDARD_RIGHTS_REQUIRED + | TOKEN_ASSIGN_PRIMARY + | TOKEN_DUPLICATE + | TOKEN_IMPERSONATE + | TOKEN_QUERY + | TOKEN_QUERY_SOURCE + | TOKEN_ADJUST_PRIVILEGES + | TOKEN_ADJUST_GROUPS + | TOKEN_ADJUST_DEFAULT + | TOKEN_ADJUST_SESSIONID +) +TOKEN_READ = STANDARD_RIGHTS_READ | TOKEN_QUERY +TOKEN_WRITE = ( + STANDARD_RIGHTS_WRITE + | TOKEN_ADJUST_PRIVILEGES + | TOKEN_ADJUST_GROUPS + | TOKEN_ADJUST_DEFAULT +) +TOKEN_EXECUTE = STANDARD_RIGHTS_EXECUTE +TOKEN_SOURCE_LENGTH = 8 + +KEY_QUERY_VALUE = 1 +KEY_SET_VALUE = 2 +KEY_CREATE_SUB_KEY = 4 +KEY_ENUMERATE_SUB_KEYS = 8 +KEY_NOTIFY = 16 +KEY_CREATE_LINK = 32 +KEY_WOW64_32KEY = 512 +KEY_WOW64_64KEY = 256 +KEY_WOW64_RES = 768 +KEY_READ = ( + STANDARD_RIGHTS_READ | KEY_QUERY_VALUE | KEY_ENUMERATE_SUB_KEYS | KEY_NOTIFY +) & (~SYNCHRONIZE) +KEY_WRITE = (STANDARD_RIGHTS_WRITE | KEY_SET_VALUE | KEY_CREATE_SUB_KEY) & ( + ~SYNCHRONIZE +) +KEY_EXECUTE = (KEY_READ) & (~SYNCHRONIZE) +KEY_ALL_ACCESS = ( + STANDARD_RIGHTS_ALL + | KEY_QUERY_VALUE + | KEY_SET_VALUE + | KEY_CREATE_SUB_KEY + | KEY_ENUMERATE_SUB_KEYS + | KEY_NOTIFY + | KEY_CREATE_LINK +) & (~SYNCHRONIZE) +REG_NOTIFY_CHANGE_ATTRIBUTES = 2 +REG_NOTIFY_CHANGE_SECURITY = 8 +REG_RESOURCE_REQUIREMENTS_LIST = 10 +REG_NONE = 0 # No value type +REG_SZ = 1 # Unicode nul terminated string +REG_EXPAND_SZ = 2 # Unicode nul terminated string +# (with environment variable references) +REG_BINARY = 3 # Free form binary +REG_DWORD = 4 # 32-bit number +REG_DWORD_LITTLE_ENDIAN = 4 # 32-bit number (same as REG_DWORD) +REG_DWORD_BIG_ENDIAN = 5 # 32-bit number +REG_LINK = 6 # Symbolic Link (unicode) +REG_MULTI_SZ = 7 # Multiple Unicode strings +REG_RESOURCE_LIST = 8 # Resource list in the resource map +REG_FULL_RESOURCE_DESCRIPTOR = 9 # Resource list in the hardware description +REG_RESOURCE_REQUIREMENTS_LIST = 10 +REG_QWORD = 11 # 64-bit number +REG_QWORD_LITTLE_ENDIAN = 11 # 64-bit number (same as REG_QWORD) + + +# Generated by h2py from \msvc20\include\winnt.h +# hacked and split by mhammond. +# Included from string.h +_NLSCMPERROR = 2147483647 +NULL = 0 +HEAP_NO_SERIALIZE = 1 +HEAP_GROWABLE = 2 +HEAP_GENERATE_EXCEPTIONS = 4 +HEAP_ZERO_MEMORY = 8 +HEAP_REALLOC_IN_PLACE_ONLY = 16 +HEAP_TAIL_CHECKING_ENABLED = 32 +HEAP_FREE_CHECKING_ENABLED = 64 +HEAP_DISABLE_COALESCE_ON_FREE = 128 +IS_TEXT_UNICODE_ASCII16 = 1 +IS_TEXT_UNICODE_REVERSE_ASCII16 = 16 +IS_TEXT_UNICODE_STATISTICS = 2 +IS_TEXT_UNICODE_REVERSE_STATISTICS = 32 +IS_TEXT_UNICODE_CONTROLS = 4 +IS_TEXT_UNICODE_REVERSE_CONTROLS = 64 +IS_TEXT_UNICODE_SIGNATURE = 8 +IS_TEXT_UNICODE_REVERSE_SIGNATURE = 128 +IS_TEXT_UNICODE_ILLEGAL_CHARS = 256 +IS_TEXT_UNICODE_ODD_LENGTH = 512 +IS_TEXT_UNICODE_DBCS_LEADBYTE = 1024 +IS_TEXT_UNICODE_NULL_BYTES = 4096 +IS_TEXT_UNICODE_UNICODE_MASK = 15 +IS_TEXT_UNICODE_REVERSE_MASK = 240 +IS_TEXT_UNICODE_NOT_UNICODE_MASK = 3840 +IS_TEXT_UNICODE_NOT_ASCII_MASK = 61440 +COMPRESSION_FORMAT_NONE = 0 +COMPRESSION_FORMAT_DEFAULT = 1 +COMPRESSION_FORMAT_LZNT1 = 2 +COMPRESSION_ENGINE_STANDARD = 0 +COMPRESSION_ENGINE_MAXIMUM = 256 +MESSAGE_RESOURCE_UNICODE = 1 +RTL_CRITSECT_TYPE = 0 +RTL_RESOURCE_TYPE = 1 +DLL_PROCESS_ATTACH = 1 +DLL_THREAD_ATTACH = 2 +DLL_THREAD_DETACH = 3 +DLL_PROCESS_DETACH = 0 +EVENTLOG_SEQUENTIAL_READ = 0x0001 +EVENTLOG_SEEK_READ = 0x0002 +EVENTLOG_FORWARDS_READ = 0x0004 +EVENTLOG_BACKWARDS_READ = 0x0008 +EVENTLOG_SUCCESS = 0x0000 +EVENTLOG_ERROR_TYPE = 1 +EVENTLOG_WARNING_TYPE = 2 +EVENTLOG_INFORMATION_TYPE = 4 +EVENTLOG_AUDIT_SUCCESS = 8 +EVENTLOG_AUDIT_FAILURE = 16 +EVENTLOG_START_PAIRED_EVENT = 1 +EVENTLOG_END_PAIRED_EVENT = 2 +EVENTLOG_END_ALL_PAIRED_EVENTS = 4 +EVENTLOG_PAIRED_EVENT_ACTIVE = 8 +EVENTLOG_PAIRED_EVENT_INACTIVE = 16 +# Generated by h2py from \msvc20\include\winnt.h +# hacked and split by mhammond. +OWNER_SECURITY_INFORMATION = 0x00000001 +GROUP_SECURITY_INFORMATION = 0x00000002 +DACL_SECURITY_INFORMATION = 0x00000004 +SACL_SECURITY_INFORMATION = 0x00000008 +IMAGE_SIZEOF_FILE_HEADER = 20 +IMAGE_FILE_MACHINE_UNKNOWN = 0 +IMAGE_NUMBEROF_DIRECTORY_ENTRIES = 16 +IMAGE_SIZEOF_ROM_OPTIONAL_HEADER = 56 +IMAGE_SIZEOF_STD_OPTIONAL_HEADER = 28 +IMAGE_SIZEOF_NT_OPTIONAL_HEADER = 224 +IMAGE_NT_OPTIONAL_HDR_MAGIC = 267 +IMAGE_ROM_OPTIONAL_HDR_MAGIC = 263 +IMAGE_SIZEOF_SHORT_NAME = 8 +IMAGE_SIZEOF_SECTION_HEADER = 40 +IMAGE_SIZEOF_SYMBOL = 18 +IMAGE_SYM_CLASS_NULL = 0 +IMAGE_SYM_CLASS_AUTOMATIC = 1 +IMAGE_SYM_CLASS_EXTERNAL = 2 +IMAGE_SYM_CLASS_STATIC = 3 +IMAGE_SYM_CLASS_REGISTER = 4 +IMAGE_SYM_CLASS_EXTERNAL_DEF = 5 +IMAGE_SYM_CLASS_LABEL = 6 +IMAGE_SYM_CLASS_UNDEFINED_LABEL = 7 +IMAGE_SYM_CLASS_MEMBER_OF_STRUCT = 8 +IMAGE_SYM_CLASS_ARGUMENT = 9 +IMAGE_SYM_CLASS_STRUCT_TAG = 10 +IMAGE_SYM_CLASS_MEMBER_OF_UNION = 11 +IMAGE_SYM_CLASS_UNION_TAG = 12 +IMAGE_SYM_CLASS_TYPE_DEFINITION = 13 +IMAGE_SYM_CLASS_UNDEFINED_STATIC = 14 +IMAGE_SYM_CLASS_ENUM_TAG = 15 +IMAGE_SYM_CLASS_MEMBER_OF_ENUM = 16 +IMAGE_SYM_CLASS_REGISTER_PARAM = 17 +IMAGE_SYM_CLASS_BIT_FIELD = 18 +IMAGE_SYM_CLASS_BLOCK = 100 +IMAGE_SYM_CLASS_FUNCTION = 101 +IMAGE_SYM_CLASS_END_OF_STRUCT = 102 +IMAGE_SYM_CLASS_FILE = 103 +IMAGE_SYM_CLASS_SECTION = 104 +IMAGE_SYM_CLASS_WEAK_EXTERNAL = 105 +N_BTMASK = 15 +N_TMASK = 48 +N_TMASK1 = 192 +N_TMASK2 = 240 +N_BTSHFT = 4 +N_TSHIFT = 2 +IMAGE_SIZEOF_AUX_SYMBOL = 18 +IMAGE_COMDAT_SELECT_NODUPLICATES = 1 +IMAGE_COMDAT_SELECT_ANY = 2 +IMAGE_COMDAT_SELECT_SAME_SIZE = 3 +IMAGE_COMDAT_SELECT_EXACT_MATCH = 4 +IMAGE_COMDAT_SELECT_ASSOCIATIVE = 5 +IMAGE_WEAK_EXTERN_SEARCH_NOLIBRARY = 1 +IMAGE_WEAK_EXTERN_SEARCH_LIBRARY = 2 +IMAGE_WEAK_EXTERN_SEARCH_ALIAS = 3 +IMAGE_SIZEOF_RELOCATION = 10 +IMAGE_REL_I386_SECTION = 10 +IMAGE_REL_I386_SECREL = 11 +IMAGE_REL_MIPS_REFHALF = 1 +IMAGE_REL_MIPS_REFWORD = 2 +IMAGE_REL_MIPS_JMPADDR = 3 +IMAGE_REL_MIPS_REFHI = 4 +IMAGE_REL_MIPS_REFLO = 5 +IMAGE_REL_MIPS_GPREL = 6 +IMAGE_REL_MIPS_LITERAL = 7 +IMAGE_REL_MIPS_SECTION = 10 +IMAGE_REL_MIPS_SECREL = 11 +IMAGE_REL_MIPS_REFWORDNB = 34 +IMAGE_REL_MIPS_PAIR = 37 +IMAGE_REL_ALPHA_ABSOLUTE = 0 +IMAGE_REL_ALPHA_REFLONG = 1 +IMAGE_REL_ALPHA_REFQUAD = 2 +IMAGE_REL_ALPHA_GPREL32 = 3 +IMAGE_REL_ALPHA_LITERAL = 4 +IMAGE_REL_ALPHA_LITUSE = 5 +IMAGE_REL_ALPHA_GPDISP = 6 +IMAGE_REL_ALPHA_BRADDR = 7 +IMAGE_REL_ALPHA_HINT = 8 +IMAGE_REL_ALPHA_INLINE_REFLONG = 9 +IMAGE_REL_ALPHA_REFHI = 10 +IMAGE_REL_ALPHA_REFLO = 11 +IMAGE_REL_ALPHA_PAIR = 12 +IMAGE_REL_ALPHA_MATCH = 13 +IMAGE_REL_ALPHA_SECTION = 14 +IMAGE_REL_ALPHA_SECREL = 15 +IMAGE_REL_ALPHA_REFLONGNB = 16 +IMAGE_SIZEOF_BASE_RELOCATION = 8 +IMAGE_REL_BASED_ABSOLUTE = 0 +IMAGE_REL_BASED_HIGH = 1 +IMAGE_REL_BASED_LOW = 2 +IMAGE_REL_BASED_HIGHLOW = 3 +IMAGE_REL_BASED_HIGHADJ = 4 +IMAGE_REL_BASED_MIPS_JMPADDR = 5 +IMAGE_SIZEOF_LINENUMBER = 6 +IMAGE_ARCHIVE_START_SIZE = 8 +IMAGE_ARCHIVE_START = "!\n" +IMAGE_ARCHIVE_END = "`\n" +IMAGE_ARCHIVE_PAD = "\n" +IMAGE_ARCHIVE_LINKER_MEMBER = "/ " +IMAGE_ARCHIVE_LONGNAMES_MEMBER = "// " +IMAGE_SIZEOF_ARCHIVE_MEMBER_HDR = 60 +IMAGE_ORDINAL_FLAG = -2147483648 + + +def IMAGE_SNAP_BY_ORDINAL(Ordinal): + return (Ordinal & IMAGE_ORDINAL_FLAG) != 0 + + +def IMAGE_ORDINAL(Ordinal): + return Ordinal & 65535 + + +IMAGE_RESOURCE_NAME_IS_STRING = -2147483648 +IMAGE_RESOURCE_DATA_IS_DIRECTORY = -2147483648 +IMAGE_DEBUG_TYPE_UNKNOWN = 0 +IMAGE_DEBUG_TYPE_COFF = 1 +IMAGE_DEBUG_TYPE_CODEVIEW = 2 +IMAGE_DEBUG_TYPE_FPO = 3 +IMAGE_DEBUG_TYPE_MISC = 4 +IMAGE_DEBUG_TYPE_EXCEPTION = 5 +IMAGE_DEBUG_TYPE_FIXUP = 6 +IMAGE_DEBUG_TYPE_OMAP_TO_SRC = 7 +IMAGE_DEBUG_TYPE_OMAP_FROM_SRC = 8 +FRAME_FPO = 0 +FRAME_TRAP = 1 +FRAME_TSS = 2 +SIZEOF_RFPO_DATA = 16 +IMAGE_DEBUG_MISC_EXENAME = 1 +IMAGE_SEPARATE_DEBUG_SIGNATURE = 18756 +# Generated by h2py from \msvcnt\include\wingdi.h +# hacked and split manually by mhammond. +NEWFRAME = 1 +ABORTDOC = 2 +NEXTBAND = 3 +SETCOLORTABLE = 4 +GETCOLORTABLE = 5 +FLUSHOUTPUT = 6 +DRAFTMODE = 7 +QUERYESCSUPPORT = 8 +SETABORTPROC = 9 +STARTDOC = 10 +ENDDOC = 11 +GETPHYSPAGESIZE = 12 +GETPRINTINGOFFSET = 13 +GETSCALINGFACTOR = 14 +MFCOMMENT = 15 +GETPENWIDTH = 16 +SETCOPYCOUNT = 17 +SELECTPAPERSOURCE = 18 +DEVICEDATA = 19 +PASSTHROUGH = 19 +GETTECHNOLGY = 20 +GETTECHNOLOGY = 20 +SETLINECAP = 21 +SETLINEJOIN = 22 +SETMITERLIMIT = 23 +BANDINFO = 24 +DRAWPATTERNRECT = 25 +GETVECTORPENSIZE = 26 +GETVECTORBRUSHSIZE = 27 +ENABLEDUPLEX = 28 +GETSETPAPERBINS = 29 +GETSETPRINTORIENT = 30 +ENUMPAPERBINS = 31 +SETDIBSCALING = 32 +EPSPRINTING = 33 +ENUMPAPERMETRICS = 34 +GETSETPAPERMETRICS = 35 +POSTSCRIPT_DATA = 37 +POSTSCRIPT_IGNORE = 38 +MOUSETRAILS = 39 +GETDEVICEUNITS = 42 +GETEXTENDEDTEXTMETRICS = 256 +GETEXTENTTABLE = 257 +GETPAIRKERNTABLE = 258 +GETTRACKKERNTABLE = 259 +EXTTEXTOUT = 512 +GETFACENAME = 513 +DOWNLOADFACE = 514 +ENABLERELATIVEWIDTHS = 768 +ENABLEPAIRKERNING = 769 +SETKERNTRACK = 770 +SETALLJUSTVALUES = 771 +SETCHARSET = 772 +STRETCHBLT = 2048 +GETSETSCREENPARAMS = 3072 +BEGIN_PATH = 4096 +CLIP_TO_PATH = 4097 +END_PATH = 4098 +EXT_DEVICE_CAPS = 4099 +RESTORE_CTM = 4100 +SAVE_CTM = 4101 +SET_ARC_DIRECTION = 4102 +SET_BACKGROUND_COLOR = 4103 +SET_POLY_MODE = 4104 +SET_SCREEN_ANGLE = 4105 +SET_SPREAD = 4106 +TRANSFORM_CTM = 4107 +SET_CLIP_BOX = 4108 +SET_BOUNDS = 4109 +SET_MIRROR_MODE = 4110 +OPENCHANNEL = 4110 +DOWNLOADHEADER = 4111 +CLOSECHANNEL = 4112 +POSTSCRIPT_PASSTHROUGH = 4115 +ENCAPSULATED_POSTSCRIPT = 4116 +SP_NOTREPORTED = 16384 +SP_ERROR = -1 +SP_APPABORT = -2 +SP_USERABORT = -3 +SP_OUTOFDISK = -4 +SP_OUTOFMEMORY = -5 +PR_JOBSTATUS = 0 + +## GDI object types +OBJ_PEN = 1 +OBJ_BRUSH = 2 +OBJ_DC = 3 +OBJ_METADC = 4 +OBJ_PAL = 5 +OBJ_FONT = 6 +OBJ_BITMAP = 7 +OBJ_REGION = 8 +OBJ_METAFILE = 9 +OBJ_MEMDC = 10 +OBJ_EXTPEN = 11 +OBJ_ENHMETADC = 12 +OBJ_ENHMETAFILE = 13 +OBJ_COLORSPACE = 14 + +MWT_IDENTITY = 1 +MWT_LEFTMULTIPLY = 2 +MWT_RIGHTMULTIPLY = 3 +MWT_MIN = MWT_IDENTITY +MWT_MAX = MWT_RIGHTMULTIPLY +BI_RGB = 0 +BI_RLE8 = 1 +BI_RLE4 = 2 +BI_BITFIELDS = 3 +TMPF_FIXED_PITCH = 1 +TMPF_VECTOR = 2 +TMPF_DEVICE = 8 +TMPF_TRUETYPE = 4 +NTM_REGULAR = 64 +NTM_BOLD = 32 +NTM_ITALIC = 1 +LF_FACESIZE = 32 +LF_FULLFACESIZE = 64 +OUT_DEFAULT_PRECIS = 0 +OUT_STRING_PRECIS = 1 +OUT_CHARACTER_PRECIS = 2 +OUT_STROKE_PRECIS = 3 +OUT_TT_PRECIS = 4 +OUT_DEVICE_PRECIS = 5 +OUT_RASTER_PRECIS = 6 +OUT_TT_ONLY_PRECIS = 7 +OUT_OUTLINE_PRECIS = 8 +CLIP_DEFAULT_PRECIS = 0 +CLIP_CHARACTER_PRECIS = 1 +CLIP_STROKE_PRECIS = 2 +CLIP_MASK = 15 +CLIP_LH_ANGLES = 1 << 4 +CLIP_TT_ALWAYS = 2 << 4 +CLIP_EMBEDDED = 8 << 4 +DEFAULT_QUALITY = 0 +DRAFT_QUALITY = 1 +PROOF_QUALITY = 2 +NONANTIALIASED_QUALITY = 3 +ANTIALIASED_QUALITY = 4 +CLEARTYPE_QUALITY = 5 +CLEARTYPE_NATURAL_QUALITY = 6 +DEFAULT_PITCH = 0 +FIXED_PITCH = 1 +VARIABLE_PITCH = 2 +ANSI_CHARSET = 0 +DEFAULT_CHARSET = 1 +SYMBOL_CHARSET = 2 +SHIFTJIS_CHARSET = 128 +HANGEUL_CHARSET = 129 +CHINESEBIG5_CHARSET = 136 +OEM_CHARSET = 255 +JOHAB_CHARSET = 130 +HEBREW_CHARSET = 177 +ARABIC_CHARSET = 178 +GREEK_CHARSET = 161 +TURKISH_CHARSET = 162 +VIETNAMESE_CHARSET = 163 +THAI_CHARSET = 222 +EASTEUROPE_CHARSET = 238 +RUSSIAN_CHARSET = 204 +MAC_CHARSET = 77 +BALTIC_CHARSET = 186 +FF_DONTCARE = 0 << 4 +FF_ROMAN = 1 << 4 +FF_SWISS = 2 << 4 +FF_MODERN = 3 << 4 +FF_SCRIPT = 4 << 4 +FF_DECORATIVE = 5 << 4 +FW_DONTCARE = 0 +FW_THIN = 100 +FW_EXTRALIGHT = 200 +FW_LIGHT = 300 +FW_NORMAL = 400 +FW_MEDIUM = 500 +FW_SEMIBOLD = 600 +FW_BOLD = 700 +FW_EXTRABOLD = 800 +FW_HEAVY = 900 +FW_ULTRALIGHT = FW_EXTRALIGHT +FW_REGULAR = FW_NORMAL +FW_DEMIBOLD = FW_SEMIBOLD +FW_ULTRABOLD = FW_EXTRABOLD +FW_BLACK = FW_HEAVY +# Generated by h2py from \msvcnt\include\wingdi.h +# hacked and split manually by mhammond. +BS_SOLID = 0 +BS_NULL = 1 +BS_HOLLOW = BS_NULL +BS_HATCHED = 2 +BS_PATTERN = 3 +BS_INDEXED = 4 +BS_DIBPATTERN = 5 +BS_DIBPATTERNPT = 6 +BS_PATTERN8X8 = 7 +BS_DIBPATTERN8X8 = 8 +HS_HORIZONTAL = 0 +HS_VERTICAL = 1 +HS_FDIAGONAL = 2 +HS_BDIAGONAL = 3 +HS_CROSS = 4 +HS_DIAGCROSS = 5 +HS_FDIAGONAL1 = 6 +HS_BDIAGONAL1 = 7 +HS_SOLID = 8 +HS_DENSE1 = 9 +HS_DENSE2 = 10 +HS_DENSE3 = 11 +HS_DENSE4 = 12 +HS_DENSE5 = 13 +HS_DENSE6 = 14 +HS_DENSE7 = 15 +HS_DENSE8 = 16 +HS_NOSHADE = 17 +HS_HALFTONE = 18 +HS_SOLIDCLR = 19 +HS_DITHEREDCLR = 20 +HS_SOLIDTEXTCLR = 21 +HS_DITHEREDTEXTCLR = 22 +HS_SOLIDBKCLR = 23 +HS_DITHEREDBKCLR = 24 +HS_API_MAX = 25 +PS_SOLID = 0 +PS_DASH = 1 +PS_DOT = 2 +PS_DASHDOT = 3 +PS_DASHDOTDOT = 4 +PS_NULL = 5 +PS_INSIDEFRAME = 6 +PS_USERSTYLE = 7 +PS_ALTERNATE = 8 +PS_STYLE_MASK = 15 +PS_ENDCAP_ROUND = 0 +PS_ENDCAP_SQUARE = 256 +PS_ENDCAP_FLAT = 512 +PS_ENDCAP_MASK = 3840 +PS_JOIN_ROUND = 0 +PS_JOIN_BEVEL = 4096 +PS_JOIN_MITER = 8192 +PS_JOIN_MASK = 61440 +PS_COSMETIC = 0 +PS_GEOMETRIC = 65536 +PS_TYPE_MASK = 983040 +AD_COUNTERCLOCKWISE = 1 +AD_CLOCKWISE = 2 +DRIVERVERSION = 0 +TECHNOLOGY = 2 +HORZSIZE = 4 +VERTSIZE = 6 +HORZRES = 8 +VERTRES = 10 +BITSPIXEL = 12 +PLANES = 14 +NUMBRUSHES = 16 +NUMPENS = 18 +NUMMARKERS = 20 +NUMFONTS = 22 +NUMCOLORS = 24 +PDEVICESIZE = 26 +CURVECAPS = 28 +LINECAPS = 30 +POLYGONALCAPS = 32 +TEXTCAPS = 34 +CLIPCAPS = 36 +RASTERCAPS = 38 +ASPECTX = 40 +ASPECTY = 42 +ASPECTXY = 44 +LOGPIXELSX = 88 +LOGPIXELSY = 90 +SIZEPALETTE = 104 +NUMRESERVED = 106 +COLORRES = 108 + +PHYSICALWIDTH = 110 +PHYSICALHEIGHT = 111 +PHYSICALOFFSETX = 112 +PHYSICALOFFSETY = 113 +SCALINGFACTORX = 114 +SCALINGFACTORY = 115 +VREFRESH = 116 +DESKTOPVERTRES = 117 +DESKTOPHORZRES = 118 +BLTALIGNMENT = 119 +SHADEBLENDCAPS = 120 +COLORMGMTCAPS = 121 + +DT_PLOTTER = 0 +DT_RASDISPLAY = 1 +DT_RASPRINTER = 2 +DT_RASCAMERA = 3 +DT_CHARSTREAM = 4 +DT_METAFILE = 5 +DT_DISPFILE = 6 +CC_NONE = 0 +CC_CIRCLES = 1 +CC_PIE = 2 +CC_CHORD = 4 +CC_ELLIPSES = 8 +CC_WIDE = 16 +CC_STYLED = 32 +CC_WIDESTYLED = 64 +CC_INTERIORS = 128 +CC_ROUNDRECT = 256 +LC_NONE = 0 +LC_POLYLINE = 2 +LC_MARKER = 4 +LC_POLYMARKER = 8 +LC_WIDE = 16 +LC_STYLED = 32 +LC_WIDESTYLED = 64 +LC_INTERIORS = 128 +PC_NONE = 0 +PC_POLYGON = 1 +PC_RECTANGLE = 2 +PC_WINDPOLYGON = 4 +PC_TRAPEZOID = 4 +PC_SCANLINE = 8 +PC_WIDE = 16 +PC_STYLED = 32 +PC_WIDESTYLED = 64 +PC_INTERIORS = 128 +CP_NONE = 0 +CP_RECTANGLE = 1 +CP_REGION = 2 +TC_OP_CHARACTER = 1 +TC_OP_STROKE = 2 +TC_CP_STROKE = 4 +TC_CR_90 = 8 +TC_CR_ANY = 16 +TC_SF_X_YINDEP = 32 +TC_SA_DOUBLE = 64 +TC_SA_INTEGER = 128 +TC_SA_CONTIN = 256 +TC_EA_DOUBLE = 512 +TC_IA_ABLE = 1024 +TC_UA_ABLE = 2048 +TC_SO_ABLE = 4096 +TC_RA_ABLE = 8192 +TC_VA_ABLE = 16384 +TC_RESERVED = 32768 +TC_SCROLLBLT = 65536 +RC_BITBLT = 1 +RC_BANDING = 2 +RC_SCALING = 4 +RC_BITMAP64 = 8 +RC_GDI20_OUTPUT = 16 +RC_GDI20_STATE = 32 +RC_SAVEBITMAP = 64 +RC_DI_BITMAP = 128 +RC_PALETTE = 256 +RC_DIBTODEV = 512 +RC_BIGFONT = 1024 +RC_STRETCHBLT = 2048 +RC_FLOODFILL = 4096 +RC_STRETCHDIB = 8192 +RC_OP_DX_OUTPUT = 16384 +RC_DEVBITS = 32768 +DIB_RGB_COLORS = 0 +DIB_PAL_COLORS = 1 +DIB_PAL_INDICES = 2 +DIB_PAL_PHYSINDICES = 2 +DIB_PAL_LOGINDICES = 4 +SYSPAL_ERROR = 0 +SYSPAL_STATIC = 1 +SYSPAL_NOSTATIC = 2 +CBM_CREATEDIB = 2 +CBM_INIT = 4 +FLOODFILLBORDER = 0 +FLOODFILLSURFACE = 1 +CCHDEVICENAME = 32 +CCHFORMNAME = 32 +# Generated by h2py from \msvcnt\include\wingdi.h +# hacked and split manually by mhammond. + +# DEVMODE.dmFields +DM_SPECVERSION = 800 +DM_ORIENTATION = 1 +DM_PAPERSIZE = 2 +DM_PAPERLENGTH = 4 +DM_PAPERWIDTH = 8 +DM_SCALE = 16 +DM_POSITION = 32 +DM_NUP = 64 +DM_DISPLAYORIENTATION = 128 +DM_COPIES = 256 +DM_DEFAULTSOURCE = 512 +DM_PRINTQUALITY = 1024 +DM_COLOR = 2048 +DM_DUPLEX = 4096 +DM_YRESOLUTION = 8192 +DM_TTOPTION = 16384 +DM_COLLATE = 32768 +DM_FORMNAME = 65536 +DM_LOGPIXELS = 131072 +DM_BITSPERPEL = 262144 +DM_PELSWIDTH = 524288 +DM_PELSHEIGHT = 1048576 +DM_DISPLAYFLAGS = 2097152 +DM_DISPLAYFREQUENCY = 4194304 +DM_ICMMETHOD = 8388608 +DM_ICMINTENT = 16777216 +DM_MEDIATYPE = 33554432 +DM_DITHERTYPE = 67108864 +DM_PANNINGWIDTH = 134217728 +DM_PANNINGHEIGHT = 268435456 +DM_DISPLAYFIXEDOUTPUT = 536870912 + +# DEVMODE.dmOrientation +DMORIENT_PORTRAIT = 1 +DMORIENT_LANDSCAPE = 2 + +# DEVMODE.dmDisplayOrientation +DMDO_DEFAULT = 0 +DMDO_90 = 1 +DMDO_180 = 2 +DMDO_270 = 3 + +# DEVMODE.dmDisplayFixedOutput +DMDFO_DEFAULT = 0 +DMDFO_STRETCH = 1 +DMDFO_CENTER = 2 + +# DEVMODE.dmPaperSize +DMPAPER_LETTER = 1 +DMPAPER_LETTERSMALL = 2 +DMPAPER_TABLOID = 3 +DMPAPER_LEDGER = 4 +DMPAPER_LEGAL = 5 +DMPAPER_STATEMENT = 6 +DMPAPER_EXECUTIVE = 7 +DMPAPER_A3 = 8 +DMPAPER_A4 = 9 +DMPAPER_A4SMALL = 10 +DMPAPER_A5 = 11 +DMPAPER_B4 = 12 +DMPAPER_B5 = 13 +DMPAPER_FOLIO = 14 +DMPAPER_QUARTO = 15 +DMPAPER_10X14 = 16 +DMPAPER_11X17 = 17 +DMPAPER_NOTE = 18 +DMPAPER_ENV_9 = 19 +DMPAPER_ENV_10 = 20 +DMPAPER_ENV_11 = 21 +DMPAPER_ENV_12 = 22 +DMPAPER_ENV_14 = 23 +DMPAPER_CSHEET = 24 +DMPAPER_DSHEET = 25 +DMPAPER_ESHEET = 26 +DMPAPER_ENV_DL = 27 +DMPAPER_ENV_C5 = 28 +DMPAPER_ENV_C3 = 29 +DMPAPER_ENV_C4 = 30 +DMPAPER_ENV_C6 = 31 +DMPAPER_ENV_C65 = 32 +DMPAPER_ENV_B4 = 33 +DMPAPER_ENV_B5 = 34 +DMPAPER_ENV_B6 = 35 +DMPAPER_ENV_ITALY = 36 +DMPAPER_ENV_MONARCH = 37 +DMPAPER_ENV_PERSONAL = 38 +DMPAPER_FANFOLD_US = 39 +DMPAPER_FANFOLD_STD_GERMAN = 40 +DMPAPER_FANFOLD_LGL_GERMAN = 41 +DMPAPER_ISO_B4 = 42 +DMPAPER_JAPANESE_POSTCARD = 43 +DMPAPER_9X11 = 44 +DMPAPER_10X11 = 45 +DMPAPER_15X11 = 46 +DMPAPER_ENV_INVITE = 47 +DMPAPER_RESERVED_48 = 48 +DMPAPER_RESERVED_49 = 49 +DMPAPER_LETTER_EXTRA = 50 +DMPAPER_LEGAL_EXTRA = 51 +DMPAPER_TABLOID_EXTRA = 52 +DMPAPER_A4_EXTRA = 53 +DMPAPER_LETTER_TRANSVERSE = 54 +DMPAPER_A4_TRANSVERSE = 55 +DMPAPER_LETTER_EXTRA_TRANSVERSE = 56 +DMPAPER_A_PLUS = 57 +DMPAPER_B_PLUS = 58 +DMPAPER_LETTER_PLUS = 59 +DMPAPER_A4_PLUS = 60 +DMPAPER_A5_TRANSVERSE = 61 +DMPAPER_B5_TRANSVERSE = 62 +DMPAPER_A3_EXTRA = 63 +DMPAPER_A5_EXTRA = 64 +DMPAPER_B5_EXTRA = 65 +DMPAPER_A2 = 66 +DMPAPER_A3_TRANSVERSE = 67 +DMPAPER_A3_EXTRA_TRANSVERSE = 68 +DMPAPER_DBL_JAPANESE_POSTCARD = 69 +DMPAPER_A6 = 70 +DMPAPER_JENV_KAKU2 = 71 +DMPAPER_JENV_KAKU3 = 72 +DMPAPER_JENV_CHOU3 = 73 +DMPAPER_JENV_CHOU4 = 74 +DMPAPER_LETTER_ROTATED = 75 +DMPAPER_A3_ROTATED = 76 +DMPAPER_A4_ROTATED = 77 +DMPAPER_A5_ROTATED = 78 +DMPAPER_B4_JIS_ROTATED = 79 +DMPAPER_B5_JIS_ROTATED = 80 +DMPAPER_JAPANESE_POSTCARD_ROTATED = 81 +DMPAPER_DBL_JAPANESE_POSTCARD_ROTATED = 82 +DMPAPER_A6_ROTATED = 83 +DMPAPER_JENV_KAKU2_ROTATED = 84 +DMPAPER_JENV_KAKU3_ROTATED = 85 +DMPAPER_JENV_CHOU3_ROTATED = 86 +DMPAPER_JENV_CHOU4_ROTATED = 87 +DMPAPER_B6_JIS = 88 +DMPAPER_B6_JIS_ROTATED = 89 +DMPAPER_12X11 = 90 +DMPAPER_JENV_YOU4 = 91 +DMPAPER_JENV_YOU4_ROTATED = 92 +DMPAPER_P16K = 93 +DMPAPER_P32K = 94 +DMPAPER_P32KBIG = 95 +DMPAPER_PENV_1 = 96 +DMPAPER_PENV_2 = 97 +DMPAPER_PENV_3 = 98 +DMPAPER_PENV_4 = 99 +DMPAPER_PENV_5 = 100 +DMPAPER_PENV_6 = 101 +DMPAPER_PENV_7 = 102 +DMPAPER_PENV_8 = 103 +DMPAPER_PENV_9 = 104 +DMPAPER_PENV_10 = 105 +DMPAPER_P16K_ROTATED = 106 +DMPAPER_P32K_ROTATED = 107 +DMPAPER_P32KBIG_ROTATED = 108 +DMPAPER_PENV_1_ROTATED = 109 +DMPAPER_PENV_2_ROTATED = 110 +DMPAPER_PENV_3_ROTATED = 111 +DMPAPER_PENV_4_ROTATED = 112 +DMPAPER_PENV_5_ROTATED = 113 +DMPAPER_PENV_6_ROTATED = 114 +DMPAPER_PENV_7_ROTATED = 115 +DMPAPER_PENV_8_ROTATED = 116 +DMPAPER_PENV_9_ROTATED = 117 +DMPAPER_PENV_10_ROTATED = 118 +DMPAPER_LAST = DMPAPER_PENV_10_ROTATED +DMPAPER_USER = 256 + +# DEVMODE.dmDefaultSource +DMBIN_UPPER = 1 +DMBIN_ONLYONE = 1 +DMBIN_LOWER = 2 +DMBIN_MIDDLE = 3 +DMBIN_MANUAL = 4 +DMBIN_ENVELOPE = 5 +DMBIN_ENVMANUAL = 6 +DMBIN_AUTO = 7 +DMBIN_TRACTOR = 8 +DMBIN_SMALLFMT = 9 +DMBIN_LARGEFMT = 10 +DMBIN_LARGECAPACITY = 11 +DMBIN_CASSETTE = 14 +DMBIN_FORMSOURCE = 15 +DMBIN_LAST = DMBIN_FORMSOURCE +DMBIN_USER = 256 + +# DEVMODE.dmPrintQuality +DMRES_DRAFT = -1 +DMRES_LOW = -2 +DMRES_MEDIUM = -3 +DMRES_HIGH = -4 + +# DEVMODE.dmColor +DMCOLOR_MONOCHROME = 1 +DMCOLOR_COLOR = 2 + +# DEVMODE.dmDuplex +DMDUP_SIMPLEX = 1 +DMDUP_VERTICAL = 2 +DMDUP_HORIZONTAL = 3 + +# DEVMODE.dmTTOption +DMTT_BITMAP = 1 +DMTT_DOWNLOAD = 2 +DMTT_SUBDEV = 3 +DMTT_DOWNLOAD_OUTLINE = 4 + +# DEVMODE.dmCollate +DMCOLLATE_FALSE = 0 +DMCOLLATE_TRUE = 1 + +# DEVMODE.dmDisplayFlags +DM_GRAYSCALE = 1 +DM_INTERLACED = 2 + +# DEVMODE.dmICMMethod +DMICMMETHOD_NONE = 1 +DMICMMETHOD_SYSTEM = 2 +DMICMMETHOD_DRIVER = 3 +DMICMMETHOD_DEVICE = 4 +DMICMMETHOD_USER = 256 + +# DEVMODE.dmICMIntent +DMICM_SATURATE = 1 +DMICM_CONTRAST = 2 +DMICM_COLORIMETRIC = 3 +DMICM_ABS_COLORIMETRIC = 4 +DMICM_USER = 256 + +# DEVMODE.dmMediaType +DMMEDIA_STANDARD = 1 +DMMEDIA_TRANSPARENCY = 2 +DMMEDIA_GLOSSY = 3 +DMMEDIA_USER = 256 + +# DEVMODE.dmDitherType +DMDITHER_NONE = 1 +DMDITHER_COARSE = 2 +DMDITHER_FINE = 3 +DMDITHER_LINEART = 4 +DMDITHER_ERRORDIFFUSION = 5 +DMDITHER_RESERVED6 = 6 +DMDITHER_RESERVED7 = 7 +DMDITHER_RESERVED8 = 8 +DMDITHER_RESERVED9 = 9 +DMDITHER_GRAYSCALE = 10 +DMDITHER_USER = 256 + +# DEVMODE.dmNup +DMNUP_SYSTEM = 1 +DMNUP_ONEUP = 2 + +# used with ExtEscape +FEATURESETTING_NUP = 0 +FEATURESETTING_OUTPUT = 1 +FEATURESETTING_PSLEVEL = 2 +FEATURESETTING_CUSTPAPER = 3 +FEATURESETTING_MIRROR = 4 +FEATURESETTING_NEGATIVE = 5 +FEATURESETTING_PROTOCOL = 6 +FEATURESETTING_PRIVATE_BEGIN = 0x1000 +FEATURESETTING_PRIVATE_END = 0x1FFF + +RDH_RECTANGLES = 1 +GGO_METRICS = 0 +GGO_BITMAP = 1 +GGO_NATIVE = 2 +TT_POLYGON_TYPE = 24 +TT_PRIM_LINE = 1 +TT_PRIM_QSPLINE = 2 +TT_AVAILABLE = 1 +TT_ENABLED = 2 +DM_UPDATE = 1 +DM_COPY = 2 +DM_PROMPT = 4 +DM_MODIFY = 8 +DM_IN_BUFFER = DM_MODIFY +DM_IN_PROMPT = DM_PROMPT +DM_OUT_BUFFER = DM_COPY +DM_OUT_DEFAULT = DM_UPDATE + +# DISPLAY_DEVICE.StateFlags +DISPLAY_DEVICE_ATTACHED_TO_DESKTOP = 1 +DISPLAY_DEVICE_MULTI_DRIVER = 2 +DISPLAY_DEVICE_PRIMARY_DEVICE = 4 +DISPLAY_DEVICE_MIRRORING_DRIVER = 8 +DISPLAY_DEVICE_VGA_COMPATIBLE = 16 +DISPLAY_DEVICE_REMOVABLE = 32 +DISPLAY_DEVICE_MODESPRUNED = 134217728 +DISPLAY_DEVICE_REMOTE = 67108864 +DISPLAY_DEVICE_DISCONNECT = 33554432 + +# DeviceCapabilities types +DC_FIELDS = 1 +DC_PAPERS = 2 +DC_PAPERSIZE = 3 +DC_MINEXTENT = 4 +DC_MAXEXTENT = 5 +DC_BINS = 6 +DC_DUPLEX = 7 +DC_SIZE = 8 +DC_EXTRA = 9 +DC_VERSION = 10 +DC_DRIVER = 11 +DC_BINNAMES = 12 +DC_ENUMRESOLUTIONS = 13 +DC_FILEDEPENDENCIES = 14 +DC_TRUETYPE = 15 +DC_PAPERNAMES = 16 +DC_ORIENTATION = 17 +DC_COPIES = 18 +DC_BINADJUST = 19 +DC_EMF_COMPLIANT = 20 +DC_DATATYPE_PRODUCED = 21 +DC_COLLATE = 22 +DC_MANUFACTURER = 23 +DC_MODEL = 24 +DC_PERSONALITY = 25 +DC_PRINTRATE = 26 +DC_PRINTRATEUNIT = 27 +DC_PRINTERMEM = 28 +DC_MEDIAREADY = 29 +DC_STAPLE = 30 +DC_PRINTRATEPPM = 31 +DC_COLORDEVICE = 32 +DC_NUP = 33 +DC_MEDIATYPENAMES = 34 +DC_MEDIATYPES = 35 + +PRINTRATEUNIT_PPM = 1 +PRINTRATEUNIT_CPS = 2 +PRINTRATEUNIT_LPM = 3 +PRINTRATEUNIT_IPM = 4 + +# TrueType constants +DCTT_BITMAP = 1 +DCTT_DOWNLOAD = 2 +DCTT_SUBDEV = 4 +DCTT_DOWNLOAD_OUTLINE = 8 + +DCBA_FACEUPNONE = 0 +DCBA_FACEUPCENTER = 1 +DCBA_FACEUPLEFT = 2 +DCBA_FACEUPRIGHT = 3 +DCBA_FACEDOWNNONE = 256 +DCBA_FACEDOWNCENTER = 257 +DCBA_FACEDOWNLEFT = 258 +DCBA_FACEDOWNRIGHT = 259 + +CA_NEGATIVE = 1 +CA_LOG_FILTER = 2 +ILLUMINANT_DEVICE_DEFAULT = 0 +ILLUMINANT_A = 1 +ILLUMINANT_B = 2 +ILLUMINANT_C = 3 +ILLUMINANT_D50 = 4 +ILLUMINANT_D55 = 5 +ILLUMINANT_D65 = 6 +ILLUMINANT_D75 = 7 +ILLUMINANT_F2 = 8 +ILLUMINANT_MAX_INDEX = ILLUMINANT_F2 +ILLUMINANT_TUNGSTEN = ILLUMINANT_A +ILLUMINANT_DAYLIGHT = ILLUMINANT_C +ILLUMINANT_FLUORESCENT = ILLUMINANT_F2 +ILLUMINANT_NTSC = ILLUMINANT_C + +# Generated by h2py from \msvcnt\include\wingdi.h +# hacked and split manually by mhammond. +FONTMAPPER_MAX = 10 +ENHMETA_SIGNATURE = 1179469088 +ENHMETA_STOCK_OBJECT = -2147483648 +EMR_HEADER = 1 +EMR_POLYBEZIER = 2 +EMR_POLYGON = 3 +EMR_POLYLINE = 4 +EMR_POLYBEZIERTO = 5 +EMR_POLYLINETO = 6 +EMR_POLYPOLYLINE = 7 +EMR_POLYPOLYGON = 8 +EMR_SETWINDOWEXTEX = 9 +EMR_SETWINDOWORGEX = 10 +EMR_SETVIEWPORTEXTEX = 11 +EMR_SETVIEWPORTORGEX = 12 +EMR_SETBRUSHORGEX = 13 +EMR_EOF = 14 +EMR_SETPIXELV = 15 +EMR_SETMAPPERFLAGS = 16 +EMR_SETMAPMODE = 17 +EMR_SETBKMODE = 18 +EMR_SETPOLYFILLMODE = 19 +EMR_SETROP2 = 20 +EMR_SETSTRETCHBLTMODE = 21 +EMR_SETTEXTALIGN = 22 +EMR_SETCOLORADJUSTMENT = 23 +EMR_SETTEXTCOLOR = 24 +EMR_SETBKCOLOR = 25 +EMR_OFFSETCLIPRGN = 26 +EMR_MOVETOEX = 27 +EMR_SETMETARGN = 28 +EMR_EXCLUDECLIPRECT = 29 +EMR_INTERSECTCLIPRECT = 30 +EMR_SCALEVIEWPORTEXTEX = 31 +EMR_SCALEWINDOWEXTEX = 32 +EMR_SAVEDC = 33 +EMR_RESTOREDC = 34 +EMR_SETWORLDTRANSFORM = 35 +EMR_MODIFYWORLDTRANSFORM = 36 +EMR_SELECTOBJECT = 37 +EMR_CREATEPEN = 38 +EMR_CREATEBRUSHINDIRECT = 39 +EMR_DELETEOBJECT = 40 +EMR_ANGLEARC = 41 +EMR_ELLIPSE = 42 +EMR_RECTANGLE = 43 +EMR_ROUNDRECT = 44 +EMR_ARC = 45 +EMR_CHORD = 46 +EMR_PIE = 47 +EMR_SELECTPALETTE = 48 +EMR_CREATEPALETTE = 49 +EMR_SETPALETTEENTRIES = 50 +EMR_RESIZEPALETTE = 51 +EMR_REALIZEPALETTE = 52 +EMR_EXTFLOODFILL = 53 +EMR_LINETO = 54 +EMR_ARCTO = 55 +EMR_POLYDRAW = 56 +EMR_SETARCDIRECTION = 57 +EMR_SETMITERLIMIT = 58 +EMR_BEGINPATH = 59 +EMR_ENDPATH = 60 +EMR_CLOSEFIGURE = 61 +EMR_FILLPATH = 62 +EMR_STROKEANDFILLPATH = 63 +EMR_STROKEPATH = 64 +EMR_FLATTENPATH = 65 +EMR_WIDENPATH = 66 +EMR_SELECTCLIPPATH = 67 +EMR_ABORTPATH = 68 +EMR_GDICOMMENT = 70 +EMR_FILLRGN = 71 +EMR_FRAMERGN = 72 +EMR_INVERTRGN = 73 +EMR_PAINTRGN = 74 +EMR_EXTSELECTCLIPRGN = 75 +EMR_BITBLT = 76 +EMR_STRETCHBLT = 77 +EMR_MASKBLT = 78 +EMR_PLGBLT = 79 +EMR_SETDIBITSTODEVICE = 80 +EMR_STRETCHDIBITS = 81 +EMR_EXTCREATEFONTINDIRECTW = 82 +EMR_EXTTEXTOUTA = 83 +EMR_EXTTEXTOUTW = 84 +EMR_POLYBEZIER16 = 85 +EMR_POLYGON16 = 86 +EMR_POLYLINE16 = 87 +EMR_POLYBEZIERTO16 = 88 +EMR_POLYLINETO16 = 89 +EMR_POLYPOLYLINE16 = 90 +EMR_POLYPOLYGON16 = 91 +EMR_POLYDRAW16 = 92 +EMR_CREATEMONOBRUSH = 93 +EMR_CREATEDIBPATTERNBRUSHPT = 94 +EMR_EXTCREATEPEN = 95 +EMR_POLYTEXTOUTA = 96 +EMR_POLYTEXTOUTW = 97 +EMR_MIN = 1 +EMR_MAX = 97 +# Generated by h2py from \msvcnt\include\wingdi.h +# hacked and split manually by mhammond. +PANOSE_COUNT = 10 +PAN_FAMILYTYPE_INDEX = 0 +PAN_SERIFSTYLE_INDEX = 1 +PAN_WEIGHT_INDEX = 2 +PAN_PROPORTION_INDEX = 3 +PAN_CONTRAST_INDEX = 4 +PAN_STROKEVARIATION_INDEX = 5 +PAN_ARMSTYLE_INDEX = 6 +PAN_LETTERFORM_INDEX = 7 +PAN_MIDLINE_INDEX = 8 +PAN_XHEIGHT_INDEX = 9 +PAN_CULTURE_LATIN = 0 +PAN_ANY = 0 +PAN_NO_FIT = 1 +PAN_FAMILY_TEXT_DISPLAY = 2 +PAN_FAMILY_SCRIPT = 3 +PAN_FAMILY_DECORATIVE = 4 +PAN_FAMILY_PICTORIAL = 5 +PAN_SERIF_COVE = 2 +PAN_SERIF_OBTUSE_COVE = 3 +PAN_SERIF_SQUARE_COVE = 4 +PAN_SERIF_OBTUSE_SQUARE_COVE = 5 +PAN_SERIF_SQUARE = 6 +PAN_SERIF_THIN = 7 +PAN_SERIF_BONE = 8 +PAN_SERIF_EXAGGERATED = 9 +PAN_SERIF_TRIANGLE = 10 +PAN_SERIF_NORMAL_SANS = 11 +PAN_SERIF_OBTUSE_SANS = 12 +PAN_SERIF_PERP_SANS = 13 +PAN_SERIF_FLARED = 14 +PAN_SERIF_ROUNDED = 15 +PAN_WEIGHT_VERY_LIGHT = 2 +PAN_WEIGHT_LIGHT = 3 +PAN_WEIGHT_THIN = 4 +PAN_WEIGHT_BOOK = 5 +PAN_WEIGHT_MEDIUM = 6 +PAN_WEIGHT_DEMI = 7 +PAN_WEIGHT_BOLD = 8 +PAN_WEIGHT_HEAVY = 9 +PAN_WEIGHT_BLACK = 10 +PAN_WEIGHT_NORD = 11 +PAN_PROP_OLD_STYLE = 2 +PAN_PROP_MODERN = 3 +PAN_PROP_EVEN_WIDTH = 4 +PAN_PROP_EXPANDED = 5 +PAN_PROP_CONDENSED = 6 +PAN_PROP_VERY_EXPANDED = 7 +PAN_PROP_VERY_CONDENSED = 8 +PAN_PROP_MONOSPACED = 9 +PAN_CONTRAST_NONE = 2 +PAN_CONTRAST_VERY_LOW = 3 +PAN_CONTRAST_LOW = 4 +PAN_CONTRAST_MEDIUM_LOW = 5 +PAN_CONTRAST_MEDIUM = 6 +PAN_CONTRAST_MEDIUM_HIGH = 7 +PAN_CONTRAST_HIGH = 8 +PAN_CONTRAST_VERY_HIGH = 9 +PAN_STROKE_GRADUAL_DIAG = 2 +PAN_STROKE_GRADUAL_TRAN = 3 +PAN_STROKE_GRADUAL_VERT = 4 +PAN_STROKE_GRADUAL_HORZ = 5 +PAN_STROKE_RAPID_VERT = 6 +PAN_STROKE_RAPID_HORZ = 7 +PAN_STROKE_INSTANT_VERT = 8 +PAN_STRAIGHT_ARMS_HORZ = 2 +PAN_STRAIGHT_ARMS_WEDGE = 3 +PAN_STRAIGHT_ARMS_VERT = 4 +PAN_STRAIGHT_ARMS_SINGLE_SERIF = 5 +PAN_STRAIGHT_ARMS_DOUBLE_SERIF = 6 +PAN_BENT_ARMS_HORZ = 7 +PAN_BENT_ARMS_WEDGE = 8 +PAN_BENT_ARMS_VERT = 9 +PAN_BENT_ARMS_SINGLE_SERIF = 10 +PAN_BENT_ARMS_DOUBLE_SERIF = 11 +PAN_LETT_NORMAL_CONTACT = 2 +PAN_LETT_NORMAL_WEIGHTED = 3 +PAN_LETT_NORMAL_BOXED = 4 +PAN_LETT_NORMAL_FLATTENED = 5 +PAN_LETT_NORMAL_ROUNDED = 6 +PAN_LETT_NORMAL_OFF_CENTER = 7 +PAN_LETT_NORMAL_SQUARE = 8 +PAN_LETT_OBLIQUE_CONTACT = 9 +PAN_LETT_OBLIQUE_WEIGHTED = 10 +PAN_LETT_OBLIQUE_BOXED = 11 +PAN_LETT_OBLIQUE_FLATTENED = 12 +PAN_LETT_OBLIQUE_ROUNDED = 13 +PAN_LETT_OBLIQUE_OFF_CENTER = 14 +PAN_LETT_OBLIQUE_SQUARE = 15 +PAN_MIDLINE_STANDARD_TRIMMED = 2 +PAN_MIDLINE_STANDARD_POINTED = 3 +PAN_MIDLINE_STANDARD_SERIFED = 4 +PAN_MIDLINE_HIGH_TRIMMED = 5 +PAN_MIDLINE_HIGH_POINTED = 6 +PAN_MIDLINE_HIGH_SERIFED = 7 +PAN_MIDLINE_CONSTANT_TRIMMED = 8 +PAN_MIDLINE_CONSTANT_POINTED = 9 +PAN_MIDLINE_CONSTANT_SERIFED = 10 +PAN_MIDLINE_LOW_TRIMMED = 11 +PAN_MIDLINE_LOW_POINTED = 12 +PAN_MIDLINE_LOW_SERIFED = 13 +PAN_XHEIGHT_CONSTANT_SMALL = 2 +PAN_XHEIGHT_CONSTANT_STD = 3 +PAN_XHEIGHT_CONSTANT_LARGE = 4 +PAN_XHEIGHT_DUCKING_SMALL = 5 +PAN_XHEIGHT_DUCKING_STD = 6 +PAN_XHEIGHT_DUCKING_LARGE = 7 +ELF_VENDOR_SIZE = 4 +ELF_VERSION = 0 +ELF_CULTURE_LATIN = 0 +RASTER_FONTTYPE = 1 +DEVICE_FONTTYPE = 2 +TRUETYPE_FONTTYPE = 4 + + +def PALETTEINDEX(i): + return 16777216 | (i) + + +PC_RESERVED = 1 +PC_EXPLICIT = 2 +PC_NOCOLLAPSE = 4 + + +def GetRValue(rgb): + return rgb & 0xFF + + +def GetGValue(rgb): + return (rgb >> 8) & 0xFF + + +def GetBValue(rgb): + return (rgb >> 16) & 0xFF + + +TRANSPARENT = 1 +OPAQUE = 2 +BKMODE_LAST = 2 +GM_COMPATIBLE = 1 +GM_ADVANCED = 2 +GM_LAST = 2 +PT_CLOSEFIGURE = 1 +PT_LINETO = 2 +PT_BEZIERTO = 4 +PT_MOVETO = 6 +MM_TEXT = 1 +MM_LOMETRIC = 2 +MM_HIMETRIC = 3 +MM_LOENGLISH = 4 +MM_HIENGLISH = 5 +MM_TWIPS = 6 +MM_ISOTROPIC = 7 +MM_ANISOTROPIC = 8 +MM_MIN = MM_TEXT +MM_MAX = MM_ANISOTROPIC +MM_MAX_FIXEDSCALE = MM_TWIPS +ABSOLUTE = 1 +RELATIVE = 2 +WHITE_BRUSH = 0 +LTGRAY_BRUSH = 1 +GRAY_BRUSH = 2 +DKGRAY_BRUSH = 3 +BLACK_BRUSH = 4 +NULL_BRUSH = 5 +HOLLOW_BRUSH = NULL_BRUSH +WHITE_PEN = 6 +BLACK_PEN = 7 +NULL_PEN = 8 +OEM_FIXED_FONT = 10 +ANSI_FIXED_FONT = 11 +ANSI_VAR_FONT = 12 +SYSTEM_FONT = 13 +DEVICE_DEFAULT_FONT = 14 +DEFAULT_PALETTE = 15 +SYSTEM_FIXED_FONT = 16 +STOCK_LAST = 16 +CLR_INVALID = -1 + +DC_BRUSH = 18 +DC_PEN = 19 + +# Exception/Status codes from winuser.h and winnt.h +STATUS_WAIT_0 = 0 +STATUS_ABANDONED_WAIT_0 = 128 +STATUS_USER_APC = 192 +STATUS_TIMEOUT = 258 +STATUS_PENDING = 259 +STATUS_SEGMENT_NOTIFICATION = 1073741829 +STATUS_GUARD_PAGE_VIOLATION = -2147483647 +STATUS_DATATYPE_MISALIGNMENT = -2147483646 +STATUS_BREAKPOINT = -2147483645 +STATUS_SINGLE_STEP = -2147483644 +STATUS_ACCESS_VIOLATION = -1073741819 +STATUS_IN_PAGE_ERROR = -1073741818 +STATUS_INVALID_HANDLE = -1073741816 +STATUS_NO_MEMORY = -1073741801 +STATUS_ILLEGAL_INSTRUCTION = -1073741795 +STATUS_NONCONTINUABLE_EXCEPTION = -1073741787 +STATUS_INVALID_DISPOSITION = -1073741786 +STATUS_ARRAY_BOUNDS_EXCEEDED = -1073741684 +STATUS_FLOAT_DENORMAL_OPERAND = -1073741683 +STATUS_FLOAT_DIVIDE_BY_ZERO = -1073741682 +STATUS_FLOAT_INEXACT_RESULT = -1073741681 +STATUS_FLOAT_INVALID_OPERATION = -1073741680 +STATUS_FLOAT_OVERFLOW = -1073741679 +STATUS_FLOAT_STACK_CHECK = -1073741678 +STATUS_FLOAT_UNDERFLOW = -1073741677 +STATUS_INTEGER_DIVIDE_BY_ZERO = -1073741676 +STATUS_INTEGER_OVERFLOW = -1073741675 +STATUS_PRIVILEGED_INSTRUCTION = -1073741674 +STATUS_STACK_OVERFLOW = -1073741571 +STATUS_CONTROL_C_EXIT = -1073741510 + + +WAIT_FAILED = -1 +WAIT_OBJECT_0 = STATUS_WAIT_0 + 0 + +WAIT_ABANDONED = STATUS_ABANDONED_WAIT_0 + 0 +WAIT_ABANDONED_0 = STATUS_ABANDONED_WAIT_0 + 0 + +WAIT_TIMEOUT = STATUS_TIMEOUT +WAIT_IO_COMPLETION = STATUS_USER_APC +STILL_ACTIVE = STATUS_PENDING +EXCEPTION_ACCESS_VIOLATION = STATUS_ACCESS_VIOLATION +EXCEPTION_DATATYPE_MISALIGNMENT = STATUS_DATATYPE_MISALIGNMENT +EXCEPTION_BREAKPOINT = STATUS_BREAKPOINT +EXCEPTION_SINGLE_STEP = STATUS_SINGLE_STEP +EXCEPTION_ARRAY_BOUNDS_EXCEEDED = STATUS_ARRAY_BOUNDS_EXCEEDED +EXCEPTION_FLT_DENORMAL_OPERAND = STATUS_FLOAT_DENORMAL_OPERAND +EXCEPTION_FLT_DIVIDE_BY_ZERO = STATUS_FLOAT_DIVIDE_BY_ZERO +EXCEPTION_FLT_INEXACT_RESULT = STATUS_FLOAT_INEXACT_RESULT +EXCEPTION_FLT_INVALID_OPERATION = STATUS_FLOAT_INVALID_OPERATION +EXCEPTION_FLT_OVERFLOW = STATUS_FLOAT_OVERFLOW +EXCEPTION_FLT_STACK_CHECK = STATUS_FLOAT_STACK_CHECK +EXCEPTION_FLT_UNDERFLOW = STATUS_FLOAT_UNDERFLOW +EXCEPTION_INT_DIVIDE_BY_ZERO = STATUS_INTEGER_DIVIDE_BY_ZERO +EXCEPTION_INT_OVERFLOW = STATUS_INTEGER_OVERFLOW +EXCEPTION_PRIV_INSTRUCTION = STATUS_PRIVILEGED_INSTRUCTION +EXCEPTION_IN_PAGE_ERROR = STATUS_IN_PAGE_ERROR +EXCEPTION_ILLEGAL_INSTRUCTION = STATUS_ILLEGAL_INSTRUCTION +EXCEPTION_NONCONTINUABLE_EXCEPTION = STATUS_NONCONTINUABLE_EXCEPTION +EXCEPTION_STACK_OVERFLOW = STATUS_STACK_OVERFLOW +EXCEPTION_INVALID_DISPOSITION = STATUS_INVALID_DISPOSITION +EXCEPTION_GUARD_PAGE = STATUS_GUARD_PAGE_VIOLATION +EXCEPTION_INVALID_HANDLE = STATUS_INVALID_HANDLE +CONTROL_C_EXIT = STATUS_CONTROL_C_EXIT + +# winuser.h line 8594 +# constants used with SystemParametersInfo +SPI_GETBEEP = 1 +SPI_SETBEEP = 2 +SPI_GETMOUSE = 3 +SPI_SETMOUSE = 4 +SPI_GETBORDER = 5 +SPI_SETBORDER = 6 +SPI_GETKEYBOARDSPEED = 10 +SPI_SETKEYBOARDSPEED = 11 +SPI_LANGDRIVER = 12 +SPI_ICONHORIZONTALSPACING = 13 +SPI_GETSCREENSAVETIMEOUT = 14 +SPI_SETSCREENSAVETIMEOUT = 15 +SPI_GETSCREENSAVEACTIVE = 16 +SPI_SETSCREENSAVEACTIVE = 17 +SPI_GETGRIDGRANULARITY = 18 +SPI_SETGRIDGRANULARITY = 19 +SPI_SETDESKWALLPAPER = 20 +SPI_SETDESKPATTERN = 21 +SPI_GETKEYBOARDDELAY = 22 +SPI_SETKEYBOARDDELAY = 23 +SPI_ICONVERTICALSPACING = 24 +SPI_GETICONTITLEWRAP = 25 +SPI_SETICONTITLEWRAP = 26 +SPI_GETMENUDROPALIGNMENT = 27 +SPI_SETMENUDROPALIGNMENT = 28 +SPI_SETDOUBLECLKWIDTH = 29 +SPI_SETDOUBLECLKHEIGHT = 30 +SPI_GETICONTITLELOGFONT = 31 +SPI_SETDOUBLECLICKTIME = 32 +SPI_SETMOUSEBUTTONSWAP = 33 +SPI_SETICONTITLELOGFONT = 34 +SPI_GETFASTTASKSWITCH = 35 +SPI_SETFASTTASKSWITCH = 36 +SPI_SETDRAGFULLWINDOWS = 37 +SPI_GETDRAGFULLWINDOWS = 38 +SPI_GETNONCLIENTMETRICS = 41 +SPI_SETNONCLIENTMETRICS = 42 +SPI_GETMINIMIZEDMETRICS = 43 +SPI_SETMINIMIZEDMETRICS = 44 +SPI_GETICONMETRICS = 45 +SPI_SETICONMETRICS = 46 +SPI_SETWORKAREA = 47 +SPI_GETWORKAREA = 48 +SPI_SETPENWINDOWS = 49 +SPI_GETFILTERKEYS = 50 +SPI_SETFILTERKEYS = 51 +SPI_GETTOGGLEKEYS = 52 +SPI_SETTOGGLEKEYS = 53 +SPI_GETMOUSEKEYS = 54 +SPI_SETMOUSEKEYS = 55 +SPI_GETSHOWSOUNDS = 56 +SPI_SETSHOWSOUNDS = 57 +SPI_GETSTICKYKEYS = 58 +SPI_SETSTICKYKEYS = 59 +SPI_GETACCESSTIMEOUT = 60 +SPI_SETACCESSTIMEOUT = 61 +SPI_GETSERIALKEYS = 62 +SPI_SETSERIALKEYS = 63 +SPI_GETSOUNDSENTRY = 64 +SPI_SETSOUNDSENTRY = 65 +SPI_GETHIGHCONTRAST = 66 +SPI_SETHIGHCONTRAST = 67 +SPI_GETKEYBOARDPREF = 68 +SPI_SETKEYBOARDPREF = 69 +SPI_GETSCREENREADER = 70 +SPI_SETSCREENREADER = 71 +SPI_GETANIMATION = 72 +SPI_SETANIMATION = 73 +SPI_GETFONTSMOOTHING = 74 +SPI_SETFONTSMOOTHING = 75 +SPI_SETDRAGWIDTH = 76 +SPI_SETDRAGHEIGHT = 77 +SPI_SETHANDHELD = 78 +SPI_GETLOWPOWERTIMEOUT = 79 +SPI_GETPOWEROFFTIMEOUT = 80 +SPI_SETLOWPOWERTIMEOUT = 81 +SPI_SETPOWEROFFTIMEOUT = 82 +SPI_GETLOWPOWERACTIVE = 83 +SPI_GETPOWEROFFACTIVE = 84 +SPI_SETLOWPOWERACTIVE = 85 +SPI_SETPOWEROFFACTIVE = 86 +SPI_SETCURSORS = 87 +SPI_SETICONS = 88 +SPI_GETDEFAULTINPUTLANG = 89 +SPI_SETDEFAULTINPUTLANG = 90 +SPI_SETLANGTOGGLE = 91 +SPI_GETWINDOWSEXTENSION = 92 +SPI_SETMOUSETRAILS = 93 +SPI_GETMOUSETRAILS = 94 +SPI_GETSNAPTODEFBUTTON = 95 +SPI_SETSNAPTODEFBUTTON = 96 +SPI_SETSCREENSAVERRUNNING = 97 +SPI_SCREENSAVERRUNNING = SPI_SETSCREENSAVERRUNNING +SPI_GETMOUSEHOVERWIDTH = 98 +SPI_SETMOUSEHOVERWIDTH = 99 +SPI_GETMOUSEHOVERHEIGHT = 100 +SPI_SETMOUSEHOVERHEIGHT = 101 +SPI_GETMOUSEHOVERTIME = 102 +SPI_SETMOUSEHOVERTIME = 103 +SPI_GETWHEELSCROLLLINES = 104 +SPI_SETWHEELSCROLLLINES = 105 +SPI_GETMENUSHOWDELAY = 106 +SPI_SETMENUSHOWDELAY = 107 + +SPI_GETSHOWIMEUI = 110 +SPI_SETSHOWIMEUI = 111 +SPI_GETMOUSESPEED = 112 +SPI_SETMOUSESPEED = 113 +SPI_GETSCREENSAVERRUNNING = 114 +SPI_GETDESKWALLPAPER = 115 + +SPI_GETACTIVEWINDOWTRACKING = 4096 +SPI_SETACTIVEWINDOWTRACKING = 4097 +SPI_GETMENUANIMATION = 4098 +SPI_SETMENUANIMATION = 4099 +SPI_GETCOMBOBOXANIMATION = 4100 +SPI_SETCOMBOBOXANIMATION = 4101 +SPI_GETLISTBOXSMOOTHSCROLLING = 4102 +SPI_SETLISTBOXSMOOTHSCROLLING = 4103 +SPI_GETGRADIENTCAPTIONS = 4104 +SPI_SETGRADIENTCAPTIONS = 4105 +SPI_GETKEYBOARDCUES = 4106 +SPI_SETKEYBOARDCUES = 4107 +SPI_GETMENUUNDERLINES = 4106 +SPI_SETMENUUNDERLINES = 4107 +SPI_GETACTIVEWNDTRKZORDER = 4108 +SPI_SETACTIVEWNDTRKZORDER = 4109 +SPI_GETHOTTRACKING = 4110 +SPI_SETHOTTRACKING = 4111 + +SPI_GETMENUFADE = 4114 +SPI_SETMENUFADE = 4115 +SPI_GETSELECTIONFADE = 4116 +SPI_SETSELECTIONFADE = 4117 +SPI_GETTOOLTIPANIMATION = 4118 +SPI_SETTOOLTIPANIMATION = 4119 +SPI_GETTOOLTIPFADE = 4120 +SPI_SETTOOLTIPFADE = 4121 +SPI_GETCURSORSHADOW = 4122 +SPI_SETCURSORSHADOW = 4123 +SPI_GETMOUSESONAR = 4124 +SPI_SETMOUSESONAR = 4125 +SPI_GETMOUSECLICKLOCK = 4126 +SPI_SETMOUSECLICKLOCK = 4127 +SPI_GETMOUSEVANISH = 4128 +SPI_SETMOUSEVANISH = 4129 +SPI_GETFLATMENU = 4130 +SPI_SETFLATMENU = 4131 +SPI_GETDROPSHADOW = 4132 +SPI_SETDROPSHADOW = 4133 +SPI_GETBLOCKSENDINPUTRESETS = 4134 +SPI_SETBLOCKSENDINPUTRESETS = 4135 +SPI_GETUIEFFECTS = 4158 +SPI_SETUIEFFECTS = 4159 + +SPI_GETFOREGROUNDLOCKTIMEOUT = 8192 +SPI_SETFOREGROUNDLOCKTIMEOUT = 8193 +SPI_GETACTIVEWNDTRKTIMEOUT = 8194 +SPI_SETACTIVEWNDTRKTIMEOUT = 8195 +SPI_GETFOREGROUNDFLASHCOUNT = 8196 +SPI_SETFOREGROUNDFLASHCOUNT = 8197 +SPI_GETCARETWIDTH = 8198 +SPI_SETCARETWIDTH = 8199 +SPI_GETMOUSECLICKLOCKTIME = 8200 +SPI_SETMOUSECLICKLOCKTIME = 8201 +SPI_GETFONTSMOOTHINGTYPE = 8202 +SPI_SETFONTSMOOTHINGTYPE = 8203 +SPI_GETFONTSMOOTHINGCONTRAST = 8204 +SPI_SETFONTSMOOTHINGCONTRAST = 8205 +SPI_GETFOCUSBORDERWIDTH = 8206 +SPI_SETFOCUSBORDERWIDTH = 8207 +SPI_GETFOCUSBORDERHEIGHT = 8208 +SPI_SETFOCUSBORDERHEIGHT = 8209 +SPI_GETFONTSMOOTHINGORIENTATION = 8210 +SPI_SETFONTSMOOTHINGORIENTATION = 8211 + +# fWinIni flags for SystemParametersInfo +SPIF_UPDATEINIFILE = 1 +SPIF_SENDWININICHANGE = 2 +SPIF_SENDCHANGE = SPIF_SENDWININICHANGE + +# used with SystemParametersInfo and SPI_GETFONTSMOOTHINGTYPE/SPI_SETFONTSMOOTHINGTYPE +FE_FONTSMOOTHINGSTANDARD = 1 +FE_FONTSMOOTHINGCLEARTYPE = 2 +FE_FONTSMOOTHINGDOCKING = 32768 + +METRICS_USEDEFAULT = -1 +ARW_BOTTOMLEFT = 0 +ARW_BOTTOMRIGHT = 1 +ARW_TOPLEFT = 2 +ARW_TOPRIGHT = 3 +ARW_STARTMASK = 3 +ARW_STARTRIGHT = 1 +ARW_STARTTOP = 2 +ARW_LEFT = 0 +ARW_RIGHT = 0 +ARW_UP = 4 +ARW_DOWN = 4 +ARW_HIDE = 8 +# ARW_VALID = 0x000F +SERKF_SERIALKEYSON = 1 +SERKF_AVAILABLE = 2 +SERKF_INDICATOR = 4 +HCF_HIGHCONTRASTON = 1 +HCF_AVAILABLE = 2 +HCF_HOTKEYACTIVE = 4 +HCF_CONFIRMHOTKEY = 8 +HCF_HOTKEYSOUND = 16 +HCF_INDICATOR = 32 +HCF_HOTKEYAVAILABLE = 64 +CDS_UPDATEREGISTRY = 1 +CDS_TEST = 2 +CDS_FULLSCREEN = 4 +CDS_GLOBAL = 8 +CDS_SET_PRIMARY = 16 +CDS_RESET = 1073741824 +CDS_SETRECT = 536870912 +CDS_NORESET = 268435456 + +# return values from ChangeDisplaySettings and ChangeDisplaySettingsEx +DISP_CHANGE_SUCCESSFUL = 0 +DISP_CHANGE_RESTART = 1 +DISP_CHANGE_FAILED = -1 +DISP_CHANGE_BADMODE = -2 +DISP_CHANGE_NOTUPDATED = -3 +DISP_CHANGE_BADFLAGS = -4 +DISP_CHANGE_BADPARAM = -5 +DISP_CHANGE_BADDUALVIEW = -6 + +ENUM_CURRENT_SETTINGS = -1 +ENUM_REGISTRY_SETTINGS = -2 +FKF_FILTERKEYSON = 1 +FKF_AVAILABLE = 2 +FKF_HOTKEYACTIVE = 4 +FKF_CONFIRMHOTKEY = 8 +FKF_HOTKEYSOUND = 16 +FKF_INDICATOR = 32 +FKF_CLICKON = 64 +SKF_STICKYKEYSON = 1 +SKF_AVAILABLE = 2 +SKF_HOTKEYACTIVE = 4 +SKF_CONFIRMHOTKEY = 8 +SKF_HOTKEYSOUND = 16 +SKF_INDICATOR = 32 +SKF_AUDIBLEFEEDBACK = 64 +SKF_TRISTATE = 128 +SKF_TWOKEYSOFF = 256 +SKF_LALTLATCHED = 268435456 +SKF_LCTLLATCHED = 67108864 +SKF_LSHIFTLATCHED = 16777216 +SKF_RALTLATCHED = 536870912 +SKF_RCTLLATCHED = 134217728 +SKF_RSHIFTLATCHED = 33554432 +SKF_LWINLATCHED = 1073741824 +SKF_RWINLATCHED = -2147483648 +SKF_LALTLOCKED = 1048576 +SKF_LCTLLOCKED = 262144 +SKF_LSHIFTLOCKED = 65536 +SKF_RALTLOCKED = 2097152 +SKF_RCTLLOCKED = 524288 +SKF_RSHIFTLOCKED = 131072 +SKF_LWINLOCKED = 4194304 +SKF_RWINLOCKED = 8388608 +MKF_MOUSEKEYSON = 1 +MKF_AVAILABLE = 2 +MKF_HOTKEYACTIVE = 4 +MKF_CONFIRMHOTKEY = 8 +MKF_HOTKEYSOUND = 16 +MKF_INDICATOR = 32 +MKF_MODIFIERS = 64 +MKF_REPLACENUMBERS = 128 +MKF_LEFTBUTTONSEL = 268435456 +MKF_RIGHTBUTTONSEL = 536870912 +MKF_LEFTBUTTONDOWN = 16777216 +MKF_RIGHTBUTTONDOWN = 33554432 +MKF_MOUSEMODE = -2147483648 +ATF_TIMEOUTON = 1 +ATF_ONOFFFEEDBACK = 2 +SSGF_NONE = 0 +SSGF_DISPLAY = 3 +SSTF_NONE = 0 +SSTF_CHARS = 1 +SSTF_BORDER = 2 +SSTF_DISPLAY = 3 +SSWF_NONE = 0 +SSWF_TITLE = 1 +SSWF_WINDOW = 2 +SSWF_DISPLAY = 3 +SSWF_CUSTOM = 4 +SSF_SOUNDSENTRYON = 1 +SSF_AVAILABLE = 2 +SSF_INDICATOR = 4 +TKF_TOGGLEKEYSON = 1 +TKF_AVAILABLE = 2 +TKF_HOTKEYACTIVE = 4 +TKF_CONFIRMHOTKEY = 8 +TKF_HOTKEYSOUND = 16 +TKF_INDICATOR = 32 +SLE_ERROR = 1 +SLE_MINORERROR = 2 +SLE_WARNING = 3 +MONITOR_DEFAULTTONULL = 0 +MONITOR_DEFAULTTOPRIMARY = 1 +MONITOR_DEFAULTTONEAREST = 2 +MONITORINFOF_PRIMARY = 1 +CCHDEVICENAME = 32 +CHILDID_SELF = 0 +INDEXID_OBJECT = 0 +INDEXID_CONTAINER = 0 +OBJID_WINDOW = 0 +OBJID_SYSMENU = -1 +OBJID_TITLEBAR = -2 +OBJID_MENU = -3 +OBJID_CLIENT = -4 +OBJID_VSCROLL = -5 +OBJID_HSCROLL = -6 +OBJID_SIZEGRIP = -7 +OBJID_CARET = -8 +OBJID_CURSOR = -9 +OBJID_ALERT = -10 +OBJID_SOUND = -11 +EVENT_MIN = 1 +EVENT_MAX = 2147483647 +EVENT_SYSTEM_SOUND = 1 +EVENT_SYSTEM_ALERT = 2 +EVENT_SYSTEM_FOREGROUND = 3 +EVENT_SYSTEM_MENUSTART = 4 +EVENT_SYSTEM_MENUEND = 5 +EVENT_SYSTEM_MENUPOPUPSTART = 6 +EVENT_SYSTEM_MENUPOPUPEND = 7 +EVENT_SYSTEM_CAPTURESTART = 8 +EVENT_SYSTEM_CAPTUREEND = 9 +EVENT_SYSTEM_MOVESIZESTART = 10 +EVENT_SYSTEM_MOVESIZEEND = 11 +EVENT_SYSTEM_CONTEXTHELPSTART = 12 +EVENT_SYSTEM_CONTEXTHELPEND = 13 +EVENT_SYSTEM_DRAGDROPSTART = 14 +EVENT_SYSTEM_DRAGDROPEND = 15 +EVENT_SYSTEM_DIALOGSTART = 16 +EVENT_SYSTEM_DIALOGEND = 17 +EVENT_SYSTEM_SCROLLINGSTART = 18 +EVENT_SYSTEM_SCROLLINGEND = 19 +EVENT_SYSTEM_SWITCHSTART = 20 +EVENT_SYSTEM_SWITCHEND = 21 +EVENT_SYSTEM_MINIMIZESTART = 22 +EVENT_SYSTEM_MINIMIZEEND = 23 +EVENT_OBJECT_CREATE = 32768 +EVENT_OBJECT_DESTROY = 32769 +EVENT_OBJECT_SHOW = 32770 +EVENT_OBJECT_HIDE = 32771 +EVENT_OBJECT_REORDER = 32772 +EVENT_OBJECT_FOCUS = 32773 +EVENT_OBJECT_SELECTION = 32774 +EVENT_OBJECT_SELECTIONADD = 32775 +EVENT_OBJECT_SELECTIONREMOVE = 32776 +EVENT_OBJECT_SELECTIONWITHIN = 32777 +EVENT_OBJECT_STATECHANGE = 32778 +EVENT_OBJECT_LOCATIONCHANGE = 32779 +EVENT_OBJECT_NAMECHANGE = 32780 +EVENT_OBJECT_DESCRIPTIONCHANGE = 32781 +EVENT_OBJECT_VALUECHANGE = 32782 +EVENT_OBJECT_PARENTCHANGE = 32783 +EVENT_OBJECT_HELPCHANGE = 32784 +EVENT_OBJECT_DEFACTIONCHANGE = 32785 +EVENT_OBJECT_ACCELERATORCHANGE = 32786 +SOUND_SYSTEM_STARTUP = 1 +SOUND_SYSTEM_SHUTDOWN = 2 +SOUND_SYSTEM_BEEP = 3 +SOUND_SYSTEM_ERROR = 4 +SOUND_SYSTEM_QUESTION = 5 +SOUND_SYSTEM_WARNING = 6 +SOUND_SYSTEM_INFORMATION = 7 +SOUND_SYSTEM_MAXIMIZE = 8 +SOUND_SYSTEM_MINIMIZE = 9 +SOUND_SYSTEM_RESTOREUP = 10 +SOUND_SYSTEM_RESTOREDOWN = 11 +SOUND_SYSTEM_APPSTART = 12 +SOUND_SYSTEM_FAULT = 13 +SOUND_SYSTEM_APPEND = 14 +SOUND_SYSTEM_MENUCOMMAND = 15 +SOUND_SYSTEM_MENUPOPUP = 16 +CSOUND_SYSTEM = 16 +ALERT_SYSTEM_INFORMATIONAL = 1 +ALERT_SYSTEM_WARNING = 2 +ALERT_SYSTEM_ERROR = 3 +ALERT_SYSTEM_QUERY = 4 +ALERT_SYSTEM_CRITICAL = 5 +CALERT_SYSTEM = 6 +WINEVENT_OUTOFCONTEXT = 0 +WINEVENT_SKIPOWNTHREAD = 1 +WINEVENT_SKIPOWNPROCESS = 2 +WINEVENT_INCONTEXT = 4 +GUI_CARETBLINKING = 1 +GUI_INMOVESIZE = 2 +GUI_INMENUMODE = 4 +GUI_SYSTEMMENUMODE = 8 +GUI_POPUPMENUMODE = 16 +STATE_SYSTEM_UNAVAILABLE = 1 +STATE_SYSTEM_SELECTED = 2 +STATE_SYSTEM_FOCUSED = 4 +STATE_SYSTEM_PRESSED = 8 +STATE_SYSTEM_CHECKED = 16 +STATE_SYSTEM_MIXED = 32 +STATE_SYSTEM_READONLY = 64 +STATE_SYSTEM_HOTTRACKED = 128 +STATE_SYSTEM_DEFAULT = 256 +STATE_SYSTEM_EXPANDED = 512 +STATE_SYSTEM_COLLAPSED = 1024 +STATE_SYSTEM_BUSY = 2048 +STATE_SYSTEM_FLOATING = 4096 +STATE_SYSTEM_MARQUEED = 8192 +STATE_SYSTEM_ANIMATED = 16384 +STATE_SYSTEM_INVISIBLE = 32768 +STATE_SYSTEM_OFFSCREEN = 65536 +STATE_SYSTEM_SIZEABLE = 131072 +STATE_SYSTEM_MOVEABLE = 262144 +STATE_SYSTEM_SELFVOICING = 524288 +STATE_SYSTEM_FOCUSABLE = 1048576 +STATE_SYSTEM_SELECTABLE = 2097152 +STATE_SYSTEM_LINKED = 4194304 +STATE_SYSTEM_TRAVERSED = 8388608 +STATE_SYSTEM_MULTISELECTABLE = 16777216 +STATE_SYSTEM_EXTSELECTABLE = 33554432 +STATE_SYSTEM_ALERT_LOW = 67108864 +STATE_SYSTEM_ALERT_MEDIUM = 134217728 +STATE_SYSTEM_ALERT_HIGH = 268435456 +STATE_SYSTEM_VALID = 536870911 +CCHILDREN_TITLEBAR = 5 +CCHILDREN_SCROLLBAR = 5 +CURSOR_SHOWING = 1 +WS_ACTIVECAPTION = 1 +GA_MIC = 1 +GA_PARENT = 1 +GA_ROOT = 2 +GA_ROOTOWNER = 3 +GA_MAC = 4 + +# winuser.h line 1979 +BF_LEFT = 1 +BF_TOP = 2 +BF_RIGHT = 4 +BF_BOTTOM = 8 +BF_TOPLEFT = BF_TOP | BF_LEFT +BF_TOPRIGHT = BF_TOP | BF_RIGHT +BF_BOTTOMLEFT = BF_BOTTOM | BF_LEFT +BF_BOTTOMRIGHT = BF_BOTTOM | BF_RIGHT +BF_RECT = BF_LEFT | BF_TOP | BF_RIGHT | BF_BOTTOM +BF_DIAGONAL = 16 +BF_DIAGONAL_ENDTOPRIGHT = BF_DIAGONAL | BF_TOP | BF_RIGHT +BF_DIAGONAL_ENDTOPLEFT = BF_DIAGONAL | BF_TOP | BF_LEFT +BF_DIAGONAL_ENDBOTTOMLEFT = BF_DIAGONAL | BF_BOTTOM | BF_LEFT +BF_DIAGONAL_ENDBOTTOMRIGHT = BF_DIAGONAL | BF_BOTTOM | BF_RIGHT +BF_MIDDLE = 2048 +BF_SOFT = 4096 +BF_ADJUST = 8192 +BF_FLAT = 16384 +BF_MONO = 32768 +DFC_CAPTION = 1 +DFC_MENU = 2 +DFC_SCROLL = 3 +DFC_BUTTON = 4 +DFC_POPUPMENU = 5 +DFCS_CAPTIONCLOSE = 0 +DFCS_CAPTIONMIN = 1 +DFCS_CAPTIONMAX = 2 +DFCS_CAPTIONRESTORE = 3 +DFCS_CAPTIONHELP = 4 +DFCS_MENUARROW = 0 +DFCS_MENUCHECK = 1 +DFCS_MENUBULLET = 2 +DFCS_MENUARROWRIGHT = 4 +DFCS_SCROLLUP = 0 +DFCS_SCROLLDOWN = 1 +DFCS_SCROLLLEFT = 2 +DFCS_SCROLLRIGHT = 3 +DFCS_SCROLLCOMBOBOX = 5 +DFCS_SCROLLSIZEGRIP = 8 +DFCS_SCROLLSIZEGRIPRIGHT = 16 +DFCS_BUTTONCHECK = 0 +DFCS_BUTTONRADIOIMAGE = 1 +DFCS_BUTTONRADIOMASK = 2 +DFCS_BUTTONRADIO = 4 +DFCS_BUTTON3STATE = 8 +DFCS_BUTTONPUSH = 16 +DFCS_INACTIVE = 256 +DFCS_PUSHED = 512 +DFCS_CHECKED = 1024 +DFCS_TRANSPARENT = 2048 +DFCS_HOT = 4096 +DFCS_ADJUSTRECT = 8192 +DFCS_FLAT = 16384 +DFCS_MONO = 32768 +DC_ACTIVE = 1 +DC_SMALLCAP = 2 +DC_ICON = 4 +DC_TEXT = 8 +DC_INBUTTON = 16 +DC_GRADIENT = 32 +IDANI_OPEN = 1 +IDANI_CLOSE = 2 +IDANI_CAPTION = 3 +CF_TEXT = 1 +CF_BITMAP = 2 +CF_METAFILEPICT = 3 +CF_SYLK = 4 +CF_DIF = 5 +CF_TIFF = 6 +CF_OEMTEXT = 7 +CF_DIB = 8 +CF_PALETTE = 9 +CF_PENDATA = 10 +CF_RIFF = 11 +CF_WAVE = 12 +CF_UNICODETEXT = 13 +CF_ENHMETAFILE = 14 +CF_HDROP = 15 +CF_LOCALE = 16 +CF_DIBV5 = 17 +CF_MAX = 18 +CF_OWNERDISPLAY = 128 +CF_DSPTEXT = 129 +CF_DSPBITMAP = 130 +CF_DSPMETAFILEPICT = 131 +CF_DSPENHMETAFILE = 142 +CF_PRIVATEFIRST = 512 +CF_PRIVATELAST = 767 +CF_GDIOBJFIRST = 768 +CF_GDIOBJLAST = 1023 +FVIRTKEY = 1 +FNOINVERT = 2 +FSHIFT = 4 +FCONTROL = 8 +FALT = 16 +WPF_SETMINPOSITION = 1 +WPF_RESTORETOMAXIMIZED = 2 +ODT_MENU = 1 +ODT_LISTBOX = 2 +ODT_COMBOBOX = 3 +ODT_BUTTON = 4 +ODT_STATIC = 5 +ODA_DRAWENTIRE = 1 +ODA_SELECT = 2 +ODA_FOCUS = 4 +ODS_SELECTED = 1 +ODS_GRAYED = 2 +ODS_DISABLED = 4 +ODS_CHECKED = 8 +ODS_FOCUS = 16 +ODS_DEFAULT = 32 +ODS_COMBOBOXEDIT = 4096 +ODS_HOTLIGHT = 64 +ODS_INACTIVE = 128 +PM_NOREMOVE = 0 +PM_REMOVE = 1 +PM_NOYIELD = 2 +MOD_ALT = 1 +MOD_CONTROL = 2 +MOD_SHIFT = 4 +MOD_WIN = 8 +IDHOT_SNAPWINDOW = -1 +IDHOT_SNAPDESKTOP = -2 +# EW_RESTARTWINDOWS = 0x0042 +# EW_REBOOTSYSTEM = 0x0043 +# EW_EXITANDEXECAPP = 0x0044 +ENDSESSION_LOGOFF = -2147483648 +EWX_LOGOFF = 0 +EWX_SHUTDOWN = 1 +EWX_REBOOT = 2 +EWX_FORCE = 4 +EWX_POWEROFF = 8 +EWX_FORCEIFHUNG = 16 +BSM_ALLCOMPONENTS = 0 +BSM_VXDS = 1 +BSM_NETDRIVER = 2 +BSM_INSTALLABLEDRIVERS = 4 +BSM_APPLICATIONS = 8 +BSM_ALLDESKTOPS = 16 +BSF_QUERY = 1 +BSF_IGNORECURRENTTASK = 2 +BSF_FLUSHDISK = 4 +BSF_NOHANG = 8 +BSF_POSTMESSAGE = 16 +BSF_FORCEIFHUNG = 32 +BSF_NOTIMEOUTIFNOTHUNG = 64 +BROADCAST_QUERY_DENY = 1112363332 # Return this value to deny a query. + +DBWF_LPARAMPOINTER = 32768 + +# winuser.h line 3232 +SWP_NOSIZE = 1 +SWP_NOMOVE = 2 +SWP_NOZORDER = 4 +SWP_NOREDRAW = 8 +SWP_NOACTIVATE = 16 +SWP_FRAMECHANGED = 32 +SWP_SHOWWINDOW = 64 +SWP_HIDEWINDOW = 128 +SWP_NOCOPYBITS = 256 +SWP_NOOWNERZORDER = 512 +SWP_NOSENDCHANGING = 1024 +SWP_DRAWFRAME = SWP_FRAMECHANGED +SWP_NOREPOSITION = SWP_NOOWNERZORDER +SWP_DEFERERASE = 8192 +SWP_ASYNCWINDOWPOS = 16384 + +DLGWINDOWEXTRA = 30 +# winuser.h line 4249 +KEYEVENTF_EXTENDEDKEY = 1 +KEYEVENTF_KEYUP = 2 +# if(_WIN32_WINNT >= 0x0500) +KEYEVENTF_UNICODE = 4 +KEYEVENTF_SCANCODE = 8 +# endif /* _WIN32_WINNT >= 0x0500 */ +MOUSEEVENTF_MOVE = 1 +MOUSEEVENTF_LEFTDOWN = 2 +MOUSEEVENTF_LEFTUP = 4 +MOUSEEVENTF_RIGHTDOWN = 8 +MOUSEEVENTF_RIGHTUP = 16 +MOUSEEVENTF_MIDDLEDOWN = 32 +MOUSEEVENTF_MIDDLEUP = 64 +MOUSEEVENTF_XDOWN = 128 +MOUSEEVENTF_XUP = 256 +MOUSEEVENTF_WHEEL = 2048 +# if (_WIN32_WINNT >= 0x0600) +MOUSEEVENTF_HWHEEL = 4096 +# endif +# if(WINVER >= 0x0600) +MOUSEEVENTF_MOVE_NOCOALESCE = 8192 +# endif /* WINVER >= 0x0600 */ +MOUSEEVENTF_VIRTUALDESK = 16384 +MOUSEEVENTF_ABSOLUTE = 32768 +INPUT_MOUSE = 0 +INPUT_KEYBOARD = 1 +INPUT_HARDWARE = 2 +MWMO_WAITALL = 1 +MWMO_ALERTABLE = 2 +MWMO_INPUTAVAILABLE = 4 +QS_KEY = 1 +QS_MOUSEMOVE = 2 +QS_MOUSEBUTTON = 4 +QS_POSTMESSAGE = 8 +QS_TIMER = 16 +QS_PAINT = 32 +QS_SENDMESSAGE = 64 +QS_HOTKEY = 128 +QS_MOUSE = QS_MOUSEMOVE | QS_MOUSEBUTTON +QS_INPUT = QS_MOUSE | QS_KEY +QS_ALLEVENTS = QS_INPUT | QS_POSTMESSAGE | QS_TIMER | QS_PAINT | QS_HOTKEY +QS_ALLINPUT = ( + QS_INPUT | QS_POSTMESSAGE | QS_TIMER | QS_PAINT | QS_HOTKEY | QS_SENDMESSAGE +) + + +IMN_CLOSESTATUSWINDOW = 1 +IMN_OPENSTATUSWINDOW = 2 +IMN_CHANGECANDIDATE = 3 +IMN_CLOSECANDIDATE = 4 +IMN_OPENCANDIDATE = 5 +IMN_SETCONVERSIONMODE = 6 +IMN_SETSENTENCEMODE = 7 +IMN_SETOPENSTATUS = 8 +IMN_SETCANDIDATEPOS = 9 +IMN_SETCOMPOSITIONFONT = 10 +IMN_SETCOMPOSITIONWINDOW = 11 +IMN_SETSTATUSWINDOWPOS = 12 +IMN_GUIDELINE = 13 +IMN_PRIVATE = 14 + +# winuser.h line 8518 +HELP_CONTEXT = 1 +HELP_QUIT = 2 +HELP_INDEX = 3 +HELP_CONTENTS = 3 +HELP_HELPONHELP = 4 +HELP_SETINDEX = 5 +HELP_SETCONTENTS = 5 +HELP_CONTEXTPOPUP = 8 +HELP_FORCEFILE = 9 +HELP_KEY = 257 +HELP_COMMAND = 258 +HELP_PARTIALKEY = 261 +HELP_MULTIKEY = 513 +HELP_SETWINPOS = 515 +HELP_CONTEXTMENU = 10 +HELP_FINDER = 11 +HELP_WM_HELP = 12 +HELP_SETPOPUP_POS = 13 +HELP_TCARD = 32768 +HELP_TCARD_DATA = 16 +HELP_TCARD_OTHER_CALLER = 17 +IDH_NO_HELP = 28440 +IDH_MISSING_CONTEXT = 28441 # Control doesn't have matching help context +IDH_GENERIC_HELP_BUTTON = 28442 # Property sheet help button +IDH_OK = 28443 +IDH_CANCEL = 28444 +IDH_HELP = 28445 +GR_GDIOBJECTS = 0 # Count of GDI objects +GR_USEROBJECTS = 1 # Count of USER objects +# Generated by h2py from \msvcnt\include\wingdi.h +# manually added (missed by generation some how! +SRCCOPY = 13369376 # dest = source +SRCPAINT = 15597702 # dest = source OR dest +SRCAND = 8913094 # dest = source AND dest +SRCINVERT = 6684742 # dest = source XOR dest +SRCERASE = 4457256 # dest = source AND (NOT dest ) +NOTSRCCOPY = 3342344 # dest = (NOT source) +NOTSRCERASE = 1114278 # dest = (NOT src) AND (NOT dest) +MERGECOPY = 12583114 # dest = (source AND pattern) +MERGEPAINT = 12255782 # dest = (NOT source) OR dest +PATCOPY = 15728673 # dest = pattern +PATPAINT = 16452105 # dest = DPSnoo +PATINVERT = 5898313 # dest = pattern XOR dest +DSTINVERT = 5570569 # dest = (NOT dest) +BLACKNESS = 66 # dest = BLACK +WHITENESS = 16711778 # dest = WHITE + +# hacked and split manually by mhammond. +R2_BLACK = 1 +R2_NOTMERGEPEN = 2 +R2_MASKNOTPEN = 3 +R2_NOTCOPYPEN = 4 +R2_MASKPENNOT = 5 +R2_NOT = 6 +R2_XORPEN = 7 +R2_NOTMASKPEN = 8 +R2_MASKPEN = 9 +R2_NOTXORPEN = 10 +R2_NOP = 11 +R2_MERGENOTPEN = 12 +R2_COPYPEN = 13 +R2_MERGEPENNOT = 14 +R2_MERGEPEN = 15 +R2_WHITE = 16 +R2_LAST = 16 +GDI_ERROR = -1 +ERROR = 0 +NULLREGION = 1 +SIMPLEREGION = 2 +COMPLEXREGION = 3 +RGN_ERROR = ERROR +RGN_AND = 1 +RGN_OR = 2 +RGN_XOR = 3 +RGN_DIFF = 4 +RGN_COPY = 5 +RGN_MIN = RGN_AND +RGN_MAX = RGN_COPY + +## Stretching modes used with Get/SetStretchBltMode +BLACKONWHITE = 1 +WHITEONBLACK = 2 +COLORONCOLOR = 3 +HALFTONE = 4 +MAXSTRETCHBLTMODE = 4 +STRETCH_ANDSCANS = BLACKONWHITE +STRETCH_ORSCANS = WHITEONBLACK +STRETCH_DELETESCANS = COLORONCOLOR +STRETCH_HALFTONE = HALFTONE + +ALTERNATE = 1 +WINDING = 2 +POLYFILL_LAST = 2 + +## flags used with SetLayout +LAYOUT_RTL = 1 +LAYOUT_BTT = 2 +LAYOUT_VBH = 4 +LAYOUT_ORIENTATIONMASK = LAYOUT_RTL | LAYOUT_BTT | LAYOUT_VBH +LAYOUT_BITMAPORIENTATIONPRESERVED = 8 + +TA_NOUPDATECP = 0 +TA_UPDATECP = 1 +TA_LEFT = 0 +TA_RIGHT = 2 +TA_CENTER = 6 +TA_TOP = 0 +TA_BOTTOM = 8 +TA_BASELINE = 24 +TA_MASK = TA_BASELINE + TA_CENTER + TA_UPDATECP +VTA_BASELINE = TA_BASELINE +VTA_LEFT = TA_BOTTOM +VTA_RIGHT = TA_TOP +VTA_CENTER = TA_CENTER +VTA_BOTTOM = TA_RIGHT +VTA_TOP = TA_LEFT +ETO_GRAYED = 1 +ETO_OPAQUE = 2 +ETO_CLIPPED = 4 +ASPECT_FILTERING = 1 +DCB_RESET = 1 +DCB_ACCUMULATE = 2 +DCB_DIRTY = DCB_ACCUMULATE +DCB_SET = DCB_RESET | DCB_ACCUMULATE +DCB_ENABLE = 4 +DCB_DISABLE = 8 +META_SETBKCOLOR = 513 +META_SETBKMODE = 258 +META_SETMAPMODE = 259 +META_SETROP2 = 260 +META_SETRELABS = 261 +META_SETPOLYFILLMODE = 262 +META_SETSTRETCHBLTMODE = 263 +META_SETTEXTCHAREXTRA = 264 +META_SETTEXTCOLOR = 521 +META_SETTEXTJUSTIFICATION = 522 +META_SETWINDOWORG = 523 +META_SETWINDOWEXT = 524 +META_SETVIEWPORTORG = 525 +META_SETVIEWPORTEXT = 526 +META_OFFSETWINDOWORG = 527 +META_SCALEWINDOWEXT = 1040 +META_OFFSETVIEWPORTORG = 529 +META_SCALEVIEWPORTEXT = 1042 +META_LINETO = 531 +META_MOVETO = 532 +META_EXCLUDECLIPRECT = 1045 +META_INTERSECTCLIPRECT = 1046 +META_ARC = 2071 +META_ELLIPSE = 1048 +META_FLOODFILL = 1049 +META_PIE = 2074 +META_RECTANGLE = 1051 +META_ROUNDRECT = 1564 +META_PATBLT = 1565 +META_SAVEDC = 30 +META_SETPIXEL = 1055 +META_OFFSETCLIPRGN = 544 +META_TEXTOUT = 1313 +META_BITBLT = 2338 +META_STRETCHBLT = 2851 +META_POLYGON = 804 +META_POLYLINE = 805 +META_ESCAPE = 1574 +META_RESTOREDC = 295 +META_FILLREGION = 552 +META_FRAMEREGION = 1065 +META_INVERTREGION = 298 +META_PAINTREGION = 299 +META_SELECTCLIPREGION = 300 +META_SELECTOBJECT = 301 +META_SETTEXTALIGN = 302 +META_CHORD = 2096 +META_SETMAPPERFLAGS = 561 +META_EXTTEXTOUT = 2610 +META_SETDIBTODEV = 3379 +META_SELECTPALETTE = 564 +META_REALIZEPALETTE = 53 +META_ANIMATEPALETTE = 1078 +META_SETPALENTRIES = 55 +META_POLYPOLYGON = 1336 +META_RESIZEPALETTE = 313 +META_DIBBITBLT = 2368 +META_DIBSTRETCHBLT = 2881 +META_DIBCREATEPATTERNBRUSH = 322 +META_STRETCHDIB = 3907 +META_EXTFLOODFILL = 1352 +META_DELETEOBJECT = 496 +META_CREATEPALETTE = 247 +META_CREATEPATTERNBRUSH = 505 +META_CREATEPENINDIRECT = 762 +META_CREATEFONTINDIRECT = 763 +META_CREATEBRUSHINDIRECT = 764 +META_CREATEREGION = 1791 +FILE_BEGIN = 0 +FILE_CURRENT = 1 +FILE_END = 2 +FILE_FLAG_WRITE_THROUGH = -2147483648 +FILE_FLAG_OVERLAPPED = 1073741824 +FILE_FLAG_NO_BUFFERING = 536870912 +FILE_FLAG_RANDOM_ACCESS = 268435456 +FILE_FLAG_SEQUENTIAL_SCAN = 134217728 +FILE_FLAG_DELETE_ON_CLOSE = 67108864 +FILE_FLAG_BACKUP_SEMANTICS = 33554432 +FILE_FLAG_POSIX_SEMANTICS = 16777216 +CREATE_NEW = 1 +CREATE_ALWAYS = 2 +OPEN_EXISTING = 3 +OPEN_ALWAYS = 4 +TRUNCATE_EXISTING = 5 +PIPE_ACCESS_INBOUND = 1 +PIPE_ACCESS_OUTBOUND = 2 +PIPE_ACCESS_DUPLEX = 3 +PIPE_CLIENT_END = 0 +PIPE_SERVER_END = 1 +PIPE_WAIT = 0 +PIPE_NOWAIT = 1 +PIPE_READMODE_BYTE = 0 +PIPE_READMODE_MESSAGE = 2 +PIPE_TYPE_BYTE = 0 +PIPE_TYPE_MESSAGE = 4 +PIPE_UNLIMITED_INSTANCES = 255 +SECURITY_CONTEXT_TRACKING = 262144 +SECURITY_EFFECTIVE_ONLY = 524288 +SECURITY_SQOS_PRESENT = 1048576 +SECURITY_VALID_SQOS_FLAGS = 2031616 +DTR_CONTROL_DISABLE = 0 +DTR_CONTROL_ENABLE = 1 +DTR_CONTROL_HANDSHAKE = 2 +RTS_CONTROL_DISABLE = 0 +RTS_CONTROL_ENABLE = 1 +RTS_CONTROL_HANDSHAKE = 2 +RTS_CONTROL_TOGGLE = 3 +GMEM_FIXED = 0 +GMEM_MOVEABLE = 2 +GMEM_NOCOMPACT = 16 +GMEM_NODISCARD = 32 +GMEM_ZEROINIT = 64 +GMEM_MODIFY = 128 +GMEM_DISCARDABLE = 256 +GMEM_NOT_BANKED = 4096 +GMEM_SHARE = 8192 +GMEM_DDESHARE = 8192 +GMEM_NOTIFY = 16384 +GMEM_LOWER = GMEM_NOT_BANKED +GMEM_VALID_FLAGS = 32626 +GMEM_INVALID_HANDLE = 32768 +GHND = GMEM_MOVEABLE | GMEM_ZEROINIT +GPTR = GMEM_FIXED | GMEM_ZEROINIT +GMEM_DISCARDED = 16384 +GMEM_LOCKCOUNT = 255 +LMEM_FIXED = 0 +LMEM_MOVEABLE = 2 +LMEM_NOCOMPACT = 16 +LMEM_NODISCARD = 32 +LMEM_ZEROINIT = 64 +LMEM_MODIFY = 128 +LMEM_DISCARDABLE = 3840 +LMEM_VALID_FLAGS = 3954 +LMEM_INVALID_HANDLE = 32768 +LHND = LMEM_MOVEABLE | LMEM_ZEROINIT +LPTR = LMEM_FIXED | LMEM_ZEROINIT +NONZEROLHND = LMEM_MOVEABLE +NONZEROLPTR = LMEM_FIXED +LMEM_DISCARDED = 16384 +LMEM_LOCKCOUNT = 255 +DEBUG_PROCESS = 1 +DEBUG_ONLY_THIS_PROCESS = 2 +CREATE_SUSPENDED = 4 +DETACHED_PROCESS = 8 +CREATE_NEW_CONSOLE = 16 +NORMAL_PRIORITY_CLASS = 32 +IDLE_PRIORITY_CLASS = 64 +HIGH_PRIORITY_CLASS = 128 +REALTIME_PRIORITY_CLASS = 256 +CREATE_NEW_PROCESS_GROUP = 512 +CREATE_UNICODE_ENVIRONMENT = 1024 +CREATE_SEPARATE_WOW_VDM = 2048 +CREATE_SHARED_WOW_VDM = 4096 +CREATE_DEFAULT_ERROR_MODE = 67108864 +CREATE_NO_WINDOW = 134217728 +PROFILE_USER = 268435456 +PROFILE_KERNEL = 536870912 +PROFILE_SERVER = 1073741824 +THREAD_BASE_PRIORITY_LOWRT = 15 +THREAD_BASE_PRIORITY_MAX = 2 +THREAD_BASE_PRIORITY_MIN = -2 +THREAD_BASE_PRIORITY_IDLE = -15 +THREAD_PRIORITY_LOWEST = THREAD_BASE_PRIORITY_MIN +THREAD_PRIORITY_BELOW_NORMAL = THREAD_PRIORITY_LOWEST + 1 +THREAD_PRIORITY_HIGHEST = THREAD_BASE_PRIORITY_MAX +THREAD_PRIORITY_ABOVE_NORMAL = THREAD_PRIORITY_HIGHEST - 1 +THREAD_PRIORITY_ERROR_RETURN = MAXLONG +THREAD_PRIORITY_TIME_CRITICAL = THREAD_BASE_PRIORITY_LOWRT +THREAD_PRIORITY_IDLE = THREAD_BASE_PRIORITY_IDLE +THREAD_PRIORITY_NORMAL = 0 +THREAD_MODE_BACKGROUND_BEGIN = 0x00010000 +THREAD_MODE_BACKGROUND_END = 0x00020000 + +EXCEPTION_DEBUG_EVENT = 1 +CREATE_THREAD_DEBUG_EVENT = 2 +CREATE_PROCESS_DEBUG_EVENT = 3 +EXIT_THREAD_DEBUG_EVENT = 4 +EXIT_PROCESS_DEBUG_EVENT = 5 +LOAD_DLL_DEBUG_EVENT = 6 +UNLOAD_DLL_DEBUG_EVENT = 7 +OUTPUT_DEBUG_STRING_EVENT = 8 +RIP_EVENT = 9 +DRIVE_UNKNOWN = 0 +DRIVE_NO_ROOT_DIR = 1 +DRIVE_REMOVABLE = 2 +DRIVE_FIXED = 3 +DRIVE_REMOTE = 4 +DRIVE_CDROM = 5 +DRIVE_RAMDISK = 6 +FILE_TYPE_UNKNOWN = 0 +FILE_TYPE_DISK = 1 +FILE_TYPE_CHAR = 2 +FILE_TYPE_PIPE = 3 +FILE_TYPE_REMOTE = 32768 +NOPARITY = 0 +ODDPARITY = 1 +EVENPARITY = 2 +MARKPARITY = 3 +SPACEPARITY = 4 +ONESTOPBIT = 0 +ONE5STOPBITS = 1 +TWOSTOPBITS = 2 +CBR_110 = 110 +CBR_300 = 300 +CBR_600 = 600 +CBR_1200 = 1200 +CBR_2400 = 2400 +CBR_4800 = 4800 +CBR_9600 = 9600 +CBR_14400 = 14400 +CBR_19200 = 19200 +CBR_38400 = 38400 +CBR_56000 = 56000 +CBR_57600 = 57600 +CBR_115200 = 115200 +CBR_128000 = 128000 +CBR_256000 = 256000 +S_QUEUEEMPTY = 0 +S_THRESHOLD = 1 +S_ALLTHRESHOLD = 2 +S_NORMAL = 0 +S_LEGATO = 1 +S_STACCATO = 2 +NMPWAIT_WAIT_FOREVER = -1 +NMPWAIT_NOWAIT = 1 +NMPWAIT_USE_DEFAULT_WAIT = 0 +OF_READ = 0 +OF_WRITE = 1 +OF_READWRITE = 2 +OF_SHARE_COMPAT = 0 +OF_SHARE_EXCLUSIVE = 16 +OF_SHARE_DENY_WRITE = 32 +OF_SHARE_DENY_READ = 48 +OF_SHARE_DENY_NONE = 64 +OF_PARSE = 256 +OF_DELETE = 512 +OF_VERIFY = 1024 +OF_CANCEL = 2048 +OF_CREATE = 4096 +OF_PROMPT = 8192 +OF_EXIST = 16384 +OF_REOPEN = 32768 +OFS_MAXPATHNAME = 128 +MAXINTATOM = 49152 + +# winbase.h +PROCESS_HEAP_REGION = 1 +PROCESS_HEAP_UNCOMMITTED_RANGE = 2 +PROCESS_HEAP_ENTRY_BUSY = 4 +PROCESS_HEAP_ENTRY_MOVEABLE = 16 +PROCESS_HEAP_ENTRY_DDESHARE = 32 +SCS_32BIT_BINARY = 0 +SCS_DOS_BINARY = 1 +SCS_WOW_BINARY = 2 +SCS_PIF_BINARY = 3 +SCS_POSIX_BINARY = 4 +SCS_OS216_BINARY = 5 +SEM_FAILCRITICALERRORS = 1 +SEM_NOGPFAULTERRORBOX = 2 +SEM_NOALIGNMENTFAULTEXCEPT = 4 +SEM_NOOPENFILEERRORBOX = 32768 +LOCKFILE_FAIL_IMMEDIATELY = 1 +LOCKFILE_EXCLUSIVE_LOCK = 2 +HANDLE_FLAG_INHERIT = 1 +HANDLE_FLAG_PROTECT_FROM_CLOSE = 2 +HINSTANCE_ERROR = 32 +GET_TAPE_MEDIA_INFORMATION = 0 +GET_TAPE_DRIVE_INFORMATION = 1 +SET_TAPE_MEDIA_INFORMATION = 0 +SET_TAPE_DRIVE_INFORMATION = 1 +FORMAT_MESSAGE_ALLOCATE_BUFFER = 256 +FORMAT_MESSAGE_IGNORE_INSERTS = 512 +FORMAT_MESSAGE_FROM_STRING = 1024 +FORMAT_MESSAGE_FROM_HMODULE = 2048 +FORMAT_MESSAGE_FROM_SYSTEM = 4096 +FORMAT_MESSAGE_ARGUMENT_ARRAY = 8192 +FORMAT_MESSAGE_MAX_WIDTH_MASK = 255 +BACKUP_INVALID = 0 +BACKUP_DATA = 1 +BACKUP_EA_DATA = 2 +BACKUP_SECURITY_DATA = 3 +BACKUP_ALTERNATE_DATA = 4 +BACKUP_LINK = 5 +BACKUP_PROPERTY_DATA = 6 +BACKUP_OBJECT_ID = 7 +BACKUP_REPARSE_DATA = 8 +BACKUP_SPARSE_BLOCK = 9 + +STREAM_NORMAL_ATTRIBUTE = 0 +STREAM_MODIFIED_WHEN_READ = 1 +STREAM_CONTAINS_SECURITY = 2 +STREAM_CONTAINS_PROPERTIES = 4 +STARTF_USESHOWWINDOW = 1 +STARTF_USESIZE = 2 +STARTF_USEPOSITION = 4 +STARTF_USECOUNTCHARS = 8 +STARTF_USEFILLATTRIBUTE = 16 +STARTF_FORCEONFEEDBACK = 64 +STARTF_FORCEOFFFEEDBACK = 128 +STARTF_USESTDHANDLES = 256 +STARTF_USEHOTKEY = 512 +SHUTDOWN_NORETRY = 1 +DONT_RESOLVE_DLL_REFERENCES = 1 +LOAD_LIBRARY_AS_DATAFILE = 2 +LOAD_WITH_ALTERED_SEARCH_PATH = 8 +DDD_RAW_TARGET_PATH = 1 +DDD_REMOVE_DEFINITION = 2 +DDD_EXACT_MATCH_ON_REMOVE = 4 +MOVEFILE_REPLACE_EXISTING = 1 +MOVEFILE_COPY_ALLOWED = 2 +MOVEFILE_DELAY_UNTIL_REBOOT = 4 +MAX_COMPUTERNAME_LENGTH = 15 +LOGON32_LOGON_INTERACTIVE = 2 +LOGON32_LOGON_NETWORK = 3 +LOGON32_LOGON_BATCH = 4 +LOGON32_LOGON_SERVICE = 5 +LOGON32_LOGON_UNLOCK = 7 +LOGON32_LOGON_NETWORK_CLEARTEXT = 8 +LOGON32_LOGON_NEW_CREDENTIALS = 9 +LOGON32_PROVIDER_DEFAULT = 0 +LOGON32_PROVIDER_WINNT35 = 1 +LOGON32_PROVIDER_WINNT40 = 2 +LOGON32_PROVIDER_WINNT50 = 3 +VER_PLATFORM_WIN32s = 0 +VER_PLATFORM_WIN32_WINDOWS = 1 +VER_PLATFORM_WIN32_NT = 2 +TC_NORMAL = 0 +TC_HARDERR = 1 +TC_GP_TRAP = 2 +TC_SIGNAL = 3 +AC_LINE_OFFLINE = 0 +AC_LINE_ONLINE = 1 +AC_LINE_BACKUP_POWER = 2 +AC_LINE_UNKNOWN = 255 +BATTERY_FLAG_HIGH = 1 +BATTERY_FLAG_LOW = 2 +BATTERY_FLAG_CRITICAL = 4 +BATTERY_FLAG_CHARGING = 8 +BATTERY_FLAG_NO_BATTERY = 128 +BATTERY_FLAG_UNKNOWN = 255 +BATTERY_PERCENTAGE_UNKNOWN = 255 +BATTERY_LIFE_UNKNOWN = -1 + +# Generated by h2py from d:\msdev\include\richedit.h +cchTextLimitDefault = 32767 +WM_CONTEXTMENU = 123 +WM_PRINTCLIENT = 792 +EN_MSGFILTER = 1792 +EN_REQUESTRESIZE = 1793 +EN_SELCHANGE = 1794 +EN_DROPFILES = 1795 +EN_PROTECTED = 1796 +EN_CORRECTTEXT = 1797 +EN_STOPNOUNDO = 1798 +EN_IMECHANGE = 1799 +EN_SAVECLIPBOARD = 1800 +EN_OLEOPFAILED = 1801 +ENM_NONE = 0 +ENM_CHANGE = 1 +ENM_UPDATE = 2 +ENM_SCROLL = 4 +ENM_KEYEVENTS = 65536 +ENM_MOUSEEVENTS = 131072 +ENM_REQUESTRESIZE = 262144 +ENM_SELCHANGE = 524288 +ENM_DROPFILES = 1048576 +ENM_PROTECTED = 2097152 +ENM_CORRECTTEXT = 4194304 +ENM_IMECHANGE = 8388608 +ES_SAVESEL = 32768 +ES_SUNKEN = 16384 +ES_DISABLENOSCROLL = 8192 +ES_SELECTIONBAR = 16777216 +ES_EX_NOCALLOLEINIT = 16777216 +ES_VERTICAL = 4194304 +ES_NOIME = 524288 +ES_SELFIME = 262144 +ECO_AUTOWORDSELECTION = 1 +ECO_AUTOVSCROLL = 64 +ECO_AUTOHSCROLL = 128 +ECO_NOHIDESEL = 256 +ECO_READONLY = 2048 +ECO_WANTRETURN = 4096 +ECO_SAVESEL = 32768 +ECO_SELECTIONBAR = 16777216 +ECO_VERTICAL = 4194304 +ECOOP_SET = 1 +ECOOP_OR = 2 +ECOOP_AND = 3 +ECOOP_XOR = 4 +WB_CLASSIFY = 3 +WB_MOVEWORDLEFT = 4 +WB_MOVEWORDRIGHT = 5 +WB_LEFTBREAK = 6 +WB_RIGHTBREAK = 7 +WB_MOVEWORDPREV = 4 +WB_MOVEWORDNEXT = 5 +WB_PREVBREAK = 6 +WB_NEXTBREAK = 7 +PC_FOLLOWING = 1 +PC_LEADING = 2 +PC_OVERFLOW = 3 +PC_DELIMITER = 4 +WBF_WORDWRAP = 16 +WBF_WORDBREAK = 32 +WBF_OVERFLOW = 64 +WBF_LEVEL1 = 128 +WBF_LEVEL2 = 256 +WBF_CUSTOM = 512 +CFM_BOLD = 1 +CFM_ITALIC = 2 +CFM_UNDERLINE = 4 +CFM_STRIKEOUT = 8 +CFM_PROTECTED = 16 +CFM_SIZE = -2147483648 +CFM_COLOR = 1073741824 +CFM_FACE = 536870912 +CFM_OFFSET = 268435456 +CFM_CHARSET = 134217728 +CFE_BOLD = 1 +CFE_ITALIC = 2 +CFE_UNDERLINE = 4 +CFE_STRIKEOUT = 8 +CFE_PROTECTED = 16 +CFE_AUTOCOLOR = 1073741824 +yHeightCharPtsMost = 1638 +SCF_SELECTION = 1 +SCF_WORD = 2 +SF_TEXT = 1 +SF_RTF = 2 +SF_RTFNOOBJS = 3 +SF_TEXTIZED = 4 +SFF_SELECTION = 32768 +SFF_PLAINRTF = 16384 +MAX_TAB_STOPS = 32 +lDefaultTab = 720 +PFM_STARTINDENT = 1 +PFM_RIGHTINDENT = 2 +PFM_OFFSET = 4 +PFM_ALIGNMENT = 8 +PFM_TABSTOPS = 16 +PFM_NUMBERING = 32 +PFM_OFFSETINDENT = -2147483648 +PFN_BULLET = 1 +PFA_LEFT = 1 +PFA_RIGHT = 2 +PFA_CENTER = 3 +WM_NOTIFY = 78 +SEL_EMPTY = 0 +SEL_TEXT = 1 +SEL_OBJECT = 2 +SEL_MULTICHAR = 4 +SEL_MULTIOBJECT = 8 +OLEOP_DOVERB = 1 +CF_RTF = "Rich Text Format" +CF_RTFNOOBJS = "Rich Text Format Without Objects" +CF_RETEXTOBJ = "RichEdit Text and Objects" + +# From wincon.h +RIGHT_ALT_PRESSED = 1 # the right alt key is pressed. +LEFT_ALT_PRESSED = 2 # the left alt key is pressed. +RIGHT_CTRL_PRESSED = 4 # the right ctrl key is pressed. +LEFT_CTRL_PRESSED = 8 # the left ctrl key is pressed. +SHIFT_PRESSED = 16 # the shift key is pressed. +NUMLOCK_ON = 32 # the numlock light is on. +SCROLLLOCK_ON = 64 # the scrolllock light is on. +CAPSLOCK_ON = 128 # the capslock light is on. +ENHANCED_KEY = 256 # the key is enhanced. +NLS_DBCSCHAR = 65536 # DBCS for JPN: SBCS/DBCS mode. +NLS_ALPHANUMERIC = 0 # DBCS for JPN: Alphanumeric mode. +NLS_KATAKANA = 131072 # DBCS for JPN: Katakana mode. +NLS_HIRAGANA = 262144 # DBCS for JPN: Hiragana mode. +NLS_ROMAN = 4194304 # DBCS for JPN: Roman/Noroman mode. +NLS_IME_CONVERSION = 8388608 # DBCS for JPN: IME conversion. +NLS_IME_DISABLE = 536870912 # DBCS for JPN: IME enable/disable. + +FROM_LEFT_1ST_BUTTON_PRESSED = 1 +RIGHTMOST_BUTTON_PRESSED = 2 +FROM_LEFT_2ND_BUTTON_PRESSED = 4 +FROM_LEFT_3RD_BUTTON_PRESSED = 8 +FROM_LEFT_4TH_BUTTON_PRESSED = 16 + +CTRL_C_EVENT = 0 +CTRL_BREAK_EVENT = 1 +CTRL_CLOSE_EVENT = 2 +CTRL_LOGOFF_EVENT = 5 +CTRL_SHUTDOWN_EVENT = 6 + +MOUSE_MOVED = 1 +DOUBLE_CLICK = 2 +MOUSE_WHEELED = 4 + +# property sheet window messages from prsht.h +PSM_SETCURSEL = WM_USER + 101 +PSM_REMOVEPAGE = WM_USER + 102 +PSM_ADDPAGE = WM_USER + 103 +PSM_CHANGED = WM_USER + 104 +PSM_RESTARTWINDOWS = WM_USER + 105 +PSM_REBOOTSYSTEM = WM_USER + 106 +PSM_CANCELTOCLOSE = WM_USER + 107 +PSM_QUERYSIBLINGS = WM_USER + 108 +PSM_UNCHANGED = WM_USER + 109 +PSM_APPLY = WM_USER + 110 +PSM_SETTITLEA = WM_USER + 111 +PSM_SETTITLEW = WM_USER + 120 +PSM_SETWIZBUTTONS = WM_USER + 112 +PSM_PRESSBUTTON = WM_USER + 113 +PSM_SETCURSELID = WM_USER + 114 +PSM_SETFINISHTEXTA = WM_USER + 115 +PSM_SETFINISHTEXTW = WM_USER + 121 +PSM_GETTABCONTROL = WM_USER + 116 +PSM_ISDIALOGMESSAGE = WM_USER + 117 +PSM_GETCURRENTPAGEHWND = WM_USER + 118 +PSM_INSERTPAGE = WM_USER + 119 +PSM_SETHEADERTITLEA = WM_USER + 125 +PSM_SETHEADERTITLEW = WM_USER + 126 +PSM_SETHEADERSUBTITLEA = WM_USER + 127 +PSM_SETHEADERSUBTITLEW = WM_USER + 128 +PSM_HWNDTOINDEX = WM_USER + 129 +PSM_INDEXTOHWND = WM_USER + 130 +PSM_PAGETOINDEX = WM_USER + 131 +PSM_INDEXTOPAGE = WM_USER + 132 +PSM_IDTOINDEX = WM_USER + 133 +PSM_INDEXTOID = WM_USER + 134 +PSM_GETRESULT = WM_USER + 135 +PSM_RECALCPAGESIZES = WM_USER + 136 + +# GetUserNameEx/GetComputerNameEx +NameUnknown = 0 +NameFullyQualifiedDN = 1 +NameSamCompatible = 2 +NameDisplay = 3 +NameUniqueId = 6 +NameCanonical = 7 +NameUserPrincipal = 8 +NameCanonicalEx = 9 +NameServicePrincipal = 10 +NameDnsDomain = 12 + +ComputerNameNetBIOS = 0 +ComputerNameDnsHostname = 1 +ComputerNameDnsDomain = 2 +ComputerNameDnsFullyQualified = 3 +ComputerNamePhysicalNetBIOS = 4 +ComputerNamePhysicalDnsHostname = 5 +ComputerNamePhysicalDnsDomain = 6 +ComputerNamePhysicalDnsFullyQualified = 7 + +LWA_COLORKEY = 0x00000001 +LWA_ALPHA = 0x00000002 +ULW_COLORKEY = 0x00000001 +ULW_ALPHA = 0x00000002 +ULW_OPAQUE = 0x00000004 + +# WinDef.h +TRUE = 1 +FALSE = 0 +MAX_PATH = 260 +# WinGDI.h +AC_SRC_OVER = 0 +AC_SRC_ALPHA = 1 +GRADIENT_FILL_RECT_H = 0 +GRADIENT_FILL_RECT_V = 1 +GRADIENT_FILL_TRIANGLE = 2 +GRADIENT_FILL_OP_FLAG = 255 + +## flags used with Get/SetSystemFileCacheSize +MM_WORKING_SET_MAX_HARD_ENABLE = 1 +MM_WORKING_SET_MAX_HARD_DISABLE = 2 +MM_WORKING_SET_MIN_HARD_ENABLE = 4 +MM_WORKING_SET_MIN_HARD_DISABLE = 8 + +## Flags for GetFinalPathNameByHandle +VOLUME_NAME_DOS = 0 +VOLUME_NAME_GUID = 1 +VOLUME_NAME_NT = 2 +VOLUME_NAME_NONE = 4 +FILE_NAME_NORMALIZED = 0 +FILE_NAME_OPENED = 8 + +DEVICE_NOTIFY_WINDOW_HANDLE = 0x00000000 +DEVICE_NOTIFY_SERVICE_HANDLE = 0x00000001 + +# From Dbt.h +# Generated by h2py from Dbt.h +WM_DEVICECHANGE = 0x0219 +BSF_QUERY = 0x00000001 +BSF_IGNORECURRENTTASK = 0x00000002 +BSF_FLUSHDISK = 0x00000004 +BSF_NOHANG = 0x00000008 +BSF_POSTMESSAGE = 0x00000010 +BSF_FORCEIFHUNG = 0x00000020 +BSF_NOTIMEOUTIFNOTHUNG = 0x00000040 +BSF_MSGSRV32ISOK = -2147483648 +BSF_MSGSRV32ISOK_BIT = 31 +BSM_ALLCOMPONENTS = 0x00000000 +BSM_VXDS = 0x00000001 +BSM_NETDRIVER = 0x00000002 +BSM_INSTALLABLEDRIVERS = 0x00000004 +BSM_APPLICATIONS = 0x00000008 +DBT_APPYBEGIN = 0x0000 +DBT_APPYEND = 0x0001 +DBT_DEVNODES_CHANGED = 0x0007 +DBT_QUERYCHANGECONFIG = 0x0017 +DBT_CONFIGCHANGED = 0x0018 +DBT_CONFIGCHANGECANCELED = 0x0019 +DBT_MONITORCHANGE = 0x001B +DBT_SHELLLOGGEDON = 0x0020 +DBT_CONFIGMGAPI32 = 0x0022 +DBT_VXDINITCOMPLETE = 0x0023 +DBT_VOLLOCKQUERYLOCK = 0x8041 +DBT_VOLLOCKLOCKTAKEN = 0x8042 +DBT_VOLLOCKLOCKFAILED = 0x8043 +DBT_VOLLOCKQUERYUNLOCK = 0x8044 +DBT_VOLLOCKLOCKRELEASED = 0x8045 +DBT_VOLLOCKUNLOCKFAILED = 0x8046 +LOCKP_ALLOW_WRITES = 0x01 +LOCKP_FAIL_WRITES = 0x00 +LOCKP_FAIL_MEM_MAPPING = 0x02 +LOCKP_ALLOW_MEM_MAPPING = 0x00 +LOCKP_USER_MASK = 0x03 +LOCKP_LOCK_FOR_FORMAT = 0x04 +LOCKF_LOGICAL_LOCK = 0x00 +LOCKF_PHYSICAL_LOCK = 0x01 +DBT_NO_DISK_SPACE = 0x0047 +DBT_LOW_DISK_SPACE = 0x0048 +DBT_CONFIGMGPRIVATE = 0x7FFF +DBT_DEVICEARRIVAL = 0x8000 +DBT_DEVICEQUERYREMOVE = 0x8001 +DBT_DEVICEQUERYREMOVEFAILED = 0x8002 +DBT_DEVICEREMOVEPENDING = 0x8003 +DBT_DEVICEREMOVECOMPLETE = 0x8004 +DBT_DEVICETYPESPECIFIC = 0x8005 +DBT_CUSTOMEVENT = 0x8006 +DBT_DEVTYP_OEM = 0x00000000 +DBT_DEVTYP_DEVNODE = 0x00000001 +DBT_DEVTYP_VOLUME = 0x00000002 +DBT_DEVTYP_PORT = 0x00000003 +DBT_DEVTYP_NET = 0x00000004 +DBT_DEVTYP_DEVICEINTERFACE = 0x00000005 +DBT_DEVTYP_HANDLE = 0x00000006 +DBTF_MEDIA = 0x0001 +DBTF_NET = 0x0002 +DBTF_RESOURCE = 0x00000001 +DBTF_XPORT = 0x00000002 +DBTF_SLOWNET = 0x00000004 +DBT_VPOWERDAPI = 0x8100 +DBT_USERDEFINED = 0xFFFF diff --git a/lib/win32/lib/win32cryptcon.py b/lib/win32/lib/win32cryptcon.py new file mode 100644 index 00000000..8d71996a --- /dev/null +++ b/lib/win32/lib/win32cryptcon.py @@ -0,0 +1,1925 @@ +# Generated by h2py from WinCrypt.h +def GET_ALG_CLASS(x): + return x & (7 << 13) + + +def GET_ALG_TYPE(x): + return x & (15 << 9) + + +def GET_ALG_SID(x): + return x & (511) + + +ALG_CLASS_ANY = 0 +ALG_CLASS_SIGNATURE = 1 << 13 +ALG_CLASS_MSG_ENCRYPT = 2 << 13 +ALG_CLASS_DATA_ENCRYPT = 3 << 13 +ALG_CLASS_HASH = 4 << 13 +ALG_CLASS_KEY_EXCHANGE = 5 << 13 +ALG_CLASS_ALL = 7 << 13 +ALG_TYPE_ANY = 0 +ALG_TYPE_DSS = 1 << 9 +ALG_TYPE_RSA = 2 << 9 +ALG_TYPE_BLOCK = 3 << 9 +ALG_TYPE_STREAM = 4 << 9 +ALG_TYPE_DH = 5 << 9 +ALG_TYPE_SECURECHANNEL = 6 << 9 +ALG_SID_ANY = 0 +ALG_SID_RSA_ANY = 0 +ALG_SID_RSA_PKCS = 1 +ALG_SID_RSA_MSATWORK = 2 +ALG_SID_RSA_ENTRUST = 3 +ALG_SID_RSA_PGP = 4 +ALG_SID_DSS_ANY = 0 +ALG_SID_DSS_PKCS = 1 +ALG_SID_DSS_DMS = 2 +ALG_SID_DES = 1 +ALG_SID_3DES = 3 +ALG_SID_DESX = 4 +ALG_SID_IDEA = 5 +ALG_SID_CAST = 6 +ALG_SID_SAFERSK64 = 7 +ALG_SID_SAFERSK128 = 8 +ALG_SID_3DES_112 = 9 +ALG_SID_CYLINK_MEK = 12 +ALG_SID_RC5 = 13 +ALG_SID_AES_128 = 14 +ALG_SID_AES_192 = 15 +ALG_SID_AES_256 = 16 +ALG_SID_AES = 17 +ALG_SID_SKIPJACK = 10 +ALG_SID_TEK = 11 +CRYPT_MODE_CBCI = 6 +CRYPT_MODE_CFBP = 7 +CRYPT_MODE_OFBP = 8 +CRYPT_MODE_CBCOFM = 9 +CRYPT_MODE_CBCOFMI = 10 +ALG_SID_RC2 = 2 +ALG_SID_RC4 = 1 +ALG_SID_SEAL = 2 +ALG_SID_DH_SANDF = 1 +ALG_SID_DH_EPHEM = 2 +ALG_SID_AGREED_KEY_ANY = 3 +ALG_SID_KEA = 4 +ALG_SID_MD2 = 1 +ALG_SID_MD4 = 2 +ALG_SID_MD5 = 3 +ALG_SID_SHA = 4 +ALG_SID_SHA1 = 4 +ALG_SID_MAC = 5 +ALG_SID_RIPEMD = 6 +ALG_SID_RIPEMD160 = 7 +ALG_SID_SSL3SHAMD5 = 8 +ALG_SID_HMAC = 9 +ALG_SID_TLS1PRF = 10 +ALG_SID_HASH_REPLACE_OWF = 11 +ALG_SID_SHA_256 = 12 +ALG_SID_SHA_384 = 13 +ALG_SID_SHA_512 = 14 +ALG_SID_SSL3_MASTER = 1 +ALG_SID_SCHANNEL_MASTER_HASH = 2 +ALG_SID_SCHANNEL_MAC_KEY = 3 +ALG_SID_PCT1_MASTER = 4 +ALG_SID_SSL2_MASTER = 5 +ALG_SID_TLS1_MASTER = 6 +ALG_SID_SCHANNEL_ENC_KEY = 7 +ALG_SID_EXAMPLE = 80 +CALG_MD2 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_MD2 +CALG_MD4 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_MD4 +CALG_MD5 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_MD5 +CALG_SHA = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA +CALG_SHA1 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA1 +CALG_MAC = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_MAC +CALG_RSA_SIGN = ALG_CLASS_SIGNATURE | ALG_TYPE_RSA | ALG_SID_RSA_ANY +CALG_DSS_SIGN = ALG_CLASS_SIGNATURE | ALG_TYPE_DSS | ALG_SID_DSS_ANY +CALG_NO_SIGN = ALG_CLASS_SIGNATURE | ALG_TYPE_ANY | ALG_SID_ANY +CALG_RSA_KEYX = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_RSA | ALG_SID_RSA_ANY +CALG_DES = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_DES +CALG_3DES_112 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_3DES_112 +CALG_3DES = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_3DES +CALG_DESX = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_DESX +CALG_RC2 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_RC2 +CALG_RC4 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_STREAM | ALG_SID_RC4 +CALG_SEAL = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_STREAM | ALG_SID_SEAL +CALG_DH_SF = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_DH | ALG_SID_DH_SANDF +CALG_DH_EPHEM = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_DH | ALG_SID_DH_EPHEM +CALG_AGREEDKEY_ANY = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_DH | ALG_SID_AGREED_KEY_ANY +CALG_KEA_KEYX = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_DH | ALG_SID_KEA +CALG_HUGHES_MD5 = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_ANY | ALG_SID_MD5 +CALG_SKIPJACK = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_SKIPJACK +CALG_TEK = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_TEK +CALG_CYLINK_MEK = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_CYLINK_MEK +CALG_SSL3_SHAMD5 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SSL3SHAMD5 +CALG_SSL3_MASTER = ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SSL3_MASTER +CALG_SCHANNEL_MASTER_HASH = ( + ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SCHANNEL_MASTER_HASH +) +CALG_SCHANNEL_MAC_KEY = ( + ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SCHANNEL_MAC_KEY +) +CALG_SCHANNEL_ENC_KEY = ( + ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SCHANNEL_ENC_KEY +) +CALG_PCT1_MASTER = ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_PCT1_MASTER +CALG_SSL2_MASTER = ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SSL2_MASTER +CALG_TLS1_MASTER = ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_TLS1_MASTER +CALG_RC5 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_RC5 +CALG_HMAC = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_HMAC +CALG_TLS1PRF = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_TLS1PRF +CALG_HASH_REPLACE_OWF = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_HASH_REPLACE_OWF +CALG_AES_128 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_AES_128 +CALG_AES_192 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_AES_192 +CALG_AES_256 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_AES_256 +CALG_AES = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_AES +CALG_SHA_256 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA_256 +CALG_SHA_384 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA_384 +CALG_SHA_512 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA_512 +CRYPT_VERIFYCONTEXT = -268435456 +CRYPT_NEWKEYSET = 0x00000008 +CRYPT_DELETEKEYSET = 0x00000010 +CRYPT_MACHINE_KEYSET = 0x00000020 +CRYPT_SILENT = 0x00000040 +CRYPT_EXPORTABLE = 0x00000001 +CRYPT_USER_PROTECTED = 0x00000002 +CRYPT_CREATE_SALT = 0x00000004 +CRYPT_UPDATE_KEY = 0x00000008 +CRYPT_NO_SALT = 0x00000010 +CRYPT_PREGEN = 0x00000040 +CRYPT_RECIPIENT = 0x00000010 +CRYPT_INITIATOR = 0x00000040 +CRYPT_ONLINE = 0x00000080 +CRYPT_SF = 0x00000100 +CRYPT_CREATE_IV = 0x00000200 +CRYPT_KEK = 0x00000400 +CRYPT_DATA_KEY = 0x00000800 +CRYPT_VOLATILE = 0x00001000 +CRYPT_SGCKEY = 0x00002000 +CRYPT_ARCHIVABLE = 0x00004000 +RSA1024BIT_KEY = 0x04000000 +CRYPT_SERVER = 0x00000400 +KEY_LENGTH_MASK = -65536 +CRYPT_Y_ONLY = 0x00000001 +CRYPT_SSL2_FALLBACK = 0x00000002 +CRYPT_DESTROYKEY = 0x00000004 +CRYPT_OAEP = 0x00000040 +CRYPT_BLOB_VER3 = 0x00000080 +CRYPT_IPSEC_HMAC_KEY = 0x00000100 +CRYPT_DECRYPT_RSA_NO_PADDING_CHECK = 0x00000020 +CRYPT_SECRETDIGEST = 0x00000001 +CRYPT_OWF_REPL_LM_HASH = 0x00000001 +CRYPT_LITTLE_ENDIAN = 0x00000001 +CRYPT_NOHASHOID = 0x00000001 +CRYPT_TYPE2_FORMAT = 0x00000002 +CRYPT_X931_FORMAT = 0x00000004 +CRYPT_MACHINE_DEFAULT = 0x00000001 +CRYPT_USER_DEFAULT = 0x00000002 +CRYPT_DELETE_DEFAULT = 0x00000004 +SIMPLEBLOB = 0x1 +PUBLICKEYBLOB = 0x6 +PRIVATEKEYBLOB = 0x7 +PLAINTEXTKEYBLOB = 0x8 +OPAQUEKEYBLOB = 0x9 +PUBLICKEYBLOBEX = 0xA +SYMMETRICWRAPKEYBLOB = 0xB +AT_KEYEXCHANGE = 1 +AT_SIGNATURE = 2 +CRYPT_USERDATA = 1 +KP_IV = 1 +KP_SALT = 2 +KP_PADDING = 3 +KP_MODE = 4 +KP_MODE_BITS = 5 +KP_PERMISSIONS = 6 +KP_ALGID = 7 +KP_BLOCKLEN = 8 +KP_KEYLEN = 9 +KP_SALT_EX = 10 +KP_P = 11 +KP_G = 12 +KP_Q = 13 +KP_X = 14 +KP_Y = 15 +KP_RA = 16 +KP_RB = 17 +KP_INFO = 18 +KP_EFFECTIVE_KEYLEN = 19 +KP_SCHANNEL_ALG = 20 +KP_CLIENT_RANDOM = 21 +KP_SERVER_RANDOM = 22 +KP_RP = 23 +KP_PRECOMP_MD5 = 24 +KP_PRECOMP_SHA = 25 +KP_CERTIFICATE = 26 +KP_CLEAR_KEY = 27 +KP_PUB_EX_LEN = 28 +KP_PUB_EX_VAL = 29 +KP_KEYVAL = 30 +KP_ADMIN_PIN = 31 +KP_KEYEXCHANGE_PIN = 32 +KP_SIGNATURE_PIN = 33 +KP_PREHASH = 34 +KP_ROUNDS = 35 +KP_OAEP_PARAMS = 36 +KP_CMS_KEY_INFO = 37 +KP_CMS_DH_KEY_INFO = 38 +KP_PUB_PARAMS = 39 +KP_VERIFY_PARAMS = 40 +KP_HIGHEST_VERSION = 41 +KP_GET_USE_COUNT = 42 +PKCS5_PADDING = 1 +RANDOM_PADDING = 2 +ZERO_PADDING = 3 +CRYPT_MODE_CBC = 1 +CRYPT_MODE_ECB = 2 +CRYPT_MODE_OFB = 3 +CRYPT_MODE_CFB = 4 +CRYPT_MODE_CTS = 5 +CRYPT_ENCRYPT = 0x0001 +CRYPT_DECRYPT = 0x0002 +CRYPT_EXPORT = 0x0004 +CRYPT_READ = 0x0008 +CRYPT_WRITE = 0x0010 +CRYPT_MAC = 0x0020 +CRYPT_EXPORT_KEY = 0x0040 +CRYPT_IMPORT_KEY = 0x0080 +CRYPT_ARCHIVE = 0x0100 +HP_ALGID = 0x0001 +HP_HASHVAL = 0x0002 +HP_HASHSIZE = 0x0004 +HP_HMAC_INFO = 0x0005 +HP_TLS1PRF_LABEL = 0x0006 +HP_TLS1PRF_SEED = 0x0007 + +CRYPT_FAILED = 0 +CRYPT_SUCCEED = 1 + + +def RCRYPT_SUCCEEDED(rt): + return (rt) == CRYPT_SUCCEED + + +def RCRYPT_FAILED(rt): + return (rt) == CRYPT_FAILED + + +PP_ENUMALGS = 1 +PP_ENUMCONTAINERS = 2 +PP_IMPTYPE = 3 +PP_NAME = 4 +PP_VERSION = 5 +PP_CONTAINER = 6 +PP_CHANGE_PASSWORD = 7 +PP_KEYSET_SEC_DESCR = 8 +PP_CERTCHAIN = 9 +PP_KEY_TYPE_SUBTYPE = 10 +PP_PROVTYPE = 16 +PP_KEYSTORAGE = 17 +PP_APPLI_CERT = 18 +PP_SYM_KEYSIZE = 19 +PP_SESSION_KEYSIZE = 20 +PP_UI_PROMPT = 21 +PP_ENUMALGS_EX = 22 +PP_ENUMMANDROOTS = 25 +PP_ENUMELECTROOTS = 26 +PP_KEYSET_TYPE = 27 +PP_ADMIN_PIN = 31 +PP_KEYEXCHANGE_PIN = 32 +PP_SIGNATURE_PIN = 33 +PP_SIG_KEYSIZE_INC = 34 +PP_KEYX_KEYSIZE_INC = 35 +PP_UNIQUE_CONTAINER = 36 +PP_SGC_INFO = 37 +PP_USE_HARDWARE_RNG = 38 +PP_KEYSPEC = 39 +PP_ENUMEX_SIGNING_PROT = 40 +PP_CRYPT_COUNT_KEY_USE = 41 +CRYPT_FIRST = 1 +CRYPT_NEXT = 2 +CRYPT_SGC_ENUM = 4 +CRYPT_IMPL_HARDWARE = 1 +CRYPT_IMPL_SOFTWARE = 2 +CRYPT_IMPL_MIXED = 3 +CRYPT_IMPL_UNKNOWN = 4 +CRYPT_IMPL_REMOVABLE = 8 +CRYPT_SEC_DESCR = 0x00000001 +CRYPT_PSTORE = 0x00000002 +CRYPT_UI_PROMPT = 0x00000004 +CRYPT_FLAG_PCT1 = 0x0001 +CRYPT_FLAG_SSL2 = 0x0002 +CRYPT_FLAG_SSL3 = 0x0004 +CRYPT_FLAG_TLS1 = 0x0008 +CRYPT_FLAG_IPSEC = 0x0010 +CRYPT_FLAG_SIGNING = 0x0020 +CRYPT_SGC = 0x0001 +CRYPT_FASTSGC = 0x0002 +PP_CLIENT_HWND = 1 +PP_CONTEXT_INFO = 11 +PP_KEYEXCHANGE_KEYSIZE = 12 +PP_SIGNATURE_KEYSIZE = 13 +PP_KEYEXCHANGE_ALG = 14 +PP_SIGNATURE_ALG = 15 +PP_DELETEKEY = 24 +PROV_RSA_FULL = 1 +PROV_RSA_SIG = 2 +PROV_DSS = 3 +PROV_FORTEZZA = 4 +PROV_MS_EXCHANGE = 5 +PROV_SSL = 6 +PROV_RSA_SCHANNEL = 12 +PROV_DSS_DH = 13 +PROV_EC_ECDSA_SIG = 14 +PROV_EC_ECNRA_SIG = 15 +PROV_EC_ECDSA_FULL = 16 +PROV_EC_ECNRA_FULL = 17 +PROV_DH_SCHANNEL = 18 +PROV_SPYRUS_LYNKS = 20 +PROV_RNG = 21 +PROV_INTEL_SEC = 22 +PROV_REPLACE_OWF = 23 +PROV_RSA_AES = 24 +MS_DEF_PROV_A = "Microsoft Base Cryptographic Provider v1.0" +MS_DEF_PROV = MS_DEF_PROV_A +MS_ENHANCED_PROV_A = "Microsoft Enhanced Cryptographic Provider v1.0" +MS_ENHANCED_PROV = MS_ENHANCED_PROV_A +MS_STRONG_PROV_A = "Microsoft Strong Cryptographic Provider" +MS_STRONG_PROV = MS_STRONG_PROV_A +MS_DEF_RSA_SIG_PROV_A = "Microsoft RSA Signature Cryptographic Provider" +MS_DEF_RSA_SIG_PROV = MS_DEF_RSA_SIG_PROV_A +MS_DEF_RSA_SCHANNEL_PROV_A = "Microsoft RSA SChannel Cryptographic Provider" +MS_DEF_RSA_SCHANNEL_PROV = MS_DEF_RSA_SCHANNEL_PROV_A +MS_DEF_DSS_PROV_A = "Microsoft Base DSS Cryptographic Provider" +MS_DEF_DSS_PROV = MS_DEF_DSS_PROV_A +MS_DEF_DSS_DH_PROV_A = "Microsoft Base DSS and Diffie-Hellman Cryptographic Provider" +MS_DEF_DSS_DH_PROV = MS_DEF_DSS_DH_PROV_A +MS_ENH_DSS_DH_PROV_A = ( + "Microsoft Enhanced DSS and Diffie-Hellman Cryptographic Provider" +) +MS_ENH_DSS_DH_PROV = MS_ENH_DSS_DH_PROV_A +MS_DEF_DH_SCHANNEL_PROV_A = "Microsoft DH SChannel Cryptographic Provider" +MS_DEF_DH_SCHANNEL_PROV = MS_DEF_DH_SCHANNEL_PROV_A +MS_SCARD_PROV_A = "Microsoft Base Smart Card Crypto Provider" +MS_SCARD_PROV = MS_SCARD_PROV_A +MS_ENH_RSA_AES_PROV_A = "Microsoft Enhanced RSA and AES Cryptographic Provider" +MS_ENH_RSA_AES_PROV = MS_ENH_RSA_AES_PROV_A +MAXUIDLEN = 64 +EXPO_OFFLOAD_REG_VALUE = "ExpoOffload" +EXPO_OFFLOAD_FUNC_NAME = "OffloadModExpo" +szKEY_CRYPTOAPI_PRIVATE_KEY_OPTIONS = "Software\\Policies\\Microsoft\\Cryptography" +szFORCE_KEY_PROTECTION = "ForceKeyProtection" +dwFORCE_KEY_PROTECTION_DISABLED = 0x0 +dwFORCE_KEY_PROTECTION_USER_SELECT = 0x1 +dwFORCE_KEY_PROTECTION_HIGH = 0x2 +szKEY_CACHE_ENABLED = "CachePrivateKeys" +szKEY_CACHE_SECONDS = "PrivateKeyLifetimeSeconds" +CUR_BLOB_VERSION = 2 +SCHANNEL_MAC_KEY = 0x00000000 +SCHANNEL_ENC_KEY = 0x00000001 +INTERNATIONAL_USAGE = 0x00000001 +szOID_RSA = "1.2.840.113549" +szOID_PKCS = "1.2.840.113549.1" +szOID_RSA_HASH = "1.2.840.113549.2" +szOID_RSA_ENCRYPT = "1.2.840.113549.3" +szOID_PKCS_1 = "1.2.840.113549.1.1" +szOID_PKCS_2 = "1.2.840.113549.1.2" +szOID_PKCS_3 = "1.2.840.113549.1.3" +szOID_PKCS_4 = "1.2.840.113549.1.4" +szOID_PKCS_5 = "1.2.840.113549.1.5" +szOID_PKCS_6 = "1.2.840.113549.1.6" +szOID_PKCS_7 = "1.2.840.113549.1.7" +szOID_PKCS_8 = "1.2.840.113549.1.8" +szOID_PKCS_9 = "1.2.840.113549.1.9" +szOID_PKCS_10 = "1.2.840.113549.1.10" +szOID_PKCS_12 = "1.2.840.113549.1.12" +szOID_RSA_RSA = "1.2.840.113549.1.1.1" +szOID_RSA_MD2RSA = "1.2.840.113549.1.1.2" +szOID_RSA_MD4RSA = "1.2.840.113549.1.1.3" +szOID_RSA_MD5RSA = "1.2.840.113549.1.1.4" +szOID_RSA_SHA1RSA = "1.2.840.113549.1.1.5" +szOID_RSA_SETOAEP_RSA = "1.2.840.113549.1.1.6" +szOID_RSA_DH = "1.2.840.113549.1.3.1" +szOID_RSA_data = "1.2.840.113549.1.7.1" +szOID_RSA_signedData = "1.2.840.113549.1.7.2" +szOID_RSA_envelopedData = "1.2.840.113549.1.7.3" +szOID_RSA_signEnvData = "1.2.840.113549.1.7.4" +szOID_RSA_digestedData = "1.2.840.113549.1.7.5" +szOID_RSA_hashedData = "1.2.840.113549.1.7.5" +szOID_RSA_encryptedData = "1.2.840.113549.1.7.6" +szOID_RSA_emailAddr = "1.2.840.113549.1.9.1" +szOID_RSA_unstructName = "1.2.840.113549.1.9.2" +szOID_RSA_contentType = "1.2.840.113549.1.9.3" +szOID_RSA_messageDigest = "1.2.840.113549.1.9.4" +szOID_RSA_signingTime = "1.2.840.113549.1.9.5" +szOID_RSA_counterSign = "1.2.840.113549.1.9.6" +szOID_RSA_challengePwd = "1.2.840.113549.1.9.7" +szOID_RSA_unstructAddr = "1.2.840.113549.1.9.8" +szOID_RSA_extCertAttrs = "1.2.840.113549.1.9.9" +szOID_RSA_certExtensions = "1.2.840.113549.1.9.14" +szOID_RSA_SMIMECapabilities = "1.2.840.113549.1.9.15" +szOID_RSA_preferSignedData = "1.2.840.113549.1.9.15.1" +szOID_RSA_SMIMEalg = "1.2.840.113549.1.9.16.3" +szOID_RSA_SMIMEalgESDH = "1.2.840.113549.1.9.16.3.5" +szOID_RSA_SMIMEalgCMS3DESwrap = "1.2.840.113549.1.9.16.3.6" +szOID_RSA_SMIMEalgCMSRC2wrap = "1.2.840.113549.1.9.16.3.7" +szOID_RSA_MD2 = "1.2.840.113549.2.2" +szOID_RSA_MD4 = "1.2.840.113549.2.4" +szOID_RSA_MD5 = "1.2.840.113549.2.5" +szOID_RSA_RC2CBC = "1.2.840.113549.3.2" +szOID_RSA_RC4 = "1.2.840.113549.3.4" +szOID_RSA_DES_EDE3_CBC = "1.2.840.113549.3.7" +szOID_RSA_RC5_CBCPad = "1.2.840.113549.3.9" +szOID_ANSI_X942 = "1.2.840.10046" +szOID_ANSI_X942_DH = "1.2.840.10046.2.1" +szOID_X957 = "1.2.840.10040" +szOID_X957_DSA = "1.2.840.10040.4.1" +szOID_X957_SHA1DSA = "1.2.840.10040.4.3" +szOID_DS = "2.5" +szOID_DSALG = "2.5.8" +szOID_DSALG_CRPT = "2.5.8.1" +szOID_DSALG_HASH = "2.5.8.2" +szOID_DSALG_SIGN = "2.5.8.3" +szOID_DSALG_RSA = "2.5.8.1.1" +szOID_OIW = "1.3.14" +szOID_OIWSEC = "1.3.14.3.2" +szOID_OIWSEC_md4RSA = "1.3.14.3.2.2" +szOID_OIWSEC_md5RSA = "1.3.14.3.2.3" +szOID_OIWSEC_md4RSA2 = "1.3.14.3.2.4" +szOID_OIWSEC_desECB = "1.3.14.3.2.6" +szOID_OIWSEC_desCBC = "1.3.14.3.2.7" +szOID_OIWSEC_desOFB = "1.3.14.3.2.8" +szOID_OIWSEC_desCFB = "1.3.14.3.2.9" +szOID_OIWSEC_desMAC = "1.3.14.3.2.10" +szOID_OIWSEC_rsaSign = "1.3.14.3.2.11" +szOID_OIWSEC_dsa = "1.3.14.3.2.12" +szOID_OIWSEC_shaDSA = "1.3.14.3.2.13" +szOID_OIWSEC_mdc2RSA = "1.3.14.3.2.14" +szOID_OIWSEC_shaRSA = "1.3.14.3.2.15" +szOID_OIWSEC_dhCommMod = "1.3.14.3.2.16" +szOID_OIWSEC_desEDE = "1.3.14.3.2.17" +szOID_OIWSEC_sha = "1.3.14.3.2.18" +szOID_OIWSEC_mdc2 = "1.3.14.3.2.19" +szOID_OIWSEC_dsaComm = "1.3.14.3.2.20" +szOID_OIWSEC_dsaCommSHA = "1.3.14.3.2.21" +szOID_OIWSEC_rsaXchg = "1.3.14.3.2.22" +szOID_OIWSEC_keyHashSeal = "1.3.14.3.2.23" +szOID_OIWSEC_md2RSASign = "1.3.14.3.2.24" +szOID_OIWSEC_md5RSASign = "1.3.14.3.2.25" +szOID_OIWSEC_sha1 = "1.3.14.3.2.26" +szOID_OIWSEC_dsaSHA1 = "1.3.14.3.2.27" +szOID_OIWSEC_dsaCommSHA1 = "1.3.14.3.2.28" +szOID_OIWSEC_sha1RSASign = "1.3.14.3.2.29" +szOID_OIWDIR = "1.3.14.7.2" +szOID_OIWDIR_CRPT = "1.3.14.7.2.1" +szOID_OIWDIR_HASH = "1.3.14.7.2.2" +szOID_OIWDIR_SIGN = "1.3.14.7.2.3" +szOID_OIWDIR_md2 = "1.3.14.7.2.2.1" +szOID_OIWDIR_md2RSA = "1.3.14.7.2.3.1" +szOID_INFOSEC = "2.16.840.1.101.2.1" +szOID_INFOSEC_sdnsSignature = "2.16.840.1.101.2.1.1.1" +szOID_INFOSEC_mosaicSignature = "2.16.840.1.101.2.1.1.2" +szOID_INFOSEC_sdnsConfidentiality = "2.16.840.1.101.2.1.1.3" +szOID_INFOSEC_mosaicConfidentiality = "2.16.840.1.101.2.1.1.4" +szOID_INFOSEC_sdnsIntegrity = "2.16.840.1.101.2.1.1.5" +szOID_INFOSEC_mosaicIntegrity = "2.16.840.1.101.2.1.1.6" +szOID_INFOSEC_sdnsTokenProtection = "2.16.840.1.101.2.1.1.7" +szOID_INFOSEC_mosaicTokenProtection = "2.16.840.1.101.2.1.1.8" +szOID_INFOSEC_sdnsKeyManagement = "2.16.840.1.101.2.1.1.9" +szOID_INFOSEC_mosaicKeyManagement = "2.16.840.1.101.2.1.1.10" +szOID_INFOSEC_sdnsKMandSig = "2.16.840.1.101.2.1.1.11" +szOID_INFOSEC_mosaicKMandSig = "2.16.840.1.101.2.1.1.12" +szOID_INFOSEC_SuiteASignature = "2.16.840.1.101.2.1.1.13" +szOID_INFOSEC_SuiteAConfidentiality = "2.16.840.1.101.2.1.1.14" +szOID_INFOSEC_SuiteAIntegrity = "2.16.840.1.101.2.1.1.15" +szOID_INFOSEC_SuiteATokenProtection = "2.16.840.1.101.2.1.1.16" +szOID_INFOSEC_SuiteAKeyManagement = "2.16.840.1.101.2.1.1.17" +szOID_INFOSEC_SuiteAKMandSig = "2.16.840.1.101.2.1.1.18" +szOID_INFOSEC_mosaicUpdatedSig = "2.16.840.1.101.2.1.1.19" +szOID_INFOSEC_mosaicKMandUpdSig = "2.16.840.1.101.2.1.1.20" +szOID_INFOSEC_mosaicUpdatedInteg = "2.16.840.1.101.2.1.1.21" +szOID_COMMON_NAME = "2.5.4.3" +szOID_SUR_NAME = "2.5.4.4" +szOID_DEVICE_SERIAL_NUMBER = "2.5.4.5" +szOID_COUNTRY_NAME = "2.5.4.6" +szOID_LOCALITY_NAME = "2.5.4.7" +szOID_STATE_OR_PROVINCE_NAME = "2.5.4.8" +szOID_STREET_ADDRESS = "2.5.4.9" +szOID_ORGANIZATION_NAME = "2.5.4.10" +szOID_ORGANIZATIONAL_UNIT_NAME = "2.5.4.11" +szOID_TITLE = "2.5.4.12" +szOID_DESCRIPTION = "2.5.4.13" +szOID_SEARCH_GUIDE = "2.5.4.14" +szOID_BUSINESS_CATEGORY = "2.5.4.15" +szOID_POSTAL_ADDRESS = "2.5.4.16" +szOID_POSTAL_CODE = "2.5.4.17" +szOID_POST_OFFICE_BOX = "2.5.4.18" +szOID_PHYSICAL_DELIVERY_OFFICE_NAME = "2.5.4.19" +szOID_TELEPHONE_NUMBER = "2.5.4.20" +szOID_TELEX_NUMBER = "2.5.4.21" +szOID_TELETEXT_TERMINAL_IDENTIFIER = "2.5.4.22" +szOID_FACSIMILE_TELEPHONE_NUMBER = "2.5.4.23" +szOID_X21_ADDRESS = "2.5.4.24" +szOID_INTERNATIONAL_ISDN_NUMBER = "2.5.4.25" +szOID_REGISTERED_ADDRESS = "2.5.4.26" +szOID_DESTINATION_INDICATOR = "2.5.4.27" +szOID_PREFERRED_DELIVERY_METHOD = "2.5.4.28" +szOID_PRESENTATION_ADDRESS = "2.5.4.29" +szOID_SUPPORTED_APPLICATION_CONTEXT = "2.5.4.30" +szOID_MEMBER = "2.5.4.31" +szOID_OWNER = "2.5.4.32" +szOID_ROLE_OCCUPANT = "2.5.4.33" +szOID_SEE_ALSO = "2.5.4.34" +szOID_USER_PASSWORD = "2.5.4.35" +szOID_USER_CERTIFICATE = "2.5.4.36" +szOID_CA_CERTIFICATE = "2.5.4.37" +szOID_AUTHORITY_REVOCATION_LIST = "2.5.4.38" +szOID_CERTIFICATE_REVOCATION_LIST = "2.5.4.39" +szOID_CROSS_CERTIFICATE_PAIR = "2.5.4.40" +szOID_GIVEN_NAME = "2.5.4.42" +szOID_INITIALS = "2.5.4.43" +szOID_DN_QUALIFIER = "2.5.4.46" +szOID_DOMAIN_COMPONENT = "0.9.2342.19200300.100.1.25" +szOID_PKCS_12_FRIENDLY_NAME_ATTR = "1.2.840.113549.1.9.20" +szOID_PKCS_12_LOCAL_KEY_ID = "1.2.840.113549.1.9.21" +szOID_PKCS_12_KEY_PROVIDER_NAME_ATTR = "1.3.6.1.4.1.311.17.1" +szOID_LOCAL_MACHINE_KEYSET = "1.3.6.1.4.1.311.17.2" +szOID_KEYID_RDN = "1.3.6.1.4.1.311.10.7.1" +CERT_RDN_ANY_TYPE = 0 +CERT_RDN_ENCODED_BLOB = 1 +CERT_RDN_OCTET_STRING = 2 +CERT_RDN_NUMERIC_STRING = 3 +CERT_RDN_PRINTABLE_STRING = 4 +CERT_RDN_TELETEX_STRING = 5 +CERT_RDN_T61_STRING = 5 +CERT_RDN_VIDEOTEX_STRING = 6 +CERT_RDN_IA5_STRING = 7 +CERT_RDN_GRAPHIC_STRING = 8 +CERT_RDN_VISIBLE_STRING = 9 +CERT_RDN_ISO646_STRING = 9 +CERT_RDN_GENERAL_STRING = 10 +CERT_RDN_UNIVERSAL_STRING = 11 +CERT_RDN_INT4_STRING = 11 +CERT_RDN_BMP_STRING = 12 +CERT_RDN_UNICODE_STRING = 12 +CERT_RDN_UTF8_STRING = 13 +CERT_RDN_TYPE_MASK = 0x000000FF +CERT_RDN_FLAGS_MASK = -16777216 +CERT_RDN_ENABLE_T61_UNICODE_FLAG = -2147483648 +CERT_RDN_ENABLE_UTF8_UNICODE_FLAG = 0x20000000 +CERT_RDN_DISABLE_CHECK_TYPE_FLAG = 0x40000000 +CERT_RDN_DISABLE_IE4_UTF8_FLAG = 0x01000000 +CERT_RSA_PUBLIC_KEY_OBJID = szOID_RSA_RSA +CERT_DEFAULT_OID_PUBLIC_KEY_SIGN = szOID_RSA_RSA +CERT_DEFAULT_OID_PUBLIC_KEY_XCHG = szOID_RSA_RSA +CERT_V1 = 0 +CERT_V2 = 1 +CERT_V3 = 2 +CERT_INFO_VERSION_FLAG = 1 +CERT_INFO_SERIAL_NUMBER_FLAG = 2 +CERT_INFO_SIGNATURE_ALGORITHM_FLAG = 3 +CERT_INFO_ISSUER_FLAG = 4 +CERT_INFO_NOT_BEFORE_FLAG = 5 +CERT_INFO_NOT_AFTER_FLAG = 6 +CERT_INFO_SUBJECT_FLAG = 7 +CERT_INFO_SUBJECT_PUBLIC_KEY_INFO_FLAG = 8 +CERT_INFO_ISSUER_UNIQUE_ID_FLAG = 9 +CERT_INFO_SUBJECT_UNIQUE_ID_FLAG = 10 +CERT_INFO_EXTENSION_FLAG = 11 +CRL_V1 = 0 +CRL_V2 = 1 +CERT_REQUEST_V1 = 0 +CERT_KEYGEN_REQUEST_V1 = 0 +CTL_V1 = 0 +CERT_ENCODING_TYPE_MASK = 0x0000FFFF +CMSG_ENCODING_TYPE_MASK = -65536 + + +def GET_CERT_ENCODING_TYPE(X): + return X & CERT_ENCODING_TYPE_MASK + + +def GET_CMSG_ENCODING_TYPE(X): + return X & CMSG_ENCODING_TYPE_MASK + + +CRYPT_ASN_ENCODING = 0x00000001 +CRYPT_NDR_ENCODING = 0x00000002 +X509_ASN_ENCODING = 0x00000001 +X509_NDR_ENCODING = 0x00000002 +PKCS_7_ASN_ENCODING = 0x00010000 +PKCS_7_NDR_ENCODING = 0x00020000 +CRYPT_FORMAT_STR_MULTI_LINE = 0x0001 +CRYPT_FORMAT_STR_NO_HEX = 0x0010 +CRYPT_FORMAT_SIMPLE = 0x0001 +CRYPT_FORMAT_X509 = 0x0002 +CRYPT_FORMAT_OID = 0x0004 +CRYPT_FORMAT_RDN_SEMICOLON = 0x0100 +CRYPT_FORMAT_RDN_CRLF = 0x0200 +CRYPT_FORMAT_RDN_UNQUOTE = 0x0400 +CRYPT_FORMAT_RDN_REVERSE = 0x0800 +CRYPT_FORMAT_COMMA = 0x1000 +CRYPT_FORMAT_SEMICOLON = CRYPT_FORMAT_RDN_SEMICOLON +CRYPT_FORMAT_CRLF = CRYPT_FORMAT_RDN_CRLF +CRYPT_ENCODE_NO_SIGNATURE_BYTE_REVERSAL_FLAG = 0x8 +CRYPT_ENCODE_ALLOC_FLAG = 0x8000 +CRYPT_UNICODE_NAME_ENCODE_ENABLE_T61_UNICODE_FLAG = CERT_RDN_ENABLE_T61_UNICODE_FLAG +CRYPT_UNICODE_NAME_ENCODE_ENABLE_UTF8_UNICODE_FLAG = CERT_RDN_ENABLE_UTF8_UNICODE_FLAG +CRYPT_UNICODE_NAME_ENCODE_DISABLE_CHECK_TYPE_FLAG = CERT_RDN_DISABLE_CHECK_TYPE_FLAG +CRYPT_SORTED_CTL_ENCODE_HASHED_SUBJECT_IDENTIFIER_FLAG = 0x10000 +CRYPT_DECODE_NOCOPY_FLAG = 0x1 +CRYPT_DECODE_TO_BE_SIGNED_FLAG = 0x2 +CRYPT_DECODE_SHARE_OID_STRING_FLAG = 0x4 +CRYPT_DECODE_NO_SIGNATURE_BYTE_REVERSAL_FLAG = 0x8 +CRYPT_DECODE_ALLOC_FLAG = 0x8000 +CRYPT_UNICODE_NAME_DECODE_DISABLE_IE4_UTF8_FLAG = CERT_RDN_DISABLE_IE4_UTF8_FLAG + +CRYPT_ENCODE_DECODE_NONE = 0 +X509_CERT = 1 +X509_CERT_TO_BE_SIGNED = 2 +X509_CERT_CRL_TO_BE_SIGNED = 3 +X509_CERT_REQUEST_TO_BE_SIGNED = 4 +X509_EXTENSIONS = 5 +X509_NAME_VALUE = 6 +X509_NAME = 7 +X509_PUBLIC_KEY_INFO = 8 +X509_AUTHORITY_KEY_ID = 9 +X509_KEY_ATTRIBUTES = 10 +X509_KEY_USAGE_RESTRICTION = 11 +X509_ALTERNATE_NAME = 12 +X509_BASIC_CONSTRAINTS = 13 +X509_KEY_USAGE = 14 +X509_BASIC_CONSTRAINTS2 = 15 +X509_CERT_POLICIES = 16 +PKCS_UTC_TIME = 17 +PKCS_TIME_REQUEST = 18 +RSA_CSP_PUBLICKEYBLOB = 19 +X509_UNICODE_NAME = 20 +X509_KEYGEN_REQUEST_TO_BE_SIGNED = 21 +PKCS_ATTRIBUTE = 22 +PKCS_CONTENT_INFO_SEQUENCE_OF_ANY = 23 +X509_UNICODE_NAME_VALUE = 24 +X509_ANY_STRING = X509_NAME_VALUE +X509_UNICODE_ANY_STRING = X509_UNICODE_NAME_VALUE +X509_OCTET_STRING = 25 +X509_BITS = 26 +X509_INTEGER = 27 +X509_MULTI_BYTE_INTEGER = 28 +X509_ENUMERATED = 29 +X509_CHOICE_OF_TIME = 30 +X509_AUTHORITY_KEY_ID2 = 31 +X509_AUTHORITY_INFO_ACCESS = 32 +X509_SUBJECT_INFO_ACCESS = X509_AUTHORITY_INFO_ACCESS +X509_CRL_REASON_CODE = X509_ENUMERATED +PKCS_CONTENT_INFO = 33 +X509_SEQUENCE_OF_ANY = 34 +X509_CRL_DIST_POINTS = 35 +X509_ENHANCED_KEY_USAGE = 36 +PKCS_CTL = 37 +X509_MULTI_BYTE_UINT = 38 +X509_DSS_PUBLICKEY = X509_MULTI_BYTE_UINT +X509_DSS_PARAMETERS = 39 +X509_DSS_SIGNATURE = 40 +PKCS_RC2_CBC_PARAMETERS = 41 +PKCS_SMIME_CAPABILITIES = 42 +X509_QC_STATEMENTS_EXT = 42 +PKCS_RSA_PRIVATE_KEY = 43 +PKCS_PRIVATE_KEY_INFO = 44 +PKCS_ENCRYPTED_PRIVATE_KEY_INFO = 45 +X509_PKIX_POLICY_QUALIFIER_USERNOTICE = 46 +X509_DH_PUBLICKEY = X509_MULTI_BYTE_UINT +X509_DH_PARAMETERS = 47 +PKCS_ATTRIBUTES = 48 +PKCS_SORTED_CTL = 49 +X509_ECC_SIGNATURE = 47 +X942_DH_PARAMETERS = 50 +X509_BITS_WITHOUT_TRAILING_ZEROES = 51 +X942_OTHER_INFO = 52 +X509_CERT_PAIR = 53 +X509_ISSUING_DIST_POINT = 54 +X509_NAME_CONSTRAINTS = 55 +X509_POLICY_MAPPINGS = 56 +X509_POLICY_CONSTRAINTS = 57 +X509_CROSS_CERT_DIST_POINTS = 58 +CMC_DATA = 59 +CMC_RESPONSE = 60 +CMC_STATUS = 61 +CMC_ADD_EXTENSIONS = 62 +CMC_ADD_ATTRIBUTES = 63 +X509_CERTIFICATE_TEMPLATE = 64 +OCSP_SIGNED_REQUEST = 65 +OCSP_REQUEST = 66 +OCSP_RESPONSE = 67 +OCSP_BASIC_SIGNED_RESPONSE = 68 +OCSP_BASIC_RESPONSE = 69 +X509_LOGOTYPE_EXT = 70 +X509_BIOMETRIC_EXT = 71 +CNG_RSA_PUBLIC_KEY_BLOB = 72 +X509_OBJECT_IDENTIFIER = 73 +X509_ALGORITHM_IDENTIFIER = 74 +PKCS_RSA_SSA_PSS_PARAMETERS = 75 +PKCS_RSAES_OAEP_PARAMETERS = 76 +ECC_CMS_SHARED_INFO = 77 +TIMESTAMP_REQUEST = 78 +TIMESTAMP_RESPONSE = 79 +TIMESTAMP_INFO = 80 +X509_CERT_BUNDLE = 81 +PKCS7_SIGNER_INFO = 500 +CMS_SIGNER_INFO = 501 + +szOID_AUTHORITY_KEY_IDENTIFIER = "2.5.29.1" +szOID_KEY_ATTRIBUTES = "2.5.29.2" +szOID_CERT_POLICIES_95 = "2.5.29.3" +szOID_KEY_USAGE_RESTRICTION = "2.5.29.4" +szOID_SUBJECT_ALT_NAME = "2.5.29.7" +szOID_ISSUER_ALT_NAME = "2.5.29.8" +szOID_BASIC_CONSTRAINTS = "2.5.29.10" +szOID_KEY_USAGE = "2.5.29.15" +szOID_PRIVATEKEY_USAGE_PERIOD = "2.5.29.16" +szOID_BASIC_CONSTRAINTS2 = "2.5.29.19" +szOID_CERT_POLICIES = "2.5.29.32" +szOID_ANY_CERT_POLICY = "2.5.29.32.0" +szOID_AUTHORITY_KEY_IDENTIFIER2 = "2.5.29.35" +szOID_SUBJECT_KEY_IDENTIFIER = "2.5.29.14" +szOID_SUBJECT_ALT_NAME2 = "2.5.29.17" +szOID_ISSUER_ALT_NAME2 = "2.5.29.18" +szOID_CRL_REASON_CODE = "2.5.29.21" +szOID_REASON_CODE_HOLD = "2.5.29.23" +szOID_CRL_DIST_POINTS = "2.5.29.31" +szOID_ENHANCED_KEY_USAGE = "2.5.29.37" +szOID_CRL_NUMBER = "2.5.29.20" +szOID_DELTA_CRL_INDICATOR = "2.5.29.27" +szOID_ISSUING_DIST_POINT = "2.5.29.28" +szOID_FRESHEST_CRL = "2.5.29.46" +szOID_NAME_CONSTRAINTS = "2.5.29.30" +szOID_POLICY_MAPPINGS = "2.5.29.33" +szOID_LEGACY_POLICY_MAPPINGS = "2.5.29.5" +szOID_POLICY_CONSTRAINTS = "2.5.29.36" +szOID_RENEWAL_CERTIFICATE = "1.3.6.1.4.1.311.13.1" +szOID_ENROLLMENT_NAME_VALUE_PAIR = "1.3.6.1.4.1.311.13.2.1" +szOID_ENROLLMENT_CSP_PROVIDER = "1.3.6.1.4.1.311.13.2.2" +szOID_OS_VERSION = "1.3.6.1.4.1.311.13.2.3" +szOID_ENROLLMENT_AGENT = "1.3.6.1.4.1.311.20.2.1" +szOID_PKIX = "1.3.6.1.5.5.7" +szOID_PKIX_PE = "1.3.6.1.5.5.7.1" +szOID_AUTHORITY_INFO_ACCESS = "1.3.6.1.5.5.7.1.1" +szOID_CERT_EXTENSIONS = "1.3.6.1.4.1.311.2.1.14" +szOID_NEXT_UPDATE_LOCATION = "1.3.6.1.4.1.311.10.2" +szOID_REMOVE_CERTIFICATE = "1.3.6.1.4.1.311.10.8.1" +szOID_CROSS_CERT_DIST_POINTS = "1.3.6.1.4.1.311.10.9.1" +szOID_CTL = "1.3.6.1.4.1.311.10.1" +szOID_SORTED_CTL = "1.3.6.1.4.1.311.10.1.1" +szOID_SERIALIZED = "1.3.6.1.4.1.311.10.3.3.1" +szOID_NT_PRINCIPAL_NAME = "1.3.6.1.4.1.311.20.2.3" +szOID_PRODUCT_UPDATE = "1.3.6.1.4.1.311.31.1" +szOID_ANY_APPLICATION_POLICY = "1.3.6.1.4.1.311.10.12.1" +szOID_AUTO_ENROLL_CTL_USAGE = "1.3.6.1.4.1.311.20.1" +szOID_ENROLL_CERTTYPE_EXTENSION = "1.3.6.1.4.1.311.20.2" +szOID_CERT_MANIFOLD = "1.3.6.1.4.1.311.20.3" +szOID_CERTSRV_CA_VERSION = "1.3.6.1.4.1.311.21.1" +szOID_CERTSRV_PREVIOUS_CERT_HASH = "1.3.6.1.4.1.311.21.2" +szOID_CRL_VIRTUAL_BASE = "1.3.6.1.4.1.311.21.3" +szOID_CRL_NEXT_PUBLISH = "1.3.6.1.4.1.311.21.4" +szOID_KP_CA_EXCHANGE = "1.3.6.1.4.1.311.21.5" +szOID_KP_KEY_RECOVERY_AGENT = "1.3.6.1.4.1.311.21.6" +szOID_CERTIFICATE_TEMPLATE = "1.3.6.1.4.1.311.21.7" +szOID_ENTERPRISE_OID_ROOT = "1.3.6.1.4.1.311.21.8" +szOID_RDN_DUMMY_SIGNER = "1.3.6.1.4.1.311.21.9" +szOID_APPLICATION_CERT_POLICIES = "1.3.6.1.4.1.311.21.10" +szOID_APPLICATION_POLICY_MAPPINGS = "1.3.6.1.4.1.311.21.11" +szOID_APPLICATION_POLICY_CONSTRAINTS = "1.3.6.1.4.1.311.21.12" +szOID_ARCHIVED_KEY_ATTR = "1.3.6.1.4.1.311.21.13" +szOID_CRL_SELF_CDP = "1.3.6.1.4.1.311.21.14" +szOID_REQUIRE_CERT_CHAIN_POLICY = "1.3.6.1.4.1.311.21.15" +szOID_ARCHIVED_KEY_CERT_HASH = "1.3.6.1.4.1.311.21.16" +szOID_ISSUED_CERT_HASH = "1.3.6.1.4.1.311.21.17" +szOID_DS_EMAIL_REPLICATION = "1.3.6.1.4.1.311.21.19" +szOID_REQUEST_CLIENT_INFO = "1.3.6.1.4.1.311.21.20" +szOID_ENCRYPTED_KEY_HASH = "1.3.6.1.4.1.311.21.21" +szOID_CERTSRV_CROSSCA_VERSION = "1.3.6.1.4.1.311.21.22" +szOID_NTDS_REPLICATION = "1.3.6.1.4.1.311.25.1" +szOID_SUBJECT_DIR_ATTRS = "2.5.29.9" +szOID_PKIX_KP = "1.3.6.1.5.5.7.3" +szOID_PKIX_KP_SERVER_AUTH = "1.3.6.1.5.5.7.3.1" +szOID_PKIX_KP_CLIENT_AUTH = "1.3.6.1.5.5.7.3.2" +szOID_PKIX_KP_CODE_SIGNING = "1.3.6.1.5.5.7.3.3" +szOID_PKIX_KP_EMAIL_PROTECTION = "1.3.6.1.5.5.7.3.4" +szOID_PKIX_KP_IPSEC_END_SYSTEM = "1.3.6.1.5.5.7.3.5" +szOID_PKIX_KP_IPSEC_TUNNEL = "1.3.6.1.5.5.7.3.6" +szOID_PKIX_KP_IPSEC_USER = "1.3.6.1.5.5.7.3.7" +szOID_PKIX_KP_TIMESTAMP_SIGNING = "1.3.6.1.5.5.7.3.8" +szOID_IPSEC_KP_IKE_INTERMEDIATE = "1.3.6.1.5.5.8.2.2" +szOID_KP_CTL_USAGE_SIGNING = "1.3.6.1.4.1.311.10.3.1" +szOID_KP_TIME_STAMP_SIGNING = "1.3.6.1.4.1.311.10.3.2" +szOID_SERVER_GATED_CRYPTO = "1.3.6.1.4.1.311.10.3.3" +szOID_SGC_NETSCAPE = "2.16.840.1.113730.4.1" +szOID_KP_EFS = "1.3.6.1.4.1.311.10.3.4" +szOID_EFS_RECOVERY = "1.3.6.1.4.1.311.10.3.4.1" +szOID_WHQL_CRYPTO = "1.3.6.1.4.1.311.10.3.5" +szOID_NT5_CRYPTO = "1.3.6.1.4.1.311.10.3.6" +szOID_OEM_WHQL_CRYPTO = "1.3.6.1.4.1.311.10.3.7" +szOID_EMBEDDED_NT_CRYPTO = "1.3.6.1.4.1.311.10.3.8" +szOID_ROOT_LIST_SIGNER = "1.3.6.1.4.1.311.10.3.9" +szOID_KP_QUALIFIED_SUBORDINATION = "1.3.6.1.4.1.311.10.3.10" +szOID_KP_KEY_RECOVERY = "1.3.6.1.4.1.311.10.3.11" +szOID_KP_DOCUMENT_SIGNING = "1.3.6.1.4.1.311.10.3.12" +szOID_KP_LIFETIME_SIGNING = "1.3.6.1.4.1.311.10.3.13" +szOID_KP_MOBILE_DEVICE_SOFTWARE = "1.3.6.1.4.1.311.10.3.14" +szOID_DRM = "1.3.6.1.4.1.311.10.5.1" +szOID_DRM_INDIVIDUALIZATION = "1.3.6.1.4.1.311.10.5.2" +szOID_LICENSES = "1.3.6.1.4.1.311.10.6.1" +szOID_LICENSE_SERVER = "1.3.6.1.4.1.311.10.6.2" +szOID_KP_SMARTCARD_LOGON = "1.3.6.1.4.1.311.20.2.2" +szOID_YESNO_TRUST_ATTR = "1.3.6.1.4.1.311.10.4.1" +szOID_PKIX_POLICY_QUALIFIER_CPS = "1.3.6.1.5.5.7.2.1" +szOID_PKIX_POLICY_QUALIFIER_USERNOTICE = "1.3.6.1.5.5.7.2.2" +szOID_CERT_POLICIES_95_QUALIFIER1 = "2.16.840.1.113733.1.7.1.1" +CERT_UNICODE_RDN_ERR_INDEX_MASK = 0x3FF +CERT_UNICODE_RDN_ERR_INDEX_SHIFT = 22 +CERT_UNICODE_ATTR_ERR_INDEX_MASK = 0x003F +CERT_UNICODE_ATTR_ERR_INDEX_SHIFT = 16 +CERT_UNICODE_VALUE_ERR_INDEX_MASK = 0x0000FFFF +CERT_UNICODE_VALUE_ERR_INDEX_SHIFT = 0 +CERT_DIGITAL_SIGNATURE_KEY_USAGE = 0x80 +CERT_NON_REPUDIATION_KEY_USAGE = 0x40 +CERT_KEY_ENCIPHERMENT_KEY_USAGE = 0x20 +CERT_DATA_ENCIPHERMENT_KEY_USAGE = 0x10 +CERT_KEY_AGREEMENT_KEY_USAGE = 0x08 +CERT_KEY_CERT_SIGN_KEY_USAGE = 0x04 +CERT_OFFLINE_CRL_SIGN_KEY_USAGE = 0x02 +CERT_CRL_SIGN_KEY_USAGE = 0x02 +CERT_ENCIPHER_ONLY_KEY_USAGE = 0x01 +CERT_DECIPHER_ONLY_KEY_USAGE = 0x80 +CERT_ALT_NAME_OTHER_NAME = 1 +CERT_ALT_NAME_RFC822_NAME = 2 +CERT_ALT_NAME_DNS_NAME = 3 +CERT_ALT_NAME_X400_ADDRESS = 4 +CERT_ALT_NAME_DIRECTORY_NAME = 5 +CERT_ALT_NAME_EDI_PARTY_NAME = 6 +CERT_ALT_NAME_URL = 7 +CERT_ALT_NAME_IP_ADDRESS = 8 +CERT_ALT_NAME_REGISTERED_ID = 9 +CERT_ALT_NAME_ENTRY_ERR_INDEX_MASK = 0xFF +CERT_ALT_NAME_ENTRY_ERR_INDEX_SHIFT = 16 +CERT_ALT_NAME_VALUE_ERR_INDEX_MASK = 0x0000FFFF +CERT_ALT_NAME_VALUE_ERR_INDEX_SHIFT = 0 +CERT_CA_SUBJECT_FLAG = 0x80 +CERT_END_ENTITY_SUBJECT_FLAG = 0x40 +szOID_PKIX_ACC_DESCR = "1.3.6.1.5.5.7.48" +szOID_PKIX_OCSP = "1.3.6.1.5.5.7.48.1" +szOID_PKIX_CA_ISSUERS = "1.3.6.1.5.5.7.48.2" +CRL_REASON_UNSPECIFIED = 0 +CRL_REASON_KEY_COMPROMISE = 1 +CRL_REASON_CA_COMPROMISE = 2 +CRL_REASON_AFFILIATION_CHANGED = 3 +CRL_REASON_SUPERSEDED = 4 +CRL_REASON_CESSATION_OF_OPERATION = 5 +CRL_REASON_CERTIFICATE_HOLD = 6 +CRL_REASON_REMOVE_FROM_CRL = 8 +CRL_DIST_POINT_NO_NAME = 0 +CRL_DIST_POINT_FULL_NAME = 1 +CRL_DIST_POINT_ISSUER_RDN_NAME = 2 +CRL_REASON_UNUSED_FLAG = 0x80 +CRL_REASON_KEY_COMPROMISE_FLAG = 0x40 +CRL_REASON_CA_COMPROMISE_FLAG = 0x20 +CRL_REASON_AFFILIATION_CHANGED_FLAG = 0x10 +CRL_REASON_SUPERSEDED_FLAG = 0x08 +CRL_REASON_CESSATION_OF_OPERATION_FLAG = 0x04 +CRL_REASON_CERTIFICATE_HOLD_FLAG = 0x02 +CRL_DIST_POINT_ERR_INDEX_MASK = 0x7F +CRL_DIST_POINT_ERR_INDEX_SHIFT = 24 + +CRL_DIST_POINT_ERR_CRL_ISSUER_BIT = -2147483648 + +CROSS_CERT_DIST_POINT_ERR_INDEX_MASK = 0xFF +CROSS_CERT_DIST_POINT_ERR_INDEX_SHIFT = 24 + +CERT_EXCLUDED_SUBTREE_BIT = -2147483648 + +SORTED_CTL_EXT_FLAGS_OFFSET = 0 * 4 +SORTED_CTL_EXT_COUNT_OFFSET = 1 * 4 +SORTED_CTL_EXT_MAX_COLLISION_OFFSET = 2 * 4 +SORTED_CTL_EXT_HASH_BUCKET_OFFSET = 3 * 4 +SORTED_CTL_EXT_HASHED_SUBJECT_IDENTIFIER_FLAG = 0x1 +CERT_DSS_R_LEN = 20 +CERT_DSS_S_LEN = 20 +CERT_DSS_SIGNATURE_LEN = CERT_DSS_R_LEN + CERT_DSS_S_LEN +CERT_MAX_ASN_ENCODED_DSS_SIGNATURE_LEN = 2 + 2 * (2 + 20 + 1) +CRYPT_X942_COUNTER_BYTE_LENGTH = 4 +CRYPT_X942_KEY_LENGTH_BYTE_LENGTH = 4 +CRYPT_X942_PUB_INFO_BYTE_LENGTH = 512 / 8 +CRYPT_RC2_40BIT_VERSION = 160 +CRYPT_RC2_56BIT_VERSION = 52 +CRYPT_RC2_64BIT_VERSION = 120 +CRYPT_RC2_128BIT_VERSION = 58 +szOID_VERISIGN_PRIVATE_6_9 = "2.16.840.1.113733.1.6.9" +szOID_VERISIGN_ONSITE_JURISDICTION_HASH = "2.16.840.1.113733.1.6.11" +szOID_VERISIGN_BITSTRING_6_13 = "2.16.840.1.113733.1.6.13" +szOID_VERISIGN_ISS_STRONG_CRYPTO = "2.16.840.1.113733.1.8.1" +szOID_NETSCAPE = "2.16.840.1.113730" +szOID_NETSCAPE_CERT_EXTENSION = "2.16.840.1.113730.1" +szOID_NETSCAPE_CERT_TYPE = "2.16.840.1.113730.1.1" +szOID_NETSCAPE_BASE_URL = "2.16.840.1.113730.1.2" +szOID_NETSCAPE_REVOCATION_URL = "2.16.840.1.113730.1.3" +szOID_NETSCAPE_CA_REVOCATION_URL = "2.16.840.1.113730.1.4" +szOID_NETSCAPE_CERT_RENEWAL_URL = "2.16.840.1.113730.1.7" +szOID_NETSCAPE_CA_POLICY_URL = "2.16.840.1.113730.1.8" +szOID_NETSCAPE_SSL_SERVER_NAME = "2.16.840.1.113730.1.12" +szOID_NETSCAPE_COMMENT = "2.16.840.1.113730.1.13" +szOID_NETSCAPE_DATA_TYPE = "2.16.840.1.113730.2" +szOID_NETSCAPE_CERT_SEQUENCE = "2.16.840.1.113730.2.5" +NETSCAPE_SSL_CLIENT_AUTH_CERT_TYPE = 0x80 +NETSCAPE_SSL_SERVER_AUTH_CERT_TYPE = 0x40 +NETSCAPE_SMIME_CERT_TYPE = 0x20 +NETSCAPE_SIGN_CERT_TYPE = 0x10 +NETSCAPE_SSL_CA_CERT_TYPE = 0x04 +NETSCAPE_SMIME_CA_CERT_TYPE = 0x02 +NETSCAPE_SIGN_CA_CERT_TYPE = 0x01 +szOID_CT_PKI_DATA = "1.3.6.1.5.5.7.12.2" +szOID_CT_PKI_RESPONSE = "1.3.6.1.5.5.7.12.3" +szOID_PKIX_NO_SIGNATURE = "1.3.6.1.5.5.7.6.2" +szOID_CMC = "1.3.6.1.5.5.7.7" +szOID_CMC_STATUS_INFO = "1.3.6.1.5.5.7.7.1" +szOID_CMC_IDENTIFICATION = "1.3.6.1.5.5.7.7.2" +szOID_CMC_IDENTITY_PROOF = "1.3.6.1.5.5.7.7.3" +szOID_CMC_DATA_RETURN = "1.3.6.1.5.5.7.7.4" +szOID_CMC_TRANSACTION_ID = "1.3.6.1.5.5.7.7.5" +szOID_CMC_SENDER_NONCE = "1.3.6.1.5.5.7.7.6" +szOID_CMC_RECIPIENT_NONCE = "1.3.6.1.5.5.7.7.7" +szOID_CMC_ADD_EXTENSIONS = "1.3.6.1.5.5.7.7.8" +szOID_CMC_ENCRYPTED_POP = "1.3.6.1.5.5.7.7.9" +szOID_CMC_DECRYPTED_POP = "1.3.6.1.5.5.7.7.10" +szOID_CMC_LRA_POP_WITNESS = "1.3.6.1.5.5.7.7.11" +szOID_CMC_GET_CERT = "1.3.6.1.5.5.7.7.15" +szOID_CMC_GET_CRL = "1.3.6.1.5.5.7.7.16" +szOID_CMC_REVOKE_REQUEST = "1.3.6.1.5.5.7.7.17" +szOID_CMC_REG_INFO = "1.3.6.1.5.5.7.7.18" +szOID_CMC_RESPONSE_INFO = "1.3.6.1.5.5.7.7.19" +szOID_CMC_QUERY_PENDING = "1.3.6.1.5.5.7.7.21" +szOID_CMC_ID_POP_LINK_RANDOM = "1.3.6.1.5.5.7.7.22" +szOID_CMC_ID_POP_LINK_WITNESS = "1.3.6.1.5.5.7.7.23" +szOID_CMC_ID_CONFIRM_CERT_ACCEPTANCE = "1.3.6.1.5.5.7.7.24" +szOID_CMC_ADD_ATTRIBUTES = "1.3.6.1.4.1.311.10.10.1" +CMC_TAGGED_CERT_REQUEST_CHOICE = 1 +CMC_OTHER_INFO_NO_CHOICE = 0 +CMC_OTHER_INFO_FAIL_CHOICE = 1 +CMC_OTHER_INFO_PEND_CHOICE = 2 +CMC_STATUS_SUCCESS = 0 +CMC_STATUS_FAILED = 2 +CMC_STATUS_PENDING = 3 +CMC_STATUS_NO_SUPPORT = 4 +CMC_STATUS_CONFIRM_REQUIRED = 5 +CMC_FAIL_BAD_ALG = 0 +CMC_FAIL_BAD_MESSAGE_CHECK = 1 +CMC_FAIL_BAD_REQUEST = 2 +CMC_FAIL_BAD_TIME = 3 +CMC_FAIL_BAD_CERT_ID = 4 +CMC_FAIL_UNSUPORTED_EXT = 5 +CMC_FAIL_MUST_ARCHIVE_KEYS = 6 +CMC_FAIL_BAD_IDENTITY = 7 +CMC_FAIL_POP_REQUIRED = 8 +CMC_FAIL_POP_FAILED = 9 +CMC_FAIL_NO_KEY_REUSE = 10 +CMC_FAIL_INTERNAL_CA_ERROR = 11 +CMC_FAIL_TRY_LATER = 12 +CRYPT_OID_ENCODE_OBJECT_FUNC = "CryptDllEncodeObject" +CRYPT_OID_DECODE_OBJECT_FUNC = "CryptDllDecodeObject" +CRYPT_OID_ENCODE_OBJECT_EX_FUNC = "CryptDllEncodeObjectEx" +CRYPT_OID_DECODE_OBJECT_EX_FUNC = "CryptDllDecodeObjectEx" +CRYPT_OID_CREATE_COM_OBJECT_FUNC = "CryptDllCreateCOMObject" +CRYPT_OID_VERIFY_REVOCATION_FUNC = "CertDllVerifyRevocation" +CRYPT_OID_VERIFY_CTL_USAGE_FUNC = "CertDllVerifyCTLUsage" +CRYPT_OID_FORMAT_OBJECT_FUNC = "CryptDllFormatObject" +CRYPT_OID_FIND_OID_INFO_FUNC = "CryptDllFindOIDInfo" +CRYPT_OID_FIND_LOCALIZED_NAME_FUNC = "CryptDllFindLocalizedName" + +CRYPT_OID_REGPATH = "Software\\Microsoft\\Cryptography\\OID" +CRYPT_OID_REG_ENCODING_TYPE_PREFIX = "EncodingType " +CRYPT_OID_REG_DLL_VALUE_NAME = "Dll" +CRYPT_OID_REG_FUNC_NAME_VALUE_NAME = "FuncName" +CRYPT_OID_REG_FUNC_NAME_VALUE_NAME_A = "FuncName" +CRYPT_OID_REG_FLAGS_VALUE_NAME = "CryptFlags" +CRYPT_DEFAULT_OID = "DEFAULT" +CRYPT_INSTALL_OID_FUNC_BEFORE_FLAG = 1 +CRYPT_GET_INSTALLED_OID_FUNC_FLAG = 0x1 +CRYPT_REGISTER_FIRST_INDEX = 0 +CRYPT_REGISTER_LAST_INDEX = -1 +CRYPT_MATCH_ANY_ENCODING_TYPE = -1 +CRYPT_HASH_ALG_OID_GROUP_ID = 1 +CRYPT_ENCRYPT_ALG_OID_GROUP_ID = 2 +CRYPT_PUBKEY_ALG_OID_GROUP_ID = 3 +CRYPT_SIGN_ALG_OID_GROUP_ID = 4 +CRYPT_RDN_ATTR_OID_GROUP_ID = 5 +CRYPT_EXT_OR_ATTR_OID_GROUP_ID = 6 +CRYPT_ENHKEY_USAGE_OID_GROUP_ID = 7 +CRYPT_POLICY_OID_GROUP_ID = 8 +CRYPT_TEMPLATE_OID_GROUP_ID = 9 +CRYPT_LAST_OID_GROUP_ID = 9 +CRYPT_FIRST_ALG_OID_GROUP_ID = CRYPT_HASH_ALG_OID_GROUP_ID +CRYPT_LAST_ALG_OID_GROUP_ID = CRYPT_SIGN_ALG_OID_GROUP_ID +CRYPT_OID_INHIBIT_SIGNATURE_FORMAT_FLAG = 0x1 +CRYPT_OID_USE_PUBKEY_PARA_FOR_PKCS7_FLAG = 0x2 +CRYPT_OID_NO_NULL_ALGORITHM_PARA_FLAG = 0x4 +CRYPT_OID_INFO_OID_KEY = 1 +CRYPT_OID_INFO_NAME_KEY = 2 +CRYPT_OID_INFO_ALGID_KEY = 3 +CRYPT_OID_INFO_SIGN_KEY = 4 +CRYPT_INSTALL_OID_INFO_BEFORE_FLAG = 1 +CRYPT_LOCALIZED_NAME_ENCODING_TYPE = 0 +CRYPT_LOCALIZED_NAME_OID = "LocalizedNames" +szOID_PKCS_7_DATA = "1.2.840.113549.1.7.1" +szOID_PKCS_7_SIGNED = "1.2.840.113549.1.7.2" +szOID_PKCS_7_ENVELOPED = "1.2.840.113549.1.7.3" +szOID_PKCS_7_SIGNEDANDENVELOPED = "1.2.840.113549.1.7.4" +szOID_PKCS_7_DIGESTED = "1.2.840.113549.1.7.5" +szOID_PKCS_7_ENCRYPTED = "1.2.840.113549.1.7.6" +szOID_PKCS_9_CONTENT_TYPE = "1.2.840.113549.1.9.3" +szOID_PKCS_9_MESSAGE_DIGEST = "1.2.840.113549.1.9.4" +CMSG_DATA = 1 +CMSG_SIGNED = 2 +CMSG_ENVELOPED = 3 +CMSG_SIGNED_AND_ENVELOPED = 4 +CMSG_HASHED = 5 +CMSG_ENCRYPTED = 6 + +CMSG_ALL_FLAGS = -1 +CMSG_DATA_FLAG = 1 << CMSG_DATA +CMSG_SIGNED_FLAG = 1 << CMSG_SIGNED +CMSG_ENVELOPED_FLAG = 1 << CMSG_ENVELOPED +CMSG_SIGNED_AND_ENVELOPED_FLAG = 1 << CMSG_SIGNED_AND_ENVELOPED +CMSG_HASHED_FLAG = 1 << CMSG_HASHED +CMSG_ENCRYPTED_FLAG = 1 << CMSG_ENCRYPTED +CERT_ID_ISSUER_SERIAL_NUMBER = 1 +CERT_ID_KEY_IDENTIFIER = 2 +CERT_ID_SHA1_HASH = 3 +CMSG_KEY_AGREE_EPHEMERAL_KEY_CHOICE = 1 +CMSG_KEY_AGREE_STATIC_KEY_CHOICE = 2 +CMSG_MAIL_LIST_HANDLE_KEY_CHOICE = 1 +CMSG_KEY_TRANS_RECIPIENT = 1 +CMSG_KEY_AGREE_RECIPIENT = 2 +CMSG_MAIL_LIST_RECIPIENT = 3 +CMSG_SP3_COMPATIBLE_ENCRYPT_FLAG = -2147483648 +CMSG_RC4_NO_SALT_FLAG = 0x40000000 +CMSG_INDEFINITE_LENGTH = -1 +CMSG_BARE_CONTENT_FLAG = 0x00000001 +CMSG_LENGTH_ONLY_FLAG = 0x00000002 +CMSG_DETACHED_FLAG = 0x00000004 +CMSG_AUTHENTICATED_ATTRIBUTES_FLAG = 0x00000008 +CMSG_CONTENTS_OCTETS_FLAG = 0x00000010 +CMSG_MAX_LENGTH_FLAG = 0x00000020 +CMSG_CMS_ENCAPSULATED_CONTENT_FLAG = 0x00000040 +CMSG_CRYPT_RELEASE_CONTEXT_FLAG = 0x00008000 +CMSG_TYPE_PARAM = 1 +CMSG_CONTENT_PARAM = 2 +CMSG_BARE_CONTENT_PARAM = 3 +CMSG_INNER_CONTENT_TYPE_PARAM = 4 +CMSG_SIGNER_COUNT_PARAM = 5 +CMSG_SIGNER_INFO_PARAM = 6 +CMSG_SIGNER_CERT_INFO_PARAM = 7 +CMSG_SIGNER_HASH_ALGORITHM_PARAM = 8 +CMSG_SIGNER_AUTH_ATTR_PARAM = 9 +CMSG_SIGNER_UNAUTH_ATTR_PARAM = 10 +CMSG_CERT_COUNT_PARAM = 11 +CMSG_CERT_PARAM = 12 +CMSG_CRL_COUNT_PARAM = 13 +CMSG_CRL_PARAM = 14 +CMSG_ENVELOPE_ALGORITHM_PARAM = 15 +CMSG_RECIPIENT_COUNT_PARAM = 17 +CMSG_RECIPIENT_INDEX_PARAM = 18 +CMSG_RECIPIENT_INFO_PARAM = 19 +CMSG_HASH_ALGORITHM_PARAM = 20 +CMSG_HASH_DATA_PARAM = 21 +CMSG_COMPUTED_HASH_PARAM = 22 +CMSG_ENCRYPT_PARAM = 26 +CMSG_ENCRYPTED_DIGEST = 27 +CMSG_ENCODED_SIGNER = 28 +CMSG_ENCODED_MESSAGE = 29 +CMSG_VERSION_PARAM = 30 +CMSG_ATTR_CERT_COUNT_PARAM = 31 +CMSG_ATTR_CERT_PARAM = 32 +CMSG_CMS_RECIPIENT_COUNT_PARAM = 33 +CMSG_CMS_RECIPIENT_INDEX_PARAM = 34 +CMSG_CMS_RECIPIENT_ENCRYPTED_KEY_INDEX_PARAM = 35 +CMSG_CMS_RECIPIENT_INFO_PARAM = 36 +CMSG_UNPROTECTED_ATTR_PARAM = 37 +CMSG_SIGNER_CERT_ID_PARAM = 38 +CMSG_CMS_SIGNER_INFO_PARAM = 39 +CMSG_SIGNED_DATA_V1 = 1 +CMSG_SIGNED_DATA_V3 = 3 +CMSG_SIGNED_DATA_PKCS_1_5_VERSION = CMSG_SIGNED_DATA_V1 +CMSG_SIGNED_DATA_CMS_VERSION = CMSG_SIGNED_DATA_V3 +CMSG_SIGNER_INFO_V1 = 1 +CMSG_SIGNER_INFO_V3 = 3 +CMSG_SIGNER_INFO_PKCS_1_5_VERSION = CMSG_SIGNER_INFO_V1 +CMSG_SIGNER_INFO_CMS_VERSION = CMSG_SIGNER_INFO_V3 +CMSG_HASHED_DATA_V0 = 0 +CMSG_HASHED_DATA_V2 = 2 +CMSG_HASHED_DATA_PKCS_1_5_VERSION = CMSG_HASHED_DATA_V0 +CMSG_HASHED_DATA_CMS_VERSION = CMSG_HASHED_DATA_V2 +CMSG_ENVELOPED_DATA_V0 = 0 +CMSG_ENVELOPED_DATA_V2 = 2 +CMSG_ENVELOPED_DATA_PKCS_1_5_VERSION = CMSG_ENVELOPED_DATA_V0 +CMSG_ENVELOPED_DATA_CMS_VERSION = CMSG_ENVELOPED_DATA_V2 +CMSG_KEY_AGREE_ORIGINATOR_CERT = 1 +CMSG_KEY_AGREE_ORIGINATOR_PUBLIC_KEY = 2 +CMSG_ENVELOPED_RECIPIENT_V0 = 0 +CMSG_ENVELOPED_RECIPIENT_V2 = 2 +CMSG_ENVELOPED_RECIPIENT_V3 = 3 +CMSG_ENVELOPED_RECIPIENT_V4 = 4 +CMSG_KEY_TRANS_PKCS_1_5_VERSION = CMSG_ENVELOPED_RECIPIENT_V0 +CMSG_KEY_TRANS_CMS_VERSION = CMSG_ENVELOPED_RECIPIENT_V2 +CMSG_KEY_AGREE_VERSION = CMSG_ENVELOPED_RECIPIENT_V3 +CMSG_MAIL_LIST_VERSION = CMSG_ENVELOPED_RECIPIENT_V4 +CMSG_CTRL_VERIFY_SIGNATURE = 1 +CMSG_CTRL_DECRYPT = 2 +CMSG_CTRL_VERIFY_HASH = 5 +CMSG_CTRL_ADD_SIGNER = 6 +CMSG_CTRL_DEL_SIGNER = 7 +CMSG_CTRL_ADD_SIGNER_UNAUTH_ATTR = 8 +CMSG_CTRL_DEL_SIGNER_UNAUTH_ATTR = 9 +CMSG_CTRL_ADD_CERT = 10 +CMSG_CTRL_DEL_CERT = 11 +CMSG_CTRL_ADD_CRL = 12 +CMSG_CTRL_DEL_CRL = 13 +CMSG_CTRL_ADD_ATTR_CERT = 14 +CMSG_CTRL_DEL_ATTR_CERT = 15 +CMSG_CTRL_KEY_TRANS_DECRYPT = 16 +CMSG_CTRL_KEY_AGREE_DECRYPT = 17 +CMSG_CTRL_MAIL_LIST_DECRYPT = 18 +CMSG_CTRL_VERIFY_SIGNATURE_EX = 19 +CMSG_CTRL_ADD_CMS_SIGNER_INFO = 20 +CMSG_VERIFY_SIGNER_PUBKEY = 1 +CMSG_VERIFY_SIGNER_CERT = 2 +CMSG_VERIFY_SIGNER_CHAIN = 3 +CMSG_VERIFY_SIGNER_NULL = 4 +CMSG_OID_GEN_ENCRYPT_KEY_FUNC = "CryptMsgDllGenEncryptKey" +CMSG_OID_EXPORT_ENCRYPT_KEY_FUNC = "CryptMsgDllExportEncryptKey" +CMSG_OID_IMPORT_ENCRYPT_KEY_FUNC = "CryptMsgDllImportEncryptKey" +CMSG_CONTENT_ENCRYPT_PAD_ENCODED_LEN_FLAG = 0x00000001 +CMSG_DEFAULT_INSTALLABLE_FUNC_OID = 1 +CMSG_CONTENT_ENCRYPT_FREE_PARA_FLAG = 0x00000001 +CMSG_CONTENT_ENCRYPT_RELEASE_CONTEXT_FLAG = 0x00008000 +CMSG_OID_GEN_CONTENT_ENCRYPT_KEY_FUNC = "CryptMsgDllGenContentEncryptKey" +CMSG_KEY_TRANS_ENCRYPT_FREE_PARA_FLAG = 0x00000001 +CMSG_OID_EXPORT_KEY_TRANS_FUNC = "CryptMsgDllExportKeyTrans" +CMSG_KEY_AGREE_ENCRYPT_FREE_PARA_FLAG = 0x00000001 +CMSG_KEY_AGREE_ENCRYPT_FREE_MATERIAL_FLAG = 0x00000002 +CMSG_KEY_AGREE_ENCRYPT_FREE_PUBKEY_ALG_FLAG = 0x00000004 +CMSG_KEY_AGREE_ENCRYPT_FREE_PUBKEY_PARA_FLAG = 0x00000008 +CMSG_KEY_AGREE_ENCRYPT_FREE_PUBKEY_BITS_FLAG = 0x00000010 +CMSG_OID_EXPORT_KEY_AGREE_FUNC = "CryptMsgDllExportKeyAgree" +CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG = 0x00000001 +CMSG_OID_EXPORT_MAIL_LIST_FUNC = "CryptMsgDllExportMailList" +CMSG_OID_IMPORT_KEY_TRANS_FUNC = "CryptMsgDllImportKeyTrans" +CMSG_OID_IMPORT_KEY_AGREE_FUNC = "CryptMsgDllImportKeyAgree" +CMSG_OID_IMPORT_MAIL_LIST_FUNC = "CryptMsgDllImportMailList" + +# Certificate property id's used with CertGetCertificateContextProperty +CERT_KEY_PROV_HANDLE_PROP_ID = 1 +CERT_KEY_PROV_INFO_PROP_ID = 2 +CERT_SHA1_HASH_PROP_ID = 3 +CERT_MD5_HASH_PROP_ID = 4 +CERT_HASH_PROP_ID = CERT_SHA1_HASH_PROP_ID +CERT_KEY_CONTEXT_PROP_ID = 5 +CERT_KEY_SPEC_PROP_ID = 6 +CERT_IE30_RESERVED_PROP_ID = 7 +CERT_PUBKEY_HASH_RESERVED_PROP_ID = 8 +CERT_ENHKEY_USAGE_PROP_ID = 9 +CERT_CTL_USAGE_PROP_ID = CERT_ENHKEY_USAGE_PROP_ID +CERT_NEXT_UPDATE_LOCATION_PROP_ID = 10 +CERT_FRIENDLY_NAME_PROP_ID = 11 +CERT_PVK_FILE_PROP_ID = 12 +CERT_DESCRIPTION_PROP_ID = 13 +CERT_ACCESS_STATE_PROP_ID = 14 +CERT_SIGNATURE_HASH_PROP_ID = 15 +CERT_SMART_CARD_DATA_PROP_ID = 16 +CERT_EFS_PROP_ID = 17 +CERT_FORTEZZA_DATA_PROP_ID = 18 +CERT_ARCHIVED_PROP_ID = 19 +CERT_KEY_IDENTIFIER_PROP_ID = 20 +CERT_AUTO_ENROLL_PROP_ID = 21 +CERT_PUBKEY_ALG_PARA_PROP_ID = 22 +CERT_CROSS_CERT_DIST_POINTS_PROP_ID = 23 +CERT_ISSUER_PUBLIC_KEY_MD5_HASH_PROP_ID = 24 +CERT_SUBJECT_PUBLIC_KEY_MD5_HASH_PROP_ID = 25 +CERT_ENROLLMENT_PROP_ID = 26 +CERT_DATE_STAMP_PROP_ID = 27 +CERT_ISSUER_SERIAL_NUMBER_MD5_HASH_PROP_ID = 28 +CERT_SUBJECT_NAME_MD5_HASH_PROP_ID = 29 +CERT_EXTENDED_ERROR_INFO_PROP_ID = 30 +CERT_RENEWAL_PROP_ID = 64 +CERT_ARCHIVED_KEY_HASH_PROP_ID = 65 +CERT_AUTO_ENROLL_RETRY_PROP_ID = 66 +CERT_AIA_URL_RETRIEVED_PROP_ID = 67 +CERT_AUTHORITY_INFO_ACCESS_PROP_ID = 68 +CERT_BACKED_UP_PROP_ID = 69 +CERT_OCSP_RESPONSE_PROP_ID = 70 +CERT_REQUEST_ORIGINATOR_PROP_ID = 71 +CERT_SOURCE_LOCATION_PROP_ID = 72 +CERT_SOURCE_URL_PROP_ID = 73 +CERT_NEW_KEY_PROP_ID = 74 +CERT_OCSP_CACHE_PREFIX_PROP_ID = 75 +CERT_SMART_CARD_ROOT_INFO_PROP_ID = 76 +CERT_NO_AUTO_EXPIRE_CHECK_PROP_ID = 77 +CERT_NCRYPT_KEY_HANDLE_PROP_ID = 78 +CERT_HCRYPTPROV_OR_NCRYPT_KEY_HANDLE_PROP_ID = 79 +CERT_SUBJECT_INFO_ACCESS_PROP_ID = 80 +CERT_CA_OCSP_AUTHORITY_INFO_ACCESS_PROP_ID = 81 +CERT_CA_DISABLE_CRL_PROP_ID = 82 +CERT_ROOT_PROGRAM_CERT_POLICIES_PROP_ID = 83 +CERT_ROOT_PROGRAM_NAME_CONSTRAINTS_PROP_ID = 84 +CERT_SUBJECT_OCSP_AUTHORITY_INFO_ACCESS_PROP_ID = 85 +CERT_SUBJECT_DISABLE_CRL_PROP_ID = 86 +CERT_CEP_PROP_ID = 87 +CERT_SIGN_HASH_CNG_ALG_PROP_ID = 89 +CERT_SCARD_PIN_ID_PROP_ID = 90 +CERT_SCARD_PIN_INFO_PROP_ID = 91 +CERT_FIRST_RESERVED_PROP_ID = 92 +CERT_LAST_RESERVED_PROP_ID = 0x00007FFF +CERT_FIRST_USER_PROP_ID = 0x00008000 +CERT_LAST_USER_PROP_ID = 0x0000FFFF + +szOID_CERT_PROP_ID_PREFIX = "1.3.6.1.4.1.311.10.11." +szOID_CERT_KEY_IDENTIFIER_PROP_ID = "1.3.6.1.4.1.311.10.11.20" +szOID_CERT_ISSUER_SERIAL_NUMBER_MD5_HASH_PROP_ID = "1.3.6.1.4.1.311.10.11.28" +szOID_CERT_SUBJECT_NAME_MD5_HASH_PROP_ID = "1.3.6.1.4.1.311.10.11.29" +CERT_ACCESS_STATE_WRITE_PERSIST_FLAG = 0x1 +CERT_ACCESS_STATE_SYSTEM_STORE_FLAG = 0x2 +CERT_ACCESS_STATE_LM_SYSTEM_STORE_FLAG = 0x4 +CERT_SET_KEY_PROV_HANDLE_PROP_ID = 0x00000001 +CERT_SET_KEY_CONTEXT_PROP_ID = 0x00000001 +sz_CERT_STORE_PROV_MEMORY = "Memory" +sz_CERT_STORE_PROV_FILENAME_W = "File" +sz_CERT_STORE_PROV_FILENAME = sz_CERT_STORE_PROV_FILENAME_W +sz_CERT_STORE_PROV_SYSTEM_W = "System" +sz_CERT_STORE_PROV_SYSTEM = sz_CERT_STORE_PROV_SYSTEM_W +sz_CERT_STORE_PROV_PKCS7 = "PKCS7" +sz_CERT_STORE_PROV_SERIALIZED = "Serialized" +sz_CERT_STORE_PROV_COLLECTION = "Collection" +sz_CERT_STORE_PROV_SYSTEM_REGISTRY_W = "SystemRegistry" +sz_CERT_STORE_PROV_SYSTEM_REGISTRY = sz_CERT_STORE_PROV_SYSTEM_REGISTRY_W +sz_CERT_STORE_PROV_PHYSICAL_W = "Physical" +sz_CERT_STORE_PROV_PHYSICAL = sz_CERT_STORE_PROV_PHYSICAL_W +sz_CERT_STORE_PROV_SMART_CARD_W = "SmartCard" +sz_CERT_STORE_PROV_SMART_CARD = sz_CERT_STORE_PROV_SMART_CARD_W +sz_CERT_STORE_PROV_LDAP_W = "Ldap" +sz_CERT_STORE_PROV_LDAP = sz_CERT_STORE_PROV_LDAP_W +CERT_STORE_SIGNATURE_FLAG = 0x00000001 +CERT_STORE_TIME_VALIDITY_FLAG = 0x00000002 +CERT_STORE_REVOCATION_FLAG = 0x00000004 +CERT_STORE_NO_CRL_FLAG = 0x00010000 +CERT_STORE_NO_ISSUER_FLAG = 0x00020000 +CERT_STORE_BASE_CRL_FLAG = 0x00000100 +CERT_STORE_DELTA_CRL_FLAG = 0x00000200 +CERT_STORE_NO_CRYPT_RELEASE_FLAG = 0x00000001 +CERT_STORE_SET_LOCALIZED_NAME_FLAG = 0x00000002 +CERT_STORE_DEFER_CLOSE_UNTIL_LAST_FREE_FLAG = 0x00000004 +CERT_STORE_DELETE_FLAG = 0x00000010 +CERT_STORE_UNSAFE_PHYSICAL_FLAG = 0x00000020 +CERT_STORE_SHARE_STORE_FLAG = 0x00000040 +CERT_STORE_SHARE_CONTEXT_FLAG = 0x00000080 +CERT_STORE_MANIFOLD_FLAG = 0x00000100 +CERT_STORE_ENUM_ARCHIVED_FLAG = 0x00000200 +CERT_STORE_UPDATE_KEYID_FLAG = 0x00000400 +CERT_STORE_BACKUP_RESTORE_FLAG = 0x00000800 +CERT_STORE_READONLY_FLAG = 0x00008000 +CERT_STORE_OPEN_EXISTING_FLAG = 0x00004000 +CERT_STORE_CREATE_NEW_FLAG = 0x00002000 +CERT_STORE_MAXIMUM_ALLOWED_FLAG = 0x00001000 +CERT_SYSTEM_STORE_MASK = -65536 +CERT_SYSTEM_STORE_RELOCATE_FLAG = -2147483648 +CERT_SYSTEM_STORE_UNPROTECTED_FLAG = 0x40000000 +CERT_SYSTEM_STORE_LOCATION_MASK = 0x00FF0000 +CERT_SYSTEM_STORE_LOCATION_SHIFT = 16 +CERT_SYSTEM_STORE_CURRENT_USER_ID = 1 +CERT_SYSTEM_STORE_LOCAL_MACHINE_ID = 2 +CERT_SYSTEM_STORE_CURRENT_SERVICE_ID = 4 +CERT_SYSTEM_STORE_SERVICES_ID = 5 +CERT_SYSTEM_STORE_USERS_ID = 6 +CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY_ID = 7 +CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY_ID = 8 +CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE_ID = 9 +CERT_SYSTEM_STORE_CURRENT_USER = ( + CERT_SYSTEM_STORE_CURRENT_USER_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT +) +CERT_SYSTEM_STORE_LOCAL_MACHINE = ( + CERT_SYSTEM_STORE_LOCAL_MACHINE_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT +) +CERT_SYSTEM_STORE_CURRENT_SERVICE = ( + CERT_SYSTEM_STORE_CURRENT_SERVICE_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT +) +CERT_SYSTEM_STORE_SERVICES = ( + CERT_SYSTEM_STORE_SERVICES_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT +) +CERT_SYSTEM_STORE_USERS = CERT_SYSTEM_STORE_USERS_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT +CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY = ( + CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT +) +CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY = ( + CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT +) +CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE = ( + CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT +) +CERT_PROT_ROOT_DISABLE_CURRENT_USER_FLAG = 0x1 +CERT_PROT_ROOT_INHIBIT_ADD_AT_INIT_FLAG = 0x2 +CERT_PROT_ROOT_INHIBIT_PURGE_LM_FLAG = 0x4 +CERT_PROT_ROOT_DISABLE_LM_AUTH_FLAG = 0x8 +CERT_PROT_ROOT_ONLY_LM_GPT_FLAG = 0x8 +CERT_PROT_ROOT_DISABLE_NT_AUTH_REQUIRED_FLAG = 0x10 +CERT_PROT_ROOT_DISABLE_NOT_DEFINED_NAME_CONSTRAINT_FLAG = 0x20 +CERT_TRUST_PUB_ALLOW_TRUST_MASK = 0x00000003 +CERT_TRUST_PUB_ALLOW_END_USER_TRUST = 0x00000000 +CERT_TRUST_PUB_ALLOW_MACHINE_ADMIN_TRUST = 0x00000001 +CERT_TRUST_PUB_ALLOW_ENTERPRISE_ADMIN_TRUST = 0x00000002 +CERT_TRUST_PUB_CHECK_PUBLISHER_REV_FLAG = 0x00000100 +CERT_TRUST_PUB_CHECK_TIMESTAMP_REV_FLAG = 0x00000200 + +CERT_AUTH_ROOT_AUTO_UPDATE_LOCAL_MACHINE_REGPATH = ( + r"Software\Microsoft\SystemCertificates\AuthRoot\AutoUpdate" +) +CERT_AUTH_ROOT_AUTO_UPDATE_DISABLE_UNTRUSTED_ROOT_LOGGING_FLAG = 0x1 +CERT_AUTH_ROOT_AUTO_UPDATE_DISABLE_PARTIAL_CHAIN_LOGGING_FLAG = 0x2 +CERT_AUTH_ROOT_AUTO_UPDATE_ROOT_DIR_URL_VALUE_NAME = "RootDirUrl" +CERT_AUTH_ROOT_AUTO_UPDATE_SYNC_DELTA_TIME_VALUE_NAME = "SyncDeltaTime" +CERT_AUTH_ROOT_AUTO_UPDATE_FLAGS_VALUE_NAME = "Flags" +CERT_AUTH_ROOT_CTL_FILENAME = "authroot.stl" +CERT_AUTH_ROOT_CTL_FILENAME_A = "authroot.stl" +CERT_AUTH_ROOT_CAB_FILENAME = "authrootstl.cab" +CERT_AUTH_ROOT_SEQ_FILENAME = "authrootseq.txt" +CERT_AUTH_ROOT_CERT_EXT = ".crt" + +CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH = ( + r"Software\Policies\Microsoft\SystemCertificates" +) +CERT_EFSBLOB_REGPATH = CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH + r"\EFS" +CERT_EFSBLOB_VALUE_NAME = "EFSBlob" +CERT_PROT_ROOT_FLAGS_REGPATH = ( + CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH + r"\Root\ProtectedRoots" +) +CERT_PROT_ROOT_FLAGS_VALUE_NAME = "Flags" +CERT_TRUST_PUB_SAFER_GROUP_POLICY_REGPATH = ( + CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH + r"\TrustedPublisher\Safer" +) +CERT_LOCAL_MACHINE_SYSTEM_STORE_REGPATH = r"Software\Microsoft\SystemCertificates" +CERT_TRUST_PUB_SAFER_LOCAL_MACHINE_REGPATH = ( + CERT_LOCAL_MACHINE_SYSTEM_STORE_REGPATH + r"\TrustedPublisher\Safer" +) +CERT_TRUST_PUB_AUTHENTICODE_FLAGS_VALUE_NAME = "AuthenticodeFlags" +CERT_OCM_SUBCOMPONENTS_LOCAL_MACHINE_REGPATH = ( + r"SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\OC Manager\Subcomponents" +) +CERT_OCM_SUBCOMPONENTS_ROOT_AUTO_UPDATE_VALUE_NAME = r"RootAutoUpdate" +CERT_DISABLE_ROOT_AUTO_UPDATE_REGPATH = ( + CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH + r"\AuthRoot" +) +CERT_DISABLE_ROOT_AUTO_UPDATE_VALUE_NAME = "DisableRootAutoUpdate" +CERT_AUTH_ROOT_AUTO_UPDATE_LOCAL_MACHINE_REGPATH = ( + CERT_LOCAL_MACHINE_SYSTEM_STORE_REGPATH + r"\AuthRoot\AutoUpdate" +) + +CERT_REGISTRY_STORE_REMOTE_FLAG = 0x10000 +CERT_REGISTRY_STORE_SERIALIZED_FLAG = 0x20000 +CERT_REGISTRY_STORE_CLIENT_GPT_FLAG = -2147483648 +CERT_REGISTRY_STORE_LM_GPT_FLAG = 0x01000000 +CERT_REGISTRY_STORE_ROAMING_FLAG = 0x40000 +CERT_REGISTRY_STORE_MY_IE_DIRTY_FLAG = 0x80000 +CERT_IE_DIRTY_FLAGS_REGPATH = r"Software\Microsoft\Cryptography\IEDirtyFlags" + +CERT_FILE_STORE_COMMIT_ENABLE_FLAG = 0x10000 +CERT_LDAP_STORE_SIGN_FLAG = 0x10000 +CERT_LDAP_STORE_AREC_EXCLUSIVE_FLAG = 0x20000 +CERT_LDAP_STORE_OPENED_FLAG = 0x40000 +CERT_LDAP_STORE_UNBIND_FLAG = 0x80000 +CRYPT_OID_OPEN_STORE_PROV_FUNC = "CertDllOpenStoreProv" + +CERT_STORE_PROV_EXTERNAL_FLAG = 0x1 +CERT_STORE_PROV_DELETED_FLAG = 0x2 +CERT_STORE_PROV_NO_PERSIST_FLAG = 0x4 +CERT_STORE_PROV_SYSTEM_STORE_FLAG = 0x8 +CERT_STORE_PROV_LM_SYSTEM_STORE_FLAG = 0x10 +CERT_STORE_PROV_CLOSE_FUNC = 0 +CERT_STORE_PROV_READ_CERT_FUNC = 1 +CERT_STORE_PROV_WRITE_CERT_FUNC = 2 +CERT_STORE_PROV_DELETE_CERT_FUNC = 3 +CERT_STORE_PROV_SET_CERT_PROPERTY_FUNC = 4 +CERT_STORE_PROV_READ_CRL_FUNC = 5 +CERT_STORE_PROV_WRITE_CRL_FUNC = 6 +CERT_STORE_PROV_DELETE_CRL_FUNC = 7 +CERT_STORE_PROV_SET_CRL_PROPERTY_FUNC = 8 +CERT_STORE_PROV_READ_CTL_FUNC = 9 +CERT_STORE_PROV_WRITE_CTL_FUNC = 10 +CERT_STORE_PROV_DELETE_CTL_FUNC = 11 +CERT_STORE_PROV_SET_CTL_PROPERTY_FUNC = 12 +CERT_STORE_PROV_CONTROL_FUNC = 13 +CERT_STORE_PROV_FIND_CERT_FUNC = 14 +CERT_STORE_PROV_FREE_FIND_CERT_FUNC = 15 +CERT_STORE_PROV_GET_CERT_PROPERTY_FUNC = 16 +CERT_STORE_PROV_FIND_CRL_FUNC = 17 +CERT_STORE_PROV_FREE_FIND_CRL_FUNC = 18 +CERT_STORE_PROV_GET_CRL_PROPERTY_FUNC = 19 +CERT_STORE_PROV_FIND_CTL_FUNC = 20 +CERT_STORE_PROV_FREE_FIND_CTL_FUNC = 21 +CERT_STORE_PROV_GET_CTL_PROPERTY_FUNC = 22 +CERT_STORE_PROV_WRITE_ADD_FLAG = 0x1 +CERT_STORE_SAVE_AS_STORE = 1 +CERT_STORE_SAVE_AS_PKCS7 = 2 +CERT_STORE_SAVE_TO_FILE = 1 +CERT_STORE_SAVE_TO_MEMORY = 2 +CERT_STORE_SAVE_TO_FILENAME_A = 3 +CERT_STORE_SAVE_TO_FILENAME_W = 4 +CERT_STORE_SAVE_TO_FILENAME = CERT_STORE_SAVE_TO_FILENAME_W +CERT_CLOSE_STORE_FORCE_FLAG = 0x00000001 +CERT_CLOSE_STORE_CHECK_FLAG = 0x00000002 +CERT_COMPARE_MASK = 0xFFFF +CERT_COMPARE_SHIFT = 16 +CERT_COMPARE_ANY = 0 +CERT_COMPARE_SHA1_HASH = 1 +CERT_COMPARE_NAME = 2 +CERT_COMPARE_ATTR = 3 +CERT_COMPARE_MD5_HASH = 4 +CERT_COMPARE_PROPERTY = 5 +CERT_COMPARE_PUBLIC_KEY = 6 +CERT_COMPARE_HASH = CERT_COMPARE_SHA1_HASH +CERT_COMPARE_NAME_STR_A = 7 +CERT_COMPARE_NAME_STR_W = 8 +CERT_COMPARE_KEY_SPEC = 9 +CERT_COMPARE_ENHKEY_USAGE = 10 +CERT_COMPARE_CTL_USAGE = CERT_COMPARE_ENHKEY_USAGE +CERT_COMPARE_SUBJECT_CERT = 11 +CERT_COMPARE_ISSUER_OF = 12 +CERT_COMPARE_EXISTING = 13 +CERT_COMPARE_SIGNATURE_HASH = 14 +CERT_COMPARE_KEY_IDENTIFIER = 15 +CERT_COMPARE_CERT_ID = 16 +CERT_COMPARE_CROSS_CERT_DIST_POINTS = 17 +CERT_COMPARE_PUBKEY_MD5_HASH = 18 +CERT_FIND_ANY = CERT_COMPARE_ANY << CERT_COMPARE_SHIFT +CERT_FIND_SHA1_HASH = CERT_COMPARE_SHA1_HASH << CERT_COMPARE_SHIFT +CERT_FIND_MD5_HASH = CERT_COMPARE_MD5_HASH << CERT_COMPARE_SHIFT +CERT_FIND_SIGNATURE_HASH = CERT_COMPARE_SIGNATURE_HASH << CERT_COMPARE_SHIFT +CERT_FIND_KEY_IDENTIFIER = CERT_COMPARE_KEY_IDENTIFIER << CERT_COMPARE_SHIFT +CERT_FIND_HASH = CERT_FIND_SHA1_HASH +CERT_FIND_PROPERTY = CERT_COMPARE_PROPERTY << CERT_COMPARE_SHIFT +CERT_FIND_PUBLIC_KEY = CERT_COMPARE_PUBLIC_KEY << CERT_COMPARE_SHIFT +CERT_FIND_SUBJECT_NAME = ( + CERT_COMPARE_NAME << CERT_COMPARE_SHIFT | CERT_INFO_SUBJECT_FLAG +) +CERT_FIND_SUBJECT_ATTR = ( + CERT_COMPARE_ATTR << CERT_COMPARE_SHIFT | CERT_INFO_SUBJECT_FLAG +) +CERT_FIND_ISSUER_NAME = CERT_COMPARE_NAME << CERT_COMPARE_SHIFT | CERT_INFO_ISSUER_FLAG +CERT_FIND_ISSUER_ATTR = CERT_COMPARE_ATTR << CERT_COMPARE_SHIFT | CERT_INFO_ISSUER_FLAG +CERT_FIND_SUBJECT_STR_A = ( + CERT_COMPARE_NAME_STR_A << CERT_COMPARE_SHIFT | CERT_INFO_SUBJECT_FLAG +) +CERT_FIND_SUBJECT_STR_W = ( + CERT_COMPARE_NAME_STR_W << CERT_COMPARE_SHIFT | CERT_INFO_SUBJECT_FLAG +) +CERT_FIND_SUBJECT_STR = CERT_FIND_SUBJECT_STR_W +CERT_FIND_ISSUER_STR_A = ( + CERT_COMPARE_NAME_STR_A << CERT_COMPARE_SHIFT | CERT_INFO_ISSUER_FLAG +) +CERT_FIND_ISSUER_STR_W = ( + CERT_COMPARE_NAME_STR_W << CERT_COMPARE_SHIFT | CERT_INFO_ISSUER_FLAG +) +CERT_FIND_ISSUER_STR = CERT_FIND_ISSUER_STR_W +CERT_FIND_KEY_SPEC = CERT_COMPARE_KEY_SPEC << CERT_COMPARE_SHIFT +CERT_FIND_ENHKEY_USAGE = CERT_COMPARE_ENHKEY_USAGE << CERT_COMPARE_SHIFT +CERT_FIND_CTL_USAGE = CERT_FIND_ENHKEY_USAGE +CERT_FIND_SUBJECT_CERT = CERT_COMPARE_SUBJECT_CERT << CERT_COMPARE_SHIFT +CERT_FIND_ISSUER_OF = CERT_COMPARE_ISSUER_OF << CERT_COMPARE_SHIFT +CERT_FIND_EXISTING = CERT_COMPARE_EXISTING << CERT_COMPARE_SHIFT +CERT_FIND_CERT_ID = CERT_COMPARE_CERT_ID << CERT_COMPARE_SHIFT +CERT_FIND_CROSS_CERT_DIST_POINTS = ( + CERT_COMPARE_CROSS_CERT_DIST_POINTS << CERT_COMPARE_SHIFT +) +CERT_FIND_PUBKEY_MD5_HASH = CERT_COMPARE_PUBKEY_MD5_HASH << CERT_COMPARE_SHIFT +CERT_FIND_OPTIONAL_ENHKEY_USAGE_FLAG = 0x1 +CERT_FIND_EXT_ONLY_ENHKEY_USAGE_FLAG = 0x2 +CERT_FIND_PROP_ONLY_ENHKEY_USAGE_FLAG = 0x4 +CERT_FIND_NO_ENHKEY_USAGE_FLAG = 0x8 +CERT_FIND_OR_ENHKEY_USAGE_FLAG = 0x10 +CERT_FIND_VALID_ENHKEY_USAGE_FLAG = 0x20 +CERT_FIND_OPTIONAL_CTL_USAGE_FLAG = CERT_FIND_OPTIONAL_ENHKEY_USAGE_FLAG +CERT_FIND_EXT_ONLY_CTL_USAGE_FLAG = CERT_FIND_EXT_ONLY_ENHKEY_USAGE_FLAG +CERT_FIND_PROP_ONLY_CTL_USAGE_FLAG = CERT_FIND_PROP_ONLY_ENHKEY_USAGE_FLAG +CERT_FIND_NO_CTL_USAGE_FLAG = CERT_FIND_NO_ENHKEY_USAGE_FLAG +CERT_FIND_OR_CTL_USAGE_FLAG = CERT_FIND_OR_ENHKEY_USAGE_FLAG +CERT_FIND_VALID_CTL_USAGE_FLAG = CERT_FIND_VALID_ENHKEY_USAGE_FLAG +CERT_SET_PROPERTY_IGNORE_PERSIST_ERROR_FLAG = -2147483648 +CERT_SET_PROPERTY_INHIBIT_PERSIST_FLAG = 0x40000000 +CTL_ENTRY_FROM_PROP_CHAIN_FLAG = 0x1 +CRL_FIND_ANY = 0 +CRL_FIND_ISSUED_BY = 1 +CRL_FIND_EXISTING = 2 +CRL_FIND_ISSUED_FOR = 3 +CRL_FIND_ISSUED_BY_AKI_FLAG = 0x1 +CRL_FIND_ISSUED_BY_SIGNATURE_FLAG = 0x2 +CRL_FIND_ISSUED_BY_DELTA_FLAG = 0x4 +CRL_FIND_ISSUED_BY_BASE_FLAG = 0x8 +CERT_STORE_ADD_NEW = 1 +CERT_STORE_ADD_USE_EXISTING = 2 +CERT_STORE_ADD_REPLACE_EXISTING = 3 +CERT_STORE_ADD_ALWAYS = 4 +CERT_STORE_ADD_REPLACE_EXISTING_INHERIT_PROPERTIES = 5 +CERT_STORE_ADD_NEWER = 6 +CERT_STORE_ADD_NEWER_INHERIT_PROPERTIES = 7 +CERT_STORE_CERTIFICATE_CONTEXT = 1 +CERT_STORE_CRL_CONTEXT = 2 +CERT_STORE_CTL_CONTEXT = 3 + +CERT_STORE_ALL_CONTEXT_FLAG = -1 +CERT_STORE_CERTIFICATE_CONTEXT_FLAG = 1 << CERT_STORE_CERTIFICATE_CONTEXT +CERT_STORE_CRL_CONTEXT_FLAG = 1 << CERT_STORE_CRL_CONTEXT +CERT_STORE_CTL_CONTEXT_FLAG = 1 << CERT_STORE_CTL_CONTEXT +CTL_ANY_SUBJECT_TYPE = 1 +CTL_CERT_SUBJECT_TYPE = 2 +CTL_FIND_ANY = 0 +CTL_FIND_SHA1_HASH = 1 +CTL_FIND_MD5_HASH = 2 +CTL_FIND_USAGE = 3 +CTL_FIND_SUBJECT = 4 +CTL_FIND_EXISTING = 5 +CTL_FIND_NO_LIST_ID_CBDATA = -1 +CTL_FIND_SAME_USAGE_FLAG = 0x1 +CERT_STORE_CTRL_RESYNC = 1 +CERT_STORE_CTRL_NOTIFY_CHANGE = 2 +CERT_STORE_CTRL_COMMIT = 3 +CERT_STORE_CTRL_AUTO_RESYNC = 4 +CERT_STORE_CTRL_CANCEL_NOTIFY = 5 +CERT_STORE_CTRL_INHIBIT_DUPLICATE_HANDLE_FLAG = 0x1 +CERT_STORE_CTRL_COMMIT_FORCE_FLAG = 0x1 +CERT_STORE_CTRL_COMMIT_CLEAR_FLAG = 0x2 +CERT_STORE_LOCALIZED_NAME_PROP_ID = 0x1000 +CERT_CREATE_CONTEXT_NOCOPY_FLAG = 0x1 +CERT_CREATE_CONTEXT_SORTED_FLAG = 0x2 +CERT_CREATE_CONTEXT_NO_HCRYPTMSG_FLAG = 0x4 +CERT_CREATE_CONTEXT_NO_ENTRY_FLAG = 0x8 + +CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG = 0x1 +CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG = 0x2 +CERT_PHYSICAL_STORE_REMOTE_OPEN_DISABLE_FLAG = 0x4 +CERT_PHYSICAL_STORE_INSERT_COMPUTER_NAME_ENABLE_FLAG = 0x8 +CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG = 0x1 + +# Names of physical cert stores +CERT_PHYSICAL_STORE_DEFAULT_NAME = ".Default" +CERT_PHYSICAL_STORE_GROUP_POLICY_NAME = ".GroupPolicy" +CERT_PHYSICAL_STORE_LOCAL_MACHINE_NAME = ".LocalMachine" +CERT_PHYSICAL_STORE_DS_USER_CERTIFICATE_NAME = ".UserCertificate" +CERT_PHYSICAL_STORE_LOCAL_MACHINE_GROUP_POLICY_NAME = ".LocalMachineGroupPolicy" +CERT_PHYSICAL_STORE_ENTERPRISE_NAME = ".Enterprise" +CERT_PHYSICAL_STORE_AUTH_ROOT_NAME = ".AuthRoot" +CERT_PHYSICAL_STORE_SMART_CARD_NAME = ".SmartCard" + +CRYPT_OID_OPEN_SYSTEM_STORE_PROV_FUNC = "CertDllOpenSystemStoreProv" +CRYPT_OID_REGISTER_SYSTEM_STORE_FUNC = "CertDllRegisterSystemStore" +CRYPT_OID_UNREGISTER_SYSTEM_STORE_FUNC = "CertDllUnregisterSystemStore" +CRYPT_OID_ENUM_SYSTEM_STORE_FUNC = "CertDllEnumSystemStore" +CRYPT_OID_REGISTER_PHYSICAL_STORE_FUNC = "CertDllRegisterPhysicalStore" +CRYPT_OID_UNREGISTER_PHYSICAL_STORE_FUNC = "CertDllUnregisterPhysicalStore" +CRYPT_OID_ENUM_PHYSICAL_STORE_FUNC = "CertDllEnumPhysicalStore" +CRYPT_OID_SYSTEM_STORE_LOCATION_VALUE_NAME = "SystemStoreLocation" + +CMSG_TRUSTED_SIGNER_FLAG = 0x1 +CMSG_SIGNER_ONLY_FLAG = 0x2 +CMSG_USE_SIGNER_INDEX_FLAG = 0x4 +CMSG_CMS_ENCAPSULATED_CTL_FLAG = 0x00008000 +CMSG_ENCODE_SORTED_CTL_FLAG = 0x1 +CMSG_ENCODE_HASHED_SUBJECT_IDENTIFIER_FLAG = 0x2 +CERT_VERIFY_INHIBIT_CTL_UPDATE_FLAG = 0x1 +CERT_VERIFY_TRUSTED_SIGNERS_FLAG = 0x2 +CERT_VERIFY_NO_TIME_CHECK_FLAG = 0x4 +CERT_VERIFY_ALLOW_MORE_USAGE_FLAG = 0x8 +CERT_VERIFY_UPDATED_CTL_FLAG = 0x1 +CERT_CONTEXT_REVOCATION_TYPE = 1 +CERT_VERIFY_REV_CHAIN_FLAG = 0x00000001 +CERT_VERIFY_CACHE_ONLY_BASED_REVOCATION = 0x00000002 +CERT_VERIFY_REV_ACCUMULATIVE_TIMEOUT_FLAG = 0x00000004 +CERT_UNICODE_IS_RDN_ATTRS_FLAG = 0x1 +CERT_CASE_INSENSITIVE_IS_RDN_ATTRS_FLAG = 0x2 +CRYPT_VERIFY_CERT_SIGN_SUBJECT_BLOB = 1 +CRYPT_VERIFY_CERT_SIGN_SUBJECT_CERT = 2 +CRYPT_VERIFY_CERT_SIGN_SUBJECT_CRL = 3 +CRYPT_VERIFY_CERT_SIGN_ISSUER_PUBKEY = 1 +CRYPT_VERIFY_CERT_SIGN_ISSUER_CERT = 2 +CRYPT_VERIFY_CERT_SIGN_ISSUER_CHAIN = 3 +CRYPT_VERIFY_CERT_SIGN_ISSUER_NULL = 4 +CRYPT_DEFAULT_CONTEXT_AUTO_RELEASE_FLAG = 0x00000001 +CRYPT_DEFAULT_CONTEXT_PROCESS_FLAG = 0x00000002 +CRYPT_DEFAULT_CONTEXT_CERT_SIGN_OID = 1 +CRYPT_DEFAULT_CONTEXT_MULTI_CERT_SIGN_OID = 2 +CRYPT_OID_EXPORT_PUBLIC_KEY_INFO_FUNC = "CryptDllExportPublicKeyInfoEx" +CRYPT_OID_IMPORT_PUBLIC_KEY_INFO_FUNC = "CryptDllImportPublicKeyInfoEx" +CRYPT_ACQUIRE_CACHE_FLAG = 0x00000001 +CRYPT_ACQUIRE_USE_PROV_INFO_FLAG = 0x00000002 +CRYPT_ACQUIRE_COMPARE_KEY_FLAG = 0x00000004 +CRYPT_ACQUIRE_SILENT_FLAG = 0x00000040 +CRYPT_FIND_USER_KEYSET_FLAG = 0x00000001 +CRYPT_FIND_MACHINE_KEYSET_FLAG = 0x00000002 +CRYPT_FIND_SILENT_KEYSET_FLAG = 0x00000040 +CRYPT_OID_IMPORT_PRIVATE_KEY_INFO_FUNC = "CryptDllImportPrivateKeyInfoEx" +CRYPT_OID_EXPORT_PRIVATE_KEY_INFO_FUNC = "CryptDllExportPrivateKeyInfoEx" +CRYPT_DELETE_KEYSET = CRYPT_DELETEKEYSET +CERT_SIMPLE_NAME_STR = 1 +CERT_OID_NAME_STR = 2 +CERT_X500_NAME_STR = 3 +CERT_NAME_STR_SEMICOLON_FLAG = 0x40000000 +CERT_NAME_STR_NO_PLUS_FLAG = 0x20000000 +CERT_NAME_STR_NO_QUOTING_FLAG = 0x10000000 +CERT_NAME_STR_CRLF_FLAG = 0x08000000 +CERT_NAME_STR_COMMA_FLAG = 0x04000000 +CERT_NAME_STR_REVERSE_FLAG = 0x02000000 +CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG = 0x00010000 +CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG = 0x00020000 +CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG = 0x00040000 +CERT_NAME_EMAIL_TYPE = 1 +CERT_NAME_RDN_TYPE = 2 +CERT_NAME_ATTR_TYPE = 3 +CERT_NAME_SIMPLE_DISPLAY_TYPE = 4 +CERT_NAME_FRIENDLY_DISPLAY_TYPE = 5 +CERT_NAME_DNS_TYPE = 6 +CERT_NAME_URL_TYPE = 7 +CERT_NAME_UPN_TYPE = 8 +CERT_NAME_ISSUER_FLAG = 0x1 +CERT_NAME_DISABLE_IE4_UTF8_FLAG = 0x00010000 +CRYPT_MESSAGE_BARE_CONTENT_OUT_FLAG = 0x00000001 +CRYPT_MESSAGE_ENCAPSULATED_CONTENT_OUT_FLAG = 0x00000002 +CRYPT_MESSAGE_KEYID_SIGNER_FLAG = 0x00000004 +CRYPT_MESSAGE_SILENT_KEYSET_FLAG = 0x00000040 +CRYPT_MESSAGE_KEYID_RECIPIENT_FLAG = 0x4 +CERT_QUERY_OBJECT_FILE = 0x00000001 +CERT_QUERY_OBJECT_BLOB = 0x00000002 +CERT_QUERY_CONTENT_CERT = 1 +CERT_QUERY_CONTENT_CTL = 2 +CERT_QUERY_CONTENT_CRL = 3 +CERT_QUERY_CONTENT_SERIALIZED_STORE = 4 +CERT_QUERY_CONTENT_SERIALIZED_CERT = 5 +CERT_QUERY_CONTENT_SERIALIZED_CTL = 6 +CERT_QUERY_CONTENT_SERIALIZED_CRL = 7 +CERT_QUERY_CONTENT_PKCS7_SIGNED = 8 +CERT_QUERY_CONTENT_PKCS7_UNSIGNED = 9 +CERT_QUERY_CONTENT_PKCS7_SIGNED_EMBED = 10 +CERT_QUERY_CONTENT_PKCS10 = 11 +CERT_QUERY_CONTENT_PFX = 12 +CERT_QUERY_CONTENT_CERT_PAIR = 13 +CERT_QUERY_CONTENT_FLAG_CERT = 1 << CERT_QUERY_CONTENT_CERT +CERT_QUERY_CONTENT_FLAG_CTL = 1 << CERT_QUERY_CONTENT_CTL +CERT_QUERY_CONTENT_FLAG_CRL = 1 << CERT_QUERY_CONTENT_CRL +CERT_QUERY_CONTENT_FLAG_SERIALIZED_STORE = 1 << CERT_QUERY_CONTENT_SERIALIZED_STORE +CERT_QUERY_CONTENT_FLAG_SERIALIZED_CERT = 1 << CERT_QUERY_CONTENT_SERIALIZED_CERT +CERT_QUERY_CONTENT_FLAG_SERIALIZED_CTL = 1 << CERT_QUERY_CONTENT_SERIALIZED_CTL +CERT_QUERY_CONTENT_FLAG_SERIALIZED_CRL = 1 << CERT_QUERY_CONTENT_SERIALIZED_CRL +CERT_QUERY_CONTENT_FLAG_PKCS7_SIGNED = 1 << CERT_QUERY_CONTENT_PKCS7_SIGNED +CERT_QUERY_CONTENT_FLAG_PKCS7_UNSIGNED = 1 << CERT_QUERY_CONTENT_PKCS7_UNSIGNED +CERT_QUERY_CONTENT_FLAG_PKCS7_SIGNED_EMBED = 1 << CERT_QUERY_CONTENT_PKCS7_SIGNED_EMBED +CERT_QUERY_CONTENT_FLAG_PKCS10 = 1 << CERT_QUERY_CONTENT_PKCS10 +CERT_QUERY_CONTENT_FLAG_PFX = 1 << CERT_QUERY_CONTENT_PFX +CERT_QUERY_CONTENT_FLAG_CERT_PAIR = 1 << CERT_QUERY_CONTENT_CERT_PAIR +CERT_QUERY_CONTENT_FLAG_ALL = ( + CERT_QUERY_CONTENT_FLAG_CERT + | CERT_QUERY_CONTENT_FLAG_CTL + | CERT_QUERY_CONTENT_FLAG_CRL + | CERT_QUERY_CONTENT_FLAG_SERIALIZED_STORE + | CERT_QUERY_CONTENT_FLAG_SERIALIZED_CERT + | CERT_QUERY_CONTENT_FLAG_SERIALIZED_CTL + | CERT_QUERY_CONTENT_FLAG_SERIALIZED_CRL + | CERT_QUERY_CONTENT_FLAG_PKCS7_SIGNED + | CERT_QUERY_CONTENT_FLAG_PKCS7_UNSIGNED + | CERT_QUERY_CONTENT_FLAG_PKCS7_SIGNED_EMBED + | CERT_QUERY_CONTENT_FLAG_PKCS10 + | CERT_QUERY_CONTENT_FLAG_PFX + | CERT_QUERY_CONTENT_FLAG_CERT_PAIR +) +CERT_QUERY_FORMAT_BINARY = 1 +CERT_QUERY_FORMAT_BASE64_ENCODED = 2 +CERT_QUERY_FORMAT_ASN_ASCII_HEX_ENCODED = 3 +CERT_QUERY_FORMAT_FLAG_BINARY = 1 << CERT_QUERY_FORMAT_BINARY +CERT_QUERY_FORMAT_FLAG_BASE64_ENCODED = 1 << CERT_QUERY_FORMAT_BASE64_ENCODED +CERT_QUERY_FORMAT_FLAG_ASN_ASCII_HEX_ENCODED = ( + 1 << CERT_QUERY_FORMAT_ASN_ASCII_HEX_ENCODED +) +CERT_QUERY_FORMAT_FLAG_ALL = ( + CERT_QUERY_FORMAT_FLAG_BINARY + | CERT_QUERY_FORMAT_FLAG_BASE64_ENCODED + | CERT_QUERY_FORMAT_FLAG_ASN_ASCII_HEX_ENCODED +) + +CREDENTIAL_OID_PASSWORD_CREDENTIALS_A = 1 +CREDENTIAL_OID_PASSWORD_CREDENTIALS_W = 2 +CREDENTIAL_OID_PASSWORD_CREDENTIALS = CREDENTIAL_OID_PASSWORD_CREDENTIALS_W + +SCHEME_OID_RETRIEVE_ENCODED_OBJECT_FUNC = "SchemeDllRetrieveEncodedObject" +SCHEME_OID_RETRIEVE_ENCODED_OBJECTW_FUNC = "SchemeDllRetrieveEncodedObjectW" +CONTEXT_OID_CREATE_OBJECT_CONTEXT_FUNC = "ContextDllCreateObjectContext" +CONTEXT_OID_CERTIFICATE = 1 +CONTEXT_OID_CRL = 2 +CONTEXT_OID_CTL = 3 +CONTEXT_OID_PKCS7 = 4 +CONTEXT_OID_CAPI2_ANY = 5 +CONTEXT_OID_OCSP_RESP = 6 + +CRYPT_RETRIEVE_MULTIPLE_OBJECTS = 0x00000001 +CRYPT_CACHE_ONLY_RETRIEVAL = 0x00000002 +CRYPT_WIRE_ONLY_RETRIEVAL = 0x00000004 +CRYPT_DONT_CACHE_RESULT = 0x00000008 +CRYPT_ASYNC_RETRIEVAL = 0x00000010 +CRYPT_STICKY_CACHE_RETRIEVAL = 0x00001000 +CRYPT_LDAP_SCOPE_BASE_ONLY_RETRIEVAL = 0x00002000 +CRYPT_OFFLINE_CHECK_RETRIEVAL = 0x00004000 +CRYPT_LDAP_INSERT_ENTRY_ATTRIBUTE = 0x00008000 +CRYPT_LDAP_SIGN_RETRIEVAL = 0x00010000 +CRYPT_NO_AUTH_RETRIEVAL = 0x00020000 +CRYPT_LDAP_AREC_EXCLUSIVE_RETRIEVAL = 0x00040000 +CRYPT_AIA_RETRIEVAL = 0x00080000 +CRYPT_VERIFY_CONTEXT_SIGNATURE = 0x00000020 +CRYPT_VERIFY_DATA_HASH = 0x00000040 +CRYPT_KEEP_TIME_VALID = 0x00000080 +CRYPT_DONT_VERIFY_SIGNATURE = 0x00000100 +CRYPT_DONT_CHECK_TIME_VALIDITY = 0x00000200 +CRYPT_CHECK_FRESHNESS_TIME_VALIDITY = 0x00000400 +CRYPT_ACCUMULATIVE_TIMEOUT = 0x00000800 +CRYPT_PARAM_ASYNC_RETRIEVAL_COMPLETION = 1 +CRYPT_PARAM_CANCEL_ASYNC_RETRIEVAL = 2 +CRYPT_GET_URL_FROM_PROPERTY = 0x00000001 +CRYPT_GET_URL_FROM_EXTENSION = 0x00000002 +CRYPT_GET_URL_FROM_UNAUTH_ATTRIBUTE = 0x00000004 +CRYPT_GET_URL_FROM_AUTH_ATTRIBUTE = 0x00000008 +URL_OID_GET_OBJECT_URL_FUNC = "UrlDllGetObjectUrl" +TIME_VALID_OID_GET_OBJECT_FUNC = "TimeValidDllGetObject" +TIME_VALID_OID_FLUSH_OBJECT_FUNC = "TimeValidDllFlushObject" + +TIME_VALID_OID_GET_CTL = 1 +TIME_VALID_OID_GET_CRL = 2 +TIME_VALID_OID_GET_CRL_FROM_CERT = 3 +TIME_VALID_OID_GET_FRESHEST_CRL_FROM_CERT = 4 +TIME_VALID_OID_GET_FRESHEST_CRL_FROM_CRL = 5 + +TIME_VALID_OID_FLUSH_CTL = 1 +TIME_VALID_OID_FLUSH_CRL = 2 +TIME_VALID_OID_FLUSH_CRL_FROM_CERT = 3 +TIME_VALID_OID_FLUSH_FRESHEST_CRL_FROM_CERT = 4 +TIME_VALID_OID_FLUSH_FRESHEST_CRL_FROM_CRL = 5 + +CRYPTPROTECT_PROMPT_ON_UNPROTECT = 0x1 +CRYPTPROTECT_PROMPT_ON_PROTECT = 0x2 +CRYPTPROTECT_PROMPT_RESERVED = 0x04 +CRYPTPROTECT_PROMPT_STRONG = 0x08 +CRYPTPROTECT_PROMPT_REQUIRE_STRONG = 0x10 +CRYPTPROTECT_UI_FORBIDDEN = 0x1 +CRYPTPROTECT_LOCAL_MACHINE = 0x4 +CRYPTPROTECT_CRED_SYNC = 0x8 +CRYPTPROTECT_AUDIT = 0x10 +CRYPTPROTECT_NO_RECOVERY = 0x20 +CRYPTPROTECT_VERIFY_PROTECTION = 0x40 +CRYPTPROTECT_CRED_REGENERATE = 0x80 +CRYPTPROTECT_FIRST_RESERVED_FLAGVAL = 0x0FFFFFFF +CRYPTPROTECT_LAST_RESERVED_FLAGVAL = -1 +CRYPTPROTECTMEMORY_BLOCK_SIZE = 16 +CRYPTPROTECTMEMORY_SAME_PROCESS = 0x00 +CRYPTPROTECTMEMORY_CROSS_PROCESS = 0x01 +CRYPTPROTECTMEMORY_SAME_LOGON = 0x02 +CERT_CREATE_SELFSIGN_NO_SIGN = 1 +CERT_CREATE_SELFSIGN_NO_KEY_INFO = 2 +CRYPT_KEYID_MACHINE_FLAG = 0x00000020 +CRYPT_KEYID_ALLOC_FLAG = 0x00008000 +CRYPT_KEYID_DELETE_FLAG = 0x00000010 +CRYPT_KEYID_SET_NEW_FLAG = 0x00002000 +CERT_CHAIN_MAX_AIA_URL_COUNT_IN_CERT_DEFAULT = 5 +CERT_CHAIN_MAX_AIA_URL_RETRIEVAL_COUNT_PER_CHAIN_DEFAULT = 10 +CERT_CHAIN_MAX_AIA_URL_RETRIEVAL_BYTE_COUNT_DEFAULT = 100000 +CERT_CHAIN_MAX_AIA_URL_RETRIEVAL_CERT_COUNT_DEFAULT = 10 +CERT_CHAIN_CACHE_END_CERT = 0x00000001 +CERT_CHAIN_THREAD_STORE_SYNC = 0x00000002 +CERT_CHAIN_CACHE_ONLY_URL_RETRIEVAL = 0x00000004 +CERT_CHAIN_USE_LOCAL_MACHINE_STORE = 0x00000008 +CERT_CHAIN_ENABLE_CACHE_AUTO_UPDATE = 0x00000010 +CERT_CHAIN_ENABLE_SHARE_STORE = 0x00000020 +CERT_TRUST_NO_ERROR = 0x00000000 +CERT_TRUST_IS_NOT_TIME_VALID = 0x00000001 +CERT_TRUST_IS_NOT_TIME_NESTED = 0x00000002 +CERT_TRUST_IS_REVOKED = 0x00000004 +CERT_TRUST_IS_NOT_SIGNATURE_VALID = 0x00000008 +CERT_TRUST_IS_NOT_VALID_FOR_USAGE = 0x00000010 +CERT_TRUST_IS_UNTRUSTED_ROOT = 0x00000020 +CERT_TRUST_REVOCATION_STATUS_UNKNOWN = 0x00000040 +CERT_TRUST_IS_CYCLIC = 0x00000080 +CERT_TRUST_INVALID_EXTENSION = 0x00000100 +CERT_TRUST_INVALID_POLICY_CONSTRAINTS = 0x00000200 +CERT_TRUST_INVALID_BASIC_CONSTRAINTS = 0x00000400 +CERT_TRUST_INVALID_NAME_CONSTRAINTS = 0x00000800 +CERT_TRUST_HAS_NOT_SUPPORTED_NAME_CONSTRAINT = 0x00001000 +CERT_TRUST_HAS_NOT_DEFINED_NAME_CONSTRAINT = 0x00002000 +CERT_TRUST_HAS_NOT_PERMITTED_NAME_CONSTRAINT = 0x00004000 +CERT_TRUST_HAS_EXCLUDED_NAME_CONSTRAINT = 0x00008000 +CERT_TRUST_IS_OFFLINE_REVOCATION = 0x01000000 +CERT_TRUST_NO_ISSUANCE_CHAIN_POLICY = 0x02000000 +CERT_TRUST_IS_PARTIAL_CHAIN = 0x00010000 +CERT_TRUST_CTL_IS_NOT_TIME_VALID = 0x00020000 +CERT_TRUST_CTL_IS_NOT_SIGNATURE_VALID = 0x00040000 +CERT_TRUST_CTL_IS_NOT_VALID_FOR_USAGE = 0x00080000 +CERT_TRUST_HAS_EXACT_MATCH_ISSUER = 0x00000001 +CERT_TRUST_HAS_KEY_MATCH_ISSUER = 0x00000002 +CERT_TRUST_HAS_NAME_MATCH_ISSUER = 0x00000004 +CERT_TRUST_IS_SELF_SIGNED = 0x00000008 +CERT_TRUST_HAS_PREFERRED_ISSUER = 0x00000100 +CERT_TRUST_HAS_ISSUANCE_CHAIN_POLICY = 0x00000200 +CERT_TRUST_HAS_VALID_NAME_CONSTRAINTS = 0x00000400 +CERT_TRUST_IS_COMPLEX_CHAIN = 0x00010000 +USAGE_MATCH_TYPE_AND = 0x00000000 +USAGE_MATCH_TYPE_OR = 0x00000001 +CERT_CHAIN_REVOCATION_CHECK_END_CERT = 0x10000000 +CERT_CHAIN_REVOCATION_CHECK_CHAIN = 0x20000000 +CERT_CHAIN_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT = 0x40000000 +CERT_CHAIN_REVOCATION_CHECK_CACHE_ONLY = -2147483648 +CERT_CHAIN_REVOCATION_ACCUMULATIVE_TIMEOUT = 0x08000000 +CERT_CHAIN_DISABLE_PASS1_QUALITY_FILTERING = 0x00000040 +CERT_CHAIN_RETURN_LOWER_QUALITY_CONTEXTS = 0x00000080 +CERT_CHAIN_DISABLE_AUTH_ROOT_AUTO_UPDATE = 0x00000100 +CERT_CHAIN_TIMESTAMP_TIME = 0x00000200 +REVOCATION_OID_CRL_REVOCATION = 1 +CERT_CHAIN_FIND_BY_ISSUER = 1 +CERT_CHAIN_FIND_BY_ISSUER_COMPARE_KEY_FLAG = 0x0001 +CERT_CHAIN_FIND_BY_ISSUER_COMPLEX_CHAIN_FLAG = 0x0002 +CERT_CHAIN_FIND_BY_ISSUER_CACHE_ONLY_URL_FLAG = 0x0004 +CERT_CHAIN_FIND_BY_ISSUER_LOCAL_MACHINE_FLAG = 0x0008 +CERT_CHAIN_FIND_BY_ISSUER_NO_KEY_FLAG = 0x4000 +CERT_CHAIN_FIND_BY_ISSUER_CACHE_ONLY_FLAG = 0x8000 +CERT_CHAIN_POLICY_IGNORE_NOT_TIME_VALID_FLAG = 0x00000001 +CERT_CHAIN_POLICY_IGNORE_CTL_NOT_TIME_VALID_FLAG = 0x00000002 +CERT_CHAIN_POLICY_IGNORE_NOT_TIME_NESTED_FLAG = 0x00000004 +CERT_CHAIN_POLICY_IGNORE_INVALID_BASIC_CONSTRAINTS_FLAG = 0x00000008 +CERT_CHAIN_POLICY_IGNORE_ALL_NOT_TIME_VALID_FLAGS = ( + CERT_CHAIN_POLICY_IGNORE_NOT_TIME_VALID_FLAG + | CERT_CHAIN_POLICY_IGNORE_CTL_NOT_TIME_VALID_FLAG + | CERT_CHAIN_POLICY_IGNORE_NOT_TIME_NESTED_FLAG +) +CERT_CHAIN_POLICY_ALLOW_UNKNOWN_CA_FLAG = 0x00000010 +CERT_CHAIN_POLICY_IGNORE_WRONG_USAGE_FLAG = 0x00000020 +CERT_CHAIN_POLICY_IGNORE_INVALID_NAME_FLAG = 0x00000040 +CERT_CHAIN_POLICY_IGNORE_INVALID_POLICY_FLAG = 0x00000080 +CERT_CHAIN_POLICY_IGNORE_END_REV_UNKNOWN_FLAG = 0x00000100 +CERT_CHAIN_POLICY_IGNORE_CTL_SIGNER_REV_UNKNOWN_FLAG = 0x00000200 +CERT_CHAIN_POLICY_IGNORE_CA_REV_UNKNOWN_FLAG = 0x00000400 +CERT_CHAIN_POLICY_IGNORE_ROOT_REV_UNKNOWN_FLAG = 0x00000800 +CERT_CHAIN_POLICY_IGNORE_ALL_REV_UNKNOWN_FLAGS = ( + CERT_CHAIN_POLICY_IGNORE_END_REV_UNKNOWN_FLAG + | CERT_CHAIN_POLICY_IGNORE_CTL_SIGNER_REV_UNKNOWN_FLAG + | CERT_CHAIN_POLICY_IGNORE_CA_REV_UNKNOWN_FLAG + | CERT_CHAIN_POLICY_IGNORE_ROOT_REV_UNKNOWN_FLAG +) +CERT_CHAIN_POLICY_ALLOW_TESTROOT_FLAG = 0x00008000 +CERT_CHAIN_POLICY_TRUST_TESTROOT_FLAG = 0x00004000 +CRYPT_OID_VERIFY_CERTIFICATE_CHAIN_POLICY_FUNC = "CertDllVerifyCertificateChainPolicy" +AUTHTYPE_CLIENT = 1 +AUTHTYPE_SERVER = 2 +BASIC_CONSTRAINTS_CERT_CHAIN_POLICY_CA_FLAG = -2147483648 +BASIC_CONSTRAINTS_CERT_CHAIN_POLICY_END_ENTITY_FLAG = 0x40000000 +MICROSOFT_ROOT_CERT_CHAIN_POLICY_ENABLE_TEST_ROOT_FLAG = 0x00010000 +CRYPT_STRING_BASE64HEADER = 0x00000000 +CRYPT_STRING_BASE64 = 0x00000001 +CRYPT_STRING_BINARY = 0x00000002 +CRYPT_STRING_BASE64REQUESTHEADER = 0x00000003 +CRYPT_STRING_HEX = 0x00000004 +CRYPT_STRING_HEXASCII = 0x00000005 +CRYPT_STRING_BASE64_ANY = 0x00000006 +CRYPT_STRING_ANY = 0x00000007 +CRYPT_STRING_HEX_ANY = 0x00000008 +CRYPT_STRING_BASE64X509CRLHEADER = 0x00000009 +CRYPT_STRING_HEXADDR = 0x0000000A +CRYPT_STRING_HEXASCIIADDR = 0x0000000B +CRYPT_STRING_NOCR = -2147483648 +CRYPT_USER_KEYSET = 0x00001000 +PKCS12_IMPORT_RESERVED_MASK = -65536 +REPORT_NO_PRIVATE_KEY = 0x0001 +REPORT_NOT_ABLE_TO_EXPORT_PRIVATE_KEY = 0x0002 +EXPORT_PRIVATE_KEYS = 0x0004 +PKCS12_EXPORT_RESERVED_MASK = -65536 + +# Certificate store provider types used with CertOpenStore +CERT_STORE_PROV_MSG = 1 +CERT_STORE_PROV_MEMORY = 2 +CERT_STORE_PROV_FILE = 3 +CERT_STORE_PROV_REG = 4 +CERT_STORE_PROV_PKCS7 = 5 +CERT_STORE_PROV_SERIALIZED = 6 +CERT_STORE_PROV_FILENAME = 8 +CERT_STORE_PROV_SYSTEM = 10 +CERT_STORE_PROV_COLLECTION = 11 +CERT_STORE_PROV_SYSTEM_REGISTRY = 13 +CERT_STORE_PROV_PHYSICAL = 14 +CERT_STORE_PROV_SMART_CARD = 15 +CERT_STORE_PROV_LDAP = 16 + +URL_OID_CERTIFICATE_ISSUER = 1 +URL_OID_CERTIFICATE_CRL_DIST_POINT = 2 +URL_OID_CTL_ISSUER = 3 +URL_OID_CTL_NEXT_UPDATE = 4 +URL_OID_CRL_ISSUER = 5 +URL_OID_CERTIFICATE_FRESHEST_CRL = 6 +URL_OID_CRL_FRESHEST_CRL = 7 +URL_OID_CROSS_CERT_DIST_POINT = 8 +URL_OID_CERTIFICATE_OCSP = 9 +URL_OID_CERTIFICATE_OCSP_AND_CRL_DIST_POINT = 10 +URL_OID_CERTIFICATE_CRL_DIST_POINT_AND_OCSP = 11 +URL_OID_CROSS_CERT_SUBJECT_INFO_ACCESS = 12 +URL_OID_CERTIFICATE_ONLY_OCSP = 13 diff --git a/lib/win32/lib/win32evtlogutil.py b/lib/win32/lib/win32evtlogutil.py new file mode 100644 index 00000000..78e231c9 --- /dev/null +++ b/lib/win32/lib/win32evtlogutil.py @@ -0,0 +1,229 @@ +"""Event Log Utilities - helper for win32evtlog.pyd +""" + +import win32api +import win32con +import win32evtlog +import winerror + +error = win32api.error # The error the evtlog module raises. + +langid = win32api.MAKELANGID(win32con.LANG_NEUTRAL, win32con.SUBLANG_NEUTRAL) + + +def AddSourceToRegistry( + appName, + msgDLL=None, + eventLogType="Application", + eventLogFlags=None, + categoryDLL=None, + categoryCount=0, +): + """Add a source of messages to the event log. + + Allows Python program to register a custom source of messages in the + registry. You must also provide the DLL name that has the message table, so the + full message text appears in the event log. + + Note that the win32evtlog.pyd file has a number of string entries with just "%1" + built in, so many Python programs can simply use this DLL. Disadvantages are that + you do not get language translation, and the full text is stored in the event log, + blowing the size of the log up. + """ + + # When an application uses the RegisterEventSource or OpenEventLog + # function to get a handle of an event log, the event logging service + # searches for the specified source name in the registry. You can add a + # new source name to the registry by opening a new registry subkey + # under the Application key and adding registry values to the new + # subkey. + + if msgDLL is None: + msgDLL = win32evtlog.__file__ + # Create a new key for our application + hkey = win32api.RegCreateKey( + win32con.HKEY_LOCAL_MACHINE, + "SYSTEM\\CurrentControlSet\\Services\\EventLog\\%s\\%s" + % (eventLogType, appName), + ) + + # Add the Event-ID message-file name to the subkey. + win32api.RegSetValueEx( + hkey, + "EventMessageFile", # value name \ + 0, # reserved \ + win32con.REG_EXPAND_SZ, # value type \ + msgDLL, + ) + + # Set the supported types flags and add it to the subkey. + if eventLogFlags is None: + eventLogFlags = ( + win32evtlog.EVENTLOG_ERROR_TYPE + | win32evtlog.EVENTLOG_WARNING_TYPE + | win32evtlog.EVENTLOG_INFORMATION_TYPE + ) + win32api.RegSetValueEx( + hkey, # subkey handle \ + "TypesSupported", # value name \ + 0, # reserved \ + win32con.REG_DWORD, # value type \ + eventLogFlags, + ) + + if categoryCount > 0: + # Optionally, you can specify a message file that contains the categories + if categoryDLL is None: + categoryDLL = win32evtlog.__file__ + win32api.RegSetValueEx( + hkey, # subkey handle \ + "CategoryMessageFile", # value name \ + 0, # reserved \ + win32con.REG_EXPAND_SZ, # value type \ + categoryDLL, + ) + + win32api.RegSetValueEx( + hkey, # subkey handle \ + "CategoryCount", # value name \ + 0, # reserved \ + win32con.REG_DWORD, # value type \ + categoryCount, + ) + win32api.RegCloseKey(hkey) + + +def RemoveSourceFromRegistry(appName, eventLogType="Application"): + """Removes a source of messages from the event log.""" + + # Delete our key + try: + win32api.RegDeleteKey( + win32con.HKEY_LOCAL_MACHINE, + "SYSTEM\\CurrentControlSet\\Services\\EventLog\\%s\\%s" + % (eventLogType, appName), + ) + except win32api.error as exc: + if exc.winerror != winerror.ERROR_FILE_NOT_FOUND: + raise + + +def ReportEvent( + appName, + eventID, + eventCategory=0, + eventType=win32evtlog.EVENTLOG_ERROR_TYPE, + strings=None, + data=None, + sid=None, +): + """Report an event for a previously added event source.""" + # Get a handle to the Application event log + hAppLog = win32evtlog.RegisterEventSource(None, appName) + + # Now report the event, which will add this event to the event log */ + win32evtlog.ReportEvent( + hAppLog, # event-log handle \ + eventType, + eventCategory, + eventID, + sid, + strings, + data, + ) + + win32evtlog.DeregisterEventSource(hAppLog) + + +def FormatMessage(eventLogRecord, logType="Application"): + """Given a tuple from ReadEventLog, and optionally where the event + record came from, load the message, and process message inserts. + + Note that this function may raise win32api.error. See also the + function SafeFormatMessage which will return None if the message can + not be processed. + """ + + # From the event log source name, we know the name of the registry + # key to look under for the name of the message DLL that contains + # the messages we need to extract with FormatMessage. So first get + # the event log source name... + keyName = "SYSTEM\\CurrentControlSet\\Services\\EventLog\\%s\\%s" % ( + logType, + eventLogRecord.SourceName, + ) + + # Now open this key and get the EventMessageFile value, which is + # the name of the message DLL. + handle = win32api.RegOpenKey(win32con.HKEY_LOCAL_MACHINE, keyName) + try: + dllNames = win32api.RegQueryValueEx(handle, "EventMessageFile")[0].split(";") + # Win2k etc appear to allow multiple DLL names + data = None + for dllName in dllNames: + try: + # Expand environment variable strings in the message DLL path name, + # in case any are there. + dllName = win32api.ExpandEnvironmentStrings(dllName) + + dllHandle = win32api.LoadLibraryEx( + dllName, 0, win32con.LOAD_LIBRARY_AS_DATAFILE + ) + try: + data = win32api.FormatMessageW( + win32con.FORMAT_MESSAGE_FROM_HMODULE, + dllHandle, + eventLogRecord.EventID, + langid, + eventLogRecord.StringInserts, + ) + finally: + win32api.FreeLibrary(dllHandle) + except win32api.error: + pass # Not in this DLL - try the next + if data is not None: + break + finally: + win32api.RegCloseKey(handle) + return data or "" # Don't want "None" ever being returned. + + +def SafeFormatMessage(eventLogRecord, logType=None): + """As for FormatMessage, except returns an error message if + the message can not be processed. + """ + if logType is None: + logType = "Application" + try: + return FormatMessage(eventLogRecord, logType) + except win32api.error: + if eventLogRecord.StringInserts is None: + desc = "" + else: + desc = ", ".join(eventLogRecord.StringInserts) + return ( + "" + % ( + winerror.HRESULT_CODE(eventLogRecord.EventID), + eventLogRecord.SourceName, + desc, + ) + ) + + +def FeedEventLogRecords( + feeder, machineName=None, logName="Application", readFlags=None +): + if readFlags is None: + readFlags = ( + win32evtlog.EVENTLOG_BACKWARDS_READ | win32evtlog.EVENTLOG_SEQUENTIAL_READ + ) + h = win32evtlog.OpenEventLog(machineName, logName) + try: + while 1: + objects = win32evtlog.ReadEventLog(h, readFlags, 0) + if not objects: + break + map(lambda item, feeder=feeder: feeder(*(item,)), objects) + finally: + win32evtlog.CloseEventLog(h) diff --git a/lib/win32/lib/win32gui_struct.py b/lib/win32/lib/win32gui_struct.py new file mode 100644 index 00000000..86623ae3 --- /dev/null +++ b/lib/win32/lib/win32gui_struct.py @@ -0,0 +1,999 @@ +# This is a work in progress - see Demos/win32gui_menu.py + +# win32gui_struct.py - helpers for working with various win32gui structures. +# As win32gui is "light-weight", it does not define objects for all possible +# win32 structures - in general, "buffer" objects are passed around - it is +# the callers responsibility to pack the buffer in the correct format. +# +# This module defines some helpers for the commonly used structures. +# +# In general, each structure has 3 functions: +# +# buffer, extras = PackSTRUCTURE(items, ...) +# item, ... = UnpackSTRUCTURE(buffer) +# buffer, extras = EmtpySTRUCTURE(...) +# +# 'extras' is always items that must be held along with the buffer, as the +# buffer refers to these object's memory. +# For structures that support a 'mask', this mask is hidden from the user - if +# 'None' is passed, the mask flag will not be set, or on return, None will +# be returned for the value if the mask is not set. +# +# NOTE: I considered making these structures look like real classes, and +# support 'attributes' etc - however, ctypes already has a good structure +# mechanism - I think it makes more sense to support ctype structures +# at the win32gui level, then there will be no need for this module at all. +# XXX - the above makes sense in terms of what is built and passed to +# win32gui (ie, the Pack* functions) - but doesn't make as much sense for +# the Unpack* functions, where the aim is user convenience. + +import array +import struct +import sys + +import commctrl +import pywintypes +import win32con +import win32gui + +is64bit = "64 bit" in sys.version + +try: + from collections import namedtuple + + def _MakeResult(names_str, values): + names = names_str.split() + nt = namedtuple(names[0], names[1:]) + return nt(*values) + +except ImportError: + # no namedtuple support - just return the values as a normal tuple. + def _MakeResult(names_str, values): + return values + + +_nmhdr_fmt = "PPi" +if is64bit: + # When the item past the NMHDR gets aligned (eg, when it is a struct) + # we need this many bytes padding. + _nmhdr_align_padding = "xxxx" +else: + _nmhdr_align_padding = "" + +# Encode a string suitable for passing in a win32gui related structure +# If win32gui is built with UNICODE defined (ie, py3k), then functions +# like InsertMenuItem are actually calling InsertMenuItemW etc, so all +# strings will need to be unicode. +if win32gui.UNICODE: + + def _make_text_buffer(text): + # XXX - at this stage win32gui.UNICODE is only True in py3k, + # and in py3k is makes sense to reject bytes. + if not isinstance(text, str): + raise TypeError("MENUITEMINFO text must be unicode") + data = (text + "\0").encode("utf-16le") + return array.array("b", data) + +else: + + def _make_text_buffer(text): + if isinstance(text, str): + text = text.encode("mbcs") + return array.array("b", text + "\0") + + +# make an 'empty' buffer, ready for filling with cch characters. +def _make_empty_text_buffer(cch): + return _make_text_buffer("\0" * cch) + + +if sys.version_info < (3, 0): + + def _make_memory(ob): + return str(buffer(ob)) + + def _make_bytes(sval): + return sval + +else: + + def _make_memory(ob): + return bytes(memoryview(ob)) + + def _make_bytes(sval): + return sval.encode("ascii") + + +# Generic WM_NOTIFY unpacking +def UnpackWMNOTIFY(lparam): + format = "PPi" + buf = win32gui.PyGetMemory(lparam, struct.calcsize(format)) + return _MakeResult("WMNOTIFY hwndFrom idFrom code", struct.unpack(format, buf)) + + +def UnpackNMITEMACTIVATE(lparam): + format = _nmhdr_fmt + _nmhdr_align_padding + if is64bit: + # the struct module doesn't handle this correctly as some of the items + # are actually structs in structs, which get individually aligned. + format = format + "iiiiiiixxxxP" + else: + format = format + "iiiiiiiP" + buf = win32gui.PyMakeBuffer(struct.calcsize(format), lparam) + return _MakeResult( + "NMITEMACTIVATE hwndFrom idFrom code iItem iSubItem uNewState uOldState uChanged actionx actiony lParam", + struct.unpack(format, buf), + ) + + +# MENUITEMINFO struct +# http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winui/WinUI/WindowsUserInterface/Resources/Menus/MenuReference/MenuStructures/MENUITEMINFO.asp +# We use the struct module to pack and unpack strings as MENUITEMINFO +# structures. We also have special handling for the 'fMask' item in that +# structure to avoid the caller needing to explicitly check validity +# (None is used if the mask excludes/should exclude the value) +_menuiteminfo_fmt = "5i5PiP" + + +def PackMENUITEMINFO( + fType=None, + fState=None, + wID=None, + hSubMenu=None, + hbmpChecked=None, + hbmpUnchecked=None, + dwItemData=None, + text=None, + hbmpItem=None, + dwTypeData=None, +): + # 'extras' are objects the caller must keep a reference to (as their + # memory is used) for the lifetime of the INFO item. + extras = [] + # ack - dwItemData and dwTypeData were confused for a while... + assert ( + dwItemData is None or dwTypeData is None + ), "sorry - these were confused - you probably want dwItemData" + # if we are a long way past 209, then we can nuke the above... + if dwTypeData is not None: + import warnings + + warnings.warn("PackMENUITEMINFO: please use dwItemData instead of dwTypeData") + if dwItemData is None: + dwItemData = dwTypeData or 0 + + fMask = 0 + if fType is None: + fType = 0 + else: + fMask |= win32con.MIIM_FTYPE + if fState is None: + fState = 0 + else: + fMask |= win32con.MIIM_STATE + if wID is None: + wID = 0 + else: + fMask |= win32con.MIIM_ID + if hSubMenu is None: + hSubMenu = 0 + else: + fMask |= win32con.MIIM_SUBMENU + if hbmpChecked is None: + assert hbmpUnchecked is None, "neither or both checkmark bmps must be given" + hbmpChecked = hbmpUnchecked = 0 + else: + assert hbmpUnchecked is not None, "neither or both checkmark bmps must be given" + fMask |= win32con.MIIM_CHECKMARKS + if dwItemData is None: + dwItemData = 0 + else: + fMask |= win32con.MIIM_DATA + if hbmpItem is None: + hbmpItem = 0 + else: + fMask |= win32con.MIIM_BITMAP + if text is not None: + fMask |= win32con.MIIM_STRING + str_buf = _make_text_buffer(text) + cch = len(text) + # We are taking address of strbuf - it must not die until windows + # has finished with our structure. + lptext = str_buf.buffer_info()[0] + extras.append(str_buf) + else: + lptext = 0 + cch = 0 + # Create the struct. + # 'P' format does not accept PyHANDLE's ! + item = struct.pack( + _menuiteminfo_fmt, + struct.calcsize(_menuiteminfo_fmt), # cbSize + fMask, + fType, + fState, + wID, + int(hSubMenu), + int(hbmpChecked), + int(hbmpUnchecked), + dwItemData, + lptext, + cch, + int(hbmpItem), + ) + # Now copy the string to a writable buffer, so that the result + # could be passed to a 'Get' function + return array.array("b", item), extras + + +def UnpackMENUITEMINFO(s): + ( + cb, + fMask, + fType, + fState, + wID, + hSubMenu, + hbmpChecked, + hbmpUnchecked, + dwItemData, + lptext, + cch, + hbmpItem, + ) = struct.unpack(_menuiteminfo_fmt, s) + assert cb == len(s) + if fMask & win32con.MIIM_FTYPE == 0: + fType = None + if fMask & win32con.MIIM_STATE == 0: + fState = None + if fMask & win32con.MIIM_ID == 0: + wID = None + if fMask & win32con.MIIM_SUBMENU == 0: + hSubMenu = None + if fMask & win32con.MIIM_CHECKMARKS == 0: + hbmpChecked = hbmpUnchecked = None + if fMask & win32con.MIIM_DATA == 0: + dwItemData = None + if fMask & win32con.MIIM_BITMAP == 0: + hbmpItem = None + if fMask & win32con.MIIM_STRING: + text = win32gui.PyGetString(lptext, cch) + else: + text = None + return _MakeResult( + "MENUITEMINFO fType fState wID hSubMenu hbmpChecked " + "hbmpUnchecked dwItemData text hbmpItem", + ( + fType, + fState, + wID, + hSubMenu, + hbmpChecked, + hbmpUnchecked, + dwItemData, + text, + hbmpItem, + ), + ) + + +def EmptyMENUITEMINFO(mask=None, text_buf_size=512): + # text_buf_size is number of *characters* - not necessarily no of bytes. + extra = [] + if mask is None: + mask = ( + win32con.MIIM_BITMAP + | win32con.MIIM_CHECKMARKS + | win32con.MIIM_DATA + | win32con.MIIM_FTYPE + | win32con.MIIM_ID + | win32con.MIIM_STATE + | win32con.MIIM_STRING + | win32con.MIIM_SUBMENU + ) + # Note: No MIIM_TYPE - this screws win2k/98. + + if mask & win32con.MIIM_STRING: + text_buffer = _make_empty_text_buffer(text_buf_size) + extra.append(text_buffer) + text_addr, _ = text_buffer.buffer_info() + else: + text_addr = text_buf_size = 0 + + # Now copy the string to a writable buffer, so that the result + # could be passed to a 'Get' function + buf = struct.pack( + _menuiteminfo_fmt, + struct.calcsize(_menuiteminfo_fmt), # cbSize + mask, + 0, # fType, + 0, # fState, + 0, # wID, + 0, # hSubMenu, + 0, # hbmpChecked, + 0, # hbmpUnchecked, + 0, # dwItemData, + text_addr, + text_buf_size, + 0, # hbmpItem + ) + return array.array("b", buf), extra + + +# MENUINFO struct +_menuinfo_fmt = "iiiiPiP" + + +def PackMENUINFO( + dwStyle=None, + cyMax=None, + hbrBack=None, + dwContextHelpID=None, + dwMenuData=None, + fMask=0, +): + if dwStyle is None: + dwStyle = 0 + else: + fMask |= win32con.MIM_STYLE + if cyMax is None: + cyMax = 0 + else: + fMask |= win32con.MIM_MAXHEIGHT + if hbrBack is None: + hbrBack = 0 + else: + fMask |= win32con.MIM_BACKGROUND + if dwContextHelpID is None: + dwContextHelpID = 0 + else: + fMask |= win32con.MIM_HELPID + if dwMenuData is None: + dwMenuData = 0 + else: + fMask |= win32con.MIM_MENUDATA + # Create the struct. + item = struct.pack( + _menuinfo_fmt, + struct.calcsize(_menuinfo_fmt), # cbSize + fMask, + dwStyle, + cyMax, + hbrBack, + dwContextHelpID, + dwMenuData, + ) + return array.array("b", item) + + +def UnpackMENUINFO(s): + (cb, fMask, dwStyle, cyMax, hbrBack, dwContextHelpID, dwMenuData) = struct.unpack( + _menuinfo_fmt, s + ) + assert cb == len(s) + if fMask & win32con.MIM_STYLE == 0: + dwStyle = None + if fMask & win32con.MIM_MAXHEIGHT == 0: + cyMax = None + if fMask & win32con.MIM_BACKGROUND == 0: + hbrBack = None + if fMask & win32con.MIM_HELPID == 0: + dwContextHelpID = None + if fMask & win32con.MIM_MENUDATA == 0: + dwMenuData = None + return _MakeResult( + "MENUINFO dwStyle cyMax hbrBack dwContextHelpID dwMenuData", + (dwStyle, cyMax, hbrBack, dwContextHelpID, dwMenuData), + ) + + +def EmptyMENUINFO(mask=None): + if mask is None: + mask = ( + win32con.MIM_STYLE + | win32con.MIM_MAXHEIGHT + | win32con.MIM_BACKGROUND + | win32con.MIM_HELPID + | win32con.MIM_MENUDATA + ) + + buf = struct.pack( + _menuinfo_fmt, + struct.calcsize(_menuinfo_fmt), # cbSize + mask, + 0, # dwStyle + 0, # cyMax + 0, # hbrBack, + 0, # dwContextHelpID, + 0, # dwMenuData, + ) + return array.array("b", buf) + + +########################################################################## +# +# Tree View structure support - TVITEM, TVINSERTSTRUCT and TVDISPINFO +# +########################################################################## + +# XXX - Note that the following implementation of TreeView structures is ripped +# XXX - from the SpamBayes project. It may not quite work correctly yet - I +# XXX - intend checking them later - but having them is better than not at all! + +_tvitem_fmt = "iPiiPiiiiP" + + +# Helpers for the ugly win32 structure packing/unpacking +# XXX - Note that functions using _GetMaskAndVal run 3x faster if they are +# 'inlined' into the function - see PackLVITEM. If the profiler points at +# _GetMaskAndVal(), you should nuke it (patches welcome once they have been +# tested) +def _GetMaskAndVal(val, default, mask, flag): + if val is None: + return mask, default + else: + if flag is not None: + mask |= flag + return mask, val + + +def PackTVINSERTSTRUCT(parent, insertAfter, tvitem): + tvitem_buf, extra = PackTVITEM(*tvitem) + tvitem_buf = tvitem_buf.tobytes() + format = "PP%ds" % len(tvitem_buf) + return struct.pack(format, parent, insertAfter, tvitem_buf), extra + + +def PackTVITEM(hitem, state, stateMask, text, image, selimage, citems, param): + extra = [] # objects we must keep references to + mask = 0 + mask, hitem = _GetMaskAndVal(hitem, 0, mask, commctrl.TVIF_HANDLE) + mask, state = _GetMaskAndVal(state, 0, mask, commctrl.TVIF_STATE) + if not mask & commctrl.TVIF_STATE: + stateMask = 0 + mask, text = _GetMaskAndVal(text, None, mask, commctrl.TVIF_TEXT) + mask, image = _GetMaskAndVal(image, 0, mask, commctrl.TVIF_IMAGE) + mask, selimage = _GetMaskAndVal(selimage, 0, mask, commctrl.TVIF_SELECTEDIMAGE) + mask, citems = _GetMaskAndVal(citems, 0, mask, commctrl.TVIF_CHILDREN) + mask, param = _GetMaskAndVal(param, 0, mask, commctrl.TVIF_PARAM) + if text is None: + text_addr = text_len = 0 + else: + text_buffer = _make_text_buffer(text) + text_len = len(text) + extra.append(text_buffer) + text_addr, _ = text_buffer.buffer_info() + buf = struct.pack( + _tvitem_fmt, + mask, + hitem, + state, + stateMask, + text_addr, + text_len, # text + image, + selimage, + citems, + param, + ) + return array.array("b", buf), extra + + +# Make a new buffer suitable for querying hitem's attributes. +def EmptyTVITEM(hitem, mask=None, text_buf_size=512): + extra = [] # objects we must keep references to + if mask is None: + mask = ( + commctrl.TVIF_HANDLE + | commctrl.TVIF_STATE + | commctrl.TVIF_TEXT + | commctrl.TVIF_IMAGE + | commctrl.TVIF_SELECTEDIMAGE + | commctrl.TVIF_CHILDREN + | commctrl.TVIF_PARAM + ) + if mask & commctrl.TVIF_TEXT: + text_buffer = _make_empty_text_buffer(text_buf_size) + extra.append(text_buffer) + text_addr, _ = text_buffer.buffer_info() + else: + text_addr = text_buf_size = 0 + buf = struct.pack( + _tvitem_fmt, mask, hitem, 0, 0, text_addr, text_buf_size, 0, 0, 0, 0 # text + ) + return array.array("b", buf), extra + + +def UnpackTVITEM(buffer): + ( + item_mask, + item_hItem, + item_state, + item_stateMask, + item_textptr, + item_cchText, + item_image, + item_selimage, + item_cChildren, + item_param, + ) = struct.unpack(_tvitem_fmt, buffer) + # ensure only items listed by the mask are valid (except we assume the + # handle is always valid - some notifications (eg, TVN_ENDLABELEDIT) set a + # mask that doesn't include the handle, but the docs explicity say it is.) + if not (item_mask & commctrl.TVIF_TEXT): + item_textptr = item_cchText = None + if not (item_mask & commctrl.TVIF_CHILDREN): + item_cChildren = None + if not (item_mask & commctrl.TVIF_IMAGE): + item_image = None + if not (item_mask & commctrl.TVIF_PARAM): + item_param = None + if not (item_mask & commctrl.TVIF_SELECTEDIMAGE): + item_selimage = None + if not (item_mask & commctrl.TVIF_STATE): + item_state = item_stateMask = None + + if item_textptr: + text = win32gui.PyGetString(item_textptr) + else: + text = None + return _MakeResult( + "TVITEM item_hItem item_state item_stateMask " + "text item_image item_selimage item_cChildren item_param", + ( + item_hItem, + item_state, + item_stateMask, + text, + item_image, + item_selimage, + item_cChildren, + item_param, + ), + ) + + +# Unpack the lparm from a "TVNOTIFY" message +def UnpackTVNOTIFY(lparam): + item_size = struct.calcsize(_tvitem_fmt) + format = _nmhdr_fmt + _nmhdr_align_padding + if is64bit: + format = format + "ixxxx" + else: + format = format + "i" + format = format + "%ds%ds" % (item_size, item_size) + buf = win32gui.PyGetMemory(lparam, struct.calcsize(format)) + hwndFrom, id, code, action, buf_old, buf_new = struct.unpack(format, buf) + item_old = UnpackTVITEM(buf_old) + item_new = UnpackTVITEM(buf_new) + return _MakeResult( + "TVNOTIFY hwndFrom id code action item_old item_new", + (hwndFrom, id, code, action, item_old, item_new), + ) + + +def UnpackTVDISPINFO(lparam): + item_size = struct.calcsize(_tvitem_fmt) + format = "PPi%ds" % (item_size,) + buf = win32gui.PyGetMemory(lparam, struct.calcsize(format)) + hwndFrom, id, code, buf_item = struct.unpack(format, buf) + item = UnpackTVITEM(buf_item) + return _MakeResult("TVDISPINFO hwndFrom id code item", (hwndFrom, id, code, item)) + + +# +# List view items +_lvitem_fmt = "iiiiiPiiPi" + + +def PackLVITEM( + item=None, + subItem=None, + state=None, + stateMask=None, + text=None, + image=None, + param=None, + indent=None, +): + extra = [] # objects we must keep references to + mask = 0 + # _GetMaskAndVal adds quite a bit of overhead to this function. + if item is None: + item = 0 # No mask for item + if subItem is None: + subItem = 0 # No mask for sibItem + if state is None: + state = 0 + stateMask = 0 + else: + mask |= commctrl.LVIF_STATE + if stateMask is None: + stateMask = state + + if image is None: + image = 0 + else: + mask |= commctrl.LVIF_IMAGE + if param is None: + param = 0 + else: + mask |= commctrl.LVIF_PARAM + if indent is None: + indent = 0 + else: + mask |= commctrl.LVIF_INDENT + + if text is None: + text_addr = text_len = 0 + else: + mask |= commctrl.LVIF_TEXT + text_buffer = _make_text_buffer(text) + text_len = len(text) + extra.append(text_buffer) + text_addr, _ = text_buffer.buffer_info() + buf = struct.pack( + _lvitem_fmt, + mask, + item, + subItem, + state, + stateMask, + text_addr, + text_len, # text + image, + param, + indent, + ) + return array.array("b", buf), extra + + +def UnpackLVITEM(buffer): + ( + item_mask, + item_item, + item_subItem, + item_state, + item_stateMask, + item_textptr, + item_cchText, + item_image, + item_param, + item_indent, + ) = struct.unpack(_lvitem_fmt, buffer) + # ensure only items listed by the mask are valid + if not (item_mask & commctrl.LVIF_TEXT): + item_textptr = item_cchText = None + if not (item_mask & commctrl.LVIF_IMAGE): + item_image = None + if not (item_mask & commctrl.LVIF_PARAM): + item_param = None + if not (item_mask & commctrl.LVIF_INDENT): + item_indent = None + if not (item_mask & commctrl.LVIF_STATE): + item_state = item_stateMask = None + + if item_textptr: + text = win32gui.PyGetString(item_textptr) + else: + text = None + return _MakeResult( + "LVITEM item_item item_subItem item_state " + "item_stateMask text item_image item_param item_indent", + ( + item_item, + item_subItem, + item_state, + item_stateMask, + text, + item_image, + item_param, + item_indent, + ), + ) + + +# Unpack an "LVNOTIFY" message +def UnpackLVDISPINFO(lparam): + item_size = struct.calcsize(_lvitem_fmt) + format = _nmhdr_fmt + _nmhdr_align_padding + ("%ds" % (item_size,)) + buf = win32gui.PyGetMemory(lparam, struct.calcsize(format)) + hwndFrom, id, code, buf_item = struct.unpack(format, buf) + item = UnpackLVITEM(buf_item) + return _MakeResult("LVDISPINFO hwndFrom id code item", (hwndFrom, id, code, item)) + + +def UnpackLVNOTIFY(lparam): + format = _nmhdr_fmt + _nmhdr_align_padding + "7i" + if is64bit: + format = format + "xxxx" # point needs padding. + format = format + "P" + buf = win32gui.PyGetMemory(lparam, struct.calcsize(format)) + ( + hwndFrom, + id, + code, + item, + subitem, + newstate, + oldstate, + changed, + pt_x, + pt_y, + lparam, + ) = struct.unpack(format, buf) + return _MakeResult( + "UnpackLVNOTIFY hwndFrom id code item subitem " + "newstate oldstate changed pt lparam", + ( + hwndFrom, + id, + code, + item, + subitem, + newstate, + oldstate, + changed, + (pt_x, pt_y), + lparam, + ), + ) + + +# Make a new buffer suitable for querying an items attributes. +def EmptyLVITEM(item, subitem, mask=None, text_buf_size=512): + extra = [] # objects we must keep references to + if mask is None: + mask = ( + commctrl.LVIF_IMAGE + | commctrl.LVIF_INDENT + | commctrl.LVIF_TEXT + | commctrl.LVIF_PARAM + | commctrl.LVIF_STATE + ) + if mask & commctrl.LVIF_TEXT: + text_buffer = _make_empty_text_buffer(text_buf_size) + extra.append(text_buffer) + text_addr, _ = text_buffer.buffer_info() + else: + text_addr = text_buf_size = 0 + buf = struct.pack( + _lvitem_fmt, + mask, + item, + subitem, + 0, + 0, + text_addr, + text_buf_size, # text + 0, + 0, + 0, + ) + return array.array("b", buf), extra + + +# List view column structure +_lvcolumn_fmt = "iiiPiiii" + + +def PackLVCOLUMN(fmt=None, cx=None, text=None, subItem=None, image=None, order=None): + extra = [] # objects we must keep references to + mask = 0 + mask, fmt = _GetMaskAndVal(fmt, 0, mask, commctrl.LVCF_FMT) + mask, cx = _GetMaskAndVal(cx, 0, mask, commctrl.LVCF_WIDTH) + mask, text = _GetMaskAndVal(text, None, mask, commctrl.LVCF_TEXT) + mask, subItem = _GetMaskAndVal(subItem, 0, mask, commctrl.LVCF_SUBITEM) + mask, image = _GetMaskAndVal(image, 0, mask, commctrl.LVCF_IMAGE) + mask, order = _GetMaskAndVal(order, 0, mask, commctrl.LVCF_ORDER) + if text is None: + text_addr = text_len = 0 + else: + text_buffer = _make_text_buffer(text) + extra.append(text_buffer) + text_addr, _ = text_buffer.buffer_info() + text_len = len(text) + buf = struct.pack( + _lvcolumn_fmt, mask, fmt, cx, text_addr, text_len, subItem, image, order # text + ) + return array.array("b", buf), extra + + +def UnpackLVCOLUMN(lparam): + mask, fmt, cx, text_addr, text_size, subItem, image, order = struct.unpack( + _lvcolumn_fmt, lparam + ) + # ensure only items listed by the mask are valid + if not (mask & commctrl.LVCF_FMT): + fmt = None + if not (mask & commctrl.LVCF_WIDTH): + cx = None + if not (mask & commctrl.LVCF_TEXT): + text_addr = text_size = None + if not (mask & commctrl.LVCF_SUBITEM): + subItem = None + if not (mask & commctrl.LVCF_IMAGE): + image = None + if not (mask & commctrl.LVCF_ORDER): + order = None + if text_addr: + text = win32gui.PyGetString(text_addr) + else: + text = None + return _MakeResult( + "LVCOLUMN fmt cx text subItem image order", + (fmt, cx, text, subItem, image, order), + ) + + +# Make a new buffer suitable for querying an items attributes. +def EmptyLVCOLUMN(mask=None, text_buf_size=512): + extra = [] # objects we must keep references to + if mask is None: + mask = ( + commctrl.LVCF_FMT + | commctrl.LVCF_WIDTH + | commctrl.LVCF_TEXT + | commctrl.LVCF_SUBITEM + | commctrl.LVCF_IMAGE + | commctrl.LVCF_ORDER + ) + if mask & commctrl.LVCF_TEXT: + text_buffer = _make_empty_text_buffer(text_buf_size) + extra.append(text_buffer) + text_addr, _ = text_buffer.buffer_info() + else: + text_addr = text_buf_size = 0 + buf = struct.pack( + _lvcolumn_fmt, mask, 0, 0, text_addr, text_buf_size, 0, 0, 0 # text + ) + return array.array("b", buf), extra + + +# List view hit-test. +def PackLVHITTEST(pt): + format = "iiiii" + buf = struct.pack(format, pt[0], pt[1], 0, 0, 0) + return array.array("b", buf), None + + +def UnpackLVHITTEST(buf): + format = "iiiii" + x, y, flags, item, subitem = struct.unpack(format, buf) + return _MakeResult( + "LVHITTEST pt flags item subitem", ((x, y), flags, item, subitem) + ) + + +def PackHDITEM( + cxy=None, text=None, hbm=None, fmt=None, param=None, image=None, order=None +): + extra = [] # objects we must keep references to + mask = 0 + mask, cxy = _GetMaskAndVal(cxy, 0, mask, commctrl.HDI_HEIGHT) + mask, text = _GetMaskAndVal(text, None, mask, commctrl.LVCF_TEXT) + mask, hbm = _GetMaskAndVal(hbm, 0, mask, commctrl.HDI_BITMAP) + mask, fmt = _GetMaskAndVal(fmt, 0, mask, commctrl.HDI_FORMAT) + mask, param = _GetMaskAndVal(param, 0, mask, commctrl.HDI_LPARAM) + mask, image = _GetMaskAndVal(image, 0, mask, commctrl.HDI_IMAGE) + mask, order = _GetMaskAndVal(order, 0, mask, commctrl.HDI_ORDER) + + if text is None: + text_addr = text_len = 0 + else: + text_buffer = _make_text_buffer(text) + extra.append(text_buffer) + text_addr, _ = text_buffer.buffer_info() + text_len = len(text) + + format = "iiPPiiPiiii" + buf = struct.pack( + format, mask, cxy, text_addr, hbm, text_len, fmt, param, image, order, 0, 0 + ) + return array.array("b", buf), extra + + +# Device notification stuff + + +# Generic function for packing a DEV_BROADCAST_* structure - generally used +# by the other PackDEV_BROADCAST_* functions in this module. +def PackDEV_BROADCAST(devicetype, rest_fmt, rest_data, extra_data=_make_bytes("")): + # It seems a requirement is 4 byte alignment, even for the 'BYTE data[1]' + # field (eg, that would make DEV_BROADCAST_HANDLE 41 bytes, but we must + # be 44. + extra_data += _make_bytes("\0" * (4 - len(extra_data) % 4)) + format = "iii" + rest_fmt + full_size = struct.calcsize(format) + len(extra_data) + data = (full_size, devicetype, 0) + rest_data + return struct.pack(format, *data) + extra_data + + +def PackDEV_BROADCAST_HANDLE( + handle, + hdevnotify=0, + guid=_make_bytes("\0" * 16), + name_offset=0, + data=_make_bytes("\0"), +): + return PackDEV_BROADCAST( + win32con.DBT_DEVTYP_HANDLE, + "PP16sl", + (int(handle), int(hdevnotify), _make_memory(guid), name_offset), + data, + ) + + +def PackDEV_BROADCAST_VOLUME(unitmask, flags): + return PackDEV_BROADCAST(win32con.DBT_DEVTYP_VOLUME, "II", (unitmask, flags)) + + +def PackDEV_BROADCAST_DEVICEINTERFACE(classguid, name=""): + if win32gui.UNICODE: + # This really means "is py3k?" - so not accepting bytes is OK + if not isinstance(name, str): + raise TypeError("Must provide unicode for the name") + name = name.encode("utf-16le") + else: + # py2k was passed a unicode object - encode as mbcs. + if isinstance(name, str): + name = name.encode("mbcs") + + # 16 bytes for the IID followed by \0 term'd string. + rest_fmt = "16s%ds" % len(name) + # _make_memory(iid) hoops necessary to get the raw IID bytes. + rest_data = (_make_memory(pywintypes.IID(classguid)), name) + return PackDEV_BROADCAST(win32con.DBT_DEVTYP_DEVICEINTERFACE, rest_fmt, rest_data) + + +# An object returned by UnpackDEV_BROADCAST. +class DEV_BROADCAST_INFO: + def __init__(self, devicetype, **kw): + self.devicetype = devicetype + self.__dict__.update(kw) + + def __str__(self): + return "DEV_BROADCAST_INFO:" + str(self.__dict__) + + +# Support for unpacking the 'lparam' +def UnpackDEV_BROADCAST(lparam): + if lparam == 0: + return None + hdr_format = "iii" + hdr_size = struct.calcsize(hdr_format) + hdr_buf = win32gui.PyGetMemory(lparam, hdr_size) + size, devtype, reserved = struct.unpack("iii", hdr_buf) + # Due to x64 alignment issues, we need to use the full format string over + # the entire buffer. ie, on x64: + # calcsize('iiiP') != calcsize('iii')+calcsize('P') + buf = win32gui.PyGetMemory(lparam, size) + + extra = x = {} + if devtype == win32con.DBT_DEVTYP_HANDLE: + # 2 handles, a GUID, a LONG and possibly an array following... + fmt = hdr_format + "PP16sl" + ( + _, + _, + _, + x["handle"], + x["hdevnotify"], + guid_bytes, + x["nameoffset"], + ) = struct.unpack(fmt, buf[: struct.calcsize(fmt)]) + x["eventguid"] = pywintypes.IID(guid_bytes, True) + elif devtype == win32con.DBT_DEVTYP_DEVICEINTERFACE: + fmt = hdr_format + "16s" + _, _, _, guid_bytes = struct.unpack(fmt, buf[: struct.calcsize(fmt)]) + x["classguid"] = pywintypes.IID(guid_bytes, True) + x["name"] = win32gui.PyGetString(lparam + struct.calcsize(fmt)) + elif devtype == win32con.DBT_DEVTYP_VOLUME: + # int mask and flags + fmt = hdr_format + "II" + _, _, _, x["unitmask"], x["flags"] = struct.unpack( + fmt, buf[: struct.calcsize(fmt)] + ) + else: + raise NotImplementedError("unknown device type %d" % (devtype,)) + return DEV_BROADCAST_INFO(devtype, **extra) diff --git a/lib/win32/lib/win32inetcon.py b/lib/win32/lib/win32inetcon.py new file mode 100644 index 00000000..b6e8e672 --- /dev/null +++ b/lib/win32/lib/win32inetcon.py @@ -0,0 +1,1086 @@ +# Generated by h2py from \mssdk\include\WinInet.h + +INTERNET_INVALID_PORT_NUMBER = 0 +INTERNET_DEFAULT_PORT = 0 +INTERNET_DEFAULT_FTP_PORT = 21 +INTERNET_DEFAULT_GOPHER_PORT = 70 +INTERNET_DEFAULT_HTTP_PORT = 80 +INTERNET_DEFAULT_HTTPS_PORT = 443 +INTERNET_DEFAULT_SOCKS_PORT = 1080 +INTERNET_MAX_HOST_NAME_LENGTH = 256 +INTERNET_MAX_USER_NAME_LENGTH = 128 +INTERNET_MAX_PASSWORD_LENGTH = 128 +INTERNET_MAX_PORT_NUMBER_LENGTH = 5 +INTERNET_MAX_PORT_NUMBER_VALUE = 65535 +INTERNET_MAX_PATH_LENGTH = 2048 +INTERNET_MAX_SCHEME_LENGTH = 32 +INTERNET_KEEP_ALIVE_ENABLED = 1 +INTERNET_KEEP_ALIVE_DISABLED = 0 +INTERNET_REQFLAG_FROM_CACHE = 0x00000001 +INTERNET_REQFLAG_ASYNC = 0x00000002 +INTERNET_REQFLAG_VIA_PROXY = 0x00000004 +INTERNET_REQFLAG_NO_HEADERS = 0x00000008 +INTERNET_REQFLAG_PASSIVE = 0x00000010 +INTERNET_REQFLAG_CACHE_WRITE_DISABLED = 0x00000040 +INTERNET_REQFLAG_NET_TIMEOUT = 0x00000080 +INTERNET_FLAG_RELOAD = -2147483648 +INTERNET_FLAG_RAW_DATA = 0x40000000 +INTERNET_FLAG_EXISTING_CONNECT = 0x20000000 +INTERNET_FLAG_ASYNC = 0x10000000 +INTERNET_FLAG_PASSIVE = 0x08000000 +INTERNET_FLAG_NO_CACHE_WRITE = 0x04000000 +INTERNET_FLAG_DONT_CACHE = INTERNET_FLAG_NO_CACHE_WRITE +INTERNET_FLAG_MAKE_PERSISTENT = 0x02000000 +INTERNET_FLAG_FROM_CACHE = 0x01000000 +INTERNET_FLAG_OFFLINE = INTERNET_FLAG_FROM_CACHE +INTERNET_FLAG_SECURE = 0x00800000 +INTERNET_FLAG_KEEP_CONNECTION = 0x00400000 +INTERNET_FLAG_NO_AUTO_REDIRECT = 0x00200000 +INTERNET_FLAG_READ_PREFETCH = 0x00100000 +INTERNET_FLAG_NO_COOKIES = 0x00080000 +INTERNET_FLAG_NO_AUTH = 0x00040000 +INTERNET_FLAG_RESTRICTED_ZONE = 0x00020000 +INTERNET_FLAG_CACHE_IF_NET_FAIL = 0x00010000 +INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP = 0x00008000 +INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS = 0x00004000 +INTERNET_FLAG_IGNORE_CERT_DATE_INVALID = 0x00002000 +INTERNET_FLAG_IGNORE_CERT_CN_INVALID = 0x00001000 +INTERNET_FLAG_RESYNCHRONIZE = 0x00000800 +INTERNET_FLAG_HYPERLINK = 0x00000400 +INTERNET_FLAG_NO_UI = 0x00000200 +INTERNET_FLAG_PRAGMA_NOCACHE = 0x00000100 +INTERNET_FLAG_CACHE_ASYNC = 0x00000080 +INTERNET_FLAG_FORMS_SUBMIT = 0x00000040 +INTERNET_FLAG_FWD_BACK = 0x00000020 +INTERNET_FLAG_NEED_FILE = 0x00000010 +INTERNET_FLAG_MUST_CACHE_REQUEST = INTERNET_FLAG_NEED_FILE +SECURITY_INTERNET_MASK = ( + INTERNET_FLAG_IGNORE_CERT_CN_INVALID + | INTERNET_FLAG_IGNORE_CERT_DATE_INVALID + | INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS + | INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP +) +INTERNET_ERROR_MASK_INSERT_CDROM = 0x1 +INTERNET_ERROR_MASK_COMBINED_SEC_CERT = 0x2 +INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG = 0x4 +INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY = 0x8 +WININET_API_FLAG_ASYNC = 0x00000001 +WININET_API_FLAG_SYNC = 0x00000004 +WININET_API_FLAG_USE_CONTEXT = 0x00000008 +INTERNET_NO_CALLBACK = 0 +IDSI_FLAG_KEEP_ALIVE = 0x00000001 +IDSI_FLAG_SECURE = 0x00000002 +IDSI_FLAG_PROXY = 0x00000004 +IDSI_FLAG_TUNNEL = 0x00000008 +INTERNET_PER_CONN_FLAGS = 1 +INTERNET_PER_CONN_PROXY_SERVER = 2 +INTERNET_PER_CONN_PROXY_BYPASS = 3 +INTERNET_PER_CONN_AUTOCONFIG_URL = 4 +INTERNET_PER_CONN_AUTODISCOVERY_FLAGS = 5 +INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL = 6 +INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS = 7 +INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME = 8 +INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL = 9 +PROXY_TYPE_DIRECT = 0x00000001 +PROXY_TYPE_PROXY = 0x00000002 +PROXY_TYPE_AUTO_PROXY_URL = 0x00000004 +PROXY_TYPE_AUTO_DETECT = 0x00000008 +AUTO_PROXY_FLAG_USER_SET = 0x00000001 +AUTO_PROXY_FLAG_ALWAYS_DETECT = 0x00000002 +AUTO_PROXY_FLAG_DETECTION_RUN = 0x00000004 +AUTO_PROXY_FLAG_MIGRATED = 0x00000008 +AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT = 0x00000010 +AUTO_PROXY_FLAG_CACHE_INIT_RUN = 0x00000020 +AUTO_PROXY_FLAG_DETECTION_SUSPECT = 0x00000040 +ISO_FORCE_DISCONNECTED = 0x00000001 +INTERNET_RFC1123_FORMAT = 0 +INTERNET_RFC1123_BUFSIZE = 30 +ICU_ESCAPE = -2147483648 +ICU_ESCAPE_AUTHORITY = 0x00002000 +ICU_REJECT_USERPWD = 0x00004000 +ICU_USERNAME = 0x40000000 +ICU_NO_ENCODE = 0x20000000 +ICU_DECODE = 0x10000000 +ICU_NO_META = 0x08000000 +ICU_ENCODE_SPACES_ONLY = 0x04000000 +ICU_BROWSER_MODE = 0x02000000 +ICU_ENCODE_PERCENT = 0x00001000 +INTERNET_OPEN_TYPE_PRECONFIG = 0 +INTERNET_OPEN_TYPE_DIRECT = 1 +INTERNET_OPEN_TYPE_PROXY = 3 +INTERNET_OPEN_TYPE_PRECONFIG_WITH_NO_AUTOPROXY = 4 +PRE_CONFIG_INTERNET_ACCESS = INTERNET_OPEN_TYPE_PRECONFIG +LOCAL_INTERNET_ACCESS = INTERNET_OPEN_TYPE_DIRECT +CERN_PROXY_INTERNET_ACCESS = INTERNET_OPEN_TYPE_PROXY +INTERNET_SERVICE_FTP = 1 +INTERNET_SERVICE_GOPHER = 2 +INTERNET_SERVICE_HTTP = 3 +IRF_ASYNC = WININET_API_FLAG_ASYNC +IRF_SYNC = WININET_API_FLAG_SYNC +IRF_USE_CONTEXT = WININET_API_FLAG_USE_CONTEXT +IRF_NO_WAIT = 0x00000008 +ISO_GLOBAL = 0x00000001 +ISO_REGISTRY = 0x00000002 +ISO_VALID_FLAGS = ISO_GLOBAL | ISO_REGISTRY +INTERNET_OPTION_CALLBACK = 1 +INTERNET_OPTION_CONNECT_TIMEOUT = 2 +INTERNET_OPTION_CONNECT_RETRIES = 3 +INTERNET_OPTION_CONNECT_BACKOFF = 4 +INTERNET_OPTION_SEND_TIMEOUT = 5 +INTERNET_OPTION_CONTROL_SEND_TIMEOUT = INTERNET_OPTION_SEND_TIMEOUT +INTERNET_OPTION_RECEIVE_TIMEOUT = 6 +INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT = INTERNET_OPTION_RECEIVE_TIMEOUT +INTERNET_OPTION_DATA_SEND_TIMEOUT = 7 +INTERNET_OPTION_DATA_RECEIVE_TIMEOUT = 8 +INTERNET_OPTION_HANDLE_TYPE = 9 +INTERNET_OPTION_LISTEN_TIMEOUT = 11 +INTERNET_OPTION_READ_BUFFER_SIZE = 12 +INTERNET_OPTION_WRITE_BUFFER_SIZE = 13 +INTERNET_OPTION_ASYNC_ID = 15 +INTERNET_OPTION_ASYNC_PRIORITY = 16 +INTERNET_OPTION_PARENT_HANDLE = 21 +INTERNET_OPTION_KEEP_CONNECTION = 22 +INTERNET_OPTION_REQUEST_FLAGS = 23 +INTERNET_OPTION_EXTENDED_ERROR = 24 +INTERNET_OPTION_OFFLINE_MODE = 26 +INTERNET_OPTION_CACHE_STREAM_HANDLE = 27 +INTERNET_OPTION_USERNAME = 28 +INTERNET_OPTION_PASSWORD = 29 +INTERNET_OPTION_ASYNC = 30 +INTERNET_OPTION_SECURITY_FLAGS = 31 +INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT = 32 +INTERNET_OPTION_DATAFILE_NAME = 33 +INTERNET_OPTION_URL = 34 +INTERNET_OPTION_SECURITY_CERTIFICATE = 35 +INTERNET_OPTION_SECURITY_KEY_BITNESS = 36 +INTERNET_OPTION_REFRESH = 37 +INTERNET_OPTION_PROXY = 38 +INTERNET_OPTION_SETTINGS_CHANGED = 39 +INTERNET_OPTION_VERSION = 40 +INTERNET_OPTION_USER_AGENT = 41 +INTERNET_OPTION_END_BROWSER_SESSION = 42 +INTERNET_OPTION_PROXY_USERNAME = 43 +INTERNET_OPTION_PROXY_PASSWORD = 44 +INTERNET_OPTION_CONTEXT_VALUE = 45 +INTERNET_OPTION_CONNECT_LIMIT = 46 +INTERNET_OPTION_SECURITY_SELECT_CLIENT_CERT = 47 +INTERNET_OPTION_POLICY = 48 +INTERNET_OPTION_DISCONNECTED_TIMEOUT = 49 +INTERNET_OPTION_CONNECTED_STATE = 50 +INTERNET_OPTION_IDLE_STATE = 51 +INTERNET_OPTION_OFFLINE_SEMANTICS = 52 +INTERNET_OPTION_SECONDARY_CACHE_KEY = 53 +INTERNET_OPTION_CALLBACK_FILTER = 54 +INTERNET_OPTION_CONNECT_TIME = 55 +INTERNET_OPTION_SEND_THROUGHPUT = 56 +INTERNET_OPTION_RECEIVE_THROUGHPUT = 57 +INTERNET_OPTION_REQUEST_PRIORITY = 58 +INTERNET_OPTION_HTTP_VERSION = 59 +INTERNET_OPTION_RESET_URLCACHE_SESSION = 60 +INTERNET_OPTION_ERROR_MASK = 62 +INTERNET_OPTION_FROM_CACHE_TIMEOUT = 63 +INTERNET_OPTION_BYPASS_EDITED_ENTRY = 64 +INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO = 67 +INTERNET_OPTION_CODEPAGE = 68 +INTERNET_OPTION_CACHE_TIMESTAMPS = 69 +INTERNET_OPTION_DISABLE_AUTODIAL = 70 +INTERNET_OPTION_MAX_CONNS_PER_SERVER = 73 +INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER = 74 +INTERNET_OPTION_PER_CONNECTION_OPTION = 75 +INTERNET_OPTION_DIGEST_AUTH_UNLOAD = 76 +INTERNET_OPTION_IGNORE_OFFLINE = 77 +INTERNET_OPTION_IDENTITY = 78 +INTERNET_OPTION_REMOVE_IDENTITY = 79 +INTERNET_OPTION_ALTER_IDENTITY = 80 +INTERNET_OPTION_SUPPRESS_BEHAVIOR = 81 +INTERNET_OPTION_AUTODIAL_MODE = 82 +INTERNET_OPTION_AUTODIAL_CONNECTION = 83 +INTERNET_OPTION_CLIENT_CERT_CONTEXT = 84 +INTERNET_OPTION_AUTH_FLAGS = 85 +INTERNET_OPTION_COOKIES_3RD_PARTY = 86 +INTERNET_OPTION_DISABLE_PASSPORT_AUTH = 87 +INTERNET_OPTION_SEND_UTF8_SERVERNAME_TO_PROXY = 88 +INTERNET_OPTION_EXEMPT_CONNECTION_LIMIT = 89 +INTERNET_OPTION_ENABLE_PASSPORT_AUTH = 90 +INTERNET_OPTION_HIBERNATE_INACTIVE_WORKER_THREADS = 91 +INTERNET_OPTION_ACTIVATE_WORKER_THREADS = 92 +INTERNET_OPTION_RESTORE_WORKER_THREAD_DEFAULTS = 93 +INTERNET_OPTION_SOCKET_SEND_BUFFER_LENGTH = 94 +INTERNET_OPTION_PROXY_SETTINGS_CHANGED = 95 +INTERNET_FIRST_OPTION = INTERNET_OPTION_CALLBACK +INTERNET_LAST_OPTION = INTERNET_OPTION_PROXY_SETTINGS_CHANGED +INTERNET_PRIORITY_FOREGROUND = 1000 +INTERNET_HANDLE_TYPE_INTERNET = 1 +INTERNET_HANDLE_TYPE_CONNECT_FTP = 2 +INTERNET_HANDLE_TYPE_CONNECT_GOPHER = 3 +INTERNET_HANDLE_TYPE_CONNECT_HTTP = 4 +INTERNET_HANDLE_TYPE_FTP_FIND = 5 +INTERNET_HANDLE_TYPE_FTP_FIND_HTML = 6 +INTERNET_HANDLE_TYPE_FTP_FILE = 7 +INTERNET_HANDLE_TYPE_FTP_FILE_HTML = 8 +INTERNET_HANDLE_TYPE_GOPHER_FIND = 9 +INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML = 10 +INTERNET_HANDLE_TYPE_GOPHER_FILE = 11 +INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML = 12 +INTERNET_HANDLE_TYPE_HTTP_REQUEST = 13 +INTERNET_HANDLE_TYPE_FILE_REQUEST = 14 +AUTH_FLAG_DISABLE_NEGOTIATE = 0x00000001 +AUTH_FLAG_ENABLE_NEGOTIATE = 0x00000002 +SECURITY_FLAG_SECURE = 0x00000001 +SECURITY_FLAG_STRENGTH_WEAK = 0x10000000 +SECURITY_FLAG_STRENGTH_MEDIUM = 0x40000000 +SECURITY_FLAG_STRENGTH_STRONG = 0x20000000 +SECURITY_FLAG_UNKNOWNBIT = -2147483648 +SECURITY_FLAG_FORTEZZA = 0x08000000 +SECURITY_FLAG_NORMALBITNESS = SECURITY_FLAG_STRENGTH_WEAK +SECURITY_FLAG_SSL = 0x00000002 +SECURITY_FLAG_SSL3 = 0x00000004 +SECURITY_FLAG_PCT = 0x00000008 +SECURITY_FLAG_PCT4 = 0x00000010 +SECURITY_FLAG_IETFSSL4 = 0x00000020 +SECURITY_FLAG_40BIT = SECURITY_FLAG_STRENGTH_WEAK +SECURITY_FLAG_128BIT = SECURITY_FLAG_STRENGTH_STRONG +SECURITY_FLAG_56BIT = SECURITY_FLAG_STRENGTH_MEDIUM +SECURITY_FLAG_IGNORE_REVOCATION = 0x00000080 +SECURITY_FLAG_IGNORE_UNKNOWN_CA = 0x00000100 +SECURITY_FLAG_IGNORE_WRONG_USAGE = 0x00000200 +SECURITY_FLAG_IGNORE_CERT_CN_INVALID = INTERNET_FLAG_IGNORE_CERT_CN_INVALID +SECURITY_FLAG_IGNORE_CERT_DATE_INVALID = INTERNET_FLAG_IGNORE_CERT_DATE_INVALID +SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE = 0x00000200 +SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS = INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS +SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP = INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP +SECURITY_SET_MASK = ( + SECURITY_FLAG_IGNORE_REVOCATION + | SECURITY_FLAG_IGNORE_UNKNOWN_CA + | SECURITY_FLAG_IGNORE_CERT_CN_INVALID + | SECURITY_FLAG_IGNORE_CERT_DATE_INVALID + | SECURITY_FLAG_IGNORE_WRONG_USAGE +) +AUTODIAL_MODE_NEVER = 1 +AUTODIAL_MODE_ALWAYS = 2 +AUTODIAL_MODE_NO_NETWORK_PRESENT = 4 +INTERNET_STATUS_RESOLVING_NAME = 10 +INTERNET_STATUS_NAME_RESOLVED = 11 +INTERNET_STATUS_CONNECTING_TO_SERVER = 20 +INTERNET_STATUS_CONNECTED_TO_SERVER = 21 +INTERNET_STATUS_SENDING_REQUEST = 30 +INTERNET_STATUS_REQUEST_SENT = 31 +INTERNET_STATUS_RECEIVING_RESPONSE = 40 +INTERNET_STATUS_RESPONSE_RECEIVED = 41 +INTERNET_STATUS_CTL_RESPONSE_RECEIVED = 42 +INTERNET_STATUS_PREFETCH = 43 +INTERNET_STATUS_CLOSING_CONNECTION = 50 +INTERNET_STATUS_CONNECTION_CLOSED = 51 +INTERNET_STATUS_HANDLE_CREATED = 60 +INTERNET_STATUS_HANDLE_CLOSING = 70 +INTERNET_STATUS_DETECTING_PROXY = 80 +INTERNET_STATUS_REQUEST_COMPLETE = 100 +INTERNET_STATUS_REDIRECT = 110 +INTERNET_STATUS_INTERMEDIATE_RESPONSE = 120 +INTERNET_STATUS_USER_INPUT_REQUIRED = 140 +INTERNET_STATUS_STATE_CHANGE = 200 +INTERNET_STATUS_COOKIE_SENT = 320 +INTERNET_STATUS_COOKIE_RECEIVED = 321 +INTERNET_STATUS_PRIVACY_IMPACTED = 324 +INTERNET_STATUS_P3P_HEADER = 325 +INTERNET_STATUS_P3P_POLICYREF = 326 +INTERNET_STATUS_COOKIE_HISTORY = 327 +INTERNET_STATE_CONNECTED = 0x00000001 +INTERNET_STATE_DISCONNECTED = 0x00000002 +INTERNET_STATE_DISCONNECTED_BY_USER = 0x00000010 +INTERNET_STATE_IDLE = 0x00000100 +INTERNET_STATE_BUSY = 0x00000200 +FTP_TRANSFER_TYPE_UNKNOWN = 0x00000000 +FTP_TRANSFER_TYPE_ASCII = 0x00000001 +FTP_TRANSFER_TYPE_BINARY = 0x00000002 +FTP_TRANSFER_TYPE_MASK = FTP_TRANSFER_TYPE_ASCII | FTP_TRANSFER_TYPE_BINARY +MAX_GOPHER_DISPLAY_TEXT = 128 +MAX_GOPHER_SELECTOR_TEXT = 256 +MAX_GOPHER_HOST_NAME = INTERNET_MAX_HOST_NAME_LENGTH +MAX_GOPHER_LOCATOR_LENGTH = ( + 1 + + MAX_GOPHER_DISPLAY_TEXT + + 1 + + MAX_GOPHER_SELECTOR_TEXT + + 1 + + MAX_GOPHER_HOST_NAME + + 1 + + INTERNET_MAX_PORT_NUMBER_LENGTH + + 1 + + 1 + + 2 +) +GOPHER_TYPE_TEXT_FILE = 0x00000001 +GOPHER_TYPE_DIRECTORY = 0x00000002 +GOPHER_TYPE_CSO = 0x00000004 +GOPHER_TYPE_ERROR = 0x00000008 +GOPHER_TYPE_MAC_BINHEX = 0x00000010 +GOPHER_TYPE_DOS_ARCHIVE = 0x00000020 +GOPHER_TYPE_UNIX_UUENCODED = 0x00000040 +GOPHER_TYPE_INDEX_SERVER = 0x00000080 +GOPHER_TYPE_TELNET = 0x00000100 +GOPHER_TYPE_BINARY = 0x00000200 +GOPHER_TYPE_REDUNDANT = 0x00000400 +GOPHER_TYPE_TN3270 = 0x00000800 +GOPHER_TYPE_GIF = 0x00001000 +GOPHER_TYPE_IMAGE = 0x00002000 +GOPHER_TYPE_BITMAP = 0x00004000 +GOPHER_TYPE_MOVIE = 0x00008000 +GOPHER_TYPE_SOUND = 0x00010000 +GOPHER_TYPE_HTML = 0x00020000 +GOPHER_TYPE_PDF = 0x00040000 +GOPHER_TYPE_CALENDAR = 0x00080000 +GOPHER_TYPE_INLINE = 0x00100000 +GOPHER_TYPE_UNKNOWN = 0x20000000 +GOPHER_TYPE_ASK = 0x40000000 +GOPHER_TYPE_GOPHER_PLUS = -2147483648 +GOPHER_TYPE_FILE_MASK = ( + GOPHER_TYPE_TEXT_FILE + | GOPHER_TYPE_MAC_BINHEX + | GOPHER_TYPE_DOS_ARCHIVE + | GOPHER_TYPE_UNIX_UUENCODED + | GOPHER_TYPE_BINARY + | GOPHER_TYPE_GIF + | GOPHER_TYPE_IMAGE + | GOPHER_TYPE_BITMAP + | GOPHER_TYPE_MOVIE + | GOPHER_TYPE_SOUND + | GOPHER_TYPE_HTML + | GOPHER_TYPE_PDF + | GOPHER_TYPE_CALENDAR + | GOPHER_TYPE_INLINE +) +MAX_GOPHER_CATEGORY_NAME = 128 +MAX_GOPHER_ATTRIBUTE_NAME = 128 +MIN_GOPHER_ATTRIBUTE_LENGTH = 256 +GOPHER_ATTRIBUTE_ID_BASE = -1412641792 +GOPHER_CATEGORY_ID_ALL = GOPHER_ATTRIBUTE_ID_BASE + 1 +GOPHER_CATEGORY_ID_INFO = GOPHER_ATTRIBUTE_ID_BASE + 2 +GOPHER_CATEGORY_ID_ADMIN = GOPHER_ATTRIBUTE_ID_BASE + 3 +GOPHER_CATEGORY_ID_VIEWS = GOPHER_ATTRIBUTE_ID_BASE + 4 +GOPHER_CATEGORY_ID_ABSTRACT = GOPHER_ATTRIBUTE_ID_BASE + 5 +GOPHER_CATEGORY_ID_VERONICA = GOPHER_ATTRIBUTE_ID_BASE + 6 +GOPHER_CATEGORY_ID_ASK = GOPHER_ATTRIBUTE_ID_BASE + 7 +GOPHER_CATEGORY_ID_UNKNOWN = GOPHER_ATTRIBUTE_ID_BASE + 8 +GOPHER_ATTRIBUTE_ID_ALL = GOPHER_ATTRIBUTE_ID_BASE + 9 +GOPHER_ATTRIBUTE_ID_ADMIN = GOPHER_ATTRIBUTE_ID_BASE + 10 +GOPHER_ATTRIBUTE_ID_MOD_DATE = GOPHER_ATTRIBUTE_ID_BASE + 11 +GOPHER_ATTRIBUTE_ID_TTL = GOPHER_ATTRIBUTE_ID_BASE + 12 +GOPHER_ATTRIBUTE_ID_SCORE = GOPHER_ATTRIBUTE_ID_BASE + 13 +GOPHER_ATTRIBUTE_ID_RANGE = GOPHER_ATTRIBUTE_ID_BASE + 14 +GOPHER_ATTRIBUTE_ID_SITE = GOPHER_ATTRIBUTE_ID_BASE + 15 +GOPHER_ATTRIBUTE_ID_ORG = GOPHER_ATTRIBUTE_ID_BASE + 16 +GOPHER_ATTRIBUTE_ID_LOCATION = GOPHER_ATTRIBUTE_ID_BASE + 17 +GOPHER_ATTRIBUTE_ID_GEOG = GOPHER_ATTRIBUTE_ID_BASE + 18 +GOPHER_ATTRIBUTE_ID_TIMEZONE = GOPHER_ATTRIBUTE_ID_BASE + 19 +GOPHER_ATTRIBUTE_ID_PROVIDER = GOPHER_ATTRIBUTE_ID_BASE + 20 +GOPHER_ATTRIBUTE_ID_VERSION = GOPHER_ATTRIBUTE_ID_BASE + 21 +GOPHER_ATTRIBUTE_ID_ABSTRACT = GOPHER_ATTRIBUTE_ID_BASE + 22 +GOPHER_ATTRIBUTE_ID_VIEW = GOPHER_ATTRIBUTE_ID_BASE + 23 +GOPHER_ATTRIBUTE_ID_TREEWALK = GOPHER_ATTRIBUTE_ID_BASE + 24 +GOPHER_ATTRIBUTE_ID_UNKNOWN = GOPHER_ATTRIBUTE_ID_BASE + 25 +HTTP_MAJOR_VERSION = 1 +HTTP_MINOR_VERSION = 0 +HTTP_VERSIONA = "HTTP/1.0" +HTTP_VERSION = HTTP_VERSIONA +HTTP_QUERY_MIME_VERSION = 0 +HTTP_QUERY_CONTENT_TYPE = 1 +HTTP_QUERY_CONTENT_TRANSFER_ENCODING = 2 +HTTP_QUERY_CONTENT_ID = 3 +HTTP_QUERY_CONTENT_DESCRIPTION = 4 +HTTP_QUERY_CONTENT_LENGTH = 5 +HTTP_QUERY_CONTENT_LANGUAGE = 6 +HTTP_QUERY_ALLOW = 7 +HTTP_QUERY_PUBLIC = 8 +HTTP_QUERY_DATE = 9 +HTTP_QUERY_EXPIRES = 10 +HTTP_QUERY_LAST_MODIFIED = 11 +HTTP_QUERY_MESSAGE_ID = 12 +HTTP_QUERY_URI = 13 +HTTP_QUERY_DERIVED_FROM = 14 +HTTP_QUERY_COST = 15 +HTTP_QUERY_LINK = 16 +HTTP_QUERY_PRAGMA = 17 +HTTP_QUERY_VERSION = 18 +HTTP_QUERY_STATUS_CODE = 19 +HTTP_QUERY_STATUS_TEXT = 20 +HTTP_QUERY_RAW_HEADERS = 21 +HTTP_QUERY_RAW_HEADERS_CRLF = 22 +HTTP_QUERY_CONNECTION = 23 +HTTP_QUERY_ACCEPT = 24 +HTTP_QUERY_ACCEPT_CHARSET = 25 +HTTP_QUERY_ACCEPT_ENCODING = 26 +HTTP_QUERY_ACCEPT_LANGUAGE = 27 +HTTP_QUERY_AUTHORIZATION = 28 +HTTP_QUERY_CONTENT_ENCODING = 29 +HTTP_QUERY_FORWARDED = 30 +HTTP_QUERY_FROM = 31 +HTTP_QUERY_IF_MODIFIED_SINCE = 32 +HTTP_QUERY_LOCATION = 33 +HTTP_QUERY_ORIG_URI = 34 +HTTP_QUERY_REFERER = 35 +HTTP_QUERY_RETRY_AFTER = 36 +HTTP_QUERY_SERVER = 37 +HTTP_QUERY_TITLE = 38 +HTTP_QUERY_USER_AGENT = 39 +HTTP_QUERY_WWW_AUTHENTICATE = 40 +HTTP_QUERY_PROXY_AUTHENTICATE = 41 +HTTP_QUERY_ACCEPT_RANGES = 42 +HTTP_QUERY_SET_COOKIE = 43 +HTTP_QUERY_COOKIE = 44 +HTTP_QUERY_REQUEST_METHOD = 45 +HTTP_QUERY_REFRESH = 46 +HTTP_QUERY_CONTENT_DISPOSITION = 47 +HTTP_QUERY_AGE = 48 +HTTP_QUERY_CACHE_CONTROL = 49 +HTTP_QUERY_CONTENT_BASE = 50 +HTTP_QUERY_CONTENT_LOCATION = 51 +HTTP_QUERY_CONTENT_MD5 = 52 +HTTP_QUERY_CONTENT_RANGE = 53 +HTTP_QUERY_ETAG = 54 +HTTP_QUERY_HOST = 55 +HTTP_QUERY_IF_MATCH = 56 +HTTP_QUERY_IF_NONE_MATCH = 57 +HTTP_QUERY_IF_RANGE = 58 +HTTP_QUERY_IF_UNMODIFIED_SINCE = 59 +HTTP_QUERY_MAX_FORWARDS = 60 +HTTP_QUERY_PROXY_AUTHORIZATION = 61 +HTTP_QUERY_RANGE = 62 +HTTP_QUERY_TRANSFER_ENCODING = 63 +HTTP_QUERY_UPGRADE = 64 +HTTP_QUERY_VARY = 65 +HTTP_QUERY_VIA = 66 +HTTP_QUERY_WARNING = 67 +HTTP_QUERY_EXPECT = 68 +HTTP_QUERY_PROXY_CONNECTION = 69 +HTTP_QUERY_UNLESS_MODIFIED_SINCE = 70 +HTTP_QUERY_ECHO_REQUEST = 71 +HTTP_QUERY_ECHO_REPLY = 72 +HTTP_QUERY_ECHO_HEADERS = 73 +HTTP_QUERY_ECHO_HEADERS_CRLF = 74 +HTTP_QUERY_PROXY_SUPPORT = 75 +HTTP_QUERY_AUTHENTICATION_INFO = 76 +HTTP_QUERY_PASSPORT_URLS = 77 +HTTP_QUERY_PASSPORT_CONFIG = 78 +HTTP_QUERY_MAX = 78 +HTTP_QUERY_CUSTOM = 65535 +HTTP_QUERY_FLAG_REQUEST_HEADERS = -2147483648 +HTTP_QUERY_FLAG_SYSTEMTIME = 0x40000000 +HTTP_QUERY_FLAG_NUMBER = 0x20000000 +HTTP_QUERY_FLAG_COALESCE = 0x10000000 +HTTP_QUERY_MODIFIER_FLAGS_MASK = ( + HTTP_QUERY_FLAG_REQUEST_HEADERS + | HTTP_QUERY_FLAG_SYSTEMTIME + | HTTP_QUERY_FLAG_NUMBER + | HTTP_QUERY_FLAG_COALESCE +) +HTTP_QUERY_HEADER_MASK = ~HTTP_QUERY_MODIFIER_FLAGS_MASK +HTTP_STATUS_CONTINUE = 100 +HTTP_STATUS_SWITCH_PROTOCOLS = 101 +HTTP_STATUS_OK = 200 +HTTP_STATUS_CREATED = 201 +HTTP_STATUS_ACCEPTED = 202 +HTTP_STATUS_PARTIAL = 203 +HTTP_STATUS_NO_CONTENT = 204 +HTTP_STATUS_RESET_CONTENT = 205 +HTTP_STATUS_PARTIAL_CONTENT = 206 +HTTP_STATUS_WEBDAV_MULTI_STATUS = 207 +HTTP_STATUS_AMBIGUOUS = 300 +HTTP_STATUS_MOVED = 301 +HTTP_STATUS_REDIRECT = 302 +HTTP_STATUS_REDIRECT_METHOD = 303 +HTTP_STATUS_NOT_MODIFIED = 304 +HTTP_STATUS_USE_PROXY = 305 +HTTP_STATUS_REDIRECT_KEEP_VERB = 307 +HTTP_STATUS_BAD_REQUEST = 400 +HTTP_STATUS_DENIED = 401 +HTTP_STATUS_PAYMENT_REQ = 402 +HTTP_STATUS_FORBIDDEN = 403 +HTTP_STATUS_NOT_FOUND = 404 +HTTP_STATUS_BAD_METHOD = 405 +HTTP_STATUS_NONE_ACCEPTABLE = 406 +HTTP_STATUS_PROXY_AUTH_REQ = 407 +HTTP_STATUS_REQUEST_TIMEOUT = 408 +HTTP_STATUS_CONFLICT = 409 +HTTP_STATUS_GONE = 410 +HTTP_STATUS_LENGTH_REQUIRED = 411 +HTTP_STATUS_PRECOND_FAILED = 412 +HTTP_STATUS_REQUEST_TOO_LARGE = 413 +HTTP_STATUS_URI_TOO_LONG = 414 +HTTP_STATUS_UNSUPPORTED_MEDIA = 415 +HTTP_STATUS_RETRY_WITH = 449 +HTTP_STATUS_SERVER_ERROR = 500 +HTTP_STATUS_NOT_SUPPORTED = 501 +HTTP_STATUS_BAD_GATEWAY = 502 +HTTP_STATUS_SERVICE_UNAVAIL = 503 +HTTP_STATUS_GATEWAY_TIMEOUT = 504 +HTTP_STATUS_VERSION_NOT_SUP = 505 +HTTP_STATUS_FIRST = HTTP_STATUS_CONTINUE +HTTP_STATUS_LAST = HTTP_STATUS_VERSION_NOT_SUP +HTTP_ADDREQ_INDEX_MASK = 0x0000FFFF +HTTP_ADDREQ_FLAGS_MASK = -65536 +HTTP_ADDREQ_FLAG_ADD_IF_NEW = 0x10000000 +HTTP_ADDREQ_FLAG_ADD = 0x20000000 +HTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA = 0x40000000 +HTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON = 0x01000000 +HTTP_ADDREQ_FLAG_COALESCE = HTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA +HTTP_ADDREQ_FLAG_REPLACE = -2147483648 +HSR_ASYNC = WININET_API_FLAG_ASYNC +HSR_SYNC = WININET_API_FLAG_SYNC +HSR_USE_CONTEXT = WININET_API_FLAG_USE_CONTEXT +HSR_INITIATE = 0x00000008 +HSR_DOWNLOAD = 0x00000010 +HSR_CHUNKED = 0x00000020 +INTERNET_COOKIE_IS_SECURE = 0x01 +INTERNET_COOKIE_IS_SESSION = 0x02 +INTERNET_COOKIE_THIRD_PARTY = 0x10 +INTERNET_COOKIE_PROMPT_REQUIRED = 0x20 +INTERNET_COOKIE_EVALUATE_P3P = 0x40 +INTERNET_COOKIE_APPLY_P3P = 0x80 +INTERNET_COOKIE_P3P_ENABLED = 0x100 +INTERNET_COOKIE_IS_RESTRICTED = 0x200 +INTERNET_COOKIE_IE6 = 0x400 +INTERNET_COOKIE_IS_LEGACY = 0x800 +FLAG_ICC_FORCE_CONNECTION = 0x00000001 +FLAGS_ERROR_UI_FILTER_FOR_ERRORS = 0x01 +FLAGS_ERROR_UI_FLAGS_CHANGE_OPTIONS = 0x02 +FLAGS_ERROR_UI_FLAGS_GENERATE_DATA = 0x04 +FLAGS_ERROR_UI_FLAGS_NO_UI = 0x08 +FLAGS_ERROR_UI_SERIALIZE_DIALOGS = 0x10 +INTERNET_ERROR_BASE = 12000 +ERROR_INTERNET_OUT_OF_HANDLES = INTERNET_ERROR_BASE + 1 +ERROR_INTERNET_TIMEOUT = INTERNET_ERROR_BASE + 2 +ERROR_INTERNET_EXTENDED_ERROR = INTERNET_ERROR_BASE + 3 +ERROR_INTERNET_INTERNAL_ERROR = INTERNET_ERROR_BASE + 4 +ERROR_INTERNET_INVALID_URL = INTERNET_ERROR_BASE + 5 +ERROR_INTERNET_UNRECOGNIZED_SCHEME = INTERNET_ERROR_BASE + 6 +ERROR_INTERNET_NAME_NOT_RESOLVED = INTERNET_ERROR_BASE + 7 +ERROR_INTERNET_PROTOCOL_NOT_FOUND = INTERNET_ERROR_BASE + 8 +ERROR_INTERNET_INVALID_OPTION = INTERNET_ERROR_BASE + 9 +ERROR_INTERNET_BAD_OPTION_LENGTH = INTERNET_ERROR_BASE + 10 +ERROR_INTERNET_OPTION_NOT_SETTABLE = INTERNET_ERROR_BASE + 11 +ERROR_INTERNET_SHUTDOWN = INTERNET_ERROR_BASE + 12 +ERROR_INTERNET_INCORRECT_USER_NAME = INTERNET_ERROR_BASE + 13 +ERROR_INTERNET_INCORRECT_PASSWORD = INTERNET_ERROR_BASE + 14 +ERROR_INTERNET_LOGIN_FAILURE = INTERNET_ERROR_BASE + 15 +ERROR_INTERNET_INVALID_OPERATION = INTERNET_ERROR_BASE + 16 +ERROR_INTERNET_OPERATION_CANCELLED = INTERNET_ERROR_BASE + 17 +ERROR_INTERNET_INCORRECT_HANDLE_TYPE = INTERNET_ERROR_BASE + 18 +ERROR_INTERNET_INCORRECT_HANDLE_STATE = INTERNET_ERROR_BASE + 19 +ERROR_INTERNET_NOT_PROXY_REQUEST = INTERNET_ERROR_BASE + 20 +ERROR_INTERNET_REGISTRY_VALUE_NOT_FOUND = INTERNET_ERROR_BASE + 21 +ERROR_INTERNET_BAD_REGISTRY_PARAMETER = INTERNET_ERROR_BASE + 22 +ERROR_INTERNET_NO_DIRECT_ACCESS = INTERNET_ERROR_BASE + 23 +ERROR_INTERNET_NO_CONTEXT = INTERNET_ERROR_BASE + 24 +ERROR_INTERNET_NO_CALLBACK = INTERNET_ERROR_BASE + 25 +ERROR_INTERNET_REQUEST_PENDING = INTERNET_ERROR_BASE + 26 +ERROR_INTERNET_INCORRECT_FORMAT = INTERNET_ERROR_BASE + 27 +ERROR_INTERNET_ITEM_NOT_FOUND = INTERNET_ERROR_BASE + 28 +ERROR_INTERNET_CANNOT_CONNECT = INTERNET_ERROR_BASE + 29 +ERROR_INTERNET_CONNECTION_ABORTED = INTERNET_ERROR_BASE + 30 +ERROR_INTERNET_CONNECTION_RESET = INTERNET_ERROR_BASE + 31 +ERROR_INTERNET_FORCE_RETRY = INTERNET_ERROR_BASE + 32 +ERROR_INTERNET_INVALID_PROXY_REQUEST = INTERNET_ERROR_BASE + 33 +ERROR_INTERNET_NEED_UI = INTERNET_ERROR_BASE + 34 +ERROR_INTERNET_HANDLE_EXISTS = INTERNET_ERROR_BASE + 36 +ERROR_INTERNET_SEC_CERT_DATE_INVALID = INTERNET_ERROR_BASE + 37 +ERROR_INTERNET_SEC_CERT_CN_INVALID = INTERNET_ERROR_BASE + 38 +ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR = INTERNET_ERROR_BASE + 39 +ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR = INTERNET_ERROR_BASE + 40 +ERROR_INTERNET_MIXED_SECURITY = INTERNET_ERROR_BASE + 41 +ERROR_INTERNET_CHG_POST_IS_NON_SECURE = INTERNET_ERROR_BASE + 42 +ERROR_INTERNET_POST_IS_NON_SECURE = INTERNET_ERROR_BASE + 43 +ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED = INTERNET_ERROR_BASE + 44 +ERROR_INTERNET_INVALID_CA = INTERNET_ERROR_BASE + 45 +ERROR_INTERNET_CLIENT_AUTH_NOT_SETUP = INTERNET_ERROR_BASE + 46 +ERROR_INTERNET_ASYNC_THREAD_FAILED = INTERNET_ERROR_BASE + 47 +ERROR_INTERNET_REDIRECT_SCHEME_CHANGE = INTERNET_ERROR_BASE + 48 +ERROR_INTERNET_DIALOG_PENDING = INTERNET_ERROR_BASE + 49 +ERROR_INTERNET_RETRY_DIALOG = INTERNET_ERROR_BASE + 50 +ERROR_INTERNET_HTTPS_HTTP_SUBMIT_REDIR = INTERNET_ERROR_BASE + 52 +ERROR_INTERNET_INSERT_CDROM = INTERNET_ERROR_BASE + 53 +ERROR_INTERNET_FORTEZZA_LOGIN_NEEDED = INTERNET_ERROR_BASE + 54 +ERROR_INTERNET_SEC_CERT_ERRORS = INTERNET_ERROR_BASE + 55 +ERROR_INTERNET_SEC_CERT_NO_REV = INTERNET_ERROR_BASE + 56 +ERROR_INTERNET_SEC_CERT_REV_FAILED = INTERNET_ERROR_BASE + 57 +ERROR_FTP_TRANSFER_IN_PROGRESS = INTERNET_ERROR_BASE + 110 +ERROR_FTP_DROPPED = INTERNET_ERROR_BASE + 111 +ERROR_FTP_NO_PASSIVE_MODE = INTERNET_ERROR_BASE + 112 +ERROR_GOPHER_PROTOCOL_ERROR = INTERNET_ERROR_BASE + 130 +ERROR_GOPHER_NOT_FILE = INTERNET_ERROR_BASE + 131 +ERROR_GOPHER_DATA_ERROR = INTERNET_ERROR_BASE + 132 +ERROR_GOPHER_END_OF_DATA = INTERNET_ERROR_BASE + 133 +ERROR_GOPHER_INVALID_LOCATOR = INTERNET_ERROR_BASE + 134 +ERROR_GOPHER_INCORRECT_LOCATOR_TYPE = INTERNET_ERROR_BASE + 135 +ERROR_GOPHER_NOT_GOPHER_PLUS = INTERNET_ERROR_BASE + 136 +ERROR_GOPHER_ATTRIBUTE_NOT_FOUND = INTERNET_ERROR_BASE + 137 +ERROR_GOPHER_UNKNOWN_LOCATOR = INTERNET_ERROR_BASE + 138 +ERROR_HTTP_HEADER_NOT_FOUND = INTERNET_ERROR_BASE + 150 +ERROR_HTTP_DOWNLEVEL_SERVER = INTERNET_ERROR_BASE + 151 +ERROR_HTTP_INVALID_SERVER_RESPONSE = INTERNET_ERROR_BASE + 152 +ERROR_HTTP_INVALID_HEADER = INTERNET_ERROR_BASE + 153 +ERROR_HTTP_INVALID_QUERY_REQUEST = INTERNET_ERROR_BASE + 154 +ERROR_HTTP_HEADER_ALREADY_EXISTS = INTERNET_ERROR_BASE + 155 +ERROR_HTTP_REDIRECT_FAILED = INTERNET_ERROR_BASE + 156 +ERROR_HTTP_NOT_REDIRECTED = INTERNET_ERROR_BASE + 160 +ERROR_HTTP_COOKIE_NEEDS_CONFIRMATION = INTERNET_ERROR_BASE + 161 +ERROR_HTTP_COOKIE_DECLINED = INTERNET_ERROR_BASE + 162 +ERROR_HTTP_REDIRECT_NEEDS_CONFIRMATION = INTERNET_ERROR_BASE + 168 +ERROR_INTERNET_SECURITY_CHANNEL_ERROR = INTERNET_ERROR_BASE + 157 +ERROR_INTERNET_UNABLE_TO_CACHE_FILE = INTERNET_ERROR_BASE + 158 +ERROR_INTERNET_TCPIP_NOT_INSTALLED = INTERNET_ERROR_BASE + 159 +ERROR_INTERNET_DISCONNECTED = INTERNET_ERROR_BASE + 163 +ERROR_INTERNET_SERVER_UNREACHABLE = INTERNET_ERROR_BASE + 164 +ERROR_INTERNET_PROXY_SERVER_UNREACHABLE = INTERNET_ERROR_BASE + 165 +ERROR_INTERNET_BAD_AUTO_PROXY_SCRIPT = INTERNET_ERROR_BASE + 166 +ERROR_INTERNET_UNABLE_TO_DOWNLOAD_SCRIPT = INTERNET_ERROR_BASE + 167 +ERROR_INTERNET_SEC_INVALID_CERT = INTERNET_ERROR_BASE + 169 +ERROR_INTERNET_SEC_CERT_REVOKED = INTERNET_ERROR_BASE + 170 +ERROR_INTERNET_FAILED_DUETOSECURITYCHECK = INTERNET_ERROR_BASE + 171 +ERROR_INTERNET_NOT_INITIALIZED = INTERNET_ERROR_BASE + 172 +ERROR_INTERNET_NEED_MSN_SSPI_PKG = INTERNET_ERROR_BASE + 173 +ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY = INTERNET_ERROR_BASE + 174 +INTERNET_ERROR_LAST = ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY +NORMAL_CACHE_ENTRY = 0x00000001 +STICKY_CACHE_ENTRY = 0x00000004 +EDITED_CACHE_ENTRY = 0x00000008 +TRACK_OFFLINE_CACHE_ENTRY = 0x00000010 +TRACK_ONLINE_CACHE_ENTRY = 0x00000020 +SPARSE_CACHE_ENTRY = 0x00010000 +COOKIE_CACHE_ENTRY = 0x00100000 +URLHISTORY_CACHE_ENTRY = 0x00200000 +URLCACHE_FIND_DEFAULT_FILTER = ( + NORMAL_CACHE_ENTRY + | COOKIE_CACHE_ENTRY + | URLHISTORY_CACHE_ENTRY + | TRACK_OFFLINE_CACHE_ENTRY + | TRACK_ONLINE_CACHE_ENTRY + | STICKY_CACHE_ENTRY +) +CACHEGROUP_ATTRIBUTE_GET_ALL = -1 +CACHEGROUP_ATTRIBUTE_BASIC = 0x00000001 +CACHEGROUP_ATTRIBUTE_FLAG = 0x00000002 +CACHEGROUP_ATTRIBUTE_TYPE = 0x00000004 +CACHEGROUP_ATTRIBUTE_QUOTA = 0x00000008 +CACHEGROUP_ATTRIBUTE_GROUPNAME = 0x00000010 +CACHEGROUP_ATTRIBUTE_STORAGE = 0x00000020 +CACHEGROUP_FLAG_NONPURGEABLE = 0x00000001 +CACHEGROUP_FLAG_GIDONLY = 0x00000004 +CACHEGROUP_FLAG_FLUSHURL_ONDELETE = 0x00000002 +CACHEGROUP_SEARCH_ALL = 0x00000000 +CACHEGROUP_SEARCH_BYURL = 0x00000001 +CACHEGROUP_TYPE_INVALID = 0x00000001 +CACHEGROUP_READWRITE_MASK = ( + CACHEGROUP_ATTRIBUTE_TYPE + | CACHEGROUP_ATTRIBUTE_QUOTA + | CACHEGROUP_ATTRIBUTE_GROUPNAME + | CACHEGROUP_ATTRIBUTE_STORAGE +) +GROUPNAME_MAX_LENGTH = 120 +GROUP_OWNER_STORAGE_SIZE = 4 +CACHE_ENTRY_ATTRIBUTE_FC = 0x00000004 +CACHE_ENTRY_HITRATE_FC = 0x00000010 +CACHE_ENTRY_MODTIME_FC = 0x00000040 +CACHE_ENTRY_EXPTIME_FC = 0x00000080 +CACHE_ENTRY_ACCTIME_FC = 0x00000100 +CACHE_ENTRY_SYNCTIME_FC = 0x00000200 +CACHE_ENTRY_HEADERINFO_FC = 0x00000400 +CACHE_ENTRY_EXEMPT_DELTA_FC = 0x00000800 +INTERNET_CACHE_GROUP_ADD = 0 +INTERNET_CACHE_GROUP_REMOVE = 1 +INTERNET_DIAL_FORCE_PROMPT = 0x2000 +INTERNET_DIAL_SHOW_OFFLINE = 0x4000 +INTERNET_DIAL_UNATTENDED = 0x8000 +INTERENT_GOONLINE_REFRESH = 0x00000001 +INTERENT_GOONLINE_MASK = 0x00000001 +INTERNET_AUTODIAL_FORCE_ONLINE = 1 +INTERNET_AUTODIAL_FORCE_UNATTENDED = 2 +INTERNET_AUTODIAL_FAILIFSECURITYCHECK = 4 +INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT = 8 +INTERNET_AUTODIAL_FLAGS_MASK = ( + INTERNET_AUTODIAL_FORCE_ONLINE + | INTERNET_AUTODIAL_FORCE_UNATTENDED + | INTERNET_AUTODIAL_FAILIFSECURITYCHECK + | INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT +) +PROXY_AUTO_DETECT_TYPE_DHCP = 1 +PROXY_AUTO_DETECT_TYPE_DNS_A = 2 +INTERNET_CONNECTION_MODEM = 0x01 +INTERNET_CONNECTION_LAN = 0x02 +INTERNET_CONNECTION_PROXY = 0x04 +INTERNET_CONNECTION_MODEM_BUSY = 0x08 +INTERNET_RAS_INSTALLED = 0x10 +INTERNET_CONNECTION_OFFLINE = 0x20 +INTERNET_CONNECTION_CONFIGURED = 0x40 +INTERNET_CUSTOMDIAL_CONNECT = 0 +INTERNET_CUSTOMDIAL_UNATTENDED = 1 +INTERNET_CUSTOMDIAL_DISCONNECT = 2 +INTERNET_CUSTOMDIAL_SHOWOFFLINE = 4 +INTERNET_CUSTOMDIAL_SAFE_FOR_UNATTENDED = 1 +INTERNET_CUSTOMDIAL_WILL_SUPPLY_STATE = 2 +INTERNET_CUSTOMDIAL_CAN_HANGUP = 4 +INTERNET_DIALSTATE_DISCONNECTED = 1 +INTERNET_IDENTITY_FLAG_PRIVATE_CACHE = 0x01 +INTERNET_IDENTITY_FLAG_SHARED_CACHE = 0x02 +INTERNET_IDENTITY_FLAG_CLEAR_DATA = 0x04 +INTERNET_IDENTITY_FLAG_CLEAR_COOKIES = 0x08 +INTERNET_IDENTITY_FLAG_CLEAR_HISTORY = 0x10 +INTERNET_IDENTITY_FLAG_CLEAR_CONTENT = 0x20 +INTERNET_SUPPRESS_RESET_ALL = 0x00 +INTERNET_SUPPRESS_COOKIE_POLICY = 0x01 +INTERNET_SUPPRESS_COOKIE_POLICY_RESET = 0x02 +PRIVACY_TEMPLATE_NO_COOKIES = 0 +PRIVACY_TEMPLATE_HIGH = 1 +PRIVACY_TEMPLATE_MEDIUM_HIGH = 2 +PRIVACY_TEMPLATE_MEDIUM = 3 +PRIVACY_TEMPLATE_MEDIUM_LOW = 4 +PRIVACY_TEMPLATE_LOW = 5 +PRIVACY_TEMPLATE_CUSTOM = 100 +PRIVACY_TEMPLATE_ADVANCED = 101 +PRIVACY_TEMPLATE_MAX = PRIVACY_TEMPLATE_LOW +PRIVACY_TYPE_FIRST_PARTY = 0 +PRIVACY_TYPE_THIRD_PARTY = 1 + +# Generated by h2py from winhttp.h +WINHTTP_FLAG_ASYNC = 0x10000000 +WINHTTP_FLAG_SECURE = 0x00800000 +WINHTTP_FLAG_ESCAPE_PERCENT = 0x00000004 +WINHTTP_FLAG_NULL_CODEPAGE = 0x00000008 +WINHTTP_FLAG_BYPASS_PROXY_CACHE = 0x00000100 +WINHTTP_FLAG_REFRESH = WINHTTP_FLAG_BYPASS_PROXY_CACHE +WINHTTP_FLAG_ESCAPE_DISABLE = 0x00000040 +WINHTTP_FLAG_ESCAPE_DISABLE_QUERY = 0x00000080 +INTERNET_SCHEME_HTTP = 1 +INTERNET_SCHEME_HTTPS = 2 +WINHTTP_AUTOPROXY_AUTO_DETECT = 0x00000001 +WINHTTP_AUTOPROXY_CONFIG_URL = 0x00000002 +WINHTTP_AUTOPROXY_RUN_INPROCESS = 0x00010000 +WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY = 0x00020000 +WINHTTP_AUTO_DETECT_TYPE_DHCP = 0x00000001 +WINHTTP_AUTO_DETECT_TYPE_DNS_A = 0x00000002 +WINHTTP_TIME_FORMAT_BUFSIZE = 62 +WINHTTP_ACCESS_TYPE_DEFAULT_PROXY = 0 +WINHTTP_ACCESS_TYPE_NO_PROXY = 1 +WINHTTP_ACCESS_TYPE_NAMED_PROXY = 3 +WINHTTP_OPTION_CALLBACK = 1 +WINHTTP_OPTION_RESOLVE_TIMEOUT = 2 +WINHTTP_OPTION_CONNECT_TIMEOUT = 3 +WINHTTP_OPTION_CONNECT_RETRIES = 4 +WINHTTP_OPTION_SEND_TIMEOUT = 5 +WINHTTP_OPTION_RECEIVE_TIMEOUT = 6 +WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT = 7 +WINHTTP_OPTION_HANDLE_TYPE = 9 +WINHTTP_OPTION_READ_BUFFER_SIZE = 12 +WINHTTP_OPTION_WRITE_BUFFER_SIZE = 13 +WINHTTP_OPTION_PARENT_HANDLE = 21 +WINHTTP_OPTION_EXTENDED_ERROR = 24 +WINHTTP_OPTION_SECURITY_FLAGS = 31 +WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT = 32 +WINHTTP_OPTION_URL = 34 +WINHTTP_OPTION_SECURITY_KEY_BITNESS = 36 +WINHTTP_OPTION_PROXY = 38 +WINHTTP_OPTION_USER_AGENT = 41 +WINHTTP_OPTION_CONTEXT_VALUE = 45 +WINHTTP_OPTION_CLIENT_CERT_CONTEXT = 47 +WINHTTP_OPTION_REQUEST_PRIORITY = 58 +WINHTTP_OPTION_HTTP_VERSION = 59 +WINHTTP_OPTION_DISABLE_FEATURE = 63 +WINHTTP_OPTION_CODEPAGE = 68 +WINHTTP_OPTION_MAX_CONNS_PER_SERVER = 73 +WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER = 74 +WINHTTP_OPTION_AUTOLOGON_POLICY = 77 +WINHTTP_OPTION_SERVER_CERT_CONTEXT = 78 +WINHTTP_OPTION_ENABLE_FEATURE = 79 +WINHTTP_OPTION_WORKER_THREAD_COUNT = 80 +WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT = 81 +WINHTTP_OPTION_PASSPORT_COBRANDING_URL = 82 +WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH = 83 +WINHTTP_OPTION_SECURE_PROTOCOLS = 84 +WINHTTP_OPTION_ENABLETRACING = 85 +WINHTTP_OPTION_PASSPORT_SIGN_OUT = 86 +WINHTTP_OPTION_PASSPORT_RETURN_URL = 87 +WINHTTP_OPTION_REDIRECT_POLICY = 88 +WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS = 89 +WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE = 90 +WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE = 91 +WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE = 92 +WINHTTP_OPTION_CONNECTION_INFO = 93 +WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST = 94 +WINHTTP_OPTION_SPN = 96 +WINHTTP_OPTION_GLOBAL_PROXY_CREDS = 97 +WINHTTP_OPTION_GLOBAL_SERVER_CREDS = 98 +WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT = 99 +WINHTTP_OPTION_REJECT_USERPWD_IN_URL = 100 +WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS = 101 +WINHTTP_LAST_OPTION = WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS +WINHTTP_OPTION_USERNAME = 0x1000 +WINHTTP_OPTION_PASSWORD = 0x1001 +WINHTTP_OPTION_PROXY_USERNAME = 0x1002 +WINHTTP_OPTION_PROXY_PASSWORD = 0x1003 +WINHTTP_CONNS_PER_SERVER_UNLIMITED = -1 +WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM = 0 +WINHTTP_AUTOLOGON_SECURITY_LEVEL_LOW = 1 +WINHTTP_AUTOLOGON_SECURITY_LEVEL_HIGH = 2 +WINHTTP_AUTOLOGON_SECURITY_LEVEL_DEFAULT = WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM +WINHTTP_OPTION_REDIRECT_POLICY_NEVER = 0 +WINHTTP_OPTION_REDIRECT_POLICY_DISALLOW_HTTPS_TO_HTTP = 1 +WINHTTP_OPTION_REDIRECT_POLICY_ALWAYS = 2 +WINHTTP_OPTION_REDIRECT_POLICY_LAST = WINHTTP_OPTION_REDIRECT_POLICY_ALWAYS +WINHTTP_OPTION_REDIRECT_POLICY_DEFAULT = ( + WINHTTP_OPTION_REDIRECT_POLICY_DISALLOW_HTTPS_TO_HTTP +) +WINHTTP_DISABLE_PASSPORT_AUTH = 0x00000000 +WINHTTP_ENABLE_PASSPORT_AUTH = 0x10000000 +WINHTTP_DISABLE_PASSPORT_KEYRING = 0x20000000 +WINHTTP_ENABLE_PASSPORT_KEYRING = 0x40000000 +WINHTTP_DISABLE_COOKIES = 0x00000001 +WINHTTP_DISABLE_REDIRECTS = 0x00000002 +WINHTTP_DISABLE_AUTHENTICATION = 0x00000004 +WINHTTP_DISABLE_KEEP_ALIVE = 0x00000008 +WINHTTP_ENABLE_SSL_REVOCATION = 0x00000001 +WINHTTP_ENABLE_SSL_REVERT_IMPERSONATION = 0x00000002 +WINHTTP_DISABLE_SPN_SERVER_PORT = 0x00000000 +WINHTTP_ENABLE_SPN_SERVER_PORT = 0x00000001 +WINHTTP_OPTION_SPN_MASK = WINHTTP_ENABLE_SPN_SERVER_PORT +WINHTTP_HANDLE_TYPE_SESSION = 1 +WINHTTP_HANDLE_TYPE_CONNECT = 2 +WINHTTP_HANDLE_TYPE_REQUEST = 3 +WINHTTP_AUTH_SCHEME_BASIC = 0x00000001 +WINHTTP_AUTH_SCHEME_NTLM = 0x00000002 +WINHTTP_AUTH_SCHEME_PASSPORT = 0x00000004 +WINHTTP_AUTH_SCHEME_DIGEST = 0x00000008 +WINHTTP_AUTH_SCHEME_NEGOTIATE = 0x00000010 +WINHTTP_AUTH_TARGET_SERVER = 0x00000000 +WINHTTP_AUTH_TARGET_PROXY = 0x00000001 +WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED = 0x00000001 +WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CERT = 0x00000002 +WINHTTP_CALLBACK_STATUS_FLAG_CERT_REVOKED = 0x00000004 +WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA = 0x00000008 +WINHTTP_CALLBACK_STATUS_FLAG_CERT_CN_INVALID = 0x00000010 +WINHTTP_CALLBACK_STATUS_FLAG_CERT_DATE_INVALID = 0x00000020 +WINHTTP_CALLBACK_STATUS_FLAG_CERT_WRONG_USAGE = 0x00000040 +WINHTTP_CALLBACK_STATUS_FLAG_SECURITY_CHANNEL_ERROR = -2147483648 +WINHTTP_FLAG_SECURE_PROTOCOL_SSL2 = 0x00000008 +WINHTTP_FLAG_SECURE_PROTOCOL_SSL3 = 0x00000020 +WINHTTP_FLAG_SECURE_PROTOCOL_TLS1 = 0x00000080 +WINHTTP_FLAG_SECURE_PROTOCOL_ALL = ( + WINHTTP_FLAG_SECURE_PROTOCOL_SSL2 + | WINHTTP_FLAG_SECURE_PROTOCOL_SSL3 + | WINHTTP_FLAG_SECURE_PROTOCOL_TLS1 +) +WINHTTP_CALLBACK_STATUS_RESOLVING_NAME = 0x00000001 +WINHTTP_CALLBACK_STATUS_NAME_RESOLVED = 0x00000002 +WINHTTP_CALLBACK_STATUS_CONNECTING_TO_SERVER = 0x00000004 +WINHTTP_CALLBACK_STATUS_CONNECTED_TO_SERVER = 0x00000008 +WINHTTP_CALLBACK_STATUS_SENDING_REQUEST = 0x00000010 +WINHTTP_CALLBACK_STATUS_REQUEST_SENT = 0x00000020 +WINHTTP_CALLBACK_STATUS_RECEIVING_RESPONSE = 0x00000040 +WINHTTP_CALLBACK_STATUS_RESPONSE_RECEIVED = 0x00000080 +WINHTTP_CALLBACK_STATUS_CLOSING_CONNECTION = 0x00000100 +WINHTTP_CALLBACK_STATUS_CONNECTION_CLOSED = 0x00000200 +WINHTTP_CALLBACK_STATUS_HANDLE_CREATED = 0x00000400 +WINHTTP_CALLBACK_STATUS_HANDLE_CLOSING = 0x00000800 +WINHTTP_CALLBACK_STATUS_DETECTING_PROXY = 0x00001000 +WINHTTP_CALLBACK_STATUS_REDIRECT = 0x00004000 +WINHTTP_CALLBACK_STATUS_INTERMEDIATE_RESPONSE = 0x00008000 +WINHTTP_CALLBACK_STATUS_SECURE_FAILURE = 0x00010000 +WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE = 0x00020000 +WINHTTP_CALLBACK_STATUS_DATA_AVAILABLE = 0x00040000 +WINHTTP_CALLBACK_STATUS_READ_COMPLETE = 0x00080000 +WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE = 0x00100000 +WINHTTP_CALLBACK_STATUS_REQUEST_ERROR = 0x00200000 +WINHTTP_CALLBACK_STATUS_SENDREQUEST_COMPLETE = 0x00400000 +API_RECEIVE_RESPONSE = 1 +API_QUERY_DATA_AVAILABLE = 2 +API_READ_DATA = 3 +API_WRITE_DATA = 4 +API_SEND_REQUEST = 5 +WINHTTP_CALLBACK_FLAG_RESOLVE_NAME = ( + WINHTTP_CALLBACK_STATUS_RESOLVING_NAME | WINHTTP_CALLBACK_STATUS_NAME_RESOLVED +) +WINHTTP_CALLBACK_FLAG_CONNECT_TO_SERVER = ( + WINHTTP_CALLBACK_STATUS_CONNECTING_TO_SERVER + | WINHTTP_CALLBACK_STATUS_CONNECTED_TO_SERVER +) +WINHTTP_CALLBACK_FLAG_SEND_REQUEST = ( + WINHTTP_CALLBACK_STATUS_SENDING_REQUEST | WINHTTP_CALLBACK_STATUS_REQUEST_SENT +) +WINHTTP_CALLBACK_FLAG_RECEIVE_RESPONSE = ( + WINHTTP_CALLBACK_STATUS_RECEIVING_RESPONSE + | WINHTTP_CALLBACK_STATUS_RESPONSE_RECEIVED +) +WINHTTP_CALLBACK_FLAG_CLOSE_CONNECTION = ( + WINHTTP_CALLBACK_STATUS_CLOSING_CONNECTION + | WINHTTP_CALLBACK_STATUS_CONNECTION_CLOSED +) +WINHTTP_CALLBACK_FLAG_HANDLES = ( + WINHTTP_CALLBACK_STATUS_HANDLE_CREATED | WINHTTP_CALLBACK_STATUS_HANDLE_CLOSING +) +WINHTTP_CALLBACK_FLAG_DETECTING_PROXY = WINHTTP_CALLBACK_STATUS_DETECTING_PROXY +WINHTTP_CALLBACK_FLAG_REDIRECT = WINHTTP_CALLBACK_STATUS_REDIRECT +WINHTTP_CALLBACK_FLAG_INTERMEDIATE_RESPONSE = ( + WINHTTP_CALLBACK_STATUS_INTERMEDIATE_RESPONSE +) +WINHTTP_CALLBACK_FLAG_SECURE_FAILURE = WINHTTP_CALLBACK_STATUS_SECURE_FAILURE +WINHTTP_CALLBACK_FLAG_SENDREQUEST_COMPLETE = ( + WINHTTP_CALLBACK_STATUS_SENDREQUEST_COMPLETE +) +WINHTTP_CALLBACK_FLAG_HEADERS_AVAILABLE = WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE +WINHTTP_CALLBACK_FLAG_DATA_AVAILABLE = WINHTTP_CALLBACK_STATUS_DATA_AVAILABLE +WINHTTP_CALLBACK_FLAG_READ_COMPLETE = WINHTTP_CALLBACK_STATUS_READ_COMPLETE +WINHTTP_CALLBACK_FLAG_WRITE_COMPLETE = WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE +WINHTTP_CALLBACK_FLAG_REQUEST_ERROR = WINHTTP_CALLBACK_STATUS_REQUEST_ERROR +WINHTTP_CALLBACK_FLAG_ALL_COMPLETIONS = ( + WINHTTP_CALLBACK_STATUS_SENDREQUEST_COMPLETE + | WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE + | WINHTTP_CALLBACK_STATUS_DATA_AVAILABLE + | WINHTTP_CALLBACK_STATUS_READ_COMPLETE + | WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE + | WINHTTP_CALLBACK_STATUS_REQUEST_ERROR +) +WINHTTP_CALLBACK_FLAG_ALL_NOTIFICATIONS = -1 +WINHTTP_QUERY_MIME_VERSION = 0 +WINHTTP_QUERY_CONTENT_TYPE = 1 +WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING = 2 +WINHTTP_QUERY_CONTENT_ID = 3 +WINHTTP_QUERY_CONTENT_DESCRIPTION = 4 +WINHTTP_QUERY_CONTENT_LENGTH = 5 +WINHTTP_QUERY_CONTENT_LANGUAGE = 6 +WINHTTP_QUERY_ALLOW = 7 +WINHTTP_QUERY_PUBLIC = 8 +WINHTTP_QUERY_DATE = 9 +WINHTTP_QUERY_EXPIRES = 10 +WINHTTP_QUERY_LAST_MODIFIED = 11 +WINHTTP_QUERY_MESSAGE_ID = 12 +WINHTTP_QUERY_URI = 13 +WINHTTP_QUERY_DERIVED_FROM = 14 +WINHTTP_QUERY_COST = 15 +WINHTTP_QUERY_LINK = 16 +WINHTTP_QUERY_PRAGMA = 17 +WINHTTP_QUERY_VERSION = 18 +WINHTTP_QUERY_STATUS_CODE = 19 +WINHTTP_QUERY_STATUS_TEXT = 20 +WINHTTP_QUERY_RAW_HEADERS = 21 +WINHTTP_QUERY_RAW_HEADERS_CRLF = 22 +WINHTTP_QUERY_CONNECTION = 23 +WINHTTP_QUERY_ACCEPT = 24 +WINHTTP_QUERY_ACCEPT_CHARSET = 25 +WINHTTP_QUERY_ACCEPT_ENCODING = 26 +WINHTTP_QUERY_ACCEPT_LANGUAGE = 27 +WINHTTP_QUERY_AUTHORIZATION = 28 +WINHTTP_QUERY_CONTENT_ENCODING = 29 +WINHTTP_QUERY_FORWARDED = 30 +WINHTTP_QUERY_FROM = 31 +WINHTTP_QUERY_IF_MODIFIED_SINCE = 32 +WINHTTP_QUERY_LOCATION = 33 +WINHTTP_QUERY_ORIG_URI = 34 +WINHTTP_QUERY_REFERER = 35 +WINHTTP_QUERY_RETRY_AFTER = 36 +WINHTTP_QUERY_SERVER = 37 +WINHTTP_QUERY_TITLE = 38 +WINHTTP_QUERY_USER_AGENT = 39 +WINHTTP_QUERY_WWW_AUTHENTICATE = 40 +WINHTTP_QUERY_PROXY_AUTHENTICATE = 41 +WINHTTP_QUERY_ACCEPT_RANGES = 42 +WINHTTP_QUERY_SET_COOKIE = 43 +WINHTTP_QUERY_COOKIE = 44 +WINHTTP_QUERY_REQUEST_METHOD = 45 +WINHTTP_QUERY_REFRESH = 46 +WINHTTP_QUERY_CONTENT_DISPOSITION = 47 +WINHTTP_QUERY_AGE = 48 +WINHTTP_QUERY_CACHE_CONTROL = 49 +WINHTTP_QUERY_CONTENT_BASE = 50 +WINHTTP_QUERY_CONTENT_LOCATION = 51 +WINHTTP_QUERY_CONTENT_MD5 = 52 +WINHTTP_QUERY_CONTENT_RANGE = 53 +WINHTTP_QUERY_ETAG = 54 +WINHTTP_QUERY_HOST = 55 +WINHTTP_QUERY_IF_MATCH = 56 +WINHTTP_QUERY_IF_NONE_MATCH = 57 +WINHTTP_QUERY_IF_RANGE = 58 +WINHTTP_QUERY_IF_UNMODIFIED_SINCE = 59 +WINHTTP_QUERY_MAX_FORWARDS = 60 +WINHTTP_QUERY_PROXY_AUTHORIZATION = 61 +WINHTTP_QUERY_RANGE = 62 +WINHTTP_QUERY_TRANSFER_ENCODING = 63 +WINHTTP_QUERY_UPGRADE = 64 +WINHTTP_QUERY_VARY = 65 +WINHTTP_QUERY_VIA = 66 +WINHTTP_QUERY_WARNING = 67 +WINHTTP_QUERY_EXPECT = 68 +WINHTTP_QUERY_PROXY_CONNECTION = 69 +WINHTTP_QUERY_UNLESS_MODIFIED_SINCE = 70 +WINHTTP_QUERY_PROXY_SUPPORT = 75 +WINHTTP_QUERY_AUTHENTICATION_INFO = 76 +WINHTTP_QUERY_PASSPORT_URLS = 77 +WINHTTP_QUERY_PASSPORT_CONFIG = 78 +WINHTTP_QUERY_MAX = 78 +WINHTTP_QUERY_CUSTOM = 65535 +WINHTTP_QUERY_FLAG_REQUEST_HEADERS = -2147483648 +WINHTTP_QUERY_FLAG_SYSTEMTIME = 0x40000000 +WINHTTP_QUERY_FLAG_NUMBER = 0x20000000 +WINHTTP_ADDREQ_INDEX_MASK = 0x0000FFFF +WINHTTP_ADDREQ_FLAGS_MASK = -65536 +WINHTTP_ADDREQ_FLAG_ADD_IF_NEW = 0x10000000 +WINHTTP_ADDREQ_FLAG_ADD = 0x20000000 +WINHTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA = 0x40000000 +WINHTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON = 0x01000000 +WINHTTP_ADDREQ_FLAG_COALESCE = WINHTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA +WINHTTP_ADDREQ_FLAG_REPLACE = -2147483648 +WINHTTP_IGNORE_REQUEST_TOTAL_LENGTH = 0 +WINHTTP_ERROR_BASE = 12000 +ERROR_WINHTTP_OUT_OF_HANDLES = WINHTTP_ERROR_BASE + 1 +ERROR_WINHTTP_TIMEOUT = WINHTTP_ERROR_BASE + 2 +ERROR_WINHTTP_INTERNAL_ERROR = WINHTTP_ERROR_BASE + 4 +ERROR_WINHTTP_INVALID_URL = WINHTTP_ERROR_BASE + 5 +ERROR_WINHTTP_UNRECOGNIZED_SCHEME = WINHTTP_ERROR_BASE + 6 +ERROR_WINHTTP_NAME_NOT_RESOLVED = WINHTTP_ERROR_BASE + 7 +ERROR_WINHTTP_INVALID_OPTION = WINHTTP_ERROR_BASE + 9 +ERROR_WINHTTP_OPTION_NOT_SETTABLE = WINHTTP_ERROR_BASE + 11 +ERROR_WINHTTP_SHUTDOWN = WINHTTP_ERROR_BASE + 12 +ERROR_WINHTTP_LOGIN_FAILURE = WINHTTP_ERROR_BASE + 15 +ERROR_WINHTTP_OPERATION_CANCELLED = WINHTTP_ERROR_BASE + 17 +ERROR_WINHTTP_INCORRECT_HANDLE_TYPE = WINHTTP_ERROR_BASE + 18 +ERROR_WINHTTP_INCORRECT_HANDLE_STATE = WINHTTP_ERROR_BASE + 19 +ERROR_WINHTTP_CANNOT_CONNECT = WINHTTP_ERROR_BASE + 29 +ERROR_WINHTTP_CONNECTION_ERROR = WINHTTP_ERROR_BASE + 30 +ERROR_WINHTTP_RESEND_REQUEST = WINHTTP_ERROR_BASE + 32 +ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED = WINHTTP_ERROR_BASE + 44 +ERROR_WINHTTP_CANNOT_CALL_BEFORE_OPEN = WINHTTP_ERROR_BASE + 100 +ERROR_WINHTTP_CANNOT_CALL_BEFORE_SEND = WINHTTP_ERROR_BASE + 101 +ERROR_WINHTTP_CANNOT_CALL_AFTER_SEND = WINHTTP_ERROR_BASE + 102 +ERROR_WINHTTP_CANNOT_CALL_AFTER_OPEN = WINHTTP_ERROR_BASE + 103 +ERROR_WINHTTP_HEADER_NOT_FOUND = WINHTTP_ERROR_BASE + 150 +ERROR_WINHTTP_INVALID_SERVER_RESPONSE = WINHTTP_ERROR_BASE + 152 +ERROR_WINHTTP_INVALID_HEADER = WINHTTP_ERROR_BASE + 153 +ERROR_WINHTTP_INVALID_QUERY_REQUEST = WINHTTP_ERROR_BASE + 154 +ERROR_WINHTTP_HEADER_ALREADY_EXISTS = WINHTTP_ERROR_BASE + 155 +ERROR_WINHTTP_REDIRECT_FAILED = WINHTTP_ERROR_BASE + 156 +ERROR_WINHTTP_AUTO_PROXY_SERVICE_ERROR = WINHTTP_ERROR_BASE + 178 +ERROR_WINHTTP_BAD_AUTO_PROXY_SCRIPT = WINHTTP_ERROR_BASE + 166 +ERROR_WINHTTP_UNABLE_TO_DOWNLOAD_SCRIPT = WINHTTP_ERROR_BASE + 167 +ERROR_WINHTTP_NOT_INITIALIZED = WINHTTP_ERROR_BASE + 172 +ERROR_WINHTTP_SECURE_FAILURE = WINHTTP_ERROR_BASE + 175 +ERROR_WINHTTP_SECURE_CERT_DATE_INVALID = WINHTTP_ERROR_BASE + 37 +ERROR_WINHTTP_SECURE_CERT_CN_INVALID = WINHTTP_ERROR_BASE + 38 +ERROR_WINHTTP_SECURE_INVALID_CA = WINHTTP_ERROR_BASE + 45 +ERROR_WINHTTP_SECURE_CERT_REV_FAILED = WINHTTP_ERROR_BASE + 57 +ERROR_WINHTTP_SECURE_CHANNEL_ERROR = WINHTTP_ERROR_BASE + 157 +ERROR_WINHTTP_SECURE_INVALID_CERT = WINHTTP_ERROR_BASE + 169 +ERROR_WINHTTP_SECURE_CERT_REVOKED = WINHTTP_ERROR_BASE + 170 +ERROR_WINHTTP_SECURE_CERT_WRONG_USAGE = WINHTTP_ERROR_BASE + 179 +ERROR_WINHTTP_AUTODETECTION_FAILED = WINHTTP_ERROR_BASE + 180 +ERROR_WINHTTP_HEADER_COUNT_EXCEEDED = WINHTTP_ERROR_BASE + 181 +ERROR_WINHTTP_HEADER_SIZE_OVERFLOW = WINHTTP_ERROR_BASE + 182 +ERROR_WINHTTP_CHUNKED_ENCODING_HEADER_SIZE_OVERFLOW = WINHTTP_ERROR_BASE + 183 +ERROR_WINHTTP_RESPONSE_DRAIN_OVERFLOW = WINHTTP_ERROR_BASE + 184 +ERROR_WINHTTP_CLIENT_CERT_NO_PRIVATE_KEY = WINHTTP_ERROR_BASE + 185 +ERROR_WINHTTP_CLIENT_CERT_NO_ACCESS_PRIVATE_KEY = WINHTTP_ERROR_BASE + 186 +WINHTTP_ERROR_LAST = WINHTTP_ERROR_BASE + 186 + +WINHTTP_NO_PROXY_NAME = None +WINHTTP_NO_PROXY_BYPASS = None +WINHTTP_NO_REFERER = None +WINHTTP_DEFAULT_ACCEPT_TYPES = None +WINHTTP_NO_ADDITIONAL_HEADERS = None +WINHTTP_NO_REQUEST_DATA = None diff --git a/lib/win32/lib/win32netcon.py b/lib/win32/lib/win32netcon.py new file mode 100644 index 00000000..63e97a14 --- /dev/null +++ b/lib/win32/lib/win32netcon.py @@ -0,0 +1,627 @@ +# Generated by h2py from lmaccess.h + +# Included from lmcons.h +CNLEN = 15 +LM20_CNLEN = 15 +DNLEN = CNLEN +LM20_DNLEN = LM20_CNLEN +UNCLEN = CNLEN + 2 +LM20_UNCLEN = LM20_CNLEN + 2 +NNLEN = 80 +LM20_NNLEN = 12 +RMLEN = UNCLEN + 1 + NNLEN +LM20_RMLEN = LM20_UNCLEN + 1 + LM20_NNLEN +SNLEN = 80 +LM20_SNLEN = 15 +STXTLEN = 256 +LM20_STXTLEN = 63 +PATHLEN = 256 +LM20_PATHLEN = 256 +DEVLEN = 80 +LM20_DEVLEN = 8 +EVLEN = 16 +UNLEN = 256 +LM20_UNLEN = 20 +GNLEN = UNLEN +LM20_GNLEN = LM20_UNLEN +PWLEN = 256 +LM20_PWLEN = 14 +SHPWLEN = 8 +CLTYPE_LEN = 12 +MAXCOMMENTSZ = 256 +LM20_MAXCOMMENTSZ = 48 +QNLEN = NNLEN +LM20_QNLEN = LM20_NNLEN +ALERTSZ = 128 +NETBIOS_NAME_LEN = 16 +CRYPT_KEY_LEN = 7 +CRYPT_TXT_LEN = 8 +ENCRYPTED_PWLEN = 16 +SESSION_PWLEN = 24 +SESSION_CRYPT_KLEN = 21 +PARMNUM_ALL = 0 +PARM_ERROR_NONE = 0 +PARMNUM_BASE_INFOLEVEL = 1000 +NULL = 0 +PLATFORM_ID_DOS = 300 +PLATFORM_ID_OS2 = 400 +PLATFORM_ID_NT = 500 +PLATFORM_ID_OSF = 600 +PLATFORM_ID_VMS = 700 +MAX_LANMAN_MESSAGE_ID = 5799 +UF_SCRIPT = 1 +UF_ACCOUNTDISABLE = 2 +UF_HOMEDIR_REQUIRED = 8 +UF_LOCKOUT = 16 +UF_PASSWD_NOTREQD = 32 +UF_PASSWD_CANT_CHANGE = 64 +UF_TEMP_DUPLICATE_ACCOUNT = 256 +UF_NORMAL_ACCOUNT = 512 +UF_INTERDOMAIN_TRUST_ACCOUNT = 2048 +UF_WORKSTATION_TRUST_ACCOUNT = 4096 +UF_SERVER_TRUST_ACCOUNT = 8192 +UF_MACHINE_ACCOUNT_MASK = ( + UF_INTERDOMAIN_TRUST_ACCOUNT + | UF_WORKSTATION_TRUST_ACCOUNT + | UF_SERVER_TRUST_ACCOUNT +) +UF_ACCOUNT_TYPE_MASK = ( + UF_TEMP_DUPLICATE_ACCOUNT + | UF_NORMAL_ACCOUNT + | UF_INTERDOMAIN_TRUST_ACCOUNT + | UF_WORKSTATION_TRUST_ACCOUNT + | UF_SERVER_TRUST_ACCOUNT +) +UF_DONT_EXPIRE_PASSWD = 65536 +UF_MNS_LOGON_ACCOUNT = 131072 +UF_SETTABLE_BITS = ( + UF_SCRIPT + | UF_ACCOUNTDISABLE + | UF_LOCKOUT + | UF_HOMEDIR_REQUIRED + | UF_PASSWD_NOTREQD + | UF_PASSWD_CANT_CHANGE + | UF_ACCOUNT_TYPE_MASK + | UF_DONT_EXPIRE_PASSWD + | UF_MNS_LOGON_ACCOUNT +) +FILTER_TEMP_DUPLICATE_ACCOUNT = 1 +FILTER_NORMAL_ACCOUNT = 2 +FILTER_INTERDOMAIN_TRUST_ACCOUNT = 8 +FILTER_WORKSTATION_TRUST_ACCOUNT = 16 +FILTER_SERVER_TRUST_ACCOUNT = 32 +LG_INCLUDE_INDIRECT = 1 +AF_OP_PRINT = 1 +AF_OP_COMM = 2 +AF_OP_SERVER = 4 +AF_OP_ACCOUNTS = 8 +AF_SETTABLE_BITS = AF_OP_PRINT | AF_OP_COMM | AF_OP_SERVER | AF_OP_ACCOUNTS +UAS_ROLE_STANDALONE = 0 +UAS_ROLE_MEMBER = 1 +UAS_ROLE_BACKUP = 2 +UAS_ROLE_PRIMARY = 3 +USER_NAME_PARMNUM = 1 +USER_PASSWORD_PARMNUM = 3 +USER_PASSWORD_AGE_PARMNUM = 4 +USER_PRIV_PARMNUM = 5 +USER_HOME_DIR_PARMNUM = 6 +USER_COMMENT_PARMNUM = 7 +USER_FLAGS_PARMNUM = 8 +USER_SCRIPT_PATH_PARMNUM = 9 +USER_AUTH_FLAGS_PARMNUM = 10 +USER_FULL_NAME_PARMNUM = 11 +USER_USR_COMMENT_PARMNUM = 12 +USER_PARMS_PARMNUM = 13 +USER_WORKSTATIONS_PARMNUM = 14 +USER_LAST_LOGON_PARMNUM = 15 +USER_LAST_LOGOFF_PARMNUM = 16 +USER_ACCT_EXPIRES_PARMNUM = 17 +USER_MAX_STORAGE_PARMNUM = 18 +USER_UNITS_PER_WEEK_PARMNUM = 19 +USER_LOGON_HOURS_PARMNUM = 20 +USER_PAD_PW_COUNT_PARMNUM = 21 +USER_NUM_LOGONS_PARMNUM = 22 +USER_LOGON_SERVER_PARMNUM = 23 +USER_COUNTRY_CODE_PARMNUM = 24 +USER_CODE_PAGE_PARMNUM = 25 +USER_PRIMARY_GROUP_PARMNUM = 51 +USER_PROFILE = 52 +USER_PROFILE_PARMNUM = 52 +USER_HOME_DIR_DRIVE_PARMNUM = 53 +USER_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_NAME_PARMNUM +USER_PASSWORD_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PASSWORD_PARMNUM +USER_PASSWORD_AGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PASSWORD_AGE_PARMNUM +USER_PRIV_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PRIV_PARMNUM +USER_HOME_DIR_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_HOME_DIR_PARMNUM +USER_COMMENT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_COMMENT_PARMNUM +USER_FLAGS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_FLAGS_PARMNUM +USER_SCRIPT_PATH_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_SCRIPT_PATH_PARMNUM +USER_AUTH_FLAGS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_AUTH_FLAGS_PARMNUM +USER_FULL_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_FULL_NAME_PARMNUM +USER_USR_COMMENT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_USR_COMMENT_PARMNUM +USER_PARMS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PARMS_PARMNUM +USER_WORKSTATIONS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_WORKSTATIONS_PARMNUM +USER_LAST_LOGON_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_LAST_LOGON_PARMNUM +USER_LAST_LOGOFF_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_LAST_LOGOFF_PARMNUM +USER_ACCT_EXPIRES_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_ACCT_EXPIRES_PARMNUM +USER_MAX_STORAGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_MAX_STORAGE_PARMNUM +USER_UNITS_PER_WEEK_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_UNITS_PER_WEEK_PARMNUM +USER_LOGON_HOURS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_LOGON_HOURS_PARMNUM +USER_PAD_PW_COUNT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PAD_PW_COUNT_PARMNUM +USER_NUM_LOGONS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_NUM_LOGONS_PARMNUM +USER_LOGON_SERVER_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_LOGON_SERVER_PARMNUM +USER_COUNTRY_CODE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_COUNTRY_CODE_PARMNUM +USER_CODE_PAGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_CODE_PAGE_PARMNUM +USER_PRIMARY_GROUP_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PRIMARY_GROUP_PARMNUM +USER_HOME_DIR_DRIVE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_HOME_DIR_DRIVE_PARMNUM +NULL_USERSETINFO_PASSWD = " " +UNITS_PER_DAY = 24 +UNITS_PER_WEEK = UNITS_PER_DAY * 7 +USER_PRIV_MASK = 3 +USER_PRIV_GUEST = 0 +USER_PRIV_USER = 1 +USER_PRIV_ADMIN = 2 +MAX_PASSWD_LEN = PWLEN +DEF_MIN_PWLEN = 6 +DEF_PWUNIQUENESS = 5 +DEF_MAX_PWHIST = 8 +DEF_MAX_BADPW = 0 +VALIDATED_LOGON = 0 +PASSWORD_EXPIRED = 2 +NON_VALIDATED_LOGON = 3 +VALID_LOGOFF = 1 +MODALS_MIN_PASSWD_LEN_PARMNUM = 1 +MODALS_MAX_PASSWD_AGE_PARMNUM = 2 +MODALS_MIN_PASSWD_AGE_PARMNUM = 3 +MODALS_FORCE_LOGOFF_PARMNUM = 4 +MODALS_PASSWD_HIST_LEN_PARMNUM = 5 +MODALS_ROLE_PARMNUM = 6 +MODALS_PRIMARY_PARMNUM = 7 +MODALS_DOMAIN_NAME_PARMNUM = 8 +MODALS_DOMAIN_ID_PARMNUM = 9 +MODALS_LOCKOUT_DURATION_PARMNUM = 10 +MODALS_LOCKOUT_OBSERVATION_WINDOW_PARMNUM = 11 +MODALS_LOCKOUT_THRESHOLD_PARMNUM = 12 +MODALS_MIN_PASSWD_LEN_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_MIN_PASSWD_LEN_PARMNUM +MODALS_MAX_PASSWD_AGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_MAX_PASSWD_AGE_PARMNUM +MODALS_MIN_PASSWD_AGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_MIN_PASSWD_AGE_PARMNUM +MODALS_FORCE_LOGOFF_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_FORCE_LOGOFF_PARMNUM +MODALS_PASSWD_HIST_LEN_INFOLEVEL = ( + PARMNUM_BASE_INFOLEVEL + MODALS_PASSWD_HIST_LEN_PARMNUM +) +MODALS_ROLE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_ROLE_PARMNUM +MODALS_PRIMARY_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_PRIMARY_PARMNUM +MODALS_DOMAIN_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_DOMAIN_NAME_PARMNUM +MODALS_DOMAIN_ID_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_DOMAIN_ID_PARMNUM +GROUPIDMASK = 32768 +GROUP_ALL_PARMNUM = 0 +GROUP_NAME_PARMNUM = 1 +GROUP_COMMENT_PARMNUM = 2 +GROUP_ATTRIBUTES_PARMNUM = 3 +GROUP_ALL_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + GROUP_ALL_PARMNUM +GROUP_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + GROUP_NAME_PARMNUM +GROUP_COMMENT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + GROUP_COMMENT_PARMNUM +GROUP_ATTRIBUTES_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + GROUP_ATTRIBUTES_PARMNUM +LOCALGROUP_NAME_PARMNUM = 1 +LOCALGROUP_COMMENT_PARMNUM = 2 +MAXPERMENTRIES = 64 +ACCESS_NONE = 0 +ACCESS_READ = 1 +ACCESS_WRITE = 2 +ACCESS_CREATE = 4 +ACCESS_EXEC = 8 +ACCESS_DELETE = 16 +ACCESS_ATRIB = 32 +ACCESS_PERM = 64 +ACCESS_GROUP = 32768 +ACCESS_AUDIT = 1 +ACCESS_SUCCESS_OPEN = 16 +ACCESS_SUCCESS_WRITE = 32 +ACCESS_SUCCESS_DELETE = 64 +ACCESS_SUCCESS_ACL = 128 +ACCESS_SUCCESS_MASK = 240 +ACCESS_FAIL_OPEN = 256 +ACCESS_FAIL_WRITE = 512 +ACCESS_FAIL_DELETE = 1024 +ACCESS_FAIL_ACL = 2048 +ACCESS_FAIL_MASK = 3840 +ACCESS_FAIL_SHIFT = 4 +ACCESS_RESOURCE_NAME_PARMNUM = 1 +ACCESS_ATTR_PARMNUM = 2 +ACCESS_COUNT_PARMNUM = 3 +ACCESS_ACCESS_LIST_PARMNUM = 4 +ACCESS_RESOURCE_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + ACCESS_RESOURCE_NAME_PARMNUM +ACCESS_ATTR_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + ACCESS_ATTR_PARMNUM +ACCESS_COUNT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + ACCESS_COUNT_PARMNUM +ACCESS_ACCESS_LIST_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + ACCESS_ACCESS_LIST_PARMNUM +ACCESS_LETTERS = "RWCXDAP " +NETLOGON_CONTROL_QUERY = 1 +NETLOGON_CONTROL_REPLICATE = 2 +NETLOGON_CONTROL_SYNCHRONIZE = 3 +NETLOGON_CONTROL_PDC_REPLICATE = 4 +NETLOGON_CONTROL_REDISCOVER = 5 +NETLOGON_CONTROL_TC_QUERY = 6 +NETLOGON_CONTROL_TRANSPORT_NOTIFY = 7 +NETLOGON_CONTROL_FIND_USER = 8 +NETLOGON_CONTROL_UNLOAD_NETLOGON_DLL = 65531 +NETLOGON_CONTROL_BACKUP_CHANGE_LOG = 65532 +NETLOGON_CONTROL_TRUNCATE_LOG = 65533 +NETLOGON_CONTROL_SET_DBFLAG = 65534 +NETLOGON_CONTROL_BREAKPOINT = 65535 +NETLOGON_REPLICATION_NEEDED = 1 +NETLOGON_REPLICATION_IN_PROGRESS = 2 +NETLOGON_FULL_SYNC_REPLICATION = 4 +NETLOGON_REDO_NEEDED = 8 + +###################### +# Manual stuff + +TEXT = lambda x: x + +MAX_PREFERRED_LENGTH = -1 +PARM_ERROR_UNKNOWN = -1 +MESSAGE_FILENAME = TEXT("NETMSG") +OS2MSG_FILENAME = TEXT("BASE") +HELP_MSG_FILENAME = TEXT("NETH") +BACKUP_MSG_FILENAME = TEXT("BAK.MSG") +TIMEQ_FOREVER = -1 +USER_MAXSTORAGE_UNLIMITED = -1 +USER_NO_LOGOFF = -1 +DEF_MAX_PWAGE = TIMEQ_FOREVER +DEF_MIN_PWAGE = 0 +DEF_FORCE_LOGOFF = -1 +ONE_DAY = 1 * 24 * 3600 +GROUP_SPECIALGRP_USERS = "USERS" +GROUP_SPECIALGRP_ADMINS = "ADMINS" +GROUP_SPECIALGRP_GUESTS = "GUESTS" +GROUP_SPECIALGRP_LOCAL = "LOCAL" +ACCESS_ALL = ( + ACCESS_READ + | ACCESS_WRITE + | ACCESS_CREATE + | ACCESS_EXEC + | ACCESS_DELETE + | ACCESS_ATRIB + | ACCESS_PERM +) + +# From lmserver.h +SV_PLATFORM_ID_OS2 = 400 +SV_PLATFORM_ID_NT = 500 +MAJOR_VERSION_MASK = 15 +SV_TYPE_WORKSTATION = 1 +SV_TYPE_SERVER = 2 +SV_TYPE_SQLSERVER = 4 +SV_TYPE_DOMAIN_CTRL = 8 +SV_TYPE_DOMAIN_BAKCTRL = 16 +SV_TYPE_TIME_SOURCE = 32 +SV_TYPE_AFP = 64 +SV_TYPE_NOVELL = 128 +SV_TYPE_DOMAIN_MEMBER = 256 +SV_TYPE_PRINTQ_SERVER = 512 +SV_TYPE_DIALIN_SERVER = 1024 +SV_TYPE_XENIX_SERVER = 2048 +SV_TYPE_SERVER_UNIX = SV_TYPE_XENIX_SERVER +SV_TYPE_NT = 4096 +SV_TYPE_WFW = 8192 +SV_TYPE_SERVER_MFPN = 16384 +SV_TYPE_SERVER_NT = 32768 +SV_TYPE_POTENTIAL_BROWSER = 65536 +SV_TYPE_BACKUP_BROWSER = 131072 +SV_TYPE_MASTER_BROWSER = 262144 +SV_TYPE_DOMAIN_MASTER = 524288 +SV_TYPE_SERVER_OSF = 1048576 +SV_TYPE_SERVER_VMS = 2097152 +SV_TYPE_WINDOWS = 4194304 +SV_TYPE_DFS = 8388608 +SV_TYPE_CLUSTER_NT = 16777216 +SV_TYPE_DCE = 268435456 +SV_TYPE_ALTERNATE_XPORT = 536870912 +SV_TYPE_LOCAL_LIST_ONLY = 1073741824 +SV_TYPE_DOMAIN_ENUM = -2147483648 +SV_TYPE_ALL = -1 +SV_NODISC = -1 +SV_USERSECURITY = 1 +SV_SHARESECURITY = 0 +SV_HIDDEN = 1 +SV_VISIBLE = 0 +SV_PLATFORM_ID_PARMNUM = 101 +SV_NAME_PARMNUM = 102 +SV_VERSION_MAJOR_PARMNUM = 103 +SV_VERSION_MINOR_PARMNUM = 104 +SV_TYPE_PARMNUM = 105 +SV_COMMENT_PARMNUM = 5 +SV_USERS_PARMNUM = 107 +SV_DISC_PARMNUM = 10 +SV_HIDDEN_PARMNUM = 16 +SV_ANNOUNCE_PARMNUM = 17 +SV_ANNDELTA_PARMNUM = 18 +SV_USERPATH_PARMNUM = 112 +SV_ULIST_MTIME_PARMNUM = 401 +SV_GLIST_MTIME_PARMNUM = 402 +SV_ALIST_MTIME_PARMNUM = 403 +SV_ALERTS_PARMNUM = 11 +SV_SECURITY_PARMNUM = 405 +SV_NUMADMIN_PARMNUM = 406 +SV_LANMASK_PARMNUM = 407 +SV_GUESTACC_PARMNUM = 408 +SV_CHDEVQ_PARMNUM = 410 +SV_CHDEVJOBS_PARMNUM = 411 +SV_CONNECTIONS_PARMNUM = 412 +SV_SHARES_PARMNUM = 413 +SV_OPENFILES_PARMNUM = 414 +SV_SESSREQS_PARMNUM = 417 +SV_ACTIVELOCKS_PARMNUM = 419 +SV_NUMREQBUF_PARMNUM = 420 +SV_NUMBIGBUF_PARMNUM = 422 +SV_NUMFILETASKS_PARMNUM = 423 +SV_ALERTSCHED_PARMNUM = 37 +SV_ERRORALERT_PARMNUM = 38 +SV_LOGONALERT_PARMNUM = 39 +SV_ACCESSALERT_PARMNUM = 40 +SV_DISKALERT_PARMNUM = 41 +SV_NETIOALERT_PARMNUM = 42 +SV_MAXAUDITSZ_PARMNUM = 43 +SV_SRVHEURISTICS_PARMNUM = 431 +SV_SESSOPENS_PARMNUM = 501 +SV_SESSVCS_PARMNUM = 502 +SV_OPENSEARCH_PARMNUM = 503 +SV_SIZREQBUF_PARMNUM = 504 +SV_INITWORKITEMS_PARMNUM = 505 +SV_MAXWORKITEMS_PARMNUM = 506 +SV_RAWWORKITEMS_PARMNUM = 507 +SV_IRPSTACKSIZE_PARMNUM = 508 +SV_MAXRAWBUFLEN_PARMNUM = 509 +SV_SESSUSERS_PARMNUM = 510 +SV_SESSCONNS_PARMNUM = 511 +SV_MAXNONPAGEDMEMORYUSAGE_PARMNUM = 512 +SV_MAXPAGEDMEMORYUSAGE_PARMNUM = 513 +SV_ENABLESOFTCOMPAT_PARMNUM = 514 +SV_ENABLEFORCEDLOGOFF_PARMNUM = 515 +SV_TIMESOURCE_PARMNUM = 516 +SV_ACCEPTDOWNLEVELAPIS_PARMNUM = 517 +SV_LMANNOUNCE_PARMNUM = 518 +SV_DOMAIN_PARMNUM = 519 +SV_MAXCOPYREADLEN_PARMNUM = 520 +SV_MAXCOPYWRITELEN_PARMNUM = 521 +SV_MINKEEPSEARCH_PARMNUM = 522 +SV_MAXKEEPSEARCH_PARMNUM = 523 +SV_MINKEEPCOMPLSEARCH_PARMNUM = 524 +SV_MAXKEEPCOMPLSEARCH_PARMNUM = 525 +SV_THREADCOUNTADD_PARMNUM = 526 +SV_NUMBLOCKTHREADS_PARMNUM = 527 +SV_SCAVTIMEOUT_PARMNUM = 528 +SV_MINRCVQUEUE_PARMNUM = 529 +SV_MINFREEWORKITEMS_PARMNUM = 530 +SV_XACTMEMSIZE_PARMNUM = 531 +SV_THREADPRIORITY_PARMNUM = 532 +SV_MAXMPXCT_PARMNUM = 533 +SV_OPLOCKBREAKWAIT_PARMNUM = 534 +SV_OPLOCKBREAKRESPONSEWAIT_PARMNUM = 535 +SV_ENABLEOPLOCKS_PARMNUM = 536 +SV_ENABLEOPLOCKFORCECLOSE_PARMNUM = 537 +SV_ENABLEFCBOPENS_PARMNUM = 538 +SV_ENABLERAW_PARMNUM = 539 +SV_ENABLESHAREDNETDRIVES_PARMNUM = 540 +SV_MINFREECONNECTIONS_PARMNUM = 541 +SV_MAXFREECONNECTIONS_PARMNUM = 542 +SV_INITSESSTABLE_PARMNUM = 543 +SV_INITCONNTABLE_PARMNUM = 544 +SV_INITFILETABLE_PARMNUM = 545 +SV_INITSEARCHTABLE_PARMNUM = 546 +SV_ALERTSCHEDULE_PARMNUM = 547 +SV_ERRORTHRESHOLD_PARMNUM = 548 +SV_NETWORKERRORTHRESHOLD_PARMNUM = 549 +SV_DISKSPACETHRESHOLD_PARMNUM = 550 +SV_MAXLINKDELAY_PARMNUM = 552 +SV_MINLINKTHROUGHPUT_PARMNUM = 553 +SV_LINKINFOVALIDTIME_PARMNUM = 554 +SV_SCAVQOSINFOUPDATETIME_PARMNUM = 555 +SV_MAXWORKITEMIDLETIME_PARMNUM = 556 +SV_MAXRAWWORKITEMS_PARMNUM = 557 +SV_PRODUCTTYPE_PARMNUM = 560 +SV_SERVERSIZE_PARMNUM = 561 +SV_CONNECTIONLESSAUTODISC_PARMNUM = 562 +SV_SHARINGVIOLATIONRETRIES_PARMNUM = 563 +SV_SHARINGVIOLATIONDELAY_PARMNUM = 564 +SV_MAXGLOBALOPENSEARCH_PARMNUM = 565 +SV_REMOVEDUPLICATESEARCHES_PARMNUM = 566 +SV_LOCKVIOLATIONRETRIES_PARMNUM = 567 +SV_LOCKVIOLATIONOFFSET_PARMNUM = 568 +SV_LOCKVIOLATIONDELAY_PARMNUM = 569 +SV_MDLREADSWITCHOVER_PARMNUM = 570 +SV_CACHEDOPENLIMIT_PARMNUM = 571 +SV_CRITICALTHREADS_PARMNUM = 572 +SV_RESTRICTNULLSESSACCESS_PARMNUM = 573 +SV_ENABLEWFW311DIRECTIPX_PARMNUM = 574 +SV_OTHERQUEUEAFFINITY_PARMNUM = 575 +SV_QUEUESAMPLESECS_PARMNUM = 576 +SV_BALANCECOUNT_PARMNUM = 577 +SV_PREFERREDAFFINITY_PARMNUM = 578 +SV_MAXFREERFCBS_PARMNUM = 579 +SV_MAXFREEMFCBS_PARMNUM = 580 +SV_MAXFREELFCBS_PARMNUM = 581 +SV_MAXFREEPAGEDPOOLCHUNKS_PARMNUM = 582 +SV_MINPAGEDPOOLCHUNKSIZE_PARMNUM = 583 +SV_MAXPAGEDPOOLCHUNKSIZE_PARMNUM = 584 +SV_SENDSFROMPREFERREDPROCESSOR_PARMNUM = 585 +SV_MAXTHREADSPERQUEUE_PARMNUM = 586 +SV_CACHEDDIRECTORYLIMIT_PARMNUM = 587 +SV_MAXCOPYLENGTH_PARMNUM = 588 +SV_ENABLEBULKTRANSFER_PARMNUM = 589 +SV_ENABLECOMPRESSION_PARMNUM = 590 +SV_AUTOSHAREWKS_PARMNUM = 591 +SV_AUTOSHARESERVER_PARMNUM = 592 +SV_ENABLESECURITYSIGNATURE_PARMNUM = 593 +SV_REQUIRESECURITYSIGNATURE_PARMNUM = 594 +SV_MINCLIENTBUFFERSIZE_PARMNUM = 595 +SV_CONNECTIONNOSESSIONSTIMEOUT_PARMNUM = 596 +SVI1_NUM_ELEMENTS = 5 +SVI2_NUM_ELEMENTS = 40 +SVI3_NUM_ELEMENTS = 44 +SW_AUTOPROF_LOAD_MASK = 1 +SW_AUTOPROF_SAVE_MASK = 2 +SV_MAX_SRV_HEUR_LEN = 32 +SV_USERS_PER_LICENSE = 5 +SVTI2_REMAP_PIPE_NAMES = 2 + +# Generated by h2py from lmshare.h +SHARE_NETNAME_PARMNUM = 1 +SHARE_TYPE_PARMNUM = 3 +SHARE_REMARK_PARMNUM = 4 +SHARE_PERMISSIONS_PARMNUM = 5 +SHARE_MAX_USES_PARMNUM = 6 +SHARE_CURRENT_USES_PARMNUM = 7 +SHARE_PATH_PARMNUM = 8 +SHARE_PASSWD_PARMNUM = 9 +SHARE_FILE_SD_PARMNUM = 501 +SHI1_NUM_ELEMENTS = 4 +SHI2_NUM_ELEMENTS = 10 +STYPE_DISKTREE = 0 +STYPE_PRINTQ = 1 +STYPE_DEVICE = 2 +STYPE_IPC = 3 +STYPE_SPECIAL = -2147483648 +SHI1005_FLAGS_DFS = 1 +SHI1005_FLAGS_DFS_ROOT = 2 +COW_PERMACHINE = 4 +COW_PERUSER = 8 +CSC_CACHEABLE = 16 +CSC_NOFLOWOPS = 32 +CSC_AUTO_INWARD = 64 +CSC_AUTO_OUTWARD = 128 +SHI1005_VALID_FLAGS_SET = ( + CSC_CACHEABLE + | CSC_NOFLOWOPS + | CSC_AUTO_INWARD + | CSC_AUTO_OUTWARD + | COW_PERMACHINE + | COW_PERUSER +) +SHI1007_VALID_FLAGS_SET = SHI1005_VALID_FLAGS_SET +SESS_GUEST = 1 +SESS_NOENCRYPTION = 2 +SESI1_NUM_ELEMENTS = 8 +SESI2_NUM_ELEMENTS = 9 +PERM_FILE_READ = 1 +PERM_FILE_WRITE = 2 +PERM_FILE_CREATE = 4 + +# Generated by h2py from d:\mssdk\include\winnetwk.h +WNNC_NET_MSNET = 65536 +WNNC_NET_LANMAN = 131072 +WNNC_NET_NETWARE = 196608 +WNNC_NET_VINES = 262144 +WNNC_NET_10NET = 327680 +WNNC_NET_LOCUS = 393216 +WNNC_NET_SUN_PC_NFS = 458752 +WNNC_NET_LANSTEP = 524288 +WNNC_NET_9TILES = 589824 +WNNC_NET_LANTASTIC = 655360 +WNNC_NET_AS400 = 720896 +WNNC_NET_FTP_NFS = 786432 +WNNC_NET_PATHWORKS = 851968 +WNNC_NET_LIFENET = 917504 +WNNC_NET_POWERLAN = 983040 +WNNC_NET_BWNFS = 1048576 +WNNC_NET_COGENT = 1114112 +WNNC_NET_FARALLON = 1179648 +WNNC_NET_APPLETALK = 1245184 +WNNC_NET_INTERGRAPH = 1310720 +WNNC_NET_SYMFONET = 1376256 +WNNC_NET_CLEARCASE = 1441792 +WNNC_NET_FRONTIER = 1507328 +WNNC_NET_BMC = 1572864 +WNNC_NET_DCE = 1638400 +WNNC_NET_DECORB = 2097152 +WNNC_NET_PROTSTOR = 2162688 +WNNC_NET_FJ_REDIR = 2228224 +WNNC_NET_DISTINCT = 2293760 +WNNC_NET_TWINS = 2359296 +WNNC_NET_RDR2SAMPLE = 2424832 +RESOURCE_CONNECTED = 1 +RESOURCE_GLOBALNET = 2 +RESOURCE_REMEMBERED = 3 +RESOURCE_RECENT = 4 +RESOURCE_CONTEXT = 5 +RESOURCETYPE_ANY = 0 +RESOURCETYPE_DISK = 1 +RESOURCETYPE_PRINT = 2 +RESOURCETYPE_RESERVED = 8 +RESOURCETYPE_UNKNOWN = -1 +RESOURCEUSAGE_CONNECTABLE = 1 +RESOURCEUSAGE_CONTAINER = 2 +RESOURCEUSAGE_NOLOCALDEVICE = 4 +RESOURCEUSAGE_SIBLING = 8 +RESOURCEUSAGE_ATTACHED = 16 +RESOURCEUSAGE_ALL = ( + RESOURCEUSAGE_CONNECTABLE | RESOURCEUSAGE_CONTAINER | RESOURCEUSAGE_ATTACHED +) +RESOURCEUSAGE_RESERVED = -2147483648 +RESOURCEDISPLAYTYPE_GENERIC = 0 +RESOURCEDISPLAYTYPE_DOMAIN = 1 +RESOURCEDISPLAYTYPE_SERVER = 2 +RESOURCEDISPLAYTYPE_SHARE = 3 +RESOURCEDISPLAYTYPE_FILE = 4 +RESOURCEDISPLAYTYPE_GROUP = 5 +RESOURCEDISPLAYTYPE_NETWORK = 6 +RESOURCEDISPLAYTYPE_ROOT = 7 +RESOURCEDISPLAYTYPE_SHAREADMIN = 8 +RESOURCEDISPLAYTYPE_DIRECTORY = 9 +RESOURCEDISPLAYTYPE_TREE = 10 +RESOURCEDISPLAYTYPE_NDSCONTAINER = 11 +NETPROPERTY_PERSISTENT = 1 +CONNECT_UPDATE_PROFILE = 1 +CONNECT_UPDATE_RECENT = 2 +CONNECT_TEMPORARY = 4 +CONNECT_INTERACTIVE = 8 +CONNECT_PROMPT = 16 +CONNECT_NEED_DRIVE = 32 +CONNECT_REFCOUNT = 64 +CONNECT_REDIRECT = 128 +CONNECT_LOCALDRIVE = 256 +CONNECT_CURRENT_MEDIA = 512 +CONNECT_DEFERRED = 1024 +CONNECT_RESERVED = -16777216 +CONNDLG_RO_PATH = 1 +CONNDLG_CONN_POINT = 2 +CONNDLG_USE_MRU = 4 +CONNDLG_HIDE_BOX = 8 +CONNDLG_PERSIST = 16 +CONNDLG_NOT_PERSIST = 32 +DISC_UPDATE_PROFILE = 1 +DISC_NO_FORCE = 64 +UNIVERSAL_NAME_INFO_LEVEL = 1 +REMOTE_NAME_INFO_LEVEL = 2 +WNFMT_MULTILINE = 1 +WNFMT_ABBREVIATED = 2 +WNFMT_INENUM = 16 +WNFMT_CONNECTION = 32 +NETINFO_DLL16 = 1 +NETINFO_DISKRED = 4 +NETINFO_PRINTERRED = 8 +RP_LOGON = 1 +RP_INIFILE = 2 +PP_DISPLAYERRORS = 1 +WNCON_FORNETCARD = 1 +WNCON_NOTROUTED = 2 +WNCON_SLOWLINK = 4 +WNCON_DYNAMIC = 8 + +## NETSETUP_NAME_TYPE, used with NetValidateName +NetSetupUnknown = 0 +NetSetupMachine = 1 +NetSetupWorkgroup = 2 +NetSetupDomain = 3 +NetSetupNonExistentDomain = 4 +NetSetupDnsMachine = 5 + +## NETSETUP_JOIN_STATUS, use with NetGetJoinInformation +NetSetupUnknownStatus = 0 +NetSetupUnjoined = 1 +NetSetupWorkgroupName = 2 +NetSetupDomainName = 3 + +NetValidateAuthentication = 1 +NetValidatePasswordChange = 2 +NetValidatePasswordReset = 3 diff --git a/lib/win32/lib/win32pdhquery.py b/lib/win32/lib/win32pdhquery.py new file mode 100644 index 00000000..a48db08a --- /dev/null +++ b/lib/win32/lib/win32pdhquery.py @@ -0,0 +1,571 @@ +""" +Performance Data Helper (PDH) Query Classes + +Wrapper classes for end-users and high-level access to the PDH query +mechanisms. PDH is a win32-specific mechanism for accessing the +performance data made available by the system. The Python for Windows +PDH module does not implement the "Registry" interface, implementing +the more straightforward Query-based mechanism. + +The basic idea of a PDH Query is an object which can query the system +about the status of any number of "counters." The counters are paths +to a particular piece of performance data. For instance, the path +'\\Memory\\Available Bytes' describes just about exactly what it says +it does, the amount of free memory on the default computer expressed +in Bytes. These paths can be considerably more complex than this, +but part of the point of this wrapper module is to hide that +complexity from the end-user/programmer. + +EXAMPLE: A more complex Path + '\\\\RAISTLIN\\PhysicalDisk(_Total)\\Avg. Disk Bytes/Read' + Raistlin --> Computer Name + PhysicalDisk --> Object Name + _Total --> The particular Instance (in this case, all instances, i.e. all drives) + Avg. Disk Bytes/Read --> The piece of data being monitored. + +EXAMPLE: Collecting Data with a Query + As an example, the following code implements a logger which allows the + user to choose what counters they would like to log, and logs those + counters for 30 seconds, at two-second intervals. + + query = Query() + query.addcounterbybrowsing() + query.collectdatafor(30,2) + + The data is now stored in a list of lists as: + query.curresults + + The counters(paths) which were used to collect the data are: + query.curpaths + + You can use the win32pdh.ParseCounterPath(path) utility function + to turn the paths into more easily read values for your task, or + write the data to a file, or do whatever you want with it. + +OTHER NOTABLE METHODS: + query.collectdatawhile(period) # start a logging thread for collecting data + query.collectdatawhile_stop() # signal the logging thread to stop logging + query.collectdata() # run the query only once + query.addperfcounter(object, counter, machine=None) # add a standard performance counter + query.addinstcounter(object, counter,machine=None,objtype = 'Process',volatile=1,format = win32pdh.PDH_FMT_LONG) # add a possibly volatile counter + +### Known bugs and limitations ### +Due to a problem with threading under the PythonWin interpreter, there +will be no data logged if the PythonWin window is not the foreground +application. Workaround: scripts using threading should be run in the +python.exe interpreter. + +The volatile-counter handlers are possibly buggy, they haven't been +tested to any extent. The wrapper Query makes it safe to pass invalid +paths (a -1 will be returned, or the Query will be totally ignored, +depending on the missing element), so you should be able to work around +the error by including all possible paths and filtering out the -1's. + +There is no way I know of to stop a thread which is currently sleeping, +so you have to wait until the thread in collectdatawhile is activated +again. This might become a problem in situations where the collection +period is multiple minutes (or hours, or whatever). + +Should make the win32pdh.ParseCounter function available to the Query +classes as a method or something similar, so that it can be accessed +by programmes that have just picked up an instance from somewhere. + +Should explicitly mention where QueryErrors can be raised, and create a +full test set to see if there are any uncaught win32api.error's still +hanging around. + +When using the python.exe interpreter, the addcounterbybrowsing- +generated browser window is often hidden behind other windows. No known +workaround other than Alt-tabing to reach the browser window. + +### Other References ### +The win32pdhutil module (which should be in the %pythonroot%/win32/lib +directory) provides quick-and-dirty utilities for one-off access to +variables from the PDH. Almost everything in that module can be done +with a Query object, but it provides task-oriented functions for a +number of common one-off tasks. + +If you can access the MS Developers Network Library, you can find +information about the PDH API as MS describes it. For a background article, +try: +http://msdn.microsoft.com/library/en-us/dnperfmo/html/msdn_pdhlib.asp + +The reference guide for the PDH API was last spotted at: +http://msdn.microsoft.com/library/en-us/perfmon/base/using_the_pdh_interface.asp + + +In general the Python version of the API is just a wrapper around the +Query-based version of this API (as far as I can see), so you can learn what +you need to from there. From what I understand, the MSDN Online +resources are available for the price of signing up for them. I can't +guarantee how long that's supposed to last. (Or anything for that +matter). +http://premium.microsoft.com/isapi/devonly/prodinfo/msdnprod/msdnlib.idc?theURL=/msdn/library/sdkdoc/perfdata_4982.htm + +The eventual plan is for my (Mike Fletcher's) Starship account to include +a section on NT Administration, and the Query is the first project +in this plan. There should be an article describing the creation of +a simple logger there, but the example above is 90% of the work of +that project, so don't sweat it if you don't find anything there. +(currently the account hasn't been set up). +http://starship.skyport.net/crew/mcfletch/ + +If you need to contact me immediately, (why I can't imagine), you can +email me at mcfletch@golden.net, or just post your question to the +Python newsgroup with a catchy subject line. +news:comp.lang.python + +### Other Stuff ### +The Query classes are by Mike Fletcher, with the working code +being corruptions of Mark Hammonds win32pdhutil module. + +Use at your own risk, no warranties, no guarantees, no assurances, +if you use it, you accept the risk of using it, etceteras. + +""" +# Feb 12, 98 - MH added "rawaddcounter" so caller can get exception details. + +import _thread +import copy +import time + +import win32api +import win32pdh + + +class BaseQuery: + """ + Provides wrapped access to the Performance Data Helper query + objects, generally you should use the child class Query + unless you have need of doing weird things :) + + This class supports two major working paradigms. In the first, + you open the query, and run it as many times as you need, closing + the query when you're done with it. This is suitable for static + queries (ones where processes being monitored don't disappear). + + In the second, you allow the query to be opened each time and + closed afterward. This causes the base query object to be + destroyed after each call. Suitable for dynamic queries (ones + which watch processes which might be closed while watching.) + """ + + def __init__(self, paths=None): + """ + The PDH Query object is initialised with a single, optional + list argument, that must be properly formatted PDH Counter + paths. Generally this list will only be provided by the class + when it is being unpickled (removed from storage). Normal + use is to call the class with no arguments and use the various + addcounter functions (particularly, for end user's, the use of + addcounterbybrowsing is the most common approach) You might + want to provide the list directly if you want to hard-code the + elements with which your query deals (and thereby avoid the + overhead of unpickling the class). + """ + self.counters = [] + if paths: + self.paths = paths + else: + self.paths = [] + self._base = None + self.active = 0 + self.curpaths = [] + + def addcounterbybrowsing( + self, flags=win32pdh.PERF_DETAIL_WIZARD, windowtitle="Python Browser" + ): + """ + Adds possibly multiple paths to the paths attribute of the query, + does this by calling the standard counter browsing dialogue. Within + this dialogue, find the counter you want to log, and click: Add, + repeat for every path you want to log, then click on close. The + paths are appended to the non-volatile paths list for this class, + subclasses may create a function which parses the paths and decides + (via heuristics) whether to add the path to the volatile or non-volatile + path list. + e.g.: + query.addcounter() + """ + win32pdh.BrowseCounters(None, 0, self.paths.append, flags, windowtitle) + + def rawaddcounter(self, object, counter, instance=None, inum=-1, machine=None): + """ + Adds a single counter path, without catching any exceptions. + + See addcounter for details. + """ + path = win32pdh.MakeCounterPath( + (machine, object, instance, None, inum, counter) + ) + self.paths.append(path) + + def addcounter(self, object, counter, instance=None, inum=-1, machine=None): + """ + Adds a single counter path to the paths attribute. Normally + this will be called by a child class' speciality functions, + rather than being called directly by the user. (Though it isn't + hard to call manually, since almost everything is given a default) + This method is only functional when the query is closed (or hasn't + yet been opened). This is to prevent conflict in multi-threaded + query applications). + e.g.: + query.addcounter('Memory','Available Bytes') + """ + if not self.active: + try: + self.rawaddcounter(object, counter, instance, inum, machine) + return 0 + except win32api.error: + return -1 + else: + return -1 + + def open(self): + """ + Build the base query object for this wrapper, + then add all of the counters required for the query. + Raise a QueryError if we can't complete the functions. + If we are already open, then do nothing. + """ + if not self.active: # to prevent having multiple open queries + # curpaths are made accessible here because of the possibility of volatile paths + # which may be dynamically altered by subclasses. + self.curpaths = copy.copy(self.paths) + try: + base = win32pdh.OpenQuery() + for path in self.paths: + try: + self.counters.append(win32pdh.AddCounter(base, path)) + except win32api.error: # we passed a bad path + self.counters.append(0) + pass + self._base = base + self.active = 1 + return 0 # open succeeded + except: # if we encounter any errors, kill the Query + try: + self.killbase(base) + except NameError: # failed in creating query + pass + self.active = 0 + self.curpaths = [] + raise QueryError(self) + return 1 # already open + + def killbase(self, base=None): + """ + ### This is not a public method + Mission critical function to kill the win32pdh objects held + by this object. User's should generally use the close method + instead of this method, in case a sub-class has overridden + close to provide some special functionality. + """ + # Kill Pythonic references to the objects in this object's namespace + self._base = None + counters = self.counters + self.counters = [] + # we don't kill the curpaths for convenience, this allows the + # user to close a query and still access the last paths + self.active = 0 + # Now call the delete functions on all of the objects + try: + map(win32pdh.RemoveCounter, counters) + except: + pass + try: + win32pdh.CloseQuery(base) + except: + pass + del counters + del base + + def close(self): + """ + Makes certain that the underlying query object has been closed, + and that all counters have been removed from it. This is + important for reference counting. + You should only need to call close if you have previously called + open. The collectdata methods all can handle opening and + closing the query. Calling close multiple times is acceptable. + """ + try: + self.killbase(self._base) + except AttributeError: + self.killbase() + + __del__ = close + + def collectdata(self, format=win32pdh.PDH_FMT_LONG): + """ + Returns the formatted current values for the Query + """ + if self._base: # we are currently open, don't change this + return self.collectdataslave(format) + else: # need to open and then close the _base, should be used by one-offs and elements tracking application instances + self.open() # will raise QueryError if couldn't open the query + temp = self.collectdataslave(format) + self.close() # will always close + return temp + + def collectdataslave(self, format=win32pdh.PDH_FMT_LONG): + """ + ### Not a public method + Called only when the Query is known to be open, runs over + the whole set of counters, appending results to the temp, + returns the values as a list. + """ + try: + win32pdh.CollectQueryData(self._base) + temp = [] + for counter in self.counters: + ok = 0 + try: + if counter: + temp.append( + win32pdh.GetFormattedCounterValue(counter, format)[1] + ) + ok = 1 + except win32api.error: + pass + if not ok: + temp.append(-1) # a better way to signal failure??? + return temp + except ( + win32api.error + ): # will happen if, for instance, no counters are part of the query and we attempt to collect data for it. + return [-1] * len(self.counters) + + # pickle functions + def __getinitargs__(self): + """ + ### Not a public method + """ + return (self.paths,) + + +class Query(BaseQuery): + """ + Performance Data Helper(PDH) Query object: + + Provides a wrapper around the native PDH query object which + allows for query reuse, query storage, and general maintenance + functions (adding counter paths in various ways being the most + obvious ones). + """ + + def __init__(self, *args, **namedargs): + """ + The PDH Query object is initialised with a single, optional + list argument, that must be properly formatted PDH Counter + paths. Generally this list will only be provided by the class + when it is being unpickled (removed from storage). Normal + use is to call the class with no arguments and use the various + addcounter functions (particularly, for end user's, the use of + addcounterbybrowsing is the most common approach) You might + want to provide the list directly if you want to hard-code the + elements with which your query deals (and thereby avoid the + overhead of unpickling the class). + """ + self.volatilecounters = [] + BaseQuery.__init__(*(self,) + args, **namedargs) + + def addperfcounter(self, object, counter, machine=None): + """ + A "Performance Counter" is a stable, known, common counter, + such as Memory, or Processor. The use of addperfcounter by + end-users is deprecated, since the use of + addcounterbybrowsing is considerably more flexible and general. + It is provided here to allow the easy development of scripts + which need to access variables so common we know them by name + (such as Memory|Available Bytes), and to provide symmetry with + the add inst counter method. + usage: + query.addperfcounter('Memory', 'Available Bytes') + It is just as easy to access addcounter directly, the following + has an identicle effect. + query.addcounter('Memory', 'Available Bytes') + """ + BaseQuery.addcounter(self, object=object, counter=counter, machine=machine) + + def addinstcounter( + self, + object, + counter, + machine=None, + objtype="Process", + volatile=1, + format=win32pdh.PDH_FMT_LONG, + ): + """ + The purpose of using an instcounter is to track particular + instances of a counter object (e.g. a single processor, a single + running copy of a process). For instance, to track all python.exe + instances, you would need merely to ask: + query.addinstcounter('python','Virtual Bytes') + You can find the names of the objects and their available counters + by doing an addcounterbybrowsing() call on a query object (or by + looking in performance monitor's add dialog.) + + Beyond merely rearranging the call arguments to make more sense, + if the volatile flag is true, the instcounters also recalculate + the paths of the available instances on every call to open the + query. + """ + if volatile: + self.volatilecounters.append((object, counter, machine, objtype, format)) + else: + self.paths[len(self.paths) :] = self.getinstpaths( + object, counter, machine, objtype, format + ) + + def getinstpaths( + self, + object, + counter, + machine=None, + objtype="Process", + format=win32pdh.PDH_FMT_LONG, + ): + """ + ### Not an end-user function + Calculate the paths for an instance object. Should alter + to allow processing for lists of object-counter pairs. + """ + items, instances = win32pdh.EnumObjectItems(None, None, objtype, -1) + # find out how many instances of this element we have... + instances.sort() + try: + cur = instances.index(object) + except ValueError: + return [] # no instances of this object + temp = [object] + try: + while instances[cur + 1] == object: + temp.append(object) + cur = cur + 1 + except IndexError: # if we went over the end + pass + paths = [] + for ind in range(len(temp)): + # can this raise an error? + paths.append( + win32pdh.MakeCounterPath( + (machine, "Process", object, None, ind, counter) + ) + ) + return paths # should also return the number of elements for naming purposes + + def open(self, *args, **namedargs): + """ + Explicitly open a query: + When you are needing to make multiple calls to the same query, + it is most efficient to open the query, run all of the calls, + then close the query, instead of having the collectdata method + automatically open and close the query each time it runs. + There are currently no arguments to open. + """ + # do all the normal opening stuff, self._base is now the query object + BaseQuery.open(*(self,) + args, **namedargs) + # should rewrite getinstpaths to take a single tuple + paths = [] + for tup in self.volatilecounters: + paths[len(paths) :] = self.getinstpaths(*tup) + for path in paths: + try: + self.counters.append(win32pdh.AddCounter(self._base, path)) + self.curpaths.append( + path + ) # if we fail on the line above, this path won't be in the table or the counters + except win32api.error: + pass # again, what to do with a malformed path??? + + def collectdatafor(self, totalperiod, period=1): + """ + Non-threaded collection of performance data: + This method allows you to specify the total period for which you would + like to run the Query, and the time interval between individual + runs. The collected data is stored in query.curresults at the + _end_ of the run. The pathnames for the query are stored in + query.curpaths. + e.g.: + query.collectdatafor(30,2) + Will collect data for 30seconds at 2 second intervals + """ + tempresults = [] + try: + self.open() + for ind in range(totalperiod / period): + tempresults.append(self.collectdata()) + time.sleep(period) + self.curresults = tempresults + finally: + self.close() + + def collectdatawhile(self, period=1): + """ + Threaded collection of performance data: + This method sets up a simple semaphor system for signalling + when you would like to start and stop a threaded data collection + method. The collection runs every period seconds until the + semaphor attribute is set to a non-true value (which normally + should be done by calling query.collectdatawhile_stop() .) + e.g.: + query.collectdatawhile(2) + # starts the query running, returns control to the caller immediately + # is collecting data every two seconds. + # do whatever you want to do while the thread runs, then call: + query.collectdatawhile_stop() + # when you want to deal with the data. It is generally a good idea + # to sleep for period seconds yourself, since the query will not copy + # the required data until the next iteration: + time.sleep(2) + # now you can access the data from the attributes of the query + query.curresults + query.curpaths + """ + self.collectdatawhile_active = 1 + _thread.start_new_thread(self.collectdatawhile_slave, (period,)) + + def collectdatawhile_stop(self): + """ + Signals the collectdatawhile slave thread to stop collecting data + on the next logging iteration. + """ + self.collectdatawhile_active = 0 + + def collectdatawhile_slave(self, period): + """ + ### Not a public function + Does the threaded work of collecting the data and storing it + in an attribute of the class. + """ + tempresults = [] + try: + self.open() # also sets active, so can't be changed. + while self.collectdatawhile_active: + tempresults.append(self.collectdata()) + time.sleep(period) + self.curresults = tempresults + finally: + self.close() + + # pickle functions + def __getinitargs__(self): + return (self.paths,) + + def __getstate__(self): + return self.volatilecounters + + def __setstate__(self, volatilecounters): + self.volatilecounters = volatilecounters + + +class QueryError: + def __init__(self, query): + self.query = query + + def __repr__(self): + return "" % repr(self.query) + + __str__ = __repr__ diff --git a/lib/win32/lib/win32pdhutil.py b/lib/win32/lib/win32pdhutil.py new file mode 100644 index 00000000..7795dd90 --- /dev/null +++ b/lib/win32/lib/win32pdhutil.py @@ -0,0 +1,210 @@ +"""Utilities for the win32 Performance Data Helper module + +Example: + To get a single bit of data: + >>> import win32pdhutil + >>> win32pdhutil.GetPerformanceAttributes("Memory", "Available Bytes") + 6053888 + >>> win32pdhutil.FindPerformanceAttributesByName("python", counter="Virtual Bytes") + [22278144] + + First example returns data which is not associated with any specific instance. + + The second example reads data for a specific instance - hence the list return - + it would return one result for each instance of Python running. + + In general, it can be tricky finding exactly the "name" of the data you wish to query. + Although you can use (None,None,(eg)"Memory", -1) to do this, + the easiest way is often to simply use PerfMon to find out the names. +""" + +import time + +import win32pdh + +error = win32pdh.error + +# Handle some localization issues. +# see http://support.microsoft.com/default.aspx?scid=http://support.microsoft.com:80/support/kb/articles/Q287/1/59.asp&NoWebContent=1 +# Build a map of english_counter_name: counter_id +counter_english_map = {} + + +def find_pdh_counter_localized_name(english_name, machine_name=None): + if not counter_english_map: + import win32api + import win32con + + counter_reg_value = win32api.RegQueryValueEx( + win32con.HKEY_PERFORMANCE_DATA, "Counter 009" + ) + counter_list = counter_reg_value[0] + for i in range(0, len(counter_list) - 1, 2): + try: + counter_id = int(counter_list[i]) + except ValueError: + continue + counter_english_map[counter_list[i + 1].lower()] = counter_id + return win32pdh.LookupPerfNameByIndex( + machine_name, counter_english_map[english_name.lower()] + ) + + +def GetPerformanceAttributes( + object, counter, instance=None, inum=-1, format=win32pdh.PDH_FMT_LONG, machine=None +): + # NOTE: Many counters require 2 samples to give accurate results, + # including "% Processor Time" (as by definition, at any instant, a + # thread's CPU usage is either 0 or 100). To read counters like this, + # you should copy this function, but keep the counter open, and call + # CollectQueryData() each time you need to know. + # See http://support.microsoft.com/default.aspx?scid=kb;EN-US;q262938 + # and http://msdn.microsoft.com/library/en-us/dnperfmo/html/perfmonpt2.asp + # My older explanation for this was that the "AddCounter" process forced + # the CPU to 100%, but the above makes more sense :) + path = win32pdh.MakeCounterPath((machine, object, instance, None, inum, counter)) + hq = win32pdh.OpenQuery() + try: + hc = win32pdh.AddCounter(hq, path) + try: + win32pdh.CollectQueryData(hq) + type, val = win32pdh.GetFormattedCounterValue(hc, format) + return val + finally: + win32pdh.RemoveCounter(hc) + finally: + win32pdh.CloseQuery(hq) + + +def FindPerformanceAttributesByName( + instanceName, + object=None, + counter=None, + format=win32pdh.PDH_FMT_LONG, + machine=None, + bRefresh=0, +): + """Find performance attributes by (case insensitive) instance name. + + Given a process name, return a list with the requested attributes. + Most useful for returning a tuple of PIDs given a process name. + """ + if object is None: + object = find_pdh_counter_localized_name("Process", machine) + if counter is None: + counter = find_pdh_counter_localized_name("ID Process", machine) + if bRefresh: # PDH docs say this is how you do a refresh. + win32pdh.EnumObjects(None, machine, 0, 1) + instanceName = instanceName.lower() + items, instances = win32pdh.EnumObjectItems(None, None, object, -1) + # Track multiple instances. + instance_dict = {} + for instance in instances: + try: + instance_dict[instance] = instance_dict[instance] + 1 + except KeyError: + instance_dict[instance] = 0 + + ret = [] + for instance, max_instances in instance_dict.items(): + for inum in range(max_instances + 1): + if instance.lower() == instanceName: + ret.append( + GetPerformanceAttributes( + object, counter, instance, inum, format, machine + ) + ) + return ret + + +def ShowAllProcesses(): + object = find_pdh_counter_localized_name("Process") + items, instances = win32pdh.EnumObjectItems( + None, None, object, win32pdh.PERF_DETAIL_WIZARD + ) + # Need to track multiple instances of the same name. + instance_dict = {} + for instance in instances: + try: + instance_dict[instance] = instance_dict[instance] + 1 + except KeyError: + instance_dict[instance] = 0 + + # Bit of a hack to get useful info. + items = [find_pdh_counter_localized_name("ID Process")] + items[:5] + print("Process Name", ",".join(items)) + for instance, max_instances in instance_dict.items(): + for inum in range(max_instances + 1): + hq = win32pdh.OpenQuery() + hcs = [] + for item in items: + path = win32pdh.MakeCounterPath( + (None, object, instance, None, inum, item) + ) + hcs.append(win32pdh.AddCounter(hq, path)) + win32pdh.CollectQueryData(hq) + # as per http://support.microsoft.com/default.aspx?scid=kb;EN-US;q262938, some "%" based + # counters need two collections + time.sleep(0.01) + win32pdh.CollectQueryData(hq) + print("%-15s\t" % (instance[:15]), end=" ") + for hc in hcs: + type, val = win32pdh.GetFormattedCounterValue(hc, win32pdh.PDH_FMT_LONG) + print("%5d" % (val), end=" ") + win32pdh.RemoveCounter(hc) + print() + win32pdh.CloseQuery(hq) + + +# NOTE: This BrowseCallback doesn't seem to work on Vista for markh. +# XXX - look at why!? +# Some counters on Vista require elevation, and callback would previously +# clear exceptions without printing them. +def BrowseCallBackDemo(counters): + ## BrowseCounters can now return multiple counter paths + for counter in counters: + ( + machine, + object, + instance, + parentInstance, + index, + counterName, + ) = win32pdh.ParseCounterPath(counter) + + result = GetPerformanceAttributes( + object, counterName, instance, index, win32pdh.PDH_FMT_DOUBLE, machine + ) + print("Value of '%s' is" % counter, result) + print( + "Added '%s' on object '%s' (machine %s), instance %s(%d)-parent of %s" + % (counterName, object, machine, instance, index, parentInstance) + ) + return 0 + + +def browse( + callback=BrowseCallBackDemo, + title="Python Browser", + level=win32pdh.PERF_DETAIL_WIZARD, +): + win32pdh.BrowseCounters(None, 0, callback, level, title, ReturnMultiple=True) + + +if __name__ == "__main__": + ShowAllProcesses() + # Show how to get a couple of attributes by name. + counter = find_pdh_counter_localized_name("Virtual Bytes") + print( + "Virtual Bytes = ", FindPerformanceAttributesByName("python", counter=counter) + ) + print( + "Available Bytes = ", + GetPerformanceAttributes( + find_pdh_counter_localized_name("Memory"), + find_pdh_counter_localized_name("Available Bytes"), + ), + ) + # And a browser. + print("Browsing for counters...") + browse() diff --git a/lib/win32/lib/win32rcparser.py b/lib/win32/lib/win32rcparser.py new file mode 100644 index 00000000..effe1429 --- /dev/null +++ b/lib/win32/lib/win32rcparser.py @@ -0,0 +1,677 @@ +# Windows dialog .RC file parser, by Adam Walker. + +# This module was adapted from the spambayes project, and is Copyright +# 2003/2004 The Python Software Foundation and is covered by the Python +# Software Foundation license. +""" +This is a parser for Windows .rc files, which are text files which define +dialogs and other Windows UI resources. +""" +__author__ = "Adam Walker" +__version__ = "0.11" + +import os +import pprint +import shlex +import stat +import sys + +import commctrl +import win32con + +_controlMap = { + "DEFPUSHBUTTON": 0x80, + "PUSHBUTTON": 0x80, + "Button": 0x80, + "GROUPBOX": 0x80, + "Static": 0x82, + "CTEXT": 0x82, + "RTEXT": 0x82, + "LTEXT": 0x82, + "LISTBOX": 0x83, + "SCROLLBAR": 0x84, + "COMBOBOX": 0x85, + "EDITTEXT": 0x81, + "ICON": 0x82, + "RICHEDIT": "RichEdit20A", +} + +# These are "default styles" for certain controls - ie, Visual Studio assumes +# the styles will be applied, and emits a "NOT {STYLE_NAME}" if it is to be +# disabled. These defaults have been determined by experimentation, so may +# not be completely accurate (most notably, some styles and/or control-types +# may be missing. +_addDefaults = { + "EDITTEXT": win32con.WS_BORDER | win32con.WS_TABSTOP, + "GROUPBOX": win32con.BS_GROUPBOX, + "LTEXT": win32con.SS_LEFT, + "DEFPUSHBUTTON": win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP, + "PUSHBUTTON": win32con.WS_TABSTOP, + "CTEXT": win32con.SS_CENTER, + "RTEXT": win32con.SS_RIGHT, + "ICON": win32con.SS_ICON, + "LISTBOX": win32con.LBS_NOTIFY, +} + +defaultControlStyle = win32con.WS_CHILD | win32con.WS_VISIBLE +defaultControlStyleEx = 0 + + +class DialogDef: + name = "" + id = 0 + style = 0 + styleEx = None + caption = "" + font = "MS Sans Serif" + fontSize = 8 + x = 0 + y = 0 + w = 0 + h = 0 + template = None + + def __init__(self, n, i): + self.name = n + self.id = i + self.styles = [] + self.stylesEx = [] + self.controls = [] + # print "dialog def for ",self.name, self.id + + def createDialogTemplate(self): + t = None + self.template = [ + [ + self.caption, + (self.x, self.y, self.w, self.h), + self.style, + self.styleEx, + (self.fontSize, self.font), + ] + ] + # Add the controls + for control in self.controls: + self.template.append(control.createDialogTemplate()) + return self.template + + +class ControlDef: + id = "" + controlType = "" + subType = "" + idNum = 0 + style = defaultControlStyle + styleEx = defaultControlStyleEx + label = "" + x = 0 + y = 0 + w = 0 + h = 0 + + def __init__(self): + self.styles = [] + self.stylesEx = [] + + def toString(self): + s = ( + "" + ) + return s + + def createDialogTemplate(self): + ct = self.controlType + if "CONTROL" == ct: + ct = self.subType + if ct in _controlMap: + ct = _controlMap[ct] + t = [ + ct, + self.label, + self.idNum, + (self.x, self.y, self.w, self.h), + self.style, + self.styleEx, + ] + # print t + return t + + +class StringDef: + def __init__(self, id, idNum, value): + self.id = id + self.idNum = idNum + self.value = value + + def __repr__(self): + return "StringDef(%r, %r, %r)" % (self.id, self.idNum, self.value) + + +class RCParser: + next_id = 1001 + dialogs = {} + _dialogs = {} + debugEnabled = False + token = "" + + def __init__(self): + self.ungot = False + self.ids = {"IDC_STATIC": -1} + self.names = {-1: "IDC_STATIC"} + self.bitmaps = {} + self.stringTable = {} + self.icons = {} + + def debug(self, *args): + if self.debugEnabled: + print(args) + + def getToken(self): + if self.ungot: + self.ungot = False + self.debug("getToken returns (ungot):", self.token) + return self.token + self.token = self.lex.get_token() + self.debug("getToken returns:", self.token) + if self.token == "": + self.token = None + return self.token + + def ungetToken(self): + self.ungot = True + + def getCheckToken(self, expected): + tok = self.getToken() + assert tok == expected, "Expected token '%s', but got token '%s'!" % ( + expected, + tok, + ) + return tok + + def getCommaToken(self): + return self.getCheckToken(",") + + # Return the *current* token as a number, only consuming a token + # if it is the negative-sign. + def currentNumberToken(self): + mult = 1 + if self.token == "-": + mult = -1 + self.getToken() + return int(self.token) * mult + + # Return the *current* token as a string literal (ie, self.token will be a + # quote. consumes all tokens until the end of the string + def currentQuotedString(self): + # Handle quoted strings - pity shlex doesn't handle it. + assert self.token.startswith('"'), self.token + bits = [self.token] + while 1: + tok = self.getToken() + if not tok.startswith('"'): + self.ungetToken() + break + bits.append(tok) + sval = "".join(bits)[1:-1] # Remove end quotes. + # Fixup quotes in the body, and all (some?) quoted characters back + # to their raw value. + for i, o in ('""', '"'), ("\\r", "\r"), ("\\n", "\n"), ("\\t", "\t"): + sval = sval.replace(i, o) + return sval + + def load(self, rcstream): + """ + RCParser.loadDialogs(rcFileName) -> None + Load the dialog information into the parser. Dialog Definations can then be accessed + using the "dialogs" dictionary member (name->DialogDef). The "ids" member contains the dictionary of id->name. + The "names" member contains the dictionary of name->id + """ + self.open(rcstream) + self.getToken() + while self.token != None: + self.parse() + self.getToken() + + def open(self, rcstream): + self.lex = shlex.shlex(rcstream) + self.lex.commenters = "//#" + + def parseH(self, file): + lex = shlex.shlex(file) + lex.commenters = "//" + token = " " + while token is not None: + token = lex.get_token() + if token == "" or token is None: + token = None + else: + if token == "define": + n = lex.get_token() + i = int(lex.get_token()) + self.ids[n] = i + if i in self.names: + # Dupe ID really isn't a problem - most consumers + # want to go from name->id, and this is OK. + # It means you can't go from id->name though. + pass + # ignore AppStudio special ones + # if not n.startswith("_APS_"): + # print "Duplicate id",i,"for",n,"is", self.names[i] + else: + self.names[i] = n + if self.next_id <= i: + self.next_id = i + 1 + + def parse(self): + noid_parsers = { + "STRINGTABLE": self.parse_stringtable, + } + + id_parsers = { + "DIALOG": self.parse_dialog, + "DIALOGEX": self.parse_dialog, + # "TEXTINCLUDE": self.parse_textinclude, + "BITMAP": self.parse_bitmap, + "ICON": self.parse_icon, + } + deep = 0 + base_token = self.token + rp = noid_parsers.get(base_token) + if rp is not None: + rp() + else: + # Not something we parse that isn't prefixed by an ID + # See if it is an ID prefixed item - if it is, our token + # is the resource ID. + resource_id = self.token + self.getToken() + if self.token is None: + return + + if "BEGIN" == self.token: + # A 'BEGIN' for a structure we don't understand - skip to the + # matching 'END' + deep = 1 + while deep != 0 and self.token is not None: + self.getToken() + self.debug("Zooming over", self.token) + if "BEGIN" == self.token: + deep += 1 + elif "END" == self.token: + deep -= 1 + else: + rp = id_parsers.get(self.token) + if rp is not None: + self.debug("Dispatching '%s'" % (self.token,)) + rp(resource_id) + else: + # We don't know what the resource type is, but we + # have already consumed the next, which can cause problems, + # so push it back. + self.debug("Skipping top-level '%s'" % base_token) + self.ungetToken() + + def addId(self, id_name): + if id_name in self.ids: + id = self.ids[id_name] + else: + # IDOK, IDCANCEL etc are special - if a real resource has this value + for n in ["IDOK", "IDCANCEL", "IDYES", "IDNO", "IDABORT"]: + if id_name == n: + v = getattr(win32con, n) + self.ids[n] = v + self.names[v] = n + return v + id = self.next_id + self.next_id += 1 + self.ids[id_name] = id + self.names[id] = id_name + return id + + def lang(self): + while ( + self.token[0:4] == "LANG" + or self.token[0:7] == "SUBLANG" + or self.token == "," + ): + self.getToken() + + def parse_textinclude(self, res_id): + while self.getToken() != "BEGIN": + pass + while 1: + if self.token == "END": + break + s = self.getToken() + + def parse_stringtable(self): + while self.getToken() != "BEGIN": + pass + while 1: + self.getToken() + if self.token == "END": + break + sid = self.token + self.getToken() + sd = StringDef(sid, self.addId(sid), self.currentQuotedString()) + self.stringTable[sid] = sd + + def parse_bitmap(self, name): + return self.parse_bitmap_or_icon(name, self.bitmaps) + + def parse_icon(self, name): + return self.parse_bitmap_or_icon(name, self.icons) + + def parse_bitmap_or_icon(self, name, dic): + self.getToken() + while not self.token.startswith('"'): + self.getToken() + bmf = self.token[1:-1] # quotes + dic[name] = bmf + + def parse_dialog(self, name): + dlg = DialogDef(name, self.addId(name)) + assert len(dlg.controls) == 0 + self._dialogs[name] = dlg + extras = [] + self.getToken() + while not self.token.isdigit(): + self.debug("extra", self.token) + extras.append(self.token) + self.getToken() + dlg.x = int(self.token) + self.getCommaToken() + self.getToken() # number + dlg.y = int(self.token) + self.getCommaToken() + self.getToken() # number + dlg.w = int(self.token) + self.getCommaToken() + self.getToken() # number + dlg.h = int(self.token) + self.getToken() + while not (self.token == None or self.token == "" or self.token == "END"): + if self.token == "STYLE": + self.dialogStyle(dlg) + elif self.token == "EXSTYLE": + self.dialogExStyle(dlg) + elif self.token == "CAPTION": + self.dialogCaption(dlg) + elif self.token == "FONT": + self.dialogFont(dlg) + elif self.token == "BEGIN": + self.controls(dlg) + else: + break + self.dialogs[name] = dlg.createDialogTemplate() + + def dialogStyle(self, dlg): + dlg.style, dlg.styles = self.styles([], win32con.DS_SETFONT) + + def dialogExStyle(self, dlg): + self.getToken() + dlg.styleEx, dlg.stylesEx = self.styles([], 0) + + def styles(self, defaults, defaultStyle): + list = defaults + style = defaultStyle + + if "STYLE" == self.token: + self.getToken() + i = 0 + Not = False + while ( + (i % 2 == 1 and ("|" == self.token or "NOT" == self.token)) or (i % 2 == 0) + ) and not self.token == None: + Not = False + if "NOT" == self.token: + Not = True + self.getToken() + i += 1 + if self.token != "|": + if self.token in win32con.__dict__: + value = getattr(win32con, self.token) + else: + if self.token in commctrl.__dict__: + value = getattr(commctrl, self.token) + else: + value = 0 + if Not: + list.append("NOT " + self.token) + self.debug("styles add Not", self.token, value) + style &= ~value + else: + list.append(self.token) + self.debug("styles add", self.token, value) + style |= value + self.getToken() + self.debug("style is ", style) + + return style, list + + def dialogCaption(self, dlg): + if "CAPTION" == self.token: + self.getToken() + self.token = self.token[1:-1] + self.debug("Caption is:", self.token) + dlg.caption = self.token + self.getToken() + + def dialogFont(self, dlg): + if "FONT" == self.token: + self.getToken() + dlg.fontSize = int(self.token) + self.getCommaToken() + self.getToken() # Font name + dlg.font = self.token[1:-1] # it's quoted + self.getToken() + while "BEGIN" != self.token: + self.getToken() + + def controls(self, dlg): + if self.token == "BEGIN": + self.getToken() + # All controls look vaguely like: + # TYPE [text, ] Control_id, l, t, r, b [, style] + # .rc parser documents all control types as: + # CHECKBOX, COMBOBOX, CONTROL, CTEXT, DEFPUSHBUTTON, EDITTEXT, GROUPBOX, + # ICON, LISTBOX, LTEXT, PUSHBUTTON, RADIOBUTTON, RTEXT, SCROLLBAR + without_text = ["EDITTEXT", "COMBOBOX", "LISTBOX", "SCROLLBAR"] + while self.token != "END": + control = ControlDef() + control.controlType = self.token + self.getToken() + if control.controlType not in without_text: + if self.token[0:1] == '"': + control.label = self.currentQuotedString() + # Some funny controls, like icons and picture controls use + # the "window text" as extra resource ID (ie, the ID of the + # icon itself). This may be either a literal, or an ID string. + elif self.token == "-" or self.token.isdigit(): + control.label = str(self.currentNumberToken()) + else: + # An ID - use the numeric equiv. + control.label = str(self.addId(self.token)) + self.getCommaToken() + self.getToken() + # Control IDs may be "names" or literal ints + if self.token == "-" or self.token.isdigit(): + control.id = self.currentNumberToken() + control.idNum = control.id + else: + # name of an ID + control.id = self.token + control.idNum = self.addId(control.id) + self.getCommaToken() + + if control.controlType == "CONTROL": + self.getToken() + control.subType = self.token[1:-1] + thisDefaultStyle = defaultControlStyle | _addDefaults.get( + control.subType, 0 + ) + # Styles + self.getCommaToken() + self.getToken() + control.style, control.styles = self.styles([], thisDefaultStyle) + else: + thisDefaultStyle = defaultControlStyle | _addDefaults.get( + control.controlType, 0 + ) + # incase no style is specified. + control.style = thisDefaultStyle + # Rect + control.x = int(self.getToken()) + self.getCommaToken() + control.y = int(self.getToken()) + self.getCommaToken() + control.w = int(self.getToken()) + self.getCommaToken() + self.getToken() + control.h = int(self.token) + self.getToken() + if self.token == ",": + self.getToken() + control.style, control.styles = self.styles([], thisDefaultStyle) + if self.token == ",": + self.getToken() + control.styleEx, control.stylesEx = self.styles( + [], defaultControlStyleEx + ) + # print control.toString() + dlg.controls.append(control) + + +def ParseStreams(rc_file, h_file): + rcp = RCParser() + if h_file: + rcp.parseH(h_file) + try: + rcp.load(rc_file) + except: + lex = getattr(rcp, "lex", None) + if lex: + print("ERROR parsing dialogs at line", lex.lineno) + print("Next 10 tokens are:") + for i in range(10): + print(lex.get_token(), end=" ") + print() + raise + return rcp + + +def Parse(rc_name, h_name=None): + if h_name: + h_file = open(h_name, "r") + else: + # See if same basename as the .rc + h_name = rc_name[:-2] + "h" + try: + h_file = open(h_name, "r") + except IOError: + # See if MSVC default of 'resource.h' in the same dir. + h_name = os.path.join(os.path.dirname(rc_name), "resource.h") + try: + h_file = open(h_name, "r") + except IOError: + # .h files are optional anyway + h_file = None + rc_file = open(rc_name, "r") + try: + return ParseStreams(rc_file, h_file) + finally: + if h_file is not None: + h_file.close() + rc_file.close() + return rcp + + +def GenerateFrozenResource(rc_name, output_name, h_name=None): + """Converts an .rc windows resource source file into a python source file + with the same basic public interface as the rest of this module. + Particularly useful for py2exe or other 'freeze' type solutions, + where a frozen .py file can be used inplace of a real .rc file. + """ + rcp = Parse(rc_name, h_name) + in_stat = os.stat(rc_name) + + out = open(output_name, "wt") + out.write("#%s\n" % output_name) + out.write("#This is a generated file. Please edit %s instead.\n" % rc_name) + out.write("__version__=%r\n" % __version__) + out.write( + "_rc_size_=%d\n_rc_mtime_=%d\n" + % (in_stat[stat.ST_SIZE], in_stat[stat.ST_MTIME]) + ) + + out.write("class StringDef:\n") + out.write("\tdef __init__(self, id, idNum, value):\n") + out.write("\t\tself.id = id\n") + out.write("\t\tself.idNum = idNum\n") + out.write("\t\tself.value = value\n") + out.write("\tdef __repr__(self):\n") + out.write( + '\t\treturn "StringDef(%r, %r, %r)" % (self.id, self.idNum, self.value)\n' + ) + + out.write("class FakeParser:\n") + + for name in "dialogs", "ids", "names", "bitmaps", "icons", "stringTable": + out.write("\t%s = \\\n" % (name,)) + pprint.pprint(getattr(rcp, name), out) + out.write("\n") + + out.write("def Parse(s):\n") + out.write("\treturn FakeParser()\n") + out.close() + + +if __name__ == "__main__": + if len(sys.argv) <= 1: + print(__doc__) + print() + print("See test_win32rcparser.py, and the win32rcparser directory (both") + print("in the test suite) for an example of this module's usage.") + else: + import pprint + + filename = sys.argv[1] + if "-v" in sys.argv: + RCParser.debugEnabled = 1 + print("Dumping all resources in '%s'" % filename) + resources = Parse(filename) + for id, ddef in resources.dialogs.items(): + print("Dialog %s (%d controls)" % (id, len(ddef))) + pprint.pprint(ddef) + print() + for id, sdef in resources.stringTable.items(): + print("String %s=%r" % (id, sdef.value)) + print() + for id, sdef in resources.bitmaps.items(): + print("Bitmap %s=%r" % (id, sdef)) + print() + for id, sdef in resources.icons.items(): + print("Icon %s=%r" % (id, sdef)) + print() diff --git a/lib/win32/lib/win32serviceutil.py b/lib/win32/lib/win32serviceutil.py new file mode 100644 index 00000000..fb187530 --- /dev/null +++ b/lib/win32/lib/win32serviceutil.py @@ -0,0 +1,1071 @@ +# General purpose service utilities, both for standard Python scripts, +# and for for Python programs which run as services... +# +# Note that most utility functions here will raise win32api.error's +# (which is win32service.error, pywintypes.error, etc) +# when things go wrong - eg, not enough permissions to hit the +# registry etc. + +import importlib +import os +import sys +import warnings + +import pywintypes +import win32api +import win32con +import win32service +import winerror + +_d = "_d" if "_d.pyd" in importlib.machinery.EXTENSION_SUFFIXES else "" +error = RuntimeError + + +# Returns the full path to an executable for hosting a Python service - typically +# 'pythonservice.exe' +# * If you pass a param and it exists as a file, you'll get the abs path back +# * Otherwise we'll use the param instead of 'pythonservice.exe', and we will +# look for it. +def LocatePythonServiceExe(exe=None): + if not exe and hasattr(sys, "frozen"): + # If py2exe etc calls this with no exe, default is current exe, + # and all setup is their problem :) + return sys.executable + + if exe and os.path.isfile(exe): + return win32api.GetFullPathName(exe) + + # We are confused if we aren't now looking for our default. But if that + # exists as specified we assume it's good. + exe = f"pythonservice{_d}.exe" + if os.path.isfile(exe): + return win32api.GetFullPathName(exe) + + # Now we are searching for the .exe + # We are going to want it here. + correct = os.path.join(sys.exec_prefix, exe) + # Even if that file already exists, we copy the one installed by pywin32 + # in-case it was upgraded. + # pywin32 installed it next to win32service.pyd (but we can't run it from there) + maybe = os.path.join(os.path.dirname(win32service.__file__), exe) + if os.path.exists(maybe): + print(f"copying host exe '{maybe}' -> '{correct}'") + win32api.CopyFile(maybe, correct) + + if not os.path.exists(correct): + raise error(f"Can't find '{correct}'") + + # If pywintypes.dll isn't next to us, or at least next to pythonXX.dll, + # there's a good chance the service will not run. That's usually copied by + # `pywin32_postinstall`, but putting it next to the python DLL seems + # reasonable. + # (Unlike the .exe above, we don't unconditionally copy this, and possibly + # copy it to a different place. Doesn't seem a good reason for that!?) + python_dll = win32api.GetModuleFileName(sys.dllhandle) + pyw = f"pywintypes{sys.version_info[0]}{sys.version_info[1]}{_d}.dll" + correct_pyw = os.path.join(os.path.dirname(python_dll), pyw) + + if not os.path.exists(correct_pyw): + print(f"copying helper dll '{pywintypes.__file__}' -> '{correct_pyw}'") + win32api.CopyFile(pywintypes.__file__, correct_pyw) + + return correct + + +def _GetServiceShortName(longName): + # looks up a services name + # from the display name + # Thanks to Andy McKay for this code. + access = ( + win32con.KEY_READ | win32con.KEY_ENUMERATE_SUB_KEYS | win32con.KEY_QUERY_VALUE + ) + hkey = win32api.RegOpenKey( + win32con.HKEY_LOCAL_MACHINE, "SYSTEM\\CurrentControlSet\\Services", 0, access + ) + num = win32api.RegQueryInfoKey(hkey)[0] + longName = longName.lower() + # loop through number of subkeys + for x in range(0, num): + # find service name, open subkey + svc = win32api.RegEnumKey(hkey, x) + skey = win32api.RegOpenKey(hkey, svc, 0, access) + try: + # find display name + thisName = str(win32api.RegQueryValueEx(skey, "DisplayName")[0]) + if thisName.lower() == longName: + return svc + except win32api.error: + # in case there is no key called DisplayName + pass + return None + + +# Open a service given either it's long or short name. +def SmartOpenService(hscm, name, access): + try: + return win32service.OpenService(hscm, name, access) + except win32api.error as details: + if details.winerror not in [ + winerror.ERROR_SERVICE_DOES_NOT_EXIST, + winerror.ERROR_INVALID_NAME, + ]: + raise + name = win32service.GetServiceKeyName(hscm, name) + return win32service.OpenService(hscm, name, access) + + +def LocateSpecificServiceExe(serviceName): + # Return the .exe name of any service. + hkey = win32api.RegOpenKey( + win32con.HKEY_LOCAL_MACHINE, + "SYSTEM\\CurrentControlSet\\Services\\%s" % (serviceName), + 0, + win32con.KEY_ALL_ACCESS, + ) + try: + return win32api.RegQueryValueEx(hkey, "ImagePath")[0] + finally: + hkey.Close() + + +def InstallPerfmonForService(serviceName, iniName, dllName=None): + # If no DLL name, look it up in the INI file name + if not dllName: # May be empty string! + dllName = win32api.GetProfileVal("Python", "dll", "", iniName) + # Still not found - look for the standard one in the same dir as win32service.pyd + if not dllName: + try: + tryName = os.path.join( + os.path.split(win32service.__file__)[0], "perfmondata.dll" + ) + if os.path.isfile(tryName): + dllName = tryName + except AttributeError: + # Frozen app? - anyway, can't find it! + pass + if not dllName: + raise ValueError("The name of the performance DLL must be available") + dllName = win32api.GetFullPathName(dllName) + # Now setup all the required "Performance" entries. + hkey = win32api.RegOpenKey( + win32con.HKEY_LOCAL_MACHINE, + "SYSTEM\\CurrentControlSet\\Services\\%s" % (serviceName), + 0, + win32con.KEY_ALL_ACCESS, + ) + try: + subKey = win32api.RegCreateKey(hkey, "Performance") + try: + win32api.RegSetValueEx(subKey, "Library", 0, win32con.REG_SZ, dllName) + win32api.RegSetValueEx( + subKey, "Open", 0, win32con.REG_SZ, "OpenPerformanceData" + ) + win32api.RegSetValueEx( + subKey, "Close", 0, win32con.REG_SZ, "ClosePerformanceData" + ) + win32api.RegSetValueEx( + subKey, "Collect", 0, win32con.REG_SZ, "CollectPerformanceData" + ) + finally: + win32api.RegCloseKey(subKey) + finally: + win32api.RegCloseKey(hkey) + # Now do the "Lodctr" thang... + + try: + import perfmon + + path, fname = os.path.split(iniName) + oldPath = os.getcwd() + if path: + os.chdir(path) + try: + perfmon.LoadPerfCounterTextStrings("python.exe " + fname) + finally: + os.chdir(oldPath) + except win32api.error as details: + print("The service was installed OK, but the performance monitor") + print("data could not be loaded.", details) + + +def _GetCommandLine(exeName, exeArgs): + if exeArgs is not None: + return exeName + " " + exeArgs + else: + return exeName + + +def InstallService( + pythonClassString, + serviceName, + displayName, + startType=None, + errorControl=None, + bRunInteractive=0, + serviceDeps=None, + userName=None, + password=None, + exeName=None, + perfMonIni=None, + perfMonDll=None, + exeArgs=None, + description=None, + delayedstart=None, +): + # Handle the default arguments. + if startType is None: + startType = win32service.SERVICE_DEMAND_START + serviceType = win32service.SERVICE_WIN32_OWN_PROCESS + if bRunInteractive: + serviceType = serviceType | win32service.SERVICE_INTERACTIVE_PROCESS + if errorControl is None: + errorControl = win32service.SERVICE_ERROR_NORMAL + + exeName = '"%s"' % LocatePythonServiceExe(exeName) + commandLine = _GetCommandLine(exeName, exeArgs) + hscm = win32service.OpenSCManager(None, None, win32service.SC_MANAGER_ALL_ACCESS) + try: + hs = win32service.CreateService( + hscm, + serviceName, + displayName, + win32service.SERVICE_ALL_ACCESS, # desired access + serviceType, # service type + startType, + errorControl, # error control type + commandLine, + None, + 0, + serviceDeps, + userName, + password, + ) + if description is not None: + try: + win32service.ChangeServiceConfig2( + hs, win32service.SERVICE_CONFIG_DESCRIPTION, description + ) + except NotImplementedError: + pass ## ChangeServiceConfig2 and description do not exist on NT + if delayedstart is not None: + try: + win32service.ChangeServiceConfig2( + hs, + win32service.SERVICE_CONFIG_DELAYED_AUTO_START_INFO, + delayedstart, + ) + except (win32service.error, NotImplementedError): + ## delayed start only exists on Vista and later - warn only when trying to set delayed to True + warnings.warn("Delayed Start not available on this system") + win32service.CloseServiceHandle(hs) + finally: + win32service.CloseServiceHandle(hscm) + InstallPythonClassString(pythonClassString, serviceName) + # If I have performance monitor info to install, do that. + if perfMonIni is not None: + InstallPerfmonForService(serviceName, perfMonIni, perfMonDll) + + +def ChangeServiceConfig( + pythonClassString, + serviceName, + startType=None, + errorControl=None, + bRunInteractive=0, + serviceDeps=None, + userName=None, + password=None, + exeName=None, + displayName=None, + perfMonIni=None, + perfMonDll=None, + exeArgs=None, + description=None, + delayedstart=None, +): + # Before doing anything, remove any perfmon counters. + try: + import perfmon + + perfmon.UnloadPerfCounterTextStrings("python.exe " + serviceName) + except (ImportError, win32api.error): + pass + + # The EXE location may have changed + exeName = '"%s"' % LocatePythonServiceExe(exeName) + + # Handle the default arguments. + if startType is None: + startType = win32service.SERVICE_NO_CHANGE + if errorControl is None: + errorControl = win32service.SERVICE_NO_CHANGE + + hscm = win32service.OpenSCManager(None, None, win32service.SC_MANAGER_ALL_ACCESS) + serviceType = win32service.SERVICE_WIN32_OWN_PROCESS + if bRunInteractive: + serviceType = serviceType | win32service.SERVICE_INTERACTIVE_PROCESS + commandLine = _GetCommandLine(exeName, exeArgs) + try: + hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_ALL_ACCESS) + try: + win32service.ChangeServiceConfig( + hs, + serviceType, # service type + startType, + errorControl, # error control type + commandLine, + None, + 0, + serviceDeps, + userName, + password, + displayName, + ) + if description is not None: + try: + win32service.ChangeServiceConfig2( + hs, win32service.SERVICE_CONFIG_DESCRIPTION, description + ) + except NotImplementedError: + pass ## ChangeServiceConfig2 and description do not exist on NT + if delayedstart is not None: + try: + win32service.ChangeServiceConfig2( + hs, + win32service.SERVICE_CONFIG_DELAYED_AUTO_START_INFO, + delayedstart, + ) + except (win32service.error, NotImplementedError): + ## Delayed start only exists on Vista and later. On Nt, will raise NotImplementedError since ChangeServiceConfig2 + ## doensn't exist. On Win2k and XP, will fail with ERROR_INVALID_LEVEL + ## Warn only if trying to set delayed to True + if delayedstart: + warnings.warn("Delayed Start not available on this system") + finally: + win32service.CloseServiceHandle(hs) + finally: + win32service.CloseServiceHandle(hscm) + InstallPythonClassString(pythonClassString, serviceName) + # If I have performance monitor info to install, do that. + if perfMonIni is not None: + InstallPerfmonForService(serviceName, perfMonIni, perfMonDll) + + +def InstallPythonClassString(pythonClassString, serviceName): + # Now setup our Python specific entries. + if pythonClassString: + key = win32api.RegCreateKey( + win32con.HKEY_LOCAL_MACHINE, + "System\\CurrentControlSet\\Services\\%s\\PythonClass" % serviceName, + ) + try: + win32api.RegSetValue(key, None, win32con.REG_SZ, pythonClassString) + finally: + win32api.RegCloseKey(key) + + +# Utility functions for Services, to allow persistant properties. +def SetServiceCustomOption(serviceName, option, value): + try: + serviceName = serviceName._svc_name_ + except AttributeError: + pass + key = win32api.RegCreateKey( + win32con.HKEY_LOCAL_MACHINE, + "System\\CurrentControlSet\\Services\\%s\\Parameters" % serviceName, + ) + try: + if type(value) == type(0): + win32api.RegSetValueEx(key, option, 0, win32con.REG_DWORD, value) + else: + win32api.RegSetValueEx(key, option, 0, win32con.REG_SZ, value) + finally: + win32api.RegCloseKey(key) + + +def GetServiceCustomOption(serviceName, option, defaultValue=None): + # First param may also be a service class/instance. + # This allows services to pass "self" + try: + serviceName = serviceName._svc_name_ + except AttributeError: + pass + key = win32api.RegCreateKey( + win32con.HKEY_LOCAL_MACHINE, + "System\\CurrentControlSet\\Services\\%s\\Parameters" % serviceName, + ) + try: + try: + return win32api.RegQueryValueEx(key, option)[0] + except win32api.error: # No value. + return defaultValue + finally: + win32api.RegCloseKey(key) + + +def RemoveService(serviceName): + try: + import perfmon + + perfmon.UnloadPerfCounterTextStrings("python.exe " + serviceName) + except (ImportError, win32api.error): + pass + + hscm = win32service.OpenSCManager(None, None, win32service.SC_MANAGER_ALL_ACCESS) + try: + hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_ALL_ACCESS) + win32service.DeleteService(hs) + win32service.CloseServiceHandle(hs) + finally: + win32service.CloseServiceHandle(hscm) + + import win32evtlogutil + + try: + win32evtlogutil.RemoveSourceFromRegistry(serviceName) + except win32api.error: + pass + + +def ControlService(serviceName, code, machine=None): + hscm = win32service.OpenSCManager(machine, None, win32service.SC_MANAGER_ALL_ACCESS) + try: + hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_ALL_ACCESS) + try: + status = win32service.ControlService(hs, code) + finally: + win32service.CloseServiceHandle(hs) + finally: + win32service.CloseServiceHandle(hscm) + return status + + +def __FindSvcDeps(findName): + if type(findName) is pywintypes.UnicodeType: + findName = str(findName) + dict = {} + k = win32api.RegOpenKey( + win32con.HKEY_LOCAL_MACHINE, "SYSTEM\\CurrentControlSet\\Services" + ) + num = 0 + while 1: + try: + svc = win32api.RegEnumKey(k, num) + except win32api.error: + break + num = num + 1 + sk = win32api.RegOpenKey(k, svc) + try: + deps, typ = win32api.RegQueryValueEx(sk, "DependOnService") + except win32api.error: + deps = () + for dep in deps: + dep = dep.lower() + dep_on = dict.get(dep, []) + dep_on.append(svc) + dict[dep] = dep_on + + return __ResolveDeps(findName, dict) + + +def __ResolveDeps(findName, dict): + items = dict.get(findName.lower(), []) + retList = [] + for svc in items: + retList.insert(0, svc) + retList = __ResolveDeps(svc, dict) + retList + return retList + + +def WaitForServiceStatus(serviceName, status, waitSecs, machine=None): + """Waits for the service to return the specified status. You + should have already requested the service to enter that state""" + for i in range(waitSecs * 4): + now_status = QueryServiceStatus(serviceName, machine)[1] + if now_status == status: + break + win32api.Sleep(250) + else: + raise pywintypes.error( + winerror.ERROR_SERVICE_REQUEST_TIMEOUT, + "QueryServiceStatus", + win32api.FormatMessage(winerror.ERROR_SERVICE_REQUEST_TIMEOUT)[:-2], + ) + + +def __StopServiceWithTimeout(hs, waitSecs=30): + try: + status = win32service.ControlService(hs, win32service.SERVICE_CONTROL_STOP) + except pywintypes.error as exc: + if exc.winerror != winerror.ERROR_SERVICE_NOT_ACTIVE: + raise + for i in range(waitSecs): + status = win32service.QueryServiceStatus(hs) + if status[1] == win32service.SERVICE_STOPPED: + break + win32api.Sleep(1000) + else: + raise pywintypes.error( + winerror.ERROR_SERVICE_REQUEST_TIMEOUT, + "ControlService", + win32api.FormatMessage(winerror.ERROR_SERVICE_REQUEST_TIMEOUT)[:-2], + ) + + +def StopServiceWithDeps(serviceName, machine=None, waitSecs=30): + # Stop a service recursively looking for dependant services + hscm = win32service.OpenSCManager(machine, None, win32service.SC_MANAGER_ALL_ACCESS) + try: + deps = __FindSvcDeps(serviceName) + for dep in deps: + hs = win32service.OpenService(hscm, dep, win32service.SERVICE_ALL_ACCESS) + try: + __StopServiceWithTimeout(hs, waitSecs) + finally: + win32service.CloseServiceHandle(hs) + # Now my service! + hs = win32service.OpenService( + hscm, serviceName, win32service.SERVICE_ALL_ACCESS + ) + try: + __StopServiceWithTimeout(hs, waitSecs) + finally: + win32service.CloseServiceHandle(hs) + + finally: + win32service.CloseServiceHandle(hscm) + + +def StopService(serviceName, machine=None): + return ControlService(serviceName, win32service.SERVICE_CONTROL_STOP, machine) + + +def StartService(serviceName, args=None, machine=None): + hscm = win32service.OpenSCManager(machine, None, win32service.SC_MANAGER_ALL_ACCESS) + try: + hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_ALL_ACCESS) + try: + win32service.StartService(hs, args) + finally: + win32service.CloseServiceHandle(hs) + finally: + win32service.CloseServiceHandle(hscm) + + +def RestartService(serviceName, args=None, waitSeconds=30, machine=None): + "Stop the service, and then start it again (with some tolerance for allowing it to stop.)" + try: + StopService(serviceName, machine) + except pywintypes.error as exc: + # Allow only "service not running" error + if exc.winerror != winerror.ERROR_SERVICE_NOT_ACTIVE: + raise + # Give it a few goes, as the service may take time to stop + for i in range(waitSeconds): + try: + StartService(serviceName, args, machine) + break + except pywintypes.error as exc: + if exc.winerror != winerror.ERROR_SERVICE_ALREADY_RUNNING: + raise + win32api.Sleep(1000) + else: + print("Gave up waiting for the old service to stop!") + + +def _DebugCtrlHandler(evt): + if evt in (win32con.CTRL_C_EVENT, win32con.CTRL_BREAK_EVENT): + assert g_debugService + print("Stopping debug service.") + g_debugService.SvcStop() + return True + return False + + +def DebugService(cls, argv=[]): + # Run a service in "debug" mode. Re-implements what pythonservice.exe + # does when it sees a "-debug" param. + # Currently only used by "frozen" (ie, py2exe) programs (but later may + # end up being used for all services should we ever remove + # pythonservice.exe) + import servicemanager + + global g_debugService + + print("Debugging service %s - press Ctrl+C to stop." % (cls._svc_name_,)) + servicemanager.Debugging(True) + servicemanager.PrepareToHostSingle(cls) + g_debugService = cls(argv) + # Setup a ctrl+c handler to simulate a "stop" + win32api.SetConsoleCtrlHandler(_DebugCtrlHandler, True) + try: + g_debugService.SvcRun() + finally: + win32api.SetConsoleCtrlHandler(_DebugCtrlHandler, False) + servicemanager.Debugging(False) + g_debugService = None + + +def GetServiceClassString(cls, argv=None): + if argv is None: + argv = sys.argv + import pickle + + modName = pickle.whichmodule(cls, cls.__name__) + if modName == "__main__": + try: + fname = win32api.GetFullPathName(argv[0]) + path = os.path.split(fname)[0] + # Eaaaahhhh - sometimes this will be a short filename, which causes + # problems with 1.5.1 and the silly filename case rule. + filelist = win32api.FindFiles(fname) + # win32api.FindFiles will not detect files in a zip or exe. If list is empty, + # skip the test and hope the file really exists. + if len(filelist) != 0: + # Get the long name + fname = os.path.join(path, filelist[0][8]) + except win32api.error: + raise error( + "Could not resolve the path name '%s' to a full path" % (argv[0]) + ) + modName = os.path.splitext(fname)[0] + return modName + "." + cls.__name__ + + +def QueryServiceStatus(serviceName, machine=None): + hscm = win32service.OpenSCManager(machine, None, win32service.SC_MANAGER_CONNECT) + try: + hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_QUERY_STATUS) + try: + status = win32service.QueryServiceStatus(hs) + finally: + win32service.CloseServiceHandle(hs) + finally: + win32service.CloseServiceHandle(hscm) + return status + + +def usage(): + try: + fname = os.path.split(sys.argv[0])[1] + except: + fname = sys.argv[0] + print( + "Usage: '%s [options] install|update|remove|start [...]|stop|restart [...]|debug [...]'" + % fname + ) + print("Options for 'install' and 'update' commands only:") + print(" --username domain\\username : The Username the service is to run under") + print(" --password password : The password for the username") + print( + " --startup [manual|auto|disabled|delayed] : How the service starts, default = manual" + ) + print(" --interactive : Allow the service to interact with the desktop.") + print( + " --perfmonini file: .ini file to use for registering performance monitor data" + ) + print(" --perfmondll file: .dll file to use when querying the service for") + print(" performance data, default = perfmondata.dll") + print("Options for 'start' and 'stop' commands only:") + print(" --wait seconds: Wait for the service to actually start or stop.") + print(" If you specify --wait with the 'stop' option, the service") + print(" and all dependent services will be stopped, each waiting") + print(" the specified period.") + sys.exit(1) + + +def HandleCommandLine( + cls, + serviceClassString=None, + argv=None, + customInstallOptions="", + customOptionHandler=None, +): + """Utility function allowing services to process the command line. + + Allows standard commands such as 'start', 'stop', 'debug', 'install' etc. + + Install supports 'standard' command line options prefixed with '--', such as + --username, --password, etc. In addition, + the function allows custom command line options to be handled by the calling function. + """ + err = 0 + + if argv is None: + argv = sys.argv + + if len(argv) <= 1: + usage() + + serviceName = cls._svc_name_ + serviceDisplayName = cls._svc_display_name_ + if serviceClassString is None: + serviceClassString = GetServiceClassString(cls) + + # Pull apart the command line + import getopt + + try: + opts, args = getopt.getopt( + argv[1:], + customInstallOptions, + [ + "password=", + "username=", + "startup=", + "perfmonini=", + "perfmondll=", + "interactive", + "wait=", + ], + ) + except getopt.error as details: + print(details) + usage() + userName = None + password = None + perfMonIni = perfMonDll = None + startup = None + delayedstart = None + interactive = None + waitSecs = 0 + for opt, val in opts: + if opt == "--username": + userName = val + elif opt == "--password": + password = val + elif opt == "--perfmonini": + perfMonIni = val + elif opt == "--perfmondll": + perfMonDll = val + elif opt == "--interactive": + interactive = 1 + elif opt == "--startup": + map = { + "manual": win32service.SERVICE_DEMAND_START, + "auto": win32service.SERVICE_AUTO_START, + "delayed": win32service.SERVICE_AUTO_START, ## ChangeServiceConfig2 called later + "disabled": win32service.SERVICE_DISABLED, + } + try: + startup = map[val.lower()] + except KeyError: + print("'%s' is not a valid startup option" % val) + if val.lower() == "delayed": + delayedstart = True + elif val.lower() == "auto": + delayedstart = False + ## else no change + elif opt == "--wait": + try: + waitSecs = int(val) + except ValueError: + print("--wait must specify an integer number of seconds.") + usage() + + arg = args[0] + knownArg = 0 + # First we process all arguments which pass additional args on + if arg == "start": + knownArg = 1 + print("Starting service %s" % (serviceName)) + try: + StartService(serviceName, args[1:]) + if waitSecs: + WaitForServiceStatus( + serviceName, win32service.SERVICE_RUNNING, waitSecs + ) + except win32service.error as exc: + print("Error starting service: %s" % exc.strerror) + err = exc.winerror + + elif arg == "restart": + knownArg = 1 + print("Restarting service %s" % (serviceName)) + RestartService(serviceName, args[1:]) + if waitSecs: + WaitForServiceStatus(serviceName, win32service.SERVICE_RUNNING, waitSecs) + + elif arg == "debug": + knownArg = 1 + if not hasattr(sys, "frozen"): + # non-frozen services use pythonservice.exe which handles a + # -debug option + svcArgs = " ".join(args[1:]) + try: + exeName = LocateSpecificServiceExe(serviceName) + except win32api.error as exc: + if exc.winerror == winerror.ERROR_FILE_NOT_FOUND: + print("The service does not appear to be installed.") + print("Please install the service before debugging it.") + sys.exit(1) + raise + try: + os.system("%s -debug %s %s" % (exeName, serviceName, svcArgs)) + # ^C is used to kill the debug service. Sometimes Python also gets + # interrupted - ignore it... + except KeyboardInterrupt: + pass + else: + # py2exe services don't use pythonservice - so we simulate + # debugging here. + DebugService(cls, args) + + if not knownArg and len(args) != 1: + usage() # the rest of the cmds don't take addn args + + if arg == "install": + knownArg = 1 + try: + serviceDeps = cls._svc_deps_ + except AttributeError: + serviceDeps = None + try: + exeName = cls._exe_name_ + except AttributeError: + exeName = None # Default to PythonService.exe + try: + exeArgs = cls._exe_args_ + except AttributeError: + exeArgs = None + try: + description = cls._svc_description_ + except AttributeError: + description = None + print("Installing service %s" % (serviceName,)) + # Note that we install the service before calling the custom option + # handler, so if the custom handler fails, we have an installed service (from NT's POV) + # but is unlikely to work, as the Python code controlling it failed. Therefore + # we remove the service if the first bit works, but the second doesnt! + try: + InstallService( + serviceClassString, + serviceName, + serviceDisplayName, + serviceDeps=serviceDeps, + startType=startup, + bRunInteractive=interactive, + userName=userName, + password=password, + exeName=exeName, + perfMonIni=perfMonIni, + perfMonDll=perfMonDll, + exeArgs=exeArgs, + description=description, + delayedstart=delayedstart, + ) + if customOptionHandler: + customOptionHandler(*(opts,)) + print("Service installed") + except win32service.error as exc: + if exc.winerror == winerror.ERROR_SERVICE_EXISTS: + arg = "update" # Fall through to the "update" param! + else: + print( + "Error installing service: %s (%d)" % (exc.strerror, exc.winerror) + ) + err = exc.winerror + except ValueError as msg: # Can be raised by custom option handler. + print("Error installing service: %s" % str(msg)) + err = -1 + # xxx - maybe I should remove after _any_ failed install - however, + # xxx - it may be useful to help debug to leave the service as it failed. + # xxx - We really _must_ remove as per the comments above... + # As we failed here, remove the service, so the next installation + # attempt works. + try: + RemoveService(serviceName) + except win32api.error: + print("Warning - could not remove the partially installed service.") + + if arg == "update": + knownArg = 1 + try: + serviceDeps = cls._svc_deps_ + except AttributeError: + serviceDeps = None + try: + exeName = cls._exe_name_ + except AttributeError: + exeName = None # Default to PythonService.exe + try: + exeArgs = cls._exe_args_ + except AttributeError: + exeArgs = None + try: + description = cls._svc_description_ + except AttributeError: + description = None + print("Changing service configuration") + try: + ChangeServiceConfig( + serviceClassString, + serviceName, + serviceDeps=serviceDeps, + startType=startup, + bRunInteractive=interactive, + userName=userName, + password=password, + exeName=exeName, + displayName=serviceDisplayName, + perfMonIni=perfMonIni, + perfMonDll=perfMonDll, + exeArgs=exeArgs, + description=description, + delayedstart=delayedstart, + ) + if customOptionHandler: + customOptionHandler(*(opts,)) + print("Service updated") + except win32service.error as exc: + print( + "Error changing service configuration: %s (%d)" + % (exc.strerror, exc.winerror) + ) + err = exc.winerror + + elif arg == "remove": + knownArg = 1 + print("Removing service %s" % (serviceName)) + try: + RemoveService(serviceName) + print("Service removed") + except win32service.error as exc: + print("Error removing service: %s (%d)" % (exc.strerror, exc.winerror)) + err = exc.winerror + elif arg == "stop": + knownArg = 1 + print("Stopping service %s" % (serviceName)) + try: + if waitSecs: + StopServiceWithDeps(serviceName, waitSecs=waitSecs) + else: + StopService(serviceName) + except win32service.error as exc: + print("Error stopping service: %s (%d)" % (exc.strerror, exc.winerror)) + err = exc.winerror + if not knownArg: + err = -1 + print("Unknown command - '%s'" % arg) + usage() + return err + + +# +# Useful base class to build services from. +# +class ServiceFramework: + # Required Attributes: + # _svc_name_ = The service name + # _svc_display_name_ = The service display name + + # Optional Attributes: + _svc_deps_ = None # sequence of service names on which this depends + _exe_name_ = None # Default to PythonService.exe + _exe_args_ = None # Default to no arguments + _svc_description_ = ( + None # Only exists on Windows 2000 or later, ignored on windows NT + ) + + def __init__(self, args): + import servicemanager + + self.ssh = servicemanager.RegisterServiceCtrlHandler( + args[0], self.ServiceCtrlHandlerEx, True + ) + servicemanager.SetEventSourceName(self._svc_name_) + self.checkPoint = 0 + + def GetAcceptedControls(self): + # Setup the service controls we accept based on our attributes. Note + # that if you need to handle controls via SvcOther[Ex](), you must + # override this. + accepted = 0 + if hasattr(self, "SvcStop"): + accepted = accepted | win32service.SERVICE_ACCEPT_STOP + if hasattr(self, "SvcPause") and hasattr(self, "SvcContinue"): + accepted = accepted | win32service.SERVICE_ACCEPT_PAUSE_CONTINUE + if hasattr(self, "SvcShutdown"): + accepted = accepted | win32service.SERVICE_ACCEPT_SHUTDOWN + return accepted + + def ReportServiceStatus( + self, serviceStatus, waitHint=5000, win32ExitCode=0, svcExitCode=0 + ): + if self.ssh is None: # Debugging! + return + if serviceStatus == win32service.SERVICE_START_PENDING: + accepted = 0 + else: + accepted = self.GetAcceptedControls() + + if serviceStatus in [ + win32service.SERVICE_RUNNING, + win32service.SERVICE_STOPPED, + ]: + checkPoint = 0 + else: + self.checkPoint = self.checkPoint + 1 + checkPoint = self.checkPoint + + # Now report the status to the control manager + status = ( + win32service.SERVICE_WIN32_OWN_PROCESS, + serviceStatus, + accepted, # dwControlsAccepted, + win32ExitCode, # dwWin32ExitCode; + svcExitCode, # dwServiceSpecificExitCode; + checkPoint, # dwCheckPoint; + waitHint, + ) + win32service.SetServiceStatus(self.ssh, status) + + def SvcInterrogate(self): + # Assume we are running, and everyone is happy. + self.ReportServiceStatus(win32service.SERVICE_RUNNING) + + def SvcOther(self, control): + try: + print("Unknown control status - %d" % control) + except IOError: + # services may not have a valid stdout! + pass + + def ServiceCtrlHandler(self, control): + return self.ServiceCtrlHandlerEx(control, 0, None) + + # The 'Ex' functions, which take additional params + def SvcOtherEx(self, control, event_type, data): + # The default here is to call self.SvcOther as that is the old behaviour. + # If you want to take advantage of the extra data, override this method + return self.SvcOther(control) + + def ServiceCtrlHandlerEx(self, control, event_type, data): + if control == win32service.SERVICE_CONTROL_STOP: + return self.SvcStop() + elif control == win32service.SERVICE_CONTROL_PAUSE: + return self.SvcPause() + elif control == win32service.SERVICE_CONTROL_CONTINUE: + return self.SvcContinue() + elif control == win32service.SERVICE_CONTROL_INTERROGATE: + return self.SvcInterrogate() + elif control == win32service.SERVICE_CONTROL_SHUTDOWN: + return self.SvcShutdown() + else: + return self.SvcOtherEx(control, event_type, data) + + def SvcRun(self): + # This is the entry point the C framework calls when the Service is + # started. Your Service class should implement SvcDoRun(). + # Or you can override this method for more control over the Service + # statuses reported to the SCM. + + # If this method raises an exception, the C framework will detect this + # and report a SERVICE_STOPPED status with a non-zero error code. + + self.ReportServiceStatus(win32service.SERVICE_RUNNING) + self.SvcDoRun() + # Once SvcDoRun terminates, the service has stopped. + # We tell the SCM the service is still stopping - the C framework + # will automatically tell the SCM it has stopped when this returns. + self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING) diff --git a/lib/win32/lib/win32timezone.py b/lib/win32/lib/win32timezone.py new file mode 100644 index 00000000..569ea9b9 --- /dev/null +++ b/lib/win32/lib/win32timezone.py @@ -0,0 +1,1023 @@ +# -*- coding: UTF-8 -*- + +""" +win32timezone: + Module for handling datetime.tzinfo time zones using the windows +registry for time zone information. The time zone names are dependent +on the registry entries defined by the operating system. + + This module may be tested using the doctest module. + + Written by Jason R. Coombs (jaraco@jaraco.com). + Copyright © 2003-2012. + All Rights Reserved. + + This module is licenced for use in Mark Hammond's pywin32 +library under the same terms as the pywin32 library. + + To use this time zone module with the datetime module, simply pass +the TimeZoneInfo object to the datetime constructor. For example, + +>>> import win32timezone, datetime +>>> assert 'Mountain Standard Time' in win32timezone.TimeZoneInfo.get_sorted_time_zone_names() +>>> MST = win32timezone.TimeZoneInfo('Mountain Standard Time') +>>> now = datetime.datetime.now(MST) + + The now object is now a time-zone aware object, and daylight savings- +aware methods may be called on it. + +>>> now.utcoffset() in (datetime.timedelta(-1, 61200), datetime.timedelta(-1, 64800)) +True + +(note that the result of utcoffset call will be different based on when now was +generated, unless standard time is always used) + +>>> now = datetime.datetime.now(TimeZoneInfo('Mountain Standard Time', True)) +>>> now.utcoffset() +datetime.timedelta(days=-1, seconds=61200) + +>>> aug2 = datetime.datetime(2003, 8, 2, tzinfo = MST) +>>> tuple(aug2.utctimetuple()) +(2003, 8, 2, 6, 0, 0, 5, 214, 0) +>>> nov2 = datetime.datetime(2003, 11, 25, tzinfo = MST) +>>> tuple(nov2.utctimetuple()) +(2003, 11, 25, 7, 0, 0, 1, 329, 0) + +To convert from one timezone to another, just use the astimezone method. + +>>> aug2.isoformat() +'2003-08-02T00:00:00-06:00' +>>> aug2est = aug2.astimezone(win32timezone.TimeZoneInfo('Eastern Standard Time')) +>>> aug2est.isoformat() +'2003-08-02T02:00:00-04:00' + +calling the displayName member will return the display name as set in the +registry. + +>>> est = win32timezone.TimeZoneInfo('Eastern Standard Time') +>>> str(est.displayName) +'(UTC-05:00) Eastern Time (US & Canada)' + +>>> gmt = win32timezone.TimeZoneInfo('GMT Standard Time', True) +>>> str(gmt.displayName) +'(UTC+00:00) Dublin, Edinburgh, Lisbon, London' + +To get the complete list of available time zone keys, +>>> zones = win32timezone.TimeZoneInfo.get_all_time_zones() + +If you want to get them in an order that's sorted longitudinally +>>> zones = win32timezone.TimeZoneInfo.get_sorted_time_zones() + +TimeZoneInfo now supports being pickled and comparison +>>> import pickle +>>> tz = win32timezone.TimeZoneInfo('China Standard Time') +>>> tz == pickle.loads(pickle.dumps(tz)) +True + +It's possible to construct a TimeZoneInfo from a TimeZoneDescription +including the currently-defined zone. +>>> tz = win32timezone.TimeZoneInfo(TimeZoneDefinition.current()) +>>> tz == pickle.loads(pickle.dumps(tz)) +True + +>>> aest = win32timezone.TimeZoneInfo('AUS Eastern Standard Time') +>>> est = win32timezone.TimeZoneInfo('E. Australia Standard Time') +>>> dt = datetime.datetime(2006, 11, 11, 1, 0, 0, tzinfo = aest) +>>> estdt = dt.astimezone(est) +>>> estdt.strftime('%Y-%m-%d %H:%M:%S') +'2006-11-11 00:00:00' + +>>> dt = datetime.datetime(2007, 1, 12, 1, 0, 0, tzinfo = aest) +>>> estdt = dt.astimezone(est) +>>> estdt.strftime('%Y-%m-%d %H:%M:%S') +'2007-01-12 00:00:00' + +>>> dt = datetime.datetime(2007, 6, 13, 1, 0, 0, tzinfo = aest) +>>> estdt = dt.astimezone(est) +>>> estdt.strftime('%Y-%m-%d %H:%M:%S') +'2007-06-13 01:00:00' + +Microsoft now has a patch for handling time zones in 2007 (see +http://support.microsoft.com/gp/cp_dst) + +As a result, patched systems will give an incorrect result for +dates prior to the designated year except for Vista and its +successors, which have dynamic time zone support. +>>> nov2_pre_change = datetime.datetime(2003, 11, 2, tzinfo = MST) +>>> old_response = (2003, 11, 2, 7, 0, 0, 6, 306, 0) +>>> incorrect_patch_response = (2003, 11, 2, 6, 0, 0, 6, 306, 0) +>>> pre_response = nov2_pre_change.utctimetuple() +>>> pre_response in (old_response, incorrect_patch_response) +True + +Furthermore, unpatched systems pre-Vista will give an incorrect +result for dates after 2007. +>>> nov2_post_change = datetime.datetime(2007, 11, 2, tzinfo = MST) +>>> incorrect_unpatched_response = (2007, 11, 2, 7, 0, 0, 4, 306, 0) +>>> new_response = (2007, 11, 2, 6, 0, 0, 4, 306, 0) +>>> post_response = nov2_post_change.utctimetuple() +>>> post_response in (new_response, incorrect_unpatched_response) +True + + +There is a function you can call to get some capabilities of the time +zone data. +>>> caps = GetTZCapabilities() +>>> isinstance(caps, dict) +True +>>> 'MissingTZPatch' in caps +True +>>> 'DynamicTZSupport' in caps +True + +>>> both_dates_correct = (pre_response == old_response and post_response == new_response) +>>> old_dates_wrong = (pre_response == incorrect_patch_response) +>>> new_dates_wrong = (post_response == incorrect_unpatched_response) + +>>> caps['DynamicTZSupport'] == both_dates_correct +True + +>>> (not caps['DynamicTZSupport'] and caps['MissingTZPatch']) == new_dates_wrong +True + +>>> (not caps['DynamicTZSupport'] and not caps['MissingTZPatch']) == old_dates_wrong +True + +This test helps ensure language support for unicode characters +>>> x = TIME_ZONE_INFORMATION(0, u'français') + + +Test conversion from one time zone to another at a DST boundary +=============================================================== + +>>> tz_hi = TimeZoneInfo('Hawaiian Standard Time') +>>> tz_pac = TimeZoneInfo('Pacific Standard Time') +>>> time_before = datetime.datetime(2011, 11, 5, 15, 59, 59, tzinfo=tz_hi) +>>> tz_hi.utcoffset(time_before) +datetime.timedelta(days=-1, seconds=50400) +>>> tz_hi.dst(time_before) +datetime.timedelta(0) + +Hawaii doesn't need dynamic TZ info +>>> getattr(tz_hi, 'dynamicInfo', None) + +Here's a time that gave some trouble as reported in #3523104 +because one minute later, the equivalent UTC time changes from DST +in the U.S. +>>> dt_hi = datetime.datetime(2011, 11, 5, 15, 59, 59, 0, tzinfo=tz_hi) +>>> dt_hi.timetuple() +time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=15, tm_min=59, tm_sec=59, tm_wday=5, tm_yday=309, tm_isdst=0) +>>> dt_hi.utctimetuple() +time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=1, tm_min=59, tm_sec=59, tm_wday=6, tm_yday=310, tm_isdst=0) + +Convert the time to pacific time. +>>> dt_pac = dt_hi.astimezone(tz_pac) +>>> dt_pac.timetuple() +time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=18, tm_min=59, tm_sec=59, tm_wday=5, tm_yday=309, tm_isdst=1) + +Notice that the UTC time is almost 2am. +>>> dt_pac.utctimetuple() +time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=1, tm_min=59, tm_sec=59, tm_wday=6, tm_yday=310, tm_isdst=0) + +Now do the same tests one minute later in Hawaii. +>>> time_after = datetime.datetime(2011, 11, 5, 16, 0, 0, 0, tzinfo=tz_hi) +>>> tz_hi.utcoffset(time_after) +datetime.timedelta(days=-1, seconds=50400) +>>> tz_hi.dst(time_before) +datetime.timedelta(0) + +>>> dt_hi = datetime.datetime(2011, 11, 5, 16, 0, 0, 0, tzinfo=tz_hi) +>>> print(dt_hi.timetuple()) +time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=16, tm_min=0, tm_sec=0, tm_wday=5, tm_yday=309, tm_isdst=0) +>>> print(dt_hi.utctimetuple()) +time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=2, tm_min=0, tm_sec=0, tm_wday=6, tm_yday=310, tm_isdst=0) + +According to the docs, this is what astimezone does. +>>> utc = (dt_hi - dt_hi.utcoffset()).replace(tzinfo=tz_pac) +>>> utc +datetime.datetime(2011, 11, 6, 2, 0, tzinfo=TimeZoneInfo('Pacific Standard Time')) +>>> tz_pac.fromutc(utc) == dt_hi.astimezone(tz_pac) +True +>>> tz_pac.fromutc(utc) +datetime.datetime(2011, 11, 5, 19, 0, tzinfo=TimeZoneInfo('Pacific Standard Time')) + +Make sure the converted time is correct. +>>> dt_pac = dt_hi.astimezone(tz_pac) +>>> dt_pac.timetuple() +time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=19, tm_min=0, tm_sec=0, tm_wday=5, tm_yday=309, tm_isdst=1) +>>> dt_pac.utctimetuple() +time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=2, tm_min=0, tm_sec=0, tm_wday=6, tm_yday=310, tm_isdst=0) + +Check some internal methods +>>> tz_pac._getStandardBias(datetime.datetime(2011, 1, 1)) +datetime.timedelta(seconds=28800) +>>> tz_pac._getDaylightBias(datetime.datetime(2011, 1, 1)) +datetime.timedelta(seconds=25200) + +Test the offsets +>>> offset = tz_pac.utcoffset(datetime.datetime(2011, 11, 6, 2, 0)) +>>> offset == datetime.timedelta(hours=-8) +True +>>> dst_offset = tz_pac.dst(datetime.datetime(2011, 11, 6, 2, 0) + offset) +>>> dst_offset == datetime.timedelta(hours=1) +True +>>> (offset + dst_offset) == datetime.timedelta(hours=-7) +True + + +Test offsets that occur right at the DST changeover +>>> datetime.datetime.utcfromtimestamp(1320570000).replace( +... tzinfo=TimeZoneInfo.utc()).astimezone(tz_pac) +datetime.datetime(2011, 11, 6, 1, 0, tzinfo=TimeZoneInfo('Pacific Standard Time')) + +""" +__author__ = "Jason R. Coombs " + +import datetime +import logging +import operator +import re +import struct +import winreg +from itertools import count + +import win32api + +log = logging.getLogger(__file__) + + +# A couple of objects for working with objects as if they were native C-type +# structures. +class _SimpleStruct(object): + _fields_ = None # must be overridden by subclasses + + def __init__(self, *args, **kw): + for i, (name, typ) in enumerate(self._fields_): + def_arg = None + if i < len(args): + def_arg = args[i] + if name in kw: + def_arg = kw[name] + if def_arg is not None: + if not isinstance(def_arg, tuple): + def_arg = (def_arg,) + else: + def_arg = () + if len(def_arg) == 1 and isinstance(def_arg[0], typ): + # already an object of this type. + # XXX - should copy.copy??? + def_val = def_arg[0] + else: + def_val = typ(*def_arg) + setattr(self, name, def_val) + + def field_names(self): + return [f[0] for f in self._fields_] + + def __eq__(self, other): + if not hasattr(other, "_fields_"): + return False + if self._fields_ != other._fields_: + return False + for name, _ in self._fields_: + if getattr(self, name) != getattr(other, name): + return False + return True + + def __ne__(self, other): + return not self.__eq__(other) + + +class SYSTEMTIME(_SimpleStruct): + _fields_ = [ + ("year", int), + ("month", int), + ("day_of_week", int), + ("day", int), + ("hour", int), + ("minute", int), + ("second", int), + ("millisecond", int), + ] + + +class TIME_ZONE_INFORMATION(_SimpleStruct): + _fields_ = [ + ("bias", int), + ("standard_name", str), + ("standard_start", SYSTEMTIME), + ("standard_bias", int), + ("daylight_name", str), + ("daylight_start", SYSTEMTIME), + ("daylight_bias", int), + ] + + +class DYNAMIC_TIME_ZONE_INFORMATION(_SimpleStruct): + _fields_ = TIME_ZONE_INFORMATION._fields_ + [ + ("key_name", str), + ("dynamic_daylight_time_disabled", bool), + ] + + +class TimeZoneDefinition(DYNAMIC_TIME_ZONE_INFORMATION): + """ + A time zone definition class based on the win32 + DYNAMIC_TIME_ZONE_INFORMATION structure. + + Describes a bias against UTC (bias), and two dates at which a separate + additional bias applies (standard_bias and daylight_bias). + """ + + def __init__(self, *args, **kwargs): + """ + Try to construct a TimeZoneDefinition from + a) [DYNAMIC_]TIME_ZONE_INFORMATION args + b) another TimeZoneDefinition + c) a byte structure (using _from_bytes) + """ + try: + super(TimeZoneDefinition, self).__init__(*args, **kwargs) + return + except (TypeError, ValueError): + pass + + try: + self.__init_from_other(*args, **kwargs) + return + except TypeError: + pass + + try: + self.__init_from_bytes(*args, **kwargs) + return + except TypeError: + pass + + raise TypeError("Invalid arguments for %s" % self.__class__) + + def __init_from_bytes( + self, + bytes, + standard_name="", + daylight_name="", + key_name="", + daylight_disabled=False, + ): + format = "3l8h8h" + components = struct.unpack(format, bytes) + bias, standard_bias, daylight_bias = components[:3] + standard_start = SYSTEMTIME(*components[3:11]) + daylight_start = SYSTEMTIME(*components[11:19]) + super(TimeZoneDefinition, self).__init__( + bias, + standard_name, + standard_start, + standard_bias, + daylight_name, + daylight_start, + daylight_bias, + key_name, + daylight_disabled, + ) + + def __init_from_other(self, other): + if not isinstance(other, TIME_ZONE_INFORMATION): + raise TypeError("Not a TIME_ZONE_INFORMATION") + for name in other.field_names(): + # explicitly get the value from the underlying structure + value = super(TimeZoneDefinition, other).__getattribute__(other, name) + setattr(self, name, value) + # consider instead of the loop above just copying the memory directly + # size = max(ctypes.sizeof(DYNAMIC_TIME_ZONE_INFO), ctypes.sizeof(other)) + # ctypes.memmove(ctypes.addressof(self), other, size) + + def __getattribute__(self, attr): + value = super(TimeZoneDefinition, self).__getattribute__(attr) + if "bias" in attr: + value = datetime.timedelta(minutes=value) + return value + + @classmethod + def current(class_): + "Windows Platform SDK GetTimeZoneInformation" + code, tzi = win32api.GetTimeZoneInformation(True) + return code, class_(*tzi) + + def set(self): + tzi = tuple(getattr(self, n) for n, t in self._fields_) + win32api.SetTimeZoneInformation(tzi) + + def copy(self): + # XXX - this is no longer a copy! + return self.__class__(self) + + def locate_daylight_start(self, year): + return self._locate_day(year, self.daylight_start) + + def locate_standard_start(self, year): + return self._locate_day(year, self.standard_start) + + @staticmethod + def _locate_day(year, cutoff): + """ + Takes a SYSTEMTIME object, such as retrieved from a TIME_ZONE_INFORMATION + structure or call to GetTimeZoneInformation and interprets it based on the given + year to identify the actual day. + + This method is necessary because the SYSTEMTIME structure refers to a day by its + day of the week and week of the month (e.g. 4th saturday in March). + + >>> SATURDAY = 6 + >>> MARCH = 3 + >>> st = SYSTEMTIME(2000, MARCH, SATURDAY, 4, 0, 0, 0, 0) + + # according to my calendar, the 4th Saturday in March in 2009 was the 28th + >>> expected_date = datetime.datetime(2009, 3, 28) + >>> TimeZoneDefinition._locate_day(2009, st) == expected_date + True + """ + # MS stores Sunday as 0, Python datetime stores Monday as zero + target_weekday = (cutoff.day_of_week + 6) % 7 + # For SYSTEMTIMEs relating to time zone inforamtion, cutoff.day + # is the week of the month + week_of_month = cutoff.day + # so the following is the first day of that week + day = (week_of_month - 1) * 7 + 1 + result = datetime.datetime( + year, + cutoff.month, + day, + cutoff.hour, + cutoff.minute, + cutoff.second, + cutoff.millisecond, + ) + # now the result is the correct week, but not necessarily the correct day of the week + days_to_go = (target_weekday - result.weekday()) % 7 + result += datetime.timedelta(days_to_go) + # if we selected a day in the month following the target month, + # move back a week or two. + # This is necessary because Microsoft defines the fifth week in a month + # to be the last week in a month and adding the time delta might have + # pushed the result into the next month. + while result.month == cutoff.month + 1: + result -= datetime.timedelta(weeks=1) + return result + + +class TimeZoneInfo(datetime.tzinfo): + """ + Main class for handling Windows time zones. + Usage: + TimeZoneInfo(

    Qo7vB+?8cn*Y)Ef(%U`lg$2elf)20OqHGedm( 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

    " + print("%s %s %10d %s" % (date_str, attr_string, info[5], rel_name)) + total_size = total_size + info[5] + print(" " * 14 + "%3d files, %10d bytes" % (len(files), total_size)) + + +def run(args): + """run program [args] + Starts the specified program on the remote device. + """ + prog_args = [] + for arg in args: + if " " in arg: + prog_args.append('"' + arg + '"') + else: + prog_args.append(arg) + prog_args = string.join(prog_args, " ") + wincerapi.CeCreateProcess(prog_args, "", None, None, 0, 0, None, "", None) + + +def delete(args): + """delete file, ... + Delete one or more remote files + """ + for arg in args: + try: + wincerapi.CeDeleteFile(arg) + print("Deleted: %s" % arg) + except win32api.error as details: + print_error(details, "Error deleting '%s'" % arg) + + +def DumpCommands(): + print("%-10s - %s" % ("Command", "Description")) + print("%-10s - %s" % ("-------", "-----------")) + for name, item in list(globals().items()): + if type(item) == type(DumpCommands): + doc = getattr(item, "__doc__", "") + if doc: + lines = string.split(doc, "\n") + print("%-10s - %s" % (name, lines[0])) + for line in lines[1:]: + if line: + print(" " * 8, line) + + +def main(): + if len(sys.argv) < 2: + print("You must specify a command!") + DumpCommands() + return + command = sys.argv[1] + fn = globals().get(command) + if fn is None: + print("Unknown command:", command) + DumpCommands() + return + + wincerapi.CeRapiInit() + try: + verinfo = wincerapi.CeGetVersionEx() + print( + "Connected to device, CE version %d.%d %s" + % (verinfo[0], verinfo[1], verinfo[4]) + ) + try: + fn(sys.argv[2:]) + except InvalidUsage as msg: + print("Invalid syntax -", msg) + print(fn.__doc__) + + finally: + try: + wincerapi.CeRapiUninit() + except win32api.error as details: + print_error(details, "Error disconnecting") + + +if __name__ == "__main__": + main() diff --git a/lib/win32/scripts/killProcName.py b/lib/win32/scripts/killProcName.py new file mode 100644 index 00000000..c9b399ff --- /dev/null +++ b/lib/win32/scripts/killProcName.py @@ -0,0 +1,62 @@ +# Kills a process by process name +# +# Uses the Performance Data Helper to locate the PID, then kills it. +# Will only kill the process if there is only one process of that name +# (eg, attempting to kill "Python.exe" will only work if there is only +# one Python.exe running. (Note that the current process does not +# count - ie, if Python.exe is hosting this script, you can still kill +# another Python.exe (as long as there is only one other Python.exe) + +# Really just a demo for the win32pdh(util) module, which allows you +# to get all sorts of information about a running process and many +# other aspects of your system. + +import sys + +import win32api +import win32con +import win32pdhutil + + +def killProcName(procname): + # Change suggested by Dan Knierim, who found that this performed a + # "refresh", allowing us to kill processes created since this was run + # for the first time. + try: + win32pdhutil.GetPerformanceAttributes("Process", "ID Process", procname) + except: + pass + + pids = win32pdhutil.FindPerformanceAttributesByName(procname) + + # If _my_ pid in there, remove it! + try: + pids.remove(win32api.GetCurrentProcessId()) + except ValueError: + pass + + if len(pids) == 0: + result = "Can't find %s" % procname + elif len(pids) > 1: + result = "Found too many %s's - pids=`%s`" % (procname, pids) + else: + handle = win32api.OpenProcess(win32con.PROCESS_TERMINATE, 0, pids[0]) + win32api.TerminateProcess(handle, 0) + win32api.CloseHandle(handle) + result = "" + + return result + + +if __name__ == "__main__": + if len(sys.argv) > 1: + for procname in sys.argv[1:]: + result = killProcName(procname) + if result: + print(result) + print("Dumping all processes...") + win32pdhutil.ShowAllProcesses() + else: + print("Killed %s" % procname) + else: + print("Usage: killProcName.py procname ...") diff --git a/lib/win32/scripts/rasutil.py b/lib/win32/scripts/rasutil.py new file mode 100644 index 00000000..e5a8922d --- /dev/null +++ b/lib/win32/scripts/rasutil.py @@ -0,0 +1,97 @@ +# A demo of using the RAS API from Python +import sys + +import win32ras + + +# The error raised if we can not +class ConnectionError(Exception): + pass + + +def Connect(rasEntryName, numRetries=5): + """Make a connection to the specified RAS entry. + + Returns a tuple of (bool, handle) on success. + - bool is 1 if a new connection was established, or 0 is a connection already existed. + - handle is a RAS HANDLE that can be passed to Disconnect() to end the connection. + + Raises a ConnectionError if the connection could not be established. + """ + assert numRetries > 0 + for info in win32ras.EnumConnections(): + if info[1].lower() == rasEntryName.lower(): + print("Already connected to", rasEntryName) + return 0, info[0] + + dial_params, have_pw = win32ras.GetEntryDialParams(None, rasEntryName) + if not have_pw: + print("Error: The password is not saved for this connection") + print( + "Please connect manually selecting the 'save password' option and try again" + ) + sys.exit(1) + + print("Connecting to", rasEntryName, "...") + retryCount = numRetries + while retryCount > 0: + rasHandle, errCode = win32ras.Dial(None, None, dial_params, None) + if win32ras.IsHandleValid(rasHandle): + bValid = 1 + break + print("Retrying...") + win32api.Sleep(5000) + retryCount = retryCount - 1 + + if errCode: + raise ConnectionError(errCode, win32ras.GetErrorString(errCode)) + return 1, rasHandle + + +def Disconnect(handle): + if type(handle) == type(""): # have they passed a connection name? + for info in win32ras.EnumConnections(): + if info[1].lower() == handle.lower(): + handle = info[0] + break + else: + raise ConnectionError(0, "Not connected to entry '%s'" % handle) + + win32ras.HangUp(handle) + + +usage = """rasutil.py - Utilities for using RAS + +Usage: + rasutil [-r retryCount] [-c rasname] [-d rasname] + + -r retryCount - Number of times to retry the RAS connection + -c rasname - Connect to the phonebook entry specified by rasname + -d rasname - Disconnect from the phonebook entry specified by rasname +""" + + +def Usage(why): + print(why) + print(usage) + sys.exit(1) + + +if __name__ == "__main__": + import getopt + + try: + opts, args = getopt.getopt(sys.argv[1:], "r:c:d:") + except getopt.error as why: + Usage(why) + retries = 5 + if len(args) != 0: + Usage("Invalid argument") + + for opt, val in opts: + if opt == "-c": + Connect(val, retries) + if opt == "-d": + Disconnect(val) + if opt == "-r": + retries = int(val) diff --git a/lib/win32/scripts/regsetup.py b/lib/win32/scripts/regsetup.py new file mode 100644 index 00000000..885698e1 --- /dev/null +++ b/lib/win32/scripts/regsetup.py @@ -0,0 +1,612 @@ +# A tool to setup the Python registry. + + +class error(Exception): + pass + + +import sys # at least we can count on this! + + +def FileExists(fname): + """Check if a file exists. Returns true or false.""" + import os + + try: + os.stat(fname) + return 1 + except os.error as details: + return 0 + + +def IsPackageDir(path, packageName, knownFileName): + """Given a path, a ni package name, and possibly a known file name in + the root of the package, see if this path is good. + """ + import os + + if knownFileName is None: + knownFileName = "." + return FileExists(os.path.join(os.path.join(path, packageName), knownFileName)) + + +def IsDebug(): + """Return "_d" if we're running a debug version. + + This is to be used within DLL names when locating them. + """ + import importlib.machinery + + return "_d" if "_d.pyd" in importlib.machinery.EXTENSION_SUFFIXES else "" + + +def FindPackagePath(packageName, knownFileName, searchPaths): + """Find a package. + + Given a ni style package name, check the package is registered. + + First place looked is the registry for an existing entry. Then + the searchPaths are searched. + """ + import os + + import regutil + + pathLook = regutil.GetRegisteredNamedPath(packageName) + if pathLook and IsPackageDir(pathLook, packageName, knownFileName): + return pathLook, None # The currently registered one is good. + # Search down the search paths. + for pathLook in searchPaths: + if IsPackageDir(pathLook, packageName, knownFileName): + # Found it + ret = os.path.abspath(pathLook) + return ret, ret + raise error("The package %s can not be located" % packageName) + + +def FindHelpPath(helpFile, helpDesc, searchPaths): + # See if the current registry entry is OK + import os + + import win32api + import win32con + + try: + key = win32api.RegOpenKey( + win32con.HKEY_LOCAL_MACHINE, + "Software\\Microsoft\\Windows\\Help", + 0, + win32con.KEY_ALL_ACCESS, + ) + try: + try: + path = win32api.RegQueryValueEx(key, helpDesc)[0] + if FileExists(os.path.join(path, helpFile)): + return os.path.abspath(path) + except win32api.error: + pass # no registry entry. + finally: + key.Close() + except win32api.error: + pass + for pathLook in searchPaths: + if FileExists(os.path.join(pathLook, helpFile)): + return os.path.abspath(pathLook) + pathLook = os.path.join(pathLook, "Help") + if FileExists(os.path.join(pathLook, helpFile)): + return os.path.abspath(pathLook) + raise error("The help file %s can not be located" % helpFile) + + +def FindAppPath(appName, knownFileName, searchPaths): + """Find an application. + + First place looked is the registry for an existing entry. Then + the searchPaths are searched. + """ + # Look in the first path. + import os + + import regutil + + regPath = regutil.GetRegisteredNamedPath(appName) + if regPath: + pathLook = regPath.split(";")[0] + if regPath and FileExists(os.path.join(pathLook, knownFileName)): + return None # The currently registered one is good. + # Search down the search paths. + for pathLook in searchPaths: + if FileExists(os.path.join(pathLook, knownFileName)): + # Found it + return os.path.abspath(pathLook) + raise error( + "The file %s can not be located for application %s" % (knownFileName, appName) + ) + + +def FindPythonExe(exeAlias, possibleRealNames, searchPaths): + """Find an exe. + + Returns the full path to the .exe, and a boolean indicating if the current + registered entry is OK. We don't trust the already registered version even + if it exists - it may be wrong (ie, for a different Python version) + """ + import os + import sys + + import regutil + import win32api + + if possibleRealNames is None: + possibleRealNames = exeAlias + # Look first in Python's home. + found = os.path.join(sys.prefix, possibleRealNames) + if not FileExists(found): # for developers + if "64 bit" in sys.version: + found = os.path.join(sys.prefix, "PCBuild", "amd64", possibleRealNames) + else: + found = os.path.join(sys.prefix, "PCBuild", possibleRealNames) + if not FileExists(found): + found = LocateFileName(possibleRealNames, searchPaths) + + registered_ok = 0 + try: + registered = win32api.RegQueryValue( + regutil.GetRootKey(), regutil.GetAppPathsKey() + "\\" + exeAlias + ) + registered_ok = found == registered + except win32api.error: + pass + return found, registered_ok + + +def QuotedFileName(fname): + """Given a filename, return a quoted version if necessary""" + + import regutil + + try: + fname.index(" ") # Other chars forcing quote? + return '"%s"' % fname + except ValueError: + # No space in name. + return fname + + +def LocateFileName(fileNamesString, searchPaths): + """Locate a file name, anywhere on the search path. + + If the file can not be located, prompt the user to find it for us + (using a common OpenFile dialog) + + Raises KeyboardInterrupt if the user cancels. + """ + import os + + import regutil + + fileNames = fileNamesString.split(";") + for path in searchPaths: + for fileName in fileNames: + try: + retPath = os.path.join(path, fileName) + os.stat(retPath) + break + except os.error: + retPath = None + if retPath: + break + else: + fileName = fileNames[0] + try: + import win32con + import win32ui + except ImportError: + raise error( + "Need to locate the file %s, but the win32ui module is not available\nPlease run the program again, passing as a parameter the path to this file." + % fileName + ) + # Display a common dialog to locate the file. + flags = win32con.OFN_FILEMUSTEXIST + ext = os.path.splitext(fileName)[1] + filter = "Files of requested type (*%s)|*%s||" % (ext, ext) + dlg = win32ui.CreateFileDialog(1, None, fileName, flags, filter, None) + dlg.SetOFNTitle("Locate " + fileName) + if dlg.DoModal() != win32con.IDOK: + raise KeyboardInterrupt("User cancelled the process") + retPath = dlg.GetPathName() + return os.path.abspath(retPath) + + +def LocatePath(fileName, searchPaths): + """Like LocateFileName, but returns a directory only.""" + import os + + return os.path.abspath(os.path.split(LocateFileName(fileName, searchPaths))[0]) + + +def LocateOptionalPath(fileName, searchPaths): + """Like LocatePath, but returns None if the user cancels.""" + try: + return LocatePath(fileName, searchPaths) + except KeyboardInterrupt: + return None + + +def LocateOptionalFileName(fileName, searchPaths=None): + """Like LocateFileName, but returns None if the user cancels.""" + try: + return LocateFileName(fileName, searchPaths) + except KeyboardInterrupt: + return None + + +def LocatePythonCore(searchPaths): + """Locate and validate the core Python directories. Returns a list + of paths that should be used as the core (ie, un-named) portion of + the Python path. + """ + import os + + import regutil + + currentPath = regutil.GetRegisteredNamedPath(None) + if currentPath: + presearchPaths = currentPath.split(";") + else: + presearchPaths = [os.path.abspath(".")] + libPath = None + for path in presearchPaths: + if FileExists(os.path.join(path, "os.py")): + libPath = path + break + if libPath is None and searchPaths is not None: + libPath = LocatePath("os.py", searchPaths) + if libPath is None: + raise error("The core Python library could not be located.") + + corePath = None + suffix = IsDebug() + for path in presearchPaths: + if FileExists(os.path.join(path, "unicodedata%s.pyd" % suffix)): + corePath = path + break + if corePath is None and searchPaths is not None: + corePath = LocatePath("unicodedata%s.pyd" % suffix, searchPaths) + if corePath is None: + raise error("The core Python path could not be located.") + + installPath = os.path.abspath(os.path.join(libPath, "..")) + return installPath, [libPath, corePath] + + +def FindRegisterPackage(packageName, knownFile, searchPaths, registryAppName=None): + """Find and Register a package. + + Assumes the core registry setup correctly. + + In addition, if the location located by the package is already + in the **core** path, then an entry is registered, but no path. + (no other paths are checked, as the application whose path was used + may later be uninstalled. This should not happen with the core) + """ + + import regutil + + if not packageName: + raise error("A package name must be supplied") + corePaths = regutil.GetRegisteredNamedPath(None).split(";") + if not searchPaths: + searchPaths = corePaths + registryAppName = registryAppName or packageName + try: + pathLook, pathAdd = FindPackagePath(packageName, knownFile, searchPaths) + if pathAdd is not None: + if pathAdd in corePaths: + pathAdd = "" + regutil.RegisterNamedPath(registryAppName, pathAdd) + return pathLook + except error as details: + print( + "*** The %s package could not be registered - %s" % (packageName, details) + ) + print( + "*** Please ensure you have passed the correct paths on the command line." + ) + print( + "*** - For packages, you should pass a path to the packages parent directory," + ) + print("*** - and not the package directory itself...") + + +def FindRegisterApp(appName, knownFiles, searchPaths): + """Find and Register a package. + + Assumes the core registry setup correctly. + + """ + + import regutil + + if type(knownFiles) == type(""): + knownFiles = [knownFiles] + paths = [] + try: + for knownFile in knownFiles: + pathLook = FindAppPath(appName, knownFile, searchPaths) + if pathLook: + paths.append(pathLook) + except error as details: + print("*** ", details) + return + + regutil.RegisterNamedPath(appName, ";".join(paths)) + + +def FindRegisterPythonExe(exeAlias, searchPaths, actualFileNames=None): + """Find and Register a Python exe (not necessarily *the* python.exe) + + Assumes the core registry setup correctly. + """ + + import regutil + + fname, ok = FindPythonExe(exeAlias, actualFileNames, searchPaths) + if not ok: + regutil.RegisterPythonExe(fname, exeAlias) + return fname + + +def FindRegisterHelpFile(helpFile, searchPaths, helpDesc=None): + import regutil + + try: + pathLook = FindHelpPath(helpFile, helpDesc, searchPaths) + except error as details: + print("*** ", details) + return + # print "%s found at %s" % (helpFile, pathLook) + regutil.RegisterHelpFile(helpFile, pathLook, helpDesc) + + +def SetupCore(searchPaths): + """Setup the core Python information in the registry. + + This function makes no assumptions about the current state of sys.path. + + After this function has completed, you should have access to the standard + Python library, and the standard Win32 extensions + """ + + import sys + + for path in searchPaths: + sys.path.append(path) + + import os + + import regutil + import win32api + import win32con + + installPath, corePaths = LocatePythonCore(searchPaths) + # Register the core Pythonpath. + print(corePaths) + regutil.RegisterNamedPath(None, ";".join(corePaths)) + + # Register the install path. + hKey = win32api.RegCreateKey(regutil.GetRootKey(), regutil.BuildDefaultPythonKey()) + try: + # Core Paths. + win32api.RegSetValue(hKey, "InstallPath", win32con.REG_SZ, installPath) + finally: + win32api.RegCloseKey(hKey) + + # Register the win32 core paths. + win32paths = ( + os.path.abspath(os.path.split(win32api.__file__)[0]) + + ";" + + os.path.abspath( + os.path.split(LocateFileName("win32con.py;win32con.pyc", sys.path))[0] + ) + ) + + # Python has builtin support for finding a "DLLs" directory, but + # not a PCBuild. Having it in the core paths means it is ignored when + # an EXE not in the Python dir is hosting us - so we add it as a named + # value + check = os.path.join(sys.prefix, "PCBuild") + if "64 bit" in sys.version: + check = os.path.join(check, "amd64") + if os.path.isdir(check): + regutil.RegisterNamedPath("PCBuild", check) + + +def RegisterShellInfo(searchPaths): + """Registers key parts of the Python installation with the Windows Shell. + + Assumes a valid, minimal Python installation exists + (ie, SetupCore() has been previously successfully run) + """ + import regutil + import win32con + + suffix = IsDebug() + # Set up a pointer to the .exe's + exePath = FindRegisterPythonExe("Python%s.exe" % suffix, searchPaths) + regutil.SetRegistryDefaultValue(".py", "Python.File", win32con.HKEY_CLASSES_ROOT) + regutil.RegisterShellCommand("Open", QuotedFileName(exePath) + ' "%1" %*', "&Run") + regutil.SetRegistryDefaultValue( + "Python.File\\DefaultIcon", "%s,0" % exePath, win32con.HKEY_CLASSES_ROOT + ) + + FindRegisterHelpFile("Python.hlp", searchPaths, "Main Python Documentation") + FindRegisterHelpFile("ActivePython.chm", searchPaths, "Main Python Documentation") + + # We consider the win32 core, as it contains all the win32 api type + # stuff we need. + + +# FindRegisterApp("win32", ["win32con.pyc", "win32api%s.pyd" % suffix], searchPaths) + +usage = ( + """\ +regsetup.py - Setup/maintain the registry for Python apps. + +Run without options, (but possibly search paths) to repair a totally broken +python registry setup. This should allow other options to work. + +Usage: %s [options ...] paths ... +-p packageName -- Find and register a package. Looks in the paths for + a sub-directory with the name of the package, and + adds a path entry for the package. +-a appName -- Unconditionally add an application name to the path. + A new path entry is create with the app name, and the + paths specified are added to the registry. +-c -- Add the specified paths to the core Pythonpath. + If a path appears on the core path, and a package also + needs that same path, the package will not bother + registering it. Therefore, By adding paths to the + core path, you can avoid packages re-registering the same path. +-m filename -- Find and register the specific file name as a module. + Do not include a path on the filename! +--shell -- Register everything with the Win95/NT shell. +--upackage name -- Unregister the package +--uapp name -- Unregister the app (identical to --upackage) +--umodule name -- Unregister the module + +--description -- Print a description of the usage. +--examples -- Print examples of usage. +""" + % sys.argv[0] +) + +description = """\ +If no options are processed, the program attempts to validate and set +the standard Python path to the point where the standard library is +available. This can be handy if you move Python to a new drive/sub-directory, +in which case most of the options would fail (as they need at least string.py, +os.py etc to function.) +Running without options should repair Python well enough to run with +the other options. + +paths are search paths that the program will use to seek out a file. +For example, when registering the core Python, you may wish to +provide paths to non-standard places to look for the Python help files, +library files, etc. + +See also the "regcheck.py" utility which will check and dump the contents +of the registry. +""" + +examples = """\ +Examples: +"regsetup c:\\wierd\\spot\\1 c:\\wierd\\spot\\2" +Attempts to setup the core Python. Looks in some standard places, +as well as the 2 wierd spots to locate the core Python files (eg, Python.exe, +python14.dll, the standard library and Win32 Extensions. + +"regsetup -a myappname . .\subdir" +Registers a new Pythonpath entry named myappname, with "C:\\I\\AM\\HERE" and +"C:\\I\\AM\\HERE\subdir" added to the path (ie, all args are converted to +absolute paths) + +"regsetup -c c:\\my\\python\\files" +Unconditionally add "c:\\my\\python\\files" to the 'core' Python path. + +"regsetup -m some.pyd \\windows\\system" +Register the module some.pyd in \\windows\\system as a registered +module. This will allow some.pyd to be imported, even though the +windows system directory is not (usually!) on the Python Path. + +"regsetup --umodule some" +Unregister the module "some". This means normal import rules then apply +for that module. +""" + +if __name__ == "__main__": + if len(sys.argv) > 1 and sys.argv[1] in ["/?", "-?", "-help", "-h"]: + print(usage) + elif len(sys.argv) == 1 or not sys.argv[1][0] in ["/", "-"]: + # No args, or useful args. + searchPath = sys.path[:] + for arg in sys.argv[1:]: + searchPath.append(arg) + # Good chance we are being run from the "regsetup.py" directory. + # Typically this will be "\somewhere\win32\Scripts" and the + # "somewhere" and "..\Lib" should also be searched. + searchPath.append("..\\Build") + searchPath.append("..\\Lib") + searchPath.append("..") + searchPath.append("..\\..") + + # for developers: + # also search somewhere\lib, ..\build, and ..\..\build + searchPath.append("..\\..\\lib") + searchPath.append("..\\build") + if "64 bit" in sys.version: + searchPath.append("..\\..\\pcbuild\\amd64") + else: + searchPath.append("..\\..\\pcbuild") + + print("Attempting to setup/repair the Python core") + + SetupCore(searchPath) + RegisterShellInfo(searchPath) + FindRegisterHelpFile("PyWin32.chm", searchPath, "Pythonwin Reference") + # Check the registry. + print("Registration complete - checking the registry...") + import regcheck + + regcheck.CheckRegistry() + else: + searchPaths = [] + import getopt + + opts, args = getopt.getopt( + sys.argv[1:], + "p:a:m:c", + ["shell", "upackage=", "uapp=", "umodule=", "description", "examples"], + ) + for arg in args: + searchPaths.append(arg) + for o, a in opts: + if o == "--description": + print(description) + if o == "--examples": + print(examples) + if o == "--shell": + print("Registering the Python core.") + RegisterShellInfo(searchPaths) + if o == "-p": + print("Registering package", a) + FindRegisterPackage(a, None, searchPaths) + if o in ["--upackage", "--uapp"]: + import regutil + + print("Unregistering application/package", a) + regutil.UnregisterNamedPath(a) + if o == "-a": + import regutil + + path = ";".join(searchPaths) + print("Registering application", a, "to path", path) + regutil.RegisterNamedPath(a, path) + if o == "-c": + if not len(searchPaths): + raise error("-c option must provide at least one additional path") + import regutil + import win32api + + currentPaths = regutil.GetRegisteredNamedPath(None).split(";") + oldLen = len(currentPaths) + for newPath in searchPaths: + if newPath not in currentPaths: + currentPaths.append(newPath) + if len(currentPaths) != oldLen: + print( + "Registering %d new core paths" % (len(currentPaths) - oldLen) + ) + regutil.RegisterNamedPath(None, ";".join(currentPaths)) + else: + print("All specified paths are already registered.") diff --git a/lib/win32/scripts/setup_d.py b/lib/win32/scripts/setup_d.py new file mode 100644 index 00000000..babd8359 --- /dev/null +++ b/lib/win32/scripts/setup_d.py @@ -0,0 +1,110 @@ +# Install and register pythonxx_d.dll, pywintypesxx_d.dll and pythoncomxx_d.dll +# +# Assumes the _d files can be found in the same directory as this script +# or in the cwd. + +import os +import shutil +import sys +import winreg + +import win32api + + +def usage_and_die(rc): + print() + print("This script is designed to copy and register the Python debug") + print("binaries. It looks for pythonxx_d.dll, pythoncomxx_d.dll etc,") + print("and installs them to work correctly with Python debug builds.") + print() + print("You will generally find this script in the. zip file that") + print("included these _d files. Please run this script from") + print("that directory") + sys.exit(rc) + + +if win32api.__file__.find("_d") > 0: + print("This scripts appears to be running a DEBUG version of Python.") + print("Please run it using a normal release build (python.exe)") + usage_and_die(1) + +try: + import pythoncom +except ImportError as details: + print("Could not import the release version of pythoncom") + print("The error details are: %s" % (details,)) + print("Please correct this error and rerun the script") + usage_and_die(2) + +try: + import pywintypes +except ImportError as details: + print("Could not import the release version of pywintypes") + print("The error details are: %s" % (details,)) + print("Please correct this error and rerun the script") + usage_and_die(2) + + +def _docopy(src, dest): + orig_src = src + if not os.path.isfile(src): + src = os.path.join(os.path.split(sys.argv[0])[0], src) + print( + "Can not find %s or %s to copy" + % (os.path.abspath(orig_src), os.path.abspath(src)) + ) + return 0 + try: + shutil.copy(src, dest) + print("Copied %s -> %s" % (src, dest)) + return 1 + except: + print("Error copying '%s' -> '%s'" % (src, dest)) + print(str(sys.exc_info[1])) + usage_and_die(3) + + +def _doregister(mod_name, dll_name): + assert os.path.isfile(dll_name), "Shouldn't get here if the file doesn't exist!" + try: + key = winreg.OpenKey( + winreg.HKEY_LOCAL_MACHINE, + "Software\\Python\\PythonCore\\%s\\Modules\\%s" % (sys.winver, mod_name), + ) + except winreg.error: + try: + key = winreg.OpenKey( + winreg.HKEY_LOCAL_MACHINE, + "Software\\Python\\PythonCore\\%s\\Modules\\%s" + % (sys.winver, mod_name), + ) + except winreg.error: + print( + "Could not find the existing '%s' module registered in the registry" + % (mod_name,) + ) + usage_and_die(4) + # Create the debug key. + sub_key = winreg.CreateKey(key, "Debug") + winreg.SetValue(sub_key, None, winreg.REG_SZ, dll_name) + print("Registered '%s' in the registry" % (dll_name,)) + + +def _domodule(mod_name, release_mod_filename): + path, fname = os.path.split(release_mod_filename) + base, ext = os.path.splitext(fname) + new_fname = base + "_d" + ext + if _docopy(new_fname, path): + _doregister(mod_name, os.path.abspath(os.path.join(path, new_fname))) + + +# First the main Python DLL. +path, fname = path, fname = os.path.split(win32api.GetModuleFileName(sys.dllhandle)) +base, ext = os.path.splitext(fname) +_docopy(base + "_d" + ext, path) + +# Then pythoncom and pywintypes. +_domodule("pythoncom", pythoncom.__file__) +_domodule("pywintypes", pywintypes.__file__) + +print("System _d files were setup.") diff --git a/lib/win32/test/handles.py b/lib/win32/test/handles.py new file mode 100644 index 00000000..ad607353 --- /dev/null +++ b/lib/win32/test/handles.py @@ -0,0 +1,171 @@ +import sys +import unittest + +import pywintypes +import win32api + + +# A class that will never die vie refcounting, but will die via GC. +class Cycle: + def __init__(self, handle): + self.cycle = self + self.handle = handle + + +class PyHandleTestCase(unittest.TestCase): + def testCleanup1(self): + # We used to clobber all outstanding exceptions. + def f1(invalidate): + import win32event + + h = win32event.CreateEvent(None, 0, 0, None) + if invalidate: + win32api.CloseHandle(int(h)) + 1 / 0 + # If we invalidated, then the object destruction code will attempt + # to close an invalid handle. We don't wan't an exception in + # this case + + def f2(invalidate): + """This function should throw an IOError.""" + try: + f1(invalidate) + except ZeroDivisionError as exc: + raise IOError("raise 2") + + self.assertRaises(IOError, f2, False) + # Now do it again, but so the auto object destruction + # actually fails. + self.assertRaises(IOError, f2, True) + + def testCleanup2(self): + # Cause an exception during object destruction. + # The worst this does is cause an ".XXX undetected error (why=3)" + # So avoiding that is the goal + import win32event + + h = win32event.CreateEvent(None, 0, 0, None) + # Close the handle underneath the object. + win32api.CloseHandle(int(h)) + # Object destructor runs with the implicit close failing + h = None + + def testCleanup3(self): + # And again with a class - no __del__ + import win32event + + class Test: + def __init__(self): + self.h = win32event.CreateEvent(None, 0, 0, None) + win32api.CloseHandle(int(self.h)) + + t = Test() + t = None + + def testCleanupGood(self): + # And check that normal error semantics *do* work. + import win32event + + h = win32event.CreateEvent(None, 0, 0, None) + win32api.CloseHandle(int(h)) + self.assertRaises(win32api.error, h.Close) + # A following Close is documented as working + h.Close() + + def testInvalid(self): + h = pywintypes.HANDLE(-2) + try: + h.Close() + # Ideally, we'd: + # self.assertRaises(win32api.error, h.Close) + # and everywhere markh has tried, that would pass - but not on + # github automation, where the .Close apparently works fine. + # (same for -1. Using 0 appears to work fine everywhere) + # There still seems value in testing it though, so we just accept + # either working or failing. + except win32api.error: + pass + + def testOtherHandle(self): + h = pywintypes.HANDLE(1) + h2 = pywintypes.HANDLE(h) + self.assertEqual(h, h2) + # but the above doesn't really test everything - we want a way to + # pass the handle directly into PyWinLong_AsVoidPtr. One way to + # to that is to abuse win32api.GetProcAddress() - the 2nd param + # is passed to PyWinLong_AsVoidPtr() if its not a string. + # passing a handle value of '1' should work - there is something + # at that ordinal + win32api.GetProcAddress(sys.dllhandle, h) + + def testHandleInDict(self): + h = pywintypes.HANDLE(1) + d = dict(foo=h) + self.assertEqual(d["foo"], h) + + def testHandleInDictThenInt(self): + h = pywintypes.HANDLE(1) + d = dict(foo=h) + self.assertEqual(d["foo"], 1) + + def testHandleCompareNone(self): + h = pywintypes.HANDLE(1) + self.assertNotEqual(h, None) + self.assertNotEqual(None, h) + # ensure we use both __eq__ and __ne__ ops + self.assertFalse(h == None) + self.assertTrue(h != None) + + def testHandleCompareInt(self): + h = pywintypes.HANDLE(1) + self.assertNotEqual(h, 0) + self.assertEqual(h, 1) + # ensure we use both __eq__ and __ne__ ops + self.assertTrue(h == 1) + self.assertTrue(1 == h) + self.assertFalse(h != 1) + self.assertFalse(1 != h) + self.assertFalse(h == 0) + self.assertFalse(0 == h) + self.assertTrue(h != 0) + self.assertTrue(0 != h) + + def testHandleNonZero(self): + h = pywintypes.HANDLE(0) + self.assertFalse(h) + + h = pywintypes.HANDLE(1) + self.assertTrue(h) + + def testLong(self): + # sys.maxint+1 should always be a 'valid' handle, treated as an + # unsigned int, even though it is a long. Although pywin32 should not + # directly create such longs, using struct.unpack() with a P format + # may well return them. eg: + # >>> struct.unpack("P", struct.pack("P", -1)) + # (4294967295L,) + try: + big = sys.maxsize + except AttributeError: + big = sys.maxint + pywintypes.HANDLE(big + 1) + + def testGC(self): + # This used to provoke: + # Fatal Python error: unexpected exception during garbage collection + def make(): + h = pywintypes.HANDLE(-2) + c = Cycle(h) + + import gc + + make() + gc.collect() + + def testTypes(self): + self.assertRaises(TypeError, pywintypes.HANDLE, "foo") + self.assertRaises(TypeError, pywintypes.HANDLE, ()) + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_clipboard.py b/lib/win32/test/test_clipboard.py new file mode 100644 index 00000000..843435b6 --- /dev/null +++ b/lib/win32/test/test_clipboard.py @@ -0,0 +1,127 @@ +# General test module for win32api - please add some :) +import array +import os +import sys +import unittest + +import pywintypes +import win32con +import win32gui +from pywin32_testutil import str2bytes +from win32clipboard import * + +custom_format_name = "PythonClipboardTestFormat" + + +class CrashingTestCase(unittest.TestCase): + def test_722082(self): + class crasher(object): + pass + + obj = crasher() + OpenClipboard() + try: + EmptyClipboard() + # This used to crash - now correctly raises type error. + self.assertRaises(TypeError, SetClipboardData, 0, obj) + finally: + CloseClipboard() + + +class TestBitmap(unittest.TestCase): + def setUp(self): + self.bmp_handle = None + try: + this_file = __file__ + except NameError: + this_file = sys.argv[0] + this_dir = os.path.dirname(this_file) + self.bmp_name = os.path.join( + os.path.abspath(this_dir), "..", "Demos", "images", "smiley.bmp" + ) + self.assertTrue(os.path.isfile(self.bmp_name), self.bmp_name) + flags = win32con.LR_DEFAULTSIZE | win32con.LR_LOADFROMFILE + self.bmp_handle = win32gui.LoadImage( + 0, self.bmp_name, win32con.IMAGE_BITMAP, 0, 0, flags + ) + self.assertTrue(self.bmp_handle, "Failed to get a bitmap handle") + + def tearDown(self): + if self.bmp_handle: + win32gui.DeleteObject(self.bmp_handle) + + def test_bitmap_roundtrip(self): + OpenClipboard() + try: + SetClipboardData(win32con.CF_BITMAP, self.bmp_handle) + got_handle = GetClipboardDataHandle(win32con.CF_BITMAP) + self.assertEqual(got_handle, self.bmp_handle) + finally: + CloseClipboard() + + +class TestStrings(unittest.TestCase): + def setUp(self): + OpenClipboard() + + def tearDown(self): + CloseClipboard() + + def test_unicode(self): + val = "test-\a9har" + SetClipboardData(win32con.CF_UNICODETEXT, val) + self.assertEqual(GetClipboardData(win32con.CF_UNICODETEXT), val) + + def test_unicode_text(self): + val = "test-val" + SetClipboardText(val) + # GetClipboardData doesn't to auto string conversions - so on py3k, + # CF_TEXT returns bytes. + expected = str2bytes(val) + self.assertEqual(GetClipboardData(win32con.CF_TEXT), expected) + SetClipboardText(val, win32con.CF_UNICODETEXT) + self.assertEqual(GetClipboardData(win32con.CF_UNICODETEXT), val) + + def test_string(self): + val = str2bytes("test") + SetClipboardData(win32con.CF_TEXT, val) + self.assertEqual(GetClipboardData(win32con.CF_TEXT), val) + + +class TestGlobalMemory(unittest.TestCase): + def setUp(self): + OpenClipboard() + + def tearDown(self): + CloseClipboard() + + def test_mem(self): + val = str2bytes("test") + expected = str2bytes("test\0") + SetClipboardData(win32con.CF_TEXT, val) + # Get the raw data - this will include the '\0' + raw_data = GetGlobalMemory(GetClipboardDataHandle(win32con.CF_TEXT)) + self.assertEqual(expected, raw_data) + + def test_bad_mem(self): + self.assertRaises(pywintypes.error, GetGlobalMemory, 0) + self.assertRaises(pywintypes.error, GetGlobalMemory, -1) + if sys.getwindowsversion()[0] <= 5: + # For some reason, the value '1' dies from a 64bit process, but + # "works" (ie, gives the correct exception) from a 32bit process. + # just silently skip this value on Vista. + self.assertRaises(pywintypes.error, GetGlobalMemory, 1) + + def test_custom_mem(self): + test_data = str2bytes("hello\x00\xff") + test_buffer = array.array("b", test_data) + cf = RegisterClipboardFormat(custom_format_name) + self.assertEqual(custom_format_name, GetClipboardFormatName(cf)) + SetClipboardData(cf, test_buffer) + hglobal = GetClipboardDataHandle(cf) + data = GetGlobalMemory(hglobal) + self.assertEqual(data, test_data) + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_exceptions.py b/lib/win32/test/test_exceptions.py new file mode 100644 index 00000000..33101107 --- /dev/null +++ b/lib/win32/test/test_exceptions.py @@ -0,0 +1,223 @@ +"""Test pywin32's error semantics""" +import sys +import unittest + +import pythoncom +import pywintypes +import win32api +import win32file +import winerror + + +class TestBase(unittest.TestCase): + def _testExceptionIndex(self, exc, index, expected): + # check the exception itself can be indexed if not py3k + if sys.version_info < (3,): + self.assertEqual(exc[index], expected) + # and that exception.args can is the same. + self.assertEqual(exc.args[index], expected) + + +class TestAPISimple(TestBase): + def _getInvalidHandleException(self): + try: + win32api.CloseHandle(1) + except win32api.error as exc: + return exc + self.fail("Didn't get invalid-handle exception.") + + def testSimple(self): + self.assertRaises(pywintypes.error, win32api.CloseHandle, 1) + + def testErrnoIndex(self): + exc = self._getInvalidHandleException() + self._testExceptionIndex(exc, 0, winerror.ERROR_INVALID_HANDLE) + + def testFuncIndex(self): + exc = self._getInvalidHandleException() + self._testExceptionIndex(exc, 1, "CloseHandle") + + def testMessageIndex(self): + exc = self._getInvalidHandleException() + expected = win32api.FormatMessage(winerror.ERROR_INVALID_HANDLE).rstrip() + self._testExceptionIndex(exc, 2, expected) + + def testUnpack(self): + try: + win32api.CloseHandle(1) + self.fail("expected exception!") + except win32api.error as exc: + self.assertEqual(exc.winerror, winerror.ERROR_INVALID_HANDLE) + self.assertEqual(exc.funcname, "CloseHandle") + expected_msg = win32api.FormatMessage( + winerror.ERROR_INVALID_HANDLE + ).rstrip() + self.assertEqual(exc.strerror, expected_msg) + + def testAsStr(self): + exc = self._getInvalidHandleException() + err_msg = win32api.FormatMessage(winerror.ERROR_INVALID_HANDLE).rstrip() + # early on the result actually *was* a tuple - it must always look like one + err_tuple = (winerror.ERROR_INVALID_HANDLE, "CloseHandle", err_msg) + self.assertEqual(str(exc), str(err_tuple)) + + def testAsTuple(self): + exc = self._getInvalidHandleException() + err_msg = win32api.FormatMessage(winerror.ERROR_INVALID_HANDLE).rstrip() + # early on the result actually *was* a tuple - it must be able to be one + err_tuple = (winerror.ERROR_INVALID_HANDLE, "CloseHandle", err_msg) + if sys.version_info < (3,): + self.assertEqual(tuple(exc), err_tuple) + else: + self.assertEqual(exc.args, err_tuple) + + def testClassName(self): + exc = self._getInvalidHandleException() + # The error class has always been named 'error'. That's not ideal :( + self.assertEqual(exc.__class__.__name__, "error") + + def testIdentity(self): + exc = self._getInvalidHandleException() + self.assertTrue(exc.__class__ is pywintypes.error) + + def testBaseClass(self): + self.assertEqual(pywintypes.error.__bases__, (Exception,)) + + def testAttributes(self): + exc = self._getInvalidHandleException() + err_msg = win32api.FormatMessage(winerror.ERROR_INVALID_HANDLE).rstrip() + self.assertEqual(exc.winerror, winerror.ERROR_INVALID_HANDLE) + self.assertEqual(exc.strerror, err_msg) + self.assertEqual(exc.funcname, "CloseHandle") + + # some tests for 'insane' args. + def testStrangeArgsNone(self): + try: + raise pywintypes.error() + self.fail("Expected exception") + except pywintypes.error as exc: + self.assertEqual(exc.args, ()) + self.assertEqual(exc.winerror, None) + self.assertEqual(exc.funcname, None) + self.assertEqual(exc.strerror, None) + + def testStrangeArgsNotEnough(self): + try: + raise pywintypes.error("foo") + self.fail("Expected exception") + except pywintypes.error as exc: + assert exc.args[0] == "foo" + # 'winerror' always args[0] + self.assertEqual(exc.winerror, "foo") + self.assertEqual(exc.funcname, None) + self.assertEqual(exc.strerror, None) + + def testStrangeArgsTooMany(self): + try: + raise pywintypes.error("foo", "bar", "you", "never", "kn", 0) + self.fail("Expected exception") + except pywintypes.error as exc: + self.assertEqual(exc.args[0], "foo") + self.assertEqual(exc.args[-1], 0) + self.assertEqual(exc.winerror, "foo") + self.assertEqual(exc.funcname, "bar") + self.assertEqual(exc.strerror, "you") + + +class TestCOMSimple(TestBase): + def _getException(self): + try: + pythoncom.StgOpenStorage("foo", None, 0) + except pythoncom.com_error as exc: + return exc + self.fail("Didn't get storage exception.") + + def testIs(self): + self.assertTrue(pythoncom.com_error is pywintypes.com_error) + + def testSimple(self): + self.assertRaises(pythoncom.com_error, pythoncom.StgOpenStorage, "foo", None, 0) + + def testErrnoIndex(self): + exc = self._getException() + self._testExceptionIndex(exc, 0, winerror.STG_E_INVALIDFLAG) + + def testMessageIndex(self): + exc = self._getException() + expected = win32api.FormatMessage(winerror.STG_E_INVALIDFLAG).rstrip() + self._testExceptionIndex(exc, 1, expected) + + def testAsStr(self): + exc = self._getException() + err_msg = win32api.FormatMessage(winerror.STG_E_INVALIDFLAG).rstrip() + # early on the result actually *was* a tuple - it must always look like one + err_tuple = (winerror.STG_E_INVALIDFLAG, err_msg, None, None) + self.assertEqual(str(exc), str(err_tuple)) + + def testAsTuple(self): + exc = self._getException() + err_msg = win32api.FormatMessage(winerror.STG_E_INVALIDFLAG).rstrip() + # early on the result actually *was* a tuple - it must be able to be one + err_tuple = (winerror.STG_E_INVALIDFLAG, err_msg, None, None) + if sys.version_info < (3,): + self.assertEqual(tuple(exc), err_tuple) + else: + self.assertEqual(exc.args, err_tuple) + + def testClassName(self): + exc = self._getException() + self.assertEqual(exc.__class__.__name__, "com_error") + + def testIdentity(self): + exc = self._getException() + self.assertTrue(exc.__class__ is pywintypes.com_error) + + def testBaseClass(self): + exc = self._getException() + self.assertEqual(pywintypes.com_error.__bases__, (Exception,)) + + def testAttributes(self): + exc = self._getException() + err_msg = win32api.FormatMessage(winerror.STG_E_INVALIDFLAG).rstrip() + self.assertEqual(exc.hresult, winerror.STG_E_INVALIDFLAG) + self.assertEqual(exc.strerror, err_msg) + self.assertEqual(exc.argerror, None) + self.assertEqual(exc.excepinfo, None) + + def testStrangeArgsNone(self): + try: + raise pywintypes.com_error() + self.fail("Expected exception") + except pywintypes.com_error as exc: + self.assertEqual(exc.args, ()) + self.assertEqual(exc.hresult, None) + self.assertEqual(exc.strerror, None) + self.assertEqual(exc.argerror, None) + self.assertEqual(exc.excepinfo, None) + + def testStrangeArgsNotEnough(self): + try: + raise pywintypes.com_error("foo") + self.fail("Expected exception") + except pywintypes.com_error as exc: + self.assertEqual(exc.args[0], "foo") + self.assertEqual(exc.hresult, "foo") + self.assertEqual(exc.strerror, None) + self.assertEqual(exc.excepinfo, None) + self.assertEqual(exc.argerror, None) + + def testStrangeArgsTooMany(self): + try: + raise pywintypes.com_error("foo", "bar", "you", "never", "kn", 0) + self.fail("Expected exception") + except pywintypes.com_error as exc: + self.assertEqual(exc.args[0], "foo") + self.assertEqual(exc.args[-1], 0) + self.assertEqual(exc.hresult, "foo") + self.assertEqual(exc.strerror, "bar") + self.assertEqual(exc.excepinfo, "you") + self.assertEqual(exc.argerror, "never") + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_odbc.py b/lib/win32/test/test_odbc.py new file mode 100644 index 00000000..ef2b4516 --- /dev/null +++ b/lib/win32/test/test_odbc.py @@ -0,0 +1,267 @@ +# odbc test suite kindly contributed by Frank Millman. +import os +import sys +import tempfile +import unittest + +import odbc +import pythoncom +from pywin32_testutil import TestSkipped, str2bytes, str2memory +from win32com.client import constants + +# We use the DAO ODBC driver +from win32com.client.gencache import EnsureDispatch + + +class TestStuff(unittest.TestCase): + def setUp(self): + self.tablename = "pywin32test_users" + self.db_filename = None + self.conn = self.cur = None + try: + # Test any database if a connection string is supplied... + conn_str = os.environ["TEST_ODBC_CONNECTION_STRING"] + except KeyError: + # Create a local MSAccess DB for testing. + self.db_filename = tempfile.NamedTemporaryFile().name + ".mdb" + + # Create a brand-new database - what is the story with these? + for suffix in (".36", ".35", ".30"): + try: + dbe = EnsureDispatch("DAO.DBEngine" + suffix) + break + except pythoncom.com_error: + pass + else: + raise TestSkipped("Can't find a DB engine") + + workspace = dbe.Workspaces(0) + + newdb = workspace.CreateDatabase( + self.db_filename, constants.dbLangGeneral, constants.dbEncrypt + ) + + newdb.Close() + + conn_str = "Driver={Microsoft Access Driver (*.mdb)};dbq=%s;Uid=;Pwd=;" % ( + self.db_filename, + ) + ## print 'Connection string:', conn_str + self.conn = odbc.odbc(conn_str) + # And we expect a 'users' table for these tests. + self.cur = self.conn.cursor() + ## self.cur.setoutputsize(1000) + try: + self.cur.execute("""drop table %s""" % self.tablename) + except (odbc.error, odbc.progError): + pass + + ## This needs to be adjusted for sql server syntax for unicode fields + ## - memo -> TEXT + ## - varchar -> nvarchar + self.assertEqual( + self.cur.execute( + """create table %s ( + userid varchar(25), + username varchar(25), + bitfield bit, + intfield integer, + floatfield float, + datefield datetime, + rawfield varbinary(100), + longtextfield memo, + longbinaryfield image + )""" + % self.tablename + ), + -1, + ) + + def tearDown(self): + if self.cur is not None: + try: + self.cur.execute("""drop table %s""" % self.tablename) + except (odbc.error, odbc.progError) as why: + print("Failed to delete test table %s" % self.tablename, why) + + self.cur.close() + self.cur = None + if self.conn is not None: + self.conn.close() + self.conn = None + if self.db_filename is not None: + try: + os.unlink(self.db_filename) + except OSError: + pass + + def test_insert_select(self, userid="Frank", username="Frank Millman"): + self.assertEqual( + self.cur.execute( + "insert into %s (userid, username) \ + values (?,?)" + % self.tablename, + [userid, username], + ), + 1, + ) + self.assertEqual( + self.cur.execute( + "select * from %s \ + where userid = ?" + % self.tablename, + [userid.lower()], + ), + 0, + ) + self.assertEqual( + self.cur.execute( + "select * from %s \ + where username = ?" + % self.tablename, + [username.lower()], + ), + 0, + ) + + def test_insert_select_unicode(self, userid="Frank", username="Frank Millman"): + self.assertEqual( + self.cur.execute( + "insert into %s (userid, username)\ + values (?,?)" + % self.tablename, + [userid, username], + ), + 1, + ) + self.assertEqual( + self.cur.execute( + "select * from %s \ + where userid = ?" + % self.tablename, + [userid.lower()], + ), + 0, + ) + self.assertEqual( + self.cur.execute( + "select * from %s \ + where username = ?" + % self.tablename, + [username.lower()], + ), + 0, + ) + + def test_insert_select_unicode_ext(self): + userid = "t-\xe0\xf2" + username = "test-\xe0\xf2 name" + self.test_insert_select_unicode(userid, username) + + def _test_val(self, fieldName, value): + for x in range(100): + self.cur.execute("delete from %s where userid='Frank'" % self.tablename) + self.assertEqual( + self.cur.execute( + "insert into %s (userid, %s) values (?,?)" + % (self.tablename, fieldName), + ["Frank", value], + ), + 1, + ) + self.cur.execute( + "select %s from %s where userid = ?" % (fieldName, self.tablename), + ["Frank"], + ) + rows = self.cur.fetchmany() + self.assertEqual(1, len(rows)) + row = rows[0] + self.assertEqual(row[0], value) + + def testBit(self): + self._test_val("bitfield", 1) + self._test_val("bitfield", 0) + + def testInt(self): + self._test_val("intfield", 1) + self._test_val("intfield", 0) + try: + big = sys.maxsize + except AttributeError: + big = sys.maxint + self._test_val("intfield", big) + + def testFloat(self): + self._test_val("floatfield", 1.01) + self._test_val("floatfield", 0) + + def testVarchar( + self, + ): + self._test_val("username", "foo") + + def testLongVarchar(self): + """Test a long text field in excess of internal cursor data size (65536)""" + self._test_val("longtextfield", "abc" * 70000) + + def testLongBinary(self): + """Test a long raw field in excess of internal cursor data size (65536)""" + self._test_val("longbinaryfield", str2memory("\0\1\2" * 70000)) + + def testRaw(self): + ## Test binary data + self._test_val("rawfield", str2memory("\1\2\3\4\0\5\6\7\8")) + + def test_widechar(self): + """Test a unicode character that would be mangled if bound as plain character. + For example, previously the below was returned as ascii 'a' + """ + self._test_val("username", "\u0101") + + def testDates(self): + import datetime + + for v in ((1900, 12, 25, 23, 39, 59),): + d = datetime.datetime(*v) + self._test_val("datefield", d) + + def test_set_nonzero_length(self): + self.assertEqual( + self.cur.execute( + "insert into %s (userid,username) " "values (?,?)" % self.tablename, + ["Frank", "Frank Millman"], + ), + 1, + ) + self.assertEqual( + self.cur.execute("update %s set username = ?" % self.tablename, ["Frank"]), + 1, + ) + self.assertEqual(self.cur.execute("select * from %s" % self.tablename), 0) + self.assertEqual(len(self.cur.fetchone()[1]), 5) + + def test_set_zero_length(self): + self.assertEqual( + self.cur.execute( + "insert into %s (userid,username) " "values (?,?)" % self.tablename, + [str2bytes("Frank"), ""], + ), + 1, + ) + self.assertEqual(self.cur.execute("select * from %s" % self.tablename), 0) + self.assertEqual(len(self.cur.fetchone()[1]), 0) + + def test_set_zero_length_unicode(self): + self.assertEqual( + self.cur.execute( + "insert into %s (userid,username) " "values (?,?)" % self.tablename, + ["Frank", ""], + ), + 1, + ) + self.assertEqual(self.cur.execute("select * from %s" % self.tablename), 0) + self.assertEqual(len(self.cur.fetchone()[1]), 0) + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_pywintypes.py b/lib/win32/test/test_pywintypes.py new file mode 100644 index 00000000..bbd9d882 --- /dev/null +++ b/lib/win32/test/test_pywintypes.py @@ -0,0 +1,116 @@ +import datetime +import operator +import sys +import time +import unittest + +import pywintypes +from pywin32_testutil import ob2memory, str2bytes + + +class TestCase(unittest.TestCase): + def testPyTimeFormat(self): + struct_current = time.localtime() + pytime_current = pywintypes.Time(struct_current) + # try and test all the standard parts of the format + # Note we used to include '%Z' testing, but that was pretty useless as + # it always returned the local timezone. + format_strings = "%a %A %b %B %c %d %H %I %j %m %M %p %S %U %w %W %x %X %y %Y" + for fmt in format_strings.split(): + v1 = pytime_current.Format(fmt) + v2 = time.strftime(fmt, struct_current) + self.assertEqual(v1, v2, "format %s failed - %r != %r" % (fmt, v1, v2)) + + def testPyTimePrint(self): + # This used to crash with an invalid, or too early time. + # We don't really want to check that it does cause a ValueError + # (as hopefully this wont be true forever). So either working, or + # ValueError is OK. + try: + t = pywintypes.Time(-2) + t.Format() + except ValueError: + return + + def testTimeInDict(self): + d = {} + d["t1"] = pywintypes.Time(1) + self.assertEqual(d["t1"], pywintypes.Time(1)) + + def testPyTimeCompare(self): + t1 = pywintypes.Time(100) + t1_2 = pywintypes.Time(100) + t2 = pywintypes.Time(101) + + self.assertEqual(t1, t1_2) + self.assertTrue(t1 <= t1_2) + self.assertTrue(t1_2 >= t1) + + self.assertNotEqual(t1, t2) + self.assertTrue(t1 < t2) + self.assertTrue(t2 > t1) + + def testPyTimeCompareOther(self): + t1 = pywintypes.Time(100) + t2 = None + self.assertNotEqual(t1, t2) + + def testTimeTuple(self): + now = datetime.datetime.now() # has usec... + # timetuple() lost usec - pt must be <=... + pt = pywintypes.Time(now.timetuple()) + # *sob* - only if we have a datetime object can we compare like this. + if isinstance(pt, datetime.datetime): + self.assertTrue(pt <= now) + + def testTimeTuplems(self): + now = datetime.datetime.now() # has usec... + tt = now.timetuple() + (now.microsecond // 1000,) + pt = pywintypes.Time(tt) + # we can't compare if using the old type, as it loses all sub-second res. + if isinstance(pt, datetime.datetime): + # but even with datetime, we lose sub-millisecond. + expectedDelta = datetime.timedelta(milliseconds=1) + self.assertTrue(-expectedDelta < (now - pt) < expectedDelta) + + def testPyTimeFromTime(self): + t1 = pywintypes.Time(time.time()) + self.assertTrue(pywintypes.Time(t1) is t1) + + def testPyTimeTooLarge(self): + MAX_TIMESTAMP = 0x7FFFFFFFFFFFFFFF # used by some API function to mean "never" + ts = pywintypes.TimeStamp(MAX_TIMESTAMP) + self.assertEqual(ts, datetime.datetime.max) + + def testGUID(self): + s = "{00020400-0000-0000-C000-000000000046}" + iid = pywintypes.IID(s) + iid2 = pywintypes.IID(ob2memory(iid), True) + self.assertEqual(iid, iid2) + self.assertRaises( + ValueError, pywintypes.IID, str2bytes("00"), True + ) # too short + self.assertRaises(TypeError, pywintypes.IID, 0, True) # no buffer + + def testGUIDRichCmp(self): + s = "{00020400-0000-0000-C000-000000000046}" + iid = pywintypes.IID(s) + self.assertFalse(s == None) + self.assertFalse(None == s) + self.assertTrue(s != None) + self.assertTrue(None != s) + if sys.version_info > (3, 0): + self.assertRaises(TypeError, operator.gt, None, s) + self.assertRaises(TypeError, operator.gt, s, None) + self.assertRaises(TypeError, operator.lt, None, s) + self.assertRaises(TypeError, operator.lt, s, None) + + def testGUIDInDict(self): + s = "{00020400-0000-0000-C000-000000000046}" + iid = pywintypes.IID(s) + d = dict(item=iid) + self.assertEqual(d["item"], iid) + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_security.py b/lib/win32/test/test_security.py new file mode 100644 index 00000000..42a82a13 --- /dev/null +++ b/lib/win32/test/test_security.py @@ -0,0 +1,166 @@ +# Tests for the win32security module. +import unittest + +import ntsecuritycon +import pywintypes +import win32api +import win32con +import win32security +import winerror +from pywin32_testutil import TestSkipped, ob2memory, testmain + + +class SecurityTests(unittest.TestCase): + def setUp(self): + self.pwr_sid = win32security.LookupAccountName("", "Power Users")[0] + try: + self.admin_sid = win32security.LookupAccountName("", "Administrator")[0] + except pywintypes.error as exc: + # in automation we see: + # pywintypes.error: (1332, 'LookupAccountName', 'No mapping between account names and security IDs was done.') + if exc.winerror != winerror.ERROR_NONE_MAPPED: + raise + self.admin_sid = None + + def tearDown(self): + pass + + def testEqual(self): + if self.admin_sid is None: + raise TestSkipped("No 'Administrator' account is available") + self.assertEqual( + win32security.LookupAccountName("", "Administrator")[0], + win32security.LookupAccountName("", "Administrator")[0], + ) + + def testNESID(self): + self.assertTrue(self.pwr_sid == self.pwr_sid) + if self.admin_sid: + self.assertTrue(self.pwr_sid != self.admin_sid) + + def testNEOther(self): + self.assertTrue(self.pwr_sid != None) + self.assertTrue(None != self.pwr_sid) + self.assertFalse(self.pwr_sid == None) + self.assertFalse(None == self.pwr_sid) + self.assertNotEqual(None, self.pwr_sid) + + def testSIDInDict(self): + d = dict(foo=self.pwr_sid) + self.assertEqual(d["foo"], self.pwr_sid) + + def testBuffer(self): + if self.admin_sid is None: + raise TestSkipped("No 'Administrator' account is available") + self.assertEqual( + ob2memory(win32security.LookupAccountName("", "Administrator")[0]), + ob2memory(win32security.LookupAccountName("", "Administrator")[0]), + ) + + def testMemory(self): + pwr_sid = self.pwr_sid + admin_sid = self.admin_sid + sd1 = win32security.SECURITY_DESCRIPTOR() + sd2 = win32security.SECURITY_DESCRIPTOR() + sd3 = win32security.SECURITY_DESCRIPTOR() + dacl = win32security.ACL() + dacl.AddAccessAllowedAce( + win32security.ACL_REVISION, win32con.GENERIC_READ, pwr_sid + ) + if admin_sid is not None: + dacl.AddAccessAllowedAce( + win32security.ACL_REVISION, win32con.GENERIC_ALL, admin_sid + ) + sd4 = win32security.SECURITY_DESCRIPTOR() + sacl = win32security.ACL() + if admin_sid is not None: + sacl.AddAuditAccessAce( + win32security.ACL_REVISION, win32con.DELETE, admin_sid, 1, 1 + ) + sacl.AddAuditAccessAce( + win32security.ACL_REVISION, win32con.GENERIC_ALL, pwr_sid, 1, 1 + ) + for x in range(0, 200000): + if admin_sid is not None: + sd1.SetSecurityDescriptorOwner(admin_sid, 0) + sd2.SetSecurityDescriptorGroup(pwr_sid, 0) + sd3.SetSecurityDescriptorDacl(1, dacl, 0) + sd4.SetSecurityDescriptorSacl(1, sacl, 0) + + +class DomainTests(unittest.TestCase): + def setUp(self): + self.ds_handle = None + try: + # saving the handle means the other test itself should bind faster. + self.ds_handle = win32security.DsBind() + except win32security.error as exc: + if exc.winerror != winerror.ERROR_NO_SUCH_DOMAIN: + raise + raise TestSkipped(exc) + + def tearDown(self): + if self.ds_handle is not None: + self.ds_handle.close() + + +class TestDS(DomainTests): + def testDsGetDcName(self): + # Not sure what we can actually test here! At least calling it + # does something :) + win32security.DsGetDcName() + + def testDsListServerInfo(self): + # again, not checking much, just exercising the code. + h = win32security.DsBind() + for status, ignore, site in win32security.DsListSites(h): + for status, ignore, server in win32security.DsListServersInSite(h, site): + info = win32security.DsListInfoForServer(h, server) + for status, ignore, domain in win32security.DsListDomainsInSite(h, site): + pass + + def testDsCrackNames(self): + h = win32security.DsBind() + fmt_offered = ntsecuritycon.DS_FQDN_1779_NAME + name = win32api.GetUserNameEx(fmt_offered) + result = win32security.DsCrackNames(h, 0, fmt_offered, fmt_offered, (name,)) + self.assertEqual(name, result[0][2]) + + def testDsCrackNamesSyntax(self): + # Do a syntax check only - that allows us to avoid binding. + # But must use DS_CANONICAL_NAME (or _EX) + expected = win32api.GetUserNameEx(win32api.NameCanonical) + fmt_offered = ntsecuritycon.DS_FQDN_1779_NAME + name = win32api.GetUserNameEx(fmt_offered) + result = win32security.DsCrackNames( + None, + ntsecuritycon.DS_NAME_FLAG_SYNTACTICAL_ONLY, + fmt_offered, + ntsecuritycon.DS_CANONICAL_NAME, + (name,), + ) + self.assertEqual(expected, result[0][2]) + + +class TestTranslate(DomainTests): + def _testTranslate(self, fmt_from, fmt_to): + name = win32api.GetUserNameEx(fmt_from) + expected = win32api.GetUserNameEx(fmt_to) + got = win32security.TranslateName(name, fmt_from, fmt_to) + self.assertEqual(got, expected) + + def testTranslate1(self): + self._testTranslate(win32api.NameFullyQualifiedDN, win32api.NameSamCompatible) + + def testTranslate2(self): + self._testTranslate(win32api.NameSamCompatible, win32api.NameFullyQualifiedDN) + + def testTranslate3(self): + self._testTranslate(win32api.NameFullyQualifiedDN, win32api.NameUniqueId) + + def testTranslate4(self): + self._testTranslate(win32api.NameUniqueId, win32api.NameFullyQualifiedDN) + + +if __name__ == "__main__": + testmain() diff --git a/lib/win32/test/test_sspi.py b/lib/win32/test/test_sspi.py new file mode 100644 index 00000000..5d349d4d --- /dev/null +++ b/lib/win32/test/test_sspi.py @@ -0,0 +1,231 @@ +# Some tests of the win32security sspi functions. +# Stolen from Roger's original test_sspi.c, a version of which is in "Demos" +# See also the other SSPI demos. +import re +import unittest + +import sspi +import sspicon +import win32api +import win32security +from pywin32_testutil import TestSkipped, str2bytes, testmain + + +# It is quite likely that the Kerberos tests will fail due to not being +# installed. The NTLM tests do *not* get the same behaviour as they should +# always be there. +def applyHandlingSkips(func, *args): + try: + return func(*args) + except win32api.error as exc: + if exc.winerror in [ + sspicon.SEC_E_NO_CREDENTIALS, + sspicon.SEC_E_NO_AUTHENTICATING_AUTHORITY, + ]: + raise TestSkipped(exc) + raise + + +class TestSSPI(unittest.TestCase): + def assertRaisesHRESULT(self, hr, func, *args): + try: + return func(*args) + raise RuntimeError("expecting %s failure" % (hr,)) + except win32security.error as exc: + self.assertEqual(exc.winerror, hr) + + def _doAuth(self, pkg_name): + sspiclient = sspi.ClientAuth(pkg_name, targetspn=win32api.GetUserName()) + sspiserver = sspi.ServerAuth(pkg_name) + + sec_buffer = None + err = 1 + while err != 0: + err, sec_buffer = sspiclient.authorize(sec_buffer) + err, sec_buffer = sspiserver.authorize(sec_buffer) + return sspiclient, sspiserver + + def _doTestImpersonate(self, pkg_name): + # Just for the sake of code exercising! + sspiclient, sspiserver = self._doAuth(pkg_name) + sspiserver.ctxt.ImpersonateSecurityContext() + sspiserver.ctxt.RevertSecurityContext() + + def testImpersonateKerberos(self): + applyHandlingSkips(self._doTestImpersonate, "Kerberos") + + def testImpersonateNTLM(self): + self._doTestImpersonate("NTLM") + + def _doTestEncrypt(self, pkg_name): + sspiclient, sspiserver = self._doAuth(pkg_name) + + pkg_size_info = sspiclient.ctxt.QueryContextAttributes( + sspicon.SECPKG_ATTR_SIZES + ) + msg = str2bytes("some data to be encrypted ......") + + trailersize = pkg_size_info["SecurityTrailer"] + encbuf = win32security.PySecBufferDescType() + encbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA)) + encbuf.append( + win32security.PySecBufferType(trailersize, sspicon.SECBUFFER_TOKEN) + ) + encbuf[0].Buffer = msg + sspiclient.ctxt.EncryptMessage(0, encbuf, 1) + sspiserver.ctxt.DecryptMessage(encbuf, 1) + self.assertEqual(msg, encbuf[0].Buffer) + # and test the higher-level functions + data_in = str2bytes("hello") + data, sig = sspiclient.encrypt(data_in) + self.assertEqual(sspiserver.decrypt(data, sig), data_in) + + data, sig = sspiserver.encrypt(data_in) + self.assertEqual(sspiclient.decrypt(data, sig), data_in) + + def _doTestEncryptStream(self, pkg_name): + # Test out the SSPI/GSSAPI interop wrapping examples at + # https://docs.microsoft.com/en-us/windows/win32/secauthn/sspi-kerberos-interoperability-with-gssapi + + sspiclient, sspiserver = self._doAuth(pkg_name) + + pkg_size_info = sspiclient.ctxt.QueryContextAttributes( + sspicon.SECPKG_ATTR_SIZES + ) + msg = str2bytes("some data to be encrypted ......") + + trailersize = pkg_size_info["SecurityTrailer"] + blocksize = pkg_size_info["BlockSize"] + encbuf = win32security.PySecBufferDescType() + encbuf.append( + win32security.PySecBufferType(trailersize, sspicon.SECBUFFER_TOKEN) + ) + encbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA)) + encbuf.append( + win32security.PySecBufferType(blocksize, sspicon.SECBUFFER_PADDING) + ) + encbuf[1].Buffer = msg + sspiclient.ctxt.EncryptMessage(0, encbuf, 1) + + encmsg = encbuf[0].Buffer + encbuf[1].Buffer + encbuf[2].Buffer + decbuf = win32security.PySecBufferDescType() + decbuf.append( + win32security.PySecBufferType(len(encmsg), sspicon.SECBUFFER_STREAM) + ) + decbuf.append(win32security.PySecBufferType(0, sspicon.SECBUFFER_DATA)) + decbuf[0].Buffer = encmsg + + sspiserver.ctxt.DecryptMessage(decbuf, 1) + self.assertEqual(msg, decbuf[1].Buffer) + + def testEncryptNTLM(self): + self._doTestEncrypt("NTLM") + + def testEncryptStreamNTLM(self): + self._doTestEncryptStream("NTLM") + + def testEncryptKerberos(self): + applyHandlingSkips(self._doTestEncrypt, "Kerberos") + + def testEncryptStreamKerberos(self): + applyHandlingSkips(self._doTestEncryptStream, "Kerberos") + + def _doTestSign(self, pkg_name): + sspiclient, sspiserver = self._doAuth(pkg_name) + + pkg_size_info = sspiclient.ctxt.QueryContextAttributes( + sspicon.SECPKG_ATTR_SIZES + ) + msg = str2bytes("some data to be encrypted ......") + + sigsize = pkg_size_info["MaxSignature"] + sigbuf = win32security.PySecBufferDescType() + sigbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA)) + sigbuf.append(win32security.PySecBufferType(sigsize, sspicon.SECBUFFER_TOKEN)) + sigbuf[0].Buffer = msg + sspiclient.ctxt.MakeSignature(0, sigbuf, 0) + sspiserver.ctxt.VerifySignature(sigbuf, 0) + # and test the higher-level functions + sspiclient.next_seq_num = 1 + sspiserver.next_seq_num = 1 + data = str2bytes("hello") + key = sspiclient.sign(data) + sspiserver.verify(data, key) + key = sspiclient.sign(data) + self.assertRaisesHRESULT( + sspicon.SEC_E_MESSAGE_ALTERED, sspiserver.verify, data + data, key + ) + + # and the other way + key = sspiserver.sign(data) + sspiclient.verify(data, key) + key = sspiserver.sign(data) + self.assertRaisesHRESULT( + sspicon.SEC_E_MESSAGE_ALTERED, sspiclient.verify, data + data, key + ) + + def testSignNTLM(self): + self._doTestSign("NTLM") + + def testSignKerberos(self): + applyHandlingSkips(self._doTestSign, "Kerberos") + + def _testSequenceSign(self): + # Only Kerberos supports sequence detection. + sspiclient, sspiserver = self._doAuth("Kerberos") + key = sspiclient.sign(b"hello") + sspiclient.sign(b"hello") + self.assertRaisesHRESULT( + sspicon.SEC_E_OUT_OF_SEQUENCE, sspiserver.verify, b"hello", key + ) + + def testSequenceSign(self): + applyHandlingSkips(self._testSequenceSign) + + def _testSequenceEncrypt(self): + # Only Kerberos supports sequence detection. + sspiclient, sspiserver = self._doAuth("Kerberos") + blob, key = sspiclient.encrypt(b"hello") + blob, key = sspiclient.encrypt(b"hello") + self.assertRaisesHRESULT( + sspicon.SEC_E_OUT_OF_SEQUENCE, sspiserver.decrypt, blob, key + ) + + def testSequenceEncrypt(self): + applyHandlingSkips(self._testSequenceEncrypt) + + def testSecBufferRepr(self): + desc = win32security.PySecBufferDescType() + assert re.match( + "PySecBufferDesc\(ulVersion: 0 \| cBuffers: 0 \| pBuffers: 0x[\da-fA-F]{8,16}\)", + repr(desc), + ) + + buffer1 = win32security.PySecBufferType(0, sspicon.SECBUFFER_TOKEN) + assert re.match( + "PySecBuffer\(cbBuffer: 0 \| BufferType: 2 \| pvBuffer: 0x[\da-fA-F]{8,16}\)", + repr(buffer1), + ) + "PySecBuffer(cbBuffer: 0 | BufferType: 2 | pvBuffer: 0x000001B8CC6D8020)" + desc.append(buffer1) + + assert re.match( + "PySecBufferDesc\(ulVersion: 0 \| cBuffers: 1 \| pBuffers: 0x[\da-fA-F]{8,16}\)", + repr(desc), + ) + + buffer2 = win32security.PySecBufferType(4, sspicon.SECBUFFER_DATA) + assert re.match( + "PySecBuffer\(cbBuffer: 4 \| BufferType: 1 \| pvBuffer: 0x[\da-fA-F]{8,16}\)", + repr(buffer2), + ) + desc.append(buffer2) + + assert re.match( + "PySecBufferDesc\(ulVersion: 0 \| cBuffers: 2 \| pBuffers: 0x[\da-fA-F]{8,16}\)", + repr(desc), + ) + + +if __name__ == "__main__": + testmain() diff --git a/lib/win32/test/test_win32api.py b/lib/win32/test/test_win32api.py new file mode 100644 index 00000000..58ac1597 --- /dev/null +++ b/lib/win32/test/test_win32api.py @@ -0,0 +1,268 @@ +# General test module for win32api - please add some :) + +import datetime +import os +import sys +import tempfile +import unittest + +import win32api +import win32con +import win32event +import winerror +from pywin32_testutil import TestSkipped, str2bytes + + +class CurrentUserTestCase(unittest.TestCase): + def testGetCurrentUser(self): + domain = win32api.GetDomainName() + if domain == "NT AUTHORITY": + # Running as a service account, so the comparison will fail + raise TestSkipped("running as service account") + name = "%s\\%s" % (domain, win32api.GetUserName()) + self.assertEqual(name, win32api.GetUserNameEx(win32api.NameSamCompatible)) + + +class TestTime(unittest.TestCase): + def testTimezone(self): + # GetTimeZoneInformation + rc, tzinfo = win32api.GetTimeZoneInformation() + if rc == win32con.TIME_ZONE_ID_DAYLIGHT: + tz_str = tzinfo[4] + tz_time = tzinfo[5] + else: + tz_str = tzinfo[1] + tz_time = tzinfo[2] + # for the sake of code exercise but don't output + tz_str.encode() + if not isinstance(tz_time, datetime.datetime) and not isinstance( + tz_time, tuple + ): + tz_time.Format() + + def TestDateFormat(self): + DATE_LONGDATE = 2 + date_flags = DATE_LONGDATE + win32api.GetDateFormat(0, date_flags, None) + win32api.GetDateFormat(0, date_flags, 0) + win32api.GetDateFormat(0, date_flags, datetime.datetime.now()) + win32api.GetDateFormat(0, date_flags, time.time()) + + def TestTimeFormat(self): + win32api.GetTimeFormat(0, 0, None) + win32api.GetTimeFormat(0, 0, 0) + win32api.GetTimeFormat(0, 0, datetime.datetime.now()) + win32api.GetTimeFormat(0, 0, time.time()) + + +class Registry(unittest.TestCase): + key_name = r"PythonTestHarness\Whatever" + + def test1(self): + # This used to leave a stale exception behind. + def reg_operation(): + hkey = win32api.RegCreateKey(win32con.HKEY_CURRENT_USER, self.key_name) + x = 3 / 0 # or a statement like: raise 'error' + + # do the test + try: + try: + try: + reg_operation() + except: + 1 / 0 # Force exception + finally: + win32api.RegDeleteKey(win32con.HKEY_CURRENT_USER, self.key_name) + except ZeroDivisionError: + pass + + def testValues(self): + key_name = r"PythonTestHarness\win32api" + ## tuples containing value name, value type, data + values = ( + (None, win32con.REG_SZ, "This is default unnamed value"), + ("REG_SZ", win32con.REG_SZ, "REG_SZ text data"), + ("REG_EXPAND_SZ", win32con.REG_EXPAND_SZ, "%systemdir%"), + ## REG_MULTI_SZ value needs to be a list since strings are returned as a list + ( + "REG_MULTI_SZ", + win32con.REG_MULTI_SZ, + ["string 1", "string 2", "string 3", "string 4"], + ), + ("REG_MULTI_SZ_empty", win32con.REG_MULTI_SZ, []), + ("REG_DWORD", win32con.REG_DWORD, 666), + ("REG_QWORD_INT", win32con.REG_QWORD, 99), + ("REG_QWORD", win32con.REG_QWORD, 2**33), + ( + "REG_BINARY", + win32con.REG_BINARY, + str2bytes("\x00\x01\x02\x03\x04\x05\x06\x07\x08\x01\x00"), + ), + ) + + hkey = win32api.RegCreateKey(win32con.HKEY_CURRENT_USER, key_name) + for value_name, reg_type, data in values: + win32api.RegSetValueEx(hkey, value_name, None, reg_type, data) + + for value_name, orig_type, orig_data in values: + data, typ = win32api.RegQueryValueEx(hkey, value_name) + self.assertEqual(typ, orig_type) + self.assertEqual(data, orig_data) + + def testNotifyChange(self): + def change(): + hkey = win32api.RegCreateKey(win32con.HKEY_CURRENT_USER, self.key_name) + try: + win32api.RegSetValue(hkey, None, win32con.REG_SZ, "foo") + finally: + win32api.RegDeleteKey(win32con.HKEY_CURRENT_USER, self.key_name) + + evt = win32event.CreateEvent(None, 0, 0, None) + ## REG_NOTIFY_CHANGE_LAST_SET - values + ## REG_CHANGE_NOTIFY_NAME - keys + ## REG_NOTIFY_CHANGE_SECURITY - security descriptor + ## REG_NOTIFY_CHANGE_ATTRIBUTES + win32api.RegNotifyChangeKeyValue( + win32con.HKEY_CURRENT_USER, + 1, + win32api.REG_NOTIFY_CHANGE_LAST_SET, + evt, + True, + ) + ret_code = win32event.WaitForSingleObject(evt, 0) + # Should be no change. + self.assertTrue(ret_code == win32con.WAIT_TIMEOUT) + change() + # Our event should now be in a signalled state. + ret_code = win32event.WaitForSingleObject(evt, 0) + self.assertTrue(ret_code == win32con.WAIT_OBJECT_0) + + +class FileNames(unittest.TestCase): + def testShortLongPathNames(self): + try: + me = __file__ + except NameError: + me = sys.argv[0] + fname = os.path.abspath(me).lower() + short_name = win32api.GetShortPathName(fname).lower() + long_name = win32api.GetLongPathName(short_name).lower() + self.assertTrue( + long_name == fname, + "Expected long name ('%s') to be original name ('%s')" % (long_name, fname), + ) + self.assertEqual(long_name, win32api.GetLongPathNameW(short_name).lower()) + long_name = win32api.GetLongPathNameW(short_name).lower() + self.assertTrue( + type(long_name) == str, + "GetLongPathNameW returned type '%s'" % (type(long_name),), + ) + self.assertTrue( + long_name == fname, + "Expected long name ('%s') to be original name ('%s')" % (long_name, fname), + ) + + def testShortUnicodeNames(self): + try: + me = __file__ + except NameError: + me = sys.argv[0] + fname = os.path.abspath(me).lower() + # passing unicode should cause GetShortPathNameW to be called. + short_name = win32api.GetShortPathName(str(fname)).lower() + self.assertTrue(isinstance(short_name, str)) + long_name = win32api.GetLongPathName(short_name).lower() + self.assertTrue( + long_name == fname, + "Expected long name ('%s') to be original name ('%s')" % (long_name, fname), + ) + self.assertEqual(long_name, win32api.GetLongPathNameW(short_name).lower()) + long_name = win32api.GetLongPathNameW(short_name).lower() + self.assertTrue( + type(long_name) == str, + "GetLongPathNameW returned type '%s'" % (type(long_name),), + ) + self.assertTrue( + long_name == fname, + "Expected long name ('%s') to be original name ('%s')" % (long_name, fname), + ) + + def testLongLongPathNames(self): + # We need filename where the FQN is > 256 - simplest way is to create a + # 250 character directory in the cwd (except - cwd may be on a drive + # not supporting \\\\?\\ (eg, network share) - so use temp. + import win32file + + basename = "a" * 250 + # but we need to ensure we use the 'long' version of the + # temp dir for later comparison. + long_temp_dir = win32api.GetLongPathNameW(tempfile.gettempdir()) + fname = "\\\\?\\" + os.path.join(long_temp_dir, basename) + try: + win32file.CreateDirectoryW(fname, None) + except win32api.error as details: + if details.winerror != winerror.ERROR_ALREADY_EXISTS: + raise + try: + # GetFileAttributes automatically calls GetFileAttributesW when + # passed unicode + try: + attr = win32api.GetFileAttributes(fname) + except win32api.error as details: + if details.winerror != winerror.ERROR_FILENAME_EXCED_RANGE: + raise + + attr = win32api.GetFileAttributes(str(fname)) + self.assertTrue(attr & win32con.FILE_ATTRIBUTE_DIRECTORY, attr) + + long_name = win32api.GetLongPathNameW(fname) + self.assertEqual(long_name.lower(), fname.lower()) + finally: + win32file.RemoveDirectory(fname) + + +class FormatMessage(unittest.TestCase): + def test_FromString(self): + msg = "Hello %1, how are you %2?" + inserts = ["Mark", "today"] + result = win32api.FormatMessage( + win32con.FORMAT_MESSAGE_FROM_STRING, + msg, # source + 0, # ID + 0, # LangID + inserts, + ) + self.assertEqual(result, "Hello Mark, how are you today?") + + +class Misc(unittest.TestCase): + def test_last_error(self): + for x in (0, 1, -1, winerror.TRUST_E_PROVIDER_UNKNOWN): + win32api.SetLastError(x) + self.assertEqual(x, win32api.GetLastError()) + + def testVkKeyScan(self): + # hopefully ' ' doesn't depend on the locale! + self.assertEqual(win32api.VkKeyScan(" "), 32) + + def testVkKeyScanEx(self): + # hopefully ' ' doesn't depend on the locale! + self.assertEqual(win32api.VkKeyScanEx(" ", 0), 32) + + def testGetSystemPowerStatus(self): + # Dummy + sps = win32api.GetSystemPowerStatus() + self.assertIsInstance(sps, dict) + test_keys = ( + "ACLineStatus", + "BatteryFlag", + "BatteryLifePercent", + "SystemStatusFlag", + "BatteryLifeTime", + "BatteryFullLifeTime", + ) + self.assertEqual(set(test_keys), set(sps.keys())) + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_win32crypt.py b/lib/win32/test/test_win32crypt.py new file mode 100644 index 00000000..4d1fa712 --- /dev/null +++ b/lib/win32/test/test_win32crypt.py @@ -0,0 +1,129 @@ +# Test module for win32crypt + +import contextlib +import unittest +from typing import Any, Iterator + +import win32crypt +from pywin32_testutil import TestSkipped, find_test_fixture, testmain +from win32cryptcon import * + + +class Crypt(unittest.TestCase): + def testSimple(self): + data = b"My test data" + entropy = None + desc = "My description" + flags = 0 + ps = None + blob = win32crypt.CryptProtectData(data, desc, entropy, None, ps, flags) + got_desc, got_data = win32crypt.CryptUnprotectData( + blob, entropy, None, ps, flags + ) + self.assertEqual(data, got_data) + self.assertEqual(desc, got_desc) + + def testEntropy(self): + data = b"My test data" + entropy = b"My test entropy" + desc = "My description" + flags = 0 + ps = None + blob = win32crypt.CryptProtectData(data, desc, entropy, None, ps, flags) + got_desc, got_data = win32crypt.CryptUnprotectData( + blob, entropy, None, ps, flags + ) + self.assertEqual(data, got_data) + self.assertEqual(desc, got_desc) + + +# via https://github.com/mhammond/pywin32/issues/1859 +_LOCAL_MACHINE = "LocalMachine" +_CURRENT_USER = "CurrentUser" + + +@contextlib.contextmanager +def open_windows_certstore(store_name: str, store_location: str) -> Iterator[Any]: + """Open a windows certificate store + + :param store_name: store name + :param store_location: store location + :return: handle to cert store + """ + handle = None + try: + handle = win32crypt.CertOpenStore( + CERT_STORE_PROV_SYSTEM, + 0, + None, + CERT_SYSTEM_STORE_LOCAL_MACHINE + if store_location == _LOCAL_MACHINE + else CERT_SYSTEM_STORE_CURRENT_USER, + store_name, + ) + yield handle + finally: + if handle is not None: + handle.CertCloseStore() + + +class TestCerts(unittest.TestCase): + def readCertFile(self, file_name): + with open(find_test_fixture(file_name), "rb") as f: + buf = bytearray(f.read()) + return win32crypt.CryptQueryObject( + CERT_QUERY_OBJECT_BLOB, + buf, + CERT_QUERY_CONTENT_FLAG_CERT, + CERT_QUERY_FORMAT_FLAG_ALL, + 0, + ) + + def testReadCertFiles(self): + # readCertFile has Python read the file and load it as a blob. + # win32crypt can read the file directly - let's check that works too + # (ideally we'd compare the 2 approaches etc, but the objects don't support + # equality checks etc, so this will do for now.) + # No need to do this for different filenames! + filename = "win32crypt_testcert_base64.cer" + cert = win32crypt.CryptQueryObject( + CERT_QUERY_OBJECT_FILE, + find_test_fixture(filename), + CERT_QUERY_CONTENT_FLAG_CERT, + CERT_QUERY_FORMAT_FLAG_ALL, + 0, + ) + self.assertEqual(cert["FormatType"], CERT_QUERY_FORMAT_BASE64_ENCODED) + self.assertEqual(cert["ContentType"], CERT_QUERY_CONTENT_CERT) + + def checkCertFile(self, filename, expected_format): + cert = self.readCertFile(filename) + self.assertEqual(cert["FormatType"], expected_format) + self.assertEqual(cert["ContentType"], CERT_QUERY_CONTENT_CERT) + + with open_windows_certstore(_CURRENT_USER, "Temp") as store: + context = store.CertAddCertificateContextToStore( + cert["Context"], CERT_STORE_ADD_REPLACE_EXISTING + ) + # Getting 2 certs here - main thing is we get 1! + self.assertTrue(len(store.CertEnumCertificatesInStore())) + self.assertFalse(len(store.CertEnumCTLsInStore())) + context.CertFreeCertificateContext() + try: + context.CertFreeCertificateContext() + except ValueError: + pass + else: + raise RuntimeError("should not be able to close the context twice") + + def testCertBase64(self): + self.checkCertFile( + "win32crypt_testcert_base64.cer", CERT_QUERY_FORMAT_BASE64_ENCODED + ) + + def testCertBinary(self): + self.checkCertFile("win32crypt_testcert_bin.cer", CERT_QUERY_FORMAT_BINARY) + + +if __name__ == "__main__": + testmain() diff --git a/lib/win32/test/test_win32event.py b/lib/win32/test/test_win32event.py new file mode 100644 index 00000000..9e6efa3f --- /dev/null +++ b/lib/win32/test/test_win32event.py @@ -0,0 +1,119 @@ +import unittest + +import pywintypes +import win32event + + +class TestWaitableTimer(unittest.TestCase): + def testWaitableFire(self): + h = win32event.CreateWaitableTimer(None, 0, None) + dt = -160 # 160 ns. + win32event.SetWaitableTimer(h, dt, 0, None, None, 0) + rc = win32event.WaitForSingleObject(h, 1000) + self.assertEqual(rc, win32event.WAIT_OBJECT_0) + + def testCreateWaitableTimerEx(self): + h = win32event.CreateWaitableTimerEx( + None, + None, + win32event.CREATE_WAITABLE_TIMER_HIGH_RESOLUTION, + win32event.TIMER_ALL_ACCESS, + ) + dt = -160 # 160 ns. + win32event.SetWaitableTimer(h, dt, 0, None, None, 0) + rc = win32event.WaitForSingleObject(h, 1000) + self.assertEqual(rc, win32event.WAIT_OBJECT_0) + + def testWaitableTrigger(self): + h = win32event.CreateWaitableTimer(None, 0, None) + # for the sake of this, pass a long that doesn't fit in an int. + dt = -2000000000 + win32event.SetWaitableTimer(h, dt, 0, None, None, 0) + rc = win32event.WaitForSingleObject(h, 10) # 10 ms. + self.assertEqual(rc, win32event.WAIT_TIMEOUT) + + def testWaitableError(self): + h = win32event.CreateWaitableTimer(None, 0, None) + h.close() + self.assertRaises( + pywintypes.error, win32event.SetWaitableTimer, h, -42, 0, None, None, 0 + ) + + +class TestWaitFunctions(unittest.TestCase): + def testMsgWaitForMultipleObjects(self): + # this function used to segfault when called with an empty list + res = win32event.MsgWaitForMultipleObjects([], 0, 0, 0) + self.assertEqual(res, win32event.WAIT_TIMEOUT) + + def testMsgWaitForMultipleObjects2(self): + # test with non-empty list + event = win32event.CreateEvent(None, 0, 0, None) + res = win32event.MsgWaitForMultipleObjects([event], 0, 0, 0) + self.assertEqual(res, win32event.WAIT_TIMEOUT) + + def testMsgWaitForMultipleObjectsEx(self): + # this function used to segfault when called with an empty list + res = win32event.MsgWaitForMultipleObjectsEx([], 0, 0, 0) + self.assertEqual(res, win32event.WAIT_TIMEOUT) + + def testMsgWaitForMultipleObjectsEx2(self): + # test with non-empty list + event = win32event.CreateEvent(None, 0, 0, None) + res = win32event.MsgWaitForMultipleObjectsEx([event], 0, 0, 0) + self.assertEqual(res, win32event.WAIT_TIMEOUT) + + +class TestEvent(unittest.TestCase): + def assertSignaled(self, event): + self.assertEqual( + win32event.WaitForSingleObject(event, 0), win32event.WAIT_OBJECT_0 + ) + + def assertNotSignaled(self, event): + self.assertEqual( + win32event.WaitForSingleObject(event, 0), win32event.WAIT_TIMEOUT + ) + + def testCreateEvent(self): + event = win32event.CreateEvent(None, False, False, None) + self.assertNotSignaled(event) + event = win32event.CreateEvent(None, False, True, None) + self.assertSignaled(event) + self.assertNotSignaled(event) + event = win32event.CreateEvent(None, True, True, None) + self.assertSignaled(event) + self.assertSignaled(event) + + def testSetEvent(self): + event = win32event.CreateEvent(None, True, False, None) + self.assertNotSignaled(event) + res = win32event.SetEvent(event) + self.assertEqual(res, None) + self.assertSignaled(event) + event.close() + self.assertRaises(pywintypes.error, win32event.SetEvent, event) + + def testResetEvent(self): + event = win32event.CreateEvent(None, True, True, None) + self.assertSignaled(event) + res = win32event.ResetEvent(event) + self.assertEqual(res, None) + self.assertNotSignaled(event) + event.close() + self.assertRaises(pywintypes.error, win32event.ResetEvent, event) + + +class TestMutex(unittest.TestCase): + def testReleaseMutex(self): + mutex = win32event.CreateMutex(None, True, None) + res = win32event.ReleaseMutex(mutex) + self.assertEqual(res, None) + res = win32event.WaitForSingleObject(mutex, 0) + self.assertEqual(res, win32event.WAIT_OBJECT_0) + mutex.close() + self.assertRaises(pywintypes.error, win32event.ReleaseMutex, mutex) + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_win32file.py b/lib/win32/test/test_win32file.py new file mode 100644 index 00000000..da998032 --- /dev/null +++ b/lib/win32/test/test_win32file.py @@ -0,0 +1,1085 @@ +import datetime +import os +import random +import shutil +import socket +import tempfile +import threading +import time +import unittest + +import ntsecuritycon +import pywintypes +import win32api +import win32con +import win32event +import win32file +import win32pipe +import win32timezone +import winerror +from pywin32_testutil import TestSkipped, str2bytes, testmain + +try: + set +except NameError: + from sets import Set as set + + +class TestReadBuffer(unittest.TestCase): + def testLen(self): + buffer = win32file.AllocateReadBuffer(1) + self.assertEqual(len(buffer), 1) + + def testSimpleIndex(self): + buffer = win32file.AllocateReadBuffer(1) + buffer[0] = 0xFF + self.assertEqual(buffer[0], 0xFF) + + def testSimpleSlice(self): + buffer = win32file.AllocateReadBuffer(2) + val = str2bytes("\0\0") + buffer[:2] = val + self.assertEqual(buffer[0:2], val) + + +class TestSimpleOps(unittest.TestCase): + def testSimpleFiles(self): + fd, filename = tempfile.mkstemp() + os.close(fd) + os.unlink(filename) + handle = win32file.CreateFile( + filename, win32file.GENERIC_WRITE, 0, None, win32con.CREATE_NEW, 0, None + ) + test_data = str2bytes("Hello\0there") + try: + win32file.WriteFile(handle, test_data) + handle.Close() + # Try and open for read + handle = win32file.CreateFile( + filename, + win32file.GENERIC_READ, + 0, + None, + win32con.OPEN_EXISTING, + 0, + None, + ) + rc, data = win32file.ReadFile(handle, 1024) + self.assertEqual(data, test_data) + finally: + handle.Close() + try: + os.unlink(filename) + except os.error: + pass + + # A simple test using normal read/write operations. + def testMoreFiles(self): + # Create a file in the %TEMP% directory. + testName = os.path.join(win32api.GetTempPath(), "win32filetest.dat") + desiredAccess = win32file.GENERIC_READ | win32file.GENERIC_WRITE + # Set a flag to delete the file automatically when it is closed. + fileFlags = win32file.FILE_FLAG_DELETE_ON_CLOSE + h = win32file.CreateFile( + testName, + desiredAccess, + win32file.FILE_SHARE_READ, + None, + win32file.CREATE_ALWAYS, + fileFlags, + 0, + ) + + # Write a known number of bytes to the file. + data = str2bytes("z") * 1025 + + win32file.WriteFile(h, data) + + self.assertTrue( + win32file.GetFileSize(h) == len(data), + "WARNING: Written file does not have the same size as the length of the data in it!", + ) + + # Ensure we can read the data back. + win32file.SetFilePointer(h, 0, win32file.FILE_BEGIN) + hr, read_data = win32file.ReadFile( + h, len(data) + 10 + ) # + 10 to get anything extra + self.assertTrue(hr == 0, "Readfile returned %d" % hr) + + self.assertTrue(read_data == data, "Read data is not what we wrote!") + + # Now truncate the file at 1/2 its existing size. + newSize = len(data) // 2 + win32file.SetFilePointer(h, newSize, win32file.FILE_BEGIN) + win32file.SetEndOfFile(h) + self.assertEqual(win32file.GetFileSize(h), newSize) + + # GetFileAttributesEx/GetFileAttributesExW tests. + self.assertEqual( + win32file.GetFileAttributesEx(testName), + win32file.GetFileAttributesExW(testName), + ) + + attr, ct, at, wt, size = win32file.GetFileAttributesEx(testName) + self.assertTrue( + size == newSize, + "Expected GetFileAttributesEx to return the same size as GetFileSize()", + ) + self.assertTrue( + attr == win32file.GetFileAttributes(testName), + "Expected GetFileAttributesEx to return the same attributes as GetFileAttributes", + ) + + h = None # Close the file by removing the last reference to the handle! + + self.assertTrue( + not os.path.isfile(testName), "After closing the file, it still exists!" + ) + + def testFilePointer(self): + # via [ 979270 ] SetFilePointer fails with negative offset + + # Create a file in the %TEMP% directory. + filename = os.path.join(win32api.GetTempPath(), "win32filetest.dat") + + f = win32file.CreateFile( + filename, + win32file.GENERIC_READ | win32file.GENERIC_WRITE, + 0, + None, + win32file.CREATE_ALWAYS, + win32file.FILE_ATTRIBUTE_NORMAL, + 0, + ) + try: + # Write some data + data = str2bytes("Some data") + (res, written) = win32file.WriteFile(f, data) + + self.assertFalse(res) + self.assertEqual(written, len(data)) + + # Move at the beginning and read the data + win32file.SetFilePointer(f, 0, win32file.FILE_BEGIN) + (res, s) = win32file.ReadFile(f, len(data)) + + self.assertFalse(res) + self.assertEqual(s, data) + + # Move at the end and read the data + win32file.SetFilePointer(f, -len(data), win32file.FILE_END) + (res, s) = win32file.ReadFile(f, len(data)) + + self.assertFalse(res) + self.assertEqual(s, data) + finally: + f.Close() + os.unlink(filename) + + def testFileTimesTimezones(self): + filename = tempfile.mktemp("-testFileTimes") + # now() is always returning a timestamp with microseconds but the + # file APIs all have zero microseconds, so some comparisons fail. + now_utc = win32timezone.utcnow().replace(microsecond=0) + now_local = now_utc.astimezone(win32timezone.TimeZoneInfo.local()) + h = win32file.CreateFile( + filename, + win32file.GENERIC_READ | win32file.GENERIC_WRITE, + 0, + None, + win32file.CREATE_ALWAYS, + 0, + 0, + ) + try: + win32file.SetFileTime(h, now_utc, now_utc, now_utc) + ct, at, wt = win32file.GetFileTime(h) + self.assertEqual(now_local, ct) + self.assertEqual(now_local, at) + self.assertEqual(now_local, wt) + # and the reverse - set local, check against utc + win32file.SetFileTime(h, now_local, now_local, now_local) + ct, at, wt = win32file.GetFileTime(h) + self.assertEqual(now_utc, ct) + self.assertEqual(now_utc, at) + self.assertEqual(now_utc, wt) + finally: + h.close() + os.unlink(filename) + + def testFileTimes(self): + from win32timezone import TimeZoneInfo + + # now() is always returning a timestamp with microseconds but the + # file APIs all have zero microseconds, so some comparisons fail. + now = datetime.datetime.now(tz=TimeZoneInfo.utc()).replace(microsecond=0) + nowish = now + datetime.timedelta(seconds=1) + later = now + datetime.timedelta(seconds=120) + + filename = tempfile.mktemp("-testFileTimes") + # Windows docs the 'last time' isn't valid until the last write + # handle is closed - so create the file, then re-open it to check. + open(filename, "w").close() + f = win32file.CreateFile( + filename, + win32file.GENERIC_READ | win32file.GENERIC_WRITE, + 0, + None, + win32con.OPEN_EXISTING, + 0, + None, + ) + try: + ct, at, wt = win32file.GetFileTime(f) + self.assertTrue( + ct >= now, + "File was created in the past - now=%s, created=%s" % (now, ct), + ) + self.assertTrue(now <= ct <= nowish, (now, ct)) + self.assertTrue( + wt >= now, + "File was written-to in the past now=%s, written=%s" % (now, wt), + ) + self.assertTrue(now <= wt <= nowish, (now, wt)) + + # Now set the times. + win32file.SetFileTime(f, later, later, later, UTCTimes=True) + # Get them back. + ct, at, wt = win32file.GetFileTime(f) + # XXX - the builtin PyTime type appears to be out by a dst offset. + # just ignore that type here... + self.assertEqual(ct, later) + self.assertEqual(at, later) + self.assertEqual(wt, later) + + finally: + f.Close() + os.unlink(filename) + + +class TestGetFileInfoByHandleEx(unittest.TestCase): + __handle = __filename = None + + def setUp(self): + fd, self.__filename = tempfile.mkstemp() + os.close(fd) + + def tearDown(self): + if self.__handle is not None: + self.__handle.Close() + if self.__filename is not None: + try: + os.unlink(self.__filename) + except OSError: + pass + self.__handle = self.__filename = None + + def testFileBasicInfo(self): + attr = win32file.GetFileAttributes(self.__filename) + f = win32file.CreateFile( + self.__filename, + win32file.GENERIC_READ, + 0, + None, + win32con.OPEN_EXISTING, + 0, + None, + ) + self.__handle = f + ct, at, wt = win32file.GetFileTime(f) + + # bug #752: this throws ERROR_BAD_LENGTH (24) in x86 binaries of build 221 + basic_info = win32file.GetFileInformationByHandleEx(f, win32file.FileBasicInfo) + + self.assertEqual(ct, basic_info["CreationTime"]) + self.assertEqual(at, basic_info["LastAccessTime"]) + self.assertEqual(wt, basic_info["LastWriteTime"]) + self.assertEqual(attr, basic_info["FileAttributes"]) + + +class TestOverlapped(unittest.TestCase): + def testSimpleOverlapped(self): + # Create a file in the %TEMP% directory. + import win32event + + testName = os.path.join(win32api.GetTempPath(), "win32filetest.dat") + desiredAccess = win32file.GENERIC_WRITE + overlapped = pywintypes.OVERLAPPED() + evt = win32event.CreateEvent(None, 0, 0, None) + overlapped.hEvent = evt + # Create the file and write shit-loads of data to it. + h = win32file.CreateFile( + testName, desiredAccess, 0, None, win32file.CREATE_ALWAYS, 0, 0 + ) + chunk_data = str2bytes("z") * 0x8000 + num_loops = 512 + expected_size = num_loops * len(chunk_data) + for i in range(num_loops): + win32file.WriteFile(h, chunk_data, overlapped) + win32event.WaitForSingleObject(overlapped.hEvent, win32event.INFINITE) + overlapped.Offset = overlapped.Offset + len(chunk_data) + h.Close() + # Now read the data back overlapped + overlapped = pywintypes.OVERLAPPED() + evt = win32event.CreateEvent(None, 0, 0, None) + overlapped.hEvent = evt + desiredAccess = win32file.GENERIC_READ + h = win32file.CreateFile( + testName, desiredAccess, 0, None, win32file.OPEN_EXISTING, 0, 0 + ) + buffer = win32file.AllocateReadBuffer(0xFFFF) + while 1: + try: + hr, data = win32file.ReadFile(h, buffer, overlapped) + win32event.WaitForSingleObject(overlapped.hEvent, win32event.INFINITE) + overlapped.Offset = overlapped.Offset + len(data) + if not data is buffer: + self.fail( + "Unexpected result from ReadFile - should be the same buffer we passed it" + ) + except win32api.error: + break + h.Close() + + def testCompletionPortsMultiple(self): + # Mainly checking that we can "associate" an existing handle. This + # failed in build 203. + ioport = win32file.CreateIoCompletionPort( + win32file.INVALID_HANDLE_VALUE, 0, 0, 0 + ) + socks = [] + for PORT in range(9123, 9125): + sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM) + sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) + sock.bind(("", PORT)) + sock.listen(1) + socks.append(sock) + new = win32file.CreateIoCompletionPort(sock.fileno(), ioport, PORT, 0) + assert new is ioport + for s in socks: + s.close() + hv = int(ioport) + ioport = new = None + # The handle itself should be closed now (unless we leak references!) + # Check that. + try: + win32file.CloseHandle(hv) + raise RuntimeError("Expected close to fail!") + except win32file.error as details: + self.assertEqual(details.winerror, winerror.ERROR_INVALID_HANDLE) + + def testCompletionPortsQueued(self): + class Foo: + pass + + io_req_port = win32file.CreateIoCompletionPort(-1, None, 0, 0) + overlapped = pywintypes.OVERLAPPED() + overlapped.object = Foo() + win32file.PostQueuedCompletionStatus(io_req_port, 0, 99, overlapped) + errCode, bytes, key, overlapped = win32file.GetQueuedCompletionStatus( + io_req_port, win32event.INFINITE + ) + self.assertEqual(errCode, 0) + self.assertTrue(isinstance(overlapped.object, Foo)) + + def _IOCPServerThread(self, handle, port, drop_overlapped_reference): + overlapped = pywintypes.OVERLAPPED() + win32pipe.ConnectNamedPipe(handle, overlapped) + if drop_overlapped_reference: + # Be naughty - the overlapped object is now dead, but + # GetQueuedCompletionStatus will still find it. Our check of + # reference counting should catch that error. + overlapped = None + # even if we fail, be sure to close the handle; prevents hangs + # on Vista 64... + try: + self.assertRaises( + RuntimeError, win32file.GetQueuedCompletionStatus, port, -1 + ) + finally: + handle.Close() + return + + result = win32file.GetQueuedCompletionStatus(port, -1) + ol2 = result[-1] + self.assertTrue(ol2 is overlapped) + data = win32file.ReadFile(handle, 512)[1] + win32file.WriteFile(handle, data) + + def testCompletionPortsNonQueued(self, test_overlapped_death=0): + # In 204 we had a reference count bug when OVERLAPPED objects were + # associated with a completion port other than via + # PostQueuedCompletionStatus. This test is based on the reproduction + # reported with that bug. + # Create the pipe. + BUFSIZE = 512 + pipe_name = r"\\.\pipe\pywin32_test_pipe" + handle = win32pipe.CreateNamedPipe( + pipe_name, + win32pipe.PIPE_ACCESS_DUPLEX | win32file.FILE_FLAG_OVERLAPPED, + win32pipe.PIPE_TYPE_MESSAGE + | win32pipe.PIPE_READMODE_MESSAGE + | win32pipe.PIPE_WAIT, + 1, + BUFSIZE, + BUFSIZE, + win32pipe.NMPWAIT_WAIT_FOREVER, + None, + ) + # Create an IOCP and associate it with the handle. + port = win32file.CreateIoCompletionPort(-1, 0, 0, 0) + win32file.CreateIoCompletionPort(handle, port, 1, 0) + + t = threading.Thread( + target=self._IOCPServerThread, args=(handle, port, test_overlapped_death) + ) + t.setDaemon(True) # avoid hanging entire test suite on failure. + t.start() + try: + time.sleep(0.1) # let thread do its thing. + try: + win32pipe.CallNamedPipe( + r"\\.\pipe\pywin32_test_pipe", str2bytes("Hello there"), BUFSIZE, 0 + ) + except win32pipe.error: + # Testing for overlapped death causes this + if not test_overlapped_death: + raise + finally: + if not test_overlapped_death: + handle.Close() + t.join(3) + self.assertFalse(t.is_alive(), "thread didn't finish") + + def testCompletionPortsNonQueuedBadReference(self): + self.testCompletionPortsNonQueued(True) + + def testHashable(self): + overlapped = pywintypes.OVERLAPPED() + d = {} + d[overlapped] = "hello" + self.assertEqual(d[overlapped], "hello") + + def testComparable(self): + overlapped = pywintypes.OVERLAPPED() + self.assertEqual(overlapped, overlapped) + # ensure we explicitly test the operators. + self.assertTrue(overlapped == overlapped) + self.assertFalse(overlapped != overlapped) + + def testComparable2(self): + # 2 overlapped objects compare equal if their contents are the same. + overlapped1 = pywintypes.OVERLAPPED() + overlapped2 = pywintypes.OVERLAPPED() + self.assertEqual(overlapped1, overlapped2) + # ensure we explicitly test the operators. + self.assertTrue(overlapped1 == overlapped2) + self.assertFalse(overlapped1 != overlapped2) + # now change something in one of them - should no longer be equal. + overlapped1.hEvent = 1 + self.assertNotEqual(overlapped1, overlapped2) + # ensure we explicitly test the operators. + self.assertFalse(overlapped1 == overlapped2) + self.assertTrue(overlapped1 != overlapped2) + + +class TestSocketExtensions(unittest.TestCase): + def acceptWorker(self, port, running_event, stopped_event): + listener = socket.socket(socket.AF_INET, socket.SOCK_STREAM) + listener.bind(("", port)) + listener.listen(200) + + # create accept socket + accepter = socket.socket(socket.AF_INET, socket.SOCK_STREAM) + # An overlapped + overlapped = pywintypes.OVERLAPPED() + overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None) + # accept the connection. + # We used to allow strings etc to be passed here, and they would be + # modified! Obviously this is evil :) + buffer = " " * 1024 # EVIL - SHOULD NOT BE ALLOWED. + self.assertRaises( + TypeError, win32file.AcceptEx, listener, accepter, buffer, overlapped + ) + + # This is the correct way to allocate the buffer... + buffer = win32file.AllocateReadBuffer(1024) + rc = win32file.AcceptEx(listener, accepter, buffer, overlapped) + self.assertEqual(rc, winerror.ERROR_IO_PENDING) + # Set the event to say we are all ready + running_event.set() + # and wait for the connection. + rc = win32event.WaitForSingleObject(overlapped.hEvent, 2000) + if rc == win32event.WAIT_TIMEOUT: + self.fail("timed out waiting for a connection") + nbytes = win32file.GetOverlappedResult(listener.fileno(), overlapped, False) + # fam, loc, rem = win32file.GetAcceptExSockaddrs(accepter, buffer) + accepter.send(buffer[:nbytes]) + # NOT set in a finally - this means *successfully* stopped! + stopped_event.set() + + def testAcceptEx(self): + port = 4680 + running = threading.Event() + stopped = threading.Event() + t = threading.Thread(target=self.acceptWorker, args=(port, running, stopped)) + t.start() + running.wait(2) + if not running.isSet(): + self.fail("AcceptEx Worker thread failed to start") + s = socket.socket(socket.AF_INET, socket.SOCK_STREAM) + s.connect(("127.0.0.1", port)) + win32file.WSASend(s, str2bytes("hello"), None) + overlapped = pywintypes.OVERLAPPED() + overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None) + # Like above - WSARecv used to allow strings as the receive buffer!! + buffer = " " * 10 + self.assertRaises(TypeError, win32file.WSARecv, s, buffer, overlapped) + # This one should work :) + buffer = win32file.AllocateReadBuffer(10) + win32file.WSARecv(s, buffer, overlapped) + nbytes = win32file.GetOverlappedResult(s.fileno(), overlapped, True) + got = buffer[:nbytes] + self.assertEqual(got, str2bytes("hello")) + # thread should have stopped + stopped.wait(2) + if not stopped.isSet(): + self.fail("AcceptEx Worker thread failed to successfully stop") + + +class TestFindFiles(unittest.TestCase): + def testIter(self): + dir = os.path.join(os.getcwd(), "*") + files = win32file.FindFilesW(dir) + set1 = set() + set1.update(files) + set2 = set() + for file in win32file.FindFilesIterator(dir): + set2.add(file) + assert len(set2) > 5, "This directory has less than 5 files!?" + self.assertEqual(set1, set2) + + def testBadDir(self): + dir = os.path.join(os.getcwd(), "a dir that doesnt exist", "*") + self.assertRaises(win32file.error, win32file.FindFilesIterator, dir) + + def testEmptySpec(self): + spec = os.path.join(os.getcwd(), "*.foo_bar") + num = 0 + for i in win32file.FindFilesIterator(spec): + num += 1 + self.assertEqual(0, num) + + def testEmptyDir(self): + test_path = os.path.join(win32api.GetTempPath(), "win32file_test_directory") + try: + # Note: previously used shutil.rmtree, but when looking for + # reference count leaks, that function showed leaks! os.rmdir + # doesn't have that problem. + os.rmdir(test_path) + except os.error: + pass + os.mkdir(test_path) + try: + num = 0 + for i in win32file.FindFilesIterator(os.path.join(test_path, "*")): + num += 1 + # Expecting "." and ".." only + self.assertEqual(2, num) + finally: + os.rmdir(test_path) + + +class TestDirectoryChanges(unittest.TestCase): + num_test_dirs = 1 + + def setUp(self): + self.watcher_threads = [] + self.watcher_thread_changes = [] + self.dir_names = [] + self.dir_handles = [] + for i in range(self.num_test_dirs): + td = tempfile.mktemp("-test-directory-changes-%d" % i) + os.mkdir(td) + self.dir_names.append(td) + hdir = win32file.CreateFile( + td, + ntsecuritycon.FILE_LIST_DIRECTORY, + win32con.FILE_SHARE_READ, + None, # security desc + win32con.OPEN_EXISTING, + win32con.FILE_FLAG_BACKUP_SEMANTICS | win32con.FILE_FLAG_OVERLAPPED, + None, + ) + self.dir_handles.append(hdir) + + changes = [] + t = threading.Thread( + target=self._watcherThreadOverlapped, args=(td, hdir, changes) + ) + t.start() + self.watcher_threads.append(t) + self.watcher_thread_changes.append(changes) + + def _watcherThread(self, dn, dh, changes): + # A synchronous version: + # XXX - not used - I was having a whole lot of problems trying to + # get this to work. Specifically: + # * ReadDirectoryChangesW without an OVERLAPPED blocks infinitely. + # * If another thread attempts to close the handle while + # ReadDirectoryChangesW is waiting on it, the ::CloseHandle() method + # blocks (which has nothing to do with the GIL - it is correctly + # managed) + # Which ends up with no way to kill the thread! + flags = win32con.FILE_NOTIFY_CHANGE_FILE_NAME + while 1: + try: + print("waiting", dh) + changes = win32file.ReadDirectoryChangesW( + dh, 8192, False, flags # sub-tree + ) + print("got", changes) + except: + raise + changes.extend(changes) + + def _watcherThreadOverlapped(self, dn, dh, changes): + flags = win32con.FILE_NOTIFY_CHANGE_FILE_NAME + buf = win32file.AllocateReadBuffer(8192) + overlapped = pywintypes.OVERLAPPED() + overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None) + while 1: + win32file.ReadDirectoryChangesW( + dh, buf, False, flags, overlapped # sub-tree + ) + # Wait for our event, or for 5 seconds. + rc = win32event.WaitForSingleObject(overlapped.hEvent, 5000) + if rc == win32event.WAIT_OBJECT_0: + # got some data! Must use GetOverlappedResult to find out + # how much is valid! 0 generally means the handle has + # been closed. Blocking is OK here, as the event has + # already been set. + nbytes = win32file.GetOverlappedResult(dh, overlapped, True) + if nbytes: + bits = win32file.FILE_NOTIFY_INFORMATION(buf, nbytes) + changes.extend(bits) + else: + # This is "normal" exit - our 'tearDown' closes the + # handle. + # print "looks like dir handle was closed!" + return + else: + print("ERROR: Watcher thread timed-out!") + return # kill the thread! + + def tearDown(self): + # be careful about raising errors at teardown! + for h in self.dir_handles: + # See comments in _watcherThread above - this appears to + # deadlock if a synchronous ReadDirectoryChangesW is waiting... + # (No such problems with an asynch ReadDirectoryChangesW) + h.Close() + for dn in self.dir_names: + try: + shutil.rmtree(dn) + except OSError: + print("FAILED to remove directory", dn) + + for t in self.watcher_threads: + # closing dir handle should have killed threads! + t.join(5) + if t.is_alive(): + print("FAILED to wait for thread termination") + + def stablize(self): + time.sleep(0.5) + + def testSimple(self): + self.stablize() + for dn in self.dir_names: + fn = os.path.join(dn, "test_file") + open(fn, "w").close() + + self.stablize() + changes = self.watcher_thread_changes[0] + self.assertEqual(changes, [(1, "test_file")]) + + def testSmall(self): + self.stablize() + for dn in self.dir_names: + fn = os.path.join(dn, "x") + open(fn, "w").close() + + self.stablize() + changes = self.watcher_thread_changes[0] + self.assertEqual(changes, [(1, "x")]) + + +class TestEncrypt(unittest.TestCase): + def testEncrypt(self): + fname = tempfile.mktemp("win32file_test") + f = open(fname, "wb") + f.write(str2bytes("hello")) + f.close() + f = None + try: + try: + win32file.EncryptFile(fname) + except win32file.error as details: + if details.winerror != winerror.ERROR_ACCESS_DENIED: + raise + print("It appears this is not NTFS - cant encrypt/decrypt") + win32file.DecryptFile(fname) + finally: + if f is not None: + f.close() + os.unlink(fname) + + +class TestConnect(unittest.TestCase): + def connect_thread_runner(self, expect_payload, giveup_event): + # As Windows 2000 doesn't do ConnectEx, we need to use a non-blocking + # accept, as our test connection may never come. May as well use + # AcceptEx for this... + listener = socket.socket() + self.addr = ("localhost", random.randint(10000, 64000)) + listener.bind(self.addr) + listener.listen(1) + + # create accept socket + accepter = socket.socket(socket.AF_INET, socket.SOCK_STREAM) + # An overlapped + overlapped = pywintypes.OVERLAPPED() + overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None) + # accept the connection. + if expect_payload: + buf_size = 1024 + else: + # when we don't expect data we must be careful to only pass the + # exact number of bytes for the endpoint data... + buf_size = win32file.CalculateSocketEndPointSize(listener) + + buffer = win32file.AllocateReadBuffer(buf_size) + win32file.AcceptEx(listener, accepter, buffer, overlapped) + # wait for the connection or our test to fail. + events = giveup_event, overlapped.hEvent + rc = win32event.WaitForMultipleObjects(events, False, 2000) + if rc == win32event.WAIT_TIMEOUT: + self.fail("timed out waiting for a connection") + if rc == win32event.WAIT_OBJECT_0: + # Our main thread running the test failed and will never connect. + return + # must be a connection. + nbytes = win32file.GetOverlappedResult(listener.fileno(), overlapped, False) + if expect_payload: + self.request = buffer[:nbytes] + accepter.send(str2bytes("some expected response")) + + def test_connect_with_payload(self): + giveup_event = win32event.CreateEvent(None, 0, 0, None) + t = threading.Thread( + target=self.connect_thread_runner, args=(True, giveup_event) + ) + t.start() + time.sleep(0.1) + s2 = socket.socket() + ol = pywintypes.OVERLAPPED() + s2.bind(("0.0.0.0", 0)) # connectex requires the socket be bound beforehand + try: + win32file.ConnectEx(s2, self.addr, ol, str2bytes("some expected request")) + except win32file.error as exc: + win32event.SetEvent(giveup_event) + if exc.winerror == 10022: # WSAEINVAL + raise TestSkipped("ConnectEx is not available on this platform") + raise # some error error we don't expect. + # We occasionally see ERROR_CONNECTION_REFUSED in automation + try: + win32file.GetOverlappedResult(s2.fileno(), ol, 1) + except win32file.error as exc: + win32event.SetEvent(giveup_event) + if exc.winerror == winerror.ERROR_CONNECTION_REFUSED: + raise TestSkipped("Assuming ERROR_CONNECTION_REFUSED is transient") + raise + ol = pywintypes.OVERLAPPED() + buff = win32file.AllocateReadBuffer(1024) + win32file.WSARecv(s2, buff, ol, 0) + length = win32file.GetOverlappedResult(s2.fileno(), ol, 1) + self.response = buff[:length] + self.assertEqual(self.response, str2bytes("some expected response")) + self.assertEqual(self.request, str2bytes("some expected request")) + t.join(5) + self.assertFalse(t.is_alive(), "worker thread didn't terminate") + + def test_connect_without_payload(self): + giveup_event = win32event.CreateEvent(None, 0, 0, None) + t = threading.Thread( + target=self.connect_thread_runner, args=(False, giveup_event) + ) + t.start() + time.sleep(0.1) + s2 = socket.socket() + ol = pywintypes.OVERLAPPED() + s2.bind(("0.0.0.0", 0)) # connectex requires the socket be bound beforehand + try: + win32file.ConnectEx(s2, self.addr, ol) + except win32file.error as exc: + win32event.SetEvent(giveup_event) + if exc.winerror == 10022: # WSAEINVAL + raise TestSkipped("ConnectEx is not available on this platform") + raise # some error error we don't expect. + # We occasionally see ERROR_CONNECTION_REFUSED in automation + try: + win32file.GetOverlappedResult(s2.fileno(), ol, 1) + except win32file.error as exc: + win32event.SetEvent(giveup_event) + if exc.winerror == winerror.ERROR_CONNECTION_REFUSED: + raise TestSkipped("Assuming ERROR_CONNECTION_REFUSED is transient") + raise + + ol = pywintypes.OVERLAPPED() + buff = win32file.AllocateReadBuffer(1024) + win32file.WSARecv(s2, buff, ol, 0) + length = win32file.GetOverlappedResult(s2.fileno(), ol, 1) + self.response = buff[:length] + self.assertEqual(self.response, str2bytes("some expected response")) + t.join(5) + self.assertFalse(t.is_alive(), "worker thread didn't terminate") + + +class TestTransmit(unittest.TestCase): + def test_transmit(self): + import binascii + + bytes = os.urandom(1024 * 1024) + val = binascii.hexlify(bytes) + val_length = len(val) + f = tempfile.TemporaryFile() + f.write(val) + + def runner(): + s1 = socket.socket() + # binding fails occasionally on github CI with: + # OSError: [WinError 10013] An attempt was made to access a socket in a way forbidden by its access permissions + # which probably just means the random port is already in use, so + # let that happen a few times. + for i in range(5): + self.addr = ("localhost", random.randint(10000, 64000)) + try: + s1.bind(self.addr) + break + except os.error as exc: + if exc.winerror != 10013: + raise + print("Failed to use port", self.addr, "trying another random one") + else: + raise RuntimeError("Failed to find an available port to bind to.") + s1.listen(1) + cli, addr = s1.accept() + buf = 1 + self.request = [] + while buf: + buf = cli.recv(1024 * 100) + self.request.append(buf) + + th = threading.Thread(target=runner) + th.start() + time.sleep(0.5) + s2 = socket.socket() + s2.connect(self.addr) + + length = 0 + aaa = str2bytes("[AAA]") + bbb = str2bytes("[BBB]") + ccc = str2bytes("[CCC]") + ddd = str2bytes("[DDD]") + empty = str2bytes("") + ol = pywintypes.OVERLAPPED() + f.seek(0) + win32file.TransmitFile( + s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0 + ) + length += win32file.GetOverlappedResult(s2.fileno(), ol, 1) + + ol = pywintypes.OVERLAPPED() + f.seek(0) + win32file.TransmitFile( + s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0, aaa, bbb + ) + length += win32file.GetOverlappedResult(s2.fileno(), ol, 1) + + ol = pywintypes.OVERLAPPED() + f.seek(0) + win32file.TransmitFile( + s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0, empty, empty + ) + length += win32file.GetOverlappedResult(s2.fileno(), ol, 1) + + ol = pywintypes.OVERLAPPED() + f.seek(0) + win32file.TransmitFile( + s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0, None, ccc + ) + length += win32file.GetOverlappedResult(s2.fileno(), ol, 1) + + ol = pywintypes.OVERLAPPED() + f.seek(0) + win32file.TransmitFile( + s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0, ddd + ) + length += win32file.GetOverlappedResult(s2.fileno(), ol, 1) + + s2.close() + th.join() + buf = str2bytes("").join(self.request) + self.assertEqual(length, len(buf)) + expected = val + aaa + val + bbb + val + val + ccc + ddd + val + self.assertEqual(type(expected), type(buf)) + self.assertEqual(expected, buf) + + +class TestWSAEnumNetworkEvents(unittest.TestCase): + def test_basics(self): + s = socket.socket() + e = win32event.CreateEvent(None, 1, 0, None) + win32file.WSAEventSelect(s, e, 0) + self.assertEqual(win32file.WSAEnumNetworkEvents(s), {}) + self.assertEqual(win32file.WSAEnumNetworkEvents(s, e), {}) + self.assertRaises(TypeError, win32file.WSAEnumNetworkEvents, s, e, 3) + self.assertRaises(TypeError, win32file.WSAEnumNetworkEvents, s, "spam") + self.assertRaises(TypeError, win32file.WSAEnumNetworkEvents, "spam", e) + self.assertRaises(TypeError, win32file.WSAEnumNetworkEvents, "spam") + f = open("NUL") + h = win32file._get_osfhandle(f.fileno()) + self.assertRaises(win32file.error, win32file.WSAEnumNetworkEvents, h) + self.assertRaises(win32file.error, win32file.WSAEnumNetworkEvents, s, h) + try: + win32file.WSAEnumNetworkEvents(h) + except win32file.error as e: + self.assertEqual(e.winerror, win32file.WSAENOTSOCK) + try: + win32file.WSAEnumNetworkEvents(s, h) + except win32file.error as e: + # According to the docs it would seem reasonable that + # this would fail with WSAEINVAL, but it doesn't. + self.assertEqual(e.winerror, win32file.WSAENOTSOCK) + + def test_functional(self): + # This is not really a unit test, but it does exercise the code + # quite well and can serve as an example of WSAEventSelect and + # WSAEnumNetworkEvents usage. + port = socket.socket() + port.setblocking(0) + port_event = win32event.CreateEvent(None, 0, 0, None) + win32file.WSAEventSelect( + port, port_event, win32file.FD_ACCEPT | win32file.FD_CLOSE + ) + port.bind(("127.0.0.1", 0)) + port.listen(10) + + client = socket.socket() + client.setblocking(0) + client_event = win32event.CreateEvent(None, 0, 0, None) + win32file.WSAEventSelect( + client, + client_event, + win32file.FD_CONNECT + | win32file.FD_READ + | win32file.FD_WRITE + | win32file.FD_CLOSE, + ) + err = client.connect_ex(port.getsockname()) + self.assertEqual(err, win32file.WSAEWOULDBLOCK) + + res = win32event.WaitForSingleObject(port_event, 1000) + self.assertEqual(res, win32event.WAIT_OBJECT_0) + events = win32file.WSAEnumNetworkEvents(port, port_event) + self.assertEqual(events, {win32file.FD_ACCEPT: 0}) + + server, addr = port.accept() + server.setblocking(0) + server_event = win32event.CreateEvent(None, 1, 0, None) + win32file.WSAEventSelect( + server, + server_event, + win32file.FD_READ | win32file.FD_WRITE | win32file.FD_CLOSE, + ) + res = win32event.WaitForSingleObject(server_event, 1000) + self.assertEqual(res, win32event.WAIT_OBJECT_0) + events = win32file.WSAEnumNetworkEvents(server, server_event) + self.assertEqual(events, {win32file.FD_WRITE: 0}) + + res = win32event.WaitForSingleObject(client_event, 1000) + self.assertEqual(res, win32event.WAIT_OBJECT_0) + events = win32file.WSAEnumNetworkEvents(client, client_event) + self.assertEqual(events, {win32file.FD_CONNECT: 0, win32file.FD_WRITE: 0}) + sent = 0 + data = str2bytes("x") * 16 * 1024 + while sent < 16 * 1024 * 1024: + try: + sent += client.send(data) + except socket.error as e: + if e.args[0] == win32file.WSAEINTR: + continue + elif e.args[0] in (win32file.WSAEWOULDBLOCK, win32file.WSAENOBUFS): + break + else: + raise + else: + self.fail("could not find socket buffer limit") + + events = win32file.WSAEnumNetworkEvents(client) + self.assertEqual(events, {}) + + res = win32event.WaitForSingleObject(server_event, 1000) + self.assertEqual(res, win32event.WAIT_OBJECT_0) + events = win32file.WSAEnumNetworkEvents(server, server_event) + self.assertEqual(events, {win32file.FD_READ: 0}) + + received = 0 + while received < sent: + try: + received += len(server.recv(16 * 1024)) + except socket.error as e: + if e.args[0] in [win32file.WSAEINTR, win32file.WSAEWOULDBLOCK]: + continue + else: + raise + + self.assertEqual(received, sent) + events = win32file.WSAEnumNetworkEvents(server) + self.assertEqual(events, {}) + + res = win32event.WaitForSingleObject(client_event, 1000) + self.assertEqual(res, win32event.WAIT_OBJECT_0) + events = win32file.WSAEnumNetworkEvents(client, client_event) + self.assertEqual(events, {win32file.FD_WRITE: 0}) + + client.shutdown(socket.SHUT_WR) + res = win32event.WaitForSingleObject(server_event, 1000) + self.assertEqual(res, win32event.WAIT_OBJECT_0) + # strange timing issues... + for i in range(5): + events = win32file.WSAEnumNetworkEvents(server, server_event) + if events: + break + win32api.Sleep(100) + else: + raise AssertionError("failed to get events") + self.assertEqual(events, {win32file.FD_CLOSE: 0}) + events = win32file.WSAEnumNetworkEvents(client) + self.assertEqual(events, {}) + + server.close() + res = win32event.WaitForSingleObject(client_event, 1000) + self.assertEqual(res, win32event.WAIT_OBJECT_0) + events = win32file.WSAEnumNetworkEvents(client, client_event) + self.assertEqual(events, {win32file.FD_CLOSE: 0}) + + client.close() + events = win32file.WSAEnumNetworkEvents(port) + self.assertEqual(events, {}) + + +if __name__ == "__main__": + testmain() diff --git a/lib/win32/test/test_win32gui.py b/lib/win32/test/test_win32gui.py new file mode 100644 index 00000000..ad96bd43 --- /dev/null +++ b/lib/win32/test/test_win32gui.py @@ -0,0 +1,65 @@ +# tests for win32gui +import array +import operator +import unittest + +import pywin32_testutil +import win32gui + + +class TestPyGetString(unittest.TestCase): + def test_get_string(self): + # test invalid addresses cause a ValueError rather than crash! + self.assertRaises(ValueError, win32gui.PyGetString, 0) + self.assertRaises(ValueError, win32gui.PyGetString, 1) + self.assertRaises(ValueError, win32gui.PyGetString, 1, 1) + + +class TestPyGetMemory(unittest.TestCase): + def test_ob(self): + # Check the PyGetMemory result and a bytes string can be compared + test_data = b"\0\1\2\3\4\5\6" + c = array.array("b", test_data) + addr, buflen = c.buffer_info() + got = win32gui.PyGetMemory(addr, buflen) + self.assertEqual(len(got), len(test_data)) + self.assertEqual(bytes(got), test_data) + + def test_memory_index(self): + # Check we can index into the buffer object returned by PyGetMemory + test_data = b"\0\1\2\3\4\5\6" + c = array.array("b", test_data) + addr, buflen = c.buffer_info() + got = win32gui.PyGetMemory(addr, buflen) + self.assertEqual(got[0], 0) + + def test_memory_slice(self): + # Check we can slice the buffer object returned by PyGetMemory + test_data = b"\0\1\2\3\4\5\6" + c = array.array("b", test_data) + addr, buflen = c.buffer_info() + got = win32gui.PyGetMemory(addr, buflen) + self.assertEqual(list(got[0:3]), [0, 1, 2]) + + def test_real_view(self): + # Do the PyGetMemory, then change the original memory, then ensure + # the initial object we fetched sees the new value. + test_data = b"\0\1\2\3\4\5\6" + c = array.array("b", test_data) + addr, buflen = c.buffer_info() + got = win32gui.PyGetMemory(addr, buflen) + self.assertEqual(got[0], 0) + c[0] = 1 + self.assertEqual(got[0], 1) + + def test_memory_not_writable(self): + # Check the buffer object fetched by PyGetMemory isn't writable. + test_data = b"\0\1\2\3\4\5\6" + c = array.array("b", test_data) + addr, buflen = c.buffer_info() + got = win32gui.PyGetMemory(addr, buflen) + self.assertRaises(TypeError, operator.setitem, got, 0, 1) + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_win32guistruct.py b/lib/win32/test/test_win32guistruct.py new file mode 100644 index 00000000..063cea3a --- /dev/null +++ b/lib/win32/test/test_win32guistruct.py @@ -0,0 +1,330 @@ +import array +import unittest + +import pythoncom +import win32con +import win32gui +import win32gui_struct + + +class TestBase(unittest.TestCase): + def assertDictEquals(self, d, **kw): + checked = dict() + for n, v in kw.items(): + self.assertEqual(v, d[n], "'%s' doesn't match: %r != %r" % (n, v, d[n])) + checked[n] = True + checked_keys = list(checked.keys()) + passed_keys = list(kw.keys()) + checked_keys.sort() + passed_keys.sort() + self.assertEqual(checked_keys, passed_keys) + + +class TestMenuItemInfo(TestBase): + def _testPackUnpack(self, text): + vals = dict( + fType=win32con.MFT_MENUBARBREAK, + fState=win32con.MFS_CHECKED, + wID=123, + hSubMenu=1234, + hbmpChecked=12345, + hbmpUnchecked=123456, + dwItemData=1234567, + text=text, + hbmpItem=321, + ) + mii, extras = win32gui_struct.PackMENUITEMINFO(**vals) + ( + fType, + fState, + wID, + hSubMenu, + hbmpChecked, + hbmpUnchecked, + dwItemData, + text, + hbmpItem, + ) = win32gui_struct.UnpackMENUITEMINFO(mii) + self.assertDictEquals( + vals, + fType=fType, + fState=fState, + wID=wID, + hSubMenu=hSubMenu, + hbmpChecked=hbmpChecked, + hbmpUnchecked=hbmpUnchecked, + dwItemData=dwItemData, + text=text, + hbmpItem=hbmpItem, + ) + + def testPackUnpack(self): + self._testPackUnpack("Hello") + + def testPackUnpackNone(self): + self._testPackUnpack(None) + + def testEmptyMenuItemInfo(self): + mii, extra = win32gui_struct.EmptyMENUITEMINFO() + ( + fType, + fState, + wID, + hSubMenu, + hbmpChecked, + hbmpUnchecked, + dwItemData, + text, + hbmpItem, + ) = win32gui_struct.UnpackMENUITEMINFO(mii) + self.assertEqual(fType, 0) + self.assertEqual(fState, 0) + self.assertEqual(wID, 0) + self.assertEqual(hSubMenu, 0) + self.assertEqual(hbmpChecked, 0) + self.assertEqual(hbmpUnchecked, 0) + self.assertEqual(dwItemData, 0) + self.assertEqual(hbmpItem, 0) + # it's not clear if UnpackMENUITEMINFO() should ignore cch, instead + # assuming it is a buffer size rather than 'current length' - but it + # never has (and this gives us every \0 in the string), and actually + # helps us test the unicode/str semantics. + self.assertEqual(text, "\0" * len(text)) + + +class TestMenuInfo(TestBase): + def testPackUnpack(self): + vals = dict(dwStyle=1, cyMax=2, hbrBack=3, dwContextHelpID=4, dwMenuData=5) + + mi = win32gui_struct.PackMENUINFO(**vals) + ( + dwStyle, + cyMax, + hbrBack, + dwContextHelpID, + dwMenuData, + ) = win32gui_struct.UnpackMENUINFO(mi) + + self.assertDictEquals( + vals, + dwStyle=dwStyle, + cyMax=cyMax, + hbrBack=hbrBack, + dwContextHelpID=dwContextHelpID, + dwMenuData=dwMenuData, + ) + + def testEmptyMenuItemInfo(self): + mi = win32gui_struct.EmptyMENUINFO() + ( + dwStyle, + cyMax, + hbrBack, + dwContextHelpID, + dwMenuData, + ) = win32gui_struct.UnpackMENUINFO(mi) + self.assertEqual(dwStyle, 0) + self.assertEqual(cyMax, 0) + self.assertEqual(hbrBack, 0) + self.assertEqual(dwContextHelpID, 0) + self.assertEqual(dwMenuData, 0) + + +class TestTreeViewItem(TestBase): + def _testPackUnpack(self, text): + vals = dict( + hitem=1, + state=2, + stateMask=3, + text=text, + image=4, + selimage=5, + citems=6, + param=7, + ) + + ti, extra = win32gui_struct.PackTVITEM(**vals) + ( + hitem, + state, + stateMask, + text, + image, + selimage, + citems, + param, + ) = win32gui_struct.UnpackTVITEM(ti) + + self.assertDictEquals( + vals, + hitem=hitem, + state=state, + stateMask=stateMask, + text=text, + image=image, + selimage=selimage, + citems=citems, + param=param, + ) + + def testPackUnpack(self): + self._testPackUnpack("Hello") + + def testPackUnpackNone(self): + self._testPackUnpack(None) + + def testEmpty(self): + ti, extras = win32gui_struct.EmptyTVITEM(0) + ( + hitem, + state, + stateMask, + text, + image, + selimage, + citems, + param, + ) = win32gui_struct.UnpackTVITEM(ti) + self.assertEqual(hitem, 0) + self.assertEqual(state, 0) + self.assertEqual(stateMask, 0) + self.assertEqual(text, "") + self.assertEqual(image, 0) + self.assertEqual(selimage, 0) + self.assertEqual(citems, 0) + self.assertEqual(param, 0) + + +class TestListViewItem(TestBase): + def _testPackUnpack(self, text): + vals = dict( + item=None, + subItem=None, + state=1, + stateMask=2, + text=text, + image=3, + param=4, + indent=5, + ) + + ti, extra = win32gui_struct.PackLVITEM(**vals) + ( + item, + subItem, + state, + stateMask, + text, + image, + param, + indent, + ) = win32gui_struct.UnpackLVITEM(ti) + + # patch expected values. + vals["item"] = 0 + vals["subItem"] = 0 + self.assertDictEquals( + vals, + item=item, + subItem=subItem, + state=state, + stateMask=stateMask, + text=text, + image=image, + param=param, + indent=indent, + ) + + def testPackUnpack(self): + self._testPackUnpack("Hello") + + def testPackUnpackNone(self): + self._testPackUnpack(None) + + def testEmpty(self): + ti, extras = win32gui_struct.EmptyLVITEM(1, 2) + ( + item, + subItem, + state, + stateMask, + text, + image, + param, + indent, + ) = win32gui_struct.UnpackLVITEM(ti) + self.assertEqual(item, 1) + self.assertEqual(subItem, 2) + self.assertEqual(state, 0) + self.assertEqual(stateMask, 0) + self.assertEqual(text, "") + self.assertEqual(image, 0) + self.assertEqual(param, 0) + self.assertEqual(indent, 0) + + +class TestLVColumn(TestBase): + def _testPackUnpack(self, text): + vals = dict(fmt=1, cx=2, text=text, subItem=3, image=4, order=5) + + ti, extra = win32gui_struct.PackLVCOLUMN(**vals) + fmt, cx, text, subItem, image, order = win32gui_struct.UnpackLVCOLUMN(ti) + + self.assertDictEquals( + vals, fmt=fmt, cx=cx, text=text, subItem=subItem, image=image, order=order + ) + + def testPackUnpack(self): + self._testPackUnpack("Hello") + + def testPackUnpackNone(self): + self._testPackUnpack(None) + + def testEmpty(self): + ti, extras = win32gui_struct.EmptyLVCOLUMN() + fmt, cx, text, subItem, image, order = win32gui_struct.UnpackLVCOLUMN(ti) + self.assertEqual(fmt, 0) + self.assertEqual(cx, 0) + self.assertEqual(text, "") + self.assertEqual(subItem, 0) + self.assertEqual(image, 0) + self.assertEqual(order, 0) + + +class TestDEV_BROADCAST_HANDLE(TestBase): + def testPackUnpack(self): + s = win32gui_struct.PackDEV_BROADCAST_HANDLE(123) + c = array.array("b", s) + got = win32gui_struct.UnpackDEV_BROADCAST(c.buffer_info()[0]) + self.assertEqual(got.handle, 123) + + def testGUID(self): + s = win32gui_struct.PackDEV_BROADCAST_HANDLE(123, guid=pythoncom.IID_IUnknown) + c = array.array("b", s) + got = win32gui_struct.UnpackDEV_BROADCAST(c.buffer_info()[0]) + self.assertEqual(got.handle, 123) + self.assertEqual(got.eventguid, pythoncom.IID_IUnknown) + + +class TestDEV_BROADCAST_DEVICEINTERFACE(TestBase): + def testPackUnpack(self): + s = win32gui_struct.PackDEV_BROADCAST_DEVICEINTERFACE( + pythoncom.IID_IUnknown, "hello" + ) + c = array.array("b", s) + got = win32gui_struct.UnpackDEV_BROADCAST(c.buffer_info()[0]) + self.assertEqual(got.classguid, pythoncom.IID_IUnknown) + self.assertEqual(got.name, "hello") + + +class TestDEV_BROADCAST_VOLUME(TestBase): + def testPackUnpack(self): + s = win32gui_struct.PackDEV_BROADCAST_VOLUME(123, 456) + c = array.array("b", s) + got = win32gui_struct.UnpackDEV_BROADCAST(c.buffer_info()[0]) + self.assertEqual(got.unitmask, 123) + self.assertEqual(got.flags, 456) + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_win32inet.py b/lib/win32/test/test_win32inet.py new file mode 100644 index 00000000..044ef8e6 --- /dev/null +++ b/lib/win32/test/test_win32inet.py @@ -0,0 +1,93 @@ +import unittest + +import winerror +from pywin32_testutil import str2bytes # py3k-friendly helper +from pywin32_testutil import TestSkipped, testmain +from win32inet import * +from win32inetcon import * + + +class CookieTests(unittest.TestCase): + def testCookies(self): + data = "TestData=Test" + InternetSetCookie("http://www.python.org", None, data) + got = InternetGetCookie("http://www.python.org", None) + # handle that there might already be cookies for the domain. + bits = map(lambda x: x.strip(), got.split(";")) + self.assertTrue(data in bits) + + def testCookiesEmpty(self): + try: + InternetGetCookie("http://site-with-no-cookie.python.org", None) + self.fail("expected win32 exception") + except error as exc: + self.assertEqual(exc.winerror, winerror.ERROR_NO_MORE_ITEMS) + + +class UrlTests(unittest.TestCase): + def testSimpleCanonicalize(self): + ret = InternetCanonicalizeUrl("foo bar") + self.assertEqual(ret, "foo%20bar") + + def testLongCanonicalize(self): + # a 4k URL causes the underlying API to request a bigger buffer" + big = "x" * 2048 + ret = InternetCanonicalizeUrl(big + " " + big) + self.assertEqual(ret, big + "%20" + big) + + +class TestNetwork(unittest.TestCase): + def setUp(self): + self.hi = InternetOpen("test", INTERNET_OPEN_TYPE_DIRECT, None, None, 0) + + def tearDown(self): + self.hi.Close() + + def testPythonDotOrg(self): + hdl = InternetOpenUrl( + self.hi, "http://www.python.org", None, INTERNET_FLAG_EXISTING_CONNECT + ) + chunks = [] + while 1: + chunk = InternetReadFile(hdl, 1024) + if not chunk: + break + chunks.append(chunk) + data = str2bytes("").join(chunks) + assert data.find(str2bytes("Python")) > 0, repr( + data + ) # This must appear somewhere on the main page! + + def testFtpCommand(self): + # ftp.python.org doesn't exist. ftp.gnu.org is what Python's urllib + # test code uses. + # (As of 2020 it doesn't! Unsurprisingly, it's difficult to find a good + # test server. This test sometimes works, but often doesn't - so handle + # failure here as a "skip") + try: + hcon = InternetConnect( + self.hi, + "ftp.gnu.org", + INTERNET_INVALID_PORT_NUMBER, + None, + None, # username/password + INTERNET_SERVICE_FTP, + 0, + 0, + ) + try: + hftp = FtpCommand(hcon, True, FTP_TRANSFER_TYPE_ASCII, "NLST", 0) + try: + print("Connected - response info is", InternetGetLastResponseInfo()) + got = InternetReadFile(hftp, 2048) + print("Read", len(got), "bytes") + finally: + hftp.Close() + finally: + hcon.Close() + except error as e: + raise TestSkipped(e) + + +if __name__ == "__main__": + testmain() diff --git a/lib/win32/test/test_win32net.py b/lib/win32/test/test_win32net.py new file mode 100644 index 00000000..93071963 --- /dev/null +++ b/lib/win32/test/test_win32net.py @@ -0,0 +1,24 @@ +import unittest + +import win32net +import win32netcon + + +class TestCase(unittest.TestCase): + def testGroupsGoodResume(self, server=None): + res = 0 + level = 0 # setting it to 1 will provide more detailed info + while True: + (user_list, total, res) = win32net.NetGroupEnum(server, level, res) + for i in user_list: + pass + if not res: + break + + def testGroupsBadResume(self, server=None): + res = 1 # Can't pass this first time round. + self.assertRaises(win32net.error, win32net.NetGroupEnum, server, 0, res) + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_win32pipe.py b/lib/win32/test/test_win32pipe.py new file mode 100644 index 00000000..cbe647dd --- /dev/null +++ b/lib/win32/test/test_win32pipe.py @@ -0,0 +1,153 @@ +import threading +import time +import unittest + +import pywintypes +import win32con +import win32event +import win32file +import win32pipe +import winerror +from pywin32_testutil import str2bytes # py3k-friendly helper + + +class PipeTests(unittest.TestCase): + pipename = "\\\\.\\pipe\\python_test_pipe" + + def _serverThread(self, pipe_handle, event, wait_time): + # just do one connection and terminate. + hr = win32pipe.ConnectNamedPipe(pipe_handle) + self.assertTrue( + hr in (0, winerror.ERROR_PIPE_CONNECTED), "Got error code 0x%x" % (hr,) + ) + hr, got = win32file.ReadFile(pipe_handle, 100) + self.assertEqual(got, str2bytes("foo\0bar")) + time.sleep(wait_time) + win32file.WriteFile(pipe_handle, str2bytes("bar\0foo")) + pipe_handle.Close() + event.set() + + def startPipeServer(self, event, wait_time=0): + openMode = win32pipe.PIPE_ACCESS_DUPLEX + pipeMode = win32pipe.PIPE_TYPE_MESSAGE | win32pipe.PIPE_WAIT + + sa = pywintypes.SECURITY_ATTRIBUTES() + sa.SetSecurityDescriptorDacl(1, None, 0) + + pipe_handle = win32pipe.CreateNamedPipe( + self.pipename, + openMode, + pipeMode, + win32pipe.PIPE_UNLIMITED_INSTANCES, + 0, + 0, + 2000, + sa, + ) + + threading.Thread( + target=self._serverThread, args=(pipe_handle, event, wait_time) + ).start() + + def testCallNamedPipe(self): + event = threading.Event() + self.startPipeServer(event) + + got = win32pipe.CallNamedPipe( + self.pipename, str2bytes("foo\0bar"), 1024, win32pipe.NMPWAIT_WAIT_FOREVER + ) + self.assertEqual(got, str2bytes("bar\0foo")) + event.wait(5) + self.assertTrue(event.isSet(), "Pipe server thread didn't terminate") + + def testTransactNamedPipeBlocking(self): + event = threading.Event() + self.startPipeServer(event) + open_mode = win32con.GENERIC_READ | win32con.GENERIC_WRITE + + hpipe = win32file.CreateFile( + self.pipename, + open_mode, + 0, # no sharing + None, # default security + win32con.OPEN_EXISTING, + 0, # win32con.FILE_FLAG_OVERLAPPED, + None, + ) + + # set to message mode. + win32pipe.SetNamedPipeHandleState( + hpipe, win32pipe.PIPE_READMODE_MESSAGE, None, None + ) + + hr, got = win32pipe.TransactNamedPipe(hpipe, str2bytes("foo\0bar"), 1024, None) + self.assertEqual(got, str2bytes("bar\0foo")) + event.wait(5) + self.assertTrue(event.isSet(), "Pipe server thread didn't terminate") + + def testTransactNamedPipeBlockingBuffer(self): + # Like testTransactNamedPipeBlocking, but a pre-allocated buffer is + # passed (not really that useful, but it exercises the code path) + event = threading.Event() + self.startPipeServer(event) + open_mode = win32con.GENERIC_READ | win32con.GENERIC_WRITE + + hpipe = win32file.CreateFile( + self.pipename, + open_mode, + 0, # no sharing + None, # default security + win32con.OPEN_EXISTING, + 0, # win32con.FILE_FLAG_OVERLAPPED, + None, + ) + + # set to message mode. + win32pipe.SetNamedPipeHandleState( + hpipe, win32pipe.PIPE_READMODE_MESSAGE, None, None + ) + + buffer = win32file.AllocateReadBuffer(1024) + hr, got = win32pipe.TransactNamedPipe( + hpipe, str2bytes("foo\0bar"), buffer, None + ) + self.assertEqual(got, str2bytes("bar\0foo")) + event.wait(5) + self.assertTrue(event.isSet(), "Pipe server thread didn't terminate") + + def testTransactNamedPipeAsync(self): + event = threading.Event() + overlapped = pywintypes.OVERLAPPED() + overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None) + self.startPipeServer(event, 0.5) + open_mode = win32con.GENERIC_READ | win32con.GENERIC_WRITE + + hpipe = win32file.CreateFile( + self.pipename, + open_mode, + 0, # no sharing + None, # default security + win32con.OPEN_EXISTING, + win32con.FILE_FLAG_OVERLAPPED, + None, + ) + + # set to message mode. + win32pipe.SetNamedPipeHandleState( + hpipe, win32pipe.PIPE_READMODE_MESSAGE, None, None + ) + + buffer = win32file.AllocateReadBuffer(1024) + hr, got = win32pipe.TransactNamedPipe( + hpipe, str2bytes("foo\0bar"), buffer, overlapped + ) + self.assertEqual(hr, winerror.ERROR_IO_PENDING) + nbytes = win32file.GetOverlappedResult(hpipe, overlapped, True) + got = buffer[:nbytes] + self.assertEqual(got, str2bytes("bar\0foo")) + event.wait(5) + self.assertTrue(event.isSet(), "Pipe server thread didn't terminate") + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_win32print.py b/lib/win32/test/test_win32print.py new file mode 100644 index 00000000..71fd2c03 --- /dev/null +++ b/lib/win32/test/test_win32print.py @@ -0,0 +1,24 @@ +# Tests (scarce) for win32print module + +import unittest + +import win32print as wprn + + +class Win32PrintTestCase(unittest.TestCase): + def setUp(self): + self.printer_idx = 0 + self.printer_levels_all = list(range(1, 10)) + self.local_printers = wprn.EnumPrinters(wprn.PRINTER_ENUM_LOCAL, None, 1) + + def test_printer_levels_read_dummy(self): + if not self.local_printers: + print("Test didn't run (no local printers)!") + return + ph = wprn.OpenPrinter(self.local_printers[self.printer_idx][2]) + for level in self.printer_levels_all: + wprn.GetPrinter(ph, level) + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_win32profile.py b/lib/win32/test/test_win32profile.py new file mode 100644 index 00000000..84dc83bc --- /dev/null +++ b/lib/win32/test/test_win32profile.py @@ -0,0 +1,18 @@ +"""Test win32profile""" +import os +import unittest + +import win32profile + + +class Tester(unittest.TestCase): + def test_environment(self): + os.environ["FOO"] = "bar=baz" + env = win32profile.GetEnvironmentStrings() + assert "FOO" in env + assert env["FOO"] == "bar=baz" + assert os.environ["FOO"] == "bar=baz" + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_win32rcparser.py b/lib/win32/test/test_win32rcparser.py new file mode 100644 index 00000000..6eae6884 --- /dev/null +++ b/lib/win32/test/test_win32rcparser.py @@ -0,0 +1,70 @@ +import os +import tempfile +import unittest + +import win32con +import win32rcparser + + +class TestParser(unittest.TestCase): + def setUp(self): + rc_file = os.path.join(os.path.dirname(__file__), "win32rcparser", "test.rc") + self.resources = win32rcparser.Parse(rc_file) + + def testStrings(self): + for sid, expected in ( + ("IDS_TEST_STRING4", "Test 'single quoted' string"), + ("IDS_TEST_STRING1", 'Test "quoted" string'), + ("IDS_TEST_STRING3", 'String with single " quote'), + ("IDS_TEST_STRING2", "Test string"), + ): + got = self.resources.stringTable[sid].value + self.assertEqual(got, expected) + + def testStandardIds(self): + for idc in "IDOK IDCANCEL".split(): + correct = getattr(win32con, idc) + self.assertEqual(self.resources.names[correct], idc) + self.assertEqual(self.resources.ids[idc], correct) + + def testTabStop(self): + d = self.resources.dialogs["IDD_TEST_DIALOG2"] + tabstop_names = ["IDC_EDIT1", "IDOK"] # should have WS_TABSTOP + tabstop_ids = [self.resources.ids[name] for name in tabstop_names] + notabstop_names = ["IDC_EDIT2"] # should have WS_TABSTOP + notabstop_ids = [self.resources.ids[name] for name in notabstop_names] + num_ok = 0 + for cdef in d[1:]: # skip dlgdef + # print cdef + cid = cdef[2] + style = cdef[-2] + styleex = cdef[-1] + if cid in tabstop_ids: + self.assertEqual(style & win32con.WS_TABSTOP, win32con.WS_TABSTOP) + num_ok += 1 + elif cid in notabstop_ids: + self.assertEqual(style & win32con.WS_TABSTOP, 0) + num_ok += 1 + self.assertEqual(num_ok, len(tabstop_ids) + len(notabstop_ids)) + + +class TestGenerated(TestParser): + def setUp(self): + # don't call base! + rc_file = os.path.join(os.path.dirname(__file__), "win32rcparser", "test.rc") + py_file = tempfile.mktemp("test_win32rcparser.py") + try: + win32rcparser.GenerateFrozenResource(rc_file, py_file) + py_source = open(py_file).read() + finally: + if os.path.isfile(py_file): + os.unlink(py_file) + + # poor-man's import :) + globs = {} + exec(py_source, globs, globs) + self.resources = globs["FakeParser"]() + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_win32timezone.py b/lib/win32/test/test_win32timezone.py new file mode 100644 index 00000000..6dba51ed --- /dev/null +++ b/lib/win32/test/test_win32timezone.py @@ -0,0 +1,27 @@ +# Test module for win32timezone + +import doctest +import sys +import unittest + +import win32timezone + + +class Win32TimeZoneTest(unittest.TestCase): + def testWin32TZ(self): + # On 3.7 and later, the repr() for datetime objects changed to use kwargs - eg, + # eg, `datetime.timedelta(0, 10800)` is now `datetime.timedelta(seconds=10800)`. + # So we just skip the tests on 3.5 and 3.6 + if sys.version_info < (3, 7): + from pywin32_testutil import TestSkipped + + raise TestSkipped( + "The repr() for datetime objects makes this test fail in 3.5 and 3.6" + ) + + failed, total = doctest.testmod(win32timezone, verbose=False) + self.assertFalse(failed) + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/test_win32trace.py b/lib/win32/test/test_win32trace.py new file mode 100644 index 00000000..8b241cbb --- /dev/null +++ b/lib/win32/test/test_win32trace.py @@ -0,0 +1,369 @@ +import os +import sys +import threading +import time +import unittest + +import win32trace +from pywin32_testutil import TestSkipped + +if __name__ == "__main__": + this_file = sys.argv[0] +else: + this_file = __file__ + + +def SkipIfCI(): + # This test often fails in CI, probably when it is being run multiple times + # (ie, for different Python versions) + # Github actions always have a `CI` variable. + if "CI" in os.environ: + raise TestSkipped("We skip this test on CI") + + +def CheckNoOtherReaders(): + win32trace.write("Hi") + time.sleep(0.05) + if win32trace.read() != "Hi": + # Reset everything so following tests still fail with this error! + win32trace.TermRead() + win32trace.TermWrite() + raise RuntimeError( + "An existing win32trace reader appears to be " + "running - please stop this process and try again" + ) + + +class TestInitOps(unittest.TestCase): + def setUp(self): + SkipIfCI() + # clear old data + win32trace.InitRead() + win32trace.read() + win32trace.TermRead() + + def tearDown(self): + try: + win32trace.TermRead() + except win32trace.error: + pass + try: + win32trace.TermWrite() + except win32trace.error: + pass + + def testInitTermRead(self): + self.assertRaises(win32trace.error, win32trace.read) + win32trace.InitRead() + result = win32trace.read() + self.assertEqual(result, "") + win32trace.TermRead() + self.assertRaises(win32trace.error, win32trace.read) + + win32trace.InitRead() + self.assertRaises(win32trace.error, win32trace.InitRead) + win32trace.InitWrite() + self.assertRaises(win32trace.error, win32trace.InitWrite) + win32trace.TermWrite() + win32trace.TermRead() + + def testInitTermWrite(self): + self.assertRaises(win32trace.error, win32trace.write, "Hei") + win32trace.InitWrite() + win32trace.write("Johan Galtung") + win32trace.TermWrite() + self.assertRaises(win32trace.error, win32trace.write, "Hei") + + def testTermSematics(self): + win32trace.InitWrite() + win32trace.write("Ta da") + + # if we both Write and Read are terminated at the same time, + # we lose the data as the win32 object is closed. Note that + # if another writer is running, we do *not* lose the data - so + # test for either the correct data or an empty string + win32trace.TermWrite() + win32trace.InitRead() + self.assertTrue(win32trace.read() in ("Ta da", "")) + win32trace.TermRead() + + # we keep the data because we init read before terminating write + win32trace.InitWrite() + win32trace.write("Ta da") + win32trace.InitRead() + win32trace.TermWrite() + self.assertEqual("Ta da", win32trace.read()) + win32trace.TermRead() + + +class BasicSetupTearDown(unittest.TestCase): + def setUp(self): + SkipIfCI() + win32trace.InitRead() + # If any other writers are running (even if not actively writing), + # terminating the module will *not* close the handle, meaning old data + # will remain. This can cause other tests to fail. + win32trace.read() + win32trace.InitWrite() + + def tearDown(self): + win32trace.TermWrite() + win32trace.TermRead() + + +class TestModuleOps(BasicSetupTearDown): + def testRoundTrip(self): + win32trace.write("Syver Enstad") + syverEnstad = win32trace.read() + self.assertEqual("Syver Enstad", syverEnstad) + + def testRoundTripUnicode(self): + win32trace.write("\xa9opyright Syver Enstad") + syverEnstad = win32trace.read() + # str objects are always returned in py2k (latin-1 encoding was used + # on unicode objects) + self.assertEqual("\xa9opyright Syver Enstad", syverEnstad) + + def testBlockingRead(self): + win32trace.write("Syver Enstad") + self.assertEqual("Syver Enstad", win32trace.blockingread()) + + def testBlockingReadUnicode(self): + win32trace.write("\xa9opyright Syver Enstad") + # str objects are always returned in py2k (latin-1 encoding was used + # on unicode objects) + self.assertEqual("\xa9opyright Syver Enstad", win32trace.blockingread()) + + def testFlush(self): + win32trace.flush() + + +class TestTraceObjectOps(BasicSetupTearDown): + def testInit(self): + win32trace.TermRead() + win32trace.TermWrite() + traceObject = win32trace.GetTracer() + self.assertRaises(win32trace.error, traceObject.read) + self.assertRaises(win32trace.error, traceObject.write, "") + win32trace.InitRead() + win32trace.InitWrite() + self.assertEqual("", traceObject.read()) + traceObject.write("Syver") + + def testFlush(self): + traceObject = win32trace.GetTracer() + traceObject.flush() + + def testIsatty(self): + tracer = win32trace.GetTracer() + assert tracer.isatty() == False + + def testRoundTrip(self): + traceObject = win32trace.GetTracer() + traceObject.write("Syver Enstad") + self.assertEqual("Syver Enstad", traceObject.read()) + + +class WriterThread(threading.Thread): + def run(self): + self.writeCount = 0 + for each in range(self.BucketCount): + win32trace.write(str(each)) + self.writeCount = self.BucketCount + + def verifyWritten(self): + return self.writeCount == self.BucketCount + + +class TestMultipleThreadsWriting(unittest.TestCase): + # FullBucket is the thread count + FullBucket = 50 + BucketCount = 9 # buckets must be a single digit number (ie. less than 10) + + def setUp(self): + SkipIfCI() + WriterThread.BucketCount = self.BucketCount + win32trace.InitRead() + win32trace.read() # clear any old data. + win32trace.InitWrite() + CheckNoOtherReaders() + self.threads = [WriterThread() for each in range(self.FullBucket)] + self.buckets = list(range(self.BucketCount)) + for each in self.buckets: + self.buckets[each] = 0 + + def tearDown(self): + win32trace.TermRead() + win32trace.TermWrite() + + def areBucketsFull(self): + bucketsAreFull = True + for each in self.buckets: + assert each <= self.FullBucket, each + if each != self.FullBucket: + bucketsAreFull = False + break + return bucketsAreFull + + def read(self): + while 1: + readString = win32trace.blockingread() + for ch in readString: + integer = int(ch) + count = self.buckets[integer] + assert count != -1 + self.buckets[integer] = count + 1 + if self.buckets[integer] == self.FullBucket: + if self.areBucketsFull(): + return + + def testThreads(self): + for each in self.threads: + each.start() + self.read() + for each in self.threads: + each.join() + for each in self.threads: + assert each.verifyWritten() + assert self.areBucketsFull() + + +class TestHugeChunks(unittest.TestCase): + # BiggestChunk is the size where we stop stressing the writer + BiggestChunk = 2**16 # 256k should do it. + + def setUp(self): + SkipIfCI() + win32trace.InitRead() + win32trace.read() # clear any old data + win32trace.InitWrite() + + def testHugeChunks(self): + data = "*" * 1023 + "\n" + while len(data) <= self.BiggestChunk: + win32trace.write(data) + data = data + data + # If we made it here, we passed. + + def tearDown(self): + win32trace.TermRead() + win32trace.TermWrite() + + +import win32event +import win32process + + +class TraceWriteProcess: + def __init__(self, threadCount): + self.exitCode = -1 + self.threadCount = threadCount + + def start(self): + procHandle, threadHandle, procId, threadId = win32process.CreateProcess( + None, # appName + 'python.exe "%s" /run_test_process %s %s' + % (this_file, self.BucketCount, self.threadCount), + None, # process security + None, # thread security + 0, # inherit handles + win32process.NORMAL_PRIORITY_CLASS, + None, # new environment + None, # Current directory + win32process.STARTUPINFO(), # startup info + ) + self.processHandle = procHandle + + def join(self): + win32event.WaitForSingleObject(self.processHandle, win32event.INFINITE) + self.exitCode = win32process.GetExitCodeProcess(self.processHandle) + + def verifyWritten(self): + return self.exitCode == 0 + + +class TestOutofProcess(unittest.TestCase): + BucketCount = 9 + FullBucket = 50 + + def setUp(self): + SkipIfCI() + win32trace.InitRead() + TraceWriteProcess.BucketCount = self.BucketCount + self.setUpWriters() + self.buckets = list(range(self.BucketCount)) + for each in self.buckets: + self.buckets[each] = 0 + + def tearDown(self): + win32trace.TermRead() + + def setUpWriters(self): + self.processes = [] + # 5 processes, quot threads in each process + quot, remainder = divmod(self.FullBucket, 5) + for each in range(5): + self.processes.append(TraceWriteProcess(quot)) + if remainder: + self.processes.append(TraceWriteProcess(remainder)) + + def areBucketsFull(self): + bucketsAreFull = True + for each in self.buckets: + assert each <= self.FullBucket, each + if each != self.FullBucket: + bucketsAreFull = False + break + return bucketsAreFull + + def read(self): + while 1: + readString = win32trace.blockingread() + for ch in readString: + integer = int(ch) + count = self.buckets[integer] + assert count != -1 + self.buckets[integer] = count + 1 + if self.buckets[integer] == self.FullBucket: + if self.areBucketsFull(): + return + + def testProcesses(self): + for each in self.processes: + each.start() + self.read() + for each in self.processes: + each.join() + for each in self.processes: + assert each.verifyWritten() + assert self.areBucketsFull() + + +def _RunAsTestProcess(): + # Run as an external process by the main tests. + WriterThread.BucketCount = int(sys.argv[2]) + threadCount = int(sys.argv[3]) + threads = [WriterThread() for each in range(threadCount)] + win32trace.InitWrite() + for t in threads: + t.start() + for t in threads: + t.join() + for t in threads: + if not t.verifyWritten(): + sys.exit(-1) + + +if __name__ == "__main__": + if sys.argv[1:2] == ["/run_test_process"]: + _RunAsTestProcess() + sys.exit(0) + # If some other win32traceutil reader is running, these tests fail + # badly (as the other reader sometimes sees the output!) + win32trace.InitRead() + win32trace.InitWrite() + CheckNoOtherReaders() + # reset state so test env is back to normal + win32trace.TermRead() + win32trace.TermWrite() + unittest.main() diff --git a/lib/win32/test/test_win32wnet.py b/lib/win32/test/test_win32wnet.py new file mode 100644 index 00000000..04ad8a4d --- /dev/null +++ b/lib/win32/test/test_win32wnet.py @@ -0,0 +1,175 @@ +import unittest + +import netbios +import win32api +import win32wnet +from pywin32_testutil import str2bytes + +RESOURCE_CONNECTED = 0x00000001 +RESOURCE_GLOBALNET = 0x00000002 +RESOURCE_REMEMBERED = 0x00000003 +RESOURCE_RECENT = 0x00000004 +RESOURCE_CONTEXT = 0x00000005 +RESOURCETYPE_ANY = 0x00000000 +RESOURCETYPE_DISK = 0x00000001 +RESOURCETYPE_PRINT = 0x00000002 +RESOURCETYPE_RESERVED = 0x00000008 +RESOURCETYPE_UNKNOWN = 0xFFFFFFFF +RESOURCEUSAGE_CONNECTABLE = 0x00000001 +RESOURCEUSAGE_CONTAINER = 0x00000002 +RESOURCEDISPLAYTYPE_GENERIC = 0x00000000 +RESOURCEDISPLAYTYPE_DOMAIN = 0x00000001 +RESOURCEDISPLAYTYPE_SERVER = 0x00000002 +RESOURCEDISPLAYTYPE_SHARE = 0x00000003 + + +NETRESOURCE_attributes = [ + ("dwScope", int), + ("dwType", int), + ("dwDisplayType", int), + ("dwUsage", int), + ("lpLocalName", str), + ("lpRemoteName", str), + ("lpComment", str), + ("lpProvider", str), +] + +NCB_attributes = [ + ("Command", int), + ("Retcode", int), + ("Lsn", int), + ("Num", int), + # ("Bufflen", int), - read-only + ("Callname", str), + ("Name", str), + ("Rto", int), + ("Sto", int), + ("Lana_num", int), + ("Cmd_cplt", int), + ("Event", int), + ("Post", int), +] + + +class TestCase(unittest.TestCase): + def testGetUser(self): + self.assertEqual(win32api.GetUserName(), win32wnet.WNetGetUser()) + + def _checkItemAttributes(self, item, attrs): + for attr, typ in attrs: + val = getattr(item, attr) + if typ is int: + self.assertTrue( + type(val) in (int,), "Attr %r has value %r" % (attr, val) + ) + new_val = val + 1 + elif typ is str: + if val is not None: + # on py2k, must be string or unicode. py3k must be string or bytes. + self.assertTrue( + type(val) in (str, str), "Attr %r has value %r" % (attr, val) + ) + new_val = val + " new value" + else: + new_val = "new value" + else: + self.fail("Don't know what %s is" % (typ,)) + # set the attribute just to make sure we can. + setattr(item, attr, new_val) + + def testNETRESOURCE(self): + nr = win32wnet.NETRESOURCE() + self._checkItemAttributes(nr, NETRESOURCE_attributes) + + def testWNetEnumResource(self): + handle = win32wnet.WNetOpenEnum(RESOURCE_GLOBALNET, RESOURCETYPE_ANY, 0, None) + try: + while 1: + items = win32wnet.WNetEnumResource(handle, 0) + if len(items) == 0: + break + for item in items: + self._checkItemAttributes(item, NETRESOURCE_attributes) + finally: + handle.Close() + + def testNCB(self): + ncb = win32wnet.NCB() + self._checkItemAttributes(ncb, NCB_attributes) + + def testNetbios(self): + # taken from the demo code in netbios.py + ncb = win32wnet.NCB() + ncb.Command = netbios.NCBENUM + la_enum = netbios.LANA_ENUM() + ncb.Buffer = la_enum + rc = win32wnet.Netbios(ncb) + self.assertEqual(rc, 0) + for i in range(la_enum.length): + ncb.Reset() + ncb.Command = netbios.NCBRESET + ncb.Lana_num = netbios.byte_to_int(la_enum.lana[i]) + rc = Netbios(ncb) + self.assertEqual(rc, 0) + ncb.Reset() + ncb.Command = netbios.NCBASTAT + ncb.Lana_num = byte_to_int(la_enum.lana[i]) + ncb.Callname = str2bytes("* ") # ensure bytes on py2x and 3k + adapter = netbios.ADAPTER_STATUS() + ncb.Buffer = adapter + Netbios(ncb) + # expect 6 bytes in the mac address. + self.assertTrue(len(adapter.adapter_address), 6) + + def iterConnectableShares(self): + nr = win32wnet.NETRESOURCE() + nr.dwScope = RESOURCE_GLOBALNET + nr.dwUsage = RESOURCEUSAGE_CONTAINER + nr.lpRemoteName = "\\\\" + win32api.GetComputerName() + + handle = win32wnet.WNetOpenEnum(RESOURCE_GLOBALNET, RESOURCETYPE_ANY, 0, nr) + while 1: + items = win32wnet.WNetEnumResource(handle, 0) + if len(items) == 0: + break + for item in items: + if item.dwDisplayType == RESOURCEDISPLAYTYPE_SHARE: + yield item + + def findUnusedDriveLetter(self): + existing = [ + x[0].lower() for x in win32api.GetLogicalDriveStrings().split("\0") if x + ] + handle = win32wnet.WNetOpenEnum(RESOURCE_REMEMBERED, RESOURCETYPE_DISK, 0, None) + try: + while 1: + items = win32wnet.WNetEnumResource(handle, 0) + if len(items) == 0: + break + xtra = [i.lpLocalName[0].lower() for i in items if i.lpLocalName] + existing.extend(xtra) + finally: + handle.Close() + for maybe in "defghijklmnopqrstuvwxyz": + if maybe not in existing: + return maybe + self.fail("All drive mappings are taken?") + + def testAddConnection(self): + localName = self.findUnusedDriveLetter() + ":" + for share in self.iterConnectableShares(): + share.lpLocalName = localName + win32wnet.WNetAddConnection2(share) + win32wnet.WNetCancelConnection2(localName, 0, 0) + break + + def testAddConnectionOld(self): + localName = self.findUnusedDriveLetter() + ":" + for share in self.iterConnectableShares(): + win32wnet.WNetAddConnection2(share.dwType, localName, share.lpRemoteName) + win32wnet.WNetCancelConnection2(localName, 0, 0) + break + + +if __name__ == "__main__": + unittest.main() diff --git a/lib/win32/test/testall.py b/lib/win32/test/testall.py new file mode 100644 index 00000000..d3df2630 --- /dev/null +++ b/lib/win32/test/testall.py @@ -0,0 +1,230 @@ +import os +import re +import sys +import traceback +import unittest + +import pywin32_testutil + +# A list of demos that depend on user-interface of *any* kind. Tests listed +# here are not suitable for unattended testing. +ui_demos = """GetSaveFileName print_desktop win32cred_demo win32gui_demo + win32gui_dialog win32gui_menu win32gui_taskbar + win32rcparser_demo winprocess win32console_demo + win32clipboard_bitmapdemo + win32gui_devicenotify + NetValidatePasswordPolicy""".split() +# Other demos known as 'bad' (or at least highly unlikely to work) +# cerapi: no CE module is built (CE via pywin32 appears dead) +# desktopmanager: hangs (well, hangs for 60secs or so...) +# EvtSubscribe_*: must be run together: +# SystemParametersInfo: a couple of the params cause markh to hang, and there's +# no great reason to adjust (twice!) all those system settings! +bad_demos = """cerapi desktopmanager win32comport_demo + EvtSubscribe_pull EvtSubscribe_push + SystemParametersInfo + """.split() + +argvs = { + "rastest": ("-l",), +} + +no_user_interaction = True + +# re to pull apart an exception line into the exception type and the args. +re_exception = re.compile("([a-zA-Z0-9_.]*): (.*)$") + + +def find_exception_in_output(data): + have_traceback = False + for line in data.splitlines(): + line = line.decode("ascii") # not sure what the correct encoding is... + if line.startswith("Traceback ("): + have_traceback = True + continue + if line.startswith(" "): + continue + if have_traceback: + # first line not starting with a space since the traceback. + # must be the exception! + m = re_exception.match(line) + if m: + exc_type, args = m.groups() + # get hacky - get the *real* exception object from the name. + bits = exc_type.split(".", 1) + if len(bits) > 1: + mod = __import__(bits[0]) + exc = getattr(mod, bits[1]) + else: + # probably builtin + exc = eval(bits[0]) + else: + # hrm - probably just an exception with no args + try: + exc = eval(line.strip()) + args = "()" + except: + return None + # try and turn the args into real args. + try: + args = eval(args) + except: + pass + if not isinstance(args, tuple): + args = (args,) + # try and instantiate the exception. + try: + ret = exc(*args) + except: + ret = None + return ret + # apparently not - keep looking... + have_traceback = False + + +class TestRunner: + def __init__(self, argv): + self.argv = argv + self.__name__ = "Test Runner for cmdline {}".format(argv) + + def __call__(self): + import subprocess + + p = subprocess.Popen( + self.argv, stdout=subprocess.PIPE, stderr=subprocess.STDOUT + ) + output, _ = p.communicate() + rc = p.returncode + + if rc: + base = os.path.basename(self.argv[1]) + # See if we can detect and reconstruct an exception in the output. + reconstituted = find_exception_in_output(output) + if reconstituted is not None: + raise reconstituted + raise AssertionError( + "%s failed with exit code %s. Output is:\n%s" % (base, rc, output) + ) + + +def get_demo_tests(): + import win32api + + ret = [] + demo_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "Demos")) + assert os.path.isdir(demo_dir), demo_dir + for name in os.listdir(demo_dir): + base, ext = os.path.splitext(name) + if base in ui_demos and no_user_interaction: + continue + # Skip any other files than .py and bad tests in any case + if ext != ".py" or base in bad_demos: + continue + argv = (sys.executable, os.path.join(demo_dir, base + ".py")) + argvs.get( + base, () + ) + ret.append( + unittest.FunctionTestCase( + TestRunner(argv), description="win32/demos/" + name + ) + ) + return ret + + +def import_all(): + # Some hacks for import order - dde depends on win32ui + try: + import win32ui + except ImportError: + pass # 'what-ev-a....' + + import win32api + + dir = os.path.dirname(win32api.__file__) + num = 0 + is_debug = os.path.basename(win32api.__file__).endswith("_d") + for name in os.listdir(dir): + base, ext = os.path.splitext(name) + # handle `modname.cp310-win_amd64.pyd` etc + base = base.split(".")[0] + if ( + (ext == ".pyd") + and name != "_winxptheme.pyd" + and ( + is_debug + and base.endswith("_d") + or not is_debug + and not base.endswith("_d") + ) + ): + try: + __import__(base) + except: + print("FAILED to import", name) + raise + num += 1 + + +def suite(): + # Loop over all .py files here, except me :) + try: + me = __file__ + except NameError: + me = sys.argv[0] + me = os.path.abspath(me) + files = os.listdir(os.path.dirname(me)) + suite = unittest.TestSuite() + suite.addTest(unittest.FunctionTestCase(import_all)) + for file in files: + base, ext = os.path.splitext(file) + if ext == ".py" and os.path.basename(me) != file: + try: + mod = __import__(base) + except: + print("FAILED to import test module %r" % base) + traceback.print_exc() + continue + if hasattr(mod, "suite"): + test = mod.suite() + else: + test = unittest.defaultTestLoader.loadTestsFromModule(mod) + suite.addTest(test) + for test in get_demo_tests(): + suite.addTest(test) + return suite + + +class CustomLoader(pywin32_testutil.TestLoader): + def loadTestsFromModule(self, module): + return self.fixupTestsForLeakTests(suite()) + + +if __name__ == "__main__": + import argparse + + parser = argparse.ArgumentParser(description="Test runner for PyWin32/win32") + parser.add_argument( + "-no-user-interaction", + default=False, + action="store_true", + help="(This is now the default - use `-user-interaction` to include them)", + ) + + parser.add_argument( + "-user-interaction", + action="store_true", + help="Include tests which require user interaction", + ) + + parsed_args, remains = parser.parse_known_args() + + if parsed_args.no_user_interaction: + print( + "Note: -no-user-interaction is now the default, run with `-user-interaction` to include them." + ) + + no_user_interaction = not parsed_args.user_interaction + + sys.argv = [sys.argv[0]] + remains + + pywin32_testutil.testmain(testLoader=CustomLoader()) diff --git a/lib/win32/test/win32rcparser/python.bmp b/lib/win32/test/win32rcparser/python.bmp new file mode 100644 index 0000000000000000000000000000000000000000..f674769727da6c39c007001d43f89e1b5ca88f89 GIT binary patch literal 778 zcmaKqJ5B>J5QYa#6Q}SQ=qN3@b4ky2sP_mdXhIW9?tFz%>;X8;v{dGw8Sg_YgyZMu ze>{)P>zj9^?H%(A#`72t^rZabQI|iai3pvh$rjAm(mc;t<)Uk+-ere@pCCCO8q2+0 zP*`sU<5o++Uin}ywN`v<3XO4VH6`>EIP{g_EG_!7u#^qSEbrnC*g}G{!-&I&2Lp(l zqFa~~2N5w+U}Lw=DzvakY;QNbnB+wZS=i47evk=VZh2fK0f%sgP+~cKW-=^8c4qiL6WgN>*^DBuwjG&RY~t8_ JbPk9A+AsNib7BAh literal 0 HcmV?d00001 diff --git a/lib/win32/test/win32rcparser/python.ico b/lib/win32/test/win32rcparser/python.ico new file mode 100644 index 0000000000000000000000000000000000000000..f714eea446e4b6bd28f9e0f1c8f75f6c81fba9c6 GIT binary patch literal 766 zcmaJm8xh$y8nAma-W z^$0#H>2kty>X)hwIrlE-S<5+vz&A`n&h*v18|y+>sjix$aZle8p4@4^r5n6eZnc>@ zG>`3+P&u~b2-=|v7s{bGs2nePG0P+8gx8LOTO>dQCQJqF(DmA(7NnHmI`9r7=bX7` z!W?&ubNbFr2j~zfBlk1694)bC>aTGXW{#1EPUo#Q3jUW;)Gsjwb=$3Xc0uvBe*c&M z&1daA>)3`jT()1f=0DJg9L%!}boam$VF^QEz=~*YKd>1d7=z`x4 + + + +Generated Python COM Support + + + + + + +

    Python and COM - Blowing the others away

    +

    Generated Python COM Support

    +

    This file describes how the Python COM extensions support "generated files". The information contained here is for expert Python users, and people who need to take advantage of the advanced features of the support. More general information is available in the Quick Start to Client Side COM documentation.

    +

    Introduction

    +

    Generated Python COM support means that a .py file exists behind a particular COM object. This .py file is created by a generation process from a COM type library.

    +

    This documentation talks about the process of the creation of the .py files.

    +

    Design Goals

    +

    The main design goal is that the Python programmer need not know much about the type library they wish to work with. They need not know the name of a specific Python module to use a type library. COM uses an IID, version and LCID to identify a type library. Therefore, the Python programmer only need know this information to obtain a Python module.

    +

    How to generate support files

    +

    Support files can be generated either "off-line" by the makepy utility, or in custom Python code.

    +

    Using makepy is in many ways far simpler - you simply pick the type library and you are ready to go! The Quick Start to Client Side COM documentation describes this process.

    +

    Often however, you will want to use code to ensure the type library has been processed. This document describes that process.

    +

    Usage

    +

    The win32com.client.gencache module implements all functionality. As described above, if you wish to generate support from code, you need to know the IID, version and LCID of the type library.

    +

    The following functions are defined. The best examples of their usage is probably in the Pythonwin OCX Demos, and the COM Test Suite (particularly testMSOffice.py)

    +

    Note that the gencache.py file supports being run from the command line, and provides some utilities for managing the cache. Run the file to see usage options.

    +

    Using makepy to help with the runtime generation

    +

    makepy supports a "-i" option, to print information about a type library. When you select a type library, makepy will print out 2 lines of code that you cant paste into your application. This will then allow your module to generate the makepy .py file at runtime, but will only take you a few seconds!

    +

    win32com.client.gencache functions

    +

    def MakeModuleForTypelib(typelibCLSID, lcid, major, minor, progressInstance = None):

    +

    Generate support for a type library.

    +

    Given the IID, LCID and version information for a type library, generate and import the necessary support files.

    +

    Returns

    +

    The Python module. No exceptions are caught.

    +

    Params

    +

    typelibCLSID
    +IID of the type library.

    +

    major
    +Integer major version.

    +

    minor
    +Integer minor version.

    +

    lcid
    +Integer LCID for the library.

    +

    progressInstance
    +A class instance to use as the progress indicator, or None to use the default GUI one. 

    +

    def EnsureModule(typelibCLSID, lcid, major, minor, progressInstance = None):

    +

    Ensure Python support is loaded for a type library, generating if necessary.

    +

    Given the IID, LCID and version information for a type library, check and if necessary generate, then import the necessary support files.

    +

    Returns:

    +

    The Python module. No exceptions are caught during the generate process.

    +

    Params

    +

    typelibCLSID
    +IID of the type library.

    +

    major
    +Integer major version.

    +

    minor
    +Integer minor version.

    +

    lcid
    +Integer LCID for the library.

    +

    progressInstance
    +A class instance to use as the progress indicator, or None to use the default GUI one. 

    +

     

    +

    def GetClassForProgID(progid):

    +

    Get a Python class for a Program ID

    +

    Given a Program ID, return a Python class which wraps the COM object

    +

    Returns

    +

    The Python class, or None if no module is available.

    +

    Params

    +

    progid
    +    A COM ProgramID or IID (eg, "Word.Application")

    +

     

    +

    def GetModuleForProgID(progid):

    +

    Get a Python module for a Program ID

    +

    Given a Program ID, return a Python module which contains the class which wraps the COM object.

    +

    Returns

    +

    The Python module, or None if no module is available.

    +

    Params:

    +

    progid
    +    A COM ProgramID or IID (eg, "Word.Application")

    +

     

    +

    def GetModuleForCLSID(clsid):

    +

    Get a Python module for a CLSID

    +

    Given a CLSID, return a Python module which contains the class which wraps the COM object.

    +

    Returns

    +

    The Python module, or None if no module is available.

    +

    Params

    +

    progid
    +    A COM CLSID (ie, not the description)

    +

     

    +

    def GetModuleForTypelib(typelibCLSID, lcid, major, minor):

    +

    Get a Python module for a type library ID

    +

    Returns

    +

    An imported Python module, else None

    +

    Params:

    +

    typelibCLSID
    +IID of the type library.

    +

    major
    +Integer major version.

    +

    minor
    +Integer minor version

    +

    lcid
    +Integer LCID for the library.

    + diff --git a/lib/win32com/HTML/PythonCOM.html b/lib/win32com/HTML/PythonCOM.html new file mode 100644 index 00000000..ed48a897 --- /dev/null +++ b/lib/win32com/HTML/PythonCOM.html @@ -0,0 +1,90 @@ + + + + +Untitled + + + + +

    Python and COM - Blowing the others away

    +

    Python and COM - Implementation Details

    +

    Introduction

    +

    This document describes the technical implementation of the COM support in Python. It is primarily concerned with the underlying C++ interface to COM, although general Python issues are touched.

    +

    This document is targeted at people who wish to maintain/enhance the standard COM support (typically by writing extension modules). For information on using Python and COM from a Python programmers perspective, please see the documentation index.

    +

    General COM Support.

    +

    COM support in Python can be broken into 2 general areas - C++ support, and Python support. C++ support exists in the core PythonCOM module (plus any PythonCOM extension modules). Python support exists in the .py files that accompany the core module.

    +

    Naming Conventions

    +

    The naming conventions used by Python code will be:

    + +
      +
    • The Python "New Import" (ni) module will be used, allowing packages, or nested modules.
      • +
    • The package name will be "win32com".
      • +
    • The core module name will be "pythoncom" (ie, "win32com.pythoncom")
    + +

    The rest of the naming conventions are yet to be worked out.

    +

    Core COM support.

    +

    This section is involved with the core C++ support in "pythoncom".

    +

    The organisation of PythonCOM support falls into 3 discrete areas.

    +

    COM Client Support

    +

    This is the ability to manipulate other COM objects via their exposed interface. This includes use of IDispatch (eg using Python to start Microsoft Word, open a file, and print it.) but also all client side IUnknown derived objects fall into this category, including ITypeLib and IConnectionPoint support.

    +

    COM Server Support

    +

    This is ability for Python to create COM Servers, which can be manipulated by another COM client. This includes server side IDispatch (eg, Visual Basic starting a Python interpreter, and asking it to evaluate some code) but also all supported server side IUnknown derived classes.

    +

    Python/COM type and value conversion

    +

    This is internal code used by the above areas to managed the conversion to and from Python/COM types and values. This includes code to convert an arbitrary Python object into a COM variant, manages return types, and a few other helpers.

    +

    COM Structures and Python Types

    +

    OLE supports many C level structures for the COM API, which must be mapped to Python.

    +

    VARIANT

    +

    Variants are never exposed as such to Python programs. The internal framework always converts all variants to and from Python types. In some cases, type descriptions may be used, which force specific mappings, although in general the automatic conversion works fine.

    +

    TYPEDESC

    +

    A tuple, containing the elements of the C union. This union will be correctly decoded by the support code.

    +

    ELEMDESC

    +

    A tuple of TYPEDESC and PARAMDESC objects.

    +

    FUNCDESC

    +

    A funcdesc is a large and unwieldy tuple. Documentation to be supplied.

    +

    IID/CLSID

    +

    A native IID in Python is a special type, defined in pythoncom. Whenever a CLSID/IID is required, typically either an object, a tuple of type "iii(iiiiiiii)" or string can be used.

    +

    Helper functions are available to convert to and from IID/CLSID and strings.

    +

    COM Framework

    +

    Both client and server side support have a specific framework in place to assist in supporting the widest possible set of interfaces. The framework allows external extension DLLs to be written, which extend the interfaces available to the Python user.

    +

    This allows the core PythonCOM module to support a wide set of common interfaces, and other extensions to support anything obscure.

    +

    Client Framework

    +

    QueryInterface and Types

    +

    When the only support required by Python is IDispatch, everything is simple - every object returned from QueryInterface is a PyIDispatch object. But this does not extend to other types, such as ITypeLib, IConnectionPoint etc., which are required for full COM support.

    +

    For example, consider the following C++ psuedo-code:

    +

    IConnectionPoint *conPt;
    +someIDispatch->QueryInterface(IID_IConnectionPoint, (void **)&conPt);
    +// Note the IID_ and type of the * could be anything!

    +

    This cast, and knowledge of a specific IID_* to type must be simulated in Python.

    +

    Python/COM will therefore maintain a map of UID's to Python type objects. Whenever QueryInterface is called, Python will lookup this map, to determine if the object type is supported. If the object is supported, then an object of that type will be returned. If the object is not supported, then a PyIUnknown object will be returned.

    +

    Note that PyIDispatch will be supported by the core engine. Therefore:

    +

    >>> disp=someobj.QueryInterface(win32com.IID_Dispatch)

    +

    will return a PyIDispatch object, whereas

    +

    >>> unk=someobj.QueryInterface(SomeUnknownIID) # returns PyIUnknown
    +>>> disp=unk.QueryInterface(win32com.IID_Dispatch)
    +>>> unk.Release() # Clean up now, rather than waiting for unk death.

    +

    Is needed to convert to an IDispatch object.

    +

    Core Support

    +

    The core COM support module will support the IUnknown, IDispatch, ITypeInfo, ITypeLib and IConnectionPointContainer and IConnectionPoint interfaces. This implies the core COM module supports 6 different OLE client object types, mapped to the 6 IID_*'s representing the objects. (The IConnection* objects allow for Python to repsond to COM events)

    +

    A psuedo-inheritance scheme is used. The Python types are all derived from the Python IUnknown type (PyIUnknown). Therefore all IUnknown methods are automatically available to all types, just as it should be. The PyIUnknown type manages all object reference counts and destruction.

    +

    Extensibility

    +

    To provide the above functionality, a Python map is provided, which maps from a GUID to a Python type object.

    +

    The advantage of this scheme is an external extension modules can hook into the core support. For example, imagine the following code:

    +

    >>> import myextracom # external .pyd supporting some interface.
    +# myextracom.pyd will do the equivilent of

    +

    # pythoncom.mapSupportedTypes(myextracom.IID_Extra, myextracom.ExtraType)
    +>>> someobj.QueryInterface(myextracom.IID_Extra)

    +

    Would correctly return an object defined in the extension module.

    +

    Server Framework

    +

    General Framework

    +

    A server framework has been put in place which provides the following features:

    +

    All Interfaces provide VTBL support - this means that the Servers exposed by Python are callable from C++ and other compiled languages.

    +

    Supports full "inproc" servers. This means that no external .EXE is needed making Python COM servers available in almost all cases.

    +

    An extensible model which allows for extension modules to provide server support for interfaces defined in that module. A map is provided which maps from a GUID to a function pointer which creates the interface.

    +

    Python and Variant Types Conversion

    +

    In general, Python and COM are both "type-less". COM is type-less via the VARIANT object, which supports many types, and Python is type-less due to its object model.

    +

    There are a number of areas where Python and OLE clash.

    +

    Parameters and conversions.

    +

    For simple calls, there are 2 helpers available which will convert to and from PyObjects and VARIANTS. The call to convert a Python object to a VARIANT is simple in that it returns a VARIANT of the most appropriate type for the Python object - ie, the type of the Python object determines the resulting VARIANT type.

    +

    There are also more complex conversion routines available, wrapped in a C++ helper class. Typically, these helpers are used whenever a specific variant type is known (eg, when an ITypeInfo is available for the object being used). In this case, all efforts are made to convert the Python type to the requested variant type - ie, in this situation, the VARIANT type determines how the Python object is coerced. In addition, this code supports the use of "ByRef" and pointer paramaters, providing and freeing any buffers necessary for the call.

    + diff --git a/lib/win32com/HTML/QuickStartClientCom.html b/lib/win32com/HTML/QuickStartClientCom.html new file mode 100644 index 00000000..f3a02742 --- /dev/null +++ b/lib/win32com/HTML/QuickStartClientCom.html @@ -0,0 +1,82 @@ + + + + +Quick Start to Client side COM and Python + + + + +

    Quick Start to Client side COM and Python

    +

    Introduction

    +

    This documents how to quickly start using COM from Python. It is not a thorough discussion of the COM system, or of the concepts introduced by COM.

    +

    Other good information on COM can be found in various conference tutorials - please see the collection of Mark's conference tutorials

    +

    For information on implementing COM objects using Python, please see a Quick Start to Server side COM and Python

    +

    In this document we discuss the following topics:

    + + + +

    Quick Start

    +

    To use a COM object from Python

    +

    import win32com.client
    +o = win32com.client.Dispatch("Object.Name")
    +o.Method()
    +o.property = "New Value"
    +print o.property

    +

    Example

    +

    o = win32com.client.Dispatch("Excel.Application")
    +o.Visible = 1
    +o.Workbooks.Add() # for office 97 – 95 a bit different!
    +o.Cells(1,1).Value = "Hello"

    +

    And we will see the word "Hello" appear in the top cell.

    +

    How do I know which methods and properties are available?

    +

    Good question. This is hard! You need to use the documentation with the products, or possibly a COM browser. Note however that COM browsers typically rely on these objects registering themselves in certain ways, and many objects to not do this. You are just expected to know.

    +

    The Python COM browser

    +

    PythonCOM comes with a basic COM browser that may show you the information you need. Note that this package requires Pythonwin (ie, the MFC GUI environment) to be installed for this to work.

    +

    There are far better COM browsers available - I tend to use the one that comes with MSVC, or this one!

    +

    To run the browser, simply select it from the Pythonwin Tools menu, or double-click on the file win32com\client\combrowse.py

    +

    Static Dispatch (or Type Safe) objects

    +

    In the above examples, if we printed the 'repr(o)' object above, it would have resulted in

    +

    <COMObject Excel.Application>

    +

    This reflects that the object is a generic COM object that Python has no special knowledge of (other than the name you used to create it!). This is known as a "dynamic dispatch" object, as all knowledge is built dynamically. The win32com package also has the concept of static dispatch objects, which gives Python up-front knowledge about the objects that it is working with (including arguments, argument types, etc)

    +

    In a nutshell, Static Dispatch involves the generation of a .py file that contains support for the specific object. For more overview information, please see the documentation references above.

    +

    The generation and management of the .py files is somewhat automatic, and involves one of 2 steps:

    + +
      +
    • Using makepy.py to select a COM library. This process is very similar to Visual Basic, where you select from a list of all objects installed on your system, and once selected the objects are magically useable.
    + +

    or

    + +
      +
    • Use explicit code to check for, and possibly generate, support at run-time. This is very powerful, as it allows the developer to avoid ensuring the user has selected the appropriate type library. This option is extremely powerful for OCX users, as it allows Python code to sub-class an OCX control, but the actual sub-class can be generated at run-time. Use makepy.py with a -i option to see how to include this support in your Python code.
    + +

    The win32com.client.gencache module manages these generated files. This module has some documentation of its own, but you probably don't need to know the gory details!

    +

    How do I get at the generated module?

    +

    You will notice that the generated file name is long and cryptic - obviously not designed for humans to work with! So how do you get at the module object for the generated code?

    +

    Hopefully, the answer is you shouldn't need to. All generated file support is generally available directly via win32com.client.Dispatch and win32com.client.constants. But should you ever really need the Python module object, the win32com.client.gencache module has functions specifically for this. The functions GetModuleForCLSID and GetModuleForProgID both return Python module objects that you can use in your code. See the docstrings in the gencache code for more details.

    +

    To generate Python Sources supporting a COM object

    +

    Example using Microsoft Office 97.

    +

    Either:

    + +
      +
    • Run 'win32com\client\makepy.py' (eg, run it from the command window, or double-click on it) and a list will be presented. Select the Type Library 'Microsoft Word 8.0 Object Library'
      • +
    • From a command prompt, run the command 'makepy.py "Microsoft Word 8.0 Object Library"' (include the double quotes). This simply avoids the selection process.
      • +
    • If you desire, you can also use explicit code to generate it just before you need to use it at runtime. Run 'makepy.py -i "Microsoft Word 8.0 Object Library"' (include the double quotes) to see how to do this.
    + +

    And that is it! Nothing more needed. No special import statements needed! Now, you simply need say

    +

    >>> import win32com.client

    +

    >>> w=win32com.client.Dispatch("Word.Application")

    +

    >>> w.Visible=1

    +

    >>> w

    +

    <win32com.gen_py.Microsoft Word 8.0 Object Library._Application>

    +

    Note that now Python knows the explicit type of the object.

    +

    Using COM Constants

    +

    Makepy automatically installs all generated constants from a type library in an object called win32com.clients.constants. You do not need to do anything special to make these constants work, other than create the object itself (ie, in the example above, the constants relating to Word would automatically be available after the w=win32com.client.Dispatch("Word.Application") statement.

    +

    For example, immediately after executing the code above, you could execute the following:

    +

    >>> w.WindowState = win32com.client.constants.wdWindowStateMinimize

    +

    and Word will Minimize.

    + diff --git a/lib/win32com/HTML/QuickStartServerCom.html b/lib/win32com/HTML/QuickStartServerCom.html new file mode 100644 index 00000000..b956daaf --- /dev/null +++ b/lib/win32com/HTML/QuickStartServerCom.html @@ -0,0 +1,195 @@ + + + + +Quick Start to Server Side COM and Python + + + + + + +

    Quick Start to Server side COM and Python

    +

    Introduction

    +

    This documents how to quickly start implementing COM objects in Python. It is not a thorough discussion of the COM system, or of the concepts introduced by COM.

    +

    For more details information on Python and COM, please see the COM Tutorial given by Greg Stein and Mark Hammond at SPAM 6 (HTML format) or download the same tutorial in PowerPoint format.

    +

    For information on using external COM objects from Python, please see a Quick Start to Client side COM and Python.

    +

    In this document we discuss the core functionality, registering the server, testing the class, debugging the class, exception handling and server policies (phew!)

    +

    Implement the core functionality

    +

    Implement a stand-alone Python class with your functionality

    +

    class HelloWorld:

    + + +

    def __init__(self):

    + + +

    self.softspace = 1

    +

    self.noCalls = 0

     +     + +

    def Hello(self, who):

    + + +

    self.noCalls = self.noCalls + 1

    +

    # insert "softspace" number of spaces

    +

    return "Hello" + " " * self.softspace + who

     +     +     +     + +

    This is obviously a very simple server. In particular, custom error handling would be needed for a production class server. In addition, there are some contrived properties just for demonstration purposes.

    +

    Make Unicode concessions

    +

    At this stage, Python and Unicode don’t really work well together. All strings which come from COM will actually be Unicode objects rather than string objects.

    +

    To make this code work in a COM environment, the last line of the "Hello" method must become:

    + + + + +

    return "Hello" + " " * self.softspace + str(who)

     +     +     +     + +

    Note the conversion of the "who" to "str(who)". This forces the Unicode object into a native Python string object.

    +

    For details on how to debug COM Servers to find this sort of error, please see debugging the class

    +

    Annotate the class with win32com specific attributes

    +

    This is not a complete list of names, simply a list of properties used by this sample.

    + + + + + + + + + + + + + +
    +

    Property Name

    		 +

    Description

    +

    _public_methods_

    		 +

    List of all method names exposed to remote COM clients

    +

    _public_attrs_

    		 +

    List of all attribute names exposed to remote COM clients

    +

    _readonly_attrs_

    		 +

    List of all attributes which can be accessed, but not set.

    + +

    We change the class header to become:

    +

    class HelloWorld:

    + + +

    _public_methods_ = ['Hello']

    +

    _public_attrs_ = ['softspace', 'noCalls']

    +

    _readonly_attrs_ = ['noCalls']

    +

    def __init__(self):

    +

    [Same from here…]

     +     + +

    Registering and assigning a CLSID for the object

    +

    COM requires that all objects use a unique CLSID and be registered under a "user friendly" name. This documents the process.

    +

    Generating the CLSID

    +

    Microsoft Visual C++ comes with various tools for generating CLSID's, which are quite suitable. Alternatively, the pythoncom module exports the function CreateGuid() to generate these identifiers.

    +

    >>> import pythoncom
    +>>> print pythoncom.CreateGuid()
    +{7CC9F362-486D-11D1-BB48-0000E838A65F}

    +

    Obviously the GUID that you get will be different than that displayed here.

    +

    Preparing for registration of the Class

    +

    The win32com package allows yet more annotations to be applied to a class, allowing registration to be effected with 2 lines in your source file. The registration annotations used by this sample are:

    + + + + + + + + + + + + + + + + + + + +
    +

    Property Name

    		 +

    Description

    +

    _reg_clsid_

    		 +

    The CLSID of the COM object

    +

    _reg_progid_

    		 +

    The "program ID", or Name, of the COM Server. This is the name the user usually uses to instantiate the object

    +

    _reg_desc_

    		 +

    Optional: The description of the COM Server. Used primarily for COM browsers. If not specified, the _reg_progid_ is used as the description.

    +

    _reg_class_spec_

    		 +

    Optional: A string which represents how Python can create the class instance. The string is of format
    +[package.subpackage.]module.class

    +

    The portion up to the class name must be valid for Python to "import", and the class portion must be a valid attribute in the specified class.

    +

    This is optional from build 124 of Pythoncom., and has been removed from this sample.

    +

    _reg_remove_keys_

    		 +

    Optional: A list of tuples of extra registry keys to be removed when uninstalling the server. Each tuple is of format ("key", root), where key is a string, and root is one of the win32con.HKEY_* constants (this item is optional, defaulting to HKEY_CLASSES_ROOT)

    + +

    Note there are quite a few other keys available. Also note that these annotations are not required - they just make registration simple. Helper functions in the module win32com.server.register allow you to explicitly specify each of these attributes without attaching them to the class.

    +

    The header of our class now becomes:

    +

    class HelloWorld:

    + + +

    _reg_clsid_ = "{7CC9F362-486D-11D1-BB48-0000E838A65F}"

    +

    _reg_desc_ = "Python Test COM Server"

    +

    _reg_progid_ = "Python.TestServer"

    +

    _public_methods_ = ['Hello']

    +

    [same from here]

     +     + +

    Registering the Class

    +

    The idiom that most Python COM Servers use is that they register themselves when run as a script (ie, when executed from the command line.) Thus the standard "if __name__=='__main___':" technique works well.

    +

    win32com.server.register contains a number of helper functions. The easiest to use is "UseCommandLine".

    +

    Registration becomes as simple as:

    +

    if __name__=='__main__':
    + # ni only for 1.4!
    + import ni, win32com.server.register
    + win32com.server.register.UseCommandLine(HelloWorld)

    +

    Running the script will register our test server.

    +

    Testing our Class

    +

    For the purposes of this demonstration, we will test the class using Visual Basic. This code should run under any version of Visual Basic, including VBA found in Microsoft Office. Any COM compliant package could be used alternatively. VB has been used just to prove there is no "smoke and mirrors. For information on how to test the server using Python, please see the Quick Start to Client side COM documentation.

    +

    This is not a tutorial in VB. The code is just presented! Run it, and it will work!

    +

    Debugging the COM Server

    +

    When things go wrong in COM Servers, there is often nowhere useful for the Python traceback to go, even if such a traceback is generated.

    +

    Rather than discuss how it works, I will just present the procedure to debug your server:

    +

    To register a debug version of your class, run the script (as above) but pass in a "--debug" parameter. Eg, for the server above, use the command line "testcomserver.py --debug".

    +

    To see the debug output generated (and any print statements you may choose to add!) you can simply select the "Remote Debug Trace Collector" from the Pythonwin Tools menu, or run the script "win32traceutil.py" from Windows Explorer or a Command Prompt.

    +

    Exception Handling

    +

    Servers need to be able to provide exception information to their client. In some cases, it may be a simple return code (such as E_NOTIMPLEMENTED), but often it can contain much richer information, describing the error on detail, and even a help file and topic where more information can be found.

    +

    We use Python class based exceptions to provide this information. The COM framework will examine the exception, and look for certain known attributes. These attributes will be copied across to the COM exception, and passed back to the client.

    +

    The following attributes are supported, and correspond to the equivalent entry in the COM Exception structure:
    +scode, code, description, source, helpfile and helpcontext

    +

    To make working with exceptions easier, there is a helper module "win32com.server.exception.py", which defines a single class. An example of its usage would be:

    +

    raise COMException(desc="Must be a string",scode=winerror.E_INVALIDARG,helpfile="myhelp.hlp",...)

    +

    (Note the COMException class supports (and translates) "desc" as a shortcut for "description", but the framework requires "description")

    +

    Server Policies

    +

    This is information about how it all hangs together. The casual COM author need not know this.

    +

    Whenever a Python Server needs to be created, the C++ framework first instantiates a "policy" object. This "policy" object is the gatekeeper for the COM Server - it is responsible for creating the underlying Python object that is the server (ie, your object), and also for translating the underlying COM requests for the object.

    +

    This policy object handles all of the underlying COM functionality. For example, COM requires all methods and properties to have unique numeric ID's associated with them. The policy object manages the creation of these ID's for the underlying Python methods and attributes. Similarly, when the client whishes to call a method with ID 123, the policy object translates this back to the actual method, and makes the call.

    +

    It should be noted that the operation of the "policy" object could be dictated by the Python object - the policy object has many defaults, but the actual Python class can always dictate its operation.

    +

    Default Policy attributes

    +

    The default policy object has a few special attributes that define who the object is exposed to COM. The example above shows the _public_methods attribute, but this section describes all such attributes in detail.

    +
    _public_methods_
    +

    Required list of strings, containing the names of all methods to be exposed to COM. It is possible this will be enhanced in the future (eg, possibly '*' will be recognised to say all methods, or some other ideas…)

    +
    _public_attrs_
    +

    Optional list of strings containing all attribute names to be exposed, both for reading and writing. The attribute names must be valid instance variables.

    +
    _readonly_attrs_
    +

    Optional list of strings defining the name of attributes exposed read-only.

    +
    _com_interfaces_
    +

    Optional list of IIDs exposed by this object. If this attribute is missing, IID_IDispatch is assumed (ie, if not supplied, the COM object will be created as a normal Automation object.

    +

    and actual instance attributes:

    +

    _dynamic_ : optional method

    +

    _value_ : optional attribute

    +

    _query_interface_ : optional method

    +

    _NewEnum : optional method

    +

    _Evaluate : optional method

    + diff --git a/lib/win32com/HTML/docindex.html b/lib/win32com/HTML/docindex.html new file mode 100644 index 00000000..fff74de8 --- /dev/null +++ b/lib/win32com/HTML/docindex.html @@ -0,0 +1,22 @@ + + + + +win32com Documentation Index + + + + +

    Python and COM - Blowing the others away

    +

    PythonCOM Documentation Index

    +

    The following documentation is available

    +

    A Quick Start to Client Side COM (including makepy)

    +

    A Quick Start to Server Side COM

    +

    Information on generated Python files (ie, what makepy generates)

    +

    An advanced VARIANT object which can give more control over parameter types

    +

    A brief description of the win32com package structure

    +

    Python COM Implementation documentation

    +

    Misc stuff I don’t know where to put anywhere else

    +

    ActiveX Scripting

    +

    ActiveX Scripting Demos

    + diff --git a/lib/win32com/HTML/image/BTN_HomePage.gif b/lib/win32com/HTML/image/BTN_HomePage.gif new file mode 100644 index 0000000000000000000000000000000000000000..5767fa0f96e5de4af525ae1846df1bb633b8f5ab GIT binary patch literal 211 zcmZ?wbhEHb^kNWZSoELa|NsAI&YW>^abZ9Oia%Kx85sUE=zxSlY8{woaO}GC&)}3~ zGwgE1sdstEs|deknL!7$W%f0_p0=az{QKYk1EVXNBTHJ^lbSkO zs-2sZvco3ySoP3a}>-GRn25SI# C6I&7h literal 0 HcmV?d00001 diff --git a/lib/win32com/HTML/image/BTN_ManualTop.gif b/lib/win32com/HTML/image/BTN_ManualTop.gif new file mode 100644 index 0000000000000000000000000000000000000000..4200880a26eedc3e0c545ddef7a099fe71c9a8c6 GIT binary patch literal 215 zcmZ?wbhEHb^kNWZSoELa|NsAI&YW>^abZ9Oia%Kx85sUE=zxSlY8{y8aO}GC&)}3~ zGcWV&o}WLai5J}xjZ1K!HT}URU54`|x%Vq{PgK7DFE+hloAFw&`8^({QBr~Prg(ZR z^{YIv=3BVS#y4wlCebWA}Pa G25SJ-f?Hq! literal 0 HcmV?d00001 diff --git a/lib/win32com/HTML/image/BTN_NextPage.gif b/lib/win32com/HTML/image/BTN_NextPage.gif new file mode 100644 index 0000000000000000000000000000000000000000..3d055fea0ecae9b27417820e2f8bdc1febf84b61 GIT binary patch literal 218 zcmZ?wbhEHbbY~D|SoELa|NsAI&YW>^abZ9Oia%Kx85sUE=zxSlY8{y8bL_hF&*0R{ zroCk>Ys=ryW^apR<6F_0=yZD>(}r^;x%VsNj#Rz>Z!O(l7BsPM@x+&tKV6C0qFCT{ z)ic~T)weS%tbF}V(ZeF5`gbCyABpUaWt#EE`}@5|{yXZr6jqv!>+xv zCo!oxLf$G^abZ9Oia%Kx85sUE=zxSlY8{y8a_qYE&*0R{ zrmafPPaprfK%8fhMcI7Uy4M*+jSL4$a_?8HJHA=>&4C3I!Y^NmTYipvX2`TC-B~#v zYuT1x;_Ve#S~S!7jqBo8#pyAj!MSl$W9}BN&se*;?8%T|n7uj>pDDN4q7Av+kVOxcGR#f^(OQ=cXkmCu;<+iaEJy>FMbP$*1O2 J8Y(bY0|3G!By<1( literal 0 HcmV?d00001 diff --git a/lib/win32com/HTML/image/pycom_blowing.gif b/lib/win32com/HTML/image/pycom_blowing.gif new file mode 100644 index 0000000000000000000000000000000000000000..0d65a2928962860cf8b675b5192a43b165f31350 GIT binary patch literal 20926 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 Ab^rhX literal 0 HcmV?d00001 diff --git a/lib/win32com/HTML/image/pythoncom.gif b/lib/win32com/HTML/image/pythoncom.gif new file mode 100644 index 0000000000000000000000000000000000000000..6b5020a1d7de11d55f66cf6713bde897898e1f8e GIT binary patch literal 5767 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 XtM)#5_xjDpPoKYh{r3GMCxbNr)TwuZ literal 0 HcmV?d00001 diff --git a/lib/win32com/HTML/index.html b/lib/win32com/HTML/index.html new file mode 100644 index 00000000..2ab0176a --- /dev/null +++ b/lib/win32com/HTML/index.html @@ -0,0 +1,31 @@ + + + + +win32com + + + + + +

    +

    +

    Python and COM

    +

    Introduction

    +

    Python has an excellent interface to COM (also known variously as OLE2, ActiveX, etc).

    +

    The Python COM package can be used to interface to almost any COM program (such as the MS-Office suite), write servers that can be hosted by any COM client (such as Visual Basic or C++), and has even been used to provide the core ActiveX Scripting Support.

    + + + +     + + +

    Documentation

    +

    Preliminary Active Scripting and Debugging documentation is available.

    +

    2 Quick-Start guides have been provided, which also contain other links. See the Quick Start for Client side COM and the Quick Start for Server side COM

    +

     +     + + diff --git a/lib/win32com/HTML/misc.html b/lib/win32com/HTML/misc.html new file mode 100644 index 00000000..4374d221 --- /dev/null +++ b/lib/win32com/HTML/misc.html @@ -0,0 +1,18 @@ + + + + +Misc win32com Stuff + + + + + + +

    Misc stuff I don’t know where to put anywhere else

    +

    Client Side Dispatch

    +

    Using win32com.client.Dispatch automatically invokes all the win32com client side "smarts", including automatic usage of generated .py files etc.

    +

    If you wish to avoid that, and use truly "dynamic" objects (ie, there is generated .py support available, but you wish to avoid it), you can use win32com.client.dynamic.Dispatch

    +

    _print_details_() method
    +If win32com.client.dynamic.Dispatch is used, the objects have a _print_details_() method available, which prints all relevant knowledge about an object (for example, all methods and properties). For objects that do not expose runtime type information, _print_details_ may not list anything.

    + diff --git a/lib/win32com/HTML/package.html b/lib/win32com/HTML/package.html new file mode 100644 index 00000000..e98f0875 --- /dev/null +++ b/lib/win32com/HTML/package.html @@ -0,0 +1,37 @@ + + + + +The win32com package + + + + +

    Python and COM - Blowing the others away

    +

    The win32com package

    +

    This document describes the win32com package in general terms.

    +

    The COM support can be thought of as existing in 2 main portions - the C++ support code (the core PythonCOM module), and helper code, implemented in Python. The total package is known as "win32com".

    +

    The win32com support is stand-alone. It does not require Pythonwin.

    +

    The win32com package

    +

    To facilitate an orderly framework, the Python "ni" module has been used, and the entire package is known as "win32com". As is normal for such packages, win32com itself does not provide any functionality. Some of the modules are described below:

    + +
      +
    • win32com.pythoncom - core C++ support.
      +This module is rarely used directly by programmers - instead the other "helper" module are used, which themselves draw on the core pythoncom services.
      • +
    • win32com.client package
      +      Support for COM clients used by Python. Some of the modules in this package allow for dynamic usage of COM clients, a module for generating .py files for certain COM servers, etc.
      • +
    • win32com.server package
      +      Support for COM servers written in Python. The modules in this package provide most of the underlying framework for magically turning Python classes into COM servers, exposing the correct public methods, registering your server in the registry, etc.
      • +
    • win32com.axscript
      +      ActiveX Scripting implementation for Python.
      • +
    • win32com.axdebug
      +      Active Debugging implementation for Python
      • +
    • win32com.mapi
      +      Utilities for working with MAPI and the Microsoft Exchange Server
    + +

     

    +

    The pythoncom module

    +

    The pythoncom module is the underlying C++ support for all COM related objects. In general, Python programmers will not use this module directly, but use win32com helper classes and functions.

    +

    This module exposes a C++ like interface to COM - there are objects implemented in pythoncom that have methods "QueryInterface()", "Invoke()", just like the C++ API. If you are using COM in C++, you would not call a method directly, you would use pObject->Invoke( …, MethodId, argArray…). Similarly, if you are using pythoncom directly, you must also use the Invoke method to call an object's exposed method.

    +

    There are some Python wrappers for hiding this raw interface, meaning you should almost never need to use the pythoncom module directly. These helpers translate a "natural" looking interface (eg, obj.SomeMethod()) into the underlying Invoke call.

     + diff --git a/lib/win32com/HTML/variant.html b/lib/win32com/HTML/variant.html new file mode 100644 index 00000000..2631203e --- /dev/null +++ b/lib/win32com/HTML/variant.html @@ -0,0 +1,162 @@ + + + win32com.client.VARIANT + + + +

    Introduction

    +

    +win32com attempts to provide a seamless COM interface and hide many COM +implementation details, including the use of COM VARIANT structures. This +means that in most cases, you just call a COM object using normal Python +objects as parameters and get back normal Python objects as results. +

    + +

    +However, in some cases this doesn't work very well, particularly when using +"dynamic" (aka late-bound) objects, or when using "makepy" (aka early-bound) +objects which only declare a parameter is a VARIANT. +

    + +

    +The win32com.client.VARIANT object is designed to overcome these +problems. +

    + +

    Drawbacks

    +The primary issue with this approach is that the programmer must learn more +about COM VARIANTs than otherwise - they need to know concepts such as +variants being byref, holding arrays, or that some may hold 32bit +unsigned integers while others hold 64bit signed ints, and they need to +understand this in the context of a single method call. In short, this is +a relatively advanced feature. The good news though is that use of these +objects should never cause your program to hard-crash - the worst you should +expect are Python or COM exceptions being thrown. + +

    The VARIANT object

    + +The VARIANT object lives in win32com.client. The constructor +takes 2 parameters - the 'variant type' and the value. The 'variant type' is +an integer and can be one or more of the pythoncom.VT_* values, +possibly or'd together. + +

    For example, to create a VARIANT object which defines a byref array of +32bit integers, you could use: + +

    +>>> from win32com.client import VARIANT
+>>> import pythoncom
+>>> v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_ARRAY | pythoncom.VT_I4,
+...             [1,2,3,4])
+>>> v
+win32com.client.VARIANT(24579, [1, 2, 3, 4])
+>>>
+
    + +This variable can then be used whereever a COM VARIANT is expected. + +

    Example usage with dynamic objects.

    + +For this example we will use the COM object used for win32com testing, +PyCOMTest.PyCOMTest. This object defines a method which is +defined in IDL as: +
    +HRESULT DoubleInOutString([in,out] BSTR *str);
+
    + +As you can see, it takes a single string parameter which is also used as +an "out" parameter - the single parameter will be updated after the call. +The implementation of the method simply "doubles" the string. + +

    If the object has a type-library, this method works fine with makepy +generated support. For example: + +

    +>>> from win32com.client.gencache import EnsureDispatch
+>>> ob = EnsureDispatch("PyCOMTest.PyCOMTest")
+>>> ob.DoubleInOutString("Hello")
+u'HelloHello'
+>>>
+
    + +However, if makepy support is not available the method does not work as +expected. For the next example we will use DumbDispatch to +simulate the object not having a type-library. + +
    +>>> import win32com.client.dynamic
+>>> ob = win32com.client.dynamic.DumbDispatch("PyCOMTest.PyCOMTest")
+>>> ob.DoubleInOutString("Hello")
+>>>
+
    + +As you can see, no result came back from the function. This is because +win32com has no type information available to use, so doesn't know the +parameter should be passed as a byref parameter. To work +around this, we can use the VARIANT object. + +

    The following example explicitly creates a VARIANT object with a +variant type of a byref string and a value 'Hello'. After making the +call with this VARIANT the value is updated. + +

    +>>> import win32com.client.dynamic
+>>> from win32com.client import VARIANT
+>>> import pythoncom
+>>> ob = win32com.client.dynamic.DumbDispatch("PyCOMTest.PyCOMTest")
+>>> variant = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_BSTR, "Hello")
+>>> variant.value # check the value before the call.
+'Hello'
+>>> ob.DoubleInOutString(variant)
+>>> variant.value
+u'HelloHello'
+>>>
+
    + +

    Usage with generated objects

    + +In most cases, objects with makepy support (ie, 'generated' objects) don't +need to use the VARIANT object - the type information means win32com can guess +the right thing to pass. However, in some cases the VARIANT object can still +be useful. + +Imagine a poorly specified object with IDL like: + +
    +HRESULT DoSomething([in] VARIANT value);
+
    + +But also imagine that the object has a limitation that if the parameter is an +integer, it must be a 32bit unsigned value - any other integer representation +will fail. + +

    If you just pass a regular Python integer to this function, it will +generally be passed as a 32bit signed integer and given the limitation above, +will fail. The VARIANT object allows you to work around the limitation - just +create a variant object VARIANT(pythoncom.VT_UI4, int_value) and +pass that - the function will then be called with the explicit type you +specified and will succeed. + +

    Note that you can not use a VARIANT object to override the types described +in a type library. If a makepy generated class specifies that a VT_UI2 is +expected, attempting to pass a VARIANT object will fail. In this case you +would need to hack around the problem. For example, imagine ob +was a COM object which a method called foo and you wanted to +override the type declaration for foo by passing a VARIANT. +You could do something like: + +

    +>>> import win32com.client.dynamic
+>>> from win32com.client import VARIANT
+>>> import pythoncom
+>>> dumbob = win32com.client.dynamic.DumbDispatch(ob)
+>>> variant = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_BSTR, "Hello")
+>>> dumbob.foo(variant)
+
    + +The code above converts the makepy supported ob into a +'dumb' (ie, non-makepy supported) version of the object, which will then +allow you to use VARIANT objects for the problematic methods. + + + diff --git a/lib/win32com/License.txt b/lib/win32com/License.txt new file mode 100644 index 00000000..6c1884e9 --- /dev/null +++ b/lib/win32com/License.txt @@ -0,0 +1,30 @@ +Unless stated in the specfic source file, this work is +Copyright (c) 1996-2008, Greg Stein and Mark Hammond. +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: + +Redistributions of source code must retain the above copyright notice, +this list of conditions and the following disclaimer. + +Redistributions in binary form must reproduce the above copyright +notice, this list of conditions and the following disclaimer in +the documentation and/or other materials provided with the distribution. + +Neither names of Greg Stein, Mark Hammond nor the name of contributors may be used +to endorse or promote products derived from this software without +specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS +IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A +PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR +CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/lib/win32com/__init__.py b/lib/win32com/__init__.py new file mode 100644 index 00000000..4832d9e1 --- /dev/null +++ b/lib/win32com/__init__.py @@ -0,0 +1,132 @@ +# +# Initialization for the win32com package +# + +import os +import sys + +import pythoncom +import win32api + +# flag if we are in a "frozen" build. +_frozen = getattr(sys, "frozen", 1 == 0) +# pythoncom dumbly defaults this to zero - we believe sys.frozen over it. +if _frozen and not getattr(pythoncom, "frozen", 0): + pythoncom.frozen = sys.frozen + +# Add support for an external "COM Extensions" path. +# Concept is that you can register a seperate path to be used for +# COM extensions, outside of the win32com directory. These modules, however, +# look identical to win32com built-in modules. +# This is the technique that we use for the "standard" COM extensions. +# eg "win32com.mapi" or "win32com.axscript" both work, even though they do not +# live under the main win32com directory. +__gen_path__ = "" +__build_path__ = None +### TODO - Load _all_ \\Extensions subkeys - for now, we only read the default +### Modules will work if loaded into "win32comext" path. + + +def SetupEnvironment(): + HKEY_LOCAL_MACHINE = -2147483646 # Avoid pulling in win32con for just these... + KEY_QUERY_VALUE = 0x1 + # Open the root key once, as this is quite slow on NT. + try: + keyName = "SOFTWARE\\Python\\PythonCore\\%s\\PythonPath\\win32com" % sys.winver + key = win32api.RegOpenKey(HKEY_LOCAL_MACHINE, keyName, 0, KEY_QUERY_VALUE) + except (win32api.error, AttributeError): + key = None + + try: + found = 0 + if key is not None: + try: + __path__.append(win32api.RegQueryValue(key, "Extensions")) + found = 1 + except win32api.error: + # Nothing registered + pass + if not found: + try: + __path__.append( + win32api.GetFullPathName(__path__[0] + "\\..\\win32comext") + ) + except win32api.error: + # Give up in disgust! + pass + + # For the sake of developers, we also look up a "BuildPath" key + # If extension modules add support, we can load their .pyd's from a completely + # different directory (see the comments below) + try: + if key is not None: + global __build_path__ + __build_path__ = win32api.RegQueryValue(key, "BuildPath") + __path__.append(__build_path__) + except win32api.error: + # __build_path__ neednt be defined. + pass + global __gen_path__ + if key is not None: + try: + __gen_path__ = win32api.RegQueryValue(key, "GenPath") + except win32api.error: + pass + finally: + if key is not None: + key.Close() + + +# A Helper for developers. A sub-package's __init__ can call this help function, +# which allows the .pyd files for the extension to live in a special "Build" directory +# (which the win32com developers do!) +def __PackageSupportBuildPath__(package_path): + # See if we have a special directory for the binaries (for developers) + if not _frozen and __build_path__: + package_path.append(__build_path__) + + +if not _frozen: + SetupEnvironment() + +# If we don't have a special __gen_path__, see if we have a gen_py as a +# normal module and use that (ie, "win32com.gen_py" may already exist as +# a package. +if not __gen_path__: + try: + import win32com.gen_py + + # hrmph - 3.3 throws: TypeError: '_NamespacePath' object does not support indexing + # attempting to get __path__[0] - but I can't quickly repro this stand-alone. + # Work around it by using an iterator. + __gen_path__ = next(iter(sys.modules["win32com.gen_py"].__path__)) + except ImportError: + # If a win32com\gen_py directory already exists, then we use it + # (gencache doesn't insist it have an __init__, but our __import__ + # above does! + __gen_path__ = os.path.abspath(os.path.join(__path__[0], "gen_py")) + if not os.path.isdir(__gen_path__): + # We used to dynamically create a directory under win32com - + # but this sucks. If the dir doesn't already exist, we we + # create a version specific directory under the user temp + # directory. + __gen_path__ = os.path.join( + win32api.GetTempPath(), + "gen_py", + "%d.%d" % (sys.version_info[0], sys.version_info[1]), + ) + +# we must have a __gen_path__, but may not have a gen_py module - +# set that up. +if "win32com.gen_py" not in sys.modules: + # Create a "win32com.gen_py", but with a custom __path__ + import types + + gen_py = types.ModuleType("win32com.gen_py") + gen_py.__path__ = [__gen_path__] + sys.modules[gen_py.__name__] = gen_py + del types +gen_py = sys.modules["win32com.gen_py"] + +# get rid of these for module users +del os, sys, win32api, pythoncom diff --git a/lib/win32com/client/CLSIDToClass.py b/lib/win32com/client/CLSIDToClass.py new file mode 100644 index 00000000..fde32743 --- /dev/null +++ b/lib/win32com/client/CLSIDToClass.py @@ -0,0 +1,57 @@ +"""Manages a dictionary of CLSID strings to Python classes. + +Primary use of this module is to allow modules generated by +makepy.py to share classes. @makepy@ automatically generates code +which interacts with this module. You should never need to reference +this module directly. + +This module only provides support for modules which have been previously +been imported. The gencache module provides some support for loading modules +on demand - once done, this module supports it... + +As an example, the MSACCESS.TLB type library makes reference to the +CLSID of the Database object, as defined in DAO3032.DLL. This +allows code using the MSAccess wrapper to natively use Databases. + +This obviously applies to all cooperating objects, not just DAO and +Access. +""" +mapCLSIDToClass = {} + + +def RegisterCLSID(clsid, pythonClass): + """Register a class that wraps a CLSID + + This function allows a CLSID to be globally associated with a class. + Certain module will automatically convert an IDispatch object to an + instance of the associated class. + """ + + mapCLSIDToClass[str(clsid)] = pythonClass + + +def RegisterCLSIDsFromDict(dict): + """Register a dictionary of CLSID's and classes. + + This module performs the same function as @RegisterCLSID@, but for + an entire dictionary of associations. + + Typically called by makepy generated modules at import time. + """ + mapCLSIDToClass.update(dict) + + +def GetClass(clsid): + """Given a CLSID, return the globally associated class. + + clsid -- a string CLSID representation to check. + """ + return mapCLSIDToClass[clsid] + + +def HasClass(clsid): + """Determines if the CLSID has an associated class. + + clsid -- the string CLSID to check + """ + return clsid in mapCLSIDToClass diff --git a/lib/win32com/client/__init__.py b/lib/win32com/client/__init__.py new file mode 100644 index 00000000..91b4b303 --- /dev/null +++ b/lib/win32com/client/__init__.py @@ -0,0 +1,714 @@ +# This module exists to create the "best" dispatch object for a given +# object. If "makepy" support for a given object is detected, it is +# used, otherwise a dynamic dispatch object. + +# Note that if the unknown dispatch object then returns a known +# dispatch object, the known class will be used. This contrasts +# with dynamic.Dispatch behaviour, where dynamic objects are always used. + +import sys + +import pythoncom +import pywintypes + +from . import dynamic, gencache + +_PyIDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch] + + +def __WrapDispatch( + dispatch, + userName=None, + resultCLSID=None, + typeinfo=None, + UnicodeToString=None, + clsctx=pythoncom.CLSCTX_SERVER, + WrapperClass=None, +): + """ + Helper function to return a makepy generated class for a CLSID if it exists, + otherwise cope by using CDispatch. + """ + assert UnicodeToString is None, "this is deprecated and will go away" + if resultCLSID is None: + try: + typeinfo = dispatch.GetTypeInfo() + if ( + typeinfo is not None + ): # Some objects return NULL, some raise exceptions... + resultCLSID = str(typeinfo.GetTypeAttr()[0]) + except (pythoncom.com_error, AttributeError): + pass + if resultCLSID is not None: + from . import gencache + + # Attempt to load generated module support + # This may load the module, and make it available + klass = gencache.GetClassForCLSID(resultCLSID) + if klass is not None: + return klass(dispatch) + + # Return a "dynamic" object - best we can do! + if WrapperClass is None: + WrapperClass = CDispatch + return dynamic.Dispatch(dispatch, userName, WrapperClass, typeinfo, clsctx=clsctx) + + +def GetObject(Pathname=None, Class=None, clsctx=None): + """ + Mimic VB's GetObject() function. + + ob = GetObject(Class = "ProgID") or GetObject(Class = clsid) will + connect to an already running instance of the COM object. + + ob = GetObject(r"c:\blah\blah\foo.xls") (aka the COM moniker syntax) + will return a ready to use Python wrapping of the required COM object. + + Note: You must specifiy one or the other of these arguments. I know + this isn't pretty, but it is what VB does. Blech. If you don't + I'll throw ValueError at you. :) + + This will most likely throw pythoncom.com_error if anything fails. + """ + if clsctx is None: + clsctx = pythoncom.CLSCTX_ALL + + if (Pathname is None and Class is None) or ( + Pathname is not None and Class is not None + ): + raise ValueError( + "You must specify a value for Pathname or Class, but not both." + ) + + if Class is not None: + return GetActiveObject(Class, clsctx) + else: + return Moniker(Pathname, clsctx) + + +def GetActiveObject(Class, clsctx=pythoncom.CLSCTX_ALL): + """ + Python friendly version of GetObject's ProgID/CLSID functionality. + """ + resultCLSID = pywintypes.IID(Class) + dispatch = pythoncom.GetActiveObject(resultCLSID) + dispatch = dispatch.QueryInterface(pythoncom.IID_IDispatch) + return __WrapDispatch(dispatch, Class, resultCLSID=resultCLSID, clsctx=clsctx) + + +def Moniker(Pathname, clsctx=pythoncom.CLSCTX_ALL): + """ + Python friendly version of GetObject's moniker functionality. + """ + moniker, i, bindCtx = pythoncom.MkParseDisplayName(Pathname) + dispatch = moniker.BindToObject(bindCtx, None, pythoncom.IID_IDispatch) + return __WrapDispatch(dispatch, Pathname, clsctx=clsctx) + + +def Dispatch( + dispatch, + userName=None, + resultCLSID=None, + typeinfo=None, + UnicodeToString=None, + clsctx=pythoncom.CLSCTX_SERVER, +): + """Creates a Dispatch based COM object.""" + assert UnicodeToString is None, "this is deprecated and will go away" + dispatch, userName = dynamic._GetGoodDispatchAndUserName(dispatch, userName, clsctx) + return __WrapDispatch(dispatch, userName, resultCLSID, typeinfo, clsctx=clsctx) + + +def DispatchEx( + clsid, + machine=None, + userName=None, + resultCLSID=None, + typeinfo=None, + UnicodeToString=None, + clsctx=None, +): + """Creates a Dispatch based COM object on a specific machine.""" + assert UnicodeToString is None, "this is deprecated and will go away" + # If InProc is registered, DCOM will use it regardless of the machine name + # (and regardless of the DCOM config for the object.) So unless the user + # specifies otherwise, we exclude inproc apps when a remote machine is used. + if clsctx is None: + clsctx = pythoncom.CLSCTX_SERVER + if machine is not None: + clsctx = clsctx & ~pythoncom.CLSCTX_INPROC + if machine is None: + serverInfo = None + else: + serverInfo = (machine,) + if userName is None: + userName = clsid + dispatch = pythoncom.CoCreateInstanceEx( + clsid, None, clsctx, serverInfo, (pythoncom.IID_IDispatch,) + )[0] + return Dispatch(dispatch, userName, resultCLSID, typeinfo, clsctx=clsctx) + + +class CDispatch(dynamic.CDispatch): + """ + The dynamic class used as a last resort. + The purpose of this overriding of dynamic.CDispatch is to perpetuate the policy + of using the makepy generated wrapper Python class instead of dynamic.CDispatch + if/when possible. + """ + + def _wrap_dispatch_( + self, ob, userName=None, returnCLSID=None, UnicodeToString=None + ): + assert UnicodeToString is None, "this is deprecated and will go away" + return Dispatch(ob, userName, returnCLSID, None) + + def __dir__(self): + return dynamic.CDispatch.__dir__(self) + + +def CastTo(ob, target, typelib=None): + """'Cast' a COM object to another interface""" + # todo - should support target being an IID + mod = None + if ( + typelib is not None + ): # caller specified target typelib (TypelibSpec). See e.g. selecttlb.EnumTlbs(). + mod = gencache.MakeModuleForTypelib( + typelib.clsid, typelib.lcid, int(typelib.major, 16), int(typelib.minor, 16) + ) + if not hasattr(mod, target): + raise ValueError( + "The interface name '%s' does not appear in the " + "specified library %r" % (target, typelib.ver_desc) + ) + + elif hasattr(target, "index"): # string like + # for now, we assume makepy for this to work. + if "CLSID" not in ob.__class__.__dict__: + # Eeek - no makepy support - try and build it. + ob = gencache.EnsureDispatch(ob) + if "CLSID" not in ob.__class__.__dict__: + raise ValueError("Must be a makepy-able object for this to work") + clsid = ob.CLSID + # Lots of hoops to support "demand-build" - ie, generating + # code for an interface first time it is used. We assume the + # interface name exists in the same library as the object. + # This is generally the case - only referenced typelibs may be + # a problem, and we can handle that later. Maybe + # So get the generated module for the library itself, then + # find the interface CLSID there. + mod = gencache.GetModuleForCLSID(clsid) + # Get the 'root' module. + mod = gencache.GetModuleForTypelib( + mod.CLSID, mod.LCID, mod.MajorVersion, mod.MinorVersion + ) + # Find the CLSID of the target + target_clsid = mod.NamesToIIDMap.get(target) + if target_clsid is None: + raise ValueError( + "The interface name '%s' does not appear in the " + "same library as object '%r'" % (target, ob) + ) + mod = gencache.GetModuleForCLSID(target_clsid) + if mod is not None: + target_class = getattr(mod, target) + # resolve coclass to interface + target_class = getattr(target_class, "default_interface", target_class) + return target_class(ob) # auto QI magic happens + raise ValueError + + +class Constants: + """A container for generated COM constants.""" + + def __init__(self): + self.__dicts__ = [] # A list of dictionaries + + def __getattr__(self, a): + for d in self.__dicts__: + if a in d: + return d[a] + raise AttributeError(a) + + +# And create an instance. +constants = Constants() + + +# A helpers for DispatchWithEvents - this becomes __setattr__ for the +# temporary class. +def _event_setattr_(self, attr, val): + try: + # Does the COM object have an attribute of this name? + self.__class__.__bases__[0].__setattr__(self, attr, val) + except AttributeError: + # Otherwise just stash it away in the instance. + self.__dict__[attr] = val + + +# An instance of this "proxy" is created to break the COM circular references +# that exist (ie, when we connect to the COM events, COM keeps a reference +# to the object. Thus, the Event connection must be manually broken before +# our object can die. This solves the problem by manually breaking the connection +# to the real object as the proxy dies. +class EventsProxy: + def __init__(self, ob): + self.__dict__["_obj_"] = ob + + def __del__(self): + try: + # If there is a COM error on disconnection we should + # just ignore it - object probably already shut down... + self._obj_.close() + except pythoncom.com_error: + pass + + def __getattr__(self, attr): + return getattr(self._obj_, attr) + + def __setattr__(self, attr, val): + setattr(self._obj_, attr, val) + + +def DispatchWithEvents(clsid, user_event_class): + """Create a COM object that can fire events to a user defined class. + clsid -- The ProgID or CLSID of the object to create. + user_event_class -- A Python class object that responds to the events. + + This requires makepy support for the COM object being created. If + this support does not exist it will be automatically generated by + this function. If the object does not support makepy, a TypeError + exception will be raised. + + The result is a class instance that both represents the COM object + and handles events from the COM object. + + It is important to note that the returned instance is not a direct + instance of the user_event_class, but an instance of a temporary + class object that derives from three classes: + * The makepy generated class for the COM object + * The makepy generated class for the COM events + * The user_event_class as passed to this function. + + If this is not suitable, see the getevents function for an alternative + technique of handling events. + + Object Lifetimes: Whenever the object returned from this function is + cleaned-up by Python, the events will be disconnected from + the COM object. This is almost always what should happen, + but see the documentation for getevents() for more details. + + Example: + + >>> class IEEvents: + ... def OnVisible(self, visible): + ... print "Visible changed:", visible + ... + >>> ie = DispatchWithEvents("InternetExplorer.Application", IEEvents) + >>> ie.Visible = 1 + Visible changed: 1 + >>> + """ + # Create/Get the object. + disp = Dispatch(clsid) + if not disp.__class__.__dict__.get( + "CLSID" + ): # Eeek - no makepy support - try and build it. + try: + ti = disp._oleobj_.GetTypeInfo() + disp_clsid = ti.GetTypeAttr()[0] + tlb, index = ti.GetContainingTypeLib() + tla = tlb.GetLibAttr() + gencache.EnsureModule(tla[0], tla[1], tla[3], tla[4], bValidateFile=0) + # Get the class from the module. + disp_class = gencache.GetClassForProgID(str(disp_clsid)) + except pythoncom.com_error: + raise TypeError( + "This COM object can not automate the makepy process - please run makepy manually for this object" + ) + else: + disp_class = disp.__class__ + # If the clsid was an object, get the clsid + clsid = disp_class.CLSID + # Create a new class that derives from 3 classes - the dispatch class, the event sink class and the user class. + # XXX - we are still "classic style" classes in py2x, so we need can't yet + # use 'type()' everywhere - revisit soon, as py2x will move to new-style too... + try: + from types import ClassType as new_type + except ImportError: + new_type = type # py3k + events_class = getevents(clsid) + if events_class is None: + raise ValueError("This COM object does not support events.") + result_class = new_type( + "COMEventClass", + (disp_class, events_class, user_event_class), + {"__setattr__": _event_setattr_}, + ) + instance = result_class( + disp._oleobj_ + ) # This only calls the first base class __init__. + events_class.__init__(instance, instance) + if hasattr(user_event_class, "__init__"): + user_event_class.__init__(instance) + return EventsProxy(instance) + + +def WithEvents(disp, user_event_class): + """Similar to DispatchWithEvents - except that the returned + object is *not* also usable as the original Dispatch object - that is + the returned object is not dispatchable. + + The difference is best summarised by example. + + >>> class IEEvents: + ... def OnVisible(self, visible): + ... print "Visible changed:", visible + ... + >>> ie = Dispatch("InternetExplorer.Application") + >>> ie_events = WithEvents(ie, IEEvents) + >>> ie.Visible = 1 + Visible changed: 1 + + Compare with the code sample for DispatchWithEvents, where you get a + single object that is both the interface and the event handler. Note that + the event handler instance will *not* be able to use 'self.' to refer to + IE's methods and properties. + + This is mainly useful where using DispatchWithEvents causes + circular reference problems that the simple proxy doesn't deal with + """ + disp = Dispatch(disp) + if not disp.__class__.__dict__.get( + "CLSID" + ): # Eeek - no makepy support - try and build it. + try: + ti = disp._oleobj_.GetTypeInfo() + disp_clsid = ti.GetTypeAttr()[0] + tlb, index = ti.GetContainingTypeLib() + tla = tlb.GetLibAttr() + gencache.EnsureModule(tla[0], tla[1], tla[3], tla[4], bValidateFile=0) + # Get the class from the module. + disp_class = gencache.GetClassForProgID(str(disp_clsid)) + except pythoncom.com_error: + raise TypeError( + "This COM object can not automate the makepy process - please run makepy manually for this object" + ) + else: + disp_class = disp.__class__ + # Get the clsid + clsid = disp_class.CLSID + # Create a new class that derives from 2 classes - the event sink + # class and the user class. + try: + from types import ClassType as new_type + except ImportError: + new_type = type # py3k + events_class = getevents(clsid) + if events_class is None: + raise ValueError("This COM object does not support events.") + result_class = new_type("COMEventClass", (events_class, user_event_class), {}) + instance = result_class(disp) # This only calls the first base class __init__. + if hasattr(user_event_class, "__init__"): + user_event_class.__init__(instance) + return instance + + +def getevents(clsid): + """Determine the default outgoing interface for a class, given + either a clsid or progid. It returns a class - you can + conveniently derive your own handler from this class and implement + the appropriate methods. + + This method relies on the classes produced by makepy. You must use + either makepy or the gencache module to ensure that the + appropriate support classes have been generated for the com server + that you will be handling events from. + + Beware of COM circular references. When the Events class is connected + to the COM object, the COM object itself keeps a reference to the Python + events class. Thus, neither the Events instance or the COM object will + ever die by themselves. The 'close' method on the events instance + must be called to break this chain and allow standard Python collection + rules to manage object lifetimes. Note that DispatchWithEvents() does + work around this problem by the use of a proxy object, but if you use + the getevents() function yourself, you must make your own arrangements + to manage this circular reference issue. + + Beware of creating Python circular references: this will happen if your + handler has a reference to an object that has a reference back to + the event source. Call the 'close' method to break the chain. + + Example: + + >>>win32com.client.gencache.EnsureModule('{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}',0,1,1) + >> + >>> class InternetExplorerEvents(win32com.client.getevents("InternetExplorer.Application.1")): + ... def OnVisible(self, Visible): + ... print "Visibility changed: ", Visible + ... + >>> + >>> ie=win32com.client.Dispatch("InternetExplorer.Application.1") + >>> events=InternetExplorerEvents(ie) + >>> ie.Visible=1 + Visibility changed: 1 + >>> + """ + + # find clsid given progid or clsid + clsid = str(pywintypes.IID(clsid)) + # return default outgoing interface for that class + klass = gencache.GetClassForCLSID(clsid) + try: + return klass.default_source + except AttributeError: + # See if we have a coclass for the interfaces. + try: + return gencache.GetClassForCLSID(klass.coclass_clsid).default_source + except AttributeError: + return None + + +# A Record object, as used by the COM struct support +def Record(name, object): + """Creates a new record object, given the name of the record, + and an object from the same type library. + + Example usage would be: + app = win32com.client.Dispatch("Some.Application") + point = win32com.client.Record("SomeAppPoint", app) + point.x = 0 + point.y = 0 + app.MoveTo(point) + """ + # XXX - to do - probably should allow "object" to already be a module object. + from . import gencache + + object = gencache.EnsureDispatch(object) + module = sys.modules[object.__class__.__module__] + # to allow us to work correctly with "demand generated" code, + # we must use the typelib CLSID to obtain the module + # (otherwise we get the sub-module for the object, which + # does not hold the records) + # thus, package may be module, or may be module's parent if demand generated. + package = gencache.GetModuleForTypelib( + module.CLSID, module.LCID, module.MajorVersion, module.MinorVersion + ) + try: + struct_guid = package.RecordMap[name] + except KeyError: + raise ValueError( + "The structure '%s' is not defined in module '%s'" % (name, package) + ) + return pythoncom.GetRecordFromGuids( + module.CLSID, module.MajorVersion, module.MinorVersion, module.LCID, struct_guid + ) + + +############################################ +# The base of all makepy generated classes +############################################ +class DispatchBaseClass: + def __init__(self, oobj=None): + if oobj is None: + oobj = pythoncom.new(self.CLSID) + elif isinstance(oobj, DispatchBaseClass): + try: + oobj = oobj._oleobj_.QueryInterface( + self.CLSID, pythoncom.IID_IDispatch + ) # Must be a valid COM instance + except pythoncom.com_error as details: + import winerror + + # Some stupid objects fail here, even tho it is _already_ IDispatch!!?? + # Eg, Lotus notes. + # So just let it use the existing object if E_NOINTERFACE + if details.hresult != winerror.E_NOINTERFACE: + raise + oobj = oobj._oleobj_ + self.__dict__["_oleobj_"] = oobj # so we dont call __setattr__ + + def __dir__(self): + lst = ( + list(self.__dict__.keys()) + + dir(self.__class__) + + list(self._prop_map_get_.keys()) + + list(self._prop_map_put_.keys()) + ) + try: + lst += [p.Name for p in self.Properties_] + except AttributeError: + pass + return list(set(lst)) + + # Provide a prettier name than the CLSID + def __repr__(self): + # Need to get the docstring for the module for this class. + try: + mod_doc = sys.modules[self.__class__.__module__].__doc__ + if mod_doc: + mod_name = "win32com.gen_py." + mod_doc + else: + mod_name = sys.modules[self.__class__.__module__].__name__ + except KeyError: + mod_name = "win32com.gen_py.unknown" + return "<%s.%s instance at 0x%s>" % ( + mod_name, + self.__class__.__name__, + id(self), + ) + + # Delegate comparison to the oleobjs, as they know how to do identity. + def __eq__(self, other): + other = getattr(other, "_oleobj_", other) + return self._oleobj_ == other + + def __ne__(self, other): + other = getattr(other, "_oleobj_", other) + return self._oleobj_ != other + + def _ApplyTypes_(self, dispid, wFlags, retType, argTypes, user, resultCLSID, *args): + return self._get_good_object_( + self._oleobj_.InvokeTypes(dispid, 0, wFlags, retType, argTypes, *args), + user, + resultCLSID, + ) + + def __getattr__(self, attr): + args = self._prop_map_get_.get(attr) + if args is None: + raise AttributeError( + "'%s' object has no attribute '%s'" % (repr(self), attr) + ) + return self._ApplyTypes_(*args) + + def __setattr__(self, attr, value): + if attr in self.__dict__: + self.__dict__[attr] = value + return + try: + args, defArgs = self._prop_map_put_[attr] + except KeyError: + raise AttributeError( + "'%s' object has no attribute '%s'" % (repr(self), attr) + ) + self._oleobj_.Invoke(*(args + (value,) + defArgs)) + + def _get_good_single_object_(self, obj, obUserName=None, resultCLSID=None): + return _get_good_single_object_(obj, obUserName, resultCLSID) + + def _get_good_object_(self, obj, obUserName=None, resultCLSID=None): + return _get_good_object_(obj, obUserName, resultCLSID) + + +# XXX - These should be consolidated with dynamic.py versions. +def _get_good_single_object_(obj, obUserName=None, resultCLSID=None): + if _PyIDispatchType == type(obj): + return Dispatch(obj, obUserName, resultCLSID) + return obj + + +def _get_good_object_(obj, obUserName=None, resultCLSID=None): + if obj is None: + return None + elif isinstance(obj, tuple): + obUserNameTuple = (obUserName,) * len(obj) + resultCLSIDTuple = (resultCLSID,) * len(obj) + return tuple(map(_get_good_object_, obj, obUserNameTuple, resultCLSIDTuple)) + else: + return _get_good_single_object_(obj, obUserName, resultCLSID) + + +class CoClassBaseClass: + def __init__(self, oobj=None): + if oobj is None: + oobj = pythoncom.new(self.CLSID) + dispobj = self.__dict__["_dispobj_"] = self.default_interface(oobj) + # See comments below re the special methods. + for maybe in [ + "__call__", + "__str__", + "__int__", + "__iter__", + "__len__", + "__nonzero__", + ]: + if hasattr(dispobj, maybe): + setattr(self, maybe, getattr(self, "__maybe" + maybe)) + + def __repr__(self): + return "" % (__doc__, self.__class__.__name__) + + def __getattr__(self, attr): + d = self.__dict__["_dispobj_"] + if d is not None: + return getattr(d, attr) + raise AttributeError(attr) + + def __setattr__(self, attr, value): + if attr in self.__dict__: + self.__dict__[attr] = value + return + try: + d = self.__dict__["_dispobj_"] + if d is not None: + d.__setattr__(attr, value) + return + except AttributeError: + pass + self.__dict__[attr] = value + + # Special methods don't use __getattr__ etc, so explicitly delegate here. + # Note however, that not all are safe to let bubble up - things like + # `bool(ob)` will break if the object defines __int__ but then raises an + # attribute error - eg, see #1753. + # It depends on what the wrapped COM object actually defines whether these + # will exist on the underlying object, so __init__ explicitly checks if they + # do and if so, wires them up. + + def __maybe__call__(self, *args, **kwargs): + return self.__dict__["_dispobj_"].__call__(*args, **kwargs) + + def __maybe__str__(self, *args): + return self.__dict__["_dispobj_"].__str__(*args) + + def __maybe__int__(self, *args): + return self.__dict__["_dispobj_"].__int__(*args) + + def __maybe__iter__(self): + return self.__dict__["_dispobj_"].__iter__() + + def __maybe__len__(self): + return self.__dict__["_dispobj_"].__len__() + + def __maybe__nonzero__(self): + return self.__dict__["_dispobj_"].__nonzero__() + + +# A very simple VARIANT class. Only to be used with poorly-implemented COM +# objects. If an object accepts an arg which is a simple "VARIANT", but still +# is very pickly about the actual variant type (eg, isn't happy with a VT_I4, +# which it would get from a Python integer), you can use this to force a +# particular VT. +class VARIANT(object): + def __init__(self, vt, value): + self.varianttype = vt + self._value = value + + # 'value' is a property so when set by pythoncom it gets any magic wrapping + # which normally happens for result objects + def _get_value(self): + return self._value + + def _set_value(self, newval): + self._value = _get_good_object_(newval) + + def _del_value(self): + del self._value + + value = property(_get_value, _set_value, _del_value) + + def __repr__(self): + return "win32com.client.VARIANT(%r, %r)" % (self.varianttype, self._value) diff --git a/lib/win32com/client/build.py b/lib/win32com/client/build.py new file mode 100644 index 00000000..ce4e2e4a --- /dev/null +++ b/lib/win32com/client/build.py @@ -0,0 +1,789 @@ +"""Contains knowledge to build a COM object definition. + +This module is used by both the @dynamic@ and @makepy@ modules to build +all knowledge of a COM object. + +This module contains classes which contain the actual knowledge of the object. +This include parameter and return type information, the COM dispid and CLSID, etc. + +Other modules may use this information to generate .py files, use the information +dynamically, or possibly even generate .html documentation for objects. +""" + +# +# NOTES: DispatchItem and MapEntry used by dynamic.py. +# the rest is used by makepy.py +# +# OleItem, DispatchItem, MapEntry, BuildCallList() is used by makepy + +import datetime +import string +import sys +from keyword import iskeyword + +import pythoncom +import winerror +from pywintypes import TimeType + + +# It isn't really clear what the quoting rules are in a C/IDL string and +# literals like a quote char and backslashes makes life a little painful to +# always render the string perfectly - so just punt and fall-back to a repr() +def _makeDocString(s): + if sys.version_info < (3,): + s = s.encode("mbcs") + return repr(s) + + +error = "PythonCOM.Client.Build error" + + +class NotSupportedException(Exception): + pass # Raised when we cant support a param type. + + +DropIndirection = "DropIndirection" + +NoTranslateTypes = [ + pythoncom.VT_BOOL, + pythoncom.VT_CLSID, + pythoncom.VT_CY, + pythoncom.VT_DATE, + pythoncom.VT_DECIMAL, + pythoncom.VT_EMPTY, + pythoncom.VT_ERROR, + pythoncom.VT_FILETIME, + pythoncom.VT_HRESULT, + pythoncom.VT_I1, + pythoncom.VT_I2, + pythoncom.VT_I4, + pythoncom.VT_I8, + pythoncom.VT_INT, + pythoncom.VT_NULL, + pythoncom.VT_R4, + pythoncom.VT_R8, + pythoncom.VT_NULL, + pythoncom.VT_STREAM, + pythoncom.VT_UI1, + pythoncom.VT_UI2, + pythoncom.VT_UI4, + pythoncom.VT_UI8, + pythoncom.VT_UINT, + pythoncom.VT_VOID, +] + +NoTranslateMap = {} +for v in NoTranslateTypes: + NoTranslateMap[v] = None + + +class MapEntry: + "Simple holder for named attibutes - items in a map." + + def __init__( + self, + desc_or_id, + names=None, + doc=None, + resultCLSID=pythoncom.IID_NULL, + resultDoc=None, + hidden=0, + ): + if type(desc_or_id) == type(0): + self.dispid = desc_or_id + self.desc = None + else: + self.dispid = desc_or_id[0] + self.desc = desc_or_id + + self.names = names + self.doc = doc + self.resultCLSID = resultCLSID + self.resultDocumentation = resultDoc + self.wasProperty = ( + 0 # Have I been transformed into a function so I can pass args? + ) + self.hidden = hidden + + def __repr__(self): + return ( + "MapEntry(dispid={s.dispid}, desc={s.desc}, names={s.names}, doc={s.doc!r}, " + "resultCLSID={s.resultCLSID}, resultDocumentation={s.resultDocumentation}, " + "wasProperty={s.wasProperty}, hidden={s.hidden}" + ).format(s=self) + + def GetResultCLSID(self): + rc = self.resultCLSID + if rc == pythoncom.IID_NULL: + return None + return rc + + # Return a string, suitable for output - either "'{...}'" or "None" + def GetResultCLSIDStr(self): + rc = self.GetResultCLSID() + if rc is None: + return "None" + return repr( + str(rc) + ) # Convert the IID object to a string, then to a string in a string. + + def GetResultName(self): + if self.resultDocumentation is None: + return None + return self.resultDocumentation[0] + + +class OleItem: + typename = "OleItem" + + def __init__(self, doc=None): + self.doc = doc + if self.doc: + self.python_name = MakePublicAttributeName(self.doc[0]) + else: + self.python_name = None + self.bWritten = 0 + self.bIsDispatch = 0 + self.bIsSink = 0 + self.clsid = None + self.co_class = None + + +class DispatchItem(OleItem): + typename = "DispatchItem" + + def __init__(self, typeinfo=None, attr=None, doc=None, bForUser=1): + OleItem.__init__(self, doc) + self.propMap = {} + self.propMapGet = {} + self.propMapPut = {} + self.mapFuncs = {} + self.defaultDispatchName = None + self.hidden = 0 + + if typeinfo: + self.Build(typeinfo, attr, bForUser) + + def _propMapPutCheck_(self, key, item): + ins, outs, opts = self.CountInOutOptArgs(item.desc[2]) + if ins > 1: # if a Put property takes more than 1 arg: + if opts + 1 == ins or ins == item.desc[6] + 1: + newKey = "Set" + key + deleteExisting = 0 # This one is still OK + else: + deleteExisting = 1 # No good to us + if key in self.mapFuncs or key in self.propMapGet: + newKey = "Set" + key + else: + newKey = key + item.wasProperty = 1 + self.mapFuncs[newKey] = item + if deleteExisting: + del self.propMapPut[key] + + def _propMapGetCheck_(self, key, item): + ins, outs, opts = self.CountInOutOptArgs(item.desc[2]) + if ins > 0: # if a Get property takes _any_ in args: + if item.desc[6] == ins or ins == opts: + newKey = "Get" + key + deleteExisting = 0 # This one is still OK + else: + deleteExisting = 1 # No good to us + if key in self.mapFuncs: + newKey = "Get" + key + else: + newKey = key + item.wasProperty = 1 + self.mapFuncs[newKey] = item + if deleteExisting: + del self.propMapGet[key] + + def _AddFunc_(self, typeinfo, fdesc, bForUser): + assert fdesc.desckind == pythoncom.DESCKIND_FUNCDESC + id = fdesc.memid + funcflags = fdesc.wFuncFlags + try: + names = typeinfo.GetNames(id) + name = names[0] + except pythoncom.ole_error: + name = "" + names = None + + doc = None + try: + if bForUser: + doc = typeinfo.GetDocumentation(id) + except pythoncom.ole_error: + pass + + if id == 0 and name: + self.defaultDispatchName = name + + invkind = fdesc.invkind + + # We need to translate any Alias', Enums, structs etc in result and args + typerepr, flag, defval = fdesc.rettype + # sys.stderr.write("%s result - %s -> " % (name, typerepr)) + typerepr, resultCLSID, resultDoc = _ResolveType(typerepr, typeinfo) + # sys.stderr.write("%s\n" % (typerepr,)) + fdesc.rettype = typerepr, flag, defval, resultCLSID + # Translate any Alias or Enums in argument list. + argList = [] + for argDesc in fdesc.args: + typerepr, flag, defval = argDesc + # sys.stderr.write("%s arg - %s -> " % (name, typerepr)) + arg_type, arg_clsid, arg_doc = _ResolveType(typerepr, typeinfo) + argDesc = arg_type, flag, defval, arg_clsid + # sys.stderr.write("%s\n" % (argDesc[0],)) + argList.append(argDesc) + fdesc.args = tuple(argList) + + hidden = (funcflags & pythoncom.FUNCFLAG_FHIDDEN) != 0 + if invkind == pythoncom.INVOKE_PROPERTYGET: + map = self.propMapGet + # This is not the best solution, but I dont think there is + # one without specific "set" syntax. + # If there is a single PUT or PUTREF, it will function as a property. + # If there are both, then the PUT remains a property, and the PUTREF + # gets transformed into a function. + # (in vb, PUT=="obj=other_obj", PUTREF="set obj=other_obj + elif invkind in (pythoncom.INVOKE_PROPERTYPUT, pythoncom.INVOKE_PROPERTYPUTREF): + # Special case + existing = self.propMapPut.get(name, None) + if existing is not None: + if existing.desc[4] == pythoncom.INVOKE_PROPERTYPUT: # Keep this one + map = self.mapFuncs + name = "Set" + name + else: # Existing becomes a func. + existing.wasProperty = 1 + self.mapFuncs["Set" + name] = existing + map = self.propMapPut # existing gets overwritten below. + else: + map = self.propMapPut # first time weve seen it. + + elif invkind == pythoncom.INVOKE_FUNC: + map = self.mapFuncs + else: + map = None + if not map is None: + # if map.has_key(name): + # sys.stderr.write("Warning - overwriting existing method/attribute %s\n" % name) + map[name] = MapEntry(fdesc, names, doc, resultCLSID, resultDoc, hidden) + # any methods that can't be reached via DISPATCH we return None + # for, so dynamic dispatch doesnt see it. + if fdesc.funckind != pythoncom.FUNC_DISPATCH: + return None + return (name, map) + return None + + def _AddVar_(self, typeinfo, vardesc, bForUser): + ### need pythoncom.VARFLAG_FRESTRICTED ... + ### then check it + assert vardesc.desckind == pythoncom.DESCKIND_VARDESC + + if vardesc.varkind == pythoncom.VAR_DISPATCH: + id = vardesc.memid + names = typeinfo.GetNames(id) + # Translate any Alias or Enums in result. + typerepr, flags, defval = vardesc.elemdescVar + typerepr, resultCLSID, resultDoc = _ResolveType(typerepr, typeinfo) + vardesc.elemdescVar = typerepr, flags, defval + doc = None + try: + if bForUser: + doc = typeinfo.GetDocumentation(id) + except pythoncom.ole_error: + pass + + # handle the enumerator specially + map = self.propMap + # Check if the element is hidden. + hidden = (vardesc.wVarFlags & 0x40) != 0 # VARFLAG_FHIDDEN + map[names[0]] = MapEntry( + vardesc, names, doc, resultCLSID, resultDoc, hidden + ) + return (names[0], map) + else: + return None + + def Build(self, typeinfo, attr, bForUser=1): + self.clsid = attr[0] + self.bIsDispatch = (attr.wTypeFlags & pythoncom.TYPEFLAG_FDISPATCHABLE) != 0 + if typeinfo is None: + return + # Loop over all methods + for j in range(attr[6]): + fdesc = typeinfo.GetFuncDesc(j) + self._AddFunc_(typeinfo, fdesc, bForUser) + + # Loop over all variables (ie, properties) + for j in range(attr[7]): + fdesc = typeinfo.GetVarDesc(j) + self._AddVar_(typeinfo, fdesc, bForUser) + + # Now post-process the maps. For any "Get" or "Set" properties + # that have arguments, we must turn them into methods. If a method + # of the same name already exists, change the name. + for key, item in list(self.propMapGet.items()): + self._propMapGetCheck_(key, item) + + for key, item in list(self.propMapPut.items()): + self._propMapPutCheck_(key, item) + + def CountInOutOptArgs(self, argTuple): + "Return tuple counting in/outs/OPTS. Sum of result may not be len(argTuple), as some args may be in/out." + ins = out = opts = 0 + for argCheck in argTuple: + inOut = argCheck[1] + if inOut == 0: + ins = ins + 1 + out = out + 1 + else: + if inOut & pythoncom.PARAMFLAG_FIN: + ins = ins + 1 + if inOut & pythoncom.PARAMFLAG_FOPT: + opts = opts + 1 + if inOut & pythoncom.PARAMFLAG_FOUT: + out = out + 1 + return ins, out, opts + + def MakeFuncMethod(self, entry, name, bMakeClass=1): + # If we have a type description, and not varargs... + if entry.desc is not None and (len(entry.desc) < 6 or entry.desc[6] != -1): + return self.MakeDispatchFuncMethod(entry, name, bMakeClass) + else: + return self.MakeVarArgsFuncMethod(entry, name, bMakeClass) + + def MakeDispatchFuncMethod(self, entry, name, bMakeClass=1): + fdesc = entry.desc + doc = entry.doc + names = entry.names + ret = [] + if bMakeClass: + linePrefix = "\t" + defNamedOptArg = "defaultNamedOptArg" + defNamedNotOptArg = "defaultNamedNotOptArg" + defUnnamedArg = "defaultUnnamedArg" + else: + linePrefix = "" + defNamedOptArg = "pythoncom.Missing" + defNamedNotOptArg = "pythoncom.Missing" + defUnnamedArg = "pythoncom.Missing" + defOutArg = "pythoncom.Missing" + id = fdesc[0] + + s = ( + linePrefix + + "def " + + name + + "(self" + + BuildCallList( + fdesc, + names, + defNamedOptArg, + defNamedNotOptArg, + defUnnamedArg, + defOutArg, + ) + + "):" + ) + ret.append(s) + if doc and doc[1]: + ret.append(linePrefix + "\t" + _makeDocString(doc[1])) + + resclsid = entry.GetResultCLSID() + if resclsid: + resclsid = "'%s'" % resclsid + else: + resclsid = "None" + # Strip the default values from the arg desc + retDesc = fdesc[8][:2] + argsDesc = tuple([what[:2] for what in fdesc[2]]) + # The runtime translation of the return types is expensive, so when we know the + # return type of the function, there is no need to check the type at runtime. + # To qualify, this function must return a "simple" type, and have no byref args. + # Check if we have byrefs or anything in the args which mean we still need a translate. + param_flags = [what[1] for what in fdesc[2]] + bad_params = [ + flag + for flag in param_flags + if flag & (pythoncom.PARAMFLAG_FOUT | pythoncom.PARAMFLAG_FRETVAL) != 0 + ] + s = None + if len(bad_params) == 0 and len(retDesc) == 2 and retDesc[1] == 0: + rd = retDesc[0] + if rd in NoTranslateMap: + s = "%s\treturn self._oleobj_.InvokeTypes(%d, LCID, %s, %s, %s%s)" % ( + linePrefix, + id, + fdesc[4], + retDesc, + argsDesc, + _BuildArgList(fdesc, names), + ) + elif rd in [pythoncom.VT_DISPATCH, pythoncom.VT_UNKNOWN]: + s = "%s\tret = self._oleobj_.InvokeTypes(%d, LCID, %s, %s, %s%s)\n" % ( + linePrefix, + id, + fdesc[4], + retDesc, + repr(argsDesc), + _BuildArgList(fdesc, names), + ) + s = s + "%s\tif ret is not None:\n" % (linePrefix,) + if rd == pythoncom.VT_UNKNOWN: + s = s + "%s\t\t# See if this IUnknown is really an IDispatch\n" % ( + linePrefix, + ) + s = s + "%s\t\ttry:\n" % (linePrefix,) + s = ( + s + + "%s\t\t\tret = ret.QueryInterface(pythoncom.IID_IDispatch)\n" + % (linePrefix,) + ) + s = s + "%s\t\texcept pythoncom.error:\n" % (linePrefix,) + s = s + "%s\t\t\treturn ret\n" % (linePrefix,) + s = s + "%s\t\tret = Dispatch(ret, %s, %s)\n" % ( + linePrefix, + repr(name), + resclsid, + ) + s = s + "%s\treturn ret" % (linePrefix) + elif rd == pythoncom.VT_BSTR: + s = "%s\t# Result is a Unicode object\n" % (linePrefix,) + s = ( + s + + "%s\treturn self._oleobj_.InvokeTypes(%d, LCID, %s, %s, %s%s)" + % ( + linePrefix, + id, + fdesc[4], + retDesc, + repr(argsDesc), + _BuildArgList(fdesc, names), + ) + ) + # else s remains None + if s is None: + s = "%s\treturn self._ApplyTypes_(%d, %s, %s, %s, %s, %s%s)" % ( + linePrefix, + id, + fdesc[4], + retDesc, + argsDesc, + repr(name), + resclsid, + _BuildArgList(fdesc, names), + ) + + ret.append(s) + ret.append("") + return ret + + def MakeVarArgsFuncMethod(self, entry, name, bMakeClass=1): + fdesc = entry.desc + names = entry.names + doc = entry.doc + ret = [] + argPrefix = "self" + if bMakeClass: + linePrefix = "\t" + else: + linePrefix = "" + ret.append(linePrefix + "def " + name + "(" + argPrefix + ", *args):") + if doc and doc[1]: + ret.append(linePrefix + "\t" + _makeDocString(doc[1])) + if fdesc: + invoketype = fdesc[4] + else: + invoketype = pythoncom.DISPATCH_METHOD + s = linePrefix + "\treturn self._get_good_object_(self._oleobj_.Invoke(*((" + ret.append( + s + str(entry.dispid) + ",0,%d,1)+args)),'%s')" % (invoketype, names[0]) + ) + ret.append("") + return ret + + +# Note - "DispatchItem" poorly named - need a new intermediate class. +class VTableItem(DispatchItem): + def Build(self, typeinfo, attr, bForUser=1): + DispatchItem.Build(self, typeinfo, attr, bForUser) + assert typeinfo is not None, "Cant build vtables without type info!" + + meth_list = ( + list(self.mapFuncs.values()) + + list(self.propMapGet.values()) + + list(self.propMapPut.values()) + ) + meth_list.sort(key=lambda m: m.desc[7]) + + # Now turn this list into the run-time representation + # (ready for immediate use or writing to gencache) + self.vtableFuncs = [] + for entry in meth_list: + self.vtableFuncs.append((entry.names, entry.dispid, entry.desc)) + + +# A Lazy dispatch item - builds an item on request using info from +# an ITypeComp. The dynamic module makes the called to build each item, +# and also holds the references to the typeinfo and typecomp. +class LazyDispatchItem(DispatchItem): + typename = "LazyDispatchItem" + + def __init__(self, attr, doc): + self.clsid = attr[0] + DispatchItem.__init__(self, None, attr, doc, 0) + + +typeSubstMap = { + pythoncom.VT_INT: pythoncom.VT_I4, + pythoncom.VT_UINT: pythoncom.VT_UI4, + pythoncom.VT_HRESULT: pythoncom.VT_I4, +} + + +def _ResolveType(typerepr, itypeinfo): + # Resolve VT_USERDEFINED (often aliases or typed IDispatches) + + if type(typerepr) == tuple: + indir_vt, subrepr = typerepr + if indir_vt == pythoncom.VT_PTR: + # If it is a VT_PTR to a VT_USERDEFINED that is an IDispatch/IUnknown, + # then it resolves to simply the object. + # Otherwise, it becomes a ByRef of the resolved type + # We need to drop an indirection level on pointer to user defined interfaces. + # eg, (VT_PTR, (VT_USERDEFINED, somehandle)) needs to become VT_DISPATCH + # only when "somehandle" is an object. + # but (VT_PTR, (VT_USERDEFINED, otherhandle)) doesnt get the indirection dropped. + was_user = type(subrepr) == tuple and subrepr[0] == pythoncom.VT_USERDEFINED + subrepr, sub_clsid, sub_doc = _ResolveType(subrepr, itypeinfo) + if was_user and subrepr in [ + pythoncom.VT_DISPATCH, + pythoncom.VT_UNKNOWN, + pythoncom.VT_RECORD, + ]: + # Drop the VT_PTR indirection + return subrepr, sub_clsid, sub_doc + # Change PTR indirection to byref + return subrepr | pythoncom.VT_BYREF, sub_clsid, sub_doc + if indir_vt == pythoncom.VT_SAFEARRAY: + # resolve the array element, and convert to VT_ARRAY + subrepr, sub_clsid, sub_doc = _ResolveType(subrepr, itypeinfo) + return pythoncom.VT_ARRAY | subrepr, sub_clsid, sub_doc + if indir_vt == pythoncom.VT_CARRAY: # runtime has no support for this yet. + # resolve the array element, and convert to VT_CARRAY + # sheesh - return _something_ + return pythoncom.VT_CARRAY, None, None + if indir_vt == pythoncom.VT_USERDEFINED: + try: + resultTypeInfo = itypeinfo.GetRefTypeInfo(subrepr) + except pythoncom.com_error as details: + if details.hresult in [ + winerror.TYPE_E_CANTLOADLIBRARY, + winerror.TYPE_E_LIBNOTREGISTERED, + ]: + # an unregistered interface + return pythoncom.VT_UNKNOWN, None, None + raise + + resultAttr = resultTypeInfo.GetTypeAttr() + typeKind = resultAttr.typekind + if typeKind == pythoncom.TKIND_ALIAS: + tdesc = resultAttr.tdescAlias + return _ResolveType(tdesc, resultTypeInfo) + elif typeKind in [pythoncom.TKIND_ENUM, pythoncom.TKIND_MODULE]: + # For now, assume Long + return pythoncom.VT_I4, None, None + + elif typeKind == pythoncom.TKIND_DISPATCH: + clsid = resultTypeInfo.GetTypeAttr()[0] + retdoc = resultTypeInfo.GetDocumentation(-1) + return pythoncom.VT_DISPATCH, clsid, retdoc + + elif typeKind in [pythoncom.TKIND_INTERFACE, pythoncom.TKIND_COCLASS]: + # XXX - should probably get default interface for CO_CLASS??? + clsid = resultTypeInfo.GetTypeAttr()[0] + retdoc = resultTypeInfo.GetDocumentation(-1) + return pythoncom.VT_UNKNOWN, clsid, retdoc + + elif typeKind == pythoncom.TKIND_RECORD: + return pythoncom.VT_RECORD, None, None + raise NotSupportedException("Can not resolve alias or user-defined type") + return typeSubstMap.get(typerepr, typerepr), None, None + + +def _BuildArgList(fdesc, names): + "Builds list of args to the underlying Invoke method." + # Word has TypeInfo for Insert() method, but says "no args" + numArgs = max(fdesc[6], len(fdesc[2])) + names = list(names) + while None in names: + i = names.index(None) + names[i] = "arg%d" % (i,) + # We've seen 'source safe' libraries offer the name of 'ret' params in + # 'names' - although we can't reproduce this, it would be insane to offer + # more args than we have arg infos for - hence the upper limit on names... + names = list(map(MakePublicAttributeName, names[1 : (numArgs + 1)])) + name_num = 0 + while len(names) < numArgs: + names.append("arg%d" % (len(names),)) + # As per BuildCallList(), avoid huge lines. + # Hack a "\n" at the end of every 5th name - "strides" would be handy + # here but don't exist in 2.2 + for i in range(0, len(names), 5): + names[i] = names[i] + "\n\t\t\t" + return "," + ", ".join(names) + + +valid_identifier_chars = string.ascii_letters + string.digits + "_" + + +def demunge_leading_underscores(className): + i = 0 + while className[i] == "_": + i += 1 + assert i >= 2, "Should only be here with names starting with '__'" + return className[i - 1 :] + className[: i - 1] + + +# Given a "public name" (eg, the name of a class, function, etc) +# make sure it is a legal (and reasonable!) Python name. +def MakePublicAttributeName(className, is_global=False): + # Given a class attribute that needs to be public, convert it to a + # reasonable name. + # Also need to be careful that the munging doesnt + # create duplicates - eg, just removing a leading "_" is likely to cause + # a clash. + # if is_global is True, then the name is a global variable that may + # overwrite a builtin - eg, "None" + if className[:2] == "__": + return demunge_leading_underscores(className) + elif className == "None": + # assign to None is evil (and SyntaxError in 2.4, even though + # iskeyword says False there) - note that if it was a global + # it would get picked up below + className = "NONE" + elif iskeyword(className): + # most keywords are lower case (except True, False etc in py3k) + ret = className.capitalize() + # but those which aren't get forced upper. + if ret == className: + ret = ret.upper() + return ret + elif is_global and hasattr(__builtins__, className): + # builtins may be mixed case. If capitalizing it doesn't change it, + # force to all uppercase (eg, "None", "True" become "NONE", "TRUE" + ret = className.capitalize() + if ret == className: # didn't change - force all uppercase. + ret = ret.upper() + return ret + # Strip non printable chars + return "".join([char for char in className if char in valid_identifier_chars]) + + +# Given a default value passed by a type library, return a string with +# an appropriate repr() for the type. +# Takes a raw ELEMDESC and returns a repr string, or None +# (NOTE: The string itself may be '"None"', which is valid, and different to None. +# XXX - To do: Dates are probably screwed, but can they come in? +def MakeDefaultArgRepr(defArgVal): + try: + inOut = defArgVal[1] + except IndexError: + # something strange - assume is in param. + inOut = pythoncom.PARAMFLAG_FIN + + if inOut & pythoncom.PARAMFLAG_FHASDEFAULT: + # times need special handling... + val = defArgVal[2] + if isinstance(val, datetime.datetime): + # VARIANT <-> SYSTEMTIME conversions always lose any sub-second + # resolution, so just use a 'timetuple' here. + return repr(tuple(val.utctimetuple())) + if type(val) is TimeType: + # must be the 'old' pywintypes time object... + year = val.year + month = val.month + day = val.day + hour = val.hour + minute = val.minute + second = val.second + msec = val.msec + return ( + "pywintypes.Time((%(year)d, %(month)d, %(day)d, %(hour)d, %(minute)d, %(second)d,0,0,0,%(msec)d))" + % locals() + ) + return repr(val) + return None + + +def BuildCallList( + fdesc, + names, + defNamedOptArg, + defNamedNotOptArg, + defUnnamedArg, + defOutArg, + is_comment=False, +): + "Builds a Python declaration for a method." + # Names[0] is the func name - param names are from 1. + numArgs = len(fdesc[2]) + numOptArgs = fdesc[6] + strval = "" + if numOptArgs == -1: # Special value that says "var args after here" + firstOptArg = numArgs + numArgs = numArgs - 1 + else: + firstOptArg = numArgs - numOptArgs + for arg in range(numArgs): + try: + argName = names[arg + 1] + namedArg = argName is not None + except IndexError: + namedArg = 0 + if not namedArg: + argName = "arg%d" % (arg) + thisdesc = fdesc[2][arg] + # See if the IDL specified a default value + defArgVal = MakeDefaultArgRepr(thisdesc) + if defArgVal is None: + # Out params always get their special default + if ( + thisdesc[1] & (pythoncom.PARAMFLAG_FOUT | pythoncom.PARAMFLAG_FIN) + == pythoncom.PARAMFLAG_FOUT + ): + defArgVal = defOutArg + else: + # Unnamed arg - always allow default values. + if namedArg: + # Is a named argument + if arg >= firstOptArg: + defArgVal = defNamedOptArg + else: + defArgVal = defNamedNotOptArg + else: + defArgVal = defUnnamedArg + + argName = MakePublicAttributeName(argName) + # insanely long lines with an 'encoding' flag crashes python 2.4.0 + # keep 5 args per line + # This may still fail if the arg names are insane, but that seems + # unlikely. See also _BuildArgList() + if (arg + 1) % 5 == 0: + strval = strval + "\n" + if is_comment: + strval = strval + "#" + strval = strval + "\t\t\t" + strval = strval + ", " + argName + if defArgVal: + strval = strval + "=" + defArgVal + if numOptArgs == -1: + strval = strval + ", *" + names[-1] + + return strval + + +if __name__ == "__main__": + print("Use 'makepy.py' to generate Python code - this module is just a helper") diff --git a/lib/win32com/client/combrowse.py b/lib/win32com/client/combrowse.py new file mode 100644 index 00000000..10eeaedf --- /dev/null +++ b/lib/win32com/client/combrowse.py @@ -0,0 +1,619 @@ +"""A utility for browsing COM objects. + + Usage: + + Command Prompt + + Use the command *"python.exe combrowse.py"*. This will display + display a fairly small, modal dialog. + + Pythonwin + + Use the "Run Script" menu item, and this will create the browser in an + MDI window. This window can be fully resized. + + Details + + This module allows browsing of registered Type Libraries, COM categories, + and running COM objects. The display is similar to the Pythonwin object + browser, and displays the objects in a hierarchical window. + + Note that this module requires the win32ui (ie, Pythonwin) distribution to + work. + +""" +import sys + +import pythoncom +import win32api +import win32con +import win32ui +from pywin.tools import browser +from win32com.client import util + + +class HLIRoot(browser.HLIPythonObject): + def __init__(self, title): + super().__init__(name=title) + + def GetSubList(self): + return [ + HLIHeadingCategory(), + HLI_IEnumMoniker( + pythoncom.GetRunningObjectTable().EnumRunning(), "Running Objects" + ), + HLIHeadingRegisterdTypeLibs(), + ] + + def __cmp__(self, other): + return cmp(self.name, other.name) + + +class HLICOM(browser.HLIPythonObject): + def GetText(self): + return self.name + + def CalculateIsExpandable(self): + return 1 + + +class HLICLSID(HLICOM): + def __init__(self, myobject, name=None): + if type(myobject) == type(""): + myobject = pythoncom.MakeIID(myobject) + if name is None: + try: + name = pythoncom.ProgIDFromCLSID(myobject) + except pythoncom.com_error: + name = str(myobject) + name = "IID: " + name + HLICOM.__init__(self, myobject, name) + + def CalculateIsExpandable(self): + return 0 + + def GetSubList(self): + return [] + + +class HLI_Interface(HLICOM): + pass + + +class HLI_Enum(HLI_Interface): + def GetBitmapColumn(self): + return 0 # Always a folder. + + def CalculateIsExpandable(self): + if self.myobject is not None: + rc = len(self.myobject.Next(1)) > 0 + self.myobject.Reset() + else: + rc = 0 + return rc + + pass + + +class HLI_IEnumMoniker(HLI_Enum): + def GetSubList(self): + ctx = pythoncom.CreateBindCtx() + ret = [] + for mon in util.Enumerator(self.myobject): + ret.append(HLI_IMoniker(mon, mon.GetDisplayName(ctx, None))) + return ret + + +class HLI_IMoniker(HLI_Interface): + def GetSubList(self): + ret = [] + ret.append(browser.MakeHLI(self.myobject.Hash(), "Hash Value")) + subenum = self.myobject.Enum(1) + ret.append(HLI_IEnumMoniker(subenum, "Sub Monikers")) + return ret + + +class HLIHeadingCategory(HLICOM): + "A tree heading for registered categories" + + def GetText(self): + return "Registered Categories" + + def GetSubList(self): + catinf = pythoncom.CoCreateInstance( + pythoncom.CLSID_StdComponentCategoriesMgr, + None, + pythoncom.CLSCTX_INPROC, + pythoncom.IID_ICatInformation, + ) + enum = util.Enumerator(catinf.EnumCategories()) + ret = [] + try: + for catid, lcid, desc in enum: + ret.append(HLICategory((catid, lcid, desc))) + except pythoncom.com_error: + # Registered categories occasionally seem to give spurious errors. + pass # Use what we already have. + return ret + + +class HLICategory(HLICOM): + "An actual Registered Category" + + def GetText(self): + desc = self.myobject[2] + if not desc: + desc = "(unnamed category)" + return desc + + def GetSubList(self): + win32ui.DoWaitCursor(1) + catid, lcid, desc = self.myobject + catinf = pythoncom.CoCreateInstance( + pythoncom.CLSID_StdComponentCategoriesMgr, + None, + pythoncom.CLSCTX_INPROC, + pythoncom.IID_ICatInformation, + ) + ret = [] + for clsid in util.Enumerator(catinf.EnumClassesOfCategories((catid,), ())): + ret.append(HLICLSID(clsid)) + win32ui.DoWaitCursor(0) + + return ret + + +class HLIHelpFile(HLICOM): + def CalculateIsExpandable(self): + return 0 + + def GetText(self): + import os + + fname, ctx = self.myobject + base = os.path.split(fname)[1] + return "Help reference in %s" % (base) + + def TakeDefaultAction(self): + fname, ctx = self.myobject + if ctx: + cmd = win32con.HELP_CONTEXT + else: + cmd = win32con.HELP_FINDER + win32api.WinHelp(win32ui.GetMainFrame().GetSafeHwnd(), fname, cmd, ctx) + + def GetBitmapColumn(self): + return 6 + + +class HLIRegisteredTypeLibrary(HLICOM): + def GetSubList(self): + import os + + clsidstr, versionStr = self.myobject + collected = [] + helpPath = "" + key = win32api.RegOpenKey( + win32con.HKEY_CLASSES_ROOT, "TypeLib\\%s\\%s" % (clsidstr, versionStr) + ) + win32ui.DoWaitCursor(1) + try: + num = 0 + while 1: + try: + subKey = win32api.RegEnumKey(key, num) + except win32api.error: + break + hSubKey = win32api.RegOpenKey(key, subKey) + try: + value, typ = win32api.RegQueryValueEx(hSubKey, None) + if typ == win32con.REG_EXPAND_SZ: + value = win32api.ExpandEnvironmentStrings(value) + except win32api.error: + value = "" + if subKey == "HELPDIR": + helpPath = value + elif subKey == "Flags": + flags = value + else: + try: + lcid = int(subKey) + lcidkey = win32api.RegOpenKey(key, subKey) + # Enumerate the platforms + lcidnum = 0 + while 1: + try: + platform = win32api.RegEnumKey(lcidkey, lcidnum) + except win32api.error: + break + try: + hplatform = win32api.RegOpenKey(lcidkey, platform) + fname, typ = win32api.RegQueryValueEx(hplatform, None) + if typ == win32con.REG_EXPAND_SZ: + fname = win32api.ExpandEnvironmentStrings(fname) + except win32api.error: + fname = "" + collected.append((lcid, platform, fname)) + lcidnum = lcidnum + 1 + win32api.RegCloseKey(lcidkey) + except ValueError: + pass + num = num + 1 + finally: + win32ui.DoWaitCursor(0) + win32api.RegCloseKey(key) + # Now, loop over my collected objects, adding a TypeLib and a HelpFile + ret = [] + # if helpPath: ret.append(browser.MakeHLI(helpPath, "Help Path")) + ret.append(HLICLSID(clsidstr)) + for lcid, platform, fname in collected: + extraDescs = [] + if platform != "win32": + extraDescs.append(platform) + if lcid: + extraDescs.append("locale=%s" % lcid) + extraDesc = "" + if extraDescs: + extraDesc = " (%s)" % ", ".join(extraDescs) + ret.append(HLITypeLib(fname, "Type Library" + extraDesc)) + ret.sort() + return ret + + +class HLITypeLibEntry(HLICOM): + def GetText(self): + tlb, index = self.myobject + name, doc, ctx, helpFile = tlb.GetDocumentation(index) + try: + typedesc = HLITypeKinds[tlb.GetTypeInfoType(index)][1] + except KeyError: + typedesc = "Unknown!" + return name + " - " + typedesc + + def GetSubList(self): + tlb, index = self.myobject + name, doc, ctx, helpFile = tlb.GetDocumentation(index) + ret = [] + if doc: + ret.append(browser.HLIDocString(doc, "Doc")) + if helpFile: + ret.append(HLIHelpFile((helpFile, ctx))) + return ret + + +class HLICoClass(HLITypeLibEntry): + def GetSubList(self): + ret = HLITypeLibEntry.GetSubList(self) + tlb, index = self.myobject + typeinfo = tlb.GetTypeInfo(index) + attr = typeinfo.GetTypeAttr() + for j in range(attr[8]): + flags = typeinfo.GetImplTypeFlags(j) + refType = typeinfo.GetRefTypeInfo(typeinfo.GetRefTypeOfImplType(j)) + refAttr = refType.GetTypeAttr() + ret.append( + browser.MakeHLI(refAttr[0], "Name=%s, Flags = %d" % (refAttr[0], flags)) + ) + return ret + + +class HLITypeLibMethod(HLITypeLibEntry): + def __init__(self, ob, name=None): + self.entry_type = "Method" + HLITypeLibEntry.__init__(self, ob, name) + + def GetSubList(self): + ret = HLITypeLibEntry.GetSubList(self) + tlb, index = self.myobject + typeinfo = tlb.GetTypeInfo(index) + attr = typeinfo.GetTypeAttr() + for i in range(attr[7]): + ret.append(HLITypeLibProperty((typeinfo, i))) + for i in range(attr[6]): + ret.append(HLITypeLibFunction((typeinfo, i))) + return ret + + +class HLITypeLibEnum(HLITypeLibEntry): + def __init__(self, myitem): + typelib, index = myitem + typeinfo = typelib.GetTypeInfo(index) + self.id = typeinfo.GetVarDesc(index)[0] + name = typeinfo.GetNames(self.id)[0] + HLITypeLibEntry.__init__(self, myitem, name) + + def GetText(self): + return self.name + " - Enum/Module" + + def GetSubList(self): + ret = [] + typelib, index = self.myobject + typeinfo = typelib.GetTypeInfo(index) + attr = typeinfo.GetTypeAttr() + for j in range(attr[7]): + vdesc = typeinfo.GetVarDesc(j) + name = typeinfo.GetNames(vdesc[0])[0] + ret.append(browser.MakeHLI(vdesc[1], name)) + return ret + + +class HLITypeLibProperty(HLICOM): + def __init__(self, myitem): + typeinfo, index = myitem + self.id = typeinfo.GetVarDesc(index)[0] + name = typeinfo.GetNames(self.id)[0] + HLICOM.__init__(self, myitem, name) + + def GetText(self): + return self.name + " - Property" + + def GetSubList(self): + ret = [] + typeinfo, index = self.myobject + names = typeinfo.GetNames(self.id) + if len(names) > 1: + ret.append(browser.MakeHLI(names[1:], "Named Params")) + vd = typeinfo.GetVarDesc(index) + ret.append(browser.MakeHLI(self.id, "Dispatch ID")) + ret.append(browser.MakeHLI(vd[1], "Value")) + ret.append(browser.MakeHLI(vd[2], "Elem Desc")) + ret.append(browser.MakeHLI(vd[3], "Var Flags")) + ret.append(browser.MakeHLI(vd[4], "Var Kind")) + return ret + + +class HLITypeLibFunction(HLICOM): + funckinds = { + pythoncom.FUNC_VIRTUAL: "Virtual", + pythoncom.FUNC_PUREVIRTUAL: "Pure Virtual", + pythoncom.FUNC_STATIC: "Static", + pythoncom.FUNC_DISPATCH: "Dispatch", + } + invokekinds = { + pythoncom.INVOKE_FUNC: "Function", + pythoncom.INVOKE_PROPERTYGET: "Property Get", + pythoncom.INVOKE_PROPERTYPUT: "Property Put", + pythoncom.INVOKE_PROPERTYPUTREF: "Property Put by reference", + } + funcflags = [ + (pythoncom.FUNCFLAG_FRESTRICTED, "Restricted"), + (pythoncom.FUNCFLAG_FSOURCE, "Source"), + (pythoncom.FUNCFLAG_FBINDABLE, "Bindable"), + (pythoncom.FUNCFLAG_FREQUESTEDIT, "Request Edit"), + (pythoncom.FUNCFLAG_FDISPLAYBIND, "Display Bind"), + (pythoncom.FUNCFLAG_FDEFAULTBIND, "Default Bind"), + (pythoncom.FUNCFLAG_FHIDDEN, "Hidden"), + (pythoncom.FUNCFLAG_FUSESGETLASTERROR, "Uses GetLastError"), + ] + + vartypes = { + pythoncom.VT_EMPTY: "Empty", + pythoncom.VT_NULL: "NULL", + pythoncom.VT_I2: "Integer 2", + pythoncom.VT_I4: "Integer 4", + pythoncom.VT_R4: "Real 4", + pythoncom.VT_R8: "Real 8", + pythoncom.VT_CY: "CY", + pythoncom.VT_DATE: "Date", + pythoncom.VT_BSTR: "String", + pythoncom.VT_DISPATCH: "IDispatch", + pythoncom.VT_ERROR: "Error", + pythoncom.VT_BOOL: "BOOL", + pythoncom.VT_VARIANT: "Variant", + pythoncom.VT_UNKNOWN: "IUnknown", + pythoncom.VT_DECIMAL: "Decimal", + pythoncom.VT_I1: "Integer 1", + pythoncom.VT_UI1: "Unsigned integer 1", + pythoncom.VT_UI2: "Unsigned integer 2", + pythoncom.VT_UI4: "Unsigned integer 4", + pythoncom.VT_I8: "Integer 8", + pythoncom.VT_UI8: "Unsigned integer 8", + pythoncom.VT_INT: "Integer", + pythoncom.VT_UINT: "Unsigned integer", + pythoncom.VT_VOID: "Void", + pythoncom.VT_HRESULT: "HRESULT", + pythoncom.VT_PTR: "Pointer", + pythoncom.VT_SAFEARRAY: "SafeArray", + pythoncom.VT_CARRAY: "C Array", + pythoncom.VT_USERDEFINED: "User Defined", + pythoncom.VT_LPSTR: "Pointer to string", + pythoncom.VT_LPWSTR: "Pointer to Wide String", + pythoncom.VT_FILETIME: "File time", + pythoncom.VT_BLOB: "Blob", + pythoncom.VT_STREAM: "IStream", + pythoncom.VT_STORAGE: "IStorage", + pythoncom.VT_STORED_OBJECT: "Stored object", + pythoncom.VT_STREAMED_OBJECT: "Streamed object", + pythoncom.VT_BLOB_OBJECT: "Blob object", + pythoncom.VT_CF: "CF", + pythoncom.VT_CLSID: "CLSID", + } + + type_flags = [ + (pythoncom.VT_VECTOR, "Vector"), + (pythoncom.VT_ARRAY, "Array"), + (pythoncom.VT_BYREF, "ByRef"), + (pythoncom.VT_RESERVED, "Reserved"), + ] + + def __init__(self, myitem): + typeinfo, index = myitem + self.id = typeinfo.GetFuncDesc(index)[0] + name = typeinfo.GetNames(self.id)[0] + HLICOM.__init__(self, myitem, name) + + def GetText(self): + return self.name + " - Function" + + def MakeReturnTypeName(self, typ): + justtyp = typ & pythoncom.VT_TYPEMASK + try: + typname = self.vartypes[justtyp] + except KeyError: + typname = "?Bad type?" + for flag, desc in self.type_flags: + if flag & typ: + typname = "%s(%s)" % (desc, typname) + return typname + + def MakeReturnType(self, returnTypeDesc): + if type(returnTypeDesc) == type(()): + first = returnTypeDesc[0] + result = self.MakeReturnType(first) + if first != pythoncom.VT_USERDEFINED: + result = result + " " + self.MakeReturnType(returnTypeDesc[1]) + return result + else: + return self.MakeReturnTypeName(returnTypeDesc) + + def GetSubList(self): + ret = [] + typeinfo, index = self.myobject + names = typeinfo.GetNames(self.id) + ret.append(browser.MakeHLI(self.id, "Dispatch ID")) + if len(names) > 1: + ret.append(browser.MakeHLI(", ".join(names[1:]), "Named Params")) + fd = typeinfo.GetFuncDesc(index) + if fd[1]: + ret.append(browser.MakeHLI(fd[1], "Possible result values")) + if fd[8]: + typ, flags, default = fd[8] + val = self.MakeReturnType(typ) + if flags: + val = "%s (Flags=%d, default=%s)" % (val, flags, default) + ret.append(browser.MakeHLI(val, "Return Type")) + + for argDesc in fd[2]: + typ, flags, default = argDesc + val = self.MakeReturnType(typ) + if flags: + val = "%s (Flags=%d)" % (val, flags) + if default is not None: + val = "%s (Default=%s)" % (val, default) + ret.append(browser.MakeHLI(val, "Argument")) + + try: + fkind = self.funckinds[fd[3]] + except KeyError: + fkind = "Unknown" + ret.append(browser.MakeHLI(fkind, "Function Kind")) + try: + ikind = self.invokekinds[fd[4]] + except KeyError: + ikind = "Unknown" + ret.append(browser.MakeHLI(ikind, "Invoke Kind")) + # 5 = call conv + # 5 = offset vtbl + ret.append(browser.MakeHLI(fd[6], "Number Optional Params")) + flagDescs = [] + for flag, desc in self.funcflags: + if flag & fd[9]: + flagDescs.append(desc) + if flagDescs: + ret.append(browser.MakeHLI(", ".join(flagDescs), "Function Flags")) + return ret + + +HLITypeKinds = { + pythoncom.TKIND_ENUM: (HLITypeLibEnum, "Enumeration"), + pythoncom.TKIND_RECORD: (HLITypeLibEntry, "Record"), + pythoncom.TKIND_MODULE: (HLITypeLibEnum, "Module"), + pythoncom.TKIND_INTERFACE: (HLITypeLibMethod, "Interface"), + pythoncom.TKIND_DISPATCH: (HLITypeLibMethod, "Dispatch"), + pythoncom.TKIND_COCLASS: (HLICoClass, "CoClass"), + pythoncom.TKIND_ALIAS: (HLITypeLibEntry, "Alias"), + pythoncom.TKIND_UNION: (HLITypeLibEntry, "Union"), +} + + +class HLITypeLib(HLICOM): + def GetSubList(self): + ret = [] + ret.append(browser.MakeHLI(self.myobject, "Filename")) + try: + tlb = pythoncom.LoadTypeLib(self.myobject) + except pythoncom.com_error: + return [browser.MakeHLI("%s can not be loaded" % self.myobject)] + + for i in range(tlb.GetTypeInfoCount()): + try: + ret.append(HLITypeKinds[tlb.GetTypeInfoType(i)][0]((tlb, i))) + except pythoncom.com_error: + ret.append(browser.MakeHLI("The type info can not be loaded!")) + ret.sort() + return ret + + +class HLIHeadingRegisterdTypeLibs(HLICOM): + "A tree heading for registered type libraries" + + def GetText(self): + return "Registered Type Libraries" + + def GetSubList(self): + # Explicit lookup in the registry. + ret = [] + key = win32api.RegOpenKey(win32con.HKEY_CLASSES_ROOT, "TypeLib") + win32ui.DoWaitCursor(1) + try: + num = 0 + while 1: + try: + keyName = win32api.RegEnumKey(key, num) + except win32api.error: + break + # Enumerate all version info + subKey = win32api.RegOpenKey(key, keyName) + name = None + try: + subNum = 0 + bestVersion = 0.0 + while 1: + try: + versionStr = win32api.RegEnumKey(subKey, subNum) + except win32api.error: + break + try: + versionFlt = float(versionStr) + except ValueError: + versionFlt = 0 # ???? + if versionFlt > bestVersion: + bestVersion = versionFlt + name = win32api.RegQueryValue(subKey, versionStr) + subNum = subNum + 1 + finally: + win32api.RegCloseKey(subKey) + if name is not None: + ret.append(HLIRegisteredTypeLibrary((keyName, versionStr), name)) + num = num + 1 + finally: + win32api.RegCloseKey(key) + win32ui.DoWaitCursor(0) + ret.sort() + return ret + + +def main(modal=True, mdi=False): + from pywin.tools import hierlist + + root = HLIRoot("COM Browser") + if mdi and "pywin.framework.app" in sys.modules: + # do it in a MDI window + browser.MakeTemplate() + browser.template.OpenObject(root) + else: + dlg = browser.dynamic_browser(root) + if modal: + dlg.DoModal() + else: + dlg.CreateWindow() + dlg.ShowWindow() + + +if __name__ == "__main__": + main(modal=win32api.GetConsoleTitle()) + + ni = pythoncom._GetInterfaceCount() + ng = pythoncom._GetGatewayCount() + if ni or ng: + print("Warning - exiting with %d/%d objects alive" % (ni, ng)) diff --git a/lib/win32com/client/connect.py b/lib/win32com/client/connect.py new file mode 100644 index 00000000..24788204 --- /dev/null +++ b/lib/win32com/client/connect.py @@ -0,0 +1,48 @@ +"""Utilities for working with Connections""" +import pythoncom +import win32com.server.util + + +class SimpleConnection: + "A simple, single connection object" + + def __init__(self, coInstance=None, eventInstance=None, eventCLSID=None, debug=0): + self.cp = None + self.cookie = None + self.debug = debug + if not coInstance is None: + self.Connect(coInstance, eventInstance, eventCLSID) + + def __del__(self): + try: + self.Disconnect() + except pythoncom.error: + # Ignore disconnection as we are torn down. + pass + + def _wrap(self, obj): + useDispatcher = None + if self.debug: + from win32com.server import dispatcher + + useDispatcher = dispatcher.DefaultDebugDispatcher + return win32com.server.util.wrap(obj, useDispatcher=useDispatcher) + + def Connect(self, coInstance, eventInstance, eventCLSID=None): + try: + oleobj = coInstance._oleobj_ + except AttributeError: + oleobj = coInstance + cpc = oleobj.QueryInterface(pythoncom.IID_IConnectionPointContainer) + if eventCLSID is None: + eventCLSID = eventInstance.CLSID + comEventInstance = self._wrap(eventInstance) + self.cp = cpc.FindConnectionPoint(eventCLSID) + self.cookie = self.cp.Advise(comEventInstance) + + def Disconnect(self): + if not self.cp is None: + if self.cookie: + self.cp.Unadvise(self.cookie) + self.cookie = None + self.cp = None diff --git a/lib/win32com/client/dynamic.py b/lib/win32com/client/dynamic.py new file mode 100644 index 00000000..449ad928 --- /dev/null +++ b/lib/win32com/client/dynamic.py @@ -0,0 +1,708 @@ +"""Support for dynamic COM client support. + +Introduction + Dynamic COM client support is the ability to use a COM server without + prior knowledge of the server. This can be used to talk to almost all + COM servers, including much of MS Office. + + In general, you should not use this module directly - see below. + +Example + >>> import win32com.client + >>> xl = win32com.client.Dispatch("Excel.Application") + # The line above invokes the functionality of this class. + # xl is now an object we can use to talk to Excel. + >>> xl.Visible = 1 # The Excel window becomes visible. + +""" +import traceback +import types + +import pythoncom # Needed as code we eval() references it. +import win32com.client +import winerror +from pywintypes import IIDType + +from . import build + +debugging = 0 # General debugging +debugging_attr = 0 # Debugging dynamic attribute lookups. + +LCID = 0x0 + +# These errors generally mean the property or method exists, +# but can't be used in this context - eg, property instead of a method, etc. +# Used to determine if we have a real error or not. +ERRORS_BAD_CONTEXT = [ + winerror.DISP_E_MEMBERNOTFOUND, + winerror.DISP_E_BADPARAMCOUNT, + winerror.DISP_E_PARAMNOTOPTIONAL, + winerror.DISP_E_TYPEMISMATCH, + winerror.E_INVALIDARG, +] + +ALL_INVOKE_TYPES = [ + pythoncom.INVOKE_PROPERTYGET, + pythoncom.INVOKE_PROPERTYPUT, + pythoncom.INVOKE_PROPERTYPUTREF, + pythoncom.INVOKE_FUNC, +] + + +def debug_print(*args): + if debugging: + for arg in args: + print(arg, end=" ") + print() + + +def debug_attr_print(*args): + if debugging_attr: + for arg in args: + print(arg, end=" ") + print() + + +def MakeMethod(func, inst, cls): + return types.MethodType(func, inst) + + +# get the type objects for IDispatch and IUnknown +PyIDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch] +PyIUnknownType = pythoncom.TypeIIDs[pythoncom.IID_IUnknown] + +_GoodDispatchTypes = (str, IIDType) +_defaultDispatchItem = build.DispatchItem + + +def _GetGoodDispatch(IDispatch, clsctx=pythoncom.CLSCTX_SERVER): + # quick return for most common case + if isinstance(IDispatch, PyIDispatchType): + return IDispatch + if isinstance(IDispatch, _GoodDispatchTypes): + try: + IDispatch = pythoncom.connect(IDispatch) + except pythoncom.ole_error: + IDispatch = pythoncom.CoCreateInstance( + IDispatch, None, clsctx, pythoncom.IID_IDispatch + ) + else: + # may already be a wrapped class. + IDispatch = getattr(IDispatch, "_oleobj_", IDispatch) + return IDispatch + + +def _GetGoodDispatchAndUserName(IDispatch, userName, clsctx): + # Get a dispatch object, and a 'user name' (ie, the name as + # displayed to the user in repr() etc. + if userName is None: + if isinstance(IDispatch, str): + userName = IDispatch + ## ??? else userName remains None ??? + else: + userName = str(userName) + return (_GetGoodDispatch(IDispatch, clsctx), userName) + + +def _GetDescInvokeType(entry, invoke_type): + # determine the wFlags argument passed as input to IDispatch::Invoke + # Only ever called by __getattr__ and __setattr__ from dynamic objects! + # * `entry` is a MapEntry with whatever typeinfo we have about the property we are getting/setting. + # * `invoke_type` is either INVOKE_PROPERTYGET | INVOKE_PROPERTYSET and really just + # means "called by __getattr__" or "called by __setattr__" + if not entry or not entry.desc: + return invoke_type + + if entry.desc.desckind == pythoncom.DESCKIND_VARDESC: + return invoke_type + + # So it's a FUNCDESC - just use what it specifies. + return entry.desc.invkind + + +def Dispatch( + IDispatch, + userName=None, + createClass=None, + typeinfo=None, + UnicodeToString=None, + clsctx=pythoncom.CLSCTX_SERVER, +): + assert UnicodeToString is None, "this is deprecated and will go away" + IDispatch, userName = _GetGoodDispatchAndUserName(IDispatch, userName, clsctx) + if createClass is None: + createClass = CDispatch + lazydata = None + try: + if typeinfo is None: + typeinfo = IDispatch.GetTypeInfo() + if typeinfo is not None: + try: + # try for a typecomp + typecomp = typeinfo.GetTypeComp() + lazydata = typeinfo, typecomp + except pythoncom.com_error: + pass + except pythoncom.com_error: + typeinfo = None + olerepr = MakeOleRepr(IDispatch, typeinfo, lazydata) + return createClass(IDispatch, olerepr, userName, lazydata=lazydata) + + +def MakeOleRepr(IDispatch, typeinfo, typecomp): + olerepr = None + if typeinfo is not None: + try: + attr = typeinfo.GetTypeAttr() + # If the type info is a special DUAL interface, magically turn it into + # a DISPATCH typeinfo. + if ( + attr[5] == pythoncom.TKIND_INTERFACE + and attr[11] & pythoncom.TYPEFLAG_FDUAL + ): + # Get corresponding Disp interface; + # -1 is a special value which does this for us. + href = typeinfo.GetRefTypeOfImplType(-1) + typeinfo = typeinfo.GetRefTypeInfo(href) + attr = typeinfo.GetTypeAttr() + if typecomp is None: + olerepr = build.DispatchItem(typeinfo, attr, None, 0) + else: + olerepr = build.LazyDispatchItem(attr, None) + except pythoncom.ole_error: + pass + if olerepr is None: + olerepr = build.DispatchItem() + return olerepr + + +def DumbDispatch( + IDispatch, + userName=None, + createClass=None, + UnicodeToString=None, + clsctx=pythoncom.CLSCTX_SERVER, +): + "Dispatch with no type info" + assert UnicodeToString is None, "this is deprecated and will go away" + IDispatch, userName = _GetGoodDispatchAndUserName(IDispatch, userName, clsctx) + if createClass is None: + createClass = CDispatch + return createClass(IDispatch, build.DispatchItem(), userName) + + +class CDispatch: + def __init__( + self, IDispatch, olerepr, userName=None, UnicodeToString=None, lazydata=None + ): + assert UnicodeToString is None, "this is deprecated and will go away" + if userName is None: + userName = "" + self.__dict__["_oleobj_"] = IDispatch + self.__dict__["_username_"] = userName + self.__dict__["_olerepr_"] = olerepr + self.__dict__["_mapCachedItems_"] = {} + self.__dict__["_builtMethods_"] = {} + self.__dict__["_enum_"] = None + self.__dict__["_unicode_to_string_"] = None + self.__dict__["_lazydata_"] = lazydata + + def __call__(self, *args): + "Provide 'default dispatch' COM functionality - allow instance to be called" + if self._olerepr_.defaultDispatchName: + invkind, dispid = self._find_dispatch_type_( + self._olerepr_.defaultDispatchName + ) + else: + invkind, dispid = ( + pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET, + pythoncom.DISPID_VALUE, + ) + if invkind is not None: + allArgs = (dispid, LCID, invkind, 1) + args + return self._get_good_object_( + self._oleobj_.Invoke(*allArgs), self._olerepr_.defaultDispatchName, None + ) + raise TypeError("This dispatch object does not define a default method") + + def __bool__(self): + return True # ie "if object:" should always be "true" - without this, __len__ is tried. + # _Possibly_ want to defer to __len__ if available, but Im not sure this is + # desirable??? + + def __repr__(self): + return "" % (self._username_) + + def __str__(self): + # __str__ is used when the user does "print object", so we gracefully + # fall back to the __repr__ if the object has no default method. + try: + return str(self.__call__()) + except pythoncom.com_error as details: + if details.hresult not in ERRORS_BAD_CONTEXT: + raise + return self.__repr__() + + def __dir__(self): + lst = list(self.__dict__.keys()) + dir(self.__class__) + self._dir_ole_() + try: + lst += [p.Name for p in self.Properties_] + except AttributeError: + pass + return list(set(lst)) + + def _dir_ole_(self): + items_dict = {} + for iTI in range(0, self._oleobj_.GetTypeInfoCount()): + typeInfo = self._oleobj_.GetTypeInfo(iTI) + self._UpdateWithITypeInfo_(items_dict, typeInfo) + return list(items_dict.keys()) + + def _UpdateWithITypeInfo_(self, items_dict, typeInfo): + typeInfos = [typeInfo] + # suppress IDispatch and IUnknown methods + inspectedIIDs = {pythoncom.IID_IDispatch: None} + + while len(typeInfos) > 0: + typeInfo = typeInfos.pop() + typeAttr = typeInfo.GetTypeAttr() + + if typeAttr.iid not in inspectedIIDs: + inspectedIIDs[typeAttr.iid] = None + for iFun in range(0, typeAttr.cFuncs): + funDesc = typeInfo.GetFuncDesc(iFun) + funName = typeInfo.GetNames(funDesc.memid)[0] + if funName not in items_dict: + items_dict[funName] = None + + # Inspect the type info of all implemented types + # E.g. IShellDispatch5 implements IShellDispatch4 which implements IShellDispatch3 ... + for iImplType in range(0, typeAttr.cImplTypes): + iRefType = typeInfo.GetRefTypeOfImplType(iImplType) + refTypeInfo = typeInfo.GetRefTypeInfo(iRefType) + typeInfos.append(refTypeInfo) + + # Delegate comparison to the oleobjs, as they know how to do identity. + def __eq__(self, other): + other = getattr(other, "_oleobj_", other) + return self._oleobj_ == other + + def __ne__(self, other): + other = getattr(other, "_oleobj_", other) + return self._oleobj_ != other + + def __int__(self): + return int(self.__call__()) + + def __len__(self): + invkind, dispid = self._find_dispatch_type_("Count") + if invkind: + return self._oleobj_.Invoke(dispid, LCID, invkind, 1) + raise TypeError("This dispatch object does not define a Count method") + + def _NewEnum(self): + try: + invkind = pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET + enum = self._oleobj_.InvokeTypes( + pythoncom.DISPID_NEWENUM, LCID, invkind, (13, 10), () + ) + except pythoncom.com_error: + return None # no enumerator for this object. + from . import util + + return util.WrapEnum(enum, None) + + def __getitem__(self, index): # syver modified + # Improved __getitem__ courtesy Syver Enstad + # Must check _NewEnum before Item, to ensure b/w compat. + if isinstance(index, int): + if self.__dict__["_enum_"] is None: + self.__dict__["_enum_"] = self._NewEnum() + if self.__dict__["_enum_"] is not None: + return self._get_good_object_(self._enum_.__getitem__(index)) + # See if we have an "Item" method/property we can use (goes hand in hand with Count() above!) + invkind, dispid = self._find_dispatch_type_("Item") + if invkind is not None: + return self._get_good_object_( + self._oleobj_.Invoke(dispid, LCID, invkind, 1, index) + ) + raise TypeError("This object does not support enumeration") + + def __setitem__(self, index, *args): + # XXX - todo - We should support calling Item() here too! + # print "__setitem__ with", index, args + if self._olerepr_.defaultDispatchName: + invkind, dispid = self._find_dispatch_type_( + self._olerepr_.defaultDispatchName + ) + else: + invkind, dispid = ( + pythoncom.DISPATCH_PROPERTYPUT | pythoncom.DISPATCH_PROPERTYPUTREF, + pythoncom.DISPID_VALUE, + ) + if invkind is not None: + allArgs = (dispid, LCID, invkind, 0, index) + args + return self._get_good_object_( + self._oleobj_.Invoke(*allArgs), self._olerepr_.defaultDispatchName, None + ) + raise TypeError("This dispatch object does not define a default method") + + def _find_dispatch_type_(self, methodName): + if methodName in self._olerepr_.mapFuncs: + item = self._olerepr_.mapFuncs[methodName] + return item.desc[4], item.dispid + + if methodName in self._olerepr_.propMapGet: + item = self._olerepr_.propMapGet[methodName] + return item.desc[4], item.dispid + + try: + dispid = self._oleobj_.GetIDsOfNames(0, methodName) + except: ### what error? + return None, None + return pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET, dispid + + def _ApplyTypes_(self, dispid, wFlags, retType, argTypes, user, resultCLSID, *args): + result = self._oleobj_.InvokeTypes( + *(dispid, LCID, wFlags, retType, argTypes) + args + ) + return self._get_good_object_(result, user, resultCLSID) + + def _wrap_dispatch_( + self, ob, userName=None, returnCLSID=None, UnicodeToString=None + ): + # Given a dispatch object, wrap it in a class + assert UnicodeToString is None, "this is deprecated and will go away" + return Dispatch(ob, userName) + + def _get_good_single_object_(self, ob, userName=None, ReturnCLSID=None): + if isinstance(ob, PyIDispatchType): + # make a new instance of (probably this) class. + return self._wrap_dispatch_(ob, userName, ReturnCLSID) + if isinstance(ob, PyIUnknownType): + try: + ob = ob.QueryInterface(pythoncom.IID_IDispatch) + except pythoncom.com_error: + # It is an IUnknown, but not an IDispatch, so just let it through. + return ob + return self._wrap_dispatch_(ob, userName, ReturnCLSID) + return ob + + def _get_good_object_(self, ob, userName=None, ReturnCLSID=None): + """Given an object (usually the retval from a method), make it a good object to return. + Basically checks if it is a COM object, and wraps it up. + Also handles the fact that a retval may be a tuple of retvals""" + if ob is None: # Quick exit! + return None + elif isinstance(ob, tuple): + return tuple( + map( + lambda o, s=self, oun=userName, rc=ReturnCLSID: s._get_good_single_object_( + o, oun, rc + ), + ob, + ) + ) + else: + return self._get_good_single_object_(ob) + + def _make_method_(self, name): + "Make a method object - Assumes in olerepr funcmap" + methodName = build.MakePublicAttributeName(name) # translate keywords etc. + methodCodeList = self._olerepr_.MakeFuncMethod( + self._olerepr_.mapFuncs[name], methodName, 0 + ) + methodCode = "\n".join(methodCodeList) + try: + # print "Method code for %s is:\n" % self._username_, methodCode + # self._print_details_() + codeObject = compile(methodCode, "" % self._username_, "exec") + # Exec the code object + tempNameSpace = {} + # "Dispatch" in the exec'd code is win32com.client.Dispatch, not ours. + globNameSpace = globals().copy() + globNameSpace["Dispatch"] = win32com.client.Dispatch + exec( + codeObject, globNameSpace, tempNameSpace + ) # self.__dict__, self.__dict__ + name = methodName + # Save the function in map. + fn = self._builtMethods_[name] = tempNameSpace[name] + newMeth = MakeMethod(fn, self, self.__class__) + return newMeth + except: + debug_print("Error building OLE definition for code ", methodCode) + traceback.print_exc() + return None + + def _Release_(self): + """Cleanup object - like a close - to force cleanup when you dont + want to rely on Python's reference counting.""" + for childCont in self._mapCachedItems_.values(): + childCont._Release_() + self._mapCachedItems_ = {} + if self._oleobj_: + self._oleobj_.Release() + self.__dict__["_oleobj_"] = None + if self._olerepr_: + self.__dict__["_olerepr_"] = None + self._enum_ = None + + def _proc_(self, name, *args): + """Call the named method as a procedure, rather than function. + Mainly used by Word.Basic, which whinges about such things.""" + try: + item = self._olerepr_.mapFuncs[name] + dispId = item.dispid + return self._get_good_object_( + self._oleobj_.Invoke(*(dispId, LCID, item.desc[4], 0) + (args)) + ) + except KeyError: + raise AttributeError(name) + + def _print_details_(self): + "Debug routine - dumps what it knows about an object." + print("AxDispatch container", self._username_) + try: + print("Methods:") + for method in self._olerepr_.mapFuncs.keys(): + print("\t", method) + print("Props:") + for prop, entry in self._olerepr_.propMap.items(): + print("\t%s = 0x%x - %s" % (prop, entry.dispid, repr(entry))) + print("Get Props:") + for prop, entry in self._olerepr_.propMapGet.items(): + print("\t%s = 0x%x - %s" % (prop, entry.dispid, repr(entry))) + print("Put Props:") + for prop, entry in self._olerepr_.propMapPut.items(): + print("\t%s = 0x%x - %s" % (prop, entry.dispid, repr(entry))) + except: + traceback.print_exc() + + def __LazyMap__(self, attr): + try: + if self._LazyAddAttr_(attr): + debug_attr_print( + "%s.__LazyMap__(%s) added something" % (self._username_, attr) + ) + return 1 + except AttributeError: + return 0 + + # Using the typecomp, lazily create a new attribute definition. + def _LazyAddAttr_(self, attr): + if self._lazydata_ is None: + return 0 + res = 0 + typeinfo, typecomp = self._lazydata_ + olerepr = self._olerepr_ + # We need to explicitly check each invoke type individually - simply + # specifying '0' will bind to "any member", which may not be the one + # we are actually after (ie, we may be after prop_get, but returned + # the info for the prop_put.) + for i in ALL_INVOKE_TYPES: + try: + x, t = typecomp.Bind(attr, i) + # Support 'Get' and 'Set' properties - see + # bug 1587023 + if x == 0 and attr[:3] in ("Set", "Get"): + x, t = typecomp.Bind(attr[3:], i) + if x == pythoncom.DESCKIND_FUNCDESC: # it's a FUNCDESC + r = olerepr._AddFunc_(typeinfo, t, 0) + elif x == pythoncom.DESCKIND_VARDESC: # it's a VARDESC + r = olerepr._AddVar_(typeinfo, t, 0) + else: # not found or TYPEDESC/IMPLICITAPP + r = None + if not r is None: + key, map = r[0], r[1] + item = map[key] + if map == olerepr.propMapPut: + olerepr._propMapPutCheck_(key, item) + elif map == olerepr.propMapGet: + olerepr._propMapGetCheck_(key, item) + res = 1 + except: + pass + return res + + def _FlagAsMethod(self, *methodNames): + """Flag these attribute names as being methods. + Some objects do not correctly differentiate methods and + properties, leading to problems when calling these methods. + + Specifically, trying to say: ob.SomeFunc() + may yield an exception "None object is not callable" + In this case, an attempt to fetch the *property* has worked + and returned None, rather than indicating it is really a method. + Calling: ob._FlagAsMethod("SomeFunc") + should then allow this to work. + """ + for name in methodNames: + details = build.MapEntry(self.__AttrToID__(name), (name,)) + self._olerepr_.mapFuncs[name] = details + + def __AttrToID__(self, attr): + debug_attr_print( + "Calling GetIDsOfNames for property %s in Dispatch container %s" + % (attr, self._username_) + ) + return self._oleobj_.GetIDsOfNames(0, attr) + + def __getattr__(self, attr): + if attr == "__iter__": + # We can't handle this as a normal method, as if the attribute + # exists, then it must return an iterable object. + try: + invkind = pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET + enum = self._oleobj_.InvokeTypes( + pythoncom.DISPID_NEWENUM, LCID, invkind, (13, 10), () + ) + except pythoncom.com_error: + raise AttributeError("This object can not function as an iterator") + + # We must return a callable object. + class Factory: + def __init__(self, ob): + self.ob = ob + + def __call__(self): + import win32com.client.util + + return win32com.client.util.Iterator(self.ob) + + return Factory(enum) + + if attr.startswith("_") and attr.endswith("_"): # Fast-track. + raise AttributeError(attr) + # If a known method, create new instance and return. + try: + return MakeMethod(self._builtMethods_[attr], self, self.__class__) + except KeyError: + pass + # XXX - Note that we current are case sensitive in the method. + # debug_attr_print("GetAttr called for %s on DispatchContainer %s" % (attr,self._username_)) + # First check if it is in the method map. Note that an actual method + # must not yet exist, (otherwise we would not be here). This + # means we create the actual method object - which also means + # this code will never be asked for that method name again. + if attr in self._olerepr_.mapFuncs: + return self._make_method_(attr) + + # Delegate to property maps/cached items + retEntry = None + if self._olerepr_ and self._oleobj_: + # first check general property map, then specific "put" map. + retEntry = self._olerepr_.propMap.get(attr) + if retEntry is None: + retEntry = self._olerepr_.propMapGet.get(attr) + # Not found so far - See what COM says. + if retEntry is None: + try: + if self.__LazyMap__(attr): + if attr in self._olerepr_.mapFuncs: + return self._make_method_(attr) + retEntry = self._olerepr_.propMap.get(attr) + if retEntry is None: + retEntry = self._olerepr_.propMapGet.get(attr) + if retEntry is None: + retEntry = build.MapEntry(self.__AttrToID__(attr), (attr,)) + except pythoncom.ole_error: + pass # No prop by that name - retEntry remains None. + + if retEntry is not None: # see if in my cache + try: + ret = self._mapCachedItems_[retEntry.dispid] + debug_attr_print("Cached items has attribute!", ret) + return ret + except (KeyError, AttributeError): + debug_attr_print("Attribute %s not in cache" % attr) + + # If we are still here, and have a retEntry, get the OLE item + if retEntry is not None: + invoke_type = _GetDescInvokeType(retEntry, pythoncom.INVOKE_PROPERTYGET) + debug_attr_print( + "Getting property Id 0x%x from OLE object" % retEntry.dispid + ) + try: + ret = self._oleobj_.Invoke(retEntry.dispid, 0, invoke_type, 1) + except pythoncom.com_error as details: + if details.hresult in ERRORS_BAD_CONTEXT: + # May be a method. + self._olerepr_.mapFuncs[attr] = retEntry + return self._make_method_(attr) + raise + debug_attr_print("OLE returned ", ret) + return self._get_good_object_(ret) + + # no where else to look. + raise AttributeError("%s.%s" % (self._username_, attr)) + + def __setattr__(self, attr, value): + if ( + attr in self.__dict__ + ): # Fast-track - if already in our dict, just make the assignment. + # XXX - should maybe check method map - if someone assigns to a method, + # it could mean something special (not sure what, tho!) + self.__dict__[attr] = value + return + # Allow property assignment. + debug_attr_print( + "SetAttr called for %s.%s=%s on DispatchContainer" + % (self._username_, attr, repr(value)) + ) + + if self._olerepr_: + # Check the "general" property map. + if attr in self._olerepr_.propMap: + entry = self._olerepr_.propMap[attr] + invoke_type = _GetDescInvokeType(entry, pythoncom.INVOKE_PROPERTYPUT) + self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value) + return + # Check the specific "put" map. + if attr in self._olerepr_.propMapPut: + entry = self._olerepr_.propMapPut[attr] + invoke_type = _GetDescInvokeType(entry, pythoncom.INVOKE_PROPERTYPUT) + self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value) + return + + # Try the OLE Object + if self._oleobj_: + if self.__LazyMap__(attr): + # Check the "general" property map. + if attr in self._olerepr_.propMap: + entry = self._olerepr_.propMap[attr] + invoke_type = _GetDescInvokeType( + entry, pythoncom.INVOKE_PROPERTYPUT + ) + self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value) + return + # Check the specific "put" map. + if attr in self._olerepr_.propMapPut: + entry = self._olerepr_.propMapPut[attr] + invoke_type = _GetDescInvokeType( + entry, pythoncom.INVOKE_PROPERTYPUT + ) + self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value) + return + try: + entry = build.MapEntry(self.__AttrToID__(attr), (attr,)) + except pythoncom.com_error: + # No attribute of that name + entry = None + if entry is not None: + try: + invoke_type = _GetDescInvokeType( + entry, pythoncom.INVOKE_PROPERTYPUT + ) + self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value) + self._olerepr_.propMap[attr] = entry + debug_attr_print( + "__setattr__ property %s (id=0x%x) in Dispatch container %s" + % (attr, entry.dispid, self._username_) + ) + return + except pythoncom.com_error: + pass + raise AttributeError( + "Property '%s.%s' can not be set." % (self._username_, attr) + ) diff --git a/lib/win32com/client/gencache.py b/lib/win32com/client/gencache.py new file mode 100644 index 00000000..99e9c6cb --- /dev/null +++ b/lib/win32com/client/gencache.py @@ -0,0 +1,799 @@ +"""Manages the cache of generated Python code. + +Description + This file manages the cache of generated Python code. When run from the + command line, it also provides a number of options for managing that cache. + +Implementation + Each typelib is generated into a filename of format "{guid}x{lcid}x{major}x{minor}.py" + + An external persistant dictionary maps from all known IIDs in all known type libraries + to the type library itself. + + Thus, whenever Python code knows the IID of an object, it can find the IID, LCID and version of + the type library which supports it. Given this information, it can find the Python module + with the support. + + If necessary, this support can be generated on the fly. + +Hacks, to do, etc + Currently just uses a pickled dictionary, but should used some sort of indexed file. + Maybe an OLE2 compound file, or a bsddb file? +""" +import glob +import os +import sys +from importlib import reload + +import pythoncom +import pywintypes +import win32com +import win32com.client + +from . import CLSIDToClass + +bForDemandDefault = 0 # Default value of bForDemand - toggle this to change the world - see also makepy.py + +# The global dictionary +clsidToTypelib = {} + +# If we have a different version of the typelib generated, this +# maps the "requested version" to the "generated version". +versionRedirectMap = {} + +# There is no reason we *must* be readonly in a .zip, but we are now, +# Rather than check for ".zip" or other tricks, PEP302 defines +# a "__loader__" attribute, so we use that. +# (Later, it may become necessary to check if the __loader__ can update files, +# as a .zip loader potentially could - but punt all that until a need arises) +is_readonly = is_zip = hasattr(win32com, "__loader__") and hasattr( + win32com.__loader__, "archive" +) + +# A dictionary of ITypeLibrary objects for demand generation explicitly handed to us +# Keyed by usual clsid, lcid, major, minor +demandGeneratedTypeLibraries = {} + +import pickle as pickle + + +def __init__(): + # Initialize the module. Called once explicitly at module import below. + try: + _LoadDicts() + except IOError: + Rebuild() + + +pickleVersion = 1 + + +def _SaveDicts(): + if is_readonly: + raise RuntimeError( + "Trying to write to a readonly gencache ('%s')!" % win32com.__gen_path__ + ) + f = open(os.path.join(GetGeneratePath(), "dicts.dat"), "wb") + try: + p = pickle.Pickler(f) + p.dump(pickleVersion) + p.dump(clsidToTypelib) + finally: + f.close() + + +def _LoadDicts(): + # Load the dictionary from a .zip file if that is where we live. + if is_zip: + import io as io + + loader = win32com.__loader__ + arc_path = loader.archive + dicts_path = os.path.join(win32com.__gen_path__, "dicts.dat") + if dicts_path.startswith(arc_path): + dicts_path = dicts_path[len(arc_path) + 1 :] + else: + # Hm. See below. + return + try: + data = loader.get_data(dicts_path) + except AttributeError: + # The __loader__ has no get_data method. See below. + return + except IOError: + # Our gencache is in a .zip file (and almost certainly readonly) + # but no dicts file. That actually needn't be fatal for a frozen + # application. Assuming they call "EnsureModule" with the same + # typelib IDs they have been frozen with, that EnsureModule will + # correctly re-build the dicts on the fly. However, objects that + # rely on the gencache but have not done an EnsureModule will + # fail (but their apps are likely to fail running from source + # with a clean gencache anyway, as then they would be getting + # Dynamic objects until the cache is built - so the best answer + # for these apps is to call EnsureModule, rather than freezing + # the dict) + return + f = io.BytesIO(data) + else: + # NOTE: IOError on file open must be caught by caller. + f = open(os.path.join(win32com.__gen_path__, "dicts.dat"), "rb") + try: + p = pickle.Unpickler(f) + version = p.load() + global clsidToTypelib + clsidToTypelib = p.load() + versionRedirectMap.clear() + finally: + f.close() + + +def GetGeneratedFileName(clsid, lcid, major, minor): + """Given the clsid, lcid, major and minor for a type lib, return + the file name (no extension) providing this support. + """ + return str(clsid).upper()[1:-1] + "x%sx%sx%s" % (lcid, major, minor) + + +def SplitGeneratedFileName(fname): + """Reverse of GetGeneratedFileName()""" + return tuple(fname.split("x", 4)) + + +def GetGeneratePath(): + """Returns the name of the path to generate to. + Checks the directory is OK. + """ + assert not is_readonly, "Why do you want the genpath for a readonly store?" + try: + os.makedirs(win32com.__gen_path__) + # os.mkdir(win32com.__gen_path__) + except os.error: + pass + try: + fname = os.path.join(win32com.__gen_path__, "__init__.py") + os.stat(fname) + except os.error: + f = open(fname, "w") + f.write( + "# Generated file - this directory may be deleted to reset the COM cache...\n" + ) + f.write("import win32com\n") + f.write( + "if __path__[:-1] != win32com.__gen_path__: __path__.append(win32com.__gen_path__)\n" + ) + f.close() + + return win32com.__gen_path__ + + +# +# The helpers for win32com.client.Dispatch and OCX clients. +# +def GetClassForProgID(progid): + """Get a Python class for a Program ID + + Given a Program ID, return a Python class which wraps the COM object + + Returns the Python class, or None if no module is available. + + Params + progid -- A COM ProgramID or IID (eg, "Word.Application") + """ + clsid = pywintypes.IID(progid) # This auto-converts named to IDs. + return GetClassForCLSID(clsid) + + +def GetClassForCLSID(clsid): + """Get a Python class for a CLSID + + Given a CLSID, return a Python class which wraps the COM object + + Returns the Python class, or None if no module is available. + + Params + clsid -- A COM CLSID (or string repr of one) + """ + # first, take a short-cut - we may already have generated support ready-to-roll. + clsid = str(clsid) + if CLSIDToClass.HasClass(clsid): + return CLSIDToClass.GetClass(clsid) + mod = GetModuleForCLSID(clsid) + if mod is None: + return None + try: + return CLSIDToClass.GetClass(clsid) + except KeyError: + return None + + +def GetModuleForProgID(progid): + """Get a Python module for a Program ID + + Given a Program ID, return a Python module which contains the + class which wraps the COM object. + + Returns the Python module, or None if no module is available. + + Params + progid -- A COM ProgramID or IID (eg, "Word.Application") + """ + try: + iid = pywintypes.IID(progid) + except pywintypes.com_error: + return None + return GetModuleForCLSID(iid) + + +def GetModuleForCLSID(clsid): + """Get a Python module for a CLSID + + Given a CLSID, return a Python module which contains the + class which wraps the COM object. + + Returns the Python module, or None if no module is available. + + Params + progid -- A COM CLSID (ie, not the description) + """ + clsid_str = str(clsid) + try: + typelibCLSID, lcid, major, minor = clsidToTypelib[clsid_str] + except KeyError: + return None + + try: + mod = GetModuleForTypelib(typelibCLSID, lcid, major, minor) + except ImportError: + mod = None + if mod is not None: + sub_mod = mod.CLSIDToPackageMap.get(clsid_str) + if sub_mod is None: + sub_mod = mod.VTablesToPackageMap.get(clsid_str) + if sub_mod is not None: + sub_mod_name = mod.__name__ + "." + sub_mod + try: + __import__(sub_mod_name) + except ImportError: + info = typelibCLSID, lcid, major, minor + # Force the generation. If this typelibrary has explicitly been added, + # use it (it may not be registered, causing a lookup by clsid to fail) + if info in demandGeneratedTypeLibraries: + info = demandGeneratedTypeLibraries[info] + from . import makepy + + makepy.GenerateChildFromTypeLibSpec(sub_mod, info) + # Generate does an import... + mod = sys.modules[sub_mod_name] + return mod + + +def GetModuleForTypelib(typelibCLSID, lcid, major, minor): + """Get a Python module for a type library ID + + Given the CLSID of a typelibrary, return an imported Python module, + else None + + Params + typelibCLSID -- IID of the type library. + major -- Integer major version. + minor -- Integer minor version + lcid -- Integer LCID for the library. + """ + modName = GetGeneratedFileName(typelibCLSID, lcid, major, minor) + mod = _GetModule(modName) + # If the import worked, it doesn't mean we have actually added this + # module to our cache though - check that here. + if "_in_gencache_" not in mod.__dict__: + AddModuleToCache(typelibCLSID, lcid, major, minor) + assert "_in_gencache_" in mod.__dict__ + return mod + + +def MakeModuleForTypelib( + typelibCLSID, + lcid, + major, + minor, + progressInstance=None, + bForDemand=bForDemandDefault, + bBuildHidden=1, +): + """Generate support for a type library. + + Given the IID, LCID and version information for a type library, generate + and import the necessary support files. + + Returns the Python module. No exceptions are caught. + + Params + typelibCLSID -- IID of the type library. + major -- Integer major version. + minor -- Integer minor version. + lcid -- Integer LCID for the library. + progressInstance -- Instance to use as progress indicator, or None to + use the GUI progress bar. + """ + from . import makepy + + makepy.GenerateFromTypeLibSpec( + (typelibCLSID, lcid, major, minor), + progressInstance=progressInstance, + bForDemand=bForDemand, + bBuildHidden=bBuildHidden, + ) + return GetModuleForTypelib(typelibCLSID, lcid, major, minor) + + +def MakeModuleForTypelibInterface( + typelib_ob, progressInstance=None, bForDemand=bForDemandDefault, bBuildHidden=1 +): + """Generate support for a type library. + + Given a PyITypeLib interface generate and import the necessary support files. This is useful + for getting makepy support for a typelibrary that is not registered - the caller can locate + and load the type library itself, rather than relying on COM to find it. + + Returns the Python module. + + Params + typelib_ob -- The type library itself + progressInstance -- Instance to use as progress indicator, or None to + use the GUI progress bar. + """ + from . import makepy + + try: + makepy.GenerateFromTypeLibSpec( + typelib_ob, + progressInstance=progressInstance, + bForDemand=bForDemandDefault, + bBuildHidden=bBuildHidden, + ) + except pywintypes.com_error: + return None + tla = typelib_ob.GetLibAttr() + guid = tla[0] + lcid = tla[1] + major = tla[3] + minor = tla[4] + return GetModuleForTypelib(guid, lcid, major, minor) + + +def EnsureModuleForTypelibInterface( + typelib_ob, progressInstance=None, bForDemand=bForDemandDefault, bBuildHidden=1 +): + """Check we have support for a type library, generating if not. + + Given a PyITypeLib interface generate and import the necessary + support files if necessary. This is useful for getting makepy support + for a typelibrary that is not registered - the caller can locate and + load the type library itself, rather than relying on COM to find it. + + Returns the Python module. + + Params + typelib_ob -- The type library itself + progressInstance -- Instance to use as progress indicator, or None to + use the GUI progress bar. + """ + tla = typelib_ob.GetLibAttr() + guid = tla[0] + lcid = tla[1] + major = tla[3] + minor = tla[4] + + # If demand generated, save the typelib interface away for later use + if bForDemand: + demandGeneratedTypeLibraries[(str(guid), lcid, major, minor)] = typelib_ob + + try: + return GetModuleForTypelib(guid, lcid, major, minor) + except ImportError: + pass + # Generate it. + return MakeModuleForTypelibInterface( + typelib_ob, progressInstance, bForDemand, bBuildHidden + ) + + +def ForgetAboutTypelibInterface(typelib_ob): + """Drop any references to a typelib previously added with EnsureModuleForTypelibInterface and forDemand""" + tla = typelib_ob.GetLibAttr() + guid = tla[0] + lcid = tla[1] + major = tla[3] + minor = tla[4] + info = str(guid), lcid, major, minor + try: + del demandGeneratedTypeLibraries[info] + except KeyError: + # Not worth raising an exception - maybe they dont know we only remember for demand generated, etc. + print( + "ForgetAboutTypelibInterface:: Warning - type library with info %s is not being remembered!" + % (info,) + ) + # and drop any version redirects to it + for key, val in list(versionRedirectMap.items()): + if val == info: + del versionRedirectMap[key] + + +def EnsureModule( + typelibCLSID, + lcid, + major, + minor, + progressInstance=None, + bValidateFile=not is_readonly, + bForDemand=bForDemandDefault, + bBuildHidden=1, +): + """Ensure Python support is loaded for a type library, generating if necessary. + + Given the IID, LCID and version information for a type library, check and if + necessary (re)generate, then import the necessary support files. If we regenerate the file, there + is no way to totally snuff out all instances of the old module in Python, and thus we will regenerate the file more than necessary, + unless makepy/genpy is modified accordingly. + + + Returns the Python module. No exceptions are caught during the generate process. + + Params + typelibCLSID -- IID of the type library. + major -- Integer major version. + minor -- Integer minor version + lcid -- Integer LCID for the library. + progressInstance -- Instance to use as progress indicator, or None to + use the GUI progress bar. + bValidateFile -- Whether or not to perform cache validation or not + bForDemand -- Should a complete generation happen now, or on demand? + bBuildHidden -- Should hidden members/attributes etc be generated? + """ + bReloadNeeded = 0 + try: + try: + module = GetModuleForTypelib(typelibCLSID, lcid, major, minor) + except ImportError: + # If we get an ImportError + # We may still find a valid cache file under a different MinorVersion # + # (which windows will search out for us) + # print "Loading reg typelib", typelibCLSID, major, minor, lcid + module = None + try: + tlbAttr = pythoncom.LoadRegTypeLib( + typelibCLSID, major, minor, lcid + ).GetLibAttr() + # if the above line doesn't throw a pythoncom.com_error, check if + # it is actually a different lib than we requested, and if so, suck it in + if tlbAttr[1] != lcid or tlbAttr[4] != minor: + # print "Trying 2nd minor #", tlbAttr[1], tlbAttr[3], tlbAttr[4] + try: + module = GetModuleForTypelib( + typelibCLSID, tlbAttr[1], tlbAttr[3], tlbAttr[4] + ) + except ImportError: + # We don't have a module, but we do have a better minor + # version - remember that. + minor = tlbAttr[4] + # else module remains None + except pythoncom.com_error: + # couldn't load any typelib - mod remains None + pass + if module is not None and bValidateFile: + assert not is_readonly, "Can't validate in a read-only gencache" + try: + typLibPath = pythoncom.QueryPathOfRegTypeLib( + typelibCLSID, major, minor, lcid + ) + # windows seems to add an extra \0 (via the underlying BSTR) + # The mainwin toolkit does not add this erroneous \0 + if typLibPath[-1] == "\0": + typLibPath = typLibPath[:-1] + suf = getattr(os.path, "supports_unicode_filenames", 0) + if not suf: + # can't pass unicode filenames directly - convert + try: + typLibPath = typLibPath.encode(sys.getfilesystemencoding()) + except AttributeError: # no sys.getfilesystemencoding + typLibPath = str(typLibPath) + tlbAttributes = pythoncom.LoadRegTypeLib( + typelibCLSID, major, minor, lcid + ).GetLibAttr() + except pythoncom.com_error: + # We have a module, but no type lib - we should still + # run with what we have though - the typelib may not be + # deployed here. + bValidateFile = 0 + if module is not None and bValidateFile: + assert not is_readonly, "Can't validate in a read-only gencache" + filePathPrefix = "%s\\%s" % ( + GetGeneratePath(), + GetGeneratedFileName(typelibCLSID, lcid, major, minor), + ) + filePath = filePathPrefix + ".py" + filePathPyc = filePathPrefix + ".py" + if __debug__: + filePathPyc = filePathPyc + "c" + else: + filePathPyc = filePathPyc + "o" + # Verify that type library is up to date. + # If we have a differing MinorVersion or genpy has bumped versions, update the file + from . import genpy + + if ( + module.MinorVersion != tlbAttributes[4] + or genpy.makepy_version != module.makepy_version + ): + # print "Version skew: %d, %d" % (module.MinorVersion, tlbAttributes[4]) + # try to erase the bad file from the cache + try: + os.unlink(filePath) + except os.error: + pass + try: + os.unlink(filePathPyc) + except os.error: + pass + if os.path.isdir(filePathPrefix): + import shutil + + shutil.rmtree(filePathPrefix) + minor = tlbAttributes[4] + module = None + bReloadNeeded = 1 + else: + minor = module.MinorVersion + filePathPrefix = "%s\\%s" % ( + GetGeneratePath(), + GetGeneratedFileName(typelibCLSID, lcid, major, minor), + ) + filePath = filePathPrefix + ".py" + filePathPyc = filePathPrefix + ".pyc" + # print "Trying py stat: ", filePath + fModTimeSet = 0 + try: + pyModTime = os.stat(filePath)[8] + fModTimeSet = 1 + except os.error as e: + # If .py file fails, try .pyc file + # print "Trying pyc stat", filePathPyc + try: + pyModTime = os.stat(filePathPyc)[8] + fModTimeSet = 1 + except os.error as e: + pass + # print "Trying stat typelib", pyModTime + # print str(typLibPath) + typLibModTime = os.stat(typLibPath)[8] + if fModTimeSet and (typLibModTime > pyModTime): + bReloadNeeded = 1 + module = None + except (ImportError, os.error): + module = None + if module is None: + # We need to build an item. If we are in a read-only cache, we + # can't/don't want to do this - so before giving up, check for + # a different minor version in our cache - according to COM, this is OK + if is_readonly: + key = str(typelibCLSID), lcid, major, minor + # If we have been asked before, get last result. + try: + return versionRedirectMap[key] + except KeyError: + pass + # Find other candidates. + items = [] + for desc in GetGeneratedInfos(): + if key[0] == desc[0] and key[1] == desc[1] and key[2] == desc[2]: + items.append(desc) + if items: + # Items are all identical, except for last tuple element + # We want the latest minor version we have - so just sort and grab last + items.sort() + new_minor = items[-1][3] + ret = GetModuleForTypelib(typelibCLSID, lcid, major, new_minor) + else: + ret = None + # remember and return + versionRedirectMap[key] = ret + return ret + # print "Rebuilding: ", major, minor + module = MakeModuleForTypelib( + typelibCLSID, + lcid, + major, + minor, + progressInstance, + bForDemand=bForDemand, + bBuildHidden=bBuildHidden, + ) + # If we replaced something, reload it + if bReloadNeeded: + module = reload(module) + AddModuleToCache(typelibCLSID, lcid, major, minor) + return module + + +def EnsureDispatch( + prog_id, bForDemand=1 +): # New fn, so we default the new demand feature to on! + """Given a COM prog_id, return an object that is using makepy support, building if necessary""" + disp = win32com.client.Dispatch(prog_id) + if not disp.__dict__.get("CLSID"): # Eeek - no makepy support - try and build it. + try: + ti = disp._oleobj_.GetTypeInfo() + disp_clsid = ti.GetTypeAttr()[0] + tlb, index = ti.GetContainingTypeLib() + tla = tlb.GetLibAttr() + mod = EnsureModule(tla[0], tla[1], tla[3], tla[4], bForDemand=bForDemand) + GetModuleForCLSID(disp_clsid) + # Get the class from the module. + from . import CLSIDToClass + + disp_class = CLSIDToClass.GetClass(str(disp_clsid)) + disp = disp_class(disp._oleobj_) + except pythoncom.com_error: + raise TypeError( + "This COM object can not automate the makepy process - please run makepy manually for this object" + ) + return disp + + +def AddModuleToCache( + typelibclsid, lcid, major, minor, verbose=1, bFlushNow=not is_readonly +): + """Add a newly generated file to the cache dictionary.""" + fname = GetGeneratedFileName(typelibclsid, lcid, major, minor) + mod = _GetModule(fname) + # if mod._in_gencache_ is already true, then we are reloading this + # module - this doesn't mean anything special though! + mod._in_gencache_ = 1 + info = str(typelibclsid), lcid, major, minor + dict_modified = False + + def SetTypelibForAllClsids(dict): + nonlocal dict_modified + for clsid, cls in dict.items(): + if clsidToTypelib.get(clsid) != info: + clsidToTypelib[clsid] = info + dict_modified = True + + SetTypelibForAllClsids(mod.CLSIDToClassMap) + SetTypelibForAllClsids(mod.CLSIDToPackageMap) + SetTypelibForAllClsids(mod.VTablesToClassMap) + SetTypelibForAllClsids(mod.VTablesToPackageMap) + + # If this lib was previously redirected, drop it + if info in versionRedirectMap: + del versionRedirectMap[info] + if bFlushNow and dict_modified: + _SaveDicts() + + +def GetGeneratedInfos(): + zip_pos = win32com.__gen_path__.find(".zip\\") + if zip_pos >= 0: + import zipfile + + zip_file = win32com.__gen_path__[: zip_pos + 4] + zip_path = win32com.__gen_path__[zip_pos + 5 :].replace("\\", "/") + zf = zipfile.ZipFile(zip_file) + infos = {} + for n in zf.namelist(): + if not n.startswith(zip_path): + continue + base = n[len(zip_path) + 1 :].split("/")[0] + try: + iid, lcid, major, minor = base.split("x") + lcid = int(lcid) + major = int(major) + minor = int(minor) + iid = pywintypes.IID("{" + iid + "}") + except ValueError: + continue + except pywintypes.com_error: + # invalid IID + continue + infos[(iid, lcid, major, minor)] = 1 + zf.close() + return list(infos.keys()) + else: + # on the file system + files = glob.glob(win32com.__gen_path__ + "\\*") + ret = [] + for file in files: + if not os.path.isdir(file) and not os.path.splitext(file)[1] == ".py": + continue + name = os.path.splitext(os.path.split(file)[1])[0] + try: + iid, lcid, major, minor = name.split("x") + iid = pywintypes.IID("{" + iid + "}") + lcid = int(lcid) + major = int(major) + minor = int(minor) + except ValueError: + continue + except pywintypes.com_error: + # invalid IID + continue + ret.append((iid, lcid, major, minor)) + return ret + + +def _GetModule(fname): + """Given the name of a module in the gen_py directory, import and return it.""" + mod_name = "win32com.gen_py.%s" % fname + mod = __import__(mod_name) + return sys.modules[mod_name] + + +def Rebuild(verbose=1): + """Rebuild the cache indexes from the file system.""" + clsidToTypelib.clear() + infos = GetGeneratedInfos() + if verbose and len(infos): # Dont bother reporting this when directory is empty! + print("Rebuilding cache of generated files for COM support...") + for info in infos: + iid, lcid, major, minor = info + if verbose: + print("Checking", GetGeneratedFileName(*info)) + try: + AddModuleToCache(iid, lcid, major, minor, verbose, 0) + except: + print( + "Could not add module %s - %s: %s" + % (info, sys.exc_info()[0], sys.exc_info()[1]) + ) + if verbose and len(infos): # Dont bother reporting this when directory is empty! + print("Done.") + _SaveDicts() + + +def _Dump(): + print("Cache is in directory", win32com.__gen_path__) + # Build a unique dir + d = {} + for clsid, (typelibCLSID, lcid, major, minor) in clsidToTypelib.items(): + d[typelibCLSID, lcid, major, minor] = None + for typelibCLSID, lcid, major, minor in d.keys(): + mod = GetModuleForTypelib(typelibCLSID, lcid, major, minor) + print("%s - %s" % (mod.__doc__, typelibCLSID)) + + +# Boot up +__init__() + + +def usage(): + usageString = """\ + Usage: gencache [-q] [-d] [-r] + + -q - Quiet + -d - Dump the cache (typelibrary description and filename). + -r - Rebuild the cache dictionary from the existing .py files + """ + print(usageString) + sys.exit(1) + + +if __name__ == "__main__": + import getopt + + try: + opts, args = getopt.getopt(sys.argv[1:], "qrd") + except getopt.error as message: + print(message) + usage() + + # we only have options - complain about real args, or none at all! + if len(sys.argv) == 1 or args: + print(usage()) + + verbose = 1 + for opt, val in opts: + if opt == "-d": # Dump + _Dump() + if opt == "-r": + Rebuild(verbose) + if opt == "-q": + verbose = 0 diff --git a/lib/win32com/client/genpy.py b/lib/win32com/client/genpy.py new file mode 100644 index 00000000..3eba075f --- /dev/null +++ b/lib/win32com/client/genpy.py @@ -0,0 +1,1411 @@ +"""genpy.py - The worker for makepy. See makepy.py for more details + +This code was moved simply to speed Python in normal circumstances. As the makepy.py +is normally run from the command line, it reparses the code each time. Now makepy +is nothing more than the command line handler and public interface. + +The makepy command line etc handling is also getting large enough in its own right! +""" + +# NOTE - now supports a "demand" mechanism - the top-level is a package, and +# each class etc can be made individually. +# This should eventually become the default. +# Then the old non-package technique should be removed. +# There should be no b/w compat issues, and will just help clean the code. +# This will be done once the new "demand" mechanism gets a good workout. +import os +import sys +import time + +import pythoncom +import win32com + +from . import build + +error = "makepy.error" +makepy_version = "0.5.01" # Written to generated file. + +GEN_FULL = "full" +GEN_DEMAND_BASE = "demand(base)" +GEN_DEMAND_CHILD = "demand(child)" + +# This map is used purely for the users benefit -it shows the +# raw, underlying type of Alias/Enums, etc. The COM implementation +# does not use this map at runtime - all Alias/Enum have already +# been translated. +mapVTToTypeString = { + pythoncom.VT_I2: "types.IntType", + pythoncom.VT_I4: "types.IntType", + pythoncom.VT_R4: "types.FloatType", + pythoncom.VT_R8: "types.FloatType", + pythoncom.VT_BSTR: "types.StringType", + pythoncom.VT_BOOL: "types.IntType", + pythoncom.VT_VARIANT: "types.TypeType", + pythoncom.VT_I1: "types.IntType", + pythoncom.VT_UI1: "types.IntType", + pythoncom.VT_UI2: "types.IntType", + pythoncom.VT_UI4: "types.IntType", + pythoncom.VT_I8: "types.LongType", + pythoncom.VT_UI8: "types.LongType", + pythoncom.VT_INT: "types.IntType", + pythoncom.VT_DATE: "pythoncom.PyTimeType", + pythoncom.VT_UINT: "types.IntType", +} + + +# Given a propget function's arg desc, return the default parameters for all +# params bar the first. Eg, then Python does a: +# object.Property = "foo" +# Python can only pass the "foo" value. If the property has +# multiple args, and the rest have default values, this allows +# Python to correctly pass those defaults. +def MakeDefaultArgsForPropertyPut(argsDesc): + ret = [] + for desc in argsDesc[1:]: + default = build.MakeDefaultArgRepr(desc) + if default is None: + break + ret.append(default) + return tuple(ret) + + +def MakeMapLineEntry(dispid, wFlags, retType, argTypes, user, resultCLSID): + # Strip the default value + argTypes = tuple([what[:2] for what in argTypes]) + return '(%s, %d, %s, %s, "%s", %s)' % ( + dispid, + wFlags, + retType[:2], + argTypes, + user, + resultCLSID, + ) + + +def MakeEventMethodName(eventName): + if eventName[:2] == "On": + return eventName + else: + return "On" + eventName + + +def WriteSinkEventMap(obj, stream): + print("\t_dispid_to_func_ = {", file=stream) + for name, entry in ( + list(obj.propMapGet.items()) + + list(obj.propMapPut.items()) + + list(obj.mapFuncs.items()) + ): + fdesc = entry.desc + print( + '\t\t%9d : "%s",' % (fdesc.memid, MakeEventMethodName(entry.names[0])), + file=stream, + ) + print("\t\t}", file=stream) + + +# MI is used to join my writable helpers, and the OLE +# classes. +class WritableItem: + # __cmp__ used for sorting in py2x... + def __cmp__(self, other): + "Compare for sorting" + ret = cmp(self.order, other.order) + if ret == 0 and self.doc: + ret = cmp(self.doc[0], other.doc[0]) + return ret + + # ... but not used in py3k - __lt__ minimum needed there + def __lt__(self, other): # py3k variant + if self.order == other.order: + return self.doc < other.doc + return self.order < other.order + + def __repr__(self): + return "OleItem: doc=%s, order=%d" % (repr(self.doc), self.order) + + +class RecordItem(build.OleItem, WritableItem): + order = 9 + typename = "RECORD" + + def __init__(self, typeInfo, typeAttr, doc=None, bForUser=1): + ## sys.stderr.write("Record %s: size %s\n" % (doc,typeAttr.cbSizeInstance)) + ## sys.stderr.write(" cVars = %s\n" % (typeAttr.cVars,)) + ## for i in range(typeAttr.cVars): + ## vdesc = typeInfo.GetVarDesc(i) + ## sys.stderr.write(" Var %d has value %s, type %d, desc=%s\n" % (i, vdesc.value, vdesc.varkind, vdesc.elemdescVar)) + ## sys.stderr.write(" Doc is %s\n" % (typeInfo.GetDocumentation(vdesc.memid),)) + + build.OleItem.__init__(self, doc) + self.clsid = typeAttr[0] + + def WriteClass(self, generator): + pass + + +# Given an enum, write all aliases for it. +# (no longer necessary for new style code, but still used for old code. +def WriteAliasesForItem(item, aliasItems, stream): + for alias in aliasItems.values(): + if item.doc and alias.aliasDoc and (alias.aliasDoc[0] == item.doc[0]): + alias.WriteAliasItem(aliasItems, stream) + + +class AliasItem(build.OleItem, WritableItem): + order = 2 + typename = "ALIAS" + + def __init__(self, typeinfo, attr, doc=None, bForUser=1): + build.OleItem.__init__(self, doc) + + ai = attr[14] + self.attr = attr + if type(ai) == type(()) and type(ai[1]) == type( + 0 + ): # XXX - This is a hack - why tuples? Need to resolve? + href = ai[1] + alinfo = typeinfo.GetRefTypeInfo(href) + self.aliasDoc = alinfo.GetDocumentation(-1) + self.aliasAttr = alinfo.GetTypeAttr() + else: + self.aliasDoc = None + self.aliasAttr = None + + def WriteAliasItem(self, aliasDict, stream): + # we could have been written as part of an alias dependency + if self.bWritten: + return + + if self.aliasDoc: + depName = self.aliasDoc[0] + if depName in aliasDict: + aliasDict[depName].WriteAliasItem(aliasDict, stream) + print(self.doc[0] + " = " + depName, file=stream) + else: + ai = self.attr[14] + if type(ai) == type(0): + try: + typeStr = mapVTToTypeString[ai] + print("# %s=%s" % (self.doc[0], typeStr), file=stream) + except KeyError: + print( + self.doc[0] + " = None # Can't convert alias info " + str(ai), + file=stream, + ) + print(file=stream) + self.bWritten = 1 + + +class EnumerationItem(build.OleItem, WritableItem): + order = 1 + typename = "ENUMERATION" + + def __init__(self, typeinfo, attr, doc=None, bForUser=1): + build.OleItem.__init__(self, doc) + + self.clsid = attr[0] + self.mapVars = {} + typeFlags = attr[11] + self.hidden = ( + typeFlags & pythoncom.TYPEFLAG_FHIDDEN + or typeFlags & pythoncom.TYPEFLAG_FRESTRICTED + ) + + for j in range(attr[7]): + vdesc = typeinfo.GetVarDesc(j) + name = typeinfo.GetNames(vdesc[0])[0] + self.mapVars[name] = build.MapEntry(vdesc) + + ## def WriteEnumerationHeaders(self, aliasItems, stream): + ## enumName = self.doc[0] + ## print >> stream "%s=constants # Compatibility with previous versions." % (enumName) + ## WriteAliasesForItem(self, aliasItems) + + def WriteEnumerationItems(self, stream): + num = 0 + enumName = self.doc[0] + # Write in name alpha order + names = list(self.mapVars.keys()) + names.sort() + for name in names: + entry = self.mapVars[name] + vdesc = entry.desc + if vdesc[4] == pythoncom.VAR_CONST: + val = vdesc[1] + + use = repr(val) + # Make sure the repr of the value is valid python syntax + # still could cause an error on import if it contains a module or type name + # not available in the global namespace + try: + compile(use, "", "eval") + except SyntaxError: + # At least add the repr as a string, so it can be investigated further + # Sanitize it, in case the repr contains its own quotes. (??? line breaks too ???) + use = use.replace('"', "'") + use = ( + '"' + + use + + '"' + + " # This VARIANT type cannot be converted automatically" + ) + print( + "\t%-30s=%-10s # from enum %s" + % (build.MakePublicAttributeName(name, True), use, enumName), + file=stream, + ) + num += 1 + return num + + +class VTableItem(build.VTableItem, WritableItem): + order = 4 + + def WriteClass(self, generator): + self.WriteVTableMap(generator) + self.bWritten = 1 + + def WriteVTableMap(self, generator): + stream = generator.file + print( + "%s_vtables_dispatch_ = %d" % (self.python_name, self.bIsDispatch), + file=stream, + ) + print("%s_vtables_ = [" % (self.python_name,), file=stream) + for v in self.vtableFuncs: + names, dispid, desc = v + assert desc.desckind == pythoncom.DESCKIND_FUNCDESC + arg_reprs = [] + # more hoops so we don't generate huge lines. + item_num = 0 + print("\t((", end=" ", file=stream) + for name in names: + print(repr(name), ",", end=" ", file=stream) + item_num = item_num + 1 + if item_num % 5 == 0: + print("\n\t\t\t", end=" ", file=stream) + print( + "), %d, (%r, %r, [" % (dispid, desc.memid, desc.scodeArray), + end=" ", + file=stream, + ) + for arg in desc.args: + item_num = item_num + 1 + if item_num % 5 == 0: + print("\n\t\t\t", end=" ", file=stream) + defval = build.MakeDefaultArgRepr(arg) + if arg[3] is None: + arg3_repr = None + else: + arg3_repr = repr(arg[3]) + print( + repr((arg[0], arg[1], defval, arg3_repr)), ",", end=" ", file=stream + ) + print("],", end=" ", file=stream) + print(repr(desc.funckind), ",", end=" ", file=stream) + print(repr(desc.invkind), ",", end=" ", file=stream) + print(repr(desc.callconv), ",", end=" ", file=stream) + print(repr(desc.cParamsOpt), ",", end=" ", file=stream) + print(repr(desc.oVft), ",", end=" ", file=stream) + print(repr(desc.rettype), ",", end=" ", file=stream) + print(repr(desc.wFuncFlags), ",", end=" ", file=stream) + print(")),", file=stream) + print("]", file=stream) + print(file=stream) + + +class DispatchItem(build.DispatchItem, WritableItem): + order = 3 + + def __init__(self, typeinfo, attr, doc=None): + build.DispatchItem.__init__(self, typeinfo, attr, doc) + self.type_attr = attr + self.coclass_clsid = None + + def WriteClass(self, generator): + if ( + not self.bIsDispatch + and not self.type_attr.typekind == pythoncom.TKIND_DISPATCH + ): + return + # This is pretty screwey - now we have vtable support we + # should probably rethink this (ie, maybe write both sides for sinks, etc) + if self.bIsSink: + self.WriteEventSinkClassHeader(generator) + self.WriteCallbackClassBody(generator) + else: + self.WriteClassHeader(generator) + self.WriteClassBody(generator) + print(file=generator.file) + self.bWritten = 1 + + def WriteClassHeader(self, generator): + generator.checkWriteDispatchBaseClass() + doc = self.doc + stream = generator.file + print("class " + self.python_name + "(DispatchBaseClass):", file=stream) + if doc[1]: + print("\t" + build._makeDocString(doc[1]), file=stream) + try: + progId = pythoncom.ProgIDFromCLSID(self.clsid) + print( + "\t# This class is creatable by the name '%s'" % (progId), file=stream + ) + except pythoncom.com_error: + pass + print("\tCLSID = " + repr(self.clsid), file=stream) + if self.coclass_clsid is None: + print("\tcoclass_clsid = None", file=stream) + else: + print("\tcoclass_clsid = " + repr(self.coclass_clsid), file=stream) + print(file=stream) + self.bWritten = 1 + + def WriteEventSinkClassHeader(self, generator): + generator.checkWriteEventBaseClass() + doc = self.doc + stream = generator.file + print("class " + self.python_name + ":", file=stream) + if doc[1]: + print("\t" + build._makeDocString(doc[1]), file=stream) + try: + progId = pythoncom.ProgIDFromCLSID(self.clsid) + print( + "\t# This class is creatable by the name '%s'" % (progId), file=stream + ) + except pythoncom.com_error: + pass + print("\tCLSID = CLSID_Sink = " + repr(self.clsid), file=stream) + if self.coclass_clsid is None: + print("\tcoclass_clsid = None", file=stream) + else: + print("\tcoclass_clsid = " + repr(self.coclass_clsid), file=stream) + print("\t_public_methods_ = [] # For COM Server support", file=stream) + WriteSinkEventMap(self, stream) + print(file=stream) + print("\tdef __init__(self, oobj = None):", file=stream) + print("\t\tif oobj is None:", file=stream) + print("\t\t\tself._olecp = None", file=stream) + print("\t\telse:", file=stream) + print("\t\t\timport win32com.server.util", file=stream) + print( + "\t\t\tfrom win32com.server.policy import EventHandlerPolicy", file=stream + ) + print( + "\t\t\tcpc=oobj._oleobj_.QueryInterface(pythoncom.IID_IConnectionPointContainer)", + file=stream, + ) + print("\t\t\tcp=cpc.FindConnectionPoint(self.CLSID_Sink)", file=stream) + print( + "\t\t\tcookie=cp.Advise(win32com.server.util.wrap(self, usePolicy=EventHandlerPolicy))", + file=stream, + ) + print("\t\t\tself._olecp,self._olecp_cookie = cp,cookie", file=stream) + print("\tdef __del__(self):", file=stream) + print("\t\ttry:", file=stream) + print("\t\t\tself.close()", file=stream) + print("\t\texcept pythoncom.com_error:", file=stream) + print("\t\t\tpass", file=stream) + print("\tdef close(self):", file=stream) + print("\t\tif self._olecp is not None:", file=stream) + print( + "\t\t\tcp,cookie,self._olecp,self._olecp_cookie = self._olecp,self._olecp_cookie,None,None", + file=stream, + ) + print("\t\t\tcp.Unadvise(cookie)", file=stream) + print("\tdef _query_interface_(self, iid):", file=stream) + print("\t\timport win32com.server.util", file=stream) + print( + "\t\tif iid==self.CLSID_Sink: return win32com.server.util.wrap(self)", + file=stream, + ) + print(file=stream) + self.bWritten = 1 + + def WriteCallbackClassBody(self, generator): + stream = generator.file + print("\t# Event Handlers", file=stream) + print( + "\t# If you create handlers, they should have the following prototypes:", + file=stream, + ) + for name, entry in ( + list(self.propMapGet.items()) + + list(self.propMapPut.items()) + + list(self.mapFuncs.items()) + ): + fdesc = entry.desc + methName = MakeEventMethodName(entry.names[0]) + print( + "#\tdef " + + methName + + "(self" + + build.BuildCallList( + fdesc, + entry.names, + "defaultNamedOptArg", + "defaultNamedNotOptArg", + "defaultUnnamedArg", + "pythoncom.Missing", + is_comment=True, + ) + + "):", + file=stream, + ) + if entry.doc and entry.doc[1]: + print("#\t\t" + build._makeDocString(entry.doc[1]), file=stream) + print(file=stream) + self.bWritten = 1 + + def WriteClassBody(self, generator): + stream = generator.file + # Write in alpha order. + names = list(self.mapFuncs.keys()) + names.sort() + specialItems = { + "count": None, + "item": None, + "value": None, + "_newenum": None, + } # If found, will end up with (entry, invoke_tupe) + itemCount = None + for name in names: + entry = self.mapFuncs[name] + assert entry.desc.desckind == pythoncom.DESCKIND_FUNCDESC + # skip [restricted] methods, unless it is the + # enumerator (which, being part of the "system", + # we know about and can use) + dispid = entry.desc.memid + if ( + entry.desc.wFuncFlags & pythoncom.FUNCFLAG_FRESTRICTED + and dispid != pythoncom.DISPID_NEWENUM + ): + continue + # If not accessible via IDispatch, then we can't use it here. + if entry.desc.funckind != pythoncom.FUNC_DISPATCH: + continue + if dispid == pythoncom.DISPID_VALUE: + lkey = "value" + elif dispid == pythoncom.DISPID_NEWENUM: + specialItems["_newenum"] = (entry, entry.desc.invkind, None) + continue # Dont build this one now! + else: + lkey = name.lower() + if ( + lkey in specialItems and specialItems[lkey] is None + ): # remember if a special one. + specialItems[lkey] = (entry, entry.desc.invkind, None) + if generator.bBuildHidden or not entry.hidden: + if entry.GetResultName(): + print("\t# Result is of type " + entry.GetResultName(), file=stream) + if entry.wasProperty: + print( + "\t# The method %s is actually a property, but must be used as a method to correctly pass the arguments" + % name, + file=stream, + ) + ret = self.MakeFuncMethod(entry, build.MakePublicAttributeName(name)) + for line in ret: + print(line, file=stream) + print("\t_prop_map_get_ = {", file=stream) + names = list(self.propMap.keys()) + names.sort() + for key in names: + entry = self.propMap[key] + if generator.bBuildHidden or not entry.hidden: + resultName = entry.GetResultName() + if resultName: + print( + "\t\t# Property '%s' is an object of type '%s'" + % (key, resultName), + file=stream, + ) + lkey = key.lower() + details = entry.desc + resultDesc = details[2] + argDesc = () + mapEntry = MakeMapLineEntry( + details.memid, + pythoncom.DISPATCH_PROPERTYGET, + resultDesc, + argDesc, + key, + entry.GetResultCLSIDStr(), + ) + + if details.memid == pythoncom.DISPID_VALUE: + lkey = "value" + elif details.memid == pythoncom.DISPID_NEWENUM: + lkey = "_newenum" + else: + lkey = key.lower() + if ( + lkey in specialItems and specialItems[lkey] is None + ): # remember if a special one. + specialItems[lkey] = ( + entry, + pythoncom.DISPATCH_PROPERTYGET, + mapEntry, + ) + # All special methods, except _newenum, are written + # "normally". This is a mess! + if details.memid == pythoncom.DISPID_NEWENUM: + continue + + print( + '\t\t"%s": %s,' % (build.MakePublicAttributeName(key), mapEntry), + file=stream, + ) + names = list(self.propMapGet.keys()) + names.sort() + for key in names: + entry = self.propMapGet[key] + if generator.bBuildHidden or not entry.hidden: + if entry.GetResultName(): + print( + "\t\t# Method '%s' returns object of type '%s'" + % (key, entry.GetResultName()), + file=stream, + ) + details = entry.desc + assert details.desckind == pythoncom.DESCKIND_FUNCDESC + lkey = key.lower() + argDesc = details[2] + resultDesc = details[8] + mapEntry = MakeMapLineEntry( + details[0], + pythoncom.DISPATCH_PROPERTYGET, + resultDesc, + argDesc, + key, + entry.GetResultCLSIDStr(), + ) + if details.memid == pythoncom.DISPID_VALUE: + lkey = "value" + elif details.memid == pythoncom.DISPID_NEWENUM: + lkey = "_newenum" + else: + lkey = key.lower() + if ( + lkey in specialItems and specialItems[lkey] is None + ): # remember if a special one. + specialItems[lkey] = ( + entry, + pythoncom.DISPATCH_PROPERTYGET, + mapEntry, + ) + # All special methods, except _newenum, are written + # "normally". This is a mess! + if details.memid == pythoncom.DISPID_NEWENUM: + continue + print( + '\t\t"%s": %s,' % (build.MakePublicAttributeName(key), mapEntry), + file=stream, + ) + + print("\t}", file=stream) + + print("\t_prop_map_put_ = {", file=stream) + # These are "Invoke" args + names = list(self.propMap.keys()) + names.sort() + for key in names: + entry = self.propMap[key] + if generator.bBuildHidden or not entry.hidden: + lkey = key.lower() + details = entry.desc + # If default arg is None, write an empty tuple + defArgDesc = build.MakeDefaultArgRepr(details[2]) + if defArgDesc is None: + defArgDesc = "" + else: + defArgDesc = defArgDesc + "," + print( + '\t\t"%s" : ((%s, LCID, %d, 0),(%s)),' + % ( + build.MakePublicAttributeName(key), + details[0], + pythoncom.DISPATCH_PROPERTYPUT, + defArgDesc, + ), + file=stream, + ) + + names = list(self.propMapPut.keys()) + names.sort() + for key in names: + entry = self.propMapPut[key] + if generator.bBuildHidden or not entry.hidden: + details = entry.desc + defArgDesc = MakeDefaultArgsForPropertyPut(details[2]) + print( + '\t\t"%s": ((%s, LCID, %d, 0),%s),' + % ( + build.MakePublicAttributeName(key), + details[0], + details[4], + defArgDesc, + ), + file=stream, + ) + print("\t}", file=stream) + + if specialItems["value"]: + entry, invoketype, propArgs = specialItems["value"] + if propArgs is None: + typename = "method" + ret = self.MakeFuncMethod(entry, "__call__") + else: + typename = "property" + ret = [ + "\tdef __call__(self):\n\t\treturn self._ApplyTypes_(*%s)" + % propArgs + ] + print( + "\t# Default %s for this class is '%s'" % (typename, entry.names[0]), + file=stream, + ) + for line in ret: + print(line, file=stream) + print("\tdef __str__(self, *args):", file=stream) + print("\t\treturn str(self.__call__(*args))", file=stream) + print("\tdef __int__(self, *args):", file=stream) + print("\t\treturn int(self.__call__(*args))", file=stream) + + # _NewEnum (DISPID_NEWENUM) does not appear in typelib for many office objects, + # but it can still be retrieved at runtime, so always create __iter__. + # Also, some of those same objects use 1-based indexing, causing the old-style + # __getitem__ iteration to fail for index 0 where the dynamic iteration succeeds. + if specialItems["_newenum"]: + enumEntry, invoketype, propArgs = specialItems["_newenum"] + assert enumEntry.desc.desckind == pythoncom.DESCKIND_FUNCDESC + invkind = enumEntry.desc.invkind + # ??? Wouldn't this be the resultCLSID for the iterator itself, rather than the resultCLSID + # for the result of each Next() call, which is what it's used for ??? + resultCLSID = enumEntry.GetResultCLSIDStr() + else: + invkind = pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET + resultCLSID = "None" + # If we dont have a good CLSID for the enum result, assume it is the same as the Item() method. + if resultCLSID == "None" and "Item" in self.mapFuncs: + resultCLSID = self.mapFuncs["Item"].GetResultCLSIDStr() + print("\tdef __iter__(self):", file=stream) + print('\t\t"Return a Python iterator for this object"', file=stream) + print("\t\ttry:", file=stream) + print( + "\t\t\tob = self._oleobj_.InvokeTypes(%d,LCID,%d,(13, 10),())" + % (pythoncom.DISPID_NEWENUM, invkind), + file=stream, + ) + print("\t\texcept pythoncom.error:", file=stream) + print( + '\t\t\traise TypeError("This object does not support enumeration")', + file=stream, + ) + # Iterator is wrapped as PyIEnumVariant, and each result of __next__ is Dispatch'ed if necessary + print( + "\t\treturn win32com.client.util.Iterator(ob, %s)" % resultCLSID, + file=stream, + ) + + if specialItems["item"]: + entry, invoketype, propArgs = specialItems["item"] + resultCLSID = entry.GetResultCLSIDStr() + print( + "\t#This class has Item property/method which allows indexed access with the object[key] syntax.", + file=stream, + ) + print( + "\t#Some objects will accept a string or other type of key in addition to integers.", + file=stream, + ) + print( + "\t#Note that many Office objects do not use zero-based indexing.", + file=stream, + ) + print("\tdef __getitem__(self, key):", file=stream) + print( + '\t\treturn self._get_good_object_(self._oleobj_.Invoke(*(%d, LCID, %d, 1, key)), "Item", %s)' + % (entry.desc.memid, invoketype, resultCLSID), + file=stream, + ) + + if specialItems["count"]: + entry, invoketype, propArgs = specialItems["count"] + if propArgs is None: + typename = "method" + ret = self.MakeFuncMethod(entry, "__len__") + else: + typename = "property" + ret = [ + "\tdef __len__(self):\n\t\treturn self._ApplyTypes_(*%s)" % propArgs + ] + print( + "\t#This class has Count() %s - allow len(ob) to provide this" + % (typename), + file=stream, + ) + for line in ret: + print(line, file=stream) + # Also include a __nonzero__ + print( + "\t#This class has a __len__ - this is needed so 'if object:' always returns TRUE.", + file=stream, + ) + print("\tdef __nonzero__(self):", file=stream) + print("\t\treturn True", file=stream) + + +class CoClassItem(build.OleItem, WritableItem): + order = 5 + typename = "COCLASS" + + def __init__(self, typeinfo, attr, doc=None, sources=[], interfaces=[], bForUser=1): + build.OleItem.__init__(self, doc) + self.clsid = attr[0] + self.sources = sources + self.interfaces = interfaces + self.bIsDispatch = 1 # Pretend it is so it is written to the class map. + + def WriteClass(self, generator): + generator.checkWriteCoClassBaseClass() + doc = self.doc + stream = generator.file + if generator.generate_type == GEN_DEMAND_CHILD: + # Some special imports we must setup. + referenced_items = [] + for ref, flag in self.sources: + referenced_items.append(ref) + for ref, flag in self.interfaces: + referenced_items.append(ref) + print("import sys", file=stream) + for ref in referenced_items: + print( + "__import__('%s.%s')" % (generator.base_mod_name, ref.python_name), + file=stream, + ) + print( + "%s = sys.modules['%s.%s'].%s" + % ( + ref.python_name, + generator.base_mod_name, + ref.python_name, + ref.python_name, + ), + file=stream, + ) + # And pretend we have written it - the name is now available as if we had! + ref.bWritten = 1 + try: + progId = pythoncom.ProgIDFromCLSID(self.clsid) + print("# This CoClass is known by the name '%s'" % (progId), file=stream) + except pythoncom.com_error: + pass + print( + "class %s(CoClassBaseClass): # A CoClass" % (self.python_name), file=stream + ) + if doc and doc[1]: + print("\t# " + doc[1], file=stream) + print("\tCLSID = %r" % (self.clsid,), file=stream) + print("\tcoclass_sources = [", file=stream) + defItem = None + for item, flag in self.sources: + if flag & pythoncom.IMPLTYPEFLAG_FDEFAULT: + defItem = item + # If we have written a Python class, reference the name - + # otherwise just the IID. + if item.bWritten: + key = item.python_name + else: + key = repr(str(item.clsid)) # really the iid. + print("\t\t%s," % (key), file=stream) + print("\t]", file=stream) + if defItem: + if defItem.bWritten: + defName = defItem.python_name + else: + defName = repr(str(defItem.clsid)) # really the iid. + print("\tdefault_source = %s" % (defName,), file=stream) + print("\tcoclass_interfaces = [", file=stream) + defItem = None + for item, flag in self.interfaces: + if flag & pythoncom.IMPLTYPEFLAG_FDEFAULT: # and dual: + defItem = item + # If we have written a class, reference its name, otherwise the IID + if item.bWritten: + key = item.python_name + else: + key = repr(str(item.clsid)) # really the iid. + print("\t\t%s," % (key,), file=stream) + print("\t]", file=stream) + if defItem: + if defItem.bWritten: + defName = defItem.python_name + else: + defName = repr(str(defItem.clsid)) # really the iid. + print("\tdefault_interface = %s" % (defName,), file=stream) + self.bWritten = 1 + print(file=stream) + + +class GeneratorProgress: + def __init__(self): + pass + + def Starting(self, tlb_desc): + """Called when the process starts.""" + self.tlb_desc = tlb_desc + + def Finished(self): + """Called when the process is complete.""" + + def SetDescription(self, desc, maxticks=None): + """We are entering a major step. If maxticks, then this + is how many ticks we expect to make until finished + """ + + def Tick(self, desc=None): + """Minor progress step. Can provide new description if necessary""" + + def VerboseProgress(self, desc): + """Verbose/Debugging output.""" + + def LogWarning(self, desc): + """If a warning is generated""" + + def LogBeginGenerate(self, filename): + pass + + def Close(self): + pass + + +class Generator: + def __init__( + self, + typelib, + sourceFilename, + progressObject, + bBuildHidden=1, + bUnicodeToString=None, + ): + assert bUnicodeToString is None, "this is deprecated and will go away" + self.bHaveWrittenDispatchBaseClass = 0 + self.bHaveWrittenCoClassBaseClass = 0 + self.bHaveWrittenEventBaseClass = 0 + self.typelib = typelib + self.sourceFilename = sourceFilename + self.bBuildHidden = bBuildHidden + self.progress = progressObject + # These 2 are later additions and most of the code still 'print's... + self.file = None + + def CollectOleItemInfosFromType(self): + ret = [] + for i in range(self.typelib.GetTypeInfoCount()): + info = self.typelib.GetTypeInfo(i) + infotype = self.typelib.GetTypeInfoType(i) + doc = self.typelib.GetDocumentation(i) + attr = info.GetTypeAttr() + ret.append((info, infotype, doc, attr)) + return ret + + def _Build_CoClass(self, type_info_tuple): + info, infotype, doc, attr = type_info_tuple + # find the source and dispinterfaces for the coclass + child_infos = [] + for j in range(attr[8]): + flags = info.GetImplTypeFlags(j) + try: + refType = info.GetRefTypeInfo(info.GetRefTypeOfImplType(j)) + except pythoncom.com_error: + # Can't load a dependent typelib? + continue + refAttr = refType.GetTypeAttr() + child_infos.append( + ( + info, + refAttr.typekind, + refType, + refType.GetDocumentation(-1), + refAttr, + flags, + ) + ) + + # Done generating children - now the CoClass itself. + newItem = CoClassItem(info, attr, doc) + return newItem, child_infos + + def _Build_CoClassChildren(self, coclass, coclass_info, oleItems, vtableItems): + sources = {} + interfaces = {} + for info, info_type, refType, doc, refAttr, flags in coclass_info: + # sys.stderr.write("Attr typeflags for coclass referenced object %s=%d (%d), typekind=%d\n" % (name, refAttr.wTypeFlags, refAttr.wTypeFlags & pythoncom.TYPEFLAG_FDUAL,refAttr.typekind)) + if refAttr.typekind == pythoncom.TKIND_DISPATCH or ( + refAttr.typekind == pythoncom.TKIND_INTERFACE + and refAttr[11] & pythoncom.TYPEFLAG_FDISPATCHABLE + ): + clsid = refAttr[0] + if clsid in oleItems: + dispItem = oleItems[clsid] + else: + dispItem = DispatchItem(refType, refAttr, doc) + oleItems[dispItem.clsid] = dispItem + dispItem.coclass_clsid = coclass.clsid + if flags & pythoncom.IMPLTYPEFLAG_FSOURCE: + dispItem.bIsSink = 1 + sources[dispItem.clsid] = (dispItem, flags) + else: + interfaces[dispItem.clsid] = (dispItem, flags) + # If dual interface, make do that too. + if clsid not in vtableItems and refAttr[11] & pythoncom.TYPEFLAG_FDUAL: + refType = refType.GetRefTypeInfo(refType.GetRefTypeOfImplType(-1)) + refAttr = refType.GetTypeAttr() + assert ( + refAttr.typekind == pythoncom.TKIND_INTERFACE + ), "must be interface bynow!" + vtableItem = VTableItem(refType, refAttr, doc) + vtableItems[clsid] = vtableItem + coclass.sources = list(sources.values()) + coclass.interfaces = list(interfaces.values()) + + def _Build_Interface(self, type_info_tuple): + info, infotype, doc, attr = type_info_tuple + oleItem = vtableItem = None + if infotype == pythoncom.TKIND_DISPATCH or ( + infotype == pythoncom.TKIND_INTERFACE + and attr[11] & pythoncom.TYPEFLAG_FDISPATCHABLE + ): + oleItem = DispatchItem(info, attr, doc) + # If this DISPATCH interface dual, then build that too. + if attr.wTypeFlags & pythoncom.TYPEFLAG_FDUAL: + # Get the vtable interface + refhtype = info.GetRefTypeOfImplType(-1) + info = info.GetRefTypeInfo(refhtype) + attr = info.GetTypeAttr() + infotype = pythoncom.TKIND_INTERFACE + else: + infotype = None + assert infotype in [ + None, + pythoncom.TKIND_INTERFACE, + ], "Must be a real interface at this point" + if infotype == pythoncom.TKIND_INTERFACE: + vtableItem = VTableItem(info, attr, doc) + return oleItem, vtableItem + + def BuildOleItemsFromType(self): + assert ( + self.bBuildHidden + ), "This code doesnt look at the hidden flag - I thought everyone set it true!?!?!" + oleItems = {} + enumItems = {} + recordItems = {} + vtableItems = {} + + for type_info_tuple in self.CollectOleItemInfosFromType(): + info, infotype, doc, attr = type_info_tuple + clsid = attr[0] + if infotype == pythoncom.TKIND_ENUM or infotype == pythoncom.TKIND_MODULE: + newItem = EnumerationItem(info, attr, doc) + enumItems[newItem.doc[0]] = newItem + # We never hide interfaces (MSAccess, for example, nominates interfaces as + # hidden, assuming that you only ever use them via the CoClass) + elif infotype in [pythoncom.TKIND_DISPATCH, pythoncom.TKIND_INTERFACE]: + if clsid not in oleItems: + oleItem, vtableItem = self._Build_Interface(type_info_tuple) + oleItems[clsid] = oleItem # Even "None" goes in here. + if vtableItem is not None: + vtableItems[clsid] = vtableItem + elif ( + infotype == pythoncom.TKIND_RECORD or infotype == pythoncom.TKIND_UNION + ): + newItem = RecordItem(info, attr, doc) + recordItems[newItem.clsid] = newItem + elif infotype == pythoncom.TKIND_ALIAS: + # We dont care about alias' - handled intrinsicly. + continue + elif infotype == pythoncom.TKIND_COCLASS: + newItem, child_infos = self._Build_CoClass(type_info_tuple) + self._Build_CoClassChildren(newItem, child_infos, oleItems, vtableItems) + oleItems[newItem.clsid] = newItem + else: + self.progress.LogWarning("Unknown TKIND found: %d" % infotype) + + return oleItems, enumItems, recordItems, vtableItems + + def open_writer(self, filename, encoding="mbcs"): + # A place to put code to open a file with the appropriate encoding. + # Does *not* set self.file - just opens and returns a file. + # Actually returns a handle to a temp file - finish_writer then deletes + # the filename asked for and puts everything back in place. This + # is so errors don't leave a 1/2 generated file around causing bizarre + # errors later, and so that multiple processes writing the same file + # don't step on each others' toes. + # Could be a classmethod one day... + temp_filename = self.get_temp_filename(filename) + return open(temp_filename, "wt", encoding=encoding) + + def finish_writer(self, filename, f, worked): + f.close() + try: + os.unlink(filename) + except os.error: + pass + temp_filename = self.get_temp_filename(filename) + if worked: + try: + os.rename(temp_filename, filename) + except os.error: + # If we are really unlucky, another process may have written the + # file in between our calls to os.unlink and os.rename. So try + # again, but only once. + # There are still some race conditions, but they seem difficult to + # fix, and they probably occur much less frequently: + # * The os.rename failure could occur more than once if more than + # two processes are involved. + # * In between os.unlink and os.rename, another process could try + # to import the module, having seen that it already exists. + # * If another process starts a COM server while we are still + # generating __init__.py, that process sees that the folder + # already exists and assumes that __init__.py is already there + # as well. + try: + os.unlink(filename) + except os.error: + pass + os.rename(temp_filename, filename) + else: + os.unlink(temp_filename) + + def get_temp_filename(self, filename): + return "%s.%d.temp" % (filename, os.getpid()) + + def generate(self, file, is_for_demand=0): + if is_for_demand: + self.generate_type = GEN_DEMAND_BASE + else: + self.generate_type = GEN_FULL + self.file = file + self.do_generate() + self.file = None + self.progress.Finished() + + def do_gen_file_header(self): + la = self.typelib.GetLibAttr() + moduleDoc = self.typelib.GetDocumentation(-1) + docDesc = "" + if moduleDoc[1]: + docDesc = moduleDoc[1] + + # Reset all the 'per file' state + self.bHaveWrittenDispatchBaseClass = 0 + self.bHaveWrittenCoClassBaseClass = 0 + self.bHaveWrittenEventBaseClass = 0 + # You must provide a file correctly configured for writing unicode. + # We assert this is it may indicate somewhere in pywin32 that needs + # upgrading. + assert self.file.encoding, self.file + encoding = self.file.encoding # or "mbcs" + + print("# -*- coding: %s -*-" % (encoding,), file=self.file) + print("# Created by makepy.py version %s" % (makepy_version,), file=self.file) + print( + "# By python version %s" % (sys.version.replace("\n", "-"),), file=self.file + ) + if self.sourceFilename: + print( + "# From type library '%s'" % (os.path.split(self.sourceFilename)[1],), + file=self.file, + ) + print("# On %s" % time.ctime(time.time()), file=self.file) + + print(build._makeDocString(docDesc), file=self.file) + + print("makepy_version =", repr(makepy_version), file=self.file) + print("python_version = 0x%x" % (sys.hexversion,), file=self.file) + print(file=self.file) + print( + "import win32com.client.CLSIDToClass, pythoncom, pywintypes", file=self.file + ) + print("import win32com.client.util", file=self.file) + print("from pywintypes import IID", file=self.file) + print("from win32com.client import Dispatch", file=self.file) + print(file=self.file) + print( + "# The following 3 lines may need tweaking for the particular server", + file=self.file, + ) + print( + "# Candidates are pythoncom.Missing, .Empty and .ArgNotFound", + file=self.file, + ) + print("defaultNamedOptArg=pythoncom.Empty", file=self.file) + print("defaultNamedNotOptArg=pythoncom.Empty", file=self.file) + print("defaultUnnamedArg=pythoncom.Empty", file=self.file) + print(file=self.file) + print("CLSID = " + repr(la[0]), file=self.file) + print("MajorVersion = " + str(la[3]), file=self.file) + print("MinorVersion = " + str(la[4]), file=self.file) + print("LibraryFlags = " + str(la[5]), file=self.file) + print("LCID = " + hex(la[1]), file=self.file) + print(file=self.file) + + def do_generate(self): + moduleDoc = self.typelib.GetDocumentation(-1) + stream = self.file + docDesc = "" + if moduleDoc[1]: + docDesc = moduleDoc[1] + self.progress.Starting(docDesc) + self.progress.SetDescription("Building definitions from type library...") + + self.do_gen_file_header() + + oleItems, enumItems, recordItems, vtableItems = self.BuildOleItemsFromType() + + self.progress.SetDescription( + "Generating...", len(oleItems) + len(enumItems) + len(vtableItems) + ) + + # Generate the constants and their support. + if enumItems: + print("class constants:", file=stream) + items = list(enumItems.values()) + items.sort() + num_written = 0 + for oleitem in items: + num_written += oleitem.WriteEnumerationItems(stream) + self.progress.Tick() + if not num_written: + print("\tpass", file=stream) + print(file=stream) + + if self.generate_type == GEN_FULL: + items = [l for l in oleItems.values() if l is not None] + items.sort() + for oleitem in items: + self.progress.Tick() + oleitem.WriteClass(self) + + items = list(vtableItems.values()) + items.sort() + for oleitem in items: + self.progress.Tick() + oleitem.WriteClass(self) + else: + self.progress.Tick(len(oleItems) + len(vtableItems)) + + print("RecordMap = {", file=stream) + for record in recordItems.values(): + if record.clsid == pythoncom.IID_NULL: + print( + "\t###%s: %s, # Record disabled because it doesn't have a non-null GUID" + % (repr(record.doc[0]), repr(str(record.clsid))), + file=stream, + ) + else: + print( + "\t%s: %s," % (repr(record.doc[0]), repr(str(record.clsid))), + file=stream, + ) + print("}", file=stream) + print(file=stream) + + # Write out _all_ my generated CLSID's in the map + if self.generate_type == GEN_FULL: + print("CLSIDToClassMap = {", file=stream) + for item in oleItems.values(): + if item is not None and item.bWritten: + print( + "\t'%s' : %s," % (str(item.clsid), item.python_name), + file=stream, + ) + print("}", file=stream) + print("CLSIDToPackageMap = {}", file=stream) + print( + "win32com.client.CLSIDToClass.RegisterCLSIDsFromDict( CLSIDToClassMap )", + file=stream, + ) + print("VTablesToPackageMap = {}", file=stream) + print("VTablesToClassMap = {", file=stream) + for item in vtableItems.values(): + print("\t'%s' : '%s'," % (item.clsid, item.python_name), file=stream) + print("}", file=stream) + print(file=stream) + + else: + print("CLSIDToClassMap = {}", file=stream) + print("CLSIDToPackageMap = {", file=stream) + for item in oleItems.values(): + if item is not None: + print( + "\t'%s' : %s," % (str(item.clsid), repr(item.python_name)), + file=stream, + ) + print("}", file=stream) + print("VTablesToClassMap = {}", file=stream) + print("VTablesToPackageMap = {", file=stream) + for item in vtableItems.values(): + print("\t'%s' : '%s'," % (item.clsid, item.python_name), file=stream) + print("}", file=stream) + print(file=stream) + + print(file=stream) + # Bit of a hack - build a temp map of iteItems + vtableItems - coClasses + map = {} + for item in oleItems.values(): + if item is not None and not isinstance(item, CoClassItem): + map[item.python_name] = item.clsid + for item in vtableItems.values(): # No nones or CoClasses in this map + map[item.python_name] = item.clsid + + print("NamesToIIDMap = {", file=stream) + for name, iid in map.items(): + print("\t'%s' : '%s'," % (name, iid), file=stream) + print("}", file=stream) + print(file=stream) + + if enumItems: + print( + "win32com.client.constants.__dicts__.append(constants.__dict__)", + file=stream, + ) + print(file=stream) + + def generate_child(self, child, dir): + "Generate a single child. May force a few children to be built as we generate deps" + self.generate_type = GEN_DEMAND_CHILD + + la = self.typelib.GetLibAttr() + lcid = la[1] + clsid = la[0] + major = la[3] + minor = la[4] + self.base_mod_name = ( + "win32com.gen_py." + str(clsid)[1:-1] + "x%sx%sx%s" % (lcid, major, minor) + ) + try: + # Process the type library's CoClass objects, looking for the + # specified name, or where a child has the specified name. + # This ensures that all interesting things (including event interfaces) + # are generated correctly. + oleItems = {} + vtableItems = {} + infos = self.CollectOleItemInfosFromType() + found = 0 + for type_info_tuple in infos: + info, infotype, doc, attr = type_info_tuple + if infotype == pythoncom.TKIND_COCLASS: + coClassItem, child_infos = self._Build_CoClass(type_info_tuple) + found = build.MakePublicAttributeName(doc[0]) == child + if not found: + # OK, check the child interfaces + for ( + info, + info_type, + refType, + doc, + refAttr, + flags, + ) in child_infos: + if build.MakePublicAttributeName(doc[0]) == child: + found = 1 + break + if found: + oleItems[coClassItem.clsid] = coClassItem + self._Build_CoClassChildren( + coClassItem, child_infos, oleItems, vtableItems + ) + break + if not found: + # Doesn't appear in a class defn - look in the interface objects for it + for type_info_tuple in infos: + info, infotype, doc, attr = type_info_tuple + if infotype in [ + pythoncom.TKIND_INTERFACE, + pythoncom.TKIND_DISPATCH, + ]: + if build.MakePublicAttributeName(doc[0]) == child: + found = 1 + oleItem, vtableItem = self._Build_Interface(type_info_tuple) + oleItems[clsid] = oleItem # Even "None" goes in here. + if vtableItem is not None: + vtableItems[clsid] = vtableItem + + assert ( + found + ), "Cant find the '%s' interface in the CoClasses, or the interfaces" % ( + child, + ) + # Make a map of iid: dispitem, vtableitem) + items = {} + for key, value in oleItems.items(): + items[key] = (value, None) + for key, value in vtableItems.items(): + existing = items.get(key, None) + if existing is not None: + new_val = existing[0], value + else: + new_val = None, value + items[key] = new_val + + self.progress.SetDescription("Generating...", len(items)) + for oleitem, vtableitem in items.values(): + an_item = oleitem or vtableitem + assert not self.file, "already have a file?" + # like makepy.py, we gen to a .temp file so failure doesn't + # leave a 1/2 generated mess. + out_name = os.path.join(dir, an_item.python_name) + ".py" + worked = False + self.file = self.open_writer(out_name) + try: + if oleitem is not None: + self.do_gen_child_item(oleitem) + if vtableitem is not None: + self.do_gen_child_item(vtableitem) + self.progress.Tick() + worked = True + finally: + self.finish_writer(out_name, self.file, worked) + self.file = None + finally: + self.progress.Finished() + + def do_gen_child_item(self, oleitem): + moduleDoc = self.typelib.GetDocumentation(-1) + docDesc = "" + if moduleDoc[1]: + docDesc = moduleDoc[1] + self.progress.Starting(docDesc) + self.progress.SetDescription("Building definitions from type library...") + self.do_gen_file_header() + oleitem.WriteClass(self) + if oleitem.bWritten: + print( + 'win32com.client.CLSIDToClass.RegisterCLSID( "%s", %s )' + % (oleitem.clsid, oleitem.python_name), + file=self.file, + ) + + def checkWriteDispatchBaseClass(self): + if not self.bHaveWrittenDispatchBaseClass: + print("from win32com.client import DispatchBaseClass", file=self.file) + self.bHaveWrittenDispatchBaseClass = 1 + + def checkWriteCoClassBaseClass(self): + if not self.bHaveWrittenCoClassBaseClass: + print("from win32com.client import CoClassBaseClass", file=self.file) + self.bHaveWrittenCoClassBaseClass = 1 + + def checkWriteEventBaseClass(self): + # Not a base class as such... + if not self.bHaveWrittenEventBaseClass: + # Nothing to do any more! + self.bHaveWrittenEventBaseClass = 1 + + +if __name__ == "__main__": + print("This is a worker module. Please use makepy to generate Python files.") diff --git a/lib/win32com/client/makepy.py b/lib/win32com/client/makepy.py new file mode 100644 index 00000000..041f18a4 --- /dev/null +++ b/lib/win32com/client/makepy.py @@ -0,0 +1,459 @@ +# Originally written by Curt Hagenlocher, and various bits +# and pieces by Mark Hammond (and now Greg Stein has had +# a go too :-) + +# Note that the main worker code has been moved to genpy.py +# As this is normally run from the command line, it reparses the code each time. +# Now this is nothing more than the command line handler and public interface. + +# XXX - TO DO +# XXX - Greg and Mark have some ideas for a revamp - just no +# time - if you want to help, contact us for details. +# Main idea is to drop the classes exported and move to a more +# traditional data driven model. + +"""Generate a .py file from an OLE TypeLibrary file. + + + This module is concerned only with the actual writing of + a .py file. It draws on the @build@ module, which builds + the knowledge of a COM interface. + +""" +usageHelp = """ \ + +Usage: + + makepy.py [-i] [-v|q] [-h] [-u] [-o output_file] [-d] [typelib, ...] + + -i -- Show information for the specified typelib. + + -v -- Verbose output. + + -q -- Quiet output. + + -h -- Do not generate hidden methods. + + -u -- Python 1.5 and earlier: Do NOT convert all Unicode objects to + strings. + + Python 1.6 and later: Convert all Unicode objects to strings. + + -o -- Create output in a specified output file. If the path leading + to the file does not exist, any missing directories will be + created. + NOTE: -o cannot be used with -d. This will generate an error. + + -d -- Generate the base code now and the class code on demand. + Recommended for large type libraries. + + typelib -- A TLB, DLL, OCX or anything containing COM type information. + If a typelib is not specified, a window containing a textbox + will open from which you can select a registered type + library. + +Examples: + + makepy.py -d + + Presents a list of registered type libraries from which you can make + a selection. + + makepy.py -d "Microsoft Excel 8.0 Object Library" + + Generate support for the type library with the specified description + (in this case, the MS Excel object model). + +""" + +import importlib +import os +import sys + +import pythoncom +from win32com.client import Dispatch, gencache, genpy, selecttlb + +bForDemandDefault = 0 # Default value of bForDemand - toggle this to change the world - see also gencache.py + +error = "makepy.error" + + +def usage(): + sys.stderr.write(usageHelp) + sys.exit(2) + + +def ShowInfo(spec): + if not spec: + tlbSpec = selecttlb.SelectTlb(excludeFlags=selecttlb.FLAG_HIDDEN) + if tlbSpec is None: + return + try: + tlb = pythoncom.LoadRegTypeLib( + tlbSpec.clsid, tlbSpec.major, tlbSpec.minor, tlbSpec.lcid + ) + except pythoncom.com_error: # May be badly registered. + sys.stderr.write( + "Warning - could not load registered typelib '%s'\n" % (tlbSpec.clsid) + ) + tlb = None + + infos = [(tlb, tlbSpec)] + else: + infos = GetTypeLibsForSpec(spec) + for tlb, tlbSpec in infos: + desc = tlbSpec.desc + if desc is None: + if tlb is None: + desc = "" % (tlbSpec.dll) + else: + desc = tlb.GetDocumentation(-1)[0] + print(desc) + print( + " %s, lcid=%s, major=%s, minor=%s" + % (tlbSpec.clsid, tlbSpec.lcid, tlbSpec.major, tlbSpec.minor) + ) + print(" >>> # Use these commands in Python code to auto generate .py support") + print(" >>> from win32com.client import gencache") + print( + " >>> gencache.EnsureModule('%s', %s, %s, %s)" + % (tlbSpec.clsid, tlbSpec.lcid, tlbSpec.major, tlbSpec.minor) + ) + + +class SimpleProgress(genpy.GeneratorProgress): + """A simple progress class prints its output to stderr""" + + def __init__(self, verboseLevel): + self.verboseLevel = verboseLevel + + def Close(self): + pass + + def Finished(self): + if self.verboseLevel > 1: + sys.stderr.write("Generation complete..\n") + + def SetDescription(self, desc, maxticks=None): + if self.verboseLevel: + sys.stderr.write(desc + "\n") + + def Tick(self, desc=None): + pass + + def VerboseProgress(self, desc, verboseLevel=2): + if self.verboseLevel >= verboseLevel: + sys.stderr.write(desc + "\n") + + def LogBeginGenerate(self, filename): + self.VerboseProgress("Generating to %s" % filename, 1) + + def LogWarning(self, desc): + self.VerboseProgress("WARNING: " + desc, 1) + + +class GUIProgress(SimpleProgress): + def __init__(self, verboseLevel): + # Import some modules we need to we can trap failure now. + import pywin # nopycln: import + import win32ui + + SimpleProgress.__init__(self, verboseLevel) + self.dialog = None + + def Close(self): + if self.dialog is not None: + self.dialog.Close() + self.dialog = None + + def Starting(self, tlb_desc): + SimpleProgress.Starting(self, tlb_desc) + if self.dialog is None: + from pywin.dialogs import status + + self.dialog = status.ThreadedStatusProgressDialog(tlb_desc) + else: + self.dialog.SetTitle(tlb_desc) + + def SetDescription(self, desc, maxticks=None): + self.dialog.SetText(desc) + if maxticks: + self.dialog.SetMaxTicks(maxticks) + + def Tick(self, desc=None): + self.dialog.Tick() + if desc is not None: + self.dialog.SetText(desc) + + +def GetTypeLibsForSpec(arg): + """Given an argument on the command line (either a file name, library + description, or ProgID of an object) return a list of actual typelibs + to use.""" + typelibs = [] + try: + try: + tlb = pythoncom.LoadTypeLib(arg) + spec = selecttlb.TypelibSpec(None, 0, 0, 0) + spec.FromTypelib(tlb, arg) + typelibs.append((tlb, spec)) + except pythoncom.com_error: + # See if it is a description + tlbs = selecttlb.FindTlbsWithDescription(arg) + if len(tlbs) == 0: + # Maybe it is the name of a COM object? + try: + ob = Dispatch(arg) + # and if so, it must support typelib info + tlb, index = ob._oleobj_.GetTypeInfo().GetContainingTypeLib() + spec = selecttlb.TypelibSpec(None, 0, 0, 0) + spec.FromTypelib(tlb) + tlbs.append(spec) + except pythoncom.com_error: + pass + if len(tlbs) == 0: + print("Could not locate a type library matching '%s'" % (arg)) + for spec in tlbs: + # Version numbers not always reliable if enumerated from registry. + # (as some libs use hex, other's dont. Both examples from MS, of course.) + if spec.dll is None: + tlb = pythoncom.LoadRegTypeLib( + spec.clsid, spec.major, spec.minor, spec.lcid + ) + else: + tlb = pythoncom.LoadTypeLib(spec.dll) + + # We have a typelib, but it may not be exactly what we specified + # (due to automatic version matching of COM). So we query what we really have! + attr = tlb.GetLibAttr() + spec.major = attr[3] + spec.minor = attr[4] + spec.lcid = attr[1] + typelibs.append((tlb, spec)) + return typelibs + except pythoncom.com_error: + t, v, tb = sys.exc_info() + sys.stderr.write("Unable to load type library from '%s' - %s\n" % (arg, v)) + tb = None # Storing tb in a local is a cycle! + sys.exit(1) + + +def GenerateFromTypeLibSpec( + typelibInfo, + file=None, + verboseLevel=None, + progressInstance=None, + bUnicodeToString=None, + bForDemand=bForDemandDefault, + bBuildHidden=1, +): + assert bUnicodeToString is None, "this is deprecated and will go away" + if verboseLevel is None: + verboseLevel = 0 # By default, we use no gui and no verbose level! + + if bForDemand and file is not None: + raise RuntimeError( + "You can only perform a demand-build when the output goes to the gen_py directory" + ) + if isinstance(typelibInfo, tuple): + # Tuple + typelibCLSID, lcid, major, minor = typelibInfo + tlb = pythoncom.LoadRegTypeLib(typelibCLSID, major, minor, lcid) + spec = selecttlb.TypelibSpec(typelibCLSID, lcid, major, minor) + spec.FromTypelib(tlb, str(typelibCLSID)) + typelibs = [(tlb, spec)] + elif isinstance(typelibInfo, selecttlb.TypelibSpec): + if typelibInfo.dll is None: + # Version numbers not always reliable if enumerated from registry. + tlb = pythoncom.LoadRegTypeLib( + typelibInfo.clsid, + typelibInfo.major, + typelibInfo.minor, + typelibInfo.lcid, + ) + else: + tlb = pythoncom.LoadTypeLib(typelibInfo.dll) + typelibs = [(tlb, typelibInfo)] + elif hasattr(typelibInfo, "GetLibAttr"): + # A real typelib object! + # Could also use isinstance(typelibInfo, PyITypeLib) instead, but PyITypeLib is not directly exposed by pythoncom. + # pythoncom.TypeIIDs[pythoncom.IID_ITypeLib] seems to work + tla = typelibInfo.GetLibAttr() + guid = tla[0] + lcid = tla[1] + major = tla[3] + minor = tla[4] + spec = selecttlb.TypelibSpec(guid, lcid, major, minor) + typelibs = [(typelibInfo, spec)] + else: + typelibs = GetTypeLibsForSpec(typelibInfo) + + if progressInstance is None: + progressInstance = SimpleProgress(verboseLevel) + progress = progressInstance + + bToGenDir = file is None + + for typelib, info in typelibs: + gen = genpy.Generator(typelib, info.dll, progress, bBuildHidden=bBuildHidden) + + if file is None: + this_name = gencache.GetGeneratedFileName( + info.clsid, info.lcid, info.major, info.minor + ) + full_name = os.path.join(gencache.GetGeneratePath(), this_name) + if bForDemand: + try: + os.unlink(full_name + ".py") + except os.error: + pass + try: + os.unlink(full_name + ".pyc") + except os.error: + pass + try: + os.unlink(full_name + ".pyo") + except os.error: + pass + if not os.path.isdir(full_name): + os.mkdir(full_name) + outputName = os.path.join(full_name, "__init__.py") + else: + outputName = full_name + ".py" + fileUse = gen.open_writer(outputName) + progress.LogBeginGenerate(outputName) + else: + fileUse = file + + worked = False + try: + gen.generate(fileUse, bForDemand) + worked = True + finally: + if file is None: + gen.finish_writer(outputName, fileUse, worked) + importlib.invalidate_caches() + if bToGenDir: + progress.SetDescription("Importing module") + gencache.AddModuleToCache(info.clsid, info.lcid, info.major, info.minor) + + progress.Close() + + +def GenerateChildFromTypeLibSpec( + child, typelibInfo, verboseLevel=None, progressInstance=None, bUnicodeToString=None +): + assert bUnicodeToString is None, "this is deprecated and will go away" + if verboseLevel is None: + verboseLevel = ( + 0 # By default, we use no gui, and no verbose level for the children. + ) + if type(typelibInfo) == type(()): + typelibCLSID, lcid, major, minor = typelibInfo + tlb = pythoncom.LoadRegTypeLib(typelibCLSID, major, minor, lcid) + else: + tlb = typelibInfo + tla = typelibInfo.GetLibAttr() + typelibCLSID = tla[0] + lcid = tla[1] + major = tla[3] + minor = tla[4] + spec = selecttlb.TypelibSpec(typelibCLSID, lcid, major, minor) + spec.FromTypelib(tlb, str(typelibCLSID)) + typelibs = [(tlb, spec)] + + if progressInstance is None: + progressInstance = SimpleProgress(verboseLevel) + progress = progressInstance + + for typelib, info in typelibs: + dir_name = gencache.GetGeneratedFileName( + info.clsid, info.lcid, info.major, info.minor + ) + dir_path_name = os.path.join(gencache.GetGeneratePath(), dir_name) + progress.LogBeginGenerate(dir_path_name) + + gen = genpy.Generator(typelib, info.dll, progress) + gen.generate_child(child, dir_path_name) + progress.SetDescription("Importing module") + importlib.invalidate_caches() + __import__("win32com.gen_py." + dir_name + "." + child) + progress.Close() + + +def main(): + import getopt + + hiddenSpec = 1 + outputName = None + verboseLevel = 1 + doit = 1 + bForDemand = bForDemandDefault + try: + opts, args = getopt.getopt(sys.argv[1:], "vo:huiqd") + for o, v in opts: + if o == "-h": + hiddenSpec = 0 + elif o == "-o": + outputName = v + elif o == "-v": + verboseLevel = verboseLevel + 1 + elif o == "-q": + verboseLevel = verboseLevel - 1 + elif o == "-i": + if len(args) == 0: + ShowInfo(None) + else: + for arg in args: + ShowInfo(arg) + doit = 0 + elif o == "-d": + bForDemand = not bForDemand + + except (getopt.error, error) as msg: + sys.stderr.write(str(msg) + "\n") + usage() + + if bForDemand and outputName is not None: + sys.stderr.write("Can not use -d and -o together\n") + usage() + + if not doit: + return 0 + if len(args) == 0: + rc = selecttlb.SelectTlb() + if rc is None: + sys.exit(1) + args = [rc] + + if outputName is not None: + path = os.path.dirname(outputName) + if path != "" and not os.path.exists(path): + os.makedirs(path) + if sys.version_info > (3, 0): + f = open(outputName, "wt", encoding="mbcs") + else: + import codecs # not available in py3k. + + f = codecs.open(outputName, "w", "mbcs") + else: + f = None + + for arg in args: + GenerateFromTypeLibSpec( + arg, + f, + verboseLevel=verboseLevel, + bForDemand=bForDemand, + bBuildHidden=hiddenSpec, + ) + + if f: + f.close() + + +if __name__ == "__main__": + rc = main() + if rc: + sys.exit(rc) + sys.exit(0) diff --git a/lib/win32com/client/selecttlb.py b/lib/win32com/client/selecttlb.py new file mode 100644 index 00000000..bb21a429 --- /dev/null +++ b/lib/win32com/client/selecttlb.py @@ -0,0 +1,183 @@ +"""Utilities for selecting and enumerating the Type Libraries installed on the system +""" + +import pythoncom +import win32api +import win32con + + +class TypelibSpec: + def __init__(self, clsid, lcid, major, minor, flags=0): + self.clsid = str(clsid) + self.lcid = int(lcid) + # We avoid assuming 'major' or 'minor' are integers - when + # read from the registry there is some confusion about if + # they are base 10 or base 16 (they *should* be base 16, but + # how they are written is beyond our control.) + self.major = major + self.minor = minor + self.dll = None + self.desc = None + self.ver_desc = None + self.flags = flags + + # For the SelectList + def __getitem__(self, item): + if item == 0: + return self.ver_desc + raise IndexError("Cant index me!") + + def __lt__(self, other): # rich-cmp/py3k-friendly version + me = ( + (self.ver_desc or "").lower(), + (self.desc or "").lower(), + self.major, + self.minor, + ) + them = ( + (other.ver_desc or "").lower(), + (other.desc or "").lower(), + other.major, + other.minor, + ) + return me < them + + def __eq__(self, other): # rich-cmp/py3k-friendly version + return ( + (self.ver_desc or "").lower() == (other.ver_desc or "").lower() + and (self.desc or "").lower() == (other.desc or "").lower() + and self.major == other.major + and self.minor == other.minor + ) + + def Resolve(self): + if self.dll is None: + return 0 + tlb = pythoncom.LoadTypeLib(self.dll) + self.FromTypelib(tlb, None) + return 1 + + def FromTypelib(self, typelib, dllName=None): + la = typelib.GetLibAttr() + self.clsid = str(la[0]) + self.lcid = la[1] + self.major = la[3] + self.minor = la[4] + if dllName: + self.dll = dllName + + +def EnumKeys(root): + index = 0 + ret = [] + while 1: + try: + item = win32api.RegEnumKey(root, index) + except win32api.error: + break + try: + # Note this doesn't handle REG_EXPAND_SZ, but the implementation + # here doesn't need to - that is handled as the data is read. + val = win32api.RegQueryValue(root, item) + except win32api.error: + val = "" # code using this assumes a string. + + ret.append((item, val)) + index = index + 1 + return ret + + +FLAG_RESTRICTED = 1 +FLAG_CONTROL = 2 +FLAG_HIDDEN = 4 + + +def EnumTlbs(excludeFlags=0): + """Return a list of TypelibSpec objects, one for each registered library.""" + key = win32api.RegOpenKey(win32con.HKEY_CLASSES_ROOT, "Typelib") + iids = EnumKeys(key) + results = [] + for iid, crap in iids: + try: + key2 = win32api.RegOpenKey(key, str(iid)) + except win32api.error: + # A few good reasons for this, including "access denied". + continue + for version, tlbdesc in EnumKeys(key2): + major_minor = version.split(".", 1) + if len(major_minor) < 2: + major_minor.append("0") + # For some reason, this code used to assume the values were hex. + # This seems to not be true - particularly for CDO 1.21 + # *sigh* - it appears there are no rules here at all, so when we need + # to know the info, we must load the tlb by filename and request it. + # The Resolve() method on the TypelibSpec does this. + # For this reason, keep the version numbers as strings - that + # way we can't be wrong! Let code that really needs an int to work + # out what to do. FWIW, http://support.microsoft.com/kb/816970 is + # pretty clear that they *should* be hex. + major = major_minor[0] + minor = major_minor[1] + key3 = win32api.RegOpenKey(key2, str(version)) + try: + # The "FLAGS" are at this point + flags = int(win32api.RegQueryValue(key3, "FLAGS")) + except (win32api.error, ValueError): + flags = 0 + if flags & excludeFlags == 0: + for lcid, crap in EnumKeys(key3): + try: + lcid = int(lcid) + except ValueError: # not an LCID entry + continue + # Check for both "{lcid}\win32" and "{lcid}\win64" keys. + try: + key4 = win32api.RegOpenKey(key3, "%s\\win32" % (lcid,)) + except win32api.error: + try: + key4 = win32api.RegOpenKey(key3, "%s\\win64" % (lcid,)) + except win32api.error: + continue + try: + dll, typ = win32api.RegQueryValueEx(key4, None) + if typ == win32con.REG_EXPAND_SZ: + dll = win32api.ExpandEnvironmentStrings(dll) + except win32api.error: + dll = None + spec = TypelibSpec(iid, lcid, major, minor, flags) + spec.dll = dll + spec.desc = tlbdesc + spec.ver_desc = tlbdesc + " (" + version + ")" + results.append(spec) + return results + + +def FindTlbsWithDescription(desc): + """Find all installed type libraries with the specified description""" + ret = [] + items = EnumTlbs() + for item in items: + if item.desc == desc: + ret.append(item) + return ret + + +def SelectTlb(title="Select Library", excludeFlags=0): + """Display a list of all the type libraries, and select one. Returns None if cancelled""" + import pywin.dialogs.list + + items = EnumTlbs(excludeFlags) + # fixup versions - we assume hex (see __init__ above) + for i in items: + i.major = int(i.major, 16) + i.minor = int(i.minor, 16) + items.sort() + rc = pywin.dialogs.list.SelectFromLists(title, items, ["Type Library"]) + if rc is None: + return None + return items[rc] + + +# Test code. +if __name__ == "__main__": + print(SelectTlb().__dict__) diff --git a/lib/win32com/client/tlbrowse.py b/lib/win32com/client/tlbrowse.py new file mode 100644 index 00000000..acc00281 --- /dev/null +++ b/lib/win32com/client/tlbrowse.py @@ -0,0 +1,279 @@ +import commctrl +import pythoncom +import win32api +import win32con +import win32ui +from pywin.mfc import dialog + + +class TLBrowserException(Exception): + "TypeLib browser internal error" + + +error = TLBrowserException + +FRAMEDLG_STD = win32con.WS_CAPTION | win32con.WS_SYSMENU +SS_STD = win32con.WS_CHILD | win32con.WS_VISIBLE +BS_STD = SS_STD | win32con.WS_TABSTOP +ES_STD = BS_STD | win32con.WS_BORDER +LBS_STD = ( + ES_STD | win32con.LBS_NOTIFY | win32con.LBS_NOINTEGRALHEIGHT | win32con.WS_VSCROLL +) +CBS_STD = ES_STD | win32con.CBS_NOINTEGRALHEIGHT | win32con.WS_VSCROLL + +typekindmap = { + pythoncom.TKIND_ENUM: "Enumeration", + pythoncom.TKIND_RECORD: "Record", + pythoncom.TKIND_MODULE: "Module", + pythoncom.TKIND_INTERFACE: "Interface", + pythoncom.TKIND_DISPATCH: "Dispatch", + pythoncom.TKIND_COCLASS: "CoClass", + pythoncom.TKIND_ALIAS: "Alias", + pythoncom.TKIND_UNION: "Union", +} + +TypeBrowseDialog_Parent = dialog.Dialog + + +class TypeBrowseDialog(TypeBrowseDialog_Parent): + "Browse a type library" + + IDC_TYPELIST = 1000 + IDC_MEMBERLIST = 1001 + IDC_PARAMLIST = 1002 + IDC_LISTVIEW = 1003 + + def __init__(self, typefile=None): + TypeBrowseDialog_Parent.__init__(self, self.GetTemplate()) + try: + if typefile: + self.tlb = pythoncom.LoadTypeLib(typefile) + else: + self.tlb = None + except pythoncom.ole_error: + self.MessageBox("The file does not contain type information") + self.tlb = None + self.HookCommand(self.CmdTypeListbox, self.IDC_TYPELIST) + self.HookCommand(self.CmdMemberListbox, self.IDC_MEMBERLIST) + + def OnAttachedObjectDeath(self): + self.tlb = None + self.typeinfo = None + self.attr = None + return TypeBrowseDialog_Parent.OnAttachedObjectDeath(self) + + def _SetupMenu(self): + menu = win32ui.CreateMenu() + flags = win32con.MF_STRING | win32con.MF_ENABLED + menu.AppendMenu(flags, win32ui.ID_FILE_OPEN, "&Open...") + menu.AppendMenu(flags, win32con.IDCANCEL, "&Close") + mainMenu = win32ui.CreateMenu() + mainMenu.AppendMenu(flags | win32con.MF_POPUP, menu.GetHandle(), "&File") + self.SetMenu(mainMenu) + self.HookCommand(self.OnFileOpen, win32ui.ID_FILE_OPEN) + + def OnFileOpen(self, id, code): + openFlags = win32con.OFN_OVERWRITEPROMPT | win32con.OFN_FILEMUSTEXIST + fspec = "Type Libraries (*.tlb, *.olb)|*.tlb;*.olb|OCX Files (*.ocx)|*.ocx|DLL's (*.dll)|*.dll|All Files (*.*)|*.*||" + dlg = win32ui.CreateFileDialog(1, None, None, openFlags, fspec) + if dlg.DoModal() == win32con.IDOK: + try: + self.tlb = pythoncom.LoadTypeLib(dlg.GetPathName()) + except pythoncom.ole_error: + self.MessageBox("The file does not contain type information") + self.tlb = None + self._SetupTLB() + + def OnInitDialog(self): + self._SetupMenu() + self.typelb = self.GetDlgItem(self.IDC_TYPELIST) + self.memberlb = self.GetDlgItem(self.IDC_MEMBERLIST) + self.paramlb = self.GetDlgItem(self.IDC_PARAMLIST) + self.listview = self.GetDlgItem(self.IDC_LISTVIEW) + + # Setup the listview columns + itemDetails = (commctrl.LVCFMT_LEFT, 100, "Item", 0) + self.listview.InsertColumn(0, itemDetails) + itemDetails = (commctrl.LVCFMT_LEFT, 1024, "Details", 0) + self.listview.InsertColumn(1, itemDetails) + + if self.tlb is None: + self.OnFileOpen(None, None) + else: + self._SetupTLB() + return TypeBrowseDialog_Parent.OnInitDialog(self) + + def _SetupTLB(self): + self.typelb.ResetContent() + self.memberlb.ResetContent() + self.paramlb.ResetContent() + self.typeinfo = None + self.attr = None + if self.tlb is None: + return + n = self.tlb.GetTypeInfoCount() + for i in range(n): + self.typelb.AddString(self.tlb.GetDocumentation(i)[0]) + + def _SetListviewTextItems(self, items): + self.listview.DeleteAllItems() + index = -1 + for item in items: + index = self.listview.InsertItem(index + 1, item[0]) + data = item[1] + if data is None: + data = "" + self.listview.SetItemText(index, 1, data) + + def SetupAllInfoTypes(self): + infos = self._GetMainInfoTypes() + self._GetMethodInfoTypes() + self._SetListviewTextItems(infos) + + def _GetMainInfoTypes(self): + pos = self.typelb.GetCurSel() + if pos < 0: + return [] + docinfo = self.tlb.GetDocumentation(pos) + infos = [("GUID", str(self.attr[0]))] + infos.append(("Help File", docinfo[3])) + infos.append(("Help Context", str(docinfo[2]))) + try: + infos.append(("Type Kind", typekindmap[self.tlb.GetTypeInfoType(pos)])) + except: + pass + + info = self.tlb.GetTypeInfo(pos) + attr = info.GetTypeAttr() + infos.append(("Attributes", str(attr))) + + for j in range(attr[8]): + flags = info.GetImplTypeFlags(j) + refInfo = info.GetRefTypeInfo(info.GetRefTypeOfImplType(j)) + doc = refInfo.GetDocumentation(-1) + attr = refInfo.GetTypeAttr() + typeKind = attr[5] + typeFlags = attr[11] + + desc = doc[0] + desc = desc + ", Flags=0x%x, typeKind=0x%x, typeFlags=0x%x" % ( + flags, + typeKind, + typeFlags, + ) + if flags & pythoncom.IMPLTYPEFLAG_FSOURCE: + desc = desc + "(Source)" + infos.append(("Implements", desc)) + + return infos + + def _GetMethodInfoTypes(self): + pos = self.memberlb.GetCurSel() + if pos < 0: + return [] + + realPos, isMethod = self._GetRealMemberPos(pos) + ret = [] + if isMethod: + funcDesc = self.typeinfo.GetFuncDesc(realPos) + id = funcDesc[0] + ret.append(("Func Desc", str(funcDesc))) + else: + id = self.typeinfo.GetVarDesc(realPos)[0] + + docinfo = self.typeinfo.GetDocumentation(id) + ret.append(("Help String", docinfo[1])) + ret.append(("Help Context", str(docinfo[2]))) + return ret + + def CmdTypeListbox(self, id, code): + if code == win32con.LBN_SELCHANGE: + pos = self.typelb.GetCurSel() + if pos >= 0: + self.memberlb.ResetContent() + self.typeinfo = self.tlb.GetTypeInfo(pos) + self.attr = self.typeinfo.GetTypeAttr() + for i in range(self.attr[7]): + id = self.typeinfo.GetVarDesc(i)[0] + self.memberlb.AddString(self.typeinfo.GetNames(id)[0]) + for i in range(self.attr[6]): + id = self.typeinfo.GetFuncDesc(i)[0] + self.memberlb.AddString(self.typeinfo.GetNames(id)[0]) + self.SetupAllInfoTypes() + return 1 + + def _GetRealMemberPos(self, pos): + pos = self.memberlb.GetCurSel() + if pos >= self.attr[7]: + return pos - self.attr[7], 1 + elif pos >= 0: + return pos, 0 + else: + raise error("The position is not valid") + + def CmdMemberListbox(self, id, code): + if code == win32con.LBN_SELCHANGE: + self.paramlb.ResetContent() + pos = self.memberlb.GetCurSel() + realPos, isMethod = self._GetRealMemberPos(pos) + if isMethod: + id = self.typeinfo.GetFuncDesc(realPos)[0] + names = self.typeinfo.GetNames(id) + for i in range(len(names)): + if i > 0: + self.paramlb.AddString(names[i]) + self.SetupAllInfoTypes() + return 1 + + def GetTemplate(self): + "Return the template used to create this dialog" + + w = 272 # Dialog width + h = 192 # Dialog height + style = ( + FRAMEDLG_STD + | win32con.WS_VISIBLE + | win32con.DS_SETFONT + | win32con.WS_MINIMIZEBOX + ) + template = [ + ["Type Library Browser", (0, 0, w, h), style, None, (8, "Helv")], + ] + template.append([130, "&Type", -1, (10, 10, 62, 9), SS_STD | win32con.SS_LEFT]) + template.append([131, None, self.IDC_TYPELIST, (10, 20, 80, 80), LBS_STD]) + template.append( + [130, "&Members", -1, (100, 10, 62, 9), SS_STD | win32con.SS_LEFT] + ) + template.append([131, None, self.IDC_MEMBERLIST, (100, 20, 80, 80), LBS_STD]) + template.append( + [130, "&Parameters", -1, (190, 10, 62, 9), SS_STD | win32con.SS_LEFT] + ) + template.append([131, None, self.IDC_PARAMLIST, (190, 20, 75, 80), LBS_STD]) + + lvStyle = ( + SS_STD + | commctrl.LVS_REPORT + | commctrl.LVS_AUTOARRANGE + | commctrl.LVS_ALIGNLEFT + | win32con.WS_BORDER + | win32con.WS_TABSTOP + ) + template.append( + ["SysListView32", "", self.IDC_LISTVIEW, (10, 110, 255, 65), lvStyle] + ) + + return template + + +if __name__ == "__main__": + import sys + + fname = None + try: + fname = sys.argv[1] + except: + pass + dlg = TypeBrowseDialog(fname) + if win32api.GetConsoleTitle(): # empty string w/o console + dlg.DoModal() + else: + dlg.CreateWindow(win32ui.GetMainFrame()) diff --git a/lib/win32com/client/util.py b/lib/win32com/client/util.py new file mode 100644 index 00000000..c5762951 --- /dev/null +++ b/lib/win32com/client/util.py @@ -0,0 +1,102 @@ +"""General client side utilities. + +This module contains utility functions, used primarily by advanced COM +programmers, or other COM modules. +""" +import pythoncom +from win32com.client import Dispatch, _get_good_object_ + +PyIDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch] + + +def WrapEnum(ob, resultCLSID=None): + """Wrap an object in a VARIANT enumerator. + + All VT_DISPATCHs returned by the enumerator are converted to wrapper objects + (which may be either a class instance, or a dynamic.Dispatch type object). + + """ + if type(ob) != pythoncom.TypeIIDs[pythoncom.IID_IEnumVARIANT]: + ob = ob.QueryInterface(pythoncom.IID_IEnumVARIANT) + return EnumVARIANT(ob, resultCLSID) + + +class Enumerator: + """A class that provides indexed access into an Enumerator + + By wrapping a PyIEnum* object in this class, you can perform + natural looping and indexing into the Enumerator. + + Looping is very efficient, but it should be noted that although random + access is supported, the underlying object is still an enumerator, so + this will force many reset-and-seek operations to find the requested index. + + """ + + def __init__(self, enum): + self._oleobj_ = enum # a PyIEnumVARIANT + self.index = -1 + + def __getitem__(self, index): + return self.__GetIndex(index) + + def __call__(self, index): + return self.__GetIndex(index) + + def __GetIndex(self, index): + if type(index) != type(0): + raise TypeError("Only integer indexes are supported for enumerators") + # NOTE + # In this context, self.index is users purely as a flag to say + # "am I still in sequence". The user may call Next() or Reset() if they + # so choose, in which case self.index will not be correct (although we + # still want to stay in sequence) + if index != self.index + 1: + # Index requested out of sequence. + self._oleobj_.Reset() + if index: + self._oleobj_.Skip( + index + ) # if asked for item 1, must skip 1, Python always zero based. + self.index = index + result = self._oleobj_.Next(1) + if len(result): + return self._make_retval_(result[0]) + raise IndexError("list index out of range") + + def Next(self, count=1): + ret = self._oleobj_.Next(count) + realRets = [] + for r in ret: + realRets.append(self._make_retval_(r)) + return tuple(realRets) # Convert back to tuple. + + def Reset(self): + return self._oleobj_.Reset() + + def Clone(self): + return self.__class__(self._oleobj_.Clone(), self.resultCLSID) + + def _make_retval_(self, result): + return result + + +class EnumVARIANT(Enumerator): + def __init__(self, enum, resultCLSID=None): + self.resultCLSID = resultCLSID + Enumerator.__init__(self, enum) + + def _make_retval_(self, result): + return _get_good_object_(result, resultCLSID=self.resultCLSID) + + +class Iterator: + def __init__(self, enum, resultCLSID=None): + self.resultCLSID = resultCLSID + self._iter_ = iter(enum.QueryInterface(pythoncom.IID_IEnumVARIANT)) + + def __iter__(self): + return self + + def __next__(self): + return _get_good_object_(next(self._iter_), resultCLSID=self.resultCLSID) diff --git a/lib/win32com/demos/__init__.py b/lib/win32com/demos/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/lib/win32com/demos/connect.py b/lib/win32com/demos/connect.py new file mode 100644 index 00000000..ed7f51c9 --- /dev/null +++ b/lib/win32com/demos/connect.py @@ -0,0 +1,100 @@ +# Implements _both_ a connectable client, and a connectable server. +# +# Note that we cheat just a little - the Server in this demo is not created +# via Normal COM - this means we can avoid registering the server. +# However, the server _is_ accessed as a COM object - just the creation +# is cheated on - so this is still working as a fully-fledged server. + +import pythoncom +import win32com.server.connect +import win32com.server.util +from pywin32_testutil import str2bytes +from win32com.server.exception import Exception + +# This is the IID of the Events interface both Client and Server support. +IID_IConnectDemoEvents = pythoncom.MakeIID("{A4988850-49C3-11d0-AE5D-52342E000000}") + +# The server which implements +# Create a connectable class, that has a single public method +# 'DoIt', which echos to a single sink 'DoneIt' + + +class ConnectableServer(win32com.server.connect.ConnectableServer): + _public_methods_ = [ + "DoIt" + ] + win32com.server.connect.ConnectableServer._public_methods_ + _connect_interfaces_ = [IID_IConnectDemoEvents] + + # The single public method that the client can call on us + # (ie, as a normal COM server, this exposes just this single method. + def DoIt(self, arg): + # Simply broadcast a notification. + self._BroadcastNotify(self.NotifyDoneIt, (arg,)) + + def NotifyDoneIt(self, interface, arg): + interface.Invoke(1000, 0, pythoncom.DISPATCH_METHOD, 1, arg) + + +# Here is the client side of the connection world. +# Define a COM object which implements the methods defined by the +# IConnectDemoEvents interface. +class ConnectableClient: + # This is another cheat - I _know_ the server defines the "DoneIt" event + # as DISPID==1000 - I also know from the implementation details of COM + # that the first method in _public_methods_ gets 1000. + # Normally some explicit DISPID->Method mapping is required. + _public_methods_ = ["OnDoneIt"] + + def __init__(self): + self.last_event_arg = None + + # A client must implement QI, and respond to a query for the Event interface. + # In addition, it must provide a COM object (which server.util.wrap) does. + def _query_interface_(self, iid): + import win32com.server.util + + # Note that this seems like a necessary hack. I am responding to IID_IConnectDemoEvents + # but only creating an IDispatch gateway object. + if iid == IID_IConnectDemoEvents: + return win32com.server.util.wrap(self) + + # And here is our event method which gets called. + def OnDoneIt(self, arg): + self.last_event_arg = arg + + +def CheckEvent(server, client, val, verbose): + client.last_event_arg = None + server.DoIt(val) + if client.last_event_arg != val: + raise RuntimeError("Sent %r, but got back %r" % (val, client.last_event_arg)) + if verbose: + print("Sent and received %r" % val) + + +# A simple test script for all this. +# In the real world, it is likely that the code controlling the server +# will be in the same class as that getting the notifications. +def test(verbose=0): + import win32com.client.connect + import win32com.client.dynamic + import win32com.server.policy + + server = win32com.client.dynamic.Dispatch( + win32com.server.util.wrap(ConnectableServer()) + ) + connection = win32com.client.connect.SimpleConnection() + client = ConnectableClient() + connection.Connect(server, client, IID_IConnectDemoEvents) + CheckEvent(server, client, "Hello", verbose) + CheckEvent(server, client, str2bytes("Here is a null>\x00<"), verbose) + CheckEvent(server, client, "Here is a null>\x00<", verbose) + val = "test-\xe0\xf2" # 2 extended characters. + CheckEvent(server, client, val, verbose) + if verbose: + print("Everything seemed to work!") + # Aggressive memory leak checking (ie, do nothing!) :-) All should cleanup OK??? + + +if __name__ == "__main__": + test(1) diff --git a/lib/win32com/demos/dump_clipboard.py b/lib/win32com/demos/dump_clipboard.py new file mode 100644 index 00000000..534d540a --- /dev/null +++ b/lib/win32com/demos/dump_clipboard.py @@ -0,0 +1,74 @@ +import pythoncom +import win32con + +formats = """CF_TEXT CF_BITMAP CF_METAFILEPICT CF_SYLK CF_DIF CF_TIFF + CF_OEMTEXT CF_DIB CF_PALETTE CF_PENDATA CF_RIFF CF_WAVE + CF_UNICODETEXT CF_ENHMETAFILE CF_HDROP CF_LOCALE CF_MAX + CF_OWNERDISPLAY CF_DSPTEXT CF_DSPBITMAP CF_DSPMETAFILEPICT + CF_DSPENHMETAFILE""".split() +format_name_map = {} +for f in formats: + val = getattr(win32con, f) + format_name_map[val] = f + +tymeds = [attr for attr in pythoncom.__dict__.keys() if attr.startswith("TYMED_")] + + +def DumpClipboard(): + do = pythoncom.OleGetClipboard() + print("Dumping all clipboard formats...") + for fe in do.EnumFormatEtc(): + fmt, td, aspect, index, tymed = fe + tymeds_this = [ + getattr(pythoncom, t) for t in tymeds if tymed & getattr(pythoncom, t) + ] + print("Clipboard format", format_name_map.get(fmt, str(fmt))) + for t_this in tymeds_this: + # As we are enumerating there should be no need to call + # QueryGetData, but we do anyway! + fetc_query = fmt, td, aspect, index, t_this + try: + do.QueryGetData(fetc_query) + except pythoncom.com_error: + print("Eeek - QGD indicated failure for tymed", t_this) + # now actually get it. + try: + medium = do.GetData(fetc_query) + except pythoncom.com_error as exc: + print("Failed to get the clipboard data:", exc) + continue + if medium.tymed == pythoncom.TYMED_GDI: + data = "GDI handle %d" % medium.data + elif medium.tymed == pythoncom.TYMED_MFPICT: + data = "METAFILE handle %d" % medium.data + elif medium.tymed == pythoncom.TYMED_ENHMF: + data = "ENHMETAFILE handle %d" % medium.data + elif medium.tymed == pythoncom.TYMED_HGLOBAL: + data = "%d bytes via HGLOBAL" % len(medium.data) + elif medium.tymed == pythoncom.TYMED_FILE: + data = "filename '%s'" % data + elif medium.tymed == pythoncom.TYMED_ISTREAM: + stream = medium.data + stream.Seek(0, 0) + bytes = 0 + while 1: + chunk = stream.Read(4096) + if not chunk: + break + bytes += len(chunk) + data = "%d bytes via IStream" % bytes + elif medium.tymed == pythoncom.TYMED_ISTORAGE: + data = "a IStorage" + else: + data = "*** unknown tymed!" + print(" -> got", data) + do = None + + +if __name__ == "__main__": + DumpClipboard() + if pythoncom._GetInterfaceCount() + pythoncom._GetGatewayCount(): + print( + "XXX - Leaving with %d/%d COM objects alive" + % (pythoncom._GetInterfaceCount(), pythoncom._GetGatewayCount()) + ) diff --git a/lib/win32com/demos/eventsApartmentThreaded.py b/lib/win32com/demos/eventsApartmentThreaded.py new file mode 100644 index 00000000..ae8e70fa --- /dev/null +++ b/lib/win32com/demos/eventsApartmentThreaded.py @@ -0,0 +1,98 @@ +# A sample originally provided by Richard Bell, and modified by Mark Hammond. + +# This sample demonstrates how to use COM events in an aparment-threaded +# world. In this world, COM itself ensures that all calls to and events +# from an object happen on the same thread that created the object, even +# if they originated from different threads. For this cross-thread +# marshalling to work, this main thread *must* run a "message-loop" (ie, +# a loop fetching and dispatching Windows messages). Without such message +# processing, dead-locks can occur. + +# See also eventsFreeThreaded.py for how to do this in a free-threaded +# world where these marshalling considerations do not exist. + +# NOTE: This example uses Internet Explorer, but it should not be considerd +# a "best-practices" for writing against IE events, but for working with +# events in general. For example: +# * The first OnDocumentComplete event is not a reliable indicator that the +# URL has completed loading +# * As we are demonstrating the most efficient way of handling events, when +# running this sample you will see an IE Windows briefly appear, but +# vanish without ever being repainted. + +import time + +# sys.coinit_flags not set, so pythoncom initializes apartment-threaded. +import pythoncom +import win32api +import win32com.client +import win32event + + +class ExplorerEvents: + def __init__(self): + self.event = win32event.CreateEvent(None, 0, 0, None) + + def OnDocumentComplete(self, pDisp=pythoncom.Empty, URL=pythoncom.Empty): + thread = win32api.GetCurrentThreadId() + print("OnDocumentComplete event processed on thread %d" % thread) + # Set the event our main thread is waiting on. + win32event.SetEvent(self.event) + + def OnQuit(self): + thread = win32api.GetCurrentThreadId() + print("OnQuit event processed on thread %d" % thread) + win32event.SetEvent(self.event) + + +def WaitWhileProcessingMessages(event, timeout=2): + start = time.perf_counter() + while True: + # Wake 4 times a second - we can't just specify the + # full timeout here, as then it would reset for every + # message we process. + rc = win32event.MsgWaitForMultipleObjects( + (event,), 0, 250, win32event.QS_ALLEVENTS + ) + if rc == win32event.WAIT_OBJECT_0: + # event signalled - stop now! + return True + if (time.perf_counter() - start) > timeout: + # Timeout expired. + return False + # must be a message. + pythoncom.PumpWaitingMessages() + + +def TestExplorerEvents(): + iexplore = win32com.client.DispatchWithEvents( + "InternetExplorer.Application", ExplorerEvents + ) + + thread = win32api.GetCurrentThreadId() + print("TestExplorerEvents created IE object on thread %d" % thread) + + iexplore.Visible = 1 + try: + iexplore.Navigate(win32api.GetFullPathName("..\\readme.html")) + except pythoncom.com_error as details: + print("Warning - could not open the test HTML file", details) + + # Wait for the event to be signalled while pumping messages. + if not WaitWhileProcessingMessages(iexplore.event): + print("Document load event FAILED to fire!!!") + + iexplore.Quit() + # + # Give IE a chance to shutdown, else it can get upset on fast machines. + # Note, Quit generates events. Although this test does NOT catch them + # it is NECESSARY to pump messages here instead of a sleep so that the Quit + # happens properly! + if not WaitWhileProcessingMessages(iexplore.event): + print("OnQuit event FAILED to fire!!!") + + iexplore = None + + +if __name__ == "__main__": + TestExplorerEvents() diff --git a/lib/win32com/demos/eventsFreeThreaded.py b/lib/win32com/demos/eventsFreeThreaded.py new file mode 100644 index 00000000..2fc04d82 --- /dev/null +++ b/lib/win32com/demos/eventsFreeThreaded.py @@ -0,0 +1,92 @@ +# A sample originally provided by Richard Bell, and modified by Mark Hammond. + +# This sample demonstrates how to use COM events in a free-threaded world. +# In this world, there is no need to marshall calls across threads, so +# no message loops are needed at all. This means regular cross-thread +# sychronization can be used. In this sample we just wait on win32 event +# objects. + +# See also ieEventsApartmentThreaded.py for how to do this in an +# aparment-threaded world, where thread-marshalling complicates things. + +# NOTE: This example uses Internet Explorer, but it should not be considerd +# a "best-practices" for writing against IE events, but for working with +# events in general. For example: +# * The first OnDocumentComplete event is not a reliable indicator that the +# URL has completed loading +# * As we are demonstrating the most efficient way of handling events, when +# running this sample you will see an IE Windows briefly appear, but +# vanish without ever being repainted. + +import sys + +sys.coinit_flags = 0 # specify free threading + + +import pythoncom +import win32api +import win32com.client +import win32event + + +# The print statements indicate that COM has actually started another thread +# and will deliver the events to that thread (ie, the events do not actually +# fire on our main thread. +class ExplorerEvents: + def __init__(self): + # We reuse this event for all events. + self.event = win32event.CreateEvent(None, 0, 0, None) + + def OnDocumentComplete(self, pDisp=pythoncom.Empty, URL=pythoncom.Empty): + # + # Caution: Since the main thread and events thread(s) are different + # it may be necessary to serialize access to shared data. Because + # this is a simple test case, that is not required here. Your + # situation may be different. Caveat programmer. + # + thread = win32api.GetCurrentThreadId() + print("OnDocumentComplete event processed on thread %d" % thread) + # Set the event our main thread is waiting on. + win32event.SetEvent(self.event) + + def OnQuit(self): + thread = win32api.GetCurrentThreadId() + print("OnQuit event processed on thread %d" % thread) + win32event.SetEvent(self.event) + + +def TestExplorerEvents(): + iexplore = win32com.client.DispatchWithEvents( + "InternetExplorer.Application", ExplorerEvents + ) + + thread = win32api.GetCurrentThreadId() + print("TestExplorerEvents created IE object on thread %d" % thread) + + iexplore.Visible = 1 + try: + iexplore.Navigate(win32api.GetFullPathName("..\\readme.html")) + except pythoncom.com_error as details: + print("Warning - could not open the test HTML file", details) + + # In this free-threaded example, we can simply wait until an event has + # been set - we will give it 2 seconds before giving up. + rc = win32event.WaitForSingleObject(iexplore.event, 2000) + if rc != win32event.WAIT_OBJECT_0: + print("Document load event FAILED to fire!!!") + + iexplore.Quit() + # Now we can do the same thing to wait for exit! + # Although Quit generates events, in this free-threaded world we + # do *not* need to run any message pumps. + + rc = win32event.WaitForSingleObject(iexplore.event, 2000) + if rc != win32event.WAIT_OBJECT_0: + print("OnQuit event FAILED to fire!!!") + + iexplore = None + print("Finished the IE event sample!") + + +if __name__ == "__main__": + TestExplorerEvents() diff --git a/lib/win32com/demos/excelAddin.py b/lib/win32com/demos/excelAddin.py new file mode 100644 index 00000000..96f6cff8 --- /dev/null +++ b/lib/win32com/demos/excelAddin.py @@ -0,0 +1,170 @@ +# A demo plugin for Microsoft Excel +# +# This addin simply adds a new button to the main Excel toolbar, +# and displays a message box when clicked. Thus, it demonstrates +# how to plug in to Excel itself, and hook Excel events. +# +# +# To register the addin, simply execute: +# excelAddin.py +# This will install the COM server, and write the necessary +# AddIn key to Excel +# +# To unregister completely: +# excelAddin.py --unregister +# +# To debug, execute: +# excelAddin.py --debug +# +# Then open Pythonwin, and select "Tools->Trace Collector Debugging Tool" +# Restart excel, and you should see some output generated. +# +# NOTE: If the AddIn fails with an error, Excel will re-register +# the addin to not automatically load next time Excel starts. To +# correct this, simply re-register the addin (see above) +# +# Author Eric Koome +# Copyright (c) 2003 Wavecom Inc. All rights reserved +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions +# are met: +# +# 1. Redistributions of source code must retain the above copyright +# notice, this list of conditions and the following disclaimer. +# +# THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED +# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +# DISCLAIMED. IN NO EVENT SHALL ERIC KOOME OR +# ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF +# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT +# OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +# SUCH DAMAGE. + +import sys + +import pythoncom +from win32com import universal +from win32com.client import Dispatch, DispatchWithEvents, constants, gencache +from win32com.server.exception import COMException + +# Support for COM objects we use. +gencache.EnsureModule( + "{00020813-0000-0000-C000-000000000046}", 0, 1, 3, bForDemand=True +) # Excel 9 +gencache.EnsureModule( + "{2DF8D04C-5BFA-101B-BDE5-00AA0044DE52}", 0, 2, 1, bForDemand=True +) # Office 9 + +# The TLB defining the interfaces we implement +universal.RegisterInterfaces( + "{AC0714F2-3D04-11D1-AE7D-00A0C90F26F4}", 0, 1, 0, ["_IDTExtensibility2"] +) + + +class ButtonEvent: + def OnClick(self, button, cancel): + import win32con # Possible, but not necessary, to use a Pythonwin GUI + import win32ui + + win32ui.MessageBox("Hello from Python", "Python Test", win32con.MB_OKCANCEL) + return cancel + + +class ExcelAddin: + _com_interfaces_ = ["_IDTExtensibility2"] + _public_methods_ = [] + _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER + _reg_clsid_ = "{C5482ECA-F559-45A0-B078-B2036E6F011A}" + _reg_progid_ = "Python.Test.ExcelAddin" + _reg_policy_spec_ = "win32com.server.policy.EventHandlerPolicy" + + def __init__(self): + self.appHostApp = None + + def OnConnection(self, application, connectMode, addin, custom): + print("OnConnection", application, connectMode, addin, custom) + try: + self.appHostApp = application + cbcMyBar = self.appHostApp.CommandBars.Add( + Name="PythonBar", + Position=constants.msoBarTop, + MenuBar=constants.msoBarTypeNormal, + Temporary=True, + ) + btnMyButton = cbcMyBar.Controls.Add( + Type=constants.msoControlButton, Parameter="Greetings" + ) + btnMyButton = self.toolbarButton = DispatchWithEvents( + btnMyButton, ButtonEvent + ) + btnMyButton.Style = constants.msoButtonCaption + btnMyButton.BeginGroup = True + btnMyButton.Caption = "&Python" + btnMyButton.TooltipText = "Python rules the World" + btnMyButton.Width = "34" + cbcMyBar.Visible = True + except pythoncom.com_error as xxx_todo_changeme: + (hr, msg, exc, arg) = xxx_todo_changeme.args + print("The Excel call failed with code %d: %s" % (hr, msg)) + if exc is None: + print("There is no extended error information") + else: + wcode, source, text, helpFile, helpId, scode = exc + print("The source of the error is", source) + print("The error message is", text) + print("More info can be found in %s (id=%d)" % (helpFile, helpId)) + + def OnDisconnection(self, mode, custom): + print("OnDisconnection") + self.appHostApp.CommandBars("PythonBar").Delete + self.appHostApp = None + + def OnAddInsUpdate(self, custom): + print("OnAddInsUpdate", custom) + + def OnStartupComplete(self, custom): + print("OnStartupComplete", custom) + + def OnBeginShutdown(self, custom): + print("OnBeginShutdown", custom) + + +def RegisterAddin(klass): + import winreg + + key = winreg.CreateKey( + winreg.HKEY_CURRENT_USER, "Software\\Microsoft\\Office\\Excel\\Addins" + ) + subkey = winreg.CreateKey(key, klass._reg_progid_) + winreg.SetValueEx(subkey, "CommandLineSafe", 0, winreg.REG_DWORD, 0) + winreg.SetValueEx(subkey, "LoadBehavior", 0, winreg.REG_DWORD, 3) + winreg.SetValueEx(subkey, "Description", 0, winreg.REG_SZ, "Excel Addin") + winreg.SetValueEx(subkey, "FriendlyName", 0, winreg.REG_SZ, "A Simple Excel Addin") + + +def UnregisterAddin(klass): + import winreg + + try: + winreg.DeleteKey( + winreg.HKEY_CURRENT_USER, + "Software\\Microsoft\\Office\\Excel\\Addins\\" + klass._reg_progid_, + ) + except WindowsError: + pass + + +if __name__ == "__main__": + import win32com.server.register + + win32com.server.register.UseCommandLine(ExcelAddin) + if "--unregister" in sys.argv: + UnregisterAddin(ExcelAddin) + else: + RegisterAddin(ExcelAddin) diff --git a/lib/win32com/demos/excelRTDServer.py b/lib/win32com/demos/excelRTDServer.py new file mode 100644 index 00000000..c50e1ac7 --- /dev/null +++ b/lib/win32com/demos/excelRTDServer.py @@ -0,0 +1,434 @@ +"""Excel IRTDServer implementation. + +This module is a functional example of how to implement the IRTDServer interface +in python, using the pywin32 extensions. Further details, about this interface +and it can be found at: + http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnexcl2k2/html/odc_xlrtdfaq.asp +""" + +# Copyright (c) 2003-2004 by Chris Nilsson +# +# By obtaining, using, and/or copying this software and/or its +# associated documentation, you agree that you have read, understood, +# and will comply with the following terms and conditions: +# +# Permission to use, copy, modify, and distribute this software and +# its associated documentation for any purpose and without fee is +# hereby granted, provided that the above copyright notice appears in +# all copies, and that both that copyright notice and this permission +# notice appear in supporting documentation, and that the name of +# Christopher Nilsson (the author) not be used in advertising or publicity +# pertaining to distribution of the software without specific, written +# prior permission. +# +# THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD +# TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT- +# ABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR +# BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY +# DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, +# WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS +# ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE +# OF THIS SOFTWARE. + +import datetime # For the example classes... +import threading + +import pythoncom +import win32com.client +from win32com import universal +from win32com.client import gencache +from win32com.server.exception import COMException + +# Typelib info for version 10 - aka Excel XP. +# This is the minimum version of excel that we can work with as this is when +# Microsoft introduced these interfaces. +EXCEL_TLB_GUID = "{00020813-0000-0000-C000-000000000046}" +EXCEL_TLB_LCID = 0 +EXCEL_TLB_MAJOR = 1 +EXCEL_TLB_MINOR = 4 + +# Import the excel typelib to make sure we've got early-binding going on. +# The "ByRef" parameters we use later won't work without this. +gencache.EnsureModule(EXCEL_TLB_GUID, EXCEL_TLB_LCID, EXCEL_TLB_MAJOR, EXCEL_TLB_MINOR) + +# Tell pywin to import these extra interfaces. +# -- +# QUESTION: Why? The interfaces seem to descend from IDispatch, so +# I'd have thought, for example, calling callback.UpdateNotify() (on the +# IRTDUpdateEvent callback excel gives us) would work without molestation. +# But the callback needs to be cast to a "real" IRTDUpdateEvent type. Hmm... +# This is where my small knowledge of the pywin framework / COM gets hazy. +# -- +# Again, we feed in the Excel typelib as the source of these interfaces. +universal.RegisterInterfaces( + EXCEL_TLB_GUID, + EXCEL_TLB_LCID, + EXCEL_TLB_MAJOR, + EXCEL_TLB_MINOR, + ["IRtdServer", "IRTDUpdateEvent"], +) + + +class ExcelRTDServer(object): + """Base RTDServer class. + + Provides most of the features needed to implement the IRtdServer interface. + Manages topic adding, removal, and packing up the values for excel. + + Shouldn't be instanciated directly. + + Instead, descendant classes should override the CreateTopic() method. + Topic objects only need to provide a GetValue() function to play nice here. + The values given need to be atomic (eg. string, int, float... etc). + + Also note: nothing has been done within this class to ensure that we get + time to check our topics for updates. I've left that up to the subclass + since the ways, and needs, of refreshing your topics will vary greatly. For + example, the sample implementation uses a timer thread to wake itself up. + Whichever way you choose to do it, your class needs to be able to wake up + occaisionally, since excel will never call your class without being asked to + first. + + Excel will communicate with our object in this order: + 1. Excel instanciates our object and calls ServerStart, providing us with + an IRTDUpdateEvent callback object. + 2. Excel calls ConnectData when it wants to subscribe to a new "topic". + 3. When we have new data to provide, we call the UpdateNotify method of the + callback object we were given. + 4. Excel calls our RefreshData method, and receives a 2d SafeArray (row-major) + containing the Topic ids in the 1st dim, and the topic values in the + 2nd dim. + 5. When not needed anymore, Excel will call our DisconnectData to + unsubscribe from a topic. + 6. When there are no more topics left, Excel will call our ServerTerminate + method to kill us. + + Throughout, at undetermined periods, Excel will call our Heartbeat + method to see if we're still alive. It must return a non-zero value, or + we'll be killed. + + NOTE: By default, excel will at most call RefreshData once every 2 seconds. + This is a setting that needs to be changed excel-side. To change this, + you can set the throttle interval like this in the excel VBA object model: + Application.RTD.ThrottleInterval = 1000 ' milliseconds + """ + + _com_interfaces_ = ["IRtdServer"] + _public_methods_ = [ + "ConnectData", + "DisconnectData", + "Heartbeat", + "RefreshData", + "ServerStart", + "ServerTerminate", + ] + _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER + # _reg_clsid_ = "# subclass must provide this class attribute" + # _reg_desc_ = "# subclass should provide this description" + # _reg_progid_ = "# subclass must provide this class attribute" + + ALIVE = 1 + NOT_ALIVE = 0 + + def __init__(self): + """Constructor""" + super(ExcelRTDServer, self).__init__() + self.IsAlive = self.ALIVE + self.__callback = None + self.topics = {} + + def SignalExcel(self): + """Use the callback we were given to tell excel new data is available.""" + if self.__callback is None: + raise COMException(desc="Callback excel provided is Null") + self.__callback.UpdateNotify() + + def ConnectData(self, TopicID, Strings, GetNewValues): + """Creates a new topic out of the Strings excel gives us.""" + try: + self.topics[TopicID] = self.CreateTopic(Strings) + except Exception as why: + raise COMException(desc=str(why)) + GetNewValues = True + result = self.topics[TopicID] + if result is None: + result = "# %s: Waiting for update" % self.__class__.__name__ + else: + result = result.GetValue() + + # fire out internal event... + self.OnConnectData(TopicID) + + # GetNewValues as per interface is ByRef, so we need to pass it back too. + return result, GetNewValues + + def DisconnectData(self, TopicID): + """Deletes the given topic.""" + self.OnDisconnectData(TopicID) + + if TopicID in self.topics: + self.topics[TopicID] = None + del self.topics[TopicID] + + def Heartbeat(self): + """Called by excel to see if we're still here.""" + return self.IsAlive + + def RefreshData(self, TopicCount): + """Packs up the topic values. Called by excel when it's ready for an update. + + Needs to: + * Return the current number of topics, via the "ByRef" TopicCount + * Return a 2d SafeArray of the topic data. + - 1st dim: topic numbers + - 2nd dim: topic values + + We could do some caching, instead of repacking everytime... + But this works for demonstration purposes.""" + TopicCount = len(self.topics) + self.OnRefreshData() + + # Grow the lists, so we don't need a heap of calls to append() + results = [[None] * TopicCount, [None] * TopicCount] + + # Excel expects a 2-dimensional array. The first dim contains the + # topic numbers, and the second contains the values for the topics. + # In true VBA style (yuck), we need to pack the array in row-major format, + # which looks like: + # ( (topic_num1, topic_num2, ..., topic_numN), \ + # (topic_val1, topic_val2, ..., topic_valN) ) + for idx, topicdata in enumerate(self.topics.items()): + topicNum, topic = topicdata + results[0][idx] = topicNum + results[1][idx] = topic.GetValue() + + # TopicCount is meant to be passed to us ByRef, so return it as well, as per + # the way pywin32 handles ByRef arguments. + return tuple(results), TopicCount + + def ServerStart(self, CallbackObject): + """Excel has just created us... We take its callback for later, and set up shop.""" + self.IsAlive = self.ALIVE + + if CallbackObject is None: + raise COMException(desc="Excel did not provide a callback") + + # Need to "cast" the raw PyIDispatch object to the IRTDUpdateEvent interface + IRTDUpdateEventKlass = win32com.client.CLSIDToClass.GetClass( + "{A43788C1-D91B-11D3-8F39-00C04F3651B8}" + ) + self.__callback = IRTDUpdateEventKlass(CallbackObject) + + self.OnServerStart() + + return self.IsAlive + + def ServerTerminate(self): + """Called when excel no longer wants us.""" + self.IsAlive = self.NOT_ALIVE # On next heartbeat, excel will free us + self.OnServerTerminate() + + def CreateTopic(self, TopicStrings=None): + """Topic factory method. Subclass must override. + + Topic objects need to provide: + * GetValue() method which returns an atomic value. + + Will raise NotImplemented if not overridden. + """ + raise NotImplemented("Subclass must implement") + + # Overridable class events... + def OnConnectData(self, TopicID): + """Called when a new topic has been created, at excel's request.""" + pass + + def OnDisconnectData(self, TopicID): + """Called when a topic is about to be deleted, at excel's request.""" + pass + + def OnRefreshData(self): + """Called when excel has requested all current topic data.""" + pass + + def OnServerStart(self): + """Called when excel has instanciated us.""" + pass + + def OnServerTerminate(self): + """Called when excel is about to destroy us.""" + pass + + +class RTDTopic(object): + """Base RTD Topic. + Only method required by our RTDServer implementation is GetValue(). + The others are more for convenience.""" + + def __init__(self, TopicStrings): + super(RTDTopic, self).__init__() + self.TopicStrings = TopicStrings + self.__currentValue = None + self.__dirty = False + + def Update(self, sender): + """Called by the RTD Server. + Gives us a chance to check if our topic data needs to be + changed (eg. check a file, quiz a database, etc).""" + raise NotImplemented("subclass must implement") + + def Reset(self): + """Call when this topic isn't considered "dirty" anymore.""" + self.__dirty = False + + def GetValue(self): + return self.__currentValue + + def SetValue(self, value): + self.__dirty = True + self.__currentValue = value + + def HasChanged(self): + return self.__dirty + + +# -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= + +###################################### +# Example classes +###################################### + + +class TimeServer(ExcelRTDServer): + """Example Time RTD server. + + Sends time updates back to excel. + + example of use, in an excel sheet: + =RTD("Python.RTD.TimeServer","","seconds","5") + + This will cause a timestamp string to fill the cell, and update its value + every 5 seconds (or as close as possible depending on how busy excel is). + + The empty string parameter denotes the com server is running on the local + machine. Otherwise, put in the hostname to look on. For more info + on this, lookup the Excel help for its "RTD" worksheet function. + + Obviously, you'd want to wrap this kind of thing in a friendlier VBA + function. + + Also, remember that the RTD function accepts a maximum of 28 arguments! + If you want to pass more, you may need to concatenate arguments into one + string, and have your topic parse them appropriately. + """ + + # win32com.server setup attributes... + # Never copy the _reg_clsid_ value in your own classes! + _reg_clsid_ = "{EA7F2CF1-11A2-45E4-B2D5-68E240DB8CB1}" + _reg_progid_ = "Python.RTD.TimeServer" + _reg_desc_ = "Python class implementing Excel IRTDServer -- feeds time" + + # other class attributes... + INTERVAL = 0.5 # secs. Threaded timer will wake us up at this interval. + + def __init__(self): + super(TimeServer, self).__init__() + + # Simply timer thread to ensure we get to update our topics, and + # tell excel about any changes. This is a pretty basic and dirty way to + # do this. Ideally, there should be some sort of waitable (eg. either win32 + # event, socket data event...) and be kicked off by that event triggering. + # As soon as we set up shop here, we _must_ return control back to excel. + # (ie. we can't block and do our own thing...) + self.ticker = threading.Timer(self.INTERVAL, self.Update) + + def OnServerStart(self): + self.ticker.start() + + def OnServerTerminate(self): + if not self.ticker.finished.isSet(): + self.ticker.cancel() # Cancel our wake-up thread. Excel has killed us. + + def Update(self): + # Get our wake-up thread ready... + self.ticker = threading.Timer(self.INTERVAL, self.Update) + try: + # Check if any of our topics have new info to pass on + if len(self.topics): + refresh = False + for topic in self.topics.values(): + topic.Update(self) + if topic.HasChanged(): + refresh = True + topic.Reset() + + if refresh: + self.SignalExcel() + finally: + self.ticker.start() # Make sure we get to run again + + def CreateTopic(self, TopicStrings=None): + """Topic factory. Builds a TimeTopic object out of the given TopicStrings.""" + return TimeTopic(TopicStrings) + + +class TimeTopic(RTDTopic): + """Example topic for example RTD server. + + Will accept some simple commands to alter how long to delay value updates. + + Commands: + * seconds, delay_in_seconds + * minutes, delay_in_minutes + * hours, delay_in_hours + """ + + def __init__(self, TopicStrings): + super(TimeTopic, self).__init__(TopicStrings) + try: + self.cmd, self.delay = self.TopicStrings + except Exception as E: + # We could simply return a "# ERROR" type string as the + # topic value, but explosions like this should be able to get handled by + # the VBA-side "On Error" stuff. + raise ValueError("Invalid topic strings: %s" % str(TopicStrings)) + + # self.cmd = str(self.cmd) + self.delay = float(self.delay) + + # setup our initial value + self.checkpoint = self.timestamp() + self.SetValue(str(self.checkpoint)) + + def timestamp(self): + return datetime.datetime.now() + + def Update(self, sender): + now = self.timestamp() + delta = now - self.checkpoint + refresh = False + if self.cmd == "seconds": + if delta.seconds >= self.delay: + refresh = True + elif self.cmd == "minutes": + if delta.minutes >= self.delay: + refresh = True + elif self.cmd == "hours": + if delta.hours >= self.delay: + refresh = True + else: + self.SetValue("#Unknown command: " + self.cmd) + + if refresh: + self.SetValue(str(now)) + self.checkpoint = now + + +if __name__ == "__main__": + import win32com.server.register + + # Register/Unregister TimeServer example + # eg. at the command line: excelrtd.py --register + # Then type in an excel cell something like: + # =RTD("Python.RTD.TimeServer","","seconds","5") + win32com.server.register.UseCommandLine(TimeServer) diff --git a/lib/win32com/demos/iebutton.py b/lib/win32com/demos/iebutton.py new file mode 100644 index 00000000..bc3ce99b --- /dev/null +++ b/lib/win32com/demos/iebutton.py @@ -0,0 +1,217 @@ +# -*- coding: latin-1 -*- + +# PyWin32 Internet Explorer Button +# +# written by Leonard Ritter (paniq@gmx.net) +# and Robert Förtsch (info@robert-foertsch.com) + + +""" +This sample implements a simple IE Button COM server +with access to the IWebBrowser2 interface. + +To demonstrate: +* Execute this script to register the server. +* Open Pythonwin's Tools -> Trace Collector Debugging Tool, so you can + see the output of 'print' statements in this demo. +* Open a new IE instance. The toolbar should have a new "scissors" icon, + with tooltip text "IE Button" - this is our new button - click it. +* Switch back to the Pythonwin window - you should see: + IOleCommandTarget::Exec called. + This is the button being clicked. Extending this to do something more + useful is left as an exercise. + +Contribtions to this sample to make it a little "friendlier" welcome! +""" + +# imports section + +import pythoncom +import win32api +import win32com +import win32com.server.register +from win32com import universal +from win32com.client import Dispatch, DispatchWithEvents, constants, gencache, getevents + +# This demo uses 'print' - use win32traceutil to see it if we have no +# console. +try: + win32api.GetConsoleTitle() +except win32api.error: + import win32traceutil + +import array + +from win32com.axcontrol import axcontrol + +# ensure we know the ms internet controls typelib so we have access to IWebBrowser2 later on +win32com.client.gencache.EnsureModule("{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1) + + +# +IObjectWithSite_methods = ["SetSite", "GetSite"] +IOleCommandTarget_methods = ["Exec", "QueryStatus"] + +_iebutton_methods_ = IOleCommandTarget_methods + IObjectWithSite_methods +_iebutton_com_interfaces_ = [ + axcontrol.IID_IOleCommandTarget, + axcontrol.IID_IObjectWithSite, # IObjectWithSite +] + + +class Stub: + """ + this class serves as a method stub, + outputting debug info whenever the object + is being called. + """ + + def __init__(self, name): + self.name = name + + def __call__(self, *args): + print("STUB: ", self.name, args) + + +class IEButton: + """ + The actual COM server class + """ + + _com_interfaces_ = _iebutton_com_interfaces_ + _public_methods_ = _iebutton_methods_ + _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER + _button_text_ = "IE Button" + _tool_tip_ = "An example implementation for an IE Button." + _icon_ = "" + _hot_icon_ = "" + + def __init__(self): + # put stubs for non-implemented methods + for method in self._public_methods_: + if not hasattr(self, method): + print("providing default stub for %s" % method) + setattr(self, method, Stub(method)) + + def QueryStatus(self, pguidCmdGroup, prgCmds, cmdtextf): + # 'cmdtextf' is the 'cmdtextf' element from the OLECMDTEXT structure, + # or None if a NULL pointer was passed. + result = [] + for id, flags in prgCmds: + flags |= axcontrol.OLECMDF_SUPPORTED | axcontrol.OLECMDF_ENABLED + result.append((id, flags)) + if cmdtextf is None: + cmdtext = None # must return None if nothing requested. + # IE never seems to want any text - this code is here for + # demo purposes only + elif cmdtextf == axcontrol.OLECMDTEXTF_NAME: + cmdtext = "IEButton Name" + else: + cmdtext = "IEButton State" + return result, cmdtext + + def Exec(self, pguidCmdGroup, nCmdID, nCmdExecOpt, pvaIn): + print(pguidCmdGroup, nCmdID, nCmdExecOpt, pvaIn) + print("IOleCommandTarget::Exec called.") + # self.webbrowser.ShowBrowserBar(GUID_IETOOLBAR, not is_ietoolbar_visible()) + + def SetSite(self, unknown): + if unknown: + # first get a command target + cmdtarget = unknown.QueryInterface(axcontrol.IID_IOleCommandTarget) + # then travel over to a service provider + serviceprovider = cmdtarget.QueryInterface(pythoncom.IID_IServiceProvider) + # finally ask for the internet explorer application, returned as a dispatch object + self.webbrowser = win32com.client.Dispatch( + serviceprovider.QueryService( + "{0002DF05-0000-0000-C000-000000000046}", pythoncom.IID_IDispatch + ) + ) + else: + # lose all references + self.webbrowser = None + + def GetClassID(self): + return self._reg_clsid_ + + +def register(classobj): + import winreg + + subKeyCLSID = ( + "SOFTWARE\\Microsoft\\Internet Explorer\\Extensions\\%38s" + % classobj._reg_clsid_ + ) + try: + hKey = winreg.CreateKey(winreg.HKEY_LOCAL_MACHINE, subKeyCLSID) + subKey = winreg.SetValueEx( + hKey, "ButtonText", 0, winreg.REG_SZ, classobj._button_text_ + ) + winreg.SetValueEx( + hKey, "ClsidExtension", 0, winreg.REG_SZ, classobj._reg_clsid_ + ) # reg value for calling COM object + winreg.SetValueEx( + hKey, "CLSID", 0, winreg.REG_SZ, "{1FBA04EE-3024-11D2-8F1F-0000F87ABD16}" + ) # CLSID for button that sends command to COM object + winreg.SetValueEx(hKey, "Default Visible", 0, winreg.REG_SZ, "Yes") + winreg.SetValueEx(hKey, "ToolTip", 0, winreg.REG_SZ, classobj._tool_tip_) + winreg.SetValueEx(hKey, "Icon", 0, winreg.REG_SZ, classobj._icon_) + winreg.SetValueEx(hKey, "HotIcon", 0, winreg.REG_SZ, classobj._hot_icon_) + except WindowsError: + print("Couldn't set standard toolbar reg keys.") + else: + print("Set standard toolbar reg keys.") + + +def unregister(classobj): + import winreg + + subKeyCLSID = ( + "SOFTWARE\\Microsoft\\Internet Explorer\\Extensions\\%38s" + % classobj._reg_clsid_ + ) + try: + hKey = winreg.CreateKey(winreg.HKEY_LOCAL_MACHINE, subKeyCLSID) + subKey = winreg.DeleteValue(hKey, "ButtonText") + winreg.DeleteValue(hKey, "ClsidExtension") # for calling COM object + winreg.DeleteValue(hKey, "CLSID") + winreg.DeleteValue(hKey, "Default Visible") + winreg.DeleteValue(hKey, "ToolTip") + winreg.DeleteValue(hKey, "Icon") + winreg.DeleteValue(hKey, "HotIcon") + winreg.DeleteKey(winreg.HKEY_LOCAL_MACHINE, subKeyCLSID) + except WindowsError: + print("Couldn't delete Standard toolbar regkey.") + else: + print("Deleted Standard toolbar regkey.") + + +# +# test implementation +# + + +class PyWin32InternetExplorerButton(IEButton): + _reg_clsid_ = "{104B66A9-9E68-49D1-A3F5-94754BE9E0E6}" + _reg_progid_ = "PyWin32.IEButton" + _reg_desc_ = "Test Button" + _button_text_ = "IE Button" + _tool_tip_ = "An example implementation for an IE Button." + _icon_ = "" + _hot_icon_ = _icon_ + + +def DllRegisterServer(): + register(PyWin32InternetExplorerButton) + + +def DllUnregisterServer(): + unregister(PyWin32InternetExplorerButton) + + +if __name__ == "__main__": + win32com.server.register.UseCommandLine( + PyWin32InternetExplorerButton, + finalize_register=DllRegisterServer, + finalize_unregister=DllUnregisterServer, + ) diff --git a/lib/win32com/demos/ietoolbar.py b/lib/win32com/demos/ietoolbar.py new file mode 100644 index 00000000..084db3c1 --- /dev/null +++ b/lib/win32com/demos/ietoolbar.py @@ -0,0 +1,376 @@ +# -*- coding: latin-1 -*- + +# PyWin32 Internet Explorer Toolbar +# +# written by Leonard Ritter (paniq@gmx.net) +# and Robert Förtsch (info@robert-foertsch.com) + + +""" +This sample implements a simple IE Toolbar COM server +supporting Windows XP styles and access to +the IWebBrowser2 interface. + +It also demonstrates how to hijack the parent window +to catch WM_COMMAND messages. +""" + +# imports section +import sys +import winreg + +import pythoncom +import win32com +from win32com import universal +from win32com.axcontrol import axcontrol +from win32com.client import Dispatch, DispatchWithEvents, constants, gencache, getevents +from win32com.shell import shell +from win32com.shell.shellcon import * + +try: + # try to get styles (winxp) + import winxpgui as win32gui +except: + # import default module (win2k and lower) + import win32gui + +import array +import struct + +import commctrl +import win32con +import win32ui + +# ensure we know the ms internet controls typelib so we have access to IWebBrowser2 later on +win32com.client.gencache.EnsureModule("{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1) + +# +IDeskBand_methods = ["GetBandInfo"] +IDockingWindow_methods = ["ShowDW", "CloseDW", "ResizeBorderDW"] +IOleWindow_methods = ["GetWindow", "ContextSensitiveHelp"] +IInputObject_methods = ["UIActivateIO", "HasFocusIO", "TranslateAcceleratorIO"] +IObjectWithSite_methods = ["SetSite", "GetSite"] +IPersistStream_methods = ["GetClassID", "IsDirty", "Load", "Save", "GetSizeMax"] + +_ietoolbar_methods_ = ( + IDeskBand_methods + + IDockingWindow_methods + + IOleWindow_methods + + IInputObject_methods + + IObjectWithSite_methods + + IPersistStream_methods +) +_ietoolbar_com_interfaces_ = [ + shell.IID_IDeskBand, # IDeskBand + axcontrol.IID_IObjectWithSite, # IObjectWithSite + pythoncom.IID_IPersistStream, + axcontrol.IID_IOleCommandTarget, +] + + +class WIN32STRUCT: + def __init__(self, **kw): + full_fmt = "" + for name, fmt, default in self._struct_items_: + self.__dict__[name] = None + if fmt == "z": + full_fmt += "pi" + else: + full_fmt += fmt + for name, val in kw.items(): + self.__dict__[name] = val + + def __setattr__(self, attr, val): + if not attr.startswith("_") and attr not in self.__dict__: + raise AttributeError(attr) + self.__dict__[attr] = val + + def toparam(self): + self._buffs = [] + full_fmt = "" + vals = [] + for name, fmt, default in self._struct_items_: + val = self.__dict__[name] + if fmt == "z": + fmt = "Pi" + if val is None: + vals.append(0) + vals.append(0) + else: + str_buf = array.array("c", val + "\0") + vals.append(str_buf.buffer_info()[0]) + vals.append(len(val)) + self._buffs.append(str_buf) # keep alive during the call. + else: + if val is None: + val = default + vals.append(val) + full_fmt += fmt + return struct.pack(*(full_fmt,) + tuple(vals)) + + +class TBBUTTON(WIN32STRUCT): + _struct_items_ = [ + ("iBitmap", "i", 0), + ("idCommand", "i", 0), + ("fsState", "B", 0), + ("fsStyle", "B", 0), + ("bReserved", "H", 0), + ("dwData", "I", 0), + ("iString", "z", None), + ] + + +class Stub: + """ + this class serves as a method stub, + outputting debug info whenever the object + is being called. + """ + + def __init__(self, name): + self.name = name + + def __call__(self, *args): + print("STUB: ", self.name, args) + + +class IEToolbarCtrl: + """ + a tiny wrapper for our winapi-based + toolbar control implementation. + """ + + def __init__(self, hwndparent): + styles = ( + win32con.WS_CHILD + | win32con.WS_VISIBLE + | win32con.WS_CLIPSIBLINGS + | win32con.WS_CLIPCHILDREN + | commctrl.TBSTYLE_LIST + | commctrl.TBSTYLE_FLAT + | commctrl.TBSTYLE_TRANSPARENT + | commctrl.CCS_TOP + | commctrl.CCS_NODIVIDER + | commctrl.CCS_NORESIZE + | commctrl.CCS_NOPARENTALIGN + ) + self.hwnd = win32gui.CreateWindow( + "ToolbarWindow32", + None, + styles, + 0, + 0, + 100, + 100, + hwndparent, + 0, + win32gui.dllhandle, + None, + ) + win32gui.SendMessage(self.hwnd, commctrl.TB_BUTTONSTRUCTSIZE, 20, 0) + + def ShowWindow(self, mode): + win32gui.ShowWindow(self.hwnd, mode) + + def AddButtons(self, *buttons): + tbbuttons = "" + for button in buttons: + tbbuttons += button.toparam() + return win32gui.SendMessage( + self.hwnd, commctrl.TB_ADDBUTTONS, len(buttons), tbbuttons + ) + + def GetSafeHwnd(self): + return self.hwnd + + +class IEToolbar: + """ + The actual COM server class + """ + + _com_interfaces_ = _ietoolbar_com_interfaces_ + _public_methods_ = _ietoolbar_methods_ + _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER + # if you copy and modify this example, be sure to change the clsid below + _reg_clsid_ = "{F21202A2-959A-4149-B1C3-68B9013F3335}" + _reg_progid_ = "PyWin32.IEToolbar" + _reg_desc_ = "PyWin32 IE Toolbar" + + def __init__(self): + # put stubs for non-implemented methods + for method in self._public_methods_: + if not hasattr(self, method): + print("providing default stub for %s" % method) + setattr(self, method, Stub(method)) + + def GetWindow(self): + return self.toolbar.GetSafeHwnd() + + def Load(self, stream): + # called when the toolbar is loaded + pass + + def Save(self, pStream, fClearDirty): + # called when the toolbar shall save its information + pass + + def CloseDW(self, dwReserved): + del self.toolbar + + def ShowDW(self, bShow): + if bShow: + self.toolbar.ShowWindow(win32con.SW_SHOW) + else: + self.toolbar.ShowWindow(win32con.SW_HIDE) + + def on_first_button(self): + print("first!") + self.webbrowser.Navigate2("http://starship.python.net/crew/mhammond/") + + def on_second_button(self): + print("second!") + + def on_third_button(self): + print("third!") + + def toolbar_command_handler(self, args): + hwnd, message, wparam, lparam, time, point = args + if lparam == self.toolbar.GetSafeHwnd(): + self._command_map[wparam]() + + def SetSite(self, unknown): + if unknown: + # retrieve the parent window interface for this site + olewindow = unknown.QueryInterface(pythoncom.IID_IOleWindow) + # ask the window for its handle + hwndparent = olewindow.GetWindow() + + # first get a command target + cmdtarget = unknown.QueryInterface(axcontrol.IID_IOleCommandTarget) + # then travel over to a service provider + serviceprovider = cmdtarget.QueryInterface(pythoncom.IID_IServiceProvider) + # finally ask for the internet explorer application, returned as a dispatch object + self.webbrowser = win32com.client.Dispatch( + serviceprovider.QueryService( + "{0002DF05-0000-0000-C000-000000000046}", pythoncom.IID_IDispatch + ) + ) + + # now create and set up the toolbar + self.toolbar = IEToolbarCtrl(hwndparent) + + buttons = [ + ("Visit PyWin32 Homepage", self.on_first_button), + ("Another Button", self.on_second_button), + ("Yet Another Button", self.on_third_button), + ] + + self._command_map = {} + # wrap our parent window so we can hook message handlers + window = win32ui.CreateWindowFromHandle(hwndparent) + + # add the buttons + for i in range(len(buttons)): + button = TBBUTTON() + name, func = buttons[i] + id = 0x4444 + i + button.iBitmap = -2 + button.idCommand = id + button.fsState = commctrl.TBSTATE_ENABLED + button.fsStyle = commctrl.TBSTYLE_BUTTON + button.iString = name + self._command_map[0x4444 + i] = func + self.toolbar.AddButtons(button) + window.HookMessage(self.toolbar_command_handler, win32con.WM_COMMAND) + else: + # lose all references + self.webbrowser = None + + def GetClassID(self): + return self._reg_clsid_ + + def GetBandInfo(self, dwBandId, dwViewMode, dwMask): + ptMinSize = (0, 24) + ptMaxSize = (2000, 24) + ptIntegral = (0, 0) + ptActual = (2000, 24) + wszTitle = "PyWin32 IE Toolbar" + dwModeFlags = DBIMF_VARIABLEHEIGHT + crBkgnd = 0 + return ( + ptMinSize, + ptMaxSize, + ptIntegral, + ptActual, + wszTitle, + dwModeFlags, + crBkgnd, + ) + + +# used for HKLM install +def DllInstall(bInstall, cmdLine): + comclass = IEToolbar + + +# register plugin +def DllRegisterServer(): + comclass = IEToolbar + + # register toolbar with IE + try: + print("Trying to register Toolbar.\n") + hkey = winreg.CreateKey( + winreg.HKEY_LOCAL_MACHINE, "SOFTWARE\\Microsoft\\Internet Explorer\\Toolbar" + ) + subKey = winreg.SetValueEx( + hkey, comclass._reg_clsid_, 0, winreg.REG_BINARY, "\0" + ) + except WindowsError: + print( + "Couldn't set registry value.\nhkey: %d\tCLSID: %s\n" + % (hkey, comclass._reg_clsid_) + ) + else: + print( + "Set registry value.\nhkey: %d\tCLSID: %s\n" % (hkey, comclass._reg_clsid_) + ) + # TODO: implement reg settings for standard toolbar button + + +# unregister plugin +def DllUnregisterServer(): + comclass = IEToolbar + + # unregister toolbar from internet explorer + try: + print("Trying to unregister Toolbar.\n") + hkey = winreg.CreateKey( + winreg.HKEY_LOCAL_MACHINE, "SOFTWARE\\Microsoft\\Internet Explorer\\Toolbar" + ) + winreg.DeleteValue(hkey, comclass._reg_clsid_) + except WindowsError: + print( + "Couldn't delete registry value.\nhkey: %d\tCLSID: %s\n" + % (hkey, comclass._reg_clsid_) + ) + else: + print("Deleting reg key succeeded.\n") + + +# entry point +if __name__ == "__main__": + import win32com.server.register + + win32com.server.register.UseCommandLine(IEToolbar) + + # parse actual command line option + if "--unregister" in sys.argv: + DllUnregisterServer() + else: + DllRegisterServer() +else: + # import trace utility for remote debugging + import win32traceutil diff --git a/lib/win32com/demos/outlookAddin.py b/lib/win32com/demos/outlookAddin.py new file mode 100644 index 00000000..9433596d --- /dev/null +++ b/lib/win32com/demos/outlookAddin.py @@ -0,0 +1,138 @@ +# A demo plugin for Microsoft Outlook (NOT Outlook Express) +# +# This addin simply adds a new button to the main Outlook toolbar, +# and displays a message box when clicked. Thus, it demonstrates +# how to plug in to Outlook itself, and hook outlook events. +# +# Additionally, each time a new message arrives in the Inbox, a message +# is printed with the subject of the message. +# +# To register the addin, simply execute: +# outlookAddin.py +# This will install the COM server, and write the necessary +# AddIn key to Outlook +# +# To unregister completely: +# outlookAddin.py --unregister +# +# To debug, execute: +# outlookAddin.py --debug +# +# Then open Pythonwin, and select "Tools->Trace Collector Debugging Tool" +# Restart Outlook, and you should see some output generated. +# +# NOTE: If the AddIn fails with an error, Outlook will re-register +# the addin to not automatically load next time Outlook starts. To +# correct this, simply re-register the addin (see above) + +import sys + +import pythoncom +from win32com import universal +from win32com.client import DispatchWithEvents, constants, gencache +from win32com.server.exception import COMException + +# Support for COM objects we use. +gencache.EnsureModule( + "{00062FFF-0000-0000-C000-000000000046}", 0, 9, 0, bForDemand=True +) # Outlook 9 +gencache.EnsureModule( + "{2DF8D04C-5BFA-101B-BDE5-00AA0044DE52}", 0, 2, 1, bForDemand=True +) # Office 9 + +# The TLB defining the interfaces we implement +universal.RegisterInterfaces( + "{AC0714F2-3D04-11D1-AE7D-00A0C90F26F4}", 0, 1, 0, ["_IDTExtensibility2"] +) + + +class ButtonEvent: + def OnClick(self, button, cancel): + import win32ui # Possible, but not necessary, to use a Pythonwin GUI + + win32ui.MessageBox("Hello from Python") + return cancel + + +class FolderEvent: + def OnItemAdd(self, item): + try: + print("An item was added to the inbox with subject:", item.Subject) + except AttributeError: + print( + "An item was added to the inbox, but it has no subject! - ", repr(item) + ) + + +class OutlookAddin: + _com_interfaces_ = ["_IDTExtensibility2"] + _public_methods_ = [] + _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER + _reg_clsid_ = "{0F47D9F3-598B-4d24-B7E3-92AC15ED27E2}" + _reg_progid_ = "Python.Test.OutlookAddin" + _reg_policy_spec_ = "win32com.server.policy.EventHandlerPolicy" + + def OnConnection(self, application, connectMode, addin, custom): + print("OnConnection", application, connectMode, addin, custom) + # ActiveExplorer may be none when started without a UI (eg, WinCE synchronisation) + activeExplorer = application.ActiveExplorer() + if activeExplorer is not None: + bars = activeExplorer.CommandBars + toolbar = bars.Item("Standard") + item = toolbar.Controls.Add(Type=constants.msoControlButton, Temporary=True) + # Hook events for the item + item = self.toolbarButton = DispatchWithEvents(item, ButtonEvent) + item.Caption = "Python" + item.TooltipText = "Click for Python" + item.Enabled = True + + # And now, for the sake of demonstration, setup a hook for all new messages + inbox = application.Session.GetDefaultFolder(constants.olFolderInbox) + self.inboxItems = DispatchWithEvents(inbox.Items, FolderEvent) + + def OnDisconnection(self, mode, custom): + print("OnDisconnection") + + def OnAddInsUpdate(self, custom): + print("OnAddInsUpdate", custom) + + def OnStartupComplete(self, custom): + print("OnStartupComplete", custom) + + def OnBeginShutdown(self, custom): + print("OnBeginShutdown", custom) + + +def RegisterAddin(klass): + import winreg + + key = winreg.CreateKey( + winreg.HKEY_CURRENT_USER, "Software\\Microsoft\\Office\\Outlook\\Addins" + ) + subkey = winreg.CreateKey(key, klass._reg_progid_) + winreg.SetValueEx(subkey, "CommandLineSafe", 0, winreg.REG_DWORD, 0) + winreg.SetValueEx(subkey, "LoadBehavior", 0, winreg.REG_DWORD, 3) + winreg.SetValueEx(subkey, "Description", 0, winreg.REG_SZ, klass._reg_progid_) + winreg.SetValueEx(subkey, "FriendlyName", 0, winreg.REG_SZ, klass._reg_progid_) + + +def UnregisterAddin(klass): + import winreg + + try: + winreg.DeleteKey( + winreg.HKEY_CURRENT_USER, + "Software\\Microsoft\\Office\\Outlook\\Addins\\" + klass._reg_progid_, + ) + except WindowsError: + pass + + +if __name__ == "__main__": + import win32com.server.register + + win32com.server.register.UseCommandLine(OutlookAddin) + if "--unregister" in sys.argv: + UnregisterAddin(OutlookAddin) + else: + RegisterAddin(OutlookAddin) diff --git a/lib/win32com/demos/trybag.py b/lib/win32com/demos/trybag.py new file mode 100644 index 00000000..3d3918b6 --- /dev/null +++ b/lib/win32com/demos/trybag.py @@ -0,0 +1,77 @@ +import pythoncom +from win32com.server import exception, util + +VT_EMPTY = pythoncom.VT_EMPTY + + +class Bag: + _public_methods_ = ["Read", "Write"] + _com_interfaces_ = [pythoncom.IID_IPropertyBag] + + def __init__(self): + self.data = {} + + def Read(self, propName, varType, errorLog): + print("read: name=", propName, "type=", varType) + if propName not in self.data: + if errorLog: + hr = 0x80070057 + exc = pythoncom.com_error(0, "Bag.Read", "no such item", None, 0, hr) + errorLog.AddError(propName, exc) + raise exception.Exception(scode=hr) + return self.data[propName] + + def Write(self, propName, value): + print("write: name=", propName, "value=", value) + self.data[propName] = value + + +class Target: + _public_methods_ = ["GetClassID", "InitNew", "Load", "Save"] + _com_interfaces_ = [pythoncom.IID_IPersist, pythoncom.IID_IPersistPropertyBag] + + def GetClassID(self): + raise exception.Exception(scode=0x80004005) # E_FAIL + + def InitNew(self): + pass + + def Load(self, bag, log): + print(bag.Read("prop1", VT_EMPTY, log)) + print(bag.Read("prop2", VT_EMPTY, log)) + try: + print(bag.Read("prop3", VT_EMPTY, log)) + except exception.Exception: + pass + + def Save(self, bag, clearDirty, saveAllProps): + bag.Write("prop1", "prop1.hello") + bag.Write("prop2", "prop2.there") + + +class Log: + _public_methods_ = ["AddError"] + _com_interfaces_ = [pythoncom.IID_IErrorLog] + + def AddError(self, propName, excepInfo): + print("error: propName=", propName, "error=", excepInfo) + + +def test(): + bag = Bag() + target = Target() + log = Log() + + target.Save(bag, 1, 1) + target.Load(bag, log) + + comBag = util.wrap(bag, pythoncom.IID_IPropertyBag) + comTarget = util.wrap(target, pythoncom.IID_IPersistPropertyBag) + comLog = util.wrap(log, pythoncom.IID_IErrorLog) + + comTarget.Save(comBag, 1, 1) + comTarget.Load(comBag, comLog) + + +if __name__ == "__main__": + test() diff --git a/lib/win32com/include/PythonCOM.h b/lib/win32com/include/PythonCOM.h new file mode 100644 index 00000000..e7599717 --- /dev/null +++ b/lib/win32com/include/PythonCOM.h @@ -0,0 +1,766 @@ +/* PythonCOM.h + + Main header for Python COM support. + + This file is involved mainly with client side COM support for + Python. + + Most COM work put together by Greg Stein and Mark Hammond, with a + few others starting to come out of the closet. + + + -------------------------------------------------------------------- + Thread State Rules + ------------------ + These rules apply to PythonCOM in general, and not just to + the client side. + + The rules are quite simple, but it is critical they be followed. + In general, errors here will be picked up quite quickly, as Python + will raise a Fatal Error. However, the Release() issue in particular + may keep a number of problems well hidden. + + Interfaces: + ----------- + Before making ANY call out to COM, you MUST release the Python lock. + This is true to ANY call whatsoever, including the COM call in question, + but also any calls to "->Release();" + + This is normally achieved with the calls + PY_INTERFACE_PRECALL and PY_INTERFACE_POSTCALL, which release + and acquire the Python lock. + + Gateways: + --------- + Before doing anything related to Python, gateways MUST acquire the + Python lock, and must release it before returning. + + This is normally achieved with PY_GATEWAY_METHOD at the top of a + gateway method. This macro resolves to a class, which automatically does + the right thing. + + Release: + -------- + As mentioned above for Interfaces, EVERY call to Release() must be done + with the Python lock released. This is expanded here. + + This is very important, but an error may not be noticed. The problem will + only be seen when the Release() is on a Python object and the Release() is the + final one for the object. In this case, the Python object will attempt to + acquire the Python lock before destroying itself, and Python will raise a + fatal error. + + In many many cases, you will not notice this error, but someday, someone will + implement the other side in Python, and suddenly FatalErrors will start + appearing. Make sure you get this right. + + Eg, this code is correct: + PY_INTERFACE_PRECALL; + pSomeObj->SomeFunction(pSomeOtherObject); + pSomeOtherObject->Release(); + PY_INTERFACE_POSTCALL; + + However, this code is WRONG, but will RARELY FAIL. + PY_INTERFACE_PRECALL; + pSomeObj->SomeFunction(pSomeOtherObject); + PY_INTERFACE_POSTCALL; + pSomeOtherObject->Release(); +-------------------------------------------------------------------- +*/ +#ifndef __PYTHONCOM_H__ +#define __PYTHONCOM_H__ + +// #define _DEBUG_LIFETIMES // Trace COM object lifetimes. + +#ifdef FREEZE_PYTHONCOM +/* The pythoncom module is being included in a frozen .EXE/.DLL */ +#define PYCOM_EXPORT +#else +#ifdef BUILD_PYTHONCOM +/* We are building pythoncomxx.dll */ +#define PYCOM_EXPORT __declspec(dllexport) +#else +/* This module uses pythoncomxx.dll */ +#define PYCOM_EXPORT __declspec(dllimport) +#ifndef _DEBUG +#pragma comment(lib, "pythoncom.lib") +#else +#pragma comment(lib, "pythoncom_d.lib") +#endif +#endif +#endif + +#ifdef MS_WINCE +// List of interfaces not supported by CE. +#define NO_PYCOM_IDISPATCHEX +#define NO_PYCOM_IPROVIDECLASSINFO +#define NO_PYCOM_IENUMGUID +#define NO_PYCOM_IENUMCATEGORYINFO +#define NO_PYCOM_ICATINFORMATION +#define NO_PYCOM_ICATREGISTER +#define NO_PYCOM_ISERVICEPROVIDER +#define NO_PYCOM_IPROPERTYSTORAGE +#define NO_PYCOM_IPROPERTYSETSTORAGE +#define NO_PYCOM_ENUMSTATPROPSTG + +#include "ocidl.h" +#include "oleauto.h" + +#endif // MS_WINCE + +#ifdef __MINGW32__ +// Special Mingw32 considerations. +#define NO_PYCOM_ENUMSTATPROPSTG +#define __try try +#define __except catch +#include + +#endif // __MINGW32__ + +#include // Standard Win32 Types + +#ifndef NO_PYCOM_IDISPATCHEX +#include // New header for IDispatchEx interface. +#endif // NO_PYCOM_IDISPATCHEX + +#if defined(MAINWIN) +// Mainwin seems to have 1/2 the VT_RECORD infrastructure in place +#if !defined(VT_RECORD) +#define VT_RECORD 36 +#define V_RECORDINFO(X) ((X)->brecVal.pRecInfo) +#define V_RECORD(X) ((X)->brecVal.pvRecord) +#else +#pragma message( \ + "MAINWIN appears to have grown correct VT_RECORD " \ + "support. Please update PythonCOM.h accordingly") +#endif // VT_RECORD +#endif // MAINWIN + +class PyIUnknown; +// To make life interesting/complicated, I use C++ classes for +// all Python objects. The main advantage is that I can derive +// a PyIDispatch object from a PyIUnknown, etc. This provides a +// clean C++ interface, and "automatically" provides all base +// Python methods to "derived" Python types. +// +// Main disadvantage is that any extension DLLs will need to include +// these headers, and link with this .lib +// +// Base class for (most of) the type objects. + +class PYCOM_EXPORT PyComTypeObject : public PyTypeObject { + public: + PyComTypeObject(const char *name, PyComTypeObject *pBaseType, Py_ssize_t typeSize, struct PyMethodDef *methodList, + PyIUnknown *(*thector)(IUnknown *)); + ~PyComTypeObject(); + + // is the given object an interface type object? (e.g. PyIUnknown) + static BOOL is_interface_type(PyObject *ob); + + public: + PyIUnknown *(*ctor)(IUnknown *); +}; + +// A type used for interfaces that can automatically provide enumerators +// (ie, they themselves aren't enumerable, but do have a suitable default +// method that returns a PyIEnum object +class PYCOM_EXPORT PyComEnumProviderTypeObject : public PyComTypeObject { + public: + PyComEnumProviderTypeObject(const char *name, PyComTypeObject *pBaseType, Py_ssize_t typeSize, + struct PyMethodDef *methodList, PyIUnknown *(*thector)(IUnknown *), + const char *enum_method_name); + static PyObject *iter(PyObject *self); + const char *enum_method_name; +}; + +// A type used for PyIEnum interfaces +class PYCOM_EXPORT PyComEnumTypeObject : public PyComTypeObject { + public: + static PyObject *iter(PyObject *self); + static PyObject *iternext(PyObject *self); + PyComEnumTypeObject(const char *name, PyComTypeObject *pBaseType, Py_ssize_t typeSize, struct PyMethodDef *methodList, + PyIUnknown *(*thector)(IUnknown *)); +}; + +// Very very base class - not COM specific - Should exist in the +// Python core somewhere, IMO. +class PYCOM_EXPORT PyIBase : public PyObject { + public: + // virtuals for Python support + virtual PyObject *getattr(char *name); + virtual int setattr(char *name, PyObject *v); + virtual PyObject *repr(); + virtual int compare(PyObject *other) + { + if (this == other) + return 0; + if (this < other) + return -1; + return 1; + } + // These iter are a little special, in that returning NULL means + // use the implementation in the type + virtual PyObject *iter() { return NULL; } + virtual PyObject *iternext() { return NULL; } + + protected: + PyIBase(); + virtual ~PyIBase(); + + public: + static BOOL is_object(PyObject *, PyComTypeObject *which); + BOOL is_object(PyComTypeObject *which); + static void dealloc(PyObject *ob); + static PyObject *repr(PyObject *ob); + static PyObject *getattro(PyObject *self, PyObject *name); + static int setattro(PyObject *op, PyObject *obname, PyObject *v); + static int cmp(PyObject *ob1, PyObject *ob2); + static PyObject *richcmp(PyObject *ob1, PyObject *ob2, int op); +}; + +/* Special Type objects */ +extern PYCOM_EXPORT PyTypeObject PyOleEmptyType; // equivalent to VT_EMPTY +extern PYCOM_EXPORT PyTypeObject PyOleMissingType; // special Python handling. +extern PYCOM_EXPORT PyTypeObject PyOleArgNotFoundType; // special VT_ERROR value +extern PYCOM_EXPORT PyTypeObject PyOleNothingType; // special VT_ERROR value + +// ALL of these set an appropriate Python error on bad return. + +// Given a Python object that is a registered COM type, return a given +// interface pointer on its underlying object, with a new reference added. +PYCOM_EXPORT BOOL PyCom_InterfaceFromPyObject(PyObject *ob, REFIID iid, LPVOID *ppv, BOOL bNoneOK = TRUE); + +// As above, but allows instance with "_oleobj_" attribute. +PYCOM_EXPORT BOOL PyCom_InterfaceFromPyInstanceOrObject(PyObject *ob, REFIID iid, LPVOID *ppv, BOOL bNoneOK = TRUE); + +// Release an arbitary COM pointer. +// NOTE: the PRECALL/POSTCALL stuff is probably not strictly necessary +// since the PyGILSTATE stuff has been in place (and even then, it only +// mattered when it was the last Release() on a Python implemented object) +#define PYCOM_RELEASE(pUnk) \ + { \ + if (pUnk) { \ + PY_INTERFACE_PRECALL; \ + (pUnk)->Release(); \ + PY_INTERFACE_POSTCALL; \ + } \ + } + +// Given an IUnknown and an Interface ID, create and return an object +// of the appropriate type. eg IID_Unknown->PyIUnknown, +// IID_IDispatch->PyIDispatch, etc. +// Uses a map that external extension DLLs can populate with their IID/type. +// Under the principal of least surprise, this will return Py_None is punk is NULL. +// Otherwise, a valid PyI*, but with NULL m_obj (and therefore totally useless) +// object would be created. +// BOOL bAddRef indicates if a COM reference count should be added to the IUnknown. +// This depends purely on the context in which it is called. If the IUnknown is obtained +// from a function that creates a new ref (eg, CoCreateInstance()) then you should use +// FALSE. If you receive the pointer as (eg) a param to a gateway function, then +// you normally need to pass TRUE, as this is truly a new reference. +// *** ALWAYS take the time to get this right. *** +PYCOM_EXPORT PyObject *PyCom_PyObjectFromIUnknown(IUnknown *punk, REFIID riid, BOOL bAddRef = FALSE); + +// VARIANT <-> PyObject conversion utilities. +PYCOM_EXPORT BOOL PyCom_VariantFromPyObject(PyObject *obj, VARIANT *var); +PYCOM_EXPORT PyObject *PyCom_PyObjectFromVariant(const VARIANT *var); + +// PROPVARIANT +PYCOM_EXPORT PyObject *PyObject_FromPROPVARIANT(PROPVARIANT *pVar); +PYCOM_EXPORT PyObject *PyObject_FromPROPVARIANTs(PROPVARIANT *pVars, ULONG cVars); +PYCOM_EXPORT BOOL PyObject_AsPROPVARIANT(PyObject *ob, PROPVARIANT *pVar); + +// Other conversion helpers... +PYCOM_EXPORT PyObject *PyCom_PyObjectFromSTATSTG(STATSTG *pStat); +PYCOM_EXPORT BOOL PyCom_PyObjectAsSTATSTG(PyObject *ob, STATSTG *pStat, DWORD flags = 0); +PYCOM_EXPORT BOOL PyCom_SAFEARRAYFromPyObject(PyObject *obj, SAFEARRAY **ppSA, VARENUM vt = VT_VARIANT); +PYCOM_EXPORT PyObject *PyCom_PyObjectFromSAFEARRAY(SAFEARRAY *psa, VARENUM vt = VT_VARIANT); +#ifndef NO_PYCOM_STGOPTIONS +PYCOM_EXPORT BOOL PyCom_PyObjectAsSTGOPTIONS(PyObject *obstgoptions, STGOPTIONS **ppstgoptions, TmpWCHAR *tmpw_shelve); +#endif +PYCOM_EXPORT PyObject *PyCom_PyObjectFromSTATPROPSETSTG(STATPROPSETSTG *pStat); +PYCOM_EXPORT BOOL PyCom_PyObjectAsSTATPROPSETSTG(PyObject *, STATPROPSETSTG *); + +// Currency support. +PYCOM_EXPORT PyObject *PyObject_FromCurrency(CURRENCY &cy); +PYCOM_EXPORT BOOL PyObject_AsCurrency(PyObject *ob, CURRENCY *pcy); + +// OLEMENUGROUPWIDTHS are used by axcontrol, shell, etc +PYCOM_EXPORT BOOL PyObject_AsOLEMENUGROUPWIDTHS(PyObject *oblpMenuWidths, OLEMENUGROUPWIDTHS *pWidths); +PYCOM_EXPORT PyObject *PyObject_FromOLEMENUGROUPWIDTHS(const OLEMENUGROUPWIDTHS *pWidths); + +/* Functions for Initializing COM, and also letting the core know about it! + */ +PYCOM_EXPORT HRESULT PyCom_CoInitializeEx(LPVOID reserved, DWORD dwInit); +PYCOM_EXPORT HRESULT PyCom_CoInitialize(LPVOID reserved); +PYCOM_EXPORT void PyCom_CoUninitialize(); + +/////////////////////////////////////////////////////////////////// +// Error related functions + +// Client related functions - generally called by interfaces before +// they return NULL back to Python to indicate the error. +// All these functions return NULL so interfaces can generally +// just "return PyCom_BuildPyException(hr, punk, IID_IWhatever)" + +// Uses the HRESULT, and IErrorInfo interfaces if available to +// create and set a pythoncom.com_error. +PYCOM_EXPORT PyObject *PyCom_BuildPyException(HRESULT hr, IUnknown *pUnk = NULL, REFIID iid = IID_NULL); + +// Uses the HRESULT and an EXCEPINFO structure to create and +// set a pythoncom.com_error. +PYCOM_EXPORT PyObject *PyCom_BuildPyExceptionFromEXCEPINFO(HRESULT hr, EXCEPINFO *pexcepInfo, UINT nArgErr = (UINT)-1); + +// Sets a pythoncom.internal_error - no one should ever see these! +PYCOM_EXPORT PyObject *PyCom_BuildInternalPyException(char *msg); + +// Log an error to a Python logger object if one can be found, or +// to stderr if no log available. +// If logProvider is not NULL, we will call a "_GetLogger_()" method on it. +// If logProvider is NULL, we attempt to fetch "win32com.logger". +// If they do not exist, return None, or raise an error fetching them +// (or even writing to them once fetched), the message still goes to stderr. +// NOTE: By default, win32com does *not* provide a logger, so default is that +// all errors are written to stdout. +// This will *not* write a record if a COM Server error is current. +PYCOM_EXPORT void PyCom_LoggerNonServerException(PyObject *logProvider, const WCHAR *fmt, ...); + +// Write an error record, including exception. This will write an error +// record even if a COM server error is current. +PYCOM_EXPORT void PyCom_LoggerException(PyObject *logProvider, const WCHAR *fmt, ...); + +// Write a warning record - in general this does *not* mean a call failed, but +// still is something in the programmers control that they should change. +// XXX - if an exception is pending when this is called, the traceback will +// also be written. This is undesirable and will be changed should this +// start being a problem. +PYCOM_EXPORT void PyCom_LoggerWarning(PyObject *logProvider, const WCHAR *fmt, ...); + +// Server related error functions +// These are supplied so that any Python errors we detect can be +// converted into COM error information. The HRESULT returned should +// be returned by the COM function, and these functions also set the +// IErrorInfo interfaces, so the caller can extract more detailed +// information about the Python exception. + +// Set a COM exception, logging the exception if not an explicitly raised 'server' exception +PYCOM_EXPORT HRESULT PyCom_SetAndLogCOMErrorFromPyException(const char *methodName, REFIID riid /* = IID_NULL */); +PYCOM_EXPORT HRESULT PyCom_SetAndLogCOMErrorFromPyExceptionEx(PyObject *provider, const char *methodName, + REFIID riid /* = IID_NULL */); + +// Used in gateways to SetErrorInfo() with a simple HRESULT, then return it. +// The description is generally only useful for debugging purposes, +// and if you are debugging via a server that supports IErrorInfo (like Python :-) +// NOTE: this function is usuable from outside the Python context +PYCOM_EXPORT HRESULT PyCom_SetCOMErrorFromSimple(HRESULT hr, REFIID riid = IID_NULL, const WCHAR *description = NULL); + +// Used in gateways to check if an IEnum*'s Next() or Clone() method worked. +PYCOM_EXPORT HRESULT PyCom_CheckIEnumNextResult(HRESULT hr, REFIID riid); + +// Used in gateways when an enumerator expected a sequence but didn't get it. +PYCOM_EXPORT HRESULT PyCom_HandleIEnumNoSequence(REFIID riid); + +// Used in gateways to SetErrorInfo() the current Python exception, and +// (assuming not a server error explicitly raised) also logs an error +// to stdout/win32com.logger. +// NOTE: this function assumes GIL held +PYCOM_EXPORT HRESULT PyCom_SetCOMErrorFromPyException(REFIID riid = IID_NULL); + +// A couple of EXCEPINFO helpers - could be private to IDispatch +// if it wasnt for the AXScript support (and ITypeInfo if we get around to that :-) +// These functions do not set any error states to either Python or +// COM - they simply convert to/from PyObjects and EXCEPINFOs + +// Use the current Python exception to fill an EXCEPINFO structure. +PYCOM_EXPORT void PyCom_ExcepInfoFromPyException(EXCEPINFO *pExcepInfo); + +// Fill in an EXCEPINFO structure from a Python instance or tuple object. +// (ie, similar to the above, except the Python exception object is specified, +// rather than using the "current" +PYCOM_EXPORT BOOL PyCom_ExcepInfoFromPyObject(PyObject *obExcepInfo, EXCEPINFO *pexcepInfo, HRESULT *phresult = NULL); + +// Create a Python object holding the exception information. The exception +// information is *not* freed by this function. Python exceptions are +// raised and NULL is returned if an error occurs. +PYCOM_EXPORT PyObject *PyCom_PyObjectFromExcepInfo(const EXCEPINFO *pexcepInfo); + +/////////////////////////////////////////////////////////////////// +// +// External C++ helpers - these helpers are for other DLLs which +// may need similar functionality, but dont want to duplicate all + +// This helper is for an application that has an IDispatch, and COM arguments +// and wants to call a Python function. It is assumed the caller can map the IDispatch +// to a Python object, so the Python handler is passed. +// Args: +// handler : A Python callable object. +// dispparms : the COM arguments. +// pVarResult : The variant for the return value of the Python call. +// pexcepinfo : Exception info the helper may fill out. +// puArgErr : Argument error the helper may fill out on exception +// addnArgs : Any additional arguments to the Python function. May be NULL. +// If addnArgs is NULL, then it is assumed the Python call should be native - +// ie, the COM args are packed as normal Python args to the call. +// If addnArgs is NOT NULL, it is assumed the Python function itself is +// a helper. This Python function will be called with 2 arguments - both +// tuples - first one is the COM args, second is the addn args. +PYCOM_EXPORT BOOL PyCom_MakeOlePythonCall(PyObject *handler, DISPPARAMS FAR *params, VARIANT FAR *pVarResult, + EXCEPINFO FAR *pexcepinfo, UINT FAR *puArgErr, PyObject *addnlArgs); + +///////////////////////////////////////////////////////////////////////////// +// Various special purpose singletons +class PYCOM_EXPORT PyOleEmpty : public PyObject { + public: + PyOleEmpty(); +}; + +class PYCOM_EXPORT PyOleMissing : public PyObject { + public: + PyOleMissing(); +}; + +class PYCOM_EXPORT PyOleArgNotFound : public PyObject { + public: + PyOleArgNotFound(); +}; + +class PYCOM_EXPORT PyOleNothing : public PyObject { + public: + PyOleNothing(); +}; + +// We need to dynamically create C++ Python objects +// These helpers allow each type object to create it. +#define MAKE_PYCOM_CTOR(classname) \ + static PyIUnknown *PyObConstruct(IUnknown *pInitObj) { return new classname(pInitObj); } +#define MAKE_PYCOM_CTOR_ERRORINFO(classname, iid) \ + static PyIUnknown *PyObConstruct(IUnknown *pInitObj) { return new classname(pInitObj); } \ + static PyObject *SetPythonCOMError(PyObject *self, HRESULT hr) \ + { \ + return PyCom_BuildPyException(hr, GetI(self), iid); \ + } +#define GET_PYCOM_CTOR(classname) classname::PyObConstruct + +// Macros that interfaces should use. PY_INTERFACE_METHOD at the top of the method +// The other 2 wrap directly around the underlying method call. +#define PY_INTERFACE_METHOD +// Identical to Py_BEGIN_ALLOW_THREADS except no { !!! +#define PY_INTERFACE_PRECALL PyThreadState *_save = PyEval_SaveThread(); +#define PY_INTERFACE_POSTCALL PyEval_RestoreThread(_save); + +///////////////////////////////////////////////////////////////////////////// +// class PyIUnknown +class PYCOM_EXPORT PyIUnknown : public PyIBase { + public: + MAKE_PYCOM_CTOR(PyIUnknown); + virtual PyObject *repr(); + virtual int compare(PyObject *other); + + static IUnknown *GetI(PyObject *self); + IUnknown *m_obj; + static char *szErrMsgObjectReleased; + static void SafeRelease(PyIUnknown *ob); + static PyComTypeObject type; + + // The Python methods + static PyObject *QueryInterface(PyObject *self, PyObject *args); + static PyObject *SafeRelease(PyObject *self, PyObject *args); + + protected: + PyIUnknown(IUnknown *punk); + ~PyIUnknown(); +}; + +///////////////////////////////////////////////////////////////////////////// +// class PyIDispatch + +class PYCOM_EXPORT PyIDispatch : public PyIUnknown { + public: + MAKE_PYCOM_CTOR(PyIDispatch); + static IDispatch *GetI(PyObject *self); + static PyComTypeObject type; + + // The Python methods + static PyObject *Invoke(PyObject *self, PyObject *args); + static PyObject *InvokeTypes(PyObject *self, PyObject *args); + static PyObject *GetIDsOfNames(PyObject *self, PyObject *args); + static PyObject *GetTypeInfo(PyObject *self, PyObject *args); + static PyObject *GetTypeInfoCount(PyObject *self, PyObject *args); + + protected: + PyIDispatch(IUnknown *pdisp); + ~PyIDispatch(); +}; + +#ifndef NO_PYCOM_IDISPATCHEX +///////////////////////////////////////////////////////////////////////////// +// class PyIDispatchEx + +class PYCOM_EXPORT PyIDispatchEx : public PyIDispatch { + public: + MAKE_PYCOM_CTOR_ERRORINFO(PyIDispatchEx, IID_IDispatchEx); + static IDispatchEx *GetI(PyObject *self); + static PyComTypeObject type; + + // The Python methods + static PyObject *GetDispID(PyObject *self, PyObject *args); + static PyObject *InvokeEx(PyObject *self, PyObject *args); + static PyObject *DeleteMemberByName(PyObject *self, PyObject *args); + static PyObject *DeleteMemberByDispID(PyObject *self, PyObject *args); + static PyObject *GetMemberProperties(PyObject *self, PyObject *args); + static PyObject *GetMemberName(PyObject *self, PyObject *args); + static PyObject *GetNextDispID(PyObject *self, PyObject *args); + + protected: + PyIDispatchEx(IUnknown *pdisp); + ~PyIDispatchEx(); +}; +#endif // NO_PYCOM_IDISPATCHEX + +///////////////////////////////////////////////////////////////////////////// +// class PyIClassFactory + +class PYCOM_EXPORT PyIClassFactory : public PyIUnknown { + public: + MAKE_PYCOM_CTOR(PyIClassFactory); + static IClassFactory *GetI(PyObject *self); + static PyComTypeObject type; + + // The Python methods + static PyObject *CreateInstance(PyObject *self, PyObject *args); + static PyObject *LockServer(PyObject *self, PyObject *args); + + protected: + PyIClassFactory(IUnknown *pdisp); + ~PyIClassFactory(); +}; + +#ifndef NO_PYCOM_IPROVIDECLASSINFO + +///////////////////////////////////////////////////////////////////////////// +// class PyIProvideTypeInfo + +class PYCOM_EXPORT PyIProvideClassInfo : public PyIUnknown { + public: + MAKE_PYCOM_CTOR(PyIProvideClassInfo); + static IProvideClassInfo *GetI(PyObject *self); + static PyComTypeObject type; + + // The Python methods + static PyObject *GetClassInfo(PyObject *self, PyObject *args); + + protected: + PyIProvideClassInfo(IUnknown *pdisp); + ~PyIProvideClassInfo(); +}; + +class PYCOM_EXPORT PyIProvideClassInfo2 : public PyIProvideClassInfo { + public: + MAKE_PYCOM_CTOR(PyIProvideClassInfo2); + static IProvideClassInfo2 *GetI(PyObject *self); + static PyComTypeObject type; + + // The Python methods + static PyObject *GetGUID(PyObject *self, PyObject *args); + + protected: + PyIProvideClassInfo2(IUnknown *pdisp); + ~PyIProvideClassInfo2(); +}; +#endif // NO_PYCOM_IPROVIDECLASSINFO + +///////////////////////////////////////////////////////////////////////////// +// class PyITypeInfo +class PYCOM_EXPORT PyITypeInfo : public PyIUnknown { + public: + MAKE_PYCOM_CTOR(PyITypeInfo); + static PyComTypeObject type; + static ITypeInfo *GetI(PyObject *self); + + PyObject *GetContainingTypeLib(); + PyObject *GetDocumentation(MEMBERID); + PyObject *GetRefTypeInfo(HREFTYPE href); + PyObject *GetRefTypeOfImplType(int index); + PyObject *GetFuncDesc(int pos); + PyObject *GetIDsOfNames(OLECHAR FAR *FAR *, int); + PyObject *GetNames(MEMBERID); + PyObject *GetTypeAttr(); + PyObject *GetVarDesc(int pos); + PyObject *GetImplTypeFlags(int index); + PyObject *GetTypeComp(); + + protected: + PyITypeInfo(IUnknown *); + ~PyITypeInfo(); +}; + +///////////////////////////////////////////////////////////////////////////// +// class PyITypeComp +class PYCOM_EXPORT PyITypeComp : public PyIUnknown { + public: + MAKE_PYCOM_CTOR(PyITypeComp); + static PyComTypeObject type; + static ITypeComp *GetI(PyObject *self); + + PyObject *Bind(OLECHAR *szName, unsigned short wflags); + PyObject *BindType(OLECHAR *szName); + + protected: + PyITypeComp(IUnknown *); + ~PyITypeComp(); +}; + +///////////////////////////////////////////////////////////////////////////// +// class CPyTypeLib + +class PYCOM_EXPORT PyITypeLib : public PyIUnknown { + public: + MAKE_PYCOM_CTOR(PyITypeLib); + static PyComTypeObject type; + static ITypeLib *GetI(PyObject *self); + + PyObject *GetLibAttr(); + PyObject *GetDocumentation(int pos); + PyObject *GetTypeInfo(int pos); + PyObject *GetTypeInfoCount(); + PyObject *GetTypeInfoOfGuid(REFGUID guid); + PyObject *GetTypeInfoType(int pos); + PyObject *GetTypeComp(); + + protected: + PyITypeLib(IUnknown *); + ~PyITypeLib(); +}; + +///////////////////////////////////////////////////////////////////////////// +// class PyIConnectionPoint + +class PYCOM_EXPORT PyIConnectionPoint : public PyIUnknown { + public: + MAKE_PYCOM_CTOR_ERRORINFO(PyIConnectionPoint, IID_IConnectionPoint); + static PyComTypeObject type; + static IConnectionPoint *GetI(PyObject *self); + + static PyObject *GetConnectionInterface(PyObject *self, PyObject *args); + static PyObject *GetConnectionPointContainer(PyObject *self, PyObject *args); + static PyObject *Advise(PyObject *self, PyObject *args); + static PyObject *Unadvise(PyObject *self, PyObject *args); + static PyObject *EnumConnections(PyObject *self, PyObject *args); + + protected: + PyIConnectionPoint(IUnknown *); + ~PyIConnectionPoint(); +}; + +class PYCOM_EXPORT PyIConnectionPointContainer : public PyIUnknown { + public: + MAKE_PYCOM_CTOR_ERRORINFO(PyIConnectionPointContainer, IID_IConnectionPointContainer); + static PyComTypeObject type; + static IConnectionPointContainer *GetI(PyObject *self); + + static PyObject *EnumConnectionPoints(PyObject *self, PyObject *args); + static PyObject *FindConnectionPoint(PyObject *self, PyObject *args); + + protected: + PyIConnectionPointContainer(IUnknown *); + ~PyIConnectionPointContainer(); +}; + +///////////////////////////////////////////////////////////////////////////// +// class PythonOleArgHelper +// +// A PythonOleArgHelper is used primarily to help out Python helpers +// which need to convert from a Python object when the specific OLE +// type is known - eg, when a TypeInfo is available. +// +// The type of conversion determines who owns what buffers etc. I wish BYREF didnt exist :-) +typedef enum { + // We dont know what sort of conversion it is yet. + POAH_CONVERT_UNKNOWN, + // A PyObject is given, we convert to a VARIANT, make the COM call, then BYREFs back to a PyObject + // ie, this is typically a "normal" COM call, where Python initiates the call + POAH_CONVERT_FROM_PYOBJECT, + // A VARIANT is given, we convert to a PyObject, make the Python call, then BYREFs back to a VARIANT. + // ie, this is typically handling a COM event, where COM itself initiates the call. + POAH_CONVERT_FROM_VARIANT, +} POAH_CONVERT_DIRECTION; + +class PYCOM_EXPORT PythonOleArgHelper { + public: + PythonOleArgHelper(); + ~PythonOleArgHelper(); + BOOL ParseTypeInformation(PyObject *reqdObjectTuple); + + // Using this call with reqdObject != NULL will check the existing + // VT_ of the variant. If not VT_EMPTY, then the result will be coerced to + // that type. This contrasts with PyCom_PyObjectToVariant which just + // uses the Python type to determine the variant type. + BOOL MakeObjToVariant(PyObject *obj, VARIANT *var, PyObject *reqdObjectTuple = NULL); + PyObject *MakeVariantToObj(VARIANT *var); + + VARTYPE m_reqdType; + BOOL m_bParsedTypeInfo; + BOOL m_bIsOut; + POAH_CONVERT_DIRECTION m_convertDirection; + PyObject *m_pyVariant; // if non-null, a win32com.client.VARIANT + union { + void *m_pValueHolder; + short m_sBuf; + long m_lBuf; + LONGLONG m_llBuf; + VARIANT_BOOL m_boolBuf; + double m_dBuf; + float m_fBuf; + IDispatch *m_dispBuf; + IUnknown *m_unkBuf; + SAFEARRAY *m_arrayBuf; + VARIANT *m_varBuf; + DATE m_dateBuf; + CY m_cyBuf; + }; +}; + +///////////////////////////////////////////////////////////////////////////// +// global functions and variables +PYCOM_EXPORT BOOL MakePythonArgumentTuples(PyObject **pArgs, PythonOleArgHelper **ppHelpers, PyObject **pNamedArgs, + PythonOleArgHelper **ppNamedHelpers, DISPPARAMS FAR *params); + +// Convert a Python object to a BSTR - allow embedded NULLs, None, etc. +PYCOM_EXPORT BOOL PyCom_BstrFromPyObject(PyObject *stringObject, BSTR *pResult, BOOL bNoneOK = FALSE); + +// MakeBstrToObj - convert a BSTR into a Python string. +// +// ONLY USE THIS FOR TRUE BSTR's - Use the fn below for OLECHAR *'s. +// NOTE - does not use standard macros, so NULLs get through! +PYCOM_EXPORT PyObject *MakeBstrToObj(const BSTR bstr); + +// Size info is available (eg, a fn returns a string and also fills in a size variable) +PYCOM_EXPORT PyObject *MakeOLECHARToObj(const OLECHAR *str, int numChars); + +// No size info avail. +PYCOM_EXPORT PyObject *MakeOLECHARToObj(const OLECHAR *str); + +PYCOM_EXPORT void PyCom_LogF(const WCHAR *fmt, ...); + +// Generic conversion from python sequence to VT_VECTOR array +// Resulting array must be freed with CoTaskMemFree +template +BOOL SeqToVector(PyObject *ob, arraytype **pA, ULONG *pcount, BOOL (*converter)(PyObject *, arraytype *)) +{ + TmpPyObject seq = PyWinSequence_Tuple(ob, pcount); + if (seq == NULL) + return FALSE; + *pA = (arraytype *)CoTaskMemAlloc(*pcount * sizeof(arraytype)); + if (*pA == NULL) { + PyErr_NoMemory(); + return FALSE; + } + for (ULONG i = 0; i < *pcount; i++) { + PyObject *item = PyTuple_GET_ITEM((PyObject *)seq, i); + if (!(*converter)(item, &(*pA)[i])) + return FALSE; + } + return TRUE; +} + +#endif // __PYTHONCOM_H__ diff --git a/lib/win32com/include/PythonCOMRegister.h b/lib/win32com/include/PythonCOMRegister.h new file mode 100644 index 00000000..ab960f53 --- /dev/null +++ b/lib/win32com/include/PythonCOMRegister.h @@ -0,0 +1,84 @@ +// Support for PythonCOM and its extensions to register the interfaces, +// gateways and IIDs it supports. +// +// The module can simply declare an array of type PyCom_InterfaceSupportInfo, then +// use the macros to populate it. +// +// See Register.cpp and AXScript.cpp for examples on its use. + +#ifndef __PYTHONCOMREGISTER_H__ +#define __PYTHONCOMREGISTER_H__ + +#include "PythonCOMServer.h" // Need defns in this file... + +typedef struct { + const GUID *pGUID; // The supported IID - required + const char *interfaceName; // Name of the interface - required + const char *iidName; // Name of the IID that goes into the dict. - required + PyTypeObject *pTypeOb; // the type object for client PyI* side - NULL for server only support. + pfnPyGatewayConstructor ctor; // Gateway (PyG*) interface constructor - NULL for client only support + +} PyCom_InterfaceSupportInfo; + +#define PYCOM_INTERFACE_IID_ONLY(ifc) \ + { \ + &IID_I##ifc, "I" #ifc, "IID_I" #ifc, NULL, NULL \ + } +#define PYCOM_INTERFACE_CLSID_ONLY(ifc) \ + { \ + &CLSID_##ifc, "CLSID_" #ifc, "CLSID_" #ifc, NULL, NULL \ + } +#define PYCOM_INTERFACE_CATID_ONLY(ifc) \ + { \ + &CATID_##ifc, "CATID_" #ifc, "CATID_" #ifc, NULL, NULL \ + } +#define PYCOM_INTERFACE_CLIENT_ONLY(ifc) \ + { \ + &IID_I##ifc, "I" #ifc, "IID_I" #ifc, &PyI##ifc::type, NULL \ + } +#define PYCOM_INTERFACE_SERVER_ONLY(ifc) \ + { \ + &IID_I##ifc, "I" #ifc, "IID_I" #ifc, NULL, GET_PYGATEWAY_CTOR(PyG##ifc) \ + } +#define PYCOM_INTERFACE_FULL(ifc) \ + { \ + &IID_I##ifc, "I" #ifc, "IID_I" #ifc, &PyI##ifc::type, GET_PYGATEWAY_CTOR(PyG##ifc) \ + } + +// Versions that use __uuidof() to get the IID, which seems to avoid the need +// to link with a lib holding the IIDs. Note that almost all extensions +// build with __uuidof() being the default; the build failed at 'shell' - so +// we could consider making this the default and making the 'explicit' version +// above the special case. +#define PYCOM_INTERFACE_IID_ONLY_UUIDOF(ifc) \ + { \ + &__uuidof(I##ifc), "I" #ifc, "IID_I" #ifc, NULL, NULL \ + } +#define PYCOM_INTERFACE_CLIENT_ONLY_UUIDOF(ifc) \ + { \ + &__uuidof(I##ifc), "I" #ifc, "IID_I" #ifc, &PyI##ifc::type, NULL \ + } +#define PYCOM_INTERFACE_SERVER_ONLY_UUIDOF(ifc) \ + { \ + &__uuidof(I##ifc), "I" #ifc, "IID_I" #ifc, NULL, GET_PYGATEWAY_CTOR(PyG##ifc) \ + } +#define PYCOM_INTERFACE_FULL_UUIDOF(ifc) \ + { \ + &__uuidof(I##ifc), "I" #ifc, "IID_I" #ifc, &PyI##ifc::type, GET_PYGATEWAY_CTOR(PyG##ifc) \ + } + +// Prototypes for the register functions + +// Register a PythonCOM extension module +PYCOM_EXPORT int PyCom_RegisterExtensionSupport(PyObject *dict, const PyCom_InterfaceSupportInfo *pInterfaces, + int numEntries); + +// THESE SHOULD NO LONGER BE USED. Instead, use the functions above passing an +// array of PyCom_InterfaceSupportInfo objects. + +PYCOM_EXPORT int PyCom_RegisterClientType(PyTypeObject *typeOb, const GUID *guid); + +HRESULT PYCOM_EXPORT PyCom_RegisterGatewayObject(REFIID iid, pfnPyGatewayConstructor ctor, const char *interfaceName); +PYCOM_EXPORT int PyCom_IsGatewayRegistered(REFIID iid); + +#endif /* __PYTHONCOMREGISTER_H__ */ diff --git a/lib/win32com/include/PythonCOMServer.h b/lib/win32com/include/PythonCOMServer.h new file mode 100644 index 00000000..d263b3ad --- /dev/null +++ b/lib/win32com/include/PythonCOMServer.h @@ -0,0 +1,176 @@ +#ifndef __PYTHONCOMSERVER_H__ +#define __PYTHONCOMSERVER_H__ + +// PythonCOMServer.h :Server side COM support + +#include + +#define DLLAcquireGlobalLock PyWin_AcquireGlobalLock +#define DLLReleaseGlobalLock PyWin_ReleaseGlobalLock + +void PYCOM_EXPORT PyCom_DLLAddRef(void); +void PYCOM_EXPORT PyCom_DLLReleaseRef(void); + +// Use this macro at the start of all gateway methods. +#define PY_GATEWAY_METHOD CEnterLeavePython _celp + +class PyGatewayBase; +// Gateway constructors. +// Each gateway must be able to be created from a "gateway constructor". This +// is simply a function that takes a Python instance as as argument, and returns +// a gateway object of the correct type. The MAKE_PYGATEWAY_CTOR is a helper that +// will embed such a constructor in the class - however, this is not necessary - +// _any_ function of the correct signature can be used. + +typedef HRESULT (*pfnPyGatewayConstructor)(PyObject *PythonInstance, PyGatewayBase *, void **ppResult, REFIID iid); +HRESULT PyCom_MakeRegisteredGatewayObject(REFIID iid, PyObject *instance, PyGatewayBase *base, void **ppv); + +// A version of the above which support classes being derived from +// other than IUnknown +#define PYGATEWAY_MAKE_SUPPORT2(classname, IInterface, theIID, gatewaybaseclass) \ + public: \ + static HRESULT PyGatewayConstruct(PyObject *pPyInstance, PyGatewayBase *unkBase, void **ppResult, \ + REFIID iid) \ + { \ + if (ppResult == NULL) \ + return E_INVALIDARG; \ + classname *newob = new classname(pPyInstance); \ + newob->m_pBaseObject = unkBase; \ + if (unkBase) \ + unkBase->AddRef(); \ + *ppResult = newob->ThisAsIID(iid); \ + return *ppResult ? S_OK : E_OUTOFMEMORY; \ + } \ + \ + protected: \ + virtual IID GetIID(void) { return theIID; } \ + virtual void *ThisAsIID(IID iid) \ + { \ + if (this == NULL) \ + return NULL; \ + if (iid == theIID) \ + return (IInterface *)this; \ + else \ + return gatewaybaseclass::ThisAsIID(iid); \ + } \ + STDMETHOD_(ULONG, AddRef)(void) { return gatewaybaseclass::AddRef(); } \ + STDMETHOD_(ULONG, Release)(void) { return gatewaybaseclass::Release(); } \ + STDMETHOD(QueryInterface)(REFIID iid, void **obj) { return gatewaybaseclass::QueryInterface(iid, obj); }; + +// This is the "old" version to use, or use it if you derive +// directly from PyGatewayBase +#define PYGATEWAY_MAKE_SUPPORT(classname, IInterface, theIID) \ + PYGATEWAY_MAKE_SUPPORT2(classname, IInterface, theIID, PyGatewayBase) + +#define GET_PYGATEWAY_CTOR(classname) classname::PyGatewayConstruct + +#ifdef _MSC_VER +// Disable an OK warning... +#pragma warning(disable : 4275) +// warning C4275: non dll-interface struct 'IDispatch' used as base for dll-interface class 'PyGatewayBase' +#endif // _MSC_VER + +// Helper interface for fetching a Python object from a gateway + +extern const GUID IID_IInternalUnwrapPythonObject; + +interface IInternalUnwrapPythonObject : public IUnknown +{ + public: + STDMETHOD(Unwrap)(PyObject * *ppPyObject) = 0; +}; + +///////////////////////////////////////////////////////////////////////////// +// PyGatewayBase +// +// Base class for all gateways. +// +class PYCOM_EXPORT PyGatewayBase : +#ifndef NO_PYCOM_IDISPATCHEX + public IDispatchEx, // IDispatch comes along for the ride! +#else + public IDispatch, // No IDispatchEx - must explicitely use IDispatch +#endif + public ISupportErrorInfo, + public IInternalUnwrapPythonObject { + protected: + PyGatewayBase(PyObject *instance); + virtual ~PyGatewayBase(); + + // Invoke the Python method (via the policy object) + STDMETHOD(InvokeViaPolicy)(const char *szMethodName, PyObject **ppResult = NULL, const char *szFormat = NULL, ...); + + public: + // IUnknown + STDMETHOD_(ULONG, AddRef)(void); + STDMETHOD_(ULONG, Release)(void); + STDMETHOD(QueryInterface)(REFIID iid, void **obj); + + // IDispatch + STDMETHOD(GetTypeInfoCount)(UINT FAR *pctInfo); + STDMETHOD(GetTypeInfo)(UINT itinfo, LCID lcid, ITypeInfo FAR *FAR *pptInfo); + STDMETHOD(GetIDsOfNames)(REFIID refiid, OLECHAR FAR *FAR *rgszNames, UINT cNames, LCID lcid, DISPID FAR *rgdispid); + STDMETHOD(Invoke) + (DISPID dispid, REFIID riid, LCID lcid, WORD wFlags, DISPPARAMS FAR *params, VARIANT FAR *pVarResult, + EXCEPINFO FAR *pexcepinfo, UINT FAR *puArgErr); + + // IDispatchEx +#ifndef NO_PYCOM_IDISPATCHEX + STDMETHOD(GetDispID)(BSTR bstrName, DWORD grfdex, DISPID *pid); + STDMETHOD(InvokeEx) + (DISPID id, LCID lcid, WORD wFlags, DISPPARAMS *pdp, VARIANT *pvarRes, EXCEPINFO *pei, IServiceProvider *pspCaller); + STDMETHOD(DeleteMemberByName)(BSTR bstr, DWORD grfdex); + STDMETHOD(DeleteMemberByDispID)(DISPID id); + STDMETHOD(GetMemberProperties)(DISPID id, DWORD grfdexFetch, DWORD *pgrfdex); + STDMETHOD(GetMemberName)(DISPID id, BSTR *pbstrName); + STDMETHOD(GetNextDispID)(DWORD grfdex, DISPID id, DISPID *pid); + STDMETHOD(GetNameSpaceParent)(IUnknown **ppunk); +#endif // NO_PYCOM_IDISPATCHEX + // ISupportErrorInfo + STDMETHOD(InterfaceSupportsErrorInfo)(REFIID riid); + + // IInternalUnwrapPythonObject + STDMETHOD(Unwrap)(PyObject **ppPyObject); + + // Basically just PYGATEWAY_MAKE_SUPPORT(PyGatewayBase, IDispatch, IID_IDispatch); + // but with special handling as its the base class. + static HRESULT PyGatewayConstruct(PyObject *pPyInstance, PyGatewayBase *gatewayBase, void **ppResult, + REFIID iid) + { + if (ppResult == NULL) + return E_INVALIDARG; + PyGatewayBase *obNew = new PyGatewayBase(pPyInstance); + obNew->m_pBaseObject = gatewayBase; + if (gatewayBase) + gatewayBase->AddRef(); + *ppResult = (IDispatch *)obNew; + return *ppResult ? S_OK : E_OUTOFMEMORY; + } + // Currently this is used only for ISupportErrorInfo, + // so hopefully this will never be called in this base class. + // (however, this is not a rule, so we wont assert or anything!) + virtual IID GetIID(void) { return IID_IUnknown; } + virtual void *ThisAsIID(IID iid); + // End of PYGATEWAY_MAKE_SUPPORT + PyObject *m_pPyObject; + PyGatewayBase *m_pBaseObject; + + private: + LONG m_cRef; +}; + +#ifdef _MSC_VER +#pragma warning(default : 4275) +#endif // _MSC_VER + +// B/W compat hack for gateways. +#define PyCom_HandlePythonFailureToCOM() \ + PyCom_SetAndLogCOMErrorFromPyExceptionEx(this->m_pPyObject, "", GetIID()) + +// F/W compat hack for gateways! Must be careful about updating +// PyGatewayBase vtable, so a slightly older pythoncomXX.dll will work +// with slightly later extensions. So use a #define. +#define MAKE_PYCOM_GATEWAY_FAILURE_CODE(method_name) \ + PyCom_SetAndLogCOMErrorFromPyExceptionEx(this->m_pPyObject, method_name, GetIID()) + +#endif /* __PYTHONCOMSERVER_H__ */ diff --git a/lib/win32com/makegw/__init__.py b/lib/win32com/makegw/__init__.py new file mode 100644 index 00000000..6178c97c --- /dev/null +++ b/lib/win32com/makegw/__init__.py @@ -0,0 +1 @@ +# indicates a python package. diff --git a/lib/win32com/makegw/makegw.py b/lib/win32com/makegw/makegw.py new file mode 100644 index 00000000..8d2e83d6 --- /dev/null +++ b/lib/win32com/makegw/makegw.py @@ -0,0 +1,560 @@ +"""Utility functions for writing out gateway C++ files + + This module will generate a C++/Python binding for a specific COM + interface. + + At this stage, no command line interface exists. You must start Python, + import this module, change to the directory where the generated code should + be written, and run the public function. + + This module is capable of generating both 'Interfaces' (ie, Python + client side support for the interface) and 'Gateways' (ie, Python + server side support for the interface). Many COM interfaces are useful + both as Client and Server. Other interfaces, however, really only make + sense to implement one side or the other. For example, it would be pointless + for Python to implement Server side for 'IRunningObjectTable', unless we were + implementing core COM for an operating system in Python (hey - now there's an idea!) + + Most COM interface code is totally boiler-plate - it consists of + converting arguments, dispatching the call to Python, and processing + any result values. + + This module automates the generation of such code. It has the ability to + parse a .H file generated by the MIDL tool (ie, almost all COM .h files) + and build almost totally complete C++ code. + + The module understands some of the well known data types, and how to + convert them. There are only a couple of places where hand-editing is + necessary, as detailed below: + + unsupported types -- If a type is not known, the generator will + pretty much ignore it, but write a comment to the generated code. You + may want to add custom support for this type. In some cases, C++ compile errors + will result. These are intentional - generating code to remove these errors would + imply a false sense of security that the generator has done the right thing. + + other return policies -- By default, Python never sees the return SCODE from + a COM function. The interface usually returns None if OK, else a COM exception + if "FAILED(scode)" is TRUE. You may need to change this if: + * EXCEPINFO is passed to the COM function. This is not detected and handled + * For some reason Python should always see the result SCODE, even if it + did fail or succeed. For example, some functions return a BOOLEAN result + in the SCODE, meaning Python should always see it. + * FAILED(scode) for the interface still has valid data to return (by default, + the code generated does not process the return values, and raise an exception + to Python/COM + +""" + +import re + +from . import makegwparse + + +def make_framework_support( + header_file_name, interface_name, bMakeInterface=1, bMakeGateway=1 +): + """Generate C++ code for a Python Interface and Gateway + + header_file_name -- The full path to the .H file which defines the interface. + interface_name -- The name of the interface to search for, and to generate. + bMakeInterface = 1 -- Should interface (ie, client) support be generated. + bMakeGatewayInterface = 1 -- Should gateway (ie, server) support be generated. + + This method will write a .cpp and .h file into the current directory, + (using the name of the interface to build the file name. + + """ + fin = open(header_file_name) + try: + interface = makegwparse.parse_interface_info(interface_name, fin) + finally: + fin.close() + + if bMakeInterface and bMakeGateway: + desc = "Interface and Gateway" + elif bMakeInterface and not bMakeGateway: + desc = "Interface" + else: + desc = "Gateway" + if interface.name[:5] == "IEnum": # IEnum - use my really simple template-based one + import win32com.makegw.makegwenum + + ifc_cpp_writer = win32com.makegw.makegwenum._write_enumifc_cpp + gw_cpp_writer = win32com.makegw.makegwenum._write_enumgw_cpp + else: # Use my harder working ones. + ifc_cpp_writer = _write_ifc_cpp + gw_cpp_writer = _write_gw_cpp + + fout = open("Py%s.cpp" % interface.name, "w") + try: + fout.write( + """\ +// This file implements the %s %s for Python. +// Generated by makegw.py + +#include "shell_pch.h" +""" + % (interface.name, desc) + ) + # if bMakeGateway: + # fout.write('#include "PythonCOMServer.h"\n') + # if interface.base not in ["IUnknown", "IDispatch"]: + # fout.write('#include "Py%s.h"\n' % interface.base) + fout.write( + '#include "Py%s.h"\n\n// @doc - This file contains autoduck documentation\n' + % interface.name + ) + if bMakeInterface: + ifc_cpp_writer(fout, interface) + if bMakeGateway: + gw_cpp_writer(fout, interface) + finally: + fout.close() + fout = open("Py%s.h" % interface.name, "w") + try: + fout.write( + """\ +// This file declares the %s %s for Python. +// Generated by makegw.py +""" + % (interface.name, desc) + ) + + if bMakeInterface: + _write_ifc_h(fout, interface) + if bMakeGateway: + _write_gw_h(fout, interface) + finally: + fout.close() + + +########################################################################### +# +# INTERNAL FUNCTIONS +# +# + + +def _write_ifc_h(f, interface): + f.write( + """\ +// --------------------------------------------------- +// +// Interface Declaration + +class Py%s : public Py%s +{ +public: + MAKE_PYCOM_CTOR(Py%s); + static %s *GetI(PyObject *self); + static PyComTypeObject type; + + // The Python methods +""" + % (interface.name, interface.base, interface.name, interface.name) + ) + for method in interface.methods: + f.write( + "\tstatic PyObject *%s(PyObject *self, PyObject *args);\n" % method.name + ) + f.write( + """\ + +protected: + Py%s(IUnknown *pdisp); + ~Py%s(); +}; +""" + % (interface.name, interface.name) + ) + + +def _write_ifc_cpp(f, interface): + name = interface.name + f.write( + """\ +// --------------------------------------------------- +// +// Interface Implementation + +Py%(name)s::Py%(name)s(IUnknown *pdisp): + Py%(base)s(pdisp) +{ + ob_type = &type; +} + +Py%(name)s::~Py%(name)s() +{ +} + +/* static */ %(name)s *Py%(name)s::GetI(PyObject *self) +{ + return (%(name)s *)Py%(base)s::GetI(self); +} + +""" + % (interface.__dict__) + ) + + ptr = re.sub("[a-z]", "", interface.name) + strdict = {"interfacename": interface.name, "ptr": ptr} + for method in interface.methods: + strdict["method"] = method.name + f.write( + """\ +// @pymethod |Py%(interfacename)s|%(method)s|Description of %(method)s. +PyObject *Py%(interfacename)s::%(method)s(PyObject *self, PyObject *args) +{ + %(interfacename)s *p%(ptr)s = GetI(self); + if ( p%(ptr)s == NULL ) + return NULL; +""" + % strdict + ) + argsParseTuple = ( + argsCOM + ) = ( + formatChars + ) = codePost = codePobjects = codeCobjects = cleanup = cleanup_gil = "" + needConversion = 0 + # if method.name=="Stat": import win32dbg;win32dbg.brk() + for arg in method.args: + try: + argCvt = makegwparse.make_arg_converter(arg) + if arg.HasAttribute("in"): + val = argCvt.GetFormatChar() + if val: + f.write("\t" + argCvt.GetAutoduckString() + "\n") + formatChars = formatChars + val + argsParseTuple = ( + argsParseTuple + ", " + argCvt.GetParseTupleArg() + ) + codePobjects = ( + codePobjects + argCvt.DeclareParseArgTupleInputConverter() + ) + codePost = codePost + argCvt.GetParsePostCode() + needConversion = needConversion or argCvt.NeedUSES_CONVERSION() + cleanup = cleanup + argCvt.GetInterfaceArgCleanup() + cleanup_gil = cleanup_gil + argCvt.GetInterfaceArgCleanupGIL() + comArgName, comArgDeclString = argCvt.GetInterfaceCppObjectInfo() + if comArgDeclString: # If we should declare a variable + codeCobjects = codeCobjects + "\t%s;\n" % (comArgDeclString) + argsCOM = argsCOM + ", " + comArgName + except makegwparse.error_not_supported as why: + f.write( + '// *** The input argument %s of type "%s" was not processed ***\n// Please check the conversion function is appropriate and exists!\n' + % (arg.name, arg.raw_type) + ) + + f.write( + "\t%s %s;\n\tPyObject *ob%s;\n" % (arg.type, arg.name, arg.name) + ) + f.write( + "\t// @pyparm |%s||Description for %s\n" + % (arg.type, arg.name, arg.name) + ) + codePost = ( + codePost + + "\tif (bPythonIsHappy && !PyObject_As%s( ob%s, &%s )) bPythonIsHappy = FALSE;\n" + % (arg.type, arg.name, arg.name) + ) + + formatChars = formatChars + "O" + argsParseTuple = argsParseTuple + ", &ob%s" % (arg.name) + + argsCOM = argsCOM + ", " + arg.name + cleanup = cleanup + "\tPyObject_Free%s(%s);\n" % (arg.type, arg.name) + + if needConversion: + f.write("\tUSES_CONVERSION;\n") + f.write(codePobjects) + f.write(codeCobjects) + f.write( + '\tif ( !PyArg_ParseTuple(args, "%s:%s"%s) )\n\t\treturn NULL;\n' + % (formatChars, method.name, argsParseTuple) + ) + if codePost: + f.write("\tBOOL bPythonIsHappy = TRUE;\n") + f.write(codePost) + f.write("\tif (!bPythonIsHappy) return NULL;\n") + strdict["argsCOM"] = argsCOM[1:] + strdict["cleanup"] = cleanup + strdict["cleanup_gil"] = cleanup_gil + f.write( + """ HRESULT hr; + PY_INTERFACE_PRECALL; + hr = p%(ptr)s->%(method)s(%(argsCOM)s ); +%(cleanup)s + PY_INTERFACE_POSTCALL; +%(cleanup_gil)s + if ( FAILED(hr) ) + return PyCom_BuildPyException(hr, p%(ptr)s, IID_%(interfacename)s ); +""" + % strdict + ) + codePre = codePost = formatChars = codeVarsPass = codeDecl = "" + for arg in method.args: + if not arg.HasAttribute("out"): + continue + try: + argCvt = makegwparse.make_arg_converter(arg) + formatChar = argCvt.GetFormatChar() + if formatChar: + formatChars = formatChars + formatChar + codePre = codePre + argCvt.GetBuildForInterfacePreCode() + codePost = codePost + argCvt.GetBuildForInterfacePostCode() + codeVarsPass = codeVarsPass + ", " + argCvt.GetBuildValueArg() + codeDecl = codeDecl + argCvt.DeclareParseArgTupleInputConverter() + except makegwparse.error_not_supported as why: + f.write( + '// *** The output argument %s of type "%s" was not processed ***\n// %s\n' + % (arg.name, arg.raw_type, why) + ) + continue + if formatChars: + f.write( + '%s\n%s\tPyObject *pyretval = Py_BuildValue("%s"%s);\n%s\treturn pyretval;' + % (codeDecl, codePre, formatChars, codeVarsPass, codePost) + ) + else: + f.write("\tPy_INCREF(Py_None);\n\treturn Py_None;\n") + f.write("\n}\n\n") + + f.write("// @object Py%s|Description of the interface\n" % (name)) + f.write("static struct PyMethodDef Py%s_methods[] =\n{\n" % name) + for method in interface.methods: + f.write( + '\t{ "%s", Py%s::%s, 1 }, // @pymeth %s|Description of %s\n' + % (method.name, interface.name, method.name, method.name, method.name) + ) + + interfacebase = interface.base + f.write( + """\ + { NULL } +}; + +PyComTypeObject Py%(name)s::type("Py%(name)s", + &Py%(interfacebase)s::type, + sizeof(Py%(name)s), + Py%(name)s_methods, + GET_PYCOM_CTOR(Py%(name)s)); +""" + % locals() + ) + + +def _write_gw_h(f, interface): + if interface.name[0] == "I": + gname = "PyG" + interface.name[1:] + else: + gname = "PyG" + interface.name + name = interface.name + if interface.base == "IUnknown" or interface.base == "IDispatch": + base_name = "PyGatewayBase" + else: + if interface.base[0] == "I": + base_name = "PyG" + interface.base[1:] + else: + base_name = "PyG" + interface.base + f.write( + """\ +// --------------------------------------------------- +// +// Gateway Declaration + +class %s : public %s, public %s +{ +protected: + %s(PyObject *instance) : %s(instance) { ; } + PYGATEWAY_MAKE_SUPPORT2(%s, %s, IID_%s, %s) + +""" + % (gname, base_name, name, gname, base_name, gname, name, name, base_name) + ) + if interface.base != "IUnknown": + f.write( + "\t// %s\n\t// *** Manually add %s method decls here\n\n" + % (interface.base, interface.base) + ) + else: + f.write("\n\n") + + f.write("\t// %s\n" % name) + + for method in interface.methods: + f.write("\tSTDMETHOD(%s)(\n" % method.name) + if method.args: + for arg in method.args[:-1]: + f.write("\t\t%s,\n" % (arg.GetRawDeclaration())) + arg = method.args[-1] + f.write("\t\t%s);\n\n" % (arg.GetRawDeclaration())) + else: + f.write("\t\tvoid);\n\n") + + f.write("};\n") + f.close() + + +def _write_gw_cpp(f, interface): + if interface.name[0] == "I": + gname = "PyG" + interface.name[1:] + else: + gname = "PyG" + interface.name + name = interface.name + if interface.base == "IUnknown" or interface.base == "IDispatch": + base_name = "PyGatewayBase" + else: + if interface.base[0] == "I": + base_name = "PyG" + interface.base[1:] + else: + base_name = "PyG" + interface.base + f.write( + """\ +// --------------------------------------------------- +// +// Gateway Implementation +""" + % {"name": name, "gname": gname, "base_name": base_name} + ) + + for method in interface.methods: + f.write( + """\ +STDMETHODIMP %s::%s( +""" + % (gname, method.name) + ) + + if method.args: + for arg in method.args[:-1]: + inoutstr = "][".join(arg.inout) + f.write("\t\t/* [%s] */ %s,\n" % (inoutstr, arg.GetRawDeclaration())) + + arg = method.args[-1] + inoutstr = "][".join(arg.inout) + f.write("\t\t/* [%s] */ %s)\n" % (inoutstr, arg.GetRawDeclaration())) + else: + f.write("\t\tvoid)\n") + + f.write("{\n\tPY_GATEWAY_METHOD;\n") + cout = 0 + codePre = codePost = codeVars = "" + argStr = "" + needConversion = 0 + formatChars = "" + if method.args: + for arg in method.args: + if arg.HasAttribute("out"): + cout = cout + 1 + if arg.indirectionLevel == 2: + f.write("\tif (%s==NULL) return E_POINTER;\n" % arg.name) + if arg.HasAttribute("in"): + try: + argCvt = makegwparse.make_arg_converter(arg) + argCvt.SetGatewayMode() + formatchar = argCvt.GetFormatChar() + needConversion = needConversion or argCvt.NeedUSES_CONVERSION() + + if formatchar: + formatChars = formatChars + formatchar + codeVars = ( + codeVars + argCvt.DeclareParseArgTupleInputConverter() + ) + argStr = argStr + ", " + argCvt.GetBuildValueArg() + codePre = codePre + argCvt.GetBuildForGatewayPreCode() + codePost = codePost + argCvt.GetBuildForGatewayPostCode() + except makegwparse.error_not_supported as why: + f.write( + '// *** The input argument %s of type "%s" was not processed ***\n// - Please ensure this conversion function exists, and is appropriate\n// - %s\n' + % (arg.name, arg.raw_type, why) + ) + f.write( + "\tPyObject *ob%s = PyObject_From%s(%s);\n" + % (arg.name, arg.type, arg.name) + ) + f.write( + '\tif (ob%s==NULL) return MAKE_PYCOM_GATEWAY_FAILURE_CODE("%s");\n' + % (arg.name, method.name) + ) + codePost = codePost + "\tPy_DECREF(ob%s);\n" % arg.name + formatChars = formatChars + "O" + argStr = argStr + ", ob%s" % (arg.name) + + if needConversion: + f.write("\tUSES_CONVERSION;\n") + f.write(codeVars) + f.write(codePre) + if cout: + f.write("\tPyObject *result;\n") + resStr = "&result" + else: + resStr = "NULL" + + if formatChars: + fullArgStr = '%s, "%s"%s' % (resStr, formatChars, argStr) + else: + fullArgStr = resStr + + f.write('\tHRESULT hr=InvokeViaPolicy("%s", %s);\n' % (method.name, fullArgStr)) + f.write(codePost) + if cout: + f.write("\tif (FAILED(hr)) return hr;\n") + f.write( + "\t// Process the Python results, and convert back to the real params\n" + ) + # process the output arguments. + formatChars = codePobjects = codePost = argsParseTuple = "" + needConversion = 0 + for arg in method.args: + if not arg.HasAttribute("out"): + continue + try: + argCvt = makegwparse.make_arg_converter(arg) + argCvt.SetGatewayMode() + val = argCvt.GetFormatChar() + if val: + formatChars = formatChars + val + argsParseTuple = ( + argsParseTuple + ", " + argCvt.GetParseTupleArg() + ) + codePobjects = ( + codePobjects + argCvt.DeclareParseArgTupleInputConverter() + ) + codePost = codePost + argCvt.GetParsePostCode() + needConversion = needConversion or argCvt.NeedUSES_CONVERSION() + except makegwparse.error_not_supported as why: + f.write( + '// *** The output argument %s of type "%s" was not processed ***\n// %s\n' + % (arg.name, arg.raw_type, why) + ) + + if formatChars: # If I have any to actually process. + if len(formatChars) == 1: + parseFn = "PyArg_Parse" + else: + parseFn = "PyArg_ParseTuple" + if codePobjects: + f.write(codePobjects) + f.write( + '\tif (!%s(result, "%s" %s))\n\t\treturn MAKE_PYCOM_GATEWAY_FAILURE_CODE("%s");\n' + % (parseFn, formatChars, argsParseTuple, method.name) + ) + if codePost: + f.write("\tBOOL bPythonIsHappy = TRUE;\n") + f.write(codePost) + f.write( + '\tif (!bPythonIsHappy) hr = MAKE_PYCOM_GATEWAY_FAILURE_CODE("%s");\n' + % method.name + ) + f.write("\tPy_DECREF(result);\n") + f.write("\treturn hr;\n}\n\n") + + +def test(): + # make_framework_support("d:\\msdev\\include\\objidl.h", "ILockBytes") + make_framework_support("d:\\msdev\\include\\objidl.h", "IStorage") + + +# make_framework_support("d:\\msdev\\include\\objidl.h", "IEnumSTATSTG") diff --git a/lib/win32com/makegw/makegwenum.py b/lib/win32com/makegw/makegwenum.py new file mode 100644 index 00000000..39c9b2d1 --- /dev/null +++ b/lib/win32com/makegw/makegwenum.py @@ -0,0 +1,331 @@ +"""Utility file for generating PyIEnum support. + +This is almost a 'template' file. It simplay contains almost full +C++ source code for PyIEnum* support, and the Python code simply +substitutes the appropriate interface name. + +This module is notmally not used directly - the @makegw@ module +automatically calls this. +""" +# +# INTERNAL FUNCTIONS +# +# +import string + + +def is_interface_enum(enumtype): + return not (enumtype[0] in string.uppercase and enumtype[2] in string.uppercase) + + +def _write_enumifc_cpp(f, interface): + enumtype = interface.name[5:] + if is_interface_enum(enumtype): + # Assume an interface. + enum_interface = "I" + enumtype[:-1] + converter = ( + "PyObject *ob = PyCom_PyObjectFromIUnknown(rgVar[i], IID_%(enum_interface)s, FALSE);" + % locals() + ) + arraydeclare = ( + "%(enum_interface)s **rgVar = new %(enum_interface)s *[celt];" % locals() + ) + else: + # Enum of a simple structure + converter = ( + "PyObject *ob = PyCom_PyObjectFrom%(enumtype)s(&rgVar[i]);" % locals() + ) + arraydeclare = "%(enumtype)s *rgVar = new %(enumtype)s[celt];" % locals() + + f.write( + """ +// --------------------------------------------------- +// +// Interface Implementation + +PyIEnum%(enumtype)s::PyIEnum%(enumtype)s(IUnknown *pdisp): + PyIUnknown(pdisp) +{ + ob_type = &type; +} + +PyIEnum%(enumtype)s::~PyIEnum%(enumtype)s() +{ +} + +/* static */ IEnum%(enumtype)s *PyIEnum%(enumtype)s::GetI(PyObject *self) +{ + return (IEnum%(enumtype)s *)PyIUnknown::GetI(self); +} + +// @pymethod object|PyIEnum%(enumtype)s|Next|Retrieves a specified number of items in the enumeration sequence. +PyObject *PyIEnum%(enumtype)s::Next(PyObject *self, PyObject *args) +{ + long celt = 1; + // @pyparm int|num|1|Number of items to retrieve. + if ( !PyArg_ParseTuple(args, "|l:Next", &celt) ) + return NULL; + + IEnum%(enumtype)s *pIE%(enumtype)s = GetI(self); + if ( pIE%(enumtype)s == NULL ) + return NULL; + + %(arraydeclare)s + if ( rgVar == NULL ) { + PyErr_SetString(PyExc_MemoryError, "allocating result %(enumtype)ss"); + return NULL; + } + + int i; +/* for ( i = celt; i--; ) + // *** possibly init each structure element??? +*/ + + ULONG celtFetched = 0; + PY_INTERFACE_PRECALL; + HRESULT hr = pIE%(enumtype)s->Next(celt, rgVar, &celtFetched); + PY_INTERFACE_POSTCALL; + if ( HRESULT_CODE(hr) != ERROR_NO_MORE_ITEMS && FAILED(hr) ) + { + delete [] rgVar; + return PyCom_BuildPyException(hr,pIE%(enumtype)s, IID_IE%(enumtype)s); + } + + PyObject *result = PyTuple_New(celtFetched); + if ( result != NULL ) + { + for ( i = celtFetched; i--; ) + { + %(converter)s + if ( ob == NULL ) + { + Py_DECREF(result); + result = NULL; + break; + } + PyTuple_SET_ITEM(result, i, ob); + } + } + +/* for ( i = celtFetched; i--; ) + // *** possibly cleanup each structure element??? +*/ + delete [] rgVar; + return result; +} + +// @pymethod |PyIEnum%(enumtype)s|Skip|Skips over the next specified elementes. +PyObject *PyIEnum%(enumtype)s::Skip(PyObject *self, PyObject *args) +{ + long celt; + if ( !PyArg_ParseTuple(args, "l:Skip", &celt) ) + return NULL; + + IEnum%(enumtype)s *pIE%(enumtype)s = GetI(self); + if ( pIE%(enumtype)s == NULL ) + return NULL; + + PY_INTERFACE_PRECALL; + HRESULT hr = pIE%(enumtype)s->Skip(celt); + PY_INTERFACE_POSTCALL; + if ( FAILED(hr) ) + return PyCom_BuildPyException(hr, pIE%(enumtype)s, IID_IE%(enumtype)s); + + Py_INCREF(Py_None); + return Py_None; +} + +// @pymethod |PyIEnum%(enumtype)s|Reset|Resets the enumeration sequence to the beginning. +PyObject *PyIEnum%(enumtype)s::Reset(PyObject *self, PyObject *args) +{ + if ( !PyArg_ParseTuple(args, ":Reset") ) + return NULL; + + IEnum%(enumtype)s *pIE%(enumtype)s = GetI(self); + if ( pIE%(enumtype)s == NULL ) + return NULL; + + PY_INTERFACE_PRECALL; + HRESULT hr = pIE%(enumtype)s->Reset(); + PY_INTERFACE_POSTCALL; + if ( FAILED(hr) ) + return PyCom_BuildPyException(hr, pIE%(enumtype)s, IID_IE%(enumtype)s); + + Py_INCREF(Py_None); + return Py_None; +} + +// @pymethod |PyIEnum%(enumtype)s|Clone|Creates another enumerator that contains the same enumeration state as the current one +PyObject *PyIEnum%(enumtype)s::Clone(PyObject *self, PyObject *args) +{ + if ( !PyArg_ParseTuple(args, ":Clone") ) + return NULL; + + IEnum%(enumtype)s *pIE%(enumtype)s = GetI(self); + if ( pIE%(enumtype)s == NULL ) + return NULL; + + IEnum%(enumtype)s *pClone; + PY_INTERFACE_PRECALL; + HRESULT hr = pIE%(enumtype)s->Clone(&pClone); + PY_INTERFACE_POSTCALL; + if ( FAILED(hr) ) + return PyCom_BuildPyException(hr, pIE%(enumtype)s, IID_IE%(enumtype)s); + + return PyCom_PyObjectFromIUnknown(pClone, IID_IEnum%(enumtype)s, FALSE); +} + +// @object PyIEnum%(enumtype)s|A Python interface to IEnum%(enumtype)s +static struct PyMethodDef PyIEnum%(enumtype)s_methods[] = +{ + { "Next", PyIEnum%(enumtype)s::Next, 1 }, // @pymeth Next|Retrieves a specified number of items in the enumeration sequence. + { "Skip", PyIEnum%(enumtype)s::Skip, 1 }, // @pymeth Skip|Skips over the next specified elementes. + { "Reset", PyIEnum%(enumtype)s::Reset, 1 }, // @pymeth Reset|Resets the enumeration sequence to the beginning. + { "Clone", PyIEnum%(enumtype)s::Clone, 1 }, // @pymeth Clone|Creates another enumerator that contains the same enumeration state as the current one. + { NULL } +}; + +PyComEnumTypeObject PyIEnum%(enumtype)s::type("PyIEnum%(enumtype)s", + &PyIUnknown::type, + sizeof(PyIEnum%(enumtype)s), + PyIEnum%(enumtype)s_methods, + GET_PYCOM_CTOR(PyIEnum%(enumtype)s)); +""" + % locals() + ) + + +def _write_enumgw_cpp(f, interface): + enumtype = interface.name[5:] + if is_interface_enum(enumtype): + # Assume an interface. + enum_interface = "I" + enumtype[:-1] + converter = ( + "if ( !PyCom_InterfaceFromPyObject(ob, IID_%(enum_interface)s, (void **)&rgVar[i], FALSE) )" + % locals() + ) + argdeclare = "%(enum_interface)s __RPC_FAR * __RPC_FAR *rgVar" % locals() + else: + argdeclare = "%(enumtype)s __RPC_FAR *rgVar" % locals() + converter = "if ( !PyCom_PyObjectAs%(enumtype)s(ob, &rgVar[i]) )" % locals() + f.write( + """ +// --------------------------------------------------- +// +// Gateway Implementation + +// Std delegation +STDMETHODIMP_(ULONG) PyGEnum%(enumtype)s::AddRef(void) {return PyGatewayBase::AddRef();} +STDMETHODIMP_(ULONG) PyGEnum%(enumtype)s::Release(void) {return PyGatewayBase::Release();} +STDMETHODIMP PyGEnum%(enumtype)s::QueryInterface(REFIID iid, void ** obj) {return PyGatewayBase::QueryInterface(iid, obj);} +STDMETHODIMP PyGEnum%(enumtype)s::GetTypeInfoCount(UINT FAR* pctInfo) {return PyGatewayBase::GetTypeInfoCount(pctInfo);} +STDMETHODIMP PyGEnum%(enumtype)s::GetTypeInfo(UINT itinfo, LCID lcid, ITypeInfo FAR* FAR* pptInfo) {return PyGatewayBase::GetTypeInfo(itinfo, lcid, pptInfo);} +STDMETHODIMP PyGEnum%(enumtype)s::GetIDsOfNames(REFIID refiid, OLECHAR FAR* FAR* rgszNames, UINT cNames, LCID lcid, DISPID FAR* rgdispid) {return PyGatewayBase::GetIDsOfNames( refiid, rgszNames, cNames, lcid, rgdispid);} +STDMETHODIMP PyGEnum%(enumtype)s::Invoke(DISPID dispid, REFIID riid, LCID lcid, WORD wFlags, DISPPARAMS FAR* params, VARIANT FAR* pVarResult, EXCEPINFO FAR* pexcepinfo, UINT FAR* puArgErr) {return PyGatewayBase::Invoke( dispid, riid, lcid, wFlags, params, pVarResult, pexcepinfo, puArgErr);} + +STDMETHODIMP PyGEnum%(enumtype)s::Next( + /* [in] */ ULONG celt, + /* [length_is][size_is][out] */ %(argdeclare)s, + /* [out] */ ULONG __RPC_FAR *pCeltFetched) +{ + PY_GATEWAY_METHOD; + PyObject *result; + HRESULT hr = InvokeViaPolicy("Next", &result, "i", celt); + if ( FAILED(hr) ) + return hr; + + if ( !PySequence_Check(result) ) + goto error; + int len; + len = PyObject_Length(result); + if ( len == -1 ) + goto error; + if ( len > (int)celt) + len = celt; + + if ( pCeltFetched ) + *pCeltFetched = len; + + int i; + for ( i = 0; i < len; ++i ) + { + PyObject *ob = PySequence_GetItem(result, i); + if ( ob == NULL ) + goto error; + + %(converter)s + { + Py_DECREF(result); + return PyCom_SetCOMErrorFromPyException(IID_IEnum%(enumtype)s); + } + } + + Py_DECREF(result); + + return len < (int)celt ? S_FALSE : S_OK; + + error: + PyErr_Clear(); // just in case + Py_DECREF(result); + return PyCom_HandleIEnumNoSequence(IID_IEnum%(enumtype)s); +} + +STDMETHODIMP PyGEnum%(enumtype)s::Skip( + /* [in] */ ULONG celt) +{ + PY_GATEWAY_METHOD; + return InvokeViaPolicy("Skip", NULL, "i", celt); +} + +STDMETHODIMP PyGEnum%(enumtype)s::Reset(void) +{ + PY_GATEWAY_METHOD; + return InvokeViaPolicy("Reset"); +} + +STDMETHODIMP PyGEnum%(enumtype)s::Clone( + /* [out] */ IEnum%(enumtype)s __RPC_FAR *__RPC_FAR *ppEnum) +{ + PY_GATEWAY_METHOD; + PyObject * result; + HRESULT hr = InvokeViaPolicy("Clone", &result); + if ( FAILED(hr) ) + return hr; + + /* + ** Make sure we have the right kind of object: we should have some kind + ** of IUnknown subclass wrapped into a PyIUnknown instance. + */ + if ( !PyIBase::is_object(result, &PyIUnknown::type) ) + { + /* the wrong kind of object was returned to us */ + Py_DECREF(result); + return PyCom_SetCOMErrorFromSimple(E_FAIL, IID_IEnum%(enumtype)s); + } + + /* + ** Get the IUnknown out of the thing. note that the Python ob maintains + ** a reference, so we don't have to explicitly AddRef() here. + */ + IUnknown *punk = ((PyIUnknown *)result)->m_obj; + if ( !punk ) + { + /* damn. the object was released. */ + Py_DECREF(result); + return PyCom_SetCOMErrorFromSimple(E_FAIL, IID_IEnum%(enumtype)s); + } + + /* + ** Get the interface we want. note it is returned with a refcount. + ** This QI is actually going to instantiate a PyGEnum%(enumtype)s. + */ + hr = punk->QueryInterface(IID_IEnum%(enumtype)s, (LPVOID *)ppEnum); + + /* done with the result; this DECREF is also for */ + Py_DECREF(result); + + return PyCom_CheckIEnumNextResult(hr, IID_IEnum%(enumtype)s); +} +""" + % locals() + ) diff --git a/lib/win32com/makegw/makegwparse.py b/lib/win32com/makegw/makegwparse.py new file mode 100644 index 00000000..59512f48 --- /dev/null +++ b/lib/win32com/makegw/makegwparse.py @@ -0,0 +1,1008 @@ +"""Utilities for makegw - Parse a header file to build an interface + + This module contains the core code for parsing a header file describing a + COM interface, and building it into an "Interface" structure. + + Each Interface has methods, and each method has arguments. + + Each argument knows how to use Py_BuildValue or Py_ParseTuple to + exchange itself with Python. + + See the @win32com.makegw@ module for information in building a COM + interface +""" +import re +import traceback + + +class error_not_found(Exception): + def __init__(self, msg="The requested item could not be found"): + super(error_not_found, self).__init__(msg) + + +class error_not_supported(Exception): + def __init__(self, msg="The required functionality is not supported"): + super(error_not_supported, self).__init__(msg) + + +VERBOSE = 0 +DEBUG = 0 + +## NOTE : For interfaces as params to work correctly, you must +## make sure any PythonCOM extensions which expose the interface are loaded +## before generating. + + +class ArgFormatter: + """An instance for a specific type of argument. Knows how to convert itself""" + + def __init__(self, arg, builtinIndirection, declaredIndirection=0): + # print 'init:', arg.name, builtinIndirection, declaredIndirection, arg.indirectionLevel + self.arg = arg + self.builtinIndirection = builtinIndirection + self.declaredIndirection = declaredIndirection + self.gatewayMode = 0 + + def _IndirectPrefix(self, indirectionFrom, indirectionTo): + """Given the indirection level I was declared at (0=Normal, 1=*, 2=**) + return a string prefix so I can pass to a function with the + required indirection (where the default is the indirection of the method's param. + + eg, assuming my arg has indirection level of 2, if this function was passed 1 + it would return "&", so that a variable declared with indirection of 1 + can be prefixed with this to turn it into the indirection level required of 2 + """ + dif = indirectionFrom - indirectionTo + if dif == 0: + return "" + elif dif == -1: + return "&" + elif dif == 1: + return "*" + else: + return "?? (%d)" % (dif,) + raise error_not_supported("Can't indirect this far - please fix me :-)") + + def GetIndirectedArgName(self, indirectFrom, indirectionTo): + # print 'get:',self.arg.name, indirectFrom,self._GetDeclaredIndirection() + self.builtinIndirection, indirectionTo, self.arg.indirectionLevel + + if indirectFrom is None: + ### ACK! this does not account for [in][out] variables. + ### when this method is called, we need to know which + indirectFrom = self._GetDeclaredIndirection() + self.builtinIndirection + + return self._IndirectPrefix(indirectFrom, indirectionTo) + self.arg.name + + def GetBuildValueArg(self): + "Get the argument to be passes to Py_BuildValue" + return self.arg.name + + def GetParseTupleArg(self): + "Get the argument to be passed to PyArg_ParseTuple" + if self.gatewayMode: + # use whatever they were declared with + return self.GetIndirectedArgName(None, 1) + # local declarations have just their builtin indirection + return self.GetIndirectedArgName(self.builtinIndirection, 1) + + def GetInterfaceCppObjectInfo(self): + """Provide information about the C++ object used. + + Simple variables (such as integers) can declare their type (eg an integer) + and use it as the target of both PyArg_ParseTuple and the COM function itself. + + More complex types require a PyObject * declared as the target of PyArg_ParseTuple, + then some conversion routine to the C++ object which is actually passed to COM. + + This method provides the name, and optionally the type of that C++ variable. + If the type if provided, the caller will likely generate a variable declaration. + The name must always be returned. + + Result is a tuple of (variableName, [DeclareType|None|""]) + """ + + # the first return element is the variable to be passed as + # an argument to an interface method. the variable was + # declared with only its builtin indirection level. when + # we pass it, we'll need to pass in whatever amount of + # indirection was applied (plus the builtin amount) + # the second return element is the variable declaration; it + # should simply be builtin indirection + return self.GetIndirectedArgName( + self.builtinIndirection, self.arg.indirectionLevel + self.builtinIndirection + ), "%s %s" % (self.GetUnconstType(), self.arg.name) + + def GetInterfaceArgCleanup(self): + "Return cleanup code for C++ args passed to the interface method." + if DEBUG: + return "/* GetInterfaceArgCleanup output goes here: %s */\n" % self.arg.name + else: + return "" + + def GetInterfaceArgCleanupGIL(self): + """Return cleanup code for C++ args passed to the interface + method that must be executed with the GIL held""" + if DEBUG: + return ( + "/* GetInterfaceArgCleanup (GIL held) output goes here: %s */\n" + % self.arg.name + ) + else: + return "" + + def GetUnconstType(self): + return self.arg.unc_type + + def SetGatewayMode(self): + self.gatewayMode = 1 + + def _GetDeclaredIndirection(self): + return self.arg.indirectionLevel + print("declared:", self.arg.name, self.gatewayMode) + if self.gatewayMode: + return self.arg.indirectionLevel + else: + return self.declaredIndirection + + def DeclareParseArgTupleInputConverter(self): + "Declare the variable used as the PyArg_ParseTuple param for a gateway" + # Only declare it?? + # if self.arg.indirectionLevel==0: + # return "\t%s %s;\n" % (self.arg.type, self.arg.name) + # else: + if DEBUG: + return ( + "/* Declare ParseArgTupleInputConverter goes here: %s */\n" + % self.arg.name + ) + else: + return "" + + def GetParsePostCode(self): + "Get a string of C++ code to be executed after (ie, to finalise) the PyArg_ParseTuple conversion" + if DEBUG: + return "/* GetParsePostCode code goes here: %s */\n" % self.arg.name + else: + return "" + + def GetBuildForInterfacePreCode(self): + "Get a string of C++ code to be executed before (ie, to initialise) the Py_BuildValue conversion for Interfaces" + if DEBUG: + return "/* GetBuildForInterfacePreCode goes here: %s */\n" % self.arg.name + else: + return "" + + def GetBuildForGatewayPreCode(self): + "Get a string of C++ code to be executed before (ie, to initialise) the Py_BuildValue conversion for Gateways" + s = self.GetBuildForInterfacePreCode() # Usually the same + if DEBUG: + if s[:4] == "/* G": + s = "/* GetBuildForGatewayPreCode goes here: %s */\n" % self.arg.name + return s + + def GetBuildForInterfacePostCode(self): + "Get a string of C++ code to be executed after (ie, to finalise) the Py_BuildValue conversion for Interfaces" + if DEBUG: + return "/* GetBuildForInterfacePostCode goes here: %s */\n" % self.arg.name + return "" + + def GetBuildForGatewayPostCode(self): + "Get a string of C++ code to be executed after (ie, to finalise) the Py_BuildValue conversion for Gateways" + s = self.GetBuildForInterfacePostCode() # Usually the same + if DEBUG: + if s[:4] == "/* G": + s = "/* GetBuildForGatewayPostCode goes here: %s */\n" % self.arg.name + return s + + def GetAutoduckString(self): + return "// @pyparm %s|%s||Description for %s" % ( + self._GetPythonTypeDesc(), + self.arg.name, + self.arg.name, + ) + + def _GetPythonTypeDesc(self): + "Returns a string with the description of the type. Used for doco purposes" + return None + + def NeedUSES_CONVERSION(self): + "Determines if this arg forces a USES_CONVERSION macro" + return 0 + + +# Special formatter for floats since they're smaller than Python floats. +class ArgFormatterFloat(ArgFormatter): + def GetFormatChar(self): + return "f" + + def DeclareParseArgTupleInputConverter(self): + # Declare a double variable + return "\tdouble dbl%s;\n" % self.arg.name + + def GetParseTupleArg(self): + return "&dbl" + self.arg.name + + def _GetPythonTypeDesc(self): + return "float" + + def GetBuildValueArg(self): + return "&dbl" + self.arg.name + + def GetBuildForInterfacePreCode(self): + return "\tdbl" + self.arg.name + " = " + self.arg.name + ";\n" + + def GetBuildForGatewayPreCode(self): + return ( + "\tdbl%s = " % self.arg.name + + self._IndirectPrefix(self._GetDeclaredIndirection(), 0) + + self.arg.name + + ";\n" + ) + + def GetParsePostCode(self): + s = "\t" + if self.gatewayMode: + s = s + self._IndirectPrefix(self._GetDeclaredIndirection(), 0) + s = s + self.arg.name + s = s + " = (float)dbl%s;\n" % self.arg.name + return s + + +# Special formatter for Shorts because they're +# a different size than Python ints! +class ArgFormatterShort(ArgFormatter): + def GetFormatChar(self): + return "i" + + def DeclareParseArgTupleInputConverter(self): + # Declare a double variable + return "\tINT i%s;\n" % self.arg.name + + def GetParseTupleArg(self): + return "&i" + self.arg.name + + def _GetPythonTypeDesc(self): + return "int" + + def GetBuildValueArg(self): + return "&i" + self.arg.name + + def GetBuildForInterfacePreCode(self): + return "\ti" + self.arg.name + " = " + self.arg.name + ";\n" + + def GetBuildForGatewayPreCode(self): + return ( + "\ti%s = " % self.arg.name + + self._IndirectPrefix(self._GetDeclaredIndirection(), 0) + + self.arg.name + + ";\n" + ) + + def GetParsePostCode(self): + s = "\t" + if self.gatewayMode: + s = s + self._IndirectPrefix(self._GetDeclaredIndirection(), 0) + s = s + self.arg.name + s = s + " = i%s;\n" % self.arg.name + return s + + +# for types which are 64bits on AMD64 - eg, HWND +class ArgFormatterLONG_PTR(ArgFormatter): + def GetFormatChar(self): + return "O" + + def DeclareParseArgTupleInputConverter(self): + # Declare a PyObject variable + return "\tPyObject *ob%s;\n" % self.arg.name + + def GetParseTupleArg(self): + return "&ob" + self.arg.name + + def _GetPythonTypeDesc(self): + return "int/long" + + def GetBuildValueArg(self): + return "ob" + self.arg.name + + def GetBuildForInterfacePostCode(self): + return "\tPy_XDECREF(ob%s);\n" % self.arg.name + + def GetParsePostCode(self): + return ( + "\tif (bPythonIsHappy && !PyWinLong_AsULONG_PTR(ob%s, (ULONG_PTR *)%s)) bPythonIsHappy = FALSE;\n" + % (self.arg.name, self.GetIndirectedArgName(None, 2)) + ) + + def GetBuildForInterfacePreCode(self): + notdirected = self.GetIndirectedArgName(None, 1) + return "\tob%s = PyWinObject_FromULONG_PTR(%s);\n" % ( + self.arg.name, + notdirected, + ) + + def GetBuildForGatewayPostCode(self): + return "\tPy_XDECREF(ob%s);\n" % self.arg.name + + +class ArgFormatterPythonCOM(ArgFormatter): + """An arg formatter for types exposed in the PythonCOM module""" + + def GetFormatChar(self): + return "O" + + # def GetInterfaceCppObjectInfo(self): + # return ArgFormatter.GetInterfaceCppObjectInfo(self)[0], \ + # "%s %s%s" % (self.arg.unc_type, "*" * self._GetDeclaredIndirection(), self.arg.name) + def DeclareParseArgTupleInputConverter(self): + # Declare a PyObject variable + return "\tPyObject *ob%s;\n" % self.arg.name + + def GetParseTupleArg(self): + return "&ob" + self.arg.name + + def _GetPythonTypeDesc(self): + return "" % self.arg.type + + def GetBuildValueArg(self): + return "ob" + self.arg.name + + def GetBuildForInterfacePostCode(self): + return "\tPy_XDECREF(ob%s);\n" % self.arg.name + + +class ArgFormatterBSTR(ArgFormatterPythonCOM): + def _GetPythonTypeDesc(self): + return "" + + def GetParsePostCode(self): + return ( + "\tif (bPythonIsHappy && !PyWinObject_AsBstr(ob%s, %s)) bPythonIsHappy = FALSE;\n" + % (self.arg.name, self.GetIndirectedArgName(None, 2)) + ) + + def GetBuildForInterfacePreCode(self): + notdirected = self.GetIndirectedArgName(None, 1) + return "\tob%s = MakeBstrToObj(%s);\n" % (self.arg.name, notdirected) + + def GetBuildForInterfacePostCode(self): + return "\tSysFreeString(%s);\n" % ( + self.arg.name, + ) + ArgFormatterPythonCOM.GetBuildForInterfacePostCode(self) + + def GetBuildForGatewayPostCode(self): + return "\tPy_XDECREF(ob%s);\n" % self.arg.name + + +class ArgFormatterOLECHAR(ArgFormatterPythonCOM): + def _GetPythonTypeDesc(self): + return "" + + def GetUnconstType(self): + if self.arg.type[:3] == "LPC": + return self.arg.type[:2] + self.arg.type[3:] + else: + return self.arg.unc_type + + def GetParsePostCode(self): + return ( + "\tif (bPythonIsHappy && !PyWinObject_AsBstr(ob%s, %s)) bPythonIsHappy = FALSE;\n" + % (self.arg.name, self.GetIndirectedArgName(None, 2)) + ) + + def GetInterfaceArgCleanup(self): + return "\tSysFreeString(%s);\n" % self.GetIndirectedArgName(None, 1) + + def GetBuildForInterfacePreCode(self): + # the variable was declared with just its builtin indirection + notdirected = self.GetIndirectedArgName(self.builtinIndirection, 1) + return "\tob%s = MakeOLECHARToObj(%s);\n" % (self.arg.name, notdirected) + + def GetBuildForInterfacePostCode(self): + # memory returned into an OLECHAR should be freed + return "\tCoTaskMemFree(%s);\n" % ( + self.arg.name, + ) + ArgFormatterPythonCOM.GetBuildForInterfacePostCode(self) + + def GetBuildForGatewayPostCode(self): + return "\tPy_XDECREF(ob%s);\n" % self.arg.name + + +class ArgFormatterTCHAR(ArgFormatterPythonCOM): + def _GetPythonTypeDesc(self): + return "string/" + + def GetUnconstType(self): + if self.arg.type[:3] == "LPC": + return self.arg.type[:2] + self.arg.type[3:] + else: + return self.arg.unc_type + + def GetParsePostCode(self): + return ( + "\tif (bPythonIsHappy && !PyWinObject_AsTCHAR(ob%s, %s)) bPythonIsHappy = FALSE;\n" + % (self.arg.name, self.GetIndirectedArgName(None, 2)) + ) + + def GetInterfaceArgCleanup(self): + return "\tPyWinObject_FreeTCHAR(%s);\n" % self.GetIndirectedArgName(None, 1) + + def GetBuildForInterfacePreCode(self): + # the variable was declared with just its builtin indirection + notdirected = self.GetIndirectedArgName(self.builtinIndirection, 1) + return "\tob%s = PyWinObject_FromTCHAR(%s);\n" % (self.arg.name, notdirected) + + def GetBuildForInterfacePostCode(self): + return "// ??? - TCHAR post code\n" + + def GetBuildForGatewayPostCode(self): + return "\tPy_XDECREF(ob%s);\n" % self.arg.name + + +class ArgFormatterIID(ArgFormatterPythonCOM): + def _GetPythonTypeDesc(self): + return "" + + def GetParsePostCode(self): + return "\tif (!PyWinObject_AsIID(ob%s, &%s)) bPythonIsHappy = FALSE;\n" % ( + self.arg.name, + self.arg.name, + ) + + def GetBuildForInterfacePreCode(self): + # notdirected = self.GetIndirectedArgName(self.arg.indirectionLevel, 0) + notdirected = self.GetIndirectedArgName(None, 0) + return "\tob%s = PyWinObject_FromIID(%s);\n" % (self.arg.name, notdirected) + + def GetInterfaceCppObjectInfo(self): + return self.arg.name, "IID %s" % (self.arg.name) + + +class ArgFormatterTime(ArgFormatterPythonCOM): + def __init__(self, arg, builtinIndirection, declaredIndirection=0): + # we don't want to declare LPSYSTEMTIME / LPFILETIME objects + if arg.indirectionLevel == 0 and arg.unc_type[:2] == "LP": + arg.unc_type = arg.unc_type[2:] + # reduce the builtin and increment the declaration + arg.indirectionLevel = arg.indirectionLevel + 1 + builtinIndirection = 0 + ArgFormatterPythonCOM.__init__( + self, arg, builtinIndirection, declaredIndirection + ) + + def _GetPythonTypeDesc(self): + return "" + + def GetParsePostCode(self): + # variable was declared with only the builtinIndirection + ### NOTE: this is an [in] ... so use only builtin + return ( + '\tif (!PyTime_Check(ob%s)) {\n\t\tPyErr_SetString(PyExc_TypeError, "The argument must be a PyTime object");\n\t\tbPythonIsHappy = FALSE;\n\t}\n\tif (!((PyTime *)ob%s)->GetTime(%s)) bPythonIsHappy = FALSE;\n' + % ( + self.arg.name, + self.arg.name, + self.GetIndirectedArgName(self.builtinIndirection, 1), + ) + ) + + def GetBuildForInterfacePreCode(self): + ### use just the builtinIndirection again... + notdirected = self.GetIndirectedArgName(self.builtinIndirection, 0) + return "\tob%s = new PyTime(%s);\n" % (self.arg.name, notdirected) + + def GetBuildForInterfacePostCode(self): + ### hack to determine if we need to free stuff + ret = "" + if self.builtinIndirection + self.arg.indirectionLevel > 1: + # memory returned into an OLECHAR should be freed + ret = "\tCoTaskMemFree(%s);\n" % self.arg.name + return ret + ArgFormatterPythonCOM.GetBuildForInterfacePostCode(self) + + +class ArgFormatterSTATSTG(ArgFormatterPythonCOM): + def _GetPythonTypeDesc(self): + return "" + + def GetParsePostCode(self): + return ( + "\tif (!PyCom_PyObjectAsSTATSTG(ob%s, %s, 0/*flags*/)) bPythonIsHappy = FALSE;\n" + % (self.arg.name, self.GetIndirectedArgName(None, 1)) + ) + + def GetBuildForInterfacePreCode(self): + notdirected = self.GetIndirectedArgName(None, 1) + return ( + "\tob%s = PyCom_PyObjectFromSTATSTG(%s);\n\t// STATSTG doco says our responsibility to free\n\tif ((%s).pwcsName) CoTaskMemFree((%s).pwcsName);\n" + % ( + self.arg.name, + self.GetIndirectedArgName(None, 1), + notdirected, + notdirected, + ) + ) + + +class ArgFormatterGeneric(ArgFormatterPythonCOM): + def _GetPythonTypeDesc(self): + return "" % self.arg.type + + def GetParsePostCode(self): + return "\tif (!PyObject_As%s(ob%s, &%s) bPythonIsHappy = FALSE;\n" % ( + self.arg.type, + self.arg.name, + self.GetIndirectedArgName(None, 1), + ) + + def GetInterfaceArgCleanup(self): + return "\tPyObject_Free%s(%s);\n" % (self.arg.type, self.arg.name) + + def GetBuildForInterfacePreCode(self): + notdirected = self.GetIndirectedArgName(None, 1) + return "\tob%s = PyObject_From%s(%s);\n" % ( + self.arg.name, + self.arg.type, + self.GetIndirectedArgName(None, 1), + ) + + +class ArgFormatterIDLIST(ArgFormatterPythonCOM): + def _GetPythonTypeDesc(self): + return "" + + def GetParsePostCode(self): + return ( + "\tif (bPythonIsHappy && !PyObject_AsPIDL(ob%s, &%s)) bPythonIsHappy = FALSE;\n" + % (self.arg.name, self.GetIndirectedArgName(None, 1)) + ) + + def GetInterfaceArgCleanup(self): + return "\tPyObject_FreePIDL(%s);\n" % (self.arg.name,) + + def GetBuildForInterfacePreCode(self): + notdirected = self.GetIndirectedArgName(None, 1) + return "\tob%s = PyObject_FromPIDL(%s);\n" % ( + self.arg.name, + self.GetIndirectedArgName(None, 1), + ) + + +class ArgFormatterHANDLE(ArgFormatterPythonCOM): + def _GetPythonTypeDesc(self): + return "" + + def GetParsePostCode(self): + return ( + "\tif (!PyWinObject_AsHANDLE(ob%s, &%s, FALSE) bPythonIsHappy = FALSE;\n" + % (self.arg.name, self.GetIndirectedArgName(None, 1)) + ) + + def GetBuildForInterfacePreCode(self): + notdirected = self.GetIndirectedArgName(None, 1) + return "\tob%s = PyWinObject_FromHANDLE(%s);\n" % ( + self.arg.name, + self.GetIndirectedArgName(None, 0), + ) + + +class ArgFormatterLARGE_INTEGER(ArgFormatterPythonCOM): + def GetKeyName(self): + return "LARGE_INTEGER" + + def _GetPythonTypeDesc(self): + return "" % self.GetKeyName() + + def GetParsePostCode(self): + return "\tif (!PyWinObject_As%s(ob%s, %s)) bPythonIsHappy = FALSE;\n" % ( + self.GetKeyName(), + self.arg.name, + self.GetIndirectedArgName(None, 1), + ) + + def GetBuildForInterfacePreCode(self): + notdirected = self.GetIndirectedArgName(None, 0) + return "\tob%s = PyWinObject_From%s(%s);\n" % ( + self.arg.name, + self.GetKeyName(), + notdirected, + ) + + +class ArgFormatterULARGE_INTEGER(ArgFormatterLARGE_INTEGER): + def GetKeyName(self): + return "ULARGE_INTEGER" + + +class ArgFormatterInterface(ArgFormatterPythonCOM): + def GetInterfaceCppObjectInfo(self): + return self.GetIndirectedArgName(1, self.arg.indirectionLevel), "%s * %s" % ( + self.GetUnconstType(), + self.arg.name, + ) + + def GetParsePostCode(self): + # This gets called for out params in gateway mode + if self.gatewayMode: + sArg = self.GetIndirectedArgName(None, 2) + else: + # vs. in params for interface mode. + sArg = self.GetIndirectedArgName(1, 2) + return ( + "\tif (bPythonIsHappy && !PyCom_InterfaceFromPyInstanceOrObject(ob%s, IID_%s, (void **)%s, TRUE /* bNoneOK */))\n\t\t bPythonIsHappy = FALSE;\n" + % (self.arg.name, self.arg.type, sArg) + ) + + def GetBuildForInterfacePreCode(self): + return "\tob%s = PyCom_PyObjectFromIUnknown(%s, IID_%s, FALSE);\n" % ( + self.arg.name, + self.arg.name, + self.arg.type, + ) + + def GetBuildForGatewayPreCode(self): + sPrefix = self._IndirectPrefix(self._GetDeclaredIndirection(), 1) + return "\tob%s = PyCom_PyObjectFromIUnknown(%s%s, IID_%s, TRUE);\n" % ( + self.arg.name, + sPrefix, + self.arg.name, + self.arg.type, + ) + + def GetInterfaceArgCleanup(self): + return "\tif (%s) %s->Release();\n" % (self.arg.name, self.arg.name) + + +class ArgFormatterVARIANT(ArgFormatterPythonCOM): + def GetParsePostCode(self): + return ( + "\tif ( !PyCom_VariantFromPyObject(ob%s, %s) )\n\t\tbPythonIsHappy = FALSE;\n" + % (self.arg.name, self.GetIndirectedArgName(None, 1)) + ) + + def GetBuildForGatewayPreCode(self): + notdirected = self.GetIndirectedArgName(None, 1) + return "\tob%s = PyCom_PyObjectFromVariant(%s);\n" % ( + self.arg.name, + notdirected, + ) + + def GetBuildForGatewayPostCode(self): + return "\tPy_XDECREF(ob%s);\n" % self.arg.name + + # Key : , Python Type Description, ParseTuple format char + + +ConvertSimpleTypes = { + "BOOL": ("BOOL", "int", "i"), + "UINT": ("UINT", "int", "i"), + "BYTE": ("BYTE", "int", "i"), + "INT": ("INT", "int", "i"), + "DWORD": ("DWORD", "int", "l"), + "HRESULT": ("HRESULT", "int", "l"), + "ULONG": ("ULONG", "int", "l"), + "LONG": ("LONG", "int", "l"), + "int": ("int", "int", "i"), + "long": ("long", "int", "l"), + "DISPID": ("DISPID", "long", "l"), + "APPBREAKFLAGS": ("int", "int", "i"), + "BREAKRESUMEACTION": ("int", "int", "i"), + "ERRORRESUMEACTION": ("int", "int", "i"), + "BREAKREASON": ("int", "int", "i"), + "BREAKPOINT_STATE": ("int", "int", "i"), + "BREAKRESUME_ACTION": ("int", "int", "i"), + "SOURCE_TEXT_ATTR": ("int", "int", "i"), + "TEXT_DOC_ATTR": ("int", "int", "i"), + "QUERYOPTION": ("int", "int", "i"), + "PARSEACTION": ("int", "int", "i"), +} + + +class ArgFormatterSimple(ArgFormatter): + """An arg formatter for simple integer etc types""" + + def GetFormatChar(self): + return ConvertSimpleTypes[self.arg.type][2] + + def _GetPythonTypeDesc(self): + return ConvertSimpleTypes[self.arg.type][1] + + +AllConverters = { + "const OLECHAR": (ArgFormatterOLECHAR, 0, 1), + "WCHAR": (ArgFormatterOLECHAR, 0, 1), + "OLECHAR": (ArgFormatterOLECHAR, 0, 1), + "LPCOLESTR": (ArgFormatterOLECHAR, 1, 1), + "LPOLESTR": (ArgFormatterOLECHAR, 1, 1), + "LPCWSTR": (ArgFormatterOLECHAR, 1, 1), + "LPWSTR": (ArgFormatterOLECHAR, 1, 1), + "LPCSTR": (ArgFormatterOLECHAR, 1, 1), + "LPTSTR": (ArgFormatterTCHAR, 1, 1), + "LPCTSTR": (ArgFormatterTCHAR, 1, 1), + "HANDLE": (ArgFormatterHANDLE, 0), + "BSTR": (ArgFormatterBSTR, 1, 0), + "const IID": (ArgFormatterIID, 0), + "CLSID": (ArgFormatterIID, 0), + "IID": (ArgFormatterIID, 0), + "GUID": (ArgFormatterIID, 0), + "const GUID": (ArgFormatterIID, 0), + "const IID": (ArgFormatterIID, 0), + "REFCLSID": (ArgFormatterIID, 0), + "REFIID": (ArgFormatterIID, 0), + "REFGUID": (ArgFormatterIID, 0), + "const FILETIME": (ArgFormatterTime, 0), + "const SYSTEMTIME": (ArgFormatterTime, 0), + "const LPSYSTEMTIME": (ArgFormatterTime, 1, 1), + "LPSYSTEMTIME": (ArgFormatterTime, 1, 1), + "FILETIME": (ArgFormatterTime, 0), + "SYSTEMTIME": (ArgFormatterTime, 0), + "STATSTG": (ArgFormatterSTATSTG, 0), + "LARGE_INTEGER": (ArgFormatterLARGE_INTEGER, 0), + "ULARGE_INTEGER": (ArgFormatterULARGE_INTEGER, 0), + "VARIANT": (ArgFormatterVARIANT, 0), + "float": (ArgFormatterFloat, 0), + "single": (ArgFormatterFloat, 0), + "short": (ArgFormatterShort, 0), + "WORD": (ArgFormatterShort, 0), + "VARIANT_BOOL": (ArgFormatterShort, 0), + "HWND": (ArgFormatterLONG_PTR, 1), + "HMENU": (ArgFormatterLONG_PTR, 1), + "HOLEMENU": (ArgFormatterLONG_PTR, 1), + "HICON": (ArgFormatterLONG_PTR, 1), + "HDC": (ArgFormatterLONG_PTR, 1), + "LPARAM": (ArgFormatterLONG_PTR, 1), + "WPARAM": (ArgFormatterLONG_PTR, 1), + "LRESULT": (ArgFormatterLONG_PTR, 1), + "UINT": (ArgFormatterShort, 0), + "SVSIF": (ArgFormatterShort, 0), + "Control": (ArgFormatterInterface, 0, 1), + "DataObject": (ArgFormatterInterface, 0, 1), + "_PropertyBag": (ArgFormatterInterface, 0, 1), + "AsyncProp": (ArgFormatterInterface, 0, 1), + "DataSource": (ArgFormatterInterface, 0, 1), + "DataFormat": (ArgFormatterInterface, 0, 1), + "void **": (ArgFormatterInterface, 2, 2), + "ITEMIDLIST": (ArgFormatterIDLIST, 0, 0), + "LPITEMIDLIST": (ArgFormatterIDLIST, 0, 1), + "LPCITEMIDLIST": (ArgFormatterIDLIST, 0, 1), + "const ITEMIDLIST": (ArgFormatterIDLIST, 0, 1), +} + +# Auto-add all the simple types +for key in ConvertSimpleTypes.keys(): + AllConverters[key] = ArgFormatterSimple, 0 + + +def make_arg_converter(arg): + try: + clz = AllConverters[arg.type][0] + bin = AllConverters[arg.type][1] + decl = 0 + if len(AllConverters[arg.type]) > 2: + decl = AllConverters[arg.type][2] + return clz(arg, bin, decl) + except KeyError: + if arg.type[0] == "I": + return ArgFormatterInterface(arg, 0, 1) + + raise error_not_supported( + "The type '%s' (%s) is unknown." % (arg.type, arg.name) + ) + + +############################################################# +# +# The instances that represent the args, methods and interface +class Argument: + """A representation of an argument to a COM method + + This class contains information about a specific argument to a method. + In addition, methods exist so that an argument knows how to convert itself + to/from Python arguments. + """ + + # in,out type name [ ] + # -------------- -------- ------------ ------ + regex = re.compile(r"/\* \[([^\]]*.*?)] \*/[ \t](.*[* ]+)(\w+)(\[ *])?[\),]") + + def __init__(self, good_interface_names): + self.good_interface_names = good_interface_names + self.inout = self.name = self.type = None + self.const = 0 + self.arrayDecl = 0 + + def BuildFromFile(self, file): + """Parse and build my data from a file + + Reads the next line in the file, and matches it as an argument + description. If not a valid argument line, an error_not_found exception + is raised. + """ + line = file.readline() + mo = self.regex.search(line) + if not mo: + raise error_not_found + self.name = mo.group(3) + self.inout = mo.group(1).split("][") + typ = mo.group(2).strip() + self.raw_type = typ + self.indirectionLevel = 0 + if mo.group(4): # Has "[ ]" decl + self.arrayDecl = 1 + try: + pos = typ.rindex("__RPC_FAR") + self.indirectionLevel = self.indirectionLevel + 1 + typ = typ[:pos].strip() + except ValueError: + pass + + typ = typ.replace("__RPC_FAR", "") + while 1: + try: + pos = typ.rindex("*") + self.indirectionLevel = self.indirectionLevel + 1 + typ = typ[:pos].strip() + except ValueError: + break + self.type = typ + if self.type[:6] == "const ": + self.unc_type = self.type[6:] + else: + self.unc_type = self.type + + if VERBOSE: + print( + " Arg %s of type %s%s (%s)" + % (self.name, self.type, "*" * self.indirectionLevel, self.inout) + ) + + def HasAttribute(self, typ): + """Determines if the argument has the specific attribute. + + Argument attributes are specified in the header file, such as + "[in][out][retval]" etc. You can pass a specific string (eg "out") + to find if this attribute was specified for the argument + """ + return typ in self.inout + + def GetRawDeclaration(self): + ret = "%s %s" % (self.raw_type, self.name) + if self.arrayDecl: + ret = ret + "[]" + return ret + + +class Method: + """A representation of a C++ method on a COM interface + + This class contains information about a specific method, as well as + a list of all @Argument@s + """ + + # options ret type callconv name + # ----------------- -------- -------- -------- + regex = re.compile(r"virtual (/\*.*?\*/ )?(.*?) (.*?) (.*?)\(\w?") + + def __init__(self, good_interface_names): + self.good_interface_names = good_interface_names + self.name = self.result = self.callconv = None + self.args = [] + + def BuildFromFile(self, file): + """Parse and build my data from a file + + Reads the next line in the file, and matches it as a method + description. If not a valid method line, an error_not_found exception + is raised. + """ + line = file.readline() + mo = self.regex.search(line) + if not mo: + raise error_not_found + self.name = mo.group(4) + self.result = mo.group(2) + if self.result != "HRESULT": + if self.result == "DWORD": # DWORD is for old old stuff? + print( + "Warning: Old style interface detected - compilation errors likely!" + ) + else: + print( + "Method %s - Only HRESULT return types are supported." % self.name + ) + # raise error_not_supported, if VERBOSE: + print(" Method %s %s(" % (self.result, self.name)) + while 1: + arg = Argument(self.good_interface_names) + try: + arg.BuildFromFile(file) + self.args.append(arg) + except error_not_found: + break + + +class Interface: + """A representation of a C++ COM Interface + + This class contains information about a specific interface, as well as + a list of all @Method@s + """ + + # name base + # -------- -------- + regex = re.compile("(interface|) ([^ ]*) : public (.*)$") + + def __init__(self, mo): + self.methods = [] + self.name = mo.group(2) + self.base = mo.group(3) + if VERBOSE: + print("Interface %s : public %s" % (self.name, self.base)) + + def BuildMethods(self, file): + """Build all sub-methods for this interface""" + # skip the next 2 lines. + file.readline() + file.readline() + while 1: + try: + method = Method([self.name]) + method.BuildFromFile(file) + self.methods.append(method) + except error_not_found: + break + + +def find_interface(interfaceName, file): + """Find and return an interface in a file + + Given an interface name and file, search for the specified interface. + + Upon return, the interface itself has been built, + but not the methods. + """ + interface = None + line = file.readline() + while line: + mo = Interface.regex.search(line) + if mo: + name = mo.group(2) + print(name) + AllConverters[name] = (ArgFormatterInterface, 0, 1) + if name == interfaceName: + interface = Interface(mo) + interface.BuildMethods(file) + line = file.readline() + if interface: + return interface + raise error_not_found + + +def parse_interface_info(interfaceName, file): + """Find, parse and return an interface in a file + + Given an interface name and file, search for the specified interface. + + Upon return, the interface itself is fully built, + """ + try: + return find_interface(interfaceName, file) + except re.error: + traceback.print_exc() + print("The interface could not be built, as the regular expression failed!") + + +def test(): + f = open("d:\\msdev\\include\\objidl.h") + try: + parse_interface_info("IPersistStream", f) + finally: + f.close() + + +def test_regex(r, text): + res = r.search(text, 0) + if res == -1: + print("** Not found") + else: + print( + "%d\n%s\n%s\n%s\n%s" % (res, r.group(1), r.group(2), r.group(3), r.group(4)) + ) diff --git a/lib/win32com/olectl.py b/lib/win32com/olectl.py new file mode 100644 index 00000000..50ec6f74 --- /dev/null +++ b/lib/win32com/olectl.py @@ -0,0 +1,70 @@ +"""Constants used by COM Controls + + Hand created version of OLECTL.H constants. +""" + +import winerror + +FACILITY_CONTROL = 0xA + + +def MAKE_SCODE(sev, fac, code): + return int((int(-sev) << 31) | ((fac) << 16) | ((code))) + + +def STD_CTL_SCODE(n): + return MAKE_SCODE(winerror.SEVERITY_ERROR, FACILITY_CONTROL, n) + + +CTL_E_ILLEGALFUNCTIONCALL = STD_CTL_SCODE(5) +CTL_E_OVERFLOW = STD_CTL_SCODE(6) +CTL_E_OUTOFMEMORY = STD_CTL_SCODE(7) +CTL_E_DIVISIONBYZERO = STD_CTL_SCODE(11) +CTL_E_OUTOFSTRINGSPACE = STD_CTL_SCODE(14) +CTL_E_OUTOFSTACKSPACE = STD_CTL_SCODE(28) +CTL_E_BADFILENAMEORNUMBER = STD_CTL_SCODE(52) +CTL_E_FILENOTFOUND = STD_CTL_SCODE(53) +CTL_E_BADFILEMODE = STD_CTL_SCODE(54) +CTL_E_FILEALREADYOPEN = STD_CTL_SCODE(55) +CTL_E_DEVICEIOERROR = STD_CTL_SCODE(57) +CTL_E_FILEALREADYEXISTS = STD_CTL_SCODE(58) +CTL_E_BADRECORDLENGTH = STD_CTL_SCODE(59) +CTL_E_DISKFULL = STD_CTL_SCODE(61) +CTL_E_BADRECORDNUMBER = STD_CTL_SCODE(63) +CTL_E_BADFILENAME = STD_CTL_SCODE(64) +CTL_E_TOOMANYFILES = STD_CTL_SCODE(67) +CTL_E_DEVICEUNAVAILABLE = STD_CTL_SCODE(68) +CTL_E_PERMISSIONDENIED = STD_CTL_SCODE(70) +CTL_E_DISKNOTREADY = STD_CTL_SCODE(71) +CTL_E_PATHFILEACCESSERROR = STD_CTL_SCODE(75) +CTL_E_PATHNOTFOUND = STD_CTL_SCODE(76) +CTL_E_INVALIDPATTERNSTRING = STD_CTL_SCODE(93) +CTL_E_INVALIDUSEOFNULL = STD_CTL_SCODE(94) +CTL_E_INVALIDFILEFORMAT = STD_CTL_SCODE(321) +CTL_E_INVALIDPROPERTYVALUE = STD_CTL_SCODE(380) +CTL_E_INVALIDPROPERTYARRAYINDEX = STD_CTL_SCODE(381) +CTL_E_SETNOTSUPPORTEDATRUNTIME = STD_CTL_SCODE(382) +CTL_E_SETNOTSUPPORTED = STD_CTL_SCODE(383) +CTL_E_NEEDPROPERTYARRAYINDEX = STD_CTL_SCODE(385) +CTL_E_SETNOTPERMITTED = STD_CTL_SCODE(387) +CTL_E_GETNOTSUPPORTEDATRUNTIME = STD_CTL_SCODE(393) +CTL_E_GETNOTSUPPORTED = STD_CTL_SCODE(394) +CTL_E_PROPERTYNOTFOUND = STD_CTL_SCODE(422) +CTL_E_INVALIDCLIPBOARDFORMAT = STD_CTL_SCODE(460) +CTL_E_INVALIDPICTURE = STD_CTL_SCODE(481) +CTL_E_PRINTERERROR = STD_CTL_SCODE(482) +CTL_E_CANTSAVEFILETOTEMP = STD_CTL_SCODE(735) +CTL_E_SEARCHTEXTNOTFOUND = STD_CTL_SCODE(744) +CTL_E_REPLACEMENTSTOOLONG = STD_CTL_SCODE(746) + +CONNECT_E_FIRST = MAKE_SCODE(winerror.SEVERITY_ERROR, winerror.FACILITY_ITF, 0x0200) +CONNECT_E_LAST = MAKE_SCODE(winerror.SEVERITY_ERROR, winerror.FACILITY_ITF, 0x020F) +CONNECT_S_FIRST = MAKE_SCODE(winerror.SEVERITY_SUCCESS, winerror.FACILITY_ITF, 0x0200) +CONNECT_S_LAST = MAKE_SCODE(winerror.SEVERITY_SUCCESS, winerror.FACILITY_ITF, 0x020F) + +CONNECT_E_NOCONNECTION = CONNECT_E_FIRST + 0 +CONNECT_E_ADVISELIMIT = CONNECT_E_FIRST + 1 +CONNECT_E_CANNOTCONNECT = CONNECT_E_FIRST + 2 +CONNECT_E_OVERRIDDEN = CONNECT_E_FIRST + 3 + +CLASS_E_NOTLICENSED = winerror.CLASSFACTORY_E_FIRST + 2 diff --git a/lib/win32com/readme.html b/lib/win32com/readme.html new file mode 100644 index 00000000..3df75340 --- /dev/null +++ b/lib/win32com/readme.html @@ -0,0 +1,87 @@ + + + + win32com Readme + + + +

    Python and COM - Blowing the others away

    + +

    Python COM Extensions Readme

    + +

    This is the readme for win32com. Please check out the win32com documentation index

    + +

    The win32com/test directory contains some interesting + scripts (and a new readme.txt). Although these + are used for testing, they do show a variety of COM techniques.

    + +

    VARIANT objects

    +

    win32com.client now has explicit VARIANT objects which can be used in +situations where you need more control over the argument types passed when +calling COM methods. See the documentation on +this object + +

    Important Currency changes

    +

    +In all builds prior to 204, a COM currency value was returned as a tuple of +integers. Working with 2 integers to represent a currency object was a poor +choice, but the alternative was never clear. Now Python ships with the +decimal +module, the alternative has arrived! +

    +

    +Up until build 212, code could set pythoncom.__future_currency__ = True +to force use of the decimal module, with a warning issued otherwise. In +builds 213 and later, the decimal module is unconditionally used when +pythoncon returns you a currency value. +

    + +

    Recent Changes

    + +

    Lots of internal changes on the road to py3k

    + +

    win32com.axcontrol and win2con.internet

    +Many more interfaces for hosting AX controls and the interfaces +used by Internet Explorer. + +

    win32com.shell

    +The shell interfaces have undergone a number of enhancements and changes. +A couple of methods have changed signature between the first build with shell support (200) and later builds. +SHGetFileInfo was broken in its result handling, so had to be changed - this +is the only function used by the samples that changed, but others not used by the samples also have changed. +These shell interfaces are now generally stable. +

    New win32com.taskscheduler module

    +Roger Upole has contributed an interface to the Windows task scheduler. This is actually very neat, and it allows +Python to edit the task list as shown by Windows Control Panel. Property page suppport may even appear later, +now that the win32 library has the new win32rcparser module. +

    ActiveX Scripting

    + +

    Python only supports "trusted" execution hosts - thus, it will no longer work +as an engine inside IE (Python itself no longer has a restricted execution environment). +Python continues to work fine as an Active Scripting Engine in all other +applications, including Windows Scripting Host, and ASP. + +

    There is also support for Python as an ActiveX Scripting Host.

    + +

    Active Debugging seems to be fully functional.

    + +

    Older stuff

    +

    • +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 literal 174394 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 z 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 z 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

    -
    - -

    Check this if your Plex Server is not on the same local network as Tautulli.

    -
    @@ -2597,7 +2589,6 @@ $(document).ready(function() { return '
    ' + @@ -2611,7 +2602,6 @@ $(document).ready(function() { return '
    ' + @@ -2634,7 +2624,6 @@ $(document).ready(function() { var identifier = $(pms_ip_selected).data('identifier'); var ip = $(pms_ip_selected).data('ip'); var port = $(pms_ip_selected).data('port'); - var local = $(pms_ip_selected).data('local'); var ssl = $(pms_ip_selected).data('ssl'); var is_cloud = $(pms_ip_selected).data('is_cloud'); var value = $(pms_ip_selected).data('value'); @@ -2642,8 +2631,6 @@ $(document).ready(function() { $("#pms_identifier").val(identifier !== 'undefined' ? identifier : ''); $('#pms_ip').val(ip !== 'undefined' ? ip : value); $('#pms_port').val(port !== 'undefined' ? port : 32400); - $('#pms_is_remote_checkbox').prop('checked', (local !== 'undefined' && local === 0)); - $('#pms_is_remote').val(local !== 'undefined' && local === 0 ? 1 : 0); $('#pms_ssl_checkbox').prop('checked', (ssl !== 'undefined' && ssl === 1)); $('#pms_ssl').val(ssl !== 'undefined' && ssl === 1 ? 1 : 0); $('#pms_is_cloud').val(is_cloud !== 'undefined' && is_cloud === true ? 1 : 0); @@ -2681,7 +2668,6 @@ $(document).ready(function() { var pms_port = $("#pms_port").val(); var pms_identifier = $("#pms_identifier").val(); var pms_ssl = $("#pms_ssl").val(); - var pms_is_remote = $("#pms_is_remote").val(); var pms_url_manual = $("#pms_url_manual").is(':checked') ? 1 : 0; if (($("#pms_ip").val() !== '') || ($("#pms_port").val() !== '')) { @@ -2693,7 +2679,6 @@ $(document).ready(function() { hostname: pms_ip, port: pms_port, ssl: pms_ssl, - remote: pms_is_remote, manual: pms_url_manual, get_url: true, test_websocket: true diff --git a/data/interfaces/default/welcome.html b/data/interfaces/default/welcome.html index 39fc19b4..e3b4bc56 100644 --- a/data/interfaces/default/welcome.html +++ b/data/interfaces/default/welcome.html @@ -135,7 +135,6 @@ data-identifier="${config['pms_identifier']}" data-ip="${config['pms_ip']}" data-port="${config['pms_port']}" - data-local="${int(not int(config['pms_is_remote']))}" data-ssl="${config['pms_ssl']}" data-is_cloud="${config['pms_is_cloud']}" data-label="${config['pms_name'] or 'Local'}" @@ -159,14 +158,6 @@
    -
    -
    - -
    -
    @@ -391,7 +382,6 @@ $(document).ready(function() { return '
    ' + @@ -405,7 +395,6 @@ $(document).ready(function() { return '
    ' + @@ -428,7 +417,6 @@ $(document).ready(function() { var identifier = $(pms_ip_selected).data('identifier'); var ip = $(pms_ip_selected).data('ip'); var port = $(pms_ip_selected).data('port'); - var local = $(pms_ip_selected).data('local'); var ssl = $(pms_ip_selected).data('ssl'); var is_cloud = $(pms_ip_selected).data('is_cloud'); var value = $(pms_ip_selected).data('value'); @@ -439,19 +427,15 @@ $(document).ready(function() { $("#pms_identifier").val(identifier !== 'undefined' ? identifier : ''); $('#pms_ip').val(ip !== 'undefined' ? ip : value); $('#pms_port').val(port !== 'undefined' ? port : 32400); - $('#pms_is_remote_checkbox').prop('checked', (local !== 'undefined' && local === 0)); - $('#pms_is_remote').val(local !== 'undefined' && local === 0 ? 1 : 0); $('#pms_ssl_checkbox').prop('checked', (ssl !== 'undefined' && ssl === 1)); $('#pms_ssl').val(ssl !== 'undefined' && ssl === 1 ? 1 : 0); $('#pms_is_cloud').val(is_cloud !== 'undefined' && is_cloud === true ? 1 : 0); if (is_cloud === true) { $('#pms_port').prop('readonly', true); - $('#pms_is_remote_checkbox').prop('disabled', true); $('#pms_ssl_checkbox').prop('disabled', true); } else { $('#pms_port').prop('readonly', false); - $('#pms_is_remote_checkbox').prop('disabled', false); $('#pms_ssl_checkbox').prop('disabled', false); } }, @@ -488,7 +472,6 @@ $(document).ready(function() { var pms_port = $("#pms_port").val().trim(); var pms_identifier = $("#pms_identifier").val(); var pms_ssl = $("#pms_ssl").val(); - var pms_is_remote = $("#pms_is_remote").val(); if ((pms_ip !== '') || (pms_port !== '')) { $("#pms-verify-status").html('  Verifying server...'); $('#pms-verify-status').fadeIn('fast'); @@ -498,8 +481,7 @@ $(document).ready(function() { hostname: pms_ip, port: pms_port, identifier: pms_identifier, - ssl: pms_ssl, - remote: pms_is_remote + ssl: pms_ssl }, cache: true, async: true, diff --git a/plexpy/plextv.py b/plexpy/plextv.py index d45ce785..eed9d50e 100644 --- a/plexpy/plextv.py +++ b/plexpy/plextv.py @@ -39,7 +39,6 @@ def get_server_resources(return_presence=False, return_server=False, return_info 'pms_ip': plexpy.CONFIG.PMS_IP, 'pms_port': plexpy.CONFIG.PMS_PORT, 'pms_ssl': plexpy.CONFIG.PMS_SSL, - 'pms_is_remote': plexpy.CONFIG.PMS_IS_REMOTE, 'pms_is_cloud': plexpy.CONFIG.PMS_IS_CLOUD, 'pms_url': plexpy.CONFIG.PMS_URL, 'pms_url_manual': plexpy.CONFIG.PMS_URL_MANUAL, @@ -52,7 +51,7 @@ def get_server_resources(return_presence=False, return_server=False, return_info if kwargs: server.update(kwargs) - for k in ['pms_ssl', 'pms_is_remote', 'pms_is_cloud', 'pms_url_manual']: + for k in ['pms_ssl', 'pms_is_cloud', 'pms_url_manual']: server[k] = int(server[k]) if server['pms_url_manual'] and server['pms_ssl'] or server['pms_is_cloud']: @@ -88,30 +87,25 @@ def get_server_resources(return_presence=False, return_server=False, return_info # Only need to retrieve PMS_URL if using SSL if not server['pms_url_manual'] and server['pms_ssl']: if connections: - if server['pms_is_remote']: - # Get all remote connections - conns = [c for c in connections if - c['local'] == '0' and ('plex.direct' in c['uri'] or 'plex.service' in c['uri'])] - else: - # Get all local connections - conns = [c for c in connections if - c['local'] == '1' and ('plex.direct' in c['uri'] or 'plex.service' in c['uri'])] - - if conns: - # Get connection with matching address, otherwise return first connection - conn = next((c for c in conns if c['address'] == server['pms_ip'] - and c['port'] == str(server['pms_port'])), conns[0]) - server['pms_url'] = conn['uri'] - logger.info("Tautulli PlexTV :: Server URL retrieved.") + # Get connection with matching address, otherwise return first connection + connection = next( + (c for c in connections if c['address'] == server['pms_ip'] and c['port'] == str(server['pms_port'])), + connections[0] + ) + server['pms_url'] = connection['uri'] + server['pms_is_remote'] = int(connection['local'] == '0') + logger.info("Tautulli PlexTV :: Server URL retrieved.") # get_server_urls() failed or PMS_URL not found, fallback url doesn't use SSL if not server['pms_url']: server['pms_url'] = fallback_url + server['pms_is_remote'] = 0 logger.warn("Tautulli PlexTV :: Unable to retrieve server URLs. Using user-defined value without SSL.") - # Not using SSL, remote has no effect + # Not using SSL else: server['pms_url'] = fallback_url + server['pms_is_remote'] = 0 logger.info("Tautulli PlexTV :: Using user-defined URL.") if return_server: diff --git a/plexpy/webserve.py b/plexpy/webserve.py index ec98baf2..150bc18d 100644 --- a/plexpy/webserve.py +++ b/plexpy/webserve.py @@ -175,7 +175,6 @@ class WebInterface(object): "pms_identifier": plexpy.CONFIG.PMS_IDENTIFIER, "pms_ip": plexpy.CONFIG.PMS_IP, "pms_port": plexpy.CONFIG.PMS_PORT, - "pms_is_remote": plexpy.CONFIG.PMS_IS_REMOTE, "pms_ssl": plexpy.CONFIG.PMS_SSL, "pms_is_cloud": plexpy.CONFIG.PMS_IS_CLOUD, "pms_name": helpers.pms_name(), @@ -3247,7 +3246,6 @@ class WebInterface(object): # If we change the SSL setting for PMS or PMS remote setting, make sure we grab the new url. if kwargs.get('pms_ssl') != str(plexpy.CONFIG.PMS_SSL) or \ - kwargs.get('pms_is_remote') != str(plexpy.CONFIG.PMS_IS_REMOTE) or \ kwargs.get('pms_url_manual') != plexpy.CONFIG.PMS_URL_MANUAL: server_changed = True @@ -4060,7 +4058,7 @@ class WebInterface(object): @cherrypy.tools.json_out() @requireAuth(member_of("admin")) @addtoapi() - def get_server_id(self, hostname=None, port=None, identifier=None, ssl=0, remote=0, manual=0, + def get_server_id(self, hostname=None, port=None, identifier=None, ssl=0, manual=0, get_url=False, test_websocket=False, **kwargs): """ Get the PMS server identifier. @@ -4115,7 +4113,6 @@ class WebInterface(object): server = self.get_server_resources(pms_ip=hostname, pms_port=port, pms_ssl=ssl, - pms_is_remote=remote, pms_url_manual=manual, pms_identifier=identifier) result['url'] = server['pms_url'] From a3af8ed36210e49350c5233487ebf5b832190a39 Mon Sep 17 00:00:00 2001 From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com> Date: Mon, 3 Jun 2024 23:07:11 -0700 Subject: [PATCH 162/290] Fix width of use secure connection checkbox in wizard --- data/interfaces/default/welcome.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/interfaces/default/welcome.html b/data/interfaces/default/welcome.html index e3b4bc56..baf1b57e 100644 --- a/data/interfaces/default/welcome.html +++ b/data/interfaces/default/welcome.html @@ -150,7 +150,7 @@
    -
    +