py2docfx 0.1.13rc2012291__py3-none-any.whl → 0.1.13rc2022156__py3-none-any.whl

py2docfx/venv/basevenv/Lib/site-packages/setuptools/_distutils/zosccompiler.py

@@ -1,229 +1,3 @@
-"""distutils.zosccompiler
+from .compilers.C import zos
 
-Contains the selection of the c & c++ compilers on z/OS. There are several
-different c compilers on z/OS, all of them are optional, so the correct
-one needs to be chosen based on the users input. This is compatible with
-the following compilers:
-
-IBM C/C++ For Open Enterprise Languages on z/OS 2.0
-IBM Open XL C/C++ 1.1 for z/OS
-IBM XL C/C++ V2.4.1 for z/OS 2.4 and 2.5
-IBM z/OS XL C/C++
-"""
-
-import os
-
-from . import sysconfig
-from .errors import CompileError, DistutilsExecError
-from .unixccompiler import UnixCCompiler
-
-_cc_args = {
-    'ibm-openxl': [
-        '-m64',
-        '-fvisibility=default',
-        '-fzos-le-char-mode=ascii',
-        '-fno-short-enums',
-    ],
-    'ibm-xlclang': [
-        '-q64',
-        '-qexportall',
-        '-qascii',
-        '-qstrict',
-        '-qnocsect',
-        '-Wa,asa,goff',
-        '-Wa,xplink',
-        '-qgonumber',
-        '-qenum=int',
-        '-Wc,DLL',
-    ],
-    'ibm-xlc': [
-        '-q64',
-        '-qexportall',
-        '-qascii',
-        '-qstrict',
-        '-qnocsect',
-        '-Wa,asa,goff',
-        '-Wa,xplink',
-        '-qgonumber',
-        '-qenum=int',
-        '-Wc,DLL',
-        '-qlanglvl=extc99',
-    ],
-}
-
-_cxx_args = {
-    'ibm-openxl': [
-        '-m64',
-        '-fvisibility=default',
-        '-fzos-le-char-mode=ascii',
-        '-fno-short-enums',
-    ],
-    'ibm-xlclang': [
-        '-q64',
-        '-qexportall',
-        '-qascii',
-        '-qstrict',
-        '-qnocsect',
-        '-Wa,asa,goff',
-        '-Wa,xplink',
-        '-qgonumber',
-        '-qenum=int',
-        '-Wc,DLL',
-    ],
-    'ibm-xlc': [
-        '-q64',
-        '-qexportall',
-        '-qascii',
-        '-qstrict',
-        '-qnocsect',
-        '-Wa,asa,goff',
-        '-Wa,xplink',
-        '-qgonumber',
-        '-qenum=int',
-        '-Wc,DLL',
-        '-qlanglvl=extended0x',
-    ],
-}
-
-_asm_args = {
-    'ibm-openxl': ['-fasm', '-fno-integrated-as', '-Wa,--ASA', '-Wa,--GOFF'],
-    'ibm-xlclang': [],
-    'ibm-xlc': [],
-}
-
-_ld_args = {
-    'ibm-openxl': [],
-    'ibm-xlclang': ['-Wl,dll', '-q64'],
-    'ibm-xlc': ['-Wl,dll', '-q64'],
-}
-
-
-# Python on z/OS is built with no compiler specific options in it's CFLAGS.
-# But each compiler requires it's own specific options to build successfully,
-# though some of the options are common between them
-class zOSCCompiler(UnixCCompiler):
-    src_extensions = ['.c', '.C', '.cc', '.cxx', '.cpp', '.m', '.s']
-    _cpp_extensions = ['.cc', '.cpp', '.cxx', '.C']
-    _asm_extensions = ['.s']
-
-    def _get_zos_compiler_name(self):
-        zos_compiler_names = [
-            os.path.basename(binary)
-            for envvar in ('CC', 'CXX', 'LDSHARED')
-            if (binary := os.environ.get(envvar, None))
-        ]
-        if len(zos_compiler_names) == 0:
-            return 'ibm-openxl'
-
-        zos_compilers = {}
-        for compiler in (
-            'ibm-clang',
-            'ibm-clang64',
-            'ibm-clang++',
-            'ibm-clang++64',
-            'clang',
-            'clang++',
-            'clang-14',
-        ):
-            zos_compilers[compiler] = 'ibm-openxl'
-
-        for compiler in ('xlclang', 'xlclang++', 'njsc', 'njsc++'):
-            zos_compilers[compiler] = 'ibm-xlclang'
-
-        for compiler in ('xlc', 'xlC', 'xlc++'):
-            zos_compilers[compiler] = 'ibm-xlc'
-
-        return zos_compilers.get(zos_compiler_names[0], 'ibm-openxl')
-
-    def __init__(self, verbose=False, dry_run=False, force=False):
-        super().__init__(verbose, dry_run, force)
-        self.zos_compiler = self._get_zos_compiler_name()
-        sysconfig.customize_compiler(self)
-
-    def _compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts):
-        local_args = []
-        if ext in self._cpp_extensions:
-            compiler = self.compiler_cxx
-            local_args.extend(_cxx_args[self.zos_compiler])
-        elif ext in self._asm_extensions:
-            compiler = self.compiler_so
-            local_args.extend(_cc_args[self.zos_compiler])
-            local_args.extend(_asm_args[self.zos_compiler])
-        else:
-            compiler = self.compiler_so
-            local_args.extend(_cc_args[self.zos_compiler])
-        local_args.extend(cc_args)
-
-        try:
-            self.spawn(compiler + local_args + [src, '-o', obj] + extra_postargs)
-        except DistutilsExecError as msg:
-            raise CompileError(msg)
-
-    def runtime_library_dir_option(self, dir):
-        return '-L' + dir
-
-    def link(
-        self,
-        target_desc,
-        objects,
-        output_filename,
-        output_dir=None,
-        libraries=None,
-        library_dirs=None,
-        runtime_library_dirs=None,
-        export_symbols=None,
-        debug=False,
-        extra_preargs=None,
-        extra_postargs=None,
-        build_temp=None,
-        target_lang=None,
-    ):
-        # For a built module to use functions from cpython, it needs to use Pythons
-        # side deck file. The side deck is located beside the libpython3.xx.so
-        ldversion = sysconfig.get_config_var('LDVERSION')
-        if sysconfig.python_build:
-            side_deck_path = os.path.join(
-                sysconfig.get_config_var('abs_builddir'),
-                f'libpython{ldversion}.x',
-            )
-        else:
-            side_deck_path = os.path.join(
-                sysconfig.get_config_var('installed_base'),
-                sysconfig.get_config_var('platlibdir'),
-                f'libpython{ldversion}.x',
-            )
-
-        if os.path.exists(side_deck_path):
-            if extra_postargs:
-                extra_postargs.append(side_deck_path)
-            else:
-                extra_postargs = [side_deck_path]
-
-        # Check and replace libraries included side deck files
-        if runtime_library_dirs:
-            for dir in runtime_library_dirs:
-                for library in libraries[:]:
-                    library_side_deck = os.path.join(dir, f'{library}.x')
-                    if os.path.exists(library_side_deck):
-                        libraries.remove(library)
-                        extra_postargs.append(library_side_deck)
-                        break
-
-        # Any required ld args for the given compiler
-        extra_postargs.extend(_ld_args[self.zos_compiler])
-
-        super().link(
-            target_desc,
-            objects,
-            output_filename,
-            output_dir,
-            libraries,
-            library_dirs,
-            runtime_library_dirs,
-            export_symbols,
-            debug,
-            extra_preargs,
-            extra_postargs,
-            build_temp,
-            target_lang,
-        )
+zOSCCompiler = zos.Compiler

py2docfx/venv/basevenv/Lib/site-packages/setuptools/_static.py

@@ -27,7 +27,7 @@ class Static:
 def _prevent_modification(target: type, method: str, copying: str) -> None:
     """
     Because setuptools is very flexible we cannot fully prevent
-    plugins and user customisations from modifying static values that were
+    plugins and user customizations from modifying static values that were
     parsed from config files.
     But we can attempt to block "in-place" mutations and identify when they
     were done.

py2docfx/venv/basevenv/Lib/site-packages/setuptools/command/editable_wheel.py

@@ -278,7 +278,7 @@ class editable_wheel(Command):
         This method implements a temporary workaround to support the ecosystem
         while the implementations catch up.
         """
-        # TODO: Once plugins/customisations had the chance to catch up, replace
+        # TODO: Once plugins/customizations had the chance to catch up, replace
         #       `self._run_build_subcommands()` with `self.run_command("build")`.
         #       Also remove _safely_run, TestCustomBuildPy. Suggested date: Aug/2023.
         build = self.get_finalized_command("build")
@@ -309,7 +309,7 @@ class editable_wheel(Command):
                 https://setuptools.pypa.io/en/latest/userguide/extension.html.
 
                 For the time being `setuptools` will silence this error and ignore
-                the faulty command, but this behaviour will change in future versions.
+                the faulty command, but this behavior will change in future versions.
                 """,
                 # TODO: define due_date
                 # There is a series of shortcomings with the available editable install
@@ -564,7 +564,7 @@ def _encode_pth(content: str) -> bytes:
     .pth files are always read with 'locale' encoding, the recommendation
     from the cpython core developers is to write them as ``open(path, "w")``
     and ignore warnings (see python/cpython#77102, pypa/setuptools#3937).
-    This function tries to simulate this behaviour without having to create an
+    This function tries to simulate this behavior without having to create an
     actual file, in a way that supports a range of active Python versions.
     (There seems to be some variety in the way different version of Python handle
     ``encoding=None``, not all of them use ``locale.getpreferredencoding(False)``

py2docfx/venv/basevenv/Lib/site-packages/setuptools/command/install.py

@@ -68,7 +68,7 @@ class install(orig.install):
             """,
             see_url="https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html",
             # TODO: Document how to bootstrap setuptools without install
-            #       (e.g. by unziping the wheel file)
+            #       (e.g. by unzipping the wheel file)
             #       and then add a due_date to this warning.
         )
 

py2docfx/venv/basevenv/Lib/site-packages/setuptools/tests/config/test_setupcfg.py

@@ -420,6 +420,7 @@ class TestMetadata:
             with get_dist(tmpdir):
                 pass
 
+    @pytest.mark.xfail(reason="#4864")
     def test_warn_dash_deprecation(self, tmpdir):
         # warn_dash_deprecation() is a method in setuptools.dist
         # remove this test and the method when no longer needed
@@ -437,6 +438,7 @@ class TestMetadata:
         assert metadata.author_email == 'test@test.com'
         assert metadata.maintainer_email == 'foo@foo.com'
 
+    @pytest.mark.xfail(reason="#4864")
     def test_make_option_lowercase(self, tmpdir):
         # remove this test and the method make_option_lowercase() in setuptools.dist
         # when no longer needed

py2docfx/venv/basevenv/Lib/site-packages/setuptools/tests/test_build_py.py

@@ -168,7 +168,7 @@ def test_excluded_subpackages(tmpdir_cwd):
     with pytest.warns(SetuptoolsDeprecationWarning, match=msg):
         # TODO: To fix #3260 we need some transition period to deprecate the
         # existing behavior of `include_package_data`. After the transition, we
-        # should remove the warning and fix the behaviour.
+        # should remove the warning and fix the behavior.
 
         if os.getenv("SETUPTOOLS_USE_DISTUTILS") == "stdlib":
             # pytest.warns reset the warning filter temporarily

py2docfx/venv/basevenv/Lib/site-packages/setuptools/unicode_utils.py

@@ -86,7 +86,7 @@ class _Utf8EncodingNeeded(SetuptoolsDeprecationWarning):
     """
 
     _DETAILS = """
-    Fallback behaviour for UTF-8 is considered **deprecated** and future versions of
+    Fallback behavior for UTF-8 is considered **deprecated** and future versions of
     `setuptools` may not implement it.
 
     Please encode {file!r} with "utf-8" to ensure future builds will succeed.

py2docfx/venv/venv1/Lib/site-packages/adodbapi/__init__.py

@@ -1,7 +1,8 @@
+# nopycln: file # undecidable cases due to explicit re-exports https://github.com/hadialqattan/pycln/issues/205
 """adodbapi - 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/adodbapi
+* https://sourceforge.net/projects/adodbapi
 """
 
 import time

py2docfx/venv/venv1/Lib/site-packages/adodbapi/ado_consts.py

@@ -1,5 +1,6 @@
 # ADO enumerated constants documented on MSDN:
-# http://msdn.microsoft.com/en-us/library/ms678353(VS.85).aspx
+# https://learn.microsoft.com/en-us/sql/ado/reference/ado-api/ado-enumerated-constants
+# TODO: Update to https://learn.microsoft.com/en-us/sql/ado/reference/ado-api/ado-enumerated-constants
 
 # IsolationLevelEnum
 adXactUnspecified = -1
@@ -79,6 +80,7 @@ ado_error_TIMEOUT = -2147217871
 
 # DataTypeEnum - ADO Data types documented at:
 # http://msdn2.microsoft.com/en-us/library/ms675318.aspx
+# TODO: Update to https://learn.microsoft.com/en-us/sql/ado/reference/ado-api/datatypeenum
 adArray = 0x2000
 adEmpty = 0x0
 adBSTR = 0x8

py2docfx/venv/venv1/Lib/site-packages/adodbapi/adodbapi.py

@@ -1,9 +1,9 @@
 """adodbapi - A python DB API 2.0 (PEP 249) interface to Microsoft ADO
 
 Copyright (C) 2002 Henrik Ekelund, versions 2.1 and later by Vernon Cole
-* http://sourceforge.net/projects/pywin32
+* https://sourceforge.net/projects/pywin32
 * https://github.com/mhammond/pywin32
-* http://sourceforge.net/projects/adodbapi
+* https://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
@@ -21,7 +21,7 @@ Copyright (C) 2002 Henrik Ekelund, versions 2.1 and later by Vernon Cole
 
     django adaptations and refactoring by Adam Vandenberg
 
-DB-API 2.0 specification: http://www.python.org/dev/peps/pep-0249/
+DB-API 2.0 specification: https://peps.python.org/pep-0249/
 
 This module source should run correctly in CPython versions 2.7 and later,
 or CPython 3.4 or later.
@@ -66,7 +66,7 @@ from collections.abc import Mapping
 def make_COM_connecter():
     try:
         pythoncom.CoInitialize()  # v2.1 Paj
-        c = Dispatch("ADODB.Connection")  # connect _after_ CoIninialize v2.1.1 adamvan
+        c = Dispatch("ADODB.Connection")  # connect _after_ CoInitialize v2.1.1 adamvan
     except:
         raise api.InterfaceError(
             "Windows COM Error: Dispatch('ADODB.Connection') failed."
@@ -79,8 +79,9 @@ def connect(*args, **kwargs):  # --> a db-api connection object
 
     call using:
     :connection_string -- An ADODB formatted connection string, see:
-         * http://www.connectionstrings.com
-         * http://www.asp101.com/articles/john/connstring/default.asp
+         * https://www.connectionstrings.com
+         * https://www.codeguru.com/dotnet/whats-in-an-ado-connection-string/
+         * https://learn.microsoft.com/en-us/dotnet/framework/data/adonet/connection-strings
     :timeout -- A command timeout value, in seconds (default 30 seconds)
     """
     co = Connection()  # make an empty connection object
@@ -162,15 +163,15 @@ def _configure_parameter(p, value, adotype, settings_known):
         p.AppendChunk(value)
 
     elif isinstance(value, str):  # v2.1 Jevon
-        L = len(value)
+        length = 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
+                length = min(length, p.Size)  # v2.1 Cole limit data to defined size
+            p.Value = value[:length]  # v2.1 Jevon & v2.1 Cole
         else:
             p.Value = value  # don't 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
+        if length > 0:  # v2.1 Cole something does not like p.Size as Zero
+            p.Size = length  # v2.1 Jevon
 
     elif isinstance(value, decimal.Decimal):
         p.Value = value
@@ -234,7 +235,7 @@ class Connection:
         self.paramstyle = api.paramstyle
         self.supportsTransactions = False
         self.connection_string = ""
-        self.cursors = weakref.WeakValueDictionary()
+        self.cursors = weakref.WeakValueDictionary[int, Cursor]()
         self.dbms_name = ""
         self.dbms_version = ""
         self.errorhandler = None  # use the standard error handler for this instance
@@ -395,9 +396,7 @@ class Connection:
                     # 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:
+                    if not self.transaction_level:
                         self.transaction_level = self.connector.BeginTrans()
             except Exception as e:
                 self._raiseConnectionError(api.ProgrammingError, e)
@@ -476,7 +475,7 @@ class Connection:
         """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
+        https://www.contrib.andrew.cmu.edu/~shadow/sql/sql1992.txt
 
         The 23000 class of errors are integrity errors.
         Error 40002 is a transactional integrity error.
@@ -595,7 +594,7 @@ class Cursor:
         eh(self.connection, self, errorclass, errorvalue)
 
     def build_column_info(self, recordset):
-        self.converters = []  # convertion function for each column
+        self.converters = []  # conversion function for each column
         self.columnNames = {}  # names of columns {lowercase name : number,...}
         self._description = None
 
@@ -634,9 +633,8 @@ class Cursor:
             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 ?
+                # TODO: Is this the correct defintion according to the DB API 2 Spec ?
+                display_size = f.ActualSize
             null_ok = bool(f.Attributes & adc.adFldMayBeNull)  # v2.1 Cole
             desc.append(
                 (
@@ -774,9 +772,8 @@ class Cursor:
         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
+        # store procedures may return altered parameters, including an added "return value" item
+        retLst = []
         for p in tuple(self.cmd.Parameters):
             if verbose > 2:
                 print(
@@ -907,9 +904,8 @@ class Cursor:
                             )
                         i += 1
             else:  # -- build own parameter list
-                if (
-                    self._parameter_names
-                ):  # we expect a dictionary of parameters, this is the list of expected names
+                # we expect a dictionary of parameters, this is the list of expected names
+                if self._parameter_names:
                     for parm_name in self._parameter_names:
                         elem = parameters[parm_name]
                         adotype = api.pyTypeToADOType(elem)

py2docfx/venv/venv1/Lib/site-packages/adodbapi/apibase.py

@@ -1,8 +1,8 @@
 """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
+* https://sourceforge.net/projects/pywin32
+* https://sourceforge.net/projects/adodbapi
 """
 
 from __future__ import annotations
@@ -13,7 +13,6 @@ import numbers
 import sys
 import time
 from collections.abc import Callable, Iterable, Mapping
-from typing import Dict
 
 # noinspection PyUnresolvedReferences
 from . import ado_consts as adc
@@ -465,7 +464,7 @@ def convert_to_python(variant, func):  # convert DB value into Python value
     return func(variant)  # call the appropriate conversion function
 
 
-class MultiMap(Dict[int, Callable[[object], object]]):
+class MultiMap(dict[int, Callable[[object], object]]):
     # builds a dictionary from {(iterable,of,keys) : function}
     """A dictionary of ado.type : function
     -- but you can set multiple items by passing an iterable of keys"""

py2docfx/venv/venv1/Lib/site-packages/adodbapi/examples/db_print.py

@@ -1,4 +1,4 @@
-""" db_print.py -- a simple demo for ADO database reads."""
+"""db_print.py -- a simple demo for ADO database reads."""
 
 import sys
 

py2docfx/venv/venv1/Lib/site-packages/adodbapi/examples/db_table_names.py

@@ -1,4 +1,4 @@
-""" db_table_names.py -- a simple demo for ADO database table listing."""
+"""db_table_names.py -- a simple demo for ADO database table listing."""
 
 import sys
 

py2docfx/venv/venv1/Lib/site-packages/adodbapi/process_connect_string.py

@@ -1,4 +1,4 @@
-""" a clumsy attempt at a macro language to let the programmer execute code on the server (ex: determine 64bit)"""
+"""a clumsy attempt at a macro language to let the programmer execute code on the server (ex: determine 64bit)"""
 
 from . import is64bit
 
@@ -45,6 +45,8 @@ def macro_call(macro_name, args, kwargs):
                 return new_key, platform.node()
 
         elif macro_name == "getenv":  # expand the server's environment variable args[1]
+            import os
+
             try:
                 dflt = args[2]  # if not found, default from args[2]
             except IndexError:  # or blank
@@ -86,13 +88,11 @@ def process(
         dsn = args[0]
     except IndexError:
         dsn = None
-    if isinstance(
-        dsn, dict
-    ):  # as a convenience the first argument may be django settings
+    # as a convenience the first argument may be django settings
+    if isinstance(dsn, dict):
         kwargs.update(dsn)
-    elif (
-        dsn
-    ):  # the connection string is passed to the connection as part of the keyword dictionary
+    # the connection string is passed to the connection as part of the keyword dictionary
+    elif dsn:
         kwargs["connection_string"] = dsn
     try:
         a1 = args[1]

py2docfx/venv/venv1/Lib/site-packages/adodbapi/setup.py

@@ -9,7 +9,7 @@ MAINTAINER_EMAIL = "vernondcole@gmail.com"
 DESCRIPTION = (
     """A pure Python package implementing PEP 249 DB-API using Microsoft ADO."""
 )
-URL = "http://sourceforge.net/projects/adodbapi"
+URL = "https://sourceforge.net/projects/adodbapi"
 LICENSE = "LGPL"
 CLASSIFIERS = [
     "Development Status :: 5 - Production/Stable",
@@ -32,7 +32,7 @@ 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]
+        VERSION = line.split("'")[1]  # pyright: ignore[reportConstantRedefinition]
         print('adodbapi version="%s"' % VERSION)
         break
 a.close()